@groeponline/pi-wishcraft 0.17.3 → 0.19.0

package/AGENTS.md

@@ -16,15 +16,19 @@ user customization.
   `parseBashModeSettings`, `PowerlineShortcuts`). Keep it a barrel; no
   implementation lives here.
 - `src/` — the proxy-free extension runtime, organized by domain:
-  - `src/extension/` — activation, command handlers, session lifecycle,
-    custom editor wiring, shortcut routing, settings IO, queue and menu views.
-    Leaf modules (`types.ts`, `constants.ts`, `queue-context.ts`,
-    `welcome-control.ts`, `settings-io.ts`, `prompt-history.ts`,
-    `stash-history.ts`, `shortcuts-config.ts`) keep the dependency graph
-    acyclic: shared types and constants live in leaves, queue/welcome
-    callbacks are wired through leaves or `RuntimeState`, and `state.ts` is
-    the hub that only has inbound edges. Verify with `npx madge --circular
-    src index.ts bash-mode queue`.
+  - `src/extension/` — the extension runtime, organized into domain subfolders:
+    `core/` (constants, types, `state.ts` hub, segment-context), `commands/`
+    (slash commands, queue commands, bash-mode actions, vibe command),
+    `session/` (activation, session lifecycle, git invalidation, stale-context),
+    `ui/` (custom editor, layout, menu views, powerline widgets, status-line
+    renderers), `history/` (prompt + stash history), `queue/` (queue context +
+    integration), `settings/` (settings IO), `shortcuts/` (shortcut config +
+    router), `welcome/` (welcome control + integration), `skills/` (inline
+    invocation). Leaf modules keep the dependency graph acyclic: shared types
+    and constants live in `core/`, queue/welcome callbacks are wired through
+    leaves or `RuntimeState`, and `core/state.ts` is the hub that only has
+    inbound edges. Verify with `npx madge --circular src index.ts bash-mode
+    queue`.
   - `src/config/` — powerline config parsing, presets, types, segment ids/options.
   - `src/segments/` — segment registry and the segment renderers.
   - `src/theme/` — colors, icons, separators, theme loading.
@@ -48,7 +52,7 @@ user customization.
   boundaries (e.g. command handlers out of `commands.ts`, git invalidation
   out of `session-lifecycle.ts`). Prefer many cohesive small modules.
 - **No circular imports.** Domain modules must not import back into
-  `src/extension/state.ts` for callbacks; move the callback into a leaf module
+  `src/extension/core/state.ts` for callbacks; move the callback into a leaf module
   (e.g. `welcome-control.ts`) or wire it through `RuntimeState`.
 - **Bun/Node-native TS:** `import` paths carry `.ts` extensions
   (`allowImportingTsExtensions`), `node:`-prefixed builtins, `node --test`

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## [0.19.0] - 2026-08-20
+
+### Added
+- Every merge to `main` cuts an npm release: CI chooses patch/minor/major from commits since the last `v*` tag, pushes `vX.Y.Z`, and publishes with the GroepOnline org secret `NPM_TOKEN`. `[skip release]` opts out.
+
+### Changed
+- Pi catalog contract: `pi-extension` / `wishcraft` keywords, public `publishConfig`, and a `pi.image` banner so the next npm publish lands on [pi.dev/packages](https://pi.dev/packages?name=groeponline) next to the other GroepOnline packages.
+
+## [0.18.0] - 2026-08-16
+
+Wishcraft v2 (#7).
+
+### Added
+- **Tab token completion** — bash-mode tab completion for stored tokens/shortcuts.
+- **Preset rework** — own-property preset handling plus reworked presets.
+- **Git commit/ahead-behind extras** — commit count and ahead/behind in the git segment; ANSI/control chars in git commit metadata sanitized.
+- **TPS in/out** — separate tokens-in/tokens-out throughput.
+- **Interactive skill-manager TUI** (`/skills`) — browse, inspect, and manage discovered skills.
+- **Full git polling for compact extras** — reliable commit/ahead-behind data.
+
+### Changed
+- **Extension refactor** — `src/extension` split into domain subfolders (core, commands, session, ui, history, queue, settings, shortcuts, welcome).
+
+### Fixed
+- **Ghost suggestions revalidated after partial completion** — and scheduleGhostUpdate stubbed in tab token-step tests.
+
 ## [0.17.3] - 2026-08-10
 
 ### Added

package/README.md

@@ -13,7 +13,7 @@ This extension translates that philosophy to the [pi](https://github.com/badlogi
 4. **Stash & Pivot (Alt+S)**: Park a prompt draft, ask a quick question, pop it back automatically.
 5. **Sticky Shell (`!cmd`)**: A persistent bash runtime under your fingertips.
 
-Inspired by [Powerlevel10k](https://github.com/romkatv/powerlevel10k) and [oh-my-pi](https://github.com/can1357/oh-my-pi).
+Inspired by [Powerlevel10k](https://github.com/romkatv/powerlevel10k) and [oh-my-pi](https://github.com/can1357/oh-my-pi). Forked from [`nicobailon/pi-powerline-footer`](https://github.com/nicobailon/pi-powerline-footer), maintained by [GroepOnline](https://github.com/GroepOnline).
 
 <img width="1261" height="817" alt="Example powerline UI" src="https://github.com/user-attachments/assets/4cc43320-3fb8-4503-b857-69dffa7028f2" />
 
@@ -54,6 +54,8 @@ Inspired by [Powerlevel10k](https://github.com/romkatv/powerlevel10k) and [oh-my
 pi install npm:@groeponline/pi-wishcraft
 ```
 
+Listed on the [Pi package catalog](https://pi.dev/packages?name=wishcraft) as `@groeponline/pi-wishcraft` next to the other GroepOnline pi packages.
+
 ### Method 2: One-Liner / Cloud Agent Startup Script (Cursor Cloud, Freebuff, Devcontainers, CI)
 
 For ephemeral VMs, cloud agents, or dev environments without manual intervention:
@@ -125,13 +127,13 @@ You can also set it in the agent settings file (`~/.pi/agent/settings.json` by d
 
 | Preset | Description |
 |--------|-------------|
-| `default` | Model, thinking, path (basename), git, context, tokens, cost |
-| `minimal` | Just path (basename), git, context |
-| `compact` | Model, git, cost, context |
-| `full` | Everything including hostname, time, abbreviated path |
-| `nerd` | Maximum detail for Nerd Font users |
-| `ascii` | Safe for any terminal |
-| `chef` | Fork default: muted colors, slash separators, TPS + open-ports segments |
+| `default` | Balanced daily driver: model, thinking, path (basename), git (branch + dirty + latest commit + ↑/↓ ahead-behind + host icon), session, queue, subagent cost, tokens in/out, cache-hit%, cost, context |
+| `minimal` | Just path (basename), git branch and context% (branch-only polling, no indicators/commit) |
+| `compact` | Model, git (short commit + ahead/behind), queue, cost, context%, session id |
+| `full` | Everything: hostname, model, path (abbreviated), full git incl commit + ↑/↓, totals, context total, elapsed + clock |
+| `nerd` | Maximum detail for Nerd Font users: qualified model, full tokens + cache, commit, totals, seconds clock |
+| `ascii` | Safe for any terminal: branch + short commit + ↑/↓, tokens, cost, context% (no Nerd glyphs) |
+| `chef` | Fork default: muted colors, slash separators, live TPS in/out + open-ports + subagent-cost segments |
 
 **Environment:** `POWERLINE_NERD_FONTS=1` to force Nerd Fonts, `=0` for ASCII.
 
@@ -238,7 +240,7 @@ Define your own preset in settings; it merges over built-ins and is selectable v
 
 `preset: "chef"` is the GroepOnline fork's default look: muted colors (no rainbow), slash separators, and two extra right-side segments:
 
-- `tps`: live tokens/sec, rolling 1-second window (EMA-free, no spikes); a rocket/bolt icon lights up while generating (override with env `POWERLINE_TPS`)
+- `tps`: live tokens/sec over a rolling 1-second window (EMA-free, no spikes), now reporting **output and input** rates separately (`⇡out ⇣in`) so you can see generation speed and incoming prompt tokens at a glance. A rocket/bolt icon lights up while streaming (override with env `POWERLINE_TPS`).
 - `open_ports`: count of unique **TCP** listening ports (`ss` → `netstat` → `/proc/net` fallback, dedupes IPv4/IPv6). Set `segmentOptions.openPorts.includeUdp: true` to include noisy UDP (mDNS/DHCP/ephemeral).
 
 Interactivity (Pi core renders the footer as static text, so live click is not possible; actions live in commands and a navigable overlay):
@@ -378,7 +380,7 @@ While bash mode is active:
 
 - Enter runs the current shell command
 - Right Arrow accepts ghost text into the editor without running it
-- Tab accepts the current ghost suggestion when one exists; otherwise it does nothing
+- Tab completes the ghost suggestion one token/segment at a time (repeat Tab to step through each further token); once the full suggestion is inserted it clears, otherwise Tab does nothing
 - Up and Down browse matching shell history
 - `escape` exits bash mode and returns to normal prompt mode
 - `ctrl+c` interrupts the active shell job before falling back to normal pi behavior
@@ -462,6 +464,14 @@ After changing bindings, run `/reload`. Invalid bindings, reserved key conflicts
 
 Powerline wraps Pi's autocomplete provider so bash mode can add shell-aware suggestions. When another editor extension was already installed, powerline now passes Pi's provider through that previous editor's `setAutocompleteProvider()` first and then wraps the resulting provider. This preserves prior autocomplete-provider wrappers where possible, but it is not full render/input composition between custom editors.
 
+## Skill manager
+
+Browse and insert your installed skills (`SKILL.md` files and `*.md`/`*.txt` prompts) from an interactive TUI overlay:
+
+- **`/skills`** — open the skill manager. Filter with plain typing, `↑↓` to move, `enter` to open a skill's detail body, `↑↓` in the detail to scroll, `enter`/`tab` to insert the skill content into your prompt, `esc` to go back/close.
+
+The manager reuses the same skill discovery as inline `/command`/`$skill` triggers, so anything you can inline you can also browse and insert manually.
+
 ## Working Vibes
 
 Transform boring "Working..." messages into themed phrases that match your style:
@@ -583,9 +593,27 @@ Set `git.hostIcon` to replace the branch icon with the origin remote's host logo
 
 The origin remote is detected (SSH or HTTPS) and mapped to an icon: GitHub (`nf-fa-github`), GitLab (`nf-fa-gitlab`), Bitbucket (`nf-fa-bitbucket`), or a generic git logo (`nf-fa-git`) for any other remote (self-hosted, Gitea, Codeberg, …). Repositories without an origin remote keep the plain branch icon (`nf-fa-code_fork`), as do ASCII (non–Nerd Font) setups. The remote is read once and cached, so this adds no per-render cost. Default is `false` (branch icon unchanged).
 
+## Git status extras (commits, ahead/behind)
+
+The git segment can also show the last commit on `HEAD` (short hash + subject) and the upstream ahead/behind counts — handy for a quick "where am I relative to main" GitHub signal:
+
+- `git.showCommit` (`true` by default) — appends `#<hash> <subject>` for the latest commit.
+- `git.maxCommitSubjectLength` (`24`) — truncates the commit subject shown.
+- `git.showAheadBehind` (`true` by default) — appends `↑<n> ↓<n>` for commits ahead/behind the configured upstream (hidden when there is no upstream).
+
+```json
+{
+  "powerline": {
+    "git": { "showCommit": true, "showAheadBehind": true, "maxCommitSubjectLength": 24 }
+  }
+}
+```
+
+The `minimal` and `compact` presets keep these off to stay lean; set `showCommit: true`/`showAheadBehind: true` to enable them.
+
 ## Segments
 
-`model` · `thinking` · `shell_mode` · `path` · `git` · `subagents` · `token_in` · `token_out` · `token_total` · `cost` · `context_pct` · `context_total` · `time_spent` · `time` · `session` · `hostname` · `cache_read` · `cache_write` · `extension_statuses`
+`model` · `shell_mode` · `path` · `git` · `subagents` · `queue` · `token_in` · `token_out` · `token_total` · `cost` · `context_pct` · `context_total` · `time_spent` · `time` · `session` · `hostname` · `cache_read` · `cache_write` · `thinking` · `tps` · `open_ports` · `extension_statuses`
 
 ## Separators
 
@@ -613,6 +641,9 @@ Colors are configurable via pi's theme system. Each preset defines its own color
 | `contextError` | `error` | Context usage >90% |
 | `cost` | `text` | Cost display |
 | `tokens` | `muted` | Token counts |
+| `queue` | `accent` | Queue / ideas / blocked counts |
+| `separator` | `dim` | Segment separators and ahead/behind counts |
+| `border` | `borderMuted` | Panel/border chrome |
 
 ### Custom Theme Override
 

package/RELEASE.md

@@ -1,28 +1,42 @@
 # Releasing `@groeponline/pi-wishcraft`
 
-This is the GroepOnline fork of `pi-powerline-footer`. It ships to npm as the
-scoped package `@groeponline/pi-wishcraft` and installs locally from the
-repo path. This doc records the end-to-end release flow and how to verify it.
+`@groeponline/pi-wishcraft` is GroepOnline's powerline status bar and
+interaction layer for the pi coding agent (forked from
+`nicobailon/pi-powerline-footer`, now independently maintained). It ships to
+npm as the scoped package `@groeponline/pi-wishcraft` and installs locally
+from the repo path. This doc records the end-to-end release flow and how to
+verify it.
 
 ## Identity
 
-- **GitHub repo:** `GroepOnline/pi-wishcraft` (fork of `nicobailon/pi-powerline-footer`)
+- **GitHub repo:** `GroepOnline/pi-wishcraft` (forked from `nicobailon/pi-powerline-footer`, independently maintained)
 - **npm package:** `@groeponline/pi-wishcraft` (scoped, `--access public`)
 - **Default branch:** `main`
-- **Local checkout:** `/home/joep/pi-wishcraft`
-- **Pi settings (`~/.pi/agent/settings.json`):** packages entry `/home/joep/pi-wishcraft` (local path, not the npm name) and `"powerline": "chef"`. Local edits are picked up on `/reload` — no reinstall needed.
+- **Local checkout:** `~/Documents/Github/GroepOnline/pi-wishcraft`
+- **Pi settings (`~/.pi/agent/settings.json`):** packages entry `npm:@groeponline/pi-wishcraft` and `"powerline": "chef"`. For active development, temporarily swap the entry to the local checkout path so edits are picked up on `/reload` — no reinstall needed; switch back to the npm name for the installed release.
 
 ## The release flow
 
-A release is: bump version → roll CHANGELOG → commit → tag → push. The tag
-triggers CI which tests and publishes to npm.
+**Default:** every merge to `main` is a release. `.github/workflows/release.yml`
+runs `node scripts/release.mjs auto --push` on `main`, then publishes when
+the `v*` tag lands. `auto` reads commit subjects since the last `v*` tag:
+`feat:` → minor, `feat!:` / `BREAKING CHANGE` → major, otherwise patch.
+
+The first merge after `v0.18.0` therefore becomes **0.19.0** (the 0.19
+`feat:` commits are already on `main`). Later docs/fix merges become
+`0.19.1`, `0.19.2`, …
+
+Put `[skip release]` in the merge-commit subject to opt out. The follow-up
+`chore: release X.Y.Z` commit does not tag again.
+
+Manual still works when you want an explicit version before pushing tags:
 
 ```bash
 # 1. Make sure the working tree is clean and tests/typecheck pass (see Verification)
 npm run typecheck        # tsc --noEmit
 npm test                 # node --experimental-strip-types --test tests/**/*.test.ts
 
-# 2. Release (patch | minor | major | explicit 1.2.3)
+# 2. Release (patch | minor | major | auto | explicit 1.2.3)
 npm run release minor    # = node scripts/release.mjs minor
 ```
 
@@ -34,12 +48,12 @@ npm run release minor    # = node scripts/release.mjs minor
 4. `git commit -m "chore: release <version>"`
 5. `git tag -a v<version> -m "Release <version>"`
 
-It does **not** push — it prints the push command. Push with the GroepOnline SSH
-identity (the laptop default `ssh`/OnlineChef key is denied for this org):
+Locally it does **not** push unless you pass `--push` (CI does). Manual push
+uses the GroepOnline SSH identity (the laptop default SSH key is denied):
 
 ```bash
 GIT_SSH_COMMAND='ssh -F ~/.ssh/config-groeponline -o IdentityFile=~/.ssh/sheesh' \
-  git push origin HEAD --tags
+  git push origin HEAD refs/tags/vX.Y.Z
 ```
 
 - SSH host alias: `github.com-groeponline` (defined in `~/.ssh/config-groeponline` with `IdentityFile ~/.ssh/sheesh`, `IdentitiesOnly yes`).
@@ -54,12 +68,15 @@ GIT_SSH_COMMAND='ssh -F ~/.ssh/config-groeponline -o IdentityFile=~/.ssh/sheesh'
 3. `npm ci --ignore-scripts` (installs devDependencies incl. `typescript`)
 4. `npm run typecheck` (tsc)
 5. `npm test` (node test runner)
-6. `npm publish --access public` with `NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}`
+6. `npm run verify:package` (catalog contract gate — see `scripts/verify-package.mjs`)
+7. `npm publish --access public` with `NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}`
+8. Echoes the Pi catalog URLs (npm, pi.dev detail page, `?name=wishcraft`, `?name=groeponline`) for post-publish confirmation
 
-`NPM_TOKEN` is a GitHub Actions secret on the repo (publish rights to the
-`@groeponline` scope). It is **not** readable after being set; verify it works by
-checking that the publish step on a real release succeeds and `npm view` resolves
-the new version (see below).
+`NPM_TOKEN` is the GroepOnline **org** Actions secret (publish rights to the
+`@groeponline` scope). This repo has no override; Actions inherits the org
+value. It is **not** readable after being set; verify it works by checking
+that the publish step on a real release succeeds and `npm view` resolves the
+new version (see below). The publish step fails closed if the secret is empty.
 
 The package has no build step — `*.ts` files are shipped directly (`pi.extensions:
 ["./index.ts"]`), and Pi loads them with TypeScript stripping at runtime.
@@ -97,8 +114,8 @@ A release is "done" when all four hold: local green, tag on origin, CI
   publish succeeded. The CI log line `+ @groeponline/pi-wishcraft@<v>`
   and HTTP `200` from `https://registry.npmjs.org/@groeponline%2fpi-wishcraft`
   are the real success signals; retry `npm view` if you see an early 404.
-- **Wrong SSH key = `Permission denied (publickey)` / `denied to OnlineChef`.**
-  Always push with `GIT_SSH_COMMAND='ssh -F ~/.ssh/config-groeponline -o IdentityFile=~/.ssh/sheesh'`.
+- **Wrong SSH key = `Permission denied (publickey)`.**
+  Always push with `GIT_SSH_COMMAND='ssh -F ~/.ssh/config-groeponline -o IdentityFile=~/.ssh/sheesh'` (chefadmin-netizen / `~/.ssh/sheesh`).
 - **TPS used to show absurd values** (e.g. `tps:12775`) because `sessionStartTime`
   resets on extension reload while output is cumulative. Fixed in 0.15.0 with a
   rolling token-rate. If TPS ever looks wrong again, check that `tpsSegment` still
@@ -112,6 +129,14 @@ A release is "done" when all four hold: local green, tag on origin, CI
 
 ## Versioning
 
-- **patch** (`0.15.0 → 0.15.1`): bug fixes, doc only.
-- **minor** (`0.15.x → 0.16.0`): new segments/presets, features, additive changes.
+Feature PRs **do not bump** `package.json`. They stay on the last published npm
+version (today: `0.18.0`) and append under `## [Unreleased]` in `CHANGELOG.md`.
+The bump happens on `main` in the release workflow, not in the feature PR.
+
+Never bump in the same PR as the feature work. Never tag from a stacked
+feature branch. `0.19.0` exists only after `main` auto-tags (or a manual
+`npm run release` on `main`).
+
+- **patch** (`0.18.0 → 0.18.1`): bug fixes, doc only; escape hatch if 0.19 slips.
+- **minor** (`0.18.x → 0.19.0`): new segments/presets, features, additive changes.
 - **major**: breaking changes to settings shape or exported API.