@fenglimg/fabric-cli 2.0.1 → 2.1.0-rc.2

package/dist/{chunk-D25XJ4BC.js → chunk-F46ORPOA.js}

@@ -54,6 +54,7 @@ import {
 var SKILL_TEMPLATE_REL = "skills/fabric-archive/SKILL.md";
 var SKILL_REVIEW_TEMPLATE_REL = "skills/fabric-review/SKILL.md";
 var SKILL_IMPORT_TEMPLATE_REL = "skills/fabric-import/SKILL.md";
+var SKILL_SYNC_TEMPLATE_REL = "skills/fabric-sync/SKILL.md";
 var HOOK_SCRIPT_TEMPLATE_REL = "hooks/fabric-hint.cjs";
 var HOOK_BROAD_SCRIPT_TEMPLATE_REL = "hooks/knowledge-hint-broad.cjs";
 var HOOK_NARROW_SCRIPT_TEMPLATE_REL = "hooks/knowledge-hint-narrow.cjs";
@@ -74,6 +75,12 @@ var SKILL_DESTINATIONS = {
   fabricImport: [
     ".claude/skills/fabric-import/SKILL.md",
     ".codex/skills/fabric-import/SKILL.md"
+  ],
+  // v2.1.0-rc.1 P4 (S46): fabric-sync mirrors the sibling skills' 2-client
+  // coverage (Claude Code + Codex CLI surface a Skills directory).
+  fabricSync: [
+    ".claude/skills/fabric-sync/SKILL.md",
+    ".codex/skills/fabric-sync/SKILL.md"
   ]
 };
 var DEPRECATED_SKILL_DIRS = [
@@ -235,6 +242,21 @@ async function installFabricImportSkill(projectRoot, _options = {}) {
   results.push(...await installSkillRefFiles(projectRoot, "fabric-import"));
   return results;
 }
+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;
+}
 async function cleanupDeprecatedSkills(projectRoot) {
   const results = [];
   for (const rel of DEPRECATED_SKILL_DIRS) {
@@ -864,6 +886,7 @@ export {
   installFabricArchiveSkill,
   installFabricReviewSkill,
   installFabricImportSkill,
+  installFabricSyncSkill,
   cleanupDeprecatedSkills,
   installSharedSkillLib,
   installArchiveHintHook,

package/dist/chunk-HFQVXY6P.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+import {
+  loadProjectConfig,
+  saveProjectConfig
+} from "./chunk-LFIKMVY7.js";
+import {
+  loadGlobalConfig,
+  resolveGlobalRoot,
+  saveGlobalConfig
+} from "./chunk-RYAFBNES.js";
+
+// src/store/store-ops.ts
+import {
+  addMountedStore,
+  bindRequiredStore,
+  detachMountedStore,
+  explainStore
+} from "@fenglimg/fabric-shared";
+var NO_GLOBAL_CONFIG = "no global Fabric config found \u2014 run `fabric install --global <url>` first";
+function requireConfig(globalRoot) {
+  const config = loadGlobalConfig(globalRoot);
+  if (config === null) {
+    throw new Error(NO_GLOBAL_CONFIG);
+  }
+  return config;
+}
+function storeList(globalRoot = resolveGlobalRoot()) {
+  return requireConfig(globalRoot).stores;
+}
+function storeAdd(store, globalRoot = resolveGlobalRoot()) {
+  const next = addMountedStore(requireConfig(globalRoot), store);
+  saveGlobalConfig(next, globalRoot);
+  return next;
+}
+function storeRemove(alias, globalRoot = resolveGlobalRoot()) {
+  const result = detachMountedStore(requireConfig(globalRoot), alias);
+  saveGlobalConfig(result.config, globalRoot);
+  return result;
+}
+function storeExplain(alias, globalRoot = resolveGlobalRoot()) {
+  return explainStore(requireConfig(globalRoot), alias);
+}
+var NO_PROJECT_CONFIG = "no project Fabric config \u2014 run `fabric install` in this repo first";
+function requireProjectConfig(projectRoot) {
+  const config = loadProjectConfig(projectRoot);
+  if (config === null) {
+    throw new Error(NO_PROJECT_CONFIG);
+  }
+  return config;
+}
+function storeBind(projectRoot, entry) {
+  const config = requireProjectConfig(projectRoot);
+  const next = {
+    ...config,
+    required_stores: bindRequiredStore(config.required_stores ?? [], entry)
+  };
+  saveProjectConfig(next, projectRoot);
+  return next;
+}
+function storeSwitchWrite(projectRoot, alias) {
+  const config = requireProjectConfig(projectRoot);
+  const next = { ...config, active_write_store: alias };
+  saveProjectConfig(next, projectRoot);
+  return next;
+}
+function missingRequiredStores(projectRoot, globalRoot = resolveGlobalRoot()) {
+  const project = loadProjectConfig(projectRoot);
+  if (project === null || project.required_stores === void 0) {
+    return [];
+  }
+  const global = loadGlobalConfig(globalRoot);
+  const mounted = new Set(
+    (global?.stores ?? []).flatMap((s) => [s.alias, s.store_uuid])
+  );
+  return project.required_stores.filter((r) => !mounted.has(r.id));
+}
+
+export {
+  storeList,
+  storeAdd,
+  storeRemove,
+  storeExplain,
+  storeBind,
+  storeSwitchWrite,
+  missingRequiredStores
+};

package/dist/chunk-L4Q55UC4.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+import {
+  loadProjectConfig
+} from "./chunk-LFIKMVY7.js";
+import {
+  loadGlobalConfig,
+  resolveGlobalRoot
+} from "./chunk-RYAFBNES.js";
+
+// src/store/scope-explain.ts
+import {
+  createStoreResolver
+} from "@fenglimg/fabric-shared";
+function buildResolveInput(projectRoot, globalRoot = resolveGlobalRoot()) {
+  const global = loadGlobalConfig(globalRoot);
+  if (global === null) {
+    return null;
+  }
+  const project = loadProjectConfig(projectRoot);
+  return {
+    uid: global.uid,
+    mountedStores: global.stores.map((s) => ({
+      store_uuid: s.store_uuid,
+      alias: s.alias,
+      ...s.remote === void 0 ? {} : { remote: s.remote },
+      writable: s.writable ?? true,
+      personal: s.personal ?? false
+    })),
+    requiredStores: (project?.required_stores ?? []).map((r) => ({
+      id: r.id,
+      ...r.suggested_remote === void 0 ? {} : { suggested_remote: r.suggested_remote }
+    })),
+    ...project?.active_write_store === void 0 ? {} : { activeWriteAlias: project.active_write_store }
+  };
+}
+function scopeExplain(projectRoot, scope, globalRoot = resolveGlobalRoot()) {
+  const input = buildResolveInput(projectRoot, globalRoot);
+  if (input === null) {
+    return null;
+  }
+  const resolver = createStoreResolver();
+  return {
+    scope,
+    readSet: resolver.resolveReadSet(input),
+    writeTarget: resolver.resolveWriteTarget(input, scope).target
+  };
+}
+
+export {
+  buildResolveInput,
+  scopeExplain
+};

package/dist/chunk-LFIKMVY7.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+
+// src/store/project-config-io.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+import { fabricConfigSchema } from "@fenglimg/fabric-shared";
+function projectConfigPath(projectRoot) {
+  return join(projectRoot, ".fabric", "fabric-config.json");
+}
+function loadProjectConfig(projectRoot) {
+  const path = projectConfigPath(projectRoot);
+  if (!existsSync(path)) {
+    return null;
+  }
+  return fabricConfigSchema.parse(JSON.parse(readFileSync(path, "utf8")));
+}
+function saveProjectConfig(config, projectRoot) {
+  const validated = fabricConfigSchema.parse(config);
+  mkdirSync(join(projectRoot, ".fabric"), { recursive: true });
+  writeFileSync(projectConfigPath(projectRoot), `${JSON.stringify(validated, null, 2)}
+`, "utf8");
+}
+
+export {
+  loadProjectConfig,
+  saveProjectConfig
+};

package/dist/chunk-RYAFBNES.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+// src/store/global-config-io.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { globalConfigSchema } from "@fenglimg/fabric-shared";
+function resolveGlobalRoot() {
+  return join(process.env.FABRIC_HOME ?? homedir(), ".fabric");
+}
+function globalConfigPath(globalRoot = resolveGlobalRoot()) {
+  return join(globalRoot, "fabric-global.json");
+}
+function loadGlobalConfig(globalRoot = resolveGlobalRoot()) {
+  const path = globalConfigPath(globalRoot);
+  if (!existsSync(path)) {
+    return null;
+  }
+  return globalConfigSchema.parse(JSON.parse(readFileSync(path, "utf8")));
+}
+function saveGlobalConfig(config, globalRoot = resolveGlobalRoot()) {
+  const validated = globalConfigSchema.parse(config);
+  mkdirSync(globalRoot, { recursive: true });
+  writeFileSync(globalConfigPath(globalRoot), `${JSON.stringify(validated, null, 2)}
+`, "utf8");
+}
+
+export {
+  resolveGlobalRoot,
+  globalConfigPath,
+  loadGlobalConfig,
+  saveGlobalConfig
+};

package/dist/chunk-T5RPGCCM.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env node
+import {
+  loadProjectConfig
+} from "./chunk-LFIKMVY7.js";
+import {
+  loadGlobalConfig,
+  resolveGlobalRoot
+} from "./chunk-RYAFBNES.js";
+
+// src/store/info-ops.ts
+function whoami(globalRoot = resolveGlobalRoot()) {
+  const config = loadGlobalConfig(globalRoot);
+  if (config === null) {
+    return null;
+  }
+  return {
+    uid: config.uid,
+    stores: config.stores.map((s) => ({
+      alias: s.alias,
+      store_uuid: s.store_uuid,
+      local_only: s.remote === void 0
+    }))
+  };
+}
+function projectStatus(projectRoot, globalRoot = resolveGlobalRoot()) {
+  const global = loadGlobalConfig(globalRoot);
+  const project = loadProjectConfig(projectRoot);
+  return {
+    uid: global?.uid ?? null,
+    mounted: (global?.stores ?? []).map((s) => s.alias),
+    project_id: project?.project_id ?? null,
+    required: (project?.required_stores ?? []).map((r) => r.id),
+    active_write_store: project?.active_write_store ?? null
+  };
+}
+
+export {
+  whoami,
+  projectStatus
+};

package/dist/chunk-WU6GAPKH.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import {
+  buildResolveInput
+} from "./chunk-L4Q55UC4.js";
+import {
+  loadProjectConfig
+} from "./chunk-LFIKMVY7.js";
+import {
+  resolveGlobalRoot
+} from "./chunk-RYAFBNES.js";
+
+// src/store/bindings-io.ts
+import { writeBindingsSnapshot } from "@fenglimg/fabric-shared";
+var DEFAULT_WRITE_SCOPE = "team";
+function regenerateBindingsSnapshot(projectRoot, options) {
+  const globalRoot = options.globalRoot ?? resolveGlobalRoot();
+  const resolveInput = buildResolveInput(projectRoot, globalRoot);
+  if (resolveInput === null) {
+    return null;
+  }
+  const project = loadProjectConfig(projectRoot);
+  if (project?.project_id === void 0) {
+    return null;
+  }
+  return writeBindingsSnapshot({
+    globalRoot,
+    projectId: project.project_id,
+    resolveInput,
+    writeScope: options.writeScope ?? DEFAULT_WRITE_SCOPE,
+    now: options.now
+  });
+}
+
+export {
+  regenerateBindingsSnapshot
+};

package/dist/{doctor-EJDSEJSS.js → doctor-QVNPHLJK.js}

@@ -10,6 +10,16 @@ import {
   getDoctorTranslator,
   t
 } from "./chunk-PWLW3B57.js";
+import {
+  missingRequiredStores
+} from "./chunk-HFQVXY6P.js";
+import {
+  loadProjectConfig
+} from "./chunk-LFIKMVY7.js";
+import {
+  loadGlobalConfig,
+  resolveGlobalRoot
+} from "./chunk-RYAFBNES.js";
 
 // src/commands/doctor.ts
 import { confirm, isCancel } from "@clack/prompts";
@@ -24,6 +34,53 @@ import {
   runDoctorHistoryAll,
   runDoctorReport
 } from "@fenglimg/fabric-server";
+
+// src/store/doctor-checks.ts
+import { join } from "path";
+import { findStoreExecutableViolations, storeRelativePath } from "@fenglimg/fabric-shared";
+function storeDoctorChecks(projectRoot, globalRoot = resolveGlobalRoot()) {
+  const diagnostics = [];
+  const global = loadGlobalConfig(globalRoot);
+  if (global === null) {
+    diagnostics.push({
+      code: "no_global_config",
+      severity: "warn",
+      message: "no global Fabric config \u2014 run `fabric install --global <url>`"
+    });
+    return diagnostics;
+  }
+  for (const missing of missingRequiredStores(projectRoot, globalRoot)) {
+    diagnostics.push({
+      code: "missing_required_store",
+      severity: "warn",
+      ref: missing.id,
+      message: `required store '${missing.id}' is not mounted; run \`fabric store add\``
+    });
+  }
+  for (const store of global.stores) {
+    if (store.remote === void 0 && store.personal !== true) {
+      diagnostics.push({
+        code: "local_only_store",
+        severity: "info",
+        ref: store.alias,
+        message: `store '${store.alias}' is local-only; add a git remote to back it up`
+      });
+    }
+    const violations = findStoreExecutableViolations(join(globalRoot, storeRelativePath(store.store_uuid)));
+    if (violations.length > 0) {
+      diagnostics.push({
+        code: "executable_in_store",
+        severity: "warn",
+        ref: store.alias,
+        message: `store '${store.alias}' contains executable/script files (${violations.slice(0, 3).join(", ")}${violations.length > 3 ? ", \u2026" : ""}) \u2014 stores are data-only; Fabric never runs them (S65)`
+      });
+    }
+  }
+  return diagnostics;
+}
+
+// src/commands/doctor.ts
+import { buildDebugBundle } from "@fenglimg/fabric-shared";
 var FIX_KNOWLEDGE_CODE_LABELS = {
   knowledge_orphan_demote_required: "demote (maturity)",
   knowledge_stale_archive_required: "archive (git mv)",
@@ -62,6 +119,14 @@ var doctorCommand = defineCommand({
       description: t("cli.doctor.args.strict.description"),
       default: false
     },
+    // v2.1.0-rc.1 P6 (S40): emit a redacted diagnostic bundle (config + store
+    // diagnostics; events excluded by default). Every string is secret-redacted
+    // so the bundle is safe to paste into a bug report. Read-only.
+    "debug-bundle": {
+      type: "boolean",
+      description: "Emit a redacted diagnostic bundle (config + store health) for bug reports",
+      default: false
+    },
     // rc.7 T11: skip the safety confirm before mutations. Required for any
     // non-tty invocation that wants to run --fix-knowledge without setting
     // FABRIC_NONINTERACTIVE=1 in the environment.
@@ -154,6 +219,24 @@ var doctorCommand = defineCommand({
     const citeCoverage = args["cite-coverage"] === true;
     const enrichDesc = args["enrich-descriptions"] === true;
     const archiveHistory = args["archive-history"] === true;
+    if (args["debug-bundle"] === true) {
+      const globalRoot = resolveGlobalRoot();
+      let config = {};
+      try {
+        config = {
+          global: loadGlobalConfig(globalRoot) ?? null,
+          project: loadProjectConfig(resolution.target) ?? null
+        };
+      } catch {
+        config = {};
+      }
+      const bundle = buildDebugBundle({
+        config,
+        diagnostics: collectStoreDiagnostics(resolution.target)
+      });
+      writeStdout(JSON.stringify(bundle, null, 2));
+      return;
+    }
     if (args.since !== void 0) {
       try {
         parseSinceDuration(args.since);
@@ -317,8 +400,15 @@ var doctorCommand = defineCommand({
     } else {
       report = await runDoctorReport(resolution.target);
     }
+    const storeDiagnostics = collectStoreDiagnostics(resolution.target);
     if (args.json === true) {
-      writeStdout(JSON.stringify(fixKnowledgeReport ?? fixReport ?? report, null, 2));
+      writeStdout(
+        JSON.stringify(
+          { ...fixKnowledgeReport ?? fixReport ?? report, store_diagnostics: storeDiagnostics },
+          null,
+          2
+        )
+      );
     } else {
       if (fixKnowledgeReport !== null) {
         writeStdout(fixKnowledgeReport.message);
@@ -332,6 +422,7 @@ var doctorCommand = defineCommand({
         writeStdout(dt("cli.doctor.fix-dry-run-banner"));
       }
       renderHumanReport(report, dt, args.verbose === true);
+      renderStoreDiagnostics(storeDiagnostics);
     }
     await emitDoctorRunEventBestEffort(resolution.target, {
       mode: fixKnowledge ? "fix-knowledge" : "lint",
@@ -366,6 +457,25 @@ function renderHumanReport(report, dt, verbose) {
   writeIssueSection(dt("doctor.section.warnings"), report.warnings, opts);
   renderPayloadLimits(report, dt);
 }
+function collectStoreDiagnostics(projectRoot) {
+  try {
+    return storeDoctorChecks(projectRoot);
+  } catch {
+    return [];
+  }
+}
+function renderStoreDiagnostics(diagnostics) {
+  if (diagnostics.length === 0) {
+    return;
+  }
+  writeStdout("");
+  writeStdout(paint.ai("store health"));
+  for (const diagnostic of diagnostics) {
+    const mark = diagnostic.severity === "warn" ? symbol.warn : "[info]";
+    const ref = diagnostic.ref === void 0 ? "" : ` [${diagnostic.ref}]`;
+    writeStdout(`${mark}${ref} ${diagnostic.message}`);
+  }
+}
 function renderPayloadLimits(report, dt) {
   const limits = report.summary.payload_limits;
   if (limits === void 0) {

package/dist/index.js

@@ -11,9 +11,17 @@ import { defineCommand, runMain } from "citty";
 
 // src/commands/index.ts
 var allCommands = {
-  install: () => import("./install-EKWMFLUU.js").then((module) => module.default),
-  doctor: () => import("./doctor-EJDSEJSS.js").then((module) => module.default),
-  uninstall: () => import("./uninstall-MH7ZIB6M.js").then((module) => module.default),
+  install: () => import("./install-2HDO5FTQ.js").then((module) => module.default),
+  // v2.1.0-rc.1 P3: multi-store lifecycle command group (list/add/remove/explain).
+  store: () => import("./store-XTSE5TY6.js").then((module) => module.default),
+  // v2.1.0-rc.1 P3 (S9/S17/S37): multi-store pull --rebase + push, conflict resume.
+  sync: () => import("./sync-BJCWDPNC.js").then((module) => module.default),
+  // v2.1.0-rc.1 P3 (F5): read-only identity/status info commands.
+  whoami: () => import("./whoami-B6AEMSEV.js").then((module) => module.default),
+  status: () => import("./status-GLQWLWH6.js").then((module) => module.default),
+  "scope-explain": () => import("./scope-explain-2F2R5URO.js").then((module) => module.default),
+  doctor: () => import("./doctor-QVNPHLJK.js").then((module) => module.default),
+  uninstall: () => import("./uninstall-TAXSUSKH.js").then((module) => module.default),
   config: () => import("./config-XJIPZNUP.js").then((module) => module.default),
   "plan-context-hint": () => import("./plan-context-hint-FC6P3WFE.js").then((module) => module.default),
   // v2.0.0-rc.23 TASK-014 (F8c): S5 onboard-slot coverage. Used by the
@@ -27,7 +35,7 @@ var allCommands = {
 var main = defineCommand({
   meta: {
     name: "fabric",
-    version: "2.0.1",
+    version: "2.1.0-rc.2",
     description: t("cli.main.description")
   },
   subCommands: allCommands