@ornexus/neocortex 4.0.1 → 4.0.2

package/packages/client/dist/resilience/degradation-manager.js

@@ -1,164 +1 @@
-/**
- * @license FSL-1.1
- * Copyright (c) 2026 OrNexus AI
- *
- * This file is part of Neocortex CLI, licensed under the
- * Functional Source License, Version 1.1 (FSL-1.1).
- *
- * Change Date: February 20, 2029
- * Change License: MIT
- *
- * See the LICENSE file in the project root for full license text.
- */
-// ── Types ─────────────────────────────────────────────────────────────────
-export var DegradationLevel;
-(function (DegradationLevel) {
-    /** Server available, fresh data, optimal performance */
-    DegradationLevel[DegradationLevel["ONLINE"] = 0] = "ONLINE";
-    /** Server slow (>2s), use cache when available */
-    DegradationLevel[DegradationLevel["HIGH_LATENCY"] = 1] = "HIGH_LATENCY";
-    /** Server down, use cache exclusively */
-    DegradationLevel[DegradationLevel["SERVER_DOWN"] = 2] = "SERVER_DOWN";
-    /** Cache expired (>24h), use with warning */
-    DegradationLevel[DegradationLevel["STALE_CACHE"] = 3] = "STALE_CACHE";
-    /** No cache and no server - error state */
-    DegradationLevel[DegradationLevel["NO_CACHE"] = 4] = "NO_CACHE";
-})(DegradationLevel || (DegradationLevel = {}));
-// ── Defaults ──────────────────────────────────────────────────────────────
-const DEFAULT_CONFIG = {
-    staleThresholdMs: 86_400_000, // 24 hours
-    warningThresholdMs: 43_200_000, // 12 hours
-    latencyThresholdMs: 2_000, // 2 seconds
-};
-// ── DegradationManager ───────────────────────────────────────────────────
-export class DegradationManager {
-    config;
-    constructor(config) {
-        this.config = { ...DEFAULT_CONFIG, ...config };
-    }
-    /**
-     * Evaluate the current degradation level based on context.
-     */
-    evaluate(context) {
-        // Force-offline mode: always use cache
-        if (context.forceOffline) {
-            return this.buildCacheOnlyDecision(context, '[OFFLINE]');
-        }
-        // Circuit is OPEN: server known to be down
-        if (context.circuitState === 'OPEN') {
-            return this.buildServerDownDecision(context);
-        }
-        // Circuit is HALF_OPEN: probing server
-        if (context.circuitState === 'HALF_OPEN') {
-            // Allow server request (probe), but prepare cache fallback
-            return {
-                level: DegradationLevel.SERVER_DOWN,
-                useCache: true,
-                useServer: true,
-                prefix: '[PROBING]',
-                warning: null,
-            };
-        }
-        // Circuit is CLOSED: server available
-        if (context.latencyMs != null && context.latencyMs > this.config.latencyThresholdMs) {
-            // High latency: prefer cache if available
-            if (context.cacheAvailable) {
-                return {
-                    level: DegradationLevel.HIGH_LATENCY,
-                    useCache: true,
-                    useServer: false,
-                    prefix: '[CACHED]',
-                    warning: null,
-                };
-            }
-            // No cache available: still use server (slow is better than nothing)
-            return {
-                level: DegradationLevel.HIGH_LATENCY,
-                useCache: false,
-                useServer: true,
-                prefix: '',
-                warning: 'Server response is slow. Consider running `neocortex cache warmup`.',
-            };
-        }
-        // Normal operation
-        return {
-            level: DegradationLevel.ONLINE,
-            useCache: false,
-            useServer: true,
-            prefix: '',
-            warning: null,
-        };
-    }
-    // ── Private ─────────────────────────────────────────────────────────
-    buildServerDownDecision(context) {
-        if (!context.cacheAvailable) {
-            return {
-                level: DegradationLevel.NO_CACHE,
-                useCache: false,
-                useServer: false,
-                prefix: '[ERROR]',
-                warning: 'Server unavailable and no cached data. Run `neocortex cache warmup` when online.',
-            };
-        }
-        const cacheAgeMs = context.cacheAgeMs ?? 0;
-        if (cacheAgeMs > this.config.staleThresholdMs) {
-            const ageStr = this.formatAge(cacheAgeMs);
-            return {
-                level: DegradationLevel.STALE_CACHE,
-                useCache: true,
-                useServer: false,
-                prefix: `[STALE CACHE - ${ageStr}]`,
-                warning: `Cache is stale (${ageStr} old). Data may be outdated.`,
-            };
-        }
-        return {
-            level: DegradationLevel.SERVER_DOWN,
-            useCache: true,
-            useServer: false,
-            prefix: '[CACHED]',
-            warning: cacheAgeMs > this.config.warningThresholdMs
-                ? `Cache is ${this.formatAge(cacheAgeMs)} old.`
-                : null,
-        };
-    }
-    buildCacheOnlyDecision(context, prefix) {
-        if (!context.cacheAvailable) {
-            return {
-                level: DegradationLevel.NO_CACHE,
-                useCache: false,
-                useServer: false,
-                prefix: '[ERROR]',
-                warning: 'Offline mode active but no cached data available. Run `neocortex cache warmup` when online.',
-            };
-        }
-        const cacheAgeMs = context.cacheAgeMs ?? 0;
-        if (cacheAgeMs > this.config.staleThresholdMs) {
-            const ageStr = this.formatAge(cacheAgeMs);
-            return {
-                level: DegradationLevel.STALE_CACHE,
-                useCache: true,
-                useServer: false,
-                prefix: `[STALE CACHE - ${ageStr}]`,
-                warning: `Using stale cache (${ageStr} old) in offline mode.`,
-            };
-        }
-        return {
-            level: DegradationLevel.SERVER_DOWN,
-            useCache: true,
-            useServer: false,
-            prefix,
-            warning: null,
-        };
-    }
-    formatAge(ms) {
-        const hours = Math.floor(ms / 3_600_000);
-        if (hours >= 48)
-            return `${Math.floor(hours / 24)}d`;
-        if (hours >= 1)
-            return `${hours}h`;
-        const minutes = Math.floor(ms / 60_000);
-        if (minutes >= 1)
-            return `${minutes}m`;
-        return '<1m';
-    }
-}
+var r;(function(s){s[s.ONLINE=0]="ONLINE",s[s.HIGH_LATENCY=1]="HIGH_LATENCY",s[s.SERVER_DOWN=2]="SERVER_DOWN",s[s.STALE_CACHE=3]="STALE_CACHE",s[s.NO_CACHE=4]="NO_CACHE"})(r||(r={}));const i={staleThresholdMs:864e5,warningThresholdMs:432e5,latencyThresholdMs:2e3};class u{config;constructor(e){this.config={...i,...e}}evaluate(e){return e.forceOffline?this.buildCacheOnlyDecision(e,"[OFFLINE]"):e.circuitState==="OPEN"?this.buildServerDownDecision(e):e.circuitState==="HALF_OPEN"?{level:r.SERVER_DOWN,useCache:!0,useServer:!0,prefix:"[PROBING]",warning:null}:e.latencyMs!=null&&e.latencyMs>this.config.latencyThresholdMs?e.cacheAvailable?{level:r.HIGH_LATENCY,useCache:!0,useServer:!1,prefix:"[CACHED]",warning:null}:{level:r.HIGH_LATENCY,useCache:!1,useServer:!0,prefix:"",warning:"Server response is slow. Consider running `neocortex cache warmup`."}:{level:r.ONLINE,useCache:!1,useServer:!0,prefix:"",warning:null}}buildServerDownDecision(e){if(!e.cacheAvailable)return{level:r.NO_CACHE,useCache:!1,useServer:!1,prefix:"[ERROR]",warning:"Server unavailable and no cached data. Run `neocortex cache warmup` when online."};const a=e.cacheAgeMs??0;if(a>this.config.staleThresholdMs){const n=this.formatAge(a);return{level:r.STALE_CACHE,useCache:!0,useServer:!1,prefix:`[STALE CACHE - ${n}]`,warning:`Cache is stale (${n} old). Data may be outdated.`}}return{level:r.SERVER_DOWN,useCache:!0,useServer:!1,prefix:"[CACHED]",warning:a>this.config.warningThresholdMs?`Cache is ${this.formatAge(a)} old.`:null}}buildCacheOnlyDecision(e,a){if(!e.cacheAvailable)return{level:r.NO_CACHE,useCache:!1,useServer:!1,prefix:"[ERROR]",warning:"Offline mode active but no cached data available. Run `neocortex cache warmup` when online."};const n=e.cacheAgeMs??0;if(n>this.config.staleThresholdMs){const l=this.formatAge(n);return{level:r.STALE_CACHE,useCache:!0,useServer:!1,prefix:`[STALE CACHE - ${l}]`,warning:`Using stale cache (${l} old) in offline mode.`}}return{level:r.SERVER_DOWN,useCache:!0,useServer:!1,prefix:a,warning:null}}formatAge(e){const a=Math.floor(e/36e5);if(a>=48)return`${Math.floor(a/24)}d`;if(a>=1)return`${a}h`;const n=Math.floor(e/6e4);return n>=1?`${n}m`:"<1m"}}export{r as DegradationLevel,u as DegradationManager};

package/packages/client/dist/resilience/freshness-indicator.js

@@ -1,100 +1 @@
-/**
- * @license FSL-1.1
- * Copyright (c) 2026 OrNexus AI
- *
- * This file is part of Neocortex CLI, licensed under the
- * Functional Source License, Version 1.1 (FSL-1.1).
- *
- * Change Date: February 20, 2029
- * Change License: MIT
- *
- * See the LICENSE file in the project root for full license text.
- */
-/**
- * @neocortex/client - Freshness Indicator
- *
- * Enriches cache responses with freshness metadata for user-facing display.
- * Formats cache age as human-readable strings and generates appropriate
- * warning prefixes based on degradation level.
- *
- * Story 42.9
- */
-import { DegradationLevel } from './degradation-manager.js';
-// ── Defaults ──────────────────────────────────────────────────────────────
-const DEFAULT_CONFIG = {
-    staleThresholdMs: 86_400_000, // 24 hours
-    warningThresholdMs: 43_200_000, // 12 hours
-};
-// ── FreshnessIndicator ──────────────────────────────────────────────────
-export class FreshnessIndicator {
-    config;
-    constructor(config) {
-        this.config = { ...DEFAULT_CONFIG, ...config };
-    }
-    /**
-     * Format a duration in ms as human-readable age string.
-     * Examples: "30m ago", "4h ago", "2d ago"
-     */
-    formatAge(ageMs) {
-        if (ageMs < 0)
-            return 'just now';
-        const seconds = Math.floor(ageMs / 1_000);
-        const minutes = Math.floor(ageMs / 60_000);
-        const hours = Math.floor(ageMs / 3_600_000);
-        const days = Math.floor(ageMs / 86_400_000);
-        if (days >= 1)
-            return `${days}d ago`;
-        if (hours >= 1)
-            return `${hours}h ago`;
-        if (minutes >= 1)
-            return `${minutes}m ago`;
-        if (seconds >= 1)
-            return `${seconds}s ago`;
-        return 'just now';
-    }
-    /**
-     * Evaluate freshness of a cache entry.
-     */
-    evaluate(cacheAgeMs, _ttlMs) {
-        const stale = cacheAgeMs > this.config.staleThresholdMs;
-        const aged = cacheAgeMs > this.config.warningThresholdMs;
-        let warning = null;
-        let prefix = '[CACHED]';
-        if (stale) {
-            const ageStr = this.formatAge(cacheAgeMs);
-            prefix = `[STALE CACHE - ${ageStr}]`;
-            warning = `WARNING: STALE - cached ${ageStr}`;
-        }
-        else if (aged) {
-            const ageStr = this.formatAge(cacheAgeMs);
-            prefix = `[CACHED]`;
-            warning = `WARNING - cached ${ageStr}`;
-        }
-        return {
-            cached: true,
-            cacheAgeMs,
-            stale,
-            warning,
-            prefix,
-        };
-    }
-    /**
-     * Format prefix string based on degradation level and optional age.
-     */
-    formatPrefix(level, ageMs) {
-        switch (level) {
-            case DegradationLevel.ONLINE:
-                return '';
-            case DegradationLevel.HIGH_LATENCY:
-                return ageMs != null ? `[CACHED] cached ${this.formatAge(ageMs)}` : '[CACHED]';
-            case DegradationLevel.SERVER_DOWN:
-                return ageMs != null ? `[CACHED] cached ${this.formatAge(ageMs)}` : '[CACHED]';
-            case DegradationLevel.STALE_CACHE:
-                return ageMs != null ? `[STALE CACHE - ${this.formatAge(ageMs)}]` : '[STALE CACHE]';
-            case DegradationLevel.NO_CACHE:
-                return '[ERROR]';
-            default:
-                return '';
-        }
-    }
-}
+import{DegradationLevel as e}from"./degradation-manager.js";const l={staleThresholdMs:864e5,warningThresholdMs:432e5};class h{config;constructor(t){this.config={...l,...t}}formatAge(t){if(t<0)return"just now";const r=Math.floor(t/1e3),n=Math.floor(t/6e4),s=Math.floor(t/36e5),o=Math.floor(t/864e5);return o>=1?`${o}d ago`:s>=1?`${s}h ago`:n>=1?`${n}m ago`:r>=1?`${r}s ago`:"just now"}evaluate(t,r){const n=t>this.config.staleThresholdMs,s=t>this.config.warningThresholdMs;let o=null,i="[CACHED]";if(n){const a=this.formatAge(t);i=`[STALE CACHE - ${a}]`,o=`WARNING: STALE - cached ${a}`}else if(s){const a=this.formatAge(t);i="[CACHED]",o=`WARNING - cached ${a}`}return{cached:!0,cacheAgeMs:t,stale:n,warning:o,prefix:i}}formatPrefix(t,r){switch(t){case e.ONLINE:return"";case e.HIGH_LATENCY:return r!=null?`[CACHED] cached ${this.formatAge(r)}`:"[CACHED]";case e.SERVER_DOWN:return r!=null?`[CACHED] cached ${this.formatAge(r)}`:"[CACHED]";case e.STALE_CACHE:return r!=null?`[STALE CACHE - ${this.formatAge(r)}]`:"[STALE CACHE]";case e.NO_CACHE:return"[ERROR]";default:return""}}}export{h as FreshnessIndicator};

package/packages/client/dist/resilience/index.js

@@ -1,8 +1 @@
-/**
- * @license FSL-1.1
- * Copyright (c) 2026 OrNexus AI
- */
-export { ClientCircuitBreaker } from './circuit-breaker.js';
-export { DegradationManager, DegradationLevel } from './degradation-manager.js';
-export { FreshnessIndicator } from './freshness-indicator.js';
-export { RecoveryDetector } from './recovery-detector.js';
+import{ClientCircuitBreaker as o}from"./circuit-breaker.js";import{DegradationManager as a,DegradationLevel as i}from"./degradation-manager.js";import{FreshnessIndicator as c}from"./freshness-indicator.js";import{RecoveryDetector as m}from"./recovery-detector.js";export{o as ClientCircuitBreaker,i as DegradationLevel,a as DegradationManager,c as FreshnessIndicator,m as RecoveryDetector};

package/packages/client/dist/resilience/recovery-detector.js

@@ -1,74 +1 @@
-/**
- * @license FSL-1.1
- * Copyright (c) 2026 OrNexus AI
- *
- * This file is part of Neocortex CLI, licensed under the
- * Functional Source License, Version 1.1 (FSL-1.1).
- *
- * Change Date: February 20, 2029
- * Change License: MIT
- *
- * See the LICENSE file in the project root for full license text.
- */
-// ── RecoveryDetector ─────────────────────────────────────────────────────
-export class RecoveryDetector {
-    actions;
-    constructor(actions) {
-        this.actions = actions;
-    }
-    /**
-     * Execute full recovery sequence.
-     * Each step is independent - failures are captured but don't block others.
-     */
-    async onRecovery() {
-        const result = {
-            circuitClosed: false,
-            jwtRefreshed: false,
-            cacheSynced: false,
-            telemetryFlushed: { sent: 0, failed: 0 },
-            notification: '[ONLINE] Server connection restored',
-        };
-        // Step 1: Close circuit breaker
-        try {
-            await this.actions.circuitBreaker.recordSuccess();
-            result.circuitClosed = true;
-        }
-        catch {
-            // Non-critical: breaker will close on next successful call
-        }
-        // Step 2: Re-validate JWT
-        try {
-            const token = await this.actions.licenseClient.getToken();
-            result.jwtRefreshed = token !== null;
-        }
-        catch {
-            // Non-critical: will be retried on next server call
-        }
-        // Step 3: Sync cache (background - just attempt, don't block)
-        try {
-            // We don't actually sync here - the next resolver call will
-            // update the cache automatically via fetchWithCacheFallback.
-            // We just mark as synced since the circuit is now closed.
-            result.cacheSynced = true;
-        }
-        catch {
-            // Non-critical
-        }
-        // Step 4: Flush telemetry queue
-        try {
-            const flushResult = await this.actions.telemetryQueue.flush(async (events) => {
-                const response = await fetch(`${this.actions.serverUrl}/api/v1/telemetry/batch`, {
-                    method: 'POST',
-                    headers: { 'Content-Type': 'application/json' },
-                    body: JSON.stringify({ events }),
-                });
-                return response.ok;
-            });
-            result.telemetryFlushed = flushResult;
-        }
-        catch {
-            // Non-critical: queue will be flushed on next recovery
-        }
-        return result;
-    }
-}
+class n{actions;constructor(e){this.actions=e}async onRecovery(){const e={circuitClosed:!1,jwtRefreshed:!1,cacheSynced:!1,telemetryFlushed:{sent:0,failed:0},notification:"[ONLINE] Server connection restored"};try{await this.actions.circuitBreaker.recordSuccess(),e.circuitClosed=!0}catch{}try{const t=await this.actions.licenseClient.getToken();e.jwtRefreshed=t!==null}catch{}try{e.cacheSynced=!0}catch{}try{const t=await this.actions.telemetryQueue.flush(async c=>(await fetch(`${this.actions.serverUrl}/api/v1/telemetry/batch`,{method:"POST",headers:{"Content-Type":"application/json"},body:JSON.stringify({events:c})})).ok);e.telemetryFlushed=t}catch{}return e}}export{n as RecoveryDetector};

package/packages/client/dist/resolvers/asset-resolver.js

@@ -1,13 +0,0 @@
-/**
- * @license FSL-1.1
- * Copyright (c) 2026 OrNexus AI
- *
- * This file is part of Neocortex CLI, licensed under the
- * Functional Source License, Version 1.1 (FSL-1.1).
- *
- * Change Date: February 20, 2029
- * Change License: MIT
- *
- * See the LICENSE file in the project root for full license text.
- */
-export {};

package/packages/client/dist/resolvers/local-resolver.js

@@ -1,218 +1,8 @@
-/**
- * @license FSL-1.1
- * Copyright (c) 2026 OrNexus AI
- *
- * This file is part of Neocortex CLI, licensed under the
- * Functional Source License, Version 1.1 (FSL-1.1).
- *
- * Change Date: February 20, 2029
- * Change License: MIT
- *
- * See the LICENSE file in the project root for full license text.
- */
-/**
- * @neocortex/client - LocalResolver
- *
- * Resolves pipeline assets from the local filesystem.
- * Used in development mode when core/ directory is available locally.
- * Replicates the current CLI behavior of reading .md files directly.
- */
-import { readFile, access } from 'node:fs/promises';
-import { join, resolve } from 'node:path';
-import { ResolverMode, } from '../types/index.js';
-// ── Frontmatter Parser ───────────────────────────────────────────────────
-const FRONTMATTER_REGEX = /^---\n([\s\S]*?)\n---/;
-/**
- * Parse YAML-like frontmatter from markdown content.
- * Simple key-value parser sufficient for step/skill frontmatter.
- */
-function parseFrontmatter(content) {
-    const match = content.match(FRONTMATTER_REGEX);
-    if (!match) {
-        return { frontmatter: {}, body: content };
-    }
-    const frontmatter = {};
-    const lines = match[1].split('\n');
-    for (const line of lines) {
-        const colonIndex = line.indexOf(':');
-        if (colonIndex === -1)
-            continue;
-        const key = line.slice(0, colonIndex).trim().replace(/^['"]|['"]$/g, '');
-        let value = line.slice(colonIndex + 1).trim();
-        // Remove surrounding quotes
-        if (typeof value === 'string') {
-            value = value.replace(/^['"]|['"]$/g, '');
-        }
-        // Parse booleans
-        if (value === 'true')
-            value = true;
-        else if (value === 'false')
-            value = false;
-        frontmatter[key] = value;
-    }
-    const body = content.slice(match[0].length).trimStart();
-    return { frontmatter, body };
-}
-// ── Step ID to File Path Mapping ─────────────────────────────────────────
-/**
- * Map step ID to file path within core/steps/.
- *
- * Step IDs follow the pattern: step-{category}-{order}-{name}
- * File paths: core/steps/steps-{category}/{id}.md
- */
-function stepIdToPath(stepId) {
-    // Extract category from step ID: step-c-01-setup-branch -> c
-    // step-r-fix-blocked -> r, step-u-init -> u, step-p-01-idea-diagnose -> p, step-e-01-epic-init -> e
-    const parts = stepId.split('-');
-    if (parts.length < 3) {
-        throw new Error(`Invalid step ID format: ${stepId}`);
-    }
-    const category = parts[1]; // c, r, u, p, e
-    const categoryMap = {
-        c: 'steps-c',
-        r: 'steps-r',
-        u: 'steps-u',
-        p: 'steps-p',
-        e: 'steps-e',
-    };
-    const dir = categoryMap[category];
-    if (!dir) {
-        throw new Error(`Unknown step category '${category}' in step ID: ${stepId}`);
-    }
-    return `core/steps/${dir}/${stepId}.md`;
-}
-// ── LocalResolver Implementation ─────────────────────────────────────────
-export class LocalResolver {
-    mode = ResolverMode.LOCAL;
-    projectRoot;
-    constructor(options) {
-        this.projectRoot = resolve(options.projectRoot);
-    }
-    async resolveStep(stepId, _context) {
-        const relativePath = stepIdToPath(stepId);
-        const fullPath = join(this.projectRoot, relativePath);
-        const raw = await readFile(fullPath, 'utf-8');
-        const { frontmatter, body } = parseFrontmatter(raw);
-        return {
-            id: stepId,
-            content: body,
-            frontmatter,
-        };
-    }
-    async resolveSkill(skillId, _context) {
-        // Skills are organized in: core/skills/{category}/{skillId}.md
-        // or: core/skills/step-skills/{step}/{skillId}.md
-        // Try multiple paths to find the skill
-        const searchPaths = [
-            `core/skills/${skillId}.md`,
-            `core/skills/step-skills/${skillId}.md`,
-        ];
-        // Also try with nested path: "diagnose/prompt-enricher" -> core/skills/step-skills/diagnose/prompt-enricher.md
-        if (skillId.includes('/')) {
-            searchPaths.unshift(`core/skills/step-skills/${skillId}.md`);
-            searchPaths.unshift(`core/skills/${skillId}.md`);
-        }
-        let raw = null;
-        let resolvedPath = '';
-        for (const searchPath of searchPaths) {
-            const fullPath = join(this.projectRoot, searchPath);
-            try {
-                raw = await readFile(fullPath, 'utf-8');
-                resolvedPath = searchPath;
-                break;
-            }
-            catch {
-                // Try next path
-            }
-        }
-        if (raw === null) {
-            throw new Error(`Skill '${skillId}' not found. Searched: ${searchPaths.join(', ')}`);
-        }
-        const { frontmatter, body } = parseFrontmatter(raw);
-        return {
-            id: skillId,
-            content: body,
-            metadata: { ...frontmatter, resolvedPath },
-        };
-    }
-    async resolveStandard(standardId) {
-        const fullPath = join(this.projectRoot, 'core', 'standards', standardId);
-        let content;
-        try {
-            content = await readFile(fullPath, 'utf-8');
-        }
-        catch {
-            // Try with .md extension if not present
-            if (!standardId.endsWith('.md')) {
-                content = await readFile(`${fullPath}.md`, 'utf-8');
-            }
-            else {
-                throw new Error(`Standard '${standardId}' not found at ${fullPath}`);
-            }
-        }
-        return {
-            id: standardId,
-            content,
-        };
-    }
-    async resolveRegistry() {
-        const fullPath = join(this.projectRoot, 'core', 'data', 'step-registry.json');
-        const raw = await readFile(fullPath, 'utf-8');
-        return JSON.parse(raw);
-    }
-    async assemblePrompt(stepId, context) {
-        // Resolve the step content
-        const step = await this.resolveStep(stepId, context);
-        // Build variables map from context
-        const variables = {
-            '{story_id}': context.storyId,
-            '{story_title}': context.storyTitle,
-            '{step_id}': stepId,
-            '{step_name}': step.frontmatter['name'] || stepId,
-            '{current_status}': context.currentStatus,
-            '{epic_id}': context.epicId,
-            '{branch_name}': context.branchName,
-            '{platform_target}': context.platformTarget,
-        };
-        // Substitute variables in step content
-        let prompt = step.content;
-        for (const [key, value] of Object.entries(variables)) {
-            prompt = prompt.replaceAll(key, value);
-        }
-        // Resolve skills referenced in step frontmatter
-        const includedSkills = [];
-        const skillsRef = step.frontmatter['skills'];
-        if (skillsRef && typeof skillsRef === 'string') {
-            const skillIds = skillsRef.split(',').map((s) => s.trim());
-            for (const sid of skillIds) {
-                try {
-                    const skill = await this.resolveSkill(sid, context);
-                    prompt += `\n\n---\n\n# Skill: ${sid}\n\n${skill.content}`;
-                    includedSkills.push(sid);
-                }
-                catch {
-                    // Skill not found - skip
-                }
-            }
-        }
-        return {
-            prompt,
-            variables,
-            includedSkills,
-            includedStandards: [],
-        };
-    }
-    async isAvailable() {
-        try {
-            const corePath = join(this.projectRoot, 'core');
-            await access(corePath);
-            return true;
-        }
-        catch {
-            return false;
-        }
-    }
-    async dispose() {
-        // LocalResolver holds no resources to release
-    }
-}
+import{readFile as f,access as m}from"node:fs/promises";import{join as p,resolve as d}from"node:path";import{ResolverMode as y}from"../types/index.js";const w=/^---\n([\s\S]*?)\n---/;function u(c){const t=c.match(w);if(!t)return{frontmatter:{},body:c};const e={},r=t[1].split(`
+`);for(const n of r){const a=n.indexOf(":");if(a===-1)continue;const i=n.slice(0,a).trim().replace(/^['"]|['"]$/g,"");let o=n.slice(a+1).trim();typeof o=="string"&&(o=o.replace(/^['"]|['"]$/g,"")),o==="true"?o=!0:o==="false"&&(o=!1),e[i]=o}const s=c.slice(t[0].length).trimStart();return{frontmatter:e,body:s}}function $(c){const t=c.split("-");if(t.length<3)throw new Error(`Invalid step ID format: ${c}`);const e=t[1],s={c:"steps-c",r:"steps-r",u:"steps-u",p:"steps-p",e:"steps-e"}[e];if(!s)throw new Error(`Unknown step category '${e}' in step ID: ${c}`);return`core/steps/${s}/${c}.md`}class g{mode=y.LOCAL;projectRoot;constructor(t){this.projectRoot=d(t.projectRoot)}async resolveStep(t,e){const r=$(t),s=p(this.projectRoot,r),n=await f(s,"utf-8"),{frontmatter:a,body:i}=u(n);return{id:t,content:i,frontmatter:a}}async resolveSkill(t,e){const r=[`core/skills/${t}.md`,`core/skills/step-skills/${t}.md`];t.includes("/")&&(r.unshift(`core/skills/step-skills/${t}.md`),r.unshift(`core/skills/${t}.md`));let s=null,n="";for(const o of r){const l=p(this.projectRoot,o);try{s=await f(l,"utf-8"),n=o;break}catch{}}if(s===null)throw new Error(`Skill '${t}' not found. Searched: ${r.join(", ")}`);const{frontmatter:a,body:i}=u(s);return{id:t,content:i,metadata:{...a,resolvedPath:n}}}async resolveStandard(t){const e=p(this.projectRoot,"core","standards",t);let r;try{r=await f(e,"utf-8")}catch{if(!t.endsWith(".md"))r=await f(`${e}.md`,"utf-8");else throw new Error(`Standard '${t}' not found at ${e}`)}return{id:t,content:r}}async resolveRegistry(){const t=p(this.projectRoot,"core","data","step-registry.json"),e=await f(t,"utf-8");return JSON.parse(e)}async assemblePrompt(t,e){const r=await this.resolveStep(t,e),s={"{story_id}":e.storyId,"{story_title}":e.storyTitle,"{step_id}":t,"{step_name}":r.frontmatter.name||t,"{current_status}":e.currentStatus,"{epic_id}":e.epicId,"{branch_name}":e.branchName,"{platform_target}":e.platformTarget};let n=r.content;for(const[o,l]of Object.entries(s))n=n.replaceAll(o,l);const a=[],i=r.frontmatter.skills;if(i&&typeof i=="string"){const o=i.split(",").map(l=>l.trim());for(const l of o)try{const h=await this.resolveSkill(l,e);n+=`
+
+---
+
+# Skill: ${l}
+
+${h.content}`,a.push(l)}catch{}}return{prompt:n,variables:s,includedSkills:a,includedStandards:[]}}async isAvailable(){try{const t=p(this.projectRoot,"core");return await m(t),!0}catch{return!1}}async dispose(){}}export{g as LocalResolver};