truthmark 1.2.0 → 1.2.1

package/dist/main.js

@@ -43,7 +43,7 @@ var renderJson = (result) => {
 };
 
 // src/config/command.ts
-import fs3 from "fs/promises";
+import fs4 from "fs/promises";
 
 // src/fs/paths.ts
 import path from "path";
@@ -423,14 +423,26 @@ var createDefaultConfig = () => ({
 });
 
 // src/version.ts
-var TRUTHMARK_VERSION = "1.2.0";
+import fs3 from "fs";
+var packageJson = JSON.parse(
+  fs3.readFileSync(new URL("../package.json", import.meta.url), "utf8")
+);
+var TRUTHMARK_VERSION = packageJson.version;
 
 // src/templates/init-files.ts
 var renderConfigTemplate = () => {
   return stringify(createDefaultRawConfig());
 };
 var renderTruthmarkTemplate = () => {
-  return `# Truthmark
+  return `---
+status: active
+doc_type: workflow-contract
+last_reviewed: 2026-05-09
+source_of_truth:
+  - .truthmark/config.yml
+---
+
+# Truthmark
 
 Markdown in the current checkout is authoritative for this branch.
 
@@ -459,6 +471,14 @@ var renderHierarchicalAreasIndexTemplate = (config) => {
   const childPath = `${config.docs.routing.areaFilesRoot}/${defaultArea}.md`;
   const title = titleCase(defaultArea);
   return [
+    "---",
+    "status: active",
+    "doc_type: route-index",
+    "last_reviewed: 2026-05-09",
+    "source_of_truth:",
+    "  - ../../.truthmark/config.yml",
+    "---",
+    "",
     "# Truthmark Areas",
     "",
     `## ${title}`,
@@ -481,6 +501,14 @@ var renderChildAreaTemplate = (config) => {
   const featureRoot = config.docs.roots.features ?? config.docs.roots.features_current ?? "docs/features";
   const leafTruthDoc = `${featureRoot}/${defaultArea}/overview.md`;
   return [
+    "---",
+    "status: active",
+    "doc_type: area-route",
+    "last_reviewed: 2026-05-09",
+    "source_of_truth:",
+    "  - ../../../.truthmark/config.yml",
+    "---",
+    "",
     `# ${title} Areas`,
     "",
     `## ${title}`,
@@ -575,7 +603,7 @@ var renderFeatureLeafDocTemplate = (config) => {
 var CONFIG_PATH = ".truthmark/config.yml";
 var configExists = async (rootDir) => {
   try {
-    await fs3.stat(resolveRepoPath(rootDir, CONFIG_PATH));
+    await fs4.stat(resolveRepoPath(rootDir, CONFIG_PATH));
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -648,10 +676,10 @@ var runConfig = async (cwd, options = {}) => {
 };
 
 // src/init/init.ts
-import fs5 from "fs/promises";
+import fs6 from "fs/promises";
 
 // src/config/load.ts
-import fs4 from "fs/promises";
+import fs5 from "fs/promises";
 import { Ajv } from "ajv";
 import { parse } from "yaml";
 var ajv = new Ajv({ allErrors: true });
@@ -700,7 +728,7 @@ var loadConfig = async (rootDir) => {
   const absolutePath = resolveRepoPath(rootDir, configPath);
   let source;
   try {
-    source = await fs4.readFile(absolutePath, "utf8");
+    source = await fs5.readFile(absolutePath, "utf8");
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
       return {
@@ -941,6 +969,8 @@ Truth Structure is agent-native:
 - define areas by product or behavior ownership, not by mechanical directory mirroring
 - create or repair docs/truthmark/areas.md
 - create starter truth docs when useful and when they belong in the canonical current-truth surface
+- Starter truth docs must use closed YAML frontmatter bounded by opening and closing --- lines; include status, doc_type, last_reviewed, and source_of_truth inside that frontmatter.
+- Starter truth docs must include ## Product Decisions and ## Rationale sections.
 - use docs/features/**, docs/architecture/**, or docs/standards/** for current truth destinations
 - use only canonical current-truth destinations for starter truth docs
 - keep active Product Decisions and Rationale in the canonical doc that owns the behavior
@@ -972,6 +1002,8 @@ Repair rules:
 - keep API endpoint details in the nearest contract truth doc when such a doc exists
 - update routing so future Truth Sync can target small docs
 - preserve existing authored docs; move or rewrite only when needed to remove ambiguity
+- Do not finish topology repair with routed canonical current-truth docs missing Product Decisions or Rationale sections.
+- If an existing canonical doc lacks either section, add the missing heading beside Current Behavior with a concise current-state placeholder or active decision.
 Portable fallback:
 - If this skill surface is unavailable, perform the same workflow directly from committed repository files.
 - Do not require the truthmark CLI.
@@ -1514,7 +1546,7 @@ ${block}`;
 var writeManagedAgentsFile = async (rootDir, path4 = "AGENTS.md", block) => {
   let existingContent = null;
   try {
-    existingContent = await fs5.readFile(resolveRepoPath(rootDir, path4), "utf8");
+    existingContent = await fs6.readFile(resolveRepoPath(rootDir, path4), "utf8");
   } catch (error) {
     if (!(error instanceof Error) || !("code" in error) || error.code !== "ENOENT") {
       throw error;
@@ -1532,21 +1564,12 @@ var diagnosticCategoryForPath = (filePath) => {
   if (filePath.startsWith(".codex/skills/truthmark-structure/")) {
     return "truth-sync";
   }
-  if (filePath.startsWith("skills/truthmark-structure/")) {
-    return "truth-sync";
-  }
   if (filePath.startsWith(".codex/skills/truthmark-sync/")) {
     return "truth-sync";
   }
-  if (filePath.startsWith("skills/truthmark-sync/")) {
-    return "truth-sync";
-  }
   if (filePath.startsWith(".codex/skills/truthmark-realize/")) {
     return "realization";
   }
-  if (filePath.startsWith("skills/truthmark-realize/")) {
-    return "realization";
-  }
   if (filePath.startsWith(".gemini/commands/truthmark/realize")) {
     return "realization";
   }
@@ -1556,9 +1579,6 @@ var diagnosticCategoryForPath = (filePath) => {
   if (filePath.startsWith(".codex/skills/truthmark-check/")) {
     return "truth-sync";
   }
-  if (filePath.startsWith("skills/truthmark-check/")) {
-    return "truth-sync";
-  }
   if (filePath === "TRUTHMARK.md" || filePath === "docs/truthmark/areas.md") {
     return "authority";
   }
@@ -1640,12 +1660,9 @@ var filesForPlatform = (platform, config, block) => {
     case "codex":
       return codexFiles(config);
     case "opencode":
-      return [
-        ...workflowSkillFiles("skills", config),
-        ...workflowSkillFiles(".opencode/skills", config)
-      ];
+      return workflowSkillFiles(".opencode/skills", config);
     case "claude-code":
-      return instructionBlockFiles([...config.instructionTargets, "CLAUDE.md"], block);
+      return instructionBlockFiles(["CLAUDE.md"], block);
     case "cursor":
       return instructionBlockFiles([".cursor/rules/truthmark.mdc"], block);
     case "github-copilot":
@@ -1726,9 +1743,10 @@ var runInit = async (cwd) => {
   results.push(...await scaffoldHierarchy(rootDir, config));
   const migrationDiagnostics = await detectHierarchyMigrationDiagnostics(rootDir, config);
   const block = renderAgentsBlock(config);
-  const platformFiles = config.platforms.flatMap(
-    (platform) => filesForPlatform(platform, config, block)
-  );
+  const platformFiles = [
+    ...instructionBlockFiles(config.instructionTargets, block),
+    ...config.platforms.flatMap((platform) => filesForPlatform(platform, config, block))
+  ];
   const uniquePlatformFiles = Array.from(
     new Map(platformFiles.map((file) => [file.path, file])).values()
   ).sort((left, right) => left.path.localeCompare(right.path));
@@ -1751,7 +1769,7 @@ var runInit = async (cwd) => {
 };
 
 // src/checks/branch-scope.ts
-import fs6 from "fs/promises";
+import fs7 from "fs/promises";
 import fg2 from "fast-glob";
 
 // src/markdown/hash.ts
@@ -1806,7 +1824,7 @@ var getBranchScopeData = async (cwd) => {
   }
   for (const relativePath of [...relevantFiles].sort()) {
     try {
-      const source = await fs6.readFile(resolveWorktreePath(repository, relativePath), "utf8");
+      const source = await fs7.readFile(resolveWorktreePath(repository, relativePath), "utf8");
       relevantFileHashes[relativePath] = hashText(source);
     } catch (error) {
       if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -1823,14 +1841,14 @@ var getBranchScopeData = async (cwd) => {
 };
 
 // src/checks/authority.ts
-import fs7 from "fs/promises";
+import fs8 from "fs/promises";
 import fg3 from "fast-glob";
 var looksLikeGlob = (pattern) => {
   return /[*?[\]{}()!+@]/u.test(pattern);
 };
 var pathExists = async (absolutePath) => {
   try {
-    await fs7.stat(absolutePath);
+    await fs8.stat(absolutePath);
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -1919,7 +1937,7 @@ var checkAuthority = async (rootDir, config) => {
 };
 
 // src/checks/frontmatter.ts
-import fs8 from "fs/promises";
+import fs9 from "fs/promises";
 
 // src/markdown/parse.ts
 import matter from "gray-matter";
@@ -1967,7 +1985,7 @@ var checkFrontmatter = async (rootDir, config, markdownPaths) => {
     }
     const absolutePath = resolveRepoPath(rootDir, markdownPath);
     await assertRepoContainment(rootDir, absolutePath);
-    const source = await fs8.readFile(absolutePath, "utf8");
+    const source = await fs9.readFile(absolutePath, "utf8");
     let document;
     try {
       document = parseMarkdownDocument(source);
@@ -2005,11 +2023,11 @@ var checkFrontmatter = async (rootDir, config, markdownPaths) => {
 };
 
 // src/checks/links.ts
-import fs9 from "fs/promises";
+import fs10 from "fs/promises";
 import path3 from "path";
 var pathExists2 = async (absolutePath) => {
   try {
-    await fs9.stat(absolutePath);
+    await fs10.stat(absolutePath);
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -2025,7 +2043,7 @@ var checkLinks = async (rootDir, markdownPaths) => {
       continue;
     }
     const absolutePath = resolveRepoPath(rootDir, markdownPath);
-    const source = await fs9.readFile(absolutePath, "utf8");
+    const source = await fs10.readFile(absolutePath, "utf8");
     let document;
     try {
       document = parseMarkdownDocument(source);
@@ -2067,12 +2085,12 @@ var checkLinks = async (rootDir, markdownPaths) => {
 };
 
 // src/checks/areas.ts
-import fs11 from "fs/promises";
+import fs12 from "fs/promises";
 import fg5 from "fast-glob";
 import micromatch3 from "micromatch";
 
 // src/routing/area-resolver.ts
-import fs10 from "fs/promises";
+import fs11 from "fs/promises";
 import fg4 from "fast-glob";
 import micromatch from "micromatch";
 
@@ -2229,7 +2247,7 @@ var ensureChildPath = async (rootDir, areaFilesRoot, filePath) => {
 var readRouteFile = async (rootDir, filePath) => {
   try {
     return {
-      source: await fs10.readFile(resolveRepoPath(rootDir, filePath), "utf8"),
+      source: await fs11.readFile(resolveRepoPath(rootDir, filePath), "utf8"),
       diagnostic: null
     };
   } catch (error) {
@@ -2502,7 +2520,7 @@ var classifyPath = (filePath, ignorePatterns) => {
   if (normalizedPath.startsWith(".truthmark/")) {
     return "derived";
   }
-  if (normalizedPath.startsWith(".codex/") || normalizedPath.startsWith(".cursor/") || normalizedPath.startsWith(".gemini/commands/") || normalizedPath.startsWith(".opencode/") || normalizedPath === ".github/copilot-instructions.md" || normalizedPath === "AGENTS.md" || normalizedPath === "CLAUDE.md" || normalizedPath === "GEMINI.md" || normalizedPath.startsWith(".gemini/commands/truthmark/") || normalizedPath.startsWith("skills/truthmark-")) {
+  if (normalizedPath.startsWith(".codex/") || normalizedPath.startsWith(".cursor/") || normalizedPath.startsWith(".gemini/commands/") || normalizedPath.startsWith(".opencode/") || normalizedPath === ".github/copilot-instructions.md" || normalizedPath === "AGENTS.md" || normalizedPath === "CLAUDE.md" || normalizedPath === "GEMINI.md" || normalizedPath.startsWith(".gemini/commands/truthmark/")) {
     return "derived";
   }
   if (ignorePatterns.length > 0 && micromatch2.isMatch(normalizedPath, ignorePatterns)) {
@@ -2529,7 +2547,7 @@ var looksLikeGlob2 = (pattern) => {
 };
 var pathExists3 = async (absolutePath) => {
   try {
-    await fs11.stat(absolutePath);
+    await fs12.stat(absolutePath);
     return true;
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
@@ -2798,7 +2816,7 @@ var checkAreas = async (rootDir, config) => {
 };
 
 // src/checks/decisions.ts
-import fs12 from "fs/promises";
+import fs13 from "fs/promises";
 import micromatch4 from "micromatch";
 var REQUIRED_DECISION_HEADINGS = ["Product Decisions", "Rationale"];
 var escapeRegExp2 = (value) => {
@@ -2821,7 +2839,7 @@ var checkDecisionSections = async (rootDir, config, markdownPaths) => {
   const diagnostics = [];
   const candidatePaths = [...new Set(markdownPaths)].filter((filePath) => isDecisionTruthCandidate(config, filePath)).sort();
   for (const filePath of candidatePaths) {
-    const source = await fs12.readFile(resolveRepoPath(rootDir, filePath), "utf8");
+    const source = await fs13.readFile(resolveRepoPath(rootDir, filePath), "utf8");
     const missingHeadings = REQUIRED_DECISION_HEADINGS.filter((heading) => !hasHeading(source, heading));
     if (missingHeadings.length === 0) {
       continue;
@@ -2837,7 +2855,7 @@ var checkDecisionSections = async (rootDir, config, markdownPaths) => {
 };
 
 // src/checks/generated-surfaces.ts
-import fs13 from "fs/promises";
+import fs14 from "fs/promises";
 
 // src/templates/generated-surfaces.ts
 var workflowSkillFiles2 = (basePath, config) => {
@@ -2916,12 +2934,9 @@ var filesForPlatform2 = (platform, config, block) => {
     case "codex":
       return codexFiles2(config);
     case "opencode":
-      return [
-        ...workflowSkillFiles2("skills", config),
-        ...workflowSkillFiles2(".opencode/skills", config)
-      ];
+      return workflowSkillFiles2(".opencode/skills", config);
     case "claude-code":
-      return instructionBlockFiles2([...config.instructionTargets, "CLAUDE.md"], block);
+      return instructionBlockFiles2(["CLAUDE.md"], block);
     case "cursor":
       return instructionBlockFiles2([".cursor/rules/truthmark.mdc"], block);
     case "github-copilot":
@@ -2951,7 +2966,10 @@ var filesForPlatform2 = (platform, config, block) => {
   }
 };
 var renderGeneratedSurfaces = (config, block = renderAgentsBlock(config)) => {
-  const files = config.platforms.flatMap((platform) => filesForPlatform2(platform, config, block));
+  const files = [
+    ...instructionBlockFiles2(config.instructionTargets, block),
+    ...config.platforms.flatMap((platform) => filesForPlatform2(platform, config, block))
+  ];
   return Array.from(new Map(files.map((file) => [file.path, file])).values()).sort(
     (left, right) => left.path.localeCompare(right.path)
   );
@@ -2960,7 +2978,7 @@ var renderGeneratedSurfaces = (config, block = renderAgentsBlock(config)) => {
 // src/checks/generated-surfaces.ts
 var readOptionalFile = async (rootDir, filePath) => {
   try {
-    return await fs13.readFile(resolveRepoPath(rootDir, filePath), "utf8");
+    return await fs14.readFile(resolveRepoPath(rootDir, filePath), "utf8");
   } catch (error) {
     if (error instanceof Error && "code" in error && error.code === "ENOENT") {
       return null;