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

package/dist/{chunk-XHHCRDIR.js → chunk-CMDW3PYK.js}

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   deepMerge
-} from "./chunk-XC5RUHLK.js";
+} from "./chunk-3IOLS5EK.js";
 
 // src/install/write-bootstrap-snapshot.ts
 import { existsSync, readFileSync } from "fs";
 import { mkdir } from "fs/promises";
 import { dirname, join } from "path";
 import { atomicWriteText } from "@fenglimg/fabric-shared/node/atomic-write";
-import { BOOTSTRAP_CANONICAL } from "@fenglimg/fabric-shared/templates/bootstrap-canonical";
+import { resolveBootstrapCanonical } from "@fenglimg/fabric-shared/templates/bootstrap-canonical";
 var FABRIC_AGENTS_RELPATH = join(".fabric", "AGENTS.md");
 var PROJECT_RULES_RELPATH = join(".fabric", "project-rules.md");
 function fabricAgentsSnapshotPath(targetRoot) {
@@ -25,31 +25,32 @@ function readProjectRulesIfPresent(targetRoot) {
 async function writeFabricAgentsSnapshot(targetRoot) {
   const step = "bootstrap-snapshot";
   const target = fabricAgentsSnapshotPath(targetRoot);
+  const canonical = resolveBootstrapCanonical();
   if (existsSync(target)) {
     try {
       const existing = readFileSync(target, "utf8");
-      if (existing === BOOTSTRAP_CANONICAL) {
+      if (existing === canonical) {
         return { step, path: target, status: "skipped", message: "up-to-date" };
       }
     } catch {
     }
   }
   await mkdir(dirname(target), { recursive: true });
-  await atomicWriteText(target, BOOTSTRAP_CANONICAL);
+  await atomicWriteText(target, canonical);
   return { step, path: target, status: "written" };
 }
 
 // src/install/skills-and-hooks.ts
-import { chmodSync, existsSync as existsSync2, readdirSync, readFileSync as readFileSync2, statSync } from "fs";
+import { chmodSync, existsSync as existsSync2, readdirSync, readFileSync as readFileSync2 } from "fs";
 import { mkdir as mkdir2, readFile, rm } from "fs/promises";
 import { dirname as dirname2, join as join2, parse, resolve } from "path";
 import { fileURLToPath } from "url";
+import { resolveGlobalLocale } from "@fenglimg/fabric-shared";
 import { atomicWriteJson, atomicWriteText as atomicWriteText2 } from "@fenglimg/fabric-shared/node/atomic-write";
 import {
   BOOTSTRAP_MARKER_BEGIN,
   BOOTSTRAP_MARKER_END,
-  BOOTSTRAP_REGEX,
-  LEGACY_KB_REGEX
+  BOOTSTRAP_REGEX
 } from "@fenglimg/fabric-shared/templates/bootstrap-canonical";
 var SKILL_TEMPLATE_REL = "skills/fabric-archive/SKILL.md";
 var SKILL_REVIEW_TEMPLATE_REL = "skills/fabric-review/SKILL.md";
@@ -67,7 +68,6 @@ var HOOK_POST_TOOLUSE_SCRIPT_TEMPLATE_REL = "hooks/post-tooluse-mutation.cjs";
 var HOOK_LIB_TEMPLATE_DIR_REL = "hooks/lib";
 var CLAUDE_HOOK_CONFIG_TEMPLATE_REL = "hooks/configs/claude-code.json";
 var CODEX_HOOK_CONFIG_TEMPLATE_REL = "hooks/configs/codex-hooks.json";
-var CURSOR_HOOK_CONFIG_TEMPLATE_REL = "hooks/configs/cursor-hooks.json";
 var SKILL_DESTINATIONS = {
   fabricArchive: [
     ".claude/skills/fabric-archive/SKILL.md",
@@ -105,6 +105,53 @@ var SKILL_DESTINATIONS = {
     ".codex/skills/fabric-connect/SKILL.md"
   ]
 };
+var FABRIC_SKILL_INSTALL_SPECS = {
+  fabricArchive: {
+    slug: "fabric-archive",
+    templateRel: SKILL_TEMPLATE_REL,
+    destinations: SKILL_DESTINATIONS.fabricArchive,
+    step: "skill",
+    includeRefFiles: true
+  },
+  fabricReview: {
+    slug: "fabric-review",
+    templateRel: SKILL_REVIEW_TEMPLATE_REL,
+    destinations: SKILL_DESTINATIONS.fabricReview,
+    step: "skill-review",
+    includeRefFiles: true
+  },
+  fabricImport: {
+    slug: "fabric-import",
+    templateRel: SKILL_IMPORT_TEMPLATE_REL,
+    destinations: SKILL_DESTINATIONS.fabricImport,
+    step: "skill-import",
+    includeRefFiles: true
+  },
+  fabricSync: {
+    slug: "fabric-sync",
+    templateRel: SKILL_SYNC_TEMPLATE_REL,
+    destinations: SKILL_DESTINATIONS.fabricSync,
+    step: "skill-sync"
+  },
+  fabricStore: {
+    slug: "fabric-store",
+    templateRel: SKILL_STORE_TEMPLATE_REL,
+    destinations: SKILL_DESTINATIONS.fabricStore,
+    step: "skill-store"
+  },
+  fabricAudit: {
+    slug: "fabric-audit",
+    templateRel: SKILL_AUDIT_TEMPLATE_REL,
+    destinations: SKILL_DESTINATIONS.fabricAudit,
+    step: "skill-audit"
+  },
+  fabricConnect: {
+    slug: "fabric-connect",
+    templateRel: SKILL_CONNECT_TEMPLATE_REL,
+    destinations: SKILL_DESTINATIONS.fabricConnect,
+    step: "skill-connect"
+  }
+};
 var DEPRECATED_SKILL_DIRS = [
   ".claude/skills/fabric-init",
   ".codex/skills/fabric-init"
@@ -112,54 +159,46 @@ var DEPRECATED_SKILL_DIRS = [
 var HOOK_SCRIPT_DESTINATIONS = {
   fabricHint: [
     ".claude/hooks/fabric-hint.cjs",
-    ".codex/hooks/fabric-hint.cjs",
-    ".cursor/hooks/fabric-hint.cjs"
+    ".codex/hooks/fabric-hint.cjs"
   ],
   knowledgeHintBroad: [
     ".claude/hooks/knowledge-hint-broad.cjs",
-    ".codex/hooks/knowledge-hint-broad.cjs",
-    ".cursor/hooks/knowledge-hint-broad.cjs"
+    ".codex/hooks/knowledge-hint-broad.cjs"
   ],
   knowledgeHintNarrow: [
     ".claude/hooks/knowledge-hint-narrow.cjs",
-    ".codex/hooks/knowledge-hint-narrow.cjs",
-    ".cursor/hooks/knowledge-hint-narrow.cjs"
+    ".codex/hooks/knowledge-hint-narrow.cjs"
   ],
   // v2.0.0-rc.34 TASK-06: Claude Code — UserPromptSubmit cite-policy long-
   // session evict sidecar.
-  // v2.0.0-rc.37 NEW-21: extended to Codex / Cursor SessionStart slots.
-  // Those clients don't have an equivalent per-prompt event, so cite-policy-
+  // v2.0.0-rc.37 NEW-21: extended to Codex SessionStart slot.
+  // Codex doesn't have an equivalent per-prompt event, so cite-policy-
   // evict.cjs runs in "SessionStart mode" (one-shot stderr emit per session
   // boot, no turn-counter). Cadence is lower than Claude Code's per-prompt
-  // window but strictly better than 0 (rc.32 baseline measured Codex/Cursor
+  // window but strictly better than 0 (rc.32 baseline measured Codex
   // at 3.1% cite coverage when no cite-reminder surface existed).
   citePolicyEvict: [
     ".claude/hooks/cite-policy-evict.cjs",
-    ".codex/hooks/cite-policy-evict.cjs",
-    ".cursor/hooks/cite-policy-evict.cjs"
+    ".codex/hooks/cite-policy-evict.cjs"
   ],
-  // lifecycle-refactor W2-T2: SessionEnd marker hook — all three clients.
+  // lifecycle-refactor W2-T2: SessionEnd marker hook — both clients.
   sessionEndMarker: [
     ".claude/hooks/session-end-marker.cjs",
-    ".codex/hooks/session-end-marker.cjs",
-    ".cursor/hooks/session-end-marker.cjs"
+    ".codex/hooks/session-end-marker.cjs"
   ],
-  // lifecycle-refactor W2-T3: PostToolUse mutation marker hook — all three.
+  // lifecycle-refactor W2-T3: PostToolUse mutation marker hook — both.
   postTooluseMutation: [
     ".claude/hooks/post-tooluse-mutation.cjs",
-    ".codex/hooks/post-tooluse-mutation.cjs",
-    ".cursor/hooks/post-tooluse-mutation.cjs"
+    ".codex/hooks/post-tooluse-mutation.cjs"
   ]
 };
 var HOOK_LIB_DESTINATIONS = [
   ".claude/hooks/lib",
-  ".codex/hooks/lib",
-  ".cursor/hooks/lib"
+  ".codex/hooks/lib"
 ];
 var HOOK_CONFIG_TARGETS = {
   claudeCode: ".claude/settings.json",
-  codex: ".codex/hooks.json",
-  cursor: ".cursor/hooks.json"
+  codex: ".codex/hooks.json"
 };
 var HOOK_CONFIG_ARRAY_PATHS = {
   // F2: "hooks.UserPromptSubmit" MUST be listed — the Claude Code template
@@ -177,8 +216,7 @@ var HOOK_CONFIG_ARRAY_PATHS = {
     "hooks.PostToolUse",
     "hooks.SessionEnd"
   ],
-  codex: ["events.Stop", "events.SessionStart", "events.PreToolUse", "events.PostToolUse", "events.SessionEnd"],
-  cursor: ["hooks.stop", "hooks.sessionStart", "hooks.preToolUse", "hooks.postToolUse", "hooks.sessionEnd"]
+  codex: ["events.Stop", "events.SessionStart", "events.PreToolUse", "events.PostToolUse", "events.SessionEnd"]
 };
 var FABRIC_HOOK_COMMAND_PATHS = {
   claudeCode: {
@@ -199,33 +237,8 @@ var FABRIC_HOOK_COMMAND_PATHS = {
     citePolicyEvict: '"$(git rev-parse --show-toplevel)/.codex/hooks/cite-policy-evict.cjs"',
     sessionEndMarker: '"$(git rev-parse --show-toplevel)/.codex/hooks/session-end-marker.cjs"',
     postTooluseMutation: '"$(git rev-parse --show-toplevel)/.codex/hooks/post-tooluse-mutation.cjs"'
-  },
-  cursor: {
-    fabricHint: ".cursor/hooks/fabric-hint.cjs",
-    knowledgeHintBroad: ".cursor/hooks/knowledge-hint-broad.cjs",
-    knowledgeHintNarrow: ".cursor/hooks/knowledge-hint-narrow.cjs",
-    citePolicyEvict: ".cursor/hooks/cite-policy-evict.cjs",
-    sessionEndMarker: ".cursor/hooks/session-end-marker.cjs",
-    postTooluseMutation: ".cursor/hooks/post-tooluse-mutation.cjs"
   }
 };
-function readFabricLanguagePreference(projectRoot) {
-  const configPath = join2(projectRoot, ".fabric", "fabric-config.json");
-  if (!existsSync2(configPath)) {
-    return "match-existing";
-  }
-  try {
-    const raw = readFileSync2(configPath, "utf8");
-    const parsed = JSON.parse(raw);
-    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
-      return "match-existing";
-    }
-    const value = parsed["fabric_language"];
-    return typeof value === "string" && value.length > 0 ? value : "match-existing";
-  } catch {
-    return "match-existing";
-  }
-}
 var SKILL_TOKEN_ERROR_TOKENS = 1e4;
 var STALE_INSTALL_RATIO = 1.5;
 function estimateSkillTokens(text) {
@@ -254,113 +267,44 @@ function inspectStaleInstall(target, source) {
   }
   return null;
 }
-async function installFabricArchiveSkill(projectRoot, _options = {}) {
-  const source = await readTemplate(SKILL_TEMPLATE_REL);
-  validateSkillCanonicalSize(source, "fabric-archive");
-  const targets = SKILL_DESTINATIONS.fabricArchive.map((rel) => join2(projectRoot, rel));
+async function installFabricSkill(projectRoot, spec) {
+  const source = await readTemplate(spec.templateRel);
+  validateSkillCanonicalSize(source, spec.slug);
+  const targets = spec.destinations.map((rel) => join2(projectRoot, rel));
   const results = [];
   for (const target of targets) {
     const staleMsg = inspectStaleInstall(target, source);
-    const result = await copyTextIdempotent("skill", source, target);
+    const result = await copyTextIdempotent(spec.step, source, target);
     if (staleMsg && result.status === "written") {
       result.message = result.message ? `${staleMsg}; ${result.message}` : staleMsg;
     }
     results.push(result);
   }
-  results.push(...await installSkillRefFiles(projectRoot, "fabric-archive"));
+  if (spec.includeRefFiles) {
+    results.push(...await installSkillRefFiles(projectRoot, spec.slug));
+  }
   return results;
 }
+async function installFabricArchiveSkill(projectRoot, _options = {}) {
+  return installFabricSkill(projectRoot, FABRIC_SKILL_INSTALL_SPECS.fabricArchive);
+}
 async function installFabricReviewSkill(projectRoot, _options = {}) {
-  const source = await readTemplate(SKILL_REVIEW_TEMPLATE_REL);
-  validateSkillCanonicalSize(source, "fabric-review");
-  const targets = SKILL_DESTINATIONS.fabricReview.map((rel) => join2(projectRoot, rel));
-  const results = [];
-  for (const target of targets) {
-    const staleMsg = inspectStaleInstall(target, source);
-    const result = await copyTextIdempotent("skill-review", source, target);
-    if (staleMsg && result.status === "written") {
-      result.message = result.message ? `${staleMsg}; ${result.message}` : staleMsg;
-    }
-    results.push(result);
-  }
-  results.push(...await installSkillRefFiles(projectRoot, "fabric-review"));
-  return results;
+  return installFabricSkill(projectRoot, FABRIC_SKILL_INSTALL_SPECS.fabricReview);
 }
 async function installFabricImportSkill(projectRoot, _options = {}) {
-  const source = await readTemplate(SKILL_IMPORT_TEMPLATE_REL);
-  validateSkillCanonicalSize(source, "fabric-import");
-  const targets = SKILL_DESTINATIONS.fabricImport.map((rel) => join2(projectRoot, rel));
-  const results = [];
-  for (const target of targets) {
-    const staleMsg = inspectStaleInstall(target, source);
-    const result = await copyTextIdempotent("skill-import", source, target);
-    if (staleMsg && result.status === "written") {
-      result.message = result.message ? `${staleMsg}; ${result.message}` : staleMsg;
-    }
-    results.push(result);
-  }
-  results.push(...await installSkillRefFiles(projectRoot, "fabric-import"));
-  return results;
+  return installFabricSkill(projectRoot, FABRIC_SKILL_INSTALL_SPECS.fabricImport);
 }
 async function installFabricSyncSkill(projectRoot, _options = {}) {
-  const source = await readTemplate(SKILL_SYNC_TEMPLATE_REL);
-  validateSkillCanonicalSize(source, "fabric-sync");
-  const targets = SKILL_DESTINATIONS.fabricSync.map((rel) => join2(projectRoot, rel));
-  const results = [];
-  for (const target of targets) {
-    const staleMsg = inspectStaleInstall(target, source);
-    const result = await copyTextIdempotent("skill-sync", source, target);
-    if (staleMsg && result.status === "written") {
-      result.message = result.message ? `${staleMsg}; ${result.message}` : staleMsg;
-    }
-    results.push(result);
-  }
-  return results;
+  return installFabricSkill(projectRoot, FABRIC_SKILL_INSTALL_SPECS.fabricSync);
 }
 async function installFabricStoreSkill(projectRoot, _options = {}) {
-  const source = await readTemplate(SKILL_STORE_TEMPLATE_REL);
-  validateSkillCanonicalSize(source, "fabric-store");
-  const targets = SKILL_DESTINATIONS.fabricStore.map((rel) => join2(projectRoot, rel));
-  const results = [];
-  for (const target of targets) {
-    const staleMsg = inspectStaleInstall(target, source);
-    const result = await copyTextIdempotent("skill-store", source, target);
-    if (staleMsg && result.status === "written") {
-      result.message = result.message ? `${staleMsg}; ${result.message}` : staleMsg;
-    }
-    results.push(result);
-  }
-  return results;
+  return installFabricSkill(projectRoot, FABRIC_SKILL_INSTALL_SPECS.fabricStore);
 }
 async function installFabricAuditSkill(projectRoot, _options = {}) {
-  const source = await readTemplate(SKILL_AUDIT_TEMPLATE_REL);
-  validateSkillCanonicalSize(source, "fabric-audit");
-  const targets = SKILL_DESTINATIONS.fabricAudit.map((rel) => join2(projectRoot, rel));
-  const results = [];
-  for (const target of targets) {
-    const staleMsg = inspectStaleInstall(target, source);
-    const result = await copyTextIdempotent("skill-audit", source, target);
-    if (staleMsg && result.status === "written") {
-      result.message = result.message ? `${staleMsg}; ${result.message}` : staleMsg;
-    }
-    results.push(result);
-  }
-  return results;
+  return installFabricSkill(projectRoot, FABRIC_SKILL_INSTALL_SPECS.fabricAudit);
 }
 async function installFabricConnectSkill(projectRoot, _options = {}) {
-  const source = await readTemplate(SKILL_CONNECT_TEMPLATE_REL);
-  validateSkillCanonicalSize(source, "fabric-connect");
-  const targets = SKILL_DESTINATIONS.fabricConnect.map((rel) => join2(projectRoot, rel));
-  const results = [];
-  for (const target of targets) {
-    const staleMsg = inspectStaleInstall(target, source);
-    const result = await copyTextIdempotent("skill-connect", source, target);
-    if (staleMsg && result.status === "written") {
-      result.message = result.message ? `${staleMsg}; ${result.message}` : staleMsg;
-    }
-    results.push(result);
-  }
-  return results;
+  return installFabricSkill(projectRoot, FABRIC_SKILL_INSTALL_SPECS.fabricConnect);
 }
 async function cleanupDeprecatedSkills(projectRoot) {
   const results = [];
@@ -647,16 +591,6 @@ async function mergeCodexHookConfig(projectRoot, _options = {}) {
     [...HOOK_CONFIG_ARRAY_PATHS.codex]
   );
 }
-async function mergeCursorHookConfig(projectRoot, _options = {}) {
-  const fragment = await readJsonTemplate(CURSOR_HOOK_CONFIG_TEMPLATE_REL);
-  const targetPath = join2(projectRoot, HOOK_CONFIG_TARGETS.cursor);
-  return mergeJsonIdempotent(
-    "cursor-hook-config",
-    targetPath,
-    fragment,
-    [...HOOK_CONFIG_ARRAY_PATHS.cursor]
-  );
-}
 function buildManagedBlockBody(targetRoot) {
   const snapshotPath = fabricAgentsSnapshotPath(targetRoot);
   const snapshot = readFileSync2(snapshotPath, "utf8");
@@ -673,13 +607,6 @@ function wrapInBootstrapMarkers(body) {
 ${body}
 ${BOOTSTRAP_MARKER_END}`;
 }
-function stripLegacyKnowledgeBaseSection(existing) {
-  const match = existing.match(LEGACY_KB_REGEX);
-  if (match === null) return existing;
-  const before = existing.slice(0, match.index ?? 0);
-  const after = existing.slice((match.index ?? 0) + match[0].length);
-  return `${before}${after.replace(/^\r?\n/, "")}`;
-}
 var CLAUDE_BOOTSTRAP_HEADER = "# Project Knowledge";
 var CLAUDE_AGENTS_IMPORT_LINE = "@.fabric/AGENTS.md";
 var CLAUDE_PROJECT_RULES_IMPORT_LINE = "@.fabric/project-rules.md";
@@ -702,7 +629,7 @@ async function writeClaudeBootstrapThinShell(targetRoot, _options = {}) {
       };
     }
   }
-  let next = stripLegacyKnowledgeBaseSection(existing);
+  let next = existing;
   if (!projectRulesPresent) {
     next = removeImportLine(next, CLAUDE_PROJECT_RULES_IMPORT_LINE);
   }
@@ -777,23 +704,22 @@ async function writeCodexBootstrapManagedBlock(targetRoot, _options = {}) {
   }
   const body = buildManagedBlockBody(targetRoot);
   const managedBlock = wrapInBootstrapMarkers(body);
-  const stripped = stripLegacyKnowledgeBaseSection(existing);
   let next;
-  const match = stripped.match(BOOTSTRAP_REGEX);
+  const match = existing.match(BOOTSTRAP_REGEX);
   if (match !== null) {
-    const before = stripped.slice(0, match.index ?? 0);
-    const after = stripped.slice((match.index ?? 0) + match[0].length);
+    const before = existing.slice(0, match.index ?? 0);
+    const after = existing.slice((match.index ?? 0) + match[0].length);
     const cleaned = `${before}${after.replace(/^\r?\n/, "")}`;
     const trailingNewline = cleaned.length === 0 || cleaned.endsWith("\n") ? "" : "\n";
     next = `${cleaned}${trailingNewline}${cleaned.length === 0 ? "" : "\n"}${managedBlock}
 `;
   } else {
-    if (stripped.length === 0) {
+    if (existing.length === 0) {
       next = `${managedBlock}
 `;
     } else {
-      const trailingNewline = stripped.endsWith("\n") ? "" : "\n";
-      next = `${stripped}${trailingNewline}
+      const trailingNewline = existing.endsWith("\n") ? "" : "\n";
+      next = `${existing}${trailingNewline}
 ${managedBlock}
 `;
     }
@@ -814,55 +740,6 @@ ${managedBlock}
     };
   }
 }
-var CURSOR_RULE_FRONT_MATTER = "---\nalwaysApply: true\ndescription: Fabric Protocol bootstrap rules\n---\n\n";
-var CURSOR_LEGACY_FLAT_FILE_REL = join2(".cursor", "rules");
-var CURSOR_BOOTSTRAP_MDC_REL = join2(".cursor", "rules", "fabric-bootstrap.mdc");
-async function writeCursorBootstrapManagedBlock(targetRoot, _options = {}) {
-  const step = "bootstrap-cursor";
-  const target = join2(targetRoot, CURSOR_BOOTSTRAP_MDC_REL);
-  const legacyFlatFile = join2(targetRoot, CURSOR_LEGACY_FLAT_FILE_REL);
-  try {
-    if (existsSync2(legacyFlatFile)) {
-      const stat = statSync(legacyFlatFile);
-      if (stat.isFile()) {
-        await rm(legacyFlatFile, { force: true });
-      }
-    }
-  } catch {
-  }
-  const body = buildManagedBlockBody(targetRoot);
-  const managedBlock = wrapInBootstrapMarkers(body);
-  const expected = `${CURSOR_RULE_FRONT_MATTER}${managedBlock}
-`;
-  let existing = "";
-  if (existsSync2(target)) {
-    try {
-      existing = await readFile(target, "utf8");
-    } catch (error) {
-      return {
-        step,
-        path: target,
-        status: "error",
-        message: error instanceof Error ? error.message : String(error)
-      };
-    }
-  }
-  if (existing === expected) {
-    return { step, path: target, status: "skipped", message: "up-to-date" };
-  }
-  try {
-    await mkdir2(dirname2(target), { recursive: true });
-    await atomicWriteText2(target, expected);
-    return { step, path: target, status: "written" };
-  } catch (error) {
-    return {
-      step,
-      path: target,
-      status: "error",
-      message: error instanceof Error ? error.message : String(error)
-    };
-  }
-}
 async function copyTextIdempotent(step, source, target) {
   if (existsSync2(target)) {
     try {
@@ -881,6 +758,17 @@ var FABRIC_HOOK_SCRIPT_BASENAMES = /* @__PURE__ */ new Set([
   "fabric-hint.cjs",
   "knowledge-hint-broad.cjs",
   "knowledge-hint-narrow.cjs",
+  // dual-sink W5-1: the strip set must enumerate the COMPLETE fabric-owned hook
+  // surface — same set as FABRIC_HOOK_COMMAND_PATHS. Otherwise a matcher change
+  // in the template (e.g. adding `apply_patch` to the Codex PreToolUse/PostToolUse
+  // matchers) silently fails to propagate on upgrade: stripStaleHookEntries
+  // leaves the un-listed entry in place, and the subsequent append-with-dedupe
+  // matches it by `command` and SKIPS the new-matcher fragment, preserving the
+  // stale matcher. Listing these three makes the canonical template entry the
+  // sole survivor on every re-install, so matcher edits actually sync.
+  "cite-policy-evict.cjs",
+  "post-tooluse-mutation.cjs",
+  "session-end-marker.cjs",
   // rc.5 TASK-010 rename — old hook scripts that pre-upgrade workspaces
   // may still have registered. Sweeping them prevents the double-fire
   // documented in audit §2.6.
@@ -1019,7 +907,6 @@ export {
   HOOK_CONFIG_TARGETS,
   HOOK_CONFIG_ARRAY_PATHS,
   FABRIC_HOOK_COMMAND_PATHS,
-  readFabricLanguagePreference,
   installFabricArchiveSkill,
   installFabricReviewSkill,
   installFabricImportSkill,
@@ -1038,8 +925,6 @@ export {
   installHookLibs,
   mergeClaudeCodeHookConfig,
   mergeCodexHookConfig,
-  mergeCursorHookConfig,
   writeClaudeBootstrapThinShell,
-  writeCodexBootstrapManagedBlock,
-  writeCursorBootstrapManagedBlock
+  writeCodexBootstrapManagedBlock
 };

package/dist/chunk-FEOPLBGA.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+import {
+  regenerateBindingsSnapshot
+} from "./chunk-PTGQAZEW.js";
+import {
+  storeBind,
+  storeProjectCreate,
+  storeProjectList,
+  storeSetWriteRoute,
+  storeSwitchWrite
+} from "./chunk-QPAW6IYT.js";
+import {
+  loadProjectConfig,
+  saveProjectConfig
+} from "./chunk-QFIVFZRH.js";
+
+// src/install/migrate-root-config.ts
+import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { dirname, join } from "path";
+var ROOT_AUTHORITATIVE_KEYS = /* @__PURE__ */ new Set([
+  "embed_enabled",
+  "embed_model",
+  "embed_weight",
+  "plan_context_top_k",
+  "mcpPayloadLimits",
+  "retrieval_budget_profile",
+  "recall_body_budget_bytes",
+  "selection_token_ttl_ms",
+  "orphan_demote_proven_days",
+  "orphan_demote_verified_days",
+  "orphan_demote_draft_days",
+  "clientPaths"
+]);
+function readJsonObject(path) {
+  if (!existsSync(path)) return null;
+  try {
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    if (parsed === null || typeof parsed !== "object" || Array.isArray(parsed)) {
+      return null;
+    }
+    return parsed;
+  } catch {
+    return null;
+  }
+}
+function migrateRootConfig(projectRoot) {
+  const rootPath = join(projectRoot, "fabric.config.json");
+  const fabricPath = join(projectRoot, ".fabric", "fabric-config.json");
+  const result = {
+    migrated: false,
+    mergedKeys: [],
+    rootPath,
+    fabricPath
+  };
+  const rootConfig = readJsonObject(rootPath);
+  if (rootConfig === null) {
+    if (existsSync(rootPath)) {
+      rmSync(rootPath, { force: true });
+      result.migrated = true;
+    }
+    return result;
+  }
+  const fabricConfig = readJsonObject(fabricPath) ?? {};
+  const merged = { ...fabricConfig };
+  const mergedKeys = [];
+  for (const [key, value] of Object.entries(rootConfig)) {
+    const fabricHasKey = Object.prototype.hasOwnProperty.call(merged, key);
+    if (ROOT_AUTHORITATIVE_KEYS.has(key) || !fabricHasKey) {
+      if (!fabricHasKey || merged[key] !== value) {
+        mergedKeys.push(key);
+      }
+      merged[key] = value;
+    }
+  }
+  mkdirSync(dirname(fabricPath), { recursive: true });
+  writeFileSync(fabricPath, JSON.stringify(merged, null, 2) + "\n", "utf8");
+  rmSync(rootPath, { force: true });
+  result.migrated = true;
+  result.mergedKeys = mergedKeys;
+  return result;
+}
+
+// src/install/store-project-onboarding.ts
+import { execFileSync } from "child_process";
+import { randomUUID } from "crypto";
+import { basename } from "path";
+function ensureProjectId(projectRoot, uuid = randomUUID()) {
+  const config = loadProjectConfig(projectRoot) ?? {};
+  if (typeof config.project_id === "string" && config.project_id.length > 0) {
+    return config.project_id;
+  }
+  saveProjectConfig({ ...config, project_id: uuid }, projectRoot);
+  return uuid;
+}
+function suggestStoreProjectId(projectRoot) {
+  return normalizeStoreProjectId(readGitRemoteName(projectRoot) ?? basename(projectRoot));
+}
+function normalizeStoreProjectId(value) {
+  const normalized = value.trim().replace(/\.git$/iu, "").toLowerCase().replace(/[^a-z0-9_-]+/gu, "-").replace(/-+/gu, "-").replace(/^[-_]+|[-_]+$/gu, "");
+  return normalized.length > 0 ? normalized : "project";
+}
+async function ensureStoreProjectBinding(projectRoot, storeAlias, options) {
+  const now = options.now ?? (/* @__PURE__ */ new Date()).toISOString();
+  const project_id = ensureProjectId(projectRoot, options.uuid);
+  const currentConfig = loadProjectConfig(projectRoot);
+  const requested = options.requestedProjectId ?? currentConfig?.active_project ?? suggestStoreProjectId(projectRoot);
+  const active_project = normalizeStoreProjectId(requested);
+  const projects = await storeProjectList(storeAlias, options.globalRoot);
+  const project_created = !projects.some((project) => project.id === active_project);
+  if (project_created) {
+    await storeProjectCreate(storeAlias, active_project, now, {
+      name: active_project,
+      globalRoot: options.globalRoot
+    });
+  }
+  const entry = options.suggestedRemote === void 0 ? { id: storeAlias } : { id: storeAlias, suggested_remote: options.suggestedRemote };
+  await storeBind(projectRoot, entry, { project: active_project, globalRoot: options.globalRoot });
+  storeSwitchWrite(projectRoot, storeAlias, { globalRoot: options.globalRoot });
+  storeSetWriteRoute(projectRoot, `project:${active_project}`, storeAlias, {
+    globalRoot: options.globalRoot
+  });
+  regenerateBindingsSnapshot(projectRoot, {
+    now,
+    globalRoot: options.globalRoot
+  });
+  return { project_id, active_project, project_created };
+}
+function readGitRemoteName(projectRoot) {
+  try {
+    const remote = execFileSync("git", ["config", "--get", "remote.origin.url"], {
+      cwd: projectRoot,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim();
+    if (remote.length === 0) {
+      return null;
+    }
+    const lastSegment = remote.split(/[/:\\]/u).filter(Boolean).at(-1);
+    return lastSegment === void 0 ? null : lastSegment.replace(/\.git$/iu, "");
+  } catch {
+    return null;
+  }
+}
+
+export {
+  migrateRootConfig,
+  suggestStoreProjectId,
+  normalizeStoreProjectId,
+  ensureStoreProjectBinding
+};

package/dist/{chunk-XCBVSGCS.js → chunk-FNHDQTPC.js}

@@ -8,18 +8,9 @@ import {
   saveGlobalConfig
 } from "@fenglimg/fabric-shared";
 
-// src/store/project-config-io.ts
-import {
-  projectConfigPath,
-  loadProjectConfig,
-  saveProjectConfig
-} from "@fenglimg/fabric-shared";
-
 export {
   resolveGlobalRoot,
   globalConfigPath,
   loadGlobalConfig,
-  saveGlobalConfig,
-  loadProjectConfig,
-  saveProjectConfig
+  saveGlobalConfig
 };