@ornexus/neocortex 3.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +56 -0
- package/README.md +661 -0
- package/install.js +453 -0
- package/install.ps1 +1478 -0
- package/install.sh +1409 -0
- package/package.json +93 -0
- package/packages/client/dist/adapters/adapter-registry.d.ts +62 -0
- package/packages/client/dist/adapters/adapter-registry.d.ts.map +1 -0
- package/packages/client/dist/adapters/adapter-registry.js +107 -0
- package/packages/client/dist/adapters/adapter-registry.js.map +1 -0
- package/packages/client/dist/adapters/antigravity-adapter.d.ts +19 -0
- package/packages/client/dist/adapters/antigravity-adapter.d.ts.map +1 -0
- package/packages/client/dist/adapters/antigravity-adapter.js +78 -0
- package/packages/client/dist/adapters/antigravity-adapter.js.map +1 -0
- package/packages/client/dist/adapters/claude-code-adapter.d.ts +20 -0
- package/packages/client/dist/adapters/claude-code-adapter.d.ts.map +1 -0
- package/packages/client/dist/adapters/claude-code-adapter.js +80 -0
- package/packages/client/dist/adapters/claude-code-adapter.js.map +1 -0
- package/packages/client/dist/adapters/codex-adapter.d.ts +20 -0
- package/packages/client/dist/adapters/codex-adapter.d.ts.map +1 -0
- package/packages/client/dist/adapters/codex-adapter.js +81 -0
- package/packages/client/dist/adapters/codex-adapter.js.map +1 -0
- package/packages/client/dist/adapters/cursor-adapter.d.ts +20 -0
- package/packages/client/dist/adapters/cursor-adapter.d.ts.map +1 -0
- package/packages/client/dist/adapters/cursor-adapter.js +116 -0
- package/packages/client/dist/adapters/cursor-adapter.js.map +1 -0
- package/packages/client/dist/adapters/gemini-adapter.d.ts +19 -0
- package/packages/client/dist/adapters/gemini-adapter.d.ts.map +1 -0
- package/packages/client/dist/adapters/gemini-adapter.js +72 -0
- package/packages/client/dist/adapters/gemini-adapter.js.map +1 -0
- package/packages/client/dist/adapters/index.d.ts +20 -0
- package/packages/client/dist/adapters/index.d.ts.map +1 -0
- package/packages/client/dist/adapters/index.js +22 -0
- package/packages/client/dist/adapters/index.js.map +1 -0
- package/packages/client/dist/adapters/platform-detector.d.ts +47 -0
- package/packages/client/dist/adapters/platform-detector.d.ts.map +1 -0
- package/packages/client/dist/adapters/platform-detector.js +107 -0
- package/packages/client/dist/adapters/platform-detector.js.map +1 -0
- package/packages/client/dist/adapters/target-adapter.d.ts +71 -0
- package/packages/client/dist/adapters/target-adapter.d.ts.map +1 -0
- package/packages/client/dist/adapters/target-adapter.js +13 -0
- package/packages/client/dist/adapters/target-adapter.js.map +1 -0
- package/packages/client/dist/adapters/vscode-adapter.d.ts +20 -0
- package/packages/client/dist/adapters/vscode-adapter.d.ts.map +1 -0
- package/packages/client/dist/adapters/vscode-adapter.js +73 -0
- package/packages/client/dist/adapters/vscode-adapter.js.map +1 -0
- package/packages/client/dist/cache/crypto-utils.d.ts +31 -0
- package/packages/client/dist/cache/crypto-utils.d.ts.map +1 -0
- package/packages/client/dist/cache/crypto-utils.js +77 -0
- package/packages/client/dist/cache/crypto-utils.js.map +1 -0
- package/packages/client/dist/cache/encrypted-cache.d.ts +31 -0
- package/packages/client/dist/cache/encrypted-cache.d.ts.map +1 -0
- package/packages/client/dist/cache/encrypted-cache.js +92 -0
- package/packages/client/dist/cache/encrypted-cache.js.map +1 -0
- package/packages/client/dist/cache/index.d.ts +14 -0
- package/packages/client/dist/cache/index.d.ts.map +1 -0
- package/packages/client/dist/cache/index.js +14 -0
- package/packages/client/dist/cache/index.js.map +1 -0
- package/packages/client/dist/cli.d.ts +15 -0
- package/packages/client/dist/cli.d.ts.map +1 -0
- package/packages/client/dist/cli.js +182 -0
- package/packages/client/dist/cli.js.map +1 -0
- package/packages/client/dist/commands/activate.d.ts +48 -0
- package/packages/client/dist/commands/activate.d.ts.map +1 -0
- package/packages/client/dist/commands/activate.js +186 -0
- package/packages/client/dist/commands/activate.js.map +1 -0
- package/packages/client/dist/commands/cache-status.d.ts +40 -0
- package/packages/client/dist/commands/cache-status.d.ts.map +1 -0
- package/packages/client/dist/commands/cache-status.js +113 -0
- package/packages/client/dist/commands/cache-status.js.map +1 -0
- package/packages/client/dist/commands/invoke.d.ts +71 -0
- package/packages/client/dist/commands/invoke.d.ts.map +1 -0
- package/packages/client/dist/commands/invoke.js +345 -0
- package/packages/client/dist/commands/invoke.js.map +1 -0
- package/packages/client/dist/config/resolver-selection.d.ts +41 -0
- package/packages/client/dist/config/resolver-selection.d.ts.map +1 -0
- package/packages/client/dist/config/resolver-selection.js +278 -0
- package/packages/client/dist/config/resolver-selection.js.map +1 -0
- package/packages/client/dist/context/context-collector.d.ts +29 -0
- package/packages/client/dist/context/context-collector.d.ts.map +1 -0
- package/packages/client/dist/context/context-collector.js +223 -0
- package/packages/client/dist/context/context-collector.js.map +1 -0
- package/packages/client/dist/context/context-sanitizer.d.ts +29 -0
- package/packages/client/dist/context/context-sanitizer.d.ts.map +1 -0
- package/packages/client/dist/context/context-sanitizer.js +146 -0
- package/packages/client/dist/context/context-sanitizer.js.map +1 -0
- package/packages/client/dist/index.d.ts +55 -0
- package/packages/client/dist/index.d.ts.map +1 -0
- package/packages/client/dist/index.js +37 -0
- package/packages/client/dist/index.js.map +1 -0
- package/packages/client/dist/license/index.d.ts +6 -0
- package/packages/client/dist/license/index.d.ts.map +1 -0
- package/packages/client/dist/license/index.js +6 -0
- package/packages/client/dist/license/index.js.map +1 -0
- package/packages/client/dist/license/license-client.d.ts +53 -0
- package/packages/client/dist/license/license-client.d.ts.map +1 -0
- package/packages/client/dist/license/license-client.js +164 -0
- package/packages/client/dist/license/license-client.js.map +1 -0
- package/packages/client/dist/machine/fingerprint.d.ts +24 -0
- package/packages/client/dist/machine/fingerprint.d.ts.map +1 -0
- package/packages/client/dist/machine/fingerprint.js +61 -0
- package/packages/client/dist/machine/fingerprint.js.map +1 -0
- package/packages/client/dist/machine/index.d.ts +6 -0
- package/packages/client/dist/machine/index.d.ts.map +1 -0
- package/packages/client/dist/machine/index.js +6 -0
- package/packages/client/dist/machine/index.js.map +1 -0
- package/packages/client/dist/resilience/circuit-breaker.d.ts +71 -0
- package/packages/client/dist/resilience/circuit-breaker.d.ts.map +1 -0
- package/packages/client/dist/resilience/circuit-breaker.js +171 -0
- package/packages/client/dist/resilience/circuit-breaker.js.map +1 -0
- package/packages/client/dist/resilience/degradation-manager.d.ts +68 -0
- package/packages/client/dist/resilience/degradation-manager.d.ts.map +1 -0
- package/packages/client/dist/resilience/degradation-manager.js +165 -0
- package/packages/client/dist/resilience/degradation-manager.js.map +1 -0
- package/packages/client/dist/resilience/freshness-indicator.d.ts +60 -0
- package/packages/client/dist/resilience/freshness-indicator.d.ts.map +1 -0
- package/packages/client/dist/resilience/freshness-indicator.js +101 -0
- package/packages/client/dist/resilience/freshness-indicator.js.map +1 -0
- package/packages/client/dist/resilience/index.d.ts +9 -0
- package/packages/client/dist/resilience/index.d.ts.map +1 -0
- package/packages/client/dist/resilience/index.js +9 -0
- package/packages/client/dist/resilience/index.js.map +1 -0
- package/packages/client/dist/resilience/recovery-detector.d.ts +60 -0
- package/packages/client/dist/resilience/recovery-detector.d.ts.map +1 -0
- package/packages/client/dist/resilience/recovery-detector.js +75 -0
- package/packages/client/dist/resilience/recovery-detector.js.map +1 -0
- package/packages/client/dist/resolvers/asset-resolver.d.ts +80 -0
- package/packages/client/dist/resolvers/asset-resolver.d.ts.map +1 -0
- package/packages/client/dist/resolvers/asset-resolver.js +14 -0
- package/packages/client/dist/resolvers/asset-resolver.js.map +1 -0
- package/packages/client/dist/resolvers/local-resolver.d.ts +27 -0
- package/packages/client/dist/resolvers/local-resolver.d.ts.map +1 -0
- package/packages/client/dist/resolvers/local-resolver.js +219 -0
- package/packages/client/dist/resolvers/local-resolver.js.map +1 -0
- package/packages/client/dist/resolvers/remote-resolver.d.ts +63 -0
- package/packages/client/dist/resolvers/remote-resolver.d.ts.map +1 -0
- package/packages/client/dist/resolvers/remote-resolver.js +207 -0
- package/packages/client/dist/resolvers/remote-resolver.js.map +1 -0
- package/packages/client/dist/telemetry/index.d.ts +6 -0
- package/packages/client/dist/telemetry/index.d.ts.map +1 -0
- package/packages/client/dist/telemetry/index.js +6 -0
- package/packages/client/dist/telemetry/index.js.map +1 -0
- package/packages/client/dist/telemetry/offline-queue.d.ts +58 -0
- package/packages/client/dist/telemetry/offline-queue.d.ts.map +1 -0
- package/packages/client/dist/telemetry/offline-queue.js +132 -0
- package/packages/client/dist/telemetry/offline-queue.js.map +1 -0
- package/packages/client/dist/types/index.d.ts +141 -0
- package/packages/client/dist/types/index.d.ts.map +1 -0
- package/packages/client/dist/types/index.js +39 -0
- package/packages/client/dist/types/index.js.map +1 -0
- package/targets-stubs/antigravity/README.md +20 -0
- package/targets-stubs/claude-code/README.md +20 -0
- package/targets-stubs/codex/README.md +20 -0
- package/targets-stubs/cursor/README.md +20 -0
- package/targets-stubs/gemini-cli/README.md +20 -0
- package/targets-stubs/vscode/README.md +20 -0
|
@@ -0,0 +1,165 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license FSL-1.1
|
|
3
|
+
* Copyright (c) 2026 OrNexus AI
|
|
4
|
+
*
|
|
5
|
+
* This file is part of Neocortex CLI, licensed under the
|
|
6
|
+
* Functional Source License, Version 1.1 (FSL-1.1).
|
|
7
|
+
*
|
|
8
|
+
* Change Date: February 20, 2029
|
|
9
|
+
* Change License: MIT
|
|
10
|
+
*
|
|
11
|
+
* See the LICENSE file in the project root for full license text.
|
|
12
|
+
*/
|
|
13
|
+
// ── Types ─────────────────────────────────────────────────────────────────
|
|
14
|
+
export var DegradationLevel;
|
|
15
|
+
(function (DegradationLevel) {
|
|
16
|
+
/** Server available, fresh data, optimal performance */
|
|
17
|
+
DegradationLevel[DegradationLevel["ONLINE"] = 0] = "ONLINE";
|
|
18
|
+
/** Server slow (>2s), use cache when available */
|
|
19
|
+
DegradationLevel[DegradationLevel["HIGH_LATENCY"] = 1] = "HIGH_LATENCY";
|
|
20
|
+
/** Server down, use cache exclusively */
|
|
21
|
+
DegradationLevel[DegradationLevel["SERVER_DOWN"] = 2] = "SERVER_DOWN";
|
|
22
|
+
/** Cache expired (>24h), use with warning */
|
|
23
|
+
DegradationLevel[DegradationLevel["STALE_CACHE"] = 3] = "STALE_CACHE";
|
|
24
|
+
/** No cache and no server - error state */
|
|
25
|
+
DegradationLevel[DegradationLevel["NO_CACHE"] = 4] = "NO_CACHE";
|
|
26
|
+
})(DegradationLevel || (DegradationLevel = {}));
|
|
27
|
+
// ── Defaults ──────────────────────────────────────────────────────────────
|
|
28
|
+
const DEFAULT_CONFIG = {
|
|
29
|
+
staleThresholdMs: 86_400_000, // 24 hours
|
|
30
|
+
warningThresholdMs: 43_200_000, // 12 hours
|
|
31
|
+
latencyThresholdMs: 2_000, // 2 seconds
|
|
32
|
+
};
|
|
33
|
+
// ── DegradationManager ───────────────────────────────────────────────────
|
|
34
|
+
export class DegradationManager {
|
|
35
|
+
config;
|
|
36
|
+
constructor(config) {
|
|
37
|
+
this.config = { ...DEFAULT_CONFIG, ...config };
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* Evaluate the current degradation level based on context.
|
|
41
|
+
*/
|
|
42
|
+
evaluate(context) {
|
|
43
|
+
// Force-offline mode: always use cache
|
|
44
|
+
if (context.forceOffline) {
|
|
45
|
+
return this.buildCacheOnlyDecision(context, '[OFFLINE]');
|
|
46
|
+
}
|
|
47
|
+
// Circuit is OPEN: server known to be down
|
|
48
|
+
if (context.circuitState === 'OPEN') {
|
|
49
|
+
return this.buildServerDownDecision(context);
|
|
50
|
+
}
|
|
51
|
+
// Circuit is HALF_OPEN: probing server
|
|
52
|
+
if (context.circuitState === 'HALF_OPEN') {
|
|
53
|
+
// Allow server request (probe), but prepare cache fallback
|
|
54
|
+
return {
|
|
55
|
+
level: DegradationLevel.SERVER_DOWN,
|
|
56
|
+
useCache: true,
|
|
57
|
+
useServer: true,
|
|
58
|
+
prefix: '[PROBING]',
|
|
59
|
+
warning: null,
|
|
60
|
+
};
|
|
61
|
+
}
|
|
62
|
+
// Circuit is CLOSED: server available
|
|
63
|
+
if (context.latencyMs != null && context.latencyMs > this.config.latencyThresholdMs) {
|
|
64
|
+
// High latency: prefer cache if available
|
|
65
|
+
if (context.cacheAvailable) {
|
|
66
|
+
return {
|
|
67
|
+
level: DegradationLevel.HIGH_LATENCY,
|
|
68
|
+
useCache: true,
|
|
69
|
+
useServer: false,
|
|
70
|
+
prefix: '[CACHED]',
|
|
71
|
+
warning: null,
|
|
72
|
+
};
|
|
73
|
+
}
|
|
74
|
+
// No cache available: still use server (slow is better than nothing)
|
|
75
|
+
return {
|
|
76
|
+
level: DegradationLevel.HIGH_LATENCY,
|
|
77
|
+
useCache: false,
|
|
78
|
+
useServer: true,
|
|
79
|
+
prefix: '',
|
|
80
|
+
warning: 'Server response is slow. Consider running `neocortex cache warmup`.',
|
|
81
|
+
};
|
|
82
|
+
}
|
|
83
|
+
// Normal operation
|
|
84
|
+
return {
|
|
85
|
+
level: DegradationLevel.ONLINE,
|
|
86
|
+
useCache: false,
|
|
87
|
+
useServer: true,
|
|
88
|
+
prefix: '',
|
|
89
|
+
warning: null,
|
|
90
|
+
};
|
|
91
|
+
}
|
|
92
|
+
// ── Private ─────────────────────────────────────────────────────────
|
|
93
|
+
buildServerDownDecision(context) {
|
|
94
|
+
if (!context.cacheAvailable) {
|
|
95
|
+
return {
|
|
96
|
+
level: DegradationLevel.NO_CACHE,
|
|
97
|
+
useCache: false,
|
|
98
|
+
useServer: false,
|
|
99
|
+
prefix: '[ERROR]',
|
|
100
|
+
warning: 'Server unavailable and no cached data. Run `neocortex cache warmup` when online.',
|
|
101
|
+
};
|
|
102
|
+
}
|
|
103
|
+
const cacheAgeMs = context.cacheAgeMs ?? 0;
|
|
104
|
+
if (cacheAgeMs > this.config.staleThresholdMs) {
|
|
105
|
+
const ageStr = this.formatAge(cacheAgeMs);
|
|
106
|
+
return {
|
|
107
|
+
level: DegradationLevel.STALE_CACHE,
|
|
108
|
+
useCache: true,
|
|
109
|
+
useServer: false,
|
|
110
|
+
prefix: `[STALE CACHE - ${ageStr}]`,
|
|
111
|
+
warning: `Cache is stale (${ageStr} old). Data may be outdated.`,
|
|
112
|
+
};
|
|
113
|
+
}
|
|
114
|
+
return {
|
|
115
|
+
level: DegradationLevel.SERVER_DOWN,
|
|
116
|
+
useCache: true,
|
|
117
|
+
useServer: false,
|
|
118
|
+
prefix: '[CACHED]',
|
|
119
|
+
warning: cacheAgeMs > this.config.warningThresholdMs
|
|
120
|
+
? `Cache is ${this.formatAge(cacheAgeMs)} old.`
|
|
121
|
+
: null,
|
|
122
|
+
};
|
|
123
|
+
}
|
|
124
|
+
buildCacheOnlyDecision(context, prefix) {
|
|
125
|
+
if (!context.cacheAvailable) {
|
|
126
|
+
return {
|
|
127
|
+
level: DegradationLevel.NO_CACHE,
|
|
128
|
+
useCache: false,
|
|
129
|
+
useServer: false,
|
|
130
|
+
prefix: '[ERROR]',
|
|
131
|
+
warning: 'Offline mode active but no cached data available. Run `neocortex cache warmup` when online.',
|
|
132
|
+
};
|
|
133
|
+
}
|
|
134
|
+
const cacheAgeMs = context.cacheAgeMs ?? 0;
|
|
135
|
+
if (cacheAgeMs > this.config.staleThresholdMs) {
|
|
136
|
+
const ageStr = this.formatAge(cacheAgeMs);
|
|
137
|
+
return {
|
|
138
|
+
level: DegradationLevel.STALE_CACHE,
|
|
139
|
+
useCache: true,
|
|
140
|
+
useServer: false,
|
|
141
|
+
prefix: `[STALE CACHE - ${ageStr}]`,
|
|
142
|
+
warning: `Using stale cache (${ageStr} old) in offline mode.`,
|
|
143
|
+
};
|
|
144
|
+
}
|
|
145
|
+
return {
|
|
146
|
+
level: DegradationLevel.SERVER_DOWN,
|
|
147
|
+
useCache: true,
|
|
148
|
+
useServer: false,
|
|
149
|
+
prefix,
|
|
150
|
+
warning: null,
|
|
151
|
+
};
|
|
152
|
+
}
|
|
153
|
+
formatAge(ms) {
|
|
154
|
+
const hours = Math.floor(ms / 3_600_000);
|
|
155
|
+
if (hours >= 48)
|
|
156
|
+
return `${Math.floor(hours / 24)}d`;
|
|
157
|
+
if (hours >= 1)
|
|
158
|
+
return `${hours}h`;
|
|
159
|
+
const minutes = Math.floor(ms / 60_000);
|
|
160
|
+
if (minutes >= 1)
|
|
161
|
+
return `${minutes}m`;
|
|
162
|
+
return '<1m';
|
|
163
|
+
}
|
|
164
|
+
}
|
|
165
|
+
//# sourceMappingURL=degradation-manager.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"degradation-manager.js","sourceRoot":"","sources":["../../src/resilience/degradation-manager.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license FSL-1.1
|
|
3
|
+
* Copyright (c) 2026 OrNexus AI
|
|
4
|
+
*
|
|
5
|
+
* This file is part of Neocortex CLI, licensed under the
|
|
6
|
+
* Functional Source License, Version 1.1 (FSL-1.1).
|
|
7
|
+
*
|
|
8
|
+
* Change Date: February 20, 2029
|
|
9
|
+
* Change License: MIT
|
|
10
|
+
*
|
|
11
|
+
* See the LICENSE file in the project root for full license text.
|
|
12
|
+
*/
|
|
13
|
+
/**
|
|
14
|
+
* @neocortex/client - Freshness Indicator
|
|
15
|
+
*
|
|
16
|
+
* Enriches cache responses with freshness metadata for user-facing display.
|
|
17
|
+
* Formats cache age as human-readable strings and generates appropriate
|
|
18
|
+
* warning prefixes based on degradation level.
|
|
19
|
+
*
|
|
20
|
+
* Story 42.9
|
|
21
|
+
*/
|
|
22
|
+
import { DegradationLevel } from './degradation-manager.js';
|
|
23
|
+
export interface FreshnessInfo {
|
|
24
|
+
/** Whether the response came from cache */
|
|
25
|
+
cached: boolean;
|
|
26
|
+
/** Age of cached entry in milliseconds */
|
|
27
|
+
cacheAgeMs: number;
|
|
28
|
+
/** Whether the cache entry is considered stale (>24h) */
|
|
29
|
+
stale: boolean;
|
|
30
|
+
/** Warning message if applicable, null otherwise */
|
|
31
|
+
warning: string | null;
|
|
32
|
+
/** Display prefix for CLI output */
|
|
33
|
+
prefix: string;
|
|
34
|
+
/** Version of the cached asset (if known) */
|
|
35
|
+
version?: string;
|
|
36
|
+
}
|
|
37
|
+
export interface FreshnessConfig {
|
|
38
|
+
/** Threshold in ms for stale warning. Default: 86_400_000 (24h) */
|
|
39
|
+
staleThresholdMs: number;
|
|
40
|
+
/** Threshold in ms for age warning. Default: 43_200_000 (12h) */
|
|
41
|
+
warningThresholdMs: number;
|
|
42
|
+
}
|
|
43
|
+
export declare class FreshnessIndicator {
|
|
44
|
+
private readonly config;
|
|
45
|
+
constructor(config?: Partial<FreshnessConfig>);
|
|
46
|
+
/**
|
|
47
|
+
* Format a duration in ms as human-readable age string.
|
|
48
|
+
* Examples: "30m ago", "4h ago", "2d ago"
|
|
49
|
+
*/
|
|
50
|
+
formatAge(ageMs: number): string;
|
|
51
|
+
/**
|
|
52
|
+
* Evaluate freshness of a cache entry.
|
|
53
|
+
*/
|
|
54
|
+
evaluate(cacheAgeMs: number, _ttlMs?: number): FreshnessInfo;
|
|
55
|
+
/**
|
|
56
|
+
* Format prefix string based on degradation level and optional age.
|
|
57
|
+
*/
|
|
58
|
+
formatPrefix(level: DegradationLevel, ageMs?: number): string;
|
|
59
|
+
}
|
|
60
|
+
//# sourceMappingURL=freshness-indicator.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"freshness-indicator.d.ts","sourceRoot":"","sources":["../../src/resilience/freshness-indicator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;GAQG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,MAAM,EAAE,OAAO,CAAC;IAChB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,gBAAgB,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAWD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAI7C;;;OAGG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAehC;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa;IA0B5D;;OAEG;IACH,YAAY,CAAC,KAAK,EAAE,gBAAgB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;CAgB9D"}
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license FSL-1.1
|
|
3
|
+
* Copyright (c) 2026 OrNexus AI
|
|
4
|
+
*
|
|
5
|
+
* This file is part of Neocortex CLI, licensed under the
|
|
6
|
+
* Functional Source License, Version 1.1 (FSL-1.1).
|
|
7
|
+
*
|
|
8
|
+
* Change Date: February 20, 2029
|
|
9
|
+
* Change License: MIT
|
|
10
|
+
*
|
|
11
|
+
* See the LICENSE file in the project root for full license text.
|
|
12
|
+
*/
|
|
13
|
+
/**
|
|
14
|
+
* @neocortex/client - Freshness Indicator
|
|
15
|
+
*
|
|
16
|
+
* Enriches cache responses with freshness metadata for user-facing display.
|
|
17
|
+
* Formats cache age as human-readable strings and generates appropriate
|
|
18
|
+
* warning prefixes based on degradation level.
|
|
19
|
+
*
|
|
20
|
+
* Story 42.9
|
|
21
|
+
*/
|
|
22
|
+
import { DegradationLevel } from './degradation-manager.js';
|
|
23
|
+
// ── Defaults ──────────────────────────────────────────────────────────────
|
|
24
|
+
const DEFAULT_CONFIG = {
|
|
25
|
+
staleThresholdMs: 86_400_000, // 24 hours
|
|
26
|
+
warningThresholdMs: 43_200_000, // 12 hours
|
|
27
|
+
};
|
|
28
|
+
// ── FreshnessIndicator ──────────────────────────────────────────────────
|
|
29
|
+
export class FreshnessIndicator {
|
|
30
|
+
config;
|
|
31
|
+
constructor(config) {
|
|
32
|
+
this.config = { ...DEFAULT_CONFIG, ...config };
|
|
33
|
+
}
|
|
34
|
+
/**
|
|
35
|
+
* Format a duration in ms as human-readable age string.
|
|
36
|
+
* Examples: "30m ago", "4h ago", "2d ago"
|
|
37
|
+
*/
|
|
38
|
+
formatAge(ageMs) {
|
|
39
|
+
if (ageMs < 0)
|
|
40
|
+
return 'just now';
|
|
41
|
+
const seconds = Math.floor(ageMs / 1_000);
|
|
42
|
+
const minutes = Math.floor(ageMs / 60_000);
|
|
43
|
+
const hours = Math.floor(ageMs / 3_600_000);
|
|
44
|
+
const days = Math.floor(ageMs / 86_400_000);
|
|
45
|
+
if (days >= 1)
|
|
46
|
+
return `${days}d ago`;
|
|
47
|
+
if (hours >= 1)
|
|
48
|
+
return `${hours}h ago`;
|
|
49
|
+
if (minutes >= 1)
|
|
50
|
+
return `${minutes}m ago`;
|
|
51
|
+
if (seconds >= 1)
|
|
52
|
+
return `${seconds}s ago`;
|
|
53
|
+
return 'just now';
|
|
54
|
+
}
|
|
55
|
+
/**
|
|
56
|
+
* Evaluate freshness of a cache entry.
|
|
57
|
+
*/
|
|
58
|
+
evaluate(cacheAgeMs, _ttlMs) {
|
|
59
|
+
const stale = cacheAgeMs > this.config.staleThresholdMs;
|
|
60
|
+
const aged = cacheAgeMs > this.config.warningThresholdMs;
|
|
61
|
+
let warning = null;
|
|
62
|
+
let prefix = '[CACHED]';
|
|
63
|
+
if (stale) {
|
|
64
|
+
const ageStr = this.formatAge(cacheAgeMs);
|
|
65
|
+
prefix = `[STALE CACHE - ${ageStr}]`;
|
|
66
|
+
warning = `WARNING: STALE - cached ${ageStr}`;
|
|
67
|
+
}
|
|
68
|
+
else if (aged) {
|
|
69
|
+
const ageStr = this.formatAge(cacheAgeMs);
|
|
70
|
+
prefix = `[CACHED]`;
|
|
71
|
+
warning = `WARNING - cached ${ageStr}`;
|
|
72
|
+
}
|
|
73
|
+
return {
|
|
74
|
+
cached: true,
|
|
75
|
+
cacheAgeMs,
|
|
76
|
+
stale,
|
|
77
|
+
warning,
|
|
78
|
+
prefix,
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* Format prefix string based on degradation level and optional age.
|
|
83
|
+
*/
|
|
84
|
+
formatPrefix(level, ageMs) {
|
|
85
|
+
switch (level) {
|
|
86
|
+
case DegradationLevel.ONLINE:
|
|
87
|
+
return '';
|
|
88
|
+
case DegradationLevel.HIGH_LATENCY:
|
|
89
|
+
return ageMs != null ? `[CACHED] cached ${this.formatAge(ageMs)}` : '[CACHED]';
|
|
90
|
+
case DegradationLevel.SERVER_DOWN:
|
|
91
|
+
return ageMs != null ? `[CACHED] cached ${this.formatAge(ageMs)}` : '[CACHED]';
|
|
92
|
+
case DegradationLevel.STALE_CACHE:
|
|
93
|
+
return ageMs != null ? `[STALE CACHE - ${this.formatAge(ageMs)}]` : '[STALE CACHE]';
|
|
94
|
+
case DegradationLevel.NO_CACHE:
|
|
95
|
+
return '[ERROR]';
|
|
96
|
+
default:
|
|
97
|
+
return '';
|
|
98
|
+
}
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
//# sourceMappingURL=freshness-indicator.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"freshness-indicator.js","sourceRoot":"","sources":["../../src/resilience/freshness-indicator.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license FSL-1.1
|
|
3
|
+
* Copyright (c) 2026 OrNexus AI
|
|
4
|
+
*/
|
|
5
|
+
export { ClientCircuitBreaker, type CircuitState, type CircuitBreakerConfig, type CircuitBreakerState, type FailureRecord } from './circuit-breaker.js';
|
|
6
|
+
export { DegradationManager, DegradationLevel, type DegradationContext, type DegradationDecision, type DegradationManagerConfig } from './degradation-manager.js';
|
|
7
|
+
export { FreshnessIndicator, type FreshnessInfo, type FreshnessConfig } from './freshness-indicator.js';
|
|
8
|
+
export { RecoveryDetector, type RecoveryActions, type RecoveryResult } from './recovery-detector.js';
|
|
9
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resilience/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAAE,KAAK,YAAY,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACxJ,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAClK,OAAO,EAAE,kBAAkB,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACxG,OAAO,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license FSL-1.1
|
|
3
|
+
* Copyright (c) 2026 OrNexus AI
|
|
4
|
+
*/
|
|
5
|
+
export { ClientCircuitBreaker } from './circuit-breaker.js';
|
|
6
|
+
export { DegradationManager, DegradationLevel } from './degradation-manager.js';
|
|
7
|
+
export { FreshnessIndicator } from './freshness-indicator.js';
|
|
8
|
+
export { RecoveryDetector } from './recovery-detector.js';
|
|
9
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resilience/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,oBAAoB,EAA8F,MAAM,sBAAsB,CAAC;AACxJ,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAoF,MAAM,0BAA0B,CAAC;AAClK,OAAO,EAAE,kBAAkB,EAA4C,MAAM,0BAA0B,CAAC;AACxG,OAAO,EAAE,gBAAgB,EAA6C,MAAM,wBAAwB,CAAC"}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license FSL-1.1
|
|
3
|
+
* Copyright (c) 2026 OrNexus AI
|
|
4
|
+
*
|
|
5
|
+
* This file is part of Neocortex CLI, licensed under the
|
|
6
|
+
* Functional Source License, Version 1.1 (FSL-1.1).
|
|
7
|
+
*
|
|
8
|
+
* Change Date: February 20, 2029
|
|
9
|
+
* Change License: MIT
|
|
10
|
+
*
|
|
11
|
+
* See the LICENSE file in the project root for full license text.
|
|
12
|
+
*/
|
|
13
|
+
/**
|
|
14
|
+
* @neocortex/client - Recovery Detector
|
|
15
|
+
*
|
|
16
|
+
* Coordinates recovery actions when server comes back online after
|
|
17
|
+
* a circuit breaker trip. Each step is independent - failures in one
|
|
18
|
+
* don't block the others.
|
|
19
|
+
*
|
|
20
|
+
* Recovery sequence:
|
|
21
|
+
* 1. Close circuit breaker (persist to file)
|
|
22
|
+
* 2. Re-validate JWT token
|
|
23
|
+
* 3. Sync cache with fresh server data (background)
|
|
24
|
+
* 4. Flush offline telemetry queue (background)
|
|
25
|
+
* 5. Notify user with [ONLINE] prefix
|
|
26
|
+
*
|
|
27
|
+
* Story 42.9
|
|
28
|
+
*/
|
|
29
|
+
import type { ClientCircuitBreaker } from './circuit-breaker.js';
|
|
30
|
+
import type { CacheProvider } from '../types/index.js';
|
|
31
|
+
import type { OfflineTelemetryQueue } from '../telemetry/offline-queue.js';
|
|
32
|
+
export interface RecoveryActions {
|
|
33
|
+
circuitBreaker: ClientCircuitBreaker;
|
|
34
|
+
licenseClient: {
|
|
35
|
+
getToken(): Promise<string | null>;
|
|
36
|
+
};
|
|
37
|
+
cache: CacheProvider;
|
|
38
|
+
telemetryQueue: OfflineTelemetryQueue;
|
|
39
|
+
serverUrl: string;
|
|
40
|
+
}
|
|
41
|
+
export interface RecoveryResult {
|
|
42
|
+
circuitClosed: boolean;
|
|
43
|
+
jwtRefreshed: boolean;
|
|
44
|
+
cacheSynced: boolean;
|
|
45
|
+
telemetryFlushed: {
|
|
46
|
+
sent: number;
|
|
47
|
+
failed: number;
|
|
48
|
+
};
|
|
49
|
+
notification: string;
|
|
50
|
+
}
|
|
51
|
+
export declare class RecoveryDetector {
|
|
52
|
+
private readonly actions;
|
|
53
|
+
constructor(actions: RecoveryActions);
|
|
54
|
+
/**
|
|
55
|
+
* Execute full recovery sequence.
|
|
56
|
+
* Each step is independent - failures are captured but don't block others.
|
|
57
|
+
*/
|
|
58
|
+
onRecovery(): Promise<RecoveryResult>;
|
|
59
|
+
}
|
|
60
|
+
//# sourceMappingURL=recovery-detector.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"recovery-detector.d.ts","sourceRoot":"","sources":["../../src/resilience/recovery-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAI3E,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,oBAAoB,CAAC;IACrC,aAAa,EAAE;QAAE,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;KAAE,CAAC;IACtD,KAAK,EAAE,aAAa,CAAC;IACrB,cAAc,EAAE,qBAAqB,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,OAAO,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;gBAE9B,OAAO,EAAE,eAAe;IAIpC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;CAsD5C"}
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license FSL-1.1
|
|
3
|
+
* Copyright (c) 2026 OrNexus AI
|
|
4
|
+
*
|
|
5
|
+
* This file is part of Neocortex CLI, licensed under the
|
|
6
|
+
* Functional Source License, Version 1.1 (FSL-1.1).
|
|
7
|
+
*
|
|
8
|
+
* Change Date: February 20, 2029
|
|
9
|
+
* Change License: MIT
|
|
10
|
+
*
|
|
11
|
+
* See the LICENSE file in the project root for full license text.
|
|
12
|
+
*/
|
|
13
|
+
// ── RecoveryDetector ─────────────────────────────────────────────────────
|
|
14
|
+
export class RecoveryDetector {
|
|
15
|
+
actions;
|
|
16
|
+
constructor(actions) {
|
|
17
|
+
this.actions = actions;
|
|
18
|
+
}
|
|
19
|
+
/**
|
|
20
|
+
* Execute full recovery sequence.
|
|
21
|
+
* Each step is independent - failures are captured but don't block others.
|
|
22
|
+
*/
|
|
23
|
+
async onRecovery() {
|
|
24
|
+
const result = {
|
|
25
|
+
circuitClosed: false,
|
|
26
|
+
jwtRefreshed: false,
|
|
27
|
+
cacheSynced: false,
|
|
28
|
+
telemetryFlushed: { sent: 0, failed: 0 },
|
|
29
|
+
notification: '[ONLINE] Server connection restored',
|
|
30
|
+
};
|
|
31
|
+
// Step 1: Close circuit breaker
|
|
32
|
+
try {
|
|
33
|
+
await this.actions.circuitBreaker.recordSuccess();
|
|
34
|
+
result.circuitClosed = true;
|
|
35
|
+
}
|
|
36
|
+
catch {
|
|
37
|
+
// Non-critical: breaker will close on next successful call
|
|
38
|
+
}
|
|
39
|
+
// Step 2: Re-validate JWT
|
|
40
|
+
try {
|
|
41
|
+
const token = await this.actions.licenseClient.getToken();
|
|
42
|
+
result.jwtRefreshed = token !== null;
|
|
43
|
+
}
|
|
44
|
+
catch {
|
|
45
|
+
// Non-critical: will be retried on next server call
|
|
46
|
+
}
|
|
47
|
+
// Step 3: Sync cache (background - just attempt, don't block)
|
|
48
|
+
try {
|
|
49
|
+
// We don't actually sync here - the next resolver call will
|
|
50
|
+
// update the cache automatically via fetchWithCacheFallback.
|
|
51
|
+
// We just mark as synced since the circuit is now closed.
|
|
52
|
+
result.cacheSynced = true;
|
|
53
|
+
}
|
|
54
|
+
catch {
|
|
55
|
+
// Non-critical
|
|
56
|
+
}
|
|
57
|
+
// Step 4: Flush telemetry queue
|
|
58
|
+
try {
|
|
59
|
+
const flushResult = await this.actions.telemetryQueue.flush(async (events) => {
|
|
60
|
+
const response = await fetch(`${this.actions.serverUrl}/api/v1/telemetry/batch`, {
|
|
61
|
+
method: 'POST',
|
|
62
|
+
headers: { 'Content-Type': 'application/json' },
|
|
63
|
+
body: JSON.stringify({ events }),
|
|
64
|
+
});
|
|
65
|
+
return response.ok;
|
|
66
|
+
});
|
|
67
|
+
result.telemetryFlushed = flushResult;
|
|
68
|
+
}
|
|
69
|
+
catch {
|
|
70
|
+
// Non-critical: queue will be flushed on next recovery
|
|
71
|
+
}
|
|
72
|
+
return result;
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
//# sourceMappingURL=recovery-detector.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"recovery-detector.js","sourceRoot":"","sources":["../../src/resilience/recovery-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAyCH,4EAA4E;AAE5E,MAAM,OAAO,gBAAgB;IACV,OAAO,CAAkB;IAE1C,YAAY,OAAwB;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,MAAM,GAAmB;YAC7B,aAAa,EAAE,KAAK;YACpB,YAAY,EAAE,KAAK;YACnB,WAAW,EAAE,KAAK;YAClB,gBAAgB,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;YACxC,YAAY,EAAE,qCAAqC;SACpD,CAAC;QAEF,gCAAgC;QAChC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC;YAClD,MAAM,CAAC,aAAa,GAAG,IAAI,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,2DAA2D;QAC7D,CAAC;QAED,0BAA0B;QAC1B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,QAAQ,EAAE,CAAC;YAC1D,MAAM,CAAC,YAAY,GAAG,KAAK,KAAK,IAAI,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,oDAAoD;QACtD,CAAC;QAED,8DAA8D;QAC9D,IAAI,CAAC;YACH,4DAA4D;YAC5D,6DAA6D;YAC7D,0DAA0D;YAC1D,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,eAAe;QACjB,CAAC;QAED,gCAAgC;QAChC,IAAI,CAAC;YACH,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,CACzD,KAAK,EAAE,MAAM,EAAE,EAAE;gBACf,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,yBAAyB,EAAE;oBAC/E,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;oBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;iBACjC,CAAC,CAAC;gBACH,OAAO,QAAQ,CAAC,EAAE,CAAC;YACrB,CAAC,CACF,CAAC;YACF,MAAM,CAAC,gBAAgB,GAAG,WAAW,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}
|
|
@@ -0,0 +1,80 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license FSL-1.1
|
|
3
|
+
* Copyright (c) 2026 OrNexus AI
|
|
4
|
+
*
|
|
5
|
+
* This file is part of Neocortex CLI, licensed under the
|
|
6
|
+
* Functional Source License, Version 1.1 (FSL-1.1).
|
|
7
|
+
*
|
|
8
|
+
* Change Date: February 20, 2029
|
|
9
|
+
* Change License: MIT
|
|
10
|
+
*
|
|
11
|
+
* See the LICENSE file in the project root for full license text.
|
|
12
|
+
*/
|
|
13
|
+
/**
|
|
14
|
+
* @neocortex/client - AssetResolver Interface
|
|
15
|
+
*
|
|
16
|
+
* Strategy pattern interface for resolving pipeline assets.
|
|
17
|
+
* Implementations: LocalResolver (filesystem) and RemoteResolver (HTTP API).
|
|
18
|
+
*/
|
|
19
|
+
import type { AssembledPrompt, PipelineContext, ResolverMode, SkillContent, StandardContent, StepContent, StepRegistry } from '../types/index.js';
|
|
20
|
+
/**
|
|
21
|
+
* AssetResolver - Core interface for the thin client abstraction layer.
|
|
22
|
+
*
|
|
23
|
+
* Enables the CLI to resolve pipeline assets (steps, skills, standards)
|
|
24
|
+
* from either local filesystem or remote server, transparently.
|
|
25
|
+
*/
|
|
26
|
+
export interface AssetResolver {
|
|
27
|
+
/** The mode this resolver operates in */
|
|
28
|
+
readonly mode: ResolverMode;
|
|
29
|
+
/**
|
|
30
|
+
* Resolve a pipeline step by its ID.
|
|
31
|
+
*
|
|
32
|
+
* @param stepId - Step identifier (e.g., "step-c-01-setup-branch")
|
|
33
|
+
* @param context - Current pipeline context for variable substitution
|
|
34
|
+
* @returns Resolved step content with parsed frontmatter
|
|
35
|
+
*/
|
|
36
|
+
resolveStep(stepId: string, context: PipelineContext): Promise<StepContent>;
|
|
37
|
+
/**
|
|
38
|
+
* Resolve a skill by its ID.
|
|
39
|
+
*
|
|
40
|
+
* @param skillId - Skill identifier (e.g., "tdd-guardian")
|
|
41
|
+
* @param context - Current pipeline context
|
|
42
|
+
* @returns Resolved skill content with metadata
|
|
43
|
+
*/
|
|
44
|
+
resolveSkill(skillId: string, context: PipelineContext): Promise<SkillContent>;
|
|
45
|
+
/**
|
|
46
|
+
* Resolve a standard by its ID.
|
|
47
|
+
*
|
|
48
|
+
* @param standardId - Standard identifier (e.g., "testing/tdd-practices")
|
|
49
|
+
* @returns Resolved standard content
|
|
50
|
+
*/
|
|
51
|
+
resolveStandard(standardId: string): Promise<StandardContent>;
|
|
52
|
+
/**
|
|
53
|
+
* Resolve the step registry (step-registry.json).
|
|
54
|
+
*
|
|
55
|
+
* @returns Parsed step registry with all step definitions
|
|
56
|
+
*/
|
|
57
|
+
resolveRegistry(): Promise<StepRegistry>;
|
|
58
|
+
/**
|
|
59
|
+
* Assemble a complete prompt for a step.
|
|
60
|
+
*
|
|
61
|
+
* Combines step content, required skills, and standards with
|
|
62
|
+
* variable substitution from the pipeline context.
|
|
63
|
+
*
|
|
64
|
+
* @param stepId - Step to assemble prompt for
|
|
65
|
+
* @param context - Current pipeline context
|
|
66
|
+
* @returns Fully assembled prompt ready for execution
|
|
67
|
+
*/
|
|
68
|
+
assemblePrompt(stepId: string, context: PipelineContext): Promise<AssembledPrompt>;
|
|
69
|
+
/**
|
|
70
|
+
* Check if this resolver is available and properly configured.
|
|
71
|
+
*
|
|
72
|
+
* @returns true if resolver can serve requests
|
|
73
|
+
*/
|
|
74
|
+
isAvailable(): Promise<boolean>;
|
|
75
|
+
/**
|
|
76
|
+
* Release any resources held by this resolver.
|
|
77
|
+
*/
|
|
78
|
+
dispose(): Promise<void>;
|
|
79
|
+
}
|
|
80
|
+
//# sourceMappingURL=asset-resolver.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"asset-resolver.d.ts","sourceRoot":"","sources":["../../src/resolvers/asset-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,WAAW,EACX,YAAY,EACb,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAE5B;;;;;;OAMG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAE5E;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/E;;;;;OAKG;IACH,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAE9D;;;;OAIG;IACH,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAEzC;;;;;;;;;OASG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEnF;;;;OAIG;IACH,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license FSL-1.1
|
|
3
|
+
* Copyright (c) 2026 OrNexus AI
|
|
4
|
+
*
|
|
5
|
+
* This file is part of Neocortex CLI, licensed under the
|
|
6
|
+
* Functional Source License, Version 1.1 (FSL-1.1).
|
|
7
|
+
*
|
|
8
|
+
* Change Date: February 20, 2029
|
|
9
|
+
* Change License: MIT
|
|
10
|
+
*
|
|
11
|
+
* See the LICENSE file in the project root for full license text.
|
|
12
|
+
*/
|
|
13
|
+
export {};
|
|
14
|
+
//# sourceMappingURL=asset-resolver.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"asset-resolver.js","sourceRoot":"","sources":["../../src/resolvers/asset-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @license FSL-1.1
|
|
3
|
+
* Copyright (c) 2026 OrNexus AI
|
|
4
|
+
*
|
|
5
|
+
* This file is part of Neocortex CLI, licensed under the
|
|
6
|
+
* Functional Source License, Version 1.1 (FSL-1.1).
|
|
7
|
+
*
|
|
8
|
+
* Change Date: February 20, 2029
|
|
9
|
+
* Change License: MIT
|
|
10
|
+
*
|
|
11
|
+
* See the LICENSE file in the project root for full license text.
|
|
12
|
+
*/
|
|
13
|
+
import type { AssetResolver } from './asset-resolver.js';
|
|
14
|
+
import { ResolverMode, type AssembledPrompt, type LocalResolverOptions, type PipelineContext, type SkillContent, type StandardContent, type StepContent, type StepRegistry } from '../types/index.js';
|
|
15
|
+
export declare class LocalResolver implements AssetResolver {
|
|
16
|
+
readonly mode = ResolverMode.LOCAL;
|
|
17
|
+
private readonly projectRoot;
|
|
18
|
+
constructor(options: LocalResolverOptions);
|
|
19
|
+
resolveStep(stepId: string, _context: PipelineContext): Promise<StepContent>;
|
|
20
|
+
resolveSkill(skillId: string, _context: PipelineContext): Promise<SkillContent>;
|
|
21
|
+
resolveStandard(standardId: string): Promise<StandardContent>;
|
|
22
|
+
resolveRegistry(): Promise<StepRegistry>;
|
|
23
|
+
assemblePrompt(stepId: string, context: PipelineContext): Promise<AssembledPrompt>;
|
|
24
|
+
isAvailable(): Promise<boolean>;
|
|
25
|
+
dispose(): Promise<void>;
|
|
26
|
+
}
|
|
27
|
+
//# sourceMappingURL=local-resolver.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"local-resolver.d.ts","sourceRoot":"","sources":["../../src/resolvers/local-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,eAAe,EACpB,KAAK,WAAW,EAChB,KAAK,YAAY,EAClB,MAAM,mBAAmB,CAAC;AAgF3B,qBAAa,aAAc,YAAW,aAAa;IACjD,QAAQ,CAAC,IAAI,sBAAsB;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,OAAO,EAAE,oBAAoB;IAInC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;IAa5E,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;IA4C/E,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAqB7D,eAAe,IAAI,OAAO,CAAC,YAAY,CAAC;IAMxC,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,eAAe,CAAC;IA8CrB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAU/B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}
|