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

package/dist/{install-74ANPCCP.js → install-BULNDUIM.js}

@@ -13,6 +13,8 @@ import {
   installHookLibs,
   installKnowledgeHintBroadHook,
   installKnowledgeHintNarrowHook,
+  installPostTooluseMutationHook,
+  installSessionEndMarkerHook,
   installSharedSkillLib,
   mergeClaudeCodeHookConfig,
   mergeCodexHookConfig,
@@ -22,7 +24,7 @@ import {
   writeCodexBootstrapManagedBlock,
   writeCursorBootstrapManagedBlock,
   writeFabricAgentsSnapshot
-} from "./chunk-2R55HNVD.js";
+} from "./chunk-XHHCRDIR.js";
 import {
   displayWidth,
   padEnd,
@@ -34,7 +36,7 @@ import {
 } from "./chunk-COI5VDFU.js";
 import {
   installMcpClients
-} from "./chunk-AOE6AYI7.js";
+} from "./chunk-F6ITRM7T.js";
 import {
   detectClientSupports
 } from "./chunk-XC5RUHLK.js";
@@ -42,19 +44,23 @@ import {
   getProjectTranslator,
   t
 } from "./chunk-2CY4BMTH.js";
+import {
+  syncStoreAliasLinks,
+  unboundAvailableStores
+} from "./chunk-5ZUMLCD5.js";
 import {
   globalConfigPath,
   loadGlobalConfig,
   resolveGlobalRoot,
   saveGlobalConfig
-} from "./chunk-RYAFBNES.js";
+} from "./chunk-XCBVSGCS.js";
 
 // src/commands/install.ts
 import { randomUUID as randomUUID2 } from "crypto";
 import { homedir } from "os";
 import * as childProcess from "child_process";
-import { appendFileSync, existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync3, rmSync as rmSync2, statSync as statSync4, writeFileSync } from "fs";
-import { dirname, isAbsolute as isAbsolute3, join as join6, resolve as resolve3 } from "path";
+import { appendFileSync, existsSync as existsSync5, mkdirSync as mkdirSync2, readFileSync as readFileSync4, rmSync as rmSync2, statSync as statSync4, writeFileSync as writeFileSync2 } from "fs";
+import { dirname, isAbsolute as isAbsolute3, join as join7, resolve as resolve3 } from "path";
 import { cancel, confirm, group, intro, isCancel, log, note, outro, select } from "@clack/prompts";
 import { defaultAgentsMetaCounters } from "@fenglimg/fabric-shared";
 import { atomicWriteJson } from "@fenglimg/fabric-shared/node/atomic-write";
@@ -79,6 +85,8 @@ async function installHooks(target, _options = {}) {
   results.push(...await runStep(() => installKnowledgeHintBroadHook(normalizedTarget)));
   results.push(...await runStep(() => installKnowledgeHintNarrowHook(normalizedTarget)));
   results.push(...await runStep(() => installCitePolicyEvictHook(normalizedTarget)));
+  results.push(...await runStep(() => installSessionEndMarkerHook(normalizedTarget)));
+  results.push(...await runStep(() => installPostTooluseMutationHook(normalizedTarget)));
   results.push(...await runStep(() => installHookLibs(normalizedTarget)));
   results.push(await runSingleStep("claude-hook-config", () => mergeClaudeCodeHookConfig(normalizedTarget)));
   results.push(await runSingleStep("codex-hook-config", () => mergeCodexHookConfig(normalizedTarget)));
@@ -94,7 +102,10 @@ function validateHookPaths(projectRoot) {
   const scripts = [
     { stepSuffix: "", hookFile: "fabric-hint.cjs" },
     { stepSuffix: "-broad", hookFile: "knowledge-hint-broad.cjs" },
-    { stepSuffix: "-narrow", hookFile: "knowledge-hint-narrow.cjs" }
+    { stepSuffix: "-narrow", hookFile: "knowledge-hint-narrow.cjs" },
+    // lifecycle-refactor W2-T2/T3: SessionEnd + PostToolUse marker hooks.
+    { stepSuffix: "-session-end", hookFile: "session-end-marker.cjs" },
+    { stepSuffix: "-post-tooluse", hookFile: "post-tooluse-mutation.cjs" }
   ];
   const clients = [
     {
@@ -197,12 +208,50 @@ function assertExistingDirectory(target) {
   }
 }
 
+// src/install/semantic-search.ts
+import { existsSync as existsSync2, readFileSync, writeFileSync } from "fs";
+import { join as join2 } from "path";
+var DEFAULT_EMBED_MODEL_PIN = "fast-bge-small-zh-v1.5";
+function enableSemanticSearch(projectRoot, opts = {}) {
+  const model = typeof opts.model === "string" && opts.model.length > 0 ? opts.model : DEFAULT_EMBED_MODEL_PIN;
+  const configPath = join2(projectRoot, "fabric.config.json");
+  let existing = {};
+  if (existsSync2(configPath)) {
+    try {
+      const parsed = JSON.parse(readFileSync(configPath, "utf8"));
+      if (parsed !== null && typeof parsed === "object" && !Array.isArray(parsed)) {
+        existing = parsed;
+      }
+    } catch {
+      existing = {};
+    }
+  }
+  const alreadyEnabled = existing.embed_enabled === true && existing.embed_model === model;
+  if (alreadyEnabled) {
+    return { configPath, model, alreadyEnabled: true, changed: false };
+  }
+  const merged = { ...existing, embed_enabled: true, embed_model: model };
+  writeFileSync(configPath, JSON.stringify(merged, null, 2) + "\n", "utf8");
+  return { configPath, model, alreadyEnabled: false, changed: true };
+}
+function renderSemanticSearchInstructions(model) {
+  return [
+    "\u8BED\u4E49\u641C\u7D22\u5DF2\u542F\u7528 (embed_enabled=true, embed_model=" + model + ")\u3002\u8FD8\u9700\u4E24\u6B65 (\u4E00\u6B21\u6027):",
+    "  1. \u5B89\u88C5\u53EF\u9009 embedder (\u88C5\u5230 MCP server \u89E3\u6790\u6A21\u5757\u7684\u4F4D\u7F6E \u2014 \u5168\u5C40\u5B89\u88C5\u5373\u5168\u5C40):",
+    "       npm i -g fastembed",
+    "  2. \u9884\u70ED\u6A21\u578B\u7F13\u5B58 (\u9996\u8DD1\u4F1A\u8054\u7F51\u4E0B\u8F7D\u6A21\u578B\u6743\u91CD ~\u6570\u5341-\u6570\u767E MB, \u4E0D\u4E0A\u4F20\u4EFB\u4F55 KB \u6570\u636E):",
+    "       export FABRIC_EMBED_CACHE_DIR=~/.cache/fabric-embed   # \u4E25\u683C\u79BB\u7EBF\u8005\u9884\u5148\u653E\u597D\u6743\u91CD",
+    "  \u6CE8: \u5207\u6362 embed_model \u540E\u5DF2\u6709\u5411\u91CF\u7EF4\u5EA6/\u8BED\u4E49\u53D8\u5316, \u4E0B\u6B21 recall \u4F1A\u6309\u65B0\u6A21\u578B\u91CD\u65B0\u5D4C\u5165 (doc \u5411\u91CF\u6309\u6587\u672C\u7F13\u5B58, \u81EA\u52A8\u5931\u914D\u91CD\u7B97)\u3002",
+    "  \u5173\u95ED: \u7F16\u8F91 fabric.config.json \u8BBE embed_enabled=false\u3002"
+  ];
+}
+
 // src/install/run-global-install.ts
 import { execFileSync as execFileSync2 } from "child_process";
 import { randomUUID } from "crypto";
 import { mkdirSync, mkdtempSync, renameSync } from "fs";
 import { tmpdir } from "os";
-import { join as join3 } from "path";
+import { join as join4 } from "path";
 import { STORES_ROOT_DIR as STORES_ROOT_DIR2, addMountedStore, readStoreIdentity } from "@fenglimg/fabric-shared";
 import { GenericIOError } from "@fenglimg/fabric-shared/errors";
 
@@ -229,7 +278,7 @@ function deriveUid(opts = {}) {
 
 // src/install/install-global.ts
 import { rmSync } from "fs";
-import { join as join2 } from "path";
+import { join as join3 } from "path";
 import {
   STORES_ROOT_DIR,
   globalConfigSchema,
@@ -288,7 +337,7 @@ async function installGlobalCore(options) {
     };
   }
   const alias = options.personalAlias ?? "personal";
-  const personalDir = join2(options.globalRoot, STORES_ROOT_DIR, options.personalStoreUuid);
+  const personalDir = join3(options.globalRoot, STORES_ROOT_DIR, options.personalStoreUuid);
   let config = null;
   const receipt = await runInstallTransaction([
     {
@@ -339,10 +388,10 @@ function gitClone(url, dest) {
   }
 }
 function mountStoreFromRemote(url, globalRoot) {
-  const storesRoot = join3(globalRoot, STORES_ROOT_DIR2);
+  const storesRoot = join4(globalRoot, STORES_ROOT_DIR2);
   mkdirSync(storesRoot, { recursive: true });
-  const tmp = mkdtempSync(join3(tmpdir(), "fabric-clone-"));
-  const cloneDest = join3(tmp, "store");
+  const tmp = mkdtempSync(join4(tmpdir(), "fabric-clone-"));
+  const cloneDest = join4(tmp, "store");
   gitClone(url, cloneDest);
   const identity = readStoreIdentity(cloneDest);
   if (identity === null) {
@@ -350,7 +399,7 @@ function mountStoreFromRemote(url, globalRoot) {
       actionHint: "verify the url points to a repository created by `fabric` (it must contain a store.json at its root); if you meant to mount a different store, re-run with the correct url"
     });
   }
-  const finalDir = join3(storesRoot, identity.store_uuid);
+  const finalDir = join4(storesRoot, identity.store_uuid);
   renameSync(cloneDest, finalDir);
   const config = loadGlobalConfig(globalRoot);
   if (config === null) {
@@ -384,23 +433,24 @@ async function runGlobalInstall(options = {}, globalRoot = resolveGlobalRoot())
   if (options.url !== void 0) {
     mountStoreFromRemote(options.url, globalRoot);
   }
+  syncStoreAliasLinks(globalRoot);
 }
 
 // src/lib/detect-language.ts
-import { existsSync as existsSync2, readdirSync, readFileSync, statSync as statSync2 } from "fs";
-import { join as join4 } from "path";
+import { existsSync as existsSync3, readdirSync, readFileSync as readFileSync2, statSync as statSync2 } from "fs";
+import { join as join5 } from "path";
 function detectExistingLanguage(target) {
   const ZH_CN_RATIO_THRESHOLD = 0.3;
   const samples = [];
-  const readmePath = join4(target, "README.md");
-  if (existsSync2(readmePath)) {
+  const readmePath = join5(target, "README.md");
+  if (existsSync3(readmePath)) {
     try {
-      samples.push(readFileSync(readmePath, "utf8"));
+      samples.push(readFileSync2(readmePath, "utf8"));
     } catch {
     }
   }
-  const docsDir = join4(target, "docs");
-  if (existsSync2(docsDir)) {
+  const docsDir = join5(target, "docs");
+  if (existsSync3(docsDir)) {
     try {
       const stat = statSync2(docsDir);
       if (stat.isDirectory()) {
@@ -408,7 +458,7 @@ function detectExistingLanguage(target) {
           if (!entry.isFile()) continue;
           if (!/\.(md|mdx|txt)$/iu.test(entry.name)) continue;
           try {
-            samples.push(readFileSync(join4(docsDir, entry.name), "utf8"));
+            samples.push(readFileSync2(join5(docsDir, entry.name), "utf8"));
           } catch {
           }
         }
@@ -441,9 +491,9 @@ function detectExistingLanguage(target) {
 
 // src/scanner/forensic.ts
 import { execFileSync as execFileSync3 } from "child_process";
-import { existsSync as existsSync3, readdirSync as readdirSync2, readFileSync as readFileSync2, statSync as statSync3 } from "fs";
+import { existsSync as existsSync4, readdirSync as readdirSync2, readFileSync as readFileSync3, statSync as statSync3 } from "fs";
 import { createRequire } from "module";
-import { basename, extname, isAbsolute as isAbsolute2, join as join5, posix, relative, resolve as resolve2, sep } from "path";
+import { basename, extname, isAbsolute as isAbsolute2, join as join6, posix, relative, resolve as resolve2, sep } from "path";
 import {
   buildScanRecommendations,
   forensicReportSchema
@@ -588,7 +638,7 @@ function buildTopology(root) {
       continue;
     }
     for (const entry of readdirSync2(current, { withFileTypes: true })) {
-      const absolutePath = join5(current, entry.name);
+      const absolutePath = join6(current, entry.name);
       const relativePath = toPosixPath(relative(root, absolutePath));
       if (relativePath.length === 0) {
         continue;
@@ -627,7 +677,7 @@ function buildTopology(root) {
   };
 }
 function assertExistingDirectory2(target) {
-  if (!existsSync3(target) || !statSync3(target).isDirectory()) {
+  if (!existsSync4(target) || !statSync3(target).isDirectory()) {
     throw new Error(`Target must be an existing directory: ${target}`);
   }
 }
@@ -676,7 +726,7 @@ function getEntryPointReason(relativePath) {
 async function buildCodeSamples(target, entryPoints, frameworkKind, topology, packageDependencies) {
   const samples = [];
   for (const entryPoint of entryPoints.slice(0, SAMPLE_LIMIT)) {
-    const absolutePath = join5(target, ...entryPoint.path.split("/"));
+    const absolutePath = join6(target, ...entryPoint.path.split("/"));
     const sample = readFirstLines(absolutePath, SAMPLE_LINE_LIMIT);
     const patternAnalysis = await inferPatternHint(entryPoint.path, sample.snippet, {
       frameworkKind,
@@ -696,7 +746,7 @@ async function buildCodeSamples(target, entryPoints, frameworkKind, topology, pa
 }
 function readFirstLines(path, lineLimit) {
   try {
-    const lines = readFileSync2(path, "utf8").split(/\r?\n/);
+    const lines = readFileSync3(path, "utf8").split(/\r?\n/);
     if (lines.at(-1) === "") {
       lines.pop();
     }
@@ -713,12 +763,12 @@ function readFirstLines(path, lineLimit) {
   }
 }
 function readPackageDependencies(target) {
-  const packageJsonPath = join5(target, "package.json");
-  if (!existsSync3(packageJsonPath)) {
+  const packageJsonPath = join6(target, "package.json");
+  if (!existsSync4(packageJsonPath)) {
     return /* @__PURE__ */ new Map();
   }
   try {
-    const packageJson = JSON.parse(readFileSync2(packageJsonPath, "utf8"));
+    const packageJson = JSON.parse(readFileSync3(packageJsonPath, "utf8"));
     return new Map([
       ...Object.entries(packageJson.dependencies ?? {}),
       ...Object.entries(packageJson.devDependencies ?? {}),
@@ -1054,16 +1104,16 @@ function scoreFrameworkConfidence(input) {
   return input.configCount > 0 || input.packageCount > 0 ? "MEDIUM" : "LOW";
 }
 function readReadmeInfo(target) {
-  const readmePath = join5(target, "README.md");
-  const hasContributing = existsSync3(join5(target, "CONTRIBUTING.md"));
-  if (!existsSync3(readmePath)) {
+  const readmePath = join6(target, "README.md");
+  const hasContributing = existsSync4(join6(target, "CONTRIBUTING.md"));
+  if (!existsSync4(readmePath)) {
     return {
       quality: "missing",
       line_count: 0,
       has_contributing: hasContributing
     };
   }
-  const readme = readFileSync2(readmePath, "utf8");
+  const readme = readFileSync3(readmePath, "utf8");
   const wordCount = readme.trim().split(/\s+/).filter(Boolean).length;
   return {
     quality: wordCount >= 200 ? "ok" : "stub",
@@ -1529,10 +1579,10 @@ function buildSkillRecommendations(frameworkKind, topology, readme, projectRoot)
   );
 }
 function readProjectName(target) {
-  const packageJsonPath = join5(target, "package.json");
-  if (existsSync3(packageJsonPath)) {
+  const packageJsonPath = join6(target, "package.json");
+  if (existsSync4(packageJsonPath)) {
     try {
-      const packageJson = JSON.parse(readFileSync2(packageJsonPath, "utf8"));
+      const packageJson = JSON.parse(readFileSync3(packageJsonPath, "utf8"));
       if (packageJson.name !== void 0 && packageJson.name.trim().length > 0) {
         return packageJson.name;
       }
@@ -1543,7 +1593,7 @@ function readProjectName(target) {
   return basename(target);
 }
 function getCliVersion() {
-  return true ? "2.2.0-rc.1" : "unknown";
+  return true ? "2.2.0-rc.3" : "unknown";
 }
 function sortRecord(record) {
   return Object.fromEntries(Object.entries(record).sort(([left], [right]) => left.localeCompare(right)));
@@ -1553,7 +1603,7 @@ function toPosixPath(path) {
 }
 
 // src/commands/install.ts
-var LOCAL_FABRIC_SERVER_PATH = join6("node_modules", "@fenglimg", "fabric-server", "dist", "index.js");
+var LOCAL_FABRIC_SERVER_PATH = join7("node_modules", "@fenglimg", "fabric-server", "dist", "index.js");
 var FABRIC_SERVER_PACKAGE = "@fenglimg/fabric-server";
 var INIT_WIZARD_GROUP_CANCELLED = /* @__PURE__ */ Symbol("init-wizard-group-cancelled");
 var installCommand = defineCommand({
@@ -1599,6 +1649,15 @@ var installCommand = defineCommand({
     url: {
       type: "string",
       description: "With --global: clone + mount this shared store remote"
+    },
+    "enable-embed": {
+      type: "boolean",
+      description: t("cli.install.args.enable-embed.description"),
+      default: false
+    },
+    "embed-model": {
+      type: "string",
+      description: t("cli.install.args.embed-model.description")
     }
   },
   async run({ args }) {
@@ -1608,8 +1667,8 @@ var installCommand = defineCommand({
 var install_default = installCommand;
 async function runSkillsOnlyRefresh(targetInput) {
   const target = normalizeTarget3(targetInput);
-  const metaPath = join6(target, ".fabric", "agents.meta.json");
-  if (!existsSync4(metaPath)) {
+  const metaPath = join7(target, ".fabric", "agents.meta.json");
+  if (!existsSync5(metaPath)) {
     const message = t("cli.install.force-skills-only.uninitialised.message");
     const hint = t("cli.install.force-skills-only.uninitialised.hint");
     process.stderr.write(`${message}
@@ -1656,8 +1715,8 @@ ${hint}
 }
 async function runHooksOnlyRefresh(targetInput) {
   const target = normalizeTarget3(targetInput);
-  const metaPath = join6(target, ".fabric", "agents.meta.json");
-  if (!existsSync4(metaPath)) {
+  const metaPath = join7(target, ".fabric", "agents.meta.json");
+  if (!existsSync5(metaPath)) {
     const message = t("cli.install.force-hooks-only.uninitialised.message");
     const hint = t("cli.install.force-hooks-only.uninitialised.hint");
     process.stderr.write(`${message}
@@ -1703,6 +1762,10 @@ async function runInitCommand(args) {
   for (const step of resolution.chain) {
     logger(step);
   }
+  if (loadGlobalConfig() === null) {
+    logger("no global Fabric config found \u2014 minting ~/.fabric (uid + personal store)");
+    await runGlobalInstall({});
+  }
   const supports = detectClientSupports(intent.target);
   const basePlan = await buildInitExecutionPlan({
     target: intent.target,
@@ -1723,6 +1786,27 @@ async function runInitCommand(args) {
     console.log(t("cli.install.next-steps"));
     console.log("");
     console.log(paint.muted("More: docs/surfaces.md explains when to use CLI vs Skill vs MCP."));
+    const unboundStores = unboundAvailableStores(resolution.target);
+    if (unboundStores.length > 0) {
+      console.log("");
+      console.log(
+        t("cli.install.store-bind-nudge", {
+          aliases: unboundStores.map((s) => `'${s.alias}'`).join(", "),
+          first: unboundStores[0].alias
+        })
+      );
+    }
+    if (args["enable-embed"] === true) {
+      const enabled = enableSemanticSearch(resolution.target, { model: args["embed-model"] });
+      console.log("");
+      if (enabled.alreadyEnabled) {
+        console.log(paint.muted(`\u8BED\u4E49\u641C\u7D22\u5DF2\u662F\u542F\u7528\u72B6\u6001 (embed_model=${enabled.model})\uFF0C\u672A\u6539\u52A8 ${enabled.configPath}\u3002`));
+      } else {
+        for (const line of renderSemanticSearchInstructions(enabled.model)) {
+          console.log(line);
+        }
+      }
+    }
   }
   return result;
 }
@@ -1739,14 +1823,14 @@ var FABRIC_GITIGNORE_CONTENT = [
   ""
 ].join("\n");
 function writeDefaultGitignore(fabricDir) {
-  const target = join6(fabricDir, ".gitignore");
-  if (existsSync4(target)) return;
+  const target = join7(fabricDir, ".gitignore");
+  if (existsSync5(target)) return;
   mkdirSync2(fabricDir, { recursive: true });
-  writeFileSync(target, FABRIC_GITIGNORE_CONTENT, "utf8");
+  writeFileSync2(target, FABRIC_GITIGNORE_CONTENT, "utf8");
 }
 function writeDefaultFabricConfig(fabricDir, targetRoot) {
-  const target = join6(fabricDir, "fabric-config.json");
-  if (existsSync4(target)) return;
+  const target = join7(fabricDir, "fabric-config.json");
+  if (existsSync5(target)) return;
   const detectedLanguage = detectExistingLanguage(targetRoot);
   const FABRIC_CONFIG_DEFAULTS = {
     // Scan/import language policy. Fixated at init time by probing
@@ -1808,7 +1892,7 @@ function writeDefaultFabricConfig(fabricDir, targetRoot) {
     review_stale_pending_days: 14
   };
   mkdirSync2(fabricDir, { recursive: true });
-  writeFileSync(target, JSON.stringify(FABRIC_CONFIG_DEFAULTS, null, 2) + "\n", "utf8");
+  writeFileSync2(target, JSON.stringify(FABRIC_CONFIG_DEFAULTS, null, 2) + "\n", "utf8");
   log.info(
     `Detected and fixated fabric_language = ${detectedLanguage}; edit ${target} to override.`
   );
@@ -1885,7 +1969,7 @@ async function executeInitExecutionPlan(plan) {
       finalSupports: plan.supports
     };
   }
-  if (existsSync4(plan.scaffold.fabricDir) && !statSync4(plan.scaffold.fabricDir).isDirectory()) {
+  if (existsSync5(plan.scaffold.fabricDir) && !statSync4(plan.scaffold.fabricDir).isDirectory()) {
     throw new Error(
       t("cli.install.diff.drift-abort", { path: plan.scaffold.fabricDir })
     );
@@ -1938,16 +2022,16 @@ function resolvePersonalFabricRoot() {
 }
 async function buildInitFabricPlan(target, options) {
   assertExistingDirectory3(target);
-  const fabricDir = join6(target, ".fabric");
-  const agentsMdPath = join6(target, "AGENTS.md");
-  const agentsMdAction = existsSync4(agentsMdPath) ? "preserved" : "created";
-  const knowledgeDir = join6(fabricDir, "knowledge");
-  const personalKnowledgeDir = join6(resolvePersonalFabricRoot(), ".fabric", "knowledge");
-  const forensicPath = join6(fabricDir, "forensic.json");
-  const eventsPath = join6(fabricDir, "events.jsonl");
-  const metaPath = join6(fabricDir, "agents.meta.json");
+  const fabricDir = join7(target, ".fabric");
+  const agentsMdPath = join7(target, "AGENTS.md");
+  const agentsMdAction = existsSync5(agentsMdPath) ? "preserved" : "created";
+  const knowledgeDir = join7(fabricDir, "knowledge");
+  const personalKnowledgeDir = join7(resolvePersonalFabricRoot(), ".fabric", "knowledge");
+  const forensicPath = join7(fabricDir, "forensic.json");
+  const eventsPath = join7(fabricDir, "events.jsonl");
+  const metaPath = join7(fabricDir, "agents.meta.json");
   const replaceFabricDir = shouldReplaceWritableDirectory(fabricDir, options);
-  const knowledgeDirAction = existsSync4(knowledgeDir) ? "overwritten" : "created";
+  const knowledgeDirAction = existsSync5(knowledgeDir) ? "overwritten" : "created";
   const metaClassification = classifyFreshPath(metaPath, "structural");
   const eventsClassification = classifyFreshPath(eventsPath, "presence");
   const forensicClassification = classifyFreshPath(forensicPath, "always-rewrite");
@@ -1997,20 +2081,13 @@ async function executeInitFabricPlan(plan) {
   writeDefaultGitignore(plan.fabricDir);
   mkdirSync2(plan.knowledgeDir, { recursive: true });
   for (const sub of KNOWLEDGE_SUBDIRS) {
-    const teamSubDir = join6(plan.knowledgeDir, sub);
+    const teamSubDir = join7(plan.knowledgeDir, sub);
     mkdirSync2(teamSubDir, { recursive: true });
-    const teamGitkeep = join6(teamSubDir, ".gitkeep");
-    if (!existsSync4(teamGitkeep)) {
-      writeFileSync(teamGitkeep, "", "utf8");
+    const teamGitkeep = join7(teamSubDir, ".gitkeep");
+    if (!existsSync5(teamGitkeep)) {
+      writeFileSync2(teamGitkeep, "", "utf8");
     }
   }
-  try {
-    mkdirSync2(plan.personalKnowledgeDir, { recursive: true });
-    for (const sub of KNOWLEDGE_SUBDIRS) {
-      mkdirSync2(join6(plan.personalKnowledgeDir, sub), { recursive: true });
-    }
-  } catch {
-  }
   if (plan.metaState === "missing") {
     preparePlannedPath(plan.metaPath, plan.metaAction);
     await atomicWriteJson(plan.metaPath, plan.meta);
@@ -2018,11 +2095,11 @@ async function executeInitFabricPlan(plan) {
   if (plan.eventsState === "missing") {
     preparePlannedPath(plan.eventsPath, plan.eventsAction);
     mkdirSync2(dirname(plan.eventsPath), { recursive: true });
-    writeFileSync(plan.eventsPath, "", "utf8");
+    writeFileSync2(plan.eventsPath, "", "utf8");
   }
   preparePlannedPath(plan.forensicPath, plan.forensicAction);
   await atomicWriteJson(plan.forensicPath, plan.forensicReport);
-  if (existsSync4(plan.eventsPath)) {
+  if (existsSync5(plan.eventsPath)) {
     const applied = [];
     const canonical = [];
     const drifted = [];
@@ -2183,6 +2260,8 @@ async function executeInitStagePlan(plan, stageName) {
         installResults.push(...await runBestEffort("hook-broad-script", () => installKnowledgeHintBroadHook(plan.target)));
         installResults.push(...await runBestEffort("hook-narrow-script", () => installKnowledgeHintNarrowHook(plan.target)));
         installResults.push(...await runBestEffort("hook-cite-policy-evict-script", () => installCitePolicyEvictHook(plan.target)));
+        installResults.push(...await runBestEffort("hook-session-end-script", () => installSessionEndMarkerHook(plan.target)));
+        installResults.push(...await runBestEffort("hook-post-tooluse-script", () => installPostTooluseMutationHook(plan.target)));
         installResults.push(...await runBestEffort("hook-lib", () => installHookLibs(plan.target)));
         installResults.push(await runBestEffortSingle("claude-hook-config", () => mergeClaudeCodeHookConfig(plan.target)));
         installResults.push(await runBestEffortSingle("codex-hook-config", () => mergeCodexHookConfig(plan.target)));
@@ -2238,7 +2317,7 @@ async function executeInitStagePlan(plan, stageName) {
   }
 }
 function shouldReplaceWritableDirectory(path, _options) {
-  if (!existsSync4(path)) {
+  if (!existsSync5(path)) {
     return false;
   }
   if (statSync4(path).isDirectory()) {
@@ -2247,7 +2326,7 @@ function shouldReplaceWritableDirectory(path, _options) {
   return false;
 }
 function classifyFreshPath(path, strategy) {
-  if (!existsSync4(path)) {
+  if (!existsSync5(path)) {
     return { path, state: "missing" };
   }
   let stat;
@@ -2267,7 +2346,7 @@ function classifyFreshPath(path, strategy) {
     return { path, state: "present-canonical" };
   }
   try {
-    const raw = readFileSync3(path, "utf8");
+    const raw = readFileSync4(path, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
       return { path, state: "user-modified", reason: "not a JSON object" };
@@ -2296,7 +2375,7 @@ function formatDiffFileState(state) {
 }
 function preparePlannedPath(path, action) {
   mkdirSync2(dirname(path), { recursive: true });
-  if (action === "overwritten" && existsSync4(path)) {
+  if (action === "overwritten" && existsSync5(path)) {
     rmSync2(path, { recursive: true, force: true });
   }
 }
@@ -2450,19 +2529,19 @@ function normalizeTarget3(targetInput) {
   return isAbsolute3(targetInput) ? targetInput : resolve3(process.cwd(), targetInput);
 }
 function assertExistingDirectory3(target) {
-  if (!existsSync4(target) || !statSync4(target).isDirectory()) {
+  if (!existsSync5(target) || !statSync4(target).isDirectory()) {
     throw new Error(`Target must be an existing directory: ${target}`);
   }
 }
 function detectPackageManager(cwd) {
   const workspaceRoot = resolve3(cwd);
-  if (existsSync4(join6(workspaceRoot, "pnpm-lock.yaml"))) {
+  if (existsSync5(join7(workspaceRoot, "pnpm-lock.yaml"))) {
     return "pnpm";
   }
-  if (existsSync4(join6(workspaceRoot, "yarn.lock"))) {
+  if (existsSync5(join7(workspaceRoot, "yarn.lock"))) {
     return "yarn";
   }
-  if (existsSync4(join6(workspaceRoot, "package-lock.json"))) {
+  if (existsSync5(join7(workspaceRoot, "package-lock.json"))) {
     return "npm";
   }
   return "npm";

package/dist/{plan-context-hint-FC6P3WFE.js → plan-context-hint-CHVZGOZ5.js}

@@ -56,16 +56,29 @@ async function runPlanContextHint(opts) {
   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
+    paths: targetPaths,
+    // lifecycle-refactor W3-T2 (§7 图谱消费 / §5): default-enable graph二阶召回 for
+    // the hint path. planContext appends the one-hop `related` neighbours that
+    // ranked outside top_k of the surfaced set and reports them in
+    // `related_appended` (appended id → source id). Honest no-op when the
+    // surfaced set declares no in-corpus related edge.
+    include_related: true
   });
   const candidates = result.candidates;
-  const entries = candidates.map((item) => ({
-    id: item.stable_id,
-    type: item.description.knowledge_type ?? "",
-    maturity: item.description.maturity ?? "",
-    summary: item.description.summary,
-    relevance_scope: item.description.relevance_scope ?? "broad"
-  }));
+  const relatedAppended = result.related_appended ?? {};
+  const entries = candidates.map((item) => {
+    const relatedTo = relatedAppended[item.stable_id];
+    return {
+      id: item.stable_id,
+      type: item.description.knowledge_type ?? "",
+      maturity: item.description.maturity ?? "",
+      summary: item.description.summary,
+      relevance_scope: item.description.relevance_scope ?? "broad",
+      // Only set when this entry was pulled in via a graph edge — its presence
+      // is the honest signal, never synthesized for ordinarily-ranked entries.
+      ...typeof relatedTo === "string" ? { related_to: relatedTo } : {}
+    };
+  });
   let narrow_count = 0;
   let broad_only_count = 0;
   for (const e of entries) {

package/dist/{scope-explain-CDIZESP5.js → scope-explain-BWRWBCCP.js}

@@ -1,15 +1,14 @@
 #!/usr/bin/env node
 import {
   scopeExplain
-} from "./chunk-L4Q55UC4.js";
+} from "./chunk-EOT63RDH.js";
 import {
   getProjectTranslator
 } from "./chunk-2CY4BMTH.js";
-import "./chunk-LFIKMVY7.js";
-import "./chunk-RYAFBNES.js";
 
 // src/commands/scope-explain.ts
 import { defineCommand } from "citty";
+import { FabricError } from "@fenglimg/fabric-shared/errors";
 var scope_explain_default = defineCommand({
   meta: {
     name: "scope-explain",
@@ -24,7 +23,18 @@ var scope_explain_default = defineCommand({
   },
   run({ args }) {
     const projectRoot = process.cwd();
-    const result = scopeExplain(projectRoot, args.scope);
+    let result;
+    try {
+      result = scopeExplain(projectRoot, args.scope);
+    } catch (error) {
+      if (error instanceof FabricError) {
+        console.error(`${error.message}
+\u2192 ${error.actionHint}`);
+        process.exitCode = 1;
+        return;
+      }
+      throw error;
+    }
     if (result === null) {
       console.log(getProjectTranslator(projectRoot)("cli.cmd.no-global-config"));
       return;