Skip to content

Commit dcd2993

Browse files
authored
Merge branch 'ChesterRa:main' into main
2 parents cf2f031 + 54ae153 commit dcd2993

154 files changed

Lines changed: 10721 additions & 6455 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,7 @@ uv.lock
2626
/web/.vite/
2727
/web/dist/
2828
/src/cccc/ports/web/dist/
29+
/space
2930

3031
# Local/editor/platform noise
3132
.DS_Store

docs/guide/best-practices.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -79,10 +79,10 @@ You can show different content to different roles using conditional markers:
7979

8080
Agents access help content through MCP tools:
8181

82-
1. **`cccc_bootstrap`** - Returns help as part of session initialization
82+
1. **`cccc_bootstrap`** - Returns the lean recovery packet (`session`, `recovery`, `inbox_preview`, `memory_recall_gate`, `next_calls`)
8383
2. **`cccc_help`** - Returns help content on demand
8484

85-
The help is returned as:
85+
The on-demand help payload is returned as:
8686
```json
8787
{
8888
"markdown": "<filtered content based on role/actor>",

docs/guide/capability-allowlist.md

Lines changed: 19 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -31,8 +31,10 @@ Runtime mutation still happens only through explicit enable flows (`capability_e
3131
Release baseline policy:
3232

3333
1. third-party sources are discoverable by default (`mounted`)
34-
2. runtime flow has no approval gate; enable path is one-step when `enable_supported=true`
35-
3. `blocked` is explicit deny state (policy/source/runtime blocklist), reserved for clear deny signals
34+
2. external capability sources default to usable path (`mounted`) in normal mode
35+
3. conservative users can switch external capability sources back to `indexed` through `external_capability_safety_mode`
36+
4. runtime flow has no approval gate; enable path is one-step when `enable_supported=true`
37+
5. `blocked` is explicit deny state (policy/source/runtime blocklist), reserved for clear deny signals
3638

3739
Runtime blocklist model:
3840

@@ -76,12 +78,22 @@ Web routes map to daemon ops:
7678
3. `PUT /api/v1/capabilities/allowlist`
7779
4. `DELETE /api/v1/capabilities/allowlist`
7880

79-
## 6. Recommended Workflow
81+
## 6. External Capability Safety Mode
82+
83+
`capability_allowlist_get` / `validate` / `update` expose `external_capability_safety_mode` as a thin semantic view over the default posture for external capability sources:
84+
85+
1. `normal` => external capability sources default to `mounted`
86+
2. `conservative` => external capability sources default to `indexed`
87+
88+
Built-in packs are unaffected. Per-source and per-capability overrides can still be stricter.
89+
90+
## 7. Recommended Workflow
8091

8192
1. call `capability_allowlist_get`
82-
2. prepare patch (or full replacement)
83-
3. call `capability_allowlist_validate`
84-
4. apply with `capability_allowlist_update(expected_revision=...)`
85-
5. if mismatch, refetch and retry
93+
2. inspect `external_capability_safety_mode` and current revision
94+
3. prepare patch (or full replacement)
95+
4. call `capability_allowlist_validate`
96+
5. apply with `capability_allowlist_update(expected_revision=...)`
97+
6. if mismatch, refetch and retry
8698

8799
Use `capability_allowlist_reset` to drop overlay and return to packaged default.

docs/release/rc19_file_matrix.csv

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -170,7 +170,7 @@ tests/test_group_template_dirty_settings_tolerance.py,B,tests,standard-file,fixe
170170
tests/test_im_subscribers_tolerance.py,B,tests,standard-file,fixed,qa,guards IM subscriber loader tolerance for dirty bool/int fields
171171
tests/test_group_lifecycle_invariants.py,B,tests,standard-file,fixed,qa,guards group start/stop running+enabled invariants
172172
tests/test_group_automation_baseline.py,B,tests,standard-file,fixed,qa,guards default standup baseline seeding and intentional clear semantics
173-
tests/test_mcp_bootstrap_ledger_tail.py,B,tests,standard-file,reviewed,qa,mcp bootstrap ledger-tail visibility rules reviewed
173+
tests/test_mcp_bootstrap_inbox_preview.py,B,tests,standard-file,reviewed,qa,mcp bootstrap inbox-preview trimming and stable shape reviewed
174174
tests/test_daemon_ipc_docs_parity.py,B,tests,standard-file,fixed,qa,guards daemon IPC op coverage in standards doc
175175
tests/test_docs_blob_path_consistency.py,B,tests,standard-file,fixed,qa,guards architecture blob-path terminology consistency
176176
tests/test_docs_mcp_architecture_surface.py,B,tests,standard-file,fixed,qa,guards architecture MCP surface narrative against legacy drift

0 commit comments

Comments
 (0)