@fenglimg/fabric-cli 2.0.0 → 2.0.1

package/dist/chunk-EYIDD2YS.js

@@ -1,1000 +0,0 @@
-#!/usr/bin/env node
-import {
-  paint,
-  symbol
-} from "./chunk-WWNXR34K.js";
-import {
-  t
-} from "./chunk-6ICJICVU.js";
-import {
-  createDebugLogger,
-  readFabricConfig,
-  resolveDevMode
-} from "./chunk-OBQU6NHO.js";
-
-// src/commands/scan.ts
-import { createHash } from "crypto";
-import { existsSync, readdirSync, readFileSync, statSync } from "fs";
-import { mkdir, readFile } from "fs/promises";
-import { dirname, isAbsolute, join, relative, resolve, sep } from "path";
-import { defineCommand } from "citty";
-import {
-  KnowledgeIdAllocator,
-  appendEventLedgerEvent,
-  writeKnowledgeMeta
-} from "@fenglimg/fabric-server";
-import {
-  formatKnowledgeId
-} from "@fenglimg/fabric-shared";
-import { atomicWriteJson, atomicWriteText } from "@fenglimg/fabric-shared/node/atomic-write";
-
-// src/scanner/detector.ts
-import { detectFramework } from "@fenglimg/fabric-shared/node";
-
-// src/scanner/ignores.ts
-var DEFAULT_IGNORES = [
-  "**/*.meta",
-  "library/**",
-  "temp/**",
-  "build/**",
-  "settings/**",
-  "profiles/**",
-  "node_modules/**",
-  "dist/**",
-  ".git/**",
-  ".fabric/**"
-];
-function resolveIgnores(fabricConfig) {
-  return [...DEFAULT_IGNORES, ...fabricConfig?.scanIgnores ?? []];
-}
-
-// src/commands/scan.ts
-async function createScanReport(targetInput = process.cwd(), fabricConfig) {
-  const target = normalizeTarget(targetInput);
-  const framework = detectFramework(target);
-  const readmeQuality = getReadmeQuality(target);
-  const hasContributing = existsSync(join(target, "CONTRIBUTING.md"));
-  const hasExistingFabric = existsSync(join(target, ".fabric", "bootstrap", "README.md")) || existsSync(join(target, ".fabric"));
-  const walkResult = walkFiles(target, resolveIgnores(fabricConfig));
-  return {
-    target,
-    framework,
-    readmeQuality,
-    hasContributing,
-    fileCount: walkResult.fileCount,
-    ignoredCount: walkResult.ignoredCount,
-    hasExistingFabric,
-    recommendations: buildRecommendations({
-      framework,
-      readmeQuality,
-      hasContributing,
-      hasExistingFabric
-    })
-  };
-}
-var KNOWLEDGE_DIR = ".fabric/knowledge";
-var SCAN_STATE_FILE = ".scan-state.json";
-var FORENSIC_FILE = ".fabric/forensic.json";
-var AGENTS_META_FILE = ".fabric/agents.meta.json";
-var LAYER_REASON = "project artifact (deterministic init scan)";
-async function runInitScan(targetInput, options = {}) {
-  const startTs = Date.now();
-  const target = normalizeTarget(targetInput);
-  const forensicPath = join(target, FORENSIC_FILE);
-  if (!existsSync(forensicPath)) {
-    throw new Error(t("cli.scan.error.missing-forensic", { path: forensicPath }));
-  }
-  const forensic = await readForensic(forensicPath);
-  const nowIso = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
-  const tags = deriveTagsFromForensic(forensic);
-  const fabricConfig = readFabricConfig(target);
-  const knowledgeLanguage = fabricConfig.knowledge_language ?? "match-existing";
-  const resolvedLanguage = resolveKnowledgeLanguage(knowledgeLanguage, target);
-  const candidates = [
-    buildTechStackEntry(forensic, nowIso, tags, resolvedLanguage),
-    buildModuleStructureEntry(forensic, nowIso, tags, resolvedLanguage),
-    buildBuildConfigEntry(forensic, nowIso, tags, resolvedLanguage),
-    buildCodeStyleEntry(forensic, nowIso, tags, resolvedLanguage),
-    buildCIConfigEntry(forensic, nowIso, tags),
-    buildReadmeFirstParaEntry(target, forensic, nowIso, tags, resolvedLanguage),
-    buildProjectBriefEntry(target, forensic, nowIso, tags)
-  ];
-  const entries = candidates.filter((e) => e !== null);
-  const sidecarPath = join(target, KNOWLEDGE_DIR, SCAN_STATE_FILE);
-  const sidecar = await readScanState(sidecarPath);
-  const allocator = new KnowledgeIdAllocator(join(target, AGENTS_META_FILE));
-  const written = [];
-  const skipped = [];
-  const placedEntries = [];
-  for (const entry of entries) {
-    const targetPath = join(target, KNOWLEDGE_DIR, entry.target_subdir, `${entry.slug}.md`);
-    const existingId = findExistingIdForFile(sidecar, targetPath, target);
-    const id = existingId ?? await allocator.allocate(entry.layer, entry.type);
-    const built = { ...entry, id };
-    placedEntries.push(built);
-    const fullContent = renderMarkdown(built);
-    const bodyHash = sha256(stripFrontmatter(fullContent));
-    const sidecarKey = id;
-    if (sidecar[sidecarKey] === bodyHash && existsSync(targetPath)) {
-      skipped.push(id);
-      continue;
-    }
-    await ensureParentDirectory(targetPath);
-    await atomicWriteText(targetPath, fullContent);
-    sidecar[sidecarKey] = bodyHash;
-    written.push(id);
-  }
-  await ensureParentDirectory(sidecarPath);
-  await atomicWriteJson(sidecarPath, sidecar);
-  await registerKnowledgeNodesInMeta(target, placedEntries);
-  await writeKnowledgeMeta(target, { source: "doctor_fix" });
-  const durationMs = Date.now() - startTs;
-  await appendEventLedgerEvent(target, {
-    event_type: "init_scan_completed",
-    written_stable_ids: written,
-    duration_ms: durationMs,
-    source: options.source ?? "scan"
-  });
-  return {
-    written_stable_ids: written,
-    skipped_stable_ids: skipped,
-    total_entries: entries.length,
-    duration_ms: durationMs
-  };
-}
-var scanCommand = defineCommand({
-  meta: {
-    name: "scan",
-    description: t("cli.scan.description")
-  },
-  args: {
-    target: {
-      type: "string",
-      description: t("cli.scan.args.target.description")
-    },
-    debug: {
-      type: "boolean",
-      description: t("cli.scan.args.debug.description"),
-      default: false
-    },
-    json: {
-      type: "boolean",
-      description: t("cli.scan.args.json.description"),
-      default: false
-    }
-  },
-  async run({ args }) {
-    const workspaceRoot = process.cwd();
-    const logger = createDebugLogger(args.debug);
-    const resolution = resolveDevMode(args.target, workspaceRoot);
-    logger(`scan target source: ${resolution.source}`);
-    for (const step of resolution.chain) {
-      logger(step);
-    }
-    try {
-      const result = await runInitScan(resolution.target, { source: "scan" });
-      if (args.json) {
-        console.log(JSON.stringify(result, null, 2));
-        return;
-      }
-      printPrettyResult(result);
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      console.error(`${symbol.warn} ${paint.warn(message)}`);
-      process.exitCode = 1;
-    }
-  }
-});
-var scan_default = scanCommand;
-var BASELINE_TEMPLATES = {
-  en: {
-    "tech-stack": {
-      title: ({ frameworkSummary }) => `Tech stack: ${frameworkSummary}`,
-      build: ({ projectName, frameworkSummary, topExtensionsLine, evidenceLines }) => ({
-        mission: `Track the primary tech stack and runtime surface used by ${projectName}.`,
-        context: [
-          `Framework: ${frameworkSummary}`,
-          `Top file extensions: ${topExtensionsLine}`,
-          `Evidence:`,
-          ...evidenceLines.map((line) => `- ${line}`)
-        ].join("\n")
-      })
-    },
-    "module-structure": {
-      title: "Module structure",
-      build: ({ projectName, totalFiles, maxDepth, dirsBlock, entriesBlock }) => ({
-        mission: `Map the high-level module layout and primary entry points of ${projectName}.`,
-        context: [
-          `Total files: ${totalFiles}`,
-          `Max directory depth: ${maxDepth}`,
-          "",
-          "Key directories:",
-          dirsBlock,
-          "",
-          "Entry points:",
-          entriesBlock
-        ].join("\n")
-      })
-    },
-    "build-config": {
-      title: "Build configuration",
-      build: ({ projectName, framework, configBlock }) => ({
-        mission: `Document the deterministic build/bootstrap configuration anchoring ${projectName}.`,
-        businessLogic: [
-          `1. Detect framework: \`${framework}\`.`,
-          `2. Read configuration files in declared order.`,
-          `3. Honor compiler/bundler boundaries before generating new code.`,
-          `4. Treat config drift as a fact-check signal \u2014 re-run \`fab scan\` after edits.`
-        ].join("\n"),
-        context: [
-          `Framework: ${framework}`,
-          "",
-          "Configuration files:",
-          configBlock
-        ].join("\n")
-      })
-    },
-    "code-style": {
-      title: "Code style guidelines",
-      build: ({ projectName, rulesBlock, patternsBlock }) => ({
-        mission: `Codify the recurring authoring conventions observed in ${projectName}.`,
-        mandatoryInjection: [
-          "When generating or modifying source files in this repo, AI agents MUST:",
-          rulesBlock
-        ].join("\n"),
-        context: [
-          "Detected patterns:",
-          patternsBlock
-        ].join("\n")
-      })
-    },
-    "readme-first-paragraph": {
-      title: "README first paragraph",
-      build: ({ lineCount, quality, excerpt }) => ({
-        mission: `Preserve the README headline and first paragraph as the canonical project elevator pitch.`,
-        context: [
-          `Source: README.md (${lineCount} lines, quality=${quality})`,
-          "",
-          "Excerpt:",
-          "> " + excerpt.split("\n").join("\n> ")
-        ].join("\n")
-      })
-    }
-  },
-  "zh-CN": {
-    "tech-stack": {
-      title: ({ frameworkSummary }) => `Tech stack: ${frameworkSummary}`,
-      build: ({ projectName, frameworkSummary, topExtensionsLine, evidenceLines }) => ({
-        mission: `\u8BB0\u5F55 ${projectName} \u6240\u4F7F\u7528\u7684\u4E3B\u8981 tech stack \u4E0E\u8FD0\u884C\u65F6\u9762\u3002`,
-        context: [
-          `Framework\uFF1A${frameworkSummary}`,
-          `\u4E3B\u8981\u6587\u4EF6\u540E\u7F00\uFF1A${topExtensionsLine}`,
-          `\u8BC1\u636E\uFF1A`,
-          ...evidenceLines.map((line) => `- ${line}`)
-        ].join("\n")
-      })
-    },
-    "module-structure": {
-      title: "Module structure",
-      build: ({ projectName, totalFiles, maxDepth, dirsBlock, entriesBlock }) => ({
-        mission: `\u68B3\u7406 ${projectName} \u7684\u9AD8\u5C42 module \u5E03\u5C40\u4E0E\u4E3B\u8981 entry point\u3002`,
-        context: [
-          `\u6587\u4EF6\u603B\u6570\uFF1A${totalFiles}`,
-          `\u6700\u5927\u76EE\u5F55\u6DF1\u5EA6\uFF1A${maxDepth}`,
-          "",
-          "\u5173\u952E\u76EE\u5F55\uFF1A",
-          dirsBlock,
-          "",
-          "Entry points\uFF1A",
-          entriesBlock
-        ].join("\n")
-      })
-    },
-    "build-config": {
-      title: "Build configuration",
-      build: ({ projectName, framework, configBlock }) => ({
-        mission: `\u8BB0\u5F55 ${projectName} \u6240\u4F9D\u8D56\u7684\u3001\u786E\u5B9A\u6027\u7684 build / bootstrap \u914D\u7F6E\u3002`,
-        businessLogic: [
-          `1. \u63A2\u6D4B framework\uFF1A\`${framework}\`\u3002`,
-          `2. \u6309\u58F0\u660E\u987A\u5E8F\u8BFB\u53D6 configuration files\u3002`,
-          `3. \u5728\u751F\u6210\u65B0\u4EE3\u7801\u4E4B\u524D\uFF0C\u5C0A\u91CD compiler / bundler \u7684\u8FB9\u754C\u3002`,
-          `4. \u628A config \u6F02\u79FB\u89C6\u4E3A fact-check \u4FE1\u53F7 \u2014\u2014 \u4FEE\u6539\u540E\u91CD\u65B0\u8FD0\u884C \`fab scan\`\u3002`
-        ].join("\n"),
-        context: [
-          `Framework\uFF1A${framework}`,
-          "",
-          "Configuration files\uFF1A",
-          configBlock
-        ].join("\n")
-      })
-    },
-    "code-style": {
-      title: "Code style guidelines",
-      build: ({ projectName, rulesBlock, patternsBlock }) => ({
-        mission: `\u56FA\u5316 ${projectName} \u4E2D\u53CD\u590D\u51FA\u73B0\u7684\u5199\u7801\u7EA6\u5B9A\u3002`,
-        mandatoryInjection: [
-          "\u5728\u672C\u4ED3\u5E93\u5185\u751F\u6210\u6216\u4FEE\u6539\u6E90\u7801\u6587\u4EF6\u65F6\uFF0CAI agent \u5FC5\u987B\uFF1A",
-          rulesBlock
-        ].join("\n"),
-        context: [
-          "\u89C2\u5BDF\u5230\u7684\u6A21\u5F0F\uFF1A",
-          patternsBlock
-        ].join("\n")
-      })
-    },
-    "readme-first-paragraph": {
-      title: "README first paragraph",
-      build: ({ lineCount, quality, excerpt }) => ({
-        mission: `\u628A README \u7684\u6807\u9898\u4E0E\u9996\u6BB5\u4FDD\u7559\u4E3A\u9879\u76EE\u5BF9\u5916\u7684 canonical elevator pitch\u3002`,
-        context: [
-          `\u6765\u6E90\uFF1AREADME.md\uFF08${lineCount} \u884C\uFF0Cquality=${quality}\uFF09`,
-          "",
-          "\u6458\u5F55\uFF1A",
-          "> " + excerpt.split("\n").join("\n> ")
-        ].join("\n")
-      })
-    }
-  }
-};
-function resolveTemplateTitle(template, inputs) {
-  return typeof template.title === "function" ? template.title(inputs) : template.title;
-}
-function resolveKnowledgeLanguage(configured, target) {
-  if (configured === "en" || configured === "zh-CN") {
-    return configured;
-  }
-  return detectExistingLanguage(target);
-}
-function detectExistingLanguage(target) {
-  const ZH_CN_RATIO_THRESHOLD = 0.3;
-  const samples = [];
-  const readmePath = join(target, "README.md");
-  if (existsSync(readmePath)) {
-    try {
-      samples.push(readFileSync(readmePath, "utf8"));
-    } catch {
-    }
-  }
-  const docsDir = join(target, "docs");
-  if (existsSync(docsDir)) {
-    try {
-      const stat = statSync(docsDir);
-      if (stat.isDirectory()) {
-        for (const entry of readdirSync(docsDir, { withFileTypes: true })) {
-          if (!entry.isFile()) continue;
-          if (!/\.(md|mdx|txt)$/iu.test(entry.name)) continue;
-          try {
-            samples.push(readFileSync(join(docsDir, entry.name), "utf8"));
-          } catch {
-          }
-        }
-      }
-    } catch {
-    }
-  }
-  if (samples.length === 0) {
-    return "en";
-  }
-  let cjkCount = 0;
-  let asciiLetterCount = 0;
-  for (const sample of samples) {
-    for (const ch of sample) {
-      const code = ch.codePointAt(0) ?? 0;
-      if (code >= 19968 && code <= 40959) {
-        cjkCount += 1;
-      } else if (code >= 65 && code <= 90 || code >= 97 && code <= 122) {
-        asciiLetterCount += 1;
-      }
-    }
-  }
-  const denominator = cjkCount + asciiLetterCount;
-  if (denominator === 0) {
-    return "en";
-  }
-  const ratio = cjkCount / denominator;
-  return ratio > ZH_CN_RATIO_THRESHOLD ? "zh-CN" : "en";
-}
-function buildTechStackEntry(forensic, nowIso, tags, language = "en") {
-  const framework = forensic.framework;
-  const byExt = forensic.topology.by_ext ?? {};
-  const topExtensions = Object.entries(byExt).sort(([, a], [, b]) => b - a).slice(0, 5).map(([ext, count]) => `${ext} (${count})`);
-  const frameworkSummary = `${framework.kind}${framework.version ? ` ${framework.version}` : ""}${framework.subkind ? ` / ${framework.subkind}` : ""}`;
-  const topExtensionsLine = topExtensions.length > 0 ? topExtensions.join(", ") : "(none)";
-  const evidenceLines = framework.evidence.length > 0 ? framework.evidence.slice(0, 6) : ["(no explicit framework evidence)"];
-  const inputs = {
-    projectName: forensic.project_name,
-    frameworkSummary,
-    topExtensionsLine,
-    evidenceLines
-  };
-  const template = BASELINE_TEMPLATES[language]["tech-stack"];
-  const sections = template.build(inputs);
-  const body = renderSections(sections);
-  const relevancePaths = ["package.json", "pnpm-workspace.yaml"];
-  return {
-    type: "model",
-    layer: "team",
-    maturity: "verified",
-    layer_reason: LAYER_REASON,
-    created_at: nowIso,
-    title: resolveTemplateTitle(template, inputs),
-    body,
-    target_subdir: "models",
-    slug: "tech-stack",
-    tags,
-    relevance_scope: "narrow",
-    relevance_paths: relevancePaths
-  };
-}
-function buildModuleStructureEntry(forensic, nowIso, tags, language = "en") {
-  const keyDirs = forensic.topology.key_dirs ?? [];
-  const entryPoints = forensic.entry_points ?? [];
-  const totalFiles = forensic.topology.total_files ?? 0;
-  const dirsBlock = keyDirs.length > 0 ? keyDirs.slice(0, 12).map((dir) => `- ${dir}`).join("\n") : "- (no key directories detected)";
-  const entriesBlock = entryPoints.length > 0 ? entryPoints.slice(0, 8).map((ep) => `- ${ep.path} \u2014 ${ep.reason}`).join("\n") : "- (no entry points detected)";
-  const inputs = {
-    projectName: forensic.project_name,
-    totalFiles,
-    maxDepth: forensic.topology.max_depth ?? 0,
-    dirsBlock,
-    entriesBlock
-  };
-  const template = BASELINE_TEMPLATES[language]["module-structure"];
-  const body = renderSections(template.build(inputs));
-  const relevancePaths = ["packages/**/package.json"];
-  return {
-    type: "model",
-    layer: "team",
-    maturity: "verified",
-    layer_reason: LAYER_REASON,
-    created_at: nowIso,
-    title: resolveTemplateTitle(template, inputs),
-    body,
-    target_subdir: "models",
-    slug: "module-structure",
-    tags,
-    relevance_scope: "narrow",
-    relevance_paths: relevancePaths
-  };
-}
-function buildBuildConfigEntry(forensic, nowIso, tags, language = "en") {
-  const configFiles = (forensic.candidate_files ?? []).filter((entry) => entry.family === "config").map((entry) => entry.path);
-  const framework = forensic.framework.kind;
-  const configBlock = configFiles.length > 0 ? configFiles.map((file) => `- ${file}`).join("\n") : "- (no config files detected)";
-  const inputs = {
-    projectName: forensic.project_name,
-    framework,
-    configBlock
-  };
-  const template = BASELINE_TEMPLATES[language]["build-config"];
-  const body = renderSections(template.build(inputs));
-  const discovered = configFiles.filter((path) => isBuildConfigPath(path));
-  const relevancePaths = discovered.length > 0 ? Array.from(new Set(discovered)) : ["tsconfig.json", "tsconfig.*.json", "vite.config.*", "rollup.config.*", "webpack.config.*"];
-  return {
-    type: "process",
-    layer: "team",
-    maturity: "verified",
-    layer_reason: LAYER_REASON,
-    created_at: nowIso,
-    title: resolveTemplateTitle(template, inputs),
-    body,
-    target_subdir: "processes",
-    slug: "build-config",
-    tags,
-    relevance_scope: "narrow",
-    relevance_paths: relevancePaths
-  };
-}
-function buildCodeStyleEntry(forensic, nowIso, tags, language = "en") {
-  const dominantPatterns = (forensic.assertions ?? []).filter((a) => a.type === "pattern" || a.type === "domain").slice(0, 4).map((a) => `- ${a.statement}`);
-  const proposedRules = (forensic.assertions ?? []).map((a) => a.proposed_rule).filter((rule) => typeof rule === "string" && rule.length > 0).slice(0, 4);
-  const patternsBlock = dominantPatterns.length > 0 ? dominantPatterns.join("\n") : "- (no dominant patterns detected)";
-  const rulesBlock = proposedRules.length > 0 ? proposedRules.map((rule) => `- ${rule}`).join("\n") : "- Follow existing module/file patterns; do not introduce new conventions without team agreement.";
-  const inputs = {
-    projectName: forensic.project_name,
-    rulesBlock,
-    patternsBlock
-  };
-  const template = BASELINE_TEMPLATES[language]["code-style"];
-  const body = renderSections(template.build(inputs));
-  const relevancePaths = [
-    ".prettierrc",
-    ".prettierrc.*",
-    ".editorconfig",
-    "eslint.config.*",
-    ".eslintrc",
-    ".eslintrc.*"
-  ];
-  return {
-    type: "guideline",
-    layer: "team",
-    maturity: "verified",
-    layer_reason: LAYER_REASON,
-    created_at: nowIso,
-    title: resolveTemplateTitle(template, inputs),
-    body,
-    target_subdir: "guidelines",
-    slug: "code-style",
-    tags,
-    relevance_scope: "narrow",
-    relevance_paths: relevancePaths
-  };
-}
-function buildCIConfigEntry(forensic, nowIso, tags) {
-  const ciFiles = (forensic.candidate_files ?? []).map((entry) => entry.path).filter((path) => isCIConfigPath(path));
-  const ciExtensions = forensic.topology.by_ext ?? {};
-  const hasCISignal = ciFiles.length > 0 || Object.keys(ciExtensions).some((ext) => ext === ".yml" || ext === ".yaml") && (forensic.assertions ?? []).some((a) => /ci|workflow|pipeline/i.test(a.statement));
-  if (!hasCISignal) {
-    return null;
-  }
-  const filesBlock = ciFiles.length > 0 ? ciFiles.map((file) => `- ${file}`).join("\n") : "- (CI configuration inferred from repository topology)";
-  const body = renderSections({
-    mission: `Document the CI / continuous-verification pipeline guarding ${forensic.project_name}.`,
-    businessLogic: [
-      "1. Pull request opens \u2192 CI workflow triggers.",
-      "2. Lint + typecheck + unit tests must pass before review.",
-      "3. Failing checks block merge until resolved.",
-      "4. Updates to CI configuration should accompany the change they enable."
-    ].join("\n"),
-    context: [
-      "CI configuration sources:",
-      filesBlock
-    ].join("\n")
-  });
-  const relevancePaths = [
-    ".github/workflows/**",
-    ".gitlab-ci.yml",
-    ".circleci/**",
-    "Jenkinsfile"
-  ];
-  return {
-    type: "process",
-    layer: "team",
-    maturity: "verified",
-    layer_reason: LAYER_REASON,
-    created_at: nowIso,
-    title: "CI configuration",
-    body,
-    target_subdir: "processes",
-    slug: "ci-config",
-    tags,
-    relevance_scope: "narrow",
-    relevance_paths: relevancePaths
-  };
-}
-function buildReadmeFirstParaEntry(target, forensic, nowIso, tags, language = "en") {
-  if (forensic.readme.quality === "missing") {
-    return null;
-  }
-  const readmePath = join(target, "README.md");
-  if (!existsSync(readmePath)) {
-    return null;
-  }
-  const readme = readFileSync(readmePath, "utf8");
-  const firstPara = extractFirstParagraph(readme);
-  if (firstPara === null) {
-    return null;
-  }
-  const inputs = {
-    lineCount: forensic.readme.line_count,
-    quality: forensic.readme.quality,
-    excerpt: firstPara
-  };
-  const template = BASELINE_TEMPLATES[language]["readme-first-paragraph"];
-  const body = renderSections(template.build(inputs));
-  return {
-    type: "model",
-    layer: "team",
-    maturity: "verified",
-    layer_reason: LAYER_REASON,
-    created_at: nowIso,
-    title: resolveTemplateTitle(template, inputs),
-    body,
-    target_subdir: "models",
-    slug: "readme-first-paragraph",
-    tags,
-    // v2.0-rc.7 T2: broad by design — single repo-root file, the Phase 1.5
-    // PreToolUse blacklist already covers README. Anchoring this entry to
-    // README.md would surface it on every README edit, which is noise.
-    relevance_scope: "broad",
-    relevance_paths: []
-  };
-}
-function buildProjectBriefEntry(target, forensic, nowIso, tags) {
-  if (forensic.readme.quality === "missing") {
-    return null;
-  }
-  const readmePath = join(target, "README.md");
-  if (!existsSync(readmePath)) {
-    return null;
-  }
-  const readme = readFileSync(readmePath, "utf8");
-  const description = extractExplicitDescription(readme);
-  if (description === null) {
-    return null;
-  }
-  const body = renderSections({
-    mission: `Capture the explicit project description declared by README.md.`,
-    context: [
-      `Project: ${forensic.project_name}`,
-      "",
-      "Declared description:",
-      "> " + description.split("\n").join("\n> ")
-    ].join("\n")
-  });
-  return {
-    type: "model",
-    layer: "team",
-    maturity: "verified",
-    layer_reason: LAYER_REASON,
-    created_at: nowIso,
-    title: "Project brief",
-    body,
-    target_subdir: "models",
-    slug: "project-brief",
-    tags,
-    // v2.0-rc.7 T2: broad — project brief is a cross-cutting description
-    // with no path anchor. Narrowing it to README.md would duplicate the
-    // readme-first-paragraph surface; keeping it broad lets the
-    // SessionStart broad hint do the right thing.
-    relevance_scope: "broad",
-    relevance_paths: []
-  };
-}
-function renderMarkdown(entry) {
-  const frontmatter = renderFrontmatter(entry);
-  return `${frontmatter}
-
-# ${entry.title}
-
-${entry.body}
-`;
-}
-function renderFrontmatter(entry) {
-  const tagsLine = entry.tags.length > 0 ? `tags: [${entry.tags.join(", ")}]` : "tags: []";
-  const relevancePathsLine = entry.relevance_paths.length > 0 ? `relevance_paths: [${entry.relevance_paths.map((p) => quoteIfNeeded(p)).join(", ")}]` : "relevance_paths: []";
-  const lines = [
-    "---",
-    `id: ${entry.id}`,
-    `type: ${entry.type}`,
-    `layer: ${entry.layer}`,
-    `maturity: ${entry.maturity}`,
-    `layer_reason: ${quoteIfNeeded(entry.layer_reason)}`,
-    `created_at: ${entry.created_at}`,
-    tagsLine,
-    `relevance_scope: ${entry.relevance_scope}`,
-    relevancePathsLine,
-    "---"
-  ];
-  return lines.join("\n");
-}
-function renderSections(input) {
-  const parts = [];
-  parts.push(`## [MISSION_STATEMENT]
-
-${input.mission}`);
-  if (input.mandatoryInjection !== void 0) {
-    parts.push(`## [MANDATORY_INJECTION]
-
-${input.mandatoryInjection}`);
-  }
-  if (input.businessLogic !== void 0) {
-    parts.push(`## [BUSINESS_LOGIC_CHUNKS]
-
-${input.businessLogic}`);
-  }
-  parts.push(`## [CONTEXT_INFO]
-
-${input.context}`);
-  return parts.join("\n\n");
-}
-function quoteIfNeeded(value) {
-  return `"${value.replace(/"/g, '\\"')}"`;
-}
-function stripFrontmatter(content) {
-  return content.replace(/^---[\s\S]*?\r?\n---\s*\r?\n?/u, "");
-}
-function deriveTagsFromForensic(forensic) {
-  const MAX_TAGS = 5;
-  const seen = /* @__PURE__ */ new Set();
-  const tags = [];
-  function add(raw) {
-    const normalized = raw.toLowerCase().trim().replace(/\s+/gu, "-");
-    if (normalized.length > 0 && !seen.has(normalized)) {
-      seen.add(normalized);
-      tags.push(normalized);
-    }
-  }
-  if (forensic.framework.kind) {
-    add(forensic.framework.kind);
-  }
-  const SKIP_EXTS = /* @__PURE__ */ new Set([".json", ".md", ".lock", ".yaml", ".yml", ".txt", ".env"]);
-  const EXT_MAP = {
-    ".ts": "typescript",
-    ".tsx": "typescript",
-    ".js": "javascript",
-    ".jsx": "javascript",
-    ".mjs": "javascript",
-    ".cjs": "javascript",
-    ".py": "python",
-    ".go": "go",
-    ".rs": "rust",
-    ".java": "java",
-    ".cs": "csharp",
-    ".rb": "ruby",
-    ".php": "php",
-    ".swift": "swift",
-    ".kt": "kotlin"
-  };
-  const byExt = forensic.topology.by_ext ?? {};
-  const sorted = Object.entries(byExt).filter(([ext]) => !SKIP_EXTS.has(ext)).sort(([, a], [, b]) => b - a);
-  for (const [ext] of sorted) {
-    if (tags.length >= MAX_TAGS) break;
-    const mapped = EXT_MAP[ext] ?? ext.replace(/^\./u, "");
-    add(mapped);
-  }
-  return tags.slice(0, MAX_TAGS);
-}
-async function readForensic(forensicPath) {
-  const raw = await readFile(forensicPath, "utf8");
-  return JSON.parse(raw);
-}
-async function readScanState(sidecarPath) {
-  if (!existsSync(sidecarPath)) {
-    return {};
-  }
-  try {
-    const raw = await readFile(sidecarPath, "utf8");
-    const parsed = JSON.parse(raw);
-    if (parsed === null || typeof parsed !== "object") {
-      return {};
-    }
-    const result = {};
-    for (const [key, value] of Object.entries(parsed)) {
-      if (typeof value === "string") {
-        result[key] = value;
-      }
-    }
-    return result;
-  } catch {
-    return {};
-  }
-}
-function findExistingIdForFile(sidecar, targetPath, target) {
-  if (!existsSync(targetPath)) {
-    return null;
-  }
-  try {
-    const raw = readFileSync(targetPath, "utf8");
-    const match = /^---\r?\n([\s\S]*?)\r?\n---/u.exec(raw);
-    if (match === null) {
-      return null;
-    }
-    const idLine = /^id:\s*(.+)$/mu.exec(match[1]);
-    if (idLine === null) {
-      return null;
-    }
-    const candidate = idLine[1].replace(/^["'](.*)["']$/u, "$1").trim();
-    if (/^K[PT]-(MOD|DEC|GLD|PIT|PRO)-\d{4,}$/.test(candidate) && sidecar[candidate] !== void 0) {
-      return candidate;
-    }
-    return null;
-  } catch {
-    void target;
-    return null;
-  }
-}
-function isCIConfigPath(path) {
-  return path.startsWith(".github/workflows/") || path.startsWith(".gitlab-ci") || path === "azure-pipelines.yml" || path === ".circleci/config.yml" || path === "Jenkinsfile" || path === ".travis.yml";
-}
-function isBuildConfigPath(path) {
-  const lower = path.toLowerCase();
-  const basename = lower.split("/").pop() ?? lower;
-  if (basename.startsWith("tsconfig") && basename.endsWith(".json")) return true;
-  if (basename === "package.json") return true;
-  if (basename === "pnpm-workspace.yaml" || basename === "pnpm-workspace.yml") return true;
-  if (basename.startsWith("vite.config.")) return true;
-  if (basename.startsWith("rollup.config.")) return true;
-  if (basename.startsWith("webpack.config.")) return true;
-  if (basename.startsWith("vitest.config.")) return true;
-  if (basename === "turbo.json" || basename === "nx.json") return true;
-  return false;
-}
-function extractFirstParagraph(readme) {
-  const lines = readme.split(/\r?\n/);
-  let i = 0;
-  while (i < lines.length && lines[i].trim().length === 0) i += 1;
-  while (i < lines.length && /^#{1,2}\s/.test(lines[i].trim())) {
-    i += 1;
-    while (i < lines.length && lines[i].trim().length === 0) i += 1;
-  }
-  if (i >= lines.length) {
-    return null;
-  }
-  const collected = [];
-  while (i < lines.length && lines[i].trim().length > 0) {
-    if (/^#{1,6}\s/.test(lines[i].trim())) break;
-    collected.push(lines[i]);
-    i += 1;
-  }
-  const paragraph = collected.join("\n").trim();
-  return paragraph.length > 0 ? paragraph : null;
-}
-function extractExplicitDescription(readme) {
-  const headingMatch = /^#{1,6}\s+(?:Description|About|Overview|Summary)\s*\r?\n+([^#][\s\S]*?)(?:\r?\n\r?\n|\r?\n#{1,6}\s|$)/imu.exec(readme);
-  if (headingMatch !== null) {
-    const text = headingMatch[1].trim();
-    if (text.length > 0) return text;
-  }
-  const labelMatch = /^\*\*(?:Description|About|Overview|Summary)\*\*\s*:?\s*(.+?)(?:\r?\n\r?\n|$)/imu.exec(readme);
-  if (labelMatch !== null) {
-    const text = labelMatch[1].trim();
-    if (text.length > 0) return text;
-  }
-  return null;
-}
-function sha256(content) {
-  return `sha256:${createHash("sha256").update(content).digest("hex")}`;
-}
-async function registerKnowledgeNodesInMeta(target, entries) {
-  if (entries.length === 0) {
-    return;
-  }
-  const metaPath = join(target, AGENTS_META_FILE);
-  let meta;
-  try {
-    const raw = await readFile(metaPath, "utf8");
-    meta = JSON.parse(raw);
-  } catch {
-    meta = {};
-  }
-  const nodes = typeof meta.nodes === "object" && meta.nodes !== null ? meta.nodes : {};
-  for (const entry of entries) {
-    const contentRef = `${KNOWLEDGE_DIR}/${entry.target_subdir}/${entry.slug}.md`;
-    const absPath = join(target, contentRef);
-    let hash = "";
-    try {
-      const raw = readFileSync(absPath, "utf8");
-      hash = sha256(raw);
-    } catch {
-    }
-    nodes[entry.id] = {
-      file: contentRef,
-      content_ref: contentRef,
-      scope_glob: "**",
-      deps: [],
-      priority: "medium",
-      level: "L1",
-      layer: "L1",
-      topology_type: "cross-cutting",
-      hash,
-      stable_id: entry.id,
-      identity_source: "declared"
-    };
-  }
-  meta.nodes = nodes;
-  await ensureParentDirectory(metaPath);
-  await atomicWriteJson(metaPath, meta);
-}
-async function ensureParentDirectory(filePath) {
-  await mkdir(dirname(filePath), { recursive: true });
-}
-function printPrettyResult(result) {
-  const writtenCount = result.written_stable_ids.length;
-  const skippedCount = result.skipped_stable_ids.length;
-  if (writtenCount === 0) {
-    console.log(`${symbol.ok} ${paint.success(t("cli.scan.summary.skipped", { count: String(skippedCount) }))}`);
-    return;
-  }
-  console.log(`${symbol.ok} ${paint.success(t("cli.scan.summary.created", { count: String(writtenCount) }))}`);
-  for (const id of result.written_stable_ids) {
-    console.log(`  - ${paint.ai(id)}`);
-  }
-  if (skippedCount > 0) {
-    console.log(paint.muted(`(${skippedCount} unchanged, skipped)`));
-  }
-}
-function normalizeTarget(targetInput) {
-  return isAbsolute(targetInput) ? targetInput : resolve(process.cwd(), targetInput);
-}
-function getReadmeQuality(target) {
-  const readmePath = join(target, "README.md");
-  if (!existsSync(readmePath)) {
-    return "stub";
-  }
-  const wordCount = readFileSync(readmePath, "utf8").trim().split(/\s+/).filter(Boolean).length;
-  return wordCount >= 200 ? "ok" : "stub";
-}
-function walkFiles(root, ignorePatterns) {
-  if (!existsSync(root) || !statSync(root).isDirectory()) {
-    throw new Error(t("cli.shared.target-invalid", { target: root }));
-  }
-  let fileCount = 0;
-  let ignoredCount = 0;
-  const stack = [root];
-  while (stack.length > 0) {
-    const current = stack.pop();
-    if (current === void 0) {
-      continue;
-    }
-    for (const entry of readdirSync(current, { withFileTypes: true })) {
-      const absolutePath = join(current, entry.name);
-      const relativePath = toPosixPath(relative(root, absolutePath));
-      if (shouldIgnore(relativePath, entry.isDirectory(), ignorePatterns)) {
-        ignoredCount += 1;
-        continue;
-      }
-      if (entry.isDirectory()) {
-        stack.push(absolutePath);
-      } else if (entry.isFile()) {
-        fileCount += 1;
-      }
-    }
-  }
-  return { fileCount, ignoredCount };
-}
-function shouldIgnore(relativePath, isDirectory, ignorePatterns) {
-  return ignorePatterns.some((pattern) => matchesIgnorePattern(relativePath, isDirectory, pattern));
-}
-function matchesIgnorePattern(relativePath, isDirectory, pattern) {
-  const normalizedPattern = toPosixPath(pattern);
-  if (normalizedPattern === "**/*.meta") {
-    return relativePath.endsWith(".meta");
-  }
-  if (normalizedPattern.endsWith("/**")) {
-    const directoryPrefix = normalizedPattern.slice(0, -3);
-    return relativePath === directoryPrefix || relativePath.startsWith(`${directoryPrefix}/`) || isDirectory && `${relativePath}/` === directoryPrefix;
-  }
-  return relativePath === normalizedPattern;
-}
-function toPosixPath(path) {
-  return path.split(sep).join("/");
-}
-function buildRecommendations(input) {
-  const recommendations = [];
-  if (!input.hasExistingFabric) {
-    recommendations.push(t("cli.scan.recommendation.init"));
-  }
-  if (input.readmeQuality === "stub") {
-    recommendations.push(t("cli.scan.recommendation.readme"));
-  }
-  if (!input.hasContributing) {
-    recommendations.push(t("cli.scan.recommendation.contributing"));
-  }
-  if (input.framework.kind === "unknown") {
-    recommendations.push(t("cli.scan.recommendation.unknown-framework"));
-  } else {
-    recommendations.push(t("cli.scan.recommendation.framework-dirs", { framework: input.framework.kind }));
-  }
-  return recommendations;
-}
-var __testing__ = {
-  buildTechStackEntry,
-  buildModuleStructureEntry,
-  buildBuildConfigEntry,
-  buildCodeStyleEntry,
-  buildCIConfigEntry,
-  buildReadmeFirstParaEntry,
-  buildProjectBriefEntry,
-  renderMarkdown,
-  stripFrontmatter,
-  isCIConfigPath,
-  isBuildConfigPath,
-  extractFirstParagraph,
-  extractExplicitDescription,
-  // TASK-008: bilingual template registry + language detection
-  detectExistingLanguage,
-  resolveKnowledgeLanguage,
-  BASELINE_TEMPLATES
-};
-
-export {
-  detectFramework,
-  formatKnowledgeId,
-  createScanReport,
-  runInitScan,
-  scanCommand,
-  scan_default,
-  deriveTagsFromForensic,
-  __testing__
-};