@hienlh/ppm 0.12.12 → 0.13.2

package/CHANGELOG.md

@@ -1,12 +1,42 @@
 # Changelog
 
+## [0.13.2] - 2026-04-21
+
+### Changed
+- **Chat tab badges redesign** — reduced visual noise from 3 separate indicators to integrated icon states:
+  - **Tag**: removed left-side color dot, now colors the chat icon itself. Untagged tabs force neutral gray (`text-text-secondary`) regardless of active state, so they don't get confused with blue-tagged tabs when active (`text-primary` was leaking into icon)
+  - **Streaming**: replaced top-right pulsing green dot with **Messenger-style typing dots** bouncing inside the chat bubble icon (3× `size-[2px]` circles using `bg-current` + staggered `animationDelay`). Added `tabTypingBounce` keyframe (1.5px translate, 1s loop) to `globals.css` with `prefers-reduced-motion` fallback
+  - **Notification**: unchanged — still top-right colored dot when unread and tab inactive
+- **Favicon streaming indicator** — replaced blue/amber flash with **typing dots animation** on amber background (`#f59e0b`, high-attention) for better peripheral visibility. Pre-encodes 4 frames (3 active positions + 1 rest frame — rest frame makes cycle boundary perceptible so all 3 dots appear to bounce equally) cycled every 300ms. `setFavicon()` signature changed: second arg is now `streamingFrame: number | null` (null = idle) instead of `isStreamingAlt: boolean`. Exports `STREAM_FRAME_COUNT` for DRY cycling in `useNotificationBadge`
+
+## [0.13.1] - 2026-04-21
+
+### Fixed
+- **WSL/Linux upgrade killed entire PPM stack (100% repro)**: Under `systemd` with `Type=simple`, the old supervisor's `process.exit(0)` at the end of `selfReplace()` triggered `KillMode=mixed` cgroup cleanup that SIGKILLed the freshly-spawned new supervisor along with server + cloudflared. Root cause: `Bun.spawn + unref()` does not escape the unit cgroup. Fix combines two changes:
+  - **Type=notify + MAINPID handoff**: Generated systemd unit now uses `Type=notify` / `NotifyAccess=all`. New supervisor sends `READY=1` via `sd_notify` on startup; during `selfReplace()`, old supervisor sends `MAINPID=<new_pid>` so systemd re-tracks the new supervisor as MainPID *before* the old one exits — cgroup is preserved instead of torn down
+  - **Tunnel in transient systemd scope**: `spawnTunnel()` now wraps `cloudflared` in `systemd-run --user --scope --quiet --collect` when running under systemd, hoisting the tunnel into its own cgroup so the trycloudflare URL survives ppm.service restarts (even the worst-case one). Preserves `adoptTunnel()` domain continuity across upgrades
+  - **Auto-migration**: `ppm start` detects stale unit files missing `Type=notify` and regenerates them silently; user runs one `systemctl --user restart ppm.service` after first upgrade to pick up the new unit
+
+### Added
+- **`src/services/sd-notify.ts`**: Thin wrapper around `systemd-notify` binary for `READY=1` / `MAINPID=` messages. No-op when `NOTIFY_SOCKET` is unset (non-systemd)
+- **`isAutoStartUnitStale()` helper**: Detects outdated systemd unit files so `ppm start` can regenerate them inline
+
+## [0.13.0] - 2026-04-21
+
+### Added
+- **`ppm export skill`**: Install a Claude Code skill at `~/.claude/skills/ppm/` so external AI agents can control PPM via its CLI, HTTP API, and SQLite config DB. Flags: `--install`, `--scope user|project`, `--output <dir>`, `--format claude-code`. Generates `SKILL.md` + `references/{cli-reference,http-api,db-schema,common-tasks}.md`. CLI/HTTP references are auto-generated at build time by walking the Commander tree and scanning Hono route files. DB schema is generated at install time from the user's `~/.ppm/ppm.db` (opened readonly). Re-install is safe: existing files are renamed to `<name>.bak-<YYYYMMDDHHmm>` before overwrite. Preview mode (no `--install`/`--output`) writes the merged `SKILL.md` to stdout.
+- **`buildProgram()` export in `src/index.ts`**: Module now exports the assembled Commander tree without parsing argv, enabling build-time introspection for auto-generated docs. Runtime behavior preserved via `import.meta.main` guard.
+
+### Changed
+- **Generator rename**: `scripts/generate-ppm-guide.ts` → `scripts/generate-ppm-skill.ts` (plus `scripts/lib/` modules). Output moved from `assets/skills/ppm-guide/` → `assets/skills/ppm/`. `npm` scripts: `generate:guide` → `generate:skill`; `prepublishOnly` updated.
+
 ## [0.12.12] - 2026-04-21
 
 ### Fixed
 - **Login broken when using `--share` without profile**: The `--share` flag was positionally parsed as a DB profile name in both supervisor and server child, causing them to read `ppm.--share.db` (with a random auto-generated token) instead of `ppm.db`. Users saw perpetual "Unauthorized" on login despite entering the correct token
 
 ### Added
-- **Expand compacted conversation**: When Claude compacts context and references a JSONL transcript (`read the full transcript at: ...`), the chat now shows a "Load previous conversation" button. Clicking fetches the pre-compact messages via `GET /chat/pre-compact-messages?jsonlPath=...` and renders them inline in a collapsible section using the existing message pipeline. Extracted shared JSONL parsing logic (`parseSessionMessage`, `nestChildEvents`, `extractText`, `stripTeammateXml`) into `src/services/jsonl-transcript-parser.ts` for reuse. Path is validated strictly under `~/.claude/` (symlink-resolved realpath) with a 50MB size guard
+- **Expand compacted conversation**: When Claude compacts context and references a JSONL transcript (`read the full transcript at: ...`), the chat now shows a "Load previous conversation" button. Clicking fetches pre-compact messages via `GET /chat/pre-compact-messages?jsonlPath=...` and **prepends them into the main message list above the compact card** (natural Messenger-style UX) — scroll up to view history, and nested compact summaries in loaded history show their own button for recursive expansion. Expansions are ephemeral (reset on session switch). Extracted shared JSONL parsing into `src/services/jsonl-transcript-parser.ts`. Path validated strictly under `~/.claude/` (symlink-resolved realpath) with a 50MB size guard
 - **Full-content diff endpoint**: `GET /git/file-full-diff?file=&ref=` returns original (ref) and modified (working tree) file contents for Monaco DiffEditor
 
 ## [0.12.11] - 2026-04-21

package/README.md

@@ -128,6 +128,17 @@ bunx @hienlh/ppm init -y \
 
 Once running, the Cloudflare public URL is printed to stdout — parse it to share with users.
 
+## Use with Claude Code
+
+Install the PPM skill so Claude Code (and other compatible AI agents) can control PPM via its CLI, HTTP API, and SQLite config DB:
+
+```bash
+ppm export skill --install
+# Installs to ~/.claude/skills/ppm/ (use --scope project for per-project install).
+```
+
+Then in Claude Code: `/ppm list my projects` → Claude invokes `ppm projects list` automatically. Re-run any time to refresh (existing files are backed up with a `.bak-<timestamp>` suffix). Requires PPM v0.13.0+.
+
 ## Requirements
 
 - **Bun** v1.3.6+ ([install](https://bun.sh))

package/assets/skills/ppm/SKILL.md

@@ -0,0 +1,74 @@
+---
+name: ppm
+description: Control PPM (Project & Process Manager) via its CLI, HTTP API, and SQLite config database. Use when the user wants to manage PPM projects, query database connections, start/stop the PPM server, view logs, or read/write PPM config.
+---
+
+# PPM Skill
+
+PPM is a local-first web IDE + project manager. This skill describes how to control PPM from the terminal, over HTTP, and by inspecting its SQLite config database.
+
+## Quick Reference
+
+| What | Where |
+|---|---|
+| CLI binary | `ppm` |
+| Default server | `http://localhost:8080` |
+| Config DB (prod) | `~/.ppm/ppm.db` (SQLite) |
+| Config DB (dev) | `~/.ppm/ppm.dev.db` (port 8081) |
+| Skill root (user) | `~/.claude/skills/` |
+| Skill root (project) | `<project>/.claude/skills/` |
+
+## When to Use This Skill
+
+Invoke when the user asks to:
+- Start, stop, restart, or check the PPM server
+- Manage registered projects (`projects list/add/remove`)
+- Manage database connections stored in PPM config (`db list/add/test/query`)
+- Get or set PPM config values (`config get/set`)
+- View PPM logs, status, or report a bug
+- Install, upgrade, or inspect bundled skills / extensions
+- Control the PPM daemon autostart registration
+
+## Top Tasks
+
+1. **Check if PPM is running** → `ppm status`
+2. **Start server** → `ppm start` (use `--port <n>` to override, `--profile dev` for dev DB)
+3. **List projects** → `ppm projects list`
+4. **Add project** → `ppm projects add <path>`
+5. **List DB connections** → `ppm db list`
+6. **Query a saved DB connection** → `ppm db query <connection-name> "<sql>"`
+7. **Read config** → `ppm config get <key>` (e.g. `port`, `auth.enabled`)
+8. **Tail logs** → `ppm logs --tail 100` or `ppm logs -f` to follow
+9. **Upgrade PPM** → `ppm upgrade` (or `--check` to only check)
+10. **Open in browser** → `ppm open`
+
+## Rules of Thumb
+
+- Always run `ppm status` before assuming the server is up.
+- Commands exit non-zero on failure and print to stderr. Capture both streams.
+- Listing commands accept `--json` for structured output; prefer JSON when parsing.
+- The config DB is **SQLite**. You may open `~/.ppm/ppm.db` read-only for inspection — see [references/db-schema.md](references/db-schema.md).
+- Do NOT edit the config DB directly while the server is running; use `ppm config set` or the HTTP API.
+
+## Links
+
+- Complete CLI options, every subcommand → [references/cli-reference.md](references/cli-reference.md)
+- HTTP API routes (25+) → [references/http-api.md](references/http-api.md)
+- Config DB schema (runtime-generated from user's DB) → [references/db-schema.md](references/db-schema.md)
+- Worked recipes for common tasks → [references/common-tasks.md](references/common-tasks.md)
+
+## Error Handling
+
+- Server not running → `ppm status` exits non-zero; start with `ppm start`.
+- Port conflict → `ppm config set port <n>` then `ppm restart`.
+- Missing config DB → `ppm init` creates defaults.
+- Upgrade failure → re-run `ppm upgrade` or `npm i -g @hienlh/ppm@latest`.
+
+## Scope Boundaries
+
+This skill covers the `ppm` CLI, its HTTP API, and its config DB. It does **not** cover:
+- Projects managed by PPM (those are user code, outside skill scope).
+- Third-party extensions (inspect via `ppm ext list`).
+- The Claude Agent SDK internals (separate skill).
+
+<!-- Generated for PPM v0.13.2 at build time. Re-run `ppm export skill --install` to refresh. -->