@pieai/doc-gov 0.9.9 → 0.9.10

package/dist/cli.js

@@ -1098,7 +1098,7 @@ function runCheck() {
 // src/commands/doctor.ts
 import { spawnSync } from "node:child_process";
 import { existsSync as existsSync8, readFileSync as readFileSync9 } from "node:fs";
-import { isAbsolute as isAbsolute2, join as join10, resolve as resolve4 } from "node:path";
+import { isAbsolute as isAbsolute2, join as join11, resolve as resolve4 } from "node:path";
 
 // src/core/router-integrity.ts
 import { existsSync as existsSync7, lstatSync as lstatSync3, readlinkSync as readlinkSync2, readFileSync as readFileSync8 } from "node:fs";
@@ -1716,6 +1716,54 @@ function findGovernedReadmes(rootDir) {
   }).map((path) => relative4(rootDir, path).split(/\\/g).join("/")).filter((repoPath) => repoPath !== "README.md");
 }
 
+// src/core/windows-host-adapters.ts
+import { lstatSync as lstatSync4, realpathSync as realpathSync2, statSync as statSync2 } from "node:fs";
+import { join as join10 } from "node:path";
+function filterCompatibleWindowsHostAdapterIssues(rootDir, issues) {
+  if (process.platform !== "win32") return [...issues];
+  const claudeEntryOk = isHardLink(join10(rootDir, "CLAUDE.md"), join10(rootDir, "AGENTS.md"));
+  const claudeSkillsOk = resolvesTo(
+    join10(rootDir, ".claude/skills"),
+    join10(rootDir, ".agents/skills")
+  );
+  return issues.filter((issue) => {
+    if (issue.code !== "invalid-host-ssot-adapter" && issue.code !== "noncanonical-host-ssot-adapter") {
+      return true;
+    }
+    if (issue.file === "CLAUDE.md" && claudeEntryOk) return false;
+    if (issue.file === ".claude/skills" && claudeSkillsOk) return false;
+    return true;
+  });
+}
+function isHardLink(candidatePath, canonicalPath) {
+  const candidate = safeLstat3(candidatePath);
+  const canonical = safeLstat3(canonicalPath);
+  if (!candidate?.isFile() || !canonical?.isFile()) return false;
+  try {
+    const left = statSync2(candidatePath);
+    const right = statSync2(canonicalPath);
+    return left.dev === right.dev && left.ino === right.ino;
+  } catch {
+    return false;
+  }
+}
+function resolvesTo(candidatePath, canonicalPath) {
+  const candidate = safeLstat3(candidatePath);
+  if (!candidate?.isSymbolicLink()) return false;
+  try {
+    return realpathSync2(candidatePath) === realpathSync2(canonicalPath);
+  } catch {
+    return false;
+  }
+}
+function safeLstat3(path) {
+  try {
+    return lstatSync4(path);
+  } catch {
+    return void 0;
+  }
+}
+
 // src/commands/doctor.ts
 function runDoctor(_args) {
   const root = process.cwd();
@@ -1740,14 +1788,13 @@ function runDoctor(_args) {
 function collectDoctorIssues(rootDir = process.cwd()) {
   const issues = [];
   const router = checkRouterIntegrity(rootDir);
-  if (!router.ok) {
-    for (const issue of router.issues) {
-      issues.push({
-        severity: "error",
-        code: `router:${issue.code}`,
-        message: `${issue.file}: ${issue.message}`
-      });
-    }
+  const routerIssues = filterCompatibleWindowsHostAdapterIssues(rootDir, router.issues);
+  for (const issue of routerIssues) {
+    issues.push({
+      severity: "error",
+      code: `router:${issue.code}`,
+      message: `${issue.file}: ${issue.message}`
+    });
   }
   const docs = checkDocs(rootDir);
   if (!docs.ok) {
@@ -1781,7 +1828,7 @@ function collectDoctorIssues(rootDir = process.cwd()) {
   return issues;
 }
 function checkLefthook(rootDir) {
-  const path = join10(rootDir, "lefthook.yml");
+  const path = join11(rootDir, "lefthook.yml");
   if (!existsSync8(path)) {
     return [
       {
@@ -1828,7 +1875,7 @@ function checkLefthook(rootDir) {
   return issues;
 }
 function checkDocsCheckWorkflow(rootDir) {
-  const path = join10(rootDir, ".github/workflows/docs-check.yml");
+  const path = join11(rootDir, ".github/workflows/docs-check.yml");
   if (!existsSync8(path)) {
     return [
       {
@@ -1865,7 +1912,7 @@ function resolveGitHookPath(rootDir, hookName) {
     encoding: "utf8"
   });
   const gitPath = result.status === 0 ? result.stdout.trim() : "";
-  if (!gitPath) return join10(rootDir, ".git/hooks", hookName);
+  if (!gitPath) return join11(rootDir, ".git/hooks", hookName);
   return isAbsolute2(gitPath) ? gitPath : resolve4(rootDir, gitPath);
 }
 
@@ -1905,11 +1952,11 @@ function runFind(args2) {
 
 // src/commands/init.ts
 import { existsSync as existsSync10, mkdirSync as mkdirSync4, writeFileSync as writeFileSync5 } from "node:fs";
-import { join as join12 } from "node:path";
+import { join as join13 } from "node:path";
 
 // src/core/templates.ts
 import { existsSync as existsSync9, mkdirSync as mkdirSync3, readFileSync as readFileSync10, writeFileSync as writeFileSync4 } from "node:fs";
-import { join as join11 } from "node:path";
+import { join as join12 } from "node:path";
 var TEMPLATE_FILES = {
   decision: "adr.md",
   spec: "spec.md",
@@ -2117,18 +2164,18 @@ var DEFAULT_TEMPLATES = {
 function loadTemplate(rootDir, type) {
   const file = TEMPLATE_FILES[type];
   if (!file) throw new Error(`No template file mapped for type: ${type}`);
-  const path = join11(rootDir, "docs/governance/templates", file);
+  const path = join12(rootDir, "docs/governance/templates", file);
   if (existsSync9(path)) return readFileSync10(path, "utf8");
   const fallback = DEFAULT_TEMPLATES[file];
   if (fallback) return fallback;
   throw new Error(`Template file is missing: docs/governance/templates/${file}`);
 }
 function ensureDefaultTemplates(rootDir) {
-  const templatesDir = join11(rootDir, "docs/governance/templates");
+  const templatesDir = join12(rootDir, "docs/governance/templates");
   mkdirSync3(templatesDir, { recursive: true });
   let created = 0;
   for (const [file, content] of Object.entries(DEFAULT_TEMPLATES)) {
-    const path = join11(templatesDir, file);
+    const path = join12(templatesDir, file);
     if (existsSync9(path)) continue;
     writeFileSync4(path, content);
     created++;
@@ -2184,7 +2231,7 @@ function runInit(args2) {
   ];
   let created = 0;
   for (const dir of dirs) {
-    const abs = join12(root, dir);
+    const abs = join13(root, dir);
     if (!existsSync10(abs)) {
       mkdirSync4(abs, { recursive: true });
       created++;
@@ -2192,7 +2239,7 @@ function runInit(args2) {
     }
   }
   for (const dir of ["docs/specs/completed", "docs/plans/completed", "docs/archive"]) {
-    const keep = join12(root, dir, ".gitkeep");
+    const keep = join13(root, dir, ".gitkeep");
     if (!existsSync10(keep)) writeFileSync5(keep, "");
   }
   const templatesCreated = ensureDefaultTemplates(root);
@@ -2241,7 +2288,7 @@ function runLinks() {
 
 // src/commands/migrate.ts
 import { existsSync as existsSync11, readFileSync as readFileSync11 } from "node:fs";
-import { join as join13 } from "node:path";
+import { join as join14 } from "node:path";
 var PROFILE_ROUTES = {
   "engineering-runtime": "docs/governance/agents-routing/engineering-runtime-v1.1.md",
   "doc-only": "docs/governance/agents-routing/doc-only-v1.1.md"
@@ -2278,10 +2325,10 @@ function checkMigrationReadiness(rootDir, profile) {
     issues.push(`${issue.file}: ${issue.code}: ${issue.message}`);
   }
   const route = PROFILE_ROUTES[profile];
-  if (!existsSync11(join13(rootDir, route))) {
+  if (!existsSync11(join14(rootDir, route))) {
     issues.push(`missing selected profile route: ${route}`);
   }
-  const agentsPath = join13(rootDir, "AGENTS.md");
+  const agentsPath = join14(rootDir, "AGENTS.md");
   if (existsSync11(agentsPath) && !readFileSync11(agentsPath, "utf8").includes(route)) {
     issues.push(`AGENTS.md must name selected profile route: ${route}`);
   }
@@ -2330,7 +2377,7 @@ function readFlag(args2, name) {
 
 // src/commands/new.ts
 import { existsSync as existsSync12, mkdirSync as mkdirSync5, writeFileSync as writeFileSync6 } from "node:fs";
-import { dirname as dirname5, join as join14 } from "node:path";
+import { dirname as dirname5, join as join15 } from "node:path";
 function runNew(args2) {
   const positional = args2.filter((a) => !a.startsWith("--"));
   const owner = readFlag2(args2, "--owner") ?? "human";
@@ -2356,7 +2403,7 @@ function runNew(args2) {
     console.error(err.message);
     return 1;
   }
-  const absPath = join14(root, plan.filePath);
+  const absPath = join15(root, plan.filePath);
   if (existsSync12(absPath) && !force) {
     console.error(`File already exists: ${plan.filePath}. Use --force to overwrite.`);
     return 1;
@@ -2412,9 +2459,11 @@ function slugToTitle(slug) {
 
 // src/commands/router-check.ts
 function runRouterCheck() {
-  const result = checkRouterIntegrity(process.cwd());
-  if (!result.ok) {
-    for (const issue of result.issues) {
+  const root = process.cwd();
+  const result = checkRouterIntegrity(root);
+  const issues = filterCompatibleWindowsHostAdapterIssues(root, result.issues);
+  if (issues.length > 0) {
+    for (const issue of issues) {
       console.error(`${issue.file}: ${issue.code}: ${issue.message}`);
     }
     return 1;
@@ -2441,7 +2490,7 @@ function runScan(args2) {
 
 // src/commands/supersede.ts
 import { readFileSync as readFileSync12, writeFileSync as writeFileSync7 } from "node:fs";
-import { join as join15 } from "node:path";
+import { join as join16 } from "node:path";
 function runSupersede(args2) {
   const [oldId, newId] = args2;
   if (!oldId || !newId) {
@@ -2477,14 +2526,14 @@ function runSupersede(args2) {
     return 1;
   }
   const today = todayIso();
-  const oldPath = join15(root, oldRec.path);
+  const oldPath = join16(root, oldRec.path);
   let oldContent = readFileSync12(oldPath, "utf8");
   oldContent = updateFrontmatterField(oldContent, "status", "superseded");
   oldContent = updateFrontmatterField(oldContent, "canonical", "false");
   oldContent = updateFrontmatterField(oldContent, "superseded_by", newId);
   oldContent = updateFrontmatterField(oldContent, "last_reviewed", today);
   writeFileSync7(oldPath, oldContent);
-  const newPath = join15(root, newRec.path);
+  const newPath = join16(root, newRec.path);
   let newContent = readFileSync12(newPath, "utf8");
   newContent = appendToFrontmatterList(newContent, "supersedes", newId === oldId ? "" : oldId);
   newContent = updateFrontmatterField(newContent, "last_reviewed", today);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pieai/doc-gov",
-  "version": "0.9.9",
+  "version": "0.9.10",
   "description": "AI-native documentation governance CLI for project docs, agent routing, and lifecycle checks.",
   "keywords": [
     "ai-agents",