@pieai/pro-gov 0.7.3 → 0.8.0
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.
- package/README.md +6 -1
- package/assets/docs/reference/adoption/migration-v1.0.md +6 -1
- package/assets/docs/reference/adoption/recommended-agent-tooling.md +16 -0
- package/assets/host-dashboard/app.css +1 -0
- package/assets/host-dashboard/app.js +66 -0
- package/assets/host-dashboard/index.html +16 -0
- package/assets/portfolio-dashboard/app.js +5 -5
- package/assets/public-agent-assets/bundles/base-governance.json +1 -2
- package/assets/public-agent-assets/registry.json +3 -36
- package/assets/public-agent-assets/skills/pie-skills/beginner-friendly-docs/SKILL.md +2 -4
- package/cli-guide.md +16 -3
- package/dist/cli.js +4582 -3371
- package/package.json +2 -2
- package/assets/public-agent-assets/skills/pie-skills/doc-cross-validator/SKILL.md +0 -194
|
@@ -87,46 +87,13 @@
|
|
|
87
87
|
"notes": "Public skill for writing teaching-oriented documentation with stories, analogies, diagrams, and examples.",
|
|
88
88
|
"promotion": {
|
|
89
89
|
"privateSourcePath": "skills/pie-skills/beginner-friendly-docs",
|
|
90
|
-
"privateSourceHash": "sha256:
|
|
91
|
-
"publicHash": "sha256:
|
|
90
|
+
"privateSourceHash": "sha256:1d33061af9376ca30a046c26e2d15f67d2972ea2364e799472fcd31c62ba7104",
|
|
91
|
+
"publicHash": "sha256:1d33061af9376ca30a046c26e2d15f67d2972ea2364e799472fcd31c62ba7104",
|
|
92
92
|
"sanitized": false,
|
|
93
|
-
"lastReviewed": "2026-
|
|
93
|
+
"lastReviewed": "2026-07-16",
|
|
94
94
|
"reviewNotes": "Public copy is byte-for-byte aligned with the private source at review time."
|
|
95
95
|
},
|
|
96
96
|
"defaultPlacement": "auto"
|
|
97
|
-
},
|
|
98
|
-
{
|
|
99
|
-
"id": "pie-skills/doc-cross-validator",
|
|
100
|
-
"title": "Doc Cross Validator",
|
|
101
|
-
"family": "pie-skills",
|
|
102
|
-
"kind": "skill",
|
|
103
|
-
"visibility": "public",
|
|
104
|
-
"sourceKind": "local",
|
|
105
|
-
"sourcePath": "skills/pie-skills/doc-cross-validator",
|
|
106
|
-
"hosts": [
|
|
107
|
-
"codex",
|
|
108
|
-
"claude-code",
|
|
109
|
-
"gemini-cli",
|
|
110
|
-
"antigravity"
|
|
111
|
-
],
|
|
112
|
-
"tags": [
|
|
113
|
-
"skill",
|
|
114
|
-
"pie-skills",
|
|
115
|
-
"documentation",
|
|
116
|
-
"validation"
|
|
117
|
-
],
|
|
118
|
-
"publishable": true,
|
|
119
|
-
"origin": "Promoted from maintainer-authored PGS local skills after public review.",
|
|
120
|
-
"notes": "Public skill for checking documentation claims against source code, config, data structures, and command output.",
|
|
121
|
-
"promotion": {
|
|
122
|
-
"privateSourcePath": "skills/pie-skills/doc-cross-validator",
|
|
123
|
-
"privateSourceHash": "sha256:8aadfc76f9c660ca42ac1dc2c2b25119f8f8328fcf759adb35f9106969411ab4",
|
|
124
|
-
"publicHash": "sha256:46bd797682876c3973ae6abf757bfc90fcbb3c451ace493eb091ea86e2b2ee0e",
|
|
125
|
-
"sanitized": true,
|
|
126
|
-
"lastReviewed": "2026-06-25",
|
|
127
|
-
"reviewNotes": "Public copy keeps the validation workflow while removing private checkout wording."
|
|
128
|
-
},
|
|
129
|
-
"defaultPlacement": "manual"
|
|
130
97
|
}
|
|
131
98
|
]
|
|
132
99
|
}
|
|
@@ -186,16 +186,14 @@ graph LR
|
|
|
186
186
|
|
|
187
187
|
### 第六步:交叉验证
|
|
188
188
|
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
写完后必须对照真实系统验证文档内容,确保没有自己想当然地编造流程。
|
|
189
|
+
这一步至关重要。写完后必须直接对照真实系统的源代码、配置、数据结构和命令输出验证文档内容,确保没有自己想当然地编造流程。
|
|
192
190
|
|
|
193
191
|
## 红线(这些是 AI 写教学文档时反复栽的坑,记住"为什么"就不会犯)
|
|
194
192
|
|
|
195
193
|
**所有层级**:
|
|
196
194
|
- 别用"简单来说"开头——它八成是"我没讲清楚"的遮羞布,真清楚的解释不需要这个前缀
|
|
197
195
|
- 别让一整段纯文字不带任何视觉元素(图/表/引用块)——读者的眼睛需要落脚点,文字墙会劝退人
|
|
198
|
-
- 别写完不做交叉验证——读着顺但流程是错的,比"丑但对"
|
|
196
|
+
- 别写完不做交叉验证——读着顺但流程是错的,比"丑但对"更危险
|
|
199
197
|
- 别在没有比喻或例子的情况下抛出复杂概念——抽象概念没有抓手,读者会假装看懂然后悄悄放弃
|
|
200
198
|
|
|
201
199
|
**初级额外**:
|
package/cli-guide.md
CHANGED
|
@@ -21,6 +21,9 @@ pro-gov portfolio plan --config /path/to/portfolio.json --target web-app --json
|
|
|
21
21
|
pro-gov portfolio assets-check --config /path/to/portfolio.json --json
|
|
22
22
|
pro-gov portfolio doctor --config /path/to/portfolio.json --json
|
|
23
23
|
pro-gov portfolio ai-health --config /path/to/portfolio.json --target all --out audits/portfolio-ai-health/2026-07-12
|
|
24
|
+
pro-gov host-lens inspect --config /path/to/portfolio.json --json
|
|
25
|
+
pro-gov host-lens scan --config /path/to/portfolio.json --out audits/host-lens/2026-07-16
|
|
26
|
+
pro-gov host-lens plan --config /path/to/portfolio.json --out audits/host-lens/cleanup-review.json
|
|
24
27
|
pro-gov learn recall --query "release downstream sync" --target .
|
|
25
28
|
pro-gov learn capture --title "Reusable learning" --summary "Reusable lesson..." --target .
|
|
26
29
|
pro-gov lens inspect --target .
|
|
@@ -73,6 +76,7 @@ pro-gov portfolio plan --config /path/to/control-repo/.pro-gov/portfolio.json --
|
|
|
73
76
|
pro-gov portfolio assets-check --config /path/to/control-repo/.pro-gov/portfolio.json --json
|
|
74
77
|
pro-gov portfolio doctor --config /path/to/control-repo/.pro-gov/portfolio.json --json
|
|
75
78
|
pro-gov portfolio ai-health --config /path/to/control-repo/.pro-gov/portfolio.json --target all --out audits/portfolio-ai-health/2026-07-12
|
|
79
|
+
pro-gov host-lens scan --config /path/to/portfolio.json --out .scratch/scheduled/host-lens
|
|
76
80
|
pro-gov assets plan --bundle base-governance --target . --out .pro-gov/asset-plan.json
|
|
77
81
|
pro-gov assets plan --bundle project-lens --target /path/to/project --host codex --placement manual --out /tmp/project-lens-plan.json
|
|
78
82
|
pro-gov assets apply --plan .pro-gov/asset-plan.json
|
|
@@ -94,7 +98,7 @@ target.
|
|
|
94
98
|
`portfolio ai-health` performs a read-only structural inventory of the control
|
|
95
99
|
plane, execution engine, registered targets, user/project AI-host configuration,
|
|
96
100
|
exact technology-version policy, the four verification-gate scripts, bounded
|
|
97
|
-
legacy-directory
|
|
101
|
+
project legacy-directory evidence, and machine-level specialist checks
|
|
98
102
|
explicitly declared in the private manifest (currently DevSpace). It then writes
|
|
99
103
|
a fixed local HTML dashboard plus JSON evidence to the explicit `--out`
|
|
100
104
|
directory. `--target <id>` refreshes one target and merges it into the existing
|
|
@@ -102,8 +106,17 @@ same-portfolio board; `--target all` creates complete coverage. Specialist
|
|
|
102
106
|
checks retain derived health states only; credentials, URLs, and raw process
|
|
103
107
|
environments are never written. The inventory records MCP server names and
|
|
104
108
|
environment filenames, but never reads or emits secret values, environment
|
|
105
|
-
values, MCP commands, arguments, or MCP environment maps.
|
|
106
|
-
read-only and never deletes
|
|
109
|
+
values, MCP commands, arguments, or MCP environment maps. Project redundancy
|
|
110
|
+
evidence is read-only and never deletes legacy directories.
|
|
111
|
+
|
|
112
|
+
`host-lens` owns host-storage inspection that does not belong in ProjectLens.
|
|
113
|
+
It measures known AI-host roots, package stores, Playwright browsers, explicit
|
|
114
|
+
backup/cache/temp groups, and protected runtime/configuration groups without
|
|
115
|
+
reading file contents. `scan` writes a second fixed SwimmerUIKit dashboard;
|
|
116
|
+
`plan` writes only a review checklist with `executable: false` and
|
|
117
|
+
`approved: false`. Prefer each package manager or host's native maintenance
|
|
118
|
+
tool over generic recursive deletion. See `docs/reference/host-lens.md` in a
|
|
119
|
+
full PGS checkout for the boundary and scheduled-operation contract.
|
|
107
120
|
|
|
108
121
|
Portfolio manifests are external configuration files owned by a user or
|
|
109
122
|
organization. PGS provides the format and commands; it does not publish a real
|