@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.
@@ -5,7 +5,6 @@
5
5
  "assets": [
6
6
  "pie-rules/ai-in-the-loop",
7
7
  "pie-rules/rule-evolution-methodology",
8
- "pie-skills/beginner-friendly-docs",
9
- "pie-skills/doc-cross-validator"
8
+ "pie-skills/beginner-friendly-docs"
10
9
  ]
11
10
  }
@@ -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:0098a81bf811f4044a62cbc4ddae30728c219be19df9006df593a2f7b610912e",
91
- "publicHash": "sha256:0098a81bf811f4044a62cbc4ddae30728c219be19df9006df593a2f7b610912e",
90
+ "privateSourceHash": "sha256:1d33061af9376ca30a046c26e2d15f67d2972ea2364e799472fcd31c62ba7104",
91
+ "publicHash": "sha256:1d33061af9376ca30a046c26e2d15f67d2972ea2364e799472fcd31c62ba7104",
92
92
  "sanitized": false,
93
- "lastReviewed": "2026-06-25",
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
- 这一步至关重要,单独列为一个技能(见 `doc-cross-validator` 技能)。
190
-
191
- 写完后必须对照真实系统验证文档内容,确保没有自己想当然地编造流程。
189
+ 这一步至关重要。写完后必须直接对照真实系统的源代码、配置、数据结构和命令输出验证文档内容,确保没有自己想当然地编造流程。
192
190
 
193
191
  ## 红线(这些是 AI 写教学文档时反复栽的坑,记住"为什么"就不会犯)
194
192
 
195
193
  **所有层级**:
196
194
  - 别用"简单来说"开头——它八成是"我没讲清楚"的遮羞布,真清楚的解释不需要这个前缀
197
195
  - 别让一整段纯文字不带任何视觉元素(图/表/引用块)——读者的眼睛需要落脚点,文字墙会劝退人
198
- - 别写完不做交叉验证——读着顺但流程是错的,比"丑但对"更危险(见 `doc-cross-validator`)
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/Playwright-cache evidence, and machine-level specialist checks
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. Redundancy evidence is
106
- read-only and never deletes caches or legacy directories.
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