@c4a/context-cli 0.7.66 → 0.7.70

package/indexers/release-manifest.json

@@ -1,7 +1,7 @@
 {
   "protocol": "context.indexer.cli-release-manifest/v1",
   "package": "@c4a/context-cli",
-  "version": "0.7.66",
+  "version": "0.7.70",
   "issuer": "context4ai/context",
   "bundles": [
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context-cli",
-  "version": "0.7.66",
+  "version": "0.7.70",
   "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.66",
-    "@c4a/extract": "0.7.66",
-    "@c4a/extract-contract": "0.7.66",
-    "@c4a/extract-go": "0.7.66",
-    "@c4a/extract-mdx": "0.7.66",
-    "@c4a/extract-proto": "0.7.66",
-    "@c4a/extract-rush": "0.7.66",
-    "@c4a/extract-sql": "0.7.66",
-    "@c4a/extract-style": "0.7.66",
-    "@c4a/extract-thrift": "0.7.66",
-    "@c4a/extract-ts": "0.7.66",
+    "@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",
     "@mermaid-js/layout-elk": "0.2.0",
     "commander": "^11.0.0",
     "fast-xml-parser": "^5.10.1",

package/parserEntryWorker.js

@@ -18099,6 +18099,19 @@ var init_indexerAgentStepProtocol = __esm(() => {
   ]);
 });
 
+// ../context/src/articleSourceLocatorInput.ts
+var articleSourceLocatorInputSchema;
+var init_articleSourceLocatorInput = __esm(() => {
+  init_zod();
+  init_articleStructure();
+  init_indexerProtocolCommon();
+  articleSourceLocatorInputSchema = exports_external.union([
+    articleSourceLocatorSchema,
+    exports_external.object({ path: portableIndexerPathSchema, heading: exports_external.string().trim().min(1) }).strict(),
+    exports_external.object({ path: portableIndexerPathSchema, quote: exports_external.string().min(1) }).strict()
+  ]);
+});
+
 // ../context/src/knowledgeMap.ts
 function validateEntries(entries) {
   const indexed = new Map(entries.map((entry) => [entry.key, entry]));
@@ -18208,6 +18221,7 @@ function parseIndexerCurrentActionSubmission(value) {
 }
 var catalogProviderSelectionSchema, providerSelectionEntrySchema, providerObservationSchema, indexerProviderSelectionSemanticInputSchema, indexerProviderResolutionSemanticInputSchema, indexerProviderProgramAuthorizationSemanticInputSchema, partitionGroupSchema2, partitionDispositionSchema, partitionUnsupportedSchema, completePartitionInputSchema, failedPartitionInputSchema, indexerPartitionSemanticInputSchema, authorVisualSchema, authorSectionSchema, authorTemplateVariablesSchema, authorMemberDispositionSchema, authorMaterialGapSchema, authorDiagnosticSchema, authorInputBaseSchema, indexerAuthorSemanticInputSchema, indexerPartitionBatchSemanticInputSchema, indexerAuthorBatchSemanticInputSchema, indexerMainBatchSubmissionEnvelopeSchema, postAuthorSectionSchema, postAuthorInputBaseSchema, indexerPostAuthorSemanticInputSchema, indexerPostAuthorBatchSemanticInputSchema, structureReviewBaseSchema, indexerStructureReviewInputSchema, layoutConfirmationBaseSchema, indexerLayoutConfirmationInputSchema, revisionSectionReferencesSchema, approvedRevisionSemanticInputSchema, sourceUpdateSemanticInputSchema, indexerCurrentActionInputDefinitions, indexerCurrentActionInputSchema;
 var init_indexerSemanticInput = __esm(() => {
+  init_articleSourceLocatorInput();
   init_articleStructure();
   init_indexerProtocolCommon();
   init_knowledgeMap();
@@ -18513,8 +18527,8 @@ var init_indexerSemanticInput = __esm(() => {
   ]);
   revisionSectionReferencesSchema = exports_external.array(exports_external.object({
     source_ref: exports_external.string().min(1),
-    locator: articleSourceLocatorSchema
-  }).strict()).max(3);
+    locator: articleSourceLocatorInputSchema
+  }).strict());
   approvedRevisionSemanticInputSchema = exports_external.union([
     exports_external.object({
       stage: exports_external.literal("approved-revision"),
@@ -20725,6 +20739,7 @@ var init_src = __esm(() => {
   init_knowledgeMap();
   init_indexerApprovedKnowledge();
   init_articleStructure();
+  init_articleSourceLocatorInput();
 });
 
 // src/project/codeAnalysisInput.ts

package/plugins/VERSION

@@ -1 +1 @@
-0.7.66
+0.7.70

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.66",
+  "version": "0.7.70",
   "author": {
     "name": "c4a"
   },

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

@@ -1,6 +1,6 @@
 {
   "name": "c4a",
-  "version": "0.7.66",
+  "version": "0.7.70",
   "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.66",
+    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.70",
     "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.66",
+  "version": "0.7.70",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
   "author": {
     "name": "Context4AI",

package/providers/context/manifest.json

@@ -2,7 +2,7 @@
   "schema": "agent-graph.bundle.v1",
   "provider": {
     "id": "c4a/context",
-    "version": "0.7.66"
+    "version": "0.7.70"
   },
   "providerManifest": "provider.yaml",
   "graphs": [
@@ -193,7 +193,7 @@
     {
       "id": "context.sdk.package-outputs",
       "path": "resources/manuals/guides/package-outputs.md",
-      "digest": "sha256:cfdd455edd5cb04ede7525a78458f8086d58a59f94e24cde4ca591628d1a22df"
+      "digest": "sha256:695a97ef8abc86e1fd8646f90f100f074ba7547f496087204caee73c6ab9237c"
     },
     {
       "id": "context.sdk.package-templates",
@@ -213,7 +213,7 @@
     {
       "id": "context.sdk.site-translation",
       "path": "resources/manuals/guides/site-translation.md",
-      "digest": "sha256:369ffdc81481e48843891f5e007129d38047e4077a693b3bc58fa6c8e8f86666"
+      "digest": "sha256:f91c6676dc2b51e91e29d9a818c56039b5f6389982b124d3f3609c7c88293a6a"
     },
     {
       "id": "context.sdk.template-variables",
@@ -248,7 +248,7 @@
     {
       "id": "diagnostic.verification",
       "path": "resources/diagnostics/verification.md",
-      "digest": "sha256:c8a3933fa250c66d12542fc1cf91bdd231ce578c34676d8bc2d7638d325e649f"
+      "digest": "sha256:49ea3bfff8b1315aa81f2dfef245ca181499a40c10bca43ec12a37f7d50383a8"
     },
     {
       "id": "diagnostic.workspace-state",
@@ -288,7 +288,7 @@
     {
       "id": "procedure.approved-revision",
       "path": "resources/procedures/approved-revision.md",
-      "digest": "sha256:4ee897e6c13e0e908e4d28b239d93f74e66756ef7707277997225743ca250552"
+      "digest": "sha256:31bc0c4dfb0393b079f69c5cfe84c0b4b0e77149e64e923838bdeeb0f7002669"
     },
     {
       "id": "procedure.close-and-build",
@@ -323,7 +323,7 @@
     {
       "id": "procedure.knowledge-updates",
       "path": "resources/procedures/knowledge-updates.md",
-      "digest": "sha256:6b54d24f6928721e1e941c904d45aee97fe053cb90173f297659b7fdb181e0da"
+      "digest": "sha256:a8c3505aa7bd7e97db85fafb89a30a62f15c24e9976b1de1f5d3736143b3e0fd"
     },
     {
       "id": "procedure.note",
@@ -348,7 +348,7 @@
     {
       "id": "procedure.production-stage-files",
       "path": "resources/procedures/production-stage-files.md",
-      "digest": "sha256:00abeb0d32efb3fa8bf65fe1864e42fd5a16be42c2de7644a344465699cecc0a"
+      "digest": "sha256:add64bef96b5d87aa8205386637a00b1a4a57cf40f715fcf5659d45b577ac2cc"
     },
     {
       "id": "procedure.project-configuration",
@@ -435,12 +435,12 @@
     {
       "id": "schemas/approved-revision-result.schema.json",
       "path": "schemas/approved-revision-result.schema.json",
-      "digest": "sha256:18d66d69acd29ff87aba456e58dacc693781768f066411262912df47a2367de5"
+      "digest": "sha256:e672c5c6de7f0f6eb523486b71a7b92ae735d36632fafc351b734732d6fbedb0"
     },
     {
       "id": "schemas/indexer-agent-step-result.schema.json",
       "path": "schemas/indexer-agent-step-result.schema.json",
-      "digest": "sha256:9900937515f9987775e6a61c3b8ce4d754296ce5a1958e69985676665d2f8ec6"
+      "digest": "sha256:b80501f5c131ffd731cd2f96513c37aa012c3470098a287bd58b06c4698af6d2"
     },
     {
       "id": "context.indexer.registry-bootstrap",
@@ -589,7 +589,7 @@
     },
     {
       "path": "provider.yaml",
-      "digest": "sha256:4f47fb7a3549e3bba40a3a291e53e01dc2e7f99e39674032a076528c531415ea"
+      "digest": "sha256:f4aa4bb6f22eb6e9fd9a95f5b44f87b404768bfbc0a40df7413df908a21b9033"
     },
     {
       "path": "resources/contracts/indexer-provider-guide.yaml",
@@ -605,7 +605,7 @@
     },
     {
       "path": "resources/diagnostics/verification.md",
-      "digest": "sha256:c8a3933fa250c66d12542fc1cf91bdd231ce578c34676d8bc2d7638d325e649f"
+      "digest": "sha256:49ea3bfff8b1315aa81f2dfef245ca181499a40c10bca43ec12a37f7d50383a8"
     },
     {
       "path": "resources/diagnostics/workspace-state.md",
@@ -649,7 +649,7 @@
     },
     {
       "path": "resources/manuals/guides/knowledge-updates.md",
-      "digest": "sha256:e389fcc1d5dd4be5e4255889f68e977f34b16d983e169b1c3cc5f6d97322a487"
+      "digest": "sha256:c26d6552b9a21d2ce1fb3a2508d0909165a3f61ab126fc4f7153fc2bca738e95"
     },
     {
       "path": "resources/manuals/guides/lark-resources.md",
@@ -665,7 +665,7 @@
     },
     {
       "path": "resources/manuals/guides/package-outputs.md",
-      "digest": "sha256:cfdd455edd5cb04ede7525a78458f8086d58a59f94e24cde4ca591628d1a22df"
+      "digest": "sha256:695a97ef8abc86e1fd8646f90f100f074ba7547f496087204caee73c6ab9237c"
     },
     {
       "path": "resources/manuals/guides/page-customization.md",
@@ -681,7 +681,7 @@
     },
     {
       "path": "resources/manuals/guides/site-translation.md",
-      "digest": "sha256:369ffdc81481e48843891f5e007129d38047e4077a693b3bc58fa6c8e8f86666"
+      "digest": "sha256:f91c6676dc2b51e91e29d9a818c56039b5f6389982b124d3f3609c7c88293a6a"
     },
     {
       "path": "resources/manuals/guides/source-batches.md",
@@ -717,7 +717,7 @@
     },
     {
       "path": "resources/procedures/approved-revision.md",
-      "digest": "sha256:4ee897e6c13e0e908e4d28b239d93f74e66756ef7707277997225743ca250552"
+      "digest": "sha256:31bc0c4dfb0393b079f69c5cfe84c0b4b0e77149e64e923838bdeeb0f7002669"
     },
     {
       "path": "resources/procedures/close-and-build.md",
@@ -745,7 +745,7 @@
     },
     {
       "path": "resources/procedures/knowledge-updates.md",
-      "digest": "sha256:6b54d24f6928721e1e941c904d45aee97fe053cb90173f297659b7fdb181e0da"
+      "digest": "sha256:a8c3505aa7bd7e97db85fafb89a30a62f15c24e9976b1de1f5d3736143b3e0fd"
     },
     {
       "path": "resources/procedures/note.md",
@@ -765,7 +765,7 @@
     },
     {
       "path": "resources/procedures/production-stage-files.md",
-      "digest": "sha256:00abeb0d32efb3fa8bf65fe1864e42fd5a16be42c2de7644a344465699cecc0a"
+      "digest": "sha256:add64bef96b5d87aa8205386637a00b1a4a57cf40f715fcf5659d45b577ac2cc"
     },
     {
       "path": "resources/procedures/project-configuration.md",
@@ -857,11 +857,11 @@
     },
     {
       "path": "schemas/approved-revision-result.schema.json",
-      "digest": "sha256:18d66d69acd29ff87aba456e58dacc693781768f066411262912df47a2367de5"
+      "digest": "sha256:e672c5c6de7f0f6eb523486b71a7b92ae735d36632fafc351b734732d6fbedb0"
     },
     {
       "path": "schemas/indexer-agent-step-result.schema.json",
-      "digest": "sha256:9900937515f9987775e6a61c3b8ce4d754296ce5a1958e69985676665d2f8ec6"
+      "digest": "sha256:b80501f5c131ffd731cd2f96513c37aa012c3470098a287bd58b06c4698af6d2"
     },
     {
       "path": "schemas/indexer-registry-bootstrap.schema.json",
@@ -901,7 +901,7 @@
     },
     {
       "path": "skills/translate-site-locales/SKILL.md",
-      "digest": "sha256:b5197f6568b1443022d631f661d7484291c9be512b78109f91e6b42806294e7e"
+      "digest": "sha256:d736b2dff46cc75330522ecbef41f10d77b24dae87fcd290418bb25683f94a43"
     },
     {
       "path": "skills/work-production-stage/SKILL.md",
@@ -912,5 +912,5 @@
     "indexer": [],
     "workspace": []
   },
-  "digest": "sha256:1bcf1bb627d06f9259cb0851140fbe276447f68ecaaf5c0e2519140c176b91a3"
+  "digest": "sha256:063167b951010b10898421a8585b4cd8311eb002f56d08131d675c1755c510c1"
 }

package/providers/context/provider.yaml

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

package/providers/context/resources/diagnostics/verification.md

@@ -19,3 +19,5 @@ whether the content needs revision.
 Changed, missing or ambiguously relocated source regions identify articles to
 inspect through the normal revision workflow. Warnings do not add a separate
 maintenance gate, silently rewrite articles or confirm that the prose is current.
+Build does not repeat this comparison or read registered sources, so package
+pages carry no source-region notice; run verify before publishing.

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

@@ -706,3 +706,14 @@ an explicit empty list removes them, and deleting a fragment removes its
 citations. Each fragment may cite at most three source positions. 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
+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.

package/providers/context/resources/manuals/guides/package-outputs.md

@@ -173,8 +173,8 @@ the workspace under `translations/<tag>/` and follow the
 [site translation](site-translation.md) procedure. The top bar language button
 switches the current page in place. A saved choice wins, then the browser
 languages, then `site.lang`; the choice is remembered under
-`site.localePreferenceKey` (default `context-locale:<package>:<base>`), which
-sites on one origin can share. Pages without a current translation show the
+`site.localePreferenceKey` (default `context-locale`), which
+sites on one origin share unless configured otherwise. Pages without a current translation show the
 original with a notice. LLM Docs and Changelog stay in the primary language.
 `context-site-map.json` lists translated, stale and missing counts per locale.
 Without `site.locales` the button still switches the interface between Chinese
@@ -575,6 +575,10 @@ not a generated HTML file: builds never overwrite existing values. Deleting it
 restores built-in defaults; Review does not need the file or an existing website
 build. The next website build recreates it.
 
+Websites open in light mode regardless of the system color scheme. The reader's
+light/dark choice is remembered under the origin-wide `context-theme` key, so
+sites and other pages on one origin share it.
+
 Each `light`/`dark` object supports `brand`, `accent`, `background`, `surface`,
 `text`, `mutedText`, and `border`. Values are hexadecimal CSS colors (`#RGB`,
 `#RRGGBB`, or `#RRGGBBAA`). Partial objects inherit missing default colors. Invalid

package/providers/context/resources/manuals/guides/site-translation.md

@@ -60,8 +60,11 @@ map_entries:
 ```
 
 A translated article keeps every `context:section` marker, id and order, every
-fenced code block with its language and content (Mermaid labels may change), and
-every link target. Submission validates all items first and saves nothing when
+fenced code block and its language marker, and every link target. Prose in
+`text`, `txt`, and `plaintext` blocks may be translated; keep commands, paths,
+and placeholders such as `<repository>` unchanged. Mermaid labels may change.
+All other blocks, including blocks without a language marker, keep their content
+unchanged. Submission validates all items first and saves nothing when
 any item fails. A digest from before an approved content change is rejected.
 
 `skip` records that the current pending items are published in the primary
@@ -76,3 +79,24 @@ an outdated notice and a button that switches to the original; a missing page
 shows the original with a notice. Navigation titles without a translation use
 the translated article title, then the primary title. Site search covers every
 language; opening a result in another language switches to it.
+
+
+## Incremental drafts
+
+`prepare` returns section changes, title/description changes, exterior-text changes
+(including the article tail), and section order changes. It writes draft files
+and a `submission_path` template. Unchanged parts retain their translation;
+changed parts contain the current primary-language text for the Agent to translate.
+Review every pending part before submitting; generated source text is not a translation.
+
+Older current translations acquire source-part baselines without changing their
+reader text. Older stale translations report `diff: unknown` and get a full source
+draft plus a `.previous.md` translation for comparison.
+
+Repeated preparation preserves edited drafts. `draft: rebase-required` means the
+source changed while a draft was being edited; that draft is excluded from the
+submission template. Reconcile it with the current source, then explicitly add
+the returned `source_digest` to that article's submission entry. Never copy a new
+digest onto an unreconciled draft. Ordinary submissions still use `expected_digest`.
+A draft without a generation record, such as one left by an older workflow, is
+kept as `unrecorded_draft` beside a freshly generated draft.

package/providers/context/resources/procedures/approved-revision.md

@@ -170,3 +170,14 @@ If the user explicitly requires a different presentation, explain the difference
 and resolve that choice before accepting it. Do not rerun unchanged Repair to
 force a format the program deliberately omits. Check the actual resulting page;
 accepted tasks or an empty Composer result alone do not demonstrate a correction.
+
+### 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
+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.

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

@@ -706,3 +706,14 @@ an explicit empty list removes them, and deleting a fragment removes its
 citations. Each fragment may cite at most three source positions. 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
+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.

package/providers/context/resources/procedures/production-stage-files.md

@@ -104,3 +104,14 @@ build resumes the same stage; a failed build retains the pause and all tasks.
 To cancel that pause explicitly, use `context run --resume-writing --format json`.
 It preserves approved articles, candidates and existing task input handles.
 Partial delivery must include the approved articles needed by its local links.
+
+### 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
+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.

package/providers/context/schemas/approved-revision-result.schema.json

@@ -30,26 +30,64 @@
                       "minLength": 1
                     },
                     "locator": {
-                      "type": "object",
-                      "properties": {
-                        "path": {
-                          "type": "string"
+                      "anyOf": [
+                        {
+                          "type": "object",
+                          "properties": {
+                            "path": {
+                              "type": "string"
+                            },
+                            "start_line": {
+                              "type": "integer",
+                              "minimum": 1
+                            },
+                            "end_line": {
+                              "type": "integer",
+                              "minimum": 1
+                            }
+                          },
+                          "required": [
+                            "path",
+                            "start_line",
+                            "end_line"
+                          ],
+                          "additionalProperties": false
                         },
-                        "start_line": {
-                          "type": "integer",
-                          "minimum": 1
+                        {
+                          "type": "object",
+                          "properties": {
+                            "path": {
+                              "$ref": "#/anyOf/0/properties/sections/items/properties/references/items/properties/locator/anyOf/0/properties/path"
+                            },
+                            "heading": {
+                              "type": "string",
+                              "minLength": 1
+                            }
+                          },
+                          "required": [
+                            "path",
+                            "heading"
+                          ],
+                          "additionalProperties": false
                         },
-                        "end_line": {
-                          "type": "integer",
-                          "minimum": 1
+                        {
+                          "type": "object",
+                          "properties": {
+                            "path": {
+                              "$ref": "#/anyOf/0/properties/sections/items/properties/references/items/properties/locator/anyOf/0/properties/path"
+                            },
+                            "quote": {
+                              "type": "string",
+                              "minLength": 1
+                            }
+                          },
+                          "required": [
+                            "path",
+                            "quote"
+                          ],
+                          "additionalProperties": false
                         }
-                      },
-                      "required": [
-                        "path",
-                        "start_line",
-                        "end_line"
-                      ],
-                      "additionalProperties": false
+                      ]
                     }
                   },
                   "required": [
@@ -57,8 +95,7 @@
                     "locator"
                   ],
                   "additionalProperties": false
-                },
-                "maxItems": 3
+                }
               }
             },
             "required": [

package/providers/context/schemas/indexer-agent-step-result.schema.json

@@ -129,26 +129,64 @@
                           "minLength": 1
                         },
                         "locator": {
-                          "type": "object",
-                          "properties": {
-                            "path": {
-                              "type": "string"
+                          "anyOf": [
+                            {
+                              "type": "object",
+                              "properties": {
+                                "path": {
+                                  "type": "string"
+                                },
+                                "start_line": {
+                                  "type": "integer",
+                                  "minimum": 1
+                                },
+                                "end_line": {
+                                  "type": "integer",
+                                  "minimum": 1
+                                }
+                              },
+                              "required": [
+                                "path",
+                                "start_line",
+                                "end_line"
+                              ],
+                              "additionalProperties": false
                             },
-                            "start_line": {
-                              "type": "integer",
-                              "minimum": 1
+                            {
+                              "type": "object",
+                              "properties": {
+                                "path": {
+                                  "$ref": "#/$defs/approvedRevision/anyOf/0/properties/sections/items/properties/references/items/properties/locator/anyOf/0/properties/path"
+                                },
+                                "heading": {
+                                  "type": "string",
+                                  "minLength": 1
+                                }
+                              },
+                              "required": [
+                                "path",
+                                "heading"
+                              ],
+                              "additionalProperties": false
                             },
-                            "end_line": {
-                              "type": "integer",
-                              "minimum": 1
+                            {
+                              "type": "object",
+                              "properties": {
+                                "path": {
+                                  "$ref": "#/$defs/approvedRevision/anyOf/0/properties/sections/items/properties/references/items/properties/locator/anyOf/0/properties/path"
+                                },
+                                "quote": {
+                                  "type": "string",
+                                  "minLength": 1
+                                }
+                              },
+                              "required": [
+                                "path",
+                                "quote"
+                              ],
+                              "additionalProperties": false
                             }
-                          },
-                          "required": [
-                            "path",
-                            "start_line",
-                            "end_line"
-                          ],
-                          "additionalProperties": false
+                          ]
                         }
                       },
                       "required": [
@@ -156,8 +194,7 @@
                         "locator"
                       ],
                       "additionalProperties": false
-                    },
-                    "maxItems": 3
+                    }
                   }
                 },
                 "required": [