specweave 0.30.11 → 0.30.13

package/dist/src/core/llm/providers/openai-provider.js

@@ -0,0 +1,119 @@
+/**
+ * OpenAI Provider
+ *
+ * Implements LLMProvider interface for OpenAI's GPT models.
+ * Uses openai SDK for API calls.
+ *
+ * TODO: Implement following the same pattern as anthropic-provider.ts
+ */
+import { MODEL_PRICING } from '../types.js';
+import { consoleLogger } from '../../../utils/logger.js';
+export class OpenAIProvider {
+    constructor(config) {
+        this.name = 'openai';
+        this.apiKey = config.apiKey;
+        this.defaultModel = config.model || 'gpt-4o';
+        this.maxTokens = config.maxTokens || 4096;
+        this.temperature = config.temperature ?? 0.3;
+        this.baseUrl = config.baseUrl || 'https://api.openai.com/v1';
+        this.logger = config.logger || consoleLogger;
+    }
+    async getClient() {
+        if (!this.client) {
+            const OpenAI = (await import('openai')).default;
+            this.client = new OpenAI({
+                apiKey: this.apiKey,
+                baseURL: this.baseUrl,
+            });
+        }
+        return this.client;
+    }
+    async analyze(prompt, options = {}) {
+        const startTime = Date.now();
+        const model = options.model || this.defaultModel;
+        const client = await this.getClient();
+        const messages = [];
+        if (options.systemPrompt) {
+            messages.push({ role: 'system', content: options.systemPrompt });
+        }
+        messages.push({ role: 'user', content: prompt });
+        const response = await client.chat.completions.create({
+            model,
+            max_tokens: options.maxTokens || this.maxTokens,
+            temperature: options.temperature ?? this.temperature,
+            messages,
+        });
+        const content = response.choices[0]?.message?.content || '';
+        const usage = {
+            inputTokens: response.usage?.prompt_tokens || 0,
+            outputTokens: response.usage?.completion_tokens || 0,
+            totalTokens: response.usage?.total_tokens || 0,
+        };
+        return {
+            content,
+            usage,
+            estimatedCost: this.estimateCost(usage.inputTokens, usage.outputTokens, model),
+            model,
+            durationMs: Date.now() - startTime,
+            wasRetry: false,
+        };
+    }
+    async analyzeStructured(prompt, options) {
+        // OpenAI supports native JSON mode
+        const client = await this.getClient();
+        const model = options.model || this.defaultModel;
+        const messages = [
+            {
+                role: 'system',
+                content: `You are a helpful assistant that responds in JSON format matching this schema: ${JSON.stringify(options.schema)}`,
+            },
+            { role: 'user', content: prompt },
+        ];
+        const response = await client.chat.completions.create({
+            model,
+            max_tokens: options.maxTokens || this.maxTokens,
+            temperature: options.temperature ?? 0.1,
+            messages,
+            response_format: { type: 'json_object' },
+        });
+        const content = response.choices[0]?.message?.content || '{}';
+        const usage = {
+            inputTokens: response.usage?.prompt_tokens || 0,
+            outputTokens: response.usage?.completion_tokens || 0,
+            totalTokens: response.usage?.total_tokens || 0,
+        };
+        const data = JSON.parse(content);
+        return {
+            data,
+            usage,
+            estimatedCost: this.estimateCost(usage.inputTokens, usage.outputTokens, model),
+        };
+    }
+    estimateCost(inputTokens, outputTokens, model) {
+        const modelId = model || this.defaultModel;
+        const pricing = MODEL_PRICING[modelId] || { inputPer1M: 5, outputPer1M: 15 };
+        return (inputTokens / 1000000) * pricing.inputPer1M +
+            (outputTokens / 1000000) * pricing.outputPer1M;
+    }
+    async isAvailable() {
+        try {
+            const status = await this.getStatus();
+            return status.available;
+        }
+        catch {
+            return false;
+        }
+    }
+    async getStatus() {
+        const startTime = Date.now();
+        try {
+            const client = await this.getClient();
+            await client.models.list();
+            return { available: true, latencyMs: Date.now() - startTime };
+        }
+        catch (error) {
+            return { available: false, error: error.message };
+        }
+    }
+}
+//# sourceMappingURL=openai-provider.js.map

package/dist/src/core/llm/providers/openai-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-provider.js","sourceRoot":"","sources":["../../../../../src/core/llm/providers/openai-provider.ts"],"names":[],"mappings":"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"}

package/dist/src/core/llm/providers/vertex-ai-provider.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Google Vertex AI Provider
+ *
+ * Implements LLMProvider interface for Google's Gemini models via Vertex AI.
+ *
+ * Best for: GCP-native environments, Gemini model access
+ *
+ * NOTE: Requires @google-cloud/vertexai
+ */
+import type { LLMProvider, AnalyzeOptions, AnalyzeResult, StructuredOptions } from '../types.js';
+import { Logger } from '../../../utils/logger.js';
+export interface VertexAIProviderConfig {
+    projectId?: string;
+    location?: string;
+    model?: string;
+    maxTokens?: number;
+    temperature?: number;
+    logger?: Logger;
+}
+export declare class VertexAIProvider implements LLMProvider {
+    readonly name: "vertex-ai";
+    readonly defaultModel: string;
+    private projectId;
+    private location;
+    private maxTokens;
+    private temperature;
+    private logger;
+    private client;
+    private model;
+    constructor(config: VertexAIProviderConfig);
+    private getModel;
+    analyze(prompt: string, options?: AnalyzeOptions): Promise<AnalyzeResult>;
+    analyzeStructured<T>(prompt: string, options: StructuredOptions<T>): Promise<{
+        data: T;
+        usage: AnalyzeResult['usage'];
+        estimatedCost: number;
+    }>;
+    estimateCost(inputTokens: number, outputTokens: number): number;
+    isAvailable(): Promise<boolean>;
+    getStatus(): Promise<{
+        available: boolean;
+        latencyMs?: number;
+        error?: string;
+    }>;
+}
+//# sourceMappingURL=vertex-ai-provider.d.ts.map

package/dist/src/core/llm/providers/vertex-ai-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertex-ai-provider.d.ts","sourceRoot":"","sources":["../../../../../src/core/llm/providers/vertex-ai-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,iBAAiB,EAClB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,MAAM,EAAiB,MAAM,0BAA0B,CAAC;AAEjE,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAiB,YAAW,WAAW;IAClD,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,KAAK,CAAM;gBAEP,MAAM,EAAE,sBAAsB;YAS5B,QAAQ;IAgBhB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IA4C7E,iBAAiB,CAAC,CAAC,EACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IAuB7E,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAezD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAK/B,SAAS,IAAI,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAiBvF"}

package/dist/src/core/llm/providers/vertex-ai-provider.js

@@ -0,0 +1,123 @@
+/**
+ * Google Vertex AI Provider
+ *
+ * Implements LLMProvider interface for Google's Gemini models via Vertex AI.
+ *
+ * Best for: GCP-native environments, Gemini model access
+ *
+ * NOTE: Requires @google-cloud/vertexai
+ */
+import { consoleLogger } from '../../../utils/logger.js';
+export class VertexAIProvider {
+    constructor(config) {
+        this.name = 'vertex-ai';
+        this.projectId = config.projectId || process.env.GOOGLE_CLOUD_PROJECT || '';
+        this.location = config.location || process.env.GOOGLE_CLOUD_LOCATION || 'us-central1';
+        this.defaultModel = config.model || 'gemini-1.5-pro';
+        this.maxTokens = config.maxTokens || 4096;
+        this.temperature = config.temperature ?? 0.3;
+        this.logger = config.logger || consoleLogger;
+    }
+    async getModel() {
+        if (!this.model) {
+            const { VertexAI } = await import('@google-cloud/vertexai');
+            this.client = new VertexAI({
+                project: this.projectId,
+                location: this.location,
+            });
+            this.model = this.client.getGenerativeModel({
+                model: this.defaultModel,
+            });
+        }
+        return this.model;
+    }
+    async analyze(prompt, options = {}) {
+        const startTime = Date.now();
+        const model = await this.getModel();
+        const systemInstruction = options.systemPrompt
+            ? { role: 'system', parts: [{ text: options.systemPrompt }] }
+            : undefined;
+        const request = {
+            contents: [
+                { role: 'user', parts: [{ text: prompt }] },
+            ],
+            systemInstruction,
+            generationConfig: {
+                maxOutputTokens: options.maxTokens || this.maxTokens,
+                temperature: options.temperature ?? this.temperature,
+            },
+        };
+        const response = await model.generateContent(request);
+        const result = response.response;
+        const content = result.candidates?.[0]?.content?.parts?.[0]?.text || '';
+        // Vertex AI provides usage metadata
+        const usageMetadata = result.usageMetadata || {};
+        const inputTokens = usageMetadata.promptTokenCount || 0;
+        const outputTokens = usageMetadata.candidatesTokenCount || 0;
+        return {
+            content,
+            usage: {
+                inputTokens,
+                outputTokens,
+                totalTokens: inputTokens + outputTokens,
+            },
+            estimatedCost: this.estimateCost(inputTokens, outputTokens),
+            model: this.defaultModel,
+            durationMs: Date.now() - startTime,
+            wasRetry: false,
+        };
+    }
+    async analyzeStructured(prompt, options) {
+        const jsonPrompt = `${prompt}
+
+Respond with valid JSON matching: ${JSON.stringify(options.schema)}
+Return ONLY the JSON object, no markdown.`;
+        const result = await this.analyze(jsonPrompt, {
+            ...options,
+            temperature: 0.1,
+        });
+        let jsonContent = result.content.trim();
+        if (jsonContent.startsWith('```')) {
+            jsonContent = jsonContent.replace(/^```json?\n?/, '').replace(/\n?```$/, '');
+        }
+        return {
+            data: JSON.parse(jsonContent),
+            usage: result.usage,
+            estimatedCost: result.estimatedCost,
+        };
+    }
+    estimateCost(inputTokens, outputTokens) {
+        // Gemini 1.5 Pro pricing
+        const model = this.defaultModel;
+        if (model.includes('gemini-1.5-pro')) {
+            // Under 128k context
+            return (inputTokens / 1000000) * 1.25 + (outputTokens / 1000000) * 5;
+        }
+        if (model.includes('gemini-1.5-flash')) {
+            return (inputTokens / 1000000) * 0.075 + (outputTokens / 1000000) * 0.3;
+        }
+        return (inputTokens / 1000000) * 1.25 + (outputTokens / 1000000) * 5;
+    }
+    async isAvailable() {
+        const status = await this.getStatus();
+        return status.available;
+    }
+    async getStatus() {
+        const startTime = Date.now();
+        try {
+            if (!this.projectId) {
+                return { available: false, error: 'GOOGLE_CLOUD_PROJECT not set' };
+            }
+            const model = await this.getModel();
+            // Simple check - try to get model info
+            return {
+                available: !!model,
+                latencyMs: Date.now() - startTime,
+            };
+        }
+        catch (error) {
+            return { available: false, error: error.message };
+        }
+    }
+}
+//# sourceMappingURL=vertex-ai-provider.js.map

package/dist/src/core/llm/providers/vertex-ai-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vertex-ai-provider.js","sourceRoot":"","sources":["../../../../../src/core/llm/providers/vertex-ai-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAQH,OAAO,EAAU,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAWjE,MAAM,OAAO,gBAAgB;IAY3B,YAAY,MAA8B;QAXjC,SAAI,GAAG,WAAoB,CAAC;QAYnC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,EAAE,CAAC;QAC5E,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,aAAa,CAAC;QACtF,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,KAAK,IAAI,gBAAgB,CAAC;QACrD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC;QAC1C,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,GAAG,CAAC;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,aAAa,CAAC;IAC/C,CAAC;IAEO,KAAK,CAAC,QAAQ;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,CAAC;YAE5D,IAAI,CAAC,MAAM,GAAG,IAAI,QAAQ,CAAC;gBACzB,OAAO,EAAE,IAAI,CAAC,SAAS;gBACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;aACxB,CAAC,CAAC;YAEH,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC;gBAC1C,KAAK,EAAE,IAAI,CAAC,YAAY;aACzB,CAAC,CAAC;QACL,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,UAA0B,EAAE;QACxD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;QAEpC,MAAM,iBAAiB,GAAG,OAAO,CAAC,YAAY;YAC5C,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,EAAE;YAC7D,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,OAAO,GAAG;YACd,QAAQ,EAAE;gBACR,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE;aAC5C;YACD,iBAAiB;YACjB,gBAAgB,EAAE;gBAChB,eAAe,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS;gBACpD,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW;aACrD;SACF,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC;QAEjC,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QAExE,oCAAoC;QACpC,MAAM,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;QACjD,MAAM,WAAW,GAAG,aAAa,CAAC,gBAAgB,IAAI,CAAC,CAAC;QACxD,MAAM,YAAY,GAAG,aAAa,CAAC,oBAAoB,IAAI,CAAC,CAAC;QAE7D,OAAO;YACL,OAAO;YACP,KAAK,EAAE;gBACL,WAAW;gBACX,YAAY;gBACZ,WAAW,EAAE,WAAW,GAAG,YAAY;aACxC;YACD,aAAa,EAAE,IAAI,CAAC,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC;YAC3D,KAAK,EAAE,IAAI,CAAC,YAAY;YACxB,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;YAClC,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,iBAAiB,CACrB,MAAc,EACd,OAA6B;QAE7B,MAAM,UAAU,GAAG,GAAG,MAAM;;oCAEI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC;0CACxB,CAAC;QAEvC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE;YAC5C,GAAG,OAAO;YACV,WAAW,EAAE,GAAG;SACjB,CAAC,CAAC;QAEH,IAAI,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAClC,WAAW,GAAG,WAAW,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC/E,CAAC;QAED,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,CAAM;YAClC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,WAAmB,EAAE,YAAoB;QACpD,yBAAyB;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC;QAEhC,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACrC,qBAAqB;YACrB,OAAO,CAAC,WAAW,GAAG,OAAS,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,GAAG,OAAS,CAAC,GAAG,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YACvC,OAAO,CAAC,WAAW,GAAG,OAAS,CAAC,GAAG,KAAK,GAAG,CAAC,YAAY,GAAG,OAAS,CAAC,GAAG,GAAG,CAAC;QAC9E,CAAC;QAED,OAAO,CAAC,WAAW,GAAG,OAAS,CAAC,GAAG,IAAI,GAAG,CAAC,YAAY,GAAG,OAAS,CAAC,GAAG,CAAC,CAAC;IAC3E,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,SAAS,CAAC;IAC1B,CAAC;IAED,KAAK,CAAC,SAAS;QACb,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACpB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC;YACrE,CAAC;YAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,uCAAuC;YACvC,OAAO;gBACL,SAAS,EAAE,CAAC,CAAC,KAAK;gBAClB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QACpD,CAAC;IACH,CAAC;CACF"}

package/dist/src/core/llm/types.d.ts

@@ -0,0 +1,181 @@
+/**
+ * LLM Provider Abstraction Types
+ *
+ * Supports multiple LLM providers for AI-powered features:
+ * - Anthropic (Claude)
+ * - OpenAI (GPT-4, GPT-4o)
+ * - Azure OpenAI
+ * - AWS Bedrock
+ * - Ollama (local)
+ * - Google Vertex AI
+ */
+/**
+ * Supported LLM providers
+ */
+export type LLMProviderType = 'claude-code' | 'anthropic' | 'openai' | 'azure-openai' | 'bedrock' | 'ollama' | 'vertex-ai';
+/**
+ * LLM configuration stored in .specweave/config.json
+ */
+export interface LLMConfig {
+    /** Provider type */
+    provider: LLMProviderType;
+    /** Model identifier (provider-specific) */
+    model: string;
+    /** Environment variable name containing API key */
+    apiKeyEnv?: string;
+    /** Custom base URL (for Azure, Ollama, proxies) */
+    baseUrl?: string;
+    /** Azure-specific: deployment name */
+    azureDeployment?: string;
+    /** Azure-specific: API version */
+    azureApiVersion?: string;
+    /** Bedrock-specific: AWS region */
+    awsRegion?: string;
+    /** Max tokens per request (default: 4096) */
+    maxTokensPerRequest?: number;
+    /** Temperature (default: 0.3 for analysis tasks) */
+    temperature?: number;
+    /** Enable cost tracking */
+    costTracking?: boolean;
+    /** Fallback provider if primary fails */
+    fallback?: LLMConfig;
+}
+/**
+ * Options for a single analysis request
+ */
+export interface AnalyzeOptions {
+    /** Override max tokens for this request */
+    maxTokens?: number;
+    /** Override temperature for this request */
+    temperature?: number;
+    /** Override model for this request */
+    model?: string;
+    /** System prompt (prepended to user prompt) */
+    systemPrompt?: string;
+    /** Request timeout in ms (default: 60000) */
+    timeout?: number;
+    /** Retry count on failure (default: 2) */
+    retries?: number;
+}
+/**
+ * Result of an analysis request
+ */
+export interface AnalyzeResult {
+    /** The response content */
+    content: string;
+    /** Token usage */
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+        totalTokens: number;
+    };
+    /** Estimated cost in USD */
+    estimatedCost: number;
+    /** Model used */
+    model: string;
+    /** Request duration in ms */
+    durationMs: number;
+    /** Whether this was a retry */
+    wasRetry: boolean;
+}
+/**
+ * Structured output options (JSON schema)
+ */
+export interface StructuredOptions<T> extends AnalyzeOptions {
+    /** JSON schema for response validation */
+    schema: JSONSchemaType<T>;
+    /** Strict mode - fail if response doesn't match schema */
+    strict?: boolean;
+}
+/**
+ * JSON Schema type (simplified)
+ */
+export interface JSONSchemaType<T> {
+    type: 'object' | 'array' | 'string' | 'number' | 'boolean';
+    properties?: Record<string, JSONSchemaType<unknown>>;
+    items?: JSONSchemaType<unknown>;
+    required?: string[];
+    description?: string;
+}
+/**
+ * Cost tracking data
+ */
+export interface CostTrackingData {
+    provider: LLMProviderType;
+    model: string;
+    inputTokens: number;
+    outputTokens: number;
+    estimatedCostUSD: number;
+    requestCount: number;
+    startedAt: string;
+    lastUpdatedAt: string;
+}
+/**
+ * LLM Provider interface
+ *
+ * All providers must implement this interface for consistent usage.
+ */
+export interface LLMProvider {
+    /** Provider name for logging */
+    readonly name: LLMProviderType;
+    /** Default model for this provider */
+    readonly defaultModel: string;
+    /**
+     * Analyze text with LLM
+     *
+     * @param prompt - The prompt to send
+     * @param options - Request options
+     * @returns Analysis result with content and usage stats
+     */
+    analyze(prompt: string, options?: AnalyzeOptions): Promise<AnalyzeResult>;
+    /**
+     * Analyze with structured JSON output
+     *
+     * @param prompt - The prompt to send
+     * @param options - Request options with schema
+     * @returns Parsed structured response
+     */
+    analyzeStructured<T>(prompt: string, options: StructuredOptions<T>): Promise<{
+        data: T;
+        usage: AnalyzeResult['usage'];
+        estimatedCost: number;
+    }>;
+    /**
+     * Estimate cost for a request
+     *
+     * @param inputTokens - Number of input tokens
+     * @param outputTokens - Number of output tokens
+     * @param model - Model to use (optional, uses default)
+     * @returns Estimated cost in USD
+     */
+    estimateCost(inputTokens: number, outputTokens: number, model?: string): number;
+    /**
+     * Check if provider is available (API key set, endpoint reachable)
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Get provider health/status
+     */
+    getStatus(): Promise<{
+        available: boolean;
+        latencyMs?: number;
+        error?: string;
+    }>;
+}
+/**
+ * Model pricing per 1M tokens (input/output)
+ */
+export interface ModelPricing {
+    inputPer1M: number;
+    outputPer1M: number;
+}
+/**
+ * Default pricing for known models (USD per 1M tokens)
+ * Updated: 2025-12-03
+ */
+export declare const MODEL_PRICING: Record<string, ModelPricing>;
+/**
+ * Recommended models by use case
+ */
+export declare const RECOMMENDED_MODELS: Record<string, Partial<Record<LLMProviderType, string>>>;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/llm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/core/llm/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,aAAa,GACb,WAAW,GACX,QAAQ,GACR,cAAc,GACd,SAAS,GACT,QAAQ,GACR,WAAW,CAAC;AAEhB;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oBAAoB;IACpB,QAAQ,EAAE,eAAe,CAAC;IAE1B,2CAA2C;IAC3C,KAAK,EAAE,MAAM,CAAC;IAEd,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,sCAAsC;IACtC,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,kCAAkC;IAClC,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6CAA6C;IAC7C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;IAEhB,kBAAkB;IAClB,KAAK,EAAE;QACL,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF,4BAA4B;IAC5B,aAAa,EAAE,MAAM,CAAC;IAEtB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IAEd,6BAA6B;IAC7B,UAAU,EAAE,MAAM,CAAC;IAEnB,+BAA+B;IAC/B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,cAAc;IAC1D,0CAA0C;IAC1C,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAE1B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,IAAI,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3D,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,KAAK,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAE/B,sCAAsC;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1E;;;;;;OAMG;IACH,iBAAiB,CAAC,CAAC,EACjB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE9E;;;;;;;OAOG;IACH,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAEhF;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC;QACnB,SAAS,EAAE,OAAO,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAgBtD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAqBvF,CAAC"}

package/dist/src/core/llm/types.js

@@ -0,0 +1,56 @@
+/**
+ * LLM Provider Abstraction Types
+ *
+ * Supports multiple LLM providers for AI-powered features:
+ * - Anthropic (Claude)
+ * - OpenAI (GPT-4, GPT-4o)
+ * - Azure OpenAI
+ * - AWS Bedrock
+ * - Ollama (local)
+ * - Google Vertex AI
+ */
+/**
+ * Default pricing for known models (USD per 1M tokens)
+ * Updated: 2025-12-03
+ */
+export const MODEL_PRICING = {
+    // Anthropic
+    'claude-opus-4-5-20251101': { inputPer1M: 15, outputPer1M: 75 },
+    'claude-sonnet-4-5-20250929': { inputPer1M: 3, outputPer1M: 15 },
+    'claude-sonnet-4-20250514': { inputPer1M: 3, outputPer1M: 15 },
+    'claude-3-5-haiku-20241022': { inputPer1M: 1, outputPer1M: 5 },
+    // OpenAI
+    'gpt-4o': { inputPer1M: 5, outputPer1M: 15 },
+    'gpt-4o-mini': { inputPer1M: 0.15, outputPer1M: 0.6 },
+    'gpt-4-turbo': { inputPer1M: 10, outputPer1M: 30 },
+    'o1-preview': { inputPer1M: 15, outputPer1M: 60 },
+    'o1-mini': { inputPer1M: 3, outputPer1M: 12 },
+    // Local (free)
+    'ollama/*': { inputPer1M: 0, outputPer1M: 0 },
+};
+/**
+ * Recommended models by use case
+ */
+export const RECOMMENDED_MODELS = {
+    // Deep analysis - needs reasoning
+    'deep-analysis': {
+        'claude-code': 'opus', // Uses MAX subscription via CLI - Opus 4.5 for best quality
+        'anthropic': 'claude-sonnet-4-20250514',
+        'openai': 'gpt-4o',
+        'azure-openai': 'gpt-4o',
+        'bedrock': 'anthropic.claude-3-5-sonnet-20241022-v2:0',
+        'ollama': 'llama3.1:70b',
+        'vertex-ai': 'gemini-1.5-pro',
+    },
+    // Quick tasks - cost-effective
+    'quick-task': {
+        'claude-code': 'haiku', // Uses MAX subscription via CLI
+        'anthropic': 'claude-3-5-haiku-20241022',
+        'openai': 'gpt-4o-mini',
+        'azure-openai': 'gpt-4o-mini',
+        'bedrock': 'anthropic.claude-3-haiku-20240307-v1:0',
+        'ollama': 'llama3.1:8b',
+        'vertex-ai': 'gemini-1.5-flash',
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/src/core/llm/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/llm/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA4MH;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAiC;IACzD,YAAY;IACZ,0BAA0B,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;IAC/D,4BAA4B,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;IAChE,0BAA0B,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;IAC9D,2BAA2B,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE;IAE9D,SAAS;IACT,QAAQ,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;IAC5C,aAAa,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE;IACrD,aAAa,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;IAClD,YAAY,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE;IACjD,SAAS,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;IAE7C,eAAe;IACf,UAAU,EAAE,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE;CAC9C,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6D;IAC1F,kCAAkC;IAClC,eAAe,EAAE;QACf,aAAa,EAAE,MAAM,EAAG,4DAA4D;QACpF,WAAW,EAAE,0BAA0B;QACvC,QAAQ,EAAE,QAAQ;QAClB,cAAc,EAAE,QAAQ;QACxB,SAAS,EAAE,2CAA2C;QACtD,QAAQ,EAAE,cAAc;QACxB,WAAW,EAAE,gBAAgB;KAC9B;IACD,+BAA+B;IAC/B,YAAY,EAAE;QACZ,aAAa,EAAE,OAAO,EAAG,gCAAgC;QACzD,WAAW,EAAE,2BAA2B;QACxC,QAAQ,EAAE,aAAa;QACvB,cAAc,EAAE,aAAa;QAC7B,SAAS,EAAE,wCAAwC;QACnD,QAAQ,EAAE,aAAa;QACvB,WAAW,EAAE,kBAAkB;KAChC;CACF,CAAC"}

package/dist/src/importers/item-converter.d.ts

@@ -254,6 +254,10 @@ export declare class ItemConverter {
      * - 2-level (ADO): specs/{containerId}/{projectId}/
      * - 1-level (GitHub): specs/{projectId}/
      * - Legacy: specs/ (no projectId)
+     *
+     * IMPORTANT: For 2-level structure, features ALWAYS go in the inner folder (board/area level),
+     * even when containerDirName == projectId (e.g., specs/nova-x-sandbox/nova-x-sandbox/).
+     * This is correct because the outer folder is PROJECT level, inner is BOARD level.
      */
     private getBaseDirectory;
     /**

package/dist/src/importers/item-converter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"item-converter.d.ts","sourceRoot":"","sources":["../../../src/importers/item-converter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"item-converter.d.ts","sourceRoot":"","sources":["../../../src/importers/item-converter.ts"],"names":[],"mappings":"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"}