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

package/dist/{doctor-QVNPHLJK.js → chunk-E7HJUU34.js}

@@ -1,25 +1,32 @@
 #!/usr/bin/env node
 import {
-  paint,
-  symbol
-} from "./chunk-WWNXR34K.js";
+  ensureStoreProjectBinding,
+  migrateRootConfig
+} from "./chunk-3D7B2UAZ.js";
 import {
   resolveDevMode
-} from "./chunk-COI5VDFU.js";
+} from "./chunk-WA3DYGSY.js";
 import {
-  getDoctorTranslator,
-  t
-} from "./chunk-PWLW3B57.js";
+  paint,
+  symbol
+} from "./chunk-NLNH64A3.js";
 import {
-  missingRequiredStores
-} from "./chunk-HFQVXY6P.js";
+  detectAliasLinkDrift,
+  missingRequiredStores,
+  syncStoreAliasLinks,
+  unboundAvailableStores
+} from "./chunk-QPAW6IYT.js";
 import {
   loadProjectConfig
-} from "./chunk-LFIKMVY7.js";
+} from "./chunk-QFIVFZRH.js";
 import {
   loadGlobalConfig,
   resolveGlobalRoot
-} from "./chunk-RYAFBNES.js";
+} from "./chunk-FNHDQTPC.js";
+import {
+  getDoctorTranslator,
+  t
+} from "./chunk-HORSMSZL.js";
 
 // src/commands/doctor.ts
 import { confirm, isCancel } from "@clack/prompts";
@@ -32,12 +39,28 @@ import {
   runDoctorCiteCoverage,
   runDoctorFix,
   runDoctorHistoryAll,
-  runDoctorReport
+  runDoctorReport,
+  runDoctorConflictLint
 } from "@fenglimg/fabric-server";
 
+// src/install/backfill-unbound-project.ts
+import { detectUnboundProject } from "@fenglimg/fabric-server";
+async function backfillUnboundProject(projectRoot, globalRoot = resolveGlobalRoot()) {
+  const violation = detectUnboundProject(projectRoot);
+  if (violation === null) {
+    return null;
+  }
+  const result = await ensureStoreProjectBinding(projectRoot, violation.alias, { globalRoot });
+  return {
+    alias: violation.alias,
+    project_id: result.project_id,
+    active_project: result.active_project
+  };
+}
+
 // src/store/doctor-checks.ts
 import { join } from "path";
-import { findStoreExecutableViolations, storeRelativePath } from "@fenglimg/fabric-shared";
+import { findStoreExecutableViolations, storeRelativePathForMount } from "@fenglimg/fabric-shared";
 function storeDoctorChecks(projectRoot, globalRoot = resolveGlobalRoot()) {
   const diagnostics = [];
   const global = loadGlobalConfig(globalRoot);
@@ -57,6 +80,23 @@ function storeDoctorChecks(projectRoot, globalRoot = resolveGlobalRoot()) {
       message: `required store '${missing.id}' is not mounted; run \`fabric store add\``
     });
   }
+  for (const store of unboundAvailableStores(projectRoot, globalRoot)) {
+    diagnostics.push({
+      code: "unbound_available_store",
+      severity: "info",
+      ref: store.alias,
+      message: `store '${store.alias}' is mounted but not bound to this project; run \`fabric store bind ${store.alias}\` to read its knowledge here (then \`fabric store switch-write ${store.alias}\` to write team knowledge into it)`
+    });
+  }
+  const aliasDrift = detectAliasLinkDrift(globalRoot);
+  if (aliasDrift.length > 0) {
+    diagnostics.push({
+      code: "store_alias_link_drift",
+      severity: "info",
+      ref: aliasDrift.join(", "),
+      message: `by-alias readability link(s) out of sync for ${aliasDrift.join(", ")}; run \`fabric doctor --fix\` to repair ~/.fabric/stores/by-alias/`
+    });
+  }
   for (const store of global.stores) {
     if (store.remote === void 0 && store.personal !== true) {
       diagnostics.push({
@@ -66,7 +106,7 @@ function storeDoctorChecks(projectRoot, globalRoot = resolveGlobalRoot()) {
         message: `store '${store.alias}' is local-only; add a git remote to back it up`
       });
     }
-    const violations = findStoreExecutableViolations(join(globalRoot, storeRelativePath(store.store_uuid)));
+    const violations = findStoreExecutableViolations(join(globalRoot, storeRelativePathForMount(store)));
     if (violations.length > 0) {
       diagnostics.push({
         code: "executable_in_store",
@@ -82,8 +122,6 @@ function storeDoctorChecks(projectRoot, globalRoot = resolveGlobalRoot()) {
 // 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)",
   knowledge_pending_auto_archive: "archive (git mv, pending)",
   knowledge_index_drift: "counter bump (agents.meta)",
   knowledge_session_hints_stale: "cache delete"
@@ -114,40 +152,28 @@ var doctorCommand = defineCommand({
       description: t("cli.doctor.args.json.description"),
       default: false
     },
-    strict: {
-      type: "boolean",
-      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.
+    // EPIC-009: hidden flag (internal debug tool).
     "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.
+    // EPIC-009: hidden flag (CI automation).
     yes: {
       type: "boolean",
       description: t("cli.doctor.args.yes.description"),
       default: false
     },
-    // rc.35 TASK-12 (P0-11): expose maintainer-audience actionHints. By
-    // default the renderer folds remediation strings that target Fabric
-    // contributors (edit `packages/cli/templates/...`, interpret G1-G5
-    // cite-goodhart codes, etc.) since npm end users have no actionable
-    // lever for them. --verbose shows them.
+    // EPIC-009: hidden flag (advanced output).
     verbose: {
       type: "boolean",
       description: t("cli.doctor.args.verbose.description"),
       default: false
     },
-    // rc.20 TASK-05: cite policy adherence report (read-only). Skips standard
-    // inspections entirely — different output surface. Mutually exclusive
-    // with --fix / --fix-knowledge (enforced in run()).
+    // EPIC-009: hidden flags (report surfaces).
     "cite-coverage": {
       type: "boolean",
       description: t("cli.doctor.args.cite-coverage.description"),
@@ -162,20 +188,14 @@ var doctorCommand = defineCommand({
       type: "string",
       description: t("cli.doctor.args.client.description"),
       default: "all",
-      valueHint: "cc|codex|cursor|all"
+      valueHint: "cc|codex|all"
     },
-    // v2.0.0-rc.24 TASK-10: --layer filter for the cite contract audit. Pairs
-    // with --cite-coverage. Validated against {'team','personal','all'} at
-    // command entry; rejects 'both' (rc.20 plan-context vocabulary) explicitly.
     layer: {
       type: "string",
       description: t("cli.doctor.args.layer.description"),
       default: "all",
       valueHint: "team|personal|all"
     },
-    // rc.23 TASK-007 (a-C2): description-grade back-fill flag set. Read-side
-    // by default; `--auto` flips the writer arm on. Mutually exclusive with
-    // --fix / --fix-knowledge / --cite-coverage (different mutation surfaces).
     "enrich-descriptions": {
       type: "boolean",
       description: t("cli.doctor.args.enrich-descriptions.description"),
@@ -191,23 +211,31 @@ var doctorCommand = defineCommand({
       description: t("cli.doctor.args.dry-run.description"),
       default: false
     },
-    // v2.0.0-rc.25 TASK-10: --archive-history flag (parallel to rc.20
-    // --cite-coverage). Read-only; reads session_archive_attempted events
-    // and renders a per-session table. Pairs with the shared `--since` flag.
     "archive-history": {
       type: "boolean",
       description: t("cli.doctor.args.archive-history.description"),
       default: false
     },
-    // rc.37 NEW-33: unified history view across archive / fix / all surfaces.
-    // Mode = `archive | fix | all` (the `archive` mode delegates to the
-    // existing runDoctorArchiveHistory; `fix` aggregates doctor_run events;
-    // `all` rolls up both into a per-day count table). Read-only; mutex
-    // with the mutation arms.
     history: {
       type: "string",
       description: t("cli.doctor.args.history.description"),
       valueHint: "archive|fix|all"
+    },
+    "lint-conflicts": {
+      type: "boolean",
+      description: t("cli.doctor.args.lint-conflicts.description"),
+      default: false
+    },
+    deep: {
+      type: "boolean",
+      description: t("cli.doctor.args.deep.description"),
+      default: false
+    },
+    // EPIC-009: hidden flag (strict mode for CI).
+    strict: {
+      type: "boolean",
+      description: t("cli.doctor.args.strict.description"),
+      default: false
     }
   },
   async run({ args }) {
@@ -362,6 +390,22 @@ var doctorCommand = defineCommand({
       renderCiteCoverageReport(report2, args.json === true, dt);
       return;
     }
+    if (args["lint-conflicts"] === true) {
+      if (fix || fixKnowledge || citeCoverage) {
+        writeStderr(dt("cli.doctor.errors.lint-conflicts-mutex"));
+        process.exitCode = 1;
+        return;
+      }
+      const report2 = await runDoctorConflictLint(resolution.target, {
+        deep: args.deep === true
+      });
+      if (args.json === true) {
+        writeStdout(JSON.stringify(report2, null, 2));
+      } else {
+        renderConflictLintReport(report2, args.deep === true, dt);
+      }
+      return;
+    }
     if (fixKnowledge && fix) {
       writeStderr(dt("cli.doctor.errors.fix-knowledge-fix-mutually-exclusive"));
       process.exitCode = 1;
@@ -369,33 +413,45 @@ var doctorCommand = defineCommand({
     }
     let fixKnowledgeReport = null;
     let fixReport = null;
+    let unboundProjectFix = null;
+    let rootConfigMigration = null;
     let report;
     if (fixKnowledge) {
       const preReport = await runDoctorReport(resolution.target);
       const plan = computeFixKnowledgePlan(preReport);
-      const yesFlag = args.yes === true;
-      const envBypass = process.env.FABRIC_NONINTERACTIVE === "1";
-      if (plan.totalCount === 0) {
+      if (args["dry-run"] === true) {
+        if (plan.totalCount > 0) {
+          renderFixKnowledgePlan(plan);
+        }
+        report = preReport;
       } else {
-        renderFixKnowledgePlan(plan);
-        const decision = await resolveFixKnowledgeConsent({
-          yesFlag,
-          envBypass,
-          plan
-        });
-        if (decision === "abort") {
-          process.exitCode = 1;
-          return;
+        const yesFlag = args.yes === true;
+        const envBypass = process.env.FABRIC_NONINTERACTIVE === "1";
+        if (plan.totalCount === 0) {
+        } else {
+          renderFixKnowledgePlan(plan);
+          const decision = await resolveFixKnowledgeConsent({
+            yesFlag,
+            envBypass,
+            plan
+          });
+          if (decision === "abort") {
+            process.exitCode = 1;
+            return;
+          }
         }
+        fixKnowledgeReport = await runDoctorFixKnowledge(resolution.target);
+        report = fixKnowledgeReport.report;
       }
-      fixKnowledgeReport = await runDoctorFixKnowledge(resolution.target);
-      report = fixKnowledgeReport.report;
     } else if (fix) {
       if (args["dry-run"] === true) {
         report = await runDoctorReport(resolution.target);
       } else {
+        rootConfigMigration = migrateRootConfig(resolution.target);
+        unboundProjectFix = await backfillUnboundProject(resolution.target);
         fixReport = await runDoctorFix(resolution.target);
         report = fixReport.report;
+        syncStoreAliasLinks();
       }
     } else {
       report = await runDoctorReport(resolution.target);
@@ -404,7 +460,12 @@ var doctorCommand = defineCommand({
     if (args.json === true) {
       writeStdout(
         JSON.stringify(
-          { ...fixKnowledgeReport ?? fixReport ?? report, store_diagnostics: storeDiagnostics },
+          {
+            ...fixKnowledgeReport ?? fixReport ?? report,
+            store_diagnostics: storeDiagnostics,
+            ...unboundProjectFix === null ? {} : { unbound_project_fix: unboundProjectFix },
+            ...rootConfigMigration?.migrated === true ? { root_config_migration: rootConfigMigration } : {}
+          },
           null,
           2
         )
@@ -418,7 +479,20 @@ var doctorCommand = defineCommand({
         renderFixKnowledgeMutations(fixKnowledgeReport, dt);
       } else if (fixReport !== null) {
         writeStdout(fixReport.message);
-      } else if (fix && args["dry-run"] === true) {
+        if (unboundProjectFix !== null) {
+          writeStdout(
+            dt("cli.doctor.unbound-project-backfilled", {
+              alias: unboundProjectFix.alias,
+              project: unboundProjectFix.active_project
+            })
+          );
+        }
+        if (rootConfigMigration?.migrated === true) {
+          writeStdout(
+            `config: migrated legacy root fabric.config.json \u2192 .fabric/fabric-config.json${rootConfigMigration.mergedKeys.length > 0 ? ` (merged: ${rootConfigMigration.mergedKeys.join(", ")})` : ""}`
+          );
+        }
+      } else if ((fix || fixKnowledge) && args["dry-run"] === true) {
         writeStdout(dt("cli.doctor.fix-dry-run-banner"));
       }
       renderHumanReport(report, dt, args.verbose === true);
@@ -447,8 +521,11 @@ var doctorCommand = defineCommand({
 var doctor_default = doctorCommand;
 function renderHumanReport(report, dt, verbose) {
   writeStdout(`${renderStatus(report.status)} ${paint.ai("fabric doctor")} ${paint.human(report.summary.target)}`);
-  renderTldrHeader(report);
+  renderTldrHeader(report, dt, verbose);
   for (const check of report.checks) {
+    if (!verbose && check.status === "ok") {
+      continue;
+    }
     writeStdout(`${renderStatus(check.status)} ${check.name}: ${check.message}`);
   }
   const opts = { verbose, dt };
@@ -471,7 +548,7 @@ function renderStoreDiagnostics(diagnostics) {
   writeStdout("");
   writeStdout(paint.ai("store health"));
   for (const diagnostic of diagnostics) {
-    const mark = diagnostic.severity === "warn" ? symbol.warn : "[info]";
+    const mark = diagnostic.severity === "error" ? symbol.error : diagnostic.severity === "warn" ? symbol.warn : "[info]";
     const ref = diagnostic.ref === void 0 ? "" : ` [${diagnostic.ref}]`;
     writeStdout(`${mark}${ref} ${diagnostic.message}`);
   }
@@ -520,16 +597,16 @@ function writeIssueSection(title, issues, options) {
     }
   }
 }
-function renderTldrHeader(report) {
+function renderTldrHeader(report, dt, verbose) {
   const ranked = [];
   for (const issue of report.fixable_errors) {
-    ranked.push({ severity: "fixable", code: issue.code, message: issue.message });
+    ranked.push({ severity: "fixable", code: issue.code, message: issue.message, actionHint: issue.actionHint, audience: issue.audience });
   }
   for (const issue of report.manual_errors) {
-    ranked.push({ severity: "manual", code: issue.code, message: issue.message });
+    ranked.push({ severity: "manual", code: issue.code, message: issue.message, actionHint: issue.actionHint, audience: issue.audience });
   }
   for (const issue of report.warnings) {
-    ranked.push({ severity: "warn", code: issue.code, message: issue.message });
+    ranked.push({ severity: "warn", code: issue.code, message: issue.message, actionHint: issue.actionHint, audience: issue.audience });
   }
   if (ranked.length === 0) {
     writeStdout(`${symbol.ok} TL;DR: all 48 checks green \u2014 nothing to fix.`);
@@ -543,6 +620,11 @@ function renderTldrHeader(report) {
     const marker = item.severity === "fixable" ? symbol.error : item.severity === "manual" ? symbol.error : symbol.warn;
     const truncated = item.message.length > 140 ? `${item.message.slice(0, 137)}...` : item.message;
     writeStdout(`  ${marker} ${item.code}: ${truncated}`);
+    if (item.actionHint !== void 0 && item.actionHint.length > 0) {
+      writeStdout(
+        item.audience === "maintainer" && !verbose ? `    \u2192 ${dt("doctor.maintainer-hint-folded")}` : `    \u2192 ${item.actionHint}`
+      );
+    }
   }
 }
 function renderStatus(status) {
@@ -646,7 +728,6 @@ async function resolveFixKnowledgeConsent(options) {
 var CITE_COVERAGE_CLIENT_FILTERS = /* @__PURE__ */ new Set([
   "cc",
   "codex",
-  "cursor",
   "all"
 ]);
 function isValidClientFilter(input) {
@@ -689,10 +770,42 @@ function renderCiteCoverageReport(report, jsonMode, dt) {
   const complianceRate = report.metrics.cite_compliance_rate;
   const complianceStr = complianceRate === null || complianceRate === void 0 ? dt("doctor.cite.metric.complianceNA") : `${(complianceRate * 100).toFixed(1)}% (${report.metrics.compliant_cites ?? 0}/${(report.metrics.compliant_cites ?? 0) + (report.metrics.noncompliant_cites ?? 0)})`;
   lines.push(`  ${dt("doctor.cite.metric.complianceRate")}: ${complianceStr}`);
+  const recallRate = report.metrics.recall_coverage_rate;
+  const recallStr = recallRate === null || recallRate === void 0 ? dt("doctor.cite.metric.recallCoverageNA") : `${(recallRate * 100).toFixed(1)}% (${report.metrics.recall_backed_edits ?? 0}/${report.metrics.edits_touched})`;
+  lines.push(`  ${dt("doctor.cite.metric.recallCoverage")}: ${recallStr}`);
   const uncorrelatable = report.metrics.uncorrelatable_edits ?? 0;
   if (uncorrelatable > 0) {
     lines.push(`  ${dt("doctor.cite.metric.uncorrelatableEdits")}: ${uncorrelatable}`);
   }
+  if (report.metrics.exposed_and_mutated !== void 0) {
+    lines.push(
+      `  ${dt("doctor.cite.metric.exposedAndMutated")}: ${report.metrics.exposed_and_mutated.count}`
+    );
+  }
+  if (report.metrics.mutations_observed !== void 0) {
+    lines.push(
+      `  ${dt("doctor.cite.metric.mutationsObserved")}: ${report.metrics.mutations_observed.count}`
+    );
+  }
+  if (report.metrics.mutation_pool !== void 0) {
+    lines.push(
+      `  ${dt("doctor.cite.metric.mutationPool")}: ${report.metrics.mutation_pool.attributed} / ${report.metrics.mutation_pool.unattributed_workspace_dirty} (attributed / unattributed_workspace_dirty)`
+    );
+  }
+  if (report.metrics.sessions_closed !== void 0) {
+    lines.push(
+      `  ${dt("doctor.cite.metric.sessionsClosed")}: ${report.metrics.sessions_closed.count}`
+    );
+  }
+  if (report.metrics.by_store !== void 0) {
+    const storeKeys = Object.keys(report.metrics.by_store).sort();
+    if (storeKeys.length > 0) {
+      lines.push(`  ${dt("doctor.cite.metric.byStore")}:`);
+      for (const store of storeKeys) {
+        lines.push(`    ${store}: ${report.metrics.by_store[store].qualifying_cites}`);
+      }
+    }
+  }
   if (report.per_client !== void 0 && Object.keys(report.per_client).length > 1) {
     lines.push("");
     lines.push(`### ${dt("doctor.cite.section.perClient")}`);
@@ -794,6 +907,38 @@ function appendContractSection(lines, report, dt) {
     );
   }
 }
+function renderConflictLintReport(report, deepRequested, dt) {
+  const lines = [];
+  lines.push(dt("doctor.conflict.header"));
+  lines.push("");
+  if (report.candidate_count === 0) {
+    lines.push(`  ${symbol.ok} ${dt("doctor.conflict.none")}`);
+    writeStdout(lines.join("\n"));
+    return;
+  }
+  lines.push(
+    `  ${dt("doctor.conflict.summary", {
+      candidates: String(report.candidate_count),
+      conflicts: String(report.conflict_count),
+      threshold: report.threshold.toFixed(2)
+    })}`
+  );
+  if (deepRequested && !report.deep) {
+    lines.push(`  ${symbol.warn} ${dt("doctor.conflict.deep_no_judge")}`);
+  }
+  lines.push("");
+  for (const pair of report.pairs) {
+    const sym = pair.verdict === "conflict" ? symbol.error : symbol.warn;
+    const verdictLabel = dt(`doctor.conflict.verdict.${pair.verdict}`);
+    const pct = `${(pair.similarity * 100).toFixed(0)}%`;
+    let line = `  ${sym} [${pair.a} \u2194 ${pair.b}] (${pair.knowledge_type}/${pair.layer}) ${pct} \u2014 ${verdictLabel}`;
+    if (pair.rationale !== void 0 && pair.rationale.length > 0) {
+      line += `: ${pair.rationale}`;
+    }
+    lines.push(line);
+  }
+  writeStdout(lines.join("\n"));
+}
 function renderEnrichDescriptionsReport(report, dt) {
   const header = `${symbol.ok} ${paint.ai("fabric doctor --enrich-descriptions")} mode=${report.mode}${report.dryRun ? " (dry-run)" : ""} scanned=${report.scanned} modified=${report.modified} skipped=${report.skipped}`;
   writeStdout(header);
@@ -913,8 +1058,39 @@ function formatTimestampForTable(iso) {
     d.getUTCHours()
   )}:${pad(d.getUTCMinutes())}`;
 }
+function renderDoctorFilteredHelp() {
+  const lines = [];
+  lines.push(paint.ai("fabric doctor") + " \u2014 Diagnose and fix Fabric workspace issues");
+  lines.push("");
+  lines.push(`${paint.human("USAGE")}`);
+  lines.push(`  fabric doctor [OPTIONS]`);
+  lines.push("");
+  lines.push(`${paint.human("OPTIONS")}`);
+  lines.push("");
+  const exposedOptions = [
+    ["--target <path>", "Override project root (defaults to cwd)"],
+    ["--fix", "Auto-fix derived-state issues (agents.meta.json)"],
+    ["--fix-knowledge", "Auto-fix knowledge entry issues (frontmatter + git mv)"],
+    ["--json", "Output as JSON for programmatic consumption"],
+    ["--verbose", "Show maintainer-audience action hints"]
+  ];
+  for (const [flag, desc] of exposedOptions) {
+    lines.push(`  ${paint.ai(flag)}  ${desc}`);
+  }
+  lines.push("");
+  lines.push(`${paint.human("EXAMPLES")}`);
+  lines.push(`  ${paint.ai("fabric doctor")}                  # Run diagnostics`);
+  lines.push(`  ${paint.ai("fabric doctor --fix")}            # Fix derived-state issues`);
+  lines.push(`  ${paint.ai("fabric doctor --fix-knowledge")}  # Fix knowledge entry issues`);
+  lines.push("");
+  lines.push(paint.human("Run `fabric doctor` to see a full diagnostic report with 48 checks."));
+  writeStdout(lines.join("\n"));
+}
+
 export {
-  doctor_default as default,
   doctorCommand,
-  parseSinceDuration
+  doctor_default,
+  renderTldrHeader,
+  parseSinceDuration,
+  renderDoctorFilteredHelp
 };

package/dist/chunk-EOT63RDH.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+
+// src/store/scope-explain.ts
+import {
+  SCOPE_COORDINATE_PATTERN,
+  buildStoreResolveInput,
+  createStoreResolver,
+  resolveGlobalRoot
+} from "@fenglimg/fabric-shared";
+import { GenericConfigError } from "@fenglimg/fabric-shared/errors";
+function buildResolveInput(projectRoot, globalRoot = resolveGlobalRoot()) {
+  return buildStoreResolveInput(projectRoot, globalRoot);
+}
+function scopeExplain(projectRoot, scope, globalRoot = resolveGlobalRoot()) {
+  if (!SCOPE_COORDINATE_PATTERN.test(scope)) {
+    throw new GenericConfigError(`invalid scope coordinate '${scope}'`, {
+      actionHint: "use ':'-joined lowercase [a-z0-9_-] segments, e.g. `team`, `personal`, `project:fabric-v2`, `org:acme:team:platform`",
+      details: { scope }
+    });
+  }
+  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-FNHDQTPC.js

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+
+// src/store/global-config-io.ts
+import {
+  resolveGlobalRoot,
+  globalConfigPath,
+  loadGlobalConfig,
+  saveGlobalConfig
+} from "@fenglimg/fabric-shared";
+
+export {
+  resolveGlobalRoot,
+  globalConfigPath,
+  loadGlobalConfig,
+  saveGlobalConfig
+};

package/dist/chunk-HORSMSZL.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+
+// src/i18n.ts
+import {
+  createTranslator,
+  resolveGlobalLocale
+} from "@fenglimg/fabric-shared";
+var locale = resolveGlobalLocale();
+var t = createTranslator(locale);
+function refreshLocale() {
+  locale = resolveGlobalLocale();
+  t = createTranslator(locale);
+}
+function getProjectTranslator(_projectRoot = process.cwd()) {
+  return createTranslator(resolveGlobalLocale());
+}
+function getDoctorTranslator(projectRoot) {
+  return getProjectTranslator(projectRoot);
+}
+
+export {
+  t,
+  refreshLocale,
+  getProjectTranslator,
+  getDoctorTranslator
+};

package/dist/chunk-NLNH64A3.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+// src/colors.ts
+import pc from "picocolors";
+import stringWidth from "string-width";
+function isColorEnabled() {
+  if (process.env.NO_COLOR) {
+    return false;
+  }
+  const force = process.env.FORCE_COLOR;
+  if (force !== void 0) {
+    return force !== "0" && force.toLowerCase() !== "false";
+  }
+  return Boolean(process.stdout.isTTY);
+}
+function colorize(painter) {
+  return (value) => isColorEnabled() ? painter(value) : value;
+}
+var paint = {
+  success: colorize(pc.green),
+  warn: colorize(pc.yellow),
+  error: colorize(pc.red),
+  drift: colorize(pc.magenta),
+  ai: colorize(pc.blue),
+  human: colorize(pc.cyan),
+  muted: colorize(pc.dim)
+};
+var symbol = {
+  get ok() {
+    return isColorEnabled() ? paint.success("[ok] \u2713") : "[ok]";
+  },
+  get warn() {
+    return isColorEnabled() ? paint.warn("[warn] !") : "[warn]";
+  },
+  get error() {
+    return isColorEnabled() ? paint.error("[error] x") : "[error]";
+  }
+};
+
+export {
+  paint,
+  symbol
+};

package/dist/{chunk-WU6GAPKH.js → chunk-PTGQAZEW.js}

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