@c4a/context-cli 0.6.1-beta.2 → 0.6.1-beta.3

package/providers/context/manifest.json

@@ -2,7 +2,7 @@
   "schema": "agent-graph.bundle.v1",
   "provider": {
     "id": "c4a/context",
-    "version": "0.6.1-beta.2"
+    "version": "0.6.1-beta.3"
   },
   "providerManifest": "provider.yaml",
   "graphs": [
@@ -16,17 +16,17 @@
     {
       "id": "align-next",
       "path": "actions/align-next.yaml",
-      "digest": "sha256:e7afec0ac46e078d16b5593f2a6c781db4ce5613ecea78824e32db20814026f9"
+      "digest": "sha256:6370fc4db94177da33b3343c5a83bb8c1162637f676a05ff5a674afd98959e59"
     },
     {
       "id": "apply-managed-review",
       "path": "actions/apply-managed-review.yaml",
-      "digest": "sha256:727408016a246f39a38cbdcc611bdd62c3dc901575d1b9598b149601e13ea56f"
+      "digest": "sha256:25e2c2c215889dd13a6dec8714bc2b6357f3e01b09cc684f1e82d986e30ef064"
     },
     {
       "id": "apply-structure-confirmation",
       "path": "actions/apply-structure-confirmation.yaml",
-      "digest": "sha256:67fa9fd70f201b6459756afe95f445583d3a332996c6cdca09303b56ca9f4350"
+      "digest": "sha256:2d5acf97ca692d324c829b25e020708b0d5fcd7ee004b7fd2be625a197dc77c3"
     },
     {
       "id": "build-next",
@@ -36,7 +36,7 @@
     {
       "id": "capture-next",
       "path": "actions/capture-next.yaml",
-      "digest": "sha256:25c53a9853f508886060b2a88b6d3962e907dd8a0aca2fd118c1a9e9396a640e"
+      "digest": "sha256:409a091eb771d5087408832539a50cb7b6f0c0d25dd47257798df49f5d8b6fc3"
     },
     {
       "id": "close-approved-knowledge",
@@ -46,37 +46,37 @@
     {
       "id": "compile-next",
       "path": "actions/compile-next.yaml",
-      "digest": "sha256:3dc91d9cfbbf6f3a67c94d66d406502ccc9c45ce5c42563c374c63b43a42e54a"
+      "digest": "sha256:e0fec702b2e77b4425c90ad47813fe2e9a6a007013d983b5e51243eb0c61433e"
     },
     {
       "id": "configure-code-extraction",
       "path": "actions/configure-code-extraction.yaml",
-      "digest": "sha256:37ee0a186ca2a4de6cce45b65237d2ab9333249aac3fab16f874ed85aad6cd39"
+      "digest": "sha256:db83bf8d71f4bd1869d023b96bb095fbe206018125a528478693920ba9e2ffe3"
     },
     {
       "id": "configure-document-capture",
       "path": "actions/configure-document-capture.yaml",
-      "digest": "sha256:351bee54b3946d082731c8c9e75104d8e5058e6830aa7717061d4ede4ce0dbec"
+      "digest": "sha256:c5955af91692dd8e46b519aba8eec56a6a0dab58c1639f2ff42f746daf558f1d"
     },
     {
       "id": "configure-package-output",
       "path": "actions/configure-package-output.yaml",
-      "digest": "sha256:13176b41722ed2db04d9c5522be3d39d07cf3a268a6ead3b16d96b7fa49d2173"
+      "digest": "sha256:2f5a682988ce3f32c53cf5131c36cf88e62332e8f27d5daaa0dedfb6e687b55a"
     },
     {
       "id": "configure-prose-lifecycle",
       "path": "actions/configure-prose-lifecycle.yaml",
-      "digest": "sha256:e3b4b6db85c9b8ed0288773febd509eb690246d798678bab71da846412b48de1"
+      "digest": "sha256:226d20be637455b3ffba4a115dd0437d3330354d8a73b8e5313b3af303d53bcc"
     },
     {
       "id": "ensure-repository-sources",
       "path": "actions/ensure-repository-sources.yaml",
-      "digest": "sha256:3fd30d746a882f6a3dfaeca8fa6270b08bdb7dc7bd34402b849b0953ec2e9743"
+      "digest": "sha256:00205debd0e58065f04520b1543c3e5dffc0da63cf42ffff4370757e59557791"
     },
     {
       "id": "extract-next",
       "path": "actions/extract-next.yaml",
-      "digest": "sha256:99f952085f23dfb0d7adcca0e12fcf31043bde568f3314326b542fd4547331cb"
+      "digest": "sha256:3d5e26cbdd912c9be666ce423b19456b31ab67da53c4e01a1a1c7a3dc1e6420a"
     },
     {
       "id": "inspect-document-classification",
@@ -111,7 +111,7 @@
     {
       "id": "repair-project-entry",
       "path": "actions/repair-project-entry.yaml",
-      "digest": "sha256:fb225cac409f3edc79d8d8931aef89a57ead11728747c49fe0f1fafb2a3f2028"
+      "digest": "sha256:7850eea903cfb5d5f17078cc79f790325eed75f07cd7e40ef91add1ee87ed9cd"
     },
     {
       "id": "repair-verification",
@@ -121,7 +121,7 @@
     {
       "id": "repair-workspace-state",
       "path": "actions/repair-workspace-state.yaml",
-      "digest": "sha256:8927f0b2c576c47bf20fc42aa9f9936633aab9b7057877fcfebec800e9285228"
+      "digest": "sha256:67296adf5336a7f746e250dc23676972282f88410fb6a6edc41a929e15d1856b"
     }
   ],
   "resources": [
@@ -148,7 +148,7 @@
     {
       "id": "context.sdk.project-api",
       "path": "resources/manuals/reference/project-api.md",
-      "digest": "sha256:8258c1bac40f919582a6b4a13f95ab250f6619dc98dd2df770d56839d3978dca"
+      "digest": "sha256:fa9e6d2eb48f4ae74b560b77c8f490ca723d6e070be30217643f0515cebc6cf1"
     },
     {
       "id": "context.sdk.template-variables",
@@ -173,7 +173,7 @@
     {
       "id": "context.semantic.align.structure-planning",
       "path": "resources/semantic/align/structure-planning.md",
-      "digest": "sha256:3d077e85f3f0e44da8f291a18bb4fe1e6e40b2885c7f0160a638ce60b72d174e"
+      "digest": "sha256:08f4dab4f53583415155a869be821b4ce2f275bc197be8976a38d3b30a66aa39"
     },
     {
       "id": "context.semantic.compile.index",
@@ -258,7 +258,7 @@
     {
       "id": "procedure.close-and-build",
       "path": "resources/procedures/close-and-build.md",
-      "digest": "sha256:0edb69a16d98538c76d6d0d321bdd1b5fe704bdbbecad8ff545faae2be8bd617"
+      "digest": "sha256:02e91b42cf9faec65bbbb27de512298b4715b9808f1ec364022b34145173dd3d"
     },
     {
       "id": "procedure.code-extraction",
@@ -273,17 +273,17 @@
     {
       "id": "procedure.document-classification",
       "path": "resources/procedures/document-classification.md",
-      "digest": "sha256:115257038ea1d559846e43e8591bcda31a55e51b6f60d164bd6dd34c88d3df9a"
+      "digest": "sha256:eae7ce95e0e61e90b71be5b020e49f64f14a04833ecb618509ca5fd3cfb34176"
     },
     {
       "id": "procedure.evidence-maintenance",
       "path": "resources/procedures/evidence-maintenance.md",
-      "digest": "sha256:ccc6e56074b7dd7d14fd0e98e7706370b7950c56baaa3d163acb6a87268a179b"
+      "digest": "sha256:2bceea12b4430586e0b6bbaef46dc32ad999f9d2cc373b7db77a88f5fca93ccc"
     },
     {
       "id": "procedure.knowledge-review",
       "path": "resources/procedures/knowledge-review.md",
-      "digest": "sha256:6a9af6aaf43f07e36ae76e9b8049d1a76fb3847e80173eedeeb250a0bcc0b8bb"
+      "digest": "sha256:5ebf2bb9399d291f8a5dbba249169b4fb221e456aa6c05081c4c54b2e6f3cf48"
     },
     {
       "id": "procedure.package-output",
@@ -293,7 +293,7 @@
     {
       "id": "procedure.project-configuration",
       "path": "resources/procedures/project-configuration.md",
-      "digest": "sha256:899af7cffb1d856b00c496dd45ffcccc14f22c19b586cf1d80679329ba8ea277"
+      "digest": "sha256:4e62fe0e5056cedfa9976d38275e5b4c5805d7e3913cb13d26edc78fa04e49ef"
     },
     {
       "id": "procedure.prose-align",
@@ -318,7 +318,7 @@
     {
       "id": "procedure.verify-and-repair",
       "path": "resources/procedures/verify-and-repair.md",
-      "digest": "sha256:4209d1361c8a6293367e239e8b6b6e7d6a708e8c3fa1160cfafdff4cdcb6b857"
+      "digest": "sha256:6becb02923a07eae47de7a9cfca2fc28ee3932a62bbcf4d273ec0f5b430b15e9"
     }
   ],
   "schemas": [
@@ -336,15 +336,15 @@
   "files": [
     {
       "path": "actions/align-next.yaml",
-      "digest": "sha256:e7afec0ac46e078d16b5593f2a6c781db4ce5613ecea78824e32db20814026f9"
+      "digest": "sha256:6370fc4db94177da33b3343c5a83bb8c1162637f676a05ff5a674afd98959e59"
     },
     {
       "path": "actions/apply-managed-review.yaml",
-      "digest": "sha256:727408016a246f39a38cbdcc611bdd62c3dc901575d1b9598b149601e13ea56f"
+      "digest": "sha256:25e2c2c215889dd13a6dec8714bc2b6357f3e01b09cc684f1e82d986e30ef064"
     },
     {
       "path": "actions/apply-structure-confirmation.yaml",
-      "digest": "sha256:67fa9fd70f201b6459756afe95f445583d3a332996c6cdca09303b56ca9f4350"
+      "digest": "sha256:2d5acf97ca692d324c829b25e020708b0d5fcd7ee004b7fd2be625a197dc77c3"
     },
     {
       "path": "actions/build-next.yaml",
@@ -352,7 +352,7 @@
     },
     {
       "path": "actions/capture-next.yaml",
-      "digest": "sha256:25c53a9853f508886060b2a88b6d3962e907dd8a0aca2fd118c1a9e9396a640e"
+      "digest": "sha256:409a091eb771d5087408832539a50cb7b6f0c0d25dd47257798df49f5d8b6fc3"
     },
     {
       "path": "actions/close-approved-knowledge.yaml",
@@ -360,31 +360,31 @@
     },
     {
       "path": "actions/compile-next.yaml",
-      "digest": "sha256:3dc91d9cfbbf6f3a67c94d66d406502ccc9c45ce5c42563c374c63b43a42e54a"
+      "digest": "sha256:e0fec702b2e77b4425c90ad47813fe2e9a6a007013d983b5e51243eb0c61433e"
     },
     {
       "path": "actions/configure-code-extraction.yaml",
-      "digest": "sha256:37ee0a186ca2a4de6cce45b65237d2ab9333249aac3fab16f874ed85aad6cd39"
+      "digest": "sha256:db83bf8d71f4bd1869d023b96bb095fbe206018125a528478693920ba9e2ffe3"
     },
     {
       "path": "actions/configure-document-capture.yaml",
-      "digest": "sha256:351bee54b3946d082731c8c9e75104d8e5058e6830aa7717061d4ede4ce0dbec"
+      "digest": "sha256:c5955af91692dd8e46b519aba8eec56a6a0dab58c1639f2ff42f746daf558f1d"
     },
     {
       "path": "actions/configure-package-output.yaml",
-      "digest": "sha256:13176b41722ed2db04d9c5522be3d39d07cf3a268a6ead3b16d96b7fa49d2173"
+      "digest": "sha256:2f5a682988ce3f32c53cf5131c36cf88e62332e8f27d5daaa0dedfb6e687b55a"
     },
     {
       "path": "actions/configure-prose-lifecycle.yaml",
-      "digest": "sha256:e3b4b6db85c9b8ed0288773febd509eb690246d798678bab71da846412b48de1"
+      "digest": "sha256:226d20be637455b3ffba4a115dd0437d3330354d8a73b8e5313b3af303d53bcc"
     },
     {
       "path": "actions/ensure-repository-sources.yaml",
-      "digest": "sha256:3fd30d746a882f6a3dfaeca8fa6270b08bdb7dc7bd34402b849b0953ec2e9743"
+      "digest": "sha256:00205debd0e58065f04520b1543c3e5dffc0da63cf42ffff4370757e59557791"
     },
     {
       "path": "actions/extract-next.yaml",
-      "digest": "sha256:99f952085f23dfb0d7adcca0e12fcf31043bde568f3314326b542fd4547331cb"
+      "digest": "sha256:3d5e26cbdd912c9be666ce423b19456b31ab67da53c4e01a1a1c7a3dc1e6420a"
     },
     {
       "path": "actions/inspect-document-classification.yaml",
@@ -412,7 +412,7 @@
     },
     {
       "path": "actions/repair-project-entry.yaml",
-      "digest": "sha256:fb225cac409f3edc79d8d8931aef89a57ead11728747c49fe0f1fafb2a3f2028"
+      "digest": "sha256:7850eea903cfb5d5f17078cc79f790325eed75f07cd7e40ef91add1ee87ed9cd"
     },
     {
       "path": "actions/repair-verification.yaml",
@@ -420,7 +420,7 @@
     },
     {
       "path": "actions/repair-workspace-state.yaml",
-      "digest": "sha256:8927f0b2c576c47bf20fc42aa9f9936633aab9b7057877fcfebec800e9285228"
+      "digest": "sha256:67296adf5336a7f746e250dc23676972282f88410fb6a6edc41a929e15d1856b"
     },
     {
       "path": "codes.yaml",
@@ -432,7 +432,7 @@
     },
     {
       "path": "provider.yaml",
-      "digest": "sha256:1789ef237bd5d8272c6d339b9b1c30c4df17696b91133336459d10926a609af2"
+      "digest": "sha256:f05c81fbb86e6e34289d0828c04a15336dafaa8fcc122e49afc7496a00e97ac3"
     },
     {
       "path": "resources/diagnostics/verification.md",
@@ -488,7 +488,7 @@
     },
     {
       "path": "resources/manuals/reference/project-api.md",
-      "digest": "sha256:8258c1bac40f919582a6b4a13f95ab250f6619dc98dd2df770d56839d3978dca"
+      "digest": "sha256:fa9e6d2eb48f4ae74b560b77c8f490ca723d6e070be30217643f0515cebc6cf1"
     },
     {
       "path": "resources/manuals/reference/template-variables.md",
@@ -496,7 +496,7 @@
     },
     {
       "path": "resources/procedures/close-and-build.md",
-      "digest": "sha256:0edb69a16d98538c76d6d0d321bdd1b5fe704bdbbecad8ff545faae2be8bd617"
+      "digest": "sha256:02e91b42cf9faec65bbbb27de512298b4715b9808f1ec364022b34145173dd3d"
     },
     {
       "path": "resources/procedures/code-extraction.md",
@@ -508,15 +508,15 @@
     },
     {
       "path": "resources/procedures/document-classification.md",
-      "digest": "sha256:115257038ea1d559846e43e8591bcda31a55e51b6f60d164bd6dd34c88d3df9a"
+      "digest": "sha256:eae7ce95e0e61e90b71be5b020e49f64f14a04833ecb618509ca5fd3cfb34176"
     },
     {
       "path": "resources/procedures/evidence-maintenance.md",
-      "digest": "sha256:ccc6e56074b7dd7d14fd0e98e7706370b7950c56baaa3d163acb6a87268a179b"
+      "digest": "sha256:2bceea12b4430586e0b6bbaef46dc32ad999f9d2cc373b7db77a88f5fca93ccc"
     },
     {
       "path": "resources/procedures/knowledge-review.md",
-      "digest": "sha256:6a9af6aaf43f07e36ae76e9b8049d1a76fb3847e80173eedeeb250a0bcc0b8bb"
+      "digest": "sha256:5ebf2bb9399d291f8a5dbba249169b4fb221e456aa6c05081c4c54b2e6f3cf48"
     },
     {
       "path": "resources/procedures/package-output.md",
@@ -524,7 +524,7 @@
     },
     {
       "path": "resources/procedures/project-configuration.md",
-      "digest": "sha256:899af7cffb1d856b00c496dd45ffcccc14f22c19b586cf1d80679329ba8ea277"
+      "digest": "sha256:4e62fe0e5056cedfa9976d38275e5b4c5805d7e3913cb13d26edc78fa04e49ef"
     },
     {
       "path": "resources/procedures/prose-align.md",
@@ -544,7 +544,7 @@
     },
     {
       "path": "resources/procedures/verify-and-repair.md",
-      "digest": "sha256:4209d1361c8a6293367e239e8b6b6e7d6a708e8c3fa1160cfafdff4cdcb6b857"
+      "digest": "sha256:6becb02923a07eae47de7a9cfca2fc28ee3932a62bbcf4d273ec0f5b430b15e9"
     },
     {
       "path": "resources/semantic/align/candidate-resolution.md",
@@ -560,7 +560,7 @@
     },
     {
       "path": "resources/semantic/align/structure-planning.md",
-      "digest": "sha256:3d077e85f3f0e44da8f291a18bb4fe1e6e40b2885c7f0160a638ce60b72d174e"
+      "digest": "sha256:08f4dab4f53583415155a869be821b4ce2f275bc197be8976a38d3b30a66aa39"
     },
     {
       "path": "resources/semantic/compile/index.md",
@@ -606,5 +606,5 @@
   "graphDependencies": {
     "workspace": []
   },
-  "digest": "sha256:e130fa822a5329aa5bee9ebdf9c66942e541b0defc58070f5a43264fba083c08"
+  "digest": "sha256:04d64bac7e963b9074ab27a621487b0980e09bf4be0c383fc6a3f240e5ee16d5"
 }

package/providers/context/provider.yaml

@@ -1,6 +1,6 @@
 schema: agent-graph.provider.v1
 id: c4a/context
-version: 0.6.1-beta.2
+version: 0.6.1-beta.3
 name: Context workflow
 description: Internal work contract for Context knowledge workspaces.
 graphs:

package/providers/context/resources/manuals/reference/project-api.md

@@ -256,6 +256,17 @@ returned by `workflow.current`. Source boundaries and unread source bodies,
 external operations, payload validation, deterministic close, and verification
 errors are never bypassed.
 
+For consecutive mechanical routes, the Agent may run:
+
+```bash
+context run --managed --until blocked-or-complete --format json
+```
+
+This is a bounded host loop over the same revisioned routes. It stops before
+read-only interpretation, project configuration, unresolved authority,
+diagnostics, or a non-unique command plan; it does not add another workflow
+entry or make semantic decisions.
+
 ### `captureFile`
 
 Capture a registered file source into a committed normalized document snapshot.
@@ -360,6 +371,7 @@ context run align:file:<source-name>:architecture --view read-plan --format json
 context run align:file:<source-name>:architecture --view source-index --compact --format json
 context run align:file:<source-name>:architecture --view span-detail --span <source-ref> --format json
 context run align:file:<source-name>:architecture --view span-text --span <source-ref> --format json
+context run align:file:<source-name>:architecture --view existing-knowledge --query <title-or-stable-ref> --format json
 context run align:file:<source-name>:architecture --view schema --format json
 context run align:file:<source-name>:architecture --view semantic-rules --format json
 context run align:file:<source-name>:architecture --validate --input <structure.yaml> --format json
@@ -377,6 +389,14 @@ schema and full reports stay behind explicit Views, while `--verbose` restores
 the full phase result and repeated contracts. Long diagnostics return a compact
 first page plus an exact diagnostics continuation command.
 
+`existing-knowledge` is the authoring-time lookup for approved identities. It
+returns stable NodeRefs, ViewRefs, titles, tags, collections, and section counts
+without exposing workspace storage paths. `--query` performs deterministic
+case-insensitive exact/prefix/substring matching; `--collection`,
+`--node-type`, `--page-size`, and the returned continuation command narrow or
+page the same View. Use it after reading source evidence and before introducing
+a new Node identity. Structure validation remains the final duplicate gate.
+
 Align and compile evidence results include `semantic_rules`. Its `required`
 array is the rule subset selected for the current judgment, with a selection
 reason and content digest for each rule. `handle`, `digest`, and

package/providers/context/resources/procedures/close-and-build.md

@@ -17,4 +17,3 @@ removed, and index changes.
 Run only the current route command, then evaluate again. A successful build
 means the currently declared scope is current; newly captured or newly declared
 targets can reopen earlier graph nodes.
-

package/providers/context/resources/procedures/document-classification.md

@@ -17,4 +17,3 @@ user decision unless the current session explicitly delegates this gate.
 After the decision, declare the complete align, compile, and review lifecycle
 for the same canonical source and collection. Re-evaluate instead of assuming
 the declaration closed every document target.
-

package/providers/context/resources/procedures/evidence-maintenance.md

@@ -18,4 +18,3 @@ the resulting evidence state must stay explicit.
 
 Use the affected `view_ref` values from the current diagnostic resource. Do not
 target maintenance by guessed paths or node names.
-

package/providers/context/resources/procedures/knowledge-review.md

@@ -22,4 +22,3 @@ conversation. It does not bypass source permission, validation, close, or
 verify.
 
 After apply, re-evaluate. Do not infer that close or package output is current.
-

package/providers/context/resources/procedures/project-configuration.md

@@ -19,4 +19,3 @@ declaration requested by the route in `src/index.ts`.
 
 The Context SDK API reference is a discoverable resource. Do not guess an API
 shape from older prompts or cached plugin text.
-

package/providers/context/resources/procedures/verify-and-repair.md

@@ -17,4 +17,3 @@ then run verification again.
 Do not delete candidates, approved pages, snapshots, or structure slots to make
 verification pass. Derived diagnostics should not be handled as independent
 root failures.
-

package/providers/context/resources/semantic/align/structure-planning.md

@@ -34,9 +34,9 @@ Run `context run align:<type>:<source>:<collection> --view read-plan --format js
 - Schema names and enum values come from
   `context run align:<type>:<source>:<collection> --view schema --format json`. Use
   that schema as the authoring contract for `context.structure.v1`.
-- Existing approved knowledge and `knowledge/structure.yaml` are the lookup
-  registry exposed through current CLI/status/query views. Do not read
-  `knowledge/**` or create a separate registry file.
+- Existing approved knowledge is the lookup registry exposed by the current
+  align `existing-knowledge` View. Do not read `knowledge/**`, guess a top-level
+  query command, or create a separate registry file.
 - Code projection Nodes are reusable knowledge handles. When document evidence belongs on a code symbol, reuse the code slug instead of creating a parallel document Node.
 - Validation diagnostics are the mechanical structure ownership source of
   truth. Non-content spans such as navigation references, placeholders, front
@@ -55,7 +55,10 @@ Run `context run align:<type>:<source>:<collection> --view read-plan --format js
   placeholder/relation source is skipped entirely, leave its relation clues in
   `unresolved[]` only when they still matter; otherwise omit them.
 - `views[]` and diagnostics distinguish citable evidence from supporting context. Do not promote supporting/context-only material into cited Sections unless a later ownership correction makes it citation-eligible.
-- Keep cache-friendly prompt order: fixed protocol/schema first, existing knowledge lookup second, source evidence views third, current semantic payload last. Preserve CLI JSON order and do not add timestamps, random ids, scratch paths, or host paths to generated payloads.
+- Keep cache-friendly prompt order: fixed protocol/schema first, source evidence
+  views second, targeted existing-knowledge results third, and the current
+  semantic payload last. Preserve CLI JSON order and do not add timestamps,
+  random ids, scratch paths, or host paths to generated payloads.
 - Structure digests and snapshot hashes are stale guards. Follow returned
   `next_action.command` and do not invent digest values.
 - Node type, tag, fake-Entity, `domain`, and `action` gates are in `structure-planning/references/gates.md`.
@@ -91,8 +94,9 @@ or `next_command`.
 
 `read-plan` is the navigation surface. It chooses whether the next evidence read
 is `source-index`, `span-detail`, `span-text`, or another current evidence view.
-Read those views and then author the requested
-`context.structure.v1` payload yourself. Never pipe evidence text into validate.
+Read those views and then author the requested `context.structure.v1` payload
+yourself after completing the targeted lookup in Step 3. Never pipe evidence
+text into validate.
 
 If an evidence view is truncated, `page.has_more: true`, or the CLI returns a
 `next_command`, run that command before authoring.
@@ -107,7 +111,16 @@ is explicitly needed, otherwise return to the CLI-designated navigation view.
 
 ### Step 3 — Reuse Existing Knowledge
 
-Query existing knowledge for reusable names before proposing new term/service/system/action Nodes. Exact title/slug/alias hits should usually become references to the existing Node, not duplicate candidates.
+After source evidence identifies a candidate title or stable ref, run:
+
+```bash
+context run align:<type>:<source>:<collection> --view existing-knowledge --query <title-or-stable-ref> --format json
+```
+
+Use the returned pagination command when present. Exact title, NodeRef, ViewRef,
+or tag hits should usually reuse the existing Node instead of creating a
+duplicate candidate. The lookup is deterministic identity discovery; the Agent
+still decides whether the source evidence describes the same concept.
 
 When a code projection Node already represents the object, reuse its slug for prose evidence and plan only prose-owned Sections for the current source evidence.