@pieai/pro-gov 0.8.0 → 0.9.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.
@@ -38,7 +38,7 @@ content under the target project's ownership. Optional Lefthook and CI
38
38
  guardrails are also consumer-owned when installed; `doc-gov doctor` checks that
39
39
  their required governance commands remain present.
40
40
 
41
- For non-trivial engineering work, run `pro-gov learn recall --query "<task
41
+ For non-trivial engineering work, run `pnpm pro-gov learn recall --query "<task
42
42
  summary>"` before changing files so existing `docs/reference/learnings/**` and
43
43
  `CONCEPTS.md` lessons can shape the work. After completed, verified, non-trivial
44
44
  work, let `capture-learning` make a visible soft closeout decision. Capture only
@@ -25,11 +25,11 @@
25
25
  "notes": "Public rule for choosing evidence lanes and requiring fresh verification before completion.",
26
26
  "promotion": {
27
27
  "privateSourcePath": "rules/pie-rules/ai-in-the-loop.md",
28
- "privateSourceHash": "sha256:045f9dcd0b1425155a89c863d24ba1509dee4e1e572f23f27fb7fe6f201874ec",
28
+ "privateSourceHash": "sha256:71f487152123491a2c110ad839a90780b08e04ae3a133d59bbe977bf8b2f64e4",
29
29
  "publicHash": "sha256:911702baf6ea1d724e41ea1876d23d80f4de8dfaaadbf1399a40c982c810224c",
30
30
  "sanitized": true,
31
- "lastReviewed": "2026-06-25",
32
- "reviewNotes": "Public copy keeps the evidence-loop method while removing private wording and local-only assumptions."
31
+ "lastReviewed": "2026-08-17",
32
+ "reviewNotes": "Reviewed after the private source gained governed front matter and normalized formatting. The public copy intentionally keeps the portable evidence-loop method without the private Grok compatibility lane or project governance metadata."
33
33
  }
34
34
  },
35
35
  {
@@ -20,14 +20,28 @@
20
20
  - Its selected agents routing file is `PROFILE_ROUTE` under
21
21
  `docs/governance/agents-routing/`.
22
22
 
23
+ ## Policy Discovery
24
+
25
+ All Markdown under `docs/policy/**/*.md`, including subdirectories and any
26
+ symlinked shared-rule files, belongs to the discoverable policy index. This is
27
+ not a command to load every policy at startup. Read the project-local baseline
28
+ and only the shared rules whose task surface actually matches.
29
+
30
+ ## Skill Availability
31
+
32
+ An asset manifest or lock records desired state; it does not prove that an
33
+ optional skill is installed, host-discoverable, loaded, or invoked. Use a skill
34
+ only when its SKILL.md actually exists and can be read. Centrally managed
35
+ project links may need the portfolio control plane to materialize them after a
36
+ fresh clone; their absence must not hide or replace the portable policy rules.
37
+
23
38
  ## Documentation Tasks
24
39
 
25
40
  When the task creates, edits, moves, deletes, or governs documentation, read
26
41
  `docs/governance/boundary.md`, `docs/governance/ssot-v1.1.md`,
27
42
  `docs/governance/doc-agent-rules.md`, `docs/governance/doc-types.md`, the
28
- selected agents routing file, and all Markdown under `docs/policy/**/*.md`.
29
- That policy set includes subdirectories and symlinked shared-rule files; keep
30
- project AI development policy in `docs/policy/`.
43
+ selected agents routing file, and the policy files that govern the changed
44
+ surface. Keep project AI development policy in `docs/policy/`.
31
45
 
32
46
  <!-- PGS-ROUTER:END -->
33
47
 
@@ -6,7 +6,7 @@ status: stable
6
6
  canonical: true
7
7
  owner: human
8
8
  created: 2026-07-13
9
- last_reviewed: 2026-07-16
9
+ last_reviewed: 2026-08-17
10
10
  domain: agents-routing
11
11
  tags:
12
12
  - agents-routing
@@ -30,13 +30,22 @@ This file decides **how to choose a workflow**, not what the project is currentl
30
30
 
31
31
  ```mermaid
32
32
  flowchart TD
33
- A["Task arrives"] --> B["Read project router and current work"]
34
- B --> C["Classify with local lane profile"]
35
- C --> F["Enter local lane"]
36
- F --> H["Use AI-in-the-Loop evidence cycle"]
37
- H --> I["Record evidence in doc-gov"]
33
+ A["Task arrives"] --> B["Read project router and local baseline"]
34
+ B --> C{"Does the task depend on current priorities or in-flight work?"}
35
+ C -->|"yes"| D["Read current work"]
36
+ C -->|"no"| E["Skip current work"]
37
+ D --> F["Classify with local lane profile"]
38
+ E --> F
39
+ F --> G["Enter local lane"]
40
+ G --> H["Use the relevant verification cycle"]
41
+ H --> I["Record durable evidence only when its document role requires it"]
38
42
  ```
39
43
 
44
+ `current-work` is a conditional state surface, not universal startup context.
45
+ Likewise, AI-in-the-Loop applies when implementation or runtime verification
46
+ needs it; a documentation-only or read-only routing task does not load that
47
+ policy by default.
48
+
40
49
  ## Keep It Small
41
50
 
42
51
  Use this router only to pick depth and workflow. Do not use it as a project roadmap.
package/cli-guide.md CHANGED
@@ -34,9 +34,12 @@ pro-gov init --profile engineering-runtime --dry-run
34
34
  pro-gov init --profile engineering-runtime --apply
35
35
  pro-gov init --profile doc-only --dry-run
36
36
  pro-gov sync --check [--profile engineering-runtime|doc-only]
37
- pro-gov doctor
37
+ pro-gov package-doctor
38
38
  ```
39
39
 
40
+ `package-doctor` checks the installed package itself; it is not a target-project
41
+ health claim. The older `doctor` command remains a compatibility alias.
42
+
40
43
  `init --apply` is safe for a fresh target: it preflights every destination and
41
44
  refuses the entire operation if any target file already exists. It never merges
42
45
  or overwrites an existing router or project-local policy. Existing projects