repositories / pi-ext

pi-ext

bugabingas pi extensions

owned by bugabinga

docs(leaks): plan integration and CI phase

c6054a3ae508d14263d620e3fe4e67a0698c1ea1

Oliver Jan Krylow <oliver@bugabinga.net> ·

unsigned

Browse filesCompare with HEAD

Changed files (1)

docs/super/plans/2026-07-17-leaks-detector-reliability-phase-3-integration-ci.md

Added
new file mode 100644
1 +# Leaks Reliability Phase 3 Integration And CI Plan
3 +**Goal:** Prove durable redaction and strict hydration through real Pi execution, gate the repository against regressions, and ship the behavior as a CI-enforced release.
5 +**Architecture:** Keep production changes small. Exercise the installed Pi agent loop with scripted provider responses and actual tool implementations. Add a tracked-source negative corpus and exact positive fixture assertions. Expand lifecycle properties around branch projections and failure commands. Put the bounded dedicated fuzz task in the release gate.
7 +## Task 1: Real agent-loop hydration
9 +- Run scripted model responses through the actual agent loop into built-in and custom tools.
10 +- Assert actual tool implementation inputs receive original bytes, not placeholders.
11 +- Cover context plus provider double processing, unknown placeholders, and incomplete traversal.
13 +## Task 2: Restart and branch lifecycle integration
15 +- Recreate extension instances against persisted session branches.
16 +- Cover resume, clear, tree navigation, copied fork branches, sibling exclusion, corruption, unsupported versions, and detector changes.
17 +- Assert diagnostics and active-generation mapping counts exactly.
19 +## Task 3: Repository negative corpus
21 +- Scan tracked production source, excluding explicit detector fixtures and tests.
22 +- Fail on every unexpected span with only masked path, detector label, line, and length metadata.
23 +- Keep intentional positives in explicit fixtures rather than allowlists.
25 +## Task 4: Exact positive corpus and adversarial properties
27 +- Replace aggregate demo thresholds with exact family, label, value-span, and outside-byte assertions.
28 +- Expand model properties with branch, corruption, version, collision, cap, append failure, and unknown-tool commands.
29 +- Verify `FC_TEST`, `FC_SEED`, and `FC_PATH` replay and the hard timeout exit code.
31 +## Task 5: CI and documentation
33 +- Add `mise run fuzz` to `mise run ci` while keeping it outside `mise run test`.
34 +- Update README, changelog, and spec for precision-first parsing, encrypted session mappings, strict tool blocking, diagnostics, and replay commands.
35 +- Run `mise run fmt`, `mise run lint`, `mise run check`, `mise run test`, `mise run fuzz`, and `mise run ci`.
36 +- Request final code review and produce an execution review.