@hienlh/ppm 0.12.11 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [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 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
 
 ### Fixed

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.0 at build time. Re-run `ppm export skill --install` to refresh. -->