hammoc 1.4.0 → 1.5.0

package/packages/server/resources/manual/16-troubleshooting.md

@@ -0,0 +1,110 @@
+## 16. Troubleshooting
+
+### 16.1 "Claude Code CLI not found"
+
+Claude Code CLI must be installed and in your PATH:
+
+```bash
+claude --version
+```
+
+If not installed, follow the [Claude Code documentation](https://docs.anthropic.com/en/docs/claude-code). The Onboarding page shows CLI installation, authentication, and API key status at a glance.
+
+### 16.2 "Authentication required" / `claude login`
+
+If the chat displays an authentication error, Claude Code CLI needs to be logged in:
+
+```bash
+claude login
+```
+
+The Onboarding page (shown when CLI is not authenticated) displays the current auth status and provides setup commands.
+
+### 16.3 API rate limit exceeded
+
+When Anthropic API rate limits are reached, the chat shows a rate limit error with a retry delay. Solutions:
+
+1. Wait for the indicated retry period and try again
+2. Reduce concurrent sessions or shorten prompts
+3. Check your API usage / plan limits on the Anthropic console
+4. The header status indicator shows API health (yellow triangle = API unavailable)
+
+### 16.4 "Connection lost" / Reconnecting
+
+Hammoc automatically reconnects when the connection is lost. The header shows a status indicator: green (connected), yellow spinning (reconnecting), or red (disconnected with manual Reconnect button).
+
+On mobile, the app automatically recovers when returning from background.
+
+If the connection doesn't recover:
+
+1. Check that the server is still running
+2. Click the Reconnect button in the header (appears when disconnected)
+3. Refresh the browser
+4. Restart the server: `hammoc` or `npm start`
+
+### 16.5 Port already in use
+
+The server automatically retries when the port is in use. If it still fails:
+
+```bash
+hammoc --port 3001
+```
+
+Or set the environment variable: `PORT=3001 hammoc`
+
+### 16.6 Terminal not available
+
+Terminal may be disabled when:
+
+- Accessing from an external network (security restriction — only local IPs are allowed)
+- `TERMINAL_ENABLED=false` is set in environment
+- Maximum terminal sessions reached (default 10, configurable via `MAX_TERMINAL_SESSIONS`)
+
+### 16.7 Reset password
+
+If you forgot your password:
+
+```bash
+hammoc --reset-password
+```
+
+This prompts you to set a new password. Alternatively, delete `~/.hammoc/config.json` and restart the server to re-trigger the password setup flow in the browser.
+
+### 16.8 Chat timeout
+
+If Claude's responses are timing out:
+
+1. Go to **Settings > Global** and adjust the **Chat Timeout** dropdown
+2. Available values: 1 min, 3 min, 5 min (default), 10 min, 30 min
+3. Complex tasks (large codebases, multi-file edits) may need longer timeouts
+4. If the `CHAT_TIMEOUT_MS` environment variable is set, it overrides the UI setting (shown with an indicator)
+
+### 16.9 Large file warning
+
+Files over 1 MB display a truncation warning. Consider:
+
+- Using the terminal to view large files
+- Opening in an external editor
+- Breaking large files into smaller ones
+
+### 16.10 Data locations
+
+If you need to find or back up your data:
+
+| Data | Path |
+|------|------|
+| App config & password | `~/.hammoc/config.json` |
+| User preferences | `~/.hammoc/preferences.json` |
+| Queue templates | `<project-root>/.hammoc/queue-templates.json` (per project) |
+| Chain failures | `~/.hammoc/chain-failures/<sessionId>.json` (per session) |
+| Global snippets | `~/.hammoc/snippets/` (shared across all projects) |
+| Project snippets | `<project-root>/.hammoc/snippets/` (per project) |
+| Global harness items | `~/.claude/` (skills, agents, commands, hooks, `CLAUDE.md`, `.mcp.json`, `settings.json`) |
+| Project harness items | `<project-root>/.claude/` (same layout as global; project takes precedence) |
+| Session data | `~/.claude/projects/` |
+| Web Push VAPID keys | `~/.hammoc/vapid-keys.json` |
+| Web Push subscriptions | `~/.hammoc/push-subscriptions.json` |
+| TLS certificates | `~/.hammoc/key.pem`, `~/.hammoc/cert.pem` |
+| Manual shards (synced) | `~/.hammoc/docs/manual/` and `~/.hammoc/docs/.manual-version` (auto-synced from the npm package on server boot; agents read these via the absolute path embedded in the system prompt) |
+| Internals docs (synced) | `~/.hammoc/docs/internals/` (agent-only mechanism reference; also re-synced when the package version changes) |
+| Server logs | `./logs/server-YYYY-MM-DD.log` (daily log files in working directory) |

package/packages/server/resources/manual/INDEX.md

@@ -0,0 +1,60 @@
+# Hammoc Manual Index (Sharded)
+
+This is a sharded mirror of `docs/MANUAL.md`, generated by `npm run build:manual-shards`.
+Each chapter lives in its own file so an agent can load only the part it needs instead of the full ~31k-token manual.
+
+## How to use this index
+
+1. Skim the chapter list below to find the topic that matches the current task.
+2. Check the audience tag — `[agent]` chapters are the ones written for an automated assistant to act on; `[user-setup]` chapters are reference material for the human operator and rarely help an agent.
+3. Read the chapter file you need with the file Read tool. Don't load the whole manual at once.
+
+When the user mentions a Hammoc-specific concept (queue, snippet, board, BMad agent, project, session, etc.) and you are not sure how the feature behaves, the matching chapter below is the source of truth — read it before guessing or improvising.
+
+## Chapters
+
+<!-- chapter-list:start -->
+- 1. [Getting Started](./01-getting-started.md)
+- 2. [Chat](./02-chat.md)
+- 3. [Sessions](./03-sessions.md)
+- 4. [Slash Commands & Favorites](./04-slash-commands-favorites.md)
+- 5. [Projects](./05-projects.md)
+- 6. [File Explorer & Editor](./06-file-explorer-editor.md)
+- 7. [Git](./07-git.md)
+- 8. [Terminal](./08-terminal.md)
+- 9. [Queue Runner](./09-queue-runner.md)
+- 10. [Project Board](./10-project-board.md)
+- 11. [BMAD-METHOD Integration](./11-bmad-method-integration.md)
+- 12. [Harness Workbench](./12-harness-workbench.md)
+- 13. [Settings](./13-settings.md)
+- 14. [Keyboard Shortcuts](./14-keyboard-shortcuts.md)
+- 15. [Environment Variables](./15-environment-variables.md)
+- 16. [Troubleshooting](./16-troubleshooting.md)
+<!-- chapter-list:end -->
+
+## Audience and trigger keywords
+
+| # | Chapter | Audience | Read when the user mentions / asks about |
+|---|---|---|---|
+| 1 | Getting Started | `[user-setup]` | Hammoc install, CLI flags, HTTPS / TLS, mobile access, reverse proxy. (Operator setup; rarely useful to an agent.) |
+| 2 | Chat | `[agent]` | streaming, message edit, conversation fork / branching, summarize & continue, code rewind, prompt chaining, extended thinking, model selector, thinking effort, context usage, abort behaviour |
+| 3 | Sessions | `[agent]` | session list, session search, rename / delete, quick session panel, active streaming indicator |
+| 4 | Slash Commands & Favorites | `[agent]` **(important)** | `/` slash commands, `%` snippets, snippet arguments and context blocks, multi-prompt snippets, snippet hierarchy (project / global / bundled), star palette, favorites |
+| 5 | Projects | `[agent]` | project list, project creation (with optional BMad init), per-project settings, project overview page, hide / delete projects |
+| 6 | File Explorer & Editor | `[user-setup]` | UI panel that the user operates by hand. The agent uses Read / Write / Edit tools directly instead. |
+| 7 | Git | `[user-setup]` | UI panel for staging / committing / branching. The agent uses git via Bash directly. |
+| 8 | Terminal | `[user-setup]` | UI terminal panel. The agent uses Bash / PowerShell tools directly. |
+| 9 | Queue Runner | `[agent]` **(important)** | queue editor, special commands (`@new`, `@save`, `@load`, `@pause`, `@model`, `@delay`, `@pauseword`, `@loop` / `@end`, `@(` / `@)`, `#` comments), multiline prompts, pauseword, loop blocks, templates, session locking, story-based generation, variable substitution |
+| 10 | Project Board | `[agent]` | Kanban / list view, issue types (Bug / Improvement), severity (Low / Medium / High / Critical), status workflow (Open → Draft → Approved → In Progress → Blocked → Review → Done → Closed), card context menu, attachments |
+| 11 | BMAD-METHOD Integration | `[agent]` **(important)** | BMad agents (SM, PM, Architect, Dev, QA, PO, etc.), agent switching, `.bmad-core` setup, PRD → Queue automation, project overview dashboard, workflow phases, story workflows |
+| 12 | Harness Workbench | `[agent]` **(important)** | Editing `.claude/` items (skills, MCP, hooks, slash commands, sub-agents, `CLAUDE.md`), Hammoc `%snippets` and command favorites, share badges / mode banner, static lint, secret-on-shared guard. Also see the on-disk layout in `~/.hammoc/docs/internals/harness-files.md`. |
+| 13 | Settings | `[mixed]` | Read individual subsections only. `[agent]`-relevant: System Prompt (13.15), Default Permission Mode (13.4), Default Model (13.3), Default Thinking Effort (13.10), Advanced Settings (13.16). Per-project overrides now live with the project (see chapter 5.3 / chapter 12). The rest is `[user-setup]`. |
+| 14 | Keyboard Shortcuts | `[user-setup]` | Reference table for the human operator. The agent does not press keys. |
+| 15 | Environment Variables | `[user-setup]` | Server / Vite env vars for operator configuration. |
+| 16 | Troubleshooting | `[user-setup]` | Operator-facing diagnosis recipes (CLI not found, auth, port in use, etc.). |
+
+## Notes for maintainers
+
+- `docs/MANUAL.md` is the single source of truth. Edit it, then run `npm run build:manual-shards` to regenerate the chapter files. The chapter-list block above is auto-updated; everything else in this file is hand-maintained.
+- The audience table above is **manually curated**. When you add a new chapter, decide whether it is `[agent]`, `[user-setup]`, or `[mixed]` and add a row.
+- Shards are packaged into the npm tarball under `packages/server/resources/manual/` and synced to `~/.hammoc/docs/manual/` on Hammoc server boot, so any user environment running Hammoc can read this index.

package/packages/shared/dist/index.d.ts

@@ -24,4 +24,7 @@ export * from './types/terminal.js';
 export * from './types/dashboard.js';
 export * from './types/board.js';
 export { LogLevel, parseLogLevel } from './types/logger.js';
+export * from './types/harness.js';
+export { splitMarkdownByH2, appendMarkdownSections, MarkdownH2Section, } from './utils/markdownSections.js';
+export * from './types/harnessBundle.js';
 //# sourceMappingURL=index.d.ts.map

package/packages/shared/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAG/B,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AAIrC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EACL,UAAU,EACV,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAIrF,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,4BAA4B,EAC5B,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG9F,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,2BAA2B,EAC3B,6BAA6B,EAC7B,eAAe,EACf,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,cAAc,uBAAuB,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG/E,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAG/F,cAAc,gBAAgB,CAAC;AAG/B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC;AAG/B,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AAIrC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,gBAAgB,CAAC;AAG/B,OAAO,EACL,UAAU,EACV,wBAAwB,EACxB,mBAAmB,EACnB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,cAAc,EACd,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAIrF,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,eAAe,EACf,4BAA4B,EAC5B,0BAA0B,EAC1B,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAG9F,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,2BAA2B,EAC3B,6BAA6B,EAC7B,eAAe,EACf,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAG5B,cAAc,uBAAuB,CAAC;AAGtC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG/E,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAG/F,cAAc,gBAAgB,CAAC;AAG/B,cAAc,qBAAqB,CAAC;AAGpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG5D,cAAc,oBAAoB,CAAC;AAGnC,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,6BAA6B,CAAC;AAGrC,cAAc,0BAA0B,CAAC"}

package/packages/shared/dist/index.js

@@ -45,4 +45,10 @@ export * from './types/dashboard.js';
 export * from './types/board.js';
 // Logger types (shared between server and client)
 export { LogLevel, parseLogLevel } from './types/logger.js';
+// Story 28.0.5: Harness workbench shared types (Epic 28 common infra)
+export * from './types/harness.js';
+// Story 29.1: Markdown H2 split/append helpers (shared by server & client)
+export { splitMarkdownByH2, appendMarkdownSections, } from './utils/markdownSections.js';
+// Story 30.3: Harness Export/Import bundle DTOs
+export * from './types/harnessBundle.js';
 //# sourceMappingURL=index.js.map

package/packages/shared/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,cAAc,gBAAgB,CAAC;AAE/B,+CAA+C;AAC/C,cAAc,sBAAsB,CAAC;AAErC,2CAA2C;AAC3C,cAAc,sBAAsB,CAAC;AAErC,4DAA4D;AAC5D,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AAErC,kDAAkD;AAClD,2FAA2F;AAC3F,cAAc,oBAAoB,CAAC;AAEnC,iDAAiD;AACjD,cAAc,gBAAgB,CAAC;AAE/B,mDAAmD;AACnD,OAAO,EAGL,mBAAmB,EACnB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,yBAAyB;AACzB,OAAO,EAKL,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,0CAA0C;AAC1C,OAAO,EAGL,gBAAgB,GAGjB,MAAM,iBAAiB,CAAC;AAEzB,iCAAiC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAKtD,gDAAgD;AAChD,kDAAkD;AAClD,OAAO,EAGL,cAAc,GAYf,MAAM,oBAAoB,CAAC;AAM5B,gDAAgD;AAChD,OAAO,EAIL,mBAAmB,EASnB,mBAAmB,GAEpB,MAAM,wBAAwB,CAAC;AAiBhC,qEAAqE;AACrE,cAAc,uBAAuB,CAAC;AAEtC,uDAAuD;AACvD,cAAc,uBAAuB,CAAC;AAEtC,iCAAiC;AACjC,cAAc,kBAAkB,CAAC;AAEjC,kCAAkC;AAClC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,uCAAuC;AACvC,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/F,kCAAkC;AAClC,cAAc,gBAAgB,CAAC;AAE/B,2CAA2C;AAC3C,cAAc,qBAAqB,CAAC;AAEpC,8BAA8B;AAC9B,cAAc,sBAAsB,CAAC;AAErC,oCAAoC;AACpC,cAAc,kBAAkB,CAAC;AAEjC,kDAAkD;AAClD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,cAAc,gBAAgB,CAAC;AAE/B,+CAA+C;AAC/C,cAAc,sBAAsB,CAAC;AAErC,2CAA2C;AAC3C,cAAc,sBAAsB,CAAC;AAErC,4DAA4D;AAC5D,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AAErC,kDAAkD;AAClD,2FAA2F;AAC3F,cAAc,oBAAoB,CAAC;AAEnC,iDAAiD;AACjD,cAAc,gBAAgB,CAAC;AAE/B,mDAAmD;AACnD,OAAO,EAGL,mBAAmB,EACnB,eAAe,GAChB,MAAM,iBAAiB,CAAC;AAEzB,yBAAyB;AACzB,OAAO,EAKL,YAAY,GACb,MAAM,iBAAiB,CAAC;AAEzB,0CAA0C;AAC1C,OAAO,EAGL,gBAAgB,GAGjB,MAAM,iBAAiB,CAAC;AAEzB,iCAAiC;AACjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAKtD,gDAAgD;AAChD,kDAAkD;AAClD,OAAO,EAGL,cAAc,GAYf,MAAM,oBAAoB,CAAC;AAM5B,gDAAgD;AAChD,OAAO,EAIL,mBAAmB,EASnB,mBAAmB,GAEpB,MAAM,wBAAwB,CAAC;AAiBhC,qEAAqE;AACrE,cAAc,uBAAuB,CAAC;AAEtC,uDAAuD;AACvD,cAAc,uBAAuB,CAAC;AAEtC,iCAAiC;AACjC,cAAc,kBAAkB,CAAC;AAEjC,kCAAkC;AAClC,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE/E,uCAAuC;AACvC,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAE/F,kCAAkC;AAClC,cAAc,gBAAgB,CAAC;AAE/B,2CAA2C;AAC3C,cAAc,qBAAqB,CAAC;AAEpC,8BAA8B;AAC9B,cAAc,sBAAsB,CAAC;AAErC,oCAAoC;AACpC,cAAc,kBAAkB,CAAC;AAEjC,kDAAkD;AAClD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAE5D,sEAAsE;AACtE,cAAc,oBAAoB,CAAC;AAEnC,2EAA2E;AAC3E,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GAEvB,MAAM,6BAA6B,CAAC;AAErC,gDAAgD;AAChD,cAAc,0BAA0B,CAAC"}

package/packages/shared/dist/types/command.d.ts

@@ -10,11 +10,11 @@ export interface SlashCommand {
     /** Brief description of what this command does */
     description?: string;
     /** Command category for grouping */
-    category: 'agent' | 'task' | 'builtin' | 'skill';
+    category: 'agent' | 'task' | 'builtin' | 'skill' | 'command';
     /** Agent icon emoji if available (from agent YAML) */
     icon?: string;
-    /** Skill scope — project-level or global (~/.claude/skills/) */
-    scope?: 'project' | 'global';
+    /** Source scope — project / global / plugin (skills + Story 28.5 commands). */
+    scope?: 'project' | 'global' | 'plugin';
 }
 /**
  * Star command definition parsed from agent YAML commands: section

package/packages/shared/dist/types/command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/types/command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IACjD,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAC5C,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB"}
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/types/command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IAC7D,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;CACzC;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,iEAAiE;IACjE,OAAO,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IAC5C,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB"}