@pieai/pro-gov 0.4.2 → 0.4.4

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.
@@ -50,13 +50,12 @@ Markdown.
50
50
 
51
51
  Extra governed roots are allowed only when a project explicitly opts in.
52
52
 
53
- Compound Engineering external artifacts are explicitly outside the default Doc
54
- Gov schema:
53
+ Learning and optional-tool artifacts are explicitly outside the default Doc Gov
54
+ schema:
55
55
 
56
56
  - `docs/solutions/**`
57
57
  - `docs/brainstorms/**`
58
58
  - `docs/pulse-reports/**`
59
- - CE-native root artifacts under `docs/plans/*`
60
59
 
61
60
  PGS plans remain under `docs/plans/active/**` and
62
61
  `docs/plans/completed/**`.
@@ -117,7 +116,7 @@ works for governed docs:
117
116
  | Project AI/development policy | `docs/policy/` |
118
117
  | Product or feature requirement | `docs/specs/` |
119
118
  | Step-by-step implementation work | `docs/plans/` |
120
- | Compound Engineering learning records | `docs/solutions/**`, governed by CE schema |
119
+ | Reusable learning records | `docs/solutions/**`, outside Doc Gov schema |
121
120
  | Durable workspace/system truth | `docs/canon/` |
122
121
  | How-to guides, architecture maps, tool notes | `docs/reference/` |
123
122
  | Retired governed history | `docs/archive/` |
@@ -40,7 +40,7 @@ Use `AGENTS.md` for startup reading. It should point agents to:
40
40
  | `docs/specs/completed/` | Completed specs |
41
41
  | `docs/plans/active/` | Active implementation plans |
42
42
  | `docs/plans/completed/` | Completed execution records |
43
- | `docs/solutions/` | Compound Engineering learning records, governed by CE schema |
43
+ | `docs/solutions/` | Reusable learning records, outside Doc Gov schema |
44
44
  | `docs/canon/` | Durable project truth |
45
45
  | `docs/reference/` | Guides and references |
46
46
  | `docs/archive/` | Retired history |
@@ -51,6 +51,6 @@ project-package canon, generated media notes, and source-package files stay in
51
51
  their product/workbench structure unless this project explicitly opts them into
52
52
  doc-gov.
53
53
 
54
- Compound Engineering may create `docs/solutions/**`, `docs/brainstorms/**`,
55
- `docs/pulse-reports/**`, and CE-native root artifacts under `docs/plans/*`.
56
- Those are external workflow artifacts, not Doc Gov canonical documents.
54
+ Optional skills may create `docs/solutions/**`, `docs/brainstorms/**`, or
55
+ `docs/pulse-reports/**`. Those are external artifacts, not Doc Gov canonical
56
+ documents.
package/cli-guide.md CHANGED
@@ -21,17 +21,15 @@ 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 learn recall --query "release downstream sync" --target .
24
- pro-gov learn capture --title "Fallback learning" --summary "Reusable lesson..." --target .
24
+ pro-gov learn capture --title "Reusable learning" --summary "Reusable lesson..." --target .
25
25
  pro-gov lens inspect --target .
26
26
  pro-gov lens report --target . --out .pro-gov/lens-report.md
27
27
  pro-gov lens audit init --target /path/to/project --out audits/project/2026-07-01
28
28
  pro-gov lens audit check --dir audits/project/2026-07-01
29
- pro-gov host-hook --host codex --event Stop --compound-gate-mode off|lite|strict
30
29
  pro-gov init --profile engineering-runtime --dry-run
31
30
  pro-gov init --profile engineering-runtime --apply
32
31
  pro-gov init --profile doc-only --dry-run
33
32
  pro-gov sync --check [--profile engineering-runtime|doc-only]
34
- pro-gov sync --apply-host-hooks --profile engineering-runtime
35
33
  pro-gov doctor
36
34
  ```
37
35
 
@@ -43,46 +41,28 @@ Actions references stay packaged but are not installed by default.
43
41
 
44
42
  `sync --check` is read-only. It compares shared governance core files strictly,
45
43
  but checks project-local seeds such as `AGENTS.md`, project policy, and current
46
- work for presence only. Host configs are compared by PGS-owned entries, so
47
- consumer hooks do not create false drift. It infers the installed profile when
48
- exactly one route exists; `--profile` resolves an empty or temporarily ambiguous target.
44
+ work for presence only. Optional `lefthook.yml` and CI guardrails remain
45
+ consumer-owned when installed; `doc-gov doctor` validates their required PGS
46
+ commands without requiring byte-for-byte template equality. It infers the
47
+ installed profile when exactly one route exists; `--profile` resolves an empty
48
+ or temporarily ambiguous target. PGS does not install or modify AI-host hooks.
49
49
 
50
- `sync --apply-host-hooks` is the bounded write path for engineering-runtime
51
- host configs. It updates only PGS Compound Gate entries and preserves consumer
52
- `PreToolUse`, other events, other top-level keys, and non-PGS entries inside
53
- Stop/SubagentStop arrays. All three files are parsed before any write.
54
-
55
- `learn recall` is the pre-work companion to Compound Engineering's post-work
56
- `ce-compound` learning records. It searches `docs/solutions/**` and
50
+ `learn recall` searches `docs/solutions/**` and
57
51
  `CONCEPTS.md` in the target repository and returns the most relevant prior
58
52
  lessons for the current task. Use it before non-trivial implementation,
59
53
  debugging, release, architecture, or portfolio-sync work. It is read-only and
60
54
  does not require a full local PGS checkout.
61
55
 
62
- `learn capture` is the fallback capture path for hosts where the Compound
63
- Engineering plugin or `ce-compound` skill is unavailable. Prefer CE when it is
64
- installed. Use fallback capture only after verified completed work produced a
65
- reusable lesson that is not already covered by an existing `docs/solutions/**`
66
- record:
56
+ `learn capture` is the small native capture path. Use it only after verified
57
+ work produced a reusable lesson that is not already covered by an existing
58
+ `docs/solutions/**` record:
67
59
 
68
60
  ```bash
69
61
  pro-gov learn capture \
70
- --title "Use fallback capture when CE is unavailable" \
71
- --summary "Capture the reusable lesson through PGS fallback capture so Learning Recall can find it later."
62
+ --title "Keep the reusable lesson searchable" \
63
+ --summary "Capture the lesson so Learning Recall can find it later."
72
64
  ```
73
65
 
74
- Then report:
75
-
76
- ```text
77
- Compound Gate: ran fallback capture -> docs/solutions/<category>/<file>.md
78
- ```
79
-
80
- `host-hook` is the cross-host Compound Gate adapter for Codex, Claude Code, and
81
- Antigravity. `--compound-gate-mode off` is the default and does not interrupt
82
- the main session. `lite` emits a short continuation prompt when completed
83
- engineering work lacks a Compound Gate marker. `strict` emits the fuller legacy
84
- prompt. The same value can be supplied through `PGS_COMPOUND_GATE_MODE`.
85
-
86
66
  Full upstream-checkout commands:
87
67
 
88
68
  ```bash
@@ -120,7 +100,7 @@ maintainer checks.
120
100
  `portfolio assets-check` verifies that the currently recorded lock and managed
121
101
  links are healthy. `portfolio doctor` additionally compares each target with the
122
102
  current portfolio `assetBundles`, registry hashes, package versions, target-local
123
- router/hook checks, and optional `hostTooling` requirements. The doctor is
103
+ router checks, and optional `hostTooling` requirements. The doctor is
124
104
  offline and read-only by default. A dirty product worktree is reported as
125
105
  evidence but is not itself a governance failure.
126
106
 
@@ -138,14 +118,14 @@ The native tools own fetching and installation. PGS reviews resulting asset
138
118
  changes, regenerates plans, and verifies the fleet; it does not implement a
139
119
  second plugin marketplace or silently accept upstream changes.
140
120
 
141
- `lens audit init` creates a raw-first audit package for Project Lens plus
142
- Ponytail reviews. For a "read-only project audit", the target repository remains
121
+ `lens audit init` creates a raw-first audit package for Project Lens reviews.
122
+ For a "read-only project audit", the target repository remains
143
123
  read-only, but the audit package is still the required output record. `lens
144
124
  audit check` fails when the package is missing required artifacts, when
145
125
  artifacts are still marked pending, or when generated template text was not
146
126
  replaced with real audit output. It also requires method records for the
147
- read-only boundary, agent execution, subagent trace, Project Lens/Ponytail
148
- sources, target status, and audit package status. Use
127
+ read-only boundary, agent execution, subagent trace, Project Lens and simplicity
128
+ review sources, target status, and audit package status. Use
149
129
  `lens audit check --mode fresh` when this session must prove it created the raw
150
130
  passes; use `--mode reuse` when it only verifies an existing audit package.
151
131
 
@@ -160,7 +140,6 @@ pnpm pro-gov init --profile engineering-runtime --dry-run
160
140
  pnpm pro-gov init --profile engineering-runtime --apply
161
141
  pnpm doc-gov scan
162
142
  pnpm pro-gov sync --check --profile engineering-runtime
163
- pnpm pro-gov sync --apply-host-hooks --profile engineering-runtime
164
143
  pnpm doc-gov migrate --profile engineering-runtime --check
165
144
  pnpm doc-gov doctor
166
145
  ```