@ornexus/neocortex 4.60.73 → 4.60.74

package/packages/client/dist/registry/registry-reconciliation.js

@@ -1,234 +1 @@
-import { execFileSync } from 'node:child_process';
-import { existsSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join, resolve } from 'node:path';
-export const REGISTRY_RECONCILIATION_REASON_CODES = Object.freeze({
-    VERSION_INVALID: 'REGISTRY_RECONCILIATION_VERSION_INVALID',
-    PROJECT_INVALID: 'REGISTRY_RECONCILIATION_PROJECT_INVALID',
-    DOWNGRADE_BLOCKED: 'REGISTRY_RECONCILIATION_DOWNGRADE_BLOCKED',
-    ARTIFACT_UNAVAILABLE: 'REGISTRY_RECONCILIATION_ARTIFACT_UNAVAILABLE',
-    ARTIFACT_MISMATCH: 'REGISTRY_RECONCILIATION_ARTIFACT_MISMATCH',
-    INSTALL_FAILED: 'REGISTRY_RECONCILIATION_INSTALL_FAILED',
-});
-export class RegistryReconciliationError extends Error {
-    reasonCode;
-    remediation;
-    constructor(reasonCode, remediation) {
-        super(`${reasonCode}: ${remediation}`);
-        this.reasonCode = reasonCode;
-        this.remediation = remediation;
-        this.name = 'RegistryReconciliationError';
-    }
-}
-const EXACT_SEMVER = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/u;
-const REGISTRY_VERSION = /^[A-Za-z0-9][A-Za-z0-9._-]{0,31}$/u;
-const SHA256 = /^[a-f0-9]{64}$/u;
-export function parseExactSemver(value) {
-    const match = EXACT_SEMVER.exec(value);
-    if (!match)
-        return undefined;
-    const numeric = [match[1], match[2], match[3]].map(Number);
-    if (numeric.some((part) => !Number.isSafeInteger(part)))
-        return undefined;
-    const prereleaseParts = match[4]?.split('.') ?? [];
-    if (prereleaseParts.some((part) => /^\d+$/u.test(part) && !/^(0|[1-9]\d*)$/u.test(part)))
-        return undefined;
-    const prerelease = prereleaseParts.map((part) => /^(0|[1-9]\d*)$/u.test(part) ? Number(part) : part);
-    return {
-        major: numeric[0],
-        minor: numeric[1],
-        patch: numeric[2],
-        prerelease,
-    };
-}
-export function compareExactSemver(left, right) {
-    const a = parseExactSemver(left);
-    const b = parseExactSemver(right);
-    if (!a || !b)
-        return undefined;
-    for (const key of ['major', 'minor', 'patch']) {
-        if (a[key] !== b[key])
-            return a[key] > b[key] ? 1 : -1;
-    }
-    if (a.prerelease.length === 0 || b.prerelease.length === 0) {
-        return a.prerelease.length === b.prerelease.length ? 0 : a.prerelease.length === 0 ? 1 : -1;
-    }
-    const length = Math.max(a.prerelease.length, b.prerelease.length);
-    for (let index = 0; index < length; index += 1) {
-        const av = a.prerelease[index];
-        const bv = b.prerelease[index];
-        if (av === undefined || bv === undefined)
-            return av === bv ? 0 : av === undefined ? -1 : 1;
-        if (av === bv)
-            continue;
-        if (typeof av === 'number' && typeof bv === 'string')
-            return -1;
-        if (typeof av === 'string' && typeof bv === 'number')
-            return 1;
-        return av > bv ? 1 : -1;
-    }
-    return 0;
-}
-function assertRegistryIdentity(value, reasonCode) {
-    if (!value || typeof value !== 'object' || Array.isArray(value)) {
-        throw new RegistryReconciliationError(reasonCode, 'Regenerate the local command registry and retry.');
-    }
-    const candidate = value;
-    if (typeof candidate.registryVersion !== 'string' || !REGISTRY_VERSION.test(candidate.registryVersion)
-        || typeof candidate.registryChecksum !== 'string' || !SHA256.test(candidate.registryChecksum)) {
-        throw new RegistryReconciliationError(reasonCode, 'Regenerate the local command registry and retry.');
-    }
-    return { version: candidate.registryVersion, checksum: candidate.registryChecksum };
-}
-/** Read only a Neocortex source checkout. Ordinary projects are not candidates. */
-export function readProjectRegistryIdentity(projectRoot) {
-    const packagePath = join(resolve(projectRoot), 'package.json');
-    if (!existsSync(packagePath))
-        return undefined;
-    let pkg;
-    try {
-        pkg = JSON.parse(readFileSync(packagePath, 'utf8'));
-    }
-    catch {
-        // A non-Neocortex project owns its package.json. Invoke validation remains
-        // responsible for it; registry reconciliation must not claim authority.
-        return undefined;
-    }
-    if (pkg.name !== '@ornexus/neocortex')
-        return undefined;
-    if (typeof pkg.version !== 'string' || !parseExactSemver(pkg.version)) {
-        throw new RegistryReconciliationError(REGISTRY_RECONCILIATION_REASON_CODES.PROJECT_INVALID, 'Set the local @ornexus/neocortex package to an exact valid version and retry.');
-    }
-    const manifestPath = join(resolve(projectRoot), 'generated', 'command-registry', 'manifest.json');
-    if (!existsSync(manifestPath)) {
-        throw new RegistryReconciliationError(REGISTRY_RECONCILIATION_REASON_CODES.PROJECT_INVALID, 'Run the repository command-registry generator, then retry.');
-    }
-    try {
-        const identity = assertRegistryIdentity(JSON.parse(readFileSync(manifestPath, 'utf8')), REGISTRY_RECONCILIATION_REASON_CODES.PROJECT_INVALID);
-        return { ...identity, packageVersion: pkg.version };
-    }
-    catch (error) {
-        if (error instanceof RegistryReconciliationError)
-            throw error;
-        throw new RegistryReconciliationError(REGISTRY_RECONCILIATION_REASON_CODES.PROJECT_INVALID, 'Regenerate the local command registry and retry.');
-    }
-}
-function readGeneratedIdentity(source) {
-    // Development builds retain exported identifiers. Published builds are
-    // minified, so use the public projection-manifest keys as a deterministic
-    // fallback rather than depending on private/minifier symbol names.
-    const version = source.match(/COMMAND_REGISTRY_VERSION\s*=\s*["']([^"']+)["']/u)?.[1]
-        ?? source.match(/registryVersion\s*:\s*["']([^"']+)["']/u)?.[1];
-    const checksum = source.match(/COMMAND_REGISTRY_CHECKSUM\s*=\s*["']([a-f0-9]{64})["']/u)?.[1]
-        ?? source.match(/registryChecksum\s*:\s*["']([a-f0-9]{64})["']/u)?.[1];
-    return assertRegistryIdentity({ registryVersion: version, registryChecksum: checksum }, REGISTRY_RECONCILIATION_REASON_CODES.ARTIFACT_MISMATCH);
-}
-/** Validate an npm-installed fixture without trusting lifecycle output. */
-export function readPublishedPackageIdentityFromPrefix(prefix) {
-    const root = join(prefix, 'node_modules', '@ornexus', 'neocortex');
-    try {
-        const pkg = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8'));
-        if (pkg.name !== '@ornexus/neocortex' || typeof pkg.version !== 'string' || !parseExactSemver(pkg.version)) {
-            throw new Error('invalid package identity');
-        }
-        const generatedPath = join(root, 'packages', 'client', 'dist', 'generated', 'command-registry.generated.js');
-        const identity = readGeneratedIdentity(readFileSync(generatedPath, 'utf8'));
-        return { packageName: '@ornexus/neocortex', packageVersion: pkg.version, ...identity };
-    }
-    catch {
-        throw new RegistryReconciliationError(REGISTRY_RECONCILIATION_REASON_CODES.ARTIFACT_MISMATCH, 'The published package does not contain a valid client registry projection; do not invoke.');
-    }
-}
-function defaultReadLatestVersion() {
-    return execFileSync('npm', ['view', '@ornexus/neocortex', 'version'], {
-        encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'], timeout: 30_000,
-    }).trim();
-}
-function defaultInspectPublished(version) {
-    const prefix = mkdtempSync(join(tmpdir(), 'neocortex-registry-reconcile-'));
-    try {
-        execFileSync('npm', [
-            'install', '--prefix', prefix, '--ignore-scripts', '--no-audit', '--no-fund', '--package-lock=false',
-            `@ornexus/neocortex@${version}`,
-        ], { stdio: 'ignore', timeout: 120_000 });
-        const identity = readPublishedPackageIdentityFromPrefix(prefix);
-        if (identity.packageVersion !== version)
-            throw new Error('npm resolved a different version');
-        return identity;
-    }
-    catch (error) {
-        if (error instanceof RegistryReconciliationError)
-            throw error;
-        throw new RegistryReconciliationError(REGISTRY_RECONCILIATION_REASON_CODES.ARTIFACT_UNAVAILABLE, `Verify public npm access, then install explicitly: npm install -g @ornexus/neocortex@${version}`);
-    }
-    finally {
-        rmSync(prefix, { recursive: true, force: true });
-    }
-}
-function defaultInstallGlobal(version) {
-    try {
-        execFileSync('npm', ['install', '-g', `@ornexus/neocortex@${version}`], {
-            stdio: 'ignore', timeout: 120_000,
-        });
-    }
-    catch {
-        throw new RegistryReconciliationError(REGISTRY_RECONCILIATION_REASON_CODES.INSTALL_FAILED, `Install the verified compatible client explicitly: npm install -g @ornexus/neocortex@${version}`);
-    }
-}
-function sameIdentity(left, right) {
-    return left.version === right.version && left.checksum === right.checksum;
-}
-export function reconcileRegistry(options) {
-    const installed = parseExactSemver(options.installedVersion);
-    if (!installed) {
-        throw new RegistryReconciliationError(REGISTRY_RECONCILIATION_REASON_CODES.VERSION_INVALID, 'Reinstall an exact published client version and retry.');
-    }
-    const dependencies = options.dependencies ?? {};
-    const project = (dependencies.readProject ?? readProjectRegistryIdentity)(options.projectRoot);
-    let selectedVersion;
-    let expectedIdentity;
-    let source = 'installed';
-    if (project) {
-        if (sameIdentity(project, options.installedIdentity)) {
-            return { status: 'current', selectedVersion: options.installedVersion, source: 'project' };
-        }
-        const order = compareExactSemver(project.packageVersion, options.installedVersion);
-        if (order === undefined) {
-            throw new RegistryReconciliationError(REGISTRY_RECONCILIATION_REASON_CODES.VERSION_INVALID, 'Use exact valid installed and project versions, then retry.');
-        }
-        if (order < 0) {
-            throw new RegistryReconciliationError(REGISTRY_RECONCILIATION_REASON_CODES.DOWNGRADE_BLOCKED, `The project requires ${project.packageVersion}, older than installed ${options.installedVersion}. Use a matching checkout or explicitly select a client version; automatic downgrade was refused.`);
-        }
-        selectedVersion = project.packageVersion;
-        expectedIdentity = project;
-        source = 'project';
-    }
-    else if (options.checkLatest) {
-        let latest;
-        try {
-            latest = (dependencies.readLatestVersion ?? defaultReadLatestVersion)().trim();
-        }
-        catch {
-            return { status: 'not-applicable', selectedVersion: options.installedVersion, source: 'installed' };
-        }
-        const order = compareExactSemver(latest, options.installedVersion);
-        if (order === undefined) {
-            throw new RegistryReconciliationError(REGISTRY_RECONCILIATION_REASON_CODES.VERSION_INVALID, 'The public latest or installed version is invalid; no update was attempted.');
-        }
-        // Crucially, inequality is not enough: older stable tags never replace a
-        // newer/beta installation.
-        if (order <= 0)
-            return { status: 'current', selectedVersion: options.installedVersion, source: 'installed' };
-        selectedVersion = latest;
-        source = 'latest';
-    }
-    else {
-        return { status: 'not-applicable', selectedVersion: options.installedVersion, source: 'installed' };
-    }
-    const published = (dependencies.inspectPublished ?? defaultInspectPublished)(selectedVersion);
-    if (published.packageVersion !== selectedVersion || (expectedIdentity && !sameIdentity(published, expectedIdentity))) {
-        throw new RegistryReconciliationError(REGISTRY_RECONCILIATION_REASON_CODES.ARTIFACT_MISMATCH, `The public ${selectedVersion} artifact does not match the local registry projection. Regenerate/release a matching artifact; no global package was changed.`);
-    }
-    (dependencies.installGlobal ?? defaultInstallGlobal)(selectedVersion);
-    return { status: 'updated', selectedVersion, source };
-}
+import{execFileSync as p}from"node:child_process";import{existsSync as g,mkdtempSync as E,readFileSync as I,rmSync as T}from"node:fs";import{tmpdir as N}from"node:os";import{join as u,resolve as h}from"node:path";const a=Object.freeze({VERSION_INVALID:"REGISTRY_RECONCILIATION_VERSION_INVALID",PROJECT_INVALID:"REGISTRY_RECONCILIATION_PROJECT_INVALID",DOWNGRADE_BLOCKED:"REGISTRY_RECONCILIATION_DOWNGRADE_BLOCKED",ARTIFACT_UNAVAILABLE:"REGISTRY_RECONCILIATION_ARTIFACT_UNAVAILABLE",ARTIFACT_MISMATCH:"REGISTRY_RECONCILIATION_ARTIFACT_MISMATCH",INSTALL_FAILED:"REGISTRY_RECONCILIATION_INSTALL_FAILED"});class o extends Error{reasonCode;remediation;constructor(r,e){super(`${r}: ${e}`),this.reasonCode=r,this.remediation=e,this.name="RegistryReconciliationError"}}const _=/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-([0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*))?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/u,V=/^[A-Za-z0-9][A-Za-z0-9._-]{0,31}$/u,C=/^[a-f0-9]{64}$/u;function f(t){const r=_.exec(t);if(!r)return;const e=[r[1],r[2],r[3]].map(Number);if(e.some(i=>!Number.isSafeInteger(i)))return;const n=r[4]?.split(".")??[];if(n.some(i=>/^\d+$/u.test(i)&&!/^(0|[1-9]\d*)$/u.test(i)))return;const s=n.map(i=>/^(0|[1-9]\d*)$/u.test(i)?Number(i):i);return{major:e[0],minor:e[1],patch:e[2],prerelease:s}}function y(t,r){const e=f(t),n=f(r);if(!e||!n)return;for(const i of["major","minor","patch"])if(e[i]!==n[i])return e[i]>n[i]?1:-1;if(e.prerelease.length===0||n.prerelease.length===0)return e.prerelease.length===n.prerelease.length?0:e.prerelease.length===0?1:-1;const s=Math.max(e.prerelease.length,n.prerelease.length);for(let i=0;i<s;i+=1){const c=e.prerelease[i],l=n.prerelease[i];if(c===void 0||l===void 0)return c===l?0:c===void 0?-1:1;if(c!==l)return typeof c=="number"&&typeof l=="string"?-1:typeof c=="string"&&typeof l=="number"||c>l?1:-1}return 0}function A(t,r){if(!t||typeof t!="object"||Array.isArray(t))throw new o(r,"Regenerate the local command registry and retry.");const e=t;if(typeof e.registryVersion!="string"||!V.test(e.registryVersion)||typeof e.registryChecksum!="string"||!C.test(e.registryChecksum))throw new o(r,"Regenerate the local command registry and retry.");return{version:e.registryVersion,checksum:e.registryChecksum}}function x(t){const r=u(h(t),"package.json");if(!g(r))return;let e;try{e=JSON.parse(I(r,"utf8"))}catch{return}if(e.name!=="@ornexus/neocortex")return;if(typeof e.version!="string"||!f(e.version))throw new o(a.PROJECT_INVALID,"Set the local @ornexus/neocortex package to an exact valid version and retry.");const n=u(h(t),"generated","command-registry","manifest.json");if(!g(n))throw new o(a.PROJECT_INVALID,"Run the repository command-registry generator, then retry.");try{return{...A(JSON.parse(I(n,"utf8")),a.PROJECT_INVALID),packageVersion:e.version}}catch(s){throw s instanceof o?s:new o(a.PROJECT_INVALID,"Regenerate the local command registry and retry.")}}function S(t){const r=t.match(/COMMAND_REGISTRY_VERSION\s*=\s*["']([^"']+)["']/u)?.[1]??t.match(/registryVersion\s*:\s*["']([^"']+)["']/u)?.[1],e=t.match(/COMMAND_REGISTRY_CHECKSUM\s*=\s*["']([a-f0-9]{64})["']/u)?.[1]??t.match(/registryChecksum\s*:\s*["']([a-f0-9]{64})["']/u)?.[1];return A({registryVersion:r,registryChecksum:e},a.ARTIFACT_MISMATCH)}function O(t){const r=u(t,"node_modules","@ornexus","neocortex");try{const e=JSON.parse(I(u(r,"package.json"),"utf8"));if(e.name!=="@ornexus/neocortex"||typeof e.version!="string"||!f(e.version))throw new Error("invalid package identity");const n=u(r,"packages","client","dist","generated","command-registry.generated.js"),s=S(I(n,"utf8"));return{packageName:"@ornexus/neocortex",packageVersion:e.version,...s}}catch{throw new o(a.ARTIFACT_MISMATCH,"The published package does not contain a valid client registry projection; do not invoke.")}}function L(){return p("npm",["view","@ornexus/neocortex","version"],{encoding:"utf8",stdio:["ignore","pipe","ignore"],timeout:3e4}).trim()}function w(t){const r=E(u(N(),"neocortex-registry-reconcile-"));try{p("npm",["install","--prefix",r,"--ignore-scripts","--no-audit","--no-fund","--package-lock=false",`@ornexus/neocortex@${t}`],{stdio:"ignore",timeout:12e4});const e=O(r);if(e.packageVersion!==t)throw new Error("npm resolved a different version");return e}catch(e){throw e instanceof o?e:new o(a.ARTIFACT_UNAVAILABLE,`Verify public npm access, then install explicitly: npm install -g @ornexus/neocortex@${t}`)}finally{T(r,{recursive:!0,force:!0})}}function k(t){try{p("npm",["install","-g",`@ornexus/neocortex@${t}`],{stdio:"ignore",timeout:12e4})}catch{throw new o(a.INSTALL_FAILED,`Install the verified compatible client explicitly: npm install -g @ornexus/neocortex@${t}`)}}function R(t,r){return t.version===r.version&&t.checksum===r.checksum}function M(t){if(!f(t.installedVersion))throw new o(a.VERSION_INVALID,"Reinstall an exact published client version and retry.");const e=t.dependencies??{},n=(e.readProject??x)(t.projectRoot);let s,i,c="installed";if(n){if(R(n,t.installedIdentity))return{status:"current",selectedVersion:t.installedVersion,source:"project"};const d=y(n.packageVersion,t.installedVersion);if(d===void 0)throw new o(a.VERSION_INVALID,"Use exact valid installed and project versions, then retry.");if(d<0)throw new o(a.DOWNGRADE_BLOCKED,`The project requires ${n.packageVersion}, older than installed ${t.installedVersion}. Use a matching checkout or explicitly select a client version; automatic downgrade was refused.`);s=n.packageVersion,i=n,c="project"}else if(t.checkLatest){let d;try{d=(e.readLatestVersion??L)().trim()}catch{return{status:"not-applicable",selectedVersion:t.installedVersion,source:"installed"}}const m=y(d,t.installedVersion);if(m===void 0)throw new o(a.VERSION_INVALID,"The public latest or installed version is invalid; no update was attempted.");if(m<=0)return{status:"current",selectedVersion:t.installedVersion,source:"installed"};s=d,c="latest"}else return{status:"not-applicable",selectedVersion:t.installedVersion,source:"installed"};const l=(e.inspectPublished??w)(s);if(l.packageVersion!==s||i&&!R(l,i))throw new o(a.ARTIFACT_MISMATCH,`The public ${s} artifact does not match the local registry projection. Regenerate/release a matching artifact; no global package was changed.`);return(e.installGlobal??k)(s),{status:"updated",selectedVersion:s,source:c}}export{a as REGISTRY_RECONCILIATION_REASON_CODES,o as RegistryReconciliationError,y as compareExactSemver,f as parseExactSemver,x as readProjectRegistryIdentity,O as readPublishedPackageIdentityFromPrefix,M as reconcileRegistry};

package/packages/client/dist/resilience/circuit-breaker.js

@@ -1,170 +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 - Persistent Circuit Breaker
- *
- * Circuit breaker with file-based state persistence for the CLI client.
- * Tracks server health using window-based failure counting and persists
- * state between CLI invocations at ~/.neocortex/.circuit-state.
- *
- * States:
- *   CLOSED    - Normal operation, requests pass through
- *   OPEN      - Circuit tripped, requests fail immediately (use cache)
- *   HALF_OPEN - Testing if server recovered (one probe request allowed)
- *
- * Story 42.9
- */
-import { readFile, writeFile, mkdir } from 'node:fs/promises';
-import { dirname } from 'node:path';
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-// ── Defaults ──────────────────────────────────────────────────────────────
-const DEFAULT_CONFIG = {
-    failureThreshold: 3,
-    failureWindowMs: 60_000,
-    halfOpenAfterMs: 60_000,
-    stateFilePath: join(homedir(), '.neocortex', '.circuit-state'),
-};
-const INITIAL_STATE = {
-    state: 'CLOSED',
-    failures: [],
-    openedAt: null,
-    lastProbeAt: null,
-};
-// ── ClientCircuitBreaker ──────────────────────────────────────────────────
-export class ClientCircuitBreaker {
-    config;
-    internalState;
-    constructor(config, initialState) {
-        this.config = { ...DEFAULT_CONFIG, ...config };
-        this.internalState = initialState ? { ...initialState } : { ...INITIAL_STATE, failures: [] };
-    }
-    /**
-     * Check if a request can be made to the server.
-     * Returns false if circuit is OPEN (fail-fast to cache).
-     */
-    canCall() {
-        this.pruneExpiredFailures();
-        switch (this.internalState.state) {
-            case 'CLOSED':
-                return true;
-            case 'OPEN': {
-                const now = Date.now();
-                const openedAt = this.internalState.openedAt ?? 0;
-                if (now - openedAt >= this.config.halfOpenAfterMs) {
-                    this.internalState.state = 'HALF_OPEN';
-                    this.internalState.lastProbeAt = now;
-                    return true;
-                }
-                return false;
-            }
-            case 'HALF_OPEN':
-                return true;
-            default:
-                return true;
-        }
-    }
-    /**
-     * Record a successful server response. Closes the circuit.
-     */
-    async recordSuccess() {
-        this.internalState.state = 'CLOSED';
-        this.internalState.failures = [];
-        this.internalState.openedAt = null;
-        this.internalState.lastProbeAt = null;
-        await this.saveToDisk();
-    }
-    /**
-     * Record a failed server response. Opens circuit after threshold failures in window.
-     */
-    async recordFailure() {
-        const now = Date.now();
-        this.internalState.failures.push({ timestamp: now });
-        this.pruneExpiredFailures();
-        if (this.internalState.failures.length >= this.config.failureThreshold) {
-            this.internalState.state = 'OPEN';
-            this.internalState.openedAt = now;
-        }
-        // If in HALF_OPEN and probe fails, go back to OPEN
-        if (this.internalState.state === 'HALF_OPEN') {
-            this.internalState.state = 'OPEN';
-            this.internalState.openedAt = now;
-        }
-        await this.saveToDisk();
-    }
-    /**
-     * Get current circuit breaker state (copy).
-     */
-    getState() {
-        this.pruneExpiredFailures();
-        return {
-            state: this.internalState.state,
-            failures: [...this.internalState.failures],
-            openedAt: this.internalState.openedAt,
-            lastProbeAt: this.internalState.lastProbeAt,
-        };
-    }
-    /**
-     * Reset circuit breaker to initial CLOSED state.
-     */
-    async reset() {
-        this.internalState = { ...INITIAL_STATE, failures: [] };
-        await this.saveToDisk();
-    }
-    /**
-     * Load circuit breaker state from disk.
-     */
-    static async loadFromDisk(path) {
-        const filePath = path ?? DEFAULT_CONFIG.stateFilePath;
-        try {
-            const raw = await readFile(filePath, 'utf8');
-            const data = JSON.parse(raw);
-            // Validate loaded state
-            if (!data.state || !Array.isArray(data.failures)) {
-                return new ClientCircuitBreaker({ stateFilePath: filePath });
-            }
-            return new ClientCircuitBreaker({ stateFilePath: filePath }, data);
-        }
-        catch {
-            // File doesn't exist or is corrupted - start fresh
-            return new ClientCircuitBreaker({ stateFilePath: filePath });
-        }
-    }
-    // ── Private ─────────────────────────────────────────────────────────
-    /**
-     * Remove failures outside the counting window.
-     */
-    pruneExpiredFailures() {
-        const cutoff = Date.now() - this.config.failureWindowMs;
-        this.internalState.failures = this.internalState.failures.filter((f) => f.timestamp > cutoff);
-    }
-    /**
-     * Persist state to disk with atomic write.
-     */
-    async saveToDisk() {
-        try {
-            const dir = dirname(this.config.stateFilePath);
-            await mkdir(dir, { recursive: true });
-            const tmpPath = `${this.config.stateFilePath}.tmp`;
-            const data = JSON.stringify(this.internalState, null, 2);
-            await writeFile(tmpPath, data, 'utf8');
-            // Atomic rename
-            const { rename } = await import('node:fs/promises');
-            await rename(tmpPath, this.config.stateFilePath);
-        }
-        catch {
-            // Persistence failures are non-critical - circuit breaker
-            // still works in-memory for current session
-        }
-    }
-}
+import{readFile as l,writeFile as o,mkdir as h}from"node:fs/promises";import{dirname as u}from"node:path";import{homedir as c}from"node:os";import{join as f}from"node:path";const n={failureThreshold:3,failureWindowMs:6e4,halfOpenAfterMs:6e4,stateFilePath:f(c(),".neocortex",".circuit-state")},r={state:"CLOSED",failures:[],openedAt:null,lastProbeAt:null};class i{config;internalState;constructor(t,e){this.config={...n,...t},this.internalState=e?{...e}:{...r,failures:[]}}canCall(){switch(this.pruneExpiredFailures(),this.internalState.state){case"CLOSED":return!0;case"OPEN":{const t=Date.now(),e=this.internalState.openedAt??0;return t-e>=this.config.halfOpenAfterMs?(this.internalState.state="HALF_OPEN",this.internalState.lastProbeAt=t,!0):!1}case"HALF_OPEN":return!0;default:return!0}}async recordSuccess(){this.internalState.state="CLOSED",this.internalState.failures=[],this.internalState.openedAt=null,this.internalState.lastProbeAt=null,await this.saveToDisk()}async recordFailure(){const t=Date.now();this.internalState.failures.push({timestamp:t}),this.pruneExpiredFailures(),this.internalState.failures.length>=this.config.failureThreshold&&(this.internalState.state="OPEN",this.internalState.openedAt=t),this.internalState.state==="HALF_OPEN"&&(this.internalState.state="OPEN",this.internalState.openedAt=t),await this.saveToDisk()}getState(){return this.pruneExpiredFailures(),{state:this.internalState.state,failures:[...this.internalState.failures],openedAt:this.internalState.openedAt,lastProbeAt:this.internalState.lastProbeAt}}async reset(){this.internalState={...r,failures:[]},await this.saveToDisk()}static async loadFromDisk(t){const e=t??n.stateFilePath;try{const s=await l(e,"utf8"),a=JSON.parse(s);return!a.state||!Array.isArray(a.failures)?new i({stateFilePath:e}):new i({stateFilePath:e},a)}catch{return new i({stateFilePath:e})}}pruneExpiredFailures(){const t=Date.now()-this.config.failureWindowMs;this.internalState.failures=this.internalState.failures.filter(e=>e.timestamp>t)}async saveToDisk(){try{const t=u(this.config.stateFilePath);await h(t,{recursive:!0});const e=`${this.config.stateFilePath}.tmp`,s=JSON.stringify(this.internalState,null,2);await o(e,s,"utf8");const{rename:a}=await import("node:fs/promises");await a(e,this.config.stateFilePath)}catch{}}}export{i as ClientCircuitBreaker};

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};