create-issflow 1.0.3 → 1.2.0

package/template/.claude/skills/ux-design/SKILL.md

@@ -1,99 +1,117 @@
----
-name: ux-design
-description: >
-  The iStartSoft UX cookbook + wireframe baseline. A checklist an agent uses to
-  VALIDATE generated UI so it does not drift outside the design frame. Use on
-  every UI-facing task: building a screen/component, reviewing a UI diff, or
-  before a frontend phase closes. Triggers: "ui", "screen", "component",
-  "layout", "design", "ux", "wireframe", "responsive", "accessib", "a11y",
-  "ตรวจดีไซน์", "หน้าจอ".
----
-
-# ux-design — cookbook + wireframe frame
-
-Caveman ULTRA mode. UI conforms to the FRAME. Build or change UI -> run this
-cookbook before you call it done. Drift outside the wireframe = defect, not
-creative liberty (METHODOLOGY hard rule 9).
-
-Read `wireframe-template.md` (same dir) when starting a new screen — it is the
-canonical low-fidelity baseline every screen must map to. Read it on demand only.
-
------
-
-## When to apply
-
-- Building a screen / page / component.
-- Reviewing a UI diff (the "ตรวจ" pass).
-- CLOSE gate of any frontend phase — the cookbook check MUST pass.
-
-Order: **wireframe first** (does the layout match the baseline frame?) ->
-**cookbook** (do the details obey the system?). Never invent layout the
-wireframe does not have. If the design truly needs a frame the wireframe lacks,
-STOP and update the wireframe baseline first (a design decision -> `log-decision`).
-
------
-
-## The cookbook (check every item)
-
-### 1. Design tokens — no raw values
-- Color / spacing / radius / type / shadow come from named tokens, never
-  hard-coded hex / px literals scattered in components.
-- One source of truth (CSS vars / theme file). New token? add it to the source,
-  don't inline it.
-
-### 2. Spacing scale — 8pt grid
-- All spacing is a multiple of 4px, prefer 8 (4 · 8 · 12 · 16 · 24 · 32 · 48 · 64).
-- No magic margins (`margin: 7px`). Off-grid spacing is a defect.
-
-### 3. Type scale
-- A fixed, named ramp (e.g. xs/sm/base/lg/xl/2xl). No arbitrary font-sizes.
-- Line-height ≥ 1.4 for body. One primary font family + a fallback stack.
-
-### 4. Accessibility — WCAG 2.1 AA (non-negotiable)
-- Text contrast ≥ **4.5:1** (≥ 3:1 for large text ≥ 24px / 19px-bold + UI/icon).
-- Every interactive element: keyboard-reachable, visible focus ring, ≥ 44×44px hit area.
-- Semantic HTML (`button`/`nav`/`main`/`label`), not `div` soup. Inputs have labels.
-- Images have `alt`; icon-only buttons have `aria-label`.
-- Color is never the ONLY signal (add text/icon for state).
-
-### 5. Component inventory — reuse, don't reinvent
-- Use an existing component before creating one. New component? it earns a place
-  in the inventory + the wireframe legend.
-- One component = one responsibility.
-
-### 6. State matrix — every interactive element covers all states
-- `default · hover · focus · active · disabled · loading · error · empty`.
-- Lists/data views handle: **empty**, **loading (skeleton)**, **error**, **partial**.
-- No dead-end empty states (always an action or explanation).
-
-### 7. Responsive breakpoints
-- Mobile-first. Honor the project breakpoints (XS < 640 · SM 640 · MD 768 ·
-  LG 1024 · XL 1280). Layout must not break or overflow between them.
-- No fixed widths that overflow small screens. Touch targets hold on mobile.
-
-### 8. Content & i18n
-- No hard-coded user-facing strings — go through the i18n layer.
-- Text can grow ~30% (translation) without breaking layout. Numbers/dates/currency
-  are locale-formatted.
-
-### 9. Feedback & motion
-- Every async action has visible feedback (spinner/skeleton/toast) within ~100ms.
-- Destructive actions confirm. Motion is subtle, respects `prefers-reduced-motion`.
-
------
-
-## RETURN FORMAT (the "ตรวจ" verdict)
-
-```
-UX CHECK: <screen/component>
-- wireframe match: PASS | DRIFT (<what left the frame>)
-- tokens/spacing/type: PASS | FAIL (<which raw values>)
-- a11y (WCAG AA): PASS | FAIL (<contrast/keyboard/semantic gap>)
-- states covered: <list missing, or "all">
-- responsive: PASS | FAIL (<breakpoint that breaks>)
-- i18n: PASS | FAIL
-- VERDICT: PASS | BLOCK (frontend phase cannot close)
-```
-
-Sources behind these defaults: WCAG 2.1 AA, Material Design 3 (semantic tokens),
-Apple HIG, Shopify Polaris. See `docs/research/design-ux-cookbook-wireframe-pattern.md`.
+---
+name: ux-design
+description: >
+  The iStartSoft UX cookbook + wireframe baseline. A checklist an agent uses to
+  VALIDATE generated UI so it does not drift outside the design frame. Use on
+  every UI-facing task: building a screen/component, reviewing a UI diff, or
+  before a frontend phase closes. Triggers: "ui", "screen", "component",
+  "layout", "design", "ux", "wireframe", "responsive", "accessib", "a11y",
+  "ตรวจดีไซน์", "หน้าจอ".
+---
+
+# ux-design — cookbook + wireframe frame
+
+Caveman ULTRA mode. UI conforms to the FRAME. Build or change UI -> run this
+cookbook before you call it done. Drift outside the wireframe = defect, not
+creative liberty (METHODOLOGY hard rule 9).
+
+Read `references/wireframe-template.md` when starting a new screen — it is the
+canonical low-fidelity baseline every screen must map to. Read it on demand only.
+
+-----
+
+## When to apply
+
+ALL web / UI work runs this — no exception. Every screen or component is verified
+against the cookbook + wireframe and produces a UX CHECK verdict; nothing UI ships
+without it. New visual direction (a layout or look the wireframe doesn't cover) is
+confirmed with the user before building — design is where human taste matters.
+
+- Building a screen / page / component.
+- Reviewing a UI diff (the "ตรวจ" pass).
+- CLOSE gate of any frontend phase — the cookbook check MUST pass.
+
+This skill is the STANDARD + the inline GATE (one screen, at phase close). For a
+WHOLE-PRODUCT sweep against this same cookbook — periodic or before a release — run
+`/ui-audit` (same rubric, broader scope, a scored report).
+
+Order: **wireframe first** (does the layout match the baseline frame?) ->
+**cookbook** (do the details obey the system?). Never invent layout the
+wireframe does not have. If the design truly needs a frame the wireframe lacks,
+STOP and update the wireframe baseline first (a design decision -> `log-decision`).
+
+-----
+
+## The cookbook (check every item)
+
+### 1. Design tokens — no raw values
+- Color / spacing / radius / type / shadow come from named tokens, never
+  hard-coded hex / px literals scattered in components.
+- One source of truth (CSS vars / theme file). New token? add it to the source,
+  don't inline it.
+
+### 2. Spacing scale — 8pt grid
+- All spacing is a multiple of 4px, prefer 8 (4 · 8 · 12 · 16 · 24 · 32 · 48 · 64).
+- No magic margins (`margin: 7px`). Off-grid spacing is a defect.
+
+### 3. Type scale
+- A fixed, named ramp (e.g. xs/sm/base/lg/xl/2xl). No arbitrary font-sizes.
+- Line-height ≥ 1.4 for body. One primary font family + a fallback stack.
+
+### 4. Accessibility — WCAG 2.1 AA (non-negotiable)
+- Text contrast ≥ **4.5:1** (≥ 3:1 for large text ≥ 24px / 19px-bold + UI/icon).
+- Every interactive element: keyboard-reachable, visible focus ring, ≥ 44×44px hit area.
+- Semantic HTML (`button`/`nav`/`main`/`label`), not `div` soup. Inputs have labels.
+- Images have `alt`; icon-only buttons have `aria-label`.
+- Color is never the ONLY signal (add text/icon for state).
+
+### 5. Iconography — real icons, never emoji
+- Use ONE real icon set (SVG, `currentColor`, one consistent grid + stroke width).
+- **NEVER use emoji as UI icons.** They render differently per OS/browser, don't
+  inherit color/size cleanly, aren't reliably accessible, and break visual
+  consistency. Emoji inside user *content* is fine; emoji as interface iconography
+  is a defect — replace with an SVG icon (or a consistent brand accent mark).
+- Icon-only controls get an `aria-label`; purely decorative icons get `aria-hidden`.
+
+### 6. Component inventory — reuse, don't reinvent
+- Use an existing component before creating one. New component? it earns a place
+  in the inventory + the wireframe legend.
+- One component = one responsibility.
+
+### 7. State matrix — every interactive element covers all states
+- `default · hover · focus · active · disabled · loading · error · empty`.
+- Lists/data views handle: **empty**, **loading (skeleton)**, **error**, **partial**.
+- No dead-end empty states (always an action or explanation).
+
+### 8. Responsive breakpoints
+- Mobile-first. Honor the project breakpoints (XS < 640 · SM 640 · MD 768 ·
+  LG 1024 · XL 1280). Layout must not break or overflow between them.
+- No fixed widths that overflow small screens. Touch targets hold on mobile.
+
+### 9. Content & i18n
+- No hard-coded user-facing strings — go through the i18n layer.
+- Text can grow ~30% (translation) without breaking layout. Numbers/dates/currency
+  are locale-formatted.
+
+### 10. Feedback & motion
+- Every async action has visible feedback (spinner/skeleton/toast) within ~100ms.
+- Destructive actions confirm. Motion is subtle, respects `prefers-reduced-motion`.
+
+-----
+
+## RETURN FORMAT (the "ตรวจ" verdict)
+
+```
+UX CHECK: <screen/component>
+- wireframe match: PASS | DRIFT (<what left the frame>)
+- tokens/spacing/type: PASS | FAIL (<which raw values>)
+- icons: PASS | FAIL (emoji used as icons / inconsistent set)
+- a11y (WCAG AA): PASS | FAIL (<contrast/keyboard/semantic gap>)
+- states covered: <list missing, or "all">
+- responsive: PASS | FAIL (<breakpoint that breaks>)
+- i18n: PASS | FAIL
+- VERDICT: PASS | BLOCK (frontend phase cannot close)
+```
+
+Sources behind these defaults: WCAG 2.1 AA, Material Design 3 (semantic tokens),
+Apple HIG, Shopify Polaris. See `docs/research/design-ux-cookbook-wireframe-pattern.md`.

package/template/.claude/skills/ux-design/{wireframe-template.md → references/wireframe-template.md}

@@ -1,95 +1,95 @@
-# Wireframe baseline — canonical prototype frame
-
-The low-fidelity reference every screen maps to BEFORE pixels exist. Copy a block
-per screen, fill the `[...]`. The agent validates generated UI against this frame
-(METHODOLOGY hard rule 9). Anything the screen renders that this frame does not
-describe is **drift** — fix the UI or, if the frame is genuinely missing, update
-this file first (`log-decision`).
-
-Keep it low fidelity on purpose: boxes + intent, not styling. Styling lives in the
-design tokens / cookbook, not here.
-
------
-
-## Global frame (applies to all screens)
-
-```
-+--------------------------------------------------+
-| [top bar: logo · primary nav · account ]         |  <- persistent
-+--------------------------------------------------+
-| [breadcrumb / page title ]                        |
-|                                                   |
-|   [ MAIN CONTENT REGION ]                          |
-|                                                   |
-+--------------------------------------------------+
-| [footer / status ]                                |
-+--------------------------------------------------+
-```
-
-- Breakpoints: nav collapses to a menu below MD (768px). Content single-column
-  below SM (640px).
-- Every screen declares: its route, its primary action, its empty/loading/error
-  rendering.
-
------
-
-## Screen template (copy per screen)
-
-```
-### Screen: [name]
-- Route:            [/path]
-- Goal (one line):  [what the user accomplishes here]
-- Primary action:   [the single most important button/intent]
-- Entry points:     [how the user arrives]
-- Exit / next:      [where they go after the primary action]
-
-Layout (regions, top -> bottom):
-  1. [region]   — [content + which components from the inventory]
-  2. [region]   — [...]
-  3. [region]   — [...]
-
-States:
-  - loading:  [skeleton of which regions]
-  - empty:    [message + the recovery action — never a dead end]
-  - error:    [message + retry]
-  - success:  [confirmation / what changes on screen]
-
-Data in / out:
-  - reads:    [endpoints from docs/ENDPOINTS.md]
-  - writes:   [endpoints]
-
-Responsive notes:
-  - mobile:   [what stacks / hides / becomes a sheet]
-  - desktop:  [what spreads out]
-
-A11y notes:
-  - focus order: [logical tab order]
-  - landmarks:   [main / nav / form labels]
-```
-
------
-
-## Component legend (the inventory the wireframe references)
-
-List every reusable block a screen may place. A screen MAY ONLY use components
-named here; a new one is added here first.
-
-```
-[Button]        — primary | secondary | ghost | destructive
-[Input]         — text | select | date | search   (always labelled)
-[Card]          — header + body + optional actions
-[Table/List]    — has empty + loading + error states baked in
-[Modal/Sheet]   — confirm | form ; sheet on mobile
-[Toast]         — success | error | info  (async feedback)
-[Nav]           — top bar (desktop) -> menu (mobile)
-[...add project components here...]
-```
-
------
-
-## How to use (agent)
-
-1. New screen -> write its block above from the PLAN acceptance spec.
-2. Build the screen to match the block (layout + states + data + a11y).
-3. Run the `ux-design` cookbook check. Verdict BLOCK -> fix before CLOSE.
-4. Frame too small for a real need -> update this file + `log-decision`, then build.
+# Wireframe baseline — canonical prototype frame
+
+The low-fidelity reference every screen maps to BEFORE pixels exist. Copy a block
+per screen, fill the `[...]`. The agent validates generated UI against this frame
+(METHODOLOGY hard rule 9). Anything the screen renders that this frame does not
+describe is **drift** — fix the UI or, if the frame is genuinely missing, update
+this file first (`log-decision`).
+
+Keep it low fidelity on purpose: boxes + intent, not styling. Styling lives in the
+design tokens / cookbook, not here.
+
+-----
+
+## Global frame (applies to all screens)
+
+```
++--------------------------------------------------+
+| [top bar: logo · primary nav · account ]         |  <- persistent
++--------------------------------------------------+
+| [breadcrumb / page title ]                        |
+|                                                   |
+|   [ MAIN CONTENT REGION ]                          |
+|                                                   |
++--------------------------------------------------+
+| [footer / status ]                                |
++--------------------------------------------------+
+```
+
+- Breakpoints: nav collapses to a menu below MD (768px). Content single-column
+  below SM (640px).
+- Every screen declares: its route, its primary action, its empty/loading/error
+  rendering.
+
+-----
+
+## Screen template (copy per screen)
+
+```
+### Screen: [name]
+- Route:            [/path]
+- Goal (one line):  [what the user accomplishes here]
+- Primary action:   [the single most important button/intent]
+- Entry points:     [how the user arrives]
+- Exit / next:      [where they go after the primary action]
+
+Layout (regions, top -> bottom):
+  1. [region]   — [content + which components from the inventory]
+  2. [region]   — [...]
+  3. [region]   — [...]
+
+States:
+  - loading:  [skeleton of which regions]
+  - empty:    [message + the recovery action — never a dead end]
+  - error:    [message + retry]
+  - success:  [confirmation / what changes on screen]
+
+Data in / out:
+  - reads:    [endpoints from docs/ENDPOINTS.md]
+  - writes:   [endpoints]
+
+Responsive notes:
+  - mobile:   [what stacks / hides / becomes a sheet]
+  - desktop:  [what spreads out]
+
+A11y notes:
+  - focus order: [logical tab order]
+  - landmarks:   [main / nav / form labels]
+```
+
+-----
+
+## Component legend (the inventory the wireframe references)
+
+List every reusable block a screen may place. A screen MAY ONLY use components
+named here; a new one is added here first.
+
+```
+[Button]        — primary | secondary | ghost | destructive
+[Input]         — text | select | date | search   (always labelled)
+[Card]          — header + body + optional actions
+[Table/List]    — has empty + loading + error states baked in
+[Modal/Sheet]   — confirm | form ; sheet on mobile
+[Toast]         — success | error | info  (async feedback)
+[Nav]           — top bar (desktop) -> menu (mobile)
+[...add project components here...]
+```
+
+-----
+
+## How to use (agent)
+
+1. New screen -> write its block above from the PLAN acceptance spec.
+2. Build the screen to match the block (layout + states + data + a11y).
+3. Run the `ux-design` cookbook check. Verdict BLOCK -> fix before CLOSE.
+4. Frame too small for a real need -> update this file + `log-decision`, then build.

package/template/.claude/templates/proposal.html

@@ -0,0 +1,126 @@
+<!doctype html>
+<!--
+  Client-facing proposal template (rendered by /propose from docs/PROPOSAL.md).
+  HOW TO USE (agent): copy this file to docs/proposal.html and replace every
+  {{PLACEHOLDER}}. LOCALISE the labels + content to the project's declared
+  language (e.g. natural Thai) — keep technical terms in English where a Thai dev
+  team would. Light + print-friendly on purpose (Ctrl/Cmd-P → "Save as PDF").
+  Repeat the <tr> in the phases table per phase; repeat <li> lists as needed.
+
+  WHITE-LABEL: this template is brand-neutral. Fill {{COMPANY}} / {{LOGO}} with the
+  ISSUING company's brand (whoever is sending the proposal) — NOT the kit's. {{LOGO}}
+  is optional: replace with an <img src="…"> or a text wordmark, or delete it.
+  Icons: none by design (no emoji) — keep it clean and typographic.
+-->
+<html lang="{{LANG}}">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>{{TITLE}} — Proposal {{VERSION}}</title>
+<style>
+  :root{ --ink:#1a2230; --muted:#5b6878; --line:#e3e8f0; --accent:#5b4cf0;
+    --accent2:#0ea5b7; --bg:#fff; --soft:#f6f8fc;
+    --sans:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Noto Sans Thai",system-ui,sans-serif;
+    --mono:ui-monospace,Menlo,Consolas,monospace; }
+  *{box-sizing:border-box}
+  body{margin:0;background:var(--soft);color:var(--ink);font-family:var(--sans);line-height:1.6}
+  .sheet{max-width:880px;margin:24px auto;background:var(--bg);border:1px solid var(--line);
+    border-radius:14px;overflow:hidden}
+  .head{padding:34px 40px;border-bottom:3px solid var(--accent);
+    background:linear-gradient(120deg,#f3f1ff,#eafcff)}
+  .brand-row{display:flex;align-items:center;gap:10px;margin-bottom:14px;font-size:1rem}
+  .brand-row .logo{display:inline-flex;align-items:center}
+  .head .ey{font:600 .72rem/1 var(--mono);letter-spacing:.18em;text-transform:uppercase;color:var(--accent)}
+  .head h1{margin:.3em 0 .1em;font-size:1.9rem;letter-spacing:-.02em}
+  .head .meta{color:var(--muted);font-size:.9rem}
+  main{padding:14px 40px 40px}
+  section{padding:20px 0;border-bottom:1px solid var(--line)}
+  section:last-child{border:none}
+  h2{font-size:1.05rem;margin:0 0 .5em;display:flex;align-items:center;gap:9px}
+  h2::before{content:"";width:10px;height:10px;border-radius:3px;
+    background:linear-gradient(120deg,var(--accent),var(--accent2))}
+  table{width:100%;border-collapse:collapse;font-size:.92rem}
+  th,td{text-align:left;padding:10px 12px;border-bottom:1px solid var(--line)}
+  th{background:var(--soft);font-size:.74rem;text-transform:uppercase;letter-spacing:.04em;color:var(--muted)}
+  td.num,th.num{text-align:right;font-family:var(--mono)}
+  tfoot td{font-weight:700;border-top:2px solid var(--ink);border-bottom:none}
+  ul{margin:.2em 0;padding-left:1.2em} li{margin:.2em 0;color:var(--muted)}
+  .total{font-size:1.5rem;font-weight:800}
+  .total small{font-size:.8rem;color:var(--muted);font-weight:500}
+  .cols{display:flex;gap:32px;flex-wrap:wrap} .cols>div{flex:1;min-width:220px}
+  .sign{display:flex;gap:40px;flex-wrap:wrap;margin-top:10px}
+  .sign div{flex:1;min-width:220px} .line{border-bottom:1px solid var(--ink);height:34px;margin-top:18px}
+  .muted{color:var(--muted)} .pill{display:inline-block;font:600 .7rem/1 var(--mono);
+    padding:3px 8px;border-radius:6px;background:var(--soft);border:1px solid var(--line);color:var(--muted)}
+  footer{padding:18px 40px;color:var(--muted);font-size:.8rem;background:var(--soft)}
+  @media print{ body{background:#fff} .sheet{margin:0;border:none;border-radius:0;max-width:none}
+    .head{background:#fff} section{break-inside:avoid} }
+</style>
+</head>
+<body>
+<div class="sheet">
+  <div class="head">
+    <div class="brand-row"><span class="logo">{{LOGO}}</span><strong>{{COMPANY}}</strong></div>
+    <div class="ey">Proposal · {{VERSION}}</div>
+    <h1>{{TITLE}}</h1>
+    <div class="meta">{{L_PREPARED_FOR}} {{CLIENT}} · {{DATE}} · <span class="pill">{{STATUS}}</span></div>
+  </div>
+  <main>
+    <section>
+      <h2>{{L_OVERVIEW}}</h2>
+      <p class="muted">{{SUMMARY}}</p>
+    </section>
+
+    <section>
+      <h2>{{L_SCOPE}}</h2>
+      <div class="cols">
+        <div><strong>{{L_IN_SCOPE}}</strong><ul>{{SCOPE_IN_ITEMS}}</ul></div>
+        <div><strong>{{L_OUT_SCOPE}}</strong><ul>{{SCOPE_OUT_ITEMS}}</ul></div>
+      </div>
+    </section>
+
+    <section>
+      <h2>{{L_PHASES}}</h2>
+      <table>
+        <thead><tr>
+          <th>{{L_PHASE}}</th><th>{{L_COMPLEXITY}}</th>
+          <th class="num">{{L_EFFORT}}</th><th class="num">{{L_COST}}</th>
+        </tr></thead>
+        <tbody>
+          {{PHASE_ROWS}}
+          <!-- e.g. <tr><td>1. Auth</td><td>M</td><td class="num">2–3d</td><td class="num">฿16,000–24,000</td></tr> -->
+        </tbody>
+        <tfoot><tr><td colspan="2">{{L_TOTAL}}</td><td class="num">{{TOTAL_EFFORT}}</td><td class="num">{{TOTAL_COST}}</td></tr></tfoot>
+      </table>
+      <p class="total" style="margin-top:14px">{{TOTAL_COST}} <small>{{CONTINGENCY_NOTE}}</small></p>
+    </section>
+
+    <section>
+      <h2>{{L_TIMELINE}}</h2>
+      <p class="muted">{{TIMELINE}}</p>
+    </section>
+
+    <section>
+      <div class="cols">
+        <div><h2>{{L_ASSUMPTIONS}}</h2><ul>{{ASSUMPTION_ITEMS}}</ul></div>
+        <div><h2>{{L_EXCLUSIONS}}</h2><ul>{{EXCLUSION_ITEMS}}</ul></div>
+      </div>
+    </section>
+
+    <section>
+      <h2>{{L_PAYMENT}}</h2>
+      <ul>{{PAYMENT_ITEMS}}</ul>
+    </section>
+
+    <section>
+      <h2>{{L_SIGNOFF}}</h2>
+      <div class="sign">
+        <div><div class="line"></div><div class="muted">{{L_CLIENT_SIGN}}</div></div>
+        <div><div class="line"></div><div class="muted">{{L_DATE}}</div></div>
+      </div>
+    </section>
+  </main>
+  <footer>{{FOOTER}}</footer>
+</div>
+</body>
+</html>

package/template/.claude/hooks/pre-compact.sh

@@ -1,25 +0,0 @@
-#!/usr/bin/env bash
-# PreCompact hook. Fires before auto/manual /compact.
-set -euo pipefail
-cd "${CLAUDE_PROJECT_DIR:-.}"
-
-mkdir -p docs/.snapshots
-STAMP=$(date +%Y%m%d-%H%M%S)
-SNAP="docs/.snapshots/precompact-${STAMP}.md"
-
-{
-  echo "# Pre-compact snapshot ${STAMP}"
-  echo
-  echo "## Git"
-  git status --short 2>/dev/null || true
-  git diff --stat 2>/dev/null || true
-  echo
-  echo "## STATE.md at compact time"
-  [ -f docs/STATE.md ] && cat docs/STATE.md || echo "(no STATE.md)"
-} > "$SNAP"
-
-ls -1t docs/.snapshots/precompact-*.md 2>/dev/null | tail -n +6 | xargs -r rm -f
-
-echo "Context was compacted. Recovery snapshot saved at ${SNAP}."
-echo "STATE.md and ISSUES.md were re-injected by the SessionStart hook - trust those."
-exit 0