@c4a/context-cli 0.7.5 → 0.7.8

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
@@ -41,6 +81,21 @@ nodes:
       required:
         - resources/views/resolved-indexer-instructions.yaml
         - resources/views/authorized-indexer-workset-view.yaml
+      recommended:
+        - 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 +146,12 @@ nodes:
     kind: action
     reasonCode: route.indexer.provider-configuration
     action: actions/configure-indexer-providers.yaml
+    resources:
+      required:
+        - 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 +177,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 +188,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 +258,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 +287,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 +298,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
@@ -239,6 +315,9 @@ nodes:
       required:
         - resources/views/resolved-indexer-instructions.yaml
         - resources/views/authorized-indexer-workset-view.yaml
+      recommended:
+        - 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 +454,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,6 +3,7 @@ id: workspace
 description: Fact-grounded lifecycle for a Context knowledge workspace.
 entrypoints:
   context: repair-project-entry
+  rollback: close-rollback
 nodes:
   - id: repair-project-entry
     kind: action
@@ -28,6 +29,9 @@ nodes:
       required:
         - resources/diagnostics/workspace-state.md
         - resources/views/workspace-current.yaml
+      recommended:
+        - resources/procedures/workspace-prepare.md
+        - resources/procedures/workspace-restore.md
 
   - id: repair-verification
     kind: action
@@ -82,10 +86,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
@@ -186,6 +189,14 @@ nodes:
     kind: action
     reasonCode: route.indexer.lifecycle-required
     action: actions/run-indexer-lifecycle.yaml
+    resources:
+      required:
+        - 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 +226,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 +300,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,6 +316,31 @@ 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
@@ -326,3 +364,6 @@ edges:
   - { from: review-package-template, to: build-next, kind: gatedBy }
   - { 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 }