@pieai/pro-gov 0.3.3

package/dist/cli.js

@@ -0,0 +1,244 @@
+#!/usr/bin/env node
+
+// src/assets.ts
+import { existsSync, readdirSync } from "node:fs";
+import { dirname, join, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+var packageRoot = dirname(dirname(fileURLToPath(import.meta.url)));
+var sourceRoot = join(packageRoot, "..", "..");
+var packagedAssetsRoot = join(packageRoot, "assets");
+var assetRoots = [
+  "starter",
+  "profiles",
+  "integrations",
+  "docs/reference/adoption"
+];
+function listAssets() {
+  const root = existsSync(packagedAssetsRoot) ? packagedAssetsRoot : sourceRoot;
+  return assetRoots.flatMap((assetRoot) => {
+    const absoluteRoot = join(root, assetRoot);
+    if (!existsSync(absoluteRoot)) return [];
+    return listFiles(absoluteRoot).map((absolutePath) => ({
+      absolutePath,
+      path: toUnixPath(relative(root, absolutePath))
+    }));
+  }).sort((a, b) => a.path.localeCompare(b.path));
+}
+function isValidProfile(profile) {
+  return profile === "engineering-runtime" || profile === "doc-only";
+}
+function listFiles(dir) {
+  const files = [];
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const absolutePath = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...listFiles(absolutePath));
+    } else if (entry.isFile()) {
+      files.push(absolutePath);
+    }
+  }
+  return files.sort();
+}
+function toUnixPath(path) {
+  return path.replaceAll("\\", "/");
+}
+
+// src/commands/assets.ts
+function runAssets(args) {
+  const [subcommand2] = args;
+  if (subcommand2 !== "list") {
+    console.error("Usage: pro-gov assets list");
+    return 1;
+  }
+  for (const asset of listAssets()) {
+    console.log(asset.path);
+  }
+  return 0;
+}
+
+// src/commands/doctor.ts
+import { spawnSync } from "node:child_process";
+import { existsSync as existsSync2 } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname as dirname2, join as join2 } from "node:path";
+var REQUIRED_ASSETS = [
+  "starter/AGENTS.template.md",
+  "starter/docs/governance/ssot-v0.9.md",
+  "starter/docs/governance/agents-routing/engineering-runtime-v0.9.md",
+  "starter/docs/governance/agents-routing/doc-only-v0.9.md",
+  "profiles/engineering-runtime/profile.md",
+  "profiles/doc-only/profile.md"
+];
+function runDoctor(_args) {
+  const assets = listAssets();
+  const assetPaths = new Set(assets.map((asset) => asset.path));
+  const missing = REQUIRED_ASSETS.filter((assetPath) => !assetPaths.has(assetPath));
+  console.log("pro-gov doctor");
+  console.log(`assets: ${assets.length}`);
+  if (missing.length > 0) {
+    for (const assetPath of missing) {
+      console.error(`missing packaged asset: ${assetPath}`);
+    }
+  } else {
+    console.log("assets: required project-governance assets found");
+  }
+  console.log(checkDocGov());
+  return missing.length > 0 ? 1 : 0;
+}
+function checkDocGov() {
+  const fromPath = spawnSync("doc-gov", ["--help"], {
+    encoding: "utf8",
+    stdio: "ignore"
+  });
+  if (!fromPath.error && fromPath.status === 0) {
+    return "doc-gov: available on PATH";
+  }
+  const dependencyCli = resolveDocGovDependencyCli();
+  if (!dependencyCli) {
+    return "doc-gov: not found; install @pieai/doc-gov beside @pieai/pro-gov for validation.";
+  }
+  const fromDependency = spawnSync(process.execPath, [dependencyCli, "--help"], {
+    encoding: "utf8",
+    stdio: "ignore"
+  });
+  if (!fromDependency.error && fromDependency.status === 0) {
+    return "doc-gov: available via package dependency";
+  }
+  return `doc-gov: dependency found but returned status ${fromDependency.status ?? "unknown"}`;
+}
+function resolveDocGovDependencyCli() {
+  try {
+    const require2 = createRequire(import.meta.url);
+    const packageJsonPath = require2.resolve("@pieai/doc-gov/package.json");
+    const cliPath = join2(dirname2(packageJsonPath), "dist/cli.js");
+    return existsSync2(cliPath) ? cliPath : null;
+  } catch {
+    return null;
+  }
+}
+
+// src/commands/shared.ts
+function planStarterFiles(profile) {
+  return listAssets().flatMap((asset) => {
+    const targetPath = starterTargetPath(asset.path);
+    if (!targetPath) return [];
+    if (profile && isOtherProfileRouting(targetPath, profile)) return [];
+    return [
+      {
+        sourcePath: asset.path,
+        targetPath,
+        absoluteSourcePath: asset.absolutePath
+      }
+    ];
+  }).sort((a, b) => a.targetPath.localeCompare(b.targetPath));
+}
+function isOtherProfileRouting(targetPath, profile) {
+  return targetPath.startsWith("docs/governance/agents-routing/") && targetPath !== `docs/governance/agents-routing/${profile}-v0.9.md`;
+}
+function starterTargetPath(sourcePath) {
+  if (sourcePath === "starter/AGENTS.template.md") return "AGENTS.md";
+  if (sourcePath === "starter/CLAUDE.template.md") return "CLAUDE.md";
+  if (sourcePath === "starter/lefthook.template.yml") return "lefthook.yml";
+  if (!sourcePath.startsWith("starter/")) return null;
+  return sourcePath.slice("starter/".length);
+}
+
+// src/commands/init.ts
+function runInit(args) {
+  const profile = readFlag(args, "--profile");
+  const dryRun = args.includes("--dry-run");
+  if (!dryRun) {
+    console.error("pro-gov init requires --dry-run in this first read-only release.");
+    return 1;
+  }
+  if (!profile) {
+    console.error("Missing required flag: --profile <engineering-runtime|doc-only>");
+    return 1;
+  }
+  if (!isValidProfile(profile)) {
+    console.error(`Invalid profile: ${profile}`);
+    return 1;
+  }
+  console.log("pro-gov init DRY RUN");
+  console.log(`profile: ${profile}`);
+  console.log("");
+  console.log("Planned starter files:");
+  for (const file of planStarterFiles(profile)) {
+    console.log(`  ${file.targetPath} <- ${file.sourcePath}`);
+  }
+  return 0;
+}
+function readFlag(args, flag) {
+  const index = args.indexOf(flag);
+  if (index === -1) return null;
+  const value = args[index + 1];
+  if (!value || value.startsWith("--")) return null;
+  return value;
+}
+
+// src/commands/sync.ts
+import { existsSync as existsSync3, readFileSync } from "node:fs";
+import { join as join3 } from "node:path";
+function runSync(args) {
+  if (!args.includes("--check")) {
+    console.error("pro-gov sync requires --check in this first read-only release.");
+    return 1;
+  }
+  let differences = 0;
+  console.log("pro-gov sync check");
+  for (const file of planStarterFiles()) {
+    const targetPath = join3(process.cwd(), file.targetPath);
+    if (!existsSync3(targetPath)) {
+      console.log(`missing: ${file.targetPath}`);
+      differences += 1;
+      continue;
+    }
+    const source = readFileSync(file.absoluteSourcePath, "utf8");
+    const target = readFileSync(targetPath, "utf8");
+    if (source !== target) {
+      console.log(`different: ${file.targetPath}`);
+      differences += 1;
+    }
+  }
+  if (differences > 0) {
+    console.error(`sync check found ${differences} difference(s).`);
+    return 1;
+  }
+  console.log("sync check passed: starter files match packaged assets.");
+  return 0;
+}
+
+// src/cli.ts
+var COMMANDS = [
+  "assets list",
+  "init --profile <engineering-runtime|doc-only> --dry-run",
+  "sync --check",
+  "doctor"
+];
+var [command, subcommand] = process.argv.slice(2);
+if (!command || command === "--help" || command === "-h") {
+  printHelp();
+  process.exitCode = command ? 0 : 1;
+} else if (command === "assets" && subcommand === "list") {
+  process.exitCode = runAssets(process.argv.slice(3));
+} else if (command === "init") {
+  process.exitCode = runInit(process.argv.slice(3));
+} else if (command === "sync") {
+  process.exitCode = runSync(process.argv.slice(3));
+} else if (command === "doctor") {
+  process.exitCode = runDoctor(process.argv.slice(3));
+} else {
+  console.error(`Unknown command: ${[command, subcommand].filter(Boolean).join(" ")}`);
+  printHelp();
+  process.exitCode = 1;
+}
+function printHelp() {
+  console.log("pro-gov \u2014 project-level distribution kit for Project Governance System");
+  console.log("");
+  console.log("Usage: pro-gov <command> [args...]");
+  console.log("");
+  console.log("Commands:");
+  for (const command2 of COMMANDS) {
+    console.log(`  ${command2}`);
+  }
+}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@pieai/pro-gov",
+  "version": "0.3.3",
+  "description": "Project-level distribution kit for Project Governance System.",
+  "keywords": [
+    "ai-agents",
+    "governance",
+    "project-management",
+    "documentation",
+    "cli"
+  ],
+  "homepage": "https://github.com/PieAIStudio/ProjectGovernanceSystem#readme",
+  "bugs": {
+    "url": "https://github.com/PieAIStudio/ProjectGovernanceSystem/issues"
+  },
+  "license": "MIT",
+  "author": "PieAI <PIEAI@hotmail.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/PieAIStudio/ProjectGovernanceSystem.git",
+    "directory": "packages/pro-gov"
+  },
+  "bin": {
+    "pro-gov": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "assets",
+    "README.md",
+    "LICENSE",
+    "cli-guide.md"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@pieai/doc-gov": "^0.3.3"
+  },
+  "devDependencies": {
+    "@types/node": "25.0.0",
+    "esbuild": "0.27.7",
+    "tsx": "4.21.0",
+    "typescript": "6.0.3"
+  },
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "scripts": {
+    "dev": "tsx src/cli.ts",
+    "build": "node scripts/copy-assets.mjs && 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",
+    "pretest": "pnpm --filter @pieai/doc-gov build && pnpm build",
+    "test": "tsx --test src/**/*.test.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}