@fenglimg/fabric-cli 0.1.3 → 1.0.0

package/dist/{bootstrap-BBFPEJQP.js → bootstrap-PMIA4W6G.js}

@@ -1,10 +1,13 @@
 #!/usr/bin/env node
 import {
   resolveClients
-} from "./chunk-3FZPYATY.js";
+} from "./chunk-VMYPJPKV.js";
 import {
   readFabricConfig
 } from "./chunk-AEOYCVBG.js";
+import {
+  t
+} from "./chunk-6ICJICVU.js";
 
 // src/commands/bootstrap.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
@@ -50,18 +53,18 @@ var CLIENT_TARGET_MAP = {
 var bootstrapCommand = defineCommand({
   meta: {
     name: "bootstrap",
-    description: "Install Fabric bootstrap prompt templates for supported AI clients."
+    description: t("cli.bootstrap.description")
   },
   subCommands: {
     install: defineCommand({
       meta: {
         name: "install",
-        description: "Copy Fabric bootstrap templates into client-native locations."
+        description: t("cli.bootstrap.install.description")
       },
       args: {
         clients: {
           type: "string",
-          description: "Optional comma-separated client filter, e.g. claude,cursor,codex."
+          description: t("cli.bootstrap.install.args.clients.description")
         }
       },
       async run({ args }) {
@@ -72,7 +75,8 @@ var bootstrapCommand = defineCommand({
         const clients = selectedClients ?? detectedClients;
         if (clients.size === 0) {
           process.stderr.write(
-            "No bootstrap targets detected. Pass --clients claude,cursor,windsurf,roo,gemini,codex to install explicitly.\n"
+            `${t("cli.bootstrap.install.no-targets")}
+`
           );
           return;
         }
@@ -93,7 +97,7 @@ function parseClientFilter(value) {
     const alias = rawClient.trim().toLowerCase();
     const client = CLIENT_ALIASES[alias];
     if (client === void 0) {
-      throw new Error(`Unknown client "${rawClient}". Use a comma-separated list such as claude,cursor,codex.`);
+      throw new Error(t("cli.bootstrap.errors.unknown-client", { client: rawClient }));
     }
     clients.add(client);
   }
@@ -138,26 +142,26 @@ function installBootstrap(client, workspaceRoot) {
     return;
   }
   writeFileSync(targetPath, ensureTrailingNewline(template), "utf8");
-  process.stderr.write(`Installed ${targetPath}
+  process.stderr.write(`${t("cli.bootstrap.install.installed", { path: targetPath })}
 `);
 }
 function writeCodexBootstrap(targetPath, template) {
   const nextContent = ensureTrailingNewline(template);
   if (!existsSync(targetPath)) {
     writeFileSync(targetPath, nextContent, "utf8");
-    process.stderr.write(`Installed ${targetPath}
+    process.stderr.write(`${t("cli.bootstrap.install.installed", { path: targetPath })}
 `);
     return;
   }
   const existing = readFileSync(targetPath, "utf8");
   if (existing.includes("# Fabric Bootstrap")) {
-    process.stderr.write(`Skipped ${targetPath}: Fabric Bootstrap header already present.
+    process.stderr.write(`${t("cli.bootstrap.install.skipped-header", { path: targetPath })}
 `);
     return;
   }
   const separator = existing.startsWith("\n") || existing.length === 0 ? "" : "\n";
   writeFileSync(targetPath, `${nextContent}${separator}${existing}`, "utf8");
-  process.stderr.write(`Prepended ${targetPath}
+  process.stderr.write(`${t("cli.bootstrap.install.prepended", { path: targetPath })}
 `);
 }
 function ensureTrailingNewline(content) {
@@ -175,7 +179,7 @@ function findTemplatePath(relativePath) {
       return candidate;
     }
   }
-  throw new Error(`Template not found: ${relativePath}`);
+  throw new Error(t("cli.shared.template-not-found", { path: relativePath }));
 }
 function templateCandidatesFrom(start, relativePath) {
   const candidates = [];
@@ -188,7 +192,7 @@ function templateCandidatesFrom(start, relativePath) {
     }
     current = parent;
   }
-  return candidates;
+  return candidates.reverse();
 }
 export {
   bootstrapCommand,

package/dist/{chunk-ZW4M4WZB.js → chunk-5BSTO745.js}

@@ -2,6 +2,9 @@
 import {
   resolveIgnores
 } from "./chunk-P4KVFB2T.js";
+import {
+  t
+} from "./chunk-6ICJICVU.js";
 
 // src/commands/sync-meta.ts
 import { createHash } from "crypto";
@@ -11,17 +14,17 @@ import { defineCommand } from "citty";
 var syncMetaCommand = defineCommand({
   meta: {
     name: "sync-meta",
-    description: "Sync Fabric metadata from AGENTS.md files."
+    description: t("cli.sync-meta.description")
   },
   args: {
     target: {
       type: "string",
-      description: "Target project path. Defaults to the current working directory.",
+      description: t("cli.sync-meta.args.target.description"),
       default: process.cwd()
     },
     "check-only": {
       type: "boolean",
-      description: "Exit with code 1 if .fabric/agents.meta.json is stale.",
+      description: t("cli.sync-meta.args.check-only.description"),
       default: false
     }
   },
@@ -32,7 +35,7 @@ var syncMetaCommand = defineCommand({
     const existingMeta = readExistingMeta(metaPath);
     if (args["check-only"]) {
       if (!existingMeta || stableStringify(existingMeta) !== stableStringify(computedMeta)) {
-        writeStderr("Fabric metadata drift detected. Run fab sync-meta to update.");
+        writeStderr(t("cli.sync-meta.drift-detected"));
         process.exitCode = 1;
       }
       return;
@@ -43,7 +46,7 @@ var syncMetaCommand = defineCommand({
     mkdirSync(join(target, ".fabric"), { recursive: true });
     writeFileSync(metaPath, `${JSON.stringify(computedMeta, null, 2)}
 `, "utf8");
-    writeStderr(`Updated ${metaPath}`);
+    writeStderr(t("cli.sync-meta.updated", { label: t("cli.shared.updated"), path: metaPath }));
   }
 });
 var sync_meta_default = syncMetaCommand;
@@ -77,7 +80,7 @@ function normalizeTarget(targetInput) {
 }
 function assertExistingDirectory(target) {
   if (!existsSync(target) || !statSync(target).isDirectory()) {
-    throw new Error(`Target must be an existing directory: ${target}`);
+    throw new Error(t("cli.shared.target-invalid", { target }));
   }
 }
 function readExistingMeta(metaPath) {

package/dist/chunk-6ICJICVU.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+// src/i18n.ts
+import { createTranslator, detectNodeLocale } from "@fenglimg/fabric-shared";
+var locale = detectNodeLocale();
+var t = createTranslator(locale);
+
+export {
+  t
+};

package/dist/{chunk-SC4A43WR.js → chunk-DKQ3HOTK.js}

@@ -7,80 +7,31 @@ import {
 import {
   resolveIgnores
 } from "./chunk-P4KVFB2T.js";
+import {
+  displayWidth,
+  padEnd,
+  paint,
+  symbol
+} from "./chunk-WWNXR34K.js";
+import {
+  t
+} from "./chunk-6ICJICVU.js";
 
 // src/commands/scan.ts
-import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2, statSync } from "fs";
-import { isAbsolute, join as join2, relative, resolve, sep } from "path";
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
+import { isAbsolute, join, relative, resolve, sep } from "path";
 import { defineCommand } from "citty";
 
 // src/scanner/detector.ts
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
-function detectFramework(root) {
-  const evidence = [];
-  if (existsSync(join(root, "project.config.json"))) {
-    return {
-      kind: "cocos-creator",
-      evidence: ["project.config.json"]
-    };
-  }
-  const packageJsonPath = join(root, "package.json");
-  if (existsSync(packageJsonPath)) {
-    const packageJson = readPackageJson(packageJsonPath);
-    const deps = collectDependencyNames(packageJson);
-    for (const [dependencyName, kind] of [
-      ["next", "next"],
-      ["vite", "vite"],
-      ["react", "react"],
-      ["vue", "vue"]
-    ]) {
-      if (deps.has(dependencyName)) {
-        evidence.push(`package.json dependency: ${dependencyName}`);
-        return { kind, evidence };
-      }
-    }
-    evidence.push("package.json");
-  }
-  if (existsSync(join(root, "Cargo.toml"))) {
-    return {
-      kind: "rust",
-      evidence: ["Cargo.toml"]
-    };
-  }
-  if (existsSync(join(root, "pyproject.toml"))) {
-    return {
-      kind: "python",
-      evidence: ["pyproject.toml"]
-    };
-  }
-  return {
-    kind: "unknown",
-    evidence
-  };
-}
-function readPackageJson(packageJsonPath) {
-  try {
-    return JSON.parse(readFileSync(packageJsonPath, "utf8"));
-  } catch {
-    return {};
-  }
-}
-function collectDependencyNames(packageJson) {
-  return /* @__PURE__ */ new Set([
-    ...Object.keys(packageJson.dependencies ?? {}),
-    ...Object.keys(packageJson.devDependencies ?? {}),
-    ...Object.keys(packageJson.peerDependencies ?? {}),
-    ...Object.keys(packageJson.optionalDependencies ?? {})
-  ]);
-}
+import { detectFramework } from "@fenglimg/fabric-shared";
 
 // src/commands/scan.ts
 function createScanReport(targetInput = process.cwd(), fabricConfig) {
   const target = normalizeTarget(targetInput);
   const framework = detectFramework(target);
   const readmeQuality = getReadmeQuality(target);
-  const hasContributing = existsSync2(join2(target, "CONTRIBUTING.md"));
-  const hasExistingFabric = existsSync2(join2(target, "AGENTS.md")) || existsSync2(join2(target, ".fabric"));
+  const hasContributing = existsSync(join(target, "CONTRIBUTING.md"));
+  const hasExistingFabric = existsSync(join(target, "AGENTS.md")) || existsSync(join(target, ".fabric"));
   const walkResult = walkFiles(target, resolveIgnores(fabricConfig));
   return {
     target,
@@ -101,21 +52,21 @@ function createScanReport(targetInput = process.cwd(), fabricConfig) {
 var scanCommand = defineCommand({
   meta: {
     name: "scan",
-    description: "Scan a project for Fabric bootstrap candidates."
+    description: t("cli.scan.description")
   },
   args: {
     target: {
       type: "string",
-      description: "Absolute target path to scan. Defaults to CLI target, EXTERNAL_FIXTURE_PATH, fabric.config.json, or cwd."
+      description: t("cli.scan.args.target.description")
     },
     debug: {
       type: "boolean",
-      description: "Print detector evidence in pretty output.",
+      description: t("cli.scan.args.debug.description"),
       default: false
     },
     json: {
       type: "boolean",
-      description: "Print the diagnostic report as JSON.",
+      description: t("cli.scan.args.json.description"),
       default: false
     }
   },
@@ -141,16 +92,16 @@ function normalizeTarget(targetInput) {
   return isAbsolute(targetInput) ? targetInput : resolve(process.cwd(), targetInput);
 }
 function getReadmeQuality(target) {
-  const readmePath = join2(target, "README.md");
-  if (!existsSync2(readmePath)) {
+  const readmePath = join(target, "README.md");
+  if (!existsSync(readmePath)) {
     return "stub";
   }
-  const wordCount = readFileSync2(readmePath, "utf8").trim().split(/\s+/).filter(Boolean).length;
+  const wordCount = readFileSync(readmePath, "utf8").trim().split(/\s+/).filter(Boolean).length;
   return wordCount >= 200 ? "ok" : "stub";
 }
 function walkFiles(root, ignorePatterns) {
-  if (!existsSync2(root) || !statSync(root).isDirectory()) {
-    throw new Error(`Target must be an existing directory: ${root}`);
+  if (!existsSync(root) || !statSync(root).isDirectory()) {
+    throw new Error(t("cli.shared.target-invalid", { target: root }));
   }
   let fileCount = 0;
   let ignoredCount = 0;
@@ -161,7 +112,7 @@ function walkFiles(root, ignorePatterns) {
       continue;
     }
     for (const entry of readdirSync(current, { withFileTypes: true })) {
-      const absolutePath = join2(current, entry.name);
+      const absolutePath = join(current, entry.name);
       const relativePath = toPosixPath(relative(root, absolutePath));
       if (shouldIgnore(relativePath, entry.isDirectory(), ignorePatterns)) {
         ignoredCount += 1;
@@ -196,40 +147,59 @@ function toPosixPath(path) {
 function buildRecommendations(input) {
   const recommendations = [];
   if (!input.hasExistingFabric) {
-    recommendations.push("L0: Run fab init to scaffold AGENTS.md with TODO markers.");
+    recommendations.push(t("cli.scan.recommendation.init"));
   }
   if (input.readmeQuality === "stub") {
-    recommendations.push("L0: Expand README.md before promoting project facts into AGENTS.md references.");
+    recommendations.push(t("cli.scan.recommendation.readme"));
   }
   if (!input.hasContributing) {
-    recommendations.push("L0: Add CONTRIBUTING.md or leave an AGENTS.md TODO reference for contribution flow.");
+    recommendations.push(t("cli.scan.recommendation.contributing"));
   }
   if (input.framework.kind === "unknown") {
-    recommendations.push("L1: Add tech-stack TODOs manually because no framework marker was detected.");
+    recommendations.push(t("cli.scan.recommendation.unknown-framework"));
   } else {
-    recommendations.push(`L1: Review ${input.framework.kind} directories for future scoped AGENTS.md files.`);
+    recommendations.push(t("cli.scan.recommendation.framework-dirs", { framework: input.framework.kind }));
   }
   return recommendations;
 }
 function printPrettyReport(report, debug) {
-  console.log("Fabric scan report");
-  console.log(`Target: ${report.target}`);
-  console.log(`Framework: ${report.framework.kind}`);
+  console.log(paint.ai(t("cli.scan.report.title")));
+  const rows = [
+    [t("cli.scan.report.target"), paint.human(report.target)],
+    [t("cli.scan.report.framework"), paint.ai(report.framework.kind)],
+    [
+      t("cli.scan.report.readme-quality"),
+      report.readmeQuality === "ok" ? paint.success(t("cli.scan.readme-quality.ok")) : paint.warn(t("cli.scan.readme-quality.stub"))
+    ],
+    [
+      t("cli.scan.report.contributing"),
+      report.hasContributing ? paint.success(t("cli.shared.present")) : paint.warn(t("cli.shared.absent"))
+    ],
+    [t("cli.scan.report.files-counted"), String(report.fileCount)],
+    [t("cli.scan.report.ignored-entries"), report.ignoredCount > 0 ? paint.muted(String(report.ignoredCount)) : "0"],
+    [
+      t("cli.scan.report.existing-fabric"),
+      report.hasExistingFabric ? paint.warn(t("cli.shared.yes")) : paint.success(t("cli.shared.no"))
+    ]
+  ];
   if (debug) {
-    console.log(`Evidence: ${report.framework.evidence.length > 0 ? report.framework.evidence.join(", ") : "none"}`);
+    rows.splice(2, 0, [
+      t("cli.scan.report.evidence"),
+      report.framework.evidence.length > 0 ? paint.muted(report.framework.evidence.join(", ")) : paint.muted(t("cli.shared.none"))
+    ]);
+  }
+  const labelWidth = Math.max(...rows.map(([key]) => displayWidth(key)));
+  for (const [key, value] of rows) {
+    console.log(`${paint.muted(padEnd(key, labelWidth))} ${value}`);
   }
-  console.log(`README quality: ${report.readmeQuality}`);
-  console.log(`CONTRIBUTING.md: ${report.hasContributing ? "present" : "missing"}`);
-  console.log(`Files counted: ${report.fileCount}`);
-  console.log(`Ignored entries: ${report.ignoredCount}`);
-  console.log(`Existing Fabric files: ${report.hasExistingFabric ? "yes" : "no"}`);
-  console.log("Recommendations:");
+  console.log(paint.muted(t("cli.scan.report.recommendations")));
   for (const recommendation of report.recommendations) {
-    console.log(`- ${recommendation}`);
+    console.log(`${symbol.warn} ${paint.drift(recommendation)}`);
   }
 }
 
 export {
+  detectFramework,
   createScanReport,
   scanCommand,
   scan_default

package/dist/{chunk-PJ4J4377.js → chunk-F2BXHPM5.js}

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  t
+} from "./chunk-6ICJICVU.js";
 
 // src/commands/ledger-append.ts
 import { execSync } from "child_process";
@@ -10,17 +13,17 @@ var INITIAL_PARENT_SHA = "root";
 var ledgerAppendCommand = defineCommand({
   meta: {
     name: "ledger-append",
-    description: "Append a Fabric intent ledger entry."
+    description: t("cli.ledger-append.description")
   },
   args: {
     target: {
       type: "string",
-      description: "Target project path. Defaults to the current working directory.",
+      description: t("cli.ledger-append.args.target.description"),
       default: process.cwd()
     },
     staged: {
       type: "boolean",
-      description: "Derive the entry from staged changes for pre-commit.",
+      description: t("cli.ledger-append.args.staged.description"),
       default: false
     }
   },
@@ -28,7 +31,7 @@ var ledgerAppendCommand = defineCommand({
     const target = normalizeTarget(args.target);
     assertExistingDirectory(target);
     if (!args.staged) {
-      writeStderr("requires --staged in pre-commit context");
+      writeStderr(t("cli.ledger-append.requires-staged"));
       process.exitCode = 1;
       return;
     }
@@ -40,6 +43,7 @@ var ledgerAppendCommand = defineCommand({
     const diffStat = readDiffStat(target).trim();
     const entry = {
       ts: Date.now(),
+      source: "human",
       parent_sha: readParentSha(target),
       intent,
       affected_paths: stagedFiles,
@@ -59,7 +63,7 @@ function normalizeTarget(targetInput) {
 }
 function assertExistingDirectory(target) {
   if (!existsSync(target) || !statSync(target).isDirectory()) {
-    throw new Error(`Target must be an existing directory: ${target}`);
+    throw new Error(t("cli.shared.target-invalid", { target }));
   }
 }
 function getStagedFiles(target) {
@@ -83,8 +87,8 @@ function deriveIntent(stagedFiles) {
   }
   const uniqueNames = Array.from(new Set(stagedFiles.map((file) => basename(file))));
   const head = uniqueNames.slice(0, 2).join(", ");
-  const suffix = uniqueNames.length > 2 ? ` +${uniqueNames.length - 2} more` : "";
-  return `auto: ${head}${suffix}`;
+  const suffix = uniqueNames.length > 2 ? t("cli.ledger-append.intent.auto-more", { count: String(uniqueNames.length - 2) }) : "";
+  return t("cli.ledger-append.intent.auto", { head, suffix });
 }
 function hasMatchingTailEntry(target, entry) {
   const ledgerPath = join(target, LEDGER_FILE);

package/dist/{chunk-YHIKLBTB.js → chunk-L43IGJ6X.js}

@@ -1,4 +1,10 @@
 #!/usr/bin/env node
+import {
+  padEnd
+} from "./chunk-WWNXR34K.js";
+import {
+  t
+} from "./chunk-6ICJICVU.js";
 
 // src/commands/human-lint.ts
 import { createHash } from "crypto";
@@ -6,15 +12,16 @@ import { existsSync } from "fs";
 import { readFile } from "fs/promises";
 import { isAbsolute, join, resolve } from "path";
 import { defineCommand } from "citty";
+import { humanLockEntrySchema } from "@fenglimg/fabric-shared";
 var humanLintCommand = defineCommand({
   meta: {
     name: "human-lint",
-    description: "Validate locked human sections."
+    description: t("cli.human-lint.description")
   },
   args: {
     target: {
       type: "string",
-      description: "Target project path. Defaults to the current working directory.",
+      description: t("cli.human-lint.args.target.description"),
       default: process.cwd()
     }
   },
@@ -60,11 +67,13 @@ var humanLintCommand = defineCommand({
     if (violations.length === 0) {
       return;
     }
-    writeStderr("Human-locked content drift detected. Revert the edit or update approved hashes before committing.");
-    writeStderr("Location                         Expected            Got");
+    writeStderr(t("cli.human-lint.drift-detected"));
+    writeStderr(
+      `${padEnd(t("cli.human-lint.table.location"), 32)} ${padEnd(t("cli.human-lint.table.expected"), 18)} ${t("cli.human-lint.table.got")}`
+    );
     for (const violation of violations) {
       writeStderr(
-        `${violation.location.padEnd(32)} ${violation.expected.padEnd(18)} ${violation.actual}`
+        `${padEnd(violation.location, 32)} ${padEnd(violation.expected, 18)} ${violation.actual}`
       );
     }
     process.exitCode = 1;
@@ -81,7 +90,7 @@ function hashLockedContent(content, entry) {
 }
 function shortenHash(value) {
   if (value === "missing") {
-    return value;
+    return t("cli.shared.missing");
   }
   return value.slice(0, 15);
 }
@@ -92,5 +101,6 @@ function writeStderr(message) {
 
 export {
   humanLintCommand,
-  human_lint_default
+  human_lint_default,
+  humanLockEntrySchema
 };

package/dist/{chunk-3FZPYATY.js → chunk-VMYPJPKV.js}

@@ -89,9 +89,15 @@ var ClaudeCodeCLIWriter = class extends JsonClientConfigWriter {
   constructor(configuredPath) {
     super(configuredPath);
   }
-  defaultPath() {
-    const claudeDir = join(homedir(), ".claude");
-    return existsSync(claudeDir) ? join(claudeDir, "settings.json") : null;
+  // Writes to project-level .claude/settings.json so MCP is scoped to the project.
+  // Detection in resolver still checks ~/ to confirm Claude Code is installed.
+  defaultPath(workspaceRoot) {
+    const globalClaudeDir = join(homedir(), ".claude");
+    const projectClaudeDir = join(workspaceRoot, ".claude");
+    if (!existsSync(globalClaudeDir) && !existsSync(projectClaudeDir)) {
+      return null;
+    }
+    return join(projectClaudeDir, "settings.json");
   }
 };
 var CursorWriter = class extends JsonClientConfigWriter {
@@ -234,6 +240,7 @@ var CodexTOMLConfigWriter = class {
 };
 
 // src/config/resolver.ts
+import { clientPathsSchema, fabricConfigSchema } from "@fenglimg/fabric-shared";
 function hasExplicitPath(clientPaths, key) {
   return typeof clientPaths?.[key] === "string" && clientPaths[key].trim().length > 0;
 }
@@ -247,7 +254,7 @@ function resolveClients(workspaceRoot, fabricConfig = {}) {
   const writers = [];
   addIfDetected(
     writers,
-    existsSync4(join4(homedir4(), ".claude")),
+    existsSync4(join4(homedir4(), ".claude")) || existsSync4(join4(workspaceRoot, ".claude")),
     (configuredPath) => new ClaudeCodeCLIWriter(configuredPath),
     hasExplicitPath(clientPaths, "claudeCodeCLI") ? clientPaths.claudeCodeCLI : void 0
   );

package/dist/chunk-WWNXR34K.js

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+
+// src/colors.ts
+import pc from "picocolors";
+import stringWidth from "string-width";
+function isColorEnabled() {
+  return !process.env.NO_COLOR && Boolean(process.stdout.isTTY) && Boolean(process.stderr.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("\u2713") : "[ok]";
+  },
+  get warn() {
+    return isColorEnabled() ? paint.warn("!") : "[warn]";
+  },
+  get error() {
+    return isColorEnabled() ? paint.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
+};