Skip to content

Commit a0d32b5

Browse files
committed
Finalize Phase 12 governance claims cleanup
1 parent 47f88d6 commit a0d32b5

4 files changed

Lines changed: 13 additions & 13 deletions

File tree

PROJEKT.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,7 @@ git push
8686
| **Phase 9** | Validate and Benchmark | Local validation, dry-runs, and deterministic benchmark flows | **COMPLETE** |
8787
| **Phase 10** | MVP Stabilization & Release Readiness | Audit documentation, verify command flows, safety hygiene checks | **COMPLETE** |
8888
| **Phase 11** | Release Packaging | Package CLI binary, finalize manifests, release artifact generation | **COMPLETE** |
89-
| **Phase 12** | Antigravity CLI Governance & Token Economy | Hook, registry token bindings, runtime stake checks | **COMPLETE** |
89+
| **Phase 12** | Antigravity CLI Governance & Token Economy | Antigravity governance docs, token economy rules, skill/hook/permission target architecture | **COMPLETE** |
9090
| **Phase 13** | Skill Bundle Registry | Distributed skills indexing and integrity hashing | *NEXT* |
9191
| **Phase 14** | Hook/Permission Integration | Hook boundaries, dynamic run approvals | *QUEUED* |
9292
| **Phase 15** | Cryptographic Provenance Engine | Signed evidence trail generation and cryptographic integrity seals | *QUEUED* |

docs/ANTIGRAVITY_CLI_INTEGRATION.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,8 @@ CompText operates under a strict separation of concerns between agent execution
1111
- **Antigravity CLI is the Agent Execution Surface**: Handles task orchestration, command execution, tool invocations, and subagent lifecycle management.
1212
- **CompText CLI (`ctxt`) is the Context, Policy, and Evidence Control Plane**: Manages deterministic context packaging, proposal audits, file-write validation gates, and safety constraints.
1313
- **Skills are progressive context-loading capsules**: Bounded guidelines designed to prevent context bloat and restrict agent operations.
14-
- **Hooks are policy-interceptor targets**: Structural interception points allowing verification before, during, and after agent activities.
15-
- **Permissions are defense-in-depth, not the source of truth**: Hard platform sandboxing boundaries that back up (but do not replace) the repository safety constitution.
14+
- **Hooks are policy-interceptor targets (target architecture)**: Planned structural interception points designed for verifying before, during, and after agent activities, not locally active in the current implementation.
15+
- **Permissions are defense-in-depth, not the source of truth**: Runtime/orchestrator permission boundaries that back up (but do not replace) the repository safety constitution.
1616
- **Subagents are bounded specialist reviewers**: Highly targeted, read-only assistants delegated for review rather than autonomous development.
1717
- **The source of truth remains the code repository**: Safety constitution (`AGENTS.md`), project tracker (`PROJEKT.md`), CompText configurations, the Proposal/Apply Gate, and local validation commands.
1818

@@ -46,4 +46,4 @@ flowchart TD
4646

4747
1. **Context Harvesting**: Before launching a task, the Antigravity Orchestrator executes `ctxt context pack --task "<task_description>"`. This harvest sanitizes the repository state, redacting secrets and building a deterministic Context Pack under `.comptext/context_pack.latest.json`.
4848
2. **Proposal Generation**: When proposing changes, the agent runs `ctxt propose --provider dummy "<prompt>"`. This creates a structured JSON patch proposal under `proposals/` without mutating source files. Note that `proposals/` contains ignored/generated runtime state and is excluded from Git tracking in the release package baseline.
49-
3. **Apply and Verification**: To modify the codebase, the agent calls `ctxt apply <proposal_path>`. The CompText control plane intercepts the request, validates that target files lie within allowed write boundaries, prompts for user confirmation (or validation suite success), applies the patches, and runs local tests.
49+
3. **Apply and Verification**: To modify the codebase, the agent calls `ctxt apply <proposal_path>`. The CompText CLI validates write boundaries and runs local verification (checking path-traversal safety, prompting for user confirmation, applying the patches, and executing validation tests). Interceptor hook checks (such as PreToolUse or PostToolUse) represent planned target architecture only and do not execute during runtime apply operations.

docs/PERMISSIONS_MODEL.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -16,14 +16,14 @@ If a hook fails or an agent attempts to bypass logical constraints, the orchestr
1616

1717
---
1818

19-
## 2. Permission Scopes
19+
## 2. Intended Permission Scopes (Target Baseline)
2020

21-
The active execution environment is partitioned into narrow permission scopes:
21+
The target host policy baseline for the runtime environment is partitioned into the following intended permission scopes:
2222

23-
- **Read Access**: Restricted to the repository workspace directory. Reading files under `/etc`, `C:\Windows`, system temp directories, or user home directories (outside the workspace) is denied by default.
24-
- **Write Access**: Restricted to allowed targets within the workspace. Writing to system folders or configuration targets outside the project root is denied.
25-
- **Network Access**: Denied by default. Enforces blockades on remote socket connections.
26-
- **Provider Access**: Denied by default. Enforces blockades on calling external LLM providers or remote endpoints unless the phase explicitly authorizes mock or local integrations.
23+
- **Read Access**: Restricted to the repository workspace directory. The intended permission baseline is that reading system paths (such as `/etc`, `C:\Windows`, system temp directories, or user home directories outside the workspace) should be denied by default. CompText treats this as a required orchestrator constraint, not a Rust-level guarantee.
24+
- **Write Access**: Restricted to allowed targets within the workspace. Target host policy should deny writing to system folders or configuration targets outside the project root.
25+
- **Network Access**: Denied by default. The intended permission baseline is that remote socket connections should be blocked by the orchestrator unless network access is explicitly authorized for the active phase.
26+
- **Provider Access**: Denied by default. Target host policy should block calling external LLM providers or remote endpoints unless the phase explicitly authorizes mock or local integrations.
2727

2828
---
2929

reports/phase_12_status.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -44,9 +44,9 @@
4444
- **SECRETS**: Redacted from all configurations and outputs.
4545
- **POLICY_DECISIONS**:
4646
- Bounded agent run token guidelines to prevent context window bloat.
47-
- Formulated hook interceptor checkpoints (SessionStart, PreToolUse, PostToolUse, PostPhase).
48-
- Defined permissions boundaries and subagent review constraints.
49-
- **RISKS**: None. All new documents conform strictly to honest claims policies.
47+
- Formulated hook target architecture for intended enforcement (SessionStart, PreToolUse, PostToolUse, PostPhase).
48+
- Defined target permissions boundaries and subagent review constraints.
49+
- **RISKS**: Hook and permission documents are design targets until implemented/enforced by the host. All new documents conform strictly to honest claims policies.
5050
- **NEXT**: Phase 13: Skill Bundle Registry
5151

5252
---

0 commit comments

Comments
 (0)