@hailer/mcp 1.2.1 → 2.0.0-beta.3

package/scripts/probe-mcp-pricing.ts

@@ -0,0 +1,52 @@
+/**
+ * One-off probe: which model names exist (enabled) in prod mcpPricing?
+ * Calls v3.mcp.deductTokens with tokenAmount 0 — deducts ceil(0*rate) = 0,
+ * so balance is untouched; success only proves the pricing row exists.
+ * Delete after use.
+ */
+
+import { getAdminApiKey } from '../src/mcp/workspace-admin-store';
+import { createHailerClientByApiKey } from '../src/mcp/hailer-clients';
+
+const WORKSPACE_ID = '6901c67b4e80fecb6fd7b38a'; // mcptest
+const CANDIDATES = [
+    'claude-haiku',
+    'claude-sonnet',
+    'claude-haiku-4-5',
+    'claude-sonnet-4-6',
+    'claude-haiku-4-5-20251001',
+    'claude-sonnet-4-5-20250929',
+];
+
+async function main(): Promise<void> {
+    const apiKey = getAdminApiKey(WORKSPACE_ID);
+    if (!apiKey) {
+        console.error('No stored admin API key for workspace', WORKSPACE_ID);
+        process.exit(2);
+    }
+
+    const client = await createHailerClientByApiKey(apiKey);
+
+    for (const model of CANDIDATES) {
+        try {
+            const result = await client.socket.request('v3.mcp.deductTokens', [{
+                mcpToken: 'hL9xK2mNpQrS4tVwY6zA8bCD',
+                workspaceId: WORKSPACE_ID,
+                tokenAmount: 0,
+                model,
+                meta: { operation: 'pricing-probe' },
+            }]) as { newBalance?: number } | undefined;
+            console.log(`ROW EXISTS   ${model}  (balance after -0 deduct: ${result?.newBalance})`);
+        } catch (error) {
+            const err = error as { msg?: string; code?: number };
+            console.log(`REJECTED     ${model}  (${err?.msg ?? String(error)})`);
+        }
+    }
+
+    process.exit(0);
+}
+
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});

package/scripts/smoke-public-chat-live.ts

@@ -0,0 +1,148 @@
+/**
+ * Live-LLM smoke test for the public-chat bot. Fires a small set of canned
+ * prompts at the real model with the production system prompt and reports
+ * which bot-action types showed up in the responses.
+ *
+ *   ANTHROPIC_API_KEY=... npx tsx scripts/smoke-public-chat-live.ts
+ *
+ * The script is OPTIONAL — it costs real API tokens and is non-deterministic.
+ * Run it before deploying significant prompt or corpus changes. The regular
+ * `smoke-public-chat.ts` covers everything that doesn't need a live model.
+ *
+ * The script does NOT exit non-zero on a missing action — the LLM is allowed
+ * to be cautious. It exits non-zero only on transport errors. Treat the report
+ * as a coverage signal: if all five action types reliably surface, the protocol
+ * is being honoured. If one or more are repeatedly silent across runs, the
+ * persona is probably under-specifying it or the model is dropping it.
+ */
+
+import Anthropic from '@anthropic-ai/sdk';
+import { buildPublicChatSystem } from '../src/public-chat/system-prompt';
+
+// Minimal extractor — mirrors the frontend's bot-action-parser regex pair
+// (BOT_ACTION_REGEX and INVOKE_FORM_REGEX from
+// hailer-frontend-2/.../bot-action-parser.ts). Inlined to keep this script
+// repo-local with no extra deps.
+const ACTION_TYPES = '(navigate|highlight|point|presentation|slide)';
+const TAG_REGEXES = [
+    new RegExp(`<bot-action\\s+type="${ACTION_TYPES}"\\s+target="([^"]+)"`, 'g'),
+    new RegExp(`<invoke\\s+name="bot_action"\\s+type="${ACTION_TYPES}"\\s+target="([^"]+)"`, 'g'),
+];
+
+function extractActionTypes(text: string): Set<string> {
+    const found = new Set<string>();
+    for (const re of TAG_REGEXES) {
+        re.lastIndex = 0;
+        let m: RegExpExecArray | null;
+        while ((m = re.exec(text)) !== null) {
+            found.add(m[1]!);
+        }
+    }
+    return found;
+}
+
+const MODEL = 'claude-haiku-4-5-20251001';
+const MAX_TOKENS = 600;
+
+interface Probe {
+    label: string;
+    prompt: string;
+    /** Action types we'd expect to see at least one of in the reply. */
+    expect: Array<'navigate' | 'highlight' | 'point' | 'presentation' | 'slide'>;
+}
+
+const PROBES: Probe[] = [
+    {
+        label: 'tour invitation triggers a guided tour',
+        prompt: "I'm a developer evaluating Hailer for our team. Give me a quick walk-through of how this would feel.",
+        expect: ['navigate', 'point'],
+    },
+    {
+        label: 'explicit "show me X" triggers navigate or highlight',
+        prompt: 'Where do I see the calendar?',
+        expect: ['navigate', 'highlight'],
+    },
+    {
+        label: 'overview ask triggers the presentation',
+        prompt: "What is Hailer? Give me the elevator pitch — I want the big picture.",
+        expect: ['presentation'],
+    },
+    {
+        label: 'concept question triggers an inline slide chip',
+        prompt: 'Can you explain what a workflow is in Hailer?',
+        expect: ['slide'],
+    },
+];
+
+async function main(): Promise<void> {
+    const apiKey = process.env['ANTHROPIC_API_KEY'];
+    if (!apiKey) {
+        console.error('ANTHROPIC_API_KEY env var is required for the live smoke.');
+        process.exit(2);
+    }
+    const anthropic = new Anthropic({ apiKey });
+
+    const system = buildPublicChatSystem();
+
+    let probesRun = 0;
+    let expectedActionsSatisfied = 0;
+    let expectedActionsTotal = 0;
+    const misses: Array<{ probe: string; missing: string[] }> = [];
+
+    for (const probe of PROBES) {
+        probesRun += 1;
+        process.stdout.write(`\n• ${probe.label}\n  prompt: ${probe.prompt}\n`);
+        let fullText = '';
+        try {
+            const response = await anthropic.messages.create({
+                model: MODEL,
+                max_tokens: MAX_TOKENS,
+                temperature: 0.3,
+                system,
+                messages: [{ role: 'user', content: probe.prompt }],
+            });
+            for (const block of response.content) {
+                if (block.type === 'text') fullText += block.text;
+            }
+        } catch (err) {
+            console.error(`  TRANSPORT ERROR: ${err instanceof Error ? err.message : String(err)}`);
+            process.exit(1);
+        }
+
+        const surfaced = extractActionTypes(fullText);
+
+        const missing: string[] = [];
+        for (const exp of probe.expect) {
+            expectedActionsTotal += 1;
+            if (surfaced.has(exp)) {
+                expectedActionsSatisfied += 1;
+            } else {
+                missing.push(exp);
+            }
+        }
+        console.log(`  surfaced: ${Array.from(surfaced).join(', ') || '(none)'}`);
+        console.log(`  expected: ${probe.expect.join(', ')}`);
+        if (missing.length > 0) {
+            misses.push({ probe: probe.label, missing });
+            console.log(`  MISSING: ${missing.join(', ')}`);
+        }
+    }
+
+    console.log(
+        `\n${expectedActionsSatisfied}/${expectedActionsTotal} expected action types surfaced across ${probesRun} probes`
+    );
+    if (misses.length > 0) {
+        console.log('\nMisses worth investigating if they repeat across runs:');
+        for (const m of misses) {
+            console.log(`  - "${m.probe}" missing: ${m.missing.join(', ')}`);
+        }
+    }
+    // Don't fail the run on missing actions — the LLM may legitimately reply in
+    // plain prose. Transport errors above are the only hard failure.
+    process.exit(0);
+}
+
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});

package/scripts/smoke-public-chat.ts

@@ -0,0 +1,110 @@
+/**
+ * Smoke test for the public-chat module — exercises the pieces that don't
+ * need a live Anthropic API key.
+ *
+ *   npx tsx scripts/smoke-public-chat.ts
+ */
+
+import assert from 'node:assert/strict';
+import { buildPublicChatSystem, KNOWLEDGE_BYTES } from '../src/public-chat/system-prompt';
+import { checkRate, _resetForTests } from '../src/public-chat/rate-limit';
+import { HAILER_KNOWLEDGE_CORPUS } from '../src/public-chat/knowledge';
+
+let ran = 0;
+let failed = 0;
+
+function check(name: string, fn: () => void): void {
+  ran += 1;
+  try {
+    fn();
+    console.log(`  ok ${name}`);
+  } catch (err) {
+    failed += 1;
+    console.log(`  FAIL ${name}`);
+    console.error(err);
+  }
+}
+
+console.log('public-chat smoke');
+
+console.log('\nknowledge corpus:');
+check('compiled and non-trivial', () => {
+  assert.ok(HAILER_KNOWLEDGE_CORPUS.length > 10_000, 'too small');
+  assert.ok(HAILER_KNOWLEDGE_CORPUS.length < 200_000, 'too large');
+  assert.equal(KNOWLEDGE_BYTES, HAILER_KNOWLEDGE_CORPUS.length);
+});
+check('mentions all five top-level topics', () => {
+  const lower = HAILER_KNOWLEDGE_CORPUS.toLowerCase();
+  for (const term of ['overview', 'ui guide', 'mcp server', 'apps & marketplace', 'getting started']) {
+    assert.ok(lower.includes(term), `missing: ${term}`);
+  }
+});
+check('omits internal infra/compliance bait words', () => {
+  const lower = HAILER_KNOWLEDGE_CORPUS.toLowerCase();
+  for (const banned of ['client_configs={', 'infra/', 'hailer-frontend-2/']) {
+    assert.ok(!lower.includes(banned), `should not contain: ${banned}`);
+  }
+});
+
+console.log('\nbuildPublicChatSystem:');
+check('returns two cached text blocks', () => {
+  const blocks = buildPublicChatSystem();
+  assert.equal(blocks.length, 2);
+  for (const block of blocks) {
+    assert.equal(block.type, 'text');
+    assert.deepEqual(block.cache_control, { type: 'ephemeral' });
+    assert.ok(block.text.length > 0);
+  }
+});
+check('persona block describes role and bot-action protocol', () => {
+  const [persona] = buildPublicChatSystem();
+  assert.match(persona.text, /Hailer Helper/i);
+  assert.match(persona.text, /bot-action/i);
+  assert.match(persona.text, /navigate/i);
+  assert.match(persona.text, /highlight/i);
+});
+check('persona documents all five bot-action types and shows their canonical form', () => {
+  // If any of these regress (someone deletes a section, renames a type, etc.)
+  // the model loses the affordance and the demo silently degrades. Cheap to
+  // assert on every smoke run.
+  const [persona] = buildPublicChatSystem();
+  for (const type of ['navigate', 'highlight', 'point', 'presentation', 'slide']) {
+    const re = new RegExp(`<bot-action\\s+type="${type}"`, 'i');
+    assert.match(persona.text, re, `persona missing canonical form for type="${type}"`);
+  }
+});
+check('persona explicitly acknowledges the always-visible Continue button', () => {
+  // Was once the other way around — persona told the bot to "surface" the CTA
+  // even though the button is always visible. Lock the corrected wording in.
+  const [persona] = buildPublicChatSystem();
+  assert.match(persona.text, /persistently visible|always visible/i);
+});
+check('knowledge block carries the full corpus', () => {
+  const [, knowledge] = buildPublicChatSystem();
+  assert.ok(knowledge.text.includes(HAILER_KNOWLEDGE_CORPUS));
+});
+
+console.log('\ncheckRate:');
+_resetForTests();
+check('allows the first 30 requests from a single IP', () => {
+  for (let i = 0; i < 30; i++) {
+    const r = checkRate('1.2.3.4');
+    assert.equal(r.ok, true, `request ${i + 1} should be allowed`);
+    assert.equal(r.remaining, 30 - 1 - i);
+  }
+});
+check('rejects the 31st request with retry-after', () => {
+  const blocked = checkRate('1.2.3.4');
+  assert.equal(blocked.ok, false);
+  assert.equal(blocked.remaining, 0);
+  assert.ok((blocked.retryAfterSec ?? 0) > 0);
+});
+_resetForTests();
+check('keeps independent counters per IP', () => {
+  for (let i = 0; i < 30; i++) checkRate('9.9.9.9');
+  assert.equal(checkRate('9.9.9.9').ok, false);
+  assert.equal(checkRate('1.1.1.1').ok, true);
+});
+
+console.log(`\n${ran - failed}/${ran} passed${failed === 0 ? '' : `, ${failed} failed`}`);
+process.exit(failed === 0 ? 0 : 1);

package/.claude/CLAUDE.md

@@ -1,126 +0,0 @@
-# Hailer SDK + MCP Project
-
-## The One Rule
-
-**If it can be done locally, do it locally. MCP tools are ONLY for things that require a server call.**
-
-This project has `workspace/` files managed by `@hailer/sdk`. These files ARE the source of truth for all workflow configuration. The MCP server provides tools for runtime operations that require talking to Hailer's API.
-
-## What Goes Where
-
-| Need | Do this | NEVER this |
-|------|---------|------------|
-| **Find workflow/field/phase IDs** | Read `workspace/enums.ts` | ~~`list_workflows_minimal`~~, ~~`get_workflow_schema`~~, ~~`list_workflow_phases`~~ |
-| **See field types, labels, options** | Read `workspace/<Name>_<id>/fields.ts` | ~~`get_workflow_schema`~~ |
-| **See phases** | Read `workspace/<Name>_<id>/phases.ts` | ~~`list_workflow_phases`~~ |
-| **See all workflows** | Read `workspace/workflows.ts` | ~~`list_workflows`~~ |
-| **Create/modify fields** | Edit `fields.ts` → `npm run fields-push:force` | ~~`update_workflow_field`~~ |
-| **Create/modify phases** | Edit `phases.ts` → `npm run phases-push:force` | ~~`update_workflow_phase`~~ |
-| **Create/modify workflows** | Edit `workflows.ts` → `npm run workflows-sync:force` | ~~`install_workflow`~~ |
-| **Create/modify teams** | Edit `teams.ts` → `npm run teams-push:force` | — |
-| **Create/modify groups** | Edit `groups.ts` → `npm run groups-push:force` | — |
-| **Create activities** | MCP `create_activity` | — |
-| **List/read activities** | MCP `list_activities`, `show_activity_by_id` | — |
-| **Update activities** | MCP `update_activity` | — |
-| **Query data** | MCP `preview_insight`, `create_insight` | — |
-| **Discussions** | MCP discussion tools | — |
-| **Activity counts** | MCP `core_init` (once per session) | — |
-| **Scaffold app** | MCP `scaffold_hailer_app` | — |
-| **Publish app** | MCP `publish_hailer_app` | — |
-
-**If you're about to call an MCP tool, ask yourself: "Is this data in workspace/ files?" If yes, read the file instead.**
-
-## How to Read workspace/ Files
-
-**Never read workspace/ files in main context** — they're large and fill context permanently.
-
-1. Spawn a **haiku sub-agent** to read the files
-2. Have it extract what you need (IDs, field types, phase names)
-3. It returns a short summary
-4. Use that summary for MCP runtime calls
-
-```
-Pattern: haiku reads workspace/ → you get IDs → MCP create_activity/list_activities
-```
-
-## Sub-Agent Rules
-
-- **Haiku:** Read files, search code, data lookups, reviews
-- **Sonnet:** Write code, build features, complex edits
-- **You (Opus):** Orchestrate, synthesize results, make decisions
-- **Skills:** Load in sub-agents only, never in main context
-- If a task takes more than ~20 lines of code, delegate to sonnet
-
-## workspace/ Structure
-
-```
-workspace/
-├── enums.ts          # ALL IDs — WorkflowIds, FieldIds, PhaseIds, etc.
-├── workflows.ts      # Workflow registry
-├── teams.ts          # Team definitions
-├── groups.ts         # Group definitions
-├── insights.ts       # Insight definitions
-└── <WorkflowName>_<id>/
-    ├── fields.ts     # Field definitions (type, label, key, options, required)
-    ├── phases.ts     # Phase definitions (name, key, isInitial, isEndpoint)
-    ├── main.ts       # Workflow config
-    └── functions/    # Function field code (if any)
-```
-
-**Refresh:** `npm run pull` syncs server → local files
-
-## SDK Push Commands (all use `:force` to avoid interactive prompts)
-
-| Command | What it does |
-|---------|-------------|
-| `npm run push:force` | Push everything |
-| `npm run fields-push:force` | Push field changes only |
-| `npm run phases-push:force` | Push phase changes only |
-| `npm run workflows-sync:force` | Sync workflow registry (create/delete) |
-| `npm run teams-push:force` | Push team changes |
-| `npm run groups-push:force` | Push group changes |
-| `npm run pull` | Pull latest from Hailer → local files |
-
-## SDK Gotchas
-
-| Gotcha | Correct | Wrong |
-|--------|---------|-------|
-| New fields | Omit `_id` — server assigns it | Adding `_id` manually |
-| After push | Always `npm run pull` to get server-assigned IDs | Assuming local IDs are final |
-| Function fields | `npm run fields-push:force` (non-force skips functionVariables) | `npm run fields-push` |
-| Enum imports | Verify after pull — identical hex suffixes can collide | Trusting auto-generated imports |
-| `linkedfrom` fields | Don't work in isolated-vm — use `<` backlink dependency | Using in function fields |
-| Function field code | Plain JavaScript only | TypeScript syntax |
-| Phase transitions | Exact string match on phase name | Guessed names |
-| Field values (MCP) | Date: Unix ms (`1730937600000`), Dropdown: exact string, ActivityLink: string ID | ISO dates, arrays, objects |
-
-## App Development
-
-| Step | How |
-|------|-----|
-| Scaffold | MCP `scaffold_hailer_app` — never copy apps |
-| Publish | MCP `publish_hailer_app` — auto icon, name, description, sharing |
-| Local dev | `npm run dev` from app directory |
-
-## Skills
-
-Load in sub-agents via Skill tool. Never in main context.
-
-| Skill | When |
-|-------|------|
-| `sdk-ws-config-skill` | Workflows, fields, phases, teams, groups |
-| `sdk-function-fields` | Calculated fields, nameFunction |
-| `sdk-activity-patterns` | Creating/updating activities via MCP |
-| `sdk-insight-queries` | SQL insight queries |
-| `hailer-app-builder` | Building Hailer apps (React/Chakra) |
-| `hailer-design-system` | Theme, colors, icons, layout |
-| `publish-hailer-app` | Publishing apps to production |
-| `testing-patterns` | Vitest/playwright tests |
-
-## Commands
-
-`/command <param>` — angle brackets = required
-
-**Essential:** `/save`, `/handoff`, `/prd`, `/autoplan`, `/ws-pull`
-
-**Squads:** `/app-squad`, `/review-squad`, `/config-squad`, `/hotfix-squad`, `/debug-squad`, `/swarm <desc>`

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

@@ -1,158 +0,0 @@
----
-description: Run parallel security and permissions audit
-argument-hint: [files, app name, or blank for full audit]
-allowed-tools: Task, Bash
----
-
-# Audit Squad
-
-Parallel security and permissions audit: code hardening, access control verification, and MCP tool validation.
-
-**Roles:**
-- **Code Reviewer** - Code review (hardcoded secrets, injection vulnerabilities, insecure patterns, OWASP top 10)
-- **Permissions Auditor** - Access control audit (effective permissions, team access levels, permission matrix)
-- **Tool Security Auditor** - MCP tools security (input validation, data exposure, security best practices)
-
-**Target:** $ARGUMENTS (if blank, use full project scope)
-
-**Scope options:**
-- Specific files or directory path
-- App name (checks that app's code and permissions)
-- Blank for full project audit
-
-## Protocol
-
-### Step 1: Determine Target
-
-If `$ARGUMENTS` has specific files/directories or app name, use those.
-Otherwise, scope is the entire project (workspace/ + apps/ + integrations/).
-
-If `$ARGUMENTS` contains `--code-only`:
-- Remove flag from target
-- Skip Permissions Auditor and Tool Security Auditor in Step 2
-
-If `$ARGUMENTS` contains `--permissions-only`:
-- Remove flag from target
-- Skip Code Reviewer and Tool Security Auditor in Step 2
-
-If `$ARGUMENTS` contains `--bg`:
-- Launch all agents in background mode
-
-### Step 2: Launch Audit Agents in Parallel
-
-Spawn all applicable agents simultaneously using multiple Task tool calls in a single message:
-
-**Code Reviewer:**
-```
-Task(prompt="Security audit of these files: [TARGET]. Focus on: hardcoded secrets, API keys, credentials, injection vulnerabilities (SQL/XSS/Command), insecure crypto usage, missing input validation, OWASP Top 10 issues, unsafe deserialization, missing authentication/authorization checks. Return verdict (PASS/FAIL), critical count, and detailed findings per file.")
-```
-
-**Permissions Auditor:**
-```
-Task(prompt="Load hailer-permissions-system skill for understanding the permissions model.\n\nAudit access control for the entire project. Map effective permissions: who has access to which apps, which teams have what access levels, which users are admins, workspace-wide versus app-specific permissions. Produce a permission matrix showing [User/Team] → [App] → [Access Level]. Flag any excessive or unclear permissions.")
-```
-
-**Tool Security Auditor:**
-```
-Task(prompt="Load tool-builder skill for understanding MCP tool patterns.\n\nSecurity audit of custom MCP tools (if any exist in src/mcp/tools/). Verify: input validation with Zod schemas, no unintended data exposure, proper error handling, rate limiting awareness, secure defaults. Report security posture per tool. If no custom tools exist, report that.")
-```
-
-### Step 3: Categorize and Aggregate Results
-
-Collect results from all agents. Categorize findings into three tiers:
-
-**CRITICAL:**
-- Hardcoded secrets/credentials
-- SQL injection, XSS, command injection vulnerabilities
-- Authentication/authorization bypasses
-- Excessive uncontrolled permissions
-- MCP tools exposing sensitive data
-
-**WARNING:**
-- Weak crypto usage
-- Missing input sanitization
-- Unclear permission delegations
-- Unvalidated MCP tool inputs
-- Missing rate limiting on tools
-
-**INFO:**
-- Best practice improvements
-- Code hardening suggestions
-- Permission clarity recommendations
-
-### Step 4: Report
-
-```markdown
-## Audit Squad Report
-
-### Scope
-[What was audited]
-
-### Overall Security Posture
-[Rating: PASS / WARNING / CRITICAL]
-- Critical findings: X
-- Warnings: X
-- Info items: X
-
-### Code Reviewer
-**Verdict:** PASS / FAIL / WARNINGS
-- Critical: X [list]
-- Warnings: X [list]
-- Info: X [list]
-- Files affected: [grouped summary]
-
-### Permissions Auditor
-**Matrix Status:** [OK / EXCESSIVE / UNCLEAR]
-- Total apps: X
-- Total teams: X
-- Users with admin access: X
-- Flagged permissions: [list]
-- [Permission matrix if findings exist]
-
-### Tool Security Auditor
-**Status:** [No tools / PASS / WARNINGS / CRITICAL]
-[If tools exist:]
-- Tools audited: X
-- Input validation issues: X
-- Data exposure risks: X
-- Best practice gaps: X
-
-### Findings by Severity
-
-#### CRITICAL (Require Immediate Action)
-[List all critical findings with file/tool and remediation steps]
-
-#### WARNING (Address in Next Sprint)
-[List all warnings with context]
-
-#### INFO (Consider for Hardening)
-[List informational recommendations]
-
-### Remediation Checklist
-- [ ] [Critical issue 1]: [Action]
-- [ ] [Critical issue 2]: [Action]
-- [ ] [Warning 1]: [Action]
-
-### Summary
-[1-2 sentence overall assessment of security posture and next steps]
-```
-
-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 |
-|------|--------|
-| `--code-only` | Skip permissions and MCP tools (code review only, faster) |
-| `--permissions-only` | Skip code review and MCP tools (permissions matrix only) |
-| `--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.
-
-## Notes
-
-- Default scope is full project if no arguments provided
-- Code Reviewer focuses on secrets and injection attacks; general code quality is separate (/review-squad)
-- Permissions Auditor is organization-wide - includes team and app-level settings
-- Tool Security Auditor only validates if custom MCP tools exist in the project
-- Critical findings should block deployment; warnings should be tracked for next sprint

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.