@fenglimg/fabric-cli 2.0.0-rc.22 → 2.0.0-rc.23

package/dist/chunk-PSVKSMRO.js

@@ -1,896 +0,0 @@
-#!/usr/bin/env node
-import {
-  t
-} from "./chunk-6ICJICVU.js";
-import {
-  readFabricConfig
-} from "./chunk-ZSESMG6L.js";
-
-// src/commands/scan.ts
-import { createHash } from "crypto";
-import { existsSync, readdirSync, readFileSync, statSync } from "fs";
-import { mkdir, readFile, unlink } from "fs/promises";
-import { dirname, isAbsolute, join, resolve } from "path";
-import {
-  KnowledgeIdAllocator,
-  appendEventLedgerEvent,
-  writeKnowledgeMeta
-} from "@fenglimg/fabric-server";
-import {
-  formatKnowledgeId
-} from "@fenglimg/fabric-shared";
-import { atomicWriteJson, atomicWriteText } from "@fenglimg/fabric-shared/node/atomic-write";
-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)";
-var KNOWN_BASELINE_IDS = /* @__PURE__ */ new Set([
-  "KT-MOD-0001",
-  // tech-stack
-  "KT-MOD-0002",
-  // module-structure
-  "KT-MOD-0003",
-  // readme-first-paragraph
-  "KT-PRO-0001",
-  // build-config
-  "KT-PRO-0002",
-  // ci-config (allocated after build-config in the deterministic order)
-  "KT-GLD-0001"
-  // code-style
-]);
-var KNOWN_BASELINE_SLUGS = /* @__PURE__ */ new Set([
-  "tech-stack",
-  "module-structure",
-  "build-config",
-  "code-style",
-  "ci-config",
-  "readme-first-paragraph",
-  "project-brief"
-]);
-var ID_PREFIXED_FILENAME_PATTERN = /^KT-[A-Z]+-\d+--.+\.md$/u;
-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 }));
-  }
-  await migrateLegacyBaselineFilenames(target);
-  const forensic = await readForensic(forensicPath);
-  const nowIso = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
-  const fabricConfig = readFabricConfig(target);
-  const fabricLanguage = fabricConfig.fabric_language ?? "match-existing";
-  const resolvedLanguage = resolveFabricLanguage(fabricLanguage, target);
-  const candidates = [
-    buildTechStackEntry(forensic, nowIso, resolvedLanguage),
-    buildModuleStructureEntry(forensic, nowIso, resolvedLanguage),
-    buildBuildConfigEntry(forensic, nowIso, resolvedLanguage),
-    buildCodeStyleEntry(forensic, nowIso, resolvedLanguage),
-    buildCIConfigEntry(forensic, nowIso),
-    buildReadmeFirstParaEntry(target, forensic, nowIso, resolvedLanguage),
-    buildProjectBriefEntry(target, forensic, nowIso)
-  ];
-  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 subdirAbs = join(target, KNOWLEDGE_DIR, entry.target_subdir);
-    const existingId = findExistingIdBySlug(sidecar, subdirAbs, entry.slug);
-    const id = existingId ?? await allocator.allocate(entry.layer, entry.type);
-    const built = { ...entry, id };
-    placedEntries.push(built);
-    const targetPath = join(subdirAbs, `${id}--${entry.slug}.md`);
-    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 STRICT_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")
-      })
-    }
-  }
-};
-var BASELINE_TEMPLATES = {
-  en: STRICT_BASELINE_TEMPLATES.en,
-  "zh-CN": STRICT_BASELINE_TEMPLATES["zh-CN"],
-  "zh-CN-hybrid": STRICT_BASELINE_TEMPLATES["zh-CN"]
-};
-function resolveTemplateTitle(template, inputs) {
-  return typeof template.title === "function" ? template.title(inputs) : template.title;
-}
-function resolveFabricLanguage(configured, target) {
-  if (configured === "en" || configured === "zh-CN" || configured === "zh-CN-hybrid") {
-    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-hybrid" : "en";
-}
-function buildTechStackEntry(forensic, nowIso, 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, 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, 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, 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) {
-  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, 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) {
-  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, "");
-}
-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 {};
-  }
-}
-async function migrateLegacyBaselineFilenames(target) {
-  const knowledgeRoot = join(target, KNOWLEDGE_DIR);
-  if (!existsSync(knowledgeRoot)) {
-    return { migrated: [] };
-  }
-  const migrated = [];
-  const subdirs = ["models", "guidelines", "processes"];
-  for (const sub of subdirs) {
-    const subdirPath = join(knowledgeRoot, sub);
-    if (!existsSync(subdirPath)) continue;
-    let entries;
-    try {
-      entries = readdirSync(subdirPath);
-    } catch {
-      continue;
-    }
-    for (const name of entries) {
-      if (!name.endsWith(".md")) continue;
-      if (ID_PREFIXED_FILENAME_PATTERN.test(name)) {
-        const idMatch = /^(KT-[A-Z]+-\d+)--(.+)\.md$/u.exec(name);
-        if (idMatch === null) continue;
-        const [, fileId, fileSlug] = idMatch;
-        if (!KNOWN_BASELINE_IDS.has(fileId)) continue;
-        if (!KNOWN_BASELINE_SLUGS.has(fileSlug)) continue;
-        const onDiskPath = join(subdirPath, name);
-        let onDiskRaw;
-        try {
-          onDiskRaw = readFileSync(onDiskPath, "utf8");
-        } catch {
-          continue;
-        }
-        const scrubbed = stripStaleTagsLine(onDiskRaw);
-        if (scrubbed !== onDiskRaw) {
-          await atomicWriteText(onDiskPath, scrubbed);
-        }
-        continue;
-      }
-      const bareSlug = name.slice(0, -".md".length);
-      if (!KNOWN_BASELINE_SLUGS.has(bareSlug)) continue;
-      const oldPath = join(subdirPath, name);
-      let raw;
-      try {
-        raw = readFileSync(oldPath, "utf8");
-      } catch {
-        continue;
-      }
-      const id = extractFrontmatterId(raw);
-      if (id === null || !KNOWN_BASELINE_IDS.has(id)) continue;
-      const newName = `${id}--${bareSlug}.md`;
-      const newPath = join(subdirPath, newName);
-      const cleanedRaw = stripStaleTagsLine(raw);
-      if (existsSync(newPath)) {
-        try {
-          await unlink(oldPath);
-        } catch {
-        }
-        continue;
-      }
-      await atomicWriteText(newPath, cleanedRaw);
-      try {
-        await unlink(oldPath);
-      } catch {
-      }
-      migrated.push({ from: oldPath, to: newPath, id });
-    }
-  }
-  return { migrated };
-}
-function stripStaleTagsLine(raw) {
-  const fmMatch = /^(---\r?\n)([\s\S]*?)(\r?\n---\s*(?:\r?\n|$))/u.exec(raw);
-  if (fmMatch === null) return raw;
-  const head = fmMatch[1];
-  const body = fmMatch[2];
-  const tail = fmMatch[3];
-  const rest = raw.slice(fmMatch[0].length);
-  const flowPattern = /^tags:[ \t]*\[[^\n]*\][ \t]*$/mu;
-  if (flowPattern.test(body)) {
-    const replaced = body.replace(flowPattern, "tags: []");
-    return `${head}${replaced}${tail}${rest}`;
-  }
-  const blockPattern = /^tags:[ \t]*\r?\n(?:[ \t]+-[ \t]+.+\r?\n?)+/mu;
-  if (blockPattern.test(body)) {
-    const replaced = body.replace(blockPattern, "tags: []\n");
-    return `${head}${replaced.replace(/\n{2,}$/u, "\n")}${tail}${rest}`;
-  }
-  const barePattern = /^tags:[ \t]*$/mu;
-  if (barePattern.test(body)) {
-    const replaced = body.replace(barePattern, "tags: []");
-    return `${head}${replaced}${tail}${rest}`;
-  }
-  return raw;
-}
-function extractFrontmatterId(raw) {
-  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;
-  return idLine[1].replace(/^["'](.*)["']$/u, "$1").trim();
-}
-function findExistingIdBySlug(sidecar, subdirAbs, slug) {
-  if (!existsSync(subdirAbs)) {
-    return null;
-  }
-  let entries;
-  try {
-    entries = readdirSync(subdirAbs);
-  } catch {
-    return null;
-  }
-  const escapedSlug = slug.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
-  const pattern = new RegExp(`^(KT-[A-Z]+-\\d+)--${escapedSlug}\\.md$`, "u");
-  const matches = [];
-  for (const name of entries) {
-    const m = pattern.exec(name);
-    if (m === null) continue;
-    matches.push({ id: m[1], file: name });
-  }
-  if (matches.length !== 1) {
-    return null;
-  }
-  const filenameId = matches[0].id;
-  try {
-    const raw = readFileSync(join(subdirAbs, matches[0].file), "utf8");
-    const frontmatterId = extractFrontmatterId(raw);
-    if (frontmatterId !== filenameId) {
-      return null;
-    }
-  } catch {
-    return null;
-  }
-  if (!/^K[PT]-(MOD|DEC|GLD|PIT|PRO)-\d{4,}$/u.test(filenameId)) {
-    return null;
-  }
-  if (sidecar[filenameId] === void 0) {
-    return null;
-  }
-  return filenameId;
-}
-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.id}--${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 normalizeTarget(targetInput) {
-  return isAbsolute(targetInput) ? targetInput : resolve(process.cwd(), targetInput);
-}
-
-export {
-  runInitScan,
-  detectExistingLanguage
-};