@hienlh/ppm 0.12.11 → 0.13.0

package/assets/skills/ppm/references/common-tasks.md

@@ -0,0 +1,139 @@
+# PPM Common Tasks
+
+Practical recipes for controlling PPM. Prefer these stable shell invocations over HTTP unless the user has specifically asked for HTTP.
+
+## Task 1: Confirm PPM is running
+
+```bash
+ppm status --json
+```
+
+Non-zero exit = server not running. Use `ppm status` (no flag) for a human-readable view.
+
+## Task 2: Start the server
+
+```bash
+# Default port (from config, usually 8080)
+ppm start
+
+# Override port
+ppm start --port 9090
+
+# Use dev DB profile (port 8081, ~/.ppm/ppm.dev.db)
+ppm start --profile dev
+```
+
+## Task 3: Register a project
+
+```bash
+# Add the current directory
+ppm projects add "$PWD"
+
+# List registered projects as JSON
+ppm projects list --json
+```
+
+## Task 4: Add and test a database connection
+
+```bash
+# Interactive add
+ppm db add
+
+# Non-interactive (check `ppm db add --help` for full flag list)
+ppm db add --name staging --type postgres --host db.example.com --port 5432 --user app --database myapp
+
+# Test the connection
+ppm db test staging
+```
+
+## Task 5: Query a saved DB connection
+
+```bash
+# Run a SQL query against a registered connection
+ppm db query staging "SELECT count(*) AS total FROM users"
+
+# Output as JSON for scripting
+ppm db query staging "SELECT id, email FROM users LIMIT 10" --json
+```
+
+## Task 6: Read or change config
+
+```bash
+# Read a value
+ppm config get port
+ppm config get auth.enabled
+
+# Set a value (takes effect on next restart)
+ppm config set port 9090
+ppm config set auth.enabled true
+
+# List all keys
+ppm config list
+```
+
+## Task 7: Tail the daemon log
+
+```bash
+# Last 100 lines
+ppm logs --tail 100
+
+# Follow live
+ppm logs -f
+
+# Clear the log
+ppm logs --clear
+```
+
+## Task 8: Upgrade PPM
+
+```bash
+# Check for a new version without installing
+ppm upgrade --check
+
+# Install the latest
+ppm upgrade
+```
+
+## Task 9: Manage auto-start on boot
+
+```bash
+ppm autostart enable              # register
+ppm autostart status --json       # inspect
+ppm autostart disable             # unregister
+```
+
+## Task 10: Inspect installed skills
+
+```bash
+ppm skills list
+ppm skills list --json
+```
+
+## HTTP API Quick Calls
+
+Assume `PPM_BASE=http://localhost:8080`. See [http-api.md](http-api.md) for full list.
+
+```bash
+# List projects over HTTP
+curl -s $PPM_BASE/api/projects | jq
+
+# List DB connections
+curl -s $PPM_BASE/api/db/connections | jq
+
+# Get server status (via CLI is easier; HTTP equivalent varies)
+```
+
+## Troubleshooting
+
+| Symptom | Check |
+|---|---|
+| `ppm: command not found` | Ensure `npm i -g @hienlh/ppm` ran; check `$PATH` includes npm bin. |
+| Server won't start | `ppm logs --tail 50`; check port conflict with `lsof -i :8080`. |
+| Stale tunnel URL | `ppm restart --force`. |
+| Auth prompts unexpected | `ppm config get auth.enabled`; toggle with `ppm config set auth.enabled false`. |
+
+## Exit Code Convention
+
+- `0` — success
+- `1` — generic error (IO, validation, server not running)
+- `2` — asset/setup missing (e.g. bundled skill assets)

package/assets/skills/ppm/references/http-api.md

@@ -0,0 +1,204 @@
+# PPM HTTP API
+
+_Auto-generated. Do not edit._
+
+_Base URL: `http://localhost:8080` (default; override via `ppm config set port <n>`)._
+
+## /
+
+- `GET    *`
+
+## /api/accounts
+
+- `GET    /api/accounts`
+- `GET    /api/accounts/active`
+- `GET    /api/accounts/settings`
+- `PUT    /api/accounts/settings`
+- `POST   /api/accounts`
+- `GET    /api/accounts/oauth/start`
+- `GET    /api/accounts/oauth/url`
+- `POST   /api/accounts/oauth/exchange`
+- `GET    /api/accounts/oauth/callback`
+- `POST   /api/accounts/oauth/refresh/:id`
+- `POST   /api/accounts/export`
+- `POST   /api/accounts/import`
+- `GET    /api/accounts/usage`
+- `GET    /api/accounts/:id/usage`
+- `GET    /api/accounts/:id/usage-history`
+- `POST   /api/accounts/:id/verify`
+- `POST   /api/accounts/test-export`
+- `POST   /api/accounts/test-raw-token`
+- `POST   /api/accounts/:id/test-token`
+- `DELETE /api/accounts/:id`
+- `PATCH  /api/accounts/:id`
+
+## /api/cloud
+
+- `GET    /api/cloud/status`
+- `GET    /api/cloud/cloud_url`
+- `POST   /api/cloud/login`
+- `GET    /api/cloud/cloud_url`
+- `POST   /api/cloud/logout`
+- `POST   /api/cloud/link`
+- `POST   /api/cloud/unlink`
+- `GET    /api/cloud/login-url`
+- `GET    /api/cloud/cloud_url`
+
+## /api/db
+
+- `GET    /api/db/connections`
+- `GET    /api/db/connections/export`
+- `POST   /api/db/connections/import`
+- `GET    /api/db/connections/:id`
+- `POST   /api/db/connections`
+- `PUT    /api/db/connections/:id`
+- `DELETE /api/db/connections/:id`
+- `POST   /api/db/test`
+- `POST   /api/db/connections/:id/test`
+- `GET    /api/db/connections/:id/tables`
+- `GET    /api/db/connections/:id/schema`
+- `GET    /api/db/connections/:id/data`
+- `POST   /api/db/connections/:id/query`
+- `PUT    /api/db/connections/:id/cell`
+- `DELETE /api/db/connections/:id/row`
+- `POST   /api/db/connections/:id/rows/delete`
+- `POST   /api/db/connections/:id/row`
+- `GET    /api/db/connections/:id/export`
+- `GET    /api/db/search`
+
+## /api/extensions
+
+- `GET    /api/extensions`
+- `GET    /api/extensions/contributions`
+- `GET    /api/extensions/:id{.+}`
+- `POST   /api/extensions/install`
+- `POST   /api/extensions/dev-link`
+- `DELETE /api/extensions/:id{.+}`
+- `PATCH  /api/extensions/:id{.+}`
+
+## /api/fs
+
+- `GET    /api/fs/browse`
+- `GET    /api/fs/list`
+- `GET    /api/fs/read`
+- `GET    /api/fs/raw`
+- `DELETE /api/fs/rmdir`
+- `POST   /api/fs/mkdir`
+- `PUT    /api/fs/write`
+
+## /api/postgres
+
+- `POST   /api/postgres/test`
+- `POST   /api/postgres/tables`
+- `POST   /api/postgres/schema`
+- `POST   /api/postgres/data`
+- `POST   /api/postgres/query`
+- `POST   /api/postgres/cell`
+
+## /api/preview
+
+- `POST   /api/preview/tunnel`
+- `DELETE /api/preview/tunnel/:port{[0-9]+}`
+- `GET    /api/preview/tunnels`
+
+## /api/projects
+
+- `GET    /api/projects`
+- `POST   /api/projects`
+- `GET    /api/projects/suggest-dirs`
+- `PATCH  /api/projects/reorder`
+- `GET    /api/projects/projects`
+- `PATCH  /api/projects/:name/color`
+- `GET    /api/projects/projects`
+- `GET    /api/projects/:name/settings`
+- `GET    /api/projects/projects`
+- `PATCH  /api/projects/:name/settings`
+- `GET    /api/projects/projects`
+- `PATCH  /api/projects/:name`
+- `DELETE /api/projects/:name`
+
+## /api/push
+
+- `GET    /api/push/vapid-key`
+- `POST   /api/push/subscribe`
+- `DELETE /api/push/subscribe`
+
+## /api/settings
+
+- `PUT    /api/settings/device-name`
+- `GET    /api/settings/theme`
+- `GET    /api/settings/theme`
+- `PUT    /api/settings/theme`
+- `GET    /api/settings/ai`
+- `GET    /api/settings/ai`
+- `PUT    /api/settings/ai`
+- `GET    /api/settings/ai`
+- `GET    /api/settings/ai/providers/:id/models`
+- `GET    /api/settings/keybindings`
+- `PUT    /api/settings/keybindings`
+- `GET    /api/settings/telegram`
+- `GET    /api/settings/telegram`
+- `PUT    /api/settings/telegram`
+- `GET    /api/settings/telegram`
+- `POST   /api/settings/telegram/test`
+- `GET    /api/settings/telegram`
+- `PUT    /api/settings/auth/password`
+- `GET    /api/settings/auth`
+- `GET    /api/settings/port`
+- `GET    /api/settings/proxy`
+- `PUT    /api/settings/proxy`
+- `GET    /api/settings/clawbot`
+- `GET    /api/settings/clawbot`
+- `PUT    /api/settings/clawbot`
+- `GET    /api/settings/clawbot`
+- `GET    /api/settings/clawbot/paired`
+- `POST   /api/settings/clawbot/paired/approve`
+- `DELETE /api/settings/clawbot/paired/:chatId`
+- `GET    /api/settings/clawbot/memories`
+- `DELETE /api/settings/clawbot/memories/:id`
+- `GET    /api/settings/files`
+- `PATCH  /api/settings/files`
+- `GET    /api/settings/clawbot/tasks`
+
+## /api/settings/mcp
+
+- `GET    /api/settings/mcp`
+- `GET    /api/settings/mcp/import/preview`
+- `POST   /api/settings/mcp/import`
+- `GET    /api/settings/mcp/:name`
+- `POST   /api/settings/mcp`
+- `PUT    /api/settings/mcp/:name`
+- `DELETE /api/settings/mcp/:name`
+
+## /api/teams
+
+- `GET    /api/teams`
+- `GET    /api/teams/:name`
+- `DELETE /api/teams/:name`
+
+## /api/tunnel
+
+- `GET    /api/tunnel`
+- `GET    /api/tunnel/port`
+- `POST   /api/tunnel/start`
+- `GET    /api/tunnel/port`
+- `POST   /api/tunnel/stop`
+
+## /api/upgrade
+
+- `GET    /api/upgrade`
+- `POST   /api/upgrade/apply`
+
+## /proxy
+
+- `POST   /proxy/v1/messages`
+- `POST   /proxy/v1/chat/completions`
+- `POST   /proxy/v1/messages/count_tokens`
+
+## WebSocket
+
+- `ws://<host>/ws/chat` — AI chat stream (Claude Agent SDK)
+- `ws://<host>/ws/terminal` — PTY terminal multiplexer
+- `ws://<host>/ws/extensions` — extension host channel
+
+<!-- Generated from src/server/routes/ for PPM v0.13.0 -->