@pieai/doc-gov 0.3.6 → 0.3.8

package/README.md

@@ -52,6 +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 selected external workflow artifacts under `docs/**` as
+outside the Doc Gov schema. For example, Compound Engineering learning records
+under `docs/solutions/**` use CE frontmatter, not Doc Gov frontmatter.
+
 ## Status
 
 The CLI is in public preview. The read-only checks are the stable path:

package/cli-guide.md

@@ -1,14 +1,14 @@
 # @pieai/doc-gov
 
-Documentation governance CLI for PieAI projects.
+Documentation governance CLI for AI-assisted projects.
 
 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.
+when a project needs packaged starter/profile assets, guarded fresh-target init,
+or read-only sync planning.
 
 ## Lifecycle
 

package/dist/cli.js

@@ -67,6 +67,24 @@ function parseScalar(value) {
 // src/core/files.ts
 import { existsSync, readdirSync, statSync } from "node:fs";
 import { join, relative } from "node:path";
+
+// src/core/external-artifacts.ts
+var EXTERNAL_ARTIFACT_PREFIXES = [
+  "docs/brainstorms/",
+  "docs/solutions/",
+  "docs/pulse-reports/"
+];
+function isExternalArtifactPath(repoPath) {
+  if (EXTERNAL_ARTIFACT_PREFIXES.some((prefix) => repoPath.startsWith(prefix))) {
+    return true;
+  }
+  if (repoPath.startsWith("docs/plans/") && repoPath !== "docs/plans/active" && !repoPath.startsWith("docs/plans/active/") && repoPath !== "docs/plans/completed" && !repoPath.startsWith("docs/plans/completed/")) {
+    return true;
+  }
+  return false;
+}
+
+// src/core/files.ts
 function listGovernedMarkdownFiles(rootDir) {
   const roots = [join(rootDir, "docs")];
   const files = [];
@@ -90,7 +108,7 @@ function walk(rootDir, dir) {
   return files;
 }
 function shouldSkip(repoPath) {
-  return repoPath.startsWith("docs/governance/templates/") || repoPath === "docs/governance/MANIFEST.yml";
+  return isExternalArtifactPath(repoPath) || repoPath.startsWith("docs/governance/templates/") || repoPath === "docs/governance/MANIFEST.yml";
 }
 function toRepoPath(rootDir, absolutePath) {
   return relative(rootDir, absolutePath).split(/\\/g).join("/");
@@ -750,12 +768,14 @@ function walkMarkdown(rootDir, dir) {
   return files;
 }
 function shouldSkipTree(repoPath) {
+  if (isExternalArtifactPath(repoPath)) return true;
   if (repoPath.startsWith("docs/archive/")) return true;
   if (repoPath.startsWith("docs/governance/templates/")) return true;
   if (repoPath === "docs/governance/MANIFEST.yml") return true;
   return false;
 }
 function shouldIncludeSource(repoPath) {
+  if (isExternalArtifactPath(repoPath)) return false;
   if (repoPath.startsWith("docs/")) {
     if (repoPath.startsWith("docs/governance/")) return true;
     return CURRENT_DOC_DIR_PREFIXES.some((prefix) => repoPath.startsWith(prefix));
@@ -2346,6 +2366,7 @@ function escapeRegex(s) {
 }
 function isGovernedMarkdownPath(path) {
   if (!/\.md$/.test(path)) return false;
+  if (isExternalArtifactPath(path)) return false;
   if (path.startsWith("docs/governance/templates/")) return false;
   if (path === "docs/governance/MANIFEST.yml") return false;
   if (path.startsWith("docs/")) return true;

package/package.json

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