hool-cli 0.1.0

package/README.md

@@ -0,0 +1,219 @@
+# HOOL CLI
+
+One command to install the entire agent-driven SDLC framework into any project.
+
+## Usage
+
+```bash
+npx hool init
+```
+
+That's it. Everything else is automatic.
+
+## What `hool init` does
+
+### Step 1: Ask project type
+```
+What are you building?
+  1. Web application
+  2. Browser game
+  3. Mobile app (React Native)
+  4. Animation / motion
+  5. CLI tool
+  6. API / backend only
+```
+
+### Step 2: Create project structure
+Based on selection, creates:
+```
+your-project/
+  phases/
+    00-init/
+      project-profile.md
+    01-brainstorm/
+      brainstorm.md
+    02-spec/
+      spec.md
+    03-design/
+      design.md
+      cards/
+    04-architecture/
+      architecture.md
+      contracts.md
+      schema.md
+      flows.md
+      fe/
+      be/
+    05-fe-scaffold/
+      fe-lld.md
+    06-be-scaffold/
+      be-lld.md
+    07-test-plan/
+      test-plan.md
+  operations/
+    current-phase.md
+    task-board.md
+    bugs.md
+    issues.md
+    inconsistencies.md
+    needs-human-review.md
+  memory/
+    product-lead/
+      hot.md, cold.md, best-practices.md, issues.md
+    fe-tech-lead/
+      hot.md, cold.md, best-practices.md, issues.md
+    be-tech-lead/
+      hot.md, cold.md, best-practices.md, issues.md
+    fe-dev/
+      hot.md, cold.md, best-practices.md, issues.md
+    be-dev/
+      hot.md, cold.md, best-practices.md, issues.md
+    qa/
+      hot.md, cold.md, best-practices.md, issues.md
+    forensic/
+      hot.md, cold.md, best-practices.md, issues.md
+  logs/
+    fe.log
+    be.log
+  src/
+    frontend/
+    backend/
+  tests/
+    unit/
+    integration/
+    e2e/
+  .hool/
+    mcps.json
+    prompts/          <- agent prompts (copied from hool-mini templates)
+  CLAUDE.md           <- injected with HOOL product-lead instructions
+```
+
+### Step 3: Check & Install MCPs (global)
+MCPs are installed GLOBALLY (once per machine, not per project).
+
+On first run:
+```
+Checking global MCPs...
+  ok context7 -- already installed
+  !! playwright -- not found
+
+Install missing MCPs globally? (y/n)
+  Installing playwright -> ~/.claude/mcp_servers.json ok
+```
+
+Required MCPs by project type:
+```
+ALL projects:     context7
+Web app:          + playwright
+Browser game:     + playwright
+Mobile app:       + adb MCP (warn if adb CLI not on PATH)
+Animation:        + playwright
+CLI / API only:   (no additional)
+```
+
+Writes to `~/.claude/mcp_servers.json` (global, shared across all projects).
+
+### Step 4: Set up Claude Code integration
+Injects HOOL product-lead instructions into project CLAUDE.md so that when you open Claude Code in this project, it knows:
+- The phase structure
+- Which agent prompts to load
+- Where state files live
+- Which MCPs are available
+
+### Step 5: Initialize status files
+Creates all status files with empty templates:
+- `operations/current-phase.md` -> Phase 0, awaiting start
+- `operations/task-board.md` -> empty
+- `operations/bugs.md`, `operations/issues.md`, `operations/inconsistencies.md`, `operations/needs-human-review.md` -> empty
+- All agent memory files (`memory/<agent-name>/hot.md`, `cold.md`, `best-practices.md`, `issues.md`) -> initialized with headers
+
+### Step 6: Write project MCP manifest
+Creates `.hool/mcps.json` -- a READ-ONLY manifest declaring which global MCPs this project uses. Not an installer, just a reference.
+```json
+{
+  "required": ["context7", "playwright"],
+  "optional": ["hool-context-mcp"],
+  "domain": "web-app"
+}
+```
+
+### Step 7: Done
+```
+HOOL initialized for: Web Application
+
+  Start building:
+    $ claude
+    > /hool start
+
+  Or manually:
+    > Read .hool/prompts/product-lead.md and begin Phase 1: Brainstorm
+
+  Global MCPs verified: context7, playwright
+  Project profile: web-app
+  Status: ready for Phase 1 -- Brainstorm
+```
+
+## Other commands
+
+```bash
+npx hool init              # bootstrap everything
+npx hool status            # show current phase + task board summary
+npx hool add-mcp <name>    # install an additional MCP
+npx hool reset             # reset status files (keep phases/)
+npx hool upgrade           # update prompts/agents to latest version
+```
+
+## How it ships
+
+```
+npm package: hool
+  bin: hool
+  contains:
+    - CLI (Node.js)
+    - Prompt templates (markdown)
+    - MCP installer logic
+    - CLAUDE.md generator
+```
+
+Install globally or use npx:
+```bash
+npm install -g hool    # global
+npx hool init          # one-shot
+```
+
+## MCP Installation Strategy
+
+MCPs install GLOBALLY -- one install per machine, shared across all projects.
+
+```
+npm-based MCPs (context7, playwright):
+  -> writes to ~/.claude/mcp_servers.json (global)
+
+Python-based MCPs:
+  -> pip/uvx install, writes to ~/.claude/mcp_servers.json (global)
+
+Custom MCPs (hool-context-mcp):
+  -> installed globally, reads per-project config from .hool/context-config.json
+
+System tools (adb):
+  -> Check if installed on PATH, warn if not, provide install instructions
+  -> Don't auto-install system-level tools
+```
+
+## Global vs Project-Level
+
+```
+GLOBAL (~/.claude/mcp_servers.json):
+  - MCP server binaries and configs
+  - Installed once, available to all projects
+  - `hool init` checks and installs missing ones
+
+PROJECT-LEVEL (.hool/mcps.json):
+  - Read-only manifest: which MCPs this project uses
+  - NOT an installer -- just a reference
+  - Helps `hool init` know what to check globally
+
+PROJECT-LEVEL (.hool/context-config.json):
+  - hool-context-mcp reads this for per-project indexing config
+  - Which dirs to watch, chunking rules, ignore patterns
+```

package/dist/adapters/claude-code.d.ts

@@ -0,0 +1,8 @@
+import type { Adapter, AdapterConfig, McpDefinition, AgentPlatform } from './types.js';
+export declare class ClaudeCodeAdapter implements Adapter {
+    readonly platform: AgentPlatform;
+    injectInstructions(config: AdapterConfig): Promise<void>;
+    installMcp(mcp: McpDefinition): Promise<void>;
+    isMcpInstalled(mcpName: string): Promise<boolean>;
+    getCompletionMessage(config: AdapterConfig): string;
+}

package/dist/adapters/claude-code.js

@@ -0,0 +1,119 @@
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+const CLAUDE_MCP_CONFIG_PATH = path.join(os.homedir(), '.claude', 'mcp_servers.json');
+function getMcpSection(projectType) {
+    const mcps = ['- **context7**: Use `mcp__context7__resolve-library-id` and `mcp__context7__query-docs` for up-to-date library documentation'];
+    if (['web-app', 'browser-game', 'animation'].includes(projectType)) {
+        mcps.push('- **playwright**: Use for E2E testing, screenshots, visual comparison, and browser automation');
+    }
+    if (projectType === 'mobile-android') {
+        mcps.push('- **adb**: Use for Android device/emulator interaction (must be installed on PATH)');
+    }
+    return mcps.join('\n');
+}
+function generateClaudeMd(config) {
+    return `# HOOL — Agent-Driven SDLC
+
+This project uses the HOOL framework. The Product Lead is the sole user-facing agent.
+All other agents are internal — dispatched by the Product Lead as subagents.
+
+## Quick Start
+
+You are the Product Lead. On every invocation:
+1. Read \`.hool/prompts/orchestrator.md\` — your full process and rules
+2. Read \`operations/current-phase.md\` to know where you are
+3. Read \`operations/task-board.md\` to know what's in flight
+4. Read your memory files (\`memory/product-lead/hot.md\`, \`best-practices.md\`, \`issues.md\`)
+5. Continue from where you left off (see Autonomous Execution Loop in orchestrator.md)
+
+## How to Dispatch Subagents
+
+When you need to dispatch an agent (Phases 5-12), use the **Agent tool**:
+
+1. Read the agent's prompt from \`.hool/prompts/agents/\`
+2. Read the agent's memory files (\`memory/<agent>/hot.md\`, \`best-practices.md\`, \`issues.md\`)
+3. Call the Agent tool with:
+   - \`prompt\`: The task description + relevant context file paths
+   - The subagent reads its own prompt, memory, and the files you specify
+4. When the subagent returns, check its output and continue the dispatch loop
+
+### Agent Registry
+All agents are defined in \`.hool/agents.json\` — read it for the full list of agents, their prompts, memory paths, and which phases they participate in.
+
+## MCP Tools Available
+
+MCP server configs are in \`.hool/mcps.json\` and installed to your platform's MCP config.
+
+${getMcpSection(config.projectType)}
+
+## Key Rules
+
+- You are the **sole user-facing agent** — the user only talks to you
+- After Phase 4 sign-off, the human is OUT — you run autonomously
+- All state lives in files: \`phases/\`, \`operations/\`, \`memory/\`
+- Agents never modify their own prompts — escalate to \`operations/needs-human-review.md\`
+- Read your full orchestrator prompt at \`.hool/prompts/orchestrator.md\` for the complete process
+`;
+}
+export class ClaudeCodeAdapter {
+    platform = 'claude-code';
+    async injectInstructions(config) {
+        const claudeMdPath = path.join(config.projectDir, 'CLAUDE.md');
+        const content = generateClaudeMd(config);
+        // Append to existing CLAUDE.md or create new
+        try {
+            const existing = await fs.readFile(claudeMdPath, 'utf-8');
+            if (existing.includes('HOOL')) {
+                // Already has HOOL instructions, replace
+                const marker = '# HOOL — Agent-Driven SDLC';
+                const idx = existing.indexOf(marker);
+                if (idx >= 0) {
+                    await fs.writeFile(claudeMdPath, existing.slice(0, idx) + content, 'utf-8');
+                }
+            }
+            else {
+                await fs.writeFile(claudeMdPath, existing + '\n\n' + content, 'utf-8');
+            }
+        }
+        catch {
+            await fs.writeFile(claudeMdPath, content, 'utf-8');
+        }
+    }
+    async installMcp(mcp) {
+        const configDir = path.dirname(CLAUDE_MCP_CONFIG_PATH);
+        await fs.mkdir(configDir, { recursive: true });
+        let config = {};
+        try {
+            const raw = await fs.readFile(CLAUDE_MCP_CONFIG_PATH, 'utf-8');
+            config = JSON.parse(raw);
+        }
+        catch {
+            // File doesn't exist or is invalid — start fresh
+        }
+        config[mcp.name] = mcp.configEntry;
+        await fs.writeFile(CLAUDE_MCP_CONFIG_PATH, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    }
+    async isMcpInstalled(mcpName) {
+        try {
+            const raw = await fs.readFile(CLAUDE_MCP_CONFIG_PATH, 'utf-8');
+            const config = JSON.parse(raw);
+            return mcpName in config;
+        }
+        catch {
+            return false;
+        }
+    }
+    getCompletionMessage(config) {
+        return [
+            '',
+            '  Start building:',
+            '    $ claude',
+            '    > Read .hool/prompts/orchestrator.md and begin Phase 1: Brainstorm',
+            '',
+            '  Or if you have the /hool skill registered:',
+            '    > /hool start',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/adapters/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/adapters/claude-code.ts"],"names":[],"mappings":"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"}

package/dist/adapters/cursor.d.ts

@@ -0,0 +1,8 @@
+import type { Adapter, AdapterConfig, McpDefinition, AgentPlatform } from './types.js';
+export declare class CursorAdapter implements Adapter {
+    readonly platform: AgentPlatform;
+    injectInstructions(config: AdapterConfig): Promise<void>;
+    installMcp(mcp: McpDefinition): Promise<void>;
+    isMcpInstalled(mcpName: string): Promise<boolean>;
+    getCompletionMessage(config: AdapterConfig): string;
+}

package/dist/adapters/cursor.js

@@ -0,0 +1,76 @@
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+const CURSOR_MCP_CONFIG_PATH = path.join(os.homedir(), '.cursor', 'mcp.json');
+function generateCursorRules(config) {
+    return `# HOOL — Agent-Driven SDLC
+
+This project uses the HOOL framework. You are the Product Lead — the sole user-facing agent.
+
+## On Every Message
+
+1. Read \`operations/current-phase.md\` to know where you are
+2. Read \`operations/task-board.md\` to know what's in flight
+3. Read your memory: \`memory/product-lead/hot.md\`, \`best-practices.md\`, \`issues.md\`
+4. Follow the full process in \`.hool/prompts/orchestrator.md\`
+
+## Agent Dispatch
+
+When you need to dispatch an agent, read the agent's prompt from \`.hool/prompts/agents/\` and follow its instructions directly. In Cursor, agents are not spawned as subprocesses — you switch roles by loading the relevant prompt and executing its process.
+
+After completing the agent's task, switch back to Product Lead role and continue the dispatch loop.
+
+## Key Rules
+
+- You are the **sole user-facing agent** — the user only talks to you
+- After Phase 4 sign-off, the human is OUT — you run autonomously
+- All state lives in files: \`phases/\`, \`operations/\`, \`memory/\`
+- Agents never modify their own prompts — escalate to \`operations/needs-human-review.md\`
+`;
+}
+export class CursorAdapter {
+    platform = 'cursor';
+    async injectInstructions(config) {
+        const rulesDir = path.join(config.projectDir, '.cursor', 'rules');
+        await fs.mkdir(rulesDir, { recursive: true });
+        const rulesPath = path.join(rulesDir, 'hool.mdc');
+        const content = generateCursorRules(config);
+        await fs.writeFile(rulesPath, content, 'utf-8');
+    }
+    async installMcp(mcp) {
+        const configDir = path.dirname(CURSOR_MCP_CONFIG_PATH);
+        await fs.mkdir(configDir, { recursive: true });
+        let config = {};
+        try {
+            const raw = await fs.readFile(CURSOR_MCP_CONFIG_PATH, 'utf-8');
+            config = JSON.parse(raw);
+        }
+        catch {
+            // Fresh config
+        }
+        if (!config.mcpServers)
+            config.mcpServers = {};
+        config.mcpServers[mcp.name] = mcp.configEntry;
+        await fs.writeFile(CURSOR_MCP_CONFIG_PATH, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+    }
+    async isMcpInstalled(mcpName) {
+        try {
+            const raw = await fs.readFile(CURSOR_MCP_CONFIG_PATH, 'utf-8');
+            const config = JSON.parse(raw);
+            return mcpName in (config.mcpServers || {});
+        }
+        catch {
+            return false;
+        }
+    }
+    getCompletionMessage(config) {
+        return [
+            '',
+            '  Start building:',
+            '    1. Open this project in Cursor',
+            '    2. The .cursor/rules/hool.mdc will load automatically',
+            '    3. Tell the agent: "Read .hool/prompts/orchestrator.md and begin Phase 1: Brainstorm"',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=cursor.js.map

package/dist/adapters/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/adapters/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AAGpB,MAAM,sBAAsB,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAE9E,SAAS,mBAAmB,CAAC,MAAqB;IAChD,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuBR,CAAC;AACF,CAAC;AAED,MAAM,OAAO,aAAa;IACf,QAAQ,GAAkB,QAAQ,CAAC;IAE5C,KAAK,CAAC,kBAAkB,CAAC,MAAqB;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;QAClE,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE9C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC5C,MAAM,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAkB;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;QACvD,MAAM,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/C,IAAI,MAAM,GAA6C,EAAE,CAAC;QAC1D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;YAC/D,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,MAAM,CAAC,UAAU,GAAG,EAAE,CAAC;QAC/C,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,WAAW,CAAC;QAC9C,MAAM,EAAE,CAAC,SAAS,CAAC,sBAAsB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9F,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,OAAe;QAClC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC/B,OAAO,OAAO,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,oBAAoB,CAAC,MAAqB;QACxC,OAAO;YACL,EAAE;YACF,mBAAmB;YACnB,oCAAoC;YACpC,2DAA2D;YAC3D,2FAA2F;SAC5F,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF"}

package/dist/adapters/generic.d.ts

@@ -0,0 +1,8 @@
+import type { Adapter, AdapterConfig, McpDefinition, AgentPlatform } from './types.js';
+export declare class GenericAdapter implements Adapter {
+    readonly platform: AgentPlatform;
+    injectInstructions(config: AdapterConfig): Promise<void>;
+    installMcp(_mcp: McpDefinition): Promise<void>;
+    isMcpInstalled(_mcpName: string): Promise<boolean>;
+    getCompletionMessage(config: AdapterConfig): string;
+}

package/dist/adapters/generic.js

@@ -0,0 +1,63 @@
+import fs from 'fs/promises';
+import path from 'path';
+function generateInstructions(config) {
+    return `# HOOL — Agent-Driven SDLC
+
+This project uses the HOOL framework for agent-driven development.
+
+## Setup
+
+Your AI agent needs to act as the Product Lead. Load the orchestrator prompt:
+
+  .hool/prompts/orchestrator.md
+
+This prompt tells the agent:
+- How to manage phases (0-12)
+- How to dispatch internal agents (by loading their prompts from .hool/prompts/agents/)
+- How to use the memory system (memory/<agent>/)
+- How to manage operations files (operations/)
+
+## On Every Session
+
+1. Read \`operations/current-phase.md\` — know where you are
+2. Read \`operations/task-board.md\` — know what's in flight
+3. Read \`memory/product-lead/hot.md\` — your recent context
+4. Follow the process in \`.hool/prompts/orchestrator.md\`
+
+## MCP Servers
+
+This project uses the following MCPs (install them for your platform):
+${config.projectType === 'web-app' || config.projectType === 'browser-game' || config.projectType === 'animation'
+        ? '- context7: npx -y @context7/mcp\n- playwright: npx @anthropic/mcp-playwright'
+        : '- context7: npx -y @context7/mcp'}
+
+See .hool/mcps.json for the full manifest.
+`;
+}
+export class GenericAdapter {
+    platform = 'generic';
+    async injectInstructions(config) {
+        const instructionsPath = path.join(config.projectDir, 'HOOL-INSTRUCTIONS.md');
+        await fs.writeFile(instructionsPath, generateInstructions(config), 'utf-8');
+    }
+    async installMcp(_mcp) {
+        // Generic adapter can't install MCPs — the user's platform handles it
+        // Just log what needs to be installed
+    }
+    async isMcpInstalled(_mcpName) {
+        // Can't check — assume not installed, instructions will list them
+        return false;
+    }
+    getCompletionMessage(config) {
+        return [
+            '',
+            '  Start building:',
+            '    1. Open this project in your AI coding tool',
+            '    2. Load the instructions from HOOL-INSTRUCTIONS.md',
+            '    3. Tell the agent: "Read .hool/prompts/orchestrator.md and begin Phase 1: Brainstorm"',
+            '',
+            '  Note: Install the MCPs listed in .hool/mcps.json for your platform manually.',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=generic.js.map

package/dist/adapters/generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../src/adapters/generic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,SAAS,oBAAoB,CAAC,MAAqB;IACjD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;EA0BP,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,MAAM,CAAC,WAAW,KAAK,cAAc,IAAI,MAAM,CAAC,WAAW,KAAK,WAAW;QAC7G,CAAC,CAAC,+EAA+E;QACjF,CAAC,CAAC,kCACJ;;;CAGD,CAAC;AACF,CAAC;AAED,MAAM,OAAO,cAAc;IAChB,QAAQ,GAAkB,SAAS,CAAC;IAE7C,KAAK,CAAC,kBAAkB,CAAC,MAAqB;QAC5C,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,sBAAsB,CAAC,CAAC;QAC9E,MAAM,EAAE,CAAC,SAAS,CAAC,gBAAgB,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAmB;QAClC,sEAAsE;QACtE,sCAAsC;IACxC,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAgB;QACnC,kEAAkE;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oBAAoB,CAAC,MAAqB;QACxC,OAAO;YACL,EAAE;YACF,mBAAmB;YACnB,iDAAiD;YACjD,wDAAwD;YACxD,2FAA2F;YAC3F,EAAE;YACF,gFAAgF;SACjF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;CACF"}

package/dist/adapters/index.d.ts

@@ -0,0 +1,3 @@
+import type { Adapter, AgentPlatform } from './types.js';
+export declare function createAdapter(platform: AgentPlatform): Adapter;
+export type { Adapter, AdapterConfig, AgentPlatform, ProjectType, McpDefinition } from './types.js';

package/dist/adapters/index.js

@@ -0,0 +1,11 @@
+import { ClaudeCodeAdapter } from './claude-code.js';
+import { CursorAdapter } from './cursor.js';
+import { GenericAdapter } from './generic.js';
+export function createAdapter(platform) {
+    switch (platform) {
+        case 'claude-code': return new ClaudeCodeAdapter();
+        case 'cursor': return new CursorAdapter();
+        case 'generic': return new GenericAdapter();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,UAAU,aAAa,CAAC,QAAuB;IACnD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,aAAa,CAAC,CAAC,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACnD,KAAK,QAAQ,CAAC,CAAC,OAAO,IAAI,aAAa,EAAE,CAAC;QAC1C,KAAK,SAAS,CAAC,CAAC,OAAO,IAAI,cAAc,EAAE,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/adapters/types.d.ts

@@ -0,0 +1,24 @@
+export type ProjectType = 'web-app' | 'browser-game' | 'mobile-android' | 'animation' | 'cli-tool' | 'api-only' | 'desktop' | 'other';
+export type AgentPlatform = 'claude-code' | 'cursor' | 'generic';
+export interface McpDefinition {
+    name: string;
+    installCommand: string;
+    configEntry: Record<string, unknown>;
+}
+export interface AdapterConfig {
+    platform: AgentPlatform;
+    projectType: ProjectType;
+    projectDir: string;
+    promptsDir: string;
+}
+export interface Adapter {
+    readonly platform: AgentPlatform;
+    /** Inject agent instructions into the platform's config (CLAUDE.md, .cursor/rules/, etc.) */
+    injectInstructions(config: AdapterConfig): Promise<void>;
+    /** Install an MCP into the platform's global config */
+    installMcp(mcp: McpDefinition): Promise<void>;
+    /** Check if an MCP is already installed */
+    isMcpInstalled(mcpName: string): Promise<boolean>;
+    /** Get platform-specific completion message */
+    getCompletionMessage(config: AdapterConfig): string;
+}

package/dist/adapters/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":""}

package/dist/core/scaffold.d.ts

@@ -0,0 +1,6 @@
+import type { ProjectType } from '../adapters/types.js';
+export type ExecutionMode = 'interactive' | 'full-hool';
+export declare function scaffoldProject(projectDir: string, projectType: ProjectType, mode?: ExecutionMode): Promise<void>;
+export declare function copyPrompts(projectDir: string, promptsSourceDir: string): Promise<void>;
+export declare function writeMcpManifest(projectDir: string, projectType: ProjectType, requiredMcps: string[]): Promise<void>;
+export declare function writeAgentManifest(projectDir: string): Promise<void>;