@c4a/context-cli 0.6.2 → 0.6.3

package/README.md

@@ -37,6 +37,11 @@ The public Agent entries are:
 For the shortest installed-package walkthrough, read
 [CLI Quickstart](./docs/quickstart.md).
 
+Workspace tracing is off by default. Use `context init context --debug` or
+`context debug enable` only when command and Agent Graph route observability is
+needed; logs stay under ignored `.tmp/context-runtime/debug/`. See
+[Workspace debug tracing](./docs/debug-tracing.md).
+
 ## CLI And Agent Responsibilities
 
 | Responsibility | Owner |
@@ -83,7 +88,8 @@ The workspace state is split across:
   confirmed structure snapshots during an open lifecycle round.
 - `knowledge/` for approved Markdown, the closed `structure.yaml` projection,
   and the minimal `decisions.json` rejected-candidate fingerprint map when one
-  exists.
+  exists. Resources referenced by approved pages live in content-addressed
+  `knowledge/assets/` paths.
 - `dist/` for generated package output.
 - `.tmp/context-runtime/` for other ignored logs, previews, reports, locks, and caches.
 
@@ -106,6 +112,8 @@ KB packages use flat, package-relative OKF roots: `wikis/`, `guides/`,
 `dist/<package-name>/` directory and is not repeated inside those roots. Older
 workspaces that still declare `distribution.knowledgeNamespace` remain
 loadable, but the legacy value no longer changes package paths.
+Resources referenced by selected pages are copied to `others/assets/` inside
+the package, with links rewritten by the builder.
 
 See the SDK manuals for the complete configuration and template contract:
 
@@ -140,9 +148,14 @@ freeze the workspace. New sources can be added and processed later.
 context plugin install
 context plugin status
 
-# Workspace state
+# Workspace creation and state
 context init [project-dir]
 context status
+context run --managed --until blocked-or-complete --format json
+
+# Route-selected resources
+context resource materialize --help
+context resource acknowledge-current --help
 
 # Sources
 context source add repo [YYYYMMDD] --module <module> --local <repo-or-subdir>
@@ -161,15 +174,28 @@ context run <phase-id>
 context review html [collection] --open
 context review apply <payload-file>
 
+# Package template decisions
+context package template accept --help
+
 # Final quality and output
 context close
 context verify
 context build
+
+# Optional workspace tracing
+context debug enable
+context debug status
+context debug export
+
+# Development/cache maintenance
+context clean-cache --dry-run
 ```
 
 Run `context <command> --help` for current flags. Commands that require a
 workspace search upward for a `package.json` with `context.project=true` and a
-configured `context.entry`.
+configured `context.entry`. Revision-bound resource and package commands should
+normally be copied from `workflow.current`; the examples above show their
+discovery surface rather than a replacement for the current route.
 
 ## Human Gates And Evidence
 
@@ -195,6 +221,7 @@ citation: copy it exactly and do not parse it as a filesystem path.
 - [Getting Started](../context/docs/getting-started.md)
 - [Agent Guide](../context/docs/guides/agent-guide.md)
 - [Agent Dialogue](../context/docs/guides/agent-dialogue.md)
+- [Lark Resource Materialization](../context/docs/guides/lark-resources.md)
 - [Project API](../context/docs/reference/project-api.md)
 - [Package Templates](../context/docs/reference/package-templates.md)
 

package/README.zh-CN.md

@@ -26,6 +26,11 @@ context plugin install
 
 最简安装后流程参见 [CLI 快速开始](./docs/quickstart.md)。
 
+工作区调试追踪默认关闭。仅在需要观察命令调用与 Agent Graph 路由时，使用
+`context init context --debug` 或 `context debug enable` 开启；日志只写入已忽略的
+`.tmp/context-runtime/debug/`。协议与回放说明见
+[工作区调试追踪](./docs/debug-tracing.md)。
+
 ## CLI、Agent 和用户的分工
 
 | 职责 | 负责方 |
@@ -62,7 +67,7 @@ node_modules/@c4a/context/docs/reference/package-templates.md
 - `src/`：项目声明和知识包模板。
 - `sources/`：来源登记和已经读取的证据。
 - `.tmp/context-runtime/lifecycle/`：一个开放生命周期轮次中的、被忽略且仅由 CLI 管理的草稿候选和已确认结构快照。
-- `knowledge/`：已批准的 Markdown、close 后的 `structure.yaml` 结构投影，以及存在时用于记录被拒候选 fingerprint 的精简 `decisions.json`。
+- `knowledge/`：已批准的 Markdown、close 后的 `structure.yaml` 结构投影，以及存在时用于记录被拒候选 fingerprint 的精简 `decisions.json`。已批准页面引用的资源位于内容寻址的 `knowledge/assets/`。
 - `dist/`：构建生成的知识包。
 - `.tmp/context-runtime/`：其他被忽略的日志、预览、报告、锁和缓存。
 
@@ -76,6 +81,7 @@ node_modules/@c4a/context/docs/reference/package-templates.md
 `wikis/`、`guides/`、`rules/` 和 `feats/` 作为包内 OKF 根目录，不再在这些目录下重复包名。
 旧工作区即使仍声明 `distribution.knowledgeNamespace` 也可以继续加载，但该兼容字段不再改变
 知识包输出路径。
+选中页面引用的资源会复制到包内 `others/assets/`，相对链接由构建器自动改写。
 
 完整配置和模板约定参见 SDK 手册：
 
@@ -106,9 +112,14 @@ node_modules/@c4a/context/docs/reference/package-templates.md
 context plugin install
 context plugin status
 
-# 工作区状态
+# 工作区创建与状态
 context init [project-dir]
 context status
+context run --managed --until blocked-or-complete --format json
+
+# 当前路由选择的资源
+context resource materialize --help
+context resource acknowledge-current --help
 
 # 知识来源
 context source add repo [YYYYMMDD] --module <module> --local <repo-or-subdir>
@@ -127,13 +138,27 @@ context run <phase-id>
 context review html [collection] --open
 context review apply <payload-file>
 
+# 知识包模板决策
+context package template accept --help
+
 # 最终质量与输出
 context close
 context verify
 context build
+
+# 可选的工作区调试追踪
+context debug enable
+context debug status
+context debug export
+
+# 开发与缓存维护
+context clean-cache --dry-run
 ```
 
-当前参数以 `context <command> --help` 为准。需要工作区的命令会向上查找带有 `context.project=true` 和 `context.entry` 配置的 `package.json`。
+当前参数以 `context <command> --help` 为准。需要工作区的命令会向上查找带有
+`context.project=true` 和 `context.entry` 配置的 `package.json`。带 revision
+约束的资源和知识包命令通常应直接复制 `workflow.current` 返回的命令；上面的例子只用于
+发现命令入口，不能替代当前路由。
 
 ## 人工门禁与证据
 
@@ -152,6 +177,7 @@ CLI 返回的来源名称、阶段 ID、候选 ID、诊断和 `source_ref` 都
 - [快速开始](../context/docs/getting-started.md)
 - [Agent 指南](../context/docs/guides/agent-guide.md)
 - [Agent 对话指南](../context/docs/guides/agent-dialogue.md)
+- [飞书资源物化](../context/docs/guides/lark-resources.md)
 - [项目 API](../context/docs/reference/project-api.md)
 - [知识包模板](../context/docs/reference/package-templates.md)