@pieai/doc-gov 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PieAI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,65 @@
+# @pieai/doc-gov
+
+CLI for Project Governance System: a thin documentation-governance layer for
+AI-assisted projects.
+
+It checks whether governed Markdown documents have the right frontmatter,
+lifecycle status, links, manifest freshness, agents-routing, and project wiring.
+
+## Install
+
+```bash
+pnpm add -D @pieai/doc-gov
+```
+
+Then add a script in your project:
+
+```json
+{
+  "scripts": {
+    "doc-gov": "doc-gov"
+  }
+}
+```
+
+## Common Commands
+
+```bash
+pnpm doc-gov init
+pnpm doc-gov new spec first-spec
+pnpm doc-gov check
+pnpm doc-gov scan --check
+pnpm doc-gov links
+pnpm doc-gov audit
+pnpm doc-gov router-check
+pnpm doc-gov doctor
+pnpm doc-gov migrate --profile doc-only --check
+pnpm doc-gov migrate --profile engineering-runtime --check
+```
+
+## What It Governs
+
+By default, Project Governance System governs:
+
+- `docs/**`
+- AI entry files such as `AGENTS.md`, `CLAUDE.md`, and `GEMINI.md`
+- documentation-governance templates, manifest, and agents-routing files
+
+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.
+
+## Status
+
+The CLI is in public preview. The read-only checks are the stable path:
+
+- `check`
+- `scan --check`
+- `links`
+- `audit`
+- `router-check`
+- `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.

package/cli-guide.md

@@ -0,0 +1,89 @@
+# @pieai/doc-gov
+
+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.
+
+## Lifecycle
+
+Normal documents:
+
+```text
+draft -> active -> completed -> stable -> superseded -> archived
+```
+
+Decision documents:
+
+```text
+proposed -> accepted -> rejected | superseded
+```
+
+`completed` means an execution artifact is done but still valuable as proof history. It is especially useful for:
+
+- `docs/plans/completed/**`
+- `docs/specs/completed/**`
+
+Unlike `archived`, a `completed` document may remain `canonical: true`.
+
+## Commands
+
+```bash
+pnpm doc-gov find <topic>
+pnpm doc-gov new <type> <slug>
+pnpm doc-gov check
+pnpm doc-gov scan
+pnpm doc-gov scan --check
+pnpm doc-gov audit
+pnpm doc-gov links
+pnpm doc-gov router-check
+pnpm doc-gov doctor
+pnpm doc-gov migrate --profile doc-only --check
+```
+
+`init` creates the directory skeleton and writes default templates under
+`docs/governance/templates/`, so `doc-gov init` followed by
+`doc-gov new spec test-spec` is a supported first-user path.
+
+`router-check` is intentionally thin:
+
+- In this upstream repo, it verifies that `AGENTS.md`,
+  `docs/governance/agents-routing/`, `profiles/`, and
+  `integrations/superpowers.md` 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
+  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
+  `AGENTS.template.md` can actually be opened, which catches stale startup
+  instructions early.
+
+It does not choose a workflow for a specific task.
+
+`doctor` is the one-command health check:
+
+- It runs router integrity, governed-doc schema, manifest freshness, and local
+  Markdown link checks.
+- It checks whether `lefthook.yml` is both present and installed into
+  `.git/hooks/`.
+- It checks whether `.github/workflows/docs-check.yml` runs the standard
+  doc-gov gate, including `router-check` and `links`.
+
+`migrate --profile <engineering-runtime|doc-only> --check` is intentionally
+read-only. It checks whether the target project is structurally ready for the
+selected profile. It does not move files or rewrite local project truth yet.
+
+## Build
+
+```bash
+pnpm --filter @pieai/doc-gov build
+pnpm --filter @pieai/doc-gov test
+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.