@pieai/doc-gov 0.3.0 → 0.3.3

package/README.md

@@ -6,6 +6,9 @@ AI-assisted projects.
 It checks whether governed Markdown documents have the right frontmatter,
 lifecycle status, links, manifest freshness, agents-routing, and project wiring.
 
+`@pieai/doc-gov` is the validator package. For reusable starter/profile assets
+and read-only project-level init/sync checks, use `@pieai/pro-gov` beside it.
+
 ## Install
 
 ```bash
@@ -61,5 +64,6 @@ The CLI is in public preview. The read-only checks are the stable path:
 - `doctor`
 - `migrate --profile <profile> --check`
 
-Future `migrate --apply` and full init profiles should be added only after more
-real projects prove the same migration shape.
+Future write-mode migration or apply behavior should be added only after more
+real projects prove the same migration shape. Project-level write behavior
+belongs in `pro-gov`, not in the validator by default.

package/cli-guide.md

@@ -3,8 +3,12 @@
 Documentation governance CLI for PieAI projects.
 
 This package is the upstream CLI source for Project Governance System. It can
-replace project-local `tools/doc-gov` copies when a project is ready to update
-its scripts and CI together.
+be installed by downstream projects as `@pieai/doc-gov` so scripts, hooks, and
+CI all use the same CLI source.
+
+It is intentionally the validator package. Install `@pieai/pro-gov` beside it
+when a project needs packaged starter/profile assets or read-only init/sync
+planning.
 
 ## Lifecycle
 
@@ -85,5 +89,7 @@ pnpm --filter @pieai/doc-gov typecheck
 ## Current Status
 
 This package is the preferred CLI source for new adoption work. Existing
-projects may keep local `tools/doc-gov` copies until their scripts, local hooks,
-and CI are moved together.
+legacy projects should move from local CLI copies to `@pieai/doc-gov` when
+their scripts, local hooks, and CI are updated together. Use `@pieai/pro-gov`
+for the project-level asset surface instead of copying the whole upstream
+repository into each target project.

package/dist/cli.js

@@ -502,7 +502,7 @@ function renderManifest(records) {
     "# docs/governance/MANIFEST.yml \u2014 auto-generated, DO NOT EDIT MANUALLY",
     "# Regenerate: pnpm doc-gov scan",
     `generated_at: ${(/* @__PURE__ */ new Date()).toISOString()}`,
-    "generator_version: doc-gov@0.3.0",
+    `generator_version: doc-gov@${readPackageVersion()}`,
     `docs_count: ${records.length}`,
     "docs:"
   ];
@@ -518,6 +518,16 @@ function renderManifest(records) {
   lines.push("");
   return lines.join("\n");
 }
+function readPackageVersion() {
+  for (const candidate of ["../package.json", "../../package.json"]) {
+    try {
+      const packageJson = JSON.parse(readFileSync2(new URL(candidate, import.meta.url), "utf8"));
+      if (typeof packageJson.version === "string") return packageJson.version;
+    } catch {
+    }
+  }
+  return "unknown";
+}
 
 // src/commands/approve.ts
 function runApprove(args2) {
@@ -945,6 +955,16 @@ var CENTRAL_REQUIRED_NEEDLES = [
     needle: ROUTER_BLOCK_BEGIN,
     message: "AGENTS.md must include the PGS router block."
   },
+  {
+    file: "AGENTS.md",
+    needle: "docs/policy/**/*.md",
+    message: "AGENTS.md must tell agents to read docs/policy/**/*.md, including subdirectories and shared-rule symlinks."
+  },
+  {
+    file: "AGENTS.md",
+    needle: "symlink",
+    message: "AGENTS.md must state that symlinked shared-rule files under docs/policy/ are included."
+  },
   {
     file: "AGENTS.md",
     needle: "docs/governance/boundary.md",
@@ -1095,6 +1115,16 @@ var CENTRAL_REQUIRED_NEEDLES = [
     needle: "docs/governance/doc-types.md",
     message: "Starter AGENTS template must point agents to docs/governance/doc-types.md."
   },
+  {
+    file: "starter/AGENTS.template.md",
+    needle: "docs/policy/**/*.md",
+    message: "Starter AGENTS template must tell agents to read docs/policy/**/*.md, including subdirectories and shared-rule symlinks."
+  },
+  {
+    file: "starter/AGENTS.template.md",
+    needle: "symlink",
+    message: "Starter AGENTS template must state that symlinked shared-rule files under docs/policy/ are included."
+  },
   {
     file: "starter/AGENTS.template.md",
     needle: "docs/policy/",
@@ -1134,8 +1164,13 @@ var PROJECT_REQUIRED_NEEDLES = [
   },
   {
     file: "AGENTS.md",
-    needle: "docs/policy/",
-    message: "AGENTS.md must point agents to docs/policy/."
+    needle: "docs/policy/**/*.md",
+    message: "AGENTS.md must tell agents to read docs/policy/**/*.md, including subdirectories and shared-rule symlinks."
+  },
+  {
+    file: "AGENTS.md",
+    needle: "symlink",
+    message: "AGENTS.md must state that symlinked shared-rule files under docs/policy/ are included."
   },
   {
     file: "AGENTS.md",
@@ -1229,7 +1264,7 @@ function checkRouterIntegrity(rootDir = process.cwd()) {
         issues.push({
           file,
           code: "project-root-integration-path",
-          message: `Project-level root integrations path must not exist: ${file}. Keep upstream integration docs in project-governance-system; use AGENTS.md or docs/reference/integrations/ only when project-specific guidance is needed.`
+          message: `Project-level root integrations path must not exist: ${file}. Keep upstream integration docs in the Project Governance System upstream repository; use AGENTS.md or docs/reference/integrations/ only when project-specific guidance is needed.`
         });
       }
     }
@@ -1298,8 +1333,20 @@ function checkRouterIntegrity(rootDir = process.cwd()) {
 function isCentralRepository(rootDir) {
   const packageJsonPath = join8(rootDir, "package.json");
   if (!existsSync6(packageJsonPath)) return false;
-  const packageJson = readFileSync6(packageJsonPath, "utf8");
-  return packageJson.includes('"name": "project-governance-system"') && existsSync6(join8(rootDir, "profiles")) && existsSync6(join8(rootDir, "starter")) && existsSync6(join8(rootDir, "integrations"));
+  const packageName = readPackageName(packageJsonPath);
+  const centralPackageNames = /* @__PURE__ */ new Set(["project-governance-system", "pro-gov"]);
+  return centralPackageNames.has(packageName) && hasCentralRepositoryShape(rootDir);
+}
+function readPackageName(packageJsonPath) {
+  try {
+    const packageJson = JSON.parse(readFileSync6(packageJsonPath, "utf8"));
+    return typeof packageJson.name === "string" ? packageJson.name : "";
+  } catch {
+    return "";
+  }
+}
+function hasCentralRepositoryShape(rootDir) {
+  return existsSync6(join8(rootDir, "profiles")) && existsSync6(join8(rootDir, "starter")) && existsSync6(join8(rootDir, "integrations"));
 }
 function validateProjectAgentsRouting(rootDir) {
   const issues = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pieai/doc-gov",
-  "version": "0.3.0",
+  "version": "0.3.3",
   "description": "AI-native documentation governance CLI for project docs, agent routing, and lifecycle checks.",
   "keywords": [
     "ai-agents",
@@ -10,15 +10,15 @@
     "project-management",
     "markdown"
   ],
-  "homepage": "https://github.com/PieAIStudio/project-governance-system#readme",
+  "homepage": "https://github.com/PieAIStudio/ProjectGovernanceSystem#readme",
   "bugs": {
-    "url": "https://github.com/PieAIStudio/project-governance-system/issues"
+    "url": "https://github.com/PieAIStudio/ProjectGovernanceSystem/issues"
   },
   "license": "MIT",
   "author": "PieAI <PIEAI@hotmail.com>",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/PieAIStudio/project-governance-system.git",
+    "url": "git+https://github.com/PieAIStudio/ProjectGovernanceSystem.git",
     "directory": "packages/doc-gov"
   },
   "bin": {
@@ -34,13 +34,6 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {
-    "dev": "tsx src/cli.ts",
-    "build": "node node_modules/esbuild/bin/esbuild src/cli.ts --bundle --platform=node --format=esm --target=node22 --banner:js=\"#!/usr/bin/env node\" --outfile=dist/cli.js && chmod +x dist/cli.js",
-    "prepack": "pnpm build",
-    "test": "tsx --test src/**/*.test.ts",
-    "typecheck": "tsc -p tsconfig.json --noEmit"
-  },
   "devDependencies": {
     "@types/node": "25.0.0",
     "esbuild": "0.27.7",
@@ -49,5 +42,11 @@
   },
   "engines": {
     "node": ">=22.12.0"
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "node node_modules/esbuild/bin/esbuild src/cli.ts --bundle --platform=node --format=esm --target=node22 --banner:js=\"#!/usr/bin/env node\" --outfile=dist/cli.js && chmod +x dist/cli.js",
+    "test": "tsx --test src/**/*.test.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
   }
-}
+}