@pieai/pro-gov 0.3.4 → 0.3.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (28) hide show
  1. package/README.md +27 -4
  2. package/assets/docs/reference/adoption/adoption-playbook.md +14 -3
  3. package/assets/docs/reference/adoption/project-relationship.md +7 -5
  4. package/assets/docs/reference/adoption/public-release-checklist.md +27 -2
  5. package/assets/public-agent-assets/README.md +40 -0
  6. package/assets/public-agent-assets/bundles/.gitkeep +0 -0
  7. package/assets/public-agent-assets/bundles/base-governance.json +11 -0
  8. package/assets/public-agent-assets/commands/pie-commands/README.md +3 -0
  9. package/assets/public-agent-assets/registry.json +132 -0
  10. package/assets/public-agent-assets/rules/pie-rules/.gitkeep +0 -0
  11. package/assets/public-agent-assets/rules/pie-rules/ai-in-the-loop.md +66 -0
  12. package/assets/public-agent-assets/rules/pie-rules/rule-evolution-methodology.md +74 -0
  13. package/assets/public-agent-assets/skills/dokobot/.gitkeep +0 -0
  14. package/assets/public-agent-assets/skills/npx-skills/README.md +3 -0
  15. package/assets/public-agent-assets/skills/pie-skills/.gitkeep +0 -0
  16. package/assets/public-agent-assets/skills/pie-skills/beginner-friendly-docs/SKILL.md +225 -0
  17. package/assets/public-agent-assets/skills/pie-skills/doc-cross-validator/SKILL.md +194 -0
  18. package/assets/starter/.github/workflows/docs-check.yml +2 -4
  19. package/assets/starter/docs/governance/agents-routing/doc-only-v0.9.md +2 -3
  20. package/assets/starter/docs/governance/agents-routing/engineering-runtime-v0.9.md +2 -3
  21. package/assets/starter/docs/governance/boundary.md +2 -2
  22. package/assets/starter/docs/governance/ssot-v0.9.md +2 -2
  23. package/assets/starter/lefthook.template.yml +2 -2
  24. package/cli-guide.md +18 -3
  25. package/dist/cli.js +670 -79
  26. package/package.json +12 -13
  27. package/assets/docs/reference/adoption/downstream-project-registry.md +0 -85
  28. package/assets/starter/.gemini/settings.json +0 -5
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pieai/pro-gov",
3
- "version": "0.3.4",
3
+ "version": "0.3.6",
4
4
  "description": "Project-level distribution kit for Project Governance System.",
5
5
  "keywords": [
6
6
  "ai-agents",
@@ -34,24 +34,23 @@
34
34
  "publishConfig": {
35
35
  "access": "public"
36
36
  },
37
- "scripts": {
38
- "dev": "tsx src/cli.ts",
39
- "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",
40
- "prepack": "pnpm build",
41
- "pretest": "pnpm --filter @pieai/doc-gov build && pnpm build",
42
- "test": "tsx --test src/*.test.ts src/**/*.test.ts",
43
- "typecheck": "tsc -p tsconfig.json --noEmit"
44
- },
45
37
  "dependencies": {
46
- "@pieai/doc-gov": "workspace:^"
38
+ "@pieai/doc-gov": "^0.3.6"
47
39
  },
48
40
  "devDependencies": {
49
- "@types/node": "25.0.0",
41
+ "@types/node": "24.13.2",
50
42
  "esbuild": "0.27.7",
51
43
  "tsx": "4.21.0",
52
44
  "typescript": "6.0.3"
53
45
  },
54
46
  "engines": {
55
- "node": ">=22.12.0"
47
+ "node": ">=24 <25"
48
+ },
49
+ "scripts": {
50
+ "dev": "tsx src/cli.ts",
51
+ "build": "node scripts/copy-assets.mjs && esbuild src/cli.ts --bundle --platform=node --format=esm --target=node24 --banner:js=\"#!/usr/bin/env node\" --outfile=dist/cli.js && chmod +x dist/cli.js",
52
+ "pretest": "pnpm --filter @pieai/doc-gov build && pnpm build",
53
+ "test": "tsx --test src/*.test.ts src/**/*.test.ts",
54
+ "typecheck": "tsc -p tsconfig.json --noEmit"
56
55
  }
57
- }
56
+ }
@@ -1,85 +0,0 @@
1
- ---
2
- id: REF-DOWNSTREAM-PROJECT-REGISTRY
3
- title: Downstream Project Registry
4
- type: reference
5
- status: active
6
- canonical: true
7
- owner: human
8
- created: 2026-06-09
9
- last_reviewed: 2026-06-14
10
- domain: adoption
11
- tags:
12
- - downstream
13
- - adoption
14
- - registry
15
- pinned: false
16
- related:
17
- - REF-PROJECT-RELATIONSHIP
18
- - POLICY-SYNC-STRATEGY
19
- ---
20
-
21
- # Downstream Project Registry
22
-
23
- This registry is the central Project Governance System ledger for known local
24
- projects that have adopted this system.
25
-
26
- It records governance adoption state, not product truth. Product plans, runtime
27
- details, IP canon, audit outputs, and project-specific policies remain in the
28
- downstream projects.
29
-
30
- ## Registry Rules
31
-
32
- - Update this file when a project adopts, leaves, renames, or changes profile.
33
- - Keep only projects that currently exist and are expected to receive future
34
- governance updates. Remove deleted or superseded projects instead of keeping
35
- stale health rows.
36
- - Treat package versions as the versions installed in the downstream project's
37
- `package.json`. Record both packages when the project has completed
38
- package-based adoption.
39
- - Treat health as a snapshot. A project can be on the latest version but still
40
- have local working-tree cleanup in progress.
41
- - Do not add a project-specific profile here unless at least two projects need
42
- the same reusable profile.
43
- - Do not use this registry to freeze the upstream local checkout path. The
44
- current local upstream folder may be `ProjectGovernanceSystem`, but downstream
45
- governed docs should prefer `@pieai/doc-gov`, `@pieai/pro-gov`, and "Project
46
- Governance System upstream repository" wording over machine-local paths.
47
-
48
- ## Current Downstream Projects
49
-
50
- The current downstream set was checked on 2026-06-14.
51
-
52
- | Project | Local path | Profile | Installed doc-gov | Installed pro-gov | Health snapshot | Notes |
53
- | --- | --- | --- | --- | --- | --- | --- |
54
- | Anvil | `/Users/yuanfei/PieAI/Anvil` | `engineering-runtime` | `0.3.3` | `0.3.3` | Healthy | `docs:check` passes with 0 warnings. Existing unrelated local writing work was preserved. |
55
- | Collapse | `/Users/yuanfei/PieAI/Collapse` | `engineering-runtime` | `0.3.3` | `0.3.3` | Healthy | Adopted the thin placeholder-phase runtime profile. `docs:check` and the production build pass. |
56
- | Non-Heroes | `/Users/yuanfei/PieAI/Non-Heroes` | `engineering-runtime` | `0.3.3` | `0.3.3` | Healthy | `docs:check` passes with 0 warnings. |
57
- | PieAIStudio-Site | `/Users/yuanfei/PieAI/PieAIStudio-Site` | `engineering-runtime` | `0.3.3` | `0.3.3` | Healthy | `docs:check` passes with 0 warnings. Existing unrelated local skill links were preserved. |
58
- | PieHQ | `/Users/yuanfei/PieAI/PieHQ` | `doc-only` | `0.3.3` | `0.3.3` | Healthy | `docs:check` passes with 0 warnings. |
59
- | Sea | `/Users/yuanfei/PieAI/Sea` | `engineering-runtime` | `0.3.3` | `0.3.3` | Healthy | `docs:check` passes with 0 warnings across the large governed-doc set. |
60
- | Show | `/Users/yuanfei/PieAI/Show` | `engineering-runtime` | `0.3.3` | `0.3.3` | Healthy | `docs:check` passes with 0 warnings. |
61
- | SupaLuv | `/Users/yuanfei/PieAI/SupaLuv` | `engineering-runtime` | `0.3.3` | `0.3.3` | Healthy | Migrated from the vendored `doc-gov@0.2.0` copy. `docs:check` and `cloud:check` pass; unrelated local content work was preserved. |
62
- | YaZu | `/Users/yuanfei/PieAI/YaZu` | `engineering-runtime` | `0.3.3` | `0.3.3` | Healthy | `docs:check` passes with 0 warnings. |
63
- | TuringPact | `/Users/yuanfei/PieAI/TuringPact` | `engineering-runtime` | `0.3.3` | `0.3.3` | Healthy | Migrated the legacy `Docs/` system into current, completed, and archive layers. `docs:check` and `verify:web` pass. |
64
- | ProjectLens | `/Users/yuanfei/PieAI/ProjectLens` | `doc-only` | `0.3.3` | `0.3.3` | Healthy | `docs:check` passes with 0 warnings. ProjectLens is a project-level audit workspace, not a runtime product. |
65
-
66
- ## Representative Examples
67
-
68
- The `examples/` directory is not the full registry. It contains representative
69
- case studies:
70
-
71
- - `examples/non-heroes/example.md` for an engineering-runtime product.
72
-
73
- Add a new example only when a project teaches a reusable adoption pattern that
74
- the existing examples do not cover.
75
-
76
- ## Removal / Rename Notes
77
-
78
- - `Supa` is no longer tracked here because that project was renamed/replaced by
79
- `Non-Heroes`.
80
- - `story-creator` is no longer tracked because the repository was renamed and
81
- replaced by `Anvil`.
82
- - `PieFlow` and `PieIP` were removed from the current registry on 2026-06-14
83
- because those projects were deleted.
84
- - GitNexus is intentionally absent. It has been removed from the central system
85
- and should not be reintroduced through downstream policy links.
@@ -1,5 +0,0 @@
1
- {
2
- "context": {
3
- "fileName": ["AGENTS.md"]
4
- }
5
- }