refactor(pi): generate modular session instructions (#25)

2026-08-24 01:36:08 +02:00
parent 4a654de84a
commit eccf6212f1
15 changed files with 606 additions and 0 deletions
@@ -0,0 +1,13 @@
+3. **Memory promotion closes the session.** Call `reviewer_memory_promote` with ONLY
+   the session id: the gate computes the candidates itself (`tht memory promote
+   --preview` — the 3 reusable types, already excluding promoted/declined ones) and
+   shows the reviewer a pre-selected checklist. Selected → saved to the vectordb +
+   `memory_promoted`; deselected → `memory_promotion_declined` (never re-proposed).
+   After recording the promotion (even with zero candidates) the gate advances F8 and
+   finalizes the session itself — do NOT present a `reviewer_confirm kind:"phase"`
+   afterwards: there is nothing left to approve. When the gate answers "sessione
+   finalizzata", give the reviewer the final summary and end the turn.
+4. If the gate reports an error instead (e.g. the datamart decision is missing),
+   fix the prerequisite and call `reviewer_memory_promote` again. Only if the gate
+   says the session is still open, close with `reviewer_confirm kind:"phase"` as a
+   fallback — it auto-finalizes after advancing the last phase too.