@fenglimg/fabric-cli 2.1.0-rc.2 → 2.2.0-rc.3

package/dist/{install-2HDO5FTQ.js → install-BULNDUIM.js}

@@ -4,12 +4,17 @@ import {
   installArchiveHintHook,
   installCitePolicyEvictHook,
   installFabricArchiveSkill,
+  installFabricAuditSkill,
+  installFabricConnectSkill,
   installFabricImportSkill,
   installFabricReviewSkill,
+  installFabricStoreSkill,
   installFabricSyncSkill,
   installHookLibs,
   installKnowledgeHintBroadHook,
   installKnowledgeHintNarrowHook,
+  installPostTooluseMutationHook,
+  installSessionEndMarkerHook,
   installSharedSkillLib,
   mergeClaudeCodeHookConfig,
   mergeCodexHookConfig,
@@ -19,38 +24,43 @@ import {
   writeCodexBootstrapManagedBlock,
   writeCursorBootstrapManagedBlock,
   writeFabricAgentsSnapshot
-} from "./chunk-F46ORPOA.js";
+} from "./chunk-XHHCRDIR.js";
 import {
   displayWidth,
   padEnd,
   paint
-} from "./chunk-WWNXR34K.js";
+} from "./chunk-BO4XIZWZ.js";
 import {
   createDebugLogger,
   resolveDevMode
 } from "./chunk-COI5VDFU.js";
 import {
   installMcpClients
-} from "./chunk-BATF4PEJ.js";
+} from "./chunk-F6ITRM7T.js";
 import {
   detectClientSupports
-} from "./chunk-MF3OTILQ.js";
+} from "./chunk-XC5RUHLK.js";
 import {
+  getProjectTranslator,
   t
-} from "./chunk-PWLW3B57.js";
+} 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";
@@ -67,11 +77,16 @@ async function installHooks(target, _options = {}) {
   results.push(...await runStep(() => installFabricReviewSkill(normalizedTarget)));
   results.push(...await runStep(() => installFabricImportSkill(normalizedTarget)));
   results.push(...await runStep(() => installFabricSyncSkill(normalizedTarget)));
+  results.push(...await runStep(() => installFabricStoreSkill(normalizedTarget)));
+  results.push(...await runStep(() => installFabricAuditSkill(normalizedTarget)));
+  results.push(...await runStep(() => installFabricConnectSkill(normalizedTarget)));
   results.push(...await runStep(() => installSharedSkillLib(normalizedTarget)));
   results.push(...await runStep(() => installArchiveHintHook(normalizedTarget)));
   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)));
@@ -87,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 = [
     {
@@ -190,18 +208,57 @@ 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";
 
 // src/store/uid.ts
 import { execFileSync } from "child_process";
 import { createHash } from "crypto";
-function deriveUid() {
+function deriveUid(opts = {}) {
   let email = "";
   try {
     email = execFileSync("git", ["config", "user.email"], {
@@ -214,13 +271,14 @@ function deriveUid() {
   if (email === "") {
     return "u-anon";
   }
-  const hash = createHash("sha256").update(email.toLowerCase()).digest("hex").slice(0, 12);
+  const material = opts.salt !== void 0 && opts.salt.length > 0 ? `${opts.salt}:${email.toLowerCase()}` : email.toLowerCase();
+  const hash = createHash("sha256").update(material).digest("hex").slice(0, 12);
   return `u-${hash}`;
 }
 
 // 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,
@@ -279,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([
     {
@@ -319,23 +377,35 @@ async function installGlobalCore(options) {
 
 // src/install/run-global-install.ts
 function gitClone(url, dest) {
-  execFileSync2("git", ["clone", url, dest], { stdio: ["ignore", "ignore", "pipe"] });
+  console.log(`cloning store from ${url} (this may take a while)\u2026`);
+  try {
+    execFileSync2("git", ["clone", "--", url, dest], { stdio: ["ignore", "ignore", "inherit"] });
+  } catch (error) {
+    throw new GenericIOError(`git clone of ${url} failed`, {
+      actionHint: "check the url is reachable and points to a Fabric store git repo (the git error above shows the cause), then re-run `fabric install --global <url>`",
+      details: error
+    });
+  }
 }
 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) {
-    throw new Error(`cloned store at ${url} has no valid store.json (not a Fabric store)`);
+    throw new GenericIOError(`cloned store at ${url} has no valid store.json (not a Fabric store)`, {
+      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) {
-    throw new Error("global config missing after install");
+    throw new GenericIOError("global config missing after install", {
+      actionHint: "re-run `fabric install --global` to (re)create the global config, then retry mounting the store; if it persists, inspect ~/.fabric for a partial install"
+    });
   }
   const alias = identity.canonical_alias ?? "team";
   saveGlobalConfig(
@@ -350,7 +420,12 @@ async function runGlobalInstall(options = {}, globalRoot = resolveGlobalRoot())
   const now = options.now ?? (/* @__PURE__ */ new Date()).toISOString();
   const result = await installGlobalCore({ globalRoot, uid, personalStoreUuid, now });
   if (!result.receipt.ok) {
-    throw new Error(`global install failed at step '${result.receipt.failedStep}': ${result.receipt.error}`);
+    throw new GenericIOError(
+      `global install failed at step '${result.receipt.failedStep}': ${result.receipt.error}`,
+      {
+        actionHint: "check write permissions and free space under ~/.fabric, then re-run `fabric install --global` (the install is transactional and rolls back partial state)"
+      }
+    );
   }
   console.log(
     result.alreadyInstalled ? "global Fabric already installed" : `installed global Fabric (uid ${uid})`
@@ -358,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()) {
@@ -382,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 {
           }
         }
@@ -415,10 +491,11 @@ 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
 } from "@fenglimg/fabric-shared";
 
@@ -536,7 +613,7 @@ async function buildForensicReport(targetInput) {
     candidate_files: candidateFiles,
     sampling_budget: DEFAULT_SAMPLING_BUDGET,
     readme,
-    recommendations_for_skill: buildSkillRecommendations(framework.kind, topology, readme)
+    recommendations_for_skill: buildSkillRecommendations(framework.kind, topology, readme, target)
   };
   const validation = forensicReportSchema.safeParse(report);
   if (!validation.success) {
@@ -561,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;
@@ -600,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}`);
   }
 }
@@ -649,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,
@@ -669,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();
     }
@@ -686,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 ?? {}),
@@ -1027,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",
@@ -1491,33 +1568,21 @@ function isDomainFile(relativePath) {
   }
   return !isConfigFile(relativePath) && !isTestFile(relativePath);
 }
-function buildSkillRecommendations(frameworkKind, topology, readme) {
-  const recommendations = [];
-  if (frameworkKind === "cocos-creator") {
-    recommendations.push("\u5EFA\u8BAE\u5411\u7528\u6237\u786E\u8BA4 Cocos Creator Component \u751F\u547D\u5468\u671F(onLoad/onEnable/start)\u987A\u5E8F\u3002");
-    recommendations.push("\u5EFA\u8BAE\u8BE2\u95EE assets/prefabs \u548C assets/scenes \u662F\u5426\u5C5E\u4E8E @HUMAN \u4FDD\u62A4\u533A\u57DF\u3002");
-    if ((topology.by_ext[".meta"] ?? 0) > 0) {
-      recommendations.push("\u68C0\u6D4B\u5230 .meta \u6587\u4EF6,\u5EFA\u8BAE\u5728 @HUMAN \u9501\u5B9A .meta \u4E0D\u88AB AI \u6539\u52A8\u3002");
-    }
-  } else if (frameworkKind === "next") {
-    recommendations.push("\u5EFA\u8BAE\u786E\u8BA4 app/pages \u8DEF\u7531\u8FB9\u754C\u548C\u670D\u52A1\u7AEF\u7EC4\u4EF6\u7EA6\u675F\u3002");
-  } else if (frameworkKind === "vite") {
-    recommendations.push("\u5EFA\u8BAE\u786E\u8BA4 src/main \u5165\u53E3\u3001\u7EC4\u4EF6\u76EE\u5F55\u548C\u6784\u5EFA\u811A\u672C\u7684\u7EF4\u62A4\u8FB9\u754C\u3002");
-  } else if (frameworkKind === "unknown") {
-    recommendations.push("\u672A\u68C0\u6D4B\u5230\u660E\u786E\u6846\u67B6,\u5EFA\u8BAE\u5148\u8BA9\u7528\u6237\u786E\u8BA4\u6280\u672F\u6808\u548C\u4E3B\u8981\u5165\u53E3\u3002");
-  } else {
-    recommendations.push(`\u5EFA\u8BAE\u56F4\u7ED5 ${frameworkKind} \u7684\u4E3B\u8981\u5165\u53E3\u548C\u751F\u6210\u76EE\u5F55\u786E\u8BA4 AGENTS.md \u5206\u5C42\u8FB9\u754C\u3002`);
-  }
-  if (readme.quality !== "ok") {
-    recommendations.push("README \u4FE1\u606F\u4E0D\u8DB3,\u5EFA\u8BAE\u5728\u521D\u59CB\u5316\u8BBF\u8C08\u4E2D\u8865\u9F50\u9879\u76EE\u76EE\u6807\u3001\u8FD0\u884C\u65B9\u5F0F\u548C\u7981\u6539\u533A\u57DF\u3002");
-  }
-  return recommendations;
+function buildSkillRecommendations(frameworkKind, topology, readme, projectRoot) {
+  return buildScanRecommendations(
+    {
+      frameworkKind,
+      hasMeta: (topology.by_ext[".meta"] ?? 0) > 0,
+      readmeOk: readme.quality === "ok"
+    },
+    getProjectTranslator(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;
       }
@@ -1528,7 +1593,7 @@ function readProjectName(target) {
   return basename(target);
 }
 function getCliVersion() {
-  return true ? "2.1.0-rc.2" : "unknown";
+  return true ? "2.2.0-rc.3" : "unknown";
 }
 function sortRecord(record) {
   return Object.fromEntries(Object.entries(record).sort(([left], [right]) => left.localeCompare(right)));
@@ -1538,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({
@@ -1584,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 }) {
@@ -1593,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}
@@ -1609,6 +1683,11 @@ ${hint}
   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;
@@ -1636,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}
@@ -1683,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,
@@ -1703,12 +1786,51 @@ 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;
 }
+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).",
+  "events.jsonl",
+  "metrics.jsonl",
+  "cite-rollup.jsonl",
+  "injections.jsonl",
+  ".cache/",
+  "*.lock",
+  "*.corrupted.*",
+  ""
+].join("\n");
+function writeDefaultGitignore(fabricDir) {
+  const target = join7(fabricDir, ".gitignore");
+  if (existsSync5(target)) return;
+  mkdirSync2(fabricDir, { recursive: true });
+  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
@@ -1770,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.`
   );
@@ -1847,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 })
     );
@@ -1900,23 +2022,32 @@ 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");
   const metaAction = diffStateToWriteAction(metaClassification.state);
   const eventsAction = diffStateToWriteAction(eventsClassification.state);
   const forensicAction = diffStateToWriteAction(forensicClassification.state);
+  const showScanProgress = process.stderr.isTTY === true;
+  if (showScanProgress) {
+    process.stderr.write(`${t("cli.install.scanning")}
+`);
+  }
   const forensicReport = await buildForensicReport(target);
+  if (showScanProgress) {
+    process.stderr.write(`${t("cli.install.scan-complete")}
+`);
+  }
   const meta = createInitialMeta();
   return {
     target,
@@ -1947,22 +2078,16 @@ 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);
+    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);
@@ -1970,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 = [];
@@ -2126,9 +2251,17 @@ async function executeInitStagePlan(plan, stageName) {
         installResults.push(...await runBestEffort("skill-install", () => installFabricArchiveSkill(plan.target)));
         installResults.push(...await runBestEffort("skill-review-install", () => installFabricReviewSkill(plan.target)));
         installResults.push(...await runBestEffort("skill-import-install", () => installFabricImportSkill(plan.target)));
+        installResults.push(...await runBestEffort("skill-sync-install", () => installFabricSyncSkill(plan.target)));
+        installResults.push(...await runBestEffort("skill-store-install", () => installFabricStoreSkill(plan.target)));
+        installResults.push(...await runBestEffort("skill-audit-install", () => installFabricAuditSkill(plan.target)));
+        installResults.push(...await runBestEffort("skill-connect-install", () => installFabricConnectSkill(plan.target)));
+        installResults.push(...await runBestEffort("skill-shared-lib", () => installSharedSkillLib(plan.target)));
         installResults.push(...await runBestEffort("hook-script", () => installArchiveHintHook(plan.target)));
         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)));
@@ -2184,7 +2317,7 @@ async function executeInitStagePlan(plan, stageName) {
   }
 }
 function shouldReplaceWritableDirectory(path, _options) {
-  if (!existsSync4(path)) {
+  if (!existsSync5(path)) {
     return false;
   }
   if (statSync4(path).isDirectory()) {
@@ -2193,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;
@@ -2213,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" };
@@ -2242,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 });
   }
 }
@@ -2396,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";