@planu/cli 0.30.1 → 0.31.0

package/dist/engine/ide-config/index.d.ts

@@ -0,0 +1,6 @@
+export { handleGenerateIdeConfig, loadIdeRegistry, mergeJsonConfig } from './core.js';
+export { generateIdeConfig } from './generators.js';
+export { detectAllIdes, getDetectedIdes, detectIde, isBinaryInPath } from './detector.js';
+export { validateConfig } from './validator.js';
+export { detectPlatform, getNpxCommand, expandHome, resolveConfigPath, buildServerEntry, } from './path-resolver.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/ide-config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/engine/ide-config/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACL,cAAc,EACd,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/engine/ide-config/index.js

@@ -0,0 +1,7 @@
+// engine/ide-config/index.ts — Barrel export for IDE config module (SPEC-080)
+export { handleGenerateIdeConfig, loadIdeRegistry, mergeJsonConfig } from './core.js';
+export { generateIdeConfig } from './generators.js';
+export { detectAllIdes, getDetectedIdes, detectIde, isBinaryInPath } from './detector.js';
+export { validateConfig } from './validator.js';
+export { detectPlatform, getNpxCommand, expandHome, resolveConfigPath, buildServerEntry, } from './path-resolver.js';
+//# sourceMappingURL=index.js.map

package/dist/engine/ide-config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/ide-config/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAE9E,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACtF,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EACL,cAAc,EACd,aAAa,EACb,UAAU,EACV,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/engine/ide-config/path-resolver.d.ts

@@ -0,0 +1,23 @@
+import type { IdeDefinition, IdeConfigScope, IdePlatform } from '../../types/index.js';
+/**
+ * Detects the current platform.
+ * Extracted to allow test mocking.
+ */
+export declare function detectPlatform(): IdePlatform;
+/**
+ * Returns the npx command appropriate for the current platform.
+ */
+export declare function getNpxCommand(platform: IdePlatform): string;
+/**
+ * Resolves `~` in a path to the actual home directory.
+ */
+export declare function expandHome(filePath: string): string;
+/**
+ * Resolves the full config file path for an IDE given scope, platform, and project path.
+ */
+export declare function resolveConfigPath(ide: IdeDefinition, scope: IdeConfigScope, platform: IdePlatform, projectPath: string): string;
+/**
+ * Builds the base MCP server entry for planu.
+ */
+export declare function buildServerEntry(platform: IdePlatform): Record<string, unknown>;
+//# sourceMappingURL=path-resolver.d.ts.map

package/dist/engine/ide-config/path-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.d.ts","sourceRoot":"","sources":["../../../src/engine/ide-config/path-resolver.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEvF;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAO5C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,aAAa,EAClB,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,WAAW,EACrB,WAAW,EAAE,MAAM,GAClB,MAAM,CAaR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAM/E"}

package/dist/engine/ide-config/path-resolver.js

@@ -0,0 +1,55 @@
+// engine/ide-config/path-resolver.ts — Resolves config file paths per OS (SPEC-080 AC-12)
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Detects the current platform.
+ * Extracted to allow test mocking.
+ */
+export function detectPlatform() {
+    const p = process.platform;
+    if (p === 'darwin' || p === 'win32' || p === 'linux') {
+        return p;
+    }
+    /* v8 ignore next 1 */
+    return 'linux'; // fallback for unknown Unix-like
+}
+/**
+ * Returns the npx command appropriate for the current platform.
+ */
+export function getNpxCommand(platform) {
+    return platform === 'win32' ? 'npx.cmd' : 'npx';
+}
+/**
+ * Resolves `~` in a path to the actual home directory.
+ */
+export function expandHome(filePath) {
+    if (filePath.startsWith('~/') || filePath === '~') {
+        return join(homedir(), filePath.slice(2));
+    }
+    return filePath;
+}
+/**
+ * Resolves the full config file path for an IDE given scope, platform, and project path.
+ */
+export function resolveConfigPath(ide, scope, platform, projectPath) {
+    if (scope === 'global') {
+        return expandHome(ide.globalConfigPath[platform]);
+    }
+    const configRelative = ide.configPath[platform];
+    // Some IDEs always use global paths (e.g. windsurf, claude-desktop)
+    if (configRelative.startsWith('~/')) {
+        return expandHome(configRelative);
+    }
+    return join(projectPath, configRelative);
+}
+/**
+ * Builds the base MCP server entry for planu.
+ */
+export function buildServerEntry(platform) {
+    return {
+        type: 'stdio',
+        command: getNpxCommand(platform),
+        args: ['-y', '@anthropic/planu-mcp-server'],
+    };
+}
+//# sourceMappingURL=path-resolver.js.map

package/dist/engine/ide-config/path-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-resolver.js","sourceRoot":"","sources":["../../../src/engine/ide-config/path-resolver.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAE1F,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC3B,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;QACrD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,sBAAsB;IACtB,OAAO,OAAO,CAAC,CAAC,iCAAiC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,QAAqB;IACjD,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AAClD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QAClD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,GAAkB,EAClB,KAAqB,EACrB,QAAqB,EACrB,WAAmB;IAEnB,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,UAAU,CAAC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,cAAc,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEhD,oEAAoE;IACpE,IAAI,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,UAAU,CAAC,cAAc,CAAC,CAAC;IACpC,CAAC;IAED,OAAO,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAqB;IACpD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC;QAChC,IAAI,EAAE,CAAC,IAAI,EAAE,6BAA6B,CAAC;KAC5C,CAAC;AACJ,CAAC"}

package/dist/engine/ide-config/validator.d.ts

@@ -0,0 +1,7 @@
+import type { IdeDefinition, IdeValidationError, GeneratedIdeConfig } from '../../types/index.js';
+/**
+ * Validate a generated IDE configuration.
+ * Returns an array of validation errors (empty = valid).
+ */
+export declare function validateConfig(config: GeneratedIdeConfig, ide: IdeDefinition): IdeValidationError[];
+//# sourceMappingURL=validator.d.ts.map

package/dist/engine/ide-config/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/engine/ide-config/validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AA4ClG;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,kBAAkB,EAC1B,GAAG,EAAE,aAAa,GACjB,kBAAkB,EAAE,CActB"}

package/dist/engine/ide-config/validator.js

@@ -0,0 +1,55 @@
+// engine/ide-config/validator.ts — Validate generated IDE configs (SPEC-080 AC-11)
+import { isBinaryInPath } from './detector.js';
+/**
+ * Validate JSON syntax of the generated content.
+ */
+function validateJsonSyntax(config, ide) {
+    if (ide.configFormat === 'lua') {
+        return null; // Lua is not JSON
+    }
+    try {
+        JSON.parse(config.content);
+        return null;
+    }
+    catch (err) {
+        /* v8 ignore next 1 */
+        const message = err instanceof Error ? err.message : 'Unknown parse error';
+        return {
+            field: 'content',
+            message: `Invalid JSON syntax: ${message}`,
+            suggestion: 'Check for trailing commas or missing quotes in the generated config.',
+        };
+    }
+}
+/**
+ * Validate that npx/npx.cmd is available.
+ */
+function validateCommandAvailable() {
+    /* v8 ignore next 1 */
+    const cmd = process.platform === 'win32' ? 'npx.cmd' : 'npx';
+    if (!isBinaryInPath(cmd)) {
+        return {
+            field: 'command',
+            message: `"${cmd}" not found in PATH`,
+            suggestion: 'Install Node.js (https://nodejs.org) to get npx.',
+        };
+    }
+    return null;
+}
+/**
+ * Validate a generated IDE configuration.
+ * Returns an array of validation errors (empty = valid).
+ */
+export function validateConfig(config, ide) {
+    const errors = [];
+    const jsonError = validateJsonSyntax(config, ide);
+    if (jsonError) {
+        errors.push(jsonError);
+    }
+    const cmdError = validateCommandAvailable();
+    if (cmdError) {
+        errors.push(cmdError);
+    }
+    return errors;
+}
+//# sourceMappingURL=validator.js.map

package/dist/engine/ide-config/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../../src/engine/ide-config/validator.ts"],"names":[],"mappings":"AAAA,mFAAmF;AAGnF,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;GAEG;AACH,SAAS,kBAAkB,CACzB,MAA0B,EAC1B,GAAkB;IAElB,IAAI,GAAG,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC,CAAC,kBAAkB;IACjC,CAAC;IAED,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,sBAAsB;QACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC;QAC3E,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,wBAAwB,OAAO,EAAE;YAC1C,UAAU,EAAE,sEAAsE;SACnF,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB;IAC/B,sBAAsB;IACtB,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAC7D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,IAAI,GAAG,qBAAqB;YACrC,UAAU,EAAE,kDAAkD;SAC/D,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,MAA0B,EAC1B,GAAkB;IAElB,MAAM,MAAM,GAAyB,EAAE,CAAC;IAExC,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClD,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,QAAQ,GAAG,wBAAwB,EAAE,CAAC;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/engine/license-validator/lemon-squeezy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lemon-squeezy.d.ts","sourceRoot":"","sources":["../../../src/engine/license-validator/lemon-squeezy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,4BAA4B,EAC5B,4BAA4B,EAC5B,8BAA8B,EAC/B,MAAM,sBAAsB,CAAC;AAoC9B,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,4BAA4B,CAAC,CAKvC;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,4BAA4B,CAAC,CAKvC;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,8BAA8B,CAAC,CAKzC"}
+{"version":3,"file":"lemon-squeezy.d.ts","sourceRoot":"","sources":["../../../src/engine/license-validator/lemon-squeezy.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,4BAA4B,EAC5B,4BAA4B,EAC5B,8BAA8B,EAC/B,MAAM,sBAAsB,CAAC;AAwC9B,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,4BAA4B,CAAC,CAKvC;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,4BAA4B,CAAC,CAKvC;AAED,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,8BAA8B,CAAC,CAKzC"}

package/dist/engine/license-validator/lemon-squeezy.js

@@ -1,7 +1,11 @@
-// engine/license-validator/lemon-squeezy.ts — HTTP client for Lemon Squeezy license API.
+// engine/license-validator/lemon-squeezy.ts — HTTP client for license API.
+// Supports Planu self-hosted (Supabase Edge Function) and Lemon Squeezy as fallback.
 // Uses native fetch() (Node 18+). No external dependencies.
-const BASE_URL = 'https://api.lemonsqueezy.com/v1/licenses';
+const DEFAULT_LICENSE_API = 'https://canusqigtzldstnjddio.supabase.co/functions/v1/license-api';
 const TIMEOUT_MS = 10_000;
+function getBaseUrl() {
+    return process.env.SDD_LICENSE_API_URL ?? DEFAULT_LICENSE_API;
+}
 // ---------------------------------------------------------------------------
 // Internal helpers
 // ---------------------------------------------------------------------------
@@ -11,15 +15,15 @@ async function post(endpoint, body) {
         controller.abort();
     }, TIMEOUT_MS);
     try {
-        const res = await fetch(`${BASE_URL}/${endpoint}`, {
+        const res = await fetch(`${getBaseUrl()}/${endpoint}`, {
             method: 'POST',
-            headers: { 'Content-Type': 'application/x-www-form-urlencoded', Accept: 'application/json' },
-            body: new URLSearchParams(body).toString(),
+            headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+            body: JSON.stringify(body),
             signal: controller.signal,
         });
         if (!res.ok) {
             const text = await res.text();
-            throw new Error(`Lemon Squeezy ${endpoint} failed (${String(res.status)}): ${text}`);
+            throw new Error(`License API ${endpoint} failed (${String(res.status)}): ${text}`);
         }
         return (await res.json());
     }
@@ -32,20 +36,20 @@ async function post(endpoint, body) {
 // ---------------------------------------------------------------------------
 export async function activateLicense(licenseKey, instanceName) {
     return post('activate', {
-        license_key: licenseKey,
-        instance_name: instanceName,
+        licenseKey,
+        instanceName,
     });
 }
 export async function validateLicense(licenseKey, instanceId) {
     return post('validate', {
-        license_key: licenseKey,
-        instance_id: instanceId,
+        licenseKey,
+        instanceId,
     });
 }
 export async function deactivateLicense(licenseKey, instanceId) {
     return post('deactivate', {
-        license_key: licenseKey,
-        instance_id: instanceId,
+        licenseKey,
+        instanceId,
     });
 }
 //# sourceMappingURL=lemon-squeezy.js.map

package/dist/engine/license-validator/lemon-squeezy.js.map

@@ -1 +1 @@
-{"version":3,"file":"lemon-squeezy.js","sourceRoot":"","sources":["../../../src/engine/license-validator/lemon-squeezy.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,4DAA4D;AAQ5D,MAAM,QAAQ,GAAG,0CAA0C,CAAC;AAC5D,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,KAAK,UAAU,IAAI,CAAI,QAAgB,EAAE,IAA4B;IACnE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC,EAAE,UAAU,CAAC,CAAC;IAEf,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,IAAI,QAAQ,EAAE,EAAE;YACjD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE,MAAM,EAAE,kBAAkB,EAAE;YAC5F,IAAI,EAAE,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;YAC1C,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,iBAAiB,QAAQ,YAAY,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;IACjC,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,YAAoB;IAEpB,OAAO,IAAI,CAA+B,UAAU,EAAE;QACpD,WAAW,EAAE,UAAU;QACvB,aAAa,EAAE,YAAY;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,UAAkB;IAElB,OAAO,IAAI,CAA+B,UAAU,EAAE;QACpD,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,UAAU;KACxB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,UAAkB;IAElB,OAAO,IAAI,CAAiC,YAAY,EAAE;QACxD,WAAW,EAAE,UAAU;QACvB,WAAW,EAAE,UAAU;KACxB,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"lemon-squeezy.js","sourceRoot":"","sources":["../../../src/engine/license-validator/lemon-squeezy.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,qFAAqF;AACrF,4DAA4D;AAQ5D,MAAM,mBAAmB,GAAG,mEAAmE,CAAC;AAChG,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,SAAS,UAAU;IACjB,OAAO,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,mBAAmB,CAAC;AAChE,CAAC;AAED,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,KAAK,UAAU,IAAI,CAAI,QAAgB,EAAE,IAA4B;IACnE,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;QAC5B,UAAU,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC,EAAE,UAAU,CAAC,CAAC;IAEf,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,UAAU,EAAE,IAAI,QAAQ,EAAE,EAAE;YACrD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE;YAC3E,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,YAAY,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;QACrF,CAAC;QACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAM,CAAC;IACjC,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,YAAoB;IAEpB,OAAO,IAAI,CAA+B,UAAU,EAAE;QACpD,UAAU;QACV,YAAY;KACb,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,UAAkB,EAClB,UAAkB;IAElB,OAAO,IAAI,CAA+B,UAAU,EAAE;QACpD,UAAU;QACV,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,UAAkB;IAElB,OAAO,IAAI,CAAiC,YAAY,EAAE;QACxD,UAAU;QACV,UAAU;KACX,CAAC,CAAC;AACL,CAAC"}

package/dist/engine/llm-providers/cost-optimizer.d.ts

@@ -0,0 +1,26 @@
+import type { LLMProviderDefinition, QualityTier, ProviderRecommendation, TaskComplexity } from '../../types/index.js';
+export type { TaskComplexity } from '../../types/index.js';
+/** Map task complexity to quality tier. */
+export declare function complexityToTier(complexity: TaskComplexity): QualityTier;
+/**
+ * Find the cheapest provider+model that meets the quality tier requirement.
+ * Returns ranked recommendations sorted by cost (cheapest first).
+ */
+export declare function optimizeCost(definitions: LLMProviderDefinition[], tier: QualityTier, language?: string): ProviderRecommendation[];
+/**
+ * Calculate potential savings compared to the most expensive provider for a tier.
+ */
+export declare function calculateSavings(definitions: LLMProviderDefinition[], tier: QualityTier, tokensEstimated: number): {
+    cheapestProvider: string;
+    expensiveProvider: string;
+    savingsUsd: number;
+    savingsPercent: number;
+} | null;
+/**
+ * Get model equivalences for a given tier from config.
+ */
+export declare function getEquivalences(tier: QualityTier): {
+    providerId: string;
+    modelId: string;
+}[];
+//# sourceMappingURL=cost-optimizer.d.ts.map

package/dist/engine/llm-providers/cost-optimizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-optimizer.d.ts","sourceRoot":"","sources":["../../../src/engine/llm-providers/cost-optimizer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,WAAW,EACX,sBAAsB,EAEtB,cAAc,EACf,MAAM,sBAAsB,CAAC;AAM9B,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,cAAc,GAAG,WAAW,CASxE;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,WAAW,EAAE,qBAAqB,EAAE,EACpC,IAAI,EAAE,WAAW,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,sBAAsB,EAAE,CA6B1B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,qBAAqB,EAAE,EACpC,IAAI,EAAE,WAAW,EACjB,eAAe,EAAE,MAAM,GACtB;IACD,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB,GAAG,IAAI,CAuBP;AAmCD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,WAAW,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,CAQ5F"}

package/dist/engine/llm-providers/cost-optimizer.js

@@ -0,0 +1,101 @@
+// engine/llm-providers/cost-optimizer.ts — Cost optimization engine.
+// SPEC-083 AC-05, AC-14
+import { checkProviderHealth } from './health-checker.js';
+import equivalencesData from '../../config/model-equivalences.json' with { type: 'json' };
+import affinityData from '../../config/model-language-affinity.json' with { type: 'json' };
+/** Map task complexity to quality tier. */
+export function complexityToTier(complexity) {
+    switch (complexity) {
+        case 'complex':
+            return 'high';
+        case 'standard':
+            return 'medium';
+        case 'simple':
+            return 'low';
+    }
+}
+/**
+ * Find the cheapest provider+model that meets the quality tier requirement.
+ * Returns ranked recommendations sorted by cost (cheapest first).
+ */
+export function optimizeCost(definitions, tier, language) {
+    const candidates = [];
+    for (const def of definitions) {
+        const health = checkProviderHealth(def);
+        if (health.status === 'unavailable') {
+            continue;
+        }
+        const matchingModels = def.models.filter((m) => m.tier === tier);
+        for (const model of matchingModels) {
+            const totalCostPer1M = model.pricingPerMToken.input + model.pricingPerMToken.output;
+            const affinityBonus = getLanguageAffinityBonus(def.id, language);
+            candidates.push({
+                providerId: def.id,
+                modelId: model.id,
+                tier: model.tier,
+                costEstimate: {
+                    tokensEstimated: 1_000_000,
+                    usdEstimated: totalCostPer1M,
+                },
+                reasoning: buildReasoning(def, model.id, totalCostPer1M, language),
+                score: 1.0 / (totalCostPer1M + 0.001) + affinityBonus,
+            });
+        }
+    }
+    return candidates.sort((a, b) => a.costEstimate.usdEstimated - b.costEstimate.usdEstimated);
+}
+/**
+ * Calculate potential savings compared to the most expensive provider for a tier.
+ */
+export function calculateSavings(definitions, tier, tokensEstimated) {
+    const ranked = optimizeCost(definitions, tier);
+    if (ranked.length < 2) {
+        return null;
+    }
+    const cheapest = ranked[0];
+    const expensive = ranked[ranked.length - 1];
+    if (!cheapest || !expensive) {
+        return null;
+    }
+    const cheapCost = (cheapest.costEstimate.usdEstimated / 1_000_000) * tokensEstimated;
+    const expCost = (expensive.costEstimate.usdEstimated / 1_000_000) * tokensEstimated;
+    const savings = expCost - cheapCost;
+    return {
+        cheapestProvider: `${cheapest.providerId}/${cheapest.modelId}`,
+        expensiveProvider: `${expensive.providerId}/${expensive.modelId}`,
+        savingsUsd: Math.round(savings * 10000) / 10000,
+        savingsPercent: expCost > 0 ? Math.round((savings / expCost) * 100) : 0,
+    };
+}
+function getLanguageAffinityBonus(providerId, language) {
+    if (!language) {
+        return 0;
+    }
+    const entry = affinityData.affinities.find((a) => a.language === language.toLowerCase());
+    if (!entry) {
+        return 0;
+    }
+    const rank = entry.preferredProviders.indexOf(providerId);
+    if (rank === -1) {
+        return 0;
+    }
+    return entry.weight * (1 - rank * 0.3);
+}
+function buildReasoning(def, modelId, costPer1M, language) {
+    const reasons = [`${def.name} ${modelId}: $${costPer1M.toFixed(2)}/1M tokens (in+out)`];
+    if (language) {
+        const bonus = getLanguageAffinityBonus(def.id, language);
+        if (bonus > 0) {
+            reasons.push(`Language affinity bonus for ${language}: +${bonus.toFixed(2)}`);
+        }
+    }
+    return reasons;
+}
+/**
+ * Get model equivalences for a given tier from config.
+ */
+export function getEquivalences(tier) {
+    const equiv = equivalencesData.equivalences.find((e) => e.tier === tier);
+    return equiv?.models ?? [];
+}
+//# sourceMappingURL=cost-optimizer.js.map

package/dist/engine/llm-providers/cost-optimizer.js.map

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

package/dist/engine/llm-providers/cost-tracker.d.ts

@@ -0,0 +1,26 @@
+import type { LLMProviderId, ProviderCostRecord, ProviderCostSummary } from '../../types/index.js';
+/**
+ * Record a cost event for a provider recommendation.
+ */
+export declare function recordCost(providerId: LLMProviderId, modelId: string, tokensEstimated: number, costEstimated: number): ProviderCostRecord;
+/**
+ * Get cost summary for a specific provider with daily/weekly/monthly aggregation.
+ */
+export declare function getCostSummary(providerId: LLMProviderId): ProviderCostSummary;
+/**
+ * Get cost summaries for all providers that have records.
+ */
+export declare function getAllCostSummaries(): ProviderCostSummary[];
+/**
+ * Get all raw cost records (for persistence/export).
+ */
+export declare function getCostRecords(): ProviderCostRecord[];
+/**
+ * Load cost records from persisted data.
+ */
+export declare function loadCostRecords(records: ProviderCostRecord[]): void;
+/**
+ * Clear all cost records (for testing).
+ */
+export declare function clearCostRecords(): void;
+//# sourceMappingURL=cost-tracker.d.ts.map

package/dist/engine/llm-providers/cost-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.d.ts","sourceRoot":"","sources":["../../../src/engine/llm-providers/cost-tracker.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAKnG;;GAEG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,aAAa,EACzB,OAAO,EAAE,MAAM,EACf,eAAe,EAAE,MAAM,EACvB,aAAa,EAAE,MAAM,GACpB,kBAAkB,CAUpB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,aAAa,GAAG,mBAAmB,CA8B7E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,mBAAmB,EAAE,CAG3D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,kBAAkB,EAAE,CAErD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAGnE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

package/dist/engine/llm-providers/cost-tracker.js

@@ -0,0 +1,75 @@
+// engine/llm-providers/cost-tracker.ts — Cost tracking per provider.
+// SPEC-083 AC-13
+/** In-memory cost records (would be persisted to llm-costs.json in production). */
+const costRecords = [];
+/**
+ * Record a cost event for a provider recommendation.
+ */
+export function recordCost(providerId, modelId, tokensEstimated, costEstimated) {
+    const record = {
+        providerId,
+        modelId,
+        tokensEstimated,
+        costEstimated,
+        timestamp: new Date().toISOString(),
+    };
+    costRecords.push(record);
+    return record;
+}
+/**
+ * Get cost summary for a specific provider with daily/weekly/monthly aggregation.
+ */
+export function getCostSummary(providerId) {
+    const now = Date.now();
+    const dayMs = 24 * 60 * 60 * 1000;
+    const providerRecords = costRecords.filter((r) => r.providerId === providerId);
+    let daily = 0;
+    let weekly = 0;
+    let monthly = 0;
+    for (const record of providerRecords) {
+        const age = now - new Date(record.timestamp).getTime();
+        if (age <= dayMs) {
+            daily += record.costEstimated;
+        }
+        if (age <= 7 * dayMs) {
+            weekly += record.costEstimated;
+        }
+        if (age <= 30 * dayMs) {
+            monthly += record.costEstimated;
+        }
+    }
+    return {
+        providerId,
+        daily: Math.round(daily * 10000) / 10000,
+        weekly: Math.round(weekly * 10000) / 10000,
+        monthly: Math.round(monthly * 10000) / 10000,
+        requestCount: providerRecords.length,
+    };
+}
+/**
+ * Get cost summaries for all providers that have records.
+ */
+export function getAllCostSummaries() {
+    const providerIds = [...new Set(costRecords.map((r) => r.providerId))];
+    return providerIds.map((id) => getCostSummary(id));
+}
+/**
+ * Get all raw cost records (for persistence/export).
+ */
+export function getCostRecords() {
+    return [...costRecords];
+}
+/**
+ * Load cost records from persisted data.
+ */
+export function loadCostRecords(records) {
+    costRecords.length = 0;
+    costRecords.push(...records);
+}
+/**
+ * Clear all cost records (for testing).
+ */
+export function clearCostRecords() {
+    costRecords.length = 0;
+}
+//# sourceMappingURL=cost-tracker.js.map

package/dist/engine/llm-providers/cost-tracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.js","sourceRoot":"","sources":["../../../src/engine/llm-providers/cost-tracker.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,iBAAiB;AAIjB,mFAAmF;AACnF,MAAM,WAAW,GAAyB,EAAE,CAAC;AAE7C;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,UAAyB,EACzB,OAAe,EACf,eAAuB,EACvB,aAAqB;IAErB,MAAM,MAAM,GAAuB;QACjC,UAAU;QACV,OAAO;QACP,eAAe;QACf,aAAa;QACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IACF,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,UAAyB;IACtD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAElC,MAAM,eAAe,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC;IAE/E,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,GAAG,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;QACvD,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC;YACjB,KAAK,IAAI,MAAM,CAAC,aAAa,CAAC;QAChC,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;YACrB,MAAM,IAAI,MAAM,CAAC,aAAa,CAAC;QACjC,CAAC;QACD,IAAI,GAAG,IAAI,EAAE,GAAG,KAAK,EAAE,CAAC;YACtB,OAAO,IAAI,MAAM,CAAC,aAAa,CAAC;QAClC,CAAC;IACH,CAAC;IAED,OAAO;QACL,UAAU;QACV,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,GAAG,KAAK;QACxC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,KAAK;QAC1C,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,KAAK;QAC5C,YAAY,EAAE,eAAe,CAAC,MAAM;KACrC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACvE,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,OAA6B;IAC3D,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IACvB,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/engine/llm-providers/failover-chain.d.ts

@@ -0,0 +1,23 @@
+import type { LLMProviderDefinition, LLMProviderId, FailoverEvent, FailoverReason, ProviderRecommendation, QualityTier } from '../../types/index.js';
+/**
+ * Walk the failover chain and return the first healthy provider that
+ * has a model matching the requested quality tier.
+ *
+ * Returns a recommendation or null if no provider is available after
+ * MAX_FAILOVER_ATTEMPTS attempts.
+ */
+export declare function resolveFailover(chain: LLMProviderId[], definitions: LLMProviderDefinition[], tier: QualityTier, reason: FailoverReason): ProviderRecommendation | null;
+/**
+ * Get all failover events logged in the current session.
+ */
+export declare function getFailoverLog(): FailoverEvent[];
+/**
+ * Clear failover log (for testing).
+ */
+export declare function clearFailoverLog(): void;
+/**
+ * Build the default failover chain from provider definitions.
+ * Orders by: number of models (descending), then alphabetically.
+ */
+export declare function buildDefaultChain(definitions: LLMProviderDefinition[]): LLMProviderId[];
+//# sourceMappingURL=failover-chain.d.ts.map

package/dist/engine/llm-providers/failover-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failover-chain.d.ts","sourceRoot":"","sources":["../../../src/engine/llm-providers/failover-chain.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,qBAAqB,EACrB,aAAa,EACb,aAAa,EACb,cAAc,EACd,sBAAsB,EACtB,WAAW,EACZ,MAAM,sBAAsB,CAAC;AAS9B;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,aAAa,EAAE,EACtB,WAAW,EAAE,qBAAqB,EAAE,EACpC,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,cAAc,GACrB,sBAAsB,GAAG,IAAI,CA+C/B;AAcD;;GAEG;AACH,wBAAgB,cAAc,IAAI,aAAa,EAAE,CAEhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,qBAAqB,EAAE,GAAG,aAAa,EAAE,CAIvF"}

package/dist/engine/llm-providers/failover-chain.js

@@ -0,0 +1,88 @@
+// engine/llm-providers/failover-chain.ts — Failover chain logic.
+// SPEC-083 AC-03
+import { checkProviderHealth } from './health-checker.js';
+/** Maximum number of failover attempts before giving up. */
+const MAX_FAILOVER_ATTEMPTS = 3;
+/** In-memory log of failover events for the current session. */
+const failoverLog = [];
+/**
+ * Walk the failover chain and return the first healthy provider that
+ * has a model matching the requested quality tier.
+ *
+ * Returns a recommendation or null if no provider is available after
+ * MAX_FAILOVER_ATTEMPTS attempts.
+ */
+export function resolveFailover(chain, definitions, tier, reason) {
+    const defMap = new Map(definitions.map((d) => [d.id, d]));
+    let previousProvider;
+    let attempts = 0;
+    for (const providerId of chain) {
+        if (attempts >= MAX_FAILOVER_ATTEMPTS) {
+            break;
+        }
+        const def = defMap.get(providerId);
+        if (!def) {
+            continue;
+        }
+        const health = checkProviderHealth(def, 0); // Force fresh check
+        if (health.status === 'unavailable') {
+            previousProvider = providerId;
+            attempts++;
+            continue;
+        }
+        const model = def.models.find((m) => m.tier === tier) ?? def.models[0];
+        if (!model) {
+            previousProvider = providerId;
+            attempts++;
+            continue;
+        }
+        // Log the failover event if we had to skip a previous provider
+        if (previousProvider) {
+            logFailoverEvent(previousProvider, providerId, reason);
+        }
+        return {
+            providerId,
+            modelId: model.id,
+            tier: model.tier,
+            costEstimate: { tokensEstimated: 0, usdEstimated: 0 },
+            reasoning: previousProvider
+                ? [`Failover from ${previousProvider}: ${reason}`]
+                : ['Primary provider selected'],
+            score: health.status === 'healthy' ? 1.0 : 0.5,
+        };
+    }
+    return null;
+}
+/**
+ * Log a failover event.
+ */
+function logFailoverEvent(from, to, reason) {
+    failoverLog.push({
+        fromProvider: from,
+        toProvider: to,
+        reason,
+        timestamp: new Date().toISOString(),
+    });
+}
+/**
+ * Get all failover events logged in the current session.
+ */
+export function getFailoverLog() {
+    return [...failoverLog];
+}
+/**
+ * Clear failover log (for testing).
+ */
+export function clearFailoverLog() {
+    failoverLog.length = 0;
+}
+/**
+ * Build the default failover chain from provider definitions.
+ * Orders by: number of models (descending), then alphabetically.
+ */
+export function buildDefaultChain(definitions) {
+    return [...definitions]
+        .sort((a, b) => b.models.length - a.models.length || a.id.localeCompare(b.id))
+        .map((d) => d.id);
+}
+//# sourceMappingURL=failover-chain.js.map

package/dist/engine/llm-providers/failover-chain.js.map

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