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

package/dist/{install-74ANPCCP.js → install-7XJ64WSC.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,29 +36,40 @@ import {
 } from "./chunk-COI5VDFU.js";
 import {
   installMcpClients
-} from "./chunk-AOE6AYI7.js";
+} from "./chunk-F6ITRM7T.js";
 import {
   detectClientSupports
 } from "./chunk-XC5RUHLK.js";
+import {
+  regenerateBindingsSnapshot
+} from "./chunk-H3FE6VIK.js";
+import "./chunk-EOT63RDH.js";
 import {
   getProjectTranslator,
   t
 } from "./chunk-2CY4BMTH.js";
+import {
+  storeBind,
+  storeCreate,
+  storeList,
+  storeSwitchWrite,
+  syncStoreAliasLinks,
+  unboundAvailableStores
+} from "./chunk-5SSNE5GM.js";
 import {
   globalConfigPath,
   loadGlobalConfig,
+  loadProjectConfig,
   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 { cancel, confirm, group, intro, isCancel, log, note, outro, select } from "@clack/prompts";
-import { defaultAgentsMetaCounters } from "@fenglimg/fabric-shared";
+import { appendFileSync, existsSync as existsSync5, mkdirSync as mkdirSync2, 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, text } from "@clack/prompts";
 import { atomicWriteJson } from "@fenglimg/fabric-shared/node/atomic-write";
 import { defineCommand } from "citty";
 
@@ -79,6 +92,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 +109,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 +215,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 +285,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 +344,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 +395,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 +406,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) {
@@ -364,6 +420,7 @@ function mountStoreFromRemote(url, globalRoot) {
     globalRoot
   );
   console.log(`mounted store '${alias}' (${identity.store_uuid}) from ${url}`);
+  return { store_uuid: identity.store_uuid, alias };
 }
 async function runGlobalInstall(options = {}, globalRoot = resolveGlobalRoot()) {
   const uid = options.uid ?? deriveUid();
@@ -384,23 +441,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 +466,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 +499,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 +646,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 +685,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 +734,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 +754,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 +771,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 +1112,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 +1587,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 +1601,7 @@ function readProjectName(target) {
   return basename(target);
 }
 function getCliVersion() {
-  return true ? "2.2.0-rc.1" : "unknown";
+  return true ? "2.2.0-rc.4" : "unknown";
 }
 function sortRecord(record) {
   return Object.fromEntries(Object.entries(record).sort(([left], [right]) => left.localeCompare(right)));
@@ -1553,7 +1611,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({
@@ -1581,24 +1639,23 @@ var installCommand = defineCommand({
       description: t("cli.install.args.yes.description"),
       default: false
     },
-    "force-skills-only": {
+    global: {
       type: "boolean",
-      description: t("cli.install.args.force-skills-only.description"),
+      description: "Set up global Fabric (~/.fabric: uid + personal store + config)",
       default: false
     },
-    "force-hooks-only": {
-      type: "boolean",
-      description: t("cli.install.args.force-hooks-only.description"),
-      default: false
+    url: {
+      type: "string",
+      description: "Clone + mount a shared store remote. In a project install: also binds it to this project and sets it as the write target. With --global: mounts it machine-wide only."
     },
-    global: {
+    "enable-embed": {
       type: "boolean",
-      description: "Set up global Fabric (~/.fabric: uid + personal store + config)",
+      description: t("cli.install.args.enable-embed.description"),
       default: false
     },
-    url: {
+    "embed-model": {
       type: "string",
-      description: "With --global: clone + mount this shared store remote"
+      description: t("cli.install.args.embed-model.description")
     }
   },
   async run({ args }) {
@@ -1606,83 +1663,6 @@ 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 message = t("cli.install.force-skills-only.uninitialised.message");
-    const hint = t("cli.install.force-skills-only.uninitialised.hint");
-    process.stderr.write(`${message}
-${hint}
-`);
-    process.exitCode = 1;
-    return;
-  }
-  console.log(formatInitStageHeader(t("cli.install.force-skills-only.banner")));
-  const results = [];
-  results.push(...await cleanupDeprecatedSkills(target));
-  results.push(...await installFabricArchiveSkill(target));
-  results.push(...await installFabricReviewSkill(target));
-  results.push(...await installFabricImportSkill(target));
-  results.push(...await installFabricSyncSkill(target));
-  results.push(...await installFabricStoreSkill(target));
-  results.push(...await installFabricAuditSkill(target));
-  results.push(...await installFabricConnectSkill(target));
-  results.push(...await installSharedSkillLib(target));
-  let written = 0;
-  let skipped = 0;
-  let errors = 0;
-  for (const r of results) {
-    if (r.status === "written") written += 1;
-    else if (r.status === "skipped") skipped += 1;
-    else if (r.status === "error") errors += 1;
-  }
-  console.log(
-    t("cli.install.force-skills-only.summary", {
-      written: String(written),
-      skipped: String(skipped),
-      errors: String(errors)
-    })
-  );
-  if (errors > 0) {
-    for (const r of results) {
-      if (r.status === "error") {
-        process.stderr.write(`  ${r.step} ${r.path}: ${r.message ?? "error"}
-`);
-      }
-    }
-    process.exitCode = 1;
-  }
-}
-async function runHooksOnlyRefresh(targetInput) {
-  const target = normalizeTarget3(targetInput);
-  const metaPath = join6(target, ".fabric", "agents.meta.json");
-  if (!existsSync4(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}
-${hint}
-`);
-    process.exitCode = 1;
-    return;
-  }
-  console.log(formatInitStageHeader(t("cli.install.force-hooks-only.banner")));
-  const result = await installHooks(target);
-  console.log(
-    t("cli.install.force-hooks-only.summary", {
-      written: String(result.installed.length),
-      skipped: String(result.skipped.length),
-      errors: String(result.errors.length)
-    })
-  );
-  if (result.errors.length > 0) {
-    for (const err of result.errors) {
-      process.stderr.write(`  ${err}
-`);
-    }
-    process.exitCode = 1;
-  }
-}
 async function runInitCommand(args) {
   const logger = createDebugLogger(args.debug);
   if (args.global === true) {
@@ -1690,19 +1670,15 @@ async function runInitCommand(args) {
     return;
   }
   const resolution = resolveDevMode(args.target, process.cwd());
-  if (args["force-skills-only"] === true) {
-    await runSkillsOnlyRefresh(resolution.target);
-    return;
-  }
-  if (args["force-hooks-only"] === true) {
-    await runHooksOnlyRefresh(resolution.target);
-    return;
-  }
   const intent = resolveInitCliIntent(args, resolution.target);
   logger(`init target source: ${resolution.source}`);
   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,9 +1699,121 @@ 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."));
+    if (typeof args.url === "string" && args.url.length > 0) {
+      bindRemoteStoreToProject(resolution.target, args.url);
+    } else if (intent.wizardEnabled) {
+      await promptStoreOnboarding(resolution.target);
+    }
+    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) {
+      enableSemanticSearchAndReport(resolution.target, args["embed-model"]);
+    } else if (intent.wizardEnabled) {
+      await promptSemanticSearch(resolution.target);
+    }
   }
   return result;
 }
+function enableSemanticSearchAndReport(projectRoot, model) {
+  const enabled = enableSemanticSearch(projectRoot, model === void 0 ? {} : { 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`));
+    return;
+  }
+  for (const line of renderSemanticSearchInstructions(enabled.model)) {
+    console.log(line);
+  }
+}
+async function promptSemanticSearch(projectRoot) {
+  const enable = await confirm({
+    message: "Enable vector semantic search? (downloads an embedding model on first use)",
+    initialValue: false
+  });
+  if (isCancel(enable) || !enable) {
+    return;
+  }
+  enableSemanticSearchAndReport(projectRoot);
+}
+function bindRemoteStoreToProject(projectRoot, url, globalRoot = resolveGlobalRoot()) {
+  const already = storeList(globalRoot).find((store) => store.remote === url);
+  const mounted = already ?? mountStoreFromRemote(url, globalRoot);
+  storeBind(projectRoot, { id: mounted.alias, suggested_remote: url });
+  storeSwitchWrite(projectRoot, mounted.alias);
+  regenerateBindingsSnapshot(projectRoot, { now: (/* @__PURE__ */ new Date()).toISOString(), globalRoot });
+  console.log("");
+  console.log(
+    paint.success(
+      `bound store '${mounted.alias}' to this project and set it as the write target.`
+    )
+  );
+}
+function bindCreatedStoreToProject(projectRoot, alias, options = {}) {
+  const globalRoot = options.globalRoot ?? resolveGlobalRoot();
+  storeCreate(alias, (/* @__PURE__ */ new Date()).toISOString(), {
+    ...options.remote === void 0 ? {} : { remote: options.remote },
+    globalRoot
+  });
+  storeBind(
+    projectRoot,
+    options.remote === void 0 ? { id: alias } : { id: alias, suggested_remote: options.remote }
+  );
+  storeSwitchWrite(projectRoot, alias);
+  regenerateBindingsSnapshot(projectRoot, { now: (/* @__PURE__ */ new Date()).toISOString(), globalRoot });
+  console.log("");
+  console.log(
+    paint.success(
+      `created store '${alias}', bound it to this project, and set it as the write target.`
+    )
+  );
+}
+async function promptStoreOnboarding(projectRoot) {
+  const config = loadProjectConfig(projectRoot);
+  if (typeof config?.active_write_store === "string" && config.active_write_store.length > 0) {
+    return;
+  }
+  const choice = await select({
+    message: "Set up a team / shared knowledge store for this project?",
+    initialValue: "skip",
+    options: [
+      { value: "skip", label: "skip", hint: "personal store only (default)" },
+      { value: "join", label: "join existing", hint: "clone + bind a shared store from a git remote" },
+      { value: "create", label: "create new", hint: "start a fresh local store (optionally remote-backed)" }
+    ]
+  });
+  if (isCancel(choice) || choice === "skip") {
+    return;
+  }
+  if (choice === "join") {
+    const url = await text({
+      message: "Shared store git remote (url):",
+      placeholder: "git@github.com:org/knowledge.git"
+    });
+    if (isCancel(url) || typeof url !== "string" || url.length === 0) {
+      return;
+    }
+    bindRemoteStoreToProject(projectRoot, url);
+    return;
+  }
+  const alias = await text({ message: "Local alias for the new store:", initialValue: "team" });
+  if (isCancel(alias) || typeof alias !== "string" || alias.length === 0) {
+    return;
+  }
+  const remote = await text({
+    message: "Git remote to back it (optional \u2014 leave blank to skip):",
+    placeholder: "git@github.com:org/knowledge.git"
+  });
+  const remoteStr = !isCancel(remote) && typeof remote === "string" && remote.length > 0 ? remote : void 0;
+  bindCreatedStoreToProject(projectRoot, alias, remoteStr === void 0 ? {} : { remote: remoteStr });
+}
 var FABRIC_GITIGNORE_CONTENT = [
   "# Fabric per-dev activity ledgers & caches \u2014 auto-generated, not shared.",
   "# Managed by `fabric install`; edit freely (re-install never overwrites this).",
@@ -1739,14 +1827,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 +1896,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.`
   );
@@ -1871,7 +1959,6 @@ async function executeInitExecutionPlan(plan) {
     printInitPlanSummary(plan.target, plan.options, plan.mcpInstallMode, plan.supports);
   }
   const scaffoldStates = [
-    { path: plan.scaffold.metaPath, state: plan.scaffold.metaState },
     { path: plan.scaffold.eventsPath, state: plan.scaffold.eventsState },
     { path: plan.scaffold.forensicPath, state: plan.scaffold.forensicState }
   ];
@@ -1885,7 +1972,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 })
     );
@@ -1932,26 +2019,16 @@ async function executeInitExecutionPlan(plan) {
     finalSupports
   };
 }
-var KNOWLEDGE_SUBDIRS = ["decisions", "pitfalls", "guidelines", "models", "processes", "pending"];
-function resolvePersonalFabricRoot() {
-  return process.env.FABRIC_HOME ?? homedir();
-}
 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 forensicPath = join7(fabricDir, "forensic.json");
+  const eventsPath = join7(fabricDir, "events.jsonl");
   const replaceFabricDir = shouldReplaceWritableDirectory(fabricDir, options);
-  const knowledgeDirAction = existsSync4(knowledgeDir) ? "overwritten" : "created";
-  const metaClassification = classifyFreshPath(metaPath, "structural");
   const eventsClassification = classifyFreshPath(eventsPath, "presence");
   const forensicClassification = classifyFreshPath(forensicPath, "always-rewrite");
-  const metaAction = diffStateToWriteAction(metaClassification.state);
   const eventsAction = diffStateToWriteAction(eventsClassification.state);
   const forensicAction = diffStateToWriteAction(forensicClassification.state);
   const showScanProgress = process.stderr.isTTY === true;
@@ -1964,7 +2041,6 @@ async function buildInitFabricPlan(target, options) {
     process.stderr.write(`${t("cli.install.scan-complete")}
 `);
   }
-  const meta = createInitialMeta();
   return {
     target,
     options,
@@ -1972,18 +2048,11 @@ async function buildInitFabricPlan(target, options) {
     replaceFabricDir,
     agentsMdPath,
     agentsMdAction,
-    knowledgeDir,
-    knowledgeDirAction,
-    personalKnowledgeDir,
-    metaPath,
-    metaAction,
-    meta,
     eventsPath,
     eventsAction,
     forensicPath,
     forensicAction,
     forensicReport,
-    metaState: metaClassification.state,
     eventsState: eventsClassification.state,
     forensicState: forensicClassification.state
   };
@@ -1995,39 +2064,18 @@ async function executeInitFabricPlan(plan) {
   mkdirSync2(plan.fabricDir, { recursive: true });
   writeDefaultFabricConfig(plan.fabricDir, plan.target);
   writeDefaultGitignore(plan.fabricDir);
-  mkdirSync2(plan.knowledgeDir, { recursive: true });
-  for (const sub of KNOWLEDGE_SUBDIRS) {
-    const teamSubDir = join6(plan.knowledgeDir, sub);
-    mkdirSync2(teamSubDir, { recursive: true });
-    const teamGitkeep = join6(teamSubDir, ".gitkeep");
-    if (!existsSync4(teamGitkeep)) {
-      writeFileSync(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);
-  }
   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 = [];
     for (const entry of [
-      { path: plan.metaPath, state: plan.metaState },
       { path: plan.eventsPath, state: plan.eventsState },
       { path: plan.forensicPath, state: plan.forensicState }
     ]) {
@@ -2044,11 +2092,6 @@ async function executeInitFabricPlan(plan) {
   return {
     agentsMdPath: plan.agentsMdPath,
     agentsMdAction: plan.agentsMdAction,
-    knowledgeDir: plan.knowledgeDir,
-    knowledgeDirAction: plan.knowledgeDirAction,
-    personalKnowledgeDir: plan.personalKnowledgeDir,
-    metaPath: plan.metaPath,
-    metaAction: plan.metaAction,
     eventsPath: plan.eventsPath,
     eventsAction: plan.eventsAction,
     forensicPath: plan.forensicPath,
@@ -2098,8 +2141,6 @@ function exhaustiveInitStagePlan(value) {
 }
 function printInitScaffoldResult(created) {
   console.log(formatAgentsMdAction(created.agentsMdPath, created.agentsMdAction));
-  console.log(formatInitPathAction(created.knowledgeDir, created.knowledgeDirAction));
-  console.log(formatInitPathAction(created.metaPath, created.metaAction));
   console.log(formatInitPathAction(created.eventsPath, created.eventsAction));
   console.log(formatInitPathAction(created.forensicPath, created.forensicAction));
 }
@@ -2146,11 +2187,6 @@ function buildPlanOnlyScaffoldResult(plan) {
   return {
     agentsMdPath: plan.agentsMdPath,
     agentsMdAction: plan.agentsMdAction,
-    knowledgeDir: plan.knowledgeDir,
-    knowledgeDirAction: plan.knowledgeDirAction,
-    personalKnowledgeDir: plan.personalKnowledgeDir,
-    metaPath: plan.metaPath,
-    metaAction: plan.metaAction,
     eventsPath: plan.eventsPath,
     eventsAction: plan.eventsAction,
     forensicPath: plan.forensicPath,
@@ -2183,6 +2219,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 +2276,7 @@ async function executeInitStagePlan(plan, stageName) {
   }
 }
 function shouldReplaceWritableDirectory(path, _options) {
-  if (!existsSync4(path)) {
+  if (!existsSync5(path)) {
     return false;
   }
   if (statSync4(path).isDirectory()) {
@@ -2246,8 +2284,8 @@ function shouldReplaceWritableDirectory(path, _options) {
   }
   return false;
 }
-function classifyFreshPath(path, strategy) {
-  if (!existsSync4(path)) {
+function classifyFreshPath(path, _strategy) {
+  if (!existsSync5(path)) {
     return { path, state: "missing" };
   }
   let stat;
@@ -2263,30 +2301,7 @@ function classifyFreshPath(path, strategy) {
   if (!stat.isFile()) {
     return { path, state: "user-modified", reason: "expected a file" };
   }
-  if (strategy === "presence" || strategy === "always-rewrite") {
-    return { path, state: "present-canonical" };
-  }
-  try {
-    const raw = readFileSync3(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" };
-    }
-    const record = parsed;
-    const hasRevision = typeof record["revision"] === "string";
-    const hasNodes = record["nodes"] !== void 0 && record["nodes"] !== null && typeof record["nodes"] === "object" && !Array.isArray(record["nodes"]);
-    const hasCounters = record["counters"] !== void 0 && record["counters"] !== null && typeof record["counters"] === "object" && !Array.isArray(record["counters"]);
-    if (!hasRevision || !hasNodes || !hasCounters) {
-      return { path, state: "drifted", reason: "missing required AgentsMeta fields" };
-    }
-    return { path, state: "present-canonical" };
-  } catch (error) {
-    return {
-      path,
-      state: "user-modified",
-      reason: error instanceof Error ? error.message : String(error)
-    };
-  }
+  return { path, state: "present-canonical" };
 }
 function diffStateToWriteAction(_state) {
   return "created";
@@ -2296,7 +2311,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 +2465,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";
@@ -2475,13 +2490,6 @@ function installLocalFabricServer(target, manager) {
     shell: process.platform === "win32"
   });
 }
-function createInitialMeta() {
-  return {
-    revision: "sha256:initial",
-    nodes: {},
-    counters: defaultAgentsMetaCounters()
-  };
-}
 function appendInstallDiffLedgerEvent(eventsPath, payload) {
   const event = {
     kind: "fabric-event",
@@ -2573,8 +2581,6 @@ function printInitPlanSummary(target, options, mcpInstallMode, supports) {
     })
   );
   console.log(t("cli.install.plan.writes"));
-  console.log(`  - ${target}/.fabric/knowledge/{decisions,pitfalls,guidelines,models,processes,pending}/`);
-  console.log(`  - ${target}/.fabric/agents.meta.json`);
   console.log(`  - ${target}/.fabric/events.jsonl`);
   console.log(`  - ${target}/.fabric/forensic.json`);
   console.log(`  - ${target}/.fabric/fabric-config.json`);
@@ -2720,6 +2726,8 @@ function writeStderr(message) {
 `);
 }
 export {
+  bindCreatedStoreToProject,
+  bindRemoteStoreToProject,
   buildInitExecutionPlan,
   buildInitFabricPlan,
   createDefaultInitWizardAdapter,
@@ -2730,8 +2738,6 @@ export {
   initFabric,
   installCommand,
   resolveInitExecutionPlanWithWizard,
-  runHooksOnlyRefresh,
   runInitCommand,
-  runSkillsOnlyRefresh,
   shouldUseInitWizard
 };