@c4a/context-cli 0.7.11 → 0.7.13

package/indexers/release-manifest.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context-cli",
-  "version": "0.7.11",
+  "version": "0.7.13",
   "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.11",
-    "@c4a/extract": "0.7.11",
-    "@c4a/extract-contract": "0.7.11",
-    "@c4a/extract-go": "0.7.11",
-    "@c4a/extract-mdx": "0.7.11",
-    "@c4a/extract-proto": "0.7.11",
-    "@c4a/extract-rush": "0.7.11",
-    "@c4a/extract-sql": "0.7.11",
-    "@c4a/extract-style": "0.7.11",
-    "@c4a/extract-thrift": "0.7.11",
-    "@c4a/extract-ts": "0.7.11",
+    "@c4a/context": "0.7.13",
+    "@c4a/extract": "0.7.13",
+    "@c4a/extract-contract": "0.7.13",
+    "@c4a/extract-go": "0.7.13",
+    "@c4a/extract-mdx": "0.7.13",
+    "@c4a/extract-proto": "0.7.13",
+    "@c4a/extract-rush": "0.7.13",
+    "@c4a/extract-sql": "0.7.13",
+    "@c4a/extract-style": "0.7.13",
+    "@c4a/extract-thrift": "0.7.13",
+    "@c4a/extract-ts": "0.7.13",
     "commander": "^11.0.0",
     "fast-xml-parser": "^5.10.1",
     "handlebars": "^4.7.8",

package/parserEntryWorker.js

@@ -4545,7 +4545,18 @@ var init_packageSite = __esm(() => {
     description: exports_external.string().optional(),
     lang: exports_external.string().min(1).default("en-US"),
     base: exports_external.string().regex(/^\/(?:[a-zA-Z0-9_-]+\/)*$/, "Use / or a slash-delimited deployment path, such as /docs/").default("/"),
-    home: packageSiteHomeSchema.optional()
+    home: packageSiteHomeSchema.optional(),
+    extensions: exports_external.object({
+      root: exports_external.string().regex(/^src\/(?:[a-zA-Z0-9_-]+\/)*[a-zA-Z0-9_-]+$/).default("src/site"),
+      slots: exports_external.object({
+        banner: exports_external.union([exports_external.string().min(1), exports_external.literal(false)]).optional(),
+        knowledge: exports_external.union([exports_external.string().min(1), exports_external.literal(false)]).optional(),
+        resources: exports_external.union([exports_external.string().min(1), exports_external.literal(false)]).optional(),
+        footer: exports_external.union([exports_external.string().min(1), exports_external.literal(false)]).optional(),
+        floating: exports_external.union([exports_external.string().min(1), exports_external.literal(false)]).optional()
+      }).strict().optional(),
+      pages: exports_external.record(exports_external.string().regex(/^[a-zA-Z0-9_-]+$/), exports_external.string().min(1)).optional()
+    }).strict().optional()
   }).strict();
 });
 

package/plugins/VERSION

@@ -1 +1 @@
-0.7.11
+0.7.13

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

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

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

package/providers/context/graphs/workspace.yaml

@@ -135,7 +135,7 @@ nodes:
     reasonCode: route.capture.pending-target
     action: actions/capture-next.yaml
     satisfiedBy:
-      - path: capture.complete
+      - path: capture.route_satisfied
         equals: true
     resources:
       required:
@@ -224,6 +224,7 @@ nodes:
         - resources/views/package-current.yaml
       recommended:
         - resources/manuals/guides/package-outputs.md
+        - resources/manuals/guides/page-customization.md
         - resources/manuals/reference/package-templates.md
         - resources/manuals/reference/template-variables.md
 
@@ -241,6 +242,7 @@ nodes:
         - resources/views/package-current.yaml
       recommended:
         - resources/manuals/guides/package-outputs.md
+        - resources/manuals/guides/page-customization.md
         - resources/manuals/reference/project-api.md
         - resources/manuals/reference/package-templates.md
         - resources/manuals/reference/template-variables.md

package/providers/context/manifest.json

@@ -2,7 +2,7 @@
   "schema": "agent-graph.bundle.v1",
   "provider": {
     "id": "c4a/context",
-    "version": "0.7.11"
+    "version": "0.7.13"
   },
   "providerManifest": "provider.yaml",
   "graphs": [
@@ -14,7 +14,7 @@
     {
       "id": "workspace",
       "path": "graphs/workspace.yaml",
-      "digest": "sha256:43eba7c45070fc2fec9c1f86af8e6190c49ebef8b729cb444701011dca8780be"
+      "digest": "sha256:2904eb61889037ffdcdf878c807187f9acf807a9409111ee4de4c5b703b15d5d"
     }
   ],
   "actions": [
@@ -188,17 +188,22 @@
     {
       "id": "context.sdk.package-outputs",
       "path": "resources/manuals/guides/package-outputs.md",
-      "digest": "sha256:a8c66facc2ad175324796e2478d6ca50e0c83b5d49eec0251d8548c3717a062b"
+      "digest": "sha256:31d1159d9c591755c1f7560928c230a86a84a33f0bd86d1866d4eb94078c075f"
     },
     {
       "id": "context.sdk.package-templates",
       "path": "resources/manuals/reference/package-templates.md",
       "digest": "sha256:8d512d232ea5157717eca73357a213ab2449d83cf98bec217621aff79eda0216"
     },
+    {
+      "id": "context.sdk.page-customization",
+      "path": "resources/manuals/guides/page-customization.md",
+      "digest": "sha256:57695bbbe3223c3c695029747856baae9e230059848e8f37506f908e843f9b0e"
+    },
     {
       "id": "context.sdk.project-api",
       "path": "resources/manuals/reference/project-api.md",
-      "digest": "sha256:6225dc08f1a4362eee72e0fba4d8639d20d535818766d8a6b181396ebbb94f3f"
+      "digest": "sha256:a65131d5cd351d8353f5028303ab1d75447f5d0c09496fd8ec83bb5d76adfd78"
     },
     {
       "id": "context.sdk.template-variables",
@@ -278,12 +283,12 @@
     {
       "id": "procedure.close-and-build",
       "path": "resources/procedures/close-and-build.md",
-      "digest": "sha256:c2f39abc2867e73a529ded2e475276738f62a4b61811b7792a49d6e358865a74"
+      "digest": "sha256:4025f98f95ac0c1818d2be3d6c33e556bd462b0510fd88227587d490ae01aa4c"
     },
     {
       "id": "procedure.document-capture",
       "path": "resources/procedures/document-capture.md",
-      "digest": "sha256:46a8231e92fcb19db7918938970ace8b4e4c22153fa8cbf0bb8100275bfbbfcf"
+      "digest": "sha256:f09100425c2b89a126c35c4490b0644519a4eee214114f2f0f52b6ea20467a04"
     },
     {
       "id": "procedure.homogeneous-source-review",
@@ -293,7 +298,7 @@
     {
       "id": "procedure.knowledge-maintenance",
       "path": "resources/procedures/knowledge-maintenance.md",
-      "digest": "sha256:42fc008c8b25df86b7a1e26d521003bc8e3a69cf16948365e93c41f896c0c315"
+      "digest": "sha256:f2cc36cb2425cf0ac96a2ea4f114ed5ce872c3711b82bdc25fdc71e42a2849b7"
     },
     {
       "id": "procedure.knowledge-review",
@@ -303,7 +308,7 @@
     {
       "id": "procedure.knowledge-updates",
       "path": "resources/procedures/knowledge-updates.md",
-      "digest": "sha256:55deff10c4ad8b2c66d5fcf8c2b7592c1533cdba22cdb1cb6a63bbf9bc42809c"
+      "digest": "sha256:f43943fdf9265e5181c2e8cf3753d981fc9f59a44ee11b5beac404ec481344ea"
     },
     {
       "id": "procedure.note",
@@ -328,7 +333,7 @@
     {
       "id": "procedure.production-stage-files",
       "path": "resources/procedures/production-stage-files.md",
-      "digest": "sha256:c5ff9e138ecd3f90d04ac834a82b2764f583da105ca23e3e07dfb816349d6c32"
+      "digest": "sha256:d093acf81a07b85cfe2a78e71f7ab301fa8c72e3edac3f5de990b1ff7eaf12f0"
     },
     {
       "id": "procedure.project-configuration",
@@ -388,7 +393,7 @@
     {
       "id": "procedure.workspace-prepare",
       "path": "resources/procedures/workspace-prepare.md",
-      "digest": "sha256:fdbfdeb1486c998785b41569cf6ed57c744e6265d11610d320a60ede0ebbc2c8"
+      "digest": "sha256:9bffefd9d4ac0ab46b9274a07c1a0a0b809659fe22a0bb28e2c78a6dc403a999"
     },
     {
       "id": "procedure.workspace-restore",
@@ -561,11 +566,11 @@
     },
     {
       "path": "graphs/workspace.yaml",
-      "digest": "sha256:43eba7c45070fc2fec9c1f86af8e6190c49ebef8b729cb444701011dca8780be"
+      "digest": "sha256:2904eb61889037ffdcdf878c807187f9acf807a9409111ee4de4c5b703b15d5d"
     },
     {
       "path": "provider.yaml",
-      "digest": "sha256:64a5026a5b0e19e64ab902d11d9f648640596c3d56367d13e4e3ae9550388aea"
+      "digest": "sha256:74fa6ece89e6d9f654ea0fa3b988488883f3b55b747e436db0eb31a420e66f78"
     },
     {
       "path": "resources/contracts/indexer-provider-guide.yaml",
@@ -621,7 +626,7 @@
     },
     {
       "path": "resources/manuals/guides/knowledge-updates.md",
-      "digest": "sha256:9c26775c38090705524e24ef1b5a78554636f1732c8833e8e69e9f6993c6b206"
+      "digest": "sha256:fe8c9e4dbe7413bce3c2007bf230f1312fca31de69d434d0c41171a27e1a68f5"
     },
     {
       "path": "resources/manuals/guides/lark-resources.md",
@@ -637,7 +642,11 @@
     },
     {
       "path": "resources/manuals/guides/package-outputs.md",
-      "digest": "sha256:a8c66facc2ad175324796e2478d6ca50e0c83b5d49eec0251d8548c3717a062b"
+      "digest": "sha256:31d1159d9c591755c1f7560928c230a86a84a33f0bd86d1866d4eb94078c075f"
+    },
+    {
+      "path": "resources/manuals/guides/page-customization.md",
+      "digest": "sha256:57695bbbe3223c3c695029747856baae9e230059848e8f37506f908e843f9b0e"
     },
     {
       "path": "resources/manuals/guides/sessions.md",
@@ -649,7 +658,7 @@
     },
     {
       "path": "resources/manuals/guides/workspace-prepare.md",
-      "digest": "sha256:0ee9b75fc2fa3237eef2119a90f217e913297cb036a4653a12369f2b00147ad9"
+      "digest": "sha256:a0f801e442331135274de04cfc4006c4641da50421d5e80a47f23b329dd13766"
     },
     {
       "path": "resources/manuals/guides/workspace-restore.md",
@@ -665,7 +674,7 @@
     },
     {
       "path": "resources/manuals/reference/project-api.md",
-      "digest": "sha256:6225dc08f1a4362eee72e0fba4d8639d20d535818766d8a6b181396ebbb94f3f"
+      "digest": "sha256:a65131d5cd351d8353f5028303ab1d75447f5d0c09496fd8ec83bb5d76adfd78"
     },
     {
       "path": "resources/manuals/reference/template-variables.md",
@@ -677,11 +686,11 @@
     },
     {
       "path": "resources/procedures/close-and-build.md",
-      "digest": "sha256:c2f39abc2867e73a529ded2e475276738f62a4b61811b7792a49d6e358865a74"
+      "digest": "sha256:4025f98f95ac0c1818d2be3d6c33e556bd462b0510fd88227587d490ae01aa4c"
     },
     {
       "path": "resources/procedures/document-capture.md",
-      "digest": "sha256:46a8231e92fcb19db7918938970ace8b4e4c22153fa8cbf0bb8100275bfbbfcf"
+      "digest": "sha256:f09100425c2b89a126c35c4490b0644519a4eee214114f2f0f52b6ea20467a04"
     },
     {
       "path": "resources/procedures/homogeneous-source-review.md",
@@ -689,7 +698,7 @@
     },
     {
       "path": "resources/procedures/knowledge-maintenance.md",
-      "digest": "sha256:42fc008c8b25df86b7a1e26d521003bc8e3a69cf16948365e93c41f896c0c315"
+      "digest": "sha256:f2cc36cb2425cf0ac96a2ea4f114ed5ce872c3711b82bdc25fdc71e42a2849b7"
     },
     {
       "path": "resources/procedures/knowledge-review.md",
@@ -697,7 +706,7 @@
     },
     {
       "path": "resources/procedures/knowledge-updates.md",
-      "digest": "sha256:55deff10c4ad8b2c66d5fcf8c2b7592c1533cdba22cdb1cb6a63bbf9bc42809c"
+      "digest": "sha256:f43943fdf9265e5181c2e8cf3753d981fc9f59a44ee11b5beac404ec481344ea"
     },
     {
       "path": "resources/procedures/note.md",
@@ -717,7 +726,7 @@
     },
     {
       "path": "resources/procedures/production-stage-files.md",
-      "digest": "sha256:c5ff9e138ecd3f90d04ac834a82b2764f583da105ca23e3e07dfb816349d6c32"
+      "digest": "sha256:d093acf81a07b85cfe2a78e71f7ab301fa8c72e3edac3f5de990b1ff7eaf12f0"
     },
     {
       "path": "resources/procedures/project-configuration.md",
@@ -765,7 +774,7 @@
     },
     {
       "path": "resources/procedures/workspace-prepare.md",
-      "digest": "sha256:fdbfdeb1486c998785b41569cf6ed57c744e6265d11610d320a60ede0ebbc2c8"
+      "digest": "sha256:9bffefd9d4ac0ab46b9274a07c1a0a0b809659fe22a0bb28e2c78a6dc403a999"
     },
     {
       "path": "resources/procedures/workspace-restore.md",
@@ -833,7 +842,7 @@
     },
     {
       "path": "skills/record-workspace-version/SKILL.md",
-      "digest": "sha256:c0e7415b362123deddcc1af61374cd50e5069e3b6db1dda516a21671734a1b1f"
+      "digest": "sha256:695b6b384a94743de08451f447bc8a135b6a7446dfab8e9b52ae16de54fd2903"
     },
     {
       "path": "skills/recover-workspace/SKILL.md",
@@ -853,12 +862,12 @@
     },
     {
       "path": "skills/work-production-stage/SKILL.md",
-      "digest": "sha256:d2ba49a86ba49f312a0e7b817164a8d41596aa18f7e20b41036d90946760a5ce"
+      "digest": "sha256:5bb250f42d5d28243daca30427b5fd9db52127460862748fc36935f0e0d0f754"
     }
   ],
   "graphDependencies": {
     "indexer": [],
     "workspace": []
   },
-  "digest": "sha256:b5152e39b14bbdc8eab34d0053a011d97d108a7b816cdbce59995e8364563783"
+  "digest": "sha256:cac0ab245b580f8a5adb9c4d03b55702d36559079adc7442a650087c91b0adca"
 }

package/providers/context/provider.yaml

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

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

@@ -107,12 +107,11 @@ configuration/template approval, before the final build. The record response
 returns the next workspace Route, so no extra status call is needed. Build retries
 reuse the recorded version when formal content is unchanged. If build preparation
 or rendering fails and formal corrections are needed, `version inspect` returns
-`reusable_version` for the current entry only while it has no successful build or
-publication receipt. Submit that same version with the complete iteration's title,
-changes and triggers, including the repair; this replaces the pending changelog
-entry rather than appending another version. Do not submit only the repair and
-lose the original delivery description. Once built or published, the version is
-sealed and further formal changes require an increase. Intermediate batches
+`reusable_version` for an untagged current entry. Before amending, read the
+publication target's remote version using the distribution skill. An unpublished
+preview may reuse its version with the complete iteration's title, changes and
+triggers; preserve the original delivery description. Published content requires
+an increasing version. A local build alone does not seal a version. Intermediate batches
 do not each receive a version.
 
 The workspace AGENTS.md and version-writing instructions require each entry's
@@ -149,19 +148,23 @@ are `initial`, `note`, `sessions`, `mr`, `module`, `document`, `navigation`,
 `repair`, `dist`, and `other`. Agent-written fields describe the actual diff and
 conversation; they must not expose credentials, raw transcripts or private IDs.
 
-The CLI writes `changelog.yaml`, generated `CHANGELOG.md`, `package.json` and the
-`.context-version.json` content baseline together. Keep these formal files with
-the workspace; do not hand-edit generated baselines. Git-managed and unignored
-new files are compared (without Git, non-runtime workspace files are compared).
-Version metadata itself, `dist`, `.tmp` and dependencies do not cause changes.
-
-Successful builds record version and per-package hashes in `.context-builds.json`.
-They do not increase versions. Before publishing, `context version publish-check
---format json` compares against `.context-published.json`. A same-version changed
-output requires a patch using `version inspect --publish` and a `dist` trigger,
-then a rebuild. Record `version published --hash <checked-hash> --receipt
-<successful-publication-reference> --format json` only after external success.
-No command commits, tags or uploads automatically.
+The CLI updates `package.json`, `changelog.yaml` and generated `CHANGELOG.md` together.
+`context version inspect --base <commit-or-tag> --format json` compares the actual
+workspace files with Git, including untracked files. Without an explicit base it
+uses the current version's `v<version>` tag when available, otherwise HEAD; HEAD
+is not proof of publication. Review article bodies, assets, structure, navigation
+and templates, not structure alone. Without Git, inspection reports local files.
+A disposable `.tmp` checkpoint suppresses repeated recording in an uncommitted
+iteration. Losing it does not lose knowledge or prove a new publication.
+
+There are no root-level Context version/build/publication receipts to maintain.
+Build freshness uses the existing local package cache. The CLI does not seal a
+version merely because a preview was built. Before reusing a version, check the
+actual publication target and Git tags; a published version requires an increase.
+Publication belongs to the installed distribution tool. Record remote receipts
+in its configuration or the existing work summary, separately for each target.
+A successful authorized commit/tag identifies the delivered source; never create
+one automatically, and never treat Git success as platform publication success.
 
 Website history is available at `changelog.html`: cards are newest first, the
 latest three expanded and older cards collapsed. The History button beside the
@@ -197,6 +200,66 @@ coverage by mechanically placing every new page under an unrelated catch-all.
 Build reports missing bindings for the Agent to resolve; it does not classify
 content. Moving a menu entry does not change the article URL.
 
+### Reader tasks, names and reading order
+
+Read the affected articles' bodies before changing their categories or titles.
+Titles and outlines help locate material; they do not settle its main reader task.
+During initial planning, keep names and placement provisional until the relevant
+material supports them. Classify by the question the page primarily answers and
+its intended reader, rather than its collection, source path or isolated words:
+
+| Main reader task | Organizing emphasis |
+| --- | --- |
+| Understand a business process | Participants, rules, decisions and lifecycle |
+| Understand an implementation | Components, data changes, calls and failure handling |
+| Integrate or use a capability | Prerequisites, setup, contracts and usage |
+| Diagnose or recover from a problem | Symptoms, checks, causes, actions and verification |
+
+These distinctions guide placement, not a required set of top-level directories.
+A page explaining retry scheduling and persistence belongs with its implementation;
+a page explaining how to recover a stalled worker serves troubleshooting. The word
+"retry" alone decides neither. Choose a primary home for a mixed page and link
+related tasks without duplicating the same overview across categories.
+
+Give each directory a concrete shared subject or reader task. At every parent,
+keep its children either all directories or all articles. Place an overview in
+the appropriate article group when the parent contains directories. Avoid empty
+category scaffolding and chains of single-article directories that add no useful
+choice. A residual "Other" group, when warranted, comes last; it must not absorb
+articles whose purpose fits an existing group. Do not invent a fixed depth,
+number of categories or page quota to make the tree look uniform.
+
+Keep directory and article titles concise and specific to their actual subject.
+Name the object and useful task, rather than enumerating every section heading.
+For example, prefer "Client authentication" to "Client tokens, configuration,
+requests, refresh and errors" when those sections all explain authentication.
+Retain a platform or product name only when it distinguishes otherwise ambiguous
+topics. Keep an existing accurate title when it already works; a necessary
+technical name need not be shortened just to meet a word count.
+
+The Agent manually arranges siblings for reading: a useful overview, prerequisites,
+the main tasks or process sequence, then later maintenance and reference material
+where applicable. Use a numbered list or ordered outline to review that proposal,
+then assign explicit, distinct `order` values among siblings in the knowledge-map
+adjustment, for example 10, 20 and 30. The list is an editing plan; persisted
+`order` values determine navigation. Reordering YAML/JSON entries or changing the
+plan's list order alone does not change the site. Paths, internal keys, alphabetical
+order and source-file order are not substitutes for a reader sequence. Keep order
+numbers out of titles. This navigation order is separate from the order in which
+workers write their drafts.
+
+For a long or compound page, inspect its content before suggesting a split or
+merge. Keep one coherent task together, and separate independently useful tasks
+only when their supported content warrants it. A long title or many headings
+alone is insufficient. Preserve useful detail and links, and retain article IDs,
+paths and unaffected sections when the reader task is unchanged. A navigation-only
+change does not require a prose rewrite or file migration; changing its label does
+not silently rename the approved article. Needed title or content revisions use
+the existing revision and Review flow. Splits and merges use ordinary article
+tasks, link repair and any explicit retirement after replacement content is
+delivered. These are Agent editorial decisions, not new CLI checks or approval
+gates.
+
 ## Edit one section or review part of a batch
 
 The current approved-revision Route accepts either full `markdown` or explicit
@@ -412,6 +475,13 @@ and the same Review/build route.
 
 ## Adjust or roll back current work
 
+Read `context task adjust --schema --format yaml` for the source-adjustment
+and knowledge-map input variants; no workspace or input file is required.
+After restoring an unavailable source, follow the recovery result's
+`next_action` to refresh the captured planning materials. Preparation can return
+a new stage: use its paths and identity when resubmitting your plan. Restoring
+the checkout alone does not replace an existing stage's captured material.
+
 For an explicit same-task change to native Indexer source inputs, use
 `context task adjust --input <file|-> --format json` with `scopes` containing the
 selected `source_ref` and optional `module_refs`, plus an `instruction` explaining

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

@@ -31,6 +31,10 @@ change that silently enables websites for existing packages.
 
 ### Static documentation website
 
+For business pages, homepage slots and a bottom-right chat/bot widget, read
+[Page Content Customization](./page-customization.md). Presentation sources live
+under `src/site/`; keep generated knowledge separate.
+
 To include the default browser-readable site, enable `site` on the same
 package. The normal `context build` produces both the Agent KB and a standalone
 `dist/<base>-site/` directory containing `index.html`, article HTML,

package/providers/context/resources/manuals/guides/page-customization.md

@@ -0,0 +1,93 @@
+---
+id: context.sdk.page-customization
+kind: procedure
+mediaType: text/markdown
+---
+
+# Page content customization
+
+Keep trusted website code in `src/site/`. It is presentation code, not captured
+material or approved knowledge. Configure it in the existing `kbPackage.site`:
+
+```ts
+site: {
+  title: "Engineering handbook",
+  extensions: {
+    root: "src/site",
+    slots: {
+      banner: "components/Banner.vue",
+      floating: "components/Chat.vue",
+    },
+    pages: { support: "pages/support.md" },
+  },
+}
+```
+
+Paths are relative to `root`. The directory can contain Vue components, CSS,
+Markdown and imported assets. Use relative imports within this directory;
+declare external dependencies in the workspace package manifest. Do not put
+credentials or private configuration in frontend files. Hidden files,
+`node_modules` and `dist` are not copied; symlinks are rejected.
+
+## Homepage and floating slots
+
+| Slot | Default | Customization |
+| --- | --- | --- |
+| `banner` | Existing homepage hero and actions | Replace with a component |
+| `knowledge` | Knowledge-map card group | Replace with a component |
+| `resources` | Resource card group | Replace with a component |
+| `footer` | Existing homepage footer | Replace with a component |
+| `floating` | Empty | Client-only component fixed at the bottom right on all pages |
+
+Omit a slot to retain its default; set it to `false` to hide it. A component
+replaces only its slot, not the global navigation, language switch or article
+provenance. Components can use VitePress `useData()` and `useRoute()` for theme,
+page and route information. Import scoped CSS from components for local styling.
+
+The floating component owns its button, chat/bot panel and open/close behavior.
+Keep its panel within the viewport and preserve keyboard focus and close controls.
+Load expensive chat SDKs when opened. Its component import is client-only, but
+other components must support static rendering: use `onMounted` for browser APIs.
+The static website supplies no chat backend or secret storage; use an authorized
+business service for authentication and requests. A service failure must not
+prevent reading the handbook.
+
+## Custom pages and navigation
+
+Each `pages` key becomes `/custom/<key>.html` under the configured site base.
+A page is trusted Markdown and may import Vue components, for example:
+
+```md
+# Support
+
+<script setup>
+import SupportPanel from '../components/SupportPanel.vue'
+</script>
+
+<SupportPanel />
+```
+
+Place it using the existing knowledge-map entry structure, with
+`target: { artifact_ref: "site:support" }`. Set `parent`, `title` and `order`
+as for other directory entries; do not create a second menu configuration.
+The `site:` namespace is reserved for website pages; do not use `section_key`
+on these targets. Undeclared targets fail website building with a diagnostic.
+Pages without directory entries remain directly accessible. Multiple entries
+can reference one page without duplicating content.
+
+These pages are website-only: they are not approved articles and do not enter
+the knowledge package or LLM Docs. Update formal articles through the existing
+knowledge revision workflow, not through a custom page that shadows their URLs.
+
+## Build and delivery
+
+Use the existing package build after editing configuration or presentation files;
+site customization does not require capture, Indexer planning or a new review
+gate. Existing authorization for building and deployment still applies.
+Extension files and workspace dependency manifests participate in build
+fingerprints. Build errors preserve previous outputs. Never edit the generated
+`.tmp` website or `dist` as the source of customization.
+
+Preview the homepage, custom pages and floating panel on desktop and mobile,
+including a non-root `site.base`, dark mode and keyboard navigation. Publish only
+the resulting website directory, not the source tree or workspace credentials.

package/providers/context/resources/manuals/guides/workspace-prepare.md

@@ -67,6 +67,9 @@ workflow bundle: `repository-source-recovery.md` beside this guide and
 `../../schemas/repository-source-recovery.schema.json`. Reuse a matching local
 checkout or, when authorized, clone into a bounded location using
 `context source restore --input <workspace-input-file> --format json`.
+Follow its `next_action` before resuming a plan: an active production stage may
+need preparation to refresh previously unavailable material. Use the stage and
+paths returned by preparation, not a payload's previous stage identity.
 Group modules sharing a remote and fixed commit; do not clone per module.
 Check registered commit and module paths. Never reset a supplied dirty checkout.
 Authentication or checkout problems can be diagnosed with Host Git tools;

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

@@ -193,6 +193,12 @@ or repository links. Knowledge map is projected from
 `src/knowledge-map.yaml` independently of KB directories; see
 [Package Outputs](../guides/package-outputs.md#optional-static-documentation-website).
 
+`site.extensions` optionally names a trusted `src/site` root, homepage and floating
+`slots`, and custom Markdown `pages`. Place custom pages in the same knowledge map
+with `target.artifact_ref: "site:<page-key>"`. See
+[Page content customization](../guides/page-customization.md) for the configuration
+and the boundary between presentation code and approved knowledge.
+
 ## Knowledge requirements and Indexer Skills
 
 When `src/indexers.yaml` is absent, the configuration Route supplies its schema.