@c4a/context-cli 0.7.5 → 0.7.9

package/providers/context/graphs/indexer.yaml

@@ -1,7 +1,12 @@
 schema: agent-graph.graph.v1
 id: indexer
-description: Static Agent route for one digest-bound Indexer workset.
+description: Static Agent route for digest-bound Indexer work, including ready-theme delivery followed by resumption of remaining planning.
 entrypoints:
+  maintenance: advance-knowledge-maintenance
+  source-update: inspect-source-update
+  approved-revision: author-approved-revision
+  approved-revision-recovery: merge-approved-revision
+  update-structure-review: review-current-indexer-structure
   agent-step: run-indexer-agent-step
   provider-selection: configure-indexer-providers
   current-provider-resolution: resolve-current-indexer-provider
@@ -23,6 +28,41 @@ entrypoints:
   candidate-compile: compile-indexer-candidates
   incremental-impact: report-indexer-incremental-impact
 nodes:
+  - id: merge-approved-revision
+    kind: action
+    reasonCode: route.indexer.approved-revision-recovery
+    action: actions/author-approved-revision.yaml
+    resources:
+      required:
+        - resources/procedures/approved-revision.md
+  - id: advance-knowledge-maintenance
+    kind: action
+    reasonCode: route.indexer.maintenance
+    action: actions/advance-knowledge-maintenance.yaml
+    resources:
+      recommended:
+        - resources/procedures/knowledge-maintenance.md
+  - id: inspect-source-update
+    kind: action
+    reasonCode: route.indexer.source-update
+    action: actions/inspect-source-update.yaml
+    resources:
+      required:
+        - resources/procedures/source-update.md
+        - resources/procedures/knowledge-updates.md
+      recommended:
+        - resources/procedures/note.md
+        - resources/procedures/sessions.md
+  - id: author-approved-revision
+    kind: action
+    reasonCode: route.indexer.approved-revision
+    action: actions/author-approved-revision.yaml
+    resources:
+      required:
+        - resources/procedures/approved-revision.md
+      recommended:
+        - resources/procedures/note.md
+        - resources/procedures/sessions.md
   - id: advance-current-indexer-lifecycle
     kind: action
     reasonCode: route.indexer.lifecycle-advance
@@ -30,6 +70,10 @@ nodes:
     satisfiedBy:
       - path: indexer_current.advance_complete
         equals: true
+    resources:
+      required:
+        - resources/procedures/homogeneous-source-review.md
+
   - id: run-current-indexer-agent
     kind: action
     reasonCode: route.indexer.agent-step
@@ -39,8 +83,26 @@ nodes:
         equals: true
     resources:
       required:
+        - resources/procedures/parallel-agent-batch.md
+        - resources/procedures/homogeneous-source-review.md
         - resources/views/resolved-indexer-instructions.yaml
         - resources/views/authorized-indexer-workset-view.yaml
+      recommended:
+        - resources/templates/indexer-agent-worker.md
+        - resources/procedures/work-start-report.md
+        - resources/templates/work-start-report.md
+  - id: confirm-current-indexer-obsolete-scope
+    kind: gate
+    reasonCode: route.indexer.obsolete-scope-confirmation
+    resolutionAction: actions/resolve-current-indexer-gate.yaml
+    gate:
+      id: indexer-obsolete-scope-confirmation
+      prompt: Resolve the obsolete scope against the current user request and existing requirements. Reuse an applicable explicit include/exclude decision or explicit delegation of this scope choice; managed review authorization alone does not decide scope. Otherwise explain the affected pages, files and consequences, ask the user and wait. This is a scope question, not a CLI failure. Inspect the full structure before submitting its approval or exclusion action.
+      authority: context.knowledge-review
+      delegatable: true
+    satisfiedBy:
+      - path: indexer_current.obsolete_scope_confirmed
+        equals: true
   - id: review-current-indexer-structure
     kind: gate
     reasonCode: route.indexer.semantic-structure-review
@@ -91,6 +153,13 @@ nodes:
     kind: action
     reasonCode: route.indexer.provider-configuration
     action: actions/configure-indexer-providers.yaml
+    resources:
+      required:
+        - resources/procedures/homogeneous-source-review.md
+        - resources/contracts/indexer-provider-guide.yaml
+      recommended:
+        - resources/procedures/work-start-report.md
+        - resources/templates/work-start-report.md
   - id: resolve-current-indexer-provider
     kind: action
     reasonCode: route.indexer.provider-host-resolution-required
@@ -116,6 +185,9 @@ nodes:
     kind: action
     reasonCode: route.indexer.markdown-provider-discovery
     action: actions/discover-markdown-indexer-providers.yaml
+    resources:
+      required:
+        - resources/contracts/indexer-provider-guide.yaml
   - id: route-markdown-indexer-provider-selection
     kind: action
     reasonCode: route.indexer.provider-selection
@@ -124,6 +196,9 @@ nodes:
     kind: action
     reasonCode: route.indexer.community-fallback
     action: actions/configure-community-indexer-fallback.yaml
+    resources:
+      required:
+        - resources/contracts/indexer-provider-guide.yaml
   - id: route-markdown-community-indexer-fallback
     kind: action
     reasonCode: route.indexer.provider-selection
@@ -191,6 +266,9 @@ nodes:
     kind: action
     reasonCode: route.indexer.community-fallback
     action: actions/configure-community-indexer-fallback.yaml
+    resources:
+      required:
+        - resources/contracts/indexer-provider-guide.yaml
   - id: route-community-indexer-fallback
     kind: action
     reasonCode: route.indexer.provider-selection
@@ -217,6 +295,9 @@ nodes:
     join: any
     reasonCode: route.indexer.customization-proposal
     action: actions/propose-indexer-customization.yaml
+    resources:
+      required:
+        - resources/contracts/indexer-provider-guide.yaml
   - id: validate-indexer-customization
     kind: action
     reasonCode: route.indexer.customization-validation
@@ -225,6 +306,9 @@ nodes:
     kind: action
     reasonCode: route.indexer.customization-project-preparation
     action: actions/prepare-indexer-customization-project.yaml
+    resources:
+      required:
+        - resources/contracts/indexer-provider-guide.yaml
   - id: indexer-customization-validation-required
     kind: terminal
     terminalOutcome: partial
@@ -237,8 +321,14 @@ nodes:
     action: actions/run-indexer-agent-step.yaml
     resources:
       required:
+        - resources/procedures/parallel-agent-batch.md
+        - resources/procedures/homogeneous-source-review.md
         - resources/views/resolved-indexer-instructions.yaml
         - resources/views/authorized-indexer-workset-view.yaml
+      recommended:
+        - resources/templates/indexer-agent-worker.md
+        - resources/procedures/work-start-report.md
+        - resources/templates/work-start-report.md
   - id: propose-overlay-question-amendment
     kind: action
     reasonCode: route.indexer.overlay-question-proposal
@@ -375,7 +465,8 @@ nodes:
     terminalOutcome: completed
 edges:
   - { from: advance-current-indexer-lifecycle, to: run-current-indexer-agent }
-  - { from: run-current-indexer-agent, to: review-current-indexer-structure }
+  - { from: run-current-indexer-agent, to: confirm-current-indexer-obsolete-scope }
+  - { from: confirm-current-indexer-obsolete-scope, to: review-current-indexer-structure, kind: gatedBy }
   - { from: review-current-indexer-structure, to: run-current-indexer-composer, kind: gatedBy }
   - { from: run-current-indexer-composer, to: resolve-current-indexer-block }
   - { from: resolve-current-indexer-block, to: confirm-current-indexer-layout, kind: gatedBy }

package/providers/context/graphs/workspace.yaml

@@ -3,7 +3,18 @@ id: workspace
 description: Fact-grounded lifecycle for a Context knowledge workspace.
 entrypoints:
   context: repair-project-entry
+  rollback: close-rollback
+  recovery: inspect-task-recovery
 nodes:
+  - id: inspect-task-recovery
+    kind: action
+    reasonCode: route.workspace.recovery
+    action: actions/inspect-task-recovery.yaml
+    resources:
+      required:
+        - resources/procedures/task-recovery.md
+        - resources/templates/recovery-issue.md
+
   - id: repair-project-entry
     kind: action
     reasonCode: route.workspace.project-entry-invalid
@@ -28,6 +39,10 @@ nodes:
       required:
         - resources/diagnostics/workspace-state.md
         - resources/views/workspace-current.yaml
+      recommended:
+        - resources/procedures/workspace-prepare.md
+        - resources/procedures/workspace-restore.md
+        - resources/procedures/task-recovery.md
 
   - id: repair-verification
     kind: action
@@ -82,10 +97,9 @@ nodes:
       - path: close.current
         equals: true
     resources:
-      required:
+      recommended:
         - resources/procedures/close-and-build.md
         - resources/views/verification-current.yaml
-      recommended:
         - resources/diagnostics/projection-stale.md
 
   - id: choose-source-boundary
@@ -93,7 +107,7 @@ nodes:
     reasonCode: route.source.boundary-required
     gate:
       id: source-boundary
-      prompt: Choose the repositories, modules, or documents that may become knowledge sources.
+      prompt: Complete and present the first-task work-start report, resolve every required start condition, then confirm the repositories, modules, or documents that may become knowledge sources. A task brief is not itself a source unless explicitly selected for ingestion.
       authority: context.source-boundary
       delegatable: false
     resolutionAction: actions/register-source-batch.yaml
@@ -107,6 +121,8 @@ nodes:
         - resources/dialogue/source-boundary.md
         - resources/dialogue/workflow-mode-after-creation.md
         - resources/views/source-current.yaml
+        - resources/procedures/work-start-report.md
+        - resources/templates/work-start-report.md
       recommended:
         - resources/procedures/source-capture-detailed.md
 
@@ -182,10 +198,34 @@ nodes:
         - resources/procedures/source-capture-detailed.md
         - resources/manuals/guides/lark-resources.md
 
+  - id: reopen-cleared-task
+    kind: gate
+    reasonCode: route.workspace.task-cleared
+    resolutionAction: actions/resume-workspace-task.yaml
+    gate:
+      id: resume-workspace-task
+      prompt: Task state was cleared; retained knowledge does not prove all registered scope was delivered. Stay ready unless the user asks to resume production. With that explicit request, run task resume and follow the fresh Route.
+      delegatable: false
+    satisfiedBy:
+      - path: workspace.task_start_authorized
+        equals: true
+    resources:
+      required:
+        - resources/procedures/workspace-prepare.md
+
   - id: run-indexer-lifecycle
     kind: action
     reasonCode: route.indexer.lifecycle-required
     action: actions/run-indexer-lifecycle.yaml
+    resources:
+      required:
+        - resources/procedures/homogeneous-source-review.md
+        - resources/contracts/indexer-registry-bootstrap.yaml
+        - resources/contracts/indexer-provider-guide.yaml
+        - resources/views/source-boundary.yaml
+      recommended:
+        - resources/procedures/work-start-report.md
+        - resources/templates/work-start-report.md
     satisfiedBy:
       - path: indexer.lifecycle_current
         equals: true
@@ -215,6 +255,7 @@ nodes:
         - resources/procedures/knowledge-review.md
         - resources/dialogue/human-gates.md
         - resources/dialogue/knowledge-review.md
+      recommended:
         - resources/views/review-current.yaml
 
   - id: choose-package-output
@@ -288,7 +329,8 @@ nodes:
       - path: packages.current
         equals: true
     resources:
-      required:
+      recommended:
+        - resources/procedures/workspace-commit.md
         - resources/procedures/close-and-build.md
         - resources/views/package-current.yaml
 
@@ -303,10 +345,43 @@ nodes:
       required:
         - resources/procedures/runtime-event-delivery.md
 
+  - id: close-rollback
+    kind: action
+    reasonCode: route.rollback.close-required
+    action: actions/close-approved-knowledge.yaml
+    satisfiedBy:
+      - path: close.current
+        equals: true
+
+  - id: build-rollback
+    kind: action
+    reasonCode: route.rollback.build-required
+    action: actions/build-next.yaml
+    satisfiedBy:
+      - path: packages.current
+        equals: true
+
+  - id: finish-rollback
+    kind: action
+    reasonCode: route.rollback.cleanup-required
+    action: actions/finish-rollback.yaml
+
+  - id: rollback-complete
+    kind: terminal
+    terminalOutcome: completed
+
   - id: current-scope-complete
     kind: terminal
     terminalOutcome: completed
 
+  - id: record-workspace-version
+    kind: action
+    reasonCode: route.version.content-changed
+    action: actions/record-workspace-version.yaml
+    satisfiedBy:
+      - path: version.recording_satisfied
+        equals: true
+
 edges:
   - { from: repair-project-entry, to: repair-workspace-state }
   - { from: repair-workspace-state, to: repair-verification }
@@ -317,12 +392,17 @@ edges:
   - { 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: run-indexer-lifecycle }
+  - { from: capture-next, to: reopen-cleared-task }
+  - { from: reopen-cleared-task, to: run-indexer-lifecycle, kind: gatedBy }
   - { from: run-indexer-lifecycle, to: review-current-batch }
   - { from: review-current-batch, to: close-approved-knowledge, kind: gatedBy }
   - { from: close-approved-knowledge, 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: review-package-template, to: record-workspace-version, kind: gatedBy }
+  - { from: record-workspace-version, to: build-next }
   - { from: build-next, to: flush-logs-after-build }
   - { from: flush-logs-after-build, to: current-scope-complete }
+  - { from: close-rollback, to: build-rollback }
+  - { from: build-rollback, to: finish-rollback }
+  - { from: finish-rollback, to: rollback-complete }