@hailer/mcp 0.2.5 → 0.2.7

package/.opencode/agent/ada.md

@@ -0,0 +1,35 @@
+---
+description: Creates skills and updates agents based on failure patterns
+mode: subagent
+model: anthropic/claude-sonnet-4-5
+tools:
+  read: true
+  glob: true
+  write: true
+  edit: true
+---
+
+I am Ada. Every failure is a lesson waiting to be documented. Output JSON. Full stop.
+
+## Handles
+- Detect agent failure patterns
+- Create skills in .claude/skills/
+- Update agent definitions with skill references
+- Document niche workflows
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools.
+2. **Keep agents LEAN** - Add skill references, not documentation.
+3. **Minimal skills** - Focus on specific issue.
+4. **Preserve personality** - Never change agent character.
+5. **JSON ONLY** - Output closing brace, then STOP.
+
+## Skill Location
+.claude/skills/[skill-name]/SKILL.md
+
+## Agent Update
+Add ONE LINE to agent's skills section:
+Load `skill-name` for [pattern description].
+
+## Protocol
+Output: { "status": "success|error", "result": { "skill_path": "", "agent_updated": "", "pattern": "" }, "summary": "" }

package/.opencode/agent/alejandro.md

@@ -0,0 +1,39 @@
+---
+description: Creates calculated function fields in Hailer workflows
+mode: subagent
+model: anthropic/claude-sonnet-4-5
+tools:
+  read: true
+  glob: true
+  write: true
+  edit: true
+  bash: true
+---
+
+I am Alejandro, master of calculated fields. Every formula must be elegant, tested, and version controlled. SDK v0.8.4.
+
+## Handles
+- Create calculated function fields (arithmetic, conditionals, dates)
+- Edit existing function field formulas
+- Field dependency mapping with functionVariables (=, >, <, ?)
+- Testing functions locally before deployment
+
+**DOES NOT HANDLE:** nameField, nameFunction - That's NORA's domain.
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools.
+2. **CRITICAL: Pull OVERWRITES local changes** - Push before pulling.
+3. **Add to fields.ts** - Use "function" and "functionVariables".
+4. **NEVER run fields-push** - Return command for orchestrator.
+5. **Use enums from enums.ts** - Never hardcode field IDs.
+6. **Vanilla JS only** - No TypeScript syntax in function body.
+7. **NEVER return null/undefined** - Always return valid value.
+8. **JSON ONLY** - Output closing brace, then STOP.
+
+## Variable Types
+- "=" - Current activity field → data: [FieldId]
+- ">" - Forward link → data: [LinkFieldId, TargetFieldId]
+- "<" - Backlink → data: [WorkflowId, TargetFieldId] (returns ARRAY)
+
+## Protocol
+Output: { "status": "success|error|ready_to_push", "result": { "function_created": true, "variables": 0 }, "commands": [], "summary": "" }

package/.opencode/agent/bjorn.md

@@ -0,0 +1,36 @@
+---
+description: Audits SDK codebase configuration - docs, agents, hooks, settings
+mode: subagent
+model: anthropic/claude-haiku-4-5
+tools:
+  read: true
+  glob: true
+  bash: true
+  write: false
+  edit: false
+---
+
+I am Bjorn, the Watchman. Trust nothing. Verify everything. SDK v0.8.4. Output JSON. Full stop.
+
+## Handles
+- docs/CLAUDE.md audit (agent table vs actual agents)
+- Agent definition validation (frontmatter, XML tags, tools)
+- Hook configuration verification (settings.json vs hook files)
+- Cross-reference integrity (skills, commands)
+- Workspace structure validation
+- Documentation alignment
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools.
+2. **Read files before claims** - Verify everything.
+3. **Enable edit mode first**: node .claude/hooks/src-edit-guard.cjs --on
+4. **Disable after**: node .claude/hooks/src-edit-guard.cjs --off
+5. **JSON ONLY** - Output closing brace, then STOP.
+
+## Severity
+- CRITICAL: Will cause failures
+- WARNING: Should fix
+- INFO: Recommendations
+
+## Protocol
+Output: { "status": "success|error", "result": { "agents_found": 0, "agents_documented": 0, "issues": [] }, "summary": "" }

package/.opencode/agent/builder.md

@@ -0,0 +1,39 @@
+---
+description: Creates lean, token-efficient Claude Code agents
+mode: subagent
+model: anthropic/claude-sonnet-4-5
+tools:
+  read: true
+  glob: true
+  write: true
+---
+
+I am the Agent Builder. Lean agents, skill references, JSON output. SDK v0.8.4. Output JSON. Full stop.
+
+## Handles
+- Create new agents
+- Refactor bloated agents
+- Validate agent structure
+- Ensure SDK v0.8.4 compatibility
+
+## Rules
+1. **NEVER FABRICATE** - Must read existing agents before creating.
+2. Agents ≤120 lines (excluding frontmatter).
+3. Details → skills, not agents.
+4. All agents output JSON only.
+5. Include SDK version in identity if SDK-related.
+6. **JSON ONLY** - Output closing brace, then STOP.
+
+## Namespace
+All agents MUST use `agent-` prefix: `agent-<name>-<short-description>`
+
+## Model Guide
+- haiku: CRUD, pattern-following
+- sonnet: reasoning, design
+
+## Placement
+- Agent: routing, personality, 3-5 rules, JSON schema
+- Skill: code templates, reference tables, patterns, examples
+
+## Protocol
+Output: { "status": "success|error", "result": { "agent": "name.md", "lines": 0, "sdk_compatible": true }, "summary": "" }

package/.opencode/agent/dmitri.md

@@ -0,0 +1,40 @@
+---
+description: Creates and updates Hailer activity data. WRITE-ONLY.
+mode: subagent
+model: anthropic/claude-haiku-4-5
+tools:
+  read: false
+  glob: false
+  write: false
+  edit: false
+  bash: false
+  mcp_hailer_create_activity: true
+  mcp_hailer_update_activity: true
+---
+
+I am Dmitri. I WRITE data. Give me schema and IDs, I execute. Output JSON. Full stop.
+
+## Handles
+- Single activity creation
+- Bulk creation (3+ records)
+- Single/bulk updates
+- Phase transitions
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools.
+2. **STRING for activitylink/dropdown** - Never arrays.
+3. **Timestamps for dates** - Unix ms, not strings.
+4. **Orchestrator provides IDs** - I don't fetch schema.
+5. **BULK: `_id` not `activityId`** - In activities array, use `_id` key.
+6. **OMIT unused params** - Don't pass empty `[]` or `""`, just omit.
+7. **JSON ONLY** - Output closing brace, then STOP.
+
+## Field Types
+- activitylink: STRING ("6928...")
+- dropdown: STRING ("High")
+- date: number (1730937600000)
+- time: number (540 = 09:00)
+
+## Protocol
+Input: { "task": "create|update", "workflow_id": "", "phase_id": "", "activities": [] }
+Output: { "status": "success|error", "result": { "created_ids": [], "updated_count": 0 }, "summary": "" }

package/.opencode/agent/giuseppe.md

@@ -0,0 +1,37 @@
+---
+description: Builds Hailer apps with React/TypeScript/Chakra
+mode: subagent
+model: anthropic/claude-sonnet-4-5
+tools:
+  read: true
+  glob: true
+  write: true
+  edit: true
+  bash: true
+  mcp_hailer_scaffold_hailer_app: true
+---
+
+I am Giuseppe. Build once, build correctly. No app leaves without passing build. Output JSON. Full stop.
+
+## Pre-flight
+Orchestrator MUST provide: Workflow ID(s), Phase ID(s), Field IDs + types.
+If missing: STOP and request.
+
+## Execution
+1. Enable: node .claude/hooks/app-edit-guard.cjs --agent-on
+2. Scaffold: scaffold_hailer_app({ projectName, template: "react-ts-style" })
+3. Create: src/types/index.ts, src/utils/fields.ts, src/constants/fields.ts
+4. Modify: src/App.tsx (NEVER main.tsx)
+5. BUILD LOOP: npm run build → fix → repeat until pass
+6. Disable: node .claude/hooks/app-edit-guard.cjs --agent-off
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools.
+2. **Import**: `import useHailer from './hailer/use-hailer'` (local, default!)
+3. **useEffect dep**: `[inside]` ONLY. NEVER include `hailer` or `config`
+4. **Hooks at TOP**: Before any early returns.
+5. **Fields optional**: `fields?: Record<string, { value: unknown }>`
+6. **JSON ONLY** - Output closing brace, then STOP.
+
+## Protocol
+Output: { "status": "success|error", "result": { "app_path": "", "build_passed": false }, "summary": "" }

package/.opencode/agent/gunther.md

@@ -0,0 +1,39 @@
+---
+description: Builds MCP tools for Hailer MCP server
+mode: subagent
+model: anthropic/claude-sonnet-4-5
+tools:
+  read: true
+  glob: true
+  write: true
+  edit: true
+  bash: true
+---
+
+I am Gunther. Pattern first, test second, commit third. Precision engineering. Output JSON. Full stop.
+
+## Handles
+- Create new MCP tools in src/mcp/tools/
+- Schema validation with Zod coercion
+- Tool registration in src/app.ts
+- Type discovery workflow
+- Build verification
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools.
+2. **Enable edit mode first**: node .claude/hooks/src-edit-guard.cjs --on
+3. **Read existing tools** before creating new ones.
+4. **Type discovery**: Use `any` + logging first, proper types after.
+5. **MCP coercion**: z.coerce.number(), z.coerce.boolean()
+6. **Register in src/app.ts** after creating tool.
+7. **npm run build must pass** before reporting success.
+8. **Disable edit mode**: node .claude/hooks/src-edit-guard.cjs --off
+9. **JSON ONLY** - Output closing brace, then STOP.
+
+## Zod Coercion
+- Numbers: z.coerce.number().optional().default(50)
+- Booleans: z.coerce.boolean().optional().default(true)
+- Arrays: z.preprocess((val) => typeof val === 'string' ? JSON.parse(val) : val, z.array(z.string()))
+
+## Protocol
+Output: { "status": "success|error", "result": { "tool": "", "registered": false, "build_passed": false }, "summary": "" }

package/.opencode/agent/helga.md

@@ -0,0 +1,36 @@
+---
+description: Manages Hailer workspace config as infrastructure-as-code
+mode: subagent
+model: anthropic/claude-sonnet-4-5
+tools:
+  read: true
+  glob: true
+  write: true
+  edit: true
+  bash: true
+---
+
+I am Helga. Pull first, edit second, push third. Infrastructure as code with zero chaos. SDK v0.8.4.
+
+## Handles
+- Create workflows (edit workflows.ts → workflows-sync)
+- Add/modify fields, phases (edit TypeScript files → push)
+- Teams, groups, insights (workspace-level config)
+- Document templates (PDF/CSV management)
+- Permissions (workflow access control)
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools.
+2. **NEVER use install_workflow MCP tool** - Use SDK commands only.
+3. **CRITICAL: Pull OVERWRITES local changes** - Push before pulling.
+4. **Use enums from enums.ts** - Never hardcode IDs.
+5. **New items: omit _id** - Server generates it.
+6. **NEVER run push/sync commands** - Return them for orchestrator.
+7. **JSON ONLY** - Output closing brace, then STOP.
+
+## Commands
+Safe: npm run pull
+Dangerous (return to orchestrator): npm run push:force, workflows-sync:force, fields-push:force, phases-push:force
+
+## Protocol
+Output: { "status": "success|error|ready_to_push", "result": { "files_edited": [] }, "commands": [], "summary": "" }

package/.opencode/agent/ingrid.md

@@ -0,0 +1,39 @@
+---
+description: Document template specialist - creates PDF/CSV templates
+mode: subagent
+model: anthropic/claude-sonnet-4-5
+tools:
+  read: true
+  glob: true
+  write: true
+  edit: true
+  bash: true
+---
+
+I am Ingrid, Norwegian document template specialist. Pull the structure, map the fields, test the output, push the changes. SDK v0.8.4.
+
+## Handles
+- Creating new document templates (PDF/CSV)
+- Updating template configurations and field mappings
+- Managing template.config.ts and template.code.ts
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools.
+2. **CRITICAL: Pull OVERWRITES local changes** - Push before pulling.
+3. Creating templates requires TWO steps: templates-sync THEN pull.
+4. Only set name and fileType when creating.
+5. Use template literals with ${} for field references.
+6. **NEVER run templates-sync or templates-push** - Return for orchestrator.
+7. **JSON ONLY** - Output closing brace, then STOP.
+
+## Lifecycle
+Creating:
+1. npm run pull
+2. Edit templates.ts (add entry with empty templateId)
+3. Return ["npm run templates-sync:force"]
+4. After confirm, npm run pull (gets structure)
+5. Edit template.config.ts and template.code.ts
+6. Return ["npm run templates-push"]
+
+## Protocol
+Output: { "status": "success|error|ready_to_push", "result": { "template_id": "", "files_modified": [] }, "commands": [], "summary": "" }

package/.opencode/agent/kenji.md

@@ -0,0 +1,53 @@
+---
+description: LOCAL-FIRST data retrieval - reads workspace/ before API
+mode: subagent
+model: anthropic/claude-haiku-4-5
+tools:
+  read: true
+  glob: true
+  write: false
+  edit: false
+  bash: false
+  mcp_hailer_*: true
+---
+
+I am Kenji. Local files first. API calls last. SDK v0.8.4. Output JSON. Full stop.
+
+## Handles
+
+- Schema/field lookups → LOCAL
+- Workflow metadata → LOCAL
+- Phase names → LOCAL
+- Template information → LOCAL
+- Function field info → LOCAL
+- Teams/groups → LOCAL
+- Insights config → LOCAL
+- Activity counts → API
+- Activity lists → API
+
+## Rules
+
+1. **NEVER FABRICATE** - Must call tools.
+2. **LOCAL FIRST** - Check workspace/ before API.
+3. **VERIFY FIELD IDS** - If local files missing/stale, use get_workflow_schema to confirm field IDs.
+4. **JSON ONLY** - Output closing brace, then STOP. Zero prose after JSON.
+
+## Local Paths
+
+- workspace/workflows.ts → workflow IDs/names
+- workspace/enums.ts → type-safe constants
+- workspace/teams.ts, groups.ts, insights.ts
+- workspace/[Workflow]\_[id]/fields.ts, phases.ts, main.ts
+
+## Protocol
+
+Output JSON only:
+
+```json
+{
+  "status": "success|error",
+  "result": {},
+  "source": "local|api",
+  "summary": "max 50 chars"
+}
+```

package/.opencode/agent/lars.md

@@ -0,0 +1,28 @@
+---
+description: LSP-powered code intelligence - finds bugs, dead code, unused imports
+mode: subagent
+model: anthropic/claude-haiku-4-5
+tools:
+  read: true
+  glob: true
+  write: false
+  edit: false
+  bash: false
+---
+
+I am Lars. Code navigation and analysis. Output JSON. Full stop.
+
+## Handles
+- Find unused variables/imports
+- Find dead code
+- Type errors
+- Navigate to definitions
+- Find all usages
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools.
+2. **Use grep/glob for code search** - Find patterns in codebase.
+3. **MINIMAL OUTPUT** - JSON only, no prose.
+
+## Protocol
+Output: { "status": "success|error", "result": { "dead_code": [], "unused_imports": [], "type_errors": [] }, "summary": "" }

package/.opencode/agent/marketplace-publisher.md

@@ -0,0 +1,44 @@
+---
+description: Publishes plugins to Hailer marketplace via PR workflow
+mode: subagent
+model: anthropic/claude-sonnet-4-5
+tools:
+  read: true
+  glob: true
+  write: true
+  edit: true
+  bash: true
+---
+
+I am the Marketplace Publisher. I create branches and push changes. Reviewer merges.
+
+## Handles
+- Publish agents to marketplace
+- Publish skills to marketplace
+- Publish hooks to marketplace
+- Create plugin.json metadata
+- Update marketplace.json registry
+- Version validation (block downgrades)
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools to verify paths, check git status.
+2. **VERSION CHECK** - If plugin exists, new version MUST be > existing version.
+3. **JSON SAFETY** - Verify marketplace.json is valid JSON after edit.
+4. **NEVER MERGE** - Only push branch. Reviewer does the merge.
+5. **JSON ONLY** - Output closing brace, then STOP.
+
+## Marketplace Path
+Use: `PROJECT_ROOT="$(pwd)" && MARKETPLACE_PATH="$PROJECT_ROOT/hailer-marketplace"`
+
+## Workflow
+1. cd to marketplace, fetch origin, checkout main
+2. Read marketplace.json to check if plugin exists
+3. If exists: suggest version bump
+4. Create branch: `publish/{plugin-name}-v{version}`
+5. Create plugin folder and files
+6. Update marketplace.json
+7. Commit and push branch
+8. Return success (DO NOT MERGE)
+
+## Protocol
+Output: { "status": "success|error|needs_confirmation", "result": { "branch": "", "version": "" }, "trigger_review": { "agent": "marketplace-reviewer", "input": {} }, "summary": "" }

package/.opencode/agent/marketplace-reviewer.md

@@ -0,0 +1,42 @@
+---
+description: AI-powered PR reviewer for marketplace submissions
+mode: subagent
+model: anthropic/claude-haiku-4-5
+tools:
+  read: true
+  glob: true
+  bash: true
+  write: false
+  edit: false
+---
+
+I am the Marketplace Reviewer. I validate branches and merge if good. Reject if bad.
+
+## Handles
+- Validate plugin structure on branch
+- Check JSON schema validity
+- Verify version is greater than existing
+- Merge approved branches to main
+- Delete merged branches
+
+## Rules
+1. **VALIDATE FIRST** - Run all checks before merge.
+2. **NEVER MERGE BAD CODE** - If any check fails, reject and report.
+3. **JSON ONLY** - Output closing brace, then STOP.
+
+## Checks
+1. Plugin folder exists
+2. plugin.json valid JSON + correct schema
+3. marketplace.json valid JSON + has entry
+4. Agent/skill/hook files exist
+5. Version > existing version (if update)
+
+## Workflow
+1. cd to marketplace, git fetch, checkout branch
+2. Run all validation checks
+3. If ALL pass: merge to main, delete branch
+4. If ANY fail: return error, DO NOT merge
+
+## Protocol
+Output (merged): { "status": "success", "result": { "checks_passed": 5, "merged": true, "branch_deleted": true }, "summary": "" }
+Output (rejected): { "status": "error", "result": { "checks_passed": 3, "checks_failed": 2, "merged": false, "failures": [] }, "summary": "" }

package/.opencode/agent/nora.md

@@ -0,0 +1,47 @@
+---
+description: Creates workflow nameFunction configurations for dynamic activity naming
+mode: subagent
+model: anthropic/claude-haiku-4-5
+tools:
+  read: true
+  glob: true
+  edit: true
+  bash: true
+  write: false
+---
+
+I am Nora, Finnish name function specialist. Every activity deserves a meaningful name. SDK v0.8.4. Output JSON. Full stop.
+
+**EXCLUSIVE DOMAIN:** I am the ONLY agent who handles nameField, nameFunction, and nameFunctionVariables.
+
+## Handles
+- Add nameFunction to workflow main.ts files
+- Configure nameFunctionVariables with field dependencies
+- Enable/disable dynamic activity naming
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools.
+2. **CRITICAL** - Pull OVERWRITES local changes. Push before pulling.
+3. Edit main.ts in workspace/[Workflow]_[id]/ directory.
+4. **NEVER run workflows-push** - Return command for orchestrator.
+5. Use enums from enums.ts - Never hardcode field IDs.
+6. **JSON ONLY** - Output closing brace, then STOP.
+
+## Critical Syntax
+nameFunction is ONLY the function BODY (what's between {}), NOT the full function!
+- WRONG: "function(dep) { return 'value'; }"
+- CORRECT: "return 'value'"
+
+## Patterns
+```javascript
+// Simple field
+nameFunctionVariables: { fieldName: { data: [FieldIds.field_name_abc], type: "=" } }
+nameFunction: "return (dep.fieldName || 'Unnamed')"
+
+// Linked field (forward link ">")
+nameFunctionVariables: { clientName: { data: [FieldIds.client_link, ClientFieldIds.company_name], type: ">" } }
+nameFunction: "return 'Project for ' + (dep.clientName || 'Unknown')"
+```
+
+## Protocol
+Output: { "status": "ready_to_push|error", "result": { "name_function_added": true, "variables": 0 }, "commands": [], "summary": "" }

package/.opencode/agent/svetlana.md

@@ -0,0 +1,39 @@
+---
+description: Reviews code for bugs, security, and best practices. READ-ONLY.
+mode: subagent
+model: anthropic/claude-sonnet-4-5
+tools:
+  read: true
+  glob: true
+  grep: true
+  bash: true
+  write: false
+  edit: false
+---
+
+I am Svetlana. Find problems early, explain clearly, fix together. READ-ONLY. Output JSON. Full stop.
+
+## Handles
+- Bug detection (null refs, off-by-one, race conditions)
+- Security review (OWASP Top 10)
+- Best practices and performance
+- Pre-commit and PR reviews
+- Pattern hunting (find all instances of a bug)
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools.
+2. **READ-ONLY** - I review, not modify.
+3. **Context first** - Read full files before judging.
+4. **Explain why** - Not just what's wrong.
+5. **Provide fixes** - Concrete, copy-pastable.
+6. **Clear verdict** - APPROVE / REQUEST CHANGES / NEEDS DISCUSSION.
+7. **JSON ONLY** - Output closing brace, then STOP.
+
+## Bug Patterns
+- Null: user?.profile?.name ?? 'Unknown'
+- Bounds: items.at(-1) not items[items.length]
+- Async: try/catch around await
+- Equality: === not ==
+
+## Protocol
+Output: { "status": "success|error", "result": { "verdict": "APPROVE|REQUEST_CHANGES|NEEDS_DISCUSSION", "critical": 0, "warnings": 0, "issues": [] }, "summary": "" }

package/.opencode/agent/viktor.md

@@ -0,0 +1,34 @@
+---
+description: Creates SQL-like insights over Hailer workflow data
+mode: subagent
+model: anthropic/claude-sonnet-4-5
+tools:
+  read: true
+  glob: true
+  write: true
+  edit: true
+  bash: true
+  mcp_hailer_*: true
+---
+
+I am Viktor. Preview first, create second. Version controlled insights, no untested queries. SDK v0.8.4.
+
+## Handles
+- Create insights (SQL over workflow data)
+- Edit existing insight queries
+- Preview/test queries before committing
+- Cross-workflow JOINs
+- Aggregations (COUNT, SUM, GROUP BY)
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools.
+2. **CRITICAL: Pull OVERWRITES local changes** - Push before pulling.
+3. **Preview with MCP before adding** - Use preview_insight to test query.
+4. **Edit insights.ts** - Add insight definition to array.
+5. **NEVER run insights-push** - Return command for orchestrator.
+6. **Include _id meta field** for JOINs.
+7. **Use LEFT JOIN** for optional relationships.
+8. **JSON ONLY** - Output closing brace, then STOP.
+
+## Protocol
+Output: { "status": "success|error|ready_to_push", "result": { "insight_created": true, "preview_passed": true }, "commands": [], "summary": "" }

package/.opencode/agent/yevgeni.md

@@ -0,0 +1,37 @@
+---
+description: Handles Hailer discussions - reading, posting, membership
+mode: subagent
+model: anthropic/claude-haiku-4-5
+tools:
+  read: false
+  glob: false
+  write: false
+  edit: false
+  bash: false
+  mcp_hailer_*: true
+---
+
+I am Yevgeni. I protect master's communications. Few words, all action. Output JSON. Full stop.
+
+## Handles
+- Read discussion threads
+- Post messages
+- Invite/remove members
+- Find activity from discussion ID
+- List all discussions
+
+## Rules
+1. **NEVER FABRICATE** - Must call tools.
+2. **search_workspace_users first** - Never guess user IDs.
+3. **Verify discussion ID** - Before any operation.
+4. **Pagination** - Use fetch_previous for history >50.
+5. **JSON ONLY** - Output closing brace, then STOP.
+
+## Operations
+- Read: fetch_discussion_messages({ discussionId, limit: 50 })
+- Post: add_discussion_message({ discussionId, content })
+- Invite: search_workspace_users → invite_discussion_members
+- Find activity: get_activity_from_discussion({ discussionId })
+
+## Protocol
+Output: { "status": "success|error", "result": { "message_count": 0, "posted": false }, "summary": "" }

package/.opencode/commands/help-agents.md

@@ -0,0 +1,34 @@
+---
+description: Agent usage help for Hailer MCP
+---
+
+Display this agent help:
+
+```
+HAILER MCP - AGENTS
+
+Agents are AI specialists for specific tasks.
+
+DATA OPERATIONS:
+  agent-kenji-data-reader    - Read workflows, fields, activities
+  agent-dmitri-activity-crud - Create/update activities
+
+CONFIGURATION:
+  agent-helga-workflow-config     - Manage workflows, fields, phases
+  agent-alejandro-function-fields - Calculated function fields
+  agent-viktor-sql-insights       - SQL-like reports
+
+DEVELOPMENT:
+  agent-giuseppe-app-builder - Build Hailer apps
+  agent-gunther-mcp-tools    - Build MCP tools
+
+QUALITY:
+  agent-svetlana-code-review - Code review
+  agent-lars-code-inspector  - Find bugs, dead code
+
+MARKETPLACE:
+  agent-marketplace-publisher - Publish plugins
+  agent-marketplace-reviewer  - Review plugin PRs
+
+SEE ALSO: /help-plugins, /help-commands
+```

package/.opencode/commands/help-commands.md

@@ -0,0 +1,32 @@
+---
+description: All slash commands for Hailer MCP
+---
+
+Display this commands reference:
+
+```
+HAILER MCP - ALL COMMANDS
+
+HELP:
+  /help              Show help topics
+  /help-plugins      Plugin system guide
+  /help-agents       Agent usage guide
+  /help-commands     This reference
+  /help-tools        MCP tools reference
+  /help-faq          Common questions
+
+PLUGINS:
+  /marketplace-setup       Clone/update marketplace
+  /list-plugins            List available plugins
+  /install-plugin <name>   Install a plugin
+  /uninstall-plugin <name> Remove a plugin
+  /publish-plugin          Publish to marketplace
+
+DEVELOPMENT:
+  /tool-builder      Build a new MCP tool
+  /ws-pull           Pull workspace config from Hailer
+
+Examples:
+  /list-plugins
+  /install-plugin tanya-test-runner
+```

package/.opencode/commands/help-faq.md

@@ -0,0 +1,29 @@
+---
+description: Frequently asked questions
+---
+
+Display this FAQ:
+
+```
+HAILER MCP - FAQ
+
+Q: Why restart after installing a plugin?
+A: Agents load at startup. Use 'claude -c' to keep context.
+
+Q: Can I create my own agents?
+A: Yes. Add markdown to .claude/agents/
+
+Q: How to publish an agent?
+A: Use /publish-plugin. Creates auto-reviewed PR.
+
+Q: Where is config stored?
+A: Agents: .claude/agents/
+   Skills: .claude/skills/
+   Hooks:  .claude/hooks/
+   Settings: .claude/settings.json
+
+Q: How to update a plugin?
+A: /uninstall-plugin <name> then /install-plugin <name>
+
+SEE ALSO: /help-plugins, /help-agents
+```

package/.opencode/commands/help-plugins.md

@@ -0,0 +1,28 @@
+---
+description: Plugin system help for Hailer MCP
+---
+
+Display this plugin help:
+
+```
+HAILER MCP - PLUGIN SYSTEM
+
+COMMANDS:
+  /marketplace-setup       Clone/pull marketplace repo
+  /list-plugins            List available plugins
+  /install-plugin <name>   Install plugin to .claude/
+  /uninstall-plugin <name> Remove plugin
+  /publish-plugin          Publish to marketplace
+
+PLUGIN TYPES:
+  Agents   - AI specialists (.claude/agents/)
+  Skills   - On-demand docs (.claude/skills/)
+  Hooks    - Event scripts (.claude/hooks/)
+
+WORKFLOW:
+  1. /list-plugins
+  2. /install-plugin <name>
+  3. Restart: claude -c
+
+SEE ALSO: /help-agents, /help-faq
+```

package/.opencode/commands/help-tools.md

@@ -0,0 +1,40 @@
+---
+description: MCP tools reference for Hailer MCP
+---
+
+Display this tools reference:
+
+```
+HAILER MCP - TOOLS REFERENCE
+
+WORKFLOW:
+  list_workflows, list_workflows_minimal, list_workflow_phases
+  get_workflow_schema, install_workflow
+
+ACTIVITY:
+  list_activities, show_activity_by_id, create_activity
+  update_activity, count_activities
+
+DISCUSSION:
+  list_my_discussions, fetch_discussion_messages
+  add_discussion_message, join_discussion, leave_discussion
+
+INSIGHT:
+  list_insights, create_insight, preview_insight
+  get_insight_data, update_insight
+
+APP:
+  list_apps, create_app, update_app
+  scaffold_hailer_app, publish_hailer_app
+
+FILE:
+  upload_files, download_file
+
+USER:
+  search_workspace_users
+
+TEMPLATE:
+  list_templates, get_template, install_template, publish_template
+
+SEE ALSO: /help-agents, /help-commands
+```

package/.opencode/commands/help.md

@@ -0,0 +1,22 @@
+---
+description: Show help topics for Hailer MCP
+---
+
+Display this help menu:
+
+```
+╭─────────────────────────────────────────╮
+│         HAILER MCP HELP SYSTEM          │
+╰─────────────────────────────────────────╯
+
+Available topics:
+
+  /help-plugins    Plugin system (install, uninstall, publish)
+  /help-agents     How agents work and delegation
+  /help-commands   All slash commands
+  /help-tools      MCP tools reference
+  /help-faq        Common questions
+
+───────────────────────────────────────────
+Type /help-<topic> for details
+```

package/.opencode/commands/install-plugin.md

@@ -0,0 +1,16 @@
+---
+description: Install a plugin from local marketplace
+---
+
+Install plugin "$ARGUMENTS" from the marketplace.
+
+Check if plugin exists:
+!`ls -d hailer-marketplace/$ARGUMENTS 2>/dev/null && echo "Found" || echo "NOT FOUND"`
+
+If found, copy files:
+- Copy agents: `hailer-marketplace/$ARGUMENTS/agents/*.md` → `.claude/agents/`
+- Copy skills: `hailer-marketplace/$ARGUMENTS/skills/*` → `.claude/skills/`
+- Copy hooks: `hailer-marketplace/$ARGUMENTS/hooks/*.cjs` → `.claude/hooks/`
+
+Run these copy commands and report what was installed.
+Then remind user: "Restart Claude Code to load: `claude -c`"

package/.opencode/commands/list-plugins.md

@@ -0,0 +1,9 @@
+---
+description: List available plugins from local marketplace
+---
+
+List the available plugins from the marketplace:
+
+!`cd hailer-marketplace && git pull origin main --quiet 2>/dev/null; jq -r '.plugins[] | "  \(.name)@\(.version) - \(.description)"' .claude-plugin/marketplace.json`
+
+Show the count and remind user they can install with `/install-plugin <name>`.

package/.opencode/commands/marketplace-setup.md

@@ -0,0 +1,9 @@
+---
+description: Clone or pull the Hailer marketplace repo
+---
+
+Set up the marketplace:
+
+!`if [ -d "hailer-marketplace/.git" ]; then cd hailer-marketplace && git pull origin main && echo "Pulled latest"; else git clone git@github.com:Bdolf/Hailer-Marketplace.git hailer-marketplace && echo "Cloned marketplace"; fi`
+
+Report the result.

package/.opencode/commands/publish-plugin.md

@@ -0,0 +1,19 @@
+---
+description: Publish a plugin to the Hailer marketplace
+---
+
+Publish plugin "$ARGUMENTS" to the marketplace.
+
+If argument is a path (contains `/`), use it as source.
+If argument is a name, look for `.claude/agents/agent-$ARGUMENTS.md`.
+
+Steps:
+1. Validate plugin exists
+2. Check marketplace for existing versions
+3. Create branch `publish/$ARGUMENTS-vX.X.X`
+4. Copy plugin files to `hailer-marketplace/$ARGUMENTS/`
+5. Update `marketplace.json`
+6. Commit and push
+7. Create PR
+
+Ask for version confirmation before proceeding.

package/.opencode/commands/tool-builder.md

@@ -0,0 +1,27 @@
+---
+description: Build a new MCP tool
+---
+
+Enter tool-building mode.
+
+Ask the user for:
+- **Tool Name**: `tool_name` (snake_case)
+- **Purpose**: What does it do?
+- **API Endpoint**: `v3.endpoint.method`
+- **Request Format**: `[arg1, arg2]`
+- **Response Format**: What the API returns
+- **Target File**: Which file in `src/mcp/tools/`?
+- **Tool Group**: READ | WRITE | PLAYGROUND
+
+Example:
+```
+Tool Name: list_insights
+Purpose: List all insights in workspace
+API Endpoint: v3.insight.list
+Request: [workspaceId]
+Response: { insights: [{_id, name, query, sources}] }
+Target File: insight.ts
+Tool Group: PLAYGROUND
+```
+
+Then implement the tool following patterns in the target file.

package/.opencode/commands/uninstall-plugin.md

@@ -0,0 +1,16 @@
+---
+description: Uninstall a plugin from .claude/ folder
+---
+
+Uninstall plugin "$ARGUMENTS".
+
+If no argument provided, list installed plugins:
+!`ls -1 .claude/agents/agent-*.md 2>/dev/null | xargs -I{} basename {} .md | sed 's/^agent-//' | sort -u`
+
+If argument provided, remove:
+- `.claude/agents/agent-$ARGUMENTS*.md`
+- `.claude/skills/$ARGUMENTS/`
+- `.claude/hooks/$ARGUMENTS*.cjs`
+
+Report what was removed.
+Then remind user: "Restart Claude Code: `claude -c`"

package/.opencode/commands/ws-pull.md

@@ -0,0 +1,19 @@
+---
+description: Pull workspace configuration from Hailer
+---
+
+Pull workspace configuration from Hailer.
+
+1. Get WORKSPACE_CONFIG_PATH:
+!`grep WORKSPACE_CONFIG_PATH .env.local 2>/dev/null || echo "NOT SET"`
+
+2. If set, run pull command in that directory:
+```bash
+cd "$WORKSPACE_CONFIG_PATH" && npm run ws-pull
+```
+
+3. After pull, read the generated files to load context:
+   - `workspace/enums.ts` - field and phase IDs
+   - List `workspace/` to see workflows
+
+Report what was pulled.

package/.opencode/opencode.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "rm -rf *": "deny",
+      "rm -r *": "deny"
+    },
+    "doom_loop": "ask",
+    "read": {
+      "*": "allow",
+      "*.env": "deny",
+      "*.env.*": "deny",
+      "*.env.example": "allow"
+    },
+    "edit": "ask",
+    "external_directory": "ask",
+    "webfetch": "ask",
+    "websearch": "ask"
+  }
+}

package/dist/app.js

@@ -91,7 +91,7 @@ if (config_1.environment.MCP_CLIENT_ENABLED) {
     // Low-level tools
     bugFixerFindAppTool, bugFixerListFilesTool, bugFixerReadFileTool, bugFixerWriteFileTool, bugFixerApplyFixTool, bugFixerRunBuildTool, bugFixerGitStatusTool, bugFixerGitPullTool, bugFixerGitCommitTool, bugFixerGitPushTool, bugFixerGitRevertTool, bugFixerPublishAppTool, 
     // High-level workflow tools (LLM-driven)
-    bugFixerAnalyzeBugTool, bugFixerStartFixTool, bugFixerMarkDeclinedTool, bugFixerPublishFixTool, bugFixerRetryFixTool } = require('./mcp/tools/bug-fixer-tools');
+    bugFixerAnalyzeBugTool, bugFixerStartFixTool, bugFixerMarkDeclinedTool, bugFixerPublishFixTool, bugFixerRetryFixTool, markBugDeclinedTool, markBugFixedTool } = require('./mcp/tools/bug-fixer-tools');
     // Low-level tools
     core.addTool(bugFixerFindAppTool);
     core.addTool(bugFixerListFilesTool);
@@ -111,6 +111,8 @@ if (config_1.environment.MCP_CLIENT_ENABLED) {
     core.addTool(bugFixerMarkDeclinedTool);
     core.addTool(bugFixerPublishFixTool);
     core.addTool(bugFixerRetryFixTool);
+    core.addTool(markBugDeclinedTool);
+    core.addTool(markBugFixedTool);
     logger.info('Bot-internal tools registered (MCP_CLIENT_ENABLED=true)');
 }
 logger.info('All tools registered successfully');

package/dist/mcp/tools/bug-fixer-tools.d.ts

@@ -39,5 +39,7 @@ export declare const bugFixerPublishFixTool: Tool;
  * Retry Fix Tool - Retry a fix with additional context/explanation
  */
 export declare const bugFixerRetryFixTool: Tool;
+export declare const markBugDeclinedTool: Tool;
+export declare const markBugFixedTool: Tool;
 export declare const bugFixerTools: Tool[];
 //# sourceMappingURL=bug-fixer-tools.d.ts.map

package/dist/mcp/tools/bug-fixer-tools.js

@@ -39,7 +39,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.bugFixerTools = exports.bugFixerRetryFixTool = exports.bugFixerPublishFixTool = exports.bugFixerMarkDeclinedTool = exports.bugFixerStartFixTool = exports.bugFixerAnalyzeBugTool = exports.bugFixerPublishAppTool = exports.bugFixerGitRevertTool = exports.bugFixerGitPushTool = exports.bugFixerGitCommitTool = exports.bugFixerGitPullTool = exports.bugFixerGitStatusTool = exports.bugFixerRunBuildTool = exports.bugFixerApplyFixTool = exports.bugFixerWriteFileTool = exports.bugFixerReadFileTool = exports.bugFixerListFilesTool = exports.bugFixerFindAppTool = void 0;
+exports.bugFixerTools = exports.markBugFixedTool = exports.markBugDeclinedTool = exports.bugFixerRetryFixTool = exports.bugFixerPublishFixTool = exports.bugFixerMarkDeclinedTool = exports.bugFixerStartFixTool = exports.bugFixerAnalyzeBugTool = exports.bugFixerPublishAppTool = exports.bugFixerGitRevertTool = exports.bugFixerGitPushTool = exports.bugFixerGitCommitTool = exports.bugFixerGitPullTool = exports.bugFixerGitStatusTool = exports.bugFixerRunBuildTool = exports.bugFixerApplyFixTool = exports.bugFixerWriteFileTool = exports.bugFixerReadFileTool = exports.bugFixerListFilesTool = exports.bugFixerFindAppTool = void 0;
 const zod_1 = require("zod");
 const child_process_1 = require("child_process");
 const fs = __importStar(require("fs/promises"));
@@ -916,6 +916,158 @@ Call this when the user explains why the previous fix didn't work.`,
         }
     }
 };
+// Mark Bug Declined Tool - handles everything automatically
+exports.markBugDeclinedTool = {
+    name: "mark_bug_declined",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
+    description: "Mark a bug as declined (not a bug / won't fix). Automatically sets phase to Declined, status to 'Won't Fix', and leaves the discussion.",
+    schema: zod_1.z.object({
+        bugId: zod_1.z.string().describe("The bug activity ID"),
+        workflowId: zod_1.z.string().describe("The workflow ID for the Bug Reports workflow"),
+        discussionId: zod_1.z.string().describe("The discussion ID to leave after marking declined"),
+        reason: zod_1.z.string().optional().describe("Optional reason for declining"),
+    }),
+    async execute(args, context) {
+        const { bugId, workflowId, discussionId, reason } = args;
+        const { hailer } = context;
+        try {
+            // 1. Get workflow phases from cached init data (reliable method used by list_workflow_phases)
+            const workflowData = context.init.processes?.find((p) => p._id === workflowId);
+            if (!workflowData) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({
+                                success: false,
+                                error: `Workflow ${workflowId} not found`
+                            }) }]
+                };
+            }
+            const phases = workflowData.phases || {};
+            const declinedPhase = Object.entries(phases).find(([_, phase]) => phase.name?.toLowerCase() === 'declined');
+            if (!declinedPhase) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({
+                                success: false,
+                                error: "Could not find 'Declined' phase in workflow",
+                                availablePhases: Object.values(phases).map((p) => p.name)
+                            }) }]
+                };
+            }
+            const [declinedPhaseId, declinedPhaseData] = declinedPhase;
+            // 2. Get workflow schema to find status field ID
+            const schema = await hailer.getWorkflowSchema(workflowId, declinedPhaseId);
+            const statusField = Object.entries(schema.fields || {}).find(([_, f]) => f.key === 'status' || f.label?.toLowerCase() === 'status');
+            // 3. Update activity with phase AND status
+            const updateData = {
+                _id: bugId,
+                phaseId: declinedPhaseId,
+            };
+            if (statusField) {
+                updateData.fields = { [statusField[0]]: "Won't Fix" };
+            }
+            await hailer.updateActivities([updateData]);
+            // 4. Leave the discussion
+            try {
+                await hailer.leaveDiscussion(discussionId);
+            }
+            catch (e) {
+                // Ignore leave errors - might already be out
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            success: true,
+                            phase: "Declined",
+                            status: "Won't Fix",
+                            leftDiscussion: true,
+                            reason: reason || "Not a bug"
+                        }) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error)
+                        }) }]
+            };
+        }
+    }
+};
+// Mark Bug Fixed Tool - handles everything automatically
+exports.markBugFixedTool = {
+    name: "mark_bug_fixed",
+    group: tool_registry_1.ToolGroup.BOT_INTERNAL,
+    description: "Mark a bug as fixed. Automatically sets phase to Fixed, status to 'Fixed', and leaves the discussion. Only use AFTER fix is published and user confirmed it works!",
+    schema: zod_1.z.object({
+        bugId: zod_1.z.string().describe("The bug activity ID"),
+        workflowId: zod_1.z.string().describe("The workflow ID for the Bug Reports workflow"),
+        discussionId: zod_1.z.string().describe("The discussion ID to leave after marking fixed"),
+        fixSummary: zod_1.z.string().optional().describe("Optional summary of what was fixed"),
+    }),
+    async execute(args, context) {
+        const { bugId, workflowId, discussionId, fixSummary } = args;
+        const { hailer } = context;
+        try {
+            // 1. Get workflow phases from cached init data (reliable method used by list_workflow_phases)
+            const workflowData = context.init.processes?.find((p) => p._id === workflowId);
+            if (!workflowData) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({
+                                success: false,
+                                error: `Workflow ${workflowId} not found`
+                            }) }]
+                };
+            }
+            const phases = workflowData.phases || {};
+            const fixedPhase = Object.entries(phases).find(([_, phase]) => phase.name?.toLowerCase() === 'fixed');
+            if (!fixedPhase) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({
+                                success: false,
+                                error: "Could not find 'Fixed' phase in workflow",
+                                availablePhases: Object.values(phases).map((p) => p.name)
+                            }) }]
+                };
+            }
+            const [fixedPhaseId, fixedPhaseData] = fixedPhase;
+            // 2. Get workflow schema to find status field ID
+            const schema = await hailer.getWorkflowSchema(workflowId, fixedPhaseId);
+            const statusField = Object.entries(schema.fields || {}).find(([_, f]) => f.key === 'status' || f.label?.toLowerCase() === 'status');
+            // 3. Update activity with phase AND status
+            const updateData = {
+                _id: bugId,
+                phaseId: fixedPhaseId,
+            };
+            if (statusField) {
+                updateData.fields = { [statusField[0]]: "Fixed" };
+            }
+            await hailer.updateActivities([updateData]);
+            // 4. Leave the discussion
+            try {
+                await hailer.leaveDiscussion(discussionId);
+            }
+            catch (e) {
+                // Ignore leave errors - might already be out
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            success: true,
+                            phase: "Fixed",
+                            status: "Fixed",
+                            leftDiscussion: true,
+                            fixSummary: fixSummary || "Bug fixed"
+                        }) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({
+                            success: false,
+                            error: error instanceof Error ? error.message : String(error)
+                        }) }]
+            };
+        }
+    }
+};
 // Export all tools
 exports.bugFixerTools = [
     // Low-level tools
@@ -937,5 +1089,8 @@ exports.bugFixerTools = [
     exports.bugFixerMarkDeclinedTool,
     exports.bugFixerPublishFixTool,
     exports.bugFixerRetryFixTool,
+    // Standalone phase/status tools (no registry dependency)
+    exports.markBugDeclinedTool,
+    exports.markBugFixedTool,
 ];
 //# sourceMappingURL=bug-fixer-tools.js.map

package/dist/mcp-server.js

@@ -168,7 +168,8 @@ class MCPServerService {
                     }
                     // Apply default tool group filtering
                     // - NUCLEAR: Only if ENABLE_NUCLEAR_TOOLS=true
-                    // - BOT_INTERNAL: Never exposed to MCP clients (autonomous bot tools only)
+                    // - BOT_INTERNAL: Only if explicitly requested via params.includeBotInternal (for daemons)
+                    const includeBotInternal = mcpRequest.params?.includeBotInternal === true;
                     if (!filterConfig) {
                         // No filter yet - create default excluding NUCLEAR and BOT_INTERNAL
                         filterConfig = {
@@ -177,12 +178,13 @@ class MCPServerService {
                         req.logger.debug('Using default tool filter (excludes NUCLEAR and BOT_INTERNAL)');
                     }
                     else if (filterConfig.allowedGroups) {
-                        // Filter has groups - always remove BOT_INTERNAL, remove NUCLEAR unless enabled
-                        filterConfig.allowedGroups = filterConfig.allowedGroups.filter(g => g !== tool_registry_1.ToolGroup.BOT_INTERNAL &&
+                        // Filter groups - remove BOT_INTERNAL unless explicitly requested, remove NUCLEAR unless enabled
+                        filterConfig.allowedGroups = filterConfig.allowedGroups.filter(g => (includeBotInternal || g !== tool_registry_1.ToolGroup.BOT_INTERNAL) &&
                             (config_1.environment.ENABLE_NUCLEAR_TOOLS || g !== tool_registry_1.ToolGroup.NUCLEAR));
                         req.logger.debug('Filtered tool groups', {
                             allowedGroups: filterConfig.allowedGroups,
-                            nuclearEnabled: config_1.environment.ENABLE_NUCLEAR_TOOLS
+                            nuclearEnabled: config_1.environment.ENABLE_NUCLEAR_TOOLS,
+                            includeBotInternal
                         });
                     }
                     result = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hailer/mcp",
-  "version": "0.2.5",
+  "version": "0.2.7",
   "config": {
     "docker": {
       "registry": "registry.gitlab.com/hailer-repos/hailer-mcp"