@pieai/doc-gov 0.4.8 → 0.5.0

package/README.md

@@ -52,9 +52,10 @@ It does not try to swallow product artifacts, prompts, generated media,
 runtime notes, or source assets outside `docs/**` unless a project explicitly
 opts them into doc-gov.
 
-It also recognizes reusable learning artifacts under `docs/solutions/**` as
-outside the Doc Gov schema. They use the compact learning-record frontmatter,
-not Doc Gov frontmatter.
+Reusable learning records under `docs/reference/learnings/**` are governed
+`reference` documents. Matt-native `CONTEXT.md`, `CONTEXT-MAP.md`, and
+`docs/adr/**` stay outside the Doc Gov schema; `docs/adr/**` is the only durable
+decision surface.
 
 ## Status
 

package/cli-guide.md

@@ -56,7 +56,7 @@ pnpm doc-gov migrate --profile doc-only --check
   `docs/governance/agents-routing/`, and `profiles/` stay connected in the
   expected order.
 - In a downstream project, it verifies the project router block,
-  `docs/governance/ssot-v0.9.md`, the selected agents-routing file, and old
+  `docs/governance/ssot-v1.0.md`, the selected agents-routing file, and old
   shared SSOT/task-routing leftovers.
 - It also checks that local paths written in backticks inside router-facing
   files such as `AGENTS.md`, `CLAUDE.md`, `README.md`, and the starter

package/dist/cli.js

@@ -73,7 +73,6 @@ var EXTERNAL_ARTIFACT_PREFIXES = [
   "docs/adr/",
   "docs/agents/",
   "docs/brainstorms/",
-  "docs/solutions/",
   "docs/pulse-reports/"
 ];
 function isExternalArtifactPath(repoPath) {
@@ -254,7 +253,7 @@ function isPathAllowedForType(path, type) {
     return type === "policy" || type === "reference";
   }
   if (type === "policy") return path.startsWith("docs/policy/");
-  if (type === "decision") return path.startsWith("docs/decisions/");
+  if (type === "decision") return path.startsWith("docs/adr/");
   if (type === "spec") return path.startsWith("docs/specs/");
   if (type === "plan") return path.startsWith("docs/plans/");
   if (type === "canon") return path.startsWith("docs/canon/");
@@ -400,9 +399,9 @@ function planPath(rootDir, type, slugInput) {
     throw new Error(`Slug "${baseSlug}" must be kebab-case (lowercase, digits, hyphens).`);
   }
   if (type === "decision") {
-    const n = nextSerial(rootDir, "docs/decisions", /^ADR-(\d{4})-/);
+    const n = nextSerial(rootDir, "docs/adr", /^(?:ADR-)?(\d{4})-/);
     return {
-      filePath: `docs/decisions/ADR-${n}-${baseSlug}.md`,
+      filePath: `docs/adr/${n}-${baseSlug}.md`,
       id: `ADR-${n}`,
       slug: baseSlug,
       subdir: ""
@@ -707,7 +706,7 @@ var CURRENT_DOC_DIR_PREFIXES = [
   "docs/reference/",
   "docs/plans/",
   "docs/specs/",
-  "docs/decisions/",
+  "docs/adr/",
   "docs/policy/"
 ];
 var LINK_PATTERN = /!??\[[^\]\n]*\]\(([^)\n]+)\)/g;
@@ -902,7 +901,7 @@ var CENTRAL_REQUIRED_FILES = [
   "AGENTS.md",
   "README.md",
   "docs/governance/boundary.md",
-  "docs/governance/ssot-v0.9.md",
+  "docs/governance/ssot-v1.0.md",
   "docs/governance/templates/adr.md",
   "docs/governance/templates/spec.md",
   "docs/governance/templates/plan.md",
@@ -910,8 +909,8 @@ var CENTRAL_REQUIRED_FILES = [
   "docs/governance/templates/reference.md",
   "docs/governance/templates/policy.md",
   "docs/governance/templates/archive.md",
-  "docs/governance/agents-routing/engineering-runtime-v0.9.md",
-  "docs/governance/agents-routing/doc-only-v0.9.md",
+  "docs/governance/agents-routing/engineering-runtime-v1.0.md",
+  "docs/governance/agents-routing/doc-only-v1.0.md",
   "integrations/mattpocock-skills.md",
   "profiles/engineering-runtime/profile.md",
   "profiles/engineering-runtime/manifest.yml",
@@ -924,9 +923,9 @@ var CENTRAL_REQUIRED_FILES = [
   "starter/docs/reference/execution/current-work.md",
   "starter/docs/policy/best-practice-for-this-project.md",
   "starter/docs/governance/boundary.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",
+  "starter/docs/governance/ssot-v1.0.md",
+  "starter/docs/governance/agents-routing/engineering-runtime-v1.0.md",
+  "starter/docs/governance/agents-routing/doc-only-v1.0.md",
   "starter/docs/governance/doc-agent-rules.md",
   "starter/docs/governance/doc-types.md",
   "starter/docs/governance/templates/adr.md",
@@ -941,14 +940,14 @@ var PROJECT_REQUIRED_FILES = [
   "AGENTS.md",
   "CLAUDE.md",
   "docs/governance/boundary.md",
-  "docs/governance/ssot-v0.9.md",
+  "docs/governance/ssot-v1.0.md",
   "docs/governance/doc-agent-rules.md",
   "docs/governance/doc-types.md",
   "docs/reference/execution/current-work.md"
 ];
 var PROJECT_AGENTS_ROUTING_FILES = [
-  "docs/governance/agents-routing/engineering-runtime-v0.9.md",
-  "docs/governance/agents-routing/doc-only-v0.9.md"
+  "docs/governance/agents-routing/engineering-runtime-v1.0.md",
+  "docs/governance/agents-routing/doc-only-v1.0.md"
 ];
 var FORBIDDEN_LEGACY_PATHS = [
   "governance",
@@ -963,7 +962,7 @@ var FORBIDDEN_PROJECT_PATHS = [
 ];
 var FORBIDDEN_PROJECT_ROOTS = ["integrations"];
 var FORBIDDEN_CENTRAL_ROOTS = ["shared-rules"];
-var ROUTER_BLOCK_BEGIN = "<!-- PGS-ROUTER:BEGIN v0.9 -->";
+var ROUTER_BLOCK_BEGIN = "<!-- PGS-ROUTER:BEGIN v1.0 -->";
 var ROUTER_BLOCK_END = "<!-- PGS-ROUTER:END -->";
 var EXTERNAL_ROUTER_MARKERS = [
   "## gstack",
@@ -993,8 +992,8 @@ var CENTRAL_REQUIRED_NEEDLES = [
   },
   {
     file: "AGENTS.md",
-    needle: "docs/governance/ssot-v0.9.md",
-    message: "AGENTS.md must mention docs/governance/ssot-v0.9.md."
+    needle: "docs/governance/ssot-v1.0.md",
+    message: "AGENTS.md must mention docs/governance/ssot-v1.0.md."
   },
   {
     file: "AGENTS.md",
@@ -1008,13 +1007,13 @@ var CENTRAL_REQUIRED_NEEDLES = [
   },
   {
     file: "AGENTS.md",
-    needle: "docs/governance/agents-routing/engineering-runtime-v0.9.md",
-    message: "AGENTS.md must mention docs/governance/agents-routing/engineering-runtime-v0.9.md."
+    needle: "docs/governance/agents-routing/engineering-runtime-v1.0.md",
+    message: "AGENTS.md must mention docs/governance/agents-routing/engineering-runtime-v1.0.md."
   },
   {
     file: "AGENTS.md",
-    needle: "docs/governance/agents-routing/doc-only-v0.9.md",
-    message: "AGENTS.md must mention docs/governance/agents-routing/doc-only-v0.9.md."
+    needle: "docs/governance/agents-routing/doc-only-v1.0.md",
+    message: "AGENTS.md must mention docs/governance/agents-routing/doc-only-v1.0.md."
   },
   {
     file: "AGENTS.md",
@@ -1032,12 +1031,12 @@ var CENTRAL_REQUIRED_NEEDLES = [
     message: "README.md must point readers to agents-routing under docs/governance/."
   },
   {
-    file: "docs/governance/agents-routing/engineering-runtime-v0.9.md",
+    file: "docs/governance/agents-routing/engineering-runtime-v1.0.md",
     needle: "current-work.md",
     message: "Engineering routing must separate routing from current-work.md."
   },
   {
-    file: "docs/governance/agents-routing/doc-only-v0.9.md",
+    file: "docs/governance/agents-routing/doc-only-v1.0.md",
     needle: "does not use engineering test workflows by default",
     message: "Doc-only routing must exclude engineering test workflows by default."
   },
@@ -1058,7 +1057,7 @@ var CENTRAL_REQUIRED_NEEDLES = [
   },
   {
     file: "profiles/engineering-runtime/manifest.yml",
-    needle: "docs/governance/agents-routing/engineering-runtime-v0.9.md",
+    needle: "docs/governance/agents-routing/engineering-runtime-v1.0.md",
     message: "Engineering profile manifest must point to engineering routing."
   },
   {
@@ -1068,7 +1067,7 @@ var CENTRAL_REQUIRED_NEEDLES = [
   },
   {
     file: "profiles/doc-only/manifest.yml",
-    needle: "docs/governance/agents-routing/doc-only-v0.9.md",
+    needle: "docs/governance/agents-routing/doc-only-v1.0.md",
     message: "Doc-only profile manifest must point to doc-only routing."
   },
   {
@@ -1093,8 +1092,8 @@ var CENTRAL_REQUIRED_NEEDLES = [
   },
   {
     file: "starter/AGENTS.template.md",
-    needle: "docs/governance/ssot-v0.9.md",
-    message: "Starter AGENTS template must point agents to docs/governance/ssot-v0.9.md."
+    needle: "docs/governance/ssot-v1.0.md",
+    message: "Starter AGENTS template must point agents to docs/governance/ssot-v1.0.md."
   },
   {
     file: "starter/AGENTS.template.md",
@@ -1180,8 +1179,8 @@ var PROJECT_REQUIRED_NEEDLES = [
   },
   {
     file: "AGENTS.md",
-    needle: "docs/governance/ssot-v0.9.md",
-    message: "AGENTS.md must mention docs/governance/ssot-v0.9.md."
+    needle: "docs/governance/ssot-v1.0.md",
+    message: "AGENTS.md must mention docs/governance/ssot-v1.0.md."
   },
   {
     file: "AGENTS.md",
@@ -1209,7 +1208,7 @@ var PROJECT_REQUIRED_NEEDLES = [
     message: "Governance boundary must preserve the product artifact boundary."
   },
   {
-    file: "docs/governance/ssot-v0.9.md",
+    file: "docs/governance/ssot-v1.0.md",
     needle: "automatically govern every Markdown file",
     message: "SSOT rule must state that not every Markdown file is governed."
   },
@@ -1314,14 +1313,14 @@ function checkRouterIntegrity(rootDir = process.cwd()) {
     "README.md",
     "starter/AGENTS.template.md",
     "starter/CLAUDE.template.md",
-    "docs/governance/agents-routing/engineering-runtime-v0.9.md",
-    "docs/governance/agents-routing/doc-only-v0.9.md"
+    "docs/governance/agents-routing/engineering-runtime-v1.0.md",
+    "docs/governance/agents-routing/doc-only-v1.0.md"
   ] : [
     "AGENTS.md",
     "CLAUDE.md",
     "README.md",
-    "docs/governance/agents-routing/engineering-runtime-v0.9.md",
-    "docs/governance/agents-routing/doc-only-v0.9.md"
+    "docs/governance/agents-routing/engineering-runtime-v1.0.md",
+    "docs/governance/agents-routing/doc-only-v1.0.md"
   ];
   for (const file of portableRouterFiles) {
     issues.push(...validatePortableRouterText(rootDir, file));
@@ -1677,29 +1676,9 @@ var TEMPLATE_FILES = {
 };
 var DEFAULT_TEMPLATES = {
   "adr.md": [
-    "---",
-    "id: REPLACE-ME",
-    "title: Replace Me",
-    "type: decision",
-    "status: proposed",
-    "canonical: true",
-    "owner: human",
-    "created: YYYY-MM-DD",
-    "last_reviewed: YYYY-MM-DD",
-    "domain: meta",
-    "tags:",
-    "  - replace-me",
-    "pinned: false",
-    "related: []",
-    "---",
-    "",
-    "# REPLACE-ME: Replace Me",
+    "# Replace Me",
     "",
-    "## Context",
-    "",
-    "## Decision",
-    "",
-    "## Consequences",
+    "Record the context, decision, and why in one to three sentences.",
     ""
   ].join("\n"),
   "spec.md": [
@@ -1926,7 +1905,7 @@ function runInit(args2) {
     "docs/governance/agents-routing",
     "docs/governance/templates",
     "docs/policy",
-    "docs/decisions",
+    "docs/adr",
     "docs/specs/active",
     "docs/specs/completed",
     "docs/plans/active",
@@ -1957,7 +1936,7 @@ function runInit(args2) {
 Next steps for a brand-new project:`);
   console.log(`  1. Copy starter/AGENTS.template.md to AGENTS.md and fill the project name.`);
   console.log(`     Copy starter/CLAUDE.template.md to CLAUDE.md as the Claude adapter.`);
-  console.log(`  2. Copy starter/docs/governance/boundary.md, ssot-v0.9.md,`);
+  console.log(`  2. Copy starter/docs/governance/boundary.md, ssot-v1.0.md,`);
   console.log(`     doc-agent-rules.md, doc-types.md, and one agents-routing file.`);
   console.log(`  3. Copy starter/docs/policy/best-practice-for-this-project.md and replace`);
   console.log(`     placeholder policy with this project's real AI/development rules.`);
@@ -1996,8 +1975,8 @@ function runLinks() {
 import { existsSync as existsSync10, readFileSync as readFileSync9 } from "node:fs";
 import { join as join12 } from "node:path";
 var PROFILE_ROUTES = {
-  "engineering-runtime": "docs/governance/agents-routing/engineering-runtime-v0.9.md",
-  "doc-only": "docs/governance/agents-routing/doc-only-v0.9.md"
+  "engineering-runtime": "docs/governance/agents-routing/engineering-runtime-v1.0.md",
+  "doc-only": "docs/governance/agents-routing/doc-only-v1.0.md"
 };
 function runMigrate(args2) {
   const checkOnly = args2.includes("--check");
@@ -2114,9 +2093,26 @@ function runNew(args2) {
     console.error(`File already exists: ${plan.filePath}. Use --force to overwrite.`);
     return 1;
   }
+  if (type === "decision") {
+    const title2 = titleOverride ?? slugToTitle(plan.slug);
+    mkdirSync5(dirname4(absPath), { recursive: true });
+    writeFileSync6(
+      absPath,
+      `# ${title2}
+
+Record the context, decision, and why in one to three sentences.
+`
+    );
+    console.log(`Created ${plan.filePath} with id ${plan.id}.`);
+    console.log(`
+Next steps:`);
+    console.log(`  1. Replace the placeholder sentence in ${plan.filePath}.`);
+    console.log(`  2. Keep this ADR concise; Doc Gov intentionally treats docs/adr/** as Matt-compatible external artifacts.`);
+    return 0;
+  }
   const template = loadTemplate(root, type);
-  const status = type === "decision" ? "proposed" : "draft";
-  const canonical = type === "decision";
+  const status = "draft";
+  const canonical = false;
   const today = todayIso();
   const title = titleOverride ?? slugToTitle(plan.slug);
   const rendered = renderTemplate(template, {

package/package.json

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