perf-skill 0.2.1 → 0.4.0

package/.claude-plugin/README.md

@@ -0,0 +1,48 @@
+# perf-skill - Claude Code Plugin
+
+This directory contains the Claude Code plugin configuration for perf-skill.
+
+## Plugin Structure
+
+```
+perf-skill/
+  .claude-plugin/
+    plugin.json          # Plugin manifest (metadata only)
+    README.md            # This file
+  skills/
+    perf-skill/
+      SKILL.md           # Skill definition (discovered by Claude Code)
+```
+
+Claude Code discovers skills via the `skills/` directory convention. The `plugin.json` provides metadata; skill contents are found automatically.
+
+## Installation via Marketplace
+
+Users install this plugin in two steps:
+
+```text
+# 1. Add the marketplace (this repo)
+/plugin marketplace add skillsland/perf-skill
+
+# 2. Install the plugin from the marketplace
+/plugin install perf-skill@skillsland-perf
+```
+
+## Alternative: CLI Installation (project-level)
+
+For project-level installation (commits skill to repo):
+
+```bash
+npx perf-skill init --ai claude
+```
+
+This copies the skill to `.claude/skills/perf-skill/SKILL.md` in the current project.
+
+## Version Sync
+
+Keep `version` in `plugin.json` synchronized with `package.json`.
+
+## Support
+
+- Issues: https://github.com/skillsland/perf-skill/issues
+- Documentation: https://github.com/skillsland/perf-skill#readme

package/.claude-plugin/marketplace.json

@@ -0,0 +1,27 @@
+{
+  "name": "skillsland-perf",
+  "owner": {
+    "name": "skillsland",
+    "email": "nicasio@foxmail.com"
+  },
+  "metadata": {
+    "description": "Performance profiling plugins for Claude Code"
+  },
+  "plugins": [
+    {
+      "name": "perf-skill",
+      "description": "Analyze pprof CPU and heap profiles and generate evidence-based performance recommendations.",
+      "version": "0.3.0",
+      "author": {
+        "name": "skillsland"
+      },
+      "source": {
+        "source": "github",
+        "repo": "skillsland/perf-skill",
+        "ref": "main"
+      },
+      "category": "Development workflows",
+      "tags": ["performance", "pprof", "profiling", "cpu", "heap", "optimization"]
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "perf-skill",
+  "version": "0.3.0",
+  "description": "Analyze pprof CPU and heap profiles and generate evidence-based performance recommendations.",
+  "author": {
+    "name": "skillsland"
+  },
+  "repository": "https://github.com/skillsland/perf-skill",
+  "homepage": "https://github.com/skillsland/perf-skill",
+  "license": "MIT",
+  "keywords": [
+    "performance",
+    "profiling",
+    "pprof",
+    "cpu",
+    "heap",
+    "memory",
+    "optimization",
+    "analysis"
+  ]
+}

package/CLAUDE.md

@@ -0,0 +1,166 @@
+# CLAUDE.md - Developer Guide for perf-skill
+
+This document provides guidelines for AI agents and developers working with the perf-skill codebase.
+
+## Project Overview
+
+perf-skill is an AI skill that converts pprof CPU and heap profiles (.pb.gz) into structured Markdown and JSON evidence. It follows a **deterministic, evidence-first** design philosophy - the tool produces factual data without AI dependencies, while AI agents can optionally enhance the output with recommendations.
+
+## Repository Structure
+
+```
+perf-skill/
+├── src/
+│   ├── cli/              # CLI implementation
+│   │   ├── main.ts       # CLI entry point
+│   │   ├── init.ts       # Skill installation logic
+│   │   ├── platforms.ts  # Multi-platform configurations
+│   │   └── template.ts   # Template rendering engine
+│   ├── parser/           # pprof parsing logic
+│   ├── renderer/         # Markdown/JSON output
+│   ├── profile/          # Node.js profiling
+│   └── index.ts          # Library exports
+├── test/                 # Test files
+├── skills/
+│   └── perf-skill/
+│       └── SKILL.md      # Main skill definition (single source of truth)
+├── .claude-plugin/       # Claude Code plugin configs
+├── package.json
+└── README.md
+```
+
+## Key Commands
+
+### Development
+
+```bash
+# Build
+npm run build
+
+# Run CLI in development
+npm run cli -- analyze profile.pb.gz
+
+# Run tests
+npm test
+
+# Lint
+npm run lint
+```
+
+### CLI Usage
+
+```bash
+# Analyze a profile
+npx perf-skill analyze cpu.pb.gz -o report.md
+
+# Compare profiles
+npx perf-skill diff base.pb.gz current.pb.gz
+
+# Profile and analyze a Node.js app
+npx perf-skill run app.js --duration 10s
+
+# Install skill for a platform
+npx perf-skill init --ai cursor
+npx perf-skill init --ai claude
+npx perf-skill init --ai all
+```
+
+## Architecture Decisions
+
+### Evidence-First Design
+
+- The core analyzer produces structured data without AI
+- LLM integration is optional (via `--ai` flag)
+- All outputs are reproducible and deterministic
+
+### Multi-Platform Support
+
+The `init` command supports 13+ AI platforms:
+- Claude, Cursor, Windsurf, Copilot, Kiro
+- Codex, Qoder, Roo Code, Gemini, Trae
+- OpenCode, Continue, CodeBuddy
+
+Each platform has its own configuration in `src/cli/platforms.ts`.
+
+### Template System
+
+Platform-specific skill files are generated from:
+1. Base `skills/perf-skill/SKILL.md` content
+2. Platform configuration (frontmatter, sections)
+3. Template engine in `src/cli/template.ts`
+
+## Contributing Guidelines
+
+### Code Style
+
+- Use TypeScript strict mode
+- Follow existing patterns for error handling
+- Add tests for new features
+- Update `skills/perf-skill/SKILL.md` for user-facing changes
+
+### Testing
+
+```bash
+# Run all tests
+npm test
+
+# Run specific test file
+node --test --import tsx test/parser.test.ts
+```
+
+### Pull Request Process
+
+1. Create feature branch from `main`
+2. Make changes with descriptive commits
+3. Ensure tests pass: `npm test`
+4. Ensure lint passes: `npm run lint`
+5. Update documentation if needed
+6. Submit PR with clear description
+
+## Common Tasks
+
+### Adding a New Platform
+
+1. Add platform to `AI_PLATFORMS` array in `src/cli/platforms.ts`
+2. Add configuration to `PLATFORM_CONFIGS` object
+3. Test installation: `npm run cli -- init --ai <platform>`
+
+### Updating SKILL.md
+
+1. Edit `skills/perf-skill/SKILL.md`
+2. Test rendering: `npm run cli -- init --ai claude --dry-run`
+3. Verify frontmatter is valid YAML
+
+### Publishing
+
+```bash
+# Bump version
+npm version patch|minor|major
+
+# Publish to npm
+npm publish
+
+# Sync Claude Marketplace
+# - Update version in .claude-plugin/plugin.json
+# - Submit to marketplace for review
+```
+
+## Debugging
+
+### Common Issues
+
+1. **Profile parsing fails**: Check file is valid gzip-compressed protobuf
+2. **Source code not included**: Verify `--source-dir` path exists
+3. **Platform install fails**: Check directory permissions
+
+### Verbose Mode
+
+```bash
+npx perf-skill analyze profile.pb.gz --verbose
+```
+
+## Security Considerations
+
+- Profile data may contain sensitive information
+- Use `--redact` (default) to sanitize paths
+- Never commit real profiles to the repository

package/README.md

@@ -4,14 +4,23 @@
 [![npm version](https://badge.fury.io/js/perf-skill.svg)](http://badge.fury.io/js/perf-skill)
 ![license](https://img.shields.io/npm/l/perf-skill)
 
-AI‑assisted pprof toolkit for CPU/heap profiles: convert .pb.gz/.pprof to structured Markdown, compare profiles for regressions, and optionally generate evidence‑backed recommendations.
+**Deterministic** pprof evidence extractor for CPU/heap profiles: convert .pb.gz/.pprof to structured Markdown and JSON, compare profiles for regressions, and produce evidence that any AI agent can use for optimization recommendations.
+
+## Philosophy
+
+This tool follows the "evidence generator" pattern:
+
+1. **Deterministic by default** — All operations produce consistent, reproducible output without external API calls
+2. **LLM-agnostic** — The tool produces structured evidence (hotspots, call paths, metrics); the host agent (Claude, Cursor, etc.) performs reasoning
+3. **No network by default** — No data leaves your machine unless you explicitly enable AI analysis with `--ai`
+4. **Skill-ready** — Designed to work as a Claude Skill / Cursor Agent Skill that provides facts for the agent to interpret
 
 ## Features
 
-- **Convert**: Transform pprof profiles to structured Markdown
-- **Analyze**: Get AI-powered optimization recommendations
-- **Diff**: Compare two profiles to find regressions
-- **Multi-format**: Library, CLI, and HTTP API
+- **Convert** (default): Transform pprof profiles to structured Markdown and JSON evidence
+- **Analyze**: Optionally get AI-powered recommendations with `--ai` flag
+- **Diff**: Compare two profiles to find regressions and improvements
+- **Multiple interfaces**: Library API and CLI for direct integration
 
 ## Installation
 
@@ -25,32 +34,56 @@ Or run directly with npx:
 npx perf-skill analyze profile.pb.gz
 ```
 
+### AI Platform Integration
+
+Install perf-skill as a skill for your preferred AI coding assistant:
+
+```bash
+# Claude Code / Claude Desktop
+npx perf-skill init --ai claude
+
+# Cursor
+npx perf-skill init --ai cursor
+
+# GitHub Copilot
+npx perf-skill init --ai copilot
+
+# All supported platforms at once
+npx perf-skill init --ai all
+```
+
+See [Supported Platforms](#supported-platforms) for the full list.
+
 ## Quick Start
 
 ### CLI Usage
 
 ```bash
-# Convert profile to markdown (fast, no LLM)
-perf-skill convert cpu.pb.gz -o report.md
+# Analyze profile → structured evidence (default, no LLM, no network)
+perf-skill analyze cpu.pb.gz -o report.md
+
+# Analyze with explicit AI recommendations (requires API key)
+perf-skill analyze cpu.pb.gz --ai -o report.md
 
-# Full analysis with AI recommendations
-perf-skill analyze cpu.pb.gz --mode analyze
+# Convert-only command (always deterministic)
+perf-skill convert cpu.pb.gz -o report.md
 
-# Profile a Node entry (CPU, 10s) and analyze
+# Profile a Node entry (CPU, 10s) → evidence output
 perf-skill run slow.mjs --duration 10s
 
+# Profile with AI recommendations
+perf-skill run slow.mjs --duration 10s --ai
+
 # CPU + Heap profiling (separate reports)
 perf-skill run slow.mjs --heap --output cpu.md --heap-output heap.md
 
 # Compare two profiles
 perf-skill diff base.pb.gz current.pb.gz -o diff.md
 
-# Start HTTP server
-perf-skill server --port 3000
-
-# Install SKILL.md for Cursor (user or project)
-perf-skill init --cursor
-perf-skill init --cursor --scope project
+# Install skill for your AI platform
+perf-skill init --ai claude
+perf-skill init --ai cursor --scope project
+perf-skill init --ai all  # Install to all supported platforms
 
 # Install SKILL.md to a custom directory
 perf-skill init ./skills/perf-skill
@@ -59,14 +92,15 @@ perf-skill init ./skills/perf-skill
 ### Programmatic Usage
 
 ```typescript
-import { analyze, diff } from "perf-skill-skill";
+import { analyze, diff } from "perf-skill";
 
-// Convert only (no LLM)
-const result = await analyze("cpu.pb.gz", { mode: "convert-only" });
-console.log(result.markdown);
-console.log(result.hotspots);
+// Default: deterministic evidence extraction (no LLM, no network)
+const result = await analyze("cpu.pb.gz");
+console.log(result.markdown);    // Structured Markdown report
+console.log(result.hotspots);    // Array of hotspot objects
+console.log(result.raw.llmStatus); // "skipped" - no LLM was invoked
 
-// Full analysis with AI recommendations
+// Explicit AI analysis (requires API key)
 const fullResult = await analyze("cpu.pb.gz", {
   mode: "analyze",
   context: {
@@ -76,8 +110,9 @@ const fullResult = await analyze("cpu.pb.gz", {
   },
 });
 console.log(fullResult.recommendations);
+console.log(fullResult.raw.llmStatus); // "success" or "failed"
 
-// Compare two profiles
+// Compare two profiles (always deterministic)
 const diffResult = await diff("base.pb.gz", "current.pb.gz", {
   normalize: "scale-to-base-total",
 });
@@ -85,43 +120,27 @@ console.log(diffResult.regressions);
 console.log(diffResult.improvements);
 ```
 
-### HTTP API
-
-```bash
-# Start server
-perf-skill server
-
-# Start server with security overrides
-perf-skill server --no-cors --no-helmet --rate-limit --rate-limit-max 120 --rate-limit-window-ms 60000
-
-# Analyze profile
-curl -X POST http://localhost:3000/v1/pprof/analyze \
-  -F "file=@cpu.pb.gz"
-
-# Compare profiles
-curl -X POST http://localhost:3000/v1/pprof/diff \
-  -F "base=@base.pb.gz" \
-  -F "current=@current.pb.gz"
-```
-
 ## CLI Options
 
 ### `perf-skill analyze <profile.pb.gz>`
 
-| Option                 | Description                                      | Default    |
-| ---------------------- | ------------------------------------------------ | ---------- |
-| `-f, --format`         | Output format: `summary`, `detailed`, `adaptive` | `adaptive` |
-| `-t, --type`           | Profile type: `cpu`, `heap`, `auto`              | `auto`     |
-| `-o, --output`         | Output markdown file                             | stdout     |
-| `-j, --json`           | Output JSON results file                         | -          |
-| `-m, --mode`           | `convert-only` or `analyze`                      | `analyze`  |
-| `-s, --source-dir`     | Source directory for code context                | -          |
-| `--max-hotspots`       | Maximum hotspots to show                         | `10`       |
-| `--llm-provider`       | LLM provider: `openai`, `anthropic`, etc.        | `openai`   |
-| `--llm-model`          | LLM model name                                   | `gpt-5.2`  |
-| `--service`            | Service name for context                         | -          |
-| `--scenario`           | Scenario description                             | -          |
-| `--redact/--no-redact` | Redact sensitive information                     | `true`     |
+| Option                 | Description                                      | Default        |
+| ---------------------- | ------------------------------------------------ | -------------- |
+| `-f, --format`         | Output format: `summary`, `detailed`, `adaptive` | `adaptive`     |
+| `-t, --type`           | Profile type: `cpu`, `heap`, `auto`              | `auto`         |
+| `-o, --output`         | Output markdown file                             | stdout         |
+| `-j, --json`           | Output JSON results file                         | -              |
+| `-m, --mode`           | `convert-only` or `analyze`                      | `convert-only` |
+| `--ai`                 | Enable AI-powered recommendations (requires key) | `false`        |
+| `-s, --source-dir`     | Source directory for code context                | -              |
+| `--max-hotspots`       | Maximum hotspots to show                         | `10`           |
+| `--llm-provider`       | LLM provider: `openai`, `anthropic`, etc.        | `openai`       |
+| `--llm-model`          | LLM model name                                   | `gpt-5.2`      |
+| `--service`            | Service name for context                         | -              |
+| `--scenario`           | Scenario description                             | -              |
+| `--redact/--no-redact` | Redact sensitive information                     | `true`         |
+
+> **Note:** By default, `analyze` produces deterministic evidence output (no LLM). Use `--ai` to explicitly enable AI recommendations.
 
 ### `perf-skill run <entry> [entryArgs...]`
 
@@ -139,7 +158,8 @@ curl -X POST http://localhost:3000/v1/pprof/diff \
 | `-t, --type`            | Profile type: `cpu`, `heap`, `auto`              | `auto`                      |
 | `-o, --output`          | Output markdown file                             | stdout                      |
 | `-j, --json`            | Output JSON results file                         | -                           |
-| `-m, --mode`            | `convert-only` or `analyze`                      | `analyze`                   |
+| `-m, --mode`            | `convert-only` or `analyze`                      | `convert-only`              |
+| `--ai`                  | Enable AI-powered recommendations (requires key) | `false`                     |
 | `-s, --source-dir`      | Source directory for code context                | -                           |
 | `--max-hotspots`        | Maximum hotspots to show                         | `10`                        |
 | `--llm-provider`        | LLM provider: `openai`, `anthropic`, etc.        | `openai`                    |
@@ -150,6 +170,8 @@ curl -X POST http://localhost:3000/v1/pprof/diff \
 
 When `--heap` is enabled and `--output` is omitted, `perf-skill` writes `cpu.md` and `heap.md` instead of printing to stdout.
 
+> **Note:** By default, `run` produces deterministic evidence output (no LLM). Use `--ai` to explicitly enable AI recommendations.
+
 ### `perf-skill profile <entry> [entryArgs...]`
 
 | Option                  | Description                                 | Default      |
@@ -173,14 +195,49 @@ When `--heap` is enabled and `--output` is omitted, `perf-skill` writes `cpu.md`
 
 ### `perf-skill init [target]`
 
-Install the bundled `SKILL.md` to a target directory or Cursor skills folder.
+Install the `SKILL.md` to a target directory or AI platform.
+
+| Option         | Description                            | Default   |
+| -------------- | -------------------------------------- | --------- |
+| `-a, --ai`     | Target AI platform (see below)         | -         |
+| `-c, --cursor` | Install into Cursor (legacy)           | `false`   |
+| `--scope`      | Installation scope: `user` or `project`| `project` |
+| `-f, --force`  | Overwrite existing `SKILL.md`          | `false`   |
+| `--dry-run`    | Show destination without writing files | `false`   |
+| `--offline`    | Use bundled assets only                | `false`   |
+
+#### Supported Platforms
+
+| Platform    | Command                         | Install Location                        |
+| ----------- | ------------------------------- | --------------------------------------- |
+| Claude      | `--ai claude`                   | `.claude/skills/perf-skill/SKILL.md`    |
+| Cursor      | `--ai cursor`                   | `.cursor/skills/perf-skill/SKILL.md`    |
+| Windsurf    | `--ai windsurf`                 | `.windsurf/skills/perf-skill/SKILL.md`  |
+| Copilot     | `--ai copilot`                  | `.github/copilot/perf-skill.md`         |
+| Kiro        | `--ai kiro`                     | `.kiro/skills/perf-skill/SKILL.md`      |
+| Codex       | `--ai codex`                    | `.codex/skills/perf-skill/SKILL.md`     |
+| Qoder       | `--ai qoder`                    | `.qodo/skills/perf-skill/SKILL.md`      |
+| Roo Code    | `--ai roocode`                  | `.roo/skills/perf-skill/SKILL.md`       |
+| Gemini      | `--ai gemini`                   | `.gemini/skills/perf-skill/SKILL.md`    |
+| Trae        | `--ai trae`                     | `.trae/skills/perf-skill/SKILL.md`      |
+| OpenCode    | `--ai opencode`                 | `.opencode/skills/perf-skill/SKILL.md`  |
+| Continue    | `--ai continue`                 | `.continue/skills/perf-skill/SKILL.md`  |
+| CodeBuddy   | `--ai codebuddy`                | `.codebuddy/skills/perf-skill/SKILL.md` |
+| **All**     | `--ai all`                      | Installs to all platforms               |
+
+```bash
+# Install for Claude
+npx perf-skill init --ai claude
+
+# Install for Cursor (project scope)
+npx perf-skill init --ai cursor --scope project
 
-| Option         | Description                            | Default |
-| -------------- | -------------------------------------- | ------- |
-| `-c, --cursor` | Install into Cursor skills folder      | `false` |
-| `--scope`      | Cursor scope: `user` or `project`      | `user`  |
-| `-f, --force`  | Overwrite existing `SKILL.md`          | `false` |
-| `--dry-run`    | Show destination without writing files | `false` |
+# Install for all supported platforms
+npx perf-skill init --ai all
+
+# Preview installation without writing
+npx perf-skill init --ai cursor --dry-run
+```
 
 ## Output Formats
 
@@ -209,9 +266,9 @@ Full context with call trees and source code.
 
 Summary with drill-down sections and anchor links for navigation.
 
-## AI Recommendations
+## AI Recommendations (Optional)
 
-When using `--mode analyze`, the tool generates structured recommendations:
+When using `--ai` (or `--mode analyze`), the tool invokes an LLM to generate structured recommendations:
 
 ```typescript
 interface Recommendation {
@@ -226,6 +283,8 @@ interface Recommendation {
 
 All recommendations must reference evidence from the profile (function names, percentages, locations).
 
+> **Note:** For Skill/Agent usage, it is recommended to let the host agent (Claude, Cursor, etc.) generate recommendations based on the deterministic evidence output. This keeps the tool LLM-agnostic and allows the agent to apply its own reasoning.
+
 ## Profile Diff
 
 Compare two profiles to identify performance regressions:
@@ -288,12 +347,6 @@ writeFileSync("heap.pb.gz", gzipSync(heapProfile.encode()));
 | `LLM_RETRY_DELAY_MS`   | Base retry delay in ms                          |
 | `LOG_LEVEL`            | Logging level: `debug`, `info`, `warn`, `error` |
 | `LOG_FORMAT`           | Log format: `text`, `json`                      |
-| `CORS_ENABLED`         | Enable CORS (`true`/`false`)                    |
-| `CORS_ORIGIN`          | CORS origin(s), comma-separated or `*`          |
-| `HELMET_ENABLED`       | Enable Helmet (`true`/`false`)                  |
-| `RATE_LIMIT_ENABLED`   | Enable rate limiting (`true`/`false`)           |
-| `RATE_LIMIT_MAX`       | Rate limit max requests per window              |
-| `RATE_LIMIT_WINDOW_MS` | Rate limit window size in ms                    |
 
 Example:
 
@@ -331,47 +384,13 @@ By default, the tool redacts:
 
 Disable with `--no-redact` or `redact: false`.
 
-### Server Mode
-
-In HTTP server mode:
-
-- Source code inclusion is disabled by default
-- File size limits are enforced
-- Only `.pb.gz` files are accepted
-
-Security defaults (configurable via env or server options):
-
-- CORS enabled (set `CORS_ENABLED=false` to disable)
-- Helmet enabled (set `HELMET_ENABLED=false` to disable)
-- Rate limiting enabled (default 60 req/min, set `RATE_LIMIT_ENABLED=false` or `RATE_LIMIT_MAX=0` to disable)
-
-Server CLI flags (override env defaults):
-
-- `--cors/--no-cors`
-- `--cors-origin <origin>` (comma-separated or `*`)
-- `--helmet/--no-helmet`
-- `--rate-limit/--no-rate-limit`
-- `--rate-limit-max <n>`
-- `--rate-limit-window-ms <ms>`
-
-ServerOptions (programmatic):
-
-```typescript
-const server = await createServer({
-  enableCors: true,
-  corsOrigin: "https://example.com",
-  enableHelmet: true,
-  enableRateLimit: true,
-  rateLimitMax: 60,
-  rateLimitWindowMs: 60_000,
-});
-```
-
 ## Requirements
 
 - Node.js >= 22.6.0
-- For AI analysis: API key for OpenAI, Anthropic, or compatible provider
 - CPU profiling uses bundled `@datadog/pprof` (native module) on supported platforms
+- **Optional:** For AI recommendations (`--ai`), an API key for OpenAI, Anthropic, or compatible provider
+
+> **No API key required for default usage.** The tool produces complete, actionable evidence without any external dependencies.
 
 ## API Reference
 

package/dist/cli/init.d.ts

@@ -1,20 +1,32 @@
 /**
- * CLI init command helpers - install SKILL.md into a target directory
+ * CLI init command helpers - install SKILL.md into target directories for multiple AI platforms
  */
+import { type AIPlatform } from "./platforms.js";
 export type CursorScope = "user" | "project";
 export interface InitOptions {
     target?: string;
     cursor?: boolean;
+    platform?: AIPlatform;
     scope?: CursorScope;
     force?: boolean;
     dryRun?: boolean;
+    offline?: boolean;
 }
 export interface InstallTarget {
-    layout: "cursor" | "flat" | "file";
+    platform: string;
+    layout: "cursor" | "flat" | "file" | "platform";
     rootDir: string;
     destDir: string;
     destFile: string;
 }
+export interface InitResult {
+    success: boolean;
+    targets: InstallTarget[];
+    errors: Array<{
+        platform: string;
+        error: string;
+    }>;
+}
 export declare function parseSkillFrontmatterName(markdown: string): string | null;
 export declare function isReservedCursorDir(targetPath: string): boolean;
 export declare function resolveInstallTarget(options: {
@@ -25,5 +37,9 @@ export declare function resolveInstallTarget(options: {
     cwd: string;
     homeDir: string;
 }): InstallTarget;
-export declare function runInit(options: InitOptions): Promise<InstallTarget>;
+/**
+ * Run init command - supports multiple platforms
+ */
+export declare function runInit(options: InitOptions): Promise<InitResult>;
+export { AI_PLATFORMS, type AIPlatform } from "./platforms.js";
 //# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAaD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAczE;AAUD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE/D;AASD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,aAAa,CAmDhB;AAuBD,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAgC1E"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/cli/init.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,OAAO,EACL,KAAK,UAAU,EAKhB,MAAM,gBAAgB,CAAC;AAGxB,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,SAAS,CAAC;AAE7C,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAaD,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAczE;AAUD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE/D;AASD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,aAAa,CAuDhB;AA4ED;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA4FvE;AAGD,OAAO,EAAE,YAAY,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC"}