@c4a/context-cli 0.7.13 → 0.7.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "protocol": "context.indexer.cli-release-manifest/v1",
3
3
  "package": "@c4a/context-cli",
4
- "version": "0.7.13",
4
+ "version": "0.7.14",
5
5
  "issuer": "context4ai/context",
6
6
  "bundles": [
7
7
  {
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@c4a/context-cli",
3
- "version": "0.7.13",
3
+ "version": "0.7.14",
4
4
  "type": "module",
5
5
  "description": "Local runtime and Agent integration for traceable knowledge production",
6
6
  "license": "MIT",
@@ -24,17 +24,17 @@
24
24
  },
25
25
  "dependencies": {
26
26
  "@c4a/agent-graph": "0.3.0",
27
- "@c4a/context": "0.7.13",
28
- "@c4a/extract": "0.7.13",
29
- "@c4a/extract-contract": "0.7.13",
30
- "@c4a/extract-go": "0.7.13",
31
- "@c4a/extract-mdx": "0.7.13",
32
- "@c4a/extract-proto": "0.7.13",
33
- "@c4a/extract-rush": "0.7.13",
34
- "@c4a/extract-sql": "0.7.13",
35
- "@c4a/extract-style": "0.7.13",
36
- "@c4a/extract-thrift": "0.7.13",
37
- "@c4a/extract-ts": "0.7.13",
27
+ "@c4a/context": "0.7.14",
28
+ "@c4a/extract": "0.7.14",
29
+ "@c4a/extract-contract": "0.7.14",
30
+ "@c4a/extract-go": "0.7.14",
31
+ "@c4a/extract-mdx": "0.7.14",
32
+ "@c4a/extract-proto": "0.7.14",
33
+ "@c4a/extract-rush": "0.7.14",
34
+ "@c4a/extract-sql": "0.7.14",
35
+ "@c4a/extract-style": "0.7.14",
36
+ "@c4a/extract-thrift": "0.7.14",
37
+ "@c4a/extract-ts": "0.7.14",
38
38
  "commander": "^11.0.0",
39
39
  "fast-xml-parser": "^5.10.1",
40
40
  "handlebars": "^4.7.8",
package/plugins/VERSION CHANGED
@@ -1 +1 @@
1
- 0.7.13
1
+ 0.7.14
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "c4a",
3
3
  "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
4
- "version": "0.7.13",
4
+ "version": "0.7.14",
5
5
  "author": {
6
6
  "name": "c4a"
7
7
  },
@@ -135,6 +135,24 @@ inferences and unavailable evidence. If source versions differ, describe the
135
135
  difference before deciding that a knowledge page is wrong. Do not dump runtime
136
136
  ids, long raw excerpts or a mandatory audit report into every answer.
137
137
 
138
+
139
+ ## Website links in the final summary
140
+
141
+ After answering from the pages actually read, optionally append one or more
142
+ related document links in the final summary. Read `context-site-map.json` from
143
+ the selected package (or its sibling website output in a workspace). Match the
144
+ read page to `pages[].package_path` or `approved_path`; use its `title` and resolve
145
+ `site_path` relative to `site_url`. The URL already includes the deployment base
146
+ path: do not prepend `base` again. Only cite matched articles, deduplicate links,
147
+ and do not invent section anchors.
148
+
149
+ This is a local formatting step, not retrieval or validation. Do not probe URLs,
150
+ make HTTP/HEAD requests, open a browser, inspect a deployment platform, or check
151
+ remote versions to add links. Never build, publish or update metadata for this
152
+ purpose. If the map, URL or matching page is absent or malformed, keep the local
153
+ citation and continue silently. A configured URL does not prove that the site
154
+ contains the current local revision; do not claim online verification.
155
+
138
156
  ## Suggest improvements and hand off
139
157
 
140
158
  When evidence supports a correction or worthwhile addition, briefly describe:
@@ -49,6 +49,17 @@ Within an active Context workflow, requests include, but are not limited to:
49
49
  | Commit workspace results | Save selected workspace files in local Git, without pushing or including unrelated changes. |
50
50
  | Restore a historical workspace version | Select a saved commit, restore only the agreed workspace scope and make its sources usable again. |
51
51
 
52
+ ## Preserve existing reading organization
53
+
54
+ For additions as well as navigation edits, first read the workspace AGENTS.md,
55
+ current map and relevant overview/category articles. Reuse their category intent;
56
+ a new source or product does not by itself justify a top-level menu. Follow the
57
+ knowledge-updates guidance returned by `context entry` or the current Route,
58
+ especially "Preserve established navigation intent". Include proposed top-level
59
+ changes in the work-start report or current plan for explicit human review before
60
+ applying them; reuse a concrete structure the user has already approved. Ordinary
61
+ placements within the approved organization do not require another review gate.
62
+
52
63
  ## Read the task before registering sources
53
64
 
54
65
  For a knowledge-map-only request, use the existing workspace directly. Read
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "c4a",
3
- "version": "0.7.13",
3
+ "version": "0.7.14",
4
4
  "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
5
5
  "author": { "name": "c4a" },
6
6
  "homepage": "https://github.com/context4ai/c4a",
@@ -10,7 +10,7 @@
10
10
  "skills": "./skills/",
11
11
  "interface": {
12
12
  "displayName": "C4A Context",
13
- "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.13",
13
+ "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.7.14",
14
14
  "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.",
15
15
  "developerName": "c4a",
16
16
  "category": "Productivity",
@@ -47,6 +47,17 @@ Within an active Context workflow, requests include, but are not limited to:
47
47
  | Commit workspace results | Save selected workspace files in local Git, without pushing or including unrelated changes. |
48
48
  | Restore a historical workspace version | Select a saved commit, restore only the agreed workspace scope and make its sources usable again. |
49
49
 
50
+ ## Preserve existing reading organization
51
+
52
+ For additions as well as navigation edits, first read the workspace AGENTS.md,
53
+ current map and relevant overview/category articles. Reuse their category intent;
54
+ a new source or product does not by itself justify a top-level menu. Follow the
55
+ knowledge-updates guidance returned by `context entry` or the current Route,
56
+ especially "Preserve established navigation intent". Include proposed top-level
57
+ changes in the work-start report or current plan for explicit human review before
58
+ applying them; reuse a concrete structure the user has already approved. Ordinary
59
+ placements within the approved organization do not require another review gate.
60
+
50
61
  ## Read the task before registering sources
51
62
 
52
63
  For a knowledge-map-only request, use the existing workspace directly. Read
@@ -135,6 +135,24 @@ inferences and unavailable evidence. If source versions differ, describe the
135
135
  difference before deciding that a knowledge page is wrong. Do not dump runtime
136
136
  ids, long raw excerpts or a mandatory audit report into every answer.
137
137
 
138
+
139
+ ## Website links in the final summary
140
+
141
+ After answering from the pages actually read, optionally append one or more
142
+ related document links in the final summary. Read `context-site-map.json` from
143
+ the selected package (or its sibling website output in a workspace). Match the
144
+ read page to `pages[].package_path` or `approved_path`; use its `title` and resolve
145
+ `site_path` relative to `site_url`. The URL already includes the deployment base
146
+ path: do not prepend `base` again. Only cite matched articles, deduplicate links,
147
+ and do not invent section anchors.
148
+
149
+ This is a local formatting step, not retrieval or validation. Do not probe URLs,
150
+ make HTTP/HEAD requests, open a browser, inspect a deployment platform, or check
151
+ remote versions to add links. Never build, publish or update metadata for this
152
+ purpose. If the map, URL or matching page is absent or malformed, keep the local
153
+ citation and continue silently. A configured URL does not prove that the site
154
+ contains the current local revision; do not claim online verification.
155
+
138
156
  ## Suggest improvements and hand off
139
157
 
140
158
  When evidence supports a correction or worthwhile addition, briefly describe:
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "c4a",
3
3
  "displayName": "C4A Context",
4
- "version": "0.7.13",
4
+ "version": "0.7.14",
5
5
  "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
6
6
  "author": {
7
7
  "name": "Context4AI",
@@ -133,6 +133,24 @@ inferences and unavailable evidence. If source versions differ, describe the
133
133
  difference before deciding that a knowledge page is wrong. Do not dump runtime
134
134
  ids, long raw excerpts or a mandatory audit report into every answer.
135
135
 
136
+
137
+ ## Website links in the final summary
138
+
139
+ After answering from the pages actually read, optionally append one or more
140
+ related document links in the final summary. Read `context-site-map.json` from
141
+ the selected package (or its sibling website output in a workspace). Match the
142
+ read page to `pages[].package_path` or `approved_path`; use its `title` and resolve
143
+ `site_path` relative to `site_url`. The URL already includes the deployment base
144
+ path: do not prepend `base` again. Only cite matched articles, deduplicate links,
145
+ and do not invent section anchors.
146
+
147
+ This is a local formatting step, not retrieval or validation. Do not probe URLs,
148
+ make HTTP/HEAD requests, open a browser, inspect a deployment platform, or check
149
+ remote versions to add links. Never build, publish or update metadata for this
150
+ purpose. If the map, URL or matching page is absent or malformed, keep the local
151
+ citation and continue silently. A configured URL does not prove that the site
152
+ contains the current local revision; do not claim online verification.
153
+
136
154
  ## Suggest improvements and hand off
137
155
 
138
156
  When evidence supports a correction or worthwhile addition, briefly describe:
@@ -44,6 +44,17 @@ Within an active Context workflow, requests include, but are not limited to:
44
44
  | Commit workspace results | Save selected workspace files in local Git, without pushing or including unrelated changes. |
45
45
  | Restore a historical workspace version | Select a saved commit, restore only the agreed workspace scope and make its sources usable again. |
46
46
 
47
+ ## Preserve existing reading organization
48
+
49
+ For additions as well as navigation edits, first read the workspace AGENTS.md,
50
+ current map and relevant overview/category articles. Reuse their category intent;
51
+ a new source or product does not by itself justify a top-level menu. Follow the
52
+ knowledge-updates guidance returned by `context entry` or the current Route,
53
+ especially "Preserve established navigation intent". Include proposed top-level
54
+ changes in the work-start report or current plan for explicit human review before
55
+ applying them; reuse a concrete structure the user has already approved. Ordinary
56
+ placements within the approved organization do not require another review gate.
57
+
47
58
  ## Read the task before registering sources
48
59
 
49
60
  For a knowledge-map-only request, use the existing workspace directly. Read
@@ -47,6 +47,17 @@ Within an active Context workflow, requests include, but are not limited to:
47
47
  | Commit workspace results | Save selected workspace files in local Git, without pushing or including unrelated changes. |
48
48
  | Restore a historical workspace version | Select a saved commit, restore only the agreed workspace scope and make its sources usable again. |
49
49
 
50
+ ## Preserve existing reading organization
51
+
52
+ For additions as well as navigation edits, first read the workspace AGENTS.md,
53
+ current map and relevant overview/category articles. Reuse their category intent;
54
+ a new source or product does not by itself justify a top-level menu. Follow the
55
+ knowledge-updates guidance returned by `context entry` or the current Route,
56
+ especially "Preserve established navigation intent". Include proposed top-level
57
+ changes in the work-start report or current plan for explicit human review before
58
+ applying them; reuse a concrete structure the user has already approved. Ordinary
59
+ placements within the approved organization do not require another review gate.
60
+
50
61
  ## Read the task before registering sources
51
62
 
52
63
  For a knowledge-map-only request, use the existing workspace directly. Read
@@ -135,6 +135,24 @@ inferences and unavailable evidence. If source versions differ, describe the
135
135
  difference before deciding that a knowledge page is wrong. Do not dump runtime
136
136
  ids, long raw excerpts or a mandatory audit report into every answer.
137
137
 
138
+
139
+ ## Website links in the final summary
140
+
141
+ After answering from the pages actually read, optionally append one or more
142
+ related document links in the final summary. Read `context-site-map.json` from
143
+ the selected package (or its sibling website output in a workspace). Match the
144
+ read page to `pages[].package_path` or `approved_path`; use its `title` and resolve
145
+ `site_path` relative to `site_url`. The URL already includes the deployment base
146
+ path: do not prepend `base` again. Only cite matched articles, deduplicate links,
147
+ and do not invent section anchors.
148
+
149
+ This is a local formatting step, not retrieval or validation. Do not probe URLs,
150
+ make HTTP/HEAD requests, open a browser, inspect a deployment platform, or check
151
+ remote versions to add links. Never build, publish or update metadata for this
152
+ purpose. If the map, URL or matching page is absent or malformed, keep the local
153
+ citation and continue silently. A configured URL does not prove that the site
154
+ contains the current local revision; do not claim online verification.
155
+
138
156
  ## Suggest improvements and hand off
139
157
 
140
158
  When evidence supports a correction or worthwhile addition, briefly describe:
@@ -2,7 +2,7 @@
2
2
  "schema": "agent-graph.bundle.v1",
3
3
  "provider": {
4
4
  "id": "c4a/context",
5
- "version": "0.7.13"
5
+ "version": "0.7.14"
6
6
  },
7
7
  "providerManifest": "provider.yaml",
8
8
  "graphs": [
@@ -188,7 +188,7 @@
188
188
  {
189
189
  "id": "context.sdk.package-outputs",
190
190
  "path": "resources/manuals/guides/package-outputs.md",
191
- "digest": "sha256:31d1159d9c591755c1f7560928c230a86a84a33f0bd86d1866d4eb94078c075f"
191
+ "digest": "sha256:2238be400ef56fba3e894f58f246aa9bf16d287e6522782ad6cdf44ee7004e24"
192
192
  },
193
193
  {
194
194
  "id": "context.sdk.package-templates",
@@ -308,7 +308,7 @@
308
308
  {
309
309
  "id": "procedure.knowledge-updates",
310
310
  "path": "resources/procedures/knowledge-updates.md",
311
- "digest": "sha256:f43943fdf9265e5181c2e8cf3753d981fc9f59a44ee11b5beac404ec481344ea"
311
+ "digest": "sha256:6132bad75635e1ef388c5bf7dd6cd0d3d1fc521a16b44c3bc4d934a7467e516e"
312
312
  },
313
313
  {
314
314
  "id": "procedure.note",
@@ -383,7 +383,7 @@
383
383
  {
384
384
  "id": "procedure.work-start-report",
385
385
  "path": "resources/procedures/work-start-report.md",
386
- "digest": "sha256:d41a91d89eb917bcc15a601ef85d4ac5187bec18365098442e45647eb19b1e90"
386
+ "digest": "sha256:7e27909f3e0209ff88c98a87db8cab3bbf84a915ae2abb5c2453b7525315e45e"
387
387
  },
388
388
  {
389
389
  "id": "procedure.workspace-commit",
@@ -413,7 +413,7 @@
413
413
  {
414
414
  "id": "template.work-start-report",
415
415
  "path": "resources/templates/work-start-report.md",
416
- "digest": "sha256:fb7c5bba6d1c6b9f71e28539c5edda63c162e6a3ccc6623d81e6d649638c8802"
416
+ "digest": "sha256:f9acb9a959dee3d93e1877cd9737dfff7702733ae2121b454a9cc90adbaf89b2"
417
417
  }
418
418
  ],
419
419
  "schemas": [
@@ -570,7 +570,7 @@
570
570
  },
571
571
  {
572
572
  "path": "provider.yaml",
573
- "digest": "sha256:74fa6ece89e6d9f654ea0fa3b988488883f3b55b747e436db0eb31a420e66f78"
573
+ "digest": "sha256:d7932685876d1ce6ae7d06442f8d59249de936893d22cf46fcca25a8949ba18f"
574
574
  },
575
575
  {
576
576
  "path": "resources/contracts/indexer-provider-guide.yaml",
@@ -626,7 +626,7 @@
626
626
  },
627
627
  {
628
628
  "path": "resources/manuals/guides/knowledge-updates.md",
629
- "digest": "sha256:fe8c9e4dbe7413bce3c2007bf230f1312fca31de69d434d0c41171a27e1a68f5"
629
+ "digest": "sha256:263410c1a4c34ae843297552b6575fa23a780c4095c694e03cc64e9cb292325c"
630
630
  },
631
631
  {
632
632
  "path": "resources/manuals/guides/lark-resources.md",
@@ -642,7 +642,7 @@
642
642
  },
643
643
  {
644
644
  "path": "resources/manuals/guides/package-outputs.md",
645
- "digest": "sha256:31d1159d9c591755c1f7560928c230a86a84a33f0bd86d1866d4eb94078c075f"
645
+ "digest": "sha256:2238be400ef56fba3e894f58f246aa9bf16d287e6522782ad6cdf44ee7004e24"
646
646
  },
647
647
  {
648
648
  "path": "resources/manuals/guides/page-customization.md",
@@ -706,7 +706,7 @@
706
706
  },
707
707
  {
708
708
  "path": "resources/procedures/knowledge-updates.md",
709
- "digest": "sha256:f43943fdf9265e5181c2e8cf3753d981fc9f59a44ee11b5beac404ec481344ea"
709
+ "digest": "sha256:6132bad75635e1ef388c5bf7dd6cd0d3d1fc521a16b44c3bc4d934a7467e516e"
710
710
  },
711
711
  {
712
712
  "path": "resources/procedures/note.md",
@@ -766,7 +766,7 @@
766
766
  },
767
767
  {
768
768
  "path": "resources/procedures/work-start-report.md",
769
- "digest": "sha256:d41a91d89eb917bcc15a601ef85d4ac5187bec18365098442e45647eb19b1e90"
769
+ "digest": "sha256:7e27909f3e0209ff88c98a87db8cab3bbf84a915ae2abb5c2453b7525315e45e"
770
770
  },
771
771
  {
772
772
  "path": "resources/procedures/workspace-commit.md",
@@ -790,7 +790,7 @@
790
790
  },
791
791
  {
792
792
  "path": "resources/templates/work-start-report.md",
793
- "digest": "sha256:fb7c5bba6d1c6b9f71e28539c5edda63c162e6a3ccc6623d81e6d649638c8802"
793
+ "digest": "sha256:f9acb9a959dee3d93e1877cd9737dfff7702733ae2121b454a9cc90adbaf89b2"
794
794
  },
795
795
  {
796
796
  "path": "resources/views/package-current.yaml",
@@ -862,12 +862,12 @@
862
862
  },
863
863
  {
864
864
  "path": "skills/work-production-stage/SKILL.md",
865
- "digest": "sha256:5bb250f42d5d28243daca30427b5fd9db52127460862748fc36935f0e0d0f754"
865
+ "digest": "sha256:cacf6ce1b106cfe7af7b07009e6a3658c04007c6eb49127069fa16e3b2892f31"
866
866
  }
867
867
  ],
868
868
  "graphDependencies": {
869
869
  "indexer": [],
870
870
  "workspace": []
871
871
  },
872
- "digest": "sha256:cac0ab245b580f8a5adb9c4d03b55702d36559079adc7442a650087c91b0adca"
872
+ "digest": "sha256:4b30698cc222807e84c58c14e0d5a367786e65d3173aca206ee68ab3b44bd052"
873
873
  }
@@ -1,6 +1,6 @@
1
1
  schema: agent-graph.provider.v1
2
2
  id: c4a/context
3
- version: 0.7.13
3
+ version: 0.7.14
4
4
  name: Context workflow
5
5
  description: Internal work contract for Context knowledge workspaces.
6
6
  graphs:
@@ -200,6 +200,48 @@ coverage by mechanically placing every new page under an unrelated catch-all.
200
200
  Build reports missing bindings for the Agent to resolve; it does not classify
201
201
  content. Moving a menu entry does not change the article URL.
202
202
 
203
+ ### Preserve established navigation intent
204
+
205
+ Before placing new knowledge, read the workspace's AGENTS.md, current
206
+ `src/knowledge-map.yaml`, existing overview pages and relevant category/article
207
+ bodies. Reuse any settled directory intent in the current plan. Establish what
208
+ each affected category helps readers do and why adjacent categories are separate;
209
+ do not infer this from labels alone. Read only affected branches and enough
210
+ neighboring content to distinguish them, not the entire library on every update.
211
+ If intent remains ambiguous, state the proposed interpretation in the plan.
212
+
213
+ Prefer, in order: revise an existing article; add a page to a matching category;
214
+ add a coherent child category; propose a top-level change only when existing
215
+ categories cannot serve a distinct, lasting reader need. Do not create a top-level
216
+ category merely because a source, repository, product, team or batch is new.
217
+ For example, a new assistant's usage guide, frontend integration and runtime
218
+ architecture can belong in existing usage, frontend and backend categories, with
219
+ cross-links for the shared product. Keep them together only when the site's
220
+ established organizing principle supports that choice.
221
+
222
+ In the work-start report or current plan, briefly state the affected articles'
223
+ intended placements and reused category intent. For proposed top-level additions,
224
+ renames, removals or changes of purpose, show the before/after tree, why reuse is
225
+ insufficient, affected existing pages and reading order. Present that change for
226
+ human review before applying it. This uses the existing report feedback where
227
+ available; do not add a new CLI state, schema field or routine per-article gate.
228
+ Explicit user approval of that concrete structure is sufficient; do not ask again.
229
+ General permission to write knowledge or organize batches is not approval to
230
+ change the site's top-level organization. If the need emerges after report
231
+ approval, update the same plan and ask about that structural change only; continue
232
+ independent work within the approved organization.
233
+
234
+ Before delivery, compare the resulting map with the approved plan: article
235
+ placement matches its main reader task, titles match the bodies, sibling ordering
236
+ is deliberate, and directories are neither empty nor accidental duplicates.
237
+ Honor the workspace's chosen directory depth and homogeneous sibling convention;
238
+ where it requires directory-only or article-only siblings, do not mix them.
239
+ Use an "Other" group last only for genuinely useful residual content, not to
240
+ avoid classification. Apply supported map adjustments through the current CLI
241
+ flow, retaining article identities and URLs. Record lasting category intent
242
+ briefly in the workspace AGENTS.md or existing organization guide; do not create
243
+ a separate taxonomy ledger or put planning instructions in reader articles.
244
+
203
245
  ### Reader tasks, names and reading order
204
246
 
205
247
  Read the affected articles' bodies before changing their categories or titles.
@@ -257,8 +299,8 @@ change does not require a prose rewrite or file migration; changing its label do
257
299
  not silently rename the approved article. Needed title or content revisions use
258
300
  the existing revision and Review flow. Splits and merges use ordinary article
259
301
  tasks, link repair and any explicit retirement after replacement content is
260
- delivered. These are Agent editorial decisions, not new CLI checks or approval
261
- gates.
302
+ delivered. These are Agent editorial decisions, not new CLI checks or routine per-article
303
+ approval gates. Top-level changes follow the focused review described above.
262
304
 
263
305
  ## Edit one section or review part of a batch
264
306
 
@@ -486,3 +486,24 @@ Only approved selected content is exported. A map or article change invalidates
486
486
  both website and LLMS outputs; failure preserves the previous staged package.
487
487
  Standalone `llmsPackage()` uses the same map organization and supplies the full
488
488
  text and raw article files alongside its template-rendered `llms.txt` index.
489
+
490
+ ## Links to a deployed website
491
+
492
+ After a website has been built and deployed, record its complete public root:
493
+
494
+ ```bash
495
+ context package site-url <package-name> https://example.com/docs/
496
+ ```
497
+
498
+ This command adds optional `site_url` to the existing `context.site-output/v1`
499
+ map, in both the website and knowledge package. It normalizes a trailing slash,
500
+ rejects credentials/query/fragment, and never contacts the URL. The address
501
+ includes the deployment subpath; resolve `pages[].site_path` against it without
502
+ adding `base` again. Rebuilds preserve the address from the previous website
503
+ map and distribute the refreshed mapping with the package. Deleting dist also
504
+ deletes this optional delivery metadata: record it again from the deployment
505
+ result instead of guessing a hostname. No new workspace configuration is needed.
506
+
507
+ The address is an access hint, not proof of publication or content freshness.
508
+ Query Skills use it only to append related links in the final summary, with no
509
+ network probes or version checks. Packages without the map work as before.
@@ -200,6 +200,48 @@ coverage by mechanically placing every new page under an unrelated catch-all.
200
200
  Build reports missing bindings for the Agent to resolve; it does not classify
201
201
  content. Moving a menu entry does not change the article URL.
202
202
 
203
+ ### Preserve established navigation intent
204
+
205
+ Before placing new knowledge, read the workspace's AGENTS.md, current
206
+ `src/knowledge-map.yaml`, existing overview pages and relevant category/article
207
+ bodies. Reuse any settled directory intent in the current plan. Establish what
208
+ each affected category helps readers do and why adjacent categories are separate;
209
+ do not infer this from labels alone. Read only affected branches and enough
210
+ neighboring content to distinguish them, not the entire library on every update.
211
+ If intent remains ambiguous, state the proposed interpretation in the plan.
212
+
213
+ Prefer, in order: revise an existing article; add a page to a matching category;
214
+ add a coherent child category; propose a top-level change only when existing
215
+ categories cannot serve a distinct, lasting reader need. Do not create a top-level
216
+ category merely because a source, repository, product, team or batch is new.
217
+ For example, a new assistant's usage guide, frontend integration and runtime
218
+ architecture can belong in existing usage, frontend and backend categories, with
219
+ cross-links for the shared product. Keep them together only when the site's
220
+ established organizing principle supports that choice.
221
+
222
+ In the work-start report or current plan, briefly state the affected articles'
223
+ intended placements and reused category intent. For proposed top-level additions,
224
+ renames, removals or changes of purpose, show the before/after tree, why reuse is
225
+ insufficient, affected existing pages and reading order. Present that change for
226
+ human review before applying it. This uses the existing report feedback where
227
+ available; do not add a new CLI state, schema field or routine per-article gate.
228
+ Explicit user approval of that concrete structure is sufficient; do not ask again.
229
+ General permission to write knowledge or organize batches is not approval to
230
+ change the site's top-level organization. If the need emerges after report
231
+ approval, update the same plan and ask about that structural change only; continue
232
+ independent work within the approved organization.
233
+
234
+ Before delivery, compare the resulting map with the approved plan: article
235
+ placement matches its main reader task, titles match the bodies, sibling ordering
236
+ is deliberate, and directories are neither empty nor accidental duplicates.
237
+ Honor the workspace's chosen directory depth and homogeneous sibling convention;
238
+ where it requires directory-only or article-only siblings, do not mix them.
239
+ Use an "Other" group last only for genuinely useful residual content, not to
240
+ avoid classification. Apply supported map adjustments through the current CLI
241
+ flow, retaining article identities and URLs. Record lasting category intent
242
+ briefly in the workspace AGENTS.md or existing organization guide; do not create
243
+ a separate taxonomy ledger or put planning instructions in reader articles.
244
+
203
245
  ### Reader tasks, names and reading order
204
246
 
205
247
  Read the affected articles' bodies before changing their categories or titles.
@@ -257,8 +299,8 @@ change does not require a prose rewrite or file migration; changing its label do
257
299
  not silently rename the approved article. Needed title or content revisions use
258
300
  the existing revision and Review flow. Splits and merges use ordinary article
259
301
  tasks, link repair and any explicit retirement after replacement content is
260
- delivered. These are Agent editorial decisions, not new CLI checks or approval
261
- gates.
302
+ delivered. These are Agent editorial decisions, not new CLI checks or routine per-article
303
+ approval gates. Top-level changes follow the focused review described above.
262
304
 
263
305
  ## Edit one section or review part of a batch
264
306
 
@@ -78,6 +78,17 @@ Estimate timing or savings only when supported by measurements and conditions.
78
78
  For a small addition to an existing site, describe only the affected reading
79
79
  position; reuse its layout and delivery choices instead of proposing them again.
80
80
 
81
+ ## Review navigation changes in context
82
+
83
+ Read the knowledge-updates guidance on preserving established navigation intent.
84
+ For an existing site, explain the category intent being reused and the affected
85
+ article placements. A new source or product is not a reason for a new top-level
86
+ menu. If a top-level addition, rename, removal or purpose change is warranted,
87
+ include its before/after tree, reuse alternatives and impact in this report.
88
+ Obtain explicit feedback before applying that structural change, reusing a
89
+ concrete structure already approved by the user. If it emerges later, update this
90
+ same plan and review only the changed decision; do not restart approved batches.
91
+
81
92
  ## Mandatory feedback
82
93
 
83
94
  Write the scratch report using the host file tool, show its clickable path,
@@ -44,7 +44,13 @@ modules, public capabilities, product operations or another evidenced structure.
44
44
  Distinguish navigation groups from sourced articles; reuse articles rather than
45
45
  duplicating bodies. Retain existing KB, website and LLMS delivery choices.
46
46
 
47
- For website delivery, add a compact sketch showing the site title, top-level
47
+ For an existing site, summarize the existing categories' intent and affected
48
+ article placements. For a proposed top-level change, show the before/after tree,
49
+ why existing categories cannot accommodate it and the affected pages/order.
50
+ Mark it as a decision for review; omit this comparison when top-level structure
51
+ is unchanged. Reuse explicit prior approval of the concrete structure.
52
+
53
+ For a new website or an approved navigation redesign, add a compact sketch showing the site title, top-level
48
54
  groups, a representative left menu, article chapters and on-page outline.
49
55
  For a new homepage or requested redesign, also propose a short title, slogan,
50
56
  description and the verified optional resource cards. Briefly explain mobile
@@ -9,7 +9,9 @@ in the user's conversation language.
9
9
  When planning or revising article placement, titles or reading order, read
10
10
  [reader organization guidance](../../resources/procedures/knowledge-updates.md#reader-tasks-names-and-reading-order).
11
11
  Apply it to the affected topics within the user's scope; it adds no production
12
- stage or permission gate.
12
+ stage. Reuse existing category intent; propose top-level changes in the current
13
+ report/plan for explicit review before applying them, unless the concrete
14
+ structure is already approved. Ordinary placements need no additional gate.
13
15
 
14
16
  For investigation, use the supplied directory and its submission schema. Start
15
17
  with code skeletons and document outlines; selectively read original material