@planu/cli 0.30.0 → 0.31.0

package/src/config/llm-providers.json

@@ -0,0 +1,198 @@
+{
+  "providers": [
+    {
+      "id": "anthropic",
+      "name": "Anthropic",
+      "apiKeyEnv": "ANTHROPIC_API_KEY",
+      "baseUrl": "https://api.anthropic.com",
+      "capabilities": ["chat", "code", "vision"],
+      "keyPattern": "^sk-ant-",
+      "rateLimits": { "requestsPerMinute": 60, "tokensPerMinute": 100000 },
+      "models": [
+        {
+          "id": "claude-opus-4",
+          "name": "Claude Opus 4",
+          "tier": "high",
+          "pricingPerMToken": { "input": 15.0, "output": 75.0 },
+          "contextWindow": 200000,
+          "maxOutputTokens": 32000
+        },
+        {
+          "id": "claude-sonnet-4",
+          "name": "Claude Sonnet 4",
+          "tier": "medium",
+          "pricingPerMToken": { "input": 3.0, "output": 15.0 },
+          "contextWindow": 200000,
+          "maxOutputTokens": 16000
+        },
+        {
+          "id": "claude-haiku-3.5",
+          "name": "Claude Haiku 3.5",
+          "tier": "low",
+          "pricingPerMToken": { "input": 0.8, "output": 4.0 },
+          "contextWindow": 200000,
+          "maxOutputTokens": 8192
+        }
+      ]
+    },
+    {
+      "id": "openai",
+      "name": "OpenAI",
+      "apiKeyEnv": "OPENAI_API_KEY",
+      "baseUrl": "https://api.openai.com",
+      "capabilities": ["chat", "code", "vision", "embeddings"],
+      "keyPattern": "^sk-",
+      "rateLimits": { "requestsPerMinute": 60, "tokensPerMinute": 150000 },
+      "models": [
+        {
+          "id": "gpt-4o",
+          "name": "GPT-4o",
+          "tier": "high",
+          "pricingPerMToken": { "input": 2.5, "output": 10.0 },
+          "contextWindow": 128000,
+          "maxOutputTokens": 16384
+        },
+        {
+          "id": "gpt-4o-mini",
+          "name": "GPT-4o Mini",
+          "tier": "medium",
+          "pricingPerMToken": { "input": 0.15, "output": 0.6 },
+          "contextWindow": 128000,
+          "maxOutputTokens": 16384
+        },
+        {
+          "id": "gpt-3.5-turbo",
+          "name": "GPT-3.5 Turbo",
+          "tier": "low",
+          "pricingPerMToken": { "input": 0.5, "output": 1.5 },
+          "contextWindow": 16385,
+          "maxOutputTokens": 4096
+        }
+      ]
+    },
+    {
+      "id": "google",
+      "name": "Google AI (Gemini)",
+      "apiKeyEnv": "GOOGLE_AI_API_KEY",
+      "baseUrl": "https://generativelanguage.googleapis.com",
+      "capabilities": ["chat", "code", "vision", "embeddings"],
+      "keyPattern": "^AI",
+      "rateLimits": { "requestsPerMinute": 60, "tokensPerMinute": 120000 },
+      "models": [
+        {
+          "id": "gemini-2.0-ultra",
+          "name": "Gemini 2.0 Ultra",
+          "tier": "high",
+          "pricingPerMToken": { "input": 7.0, "output": 21.0 },
+          "contextWindow": 1000000,
+          "maxOutputTokens": 8192
+        },
+        {
+          "id": "gemini-2.0-pro",
+          "name": "Gemini 2.0 Pro",
+          "tier": "medium",
+          "pricingPerMToken": { "input": 1.25, "output": 5.0 },
+          "contextWindow": 1000000,
+          "maxOutputTokens": 8192
+        },
+        {
+          "id": "gemini-2.0-flash",
+          "name": "Gemini 2.0 Flash",
+          "tier": "low",
+          "pricingPerMToken": { "input": 0.075, "output": 0.3 },
+          "contextWindow": 1000000,
+          "maxOutputTokens": 8192
+        }
+      ]
+    },
+    {
+      "id": "mistral",
+      "name": "Mistral AI",
+      "apiKeyEnv": "MISTRAL_API_KEY",
+      "baseUrl": "https://api.mistral.ai",
+      "capabilities": ["chat", "code"],
+      "keyPattern": "^[a-zA-Z0-9]",
+      "rateLimits": { "requestsPerMinute": 30, "tokensPerMinute": 60000 },
+      "models": [
+        {
+          "id": "mistral-large",
+          "name": "Mistral Large",
+          "tier": "high",
+          "pricingPerMToken": { "input": 3.0, "output": 9.0 },
+          "contextWindow": 128000,
+          "maxOutputTokens": 8192
+        },
+        {
+          "id": "mistral-medium",
+          "name": "Mistral Medium",
+          "tier": "medium",
+          "pricingPerMToken": { "input": 2.7, "output": 8.1 },
+          "contextWindow": 32000,
+          "maxOutputTokens": 8192
+        },
+        {
+          "id": "mistral-small",
+          "name": "Mistral Small",
+          "tier": "low",
+          "pricingPerMToken": { "input": 1.0, "output": 3.0 },
+          "contextWindow": 32000,
+          "maxOutputTokens": 8192
+        }
+      ]
+    },
+    {
+      "id": "ollama",
+      "name": "Ollama (Local)",
+      "apiKeyEnv": "",
+      "baseUrl": "http://localhost:11434",
+      "capabilities": ["chat", "code"],
+      "keyPattern": "",
+      "rateLimits": { "requestsPerMinute": 999, "tokensPerMinute": 999999 },
+      "models": [
+        {
+          "id": "llama3.1-70b",
+          "name": "Llama 3.1 70B",
+          "tier": "medium",
+          "pricingPerMToken": { "input": 0, "output": 0 },
+          "contextWindow": 128000,
+          "maxOutputTokens": 8192
+        },
+        {
+          "id": "llama3.1-8b",
+          "name": "Llama 3.1 8B",
+          "tier": "low",
+          "pricingPerMToken": { "input": 0, "output": 0 },
+          "contextWindow": 128000,
+          "maxOutputTokens": 8192
+        }
+      ]
+    },
+    {
+      "id": "deepseek",
+      "name": "DeepSeek",
+      "apiKeyEnv": "DEEPSEEK_API_KEY",
+      "baseUrl": "https://api.deepseek.com",
+      "capabilities": ["chat", "code"],
+      "keyPattern": "^sk-",
+      "rateLimits": { "requestsPerMinute": 60, "tokensPerMinute": 100000 },
+      "models": [
+        {
+          "id": "deepseek-v3",
+          "name": "DeepSeek V3",
+          "tier": "high",
+          "pricingPerMToken": { "input": 0.27, "output": 1.1 },
+          "contextWindow": 64000,
+          "maxOutputTokens": 8192
+        },
+        {
+          "id": "deepseek-chat",
+          "name": "DeepSeek Chat",
+          "tier": "medium",
+          "pricingPerMToken": { "input": 0.14, "output": 0.28 },
+          "contextWindow": 64000,
+          "maxOutputTokens": 8192
+        }
+      ]
+    }
+  ]
+}

package/src/config/model-equivalences.json

@@ -0,0 +1,41 @@
+{
+  "equivalences": [
+    {
+      "tier": "high",
+      "models": [
+        { "providerId": "anthropic", "modelId": "claude-opus-4" },
+        { "providerId": "openai", "modelId": "gpt-4o" },
+        { "providerId": "google", "modelId": "gemini-2.0-ultra" },
+        { "providerId": "mistral", "modelId": "mistral-large" },
+        { "providerId": "deepseek", "modelId": "deepseek-v3" }
+      ],
+      "qualityScore": 0.95,
+      "speedScore": 0.5
+    },
+    {
+      "tier": "medium",
+      "models": [
+        { "providerId": "anthropic", "modelId": "claude-sonnet-4" },
+        { "providerId": "openai", "modelId": "gpt-4o-mini" },
+        { "providerId": "google", "modelId": "gemini-2.0-pro" },
+        { "providerId": "mistral", "modelId": "mistral-medium" },
+        { "providerId": "ollama", "modelId": "llama3.1-70b" },
+        { "providerId": "deepseek", "modelId": "deepseek-chat" }
+      ],
+      "qualityScore": 0.8,
+      "speedScore": 0.75
+    },
+    {
+      "tier": "low",
+      "models": [
+        { "providerId": "anthropic", "modelId": "claude-haiku-3.5" },
+        { "providerId": "openai", "modelId": "gpt-3.5-turbo" },
+        { "providerId": "google", "modelId": "gemini-2.0-flash" },
+        { "providerId": "mistral", "modelId": "mistral-small" },
+        { "providerId": "ollama", "modelId": "llama3.1-8b" }
+      ],
+      "qualityScore": 0.6,
+      "speedScore": 0.95
+    }
+  ]
+}

package/src/config/model-language-affinity.json

@@ -0,0 +1,16 @@
+{
+  "affinities": [
+    { "language": "typescript", "preferredProviders": ["anthropic", "openai", "deepseek"], "weight": 0.1 },
+    { "language": "javascript", "preferredProviders": ["anthropic", "openai", "deepseek"], "weight": 0.1 },
+    { "language": "python", "preferredProviders": ["openai", "anthropic", "deepseek"], "weight": 0.1 },
+    { "language": "go", "preferredProviders": ["google", "anthropic", "openai"], "weight": 0.1 },
+    { "language": "rust", "preferredProviders": ["anthropic", "deepseek", "openai"], "weight": 0.1 },
+    { "language": "java", "preferredProviders": ["openai", "anthropic", "google"], "weight": 0.1 },
+    { "language": "kotlin", "preferredProviders": ["openai", "anthropic", "google"], "weight": 0.1 },
+    { "language": "swift", "preferredProviders": ["anthropic", "openai", "google"], "weight": 0.1 },
+    { "language": "php", "preferredProviders": ["openai", "anthropic", "mistral"], "weight": 0.1 },
+    { "language": "ruby", "preferredProviders": ["openai", "anthropic", "mistral"], "weight": 0.1 },
+    { "language": "csharp", "preferredProviders": ["openai", "anthropic", "google"], "weight": 0.1 },
+    { "language": "dart", "preferredProviders": ["google", "openai", "anthropic"], "weight": 0.1 }
+  ]
+}

package/src/config/orchestration-templates.json

@@ -0,0 +1,76 @@
+{
+  "templates": [
+    {
+      "id": "feature-build",
+      "name": "Feature Build",
+      "description": "Build a complete feature with coordinator, implementer, and tester agents.",
+      "topology": "hierarchical",
+      "agentRoles": [
+        { "role": "coordinator", "capabilities": ["planning", "review"], "modelTier": "opus", "count": 1 },
+        { "role": "implementer", "capabilities": ["coding", "refactoring"], "modelTier": "sonnet", "count": "dynamic" },
+        { "role": "tester", "capabilities": ["testing", "quality"], "modelTier": "sonnet", "count": 1 }
+      ],
+      "defaultOptions": { "maxRetries": 2, "timeoutMs": 600000, "failFast": false, "conflictStrategy": "merge-auto" },
+      "taskDecompositionStrategy": "by-acceptance-criteria"
+    },
+    {
+      "id": "security-audit",
+      "name": "Security Audit",
+      "description": "Audit security across modules with a lead and per-module auditors.",
+      "topology": "star",
+      "agentRoles": [
+        { "role": "security-lead", "capabilities": ["security", "analysis"], "modelTier": "opus", "count": 1 },
+        { "role": "module-auditor", "capabilities": ["security", "review"], "modelTier": "sonnet", "count": "dynamic" }
+      ],
+      "defaultOptions": {
+        "maxRetries": 1,
+        "timeoutMs": 300000,
+        "failFast": false,
+        "conflictStrategy": "flag-for-review"
+      },
+      "taskDecompositionStrategy": "by-module"
+    },
+    {
+      "id": "code-review",
+      "name": "Code Review",
+      "description": "Parallel code review with N reviewers across the codebase.",
+      "topology": "mesh",
+      "agentRoles": [
+        {
+          "role": "reviewer",
+          "capabilities": ["review", "analysis", "quality"],
+          "modelTier": "sonnet",
+          "count": "dynamic"
+        }
+      ],
+      "defaultOptions": { "maxRetries": 1, "timeoutMs": 300000, "failFast": false, "conflictStrategy": "merge-auto" },
+      "taskDecompositionStrategy": "by-file-group"
+    },
+    {
+      "id": "migration",
+      "name": "Migration",
+      "description": "Step-by-step migration with analyzer, planner, implementer, and verifier stages.",
+      "topology": "pipeline",
+      "agentRoles": [
+        { "role": "analyzer", "capabilities": ["analysis", "detection"], "modelTier": "sonnet", "count": 1 },
+        { "role": "planner", "capabilities": ["planning", "architecture"], "modelTier": "opus", "count": 1 },
+        { "role": "implementer", "capabilities": ["coding", "refactoring"], "modelTier": "sonnet", "count": 1 },
+        { "role": "verifier", "capabilities": ["testing", "validation"], "modelTier": "sonnet", "count": 1 }
+      ],
+      "defaultOptions": { "maxRetries": 2, "timeoutMs": 600000, "failFast": true, "conflictStrategy": "first-wins" },
+      "taskDecompositionStrategy": "by-stage"
+    },
+    {
+      "id": "spec-implementation",
+      "name": "Spec Implementation",
+      "description": "Implement a large spec with coordinator and N workers per criteria group.",
+      "topology": "hierarchical",
+      "agentRoles": [
+        { "role": "coordinator", "capabilities": ["planning", "review"], "modelTier": "opus", "count": 1 },
+        { "role": "worker", "capabilities": ["coding", "testing"], "modelTier": "sonnet", "count": "dynamic" }
+      ],
+      "defaultOptions": { "maxRetries": 2, "timeoutMs": 600000, "failFast": false, "conflictStrategy": "merge-auto" },
+      "taskDecompositionStrategy": "by-acceptance-criteria"
+    }
+  ]
+}

package/src/config/orchestration-topologies.json

@@ -0,0 +1,36 @@
+{
+  "topologies": {
+    "mesh": {
+      "id": "mesh",
+      "name": "Mesh (All-to-All)",
+      "description": "All agents work in parallel without a central coordinator. Results are reconciled at the end.",
+      "maxAgents": 10,
+      "supportsFailFast": true,
+      "bestFor": ["code-review", "parallel-testing", "independent-modules"]
+    },
+    "hierarchical": {
+      "id": "hierarchical",
+      "name": "Hierarchical (Coordinator + Workers)",
+      "description": "One coordinator agent decomposes tasks, workers execute. Workers report to coordinator.",
+      "maxAgents": 8,
+      "supportsFailFast": true,
+      "bestFor": ["feature-build", "spec-implementation", "large-refactors"]
+    },
+    "pipeline": {
+      "id": "pipeline",
+      "name": "Pipeline (Sequential Stages)",
+      "description": "Agents execute in sequence. Output of each stage becomes input for the next.",
+      "maxAgents": 5,
+      "supportsFailFast": true,
+      "bestFor": ["migrations", "staged-processing", "build-chains"]
+    },
+    "star": {
+      "id": "star",
+      "name": "Star (Hub-Spoke)",
+      "description": "One hub agent coordinates N spoke agents. Spokes report only to the hub.",
+      "maxAgents": 8,
+      "supportsFailFast": true,
+      "bestFor": ["security-audit", "multi-module-analysis", "distributed-testing"]
+    }
+  }
+}

package/src/config/plugin-marketplace.json

@@ -0,0 +1,59 @@
+{
+  "marketplace": [
+    {
+      "id": "healthcare-templates",
+      "name": "Healthcare Spec Templates",
+      "description": "HIPAA-compliant spec templates for healthcare applications. Includes patient data handling, EHR integration, and clinical workflow patterns.",
+      "author": "planu-community",
+      "repository": "https://github.com/planu-community/healthcare-templates",
+      "version": "1.0.0",
+      "downloads": 0,
+      "rating": 0,
+      "tags": ["healthcare", "hipaa", "templates", "compliance"]
+    },
+    {
+      "id": "fintech-compliance",
+      "name": "Fintech Compliance Analyzer",
+      "description": "Analyzes specs and code for PCI-DSS, SOX, and financial regulation compliance. Detects missing security controls and audit trails.",
+      "author": "planu-community",
+      "repository": "https://github.com/planu-community/fintech-compliance",
+      "version": "1.0.0",
+      "downloads": 0,
+      "rating": 0,
+      "tags": ["fintech", "compliance", "pci-dss", "analyzer", "security"]
+    },
+    {
+      "id": "gaming-specs",
+      "name": "Gaming Spec Templates",
+      "description": "Spec templates for game development: multiplayer networking, game state management, asset pipelines, and platform-specific builds.",
+      "author": "planu-community",
+      "repository": "https://github.com/planu-community/gaming-specs",
+      "version": "1.0.0",
+      "downloads": 0,
+      "rating": 0,
+      "tags": ["gaming", "templates", "multiplayer", "gamedev"]
+    },
+    {
+      "id": "api-security-analyzer",
+      "name": "API Security Analyzer",
+      "description": "Detects OWASP API Top 10 vulnerabilities in specs and API definitions. Supports REST, GraphQL, and gRPC across all languages.",
+      "author": "planu-community",
+      "repository": "https://github.com/planu-community/api-security-analyzer",
+      "version": "1.0.0",
+      "downloads": 0,
+      "rating": 0,
+      "tags": ["security", "api", "owasp", "analyzer", "rest", "graphql"]
+    },
+    {
+      "id": "mobile-platform-templates",
+      "name": "Mobile Platform Templates",
+      "description": "Spec templates for mobile development across iOS (Swift/SwiftUI), Android (Kotlin/Compose), Flutter, and React Native.",
+      "author": "planu-community",
+      "repository": "https://github.com/planu-community/mobile-platform-templates",
+      "version": "1.0.0",
+      "downloads": 0,
+      "rating": 0,
+      "tags": ["mobile", "ios", "android", "flutter", "react-native", "templates"]
+    }
+  ]
+}

package/src/config/security-runtime-config.json

@@ -0,0 +1,26 @@
+{
+  "level": "standard",
+  "rateLimits": {
+    "read": {
+      "maxTokens": 60,
+      "refillRatePerSecond": 1,
+      "burstMultiplier": 2,
+      "burstDurationMs": 5000
+    },
+    "write": {
+      "maxTokens": 30,
+      "refillRatePerSecond": 0.5,
+      "burstMultiplier": 2,
+      "burstDurationMs": 5000
+    },
+    "destructive": {
+      "maxTokens": 10,
+      "refillRatePerSecond": 0.167,
+      "burstMultiplier": 2,
+      "burstDurationMs": 5000
+    }
+  },
+  "allowedDirectories": [],
+  "customInjectionPatterns": [],
+  "disabledCheckers": []
+}

package/src/config/workers-registry.json

@@ -0,0 +1,100 @@
+{
+  "workers": [
+    {
+      "name": "test-gaps",
+      "description": "Detects source files without corresponding test files across TypeScript, Python, Go, Rust, and Java projects",
+      "trigger": {
+        "type": "file-change",
+        "patterns": ["**/*.ts", "**/*.py", "**/*.go", "**/*.rs", "**/*.java", "**/*.kt"]
+      },
+      "handler": "handlers/test-gaps",
+      "priority": 7,
+      "cooldownMs": 30000,
+      "enabled": true,
+      "tier": "free"
+    },
+    {
+      "name": "security-audit",
+      "description": "Scans for hardcoded secrets, unsafe eval/exec, SQL injection patterns, and insecure defaults",
+      "trigger": {
+        "type": "file-change",
+        "patterns": [
+          "**/*.ts",
+          "**/*.js",
+          "**/*.py",
+          "**/*.go",
+          "**/*.rs",
+          "**/*.java",
+          "**/*.env",
+          "**/*.yml",
+          "**/*.yaml"
+        ]
+      },
+      "handler": "handlers/security-audit",
+      "priority": 9,
+      "cooldownMs": 30000,
+      "enabled": true,
+      "tier": "free"
+    },
+    {
+      "name": "optimization",
+      "description": "Detects large files, long functions, high cyclomatic complexity, and potential circular imports",
+      "trigger": {
+        "type": "file-change",
+        "patterns": ["**/*.ts", "**/*.js", "**/*.py", "**/*.go", "**/*.rs", "**/*.java"]
+      },
+      "handler": "handlers/optimization",
+      "priority": 5,
+      "cooldownMs": 30000,
+      "enabled": true,
+      "tier": "free"
+    },
+    {
+      "name": "code-map",
+      "description": "Builds file/export dependency map with directory tree, entry points, and import graph",
+      "trigger": {
+        "type": "file-change",
+        "patterns": ["**/*.ts", "**/*.js", "**/*.py", "**/*.go", "**/*.rs", "**/*.java"]
+      },
+      "handler": "handlers/code-map",
+      "priority": 4,
+      "cooldownMs": 60000,
+      "enabled": true,
+      "tier": "pro"
+    },
+    {
+      "name": "documentation",
+      "description": "Finds exported functions, classes, and types without JSDoc, docstrings, or doc comments",
+      "trigger": {
+        "type": "file-change",
+        "patterns": ["**/*.ts", "**/*.js", "**/*.py", "**/*.go", "**/*.rs", "**/*.java"]
+      },
+      "handler": "handlers/documentation",
+      "priority": 3,
+      "cooldownMs": 60000,
+      "enabled": true,
+      "tier": "pro"
+    },
+    {
+      "name": "dependency-health",
+      "description": "Analyzes package.json, pyproject.toml, go.mod, Cargo.toml, and pom.xml for unpinned or risky dependencies",
+      "trigger": {
+        "type": "file-change",
+        "patterns": [
+          "**/package.json",
+          "**/pyproject.toml",
+          "**/requirements.txt",
+          "**/go.mod",
+          "**/Cargo.toml",
+          "**/pom.xml",
+          "**/build.gradle"
+        ]
+      },
+      "handler": "handlers/dependency-health",
+      "priority": 6,
+      "cooldownMs": 60000,
+      "enabled": true,
+      "tier": "free"
+    }
+  ]
+}