@c4a/context-cli 0.6.1 → 0.6.2

package/providers/context/codes.yaml

@@ -0,0 +1,40 @@
+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 source is not ready locally., document: resources/procedures/source-boundary.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.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 }

package/providers/context/graphs/workspace.yaml

@@ -0,0 +1,494 @@
+schema: agent-graph.graph.v1
+id: workspace
+description: Fact-grounded lifecycle for a Context knowledge workspace.
+entrypoints:
+  continue: repair-project-entry
+nodes:
+  - id: repair-project-entry
+    kind: action
+    reasonCode: route.workspace.project-entry-invalid
+    action: actions/repair-project-entry.yaml
+    satisfiedBy:
+      - path: workspace.project_entry_valid
+        equals: true
+    resources:
+      required:
+        - resources/procedures/project-configuration.md
+        - resources/manuals/reference/project-api.md
+      recommended: [resources/diagnostics/workspace-state.md]
+
+  - id: repair-workspace-state
+    kind: action
+    reasonCode: route.workspace.state-invalid
+    action: actions/repair-workspace-state.yaml
+    satisfiedBy:
+      - path: workspace.state_valid
+        equals: true
+    resources:
+      required:
+        - resources/diagnostics/workspace-state.md
+        - resources/views/workspace-current.yaml
+
+  - id: repair-verification
+    kind: action
+    reasonCode: route.verify.failed
+    action: actions/repair-verification.yaml
+    satisfiedBy:
+      - path: verification.blocking_clear
+        equals: true
+    resources:
+      required:
+        - resources/procedures/verify-and-repair.md
+        - resources/views/verification-current.yaml
+      recommended: [resources/diagnostics/verification.md]
+
+  - id: choose-evidence-maintenance
+    kind: gate
+    reasonCode: route.evidence.decision-required
+    resolutionAction: actions/maintain-evidence.yaml
+    gate:
+      id: evidence-maintenance
+      prompt: Decide how to handle approved knowledge whose source evidence moved or disappeared.
+      authority: context.evidence-maintenance
+      delegatable: false
+    satisfiedBy:
+      - path: gates.evidence_maintenance_resolved
+        equals: true
+    resources:
+      required:
+        - resources/procedures/evidence-maintenance.md
+        - resources/dialogue/human-gates.md
+        - resources/dialogue/evidence-maintenance.md
+        - resources/views/verification-current.yaml
+
+  - id: maintain-evidence
+    kind: action
+    reasonCode: route.evidence.maintenance-required
+    action: actions/maintain-evidence.yaml
+    satisfiedBy:
+      - path: evidence.maintenance_clear
+        equals: true
+    resources:
+      required:
+        - resources/procedures/evidence-maintenance.md
+        - resources/views/verification-current.yaml
+      recommended: [resources/diagnostics/verification.md]
+
+  - id: resume-prose-lifecycle
+    kind: action
+    reasonCode: route.prose.configuration-required
+    action: actions/configure-prose-lifecycle.yaml
+    satisfiedBy:
+      - path: resume.prose_declarations_complete
+        equals: true
+    resources:
+      required:
+        - resources/procedures/project-configuration.md
+        - resources/procedures/document-classification.md
+        - resources/views/structure-current.yaml
+        - resources/manuals/reference/project-api.md
+
+  - id: confirm-structure
+    kind: gate
+    reasonCode: route.structure.confirmation-required
+    inspectionAction: actions/inspect-structure.yaml
+    gate:
+      id: structure-confirmation
+      prompt: Confirm the proposed knowledge structure before candidates are compiled.
+      authority: context.structure-confirmation
+      delegatable: true
+    satisfiedBy:
+      - path: resume.structure_confirmation_resolved
+        equals: true
+    resources:
+      required:
+        - resources/procedures/prose-align.md
+        - resources/dialogue/human-gates.md
+        - resources/dialogue/structure-confirmation.md
+        - resources/views/structure-current.yaml
+
+  - id: apply-structure-confirmation
+    kind: action
+    reasonCode: route.structure.confirm
+    action: actions/apply-structure-confirmation.yaml
+    satisfiedBy:
+      - path: resume.structure_confirmed
+        equals: true
+    resources:
+      required:
+        - resources/procedures/prose-align.md
+        - resources/views/structure-current.yaml
+
+  - id: compile-next
+    kind: action
+    reasonCode: route.compile.pending-target
+    action: actions/compile-next.yaml
+    satisfiedBy:
+      - path: resume.compile_complete
+        equals: true
+    resources:
+      required:
+        - resources/procedures/prose-compile.md
+      recommended:
+        - resources/views/structure-current.yaml
+        - resources/semantic/compile/index.md
+
+  - id: resume-review-current-batch
+    kind: gate
+    reasonCode: route.review.decision-required
+    inspectionAction: actions/inspect-review.yaml
+    gate:
+      id: knowledge-review
+      prompt: Review the complete current document candidate batch before it enters approved knowledge.
+      authority: context.knowledge-review
+      delegatable: true
+    satisfiedBy:
+      - path: resume.knowledge_review_resolved
+        equals: true
+    resources:
+      required:
+        - resources/procedures/knowledge-review.md
+        - resources/dialogue/human-gates.md
+        - resources/dialogue/knowledge-review.md
+        - resources/views/review-current.yaml
+
+  - id: apply-resumed-review
+    kind: action
+    reasonCode: route.review.apply-managed
+    action: actions/apply-managed-review.yaml
+    satisfiedBy:
+      - path: resume.review_gate_clear
+        equals: true
+    resources:
+      required:
+        - resources/procedures/knowledge-review.md
+        - resources/views/review-current.yaml
+
+  - id: choose-source-boundary
+    kind: gate
+    reasonCode: route.source.boundary-required
+    gate:
+      id: source-boundary
+      prompt: Choose the repositories, modules, or documents that may become knowledge sources.
+      authority: context.source-boundary
+      delegatable: false
+    resolutionAction: actions/register-source-batch.yaml
+    satisfiedBy:
+      - path: sources.registered
+        equals: true
+    resources:
+      required:
+        - resources/procedures/source-boundary.md
+        - resources/dialogue/human-gates.md
+        - resources/dialogue/source-boundary.md
+        - resources/views/source-current.yaml
+      recommended:
+        - resources/procedures/source-capture-detailed.md
+
+  - id: ensure-repository-sources
+    kind: action
+    reasonCode: route.source.repository-not-ready
+    action: actions/ensure-repository-sources.yaml
+    satisfiedBy:
+      - path: sources.repositories_ready
+        equals: true
+    resources:
+      required:
+        - resources/procedures/source-boundary.md
+        - resources/views/source-current.yaml
+
+  - id: configure-document-capture
+    kind: action
+    reasonCode: route.capture.configuration-required
+    action: actions/configure-document-capture.yaml
+    satisfiedBy:
+      - path: capture.declarations_complete
+        equals: true
+    resources:
+      required:
+        - resources/procedures/project-configuration.md
+        - resources/manuals/reference/project-api.md
+      recommended:
+        - resources/procedures/document-capture.md
+        - resources/views/source-current.yaml
+
+  - id: authorize-document-capture
+    kind: gate
+    reasonCode: route.capture.permission-required
+    gate:
+      id: source-read-permission
+      prompt: Allow Context to read the registered external document sources for this capture.
+      authority: context.source-read
+      delegatable: false
+    satisfiedBy:
+      - path: gates.source_read_resolved
+        equals: true
+    resources:
+      required:
+        - resources/procedures/document-capture.md
+        - resources/dialogue/human-gates.md
+        - resources/dialogue/document-capture.md
+        - resources/views/source-current.yaml
+      recommended:
+        - resources/procedures/source-capture-detailed.md
+
+  - id: capture-next
+    kind: action
+    reasonCode: route.capture.pending-target
+    action: actions/capture-next.yaml
+    satisfiedBy:
+      - path: capture.complete
+        equals: true
+    resources:
+      required:
+        - resources/procedures/document-capture.md
+        - resources/views/source-current.yaml
+      recommended:
+        - resources/procedures/source-capture-detailed.md
+
+  - id: choose-extraction-scope
+    kind: gate
+    reasonCode: route.extract.scope-required
+    gate:
+      id: extraction-scope
+      prompt: Confirm which registered code modules and symbol boundaries should enter code knowledge.
+      authority: context.extraction-scope
+      delegatable: true
+    satisfiedBy:
+      - path: gates.extraction_scope_resolved
+        equals: true
+    resources:
+      required:
+        - resources/procedures/code-extraction.md
+        - resources/dialogue/human-gates.md
+        - resources/dialogue/code-extraction.md
+        - resources/views/source-current.yaml
+      recommended:
+        - resources/procedures/source-capture-detailed.md
+
+  - id: configure-code-extraction
+    kind: action
+    reasonCode: route.extract.configuration-required
+    action: actions/configure-code-extraction.yaml
+    satisfiedBy:
+      - path: extract.declarations_complete
+        equals: true
+    resources:
+      required:
+        - resources/procedures/project-configuration.md
+        - resources/procedures/code-extraction.md
+        - resources/views/source-current.yaml
+        - resources/manuals/reference/project-api.md
+
+  - id: extract-next
+    kind: action
+    reasonCode: route.extract.pending-target
+    action: actions/extract-next.yaml
+    satisfiedBy:
+      - path: extract.complete
+        equals: true
+    resources:
+      required:
+        - resources/procedures/code-extraction.md
+        - resources/views/source-current.yaml
+
+  - id: classify-document
+    kind: gate
+    reasonCode: route.document.classification-required
+    inspectionAction: actions/inspect-document-classification.yaml
+    gate:
+      id: document-classification
+      prompt: Confirm the evidence-backed knowledge collection for the next captured document.
+      authority: context.document-classification
+      delegatable: true
+    satisfiedBy:
+      - path: gates.document_classification_resolved
+        equals: true
+    resources:
+      required:
+        - resources/procedures/document-classification.md
+        - resources/dialogue/human-gates.md
+        - resources/dialogue/document-classification.md
+        - resources/views/source-current.yaml
+
+  - id: configure-prose-lifecycle
+    kind: action
+    reasonCode: route.prose.configuration-required
+    action: actions/configure-prose-lifecycle.yaml
+    satisfiedBy:
+      - path: prose.declarations_complete
+        equals: true
+    resources:
+      required:
+        - resources/procedures/project-configuration.md
+        - resources/procedures/document-classification.md
+        - resources/views/structure-current.yaml
+        - resources/manuals/reference/project-api.md
+
+  - id: align-next
+    kind: action
+    reasonCode: route.structure.pending-target
+    action: actions/align-next.yaml
+    satisfiedBy:
+      - path: align.prepared
+        equals: true
+    resources:
+      required:
+        - resources/procedures/prose-align.md
+        - resources/views/structure-current.yaml
+      recommended:
+        - resources/semantic/align/structure-planning.md
+        - resources/semantic/align/gates.md
+        - resources/semantic/align/density-profile.md
+        - resources/semantic/align/candidate-resolution.md
+
+  - id: review-current-batch
+    kind: gate
+    reasonCode: route.review.decision-required
+    inspectionAction: actions/inspect-review.yaml
+    gate:
+      id: knowledge-review
+      prompt: Review the complete current candidate batch before it enters approved knowledge.
+      authority: context.knowledge-review
+      delegatable: true
+    satisfiedBy:
+      - path: gates.knowledge_review_resolved
+        equals: true
+    resources:
+      required:
+        - resources/procedures/knowledge-review.md
+        - resources/dialogue/human-gates.md
+        - resources/dialogue/knowledge-review.md
+        - resources/views/review-current.yaml
+
+  - id: apply-managed-review
+    kind: action
+    reasonCode: route.review.apply-managed
+    action: actions/apply-managed-review.yaml
+    satisfiedBy:
+      - path: review.gate_clear
+        equals: true
+    resources:
+      required:
+        - resources/procedures/knowledge-review.md
+        - resources/views/review-current.yaml
+
+  - id: close-approved-knowledge
+    kind: action
+    reasonCode: route.close.projection-stale
+    action: actions/close-approved-knowledge.yaml
+    satisfiedBy:
+      - path: close.current
+        equals: true
+    resources:
+      required:
+        - resources/procedures/close-and-build.md
+        - resources/views/verification-current.yaml
+      recommended:
+        - resources/diagnostics/projection-stale.md
+
+  - id: choose-package-output
+    kind: gate
+    reasonCode: route.package.output-required
+    gate:
+      id: package-output
+      prompt: Choose how approved knowledge should be packaged for downstream consumers.
+      authority: context.package-output
+      delegatable: true
+    satisfiedBy:
+      - path: gates.package_output_resolved
+        equals: true
+    resources:
+      required:
+        - resources/procedures/package-output.md
+        - resources/dialogue/human-gates.md
+        - resources/dialogue/package-output.md
+        - resources/views/package-current.yaml
+      recommended:
+        - resources/manuals/guides/package-outputs.md
+        - resources/manuals/reference/package-templates.md
+        - resources/manuals/reference/template-variables.md
+
+  - id: configure-package-output
+    kind: action
+    reasonCode: route.package.configuration-required
+    action: actions/configure-package-output.yaml
+    satisfiedBy:
+      - path: packages.declared
+        equals: true
+    resources:
+      required:
+        - resources/procedures/project-configuration.md
+        - resources/procedures/package-output.md
+        - resources/views/package-current.yaml
+      recommended:
+        - resources/manuals/guides/package-outputs.md
+        - resources/manuals/reference/project-api.md
+        - resources/manuals/reference/package-templates.md
+        - resources/manuals/reference/template-variables.md
+
+  - id: build-next
+    kind: action
+    reasonCode: route.build.package-stale
+    action: actions/build-next.yaml
+    satisfiedBy:
+      - path: packages.current
+        equals: true
+    resources:
+      required:
+        - resources/procedures/close-and-build.md
+        - resources/views/package-current.yaml
+
+  - id: review-package-template
+    kind: gate
+    reasonCode: route.package.template-review-required
+    resolutionAction: actions/accept-package-templates.yaml
+    gate:
+      id: package-template-review
+      prompt: Replace or edit the declared package templates, or explicitly accept the unchanged generic defaults.
+      authority: context.package-template-review
+      delegatable: true
+    satisfiedBy:
+      - path: packages.templates_reviewed
+        equals: true
+    resources:
+      required:
+        - resources/procedures/package-output.md
+        - resources/dialogue/human-gates.md
+        - resources/views/package-current.yaml
+        - resources/manuals/reference/package-templates.md
+
+  - id: current-scope-complete
+    kind: terminal
+    terminalOutcome: completed
+
+edges:
+  - { from: repair-project-entry, to: repair-workspace-state }
+  - { from: repair-workspace-state, to: repair-verification }
+  - { from: repair-verification, to: choose-evidence-maintenance }
+  - { from: choose-evidence-maintenance, to: maintain-evidence, kind: gatedBy }
+  - { from: maintain-evidence, to: close-approved-knowledge }
+  - { from: close-approved-knowledge, to: resume-prose-lifecycle }
+  - { from: resume-prose-lifecycle, to: confirm-structure }
+  - { from: confirm-structure, to: apply-structure-confirmation, kind: gatedBy }
+  - { from: apply-structure-confirmation, to: compile-next }
+  - { from: compile-next, to: resume-review-current-batch }
+  - { from: resume-review-current-batch, to: apply-resumed-review, kind: gatedBy }
+  - { from: apply-resumed-review, to: choose-source-boundary }
+  - { from: choose-source-boundary, to: ensure-repository-sources, kind: gatedBy }
+  - { from: ensure-repository-sources, to: configure-document-capture }
+  - { from: configure-document-capture, to: authorize-document-capture }
+  - { from: authorize-document-capture, to: capture-next, kind: gatedBy }
+  - { from: capture-next, to: choose-extraction-scope }
+  - { from: choose-extraction-scope, to: configure-code-extraction, kind: gatedBy }
+  - { from: configure-code-extraction, to: extract-next }
+  - { from: extract-next, to: review-current-batch }
+  - { from: review-current-batch, to: apply-managed-review, kind: gatedBy }
+  - { from: apply-managed-review, to: classify-document }
+  - { from: classify-document, to: configure-prose-lifecycle, kind: gatedBy }
+  - { from: configure-prose-lifecycle, to: align-next }
+  - { from: align-next, to: choose-package-output }
+  - { from: choose-package-output, to: configure-package-output, kind: gatedBy }
+  - { from: configure-package-output, to: review-package-template }
+  - { from: review-package-template, to: build-next, kind: gatedBy }
+  - { from: build-next, to: current-scope-complete }