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

package/dist/{chunk-2CY4BMTH.js → chunk-HORSMSZL.js}

@@ -3,13 +3,16 @@
 // src/i18n.ts
 import {
   createTranslator,
-  detectNodeLocale,
-  resolveFabricLocale
+  resolveGlobalLocale
 } from "@fenglimg/fabric-shared";
-var locale = detectNodeLocale();
+var locale = resolveGlobalLocale();
 var t = createTranslator(locale);
-function getProjectTranslator(projectRoot = process.cwd()) {
-  return createTranslator(resolveFabricLocale(projectRoot));
+function refreshLocale() {
+  locale = resolveGlobalLocale();
+  t = createTranslator(locale);
+}
+function getProjectTranslator(_projectRoot = process.cwd()) {
+  return createTranslator(resolveGlobalLocale());
 }
 function getDoctorTranslator(projectRoot) {
   return getProjectTranslator(projectRoot);
@@ -17,6 +20,7 @@ function getDoctorTranslator(projectRoot) {
 
 export {
   t,
+  refreshLocale,
   getProjectTranslator,
   getDoctorTranslator
 };

package/dist/{doctor-J4O3X54I.js → chunk-JTHWLUD3.js}

@@ -1,26 +1,32 @@
 #!/usr/bin/env node
 import {
-  paint,
-  symbol
-} from "./chunk-BO4XIZWZ.js";
+  ensureStoreProjectBinding,
+  migrateRootConfig
+} from "./chunk-FEOPLBGA.js";
 import {
   resolveDevMode
-} from "./chunk-COI5VDFU.js";
+} from "./chunk-WA3DYGSY.js";
 import {
-  getDoctorTranslator,
-  t
-} from "./chunk-2CY4BMTH.js";
+  paint,
+  symbol
+} from "./chunk-NLNH64A3.js";
 import {
   detectAliasLinkDrift,
   missingRequiredStores,
   syncStoreAliasLinks,
   unboundAvailableStores
-} from "./chunk-5ZUMLCD5.js";
+} from "./chunk-QPAW6IYT.js";
+import {
+  loadProjectConfig
+} from "./chunk-QFIVFZRH.js";
 import {
   loadGlobalConfig,
-  loadProjectConfig,
   resolveGlobalRoot
-} from "./chunk-XCBVSGCS.js";
+} from "./chunk-FNHDQTPC.js";
+import {
+  getDoctorTranslator,
+  t
+} from "./chunk-HORSMSZL.js";
 
 // src/commands/doctor.ts
 import { confirm, isCancel } from "@clack/prompts";
@@ -37,9 +43,24 @@ import {
   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);
@@ -85,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",
@@ -101,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"
@@ -133,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"),
@@ -181,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"),
@@ -210,25 +211,16 @@ 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"
     },
-    // v2.1 ④ conflict-detection (P4): knowledge-conflict lint surface.
     "lint-conflicts": {
       type: "boolean",
       description: t("cli.doctor.args.lint-conflicts.description"),
@@ -238,6 +230,12 @@ var doctorCommand = defineCommand({
       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 }) {
@@ -415,6 +413,8 @@ 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);
@@ -447,6 +447,8 @@ var doctorCommand = defineCommand({
       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();
@@ -458,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
         )
@@ -472,6 +479,19 @@ var doctorCommand = defineCommand({
         renderFixKnowledgeMutations(fixKnowledgeReport, dt);
       } else if (fixReport !== null) {
         writeStdout(fixReport.message);
+        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"));
       }
@@ -503,6 +523,9 @@ function renderHumanReport(report, dt, verbose) {
   writeStdout(`${renderStatus(report.status)} ${paint.ai("fabric doctor")} ${paint.human(report.summary.target)}`);
   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 };
@@ -525,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}`);
   }
@@ -705,7 +728,6 @@ async function resolveFixKnowledgeConsent(options) {
 var CITE_COVERAGE_CLIENT_FILTERS = /* @__PURE__ */ new Set([
   "cc",
   "codex",
-  "cursor",
   "all"
 ]);
 function isValidClientFilter(input) {
@@ -1036,9 +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,
+  doctor_default,
+  renderTldrHeader,
   parseSinceDuration,
-  renderTldrHeader
+  renderDoctorFilteredHelp
 };

package/dist/{chunk-BO4XIZWZ.js → chunk-NLNH64A3.js}

@@ -11,7 +11,7 @@ function isColorEnabled() {
   if (force !== void 0) {
     return force !== "0" && force.toLowerCase() !== "false";
   }
-  return Boolean(process.stdout.isTTY) && Boolean(process.stderr.isTTY);
+  return Boolean(process.stdout.isTTY);
 }
 function colorize(painter) {
   return (value) => isColorEnabled() ? painter(value) : value;
@@ -27,30 +27,17 @@ var paint = {
 };
 var symbol = {
   get ok() {
-    return isColorEnabled() ? paint.success("\u2713") : "[ok]";
+    return isColorEnabled() ? paint.success("[ok] \u2713") : "[ok]";
   },
   get warn() {
-    return isColorEnabled() ? paint.warn("!") : "[warn]";
+    return isColorEnabled() ? paint.warn("[warn] !") : "[warn]";
   },
   get error() {
-    return isColorEnabled() ? paint.error("x") : "[error]";
+    return isColorEnabled() ? paint.error("[error] x") : "[error]";
   }
 };
-function displayWidth(value) {
-  return stringWidth(value);
-}
-function padEnd(value, width, char = " ") {
-  const fill = char.length > 0 ? char : " ";
-  let result = value;
-  while (displayWidth(result) < width) {
-    result += fill;
-  }
-  return result;
-}
 
 export {
   paint,
-  symbol,
-  displayWidth,
-  padEnd
+  symbol
 };

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

@@ -3,12 +3,17 @@ import {
   buildResolveInput
 } from "./chunk-EOT63RDH.js";
 import {
-  loadProjectConfig,
+  loadProjectConfig
+} from "./chunk-QFIVFZRH.js";
+import {
   resolveGlobalRoot
-} from "./chunk-XCBVSGCS.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();
@@ -20,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

package/dist/chunk-QFIVFZRH.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+
+// src/store/project-config-io.ts
+import {
+  projectConfigPath,
+  loadProjectConfig,
+  saveProjectConfig
+} from "@fenglimg/fabric-shared";
+
+export {
+  loadProjectConfig,
+  saveProjectConfig
+};