@c4a/context-cli 0.6.16 → 0.6.17

package/README.md

@@ -169,7 +169,8 @@ for maintainers, automation, and diagnostics:
 - `context plugin status` checks installed Agent projections;
 - `context debug enable` records optional traces below
   `.tmp/context-runtime/debug/`;
-- `context optimize-docs enable` enables incremental document revisions
+- new workspaces enable conservative document revisions by default;
+  `context optimize-docs enable|disable` changes that workspace preference
   without modifying approved `knowledge/`;
 - `context revise "<title or approved path>"` starts one conversational
   correction and routes its validation before the next package build;

package/README.zh-CN.md

@@ -143,8 +143,8 @@ context/
 - `context <command> --help` 是当前参数的权威来源；
 - `context plugin status` 检查已安装的 Agent 投影；
 - `context debug enable` 在 `.tmp/context-runtime/debug/` 记录可选轨迹；
-- `context optimize-docs enable` 开启增量排版优化，并保持 `knowledge/`
-  中的正式知识不变；
+- 新工作区默认开启保守的文档修订；`context optimize-docs enable|disable`
+  可调整工作区偏好，同时保持 `knowledge/` 中的正式知识不变；
 - `context revise "<标题或正式知识路径>"` 从对话启动一次单页修正，校验后再由
   Route 提示重新构建；
 - `context clean-cache --dry-run` 预览 Context-owned 过期插件缓存清理。

package/cli.js

@@ -18626,6 +18626,8 @@ async function initContextProject(input) {
     await enableContextDebug(projectRoot, "init");
   if (input.optimizeDocs === true)
     await enableDocumentOptimization(projectRoot);
+  if (input.optimizeDocs === false)
+    await disableDocumentOptimization(projectRoot);
   return result;
 }
 async function loadContextProjectModule(root) {
@@ -109075,7 +109077,9 @@ function initCommand2(input, projectDir) {
     args.push("--dev");
   if (input.debug === true)
     args.push("--debug");
-  if (input.optimizeDocs === true)
+  if (input.optimizeDocs === false)
+    args.push("--no-optimize-docs");
+  else
     args.push("--optimize-docs");
   return args.map(shellQuote9).join(" ");
 }
@@ -109171,7 +109175,7 @@ function formatContextEntry(result) {
 
 // src/registerProjectLifecycleCommands.ts
 function registerProjectEntryCommand(program2) {
-  program2.command("entry [project-dir]").description("Resolve the single Context agent entry for initialization or workflow evaluation").option("--name <name>", "display/package name override when initialization is required").option("--language <language>", "workspace and starter-template language: en | zh-CN", "en").option("--dev", "plan initialization with the locally linked @c4a/context SDK").option("--debug", "plan initialization with workspace-local tracing enabled").option("--optimize-docs", "plan initialization with document optimization enabled").option("--managed", "use explicit current-conversation managed approval for workflow evaluation").addOption(new Option("--authority <authority>", "current-conversation scoped authority granted by the user; repeatable").argParser(collectWorkflowAuthorityOption).default([])).option("--format <format>", "output format: json", "json").action((projectDir, options) => {
+  program2.command("entry [project-dir]").description("Resolve the single Context agent entry for initialization or workflow evaluation").option("--name <name>", "display/package name override when initialization is required").option("--language <language>", "workspace and starter-template language: en | zh-CN", "en").option("--dev", "plan initialization with the locally linked @c4a/context SDK").option("--debug", "plan initialization with workspace-local tracing enabled").option("--optimize-docs", "plan initialization with document optimization enabled").option("--no-optimize-docs", "plan initialization with document optimization disabled").option("--managed", "use explicit current-conversation managed approval for workflow evaluation").addOption(new Option("--authority <authority>", "current-conversation scoped authority granted by the user; repeatable").argParser(collectWorkflowAuthorityOption).default([])).option("--format <format>", "output format: json", "json").action((projectDir, options) => {
     if (options.format !== "json") {
       throw new ContextError(ExitCode.UserError, "--format must be json", {
         category: ErrorCategory.UserInputInvalid
@@ -109184,16 +109188,17 @@ function registerProjectEntryCommand(program2) {
       language: projectLanguage(options.language),
       ...options.dev === true ? { dev: true } : {},
       ...options.debug === true ? { debug: true } : {},
-      ...options.optimizeDocs === true ? { optimizeDocs: true } : {},
+      ...typeof options.optimizeDocs === "boolean" ? { optimizeDocs: options.optimizeDocs } : {},
       ...options.managed === true ? { managed: true } : {},
       authorities: workflowAuthorities(options.authority)
     })));
   });
 }
 function registerProjectInitCommand(program2) {
-  program2.command("init [project-dir]").description("Initialize a project-local context workspace").option("--name <name>", "display/package name override").option("--language <language>", "workspace and starter-template language: en | zh-CN").option("--dev", "initialize with the locally linked @c4a/context SDK").option("--debug", "enable workspace-local command and Agent Graph tracing").option("--optimize-docs", "enable conservative document revisions").option("--allow-nonempty", "after explicit confirmation, preserve existing files and initialize inside a non-empty non-Context directory").action(async (projectDir, options) => {
+  program2.command("init [project-dir]").description("Initialize a project-local context workspace").option("--name <name>", "display/package name override").option("--language <language>", "workspace and starter-template language: en | zh-CN").option("--dev", "initialize with the locally linked @c4a/context SDK").option("--debug", "enable workspace-local command and Agent Graph tracing").option("--optimize-docs", "enable conservative document revisions (default for new workspaces)").option("--no-optimize-docs", "disable document revisions for the initialized workspace").option("--allow-nonempty", "after explicit confirmation, preserve existing files and initialize inside a non-empty non-Context directory").action(async (projectDir, options) => {
     const targetRoot = resolveContextProjectInitTarget(process.cwd(), projectDir);
     const wasContextWorkspace = isContextProjectRoot(targetRoot);
+    const optimizeDocs = typeof options.optimizeDocs === "boolean" ? options.optimizeDocs : wasContextWorkspace ? undefined : true;
     const result = await initContextProject({
       cwd: process.cwd(),
       ...projectDir !== undefined ? { projectDir } : {},
@@ -109201,7 +109206,7 @@ function registerProjectInitCommand(program2) {
       ...typeof options.language === "string" ? { language: projectLanguage(options.language) } : {},
       ...options.dev === true ? { dev: true } : {},
       ...options.debug === true ? { debug: true } : {},
-      ...options.optimizeDocs === true ? { optimizeDocs: true } : {},
+      ...optimizeDocs === undefined ? {} : { optimizeDocs },
       ...options.allowNonempty === true ? { allowNonempty: true } : {}
     });
     process.stdout.write(formatProjectInitResult(result));

package/docs/document-optimization.md

@@ -1,19 +1,21 @@
 # Document revisions
 
-Document optimization is an optional build phase for source-backed prose. It
-repairs presentation-level Markdown without changing the approved knowledge
-page.
+New workspaces enable conservative document optimization by default. It is a
+build phase for source-backed prose that repairs presentation-level Markdown,
+links, and obvious local errors without changing the approved knowledge page or
+broadly rewriting its meaning.
 
-Enable it during initialization:
+To opt out during initialization:
 
 ```bash
-context init context --optimize-docs
+context init context --no-optimize-docs
 ```
 
-Or enable it in an existing workspace:
+Existing workspaces retain their current setting. Change it explicitly with:
 
 ```bash
 context optimize-docs enable
+context optimize-docs disable
 context status --format json
 ```
 
@@ -52,11 +54,5 @@ broad document optimization was disabled, this entry activates only the target
 page and keeps every other eligible page out of the pending batch. If upstream
 content changes, the revision becomes a conflict and must be reviewed again.
 
-Disable and restore baseline output with:
-
-```bash
-context optimize-docs disable
-```
-
-Revision pages move to Context runtime recovery storage, and the next build
-uses approved knowledge directly.
+Disabling moves active revision pages to Context runtime recovery storage. The
+next build uses approved knowledge directly.

package/docs/document-optimization.zh-CN.md

@@ -1,18 +1,19 @@
 # 文档修订页
 
-文档编译优化是面向来源可追溯正文的可选构建阶段。它只修复 Markdown
-排版和明显的局部问题，不修改正式知识页。
+新工作区默认开启保守的文档编译优化。它是面向来源可追溯正文的构建阶段，只修复
+Markdown 排版、链接和明显的局部错误，不修改正式知识页，也不大段改写原意。
 
-初始化时开启：
+初始化时如需关闭：
 
 ```bash
-context init context --optimize-docs
+context init context --no-optimize-docs
 ```
 
-已有工作区可以运行：
+已有工作区保持当前设置，可显式调整：
 
 ```bash
 context optimize-docs enable
+context optimize-docs disable
 context status --format json
 ```
 
@@ -42,13 +43,8 @@ CLI 只在目标唯一时创建或复用该页修订，并由 Agent Graph 返回
 否则询问用户。Agent 只编辑面向读者的正文，不修改来源信息和
 `context:section` 边界，随后运行 `context optimize-docs validate`。校验成功后，
 请求自动结束；若产物因此过期，下一条 Route 会直接提示重新构建。即使工作区
-此前没有开启整库文档编译优化，这个入口也只激活目标页面，不会让其他页面进入
+此前关闭了整库文档编译优化，这个入口也只激活目标页面，不会让其他页面进入
 待优化队列。上游内容变化后，旧修订页会成为冲突，不会被静默应用。
 
-关闭并恢复基础构建结果：
-
-```bash
-context optimize-docs disable
-```
-
-修订页会被移动到 Context 的运行时恢复目录，下一次构建直接使用正式知识。
+关闭后，修订页会被移动到 Context 的运行时恢复目录，下一次构建直接使用正式
+知识。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context-cli",
-  "version": "0.6.16",
+  "version": "0.6.17",
   "type": "module",
   "description": "Local runtime and Agent integration for traceable knowledge production",
   "license": "MIT",
@@ -24,7 +24,7 @@
   },
   "dependencies": {
     "@c4a/agent-graph": "0.2.6",
-    "@c4a/context": "0.6.16",
+    "@c4a/context": "0.6.17",
     "commander": "^11.0.0",
     "fast-xml-parser": "^5.10.1",
     "handlebars": "^4.7.8",

package/plugins/VERSION

@@ -1 +1 @@
-0.6.16
+0.6.17

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

package/plugins/claude/commands/context.md

@@ -28,12 +28,12 @@ context entry [project-dir] --language <language> --format json
 
 Use the user's explicit language choice when present; otherwise pass `zh-CN`
 for a Chinese conversation and `en` for an English conversation. Pass
-`project-dir`, `--name`, `--dev`, `--debug`, or `--optimize-docs` only when the
-user explicitly requested that initialization choice. Treat requests to enable
-document compilation optimization, document formatting optimization, or
-equivalent conservative build-time cleanup as `--optimize-docs`. Pass
-`--managed` only after the user
-explicitly authorizes fully managed operation in this conversation.
+`project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
+requested that initialization choice. New workspaces enable conservative
+document compilation optimization by default. Pass `--no-optimize-docs` only
+when the user explicitly asks to disable it during initialization. Pass
+`--managed` only after the user explicitly authorizes fully managed operation
+in this conversation.
 
 If the `context` process itself cannot start because the command is missing
 (`ENOENT`, or shell exit 127 explicitly identifying `context` as the missing
@@ -90,13 +90,19 @@ before workflow evaluation. Debugging records traces below
 `.tmp/context-runtime/debug/` but does not grant workflow authority or provide
 source evidence.
 
-Enable document optimization only when the user explicitly requests it. If
-initialization is required, pass `--optimize-docs` through `context entry`; for
-an existing workspace, run `context optimize-docs enable` before workflow
-evaluation. The feature keeps approved pages source-faithful and stores only
-changed full-page revisions beside them as `knowledge/**/*__revision.md`.
-Default knowledge discovery excludes those reserved sidecars; validation and
-package compilation apply them to the matching base page.
+Document optimization is enabled by default for newly initialized workspaces.
+It conservatively repairs formatting, Markdown, links, and obvious local errors
+without broadly rewriting source-backed prose. It keeps approved pages
+source-faithful and stores only changed full-page revisions beside them as
+`knowledge/**/*__revision.md`. Default knowledge discovery excludes those
+reserved sidecars; validation and package compilation apply them to the
+matching base page.
+
+For an existing workspace, respect its current `package.json` setting. Run
+`context optimize-docs enable` or `context optimize-docs disable` only when the
+user explicitly changes that preference. If initialization is required and the
+user opts out, pass `--no-optimize-docs` through `context entry`; otherwise let
+the default initialization command enable it.
 Follow the resulting Route instead of editing approved knowledge or package
 output by hand.
 

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

@@ -1,6 +1,6 @@
 {
   "name": "c4a",
-  "version": "0.6.16",
+  "version": "0.6.17",
   "description": "Start or continue a project-local knowledge workspace through one graph-routed entry.",
   "author": {
     "name": "c4a"
@@ -18,7 +18,7 @@
   "skills": "./skills/",
   "interface": {
     "displayName": "C4A Context",
-    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.6.16",
+    "shortDescription": "Initialize and advance a local, source-linked project knowledge workspace.\nv0.6.17",
     "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/codex/skills/context/SKILL.md

@@ -40,12 +40,12 @@ context entry [project-dir] --language <language> --format json
 
 Use the user's explicit language choice when present; otherwise pass `zh-CN`
 for a Chinese conversation and `en` for an English conversation. Pass
-`project-dir`, `--name`, `--dev`, `--debug`, or `--optimize-docs` only when the
-user explicitly requested that initialization choice. Treat requests to enable
-document compilation optimization, document formatting optimization, or
-equivalent conservative build-time cleanup as `--optimize-docs`. Pass
-`--managed` only after the user
-explicitly authorizes fully managed operation in this conversation.
+`project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
+requested that initialization choice. New workspaces enable conservative
+document compilation optimization by default. Pass `--no-optimize-docs` only
+when the user explicitly asks to disable it during initialization. Pass
+`--managed` only after the user explicitly authorizes fully managed operation
+in this conversation.
 
 If the `context` process itself cannot start because the command is missing
 (`ENOENT`, or shell exit 127 explicitly identifying `context` as the missing
@@ -102,13 +102,19 @@ before workflow evaluation. Debugging records traces below
 `.tmp/context-runtime/debug/` but does not grant workflow authority or provide
 source evidence.
 
-Enable document optimization only when the user explicitly requests it. If
-initialization is required, pass `--optimize-docs` through `context entry`; for
-an existing workspace, run `context optimize-docs enable` before workflow
-evaluation. The feature keeps approved pages source-faithful and stores only
-changed full-page revisions beside them as `knowledge/**/*__revision.md`.
-Default knowledge discovery excludes those reserved sidecars; validation and
-package compilation apply them to the matching base page.
+Document optimization is enabled by default for newly initialized workspaces.
+It conservatively repairs formatting, Markdown, links, and obvious local errors
+without broadly rewriting source-backed prose. It keeps approved pages
+source-faithful and stores only changed full-page revisions beside them as
+`knowledge/**/*__revision.md`. Default knowledge discovery excludes those
+reserved sidecars; validation and package compilation apply them to the
+matching base page.
+
+For an existing workspace, respect its current `package.json` setting. Run
+`context optimize-docs enable` or `context optimize-docs disable` only when the
+user explicitly changes that preference. If initialization is required and the
+user opts out, pass `--no-optimize-docs` through `context entry`; otherwise let
+the default initialization command enable it.
 Follow the resulting Route instead of editing approved knowledge or package
 output by hand.
 

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

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

package/plugins/cursor/commands/c4a-context.md

@@ -32,12 +32,12 @@ context entry [project-dir] --language <language> --format json
 
 Use the user's explicit language choice when present; otherwise pass `zh-CN`
 for a Chinese conversation and `en` for an English conversation. Pass
-`project-dir`, `--name`, `--dev`, `--debug`, or `--optimize-docs` only when the
-user explicitly requested that initialization choice. Treat requests to enable
-document compilation optimization, document formatting optimization, or
-equivalent conservative build-time cleanup as `--optimize-docs`. Pass
-`--managed` only after the user
-explicitly authorizes fully managed operation in this conversation.
+`project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
+requested that initialization choice. New workspaces enable conservative
+document compilation optimization by default. Pass `--no-optimize-docs` only
+when the user explicitly asks to disable it during initialization. Pass
+`--managed` only after the user explicitly authorizes fully managed operation
+in this conversation.
 
 If the `context` process itself cannot start because the command is missing
 (`ENOENT`, or shell exit 127 explicitly identifying `context` as the missing
@@ -94,13 +94,19 @@ before workflow evaluation. Debugging records traces below
 `.tmp/context-runtime/debug/` but does not grant workflow authority or provide
 source evidence.
 
-Enable document optimization only when the user explicitly requests it. If
-initialization is required, pass `--optimize-docs` through `context entry`; for
-an existing workspace, run `context optimize-docs enable` before workflow
-evaluation. The feature keeps approved pages source-faithful and stores only
-changed full-page revisions beside them as `knowledge/**/*__revision.md`.
-Default knowledge discovery excludes those reserved sidecars; validation and
-package compilation apply them to the matching base page.
+Document optimization is enabled by default for newly initialized workspaces.
+It conservatively repairs formatting, Markdown, links, and obvious local errors
+without broadly rewriting source-backed prose. It keeps approved pages
+source-faithful and stores only changed full-page revisions beside them as
+`knowledge/**/*__revision.md`. Default knowledge discovery excludes those
+reserved sidecars; validation and package compilation apply them to the
+matching base page.
+
+For an existing workspace, respect its current `package.json` setting. Run
+`context optimize-docs enable` or `context optimize-docs disable` only when the
+user explicitly changes that preference. If initialization is required and the
+user opts out, pass `--no-optimize-docs` through `context entry`; otherwise let
+the default initialization command enable it.
 Follow the resulting Route instead of editing approved knowledge or package
 output by hand.
 

package/plugins/skills/c4a-context/SKILL.md

@@ -40,12 +40,12 @@ context entry [project-dir] --language <language> --format json
 
 Use the user's explicit language choice when present; otherwise pass `zh-CN`
 for a Chinese conversation and `en` for an English conversation. Pass
-`project-dir`, `--name`, `--dev`, `--debug`, or `--optimize-docs` only when the
-user explicitly requested that initialization choice. Treat requests to enable
-document compilation optimization, document formatting optimization, or
-equivalent conservative build-time cleanup as `--optimize-docs`. Pass
-`--managed` only after the user
-explicitly authorizes fully managed operation in this conversation.
+`project-dir`, `--name`, `--dev`, or `--debug` only when the user explicitly
+requested that initialization choice. New workspaces enable conservative
+document compilation optimization by default. Pass `--no-optimize-docs` only
+when the user explicitly asks to disable it during initialization. Pass
+`--managed` only after the user explicitly authorizes fully managed operation
+in this conversation.
 
 If the `context` process itself cannot start because the command is missing
 (`ENOENT`, or shell exit 127 explicitly identifying `context` as the missing
@@ -102,13 +102,19 @@ before workflow evaluation. Debugging records traces below
 `.tmp/context-runtime/debug/` but does not grant workflow authority or provide
 source evidence.
 
-Enable document optimization only when the user explicitly requests it. If
-initialization is required, pass `--optimize-docs` through `context entry`; for
-an existing workspace, run `context optimize-docs enable` before workflow
-evaluation. The feature keeps approved pages source-faithful and stores only
-changed full-page revisions beside them as `knowledge/**/*__revision.md`.
-Default knowledge discovery excludes those reserved sidecars; validation and
-package compilation apply them to the matching base page.
+Document optimization is enabled by default for newly initialized workspaces.
+It conservatively repairs formatting, Markdown, links, and obvious local errors
+without broadly rewriting source-backed prose. It keeps approved pages
+source-faithful and stores only changed full-page revisions beside them as
+`knowledge/**/*__revision.md`. Default knowledge discovery excludes those
+reserved sidecars; validation and package compilation apply them to the
+matching base page.
+
+For an existing workspace, respect its current `package.json` setting. Run
+`context optimize-docs enable` or `context optimize-docs disable` only when the
+user explicitly changes that preference. If initialization is required and the
+user opts out, pass `--no-optimize-docs` through `context entry`; otherwise let
+the default initialization command enable it.
 Follow the resulting Route instead of editing approved knowledge or package
 output by hand.
 

package/providers/context/manifest.json

@@ -2,7 +2,7 @@
   "schema": "agent-graph.bundle.v1",
   "provider": {
     "id": "c4a/context",
-    "version": "0.6.16"
+    "version": "0.6.17"
   },
   "providerManifest": "provider.yaml",
   "graphs": [
@@ -664,7 +664,7 @@
     },
     {
       "path": "provider.yaml",
-      "digest": "sha256:a718b8f16af0967f020ef9211a3da1507369a0889d7faf88beeaed536a0256ce"
+      "digest": "sha256:31e9ca586a2c9edab004d04be8221e46897a7b88a601e9acad603af3ba250910"
     },
     {
       "path": "resources/diagnostics/projection-stale.md",
@@ -966,5 +966,5 @@
   "graphDependencies": {
     "workspace": []
   },
-  "digest": "sha256:4f5bf521512a167b2e78c2649deeffa11f2dff07a137970bb1027b164697bc6f"
+  "digest": "sha256:5da3c1272fa593c6eb36bbb33acc303e01dae0788f5f6ff5389835a76f8bd2df"
 }

package/providers/context/provider.yaml

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