@groeponline/pi-wishcraft 1.1.0 → 1.2.0

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 ## [Unreleased]
 
+## [1.2.0] - 2026-08-24
+
+### Changed
+- Deck polish: structural display names (Lanternwake, Hexforge, …), injectable gallery tick, route-specific footers, and Signal three-lane copy. Clock frames stay ASCII-safe. Flat `/wishcraft settings` reloads Signal through `reloadPowerlineFromSettings`.
+
+### Added
+- Wishcraft Deck (`alt+p` / `/wishcraft`) is the operator overlay: eleven routes, `g`-prefix jumps, and a live session snapshot. `/wishcraft settings` (or `config`) opens the flat settings list.
+- `/signal` is the primary status command (`/powerline` remains an alias). No-args still toggles. `/signal menu` opens Navigate / Configure / Status.
+- Ten structural appearance bases (`lanternwake`…`crucible`) apply live Signal colors via `powerline.appearance.base`. Deck Appearance + Enter writes the base. `/signal hexforge` syncs appearance when the layout name is structural.
+- Motion Gallery and Composer on the Deck Motion route. Catalog is 50+ definitions. Enter assigns a motion to a semantic event (`powerline.appearance.motion`).
+- Skill Workbench, idea list, and guardrail rules render inside the Deck Craft routes.
+- First-class motion levels (`full|reduced|functional|off`) via `powerline.motionLevel`, `NO_COLOR`, and screen-reader / reduced-motion host flags.
+
 ## [1.1.0] - 2026-08-23
 
 ### Security

package/README.md

@@ -39,8 +39,8 @@ Then restart pi or `/reload`. Pi host packages are declared as `peerDependencies
 
 | Surface | What it does |
 | --- | --- |
-| Status bar | Git, TPS (1s window over a 5s ring), context, cost, ports, queue. Default placement is the editor top border; `/powerline placement below` moves it. |
-| `alt+p` | Three overlays: Navigate, Configure, Status. In Navigate, `→` / `tab` opens per-segment detail (ports, git, cost, context). `alt+i` is the ports list. |
+| Signal | Motion-aware three-lane operator status: model/Git, live activity/tool state, and context/queue. Default placement is the editor top border; `/signal placement below` moves it. |
+| `alt+p` | Wishcraft Deck: session, Signal, skills, ideas, guardrails, appearance. `g` + jump. `/wishcraft settings` is the flat list. `/signal menu` is Navigate / Configure / Status. |
 | `# <idea>` | File-backed inbox. Does not send the prompt. `/ideas` reviews status, tags, and skill insert. `/ideas next` feeds the oldest active idea into the session. |
 | `alt+s` | Stash the draft, ask something else, get it back when the run finishes. |
 | `/skills` | Overlay search on name, description, and path. Enter inserts. `/skills doctor` is the health table. `/skills new` writes a SKILL.md from a template. |
@@ -53,11 +53,11 @@ Pi owns the footer chrome, feed scrolling, and input. Wishcraft supplies widgets
 
 ## Daily commands
 
-Activates on load. `/powerline` toggles it. `/powerline <preset>` switches look. Tab completes presets and `placement above|below|toggle`.
+Activates on load. `/signal` toggles it. `/signal <preset>` switches the information layout. `/signal menu` opens Navigate / Configure / Status. `/wishcraft` opens the Deck. Tab completes presets and `placement above|below|toggle`. `/powerline` remains a compatibility alias.
 
 ```text
-/powerline doctor     settings, queue, git, bash, fonts
-/powerline export     current preset + layout as JSON
+/signal doctor        settings, queue, git, bash, fonts
+/signal export        current preset + layout as JSON
 /tps                  live in/out overlay (same ring as the segment)
 /tps 40               override POWERLINE_TPS
 /usage                session / today / week from ~/.pi/agent/wishcraft-usage.json
@@ -66,7 +66,8 @@ Activates on load. `/powerline` toggles it. `/powerline <preset>` switches look.
 /skills doctor        health table (broken frontmatter, dupes, unused, budget)
 /skills new [name]    write a SKILL.md from a template
 /ideas                idea review overlay (status, tags, skill insert)
-/wishcraft            settings TUI
+/wishcraft            Deck overlay (operator surface)
+/wishcraft settings   flat settings TUI
 /open-ports           listening sockets
 /cd <path>            continue this conversation in another directory
 /bash-mode            sticky shell  (also ctrl+shift+b)
@@ -99,7 +100,8 @@ Keybinds (`powerlineShortcuts`, applied after `/reload`; `null` disables):
   "powerline": {
     "preset": "chef",
     "placement": "above",
-    "welcome": true
+    "welcome": true,
+    "appearance": { "base": "lanternwake" }
   }
 }
 ```
@@ -221,6 +223,13 @@ Declarative deny/inject rules in the **global** agent settings file. No shell co
 - The legacy `@groeponline/pi-powerline-footer` package is deprecated on npm in favor of `@groeponline/pi-wishcraft`; the GitHub fork relationship is retained for upstream history and attribution.
 - Tags are not rewritten. 0.19.x through current stay on the timeline.
 
+## vNext Direction
+
+Wishcraft is evolving into Pi's animated operator layer — intent, skills, ideas, guardrails, and session state made visible and controllable without turning Pi into an IDE.
+
+- **[vNext Stacked PR Release Plan](docs/design/vnext-release-plan.md)**: Specifications for PR0 through PR8.
+- **[Design Corpus](docs/index.md#design-system--vnext-specifications)**: Deck, Signal, Motion Gallery, tokens, and the 10 structural presets. `npm run preview` renders the Deck frames.
+
 ## Docs
 
 - [Commands](docs/commands.md)

package/ROADMAP.md

@@ -97,6 +97,29 @@ Niet de fork. Niet de SaaS-agent.
   preset-editor, idee-review, stabiele ChefGroep-statuskeys,
   documentatie die waar is. Done = README dekt alles wat we shipten,
   geen kapotte footer-belofte.
+- **vNext — "Operator Layer"** (in uitvoering). Stacked PRs PR0–PR8:
+  Deck control surface (`ctx.ui.custom`), animated Signal powerline,
+  zero-overhead Motion Engine (0 FPS idle), 10 signature structural presets,
+  semantische tokens, en first-class accessibility (`NO_COLOR`, reduced motion).
+  Zie [docs/design/vnext-release-plan.md](docs/design/vnext-release-plan.md).
+  - PR0 design corpus — geland (`docs/design/`).
+  - PR1 motion engine — geland (`src/motion/`): één scheduler op de bestaande
+    coalescing timer, semantische events, 6 channels, 0 FPS zonder consumers.
+  - PR2 semantic tokens — geland (`src/config/tokens.ts`): `PresetDef.tokens`
+    is optioneel en `DEFAULT_TOKENS` reproduceert `getDefaultColors()`.
+  - PR3 structural presets — geland (`src/config/structural-presets.ts`,
+    `src/config/appearance.ts`): 10 signature presets, mixable layers, Nerd/ASCII
+    glyph fallbacks; legacy layout presets ongewijzigd.
+  - PR4 animated Signal — geland (`src/signal/`): drie lanes, lifecycle-driven
+    motion op één gedeelde scheduler, `/signal` primair en 0 FPS in rust.
+  - PR5 Deck — geland (`src/extension/ui/deck/`): unified overlay via
+    `ctx.ui.custom`, Alt+P en `/wishcraft`, elf routes, jump/search navigatie.
+  - PR6 Appearance / Gallery — geland: Deck Motion gallery + composer,
+    50+ catalog defs, Enter assigns `powerline.appearance.motion`.
+  - PR7 accessibility — geland: `src/theme/detect.ts`,
+    `src/motion/accessibility.ts`, `powerline.motionLevel`.
+  - PR8 Craft + docs — geland: Deck Skill Workbench, idea/guardrail panes,
+    `skills/wishcraft-tui/references/*`, project subagents.
 
 ## Top-15 track: remaining maturity gaps
 
@@ -136,227 +159,37 @@ P1 — differentiation and quality:
    useful features. *Fix: sensible defaults + first-run setup overlay.*
 3. **Perf budget / low-power mode.** Status renders every ~33ms; heavy
    segments (bash-history, git) can hit the hot path. *Fix: configurable
-   refresh + lite mode.*
+   refresh + lite mode / repeating scheduler with 0 FPS idle. Scheduler landed
+   in PR1 (`src/motion/scheduler.ts`); the segment hot path is still open.*
 4. **Accessibility (no-color / reduced-motion).** Truecolor + animations
    (vibes, rainbow think) break on terminals without truecolor. *Fix:
-   `NO_COLOR`/8-color + reduced-motion respect.*
+   `NO_COLOR`/8-color + reduced-motion respect (PR7).*
 
 P2 — full product, post-1.0:
-5. **Preset editor in-menu** — custom JSON-only today.
+5. **Preset editor in-menu** — custom JSON-only today (addressed in PR3 & PR6).
 6. **Skill install from repo/npm** — discovery + doctor exist; install and
-   curate missing.
+   curate missing (addressed in PR8).
 7. **Host-status integration** — `ctx.ui.setStatus` beside the footer so
    status also shows in host UI (`skills.count` is a start; full coverage
    remains).
 
-Linear tickets for open gaps are still to be filed (not invented in this
-ROADMAP).
-
----
-
-## 0.19.0 — Correctheid
-
-Eén campagne, drie stacked PRs. Volgorde vast. Elke PR: `npm run
-typecheck && npm test && npx madge --circular src index.ts bash-mode
-queue` groen vóór review. Overlay-submenus (CHE-42) zitten in 0.20.
-
-### PR A — runtime-bugs — ✅ geland in `feat/wishcraft-0.19` (samen met skills v2, hooks, lantern-welcome, `/wishcraft` config-TUI; supersedeert #10)
-
-Alle zes punten uit het oorspronkelijke plan zitten in de ene 0.19-branch:
-debris weg, filter werkend (v2: substring i.p.v. prefix), cache-invalide op
-`session_start` + TTL, woordgrens op inline-triggers, unclosed-fence EOF,
-bash-session tempdir + sentinel-colon, `permissions: contents: read`.
-`npm pack --dry-run` bevat geen debris (113 files, geen `ook.md`/`test.md`).
-
-### PR B — config-afmakers — ✅ geland in `feat/wishcraft-0.19` / #12
-
-Bestanden: `src/config/`, `src/segments/`, `src/extension/ui/`.
-
-1. `segmentLabels` toepassen in `renderSegment` voor **alle** segments
-   (nu alleen tps/open_ports/subagents).
-2. `segmentOptions.<seg>.template` wint van label
-   (`"{value} tok/s"`).
-3. `segmentOptions.tps.windowMs` (default 1000), `.mode`
-   (`both | out | in | total`), `.hideIdle` (default true).
-4. Visibility-toggle in het `alt+p`-menu schrijft live
-   `powerline.disabledSegments`.
-
-Done: unit tests op label/template/windowMs-resolutie; handmatige
-check: label op `git` + `cost` zichtbaar, TPS hidden bij 0 wanneer
-`hideIdle`.
-
-### PR C — release 0.19.0
-
-1. Merge naar `main` triggert `release.yml`: `node scripts/release.mjs auto --push`.
-   Commits sinds `v0.18.0` bevatten `feat:` → **0.19.0**. Handmatig blijft
-   `npm run release minor` + tag-push mogelijk.
-2. Tag-job publiceert met org-secret `NPM_TOKEN` (geen repo-override).
-3. Verify: tag op origin, publish-job groen, `npm view @groeponline/pi-wishcraft version` = 0.19.0.
-   Catalogus (hard): `npm run verify:package` groen in de release-job;
-   `npm view @groeponline/pi-wishcraft keywords` bevat `pi-package`,
-   `pi-extension`, `wishcraft`; `pi.image` is de banner-URL.
-   Daarna:
-   - https://pi.dev/packages/@groeponline/pi-wishcraft toont 0.19.0
-   - https://pi.dev/packages?name=wishcraft toont de card
-   - https://pi.dev/packages?name=groeponline toont wishcraft naast
-     fff en orchestrator
-   Detailpagina bestaat al voor 0.18.0; de zoekindex niet. Nieuwe
-   publish + discovery-keywords is de refresh. Catalogus-lag tot
-   een paar uur is oké; ontbreken na 24u = 0.19.1 met dezelfde
-   metadata, geen stille "later wel".
-4. README: skills-sectie zegt dat filter werkt; geen `ook`/`test`
-   debris. ROADMAP sync (deze file).
-5. `npm deprecate @groeponline/pi-powerline-footer` blijft een
-   scope-owner actie buiten deze PR (`deprecate-old-name.yml`,
-   workflow_dispatch). Blokkeert 0.19 niet.
-
-Hygiëne die al klaar is en niet opnieuw gepland wordt:
-
-- Fork-tags weg (51 upstream-tags, 2026-08-18). Eigen reeks vanaf
-  `v0.10.0`.
-- `banner.png` blijft (README). `wishcraft-concept.png` gaat weg in
-  PR A of een docs-PR, niet in de balk-runtime.
-- CHANGELOG inkorten (GRO-1060) doen we **niet** in 0.19. Erfgoed
-  is history, geen cruft.
-- Versie blijft 0.19, geen reset naar 1.0.0.
-
-GRO-1061 (runner-queue) is ops, geen product-slice.
-
 ---
 
-## 0.20.0 — Harness
-
-Vier stacked PRs. 0.20.0 (#19) en 0.21.0 (#13) staan op npm. CHE-42
-Configure-overlay, doctor/export, queue-archive en `docs/` zijn geland.
-GRO-1414 sluit README-hooks, rest-repairs, `/tps`+`/usage`, substring-filter.
-
-Overlay-chrome kit, één keer, daarna hergebruiken: box + ronde hoeken,
-accent-kop, dim metadata, rechts uitgelijnde counts, `→` detail /
-`←` terug / `esc` weg, consistente footer-hints. Eerste consument =
-skills v2; tweede = `/usage`; derde = queue/idea. Pure render-
-functies, geen `ctx.ui`-mock.
-
-### PR E — hooks — ✅ geland in `feat/wishcraft-0.19`; README-voorbeelden in GRO-1414
-
-Settings: `wishcraft.hooks` met events
-`preToolUse | postToolUse | sessionStart | turnEnd`. Per hook
-`matcher` (toolName-regex) en `command` (JSON stdin/stdout, timeout
-30s, max 600s). PreToolUse: `allow | deny` + reason die het model
-ziet. Exit 2 = deny, stderr-eerste-regel = reason. PostToolUse /
-SessionStart: `additionalContext`. Kill-switch
-`wishcraft.hooksEnabled: false`. PreToolUse sequentieel (eerste deny
-stopt); PostToolUse/turnEnd parallel.
-
-Done: `parseHookOutput` unit-testen. README met drie werkende
-voorbeelden: bash-guard (`rm -rf /` blokkeren), write-audit
-(append-only log), SessionStart git-status injectie.
-
-### PR F — tool-input repairs — ✅ schema-loze subset in 0.19; rest (JSON-array, `{}`, bare-wrap, path aliases) in GRO-1414. Core tools blijven met rust.
-
-`tool_call`-handler repareert bekende malformaties vóór executie
-(mutable input). Volgorde vast: json-parse vóór bare-wrap.
-
-1. `null` voor optioneel weglaten.
-2. JSON-string-array → array.
-3. `{}`-placeholder → array.
-4. bare-string → array-wrap.
-5. markdown-auto-link pads (`[x.md](http://x.md)` → `x.md`).
-6. pad-alias `filePath` / `absolutePath` / `target_file` → `path`.
-
-Repair-teller per `(tool, repair)` als extension status.
-`wishcraft.repairsEnabled` default true. Scope: custom tools +
-extensie-tools. Pi core-tools laten we met rust — core valideert
-zijn eigen schema's.
-
-Done: pure `repairToolInput(tool, input)` + table-driven tests voor
-de zes gevallen + de parse-vóór-wrap invariant.
-
-### PR G — overlay-submenus (CHE-42) — ✅ #19 + expansion (#13 reopen)
-
-The `alt+p` menu gets stacked `SelectList` overlays (arrows +
-descriptions) instead of flat `ctx.ui.select`. Maximum three top-level
-entries. #19 lands the top-level tree (Navigate / Configure /
-Status). Configure now uses `showSelectOverlay` (CHE-42 remainder). CHE-40
-is Done (#18). CHE-41 is Done: `→` in Navigate, snapshot on open, no second `alt+i` path.
-
-### PR H — skills manager v2 UI + token-overlays
-
-Replaces `skill-manager.ts` (242 lines). The data layer builds on Pi
-core `loadSkills` / `loadSkillsFromDir` / `Skill` /
-`SkillFrontmatter` (publicly exported in
-`@earendil-works/pi-coding-agent`).
-
-UI, non-negotiable:
-
-- Working search: substring on name + description + path,
-  case-insensitive; `ctrl+u` clears; empty match = row
-  `no skills for '<q>'`.
-- Categories with headings (bundled / global / project / prompts);
-  `tab` switches the filter; `s` sorts name ↔ usage.
-- `→` detail (frontmatter table, usage, path, body + scroll);
-  `enter` inserts; `e` opens `$EDITOR` (default nvim) via external
-  spawn like pi's `!`; `n` creates a new skill in
-  `~/.pi/agent/skills/<name>/SKILL.md`; `d` delete + confirm.
-- Usage-ledger `~/.pi/agent/skill-usage.json` (name, timestamp,
-  trigger type). Best-effort, never blocking on the input hot path.
-- Skill health: core-diagnostics as a warning icon; `?` explains it.
-
-Same chrome as the segment navigator. English, direct.
-
-At the same time, small additions:
-
-- `/tps` overlay: in/out, peak + average over the existing ring.
-  No new sampler.
-- `/usage` overlay: today / this week / this session; per model;
-  cache-hit %; ASCII sparkline. File
-  `~/.pi/agent/wishcraft-usage.json` (append-only, compaction at
-  threshold).
-- `wishcraft.tokenBudget.daily` colors the segment red and warns
-  in the welcome at 80% / 100%. Never blocking.
-
-Done: substring filter tests; usage-ledger tests; `/tps` reads
-the same ring as the segment (no second source of truth).
-
----
+## vNext Milestone: The Stacked PR Plan
 
-## 1.0 — Cockpit
-
-Shipped. The 0.x train ends at this cut. Preset editor and skill
-install-from-repo stay post-1.0 (top-15 P2).
-
-- [x] `/skills doctor` — broken frontmatter, long descriptions, global/project
-      duplicates, unused skills. Table, not an essay. (GRO-1416, #28)
-- [x] `/skills new` templates — standard, browser-workflow, CLI-workflow,
-      review-checklist. No marketplace. (GRO-1417, #32)
-- [x] Policy engine — in-process deny/inject, no spawn. Command hooks remain
-      for anything that needs a process. (GRO-1418, #29)
-- [x] Per-segment detail (CHE-41) — `→` in Navigate, snapshot on open.
-- [x] Idea review — `/ideas` overlay: idea / in-progress / done, tags,
-      Run with skill X. Welcome widget shows next idea + `/ideas next`.
-      (GRO-1419, #31)
-- [x] Status keys — `powerline.tps`, `powerline.ports`, `powerline.preset`,
-      `powerline.skills.count` via `ctx.ui.setStatus`. Not the public pitch.
-      (GRO-1420)
-- [x] Read-tool hints — continuation hint when core omits a range/offset
-      summary. (GRO-1420)
-- [x] English operator UI. (GRO-1422, #24)
-- [x] README lists doctor, new, policy, and idea-review. `banner.png` only.
-
----
-
-## Linear
-
-| Ticket | Actie |
-|---|---|
-| GRO-1060 fork cleanup | Done. Release-pad bewezen. CHANGELOG niet inkorten. Versie niet resetten. `banner.png` blijft. |
-| GRO-1061 CI queue | Ops, niet deze roadmap. |
-| CHE-40 `/powerline` tab | Done (#18 / 0.19.2). |
-| CHE-41 per-segment detail | Done. `→` in Navigate; snapshot on open; `alt+i` stays ports. |
-| CHE-42 drill-down | Done (#19 + Configure in #13). |
-| GRO-1414 0.20 leftovers | Done (#20 / 0.22.0). |
+The complete vNext architecture is detailed in **[`docs/design/vnext-release-plan.md`](docs/design/vnext-release-plan.md)** and executed across 9 stacked pull requests:
 
-Oude `pi-powerline-footer`-projecttickets niet laten staan alsof
-die package nog leeft.
+```mermaid
+graph LR
+  PR0["PR0: Design Corpus"] --> PR1["PR1: Motion Engine"]
+  PR1 --> PR2["PR2: Semantic Tokens"]
+  PR2 --> PR3["PR3: Preset Contract"]
+  PR3 --> PR4["PR4: Animated Signal"]
+  PR4 --> PR5["PR5: Wishcraft Deck"]
+  PR5 --> PR6["PR6: Appearance & Gallery"]
+  PR6 --> PR7["PR7: First-Class A11y"]
+  PR7 --> PR8["PR8: Craft, Skills & Docs"]
+```
 
 ---
 
@@ -373,55 +206,3 @@ die package nog leeft.
 - TPS-core blijft 1s sliding window over 5s-ring. Geen regressie
   naar session-average of per-render EMA (beide spikten:
   `tps:12775`).
-
----
-
-## Residual risks
-
-- `SelectList.setFilter` matcht alleen prefix op `value`. Overlay-chrome
-  filtert zelf op substring (GRO-1414). Skills-manager had dat al.
-- `npm deprecate` van de oude naam faalt tot de scope-owner het
-  token verruimt. Gebruikers die `pi-powerline-footer` installeren
-  blijven op 0.17.2.
-- Hooks spawnen processen. Default timeout 30s; kill-switch
-  `wishcraft.hooksEnabled` bestaat al op `main`.
-- Repairs op core-tools raken we niet aan. Als DeepSeek-achtige
-  modellen daar alsnog op stuklopen, is dat een gesprek met pi
-  core, geen stille override.
-- `loadSkills` API-drift: we pinnen `@earendil-works/pi-coding-agent`
-  `>=0.81.0 <0.85.0`. 0.20 neemt de publieke export over; bij
-  breaking change blijven we op eigen scan tot de pin omhoog kan.
-- Usage-ledger corruptie: best-effort write, kapot JSON → leeg
-  object, nooit throw op de input-path.
-- ChefGroep-keys in 1.0 mogen de publieke README niet gijzelen.
-
----
-
-## Rollback
-
-- PR A–H: revert-commit op `main`. Geen force-push.
-- 0.19-tag te vroeg: laat de tag staan, ship `0.19.1` met de fix.
-  Tags niet herschrijven.
-- Fork-tags (51 stuks) zijn weg. Recovery = upstream remote
-  `nicobailon/pi-powerline-footer` opnieuw fetchen, niet onze
-  `v0.10.0+` overschrijven.
-- DevDep-bumps (pi-* 0.84.2, TS 7) horen in een eigen PR met
-  `npm ci` + de verify-trio. Revert = die PR revert + `npm ci`.
-
----
-
-## Checklist (1:1 met 0.19)
-
-- [x] PR A gemerged: filter, debris, cache, triggers, bash-leaks,
-      CodeQL. Verify-trio groen. (#12)
-- [x] `npm pack --dry-run` bevat geen `ook.md` / `test.md`.
-- [x] PR B gemerged: labels, template, TPS-opties, visibility.
-      Verify-trio groen. (#12)
-- [x] Gallery-contract gemerged (`chore/pi-dev-gallery`): keywords,
-      `publishConfig.access`, `pi.image`, `npm run verify:package`. (#11)
-- [x] PR C: merge to `main` tagged `v0.19.0` then `v0.19.1` then
-      `v0.19.2` and published (`npm view` = `0.19.2`). Same-job bump
-      publish via #16. CHE-40 tab-complete via #18.
-- [x] README skills-sectie waar; deze ROADMAP in sync met 0.19.2.
-- [x] CHE-40: `/powerline` subcommand-tab geland (#18). CHE-41/42
-      hernoemd naar wishcraft.

package/docs/commands.md

@@ -2,7 +2,7 @@
 
 ## Usage
 
-Activates automatically. Toggle with `/powerline`, switch presets with `/powerline <name>`, and move the primary row with `/powerline placement above|below|toggle`.
+Activates automatically. Toggle with `/signal` (alias `/powerline`). Switch layouts with `/signal <name>`. `/signal menu` opens Navigate / Configure / Status. `/wishcraft` opens the Deck; `/wishcraft settings` is the flat list. Move the primary row with `/signal placement above|below|toggle`.
 
 Use `/cd <path>` to continue the current conversation from another working directory. It supports relative paths, absolute paths, `~`, `~/...`, and directory completions. With no argument, `/cd` prints the current Pi session directory. The command switches into a cwd-updated session file so Pi tools and the footer path segment agree after the change.
 
@@ -101,8 +101,12 @@ Pi core renders the footer as static text, so live click is not possible; action
 - `/open-ports`: list listening ports and pick one
 - `/powerline doctor`: diagnostics overlay — settings file validity, unknown presets, Nerd Font detection, git polling, bash-mode status, and queue file health
 - `/powerline export`: export the current preset + effective layout + labels as a JSON snippet (Enter copies it to the clipboard)
-- `alt+p`: **powerline menu**: navigate the live segments (`↑`/`↓` + `enter`, `→`/`tab` opens a per-segment detail panel captured at open), configure (preset / TPS / UDP / segment visibility / labels / build custom preset), or open the full ports list
+- `alt+p`: **Wishcraft Deck** — operator overlay (Home, Signal, Skills, Ideas, Guardrails, Appearance, …). `g` then a jump key (`h` home, `s` signal, `a` appearance). Escape closes. `/signal menu` still opens Navigate / Configure / Status.
 - `alt+i`: **powerline info**: full open-ports list
+- `/wishcraft [route]`: open the Deck at a named route (`appearance`, `skills`, …)
+- `/wishcraft settings`: flat settings TUI, including `powerline.appearance.base` and `powerline.motionLevel`
+- Deck **Motion**: gallery + composer. `t` picks the event, Enter applies, `e` opens the composer
+- Deck **Skills**: workbench list with health; Enter inserts the skill body
 
 Both `alt+p` and `alt+i` are rebindable (see Keybinds below); changes apply after `/reload`.
 

package/docs/configuration.md

@@ -190,6 +190,27 @@ Make `open_ports` probe a named SSH host instead of the laptop:
 
 See [Segments & theming](./segments.md) for the probe's best-effort behavior and requirements.
 
+## Appearance
+
+`powerline.appearance` is independent of the information layout (`powerline.preset`). The structural base paints Signal colors and motion. Layout presets (`default`, `minimal`, `compact`, `full`, `nerd`, `ascii`, `chef`) keep their segment lists until you change `preset`.
+
+```json
+{
+  "powerline": {
+    "preset": "chef",
+    "appearance": {
+      "base": "lanternwake"
+    }
+  }
+}
+```
+
+Bases: `lanternwake`, `threadbound`, `scryglass`, `runebloom`, `moonwell`, `hexforge`, `vellum`, `wisp`, `starweave`, `crucible`. Apply from Deck → Appearance → Enter, `/wishcraft settings`, or `/signal hexforge` (a structural layout name also writes `appearance.base`). Optional mix keys: `palette`, `signalLayout`, `chrome`, `glyphs`, `deck`, `welcome`, `motion`.
+
+Until `appearance` is set, Signal keeps the layout preset colors. If `preset` itself is a structural name and `appearance` is empty, that name is treated as the base.
+
+`powerline.motionLevel` is `full`, `reduced`, `functional`, or `off`. Host flags still win: `NO_COLOR`, `WISHCRAFT_MOTION`, `WISHCRAFT_SCREEN_READER`, and `PREFER_REDUCED_MOTION`. Deck Motion → Enter writes `powerline.appearance.motion.<event>`.
+
 ## Status bridge for other extensions
 
 Powerline publishes its own state under a stable key set so ChefBar and other extensions can read it without depending on powerline internals:

package/docs/design/accessibility.md

@@ -0,0 +1,71 @@
+# First-Class Accessibility & Graceful Degradation
+
+## Overview
+
+Terminal environments vary drastically—from modern GPU-accelerated terminals with full truecolor and Nerd Font glyphs to low-bandwidth SSH sessions, restricted 8-color virtual consoles, and screen readers.
+
+Wishcraft treats accessibility and environmental adaptability as first-class architectural constraints, directly resolving ROADMAP P1 Gap #4.
+
+---
+
+## Motion Levels
+
+Users can configure global motion sensitivity via settings or keyboard shortcuts:
+
+```
+Motion Sensitivity:
+(●) Full              - Continuous sweeps, micro-spinners, and transitions
+( ) Reduced           - Instant state changes; continuous loops replaced by static glyphs
+( ) Functional Only   - Task indicators active; decorative ambient motion disabled
+( ) Off               - 100% static display; zero animated frames
+```
+
+---
+
+## Environment Degradation Matrix
+
+```
+┌───────────────────┬───────────────────┬───────────────────┬────────────────────┐
+│ ENVIRONMENT       │ MOTION BEHAVIOR   │ COLOR PALETTE     │ GLYPH RENDERING    │
+├───────────────────┼───────────────────┼───────────────────┼────────────────────┤
+│ Modern Truecolor  │ Full FPS & Sweeps │ True 24-bit RGB   │ Full Nerd Fonts    │
+│ Standard 256 Color│ Full FPS & Sweeps │ ANSI-256 Mapped   │ Unicode / Nerd     │
+│ Basic 8/16 Color  │ Simplified Pulse  │ Basic ANSI        │ Clean ASCII        │
+│ NO_COLOR Set      │ Glyphs Active     │ No ANSI Escapes   │ Unicode / ASCII    │
+│ prefers-reduced   │ Discrete States   │ Full Color        │ Standard Glyphs    │
+│ Screen Reader     │ Disabled (0 FPS)  │ High Contrast     │ Descriptive Text   │
+└───────────────────┴───────────────────┴───────────────────┴────────────────────┘
+```
+
+---
+
+## Concrete Degradation Policies
+
+### 1. `NO_COLOR` Compliance
+When the `NO_COLOR` environment variable is detected:
+- All ANSI color codes and RGB background styling are stripped.
+- Spatial layout, separators, and glyph animations remain active to convey status through structure.
+
+### 2. `prefers-reduced-motion`
+When reduced motion is requested by the OS or user configuration:
+- Continuous sweeps along the Signal track are disabled.
+- Spinners transition immediately to static state markers (`[..]`, `[ok]`, `[!]`).
+- Transient notifications appear statically without fade-in or slide-in transitions.
+
+### 3. Screen Reader Mode
+- Motion engine is completely stopped (0 FPS).
+- Powerline separators and visual spacers are suppressed.
+- Status is formatted as clean, semantic plain text (e.g. `Model: GPT-5.6 | Git: main (clean) | State: Streaming | Context: 47%`).
+
+### 4. ASCII Fallback Strategy
+Every custom Unicode icon and Nerd Font symbol provides a guaranteed 1-to-1 ASCII equivalent:
+
+| Semantic Icon | Nerd Font Glyph | Unicode Default | ASCII Fallback |
+| :--- | :--- | :--- | :--- |
+| Model | `󰚩` | `◈` | `[*]` |
+| Git Branch | `` | `⎇` | `branch:` |
+| Git Clean | `✔` | `✓` | `ok` |
+| Git Dirty | `✎` | `⚡` | `*` |
+| Streaming | `󱐋` | `✦` | `~` |
+| Tool Call | `󰒓` | `◆` | `>` |
+| Error | `󰅚` | `✗` | `ERR` |

package/docs/design/deck-layout.md

@@ -0,0 +1,69 @@
+# Deck Layout & Interactive Route Architecture
+
+## Overview
+
+The **Wishcraft Deck** (`Alt+P` / `/wishcraft`) is the central control surface for the agent operator. It replaces fragmented menus with a cohesive, keyboard-first modal overlay built inside `ctx.ui.custom`.
+
+---
+
+## The Continuous Surface Design
+
+Unlike cheap TUIs that stack boxes inside boxes with conflicting borders, the Deck utilizes a **single continuous outer frame** partitioned into an ambient header, the active route viewport, and a contextual footer.
+
+```
+╭────────────────────────────── WISHCRAFT DECK ──────────────────────────────╮
+│ ◈ GPT-5.6 HIGH        main +12      context 47%        ◆ STREAMING         │
+├──────────────┬──────────────────────────────────────┬───────────────────────┤
+│ NAVIGATION   │ ACTIVE ROUTE: HOME                   │ ACTIVITY FEED         │
+│              │                                      │                       │
+│ ◉ Home       │  CURRENT SESSION                     │ 21:16 read_file       │
+│ ◆ Signal     │  ◆ Streaming response                │ 21:16 grep_pattern    │
+│ ◇ Skills  27 │  ━━━━╾✦╼━━━━━━━━━━━━                 │ 21:15 skill.load      │
+│ ◇ Ideas    4 │                                      │                       │
+│ ◇ Guardrails │  Context Capacity                    │ SKILLS HEALTH         │
+│ ◇ Shell      │  ████████░░░░░ 47% (94k / 200k)      │ ✓ 25 healthy          │
+│ ◇ Usage      │                                      │ !  2 warnings         │
+│ ◇ Appearance │  NEXT INTENT                         │                       │
+│ ◇ Motion     │  Improve Signal motion engine        │ GUARDRAILS            │
+│ ◇ Shortcuts  │  [Run]  [Open Skill]  [Review]       │ Policy: STRICT (Enf)  │
+├──────────────┴──────────────────────────────────────┴───────────────────────┤
+│ / Search     g s Skills     g i Ideas     ? Help     Esc Close Deck         │
+╰─────────────────────────────────────────────────────────────────────────────╯
+```
+
+---
+
+## Route Catalog & Deep Links
+
+| Route | Deep Link Command | Purpose & Main Components |
+| :--- | :--- | :--- |
+| **`Home`** | `/wishcraft` / `Alt+P` | Live session overview, intent card, context bar, recent activity stream. |
+| **`Signal`** | `/signal` | Visual powerline editor, lane assignments, separator picker. |
+| **`Skills`** | `/skills` | Skill catalog, inline creation wizard, health diagnostics. |
+| **`Skills Doctor`**| `/skills doctor` | Deep validation of skill frontmatter, descriptions, and triggers. |
+| **`Ideas`** | `/ideas` | Rapid capture and organization of intent notes and future tasks. |
+| **`Guardrails`** | `/guardrails` | Safety policies, denial logs, execution boundaries. |
+| **`Shell`** | `/shell` | Execution environment inspect, tool binary availability. |
+| **`Usage`** | `/usage` | Detailed token statistics and context window metrics. |
+| **`Appearance`**| `/appearance` | Preset picker, semantic token overrides, layout density. |
+| **`Motion`** | `/motion` | Motion Gallery, Composer, accessibility sensitivity sliders. |
+| **`Shortcuts`** | `/shortcuts` | Keyboard navigation and jump-mode cheat sheet. |
+| **`Diagnostics`**| `/diagnostics` | Terminal capabilities, color support, and encoding checks. |
+
+---
+
+## Navigation Ergonomics
+
+Wishcraft combines **Posting-style jump shortcuts** with a fast **fuzzy command palette**:
+
+1. **Global Jump Keys**:
+   - `g h` $\rightarrow$ Jump to Home
+   - `g s` $\rightarrow$ Jump to Skills
+   - `g i` $\rightarrow$ Jump to Ideas
+   - `g a` $\rightarrow$ Jump to Appearance
+   - `g m` $\rightarrow$ Jump to Motion
+2. **Fuzzy Search Palette (`/`)**:
+   - Typing `/` anywhere in the Deck opens the instant search bar.
+   - Matches routes, config keys, actions, and skills with real-time highlighted filtering.
+3. **Key Hints**:
+   - The footer always renders context-relevant shortcuts, eliminating the need to memorize keybindings.