@fenglimg/fabric-cli 2.2.0 → 2.3.0-rc.1

package/dist/{store-HOCORVL3.js → store-GF4SFBMJ.js}

@@ -1,8 +1,7 @@
 #!/usr/bin/env node
 import {
   regenerateBindingsSnapshot
-} from "./chunk-PTGQAZEW.js";
-import "./chunk-EOT63RDH.js";
+} from "./chunk-GGDVZCD6.js";
 import {
   assertStoreMountable,
   resolveStoreDir,
@@ -17,16 +16,17 @@ import {
   storeRemove,
   storeSetWriteRoute,
   storeSwitchWrite
-} from "./chunk-QPAW6IYT.js";
+} from "./chunk-7V4XMLQ2.js";
 import {
   loadProjectConfig
-} from "./chunk-QFIVFZRH.js";
+} from "./chunk-I5F5BHWI.js";
 import "./chunk-FNHDQTPC.js";
 import {
   getProjectTranslator
 } from "./chunk-HORSMSZL.js";
 
 // src/commands/store.ts
+import { confirm, isCancel } from "@clack/prompts";
 import { defineCommand } from "citty";
 import { join as join3 } from "path";
 
@@ -220,6 +220,47 @@ import {
   loadGlobalConfig,
   resolveGlobalRoot
 } from "@fenglimg/fabric-shared";
+async function resolveStoreMutationConsent(opts) {
+  if (opts.yes || process.env.FABRIC_NONINTERACTIVE === "1") {
+    return "proceed";
+  }
+  if (process.stdin.isTTY !== true) {
+    console.error(
+      `store ${opts.label}: stdin is not a TTY and neither --yes nor FABRIC_NONINTERACTIVE=1 is set. Refusing to mutate.`
+    );
+    return "abort";
+  }
+  const answer = await confirm({
+    message: `About to rewrite ${opts.count} knowledge entr${opts.count === 1 ? "y" : "ies"} (store ${opts.label}). Proceed?`,
+    initialValue: false
+  });
+  if (isCancel(answer) || answer !== true) {
+    console.error(`store ${opts.label}: aborted by user.`);
+    return "abort";
+  }
+  return "proceed";
+}
+async function runGatedMigrate(opts) {
+  if (opts.dryRun) {
+    opts.print(await opts.run(true));
+    return;
+  }
+  const preview = await opts.run(true);
+  if (preview.changes.length === 0) {
+    opts.print(preview);
+    return;
+  }
+  const decision = await resolveStoreMutationConsent({
+    label: opts.label,
+    count: preview.changes.length,
+    yes: opts.yes
+  });
+  if (decision === "abort") {
+    process.exitCode = 1;
+    return;
+  }
+  opts.print(await opts.run(false));
+}
 var listCommand = defineCommand({
   meta: { name: "list", description: "List mounted knowledge stores" },
   run() {
@@ -230,16 +271,24 @@ var listCommand = defineCommand({
       return;
     }
     const localOnly = t("cli.shared.local-only");
-    for (const store of stores) {
-      const realRemote = storeGitRemote(store.alias);
+    const rows = stores.map((store) => ({
+      alias: store.alias,
+      name: store.mount_name ?? store.store_uuid,
+      uuid: store.store_uuid,
+      remote: storeGitRemote(store.alias) ?? localOnly
+    }));
+    const aliasW = Math.max(...rows.map((r) => r.alias.length));
+    const nameW = Math.max(...rows.map((r) => r.name.length));
+    const uuidW = Math.max(...rows.map((r) => r.uuid.length));
+    for (const r of rows) {
       console.log(
-        `${store.alias}	${store.mount_name ?? store.store_uuid}	${store.store_uuid}	${realRemote ?? localOnly}`
+        `${r.alias.padEnd(aliasW)}  ${r.name.padEnd(nameW)}  ${r.uuid.padEnd(uuidW)}  ${r.remote}`
       );
     }
   }
 });
-var addCommand = defineCommand({
-  meta: { name: "add", description: "Mount a knowledge store into the global registry" },
+var mountCommand = defineCommand({
+  meta: { name: "mount", description: "Mount a knowledge store into the global registry" },
   args: {
     uuid: { type: "string", required: true, description: "Intrinsic store UUID" },
     alias: { type: "string", required: true, description: "Local alias for this store" },
@@ -346,29 +395,35 @@ var bindCommand = defineCommand({
   }
 });
 var switchWriteCommand = defineCommand({
-  meta: { name: "switch-write", description: "Set the default write store for non-personal scopes" },
+  meta: {
+    name: "switch-write",
+    description: "Set the default write store, or route one semantic scope with --scope"
+  },
   args: {
-    alias: { type: "positional", required: true, description: "Alias of the store to write to" }
+    alias: { type: "positional", required: true, description: "Alias of the store to write to" },
+    scope: {
+      type: "string",
+      description: "Route only this semantic scope (e.g. team or project:fabric-v2) to the store"
+    }
   },
   async run({ args }) {
     const projectRoot = process.cwd();
+    if (typeof args.scope === "string" && args.scope.length > 0) {
+      storeSetWriteRoute(projectRoot, args.scope, args.alias);
+      regenerateBindingsSnapshot(projectRoot, { now: (/* @__PURE__ */ new Date()).toISOString() });
+      console.log(
+        getProjectTranslator(projectRoot)("cli.store.routed", {
+          scope: args.scope,
+          alias: args.alias
+        })
+      );
+      return;
+    }
     storeSwitchWrite(projectRoot, args.alias);
     regenerateBindingsSnapshot(projectRoot, { now: (/* @__PURE__ */ new Date()).toISOString() });
     console.log(getProjectTranslator(projectRoot)("cli.store.switch-write", { alias: args.alias }));
   }
 });
-var routeWriteCommand = defineCommand({
-  meta: { name: "route-write", description: "Route a semantic scope to a writable shared store" },
-  args: {
-    scope: { type: "positional", required: true, description: "Semantic scope, e.g. team or project:fabric-v2" },
-    alias: { type: "positional", required: true, description: "Alias of the shared store to write to" }
-  },
-  run({ args }) {
-    const projectRoot = process.cwd();
-    storeSetWriteRoute(projectRoot, args.scope, args.alias);
-    console.log(`write route: ${args.scope} -> ${args.alias}`);
-  }
-});
 var projectListCommand = defineCommand({
   meta: { name: "list", description: "List projects registered in a store" },
   args: {
@@ -408,14 +463,15 @@ var projectCommand = defineCommand({
 });
 var backfillScopeCommand = defineCommand({
   meta: {
-    name: "backfill-scope",
+    name: "backfill",
     description: "Backfill semantic_scope + visibility_store on existing knowledge (repairs dirty layer)"
   },
   args: {
     store: { type: "string", description: "Backfill a mounted store's knowledge" },
-    "dry-run": { type: "boolean", description: "Preview changes without writing" }
+    "dry-run": { type: "boolean", description: "Preview changes without writing" },
+    yes: { type: "boolean", description: "Skip the confirm-before-mutate prompt (CI / non-interactive)" }
   },
-  run({ args }) {
+  async run({ args }) {
     const dryRun = args["dry-run"] === true;
     let knowledgeDir;
     let visibilityStore;
@@ -437,23 +493,43 @@ var backfillScopeCommand = defineCommand({
       knowledgeDir = join3(storeDir, STORE_LAYOUT2.knowledgeDir);
       visibilityStore = selectedStore;
     }
-    const report = backfillKnowledgeDir(knowledgeDir, { visibilityStore, dryRun });
-    if (report.changes.length === 0) {
-      console.log(`scope backfill: nothing to do (${report.unchanged} already consistent).`);
+    const printReport = (report, preview2) => {
+      if (report.changes.length === 0) {
+        console.log(`scope backfill: nothing to do (${report.unchanged} already consistent).`);
+        return;
+      }
+      console.log(
+        `${preview2 ? "[dry-run] " : ""}scope backfill: ${report.changes.length} entr${report.changes.length === 1 ? "y" : "ies"} updated, ${report.unchanged} unchanged.`
+      );
+      for (const c of report.changes) {
+        console.log(`  ${c.id ?? "(no id)"}  [${c.changed.join(", ")}]`);
+      }
+      const scopeAssigned = report.changes.filter((c) => c.changed.includes("semantic_scope")).length;
+      if (scopeAssigned > 0) {
+        console.error(
+          `${preview2 ? "[dry-run] " : ""}note: ${scopeAssigned} entr${scopeAssigned === 1 ? "y" : "ies"} defaulted to semantic_scope: team. Demote project-specific ones with \`fabric store migrate scope <store> --to project:<id> --id <id>\`.`
+        );
+      }
+    };
+    if (dryRun) {
+      printReport(backfillKnowledgeDir(knowledgeDir, { visibilityStore, dryRun: true }), true);
       return;
     }
-    console.log(
-      `${dryRun ? "[dry-run] " : ""}scope backfill: ${report.changes.length} entr${report.changes.length === 1 ? "y" : "ies"} updated, ${report.unchanged} unchanged.`
-    );
-    for (const c of report.changes) {
-      console.log(`  ${c.id ?? "(no id)"}  [${c.changed.join(", ")}]`);
+    const preview = backfillKnowledgeDir(knowledgeDir, { visibilityStore, dryRun: true });
+    if (preview.changes.length === 0) {
+      printReport(preview, false);
+      return;
     }
-    const scopeAssigned = report.changes.filter((c) => c.changed.includes("semantic_scope")).length;
-    if (scopeAssigned > 0) {
-      console.error(
-        `${dryRun ? "[dry-run] " : ""}note: ${scopeAssigned} entr${scopeAssigned === 1 ? "y" : "ies"} defaulted to semantic_scope: team. Demote project-specific ones with \`fabric store re-scope <store> --to project:<id> --id <id>\`.`
-      );
+    const decision = await resolveStoreMutationConsent({
+      label: "migrate backfill",
+      count: preview.changes.length,
+      yes: args.yes === true
+    });
+    if (decision === "abort") {
+      process.exitCode = 1;
+      return;
     }
+    printReport(backfillKnowledgeDir(knowledgeDir, { visibilityStore, dryRun: false }), false);
   }
 });
 function resolveStoreDirAndVisibility(aliasOrUuid) {
@@ -488,7 +564,7 @@ function printRescopeReport(report) {
 }
 var rescopeCommand = defineCommand({
   meta: {
-    name: "re-scope",
+    name: "scope",
     description: "Rewrite knowledge entries' semantic_scope coordinate in a store"
   },
   args: {
@@ -496,7 +572,8 @@ var rescopeCommand = defineCommand({
     to: { type: "string", required: true, description: "New semantic_scope (e.g. team, project:alpha)" },
     id: { type: "string", description: "Only the entry with this stable_id" },
     from: { type: "string", description: "Only entries currently at this semantic_scope" },
-    "dry-run": { type: "boolean", description: "Preview changes without writing" }
+    "dry-run": { type: "boolean", description: "Preview changes without writing" },
+    yes: { type: "boolean", description: "Skip the confirm-before-mutate prompt (CI / non-interactive)" }
   },
   async run({ args }) {
     const resolved = resolveStoreDirAndVisibility(args.store);
@@ -505,14 +582,18 @@ var rescopeCommand = defineCommand({
       process.exitCode = 1;
       return;
     }
-    printRescopeReport(
-      await rescopeStore(resolved.dir, args.to, {
+    await runGatedMigrate({
+      label: "migrate scope",
+      dryRun: args["dry-run"] === true,
+      yes: args.yes === true,
+      run: (dryRun) => rescopeStore(resolved.dir, args.to, {
         id: args.id,
         fromScope: args.from,
         storeVisibility: resolved.visibility,
-        dryRun: args["dry-run"] === true
-      })
-    );
+        dryRun
+      }),
+      print: printRescopeReport
+    });
   }
 });
 var promoteCommand = defineCommand({
@@ -523,7 +604,8 @@ var promoteCommand = defineCommand({
   args: {
     store: { type: "positional", required: true, description: "Target store alias or uuid" },
     project: { type: "string", description: "Only this project's entries (default: all project:*)" },
-    "dry-run": { type: "boolean", description: "Preview changes without writing" }
+    "dry-run": { type: "boolean", description: "Preview changes without writing" },
+    yes: { type: "boolean", description: "Skip the confirm-before-mutate prompt (CI / non-interactive)" }
   },
   async run({ args }) {
     const resolved = resolveStoreDirAndVisibility(args.store);
@@ -532,29 +614,45 @@ var promoteCommand = defineCommand({
       process.exitCode = 1;
       return;
     }
-    printRescopeReport(
-      await promoteProjectToTeam(resolved.dir, {
+    await runGatedMigrate({
+      label: "migrate promote",
+      dryRun: args["dry-run"] === true,
+      yes: args.yes === true,
+      run: (dryRun) => promoteProjectToTeam(resolved.dir, {
         projectId: args.project,
         storeVisibility: resolved.visibility,
-        dryRun: args["dry-run"] === true
-      })
-    );
+        dryRun
+      }),
+      print: printRescopeReport
+    });
+  }
+});
+var migrateCommand = defineCommand({
+  meta: { name: "migrate", description: "Rewrite knowledge entries' scope coordinates in a store" },
+  subCommands: {
+    scope: rescopeCommand,
+    promote: promoteCommand,
+    backfill: backfillScopeCommand
   }
 });
 var store_default = defineCommand({
   meta: { name: "store", description: "Manage mounted Fabric knowledge stores" },
+  // W3-E: subCommands ordered by value axis — registry (which stores exist) →
+  // project wiring (where this repo reads/writes) → knowledge migration →
+  // store-internal project registry.
   subCommands: {
+    // registry
+    mount: mountCommand,
     list: listCommand,
     create: createCommand,
-    add: addCommand,
     remove: removeCommand,
     explain: explainCommand,
+    // project wiring
     bind: bindCommand,
     "switch-write": switchWriteCommand,
-    "route-write": routeWriteCommand,
-    "backfill-scope": backfillScopeCommand,
-    "re-scope": rescopeCommand,
-    promote: promoteCommand,
+    // knowledge migration
+    migrate: migrateCommand,
+    // store-internal projects
     project: projectCommand
   }
 });

package/dist/{sync-DT5UJMMR.js → sync-3XCIRDPK.js}

@@ -1,12 +1,11 @@
 #!/usr/bin/env node
 import {
   paint
-} from "./chunk-NLNH64A3.js";
+} from "./chunk-SL77FXX7.js";
 import {
   regenerateBindingsSnapshot
-} from "./chunk-PTGQAZEW.js";
-import "./chunk-EOT63RDH.js";
-import "./chunk-QFIVFZRH.js";
+} from "./chunk-GGDVZCD6.js";
+import "./chunk-I5F5BHWI.js";
 import {
   loadGlobalConfig,
   resolveGlobalRoot

package/dist/{uninstall-IFN2KYBK.js → uninstall-BG4ML4FC.js}

@@ -7,18 +7,18 @@ import {
   HOOK_SCRIPT_DESTINATIONS,
   SKILL_DESTINATIONS,
   fabricAgentsSnapshotPath
-} from "./chunk-7ZDXBOOU.js";
-import {
-  createDebugLogger,
-  resolveDevMode
-} from "./chunk-WA3DYGSY.js";
+} from "./chunk-ACSMNX3V.js";
 import {
   detectClientSupports,
   resolveClients
 } from "./chunk-3IOLS5EK.js";
+import {
+  createDebugLogger,
+  resolveDevMode
+} from "./chunk-WA3DYGSY.js";
 import {
   paint
-} from "./chunk-NLNH64A3.js";
+} from "./chunk-SL77FXX7.js";
 import {
   t
 } from "./chunk-HORSMSZL.js";
@@ -38,7 +38,11 @@ import { dirname, join } from "path";
 import { atomicWriteJson, atomicWriteText } from "@fenglimg/fabric-shared/node/atomic-write";
 import { BOOTSTRAP_REGEX } from "@fenglimg/fabric-shared/templates/bootstrap-canonical";
 async function uninstallFabricRouterSkill(projectRoot) {
-  return removeSkill("skill-router", SKILL_DESTINATIONS.fabricRouter, projectRoot);
+  return removeSkill(
+    "skill-router",
+    [".claude/skills/fabric/SKILL.md", ".codex/skills/fabric/SKILL.md"],
+    projectRoot
+  );
 }
 async function uninstallFabricArchiveSkill(projectRoot) {
   return removeSkill("skill", SKILL_DESTINATIONS.fabricArchive, projectRoot);
@@ -47,16 +51,28 @@ async function uninstallFabricReviewSkill(projectRoot) {
   return removeSkill("skill-review", SKILL_DESTINATIONS.fabricReview, projectRoot);
 }
 async function uninstallFabricImportSkill(projectRoot) {
-  return removeSkill("skill-import", SKILL_DESTINATIONS.fabricImport, projectRoot);
+  return removeSkill(
+    "skill-import",
+    [".claude/skills/fabric-import/SKILL.md", ".codex/skills/fabric-import/SKILL.md"],
+    projectRoot
+  );
 }
 async function uninstallFabricSyncSkill(projectRoot) {
   return removeSkill("skill-sync", SKILL_DESTINATIONS.fabricSync, projectRoot);
 }
 async function uninstallFabricAuditSkill(projectRoot) {
-  return removeSkill("skill-audit", SKILL_DESTINATIONS.fabricAudit, projectRoot);
+  return removeSkill(
+    "skill-audit",
+    [".claude/skills/fabric-audit/SKILL.md", ".codex/skills/fabric-audit/SKILL.md"],
+    projectRoot
+  );
 }
 async function uninstallFabricConnectSkill(projectRoot) {
-  return removeSkill("skill-connect", SKILL_DESTINATIONS.fabricConnect, projectRoot);
+  return removeSkill(
+    "skill-connect",
+    [".claude/skills/fabric-connect/SKILL.md", ".codex/skills/fabric-connect/SKILL.md"],
+    projectRoot
+  );
 }
 async function removeSkill(step, rels, projectRoot) {
   const results = [];
@@ -91,6 +107,13 @@ async function removeCitePolicyEvictHook(projectRoot) {
     projectRoot
   );
 }
+async function removeKnowledgePretoolUseHook(projectRoot) {
+  return removeHookScripts(
+    "hook-pretooluse-script",
+    HOOK_SCRIPT_DESTINATIONS.knowledgePretoolUse,
+    projectRoot
+  );
+}
 async function removeSessionEndMarkerHook(projectRoot) {
   return removeHookScripts(
     "hook-session-end-script",
@@ -300,6 +323,12 @@ async function uninstallBootstrapStage(projectRoot, _opts = {}) {
     projectRoot,
     () => removeCitePolicyEvictHook(projectRoot)
   );
+  await runAndCollect(
+    results,
+    "hook-pretooluse-script",
+    projectRoot,
+    () => removeKnowledgePretoolUseHook(projectRoot)
+  );
   await runAndCollect(
     results,
     "hook-session-end-script",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fenglimg/fabric-cli",
-  "version": "2.2.0",
+  "version": "2.3.0-rc.1",
   "description": "Fabric CLI — installs the MCP server + skills + hooks for Claude Code and Codex CLI; runs doctor / knowledge maintenance.",
   "license": "MIT",
   "author": "wangzhichao <fenglimg90@gmail.com>",
@@ -39,19 +39,15 @@
   "dependencies": {
     "@clack/prompts": "^1.2.0",
     "citty": "^0.2.2",
-    "ink": "^4.4.1",
-    "picocolors": "^1.1.1",
-    "react": "^18.3.1",
     "string-width": "^7.2.0",
     "tree-sitter-javascript": "^0.25.0",
     "tree-sitter-typescript": "^0.23.2",
     "web-tree-sitter": "^0.26.8",
-    "@fenglimg/fabric-server": "2.2.0",
-    "@fenglimg/fabric-shared": "2.2.0"
+    "@fenglimg/fabric-server": "2.3.0-rc.1",
+    "@fenglimg/fabric-shared": "2.3.0-rc.1"
   },
   "devDependencies": {
     "@types/node": "^22.15.0",
-    "@types/react": "^18.3.12",
     "tsup": "^8.5.0",
     "typescript": "^5.8.3"
   },

package/templates/hooks/cite-policy-evict.cjs

@@ -385,7 +385,7 @@ function renderNudge(editPaths) {
     `[fabric cite] 改 ${target} 前未检测到相关 fab_recall —`,
     "建议先调 fab_recall(paths=[<被改文件>]) 让系统自动记账引用的 KB(无需手写首行 KB:)。",
     "已 recall 过可忽略本提示。仍可手写首行 `KB: <id> [applied]` 显式 override。",
-    "(nudge only — 不阻塞本次编辑;cite 覆盖率见 fabric doctor --cite-coverage)",
+    "(nudge only — 不阻塞本次编辑;cite 覆盖率见 fabric audit cite)",
   ].join("\n");
 }
 

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

@@ -28,11 +28,7 @@
         "hooks": [
           {
             "type": "command",
-            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/knowledge-hint-narrow.cjs"
-          },
-          {
-            "type": "command",
-            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/cite-policy-evict.cjs"
+            "command": "${CLAUDE_PROJECT_DIR}/.claude/hooks/knowledge-pretooluse.cjs"
           }
         ]
       }

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

@@ -13,11 +13,7 @@
     "PreToolUse": [
       {
         "matcher": "Edit|Write|MultiEdit|apply_patch",
-        "command": "\"$(git rev-parse --show-toplevel)/.codex/hooks/knowledge-hint-narrow.cjs\""
-      },
-      {
-        "matcher": "Edit|Write|MultiEdit|apply_patch",
-        "command": "\"$(git rev-parse --show-toplevel)/.codex/hooks/cite-policy-evict.cjs\""
+        "command": "\"$(git rev-parse --show-toplevel)/.codex/hooks/knowledge-pretooluse.cjs\""
       }
     ],
     "PostToolUse": [