@c4a/context-cli 0.7.67 → 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.67",
+  "version": "0.7.70",
   "issuer": "context4ai/context",
   "bundles": [
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context-cli",
-  "version": "0.7.67",
+  "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.67",
-    "@c4a/extract": "0.7.67",
-    "@c4a/extract-contract": "0.7.67",
-    "@c4a/extract-go": "0.7.67",
-    "@c4a/extract-mdx": "0.7.67",
-    "@c4a/extract-proto": "0.7.67",
-    "@c4a/extract-rush": "0.7.67",
-    "@c4a/extract-sql": "0.7.67",
-    "@c4a/extract-style": "0.7.67",
-    "@c4a/extract-thrift": "0.7.67",
-    "@c4a/extract-ts": "0.7.67",
+    "@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.67
+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.67",
+  "version": "0.7.70",
   "author": {
     "name": "c4a"
   },

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

@@ -1,6 +1,6 @@
 {
   "name": "c4a",
-  "version": "0.7.67",
+  "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.67",
+    "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.67",
+  "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.67"
+    "version": "0.7.70"
   },
   "providerManifest": "provider.yaml",
   "graphs": [
@@ -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",
@@ -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:13d87c848d3f6b43d934f8f23da53a8fa3e52566a18a11c9850c0a2e084bfc41"
+      "digest": "sha256:f4aa4bb6f22eb6e9fd9a95f5b44f87b404768bfbc0a40df7413df908a21b9033"
     },
     {
       "path": "resources/contracts/indexer-provider-guide.yaml",
@@ -649,7 +649,7 @@
     },
     {
       "path": "resources/manuals/guides/knowledge-updates.md",
-      "digest": "sha256:e389fcc1d5dd4be5e4255889f68e977f34b16d983e169b1c3cc5f6d97322a487"
+      "digest": "sha256:c26d6552b9a21d2ce1fb3a2508d0909165a3f61ab126fc4f7153fc2bca738e95"
     },
     {
       "path": "resources/manuals/guides/lark-resources.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:e70281043cdf69e95392b4fcf03d83a8ce7ea0c5ce846b426c43105a9540b5d9"
+  "digest": "sha256:063167b951010b10898421a8585b4cd8311eb002f56d08131d675c1755c510c1"
 }

package/providers/context/provider.yaml

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

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/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": [

package/providers/context/skills/translate-site-locales/SKILL.md

@@ -8,13 +8,20 @@ knowledge map title that is missing or stale for each declared locale, with the
 `expected_digest` to submit. Approved knowledge in the primary language remains
 the only source of truth; translations never change it.
 
+Use the returned draft and submission paths. Preserve unchanged translated parts
+and translate the listed changes in a natural tone. For `diff: unknown`, compare
+with the previous translation. A `rebase-required` draft must be reconciled with
+the current source before explicitly confirming its `source_digest`.
+
 For each article, read the approved file and write a complete translation to a
 temporary file under `.tmp/agent-payloads/`. Keep its structure exactly:
 
 - frontmatter contains only a translated `title` and optional `description`;
 - keep every `context:section` marker, id and order unchanged;
-- keep every fenced code block, language and content unchanged; only Mermaid
-  labels may be translated;
+- keep every fenced code block and language marker; translate prose in `text`,
+  `txt`, and `plaintext` blocks, preserving commands, paths and placeholders such
+  as `<repository>`. Mermaid labels may be translated. Keep content unchanged
+  in every other block, including blocks without a language marker;
 - keep every link target unchanged; translate link labels only;
 - keep product names, commands, file paths, identifiers and API names as written.