@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.
Files changed (156) hide show
  1. package/LICENSE +56 -0
  2. package/README.md +661 -0
  3. package/install.js +453 -0
  4. package/install.ps1 +1478 -0
  5. package/install.sh +1409 -0
  6. package/package.json +93 -0
  7. package/packages/client/dist/adapters/adapter-registry.d.ts +62 -0
  8. package/packages/client/dist/adapters/adapter-registry.d.ts.map +1 -0
  9. package/packages/client/dist/adapters/adapter-registry.js +107 -0
  10. package/packages/client/dist/adapters/adapter-registry.js.map +1 -0
  11. package/packages/client/dist/adapters/antigravity-adapter.d.ts +19 -0
  12. package/packages/client/dist/adapters/antigravity-adapter.d.ts.map +1 -0
  13. package/packages/client/dist/adapters/antigravity-adapter.js +78 -0
  14. package/packages/client/dist/adapters/antigravity-adapter.js.map +1 -0
  15. package/packages/client/dist/adapters/claude-code-adapter.d.ts +20 -0
  16. package/packages/client/dist/adapters/claude-code-adapter.d.ts.map +1 -0
  17. package/packages/client/dist/adapters/claude-code-adapter.js +80 -0
  18. package/packages/client/dist/adapters/claude-code-adapter.js.map +1 -0
  19. package/packages/client/dist/adapters/codex-adapter.d.ts +20 -0
  20. package/packages/client/dist/adapters/codex-adapter.d.ts.map +1 -0
  21. package/packages/client/dist/adapters/codex-adapter.js +81 -0
  22. package/packages/client/dist/adapters/codex-adapter.js.map +1 -0
  23. package/packages/client/dist/adapters/cursor-adapter.d.ts +20 -0
  24. package/packages/client/dist/adapters/cursor-adapter.d.ts.map +1 -0
  25. package/packages/client/dist/adapters/cursor-adapter.js +116 -0
  26. package/packages/client/dist/adapters/cursor-adapter.js.map +1 -0
  27. package/packages/client/dist/adapters/gemini-adapter.d.ts +19 -0
  28. package/packages/client/dist/adapters/gemini-adapter.d.ts.map +1 -0
  29. package/packages/client/dist/adapters/gemini-adapter.js +72 -0
  30. package/packages/client/dist/adapters/gemini-adapter.js.map +1 -0
  31. package/packages/client/dist/adapters/index.d.ts +20 -0
  32. package/packages/client/dist/adapters/index.d.ts.map +1 -0
  33. package/packages/client/dist/adapters/index.js +22 -0
  34. package/packages/client/dist/adapters/index.js.map +1 -0
  35. package/packages/client/dist/adapters/platform-detector.d.ts +47 -0
  36. package/packages/client/dist/adapters/platform-detector.d.ts.map +1 -0
  37. package/packages/client/dist/adapters/platform-detector.js +107 -0
  38. package/packages/client/dist/adapters/platform-detector.js.map +1 -0
  39. package/packages/client/dist/adapters/target-adapter.d.ts +71 -0
  40. package/packages/client/dist/adapters/target-adapter.d.ts.map +1 -0
  41. package/packages/client/dist/adapters/target-adapter.js +13 -0
  42. package/packages/client/dist/adapters/target-adapter.js.map +1 -0
  43. package/packages/client/dist/adapters/vscode-adapter.d.ts +20 -0
  44. package/packages/client/dist/adapters/vscode-adapter.d.ts.map +1 -0
  45. package/packages/client/dist/adapters/vscode-adapter.js +73 -0
  46. package/packages/client/dist/adapters/vscode-adapter.js.map +1 -0
  47. package/packages/client/dist/cache/crypto-utils.d.ts +31 -0
  48. package/packages/client/dist/cache/crypto-utils.d.ts.map +1 -0
  49. package/packages/client/dist/cache/crypto-utils.js +77 -0
  50. package/packages/client/dist/cache/crypto-utils.js.map +1 -0
  51. package/packages/client/dist/cache/encrypted-cache.d.ts +31 -0
  52. package/packages/client/dist/cache/encrypted-cache.d.ts.map +1 -0
  53. package/packages/client/dist/cache/encrypted-cache.js +92 -0
  54. package/packages/client/dist/cache/encrypted-cache.js.map +1 -0
  55. package/packages/client/dist/cache/index.d.ts +14 -0
  56. package/packages/client/dist/cache/index.d.ts.map +1 -0
  57. package/packages/client/dist/cache/index.js +14 -0
  58. package/packages/client/dist/cache/index.js.map +1 -0
  59. package/packages/client/dist/cli.d.ts +15 -0
  60. package/packages/client/dist/cli.d.ts.map +1 -0
  61. package/packages/client/dist/cli.js +182 -0
  62. package/packages/client/dist/cli.js.map +1 -0
  63. package/packages/client/dist/commands/activate.d.ts +48 -0
  64. package/packages/client/dist/commands/activate.d.ts.map +1 -0
  65. package/packages/client/dist/commands/activate.js +186 -0
  66. package/packages/client/dist/commands/activate.js.map +1 -0
  67. package/packages/client/dist/commands/cache-status.d.ts +40 -0
  68. package/packages/client/dist/commands/cache-status.d.ts.map +1 -0
  69. package/packages/client/dist/commands/cache-status.js +113 -0
  70. package/packages/client/dist/commands/cache-status.js.map +1 -0
  71. package/packages/client/dist/commands/invoke.d.ts +71 -0
  72. package/packages/client/dist/commands/invoke.d.ts.map +1 -0
  73. package/packages/client/dist/commands/invoke.js +345 -0
  74. package/packages/client/dist/commands/invoke.js.map +1 -0
  75. package/packages/client/dist/config/resolver-selection.d.ts +41 -0
  76. package/packages/client/dist/config/resolver-selection.d.ts.map +1 -0
  77. package/packages/client/dist/config/resolver-selection.js +278 -0
  78. package/packages/client/dist/config/resolver-selection.js.map +1 -0
  79. package/packages/client/dist/context/context-collector.d.ts +29 -0
  80. package/packages/client/dist/context/context-collector.d.ts.map +1 -0
  81. package/packages/client/dist/context/context-collector.js +223 -0
  82. package/packages/client/dist/context/context-collector.js.map +1 -0
  83. package/packages/client/dist/context/context-sanitizer.d.ts +29 -0
  84. package/packages/client/dist/context/context-sanitizer.d.ts.map +1 -0
  85. package/packages/client/dist/context/context-sanitizer.js +146 -0
  86. package/packages/client/dist/context/context-sanitizer.js.map +1 -0
  87. package/packages/client/dist/index.d.ts +55 -0
  88. package/packages/client/dist/index.d.ts.map +1 -0
  89. package/packages/client/dist/index.js +37 -0
  90. package/packages/client/dist/index.js.map +1 -0
  91. package/packages/client/dist/license/index.d.ts +6 -0
  92. package/packages/client/dist/license/index.d.ts.map +1 -0
  93. package/packages/client/dist/license/index.js +6 -0
  94. package/packages/client/dist/license/index.js.map +1 -0
  95. package/packages/client/dist/license/license-client.d.ts +53 -0
  96. package/packages/client/dist/license/license-client.d.ts.map +1 -0
  97. package/packages/client/dist/license/license-client.js +164 -0
  98. package/packages/client/dist/license/license-client.js.map +1 -0
  99. package/packages/client/dist/machine/fingerprint.d.ts +24 -0
  100. package/packages/client/dist/machine/fingerprint.d.ts.map +1 -0
  101. package/packages/client/dist/machine/fingerprint.js +61 -0
  102. package/packages/client/dist/machine/fingerprint.js.map +1 -0
  103. package/packages/client/dist/machine/index.d.ts +6 -0
  104. package/packages/client/dist/machine/index.d.ts.map +1 -0
  105. package/packages/client/dist/machine/index.js +6 -0
  106. package/packages/client/dist/machine/index.js.map +1 -0
  107. package/packages/client/dist/resilience/circuit-breaker.d.ts +71 -0
  108. package/packages/client/dist/resilience/circuit-breaker.d.ts.map +1 -0
  109. package/packages/client/dist/resilience/circuit-breaker.js +171 -0
  110. package/packages/client/dist/resilience/circuit-breaker.js.map +1 -0
  111. package/packages/client/dist/resilience/degradation-manager.d.ts +68 -0
  112. package/packages/client/dist/resilience/degradation-manager.d.ts.map +1 -0
  113. package/packages/client/dist/resilience/degradation-manager.js +165 -0
  114. package/packages/client/dist/resilience/degradation-manager.js.map +1 -0
  115. package/packages/client/dist/resilience/freshness-indicator.d.ts +60 -0
  116. package/packages/client/dist/resilience/freshness-indicator.d.ts.map +1 -0
  117. package/packages/client/dist/resilience/freshness-indicator.js +101 -0
  118. package/packages/client/dist/resilience/freshness-indicator.js.map +1 -0
  119. package/packages/client/dist/resilience/index.d.ts +9 -0
  120. package/packages/client/dist/resilience/index.d.ts.map +1 -0
  121. package/packages/client/dist/resilience/index.js +9 -0
  122. package/packages/client/dist/resilience/index.js.map +1 -0
  123. package/packages/client/dist/resilience/recovery-detector.d.ts +60 -0
  124. package/packages/client/dist/resilience/recovery-detector.d.ts.map +1 -0
  125. package/packages/client/dist/resilience/recovery-detector.js +75 -0
  126. package/packages/client/dist/resilience/recovery-detector.js.map +1 -0
  127. package/packages/client/dist/resolvers/asset-resolver.d.ts +80 -0
  128. package/packages/client/dist/resolvers/asset-resolver.d.ts.map +1 -0
  129. package/packages/client/dist/resolvers/asset-resolver.js +14 -0
  130. package/packages/client/dist/resolvers/asset-resolver.js.map +1 -0
  131. package/packages/client/dist/resolvers/local-resolver.d.ts +27 -0
  132. package/packages/client/dist/resolvers/local-resolver.d.ts.map +1 -0
  133. package/packages/client/dist/resolvers/local-resolver.js +219 -0
  134. package/packages/client/dist/resolvers/local-resolver.js.map +1 -0
  135. package/packages/client/dist/resolvers/remote-resolver.d.ts +63 -0
  136. package/packages/client/dist/resolvers/remote-resolver.d.ts.map +1 -0
  137. package/packages/client/dist/resolvers/remote-resolver.js +207 -0
  138. package/packages/client/dist/resolvers/remote-resolver.js.map +1 -0
  139. package/packages/client/dist/telemetry/index.d.ts +6 -0
  140. package/packages/client/dist/telemetry/index.d.ts.map +1 -0
  141. package/packages/client/dist/telemetry/index.js +6 -0
  142. package/packages/client/dist/telemetry/index.js.map +1 -0
  143. package/packages/client/dist/telemetry/offline-queue.d.ts +58 -0
  144. package/packages/client/dist/telemetry/offline-queue.d.ts.map +1 -0
  145. package/packages/client/dist/telemetry/offline-queue.js +132 -0
  146. package/packages/client/dist/telemetry/offline-queue.js.map +1 -0
  147. package/packages/client/dist/types/index.d.ts +141 -0
  148. package/packages/client/dist/types/index.d.ts.map +1 -0
  149. package/packages/client/dist/types/index.js +39 -0
  150. package/packages/client/dist/types/index.js.map +1 -0
  151. package/targets-stubs/antigravity/README.md +20 -0
  152. package/targets-stubs/claude-code/README.md +20 -0
  153. package/targets-stubs/codex/README.md +20 -0
  154. package/targets-stubs/cursor/README.md +20 -0
  155. package/targets-stubs/gemini-cli/README.md +20 -0
  156. 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"}