@ornexus/neocortex 3.8.0

package/packages/client/dist/commands/activate.js

@@ -0,0 +1,186 @@
+/**
+ * @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 - Activate Command
+ *
+ * Manages license activation for the Neocortex CLI.
+ * Validates license key with the IP Protection Server,
+ * caches JWT token, and creates user config file.
+ *
+ * Story 43.3 - AC1, AC3, AC4, AC5
+ */
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { LicenseClient } from '../license/license-client.js';
+import { getMachineFingerprint } from '../machine/fingerprint.js';
+// ── Constants ─────────────────────────────────────────────────────────────
+const CONFIG_DIR = join(homedir(), '.neocortex');
+const CONFIG_FILE = join(CONFIG_DIR, 'config.json');
+const DEFAULT_SERVER_URL = 'https://api.neocortex.ornexus.com';
+// License key format: NX-{TIER}-{random}-{random}
+const LICENSE_KEY_PATTERN = /^NX-(FREE|PRO|ENT)-[A-Z0-9]+-[A-Z0-9]+$/i;
+// ── Validation ────────────────────────────────────────────────────────────
+/**
+ * Validate license key format.
+ * Format: NX-{TIER}-{random}-{random}
+ * Tiers: FREE, PRO, ENT
+ */
+export function validateLicenseKeyFormat(key) {
+    if (!key || key.trim().length === 0) {
+        return { valid: false, error: 'License key cannot be empty' };
+    }
+    const trimmed = key.trim().toUpperCase();
+    if (!trimmed.startsWith('NX-')) {
+        return { valid: false, error: 'License key must start with "NX-"' };
+    }
+    if (!LICENSE_KEY_PATTERN.test(trimmed)) {
+        return {
+            valid: false,
+            error: 'Invalid license key format. Expected: NX-{TIER}-{ID} (e.g., NX-PRO-ABC-123)',
+        };
+    }
+    return { valid: true };
+}
+// ── Config Management ─────────────────────────────────────────────────────
+/**
+ * Load existing user config, if any.
+ */
+function loadExistingConfig() {
+    try {
+        if (existsSync(CONFIG_FILE)) {
+            const raw = readFileSync(CONFIG_FILE, 'utf-8');
+            return JSON.parse(raw);
+        }
+    }
+    catch {
+        // Corrupted config - will be overwritten
+    }
+    return null;
+}
+/**
+ * Save user config after successful activation.
+ * NOTE: License key is NOT stored - only JWT is cached by LicenseClient.
+ */
+function saveConfig(config) {
+    mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+// ── Activate Command ──────────────────────────────────────────────────────
+/**
+ * Activate a Neocortex license.
+ *
+ * Flow:
+ * 1. Validate license key format
+ * 2. Call IP Protection Server to activate
+ * 3. Cache JWT token via LicenseClient
+ * 4. Create/update ~/.neocortex/config.json
+ * 5. Return result with feedback
+ */
+export async function activate(options) {
+    const { licenseKey, serverUrl = DEFAULT_SERVER_URL } = options;
+    // 1. Validate license key
+    if (!licenseKey) {
+        return {
+            success: false,
+            message: 'No license key provided. Usage: neocortex activate NX-PRO-xxx',
+        };
+    }
+    const validation = validateLicenseKeyFormat(licenseKey);
+    if (!validation.valid) {
+        return {
+            success: false,
+            message: `Invalid license key: ${validation.error}`,
+        };
+    }
+    const normalizedKey = licenseKey.trim().toUpperCase();
+    // 2. Extract tier from key
+    const tierMatch = normalizedKey.match(/^NX-(FREE|PRO|ENT)-/);
+    const tier = tierMatch?.[1]?.toLowerCase() ?? 'unknown';
+    // 3. Attempt activation via LicenseClient
+    const client = new LicenseClient({
+        serverUrl,
+        licenseKey: normalizedKey,
+    });
+    let activationResult;
+    try {
+        activationResult = await client.activate();
+    }
+    catch {
+        return {
+            success: false,
+            message: [
+                'Failed to connect to IP Protection Server.',
+                '',
+                'Possible causes:',
+                `  - Server at ${serverUrl} is unreachable`,
+                '  - Network connectivity issue',
+                '  - Server is still being deployed',
+                '',
+                'Workaround: Use --local flag to run in local mode',
+            ].join('\n'),
+        };
+    }
+    if (!activationResult) {
+        return {
+            success: false,
+            message: [
+                'License activation failed.',
+                '',
+                'Possible causes:',
+                '  - Invalid or expired license key',
+                '  - License already activated on another machine',
+                '  - Server rejected the activation request',
+                '',
+                'Check your license key and try again.',
+                'Contact support if the problem persists.',
+            ].join('\n'),
+        };
+    }
+    // 4. Save config (without license key for security)
+    const config = {
+        serverUrl,
+        mode: 'remote',
+        machineId: getMachineFingerprint(),
+        activatedAt: new Date().toISOString(),
+        tier,
+    };
+    try {
+        saveConfig(config);
+    }
+    catch (err) {
+        return {
+            success: false,
+            message: `Failed to save config to ${CONFIG_FILE}: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    // 5. Return success
+    return {
+        success: true,
+        message: [
+            `License activated successfully!`,
+            '',
+            `  Tier:    ${tier}`,
+            `  Server:  ${serverUrl}`,
+            `  Config:  ${CONFIG_FILE}`,
+            `  Expires: ${Math.floor(activationResult.expiresIn / 3600)}h`,
+            '',
+            'You can now use Neocortex in remote mode.',
+            'The CLI will automatically fetch content from the server.',
+        ].join('\n'),
+        tier,
+        serverUrl,
+        configPath: CONFIG_FILE,
+    };
+}
+//# sourceMappingURL=activate.js.map

package/packages/client/dist/commands/activate.js.map

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

package/packages/client/dist/commands/cache-status.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @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.
+ */
+import type { ClientCircuitBreaker, CircuitState } from '../resilience/circuit-breaker.js';
+import type { OfflineTelemetryQueue } from '../telemetry/offline-queue.js';
+export interface CacheStatusInfo {
+    totalEntries: number;
+    totalSizeBytes: number;
+    totalSizeFormatted: string;
+    oldestEntry: Date | null;
+    newestEntry: Date | null;
+    staleEntries: number;
+    circuitState: CircuitState;
+    lastSync: Date | null;
+    telemetryQueueSize: number;
+}
+export interface CacheStatusOptions {
+    cacheDir: string;
+    circuitBreaker: ClientCircuitBreaker;
+    telemetryQueue: OfflineTelemetryQueue;
+    staleThresholdMs?: number;
+}
+/**
+ * Gather comprehensive cache status information.
+ */
+export declare function getCacheStatus(options: CacheStatusOptions): Promise<CacheStatusInfo>;
+/**
+ * Format cache status as a human-readable string for terminal output.
+ */
+export declare function formatCacheStatus(info: CacheStatusInfo): string;
+//# sourceMappingURL=cache-status.d.ts.map

package/packages/client/dist/commands/cache-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-status.d.ts","sourceRoot":"","sources":["../../src/commands/cache-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAcH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAI3E,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,YAAY,CAAC;IAC3B,QAAQ,EAAE,IAAI,GAAG,IAAI,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,oBAAoB,CAAC;IACrC,cAAc,EAAE,qBAAqB,CAAC;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0D1F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAkB/D"}

package/packages/client/dist/commands/cache-status.js

@@ -0,0 +1,113 @@
+/**
+ * @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 - Cache Status Command
+ *
+ * Displays comprehensive cache and circuit breaker status information.
+ * Shows entry count, total size, age range, stale entries, circuit state,
+ * and telemetry queue stats.
+ *
+ * Story 42.9 - AC7
+ */
+import { readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+// ── Implementation ──────────────────────────────────────────────────────
+/**
+ * Gather comprehensive cache status information.
+ */
+export async function getCacheStatus(options) {
+    const staleThreshold = options.staleThresholdMs ?? 86_400_000; // 24h default
+    let totalEntries = 0;
+    let totalSizeBytes = 0;
+    let staleEntries = 0;
+    let oldestEntry = null;
+    let newestEntry = null;
+    try {
+        const entries = await readdir(options.cacheDir);
+        const encFiles = entries.filter((e) => e.endsWith('.enc'));
+        totalEntries = encFiles.length;
+        const now = Date.now();
+        for (const file of encFiles) {
+            try {
+                const filePath = join(options.cacheDir, file);
+                const fileStat = await stat(filePath);
+                totalSizeBytes += fileStat.size;
+                const mtime = fileStat.mtime;
+                if (!oldestEntry || mtime < oldestEntry)
+                    oldestEntry = mtime;
+                if (!newestEntry || mtime > newestEntry)
+                    newestEntry = mtime;
+                if (now - mtime.getTime() > staleThreshold) {
+                    staleEntries++;
+                }
+            }
+            catch {
+                // Skip files that can't be stat'd
+            }
+        }
+    }
+    catch {
+        // Cache directory doesn't exist or can't be read
+    }
+    const circuitState = options.circuitBreaker.getState().state;
+    let telemetryQueueSize = 0;
+    try {
+        const queueStats = await options.telemetryQueue.getStats();
+        telemetryQueueSize = queueStats.count;
+    }
+    catch {
+        // Queue unavailable
+    }
+    return {
+        totalEntries,
+        totalSizeBytes,
+        totalSizeFormatted: formatBytes(totalSizeBytes),
+        oldestEntry,
+        newestEntry,
+        staleEntries,
+        circuitState,
+        lastSync: newestEntry, // Most recent cache write approximates last sync
+        telemetryQueueSize,
+    };
+}
+/**
+ * Format cache status as a human-readable string for terminal output.
+ */
+export function formatCacheStatus(info) {
+    const lines = [
+        '+-------------------------------------------------+',
+        '|  NEOCORTEX CACHE STATUS                         |',
+        '+-------------------------------------------------+',
+        `|  Total entries:    ${String(info.totalEntries).padEnd(29)}|`,
+        `|  Total size:       ${info.totalSizeFormatted.padEnd(29)}|`,
+        `|  Oldest entry:     ${(info.oldestEntry?.toISOString() ?? 'N/A').padEnd(29)}|`,
+        `|  Newest entry:     ${(info.newestEntry?.toISOString() ?? 'N/A').padEnd(29)}|`,
+        `|  Stale entries:    ${String(info.staleEntries).padEnd(29)}|`,
+        '|-------------------------------------------------|',
+        `|  Circuit breaker:  ${info.circuitState.padEnd(29)}|`,
+        `|  Last sync:        ${(info.lastSync?.toISOString() ?? 'N/A').padEnd(29)}|`,
+        `|  Telemetry queue:  ${(info.telemetryQueueSize + ' events').padEnd(29)}|`,
+        '+-------------------------------------------------+',
+    ];
+    return lines.join('\n');
+}
+// ── Helpers ─────────────────────────────────────────────────────────────
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(1024));
+    const value = bytes / Math.pow(1024, i);
+    return `${value.toFixed(i === 0 ? 0 : 1)} ${units[i]}`;
+}
+//# sourceMappingURL=cache-status.js.map

package/packages/client/dist/commands/cache-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-status.js","sourceRoot":"","sources":["../../src/commands/cache-status.ts"],"names":[],"mappings":"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"}

package/packages/client/dist/commands/invoke.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @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 interface InvokeOptions {
+    /** Raw args from the user (e.g., "*yolo @docs/stories/1.1.story.md") */
+    readonly args: string;
+    /** Project root directory (default: cwd) */
+    readonly projectRoot?: string;
+    /** Output format: 'json' for full response, 'plain' for instructions only */
+    readonly format?: 'json' | 'plain';
+    /** Server URL override */
+    readonly serverUrl?: string;
+    /** Platform target (default: 'claude-code') */
+    readonly platformTarget?: string;
+}
+export interface InvokeResult {
+    readonly success: boolean;
+    readonly instructions?: string;
+    readonly metadata?: Record<string, unknown>;
+    readonly error?: string;
+    readonly exitCode: number;
+}
+interface StateSnapshot {
+    readonly config: {
+        readonly project_name: string;
+        readonly default_branch: string;
+        readonly language: string;
+        readonly yolo_mode?: boolean;
+        readonly user_name?: string;
+        readonly worktree_base?: string;
+        readonly max_parallel_stories?: number;
+    };
+    readonly stories: Record<string, Record<string, unknown>>;
+    readonly epics: Record<string, Record<string, unknown>>;
+}
+/**
+ * Read state.json and construct a sanitized snapshot for the server.
+ * Relative paths only - no absolute paths sent to server.
+ */
+export declare function collectStateSnapshot(projectRoot: string): StateSnapshot;
+/**
+ * Execute the invoke command.
+ *
+ * Flow:
+ * 1. Load config to get server URL
+ * 2. Collect state snapshot from project root
+ * 3. Check menu cache for empty invocations
+ * 4. Send POST /api/v1/invoke
+ * 5. Format and return result
+ */
+export declare function invoke(options: InvokeOptions): Promise<InvokeResult>;
+/**
+ * CLI handler for the invoke command.
+ * Parses CLI args and delegates to invoke().
+ *
+ * Usage:
+ *   neocortex-client invoke --args "*yolo @story.md" --project-root /path
+ *   neocortex-client invoke --args "*status" --format json
+ */
+export declare function invokeCliHandler(argv: string[]): Promise<number>;
+export {};
+//# sourceMappingURL=invoke.d.ts.map

package/packages/client/dist/commands/invoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.d.ts","sourceRoot":"","sources":["../../src/commands/invoke.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA+BH,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACnC,0BAA0B;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,UAAU,aAAa;IACrB,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;QAChC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;KACxC,CAAC;IACF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACzD;AAqBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAiFvE;AA8HD;;;;;;;;;GASG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAwE1E;AAID;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkDtE"}