@pieai/pro-gov 0.4.3 → 0.4.5

package/assets/integrations/ponytail.md

@@ -1,161 +0,0 @@
-# Ponytail Integration
-
-Ponytail is an external plugin that asks an AI to prefer the smallest solution
-that still works. Project Governance System does not vendor, rewrite, or require
-the Ponytail plugin.
-
-## The Beginner Version
-
-Think of an AI project as a building site:
-
-- PGS is the traffic desk and inspection station.
-- Superpowers is the construction process.
-- Ponytail is the cost and complexity adviser.
-
-The adviser can stop the team from buying unnecessary materials. The adviser
-cannot cancel the fire exit, the safety inspection, or a room the owner
-explicitly requested.
-
-## Safe Default
-
-Keep the global Ponytail mode `off`.
-
-`off` does not mean Ponytail is useless. It means Ponytail is available when a
-task needs a simplicity review without silently influencing every project and
-every answer.
-
-Do not describe `lite` as "almost off." In Ponytail 4.7.0, `lite` still injects
-the shared minimalism rules into the active AI context. Its mode-specific line
-is gentler than `full`, but the same AI still sees rules about fewer files,
-fewer abstractions, shorter diffs, and avoiding speculative work.
-
-## Mode Policy
-
-| Mode | Governed use |
-| --- | --- |
-| `off` | Recommended global default. Ponytail does not inject its active ruleset. |
-| `lite` | First mode to test in one isolated task or session. Complete the requested work, while surfacing a simpler option. |
-| `full` | Optional stress test after `lite`. Use only in an isolated task to see whether stronger minimalism harms scope or proof. |
-| `ultra` | Not part of the recommended PGS workflow. It is too aggressive for a default governed engineering lane. |
-
-Return to `off` after every comparison.
-
-## Comparison Protocol
-
-Use the same bounded, low-risk task in separate sessions or worktrees:
-
-```text
-baseline with off
--> repeat with lite
--> compare scope, proof, complexity, and clarity
--> optionally repeat with full
--> return global mode to off
-```
-
-Compare:
-
-- whether every requested requirement was delivered;
-- whether Superpowers brainstorming, planning, TDD, debugging, and verification
-  gates were preserved;
-- whether tests, security, accessibility, validation, and data-loss prevention
-  remained intact;
-- files, dependencies, abstractions, and lines changed;
-- whether the explanation and durable evidence stayed understandable;
-- token and time measurements only when the AI host exposes trustworthy data.
-
-A shorter answer or smaller diff is not automatically a better result.
-
-## Priority And Boundary
-
-Use this priority order:
-
-1. User instructions and project safety requirements.
-2. PGS routing, governance boundaries, and required evidence.
-3. Superpowers workflow gates.
-4. Ponytail complexity and cost advice.
-
-Ponytail may:
-
-- question speculative scope;
-- prefer the standard library or an already-installed dependency;
-- suggest fewer files, dependencies, and abstractions;
-- identify code or structure that can be removed safely.
-
-Ponytail may not:
-
-- remove an explicit requirement;
-- bypass PGS routing or document placement;
-- skip required brainstorming, plans, TDD, debugging, or verification;
-- weaken security, accessibility, trust-boundary validation, error handling, or
-  data-loss protection;
-- replace proof with "the code is shorter";
-- silently change the user's global Ponytail configuration.
-
-## Recommended Workflow
-
-```mermaid
-flowchart TD
-  A["Task arrives"] --> B["PGS selects the project lane"]
-  B --> C["Superpowers runs the required workflow"]
-  C --> D{"Would a simplicity review help?"}
-  D -- "no" --> E["Implement and verify normally"]
-  D -- "yes" --> F["Use Ponytail explicitly for this task"]
-  F --> G["Keep requirements and proof intact"]
-  G --> E
-```
-
-For normal engineering, Ponytail is a scoped adviser, not a second workflow
-engine and not a replacement for Superpowers.
-
-## ProjectLens Audit Use
-
-When ProjectLens and Ponytail are used together for a target-project audit,
-ProjectLens owns the audit package contract. Ponytail acts as an independent
-senior engineering reviewer whose simplicity, YAGNI, dependency, abstraction,
-and rewrite judgment can challenge ProjectLens recommendations.
-
-For this combined workflow, "read-only project audit" means the target
-repository must not be modified. It does not mean "do not write the PGS audit
-package." The audit package is the required owner-facing evidence record.
-
-Use this order:
-
-1. The main agent establishes target path, goal, current phase, target commit or
-   working state, then creates the package with
-   `pro-gov lens audit init --target <path> --out audits/<target>/<date>`.
-2. ProjectLens gathers local evidence and writes its own raw artifacts under
-   `raw/project-lens/`.
-3. Ponytail runs independently and writes its own raw artifacts under
-   `raw/ponytail/`. For initial whole-project audits, preserve at least
-   `ponytail-audit`, `ponytail-debt`, and `ponytail-gain` outputs when the
-   plugin can produce them.
-4. The target command log records Project Lens and Ponytail method sources.
-5. The main agent writes `synthesis/decision-index.md` and
-   `synthesis/handoff-for-implementation-ai.md`, then runs
-   `pro-gov lens audit check --dir audits/<target>/<date>`.
-
-Use subagents for the ProjectLens/Ponytail raw passes when the AI host exposes
-them and the user has authorized subagent or parallel agent work. If host rules
-block subagents, preserve the same raw-output separation with serial passes and
-record the fallback in the audit package. Do not claim that subagents were used
-when they were not. The manifest must include `Subagent trace:` with each pass
-role, execution mode, final status, and raw artifact path; if durable subagent
-IDs are unavailable, record that limitation.
-
-Do not blur a fresh audit with a reuse verification. For a fresh ProjectLens plus
-Ponytail audit, run `pro-gov lens audit check --dir <audit-dir> --mode fresh`.
-If an existing package is reused because the target commit and package check are
-still valid, label the result as reuse and run `--mode reuse`.
-
-Do not blend Ponytail findings into ProjectLens files. Do not suppress Ponytail
-to make ProjectLens look correct. Preserve material disagreements in the raw
-artifacts and let the synthesis state which judgment won and why. The shared
-boundary is evidence, user intent, project safety, explicit product-line
-direction, and PGS's technology-governance protocol. If a stack direction
-exists, Ponytail may challenge migration scope, timing, and complexity, while
-ProjectLens records the direction as the product group's stated intent and PGS
-classifies the execution posture.
-
-Use `ponytail-review` later for implementation diffs or PR-style changes. For
-initial read-only project audits, prefer the whole-repo Ponytail modes above so
-the audit starts from system shape instead of line-level patch review.

package/assets/integrations/superpowers.md

@@ -1,107 +0,0 @@
-# Superpowers Integration
-
-Superpowers is an external plugin/system. This repository does not vendor or rewrite it.
-
-## The Beginner Version
-
-Think of an AI project as a building site:
-
-- PGS is the traffic desk and inspection station.
-- Superpowers is the construction process.
-- `pro-gov learn recall` is the pre-work lookup for reusable lessons.
-- Compound Engineering's `ce-compound` is the knowledge-capture tail.
-- Ponytail is an optional cost and complexity adviser.
-
-PGS chooses the lane. Superpowers makes sure the work follows the right
-engineering process. Learning Recall checks prior lessons before work starts.
-Compound Engineering records reusable lessons after verified work. Ponytail may
-suggest a leaner implementation, but it cannot cancel the process or the final
-inspection.
-
-## Boundary
-
-Superpowers owns engineering workflows such as:
-
-- brainstorming
-- writing plans
-- TDD
-- debugging
-- verification before completion
-- worktree usage
-
-Superpowers 6.x for Codex is skill-routed, not hook-driven. The plugin manifest
-does not need a SessionStart hook for PGS to make use of it. The startup
-behavior comes from the `using-superpowers` skill description, which tells the
-host to check relevant skills at the start of a conversation and before acting.
-Do not add a PGS hook just to force Superpowers startup unless a future
-Superpowers release explicitly requires one.
-
-Project Governance System owns:
-
-- documentation lifecycle
-- agents routing
-- current work index conventions
-- pre-work learning recall through `pro-gov learn recall`
-- the governed location and boundary for externally sourced AI evidence rules
-
-Ponytail, when explicitly enabled for a task, may advise on:
-
-- speculative scope;
-- unnecessary dependencies;
-- avoidable files and abstractions;
-- simpler implementation choices.
-
-Compound Engineering, by default, owns:
-
-- post-work knowledge capture through `ce-compound`;
-- fallback capture through `pro-gov learn capture` only when CE is unavailable;
-- `docs/solutions/**` learning records and their CE frontmatter;
-- CE-owned external artifacts when the user explicitly invokes CE workflows.
-
-## Rule
-
-Use Superpowers inside the selected project lane. Do not let Superpowers create a separate durable document tree unless the project explicitly adopts one.
-
-Durable outputs should map back to the project's doc-gov layers:
-
-- specs -> `docs/specs/**`
-- plans -> `docs/plans/**`
-- durable references -> `docs/reference/**`
-
-## Execution Order
-
-Agents routing classifies first. For non-trivial work, Learning Recall checks
-prior `docs/solutions/**` and `CONCEPTS.md` records before files change.
-Superpowers executes inside the selected lane. Optional Ponytail advice may run
-after those responsibilities are known. It may make the implementation leaner,
-but it must not remove explicit requirements or reduce how correctness is
-proven. The Compound Gate runs near the end, before final reporting, to decide
-whether verified work produced reusable learning.
-
-```mermaid
-flowchart TD
-  A["Task arrives"] --> B["Read project router and current work"]
-  B --> C["Classify profile and lane"]
-  C --> R["Run Learning Recall for non-trivial work"]
-  R --> D{"Does this lane need a Superpowers workflow?"}
-  D -- "yes" --> E["Use the matching Superpowers skill"]
-  D -- "no" --> F["Use the local non-Superpowers lane rules"]
-  E --> G{"Would an explicit simplicity review help?"}
-  F --> G
-  G -- "yes" --> H["Use Ponytail without dropping workflow gates"]
-  G -- "no" --> I["Pass the Compound Gate"]
-  H --> I
-  I --> J["Write durable outputs into doc-gov layers"]
-```
-
-If Superpowers suggests a default location such as `docs/superpowers/**`, project instructions may override that location. The durable project record should still land in the governed doc-gov layer unless the project has explicitly adopted a separate Superpowers document tree.
-
-Host-specific files such as `CLAUDE.md` may include Superpowers skill routing
-text. That text is an adapter. It must not replace the project `AGENTS.md`
-router or run before the Project Governance System routing block.
-
-For Ponytail mode policy and the isolated comparison protocol, read
-`integrations/ponytail.md`.
-
-For Compound Engineering's knowledge-capture boundary, read
-`integrations/compound-engineering.md`.

package/assets/starter/.agents/hooks.json

@@ -1,26 +0,0 @@
-{
-  "pgs-compound-gate": {
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cd \"$(git rev-parse --show-toplevel)\" && if [ -x ./node_modules/.bin/pro-gov ]; then PGS_HOST_HOOK_DEBUG=1 ./node_modules/.bin/pro-gov host-hook --host antigravity --event Stop --compound-gate-mode off; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; PGS_HOST_HOOK_DEBUG=1 pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host antigravity --event Stop --compound-gate-mode off; else PGS_HOST_HOOK_DEBUG=1 npx --no-install @pieai/pro-gov host-hook --host antigravity --event Stop --compound-gate-mode off; fi",
-            "timeout": 30
-          }
-        ]
-      }
-    ],
-    "SubagentStop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cd \"$(git rev-parse --show-toplevel)\" && if [ -x ./node_modules/.bin/pro-gov ]; then PGS_HOST_HOOK_DEBUG=1 ./node_modules/.bin/pro-gov host-hook --host antigravity --event SubagentStop --compound-gate-mode off; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; PGS_HOST_HOOK_DEBUG=1 pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host antigravity --event SubagentStop --compound-gate-mode off; else PGS_HOST_HOOK_DEBUG=1 npx --no-install @pieai/pro-gov host-hook --host antigravity --event SubagentStop --compound-gate-mode off; fi",
-            "timeout": 30
-          }
-        ]
-      }
-    ]
-  }
-}

package/assets/starter/.claude/settings.json

@@ -1,26 +0,0 @@
-{
-  "hooks": {
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cd \"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}\" && if [ -x ./node_modules/.bin/pro-gov ]; then ./node_modules/.bin/pro-gov host-hook --host claude-code --event Stop --compound-gate-mode off; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host claude-code --event Stop --compound-gate-mode off; else npx --no-install @pieai/pro-gov host-hook --host claude-code --event Stop --compound-gate-mode off; fi",
-            "timeout": 30
-          }
-        ]
-      }
-    ],
-    "SubagentStop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cd \"${CLAUDE_PROJECT_DIR:-$(git rev-parse --show-toplevel)}\" && if [ -x ./node_modules/.bin/pro-gov ]; then ./node_modules/.bin/pro-gov host-hook --host claude-code --event SubagentStop --compound-gate-mode off; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host claude-code --event SubagentStop --compound-gate-mode off; else npx --no-install @pieai/pro-gov host-hook --host claude-code --event SubagentStop --compound-gate-mode off; fi",
-            "timeout": 30
-          }
-        ]
-      }
-    ]
-  }
-}

package/assets/starter/.codex/hooks.json

@@ -1,28 +0,0 @@
-{
-  "hooks": {
-    "Stop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cd \"$(git rev-parse --show-toplevel)\" && if [ -x ./node_modules/.bin/pro-gov ]; then ./node_modules/.bin/pro-gov host-hook --host codex --event Stop --compound-gate-mode off; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host codex --event Stop --compound-gate-mode off; else npx --no-install @pieai/pro-gov host-hook --host codex --event Stop --compound-gate-mode off; fi",
-            "timeout": 30,
-            "statusMessage": "Checking PGS Compound Gate"
-          }
-        ]
-      }
-    ],
-    "SubagentStop": [
-      {
-        "hooks": [
-          {
-            "type": "command",
-            "command": "cd \"$(git rev-parse --show-toplevel)\" && if [ -x ./node_modules/.bin/pro-gov ]; then ./node_modules/.bin/pro-gov host-hook --host codex --event SubagentStop --compound-gate-mode off; elif [ -f packages/pro-gov/src/cli.ts ] && { command -v corepack >/dev/null 2>&1 || command -v pnpm >/dev/null 2>&1; }; then pgs_pnpm() { if command -v corepack >/dev/null 2>&1; then corepack pnpm \"$@\"; else pnpm \"$@\"; fi; }; pgs_pnpm --silent --filter @pieai/pro-gov dev host-hook --host codex --event SubagentStop --compound-gate-mode off; else npx --no-install @pieai/pro-gov host-hook --host codex --event SubagentStop --compound-gate-mode off; fi",
-            "timeout": 30,
-            "statusMessage": "Checking PGS subagent Compound Gate"
-          }
-        ]
-      }
-    ]
-  }
-}