@fenglimg/fabric-cli 2.0.0-rc.1 → 2.0.0

package/dist/plan-context-hint-QMUPAXIB.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+import {
+  resolveDevMode
+} from "./chunk-OBQU6NHO.js";
+
+// src/commands/plan-context-hint.ts
+import { defineCommand } from "citty";
+import { planContext } from "@fenglimg/fabric-server";
+var ALL_PATHS_SENTINEL = "**";
+var planContextHintCommand = defineCommand({
+  meta: {
+    name: "plan-context-hint",
+    description: "Emit versioned knowledge hint JSON to stdout. Used by rc.6 hooks and the fabric-import skill."
+  },
+  args: {
+    paths: {
+      type: "string",
+      description: "Comma-separated list of file paths to compute narrow hints for."
+    },
+    all: {
+      type: "boolean",
+      description: "Return the full broad+narrow set with no path filter.",
+      default: false
+    },
+    target: {
+      type: "string",
+      description: "Override the project root (defaults to cwd / dev-mode resolution)."
+    }
+  },
+  async run({ args }) {
+    try {
+      const output = await runPlanContextHint({
+        paths: parsePathsArg(args.paths),
+        all: args.all === true,
+        target: args.target
+      });
+      process.stdout.write(`${JSON.stringify(output)}
+`);
+    } catch (error) {
+      const message = error instanceof Error ? error.message : String(error);
+      process.stderr.write(`plan-context-hint failed: ${message}
+`);
+      process.exitCode = 1;
+    }
+  }
+});
+var plan_context_hint_default = planContextHintCommand;
+async function runPlanContextHint(opts) {
+  const all = opts.all === true;
+  const explicitPaths = (opts.paths ?? []).filter((p) => p.length > 0);
+  const targetPaths = all ? [ALL_PATHS_SENTINEL] : explicitPaths.length > 0 ? explicitPaths : [ALL_PATHS_SENTINEL];
+  const resolution = resolveDevMode(opts.target, process.cwd());
+  const result = await planContext(resolution.target, {
+    paths: targetPaths
+  });
+  const sharedIndex = result.shared.description_index;
+  const narrowSource = all ? sharedIndex : (
+    // Path mode: union of per-entry description_index across requested
+    // paths, deduped by stable_id. This is identical to `shared` for L0/L1
+    // entries (always included) and additionally captures L2 entries whose
+    // scope_glob matches the requested path.
+    dedupeByStableId(result.entries.flatMap((entry) => entry.description_index))
+  );
+  const narrow = narrowSource.map((item) => ({
+    id: item.stable_id,
+    type: item.type ?? item.description.knowledge_type ?? "",
+    maturity: item.maturity ?? item.description.maturity ?? "",
+    summary: item.description.summary
+  }));
+  return {
+    version: 1,
+    revision_hash: result.revision_hash,
+    target_paths: targetPaths,
+    narrow,
+    broad_count: sharedIndex.length
+  };
+}
+function parsePathsArg(raw) {
+  if (raw === void 0 || raw.length === 0) {
+    return [];
+  }
+  return raw.split(",").map((part) => part.trim()).filter((part) => part.length > 0);
+}
+function dedupeByStableId(items) {
+  const seen = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const item of items) {
+    if (seen.has(item.stable_id)) continue;
+    seen.add(item.stable_id);
+    result.push(item);
+  }
+  return result;
+}
+export {
+  plan_context_hint_default as default,
+  planContextHintCommand,
+  runPlanContextHint
+};

package/dist/{scan-HU2EGITF.js → scan-LMK3UCWL.js}

@@ -7,8 +7,10 @@ import {
   runInitScan,
   scanCommand,
   scan_default
-} from "./chunk-UHNP7T7W.js";
-import "./chunk-5LOYBXWD.js";
+} from "./chunk-EYIDD2YS.js";
+import "./chunk-WWNXR34K.js";
+import "./chunk-6ICJICVU.js";
+import "./chunk-OBQU6NHO.js";
 export {
   __testing__,
   createScanReport,

package/dist/{serve-3LXXSBFR.js → serve-H554BHLG.js}

@@ -1,11 +1,15 @@
 #!/usr/bin/env node
 import {
-  createDebugLogger,
   paint,
-  resolveDevMode,
-  symbol,
+  symbol
+} from "./chunk-WWNXR34K.js";
+import {
   t
-} from "./chunk-5LOYBXWD.js";
+} from "./chunk-6ICJICVU.js";
+import {
+  createDebugLogger,
+  resolveDevMode
+} from "./chunk-OBQU6NHO.js";
 
 // src/commands/serve.ts
 import { defineCommand } from "citty";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-cli",
-  "version": "2.0.0-rc.1",
+  "version": "2.0.0",
   "type": "module",
   "bin": {
     "fab": "dist/index.js",
@@ -20,8 +20,8 @@
     "tree-sitter-javascript": "^0.25.0",
     "tree-sitter-typescript": "^0.23.2",
     "web-tree-sitter": "^0.26.8",
-    "@fenglimg/fabric-server": "2.0.0-rc.1",
-    "@fenglimg/fabric-shared": "2.0.0-rc.1"
+    "@fenglimg/fabric-server": "2.0.0",
+    "@fenglimg/fabric-shared": "2.0.0"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",

package/templates/bootstrap/CLAUDE.md

@@ -1,7 +1,7 @@
 # Fabric Bootstrap
 - 主说明文档已收敛到 `.fabric/bootstrap/README.md`。
 - 项目级 bootstrap 入口仍然是 `AGENTS.md`。
-- 修改任何文件前必须调用 `fab_plan_context(paths=[<被改文件>])`，再调用 `fab_get_rule_sections` 获取规则段落。
+- 修改任何文件前必须调用 `fab_plan_context(paths=[<被改文件>])`，再调用 `fab_get_knowledge_sections` 获取规则段落。
 MCP 和 doctor 会写入 `.fabric/events.jsonl`。
 - 规则 baseline 变更通过 `fabric doctor --fix` 接受。
 

package/templates/bootstrap/codex-AGENTS-header.md

@@ -1,6 +1,6 @@
 # Fabric Bootstrap
 - 主说明文档已收敛到 `.fabric/bootstrap/README.md`。
 - 此 header 仅用于把 Codex 引导到 Fabric 项目级规则入口。
-- 修改任何文件前必须调用 `fab_plan_context(paths=[<被改文件>])`，再调用 `fab_get_rule_sections` 获取规则段落。
+- 修改任何文件前必须调用 `fab_plan_context(paths=[<被改文件>])`，再调用 `fab_get_knowledge_sections` 获取规则段落。
 MCP 和 doctor 会写入 `.fabric/events.jsonl`。
 - 规则 baseline 变更通过 `fabric doctor --fix` 接受。

package/templates/bootstrap/cursor-fabric-bootstrap.mdc

@@ -5,6 +5,6 @@ description: Fabric Protocol bootstrap rules
 
 # Fabric Bootstrap
 - 本项目使用 Fabric Protocol 管理规则。
-- **任何文件修改前**，必须先调 MCP tool `fab_plan_context(paths=[<被改文件>])`，再调 `fab_get_rule_sections` 获取规则段落。
+- **任何文件修改前**，必须先调 MCP tool `fab_plan_context(paths=[<被改文件>])`，再调 `fab_get_knowledge_sections` 获取规则段落。
 - 新建或调整 L1/L2 节点时，修改规则源文件后运行 `fabric doctor --fix` 接受 baseline，**严禁**直接编辑 `.fabric/agents.meta.json`。
 Fabric 会把 MCP 和 doctor 行为写入 `.fabric/events.jsonl`。

package/templates/hooks/configs/README.md

@@ -0,0 +1,73 @@
+# Client hook config templates
+
+These JSON files are **fragment templates** consumed by `fabric init` and
+`fabric hooks install`. They are not standalone client config files.
+
+The supported clients are pinned by `packages/shared/src/schemas/fabric-config.ts`
+to Claude Code, Cursor, and Codex CLI. Adding a new client requires extending
+that schema first.
+
+## claude-code.json
+
+Deep-merged into the user repo's `.claude/settings.json` by the init pipeline.
+Registers `fabric-hint.cjs` under `hooks.Stop[]` with `matcher: "*"`. The
+existing `mcpServers`, `permissions`, and any other top-level keys in the user's
+settings.json are preserved.
+
+The `hooks.Stop[]` array merge needs special-case handling (array-append with
+dedupe by `command` string) because `packages/cli/src/config/json.ts:18` default
+`deepMerge` REPLACES arrays. The mergeClaudeCodeHookConfig helper owns that
+wiring.
+
+## codex-hooks.json
+
+Written to (or merged into) the user repo's `.codex/hooks.json`. NOTE: Codex
+project-level hooks file is JSON, **not** TOML — only the user-level Codex MCP
+config (`~/.codex/config.toml`) is TOML.
+
+## cursor-hooks.json
+
+Written to (or merged into) the user repo's `.cursor/hooks.json`. Mirrors the
+Codex `events.Stop[]` envelope shape — Cursor's hook event vocabulary is
+not stable across releases, so the canonical Stop-on-tool-finish lifecycle hook
+is the only entry we register today. SessionStart / PreToolUse slots are left
+unfilled for rc.6 to add when their semantics stabilise.
+
+## fabric-hint.cjs script paths
+
+- Claude: `.claude/hooks/fabric-hint.cjs` (project-relative)
+- Codex:  `.codex/hooks/fabric-hint.cjs`  (project-relative)
+- Cursor: `.cursor/hooks/fabric-hint.cjs` (project-relative)
+
+The single shared script lives at `packages/cli/templates/hooks/fabric-hint.cjs`
+in this repo and is copied into all three `<client>/hooks/` destinations by the
+install wiring. The script emits stdout JSON
+`{decision:"block", reason, signal, recommended_skill}` with exit 0 when one of
+three signals trips:
+
+- **archive** (rc.5 TASK-015): 24h elapsed since last `knowledge_proposed`
+  event. Silent on a never-archived workspace (that case is the **import**
+  signal's domain). Recommends the `fabric-archive` skill. The previous
+  `5 plan_contexts` count branch (rc.2) was dropped because rc.5+ hooks
+  auto-fire plan_context events; rc.6 will reintroduce an Edit-count signal
+  via a PreToolUse sidecar.
+- **review** (rc.3): pending knowledge count >= 10, OR oldest pending entry >= 7
+  days old. Recommends the `fabric-review` skill.
+- **import** (rc.5): canonical knowledge node count < `underseed_node_threshold`
+  (default 10) AND `init_scan_completed` event >= 24h ago AND no
+  `knowledge_proposed` event in last 24h. Recommends the `fabric-import` skill.
+
+Precedence: archive > review > import. After firing, the hook stays silent for
+`archive_hint_cooldown_hours` (default 12h, keyed by `signal` so the three
+signals share a cache file but throttle independently).
+
+The script is silent + exit 0 when no signal trips. It NEVER blocks tool
+execution on its own failure — any read/parse error is swallowed.
+
+## Historical note: archive-hint.cjs rename
+
+Pre-rc.5, this script was named `archive-hint.cjs` (only the archive signal
+existed). rc.5 TASK-010 renamed it to `fabric-hint.cjs` to reflect its expanded
+three-signal scope. The cooldown cache file is intentionally still named
+`archive-hint-shown.json` so an in-place upgrade does not flush the user's
+existing throttle state.

package/templates/hooks/configs/claude-code.json

@@ -0,0 +1,37 @@
+{
+  "hooks": {
+    "Stop": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/fabric-hint.cjs"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/knowledge-hint-broad.cjs"
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "hooks": [
+          {
+            "type": "command",
+            "command": ".claude/hooks/knowledge-hint-narrow.cjs"
+          }
+        ]
+      }
+    ]
+  }
+}

package/templates/hooks/configs/codex-hooks.json

@@ -0,0 +1,20 @@
+{
+  "events": {
+    "Stop": [
+      {
+        "command": ".codex/hooks/fabric-hint.cjs"
+      }
+    ],
+    "SessionStart": [
+      {
+        "command": ".codex/hooks/knowledge-hint-broad.cjs"
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "command": ".codex/hooks/knowledge-hint-narrow.cjs"
+      }
+    ]
+  }
+}

package/templates/hooks/configs/cursor-hooks.json

@@ -0,0 +1,20 @@
+{
+  "events": {
+    "Stop": [
+      {
+        "command": ".cursor/hooks/fabric-hint.cjs"
+      }
+    ],
+    "SessionStart": [
+      {
+        "command": ".cursor/hooks/knowledge-hint-broad.cjs"
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "Edit|Write|MultiEdit",
+        "command": ".cursor/hooks/knowledge-hint-narrow.cjs"
+      }
+    ]
+  }
+}