@hailer/mcp 1.2.1 → 1.3.10

package/.claude/commands/cleanup-squad.md

@@ -1,98 +0,0 @@
----
-description: Clean up codebase with config audit, code simplification, and dead code detection
-argument-hint: [files, directory, or blank for recent changes]
-allowed-tools: Task, Bash
----
-# Cleanup Squad
-
-Run parallel codebase cleanup using three agents simultaneously.
-
-**Roles:**
-- **Config Auditor** - Configuration audit (verify CLAUDE.md, hooks, workspace structure)
-- **Code Simplifier** - Refactor (improve code clarity and maintainability)
-- **Dead Code Inspector** - Dead code detection (find unused imports, dead code, type errors)
-
-**Target:** $ARGUMENTS (if blank, use recent git changes)
-
-**Changed files (auto-injected):**
-!git diff --name-only HEAD
-
-## Protocol
-
-### Step 1: Determine Target
-
-If `$ARGUMENTS` has specific files/directories, use those.
-Otherwise, use the changed files list above as the target.
-
-If `$ARGUMENTS` contains `--skip-config`:
-- Remove flag from target
-- Skip Config Auditor in Step 2
-
-If `$ARGUMENTS` contains `--skip-dead-code`:
-- Remove flag from target
-- Skip Dead Code Inspector in Step 2
-
-### Step 2: Launch Agents in Parallel
-
-Spawn all agents simultaneously using multiple Task tool calls in a single message:
-
-**Config Auditor:**
-```
-Task(prompt="Audit codebase configuration for: [TARGET]. Check:\n- CLAUDE.md accuracy and completeness\n- Hook configurations\n- Workspace structure\n- Agent definitions\n\nReturn list of issues found with severity levels.")
-```
-
-**Code Simplifier:**
-```
-Task(prompt="Refactor these files for clarity and maintainability: [TARGET]. Focus on:\n- Variable naming\n- Function complexity\n- Comment clarity\n- Code organization\n\nReturn refactoring suggestions with before/after examples.")
-```
-
-**Dead Code Inspector:**
-```
-Task(prompt="Load lsp-setup skill for code inspection.\n\nInspect these files for dead code: [TARGET]. Find:\n- Unused imports\n- Unreachable code\n- Unused variables\n- Type errors\n\nUse LSP if available. Return detailed list grouped by file.")
-```
-
-### Step 3: Aggregate Results
-
-Compile a unified cleanup report:
-
-```markdown
-## Cleanup Squad Report
-
-### Config Auditor
-- Issues found: X
-- Critical: X
-- Warnings: X
-- [Issues grouped by category]
-
-### Code Simplifier
-- Files analyzed: X
-- Refactoring suggestions: X
-- [Suggestions grouped by file]
-
-### Dead Code Inspector
-- Unused imports: X
-- Dead code blocks: X
-- Type errors: X
-- [Details grouped by file]
-
-### Summary
-[Overall assessment of codebase health]
-[Prioritized action items]
-
-### Recommended Order
-1. [Fix critical config issues first]
-2. [Remove dead code]
-3. [Apply refactoring suggestions]
-```
-
-If any agent fails or times out, report partial results from successful agents, note which failed, and offer to re-run individually.
-
-## Options
-
-| Flag | Effect |
-|------|--------|
-| `--skip-config` | Skip Config Auditor (faster, no config validation) |
-| `--skip-dead-code` | Skip Dead Code Inspector (when LSP not configured) |
-| `--bg` | Run all agents in background mode |
-
-If `--bg` is present, launch all agents with `run_in_background: true` and tell the user they'll be notified when complete.

package/.claude/commands/config-squad.md

@@ -1,106 +0,0 @@
----
-description: Set up workflow config with infrastructure, functions, and insights
-argument-hint: "workflow/config description"
-allowed-tools: Task, Bash, Read
----
-# Config Squad
-
-Sequential pipeline: Create workflow infrastructure, then calculated fields, then insights.
-
-**Roles:**
-1. **Workflow Config** - Workflow configuration (fields, phases, teams, groups)
-2. **Function Fields** - Calculated fields and nameFunction
-3. **SQL Insights** - SQL insights for reporting
-
-**Goal:** $ARGUMENTS
-
-## Protocol
-
-### Step 1: Understand Scope
-
-Parse `$ARGUMENTS` to determine what's needed:
-
-| Keyword | Steps to Run |
-|---------|-------------|
-| "workflow", "fields", "phases" | Workflow Config (+ Function Fields if calculated fields mentioned) |
-| "insight", "report", "dashboard" | SQL Insights (may need schema discovery first) |
-| "function", "calculated", "nameFunction" | Function Fields only |
-| General description | All three in sequence |
-
-If scope is unclear, use AskUserQuestion:
-- What workflow(s) does this involve?
-- Do you need calculated fields?
-- Do you need reports/insights?
-
-If `$ARGUMENTS` contains `--skip-insights`: skip SQL Insights step.
-If `$ARGUMENTS` contains `--skip-functions`: skip Function Fields step.
-
-### Step 2: Workflow Config
-
-Spawn a workflow config agent:
-
-```
-Task(prompt="Load sdk-ws-config-skill for understanding workspace configuration.\n\n$ARGUMENTS")
-```
-
-Wait for result. If the agent returns `"status": "ready_to_push"`:
-- Run the push commands it provides (e.g., `npm run fields-push:force`)
-- Then run `npm run pull` to refresh local workspace with new IDs
-
-**Important:** The workflow config agent ALWAYS spawns a function fields agent for nameFunction after creating a workflow. Check the result - if it reports the function fields agent created the nameFunction and all needed function fields, skip Step 3. Only proceed to Step 3 if additional function fields are needed beyond what was already created.
-
-### Step 3: Function Fields
-
-Only if function fields or nameFunction are needed and weren't handled in Step 2.
-
-Spawn a function fields agent:
-
-```
-Task(prompt="Load sdk-function-fields and sdk-ws-config-skill skills for creating calculated fields.\n\nCreate function fields for: $ARGUMENTS. Workflow config agent created these workflows: [SUMMARIZE STEP 2 RESULT - workflow names and any IDs returned]. Read workspace/ to discover field IDs and types. New fields created in Step 2: [LIST FROM STEP 2 RESULT IF ANY].")
-```
-
-Wait for result. If `"status": "ready_to_push"`:
-- Run the push commands
-
-### Step 4: SQL Insights
-
-Only if reporting/insights are needed.
-
-Spawn an SQL insights agent:
-
-```
-Task(prompt="Load sdk-insight-queries and sdk-ws-config-skill skills for building insights.\n\nCreate insights for: $ARGUMENTS. Read workspace/ to discover workflow IDs and field IDs for SQL queries. Workflow config agent created: [SUMMARIZE STEP 2 RESULT].")
-```
-
-Wait for result. If `"status": "ready_to_push"`:
-- Run the push commands (e.g., `npm run insights-push:force`)
-
-### Step 5: Report
-
-```markdown
-## Config Squad Complete
-
-### Workflow Config
-- Workflows: [created/modified]
-- Fields: [count]
-- Phases: [count]
-- Commands run: [list]
-
-### Function Fields
-- Function fields: [list with formulas]
-- Name function: [pattern]
-- Skipped: [reason if skipped]
-
-### SQL Insights
-- Insights: [list with descriptions]
-- Skipped: [reason if skipped]
-
-### Workspace State
-Run `npm run pull` to ensure workspace/ is up to date.
-```
-
-## Notes
-
-- Each agent in the pipeline needs IDs from the previous step. Always `npm run pull` between steps.
-- Workflow config auto-spawns function fields agent for nameFunction - check the output before spawning separately.
-- SQL insights agent needs real field IDs for SQL queries - never let it guess.

package/.claude/commands/crud-squad.md

@@ -1,87 +0,0 @@
----
-description: Create, update, or manage activities with schema discovery and CRUD operations
-argument-hint: "what to create/update and in which workflow"
-allowed-tools: Task, Bash, Read
----
-# CRUD Squad
-
-Sequential pipeline: Discover schema, execute CRUD operations, verify results.
-
-**Roles:**
-1. **Data Reader** - Schema discovery + pre-read existing data
-2. **Activity Writer** - Create/update activities
-3. **Data Reader** - Verify results (count/list after changes)
-
-**Goal:** $ARGUMENTS
-
-## Protocol
-
-### Step 1: Schema Discovery
-
-Discover workflow schema and existing data relevant to the task:
-
-```
-Task(prompt="Load sdk-ws-config-skill and sdk-activity-patterns skills for data operations.\n\nFor this task: $ARGUMENTS\n\n1. List the relevant workflow(s) with field IDs, types, and dropdown/enum options\n2. List phases and their IDs\n3. If updating existing activities: list the activities that match (include their IDs)\n4. If creating new activities: show a sample existing activity so we know the expected field format")
-```
-
-Wait for result. This gives the activity writer the real IDs and field formats.
-
-### Step 2: CRUD Operations
-
-Spawn an activity writer with full schema context:
-
-```
-Task(prompt="Load sdk-activity-patterns skill for activity creation and updates.\n\nTask: $ARGUMENTS\n\nWorkflow schema from data reader:\n[PASTE DATA READER OUTPUT - workflow ID, field IDs, types, phase IDs, enum options]\n\n[IF UPDATING: Target activities:\nPASTE ACTIVITY IDs AND CURRENT VALUES]\n\nExecute the CRUD operations using the correct field IDs and value formats.")
-```
-
-Wait for result. Check for errors - if the activity writer reports validation failures, review field formats and retry once.
-
-### Step 3: Verify Results
-
-Skip if `--skip-verify` flag is set.
-
-Verify the operations succeeded:
-
-```
-Task(prompt="Load sdk-ws-config-skill for data verification.\n\nVerify CRUD operations for: $ARGUMENTS\n\nExpected changes:\n[PASTE ACTIVITY WRITER OUTPUT - created/updated activity IDs]\n\nCount activities in the workflow and list the recently created/modified ones to confirm they exist with correct values.")
-```
-
-### Step 4: Report
-
-```markdown
-## CRUD Squad Complete
-
-### Data Reader (Schema Discovery)
-- Workflow: [name] ([id])
-- Fields mapped: [count]
-- Existing activities found: [count or "N/A"]
-
-### Activity Writer (CRUD Operations)
-- Created: [count] activities
-- Updated: [count] activities
-- Errors: [count or "none"]
-
-### Data Reader (Verification)
-- Activities confirmed: [count]
-- Discrepancies: [list or "none"]
-
-### Summary
-[Brief description of what was done]
-```
-
-## Options
-
-| Flag | Effect |
-|------|--------|
-| `--skip-verify` | Skip verification (trust Activity Writer's response) |
-| `--skip-discovery` | Skip schema discovery (when you already know the workflow schema) |
-| `--dry-run` | Run Data Reader discovery only, show what Activity Writer would do, but don't execute |
-
-## Difference from Direct Activity Writer
-
-| | Direct Activity Writer | CRUD Squad |
-|---|---|---|
-| **Schema context** | You must provide IDs manually | Data Reader discovers IDs automatically |
-| **Verification** | Trust Activity Writer's response | Data Reader independently verifies |
-| **Bulk ops** | Single prompt | Discovery → execute → verify pipeline |
-| **Use when** | You already know exact IDs and format | "Create 5 customers" or "Update all overdue tasks" |

package/.claude/commands/data-squad.md

@@ -1,97 +0,0 @@
----
-description: Build reports with schema discovery, function fields, and insights
-argument-hint: "report/dashboard description"
-allowed-tools: Task, Bash, Read
----
-# Data Squad
-
-Sequential pipeline: Discover schema, create calculated fields if needed, then build insights.
-
-**Roles:**
-1. **Data Reader** - Schema discovery (workflow fields, types, IDs)
-2. **Function Fields** - Calculated fields (if needed)
-3. **SQL Insights** - SQL insights (queries, aggregations, reports)
-
-**Goal:** $ARGUMENTS
-
-## Protocol
-
-### Step 1: Schema Discovery
-
-Always start with schema discovery to get real IDs and field types:
-
-```
-Task(prompt="Load sdk-ws-config-skill for understanding workspace structure.\n\nList all workflows and their fields relevant to: $ARGUMENTS. Include field IDs, types, and dropdown options. Also list existing insights if any.")
-```
-
-Wait for result. This gives the function fields and SQL insights agents the real IDs they need.
-
-### Step 2: Check if Function Fields Needed
-
-Review the schema discovery output. Function fields are needed when:
-- The report needs **calculated values** not already in the schema (totals, percentages, date diffs)
-- An existing function field needs modification
-- A **nameFunction** is missing or needs updating
-
-If no calculated fields needed, skip to Step 3.
-
-If needed, spawn a function fields agent:
-
-```
-Task(prompt="Load sdk-function-fields and sdk-ws-config-skill skills for creating calculated fields.\n\nCreate function fields for: $ARGUMENTS.\n\nWorkflow schema from data reader:\n[PASTE SCHEMA DISCOVERY OUTPUT - workflow IDs, field IDs, types]\n\nCreate the calculated fields needed for this report.")
-```
-
-Wait for result. If `"status": "ready_to_push"`:
-- Run the push commands
-- Run `npm run pull` to get new field IDs
-
-### Step 3: SQL Insights
-
-Spawn an SQL insights agent with full schema context:
-
-```
-Task(prompt="Load sdk-insight-queries and sdk-ws-config-skill skills for building insights.\n\nCreate insights for: $ARGUMENTS.\n\nWorkflow schema:\n[Data reader found these workflows and fields: SUMMARIZE SCHEMA DISCOVERY RESULT.]\n\n[IF FUNCTION FIELDS AGENT RAN: It created these function fields: SUMMARIZE FUNCTION FIELDS RESULT.]\n\nBuild SQL queries with correct field IDs. Never guess IDs.")
-```
-
-Wait for result. If `"status": "ready_to_push"`:
-- Run the push commands (e.g., `npm run insights-push:force`)
-
-### Step 4: Report
-
-```markdown
-## Data Squad Complete
-
-### Data Reader (Schema Discovery)
-- Workflows found: [list]
-- Fields mapped: [count]
-- Existing insights: [list or "none"]
-
-### Function Fields
-- Created: [list with formulas]
-- Skipped: [reason if not needed]
-
-### SQL Insights
-- Insights created: [list]
-- Query summary: [brief description of each]
-- Public: [yes/no for each]
-
-### Next Steps
-- Preview insights in Hailer
-- Use insights as data source for apps (if needed)
-```
-
-## Options
-
-| Flag | Effect |
-|------|--------|
-| `--skip-functions` | Skip Function Fields step (when not needed) |
-| `--skip-insights` | Skip SQL Insights step (when not needed) |
-
-## Difference from Config Squad
-
-| | Config Squad | Data Squad |
-|---|---|---|
-| **Starting point** | New workflow needed | Workflow already exists |
-| **First agent** | Workflow Config (create workflow) | Data Reader (read existing schema) |
-| **Focus** | Infrastructure setup | Reporting and analytics |
-| **Use when** | "Create a Tasks workflow with..." | "Build a report showing..." |

package/.claude/commands/doc-squad.md

@@ -1,65 +0,0 @@
----
-description: Document API endpoints with code analysis and documentation generation
-argument-hint: "endpoint or module to document"
-allowed-tools: Task, Bash
----
-# Doc Squad
-
-Sequential pipeline: Code analysis, then generate documentation.
-
-**Roles:**
-1. **Code Inspector** - LSP code analysis (inspect types, schemas, function signatures)
-2. **Documentation Generator** - API documentation (generate endpoint docs from analysis)
-
-**Goal:** $ARGUMENTS
-
-## Protocol
-
-### Step 1: Code Analysis
-
-Spawn a code inspector to analyze code and extract types/schemas:
-
-```
-Task(prompt="Load lsp-setup skill for code inspection.\n\nInspect code for: $ARGUMENTS. Extract:\n- Function signatures\n- Type definitions\n- Return types\n- Parameter schemas\n- Joi/Zod validation rules\n\nUse LSP if available. Return structured analysis with types and schemas.")
-```
-
-Wait for result. Save the analysis output - the documentation generator needs these type definitions.
-
-### Step 2: Generate Documentation
-
-Spawn a documentation generator with the code analysis:
-
-```
-Task(prompt="Load api-documentation-patterns skill for creating API documentation.\n\nGenerate API documentation for: $ARGUMENTS.\n\nCode analysis from code inspector:\n[PASTE CODE INSPECTOR OUTPUT - types, schemas, function signatures]\n\nCreate comprehensive endpoint documentation including:\n- Endpoint path and method\n- Description\n- Parameters and types\n- Request/response examples\n- Error codes and handling\n- Usage examples with @hailer/cli")
-```
-
-Wait for result. If `"status": "ready_to_push"`:
-- Run the push commands provided
-
-### Step 3: Report
-
-```markdown
-## Doc Squad Complete
-
-### Code Inspector
-- Files analyzed: [count]
-- Functions found: [count]
-- Types extracted: [count]
-- Schemas identified: [list]
-
-### Documentation Generator
-- Endpoints documented: [count]
-- Examples created: [count]
-- Files generated: [list]
-
-### Next Steps
-- Review generated documentation
-- Add to API reference
-- Test examples with @hailer/cli
-```
-
-## Notes
-
-- Code Inspector runs first to extract accurate types - never guess schemas
-- Documentation Generator creates human-friendly docs from the type analysis
-- Documentation stays in sync with actual code signatures

package/.claude/commands/help.md

@@ -1,29 +0,0 @@
----
-description: Show help topics for Hailer MCP
----
-
-# Hailer MCP Help
-
-Display available help topics to the user.
-
-## Output
-
-```
-╭─────────────────────────────────────────╮
-│         HAILER MCP HELP SYSTEM          │
-╰─────────────────────────────────────────╯
-
-Available topics:
-
-  /help agents     How agents work and delegation
-  /help skills     Skills reference (patterns, templates, fixes)
-  /help commands   All slash commands
-  /help tools      MCP tools reference
-  /help plugins    Plugin system (install, uninstall, publish)
-  /help faq        Common questions
-
-───────────────────────────────────────────
-Type /help <topic> for details
-```
-
-## Always show this exactly as formatted above.

package/.claude/commands/help:agents.md

@@ -1,182 +0,0 @@
----
-description: Help for working with skills and general-purpose sub-agents
----
-
-# Skills & Roles Help
-
-Display how to work with the skill-based model and general-purpose sub-agents.
-
-## Output
-
-```
-╭─────────────────────────────────────────╮
-│    HAILER MCP - SKILLS & WORKFLOWS      │
-╰─────────────────────────────────────────╯
-
-The new model: General-purpose sub-agents + skills. No named agents.
-Load the right skills for the domain, spawn a sub-agent with them.
-
-HOW IT WORKS:
-
-  1. You ask Claude to do something
-  2. Claude picks the relevant skills for context
-  3. Claude spawns a general-purpose sub-agent with skill instructions
-  4. Sub-agent executes using domain knowledge from skills
-  5. Claude interprets result and reports back
-
-─────────────────────────────────────────────────────────────────────────
-
-SKILL CATALOG:
-
-  Workspace & Config:
-    sdk-ws-config-skill        - Understanding workflows, fields, phases, type generation
-    sdk-function-fields        - Creating calculated fields
-    sdk-activity-patterns      - Creating/updating activities
-    sdk-insight-queries        - Writing insight queries
-    sdk-document-templates     - Creating PDF/CSV templates
-
-  App Development:
-    hailer-app-builder         - Building Hailer apps (React/Chakra)
-    hailer-design-system       - Theme, colors, icons, components, UI/UX patterns
-    hailer-apps-pictures       - Working with images in apps
-    publish-hailer-app         - Publishing to production
-    hailer-api-client          - Making REST API calls
-
-  Integrations:
-    hailer-monolith-automations - Webhook handlers, scheduled jobs, phase cascade bots
-    zapier-hailer-patterns      - Zapier integrations
-    integration-patterns        - General integration patterns
-    hailer-api-client           - Using HailerApiClient
-
-  Testing & Quality:
-    testing-patterns           - vitest/playwright patterns
-    lsp-setup                  - Code inspection tools
-    api-documentation-patterns - API endpoint documentation
-    tool-builder               - Building MCP tools
-
-  Error Handling:
-    tool-parameter-usage       - MCP validation errors
-    tool-response-verification - Tool failures
-    optional-parameters        - Optional param errors
-    json-only-output          - JSON formatting issues
-
-─────────────────────────────────────────────────────────────────────────
-
-ROLE-BASED WORKFLOWS:
-
-  Data Operations:
-    • Data Reader       - Read workflows, fields, activities (LOCAL FIRST)
-    • Activity Writer   - Create/update activities
-    • Data Analyzer     - Query patterns, anomalies, analysis
-    • Access Controller - Manage app access
-
-  Configuration:
-    • Workflow Config   - Manage workflows, fields, phases
-    • Function Fields   - Calculated fields + nameFunction
-    • SQL Insights      - SQL-like reports
-    • Template Designer - PDF/CSV document templates
-
-  Development:
-    • App Builder       - Build Hailer apps (production)
-    • UI Designer       - Design specs (layout, components)
-    • Code Builder      - Build MCP tools, backends
-    • Activity Mover    - Phase cascade microservices
-    • Automation Builder - Webhooks, scheduled jobs
-
-  Quality:
-    • Code Reviewer     - Code review, security
-    • Test Runner       - Run tests, verify builds
-    • Code Inspector    - Find dead code, type errors
-    • Config Auditor    - Audit configuration
-    • Code Simplifier   - Refactor for clarity
-
-  Meta:
-    • Skill Builder     - Create skills from patterns
-    • Documentation Generator - API endpoint docs
-    • Publisher         - Publish to marketplace
-    • Reviewer          - PR review
-
-─────────────────────────────────────────────────────────────────────────
-
-COMMON WORKFLOWS:
-
-  Add a field:
-    Data Reader (get IDs) → Workflow Config (create field) → (push)
-    → Data Reader (verify)
-
-  Create an activity:
-    Data Reader (get schema) → Activity Writer (create)
-
-  Build an app:
-    Data Reader (discover schema) → UI Designer (design spec)
-    → App Builder (build) → Test Runner (verify)
-
-  Create a report:
-    Data Reader (get schema) → Function Fields (if needed)
-    → SQL Insights (build queries)
-
-  Review code:
-    Code Reviewer (find issues) → Code Fixer (fix) → Code Reviewer (verify)
-
-─────────────────────────────────────────────────────────────────────────
-
-HOW TO SPAWN SUB-AGENTS:
-
-  With skills:
-    Task(prompt="Load <skill-name> for understanding the domain.
-    
-    Your mission: [detailed task description]")
-
-  Multiple skills:
-    Task(prompt="Load <skill-1> and <skill-2> skills.
-    
-    Your mission: [detailed task description]")
-
-  Example:
-    Task(prompt="Load sdk-ws-config-skill for workspace understanding.
-    
-    List all workflows and their fields for the Customer workflow.")
-
-─────────────────────────────────────────────────────────────────────────
-
-DATA OPERATION RULES:
-
-  Read First: Always check workspace/ before API calls
-    - workflow/ directory has all structural data (IDs, field types, phases)
-    - API only needed for live activity data, counts, discussion messages
-
-  Refresh Often: `npm run pull` updates workspace/ from Hailer
-    - After pushing new config, pull to get new IDs
-    - Between pipeline steps
-
-  ID Format: Field IDs, workflow IDs, phase IDs come from workspace/
-    - Never guess IDs - always read them from workspace/ files
-    - Always verify types match before using in code
-
-  Activity Updates: Use correct wrapper format
-    - Correct: `{type: "string", value: "x"}`
-    - Wrong: Raw value `"x"`
-
-─────────────────────────────────────────────────────────────────────────
-
-SQUAD WORKFLOWS:
-
-  Pre-built multi-step orchestrations:
-    /app-squad         - Build apps end-to-end
-    /review-squad      - Code review + auto-fix
-    /config-squad      - Workflow config + functions + insights
-    /hotfix-squad      - Test → fix → security review
-    /debug-squad       - Parallel investigation
-    /crud-squad        - Schema discovery → CRUD → verify
-    /data-squad        - Build reports (discover → functions → insights)
-
-  Large-scale parallel:
-    /swarm <desc>      - Auto-select roles, split work across workers
-
-─────────────────────────────────────────────────────────────────────────
-
-SEE ALSO:
-  /stats         - Task statistics
-  /help:skills   - Skill details
-  /help:commands - All commands
-```