@gtrabanco/pi-agentic-workflow 0.13.3 → 0.14.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.
Files changed (91) hide show
  1. package/README.md +3 -9
  2. package/dist/runtime.d.ts +45 -0
  3. package/dist/runtime.js +62 -0
  4. package/package.json +3 -2
  5. package/skills/audit-docs/SKILL.md +6 -5
  6. package/skills/audit-pr/SKILL.md +1 -1
  7. package/skills/audit-pr/references/PORTABILITY.md +1 -1
  8. package/skills/execute-phase/SKILL.md +207 -116
  9. package/skills/execute-phase/references/DESCOPE.md +22 -18
  10. package/skills/execute-phase/references/EXECUTION_CONTRACT.md +69 -77
  11. package/skills/execute-phase/references/FOLDING.md +34 -47
  12. package/skills/execute-phase/references/PREFLIGHT.md +103 -114
  13. package/skills/execute-phase/references/PRE_EXECUTION_GATE.md +53 -60
  14. package/skills/init-workspace/SKILL.md +35 -5
  15. package/skills/init-workspace/references/BOOTSTRAP_DISCOVERY.md +5 -5
  16. package/skills/init-workspace/references/BOOTSTRAP_WRITE.md +15 -8
  17. package/skills/init-workspace/references/PORTABILITY.md +1 -1
  18. package/skills/init-workspace/references/UPGRADE.md +17 -7
  19. package/skills/log-session/SKILL.md +4 -3
  20. package/skills/orchestration-envelope/references/TURN_CONTRACT.md +1 -1
  21. package/skills/pre-execution-review/references/LEDGERS.md +39 -39
  22. package/skills/pre-execution-review/references/POLICY.md +1 -0
  23. package/skills/review-change/SKILL.md +1 -1
  24. package/skills/review-change/references/PORTABILITY.md +1 -1
  25. package/skills/unit-lane/SKILL.md +154 -0
  26. package/skills/unit-lane/references/DESIGN.md +35 -0
  27. package/skills/unit-lane/references/DOCS.md +36 -0
  28. package/skills/unit-lane/references/EVIDENCE.md +34 -0
  29. package/skills/unit-lane/references/IMPLEMENT.md +45 -0
  30. package/skills/unit-lane/references/PLAN.md +38 -0
  31. package/skills/unit-lane/references/RELEASE.md +45 -0
  32. package/skills/unit-lane/references/RESEARCH.md +37 -0
  33. package/skills/unit-lane/references/REVIEW.md +45 -0
  34. package/skills/unit-lane/references/STEPS.md +23 -0
  35. package/skills/unit-lane/references/TESTS.md +32 -0
  36. package/skills/workflow-status/references/ENVELOPE_FIELDS.md +5 -6
  37. package/skills/workflow-status/references/SENSOR_CORE.md +16 -20
  38. package/skills/workflow-status/references/SENSOR_SIGNALS.md +5 -7
  39. package/skills/design-feature/SKILL.md +0 -231
  40. package/skills/design-feature/references/INTERVIEW.md +0 -74
  41. package/skills/design-feature/references/PORTABILITY.md +0 -15
  42. package/skills/design-feature/references/REPAIR.md +0 -88
  43. package/skills/design-feature/references/UPSERT_EXAMPLE.md +0 -8
  44. package/skills/design-feature/references/WRITE_AND_UPSERT.md +0 -115
  45. package/skills/evidence-grounding/SKILL.md +0 -174
  46. package/skills/evidence-grounding/references/DELEGATION.md +0 -131
  47. package/skills/evidence-grounding/references/READINESS.md +0 -130
  48. package/skills/evidence-grounding/references/ROWS.md +0 -93
  49. package/skills/execute-phase/references/BATCH_AND_PORTABILITY.md +0 -57
  50. package/skills/execute-phase/references/CLOSEOUT.md +0 -77
  51. package/skills/execute-phase/references/HANDOFF.md +0 -21
  52. package/skills/execute-phase/references/OPPORTUNISTIC_FINDING.md +0 -45
  53. package/skills/execute-phase/references/UNIT_LOOP.md +0 -88
  54. package/skills/execute-phase/references/WORKFLOWS_FEATURE.md +0 -37
  55. package/skills/execute-phase/references/WORKFLOWS_FIX.md +0 -43
  56. package/skills/execute-phase/references/WORKFLOWS_LEGACY.md +0 -26
  57. package/skills/execute-phase/references/WORKFLOWS_SMALL_PHASED.md +0 -38
  58. package/skills/generate-docs/SKILL.md +0 -145
  59. package/skills/generate-docs/references/ADAPTERS.md +0 -15
  60. package/skills/generate-docs/references/ADAPTER_DISCOVERY.md +0 -33
  61. package/skills/generate-docs/references/GENERATION_PROCESS.md +0 -90
  62. package/skills/implementation-discovery/SKILL.md +0 -209
  63. package/skills/plan-feature/SKILL.md +0 -208
  64. package/skills/plan-feature/references/ROUTING.md +0 -155
  65. package/skills/plan-feature-from-issue/SKILL.md +0 -162
  66. package/skills/plan-feature-scaffold/SKILL.md +0 -112
  67. package/skills/plan-feature-scaffold/references/SCAFFOLD_PROCESS.md +0 -122
  68. package/skills/plan-fix/SKILL.md +0 -161
  69. package/skills/plan-fix/references/PLANNING_PROCESS.md +0 -148
  70. package/skills/plan-fix/references/SPEC_CONTRACT.md +0 -22
  71. package/skills/planning-preflight/SKILL.md +0 -130
  72. package/skills/replan-findings/SKILL.md +0 -131
  73. package/skills/replan-findings/references/PHASE_APPEND.md +0 -89
  74. package/skills/review-plan/SKILL.md +0 -154
  75. package/skills/review-plan/references/CHECKS.md +0 -111
  76. package/skills/review-plan/references/ENG-CHECKS.md +0 -30
  77. package/skills/review-plan/references/OUTPUT.md +0 -166
  78. package/skills/review-spec/SKILL.md +0 -145
  79. package/skills/review-spec/references/CHECKS.md +0 -108
  80. package/skills/review-spec/references/OUTPUT.md +0 -160
  81. package/skills/ship-roadmap/SKILL.md +0 -120
  82. package/skills/ship-roadmap/references/ADVANCE.md +0 -117
  83. package/skills/ship-roadmap/references/AUDIT_AND_MERGE.md +0 -64
  84. package/skills/ship-roadmap/references/CLOSEOUT_AND_LOG.md +0 -27
  85. package/skills/ship-roadmap/references/FOUNDING.md +0 -101
  86. package/skills/ship-roadmap/references/GUARDRAILS.md +0 -56
  87. package/skills/ship-roadmap/references/MODEL_ROUTING.md +0 -16
  88. package/skills/ship-roadmap/references/PORTABILITY.md +0 -34
  89. package/skills/ship-roadmap/references/RECOVERY_AND_SELECTION.md +0 -94
  90. package/skills/ship-roadmap/references/STOP_CONDITIONS.md +0 -9
  91. package/skills/ship-roadmap/references/TERMINAL_REPORT.md +0 -34
@@ -1,9 +0,0 @@
1
- ### Stop conditions
2
-
3
- | Banner | Fires when |
4
- |---|---|
5
- | `SHIP: COMPLETE` | Every roadmap feature is `done` **and its PR merged** (default mode: the human merged them all; `--fullauto`: merged under the floors) — `done` alone is not enough, since it only means *built + PR open* — **AND the issue sweep ran to completion**: existing issues inventoried/triaged, every fix-now issue shipped or parked, and untracked residue deduplicated as report proposals without creating backlog. Features merged but sweep pending → the run is NOT complete. Report written, report PR open. |
6
- | `SHIP: BLOCKED` | Everything remaining is `done`-but-pr-open awaiting human merges, or planned with unmerged deps (default mode); or a parked feature transitively blocks the rest. Always includes the unblock map. |
7
- | `SHIP: STOPPED` | Budget/iteration cap; a Round-5 milestone stop line; substrate invariant broken (gate unrunnable, roadmap unparseable, unexplained dirty default branch, decision record missing); forge unavailable (no stage that depends on PR state may proceed on guesses). |
8
- | (feature parked, run continues) | Repeated red gate (retry cap), review ping-pong (2 cycles), audit ping-pong (2 cycles), capacity guard (3 partials), planning contradiction, **undesignable-from-record** (DESIGN stage `NEEDS_INPUT` — the recorded gap is a human-only unpark, never a mid-run re-ask). |
9
- | **Systemic drift stop** | `review-change` flags SPEC drift on **two consecutive features** → the locked founding assumptions are probably stale; the whole run stops rather than auto-merging a compounding error. |
@@ -1,34 +0,0 @@
1
- ### Final report
2
-
3
- Written by the terminal iteration to `docs/features/SHIP_REPORT_<date>.md` on a
4
- `docs/ship-report` branch as a docs-only PR (default: human merges; `--fullauto`:
5
- audit-gated like any PR), and printed in full under the banner:
6
-
7
- 1. **Run summary** — mode, iterations used vs cap, stop reason, feature counts
8
- (merged / `done`-awaiting-merge / parked / not started).
9
- 2. **Per-feature outcomes** — size planned vs final, phases, gate history,
10
- review findings folded vs postponed, audit verdict + SHA, PR + final state,
11
- merged by human or autopilot.
12
- 3. **Issues** — the sweep's existing-issue inventory and outcomes: fix-now issues
13
- shipped (PR links), postponed/wontfix verdicts with the trigger that
14
- should reopen each (feeds `triage-issue`'s verification model), and
15
- anything the sweep could not finish (budget/parked) as the explicit
16
- remaining triage batch. Untracked residue is listed separately as proposals;
17
- the run created no backlog for it.
18
- 4. **New feature proposals** — capabilities discovered during the build that
19
- serve the product goal (Round 1 quoted as the yardstick), each sized with a
20
- suggested roadmap slot. Recommend-only.
21
- 5. **Residual risks** — weak test areas, `--fullauto` merges deserving a second
22
- look, parked features and why, silent decisions with outsized consequences.
23
- 6. **Manual-verification checklist** — the deduplicated union of every review
24
- checkpoint's manual checks plus audit notes: what no gate proved.
25
- 7. **Going forward** — concrete `product-audit` cadence for this project
26
- (first one now if ≥2–3 features merged; then ~every 5 or pre-release), and
27
- the suggested command sequence to continue, closed with the canonical block:
28
-
29
- ```
30
- → Next: <merge the open PRs | /triage-issue <batch> | /plan-feature --next>
31
- · accepted proposals → /plan-feature · product-audit due → /product-audit
32
- ```
33
-
34
- Closing line, verbatim policy: **this report recommends; the human decides.**