@pieai/doc-gov 0.3.2 → 0.3.4

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
@@ -42,7 +45,7 @@ pnpm doc-gov migrate --profile engineering-runtime --check
 By default, Project Governance System governs:
 
 - `docs/**`
-- AI entry files such as `AGENTS.md`, `CLAUDE.md`, and `GEMINI.md`
+- AI entry files/config adapters such as `AGENTS.md`, `CLAUDE.md`, and `.gemini/settings.json`
 - documentation-governance templates, manifest, and agents-routing files
 
 It does not try to swallow product artifacts, prompts, generated media,
@@ -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

@@ -6,6 +6,10 @@ This package is the upstream CLI source for Project Governance System. It can
 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
 
 Normal documents:
@@ -86,4 +90,6 @@ pnpm --filter @pieai/doc-gov typecheck
 
 This package is the preferred CLI source for new adoption work. Existing
 legacy projects should move from local CLI copies to `@pieai/doc-gov` when
-their scripts, local hooks, and CI are updated together.
+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

@@ -869,8 +869,9 @@ function runCheck() {
 }
 
 // src/commands/doctor.ts
+import { spawnSync } from "node:child_process";
 import { existsSync as existsSync7, readFileSync as readFileSync7 } from "node:fs";
-import { join as join9 } from "node:path";
+import { isAbsolute, join as join9, resolve as resolve2 } from "node:path";
 
 // src/core/router-integrity.ts
 import { existsSync as existsSync6, readdirSync as readdirSync5, readFileSync as readFileSync6 } from "node:fs";
@@ -1264,7 +1265,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.`
         });
       }
     }
@@ -1333,8 +1334,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 = [];
@@ -1552,8 +1565,8 @@ function checkLefthook(rootDir) {
       });
     }
   }
-  const preCommit = join9(rootDir, ".git/hooks/pre-commit");
-  const commitMsg = join9(rootDir, ".git/hooks/commit-msg");
+  const preCommit = resolveGitHookPath(rootDir, "pre-commit");
+  const commitMsg = resolveGitHookPath(rootDir, "commit-msg");
   if (!hookCallsLefthook(preCommit)) {
     issues.push({
       severity: "error",
@@ -1603,6 +1616,14 @@ function checkDocsCheckWorkflow(rootDir) {
 function hookCallsLefthook(path) {
   return existsSync7(path) && readFileSync7(path, "utf8").includes("lefthook");
 }
+function resolveGitHookPath(rootDir, hookName) {
+  const result = spawnSync("git", ["-C", rootDir, "rev-parse", "--git-path", `hooks/${hookName}`], {
+    encoding: "utf8"
+  });
+  const gitPath = result.status === 0 ? result.stdout.trim() : "";
+  if (!gitPath) return join9(rootDir, ".git/hooks", hookName);
+  return isAbsolute(gitPath) ? gitPath : resolve2(rootDir, gitPath);
+}
 
 // src/commands/find.ts
 function runFind(args2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pieai/doc-gov",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "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": {