@c4a/context-cli 0.5.41-beta.6 → 0.5.41-beta.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/context-cli",
-  "version": "0.5.41-beta.6",
+  "version": "0.5.41-beta.7",
   "type": "module",
   "bin": {
     "context": "./cli.js"

package/plugin/README.md

@@ -98,8 +98,9 @@ Work includes but is not limited to: workspace init, multi-source capture, align
 
 The compiled knowledge base can be packaged for distribution:
 
-- export as a **Skills** package — `context build --format skills-pack`;
+- export as a **Skills** package — `context build --format skills`;
 - export as **LLMs.txt** — `context build --format llms`;
+- agent ops build — `/context:ops build` exports Skills by default; use `--format llms` for LLMs.txt;
 - [TODO] publish to the **C4A platform** as an MCP service for other AIs to query live;
 - [TODO] publish as a standalone Plugin knowledge package, with retrieval quality on par with the MCP service and CLI.
 

package/plugin/README_CN.md

@@ -96,8 +96,9 @@ bun add -g @c4a/context-cli
 
 完整知识库支持对外打包发布：
 
-- 导出为 **Skills** 包：`context build --format skills-pack`；
+- 导出为 **Skills** 包：`context build --format skills`；
 - 导出为 **LLMs.txt**：`context build --format llms`；
+- Agent 运维构建：`/context:ops build` 默认导出 Skills，可用 `--format llms` 导出 LLMs.txt；
 - [TODO] 发布至 **C4A 平台**，作为 MCP 服务供其他 AI 实时查询；
 - [TODO] 发布为独立 Plugin 知识包，具备与 MCP 及 CLI 同等精度的检索能力。
 

package/plugin/commands/compile.md

@@ -21,7 +21,7 @@ Naming convention:
 - **`--aspect code [selector]`** — run `context compile --aspect code [selector]`, report the CLI result, and stop unless the CLI asks for a follow-up close. The selector may be omitted to process all actionable code sources; when present, the CLI resolves source slug, package name, or module path.
 - **`--aspect <name>`** — run deterministic custom aspect projection for one configured aspect. Use `context compile --aspect <name> --allow-large-deprecate` only when the CLI rejected a large deprecate and the user confirms the runner output is intentionally empty or reduced.
 - **`--all`** — run `context compile --all` to materialize code projection first and then custom aspect projections in deterministic order.
-- **Delegated** — add `--delegated` only when the user explicitly authorized delegated mode at the start of this conversation. Delegated mode records scoped authority for low-risk reconcile/review/apply defaults; it does not auto-draft Node content or replace agent evidence reading. Do not infer it from vague "continue" permission.
+- **Delegated** — add `--delegated` only when the user explicitly authorized delegated mode at the start of this conversation. Treat requests such as "全托管执行", "全自动托管", "fully managed", "delegated execution", or "use delegated mode" as explicit delegated authorization. Delegated mode records scoped authority for low-risk reconcile/review/apply defaults; it does not auto-draft Node content or replace agent evidence reading. Do not infer it from vague "continue", "继续", or "后面不用问我" permission.
 
 ### Core Rules
 
@@ -40,7 +40,7 @@ Protocol discovery:
 
 ## Start
 
-1. Run `context compile scan --format json` (or `context compile scan --delegated --format json` only for explicit delegated mode).
+1. Run `context compile scan --format json` (or `context compile scan --delegated --format json` when the user explicitly authorized delegated mode, including "全托管执行" / "fully managed").
 2. If the scan returns `close_compile`, run the returned close command even when there are no changed Nodes; finalized no-write/container Nodes may still need close materialization.
 3. If the scan returns `stop_noop` or no changed work, report that compile stopped before draft and no files were written.
 4. Run `context status --view summary --format json` or `context mdrive workspace stats --format json` only when needed for the final before/after report or when the CLI asks for diagnostics. Do not run doctor/status/source-list as a required preflight before following a valid compile scan or align-finalize handoff.
@@ -72,6 +72,8 @@ For `submit_compile_cycle`, load the Node evidence via the returned command/view
 
 Prefer heredocs for small payloads. If large or parallel draft payloads need staging, use the workspace AGENTS.md scratch path (`.context/.tmp/agent-payloads/<run-id>/...` in embedded workspaces, `.tmp/agent-payloads/<run-id>/...` in root-layout workspaces) and redirect stdin from that file. Never reuse fixed names like `/tmp/c4a-draft-<node>.json`, and never use scratch paths as workflow handoff or CLI-managed storage.
 
+Use `op: deprecate` only when an existing active Section is no longer supported by its source, is factually wrong, has been superseded, or the user explicitly asked to retire it. Do not deprecate an existing true Section merely because it is low-relevance to the current narrow task; leave it unchanged and use `op: skip` / omit only for the current proposed evidence.
+
 For `continue_compile_cycle`, do not invoke the draft skill and do not attach `--input`; execute the returned `next_action.command` exactly. `--continue` resumes a saved draft session. If it returns `status: "noop"`, follow the returned `close_compile` next action.
 
 For `patch_compile_draft`, submit only the patch schema requested by the CLI. Use `actions_meta[].action_id` for `replace_action` / `remove_action`, or `add_action` with `before` / `after`; do not use generic `op/path/value` aliases.
@@ -100,4 +102,11 @@ Do not recover by replaying an old manual path, editing rendered files, or guess
 
 When `next_action.kind` is `close_compile`, execute `context compile close` through packaged `context:skill-compile-close` or the returned command. Never claim success unless close exits 0 and verify is green, except the explicit no-work path.
 
+Treat close as a terminal gate, not a blind final step:
+
+- If close reports `code_projection_followup` / `compile-close-code-projection-followup`, run the returned `context compile --aspect code ...` command, then run `context compile close` again before reporting final success.
+- If close reports `ready_with_debt`, do not enter export/query/report-as-complete unless the user explicitly accepts the remaining debt. Otherwise repair or skip coverage debt through the returned coverage commands, then run close again.
+- Coverage disposition commands mutate workflow state. Run one `context compile coverage ...` command at a time, or use the returned `--skip-unresolved` bulk command for one Node; never submit multiple coverage disposition writes concurrently.
+- Use `context query --intent recall` only as a smoke-test query. Do not use recall as a deterministic full-workspace export path.
+
 Report in the user's conversation language. Include semantic apply counts, close/verify status, warning-level `auto_repaired[]`, `ready_with_debt` coverage summaries when present, and before/after workspace totals. Do not surface internal workflow payload digests, source-ref hashes, archive paths, or absolute file paths unless a user-facing report view explicitly returns them.

package/plugin/commands/context.md

@@ -24,10 +24,11 @@ Routing rules (first match wins):
 7. **Mentions `aspect` without a concrete supported capture flag** → ask one clarification; code aspect capture is exposed as `/context:capture --code`.
 8. **Matches `align`, `structure`, `plan`, `node tree`** → `/context:align $ARGUMENTS`.
 9. **Matches `compile`, `recompile`, `synthesize`, or `build knowledge`** → `/context:compile $ARGUMENTS`.
-10. **Matches `drop`, `retract`, `delete source`, or passes a known source-id pattern (`feishu:*` / `local:*` / `aspect:*` / `oncall:*` / `meeting:*`)** → `/context:drop $ARGUMENTS`.
-11. **Matches `purge`, `clear archive`, `delete archive`, or `清理归档`** → `/context:purge $ARGUMENTS`.
-12. **Equals `status`, `health`, `overview`, `summary`, or asks for workspace/cache/plugin health** → `/context:status`.
-13. **Anything else** (likely a knowledge question) → `/context:query $ARGUMENTS`.
+10. **Matches `build`, `export`, `package`, `publish`, `deploy`, `release`, `ops`, `operations`, or `运维` as an operational/package task** → `/context:ops $ARGUMENTS`.
+11. **Matches `drop`, `retract`, `delete source`, or passes a known source-id pattern (`feishu:*` / `local:*` / `aspect:*` / `oncall:*` / `meeting:*`)** → `/context:drop $ARGUMENTS`.
+12. **Matches `purge`, `clear archive`, `delete archive`, or `清理归档`** → `/context:purge $ARGUMENTS`.
+13. **Equals `status`, `health`, `overview`, `summary`, or asks for workspace/cache/plugin health** → `/context:status`.
+14. **Anything else** (likely a knowledge question) → `/context:query $ARGUMENTS`.
 
 If multiple rules apply, pick the most specific (URL beats word match). When in doubt, ask one clarifying question before dispatching.
 Never use Read / Glob / Grep / Write against `WORKSPACE_DIR`; route to packaged `/context:*` commands and skills instead of opening plugin or workspace files manually.

package/plugin/commands/ops.md

@@ -0,0 +1,47 @@
+---
+description: "Run operational package tasks such as local build/export, with future publish commands kept under the same entry."
+argument-hint: "build [--format llms|skills]"
+allowed-tools: Bash(context:*)
+---
+
+## Your Task
+
+Run operational tasks for the current context workspace. This command owns packaging/export work and is the future home for platform publish. It does not capture, align, compile, query, drop, or purge knowledge.
+
+Supported subcommands:
+
+- `build`: build a local knowledge package by running `context build`.
+
+Unsupported but reserved subcommands:
+
+- `publish`: reserved for future platform publish. Do not invent a CLI command for it.
+- `package`: reserved for future offline package-only publish flow. Do not invent a CLI command for it.
+
+### Build
+
+If `$ARGUMENTS` is empty, treat it as `build --format skills`.
+
+If `$ARGUMENTS` starts with `build`, run `context build` with the requested format:
+
+- `build --format skills` -> `context build --format skills`
+- `build --format llms` -> `context build --format llms`
+- `build skills` -> `context build --format skills`
+- `build llms` -> `context build --format llms`
+- `build` -> `context build --format skills`
+
+If the user asks for both formats, run the two CLI commands separately:
+
+1. `context build --format skills`
+2. `context build --format llms`
+
+Do not pass unsupported flags to `context build`. If the user supplies an unknown build format, explain that the supported formats are `skills` and `llms`, then stop.
+
+Before running build, do not inspect workspace files with generic tools. The CLI performs workspace verification and prints blocking issues if the workspace is not ready.
+
+After build succeeds, surface the CLI output verbatim, especially the package path under `output/skills-pkg/` or `output/llms-pkg/`. If build fails because verification failed, relay the error and let the CLI's issue list drive remediation; do not inspect `raw/`, `knowledge/`, or `output/` yourself.
+
+### Reserved Publish
+
+If `$ARGUMENTS` starts with `publish`, `package`, `deploy`, or `release`, do not run any command. Explain briefly that platform publish/package-only is reserved under `/context:ops` but not implemented yet. For now, the available operational command is `/context:ops build`.
+
+Language policy: CLI stdout/stderr stays verbatim. Any explanation you add follows the user's conversation language; command names, flags, paths, package formats, and issue codes stay as printed.

package/plugin/skills/skill-context-query/SKILL.md

@@ -50,11 +50,14 @@ Supplemental context can come from:
 
 ```text
 context query --intent node_view --scope <slug>
+context query --intent node_view --scope <slug> --view source-refs
 context query --intent impact_analysis --scope <slug>
 context query --intent node_view --refers-to <slug>
 context query --intent section_search --scope <slug> --query "<keywords>"
 ```
 
+Use the `--view source-refs` / `--view source-refs-index` node_view forms when a hit's `raw_expand_command` is needed for factual confirmation. These are query-owned read views; do not substitute `context compile context ...` during answer-only query work.
+
 ## Query Route Decision Table
 
 Choose the `context query` command based on problem intent. **Structure queries take priority.**

package/scripts/build-plugin.ts

@@ -326,10 +326,6 @@ function claudeCommandForSlug(slug: string): string {
   return slug === "context" ? "/context:context" : `/context:${slug}`;
 }
 
-function cursorCommandForSlug(slug: string): string {
-  return slug === "context" ? "/context" : `/context-${slug}`;
-}
-
 const CURSOR_COMMAND_SUMMARIES: Record<string, string> = {
   align: "Review raw material and confirm the Node tree before compiling knowledge.",
   capture: "Capture documents, source code, notes, inbox files, or refreshed sources into the workspace.",
@@ -338,6 +334,7 @@ const CURSOR_COMMAND_SUMMARIES: Record<string, string> = {
   drop: "Plan and apply source retraction with semantic decisions and archive safety.",
   extract: "Preview extraction output for a file without writing workspace state.",
   init: "Choose workspace layout, language, and focus, then create the C4A workspace.",
+  ops: "Run operational package tasks such as local build/export, with future publish kept under one entry.",
   purge: "Permanently delete archived dropped-source artifacts after explicit confirmation.",
   query: "Answer from the local knowledge workspace with citations and gap handling.",
   status: "Show workspace state, pending work, cache health, and the next useful command.",