@c4a/context-cli 0.6.1 → 0.6.3

package/plugins/skills/context-init/SKILL.md

@@ -13,22 +13,36 @@ Public Context entry for agents that expose skills instead of slash commands.
 - Public entry: `context-init`
 - Host command names are installation-specific; use the command or skill surfaced by the current host instead of deriving a filesystem path from an example name.
 - CLI primitive prefix: `context ...`
-- Internal procedures live under `references/internal-procedures/`; read each referenced file in full before following that step.
 
 ---
 
 ## Workflow
 
-Initialize a Context workspace with the global CLI, then continue only through
-safe mechanical setup steps until the first human decision gate.
-
-Language policy: explain, ask, confirm, and summarize in the user's current
-conversation language. Keep CLI commands, flags, file paths, package names,
-enum values, payload keys, and copied CLI output tokens unchanged.
-
-Use the procedure in `references/internal-procedures/skill-init-workspace.md` end to end. It owns
-the `context init` invocation, dependency install follow-up, generated
-`AGENTS.md` handoff, status handoff, and stop conditions.
-
-Do not add extra project-local agent setup. Do not infer repo sources or
-extraction scope from the surrounding monorepo after setup.
+Initialize a Context workspace with the global CLI, complete the returned setup
+step, then hand control to the current workflow route.
+
+Use the user's language for conversation. Keep command and payload tokens
+unchanged.
+
+Run `context init [project-dir] [--name <name>] --language <language>`. Use the
+user's explicit language choice when present; otherwise pass `zh-CN` for a
+Chinese conversation and `en` for an English conversation. This explicit CLI
+value controls generated workspace instructions and starter templates. Never
+substitute `.` when `project-dir` was omitted; the default is `context/`. Use
+`--dev` only for an explicitly requested local-link test.
+Add `--debug` only when the user explicitly asks to trace this workspace. Debug
+mode is otherwise off by default.
+
+If init reports `init-target-nonempty`, explain that existing files would share
+the workspace root. Run the returned `--allow-nonempty` command only after
+explicit confirmation.
+
+Execute the returned setup command, enter the project root, and read its
+generated `AGENTS.md`. Then run `context status --format json`, adding
+`--managed` only for fully managed operation explicitly authorized in this
+conversation. Treat `workflow.current` as authoritative: read its required
+resources, execute only exact commands, honor unresolved human gates, and
+reevaluate status after each action.
+
+Do not add extra project-local agent setup or infer sources from the surrounding
+monorepo.

package/providers/context/actions/accept-package-templates.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: accept-package-templates
+runner: command
+effect: write
+command: context package template accept --all --format json

package/providers/context/actions/align-next.yaml

@@ -0,0 +1,6 @@
+schema: agent-graph.action.v1
+id: align-next
+runner: host
+effect: write
+handler: context.align.next
+inputSchema: schemas/prose-structure-batch.schema.json

package/providers/context/actions/apply-managed-review.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: apply-managed-review
+runner: host
+effect: write
+handler: context.review.approve-current

package/providers/context/actions/apply-structure-confirmation.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: apply-structure-confirmation
+runner: host
+effect: write
+handler: context.structure.confirm

package/providers/context/actions/build-next.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: build-next
+runner: command
+effect: write
+command: context build --format json

package/providers/context/actions/capture-next.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: capture-next
+runner: host
+effect: external
+handler: context.capture.next

package/providers/context/actions/close-approved-knowledge.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: close-approved-knowledge
+runner: command
+effect: write
+command: context close --format json

package/providers/context/actions/compile-next.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: compile-next
+runner: host
+effect: write
+handler: context.compile.next

package/providers/context/actions/configure-code-extraction.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: configure-code-extraction
+runner: host
+effect: write
+handler: context.project.configure-extraction

package/providers/context/actions/configure-document-capture.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: configure-document-capture
+runner: host
+effect: write
+handler: context.project.configure-capture

package/providers/context/actions/configure-package-output.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: configure-package-output
+runner: host
+effect: write
+handler: context.project.configure-package

package/providers/context/actions/configure-prose-lifecycle.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: configure-prose-lifecycle
+runner: host
+effect: write
+handler: context.project.configure-prose

package/providers/context/actions/extract-next.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: extract-next
+runner: host
+effect: write
+handler: context.extract.next

package/providers/context/actions/inspect-document-classification.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: inspect-document-classification
+runner: host
+effect: read
+handler: context.document.inspect-classification

package/providers/context/actions/inspect-repository-recovery.yaml

@@ -0,0 +1,6 @@
+schema: agent-graph.action.v1
+id: inspect-repository-recovery
+description: Group missing repository modules by physical checkout and show recovery choices.
+runner: command
+effect: read
+command: context source recovery-plan --format json

package/providers/context/actions/inspect-review.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: inspect-review
+runner: host
+effect: read
+handler: context.review.inspect-current

package/providers/context/actions/inspect-structure.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: inspect-structure
+runner: host
+effect: read
+handler: context.structure.inspect

package/providers/context/actions/maintain-evidence.yaml

@@ -0,0 +1,6 @@
+schema: agent-graph.action.v1
+id: maintain-evidence
+runner: command
+effect: write
+command: context review maintain --input - --format json
+inputSchema: schemas/evidence-maintenance-input.schema.json

package/providers/context/actions/materialize-context-view.yaml

@@ -0,0 +1,8 @@
+schema: agent-graph.action.v1
+id: materialize-context-view
+description: Emit a Context-owned, revision-bound Markdown view supplied by the host adapter.
+runner: script
+effect: read
+entry: scripts/render-context-view.mjs
+runtime: node
+cwd: workspace

package/providers/context/actions/reconcile-review-identities.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: reconcile-review-identities
+runner: host
+effect: write
+handler: context.review.preserve-approved-identities

package/providers/context/actions/register-source-batch.yaml

@@ -0,0 +1,7 @@
+schema: agent-graph.action.v1
+id: register-source-batch
+description: Register the source batch explicitly confirmed in the current conversation.
+runner: command
+effect: write
+command: context source add batch --input - --format json
+inputSchema: schemas/source-batch-input.schema.json

package/providers/context/actions/repair-project-entry.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: repair-project-entry
+runner: host
+effect: write
+handler: context.project.repair-entry

package/providers/context/actions/repair-verification.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: repair-verification
+runner: host
+effect: external
+handler: context.verification.repair-next

package/providers/context/actions/repair-workspace-state.yaml

@@ -0,0 +1,5 @@
+schema: agent-graph.action.v1
+id: repair-workspace-state
+runner: host
+effect: read
+handler: context.workspace.inspect-diagnostics

package/providers/context/actions/restore-repository-sources.yaml

@@ -0,0 +1,7 @@
+schema: agent-graph.action.v1
+id: restore-repository-sources
+description: Restore registered repository sources from user-confirmed local paths or explicit clones.
+runner: command
+effect: external
+command: context source restore --input - --format json
+inputSchema: schemas/repository-source-recovery.schema.json

package/providers/context/codes.yaml

@@ -0,0 +1,41 @@
+schema: agent-graph.code-catalog.v1
+codes:
+  - { code: diagnostic.project-entry-invalid, kind: diagnostic, severity: error, summary: The Context project entry cannot be loaded., document: resources/diagnostics/workspace-state.md }
+  - { code: diagnostic.workspace-state-invalid, kind: diagnostic, severity: error, summary: Context cannot establish valid lifecycle facts for the workspace., document: resources/diagnostics/workspace-state.md }
+  - { code: diagnostic.structure-snapshot-invalid, kind: diagnostic, severity: error, summary: An active source-bound structure snapshot is invalid., document: resources/diagnostics/workspace-state.md }
+  - { code: diagnostic.phase-source-unresolved, kind: diagnostic, severity: error, summary: A document lifecycle phase cannot resolve its canonical source., document: resources/diagnostics/workspace-state.md }
+  - { code: diagnostic.structure-route-unresolved, kind: diagnostic, severity: error, summary: A staged structure cannot resolve to one source and collection lifecycle., document: resources/diagnostics/workspace-state.md }
+  - { code: diagnostic.compile-route-ambiguous, kind: diagnostic, severity: error, summary: More than one compile lifecycle owns the same source and collection., document: resources/diagnostics/workspace-state.md }
+  - { code: diagnostic.structure-snapshot-missing, kind: diagnostic, severity: error, summary: A compile batch references a missing confirmed structure snapshot., document: resources/diagnostics/workspace-state.md }
+  - { code: diagnostic.verify-failed, kind: diagnostic, severity: error, summary: Verification found one or more blocking findings., document: resources/diagnostics/verification.md }
+  - { code: diagnostic.projection-stale, kind: diagnostic, severity: info, summary: Approved knowledge changed and deterministic close must refresh its derived projection., document: resources/diagnostics/projection-stale.md }
+  - { code: diagnostic.evidence-degraded, kind: diagnostic, severity: warning, summary: Approved knowledge has evidence that cannot currently be rechecked., document: resources/diagnostics/verification.md }
+  - { code: diagnostic.evidence-stale, kind: diagnostic, severity: warning, summary: Approved knowledge evidence is stale against its registered source., document: resources/diagnostics/verification.md }
+  - { code: diagnostic.evidence-orphaned, kind: diagnostic, severity: warning, summary: Approved knowledge no longer resolves to registered source evidence., document: resources/diagnostics/verification.md }
+  - { code: route.workspace.project-entry-invalid, kind: route-reason, summary: Repair the Context project entry before continuing., document: resources/procedures/project-configuration.md }
+  - { code: route.workspace.state-invalid, kind: route-reason, summary: Inspect and repair the invalid workspace facts., document: resources/diagnostics/workspace-state.md }
+  - { code: route.verify.failed, kind: route-reason, summary: Resolve blocking verification findings before other lifecycle writes., document: resources/procedures/verify-and-repair.md }
+  - { code: route.evidence.decision-required, kind: route-reason, summary: A source-evidence change needs an explicit maintenance decision., document: resources/procedures/evidence-maintenance.md }
+  - { code: route.evidence.maintenance-required, kind: route-reason, summary: Apply the selected evidence-maintenance action., document: resources/procedures/evidence-maintenance.md }
+  - { code: route.source.boundary-required, kind: route-reason, summary: No knowledge source boundary has been registered., document: resources/procedures/source-boundary.md }
+  - { code: route.source.repository-not-ready, kind: route-reason, summary: A registered repository checkout or local source link must be restored., document: resources/procedures/repository-source-recovery.md }
+  - { code: route.capture.configuration-required, kind: route-reason, summary: Registered document sources are missing capture declarations., document: resources/procedures/project-configuration.md }
+  - { code: route.capture.permission-required, kind: route-reason, summary: External document capture requires source-read permission., document: resources/procedures/document-capture.md }
+  - { code: route.capture.pending-target, kind: route-reason, summary: Capture the next declared document target., document: resources/procedures/document-capture.md }
+  - { code: route.extract.scope-required, kind: route-reason, summary: Code extraction scope has not been confirmed., document: resources/procedures/code-extraction.md }
+  - { code: route.extract.configuration-required, kind: route-reason, summary: Registered repository sources are missing extraction declarations., document: resources/procedures/project-configuration.md }
+  - { code: route.extract.pending-target, kind: route-reason, summary: Extract the next pending code target before another workflow family., document: resources/procedures/code-extraction.md }
+  - { code: route.document.classification-required, kind: route-reason, summary: A captured document needs an evidence-backed collection decision., document: resources/procedures/document-classification.md }
+  - { code: route.prose.configuration-required, kind: route-reason, summary: A document target is missing a complete prose lifecycle declaration., document: resources/procedures/project-configuration.md }
+  - { code: route.structure.pending-target, kind: route-reason, summary: Prepare the next document structure slot from source evidence., document: resources/procedures/prose-align.md }
+  - { code: route.structure.confirmation-required, kind: route-reason, summary: A staged structure is waiting for confirmation., document: resources/procedures/prose-align.md }
+  - { code: route.structure.confirm, kind: route-reason, summary: Persist the confirmed structure slot., document: resources/procedures/prose-align.md }
+  - { code: route.compile.pending-target, kind: route-reason, summary: Compile the next planned source-bound knowledge view., document: resources/procedures/prose-compile.md }
+  - { code: route.review.identity-conflict, kind: route-reason, summary: Preserve approved ViewRef and path identity before Review., document: resources/procedures/knowledge-review.md }
+  - { code: route.review.decision-required, kind: route-reason, summary: The complete current candidate batch needs one review decision set., document: resources/procedures/knowledge-review.md }
+  - { code: route.review.apply-managed, kind: route-reason, summary: Apply the current candidate batch under explicit session-managed authority., document: resources/procedures/knowledge-review.md }
+  - { code: route.close.projection-stale, kind: route-reason, summary: Rebuild the deterministic approved structure projection., document: resources/procedures/close-and-build.md }
+  - { code: route.package.output-required, kind: route-reason, summary: Approved knowledge has no confirmed package output., document: resources/procedures/package-output.md }
+  - { code: route.package.configuration-required, kind: route-reason, summary: Declare the confirmed package output in the Context project., document: resources/procedures/package-output.md }
+  - { code: route.package.template-review-required, kind: route-reason, summary: "Replace or edit package templates, or explicitly accept the generic defaults.", document: resources/procedures/package-output.md }
+  - { code: route.build.package-stale, kind: route-reason, summary: Build the declared package outputs from current approved knowledge., document: resources/procedures/close-and-build.md }