@c4a/context-cli 0.7.70 → 0.7.72

package/indexers/release-manifest.json

@@ -1,7 +1,7 @@
 {
   "protocol": "context.indexer.cli-release-manifest/v1",
   "package": "@c4a/context-cli",
-  "version": "0.7.70",
+  "version": "0.7.72",
   "issuer": "context4ai/context",
   "bundles": [
     {
@@ -11,7 +11,7 @@
         "kind": "cli-bundled",
         "locator": "cli-bundled://context/context-code-indexer"
       },
-      "integrity": "sha256:d2d93b54af00ddb1062f49a0a2d622b5c88c1e9481e53ddfe7afe0445d950910",
+      "integrity": "sha256:c0dee602a87f5f95a3419fba3bbb3b3ea69292968b52c46744af869751487107",
       "manifest_digest": "sha256:1bb49c2cfaaf1cc847dccd90c5f2bb6465941217a0e0d6053c0a5aeff467a013",
       "files": [
         {
@@ -92,35 +92,35 @@
         },
         {
           "path": "references/composers/contracts-and-chains.md",
-          "digest": "sha256:04d2286b60c153d9e5521145901042af06af9538902dab8c570027f77b28cfd9"
+          "digest": "sha256:9cd801c6901ecf4d0e95258224e4a1c82ee14ba4010ce594ff97267c6ce58e38"
         },
         {
           "path": "references/composers/cross-module-chain.md",
-          "digest": "sha256:a548e2f92fb7416df78734d4b913526d86717ccdd740b78c35423ccaae0be6a4"
+          "digest": "sha256:7beb0ace96064e035de762c8ffe19b29c5960da7695363bf4873eb186528e2c3"
         },
         {
           "path": "references/composers/development-and-delivery.md",
-          "digest": "sha256:77e15189c2f4e19d15ff0d88773b99a6f7fa3e37b0af3ac7b67c0316c744e947"
+          "digest": "sha256:27414925870e883803f3507abaacf2e2dc1c01bf03e4b6cf3ec47ad80f95770a"
         },
         {
           "path": "references/composers/event-flow.md",
-          "digest": "sha256:0c33872b835ef44f9e7343173e3ca0913006e7f8c7a32617e005f866b60d74cb"
+          "digest": "sha256:a430d14f11c02c8b67e98afffd0cf9d3c6e71bbf421780fd9b0399723cab8e93"
         },
         {
           "path": "references/composers/examples-and-documentation.md",
-          "digest": "sha256:580ad81d9bd8f7cd8426a98a26d0fb8e0aa5a5e9c7c064fe48addbc42bdca0b0"
+          "digest": "sha256:e97d2be0bb15ad28ad69de04dedb150ca0395278e45d8ee3299f22380579a45c"
         },
         {
           "path": "references/composers/persistence-boundary.md",
-          "digest": "sha256:24c931a72a22d94e6a66eac8c8fc075dc559244bc1b623ec3673f3e6ae632bb5"
+          "digest": "sha256:406e4a08f50f6a75c6f2cb52bbc5263eb1962071971681749bed4a6b0072e4e7"
         },
         {
           "path": "references/composers/protocol-boundary.md",
-          "digest": "sha256:b92134ac9c73d4b4b813a9fa29c410c30c808d14bb275cc61552f20e7740d856"
+          "digest": "sha256:fc30a3ad05e0e6183e526e801d72d802df69770885f627b51c1e9739eaac17b7"
         },
         {
           "path": "references/composers/public-contract.md",
-          "digest": "sha256:d21f3d31def73d66f22e16f3a0e2932c144837a9814a3006f93fee8405212e88"
+          "digest": "sha256:0870c39814802b4ecb647f86878b325ddb29fec0dd9865de05de7e183d692422"
         },
         {
           "path": "references/diagram-behavior-examples.md",
@@ -136,7 +136,7 @@
         },
         {
           "path": "references/indexer.md",
-          "digest": "sha256:7aacb7d6d11c30483ea73ccdbb6639fdc0912566f6e8022f28277dcee03244ab"
+          "digest": "sha256:4c14a0ea8961a5aeabe8fc457d5fc8b70bb3da948fa724ec189d08198651c659"
         },
         {
           "path": "references/metrics.md",
@@ -388,7 +388,7 @@
         },
         {
           "path": "templates/data-sync-reconciliation.md",
-          "digest": "sha256:505f3f07c14b3f4dffc2ba301a9b307a707d83e0af055be751935e00114ffc00"
+          "digest": "sha256:0e8d5cc9759cced52a2cb9baad6b18c10c3df85cb9c61927d383268c7ef64214"
         },
         {
           "path": "templates/derived-generated-source-public-api-reference.md",
@@ -539,7 +539,7 @@
         "kind": "cli-bundled",
         "locator": "cli-bundled://context/context-markdown-indexer"
       },
-      "integrity": "sha256:41f8ff9add026026c1a689224c684afe220680922935f5cee7afd792207ced98",
+      "integrity": "sha256:12a5a40e4770cc1b96876028732ed887e7c92b279060b247cc61dafe54fc6a75",
       "manifest_digest": "sha256:4b6ea2307077abd4899515d32f72941ab8e6bceaa89f2b7662d732bbf817bce5",
       "files": [
         {
@@ -628,7 +628,7 @@
         },
         {
           "path": "references/indexer.md",
-          "digest": "sha256:3287d06938825afd9b2244b4cb2c4e2ba4cf8a03b78d0f924162e13eb06f8a93"
+          "digest": "sha256:d96c0396d43c610870ae78aa80cf19b3fedec761a70ca330f2190115615133cf"
         },
         {
           "path": "references/semantic-planning.md",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context-cli",
-  "version": "0.7.70",
+  "version": "0.7.72",
   "type": "module",
   "description": "Local runtime and Agent integration for traceable knowledge production",
   "license": "MIT",
@@ -24,17 +24,17 @@
   },
   "dependencies": {
     "@c4a/agent-graph": "0.3.0",
-    "@c4a/context": "0.7.70",
-    "@c4a/extract": "0.7.70",
-    "@c4a/extract-contract": "0.7.70",
-    "@c4a/extract-go": "0.7.70",
-    "@c4a/extract-mdx": "0.7.70",
-    "@c4a/extract-proto": "0.7.70",
-    "@c4a/extract-rush": "0.7.70",
-    "@c4a/extract-sql": "0.7.70",
-    "@c4a/extract-style": "0.7.70",
-    "@c4a/extract-thrift": "0.7.70",
-    "@c4a/extract-ts": "0.7.70",
+    "@c4a/context": "0.7.72",
+    "@c4a/extract": "0.7.72",
+    "@c4a/extract-contract": "0.7.72",
+    "@c4a/extract-go": "0.7.72",
+    "@c4a/extract-mdx": "0.7.72",
+    "@c4a/extract-proto": "0.7.72",
+    "@c4a/extract-rush": "0.7.72",
+    "@c4a/extract-sql": "0.7.72",
+    "@c4a/extract-style": "0.7.72",
+    "@c4a/extract-thrift": "0.7.72",
+    "@c4a/extract-ts": "0.7.72",
     "@mermaid-js/layout-elk": "0.2.0",
     "commander": "^11.0.0",
     "fast-xml-parser": "^5.10.1",

package/parserEntryWorker.js

@@ -4821,6 +4821,18 @@ var init_indexerProtocolCommon = __esm(() => {
 
 // ../context/src/articleStructure.ts
 import { createHash as createHash3 } from "node:crypto";
+function articleFragmentReferenceListSchema(item) {
+  return exports_external.array(item).max(ARTICLE_FRAGMENT_REGION_LIMIT, {
+    message: `A fragment can cite at most ${ARTICLE_FRAGMENT_REGION_LIMIT} source regions`
+  }).superRefine((references, context) => {
+    const files = new Set(references.map((reference) => JSON.stringify([reference.source_ref, reference.locator.path])));
+    if (files.size > ARTICLE_FRAGMENT_SOURCE_FILE_LIMIT)
+      context.addIssue({
+        code: exports_external.ZodIssueCode.custom,
+        message: `A fragment can cite at most ${ARTICLE_FRAGMENT_SOURCE_FILE_LIMIT} distinct source files (got ${files.size}); split the fragment or drop a supporting file`
+      });
+  });
+}
 function articleFragmentReferences(values) {
   const unique = new Map;
   for (const value of values) {
@@ -4885,7 +4897,7 @@ function locateArticleRegion(regionText, newText, path) {
     end_line: found + region.length
   };
 }
-var articleSourceLocatorSchema, articleSourceReferenceSchema, articleSectionSchema, articleStructureEntrySchema;
+var articleSourceLocatorSchema, articleSourceReferenceSchema, ARTICLE_FRAGMENT_SOURCE_FILE_LIMIT = 3, ARTICLE_FRAGMENT_REGION_LIMIT = 8, articleSectionSchema, articleStructureEntrySchema;
 var init_articleStructure = __esm(() => {
   init_zod();
   init_contracts();
@@ -4909,7 +4921,7 @@ var init_articleStructure = __esm(() => {
   }).strict();
   articleSectionSchema = exports_external.object({
     id: exports_external.string().min(1),
-    references: exports_external.array(articleSourceReferenceSchema).max(3)
+    references: articleFragmentReferenceListSchema(articleSourceReferenceSchema)
   }).strict();
   articleStructureEntrySchema = exports_external.object({
     article_id: exports_external.string().min(1),
@@ -5322,12 +5334,12 @@ var init_indexerContentLayers = __esm(() => {
     block_id: indexerIdSchema,
     layer: exports_external.literal("semantic-prose"),
     markdown: exports_external.string().min(1),
-    references: exports_external.array(articleSourceReferenceSchema).max(3)
+    references: articleFragmentReferenceListSchema(articleSourceReferenceSchema)
   }).strict();
   renderedContentBlockPayloadSchema = exports_external.object({
     layer: exports_external.enum(["deterministic-block", "semantic-prose"]),
     markdown: exports_external.string().min(1),
-    references: exports_external.array(articleSourceReferenceSchema).max(3)
+    references: articleFragmentReferenceListSchema(articleSourceReferenceSchema)
   }).strict();
   indexerRenderedContentBlockSchema = renderedContentBlockPayloadSchema.extend({
     content_digest: indexerDigestSchema
@@ -5360,7 +5372,7 @@ var init_indexerArtifact = __esm(() => {
   }).strict();
   indexerArtifactTemplateVariableSchema = exports_external.object({
     value: indexerCanonicalJsonSchema,
-    references: exports_external.array(articleSourceReferenceSchema).max(3)
+    references: articleFragmentReferenceListSchema(articleSourceReferenceSchema)
   }).strict();
   artifactCommonFields = {
     artifact_id: indexerIdSchema,
@@ -18340,14 +18352,14 @@ var init_indexerSemanticInput = __esm(() => {
     heading: exports_external.string().min(1),
     visuals: exports_external.array(authorVisualSchema).optional(),
     markdown: exports_external.string().min(1),
-    references: exports_external.array(exports_external.object({ source_ref: exports_external.string().min(1), locator: articleSourceLocatorSchema }).strict()).max(3).default([]),
+    references: articleFragmentReferenceListSchema(exports_external.object({ source_ref: exports_external.string().min(1), locator: articleSourceLocatorSchema }).strict()).default([]),
     answers: exports_external.array(exports_external.string().min(1)).default([])
   }).strict();
   authorTemplateVariablesSchema = exports_external.record(exports_external.union([
     exports_external.string(),
     exports_external.object({
       value: exports_external.string(),
-      references: exports_external.array(exports_external.object({ source_ref: exports_external.string().min(1), locator: articleSourceLocatorSchema }).strict()).max(3).default([])
+      references: articleFragmentReferenceListSchema(exports_external.object({ source_ref: exports_external.string().min(1), locator: articleSourceLocatorSchema }).strict()).default([])
     }).strict()
   ]));
   authorMemberDispositionSchema = exports_external.object({
@@ -18458,7 +18470,7 @@ var init_indexerSemanticInput = __esm(() => {
     heading: exports_external.string().min(1),
     visuals: exports_external.array(authorVisualSchema).optional(),
     markdown: exports_external.string().min(1),
-    references: exports_external.array(exports_external.object({ source_ref: exports_external.string().min(1), locator: articleSourceLocatorSchema }).strict()).max(3)
+    references: articleFragmentReferenceListSchema(exports_external.object({ source_ref: exports_external.string().min(1), locator: articleSourceLocatorSchema }).strict())
   }).strict();
   postAuthorInputBaseSchema = exports_external.object({
     stage: exports_external.literal("post-author"),
@@ -19270,7 +19282,7 @@ var init_indexerTemplateRendering = __esm(() => {
     artifact_kind: indexerIdSchema,
     markdown: exports_external.string().min(1),
     content_blocks: exports_external.array(indexerRenderedContentBlockSchema).min(1),
-    references: exports_external.array(articleSourceReferenceSchema).max(3),
+    references: articleFragmentReferenceListSchema(articleSourceReferenceSchema),
     content_digest: indexerDigestSchema
   }).strict();
   renderedMaterialGapSchema = exports_external.object({
@@ -19325,7 +19337,7 @@ var init_indexerLayoutResolver = __esm(() => {
     artifact_kind: indexerIdSchema,
     state: exports_external.enum(["structured", "rendered", "material-gap"]),
     content_digest: indexerDigestSchema.nullable(),
-    references: exports_external.array(articleSourceReferenceSchema).max(3),
+    references: articleFragmentReferenceListSchema(articleSourceReferenceSchema),
     material_question_proposal_ref: indexerCanonicalRefSchema.nullable(),
     collection_resolution_digest: indexerDigestSchema
   }).strict();
@@ -19698,7 +19710,7 @@ var init_indexerCandidateCompile = __esm(() => {
     sections: exports_external.array(exports_external.object({
       section_ref: exports_external.string().min(1),
       section_key: indexerIdSchema,
-      references: exports_external.array(articleSourceReferenceSchema).max(3),
+      references: articleFragmentReferenceListSchema(articleSourceReferenceSchema),
       markdown: exports_external.string().min(1),
       markdown_digest: indexerDigestSchema
     }).strict()).min(1),

package/plugins/VERSION

@@ -1 +1 @@
-0.7.70
+0.7.72

package/plugins/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "c4a",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
-  "version": "0.7.70",
+  "version": "0.7.72",
   "author": {
     "name": "c4a"
   },

package/plugins/codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "c4a",
-  "version": "0.7.70",
+  "version": "0.7.72",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
   "author": { "name": "c4a" },
   "homepage": "https://github.com/context4ai/c4a",
@@ -10,7 +10,7 @@
   "skills": "./skills/",
   "interface": {
     "displayName": "C4A Context",
-    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.70",
+    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.72",
     "longDescription": "Create a Context workspace and use agent-guided next steps to register sources, run extraction, review candidates, build package outputs, and verify health without silently mutating source repositories.",
     "developerName": "c4a",
     "category": "Productivity",

package/plugins/cursor/.cursor-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "c4a",
   "displayName": "C4A Context",
-  "version": "0.7.70",
+  "version": "0.7.72",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
   "author": {
     "name": "Context4AI",

package/plugins/skills/context-code-indexer/references/composers/contracts-and-chains.md

@@ -24,5 +24,5 @@ empty `fragments` array.
 
 Use only the supplied primary artifacts and their actual regional references.
 Do not require a primary Fact table, evidence IDs, or graph nodes. Each derived
-output fragment retains at most three real source locations; no reference
-ledger is reconstructed from the full inventory.
+output fragment retains real source regions from at most three files (up to
+eight regions); no reference ledger is reconstructed from the full inventory.

package/plugins/skills/context-code-indexer/references/composers/cross-module-chain.md

@@ -23,5 +23,5 @@ empty result: the accepted layer-fragment result with `fragments: []`.
 
 Use only the supplied primary artifacts and their actual regional references.
 Do not require a primary Fact table, evidence IDs, or graph nodes. Each derived
-output fragment retains at most three real source locations; no reference
-ledger is reconstructed from the full inventory.
+output fragment retains real source regions from at most three files (up to
+eight regions); no reference ledger is reconstructed from the full inventory.

package/plugins/skills/context-code-indexer/references/composers/development-and-delivery.md

@@ -23,5 +23,5 @@ return `fragments: []` in the ordinary structured result.
 
 Use only the supplied primary artifacts and their actual regional references.
 Do not require a primary Fact table, evidence IDs, or graph nodes. Each derived
-output fragment retains at most three real source locations; no reference
-ledger is reconstructed from the full inventory.
+output fragment retains real source regions from at most three files (up to
+eight regions); no reference ledger is reconstructed from the full inventory.

package/plugins/skills/context-code-indexer/references/composers/event-flow.md

@@ -22,5 +22,5 @@ reader value must return the normal result envelope with `fragments: []`.
 
 Use only the supplied primary artifacts and their actual regional references.
 Do not require a primary Fact table, evidence IDs, or graph nodes. Each derived
-output fragment retains at most three real source locations; no reference
-ledger is reconstructed from the full inventory.
+output fragment retains real source regions from at most three files (up to
+eight regions); no reference ledger is reconstructed from the full inventory.

package/plugins/skills/context-code-indexer/references/composers/examples-and-documentation.md

@@ -23,5 +23,5 @@ never invent tutorial steps.
 
 Use only the supplied primary artifacts and their actual regional references.
 Do not require a primary Fact table, evidence IDs, or graph nodes. Each derived
-output fragment retains at most three real source locations; no reference
-ledger is reconstructed from the full inventory.
+output fragment retains real source regions from at most three files (up to
+eight regions); no reference ledger is reconstructed from the full inventory.

package/plugins/skills/context-code-indexer/references/composers/persistence-boundary.md

@@ -22,5 +22,5 @@ set rather than reading outside the workset.
 
 Use only the supplied primary artifacts and their actual regional references.
 Do not require a primary Fact table, evidence IDs, or graph nodes. Each derived
-output fragment retains at most three real source locations; no reference
-ledger is reconstructed from the full inventory.
+output fragment retains real source regions from at most three files (up to
+eight regions); no reference ledger is reconstructed from the full inventory.

package/plugins/skills/context-code-indexer/references/composers/protocol-boundary.md

@@ -23,5 +23,5 @@ answers the reader question, return a valid result with `fragments: []`.
 
 Use only the supplied primary artifacts and their actual regional references.
 Do not require a primary Fact table, evidence IDs, or graph nodes. Each derived
-output fragment retains at most three real source locations; no reference
-ledger is reconstructed from the full inventory.
+output fragment retains real source regions from at most three files (up to
+eight regions); no reference ledger is reconstructed from the full inventory.

package/plugins/skills/context-code-indexer/references/composers/public-contract.md

@@ -36,5 +36,5 @@ Composer's declared result schema and actions.
 
 Use only the supplied primary artifacts and their actual regional references.
 Do not require a primary Fact table, evidence IDs, or graph nodes. Each derived
-output fragment retains at most three real source locations; no reference
-ledger is reconstructed from the full inventory.
+output fragment retains real source regions from at most three files (up to
+eight regions); no reference ledger is reconstructed from the full inventory.

package/plugins/skills/context-code-indexer/references/indexer.md

@@ -129,8 +129,8 @@ affected sections when appropriate. Preserve still-valid examples, limitations
 and confirmed contributions. New explanatory context does not require
 repartitioning unchanged code.
 
-Each fragment uses actual source regions, at most three locations; the CLI
-computes content digests. Do not use fallback evidence from an unrelated
+Each fragment uses actual source regions from at most three source files (up
+to eight regions in total); the CLI computes content digests. Do not use fallback evidence from an unrelated
 member, fabricate a continuous span for unrelated locations, or include
 process identities, full source bodies or credentials in reader output.
 

package/plugins/skills/context-code-indexer/templates/data-sync-reconciliation.md

@@ -61,7 +61,8 @@ owner or inventory membership is required; avoid duplicating existing prose.
 The article may cite every authorized participating source. Cover the reader
 question and relevant handoffs defined in the task brief.
 Explain operations and handoffs in reader prose, links or diagrams, citing the
-actual source regions for each fragment (at most three locations per fragment).
+actual source regions for each fragment (at most three source files per fragment;
+several regions of one file are fine, up to eight regions in total).
 Do not emit graph edges, classify nodes or create a relationship ledger.
 
 ## Granularity and stop conditions

package/plugins/skills/context-markdown-indexer/references/indexer.md

@@ -27,8 +27,8 @@ needed section edits when appropriate. Stable section markers and title and
 description follow that schema; there is no ArtifactResult, subject identity
 or profile-owned output mapping to assemble.
 
-For each output fragment, cite the actual source regions used, at most three
-locations. Use source_ref and an inclusive file/line locator; the CLI computes
+For each output fragment, cite the actual source regions used, from at most
+three source files (up to eight regions in total). Use source_ref and an inclusive file/line locator; the CLI computes
 content digests. Do not attach an entire corpus to a generic paragraph or
 combine unrelated locations into a fabricated continuous span. Split genuinely
 distinct explanations when they need distinct references.

package/providers/context/manifest.json

@@ -2,7 +2,7 @@
   "schema": "agent-graph.bundle.v1",
   "provider": {
     "id": "c4a/context",
-    "version": "0.7.70"
+    "version": "0.7.72"
   },
   "providerManifest": "provider.yaml",
   "graphs": [
@@ -193,12 +193,12 @@
     {
       "id": "context.sdk.package-outputs",
       "path": "resources/manuals/guides/package-outputs.md",
-      "digest": "sha256:695a97ef8abc86e1fd8646f90f100f074ba7547f496087204caee73c6ab9237c"
+      "digest": "sha256:72293f50a37e09fe14177bb940e12ada2515d71e7826c808ab7b9f7bf47bcce3"
     },
     {
       "id": "context.sdk.package-templates",
       "path": "resources/manuals/reference/package-templates.md",
-      "digest": "sha256:8d512d232ea5157717eca73357a213ab2449d83cf98bec217621aff79eda0216"
+      "digest": "sha256:f3a7fcc0166a6af15da550edb7937c7630bd2fb2372ca2ccd430b7cd6e56a3a9"
     },
     {
       "id": "context.sdk.page-customization",
@@ -213,7 +213,7 @@
     {
       "id": "context.sdk.site-translation",
       "path": "resources/manuals/guides/site-translation.md",
-      "digest": "sha256:f91c6676dc2b51e91e29d9a818c56039b5f6389982b124d3f3609c7c88293a6a"
+      "digest": "sha256:6d7567967cda5c592665641cfb8ba29255621acf77ee27b45ee6272e76879872"
     },
     {
       "id": "context.sdk.template-variables",
@@ -288,7 +288,7 @@
     {
       "id": "procedure.approved-revision",
       "path": "resources/procedures/approved-revision.md",
-      "digest": "sha256:31bc0c4dfb0393b079f69c5cfe84c0b4b0e77149e64e923838bdeeb0f7002669"
+      "digest": "sha256:fecf43f12b1759cc1ca3b716892a787b5445caa25ff7efadb2cebf042a309a0c"
     },
     {
       "id": "procedure.close-and-build",
@@ -323,7 +323,7 @@
     {
       "id": "procedure.knowledge-updates",
       "path": "resources/procedures/knowledge-updates.md",
-      "digest": "sha256:a8c3505aa7bd7e97db85fafb89a30a62f15c24e9976b1de1f5d3736143b3e0fd"
+      "digest": "sha256:8a3e8d6539bc18d4bc82cb69376b5126d53c6d1535c9145ba5770b72cf008656"
     },
     {
       "id": "procedure.note",
@@ -348,7 +348,7 @@
     {
       "id": "procedure.production-stage-files",
       "path": "resources/procedures/production-stage-files.md",
-      "digest": "sha256:add64bef96b5d87aa8205386637a00b1a4a57cf40f715fcf5659d45b577ac2cc"
+      "digest": "sha256:3baccaa799d01749dae4cdb7bf839c7d182009540d3bf91a95e775d44be2ef6c"
     },
     {
       "id": "procedure.project-configuration",
@@ -383,7 +383,7 @@
     {
       "id": "procedure.source-update",
       "path": "resources/procedures/source-update.md",
-      "digest": "sha256:70953737216d099e06875d23b5ae00759e71fc1bdcfeade9b24df9e89bc2f581"
+      "digest": "sha256:cbc558e0b2f7b2d1274dd898fc9a6a8eaaea89607452e54de0c9694088bbb3e6"
     },
     {
       "id": "procedure.task-recovery",
@@ -589,7 +589,7 @@
     },
     {
       "path": "provider.yaml",
-      "digest": "sha256:f4aa4bb6f22eb6e9fd9a95f5b44f87b404768bfbc0a40df7413df908a21b9033"
+      "digest": "sha256:5f8774eb8a7e256066407626d012ed222412c569317d2172641e04fadf991221"
     },
     {
       "path": "resources/contracts/indexer-provider-guide.yaml",
@@ -637,7 +637,7 @@
     },
     {
       "path": "resources/manuals/guides/code-indexer-skill-authoring.md",
-      "digest": "sha256:55cf273848c8acce51f83bb03b4d86222c4d431472cde573f081049f88bddece"
+      "digest": "sha256:35a403edb2efaa0814df6f7b743c9c6a997f65603667678b53f6b36a068d124b"
     },
     {
       "path": "resources/manuals/guides/imports.md",
@@ -649,7 +649,7 @@
     },
     {
       "path": "resources/manuals/guides/knowledge-updates.md",
-      "digest": "sha256:c26d6552b9a21d2ce1fb3a2508d0909165a3f61ab126fc4f7153fc2bca738e95"
+      "digest": "sha256:bdb5bfac802dfea75f38af8800216288cf740b53395ccbe4bfe5e30a1c555f48"
     },
     {
       "path": "resources/manuals/guides/lark-resources.md",
@@ -657,7 +657,7 @@
     },
     {
       "path": "resources/manuals/guides/markdown-indexer-skill-authoring.md",
-      "digest": "sha256:63dcf596e262035500d94910e1adc37d9bc4174862821a15a381019ba3ab322a"
+      "digest": "sha256:a2d9cce0fce4a220befbfa8c0a8062ec4656b1ab812b149e0a14d341967d976a"
     },
     {
       "path": "resources/manuals/guides/note.md",
@@ -665,7 +665,7 @@
     },
     {
       "path": "resources/manuals/guides/package-outputs.md",
-      "digest": "sha256:695a97ef8abc86e1fd8646f90f100f074ba7547f496087204caee73c6ab9237c"
+      "digest": "sha256:72293f50a37e09fe14177bb940e12ada2515d71e7826c808ab7b9f7bf47bcce3"
     },
     {
       "path": "resources/manuals/guides/page-customization.md",
@@ -681,7 +681,7 @@
     },
     {
       "path": "resources/manuals/guides/site-translation.md",
-      "digest": "sha256:f91c6676dc2b51e91e29d9a818c56039b5f6389982b124d3f3609c7c88293a6a"
+      "digest": "sha256:6d7567967cda5c592665641cfb8ba29255621acf77ee27b45ee6272e76879872"
     },
     {
       "path": "resources/manuals/guides/source-batches.md",
@@ -705,7 +705,7 @@
     },
     {
       "path": "resources/manuals/reference/package-templates.md",
-      "digest": "sha256:8d512d232ea5157717eca73357a213ab2449d83cf98bec217621aff79eda0216"
+      "digest": "sha256:f3a7fcc0166a6af15da550edb7937c7630bd2fb2372ca2ccd430b7cd6e56a3a9"
     },
     {
       "path": "resources/manuals/reference/project-api.md",
@@ -717,7 +717,7 @@
     },
     {
       "path": "resources/procedures/approved-revision.md",
-      "digest": "sha256:31bc0c4dfb0393b079f69c5cfe84c0b4b0e77149e64e923838bdeeb0f7002669"
+      "digest": "sha256:fecf43f12b1759cc1ca3b716892a787b5445caa25ff7efadb2cebf042a309a0c"
     },
     {
       "path": "resources/procedures/close-and-build.md",
@@ -745,7 +745,7 @@
     },
     {
       "path": "resources/procedures/knowledge-updates.md",
-      "digest": "sha256:a8c3505aa7bd7e97db85fafb89a30a62f15c24e9976b1de1f5d3736143b3e0fd"
+      "digest": "sha256:8a3e8d6539bc18d4bc82cb69376b5126d53c6d1535c9145ba5770b72cf008656"
     },
     {
       "path": "resources/procedures/note.md",
@@ -765,7 +765,7 @@
     },
     {
       "path": "resources/procedures/production-stage-files.md",
-      "digest": "sha256:add64bef96b5d87aa8205386637a00b1a4a57cf40f715fcf5659d45b577ac2cc"
+      "digest": "sha256:3baccaa799d01749dae4cdb7bf839c7d182009540d3bf91a95e775d44be2ef6c"
     },
     {
       "path": "resources/procedures/project-configuration.md",
@@ -793,7 +793,7 @@
     },
     {
       "path": "resources/procedures/source-update.md",
-      "digest": "sha256:70953737216d099e06875d23b5ae00759e71fc1bdcfeade9b24df9e89bc2f581"
+      "digest": "sha256:cbc558e0b2f7b2d1274dd898fc9a6a8eaaea89607452e54de0c9694088bbb3e6"
     },
     {
       "path": "resources/procedures/task-recovery.md",
@@ -901,7 +901,7 @@
     },
     {
       "path": "skills/translate-site-locales/SKILL.md",
-      "digest": "sha256:d736b2dff46cc75330522ecbef41f10d77b24dae87fcd290418bb25683f94a43"
+      "digest": "sha256:b13be9668338273cb6f2a7baa4bf1249d77e63895369220af84193c1de3da3ad"
     },
     {
       "path": "skills/work-production-stage/SKILL.md",
@@ -912,5 +912,5 @@
     "indexer": [],
     "workspace": []
   },
-  "digest": "sha256:063167b951010b10898421a8585b4cd8311eb002f56d08131d675c1755c510c1"
+  "digest": "sha256:5414538128cc2628c96857e762427d169d4a308752b47d4d674361ca7a6c123f"
 }

package/providers/context/provider.yaml

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

package/providers/context/resources/manuals/guides/code-indexer-skill-authoring.md

@@ -50,7 +50,8 @@ proof of runtime behavior. Preserve expressions without executing project code,
 distinguish declaration defaults from implementation defaults, and state unknowns.
 
 Use the current stage's Markdown and reference-file schemas. Each fragment cites
-at most three actual source locations; the CLI computes regional digests. Split
+actual source regions from at most three files (up to eight regions); the CLI
+computes regional digests. Split
 an explanation when it needs separate evidence, not to fill a fixed template.
 Reuse stable article and fragment identities when revising. Supporting documents,
 notes or sessions may contribute to the same article without becoming code facts.

package/providers/context/resources/manuals/guides/knowledge-updates.md

@@ -338,7 +338,7 @@ changing structure, adding a page or when a section has no unambiguous ID.
 To change a fragment's citations, include `references` alongside its `section_id`:
 each entry supplies `source_ref` and `locator` (`path`, `start_line`, `end_line`).
 Context computes the region fingerprint. This uses the same revision submission,
-with at most three source positions per fragment. Full Markdown may include a
+with at most three source files and eight regions per fragment. Full Markdown may include a
 `sections` list of reference edits; local section edits may change content,
 references, or both. Omission preserves citations; an empty list removes them.
 
@@ -703,17 +703,19 @@ Revision section edits may supply `references` as `source_ref` plus a
 `locator` containing `path`, `start_line`, and `end_line`. Context computes the
 regional digest. Omitted references preserve the current fragment's citations;
 an explicit empty list removes them, and deleting a fragment removes its
-citations. Each fragment may cite at most three source positions. Register and
+citations. Each fragment may cite at most three source files and eight regions. Register and
 authorize new material before citing it, then follow normal Review, close and
 build. Article links alone do not authorize reading new sources or prove a claim.
 
 ### Locating submitted references
 
 Submission locators also accept `{path, heading}` or `{path, quote}` instead of
-line numbers. Use exactly one form. A heading matches an exact ATX heading
-outside code fences in a Markdown source; its region ends before the next
+line numbers. Use exactly one form. A heading is the title text of an exact ATX heading
+outside code fences in a Markdown source; a leading `##` marker is optional and,
+when present, also selects the heading level; its region ends before the next
 same-level or higher-level heading. A quote is an exact, unique, nonempty
 substring (line endings are normalized). Ambiguous matches return candidate
 line ranges. Both forms resolve against authorized captured text before hashing;
 stored references still contain only `path`, `start_line` and `end_line`.
-The three-region limit applies after resolving and deduplicating positions.
+The per-fragment limits (three source files, eight regions) apply after
+resolving and deduplicating positions.