@cleocode/contracts 2026.4.100 → 2026.4.101
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/dist/brain-graph.d.ts +245 -0
- package/dist/brain-graph.d.ts.map +1 -0
- package/dist/brain-graph.js +30 -0
- package/dist/brain-graph.js.map +1 -0
- package/dist/exit-codes.d.ts +1 -1
- package/dist/exit-codes.d.ts.map +1 -1
- package/dist/exit-codes.js +1 -1
- package/dist/exit-codes.js.map +1 -1
- package/dist/graph.d.ts +2 -0
- package/dist/graph.d.ts.map +1 -1
- package/dist/index.d.ts +8 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js.map +1 -1
- package/dist/nexus-contract-ops.d.ts +186 -0
- package/dist/nexus-contract-ops.d.ts.map +1 -0
- package/dist/nexus-contract-ops.js +11 -0
- package/dist/nexus-contract-ops.js.map +1 -0
- package/dist/nexus-living-brain-ops.d.ts +314 -0
- package/dist/nexus-living-brain-ops.d.ts.map +1 -0
- package/dist/nexus-living-brain-ops.js +15 -0
- package/dist/nexus-living-brain-ops.js.map +1 -0
- package/dist/nexus-query-ops.d.ts +82 -0
- package/dist/nexus-query-ops.d.ts.map +1 -0
- package/dist/nexus-query-ops.js +11 -0
- package/dist/nexus-query-ops.js.map +1 -0
- package/dist/nexus-route-ops.d.ts +103 -0
- package/dist/nexus-route-ops.d.ts.map +1 -0
- package/dist/nexus-route-ops.js +10 -0
- package/dist/nexus-route-ops.js.map +1 -0
- package/dist/nexus-tasks-bridge-ops.d.ts +68 -0
- package/dist/nexus-tasks-bridge-ops.d.ts.map +1 -0
- package/dist/nexus-tasks-bridge-ops.js +11 -0
- package/dist/nexus-tasks-bridge-ops.js.map +1 -0
- package/dist/nexus-wiki-ops.d.ts +51 -0
- package/dist/nexus-wiki-ops.d.ts.map +1 -0
- package/dist/nexus-wiki-ops.js +11 -0
- package/dist/nexus-wiki-ops.js.map +1 -0
- package/dist/operations/admin.d.ts +1781 -0
- package/dist/operations/admin.d.ts.map +1 -0
- package/dist/operations/admin.js +27 -0
- package/dist/operations/admin.js.map +1 -0
- package/dist/operations/brain.d.ts +34 -26
- package/dist/operations/brain.d.ts.map +1 -1
- package/dist/operations/brain.js +7 -6
- package/dist/operations/brain.js.map +1 -1
- package/dist/operations/docs.d.ts +279 -0
- package/dist/operations/docs.d.ts.map +1 -0
- package/dist/operations/docs.js +31 -0
- package/dist/operations/docs.js.map +1 -0
- package/dist/operations/intelligence.d.ts +319 -0
- package/dist/operations/intelligence.d.ts.map +1 -0
- package/dist/operations/intelligence.js +24 -0
- package/dist/operations/intelligence.js.map +1 -0
- package/dist/operations/orchestrate.d.ts +113 -2
- package/dist/operations/orchestrate.d.ts.map +1 -1
- package/dist/operations/orchestrate.js +3 -2
- package/dist/operations/orchestrate.js.map +1 -1
- package/dist/operations/session.d.ts +185 -47
- package/dist/operations/session.d.ts.map +1 -1
- package/dist/operations/session.js +7 -6
- package/dist/operations/session.js.map +1 -1
- package/dist/operations/sticky.d.ts +264 -0
- package/dist/operations/sticky.d.ts.map +1 -0
- package/dist/operations/sticky.js +19 -0
- package/dist/operations/sticky.js.map +1 -0
- package/dist/operations/validate.d.ts +145 -19
- package/dist/operations/validate.d.ts.map +1 -1
- package/dist/operations/validate.js +3 -3
- package/dist/task-record.d.ts +19 -0
- package/dist/task-record.d.ts.map +1 -1
- package/package.json +41 -1
- package/src/brain-graph.ts +282 -0
- package/src/exit-codes.ts +1 -1
- package/src/graph.ts +2 -0
- package/src/index.ts +109 -0
- package/src/nexus-contract-ops.ts +244 -0
- package/src/nexus-living-brain-ops.ts +345 -0
- package/src/nexus-query-ops.ts +100 -0
- package/src/nexus-route-ops.ts +134 -0
- package/src/nexus-tasks-bridge-ops.ts +71 -0
- package/src/nexus-wiki-ops.ts +53 -0
- package/src/operations/admin.ts +2087 -0
- package/src/operations/brain.ts +34 -26
- package/src/operations/docs.ts +322 -0
- package/src/operations/intelligence.ts +399 -0
- package/src/operations/orchestrate.ts +117 -2
- package/src/operations/session.ts +217 -48
- package/src/operations/sticky.ts +308 -0
- package/src/operations/validate.ts +161 -55
- package/src/task-record.ts +19 -0
|
@@ -0,0 +1,245 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Canonical Brain unified-graph types.
|
|
3
|
+
*
|
|
4
|
+
* These are the **single source of truth** for `BrainNode`, `BrainEdge`,
|
|
5
|
+
* `BrainGraph`, and their supporting types across the entire CLEO monorepo.
|
|
6
|
+
*
|
|
7
|
+
* All other packages MUST import these types from `@cleocode/contracts`
|
|
8
|
+
* (or a relative path into this file) rather than defining their own copies.
|
|
9
|
+
* Runtime packages such as `@cleocode/brain` re-export these types directly
|
|
10
|
+
* so downstream consumers do not need to change their import path.
|
|
11
|
+
*
|
|
12
|
+
* ## Shape rationale
|
|
13
|
+
*
|
|
14
|
+
* The types here are the **runtime** shapes produced by the substrate
|
|
15
|
+
* adapters in `@cleocode/brain` and consumed by every graph renderer,
|
|
16
|
+
* SSE stream, and API route in `@cleocode/studio`. The wire-format
|
|
17
|
+
* operation contracts in `./operations/brain.ts` are intentionally distinct
|
|
18
|
+
* (they use `from`/`to`/`kind` field names and a separate `BrainSubstrateName`
|
|
19
|
+
* vocabulary) and are namespaced under `ops.*` to avoid collisions.
|
|
20
|
+
*
|
|
21
|
+
* @task T989 — canonical type unification (was split across packages/brain
|
|
22
|
+
* and packages/contracts/operations/brain)
|
|
23
|
+
* @task T973 — LB* → Brain* rename
|
|
24
|
+
* @task T969 — `@cleocode/brain` package extraction
|
|
25
|
+
* @see packages/brain/src/types.ts (re-exports from here for backwards compat)
|
|
26
|
+
* @see packages/contracts/src/operations/brain.ts (wire-format / ops contracts)
|
|
27
|
+
* @see docs/plans/brain-synaptic-visualization-research.md §5.2
|
|
28
|
+
*/
|
|
29
|
+
/**
|
|
30
|
+
* All possible node kinds across the five CLEO substrates.
|
|
31
|
+
*
|
|
32
|
+
* - `observation` / `decision` / `pattern` / `learning` → BRAIN typed tables
|
|
33
|
+
* - `task` / `session` → TASKS
|
|
34
|
+
* - `symbol` / `file` → NEXUS
|
|
35
|
+
* - `agent` → SIGNALDOCK
|
|
36
|
+
* - `message` → CONDUIT
|
|
37
|
+
*/
|
|
38
|
+
export type BrainNodeKind = 'observation' | 'decision' | 'pattern' | 'learning' | 'task' | 'session' | 'symbol' | 'file' | 'agent' | 'message';
|
|
39
|
+
/**
|
|
40
|
+
* Which database a node or edge originates from.
|
|
41
|
+
*
|
|
42
|
+
* @remarks
|
|
43
|
+
* Uses the literal `'brain'` to match the on-disk `brain.db` filename.
|
|
44
|
+
* This differs from `BrainSubstrateName` in `./operations/brain.ts` which
|
|
45
|
+
* uses `'memory'` to align with the cognitive-memory domain rename. Callers
|
|
46
|
+
* that bridge runtime output to the wire format translate between the two
|
|
47
|
+
* naming planes at the adapter boundary.
|
|
48
|
+
*/
|
|
49
|
+
export type BrainSubstrate = 'brain' | 'nexus' | 'tasks' | 'conduit' | 'signaldock';
|
|
50
|
+
/**
|
|
51
|
+
* A single node in the unified CLEO Brain graph.
|
|
52
|
+
*
|
|
53
|
+
* The `id` field is always substrate-prefixed so nodes from different
|
|
54
|
+
* substrates can be merged without collisions:
|
|
55
|
+
* - `"brain:O-abc"` — a brain observation
|
|
56
|
+
* - `"nexus:sym-123"` — a nexus code symbol
|
|
57
|
+
* - `"tasks:T949"` — a CLEO task
|
|
58
|
+
* - `"conduit:msg-7f3a2b1c"` — a conduit message
|
|
59
|
+
* - `"signaldock:agent-cleo-prime"` — a SignalDock agent
|
|
60
|
+
*
|
|
61
|
+
* @remarks
|
|
62
|
+
* This is the shape produced by all substrate adapters in `@cleocode/brain`
|
|
63
|
+
* and consumed by graph renderers and SSE streams. It differs from the
|
|
64
|
+
* `BrainNodeWire` wire-format type in `./operations/brain.ts` which uses
|
|
65
|
+
* `type`/`data` instead of `kind`/`meta`.
|
|
66
|
+
*/
|
|
67
|
+
export interface BrainNode {
|
|
68
|
+
/** Substrate-prefixed identifier, e.g. `"brain:O-abc"`, `"nexus:sym-123"`. */
|
|
69
|
+
id: string;
|
|
70
|
+
/** Semantic category of this node. */
|
|
71
|
+
kind: BrainNodeKind;
|
|
72
|
+
/** Source database. */
|
|
73
|
+
substrate: BrainSubstrate;
|
|
74
|
+
/** Human-readable display label. */
|
|
75
|
+
label: string;
|
|
76
|
+
/**
|
|
77
|
+
* Optional numeric weight in `[0, 1]`.
|
|
78
|
+
*
|
|
79
|
+
* - BRAIN: `quality_score` (0.0–1.0)
|
|
80
|
+
* - NEXUS: in-degree / caller count (normalised)
|
|
81
|
+
* - TASKS: priority rank (critical=4 → 1.0, low=1 → 0.25)
|
|
82
|
+
* - CONDUIT / SIGNALDOCK: omitted
|
|
83
|
+
*/
|
|
84
|
+
weight?: number;
|
|
85
|
+
/**
|
|
86
|
+
* ISO-8601 creation timestamp, or `null` when the substrate does not
|
|
87
|
+
* expose a timestamp for this node type.
|
|
88
|
+
*
|
|
89
|
+
* - BRAIN: `brain_*` tables `created_at` column (ISO text)
|
|
90
|
+
* - NEXUS: `nexus_nodes.indexed_at` column (ISO text)
|
|
91
|
+
* - TASKS: `tasks.created_at` / `sessions.started_at` column (ISO text)
|
|
92
|
+
* - CONDUIT: `messages.created_at` converted from UNIX epoch (INTEGER)
|
|
93
|
+
* - SIGNALDOCK: `agents.created_at` converted from UNIX epoch (INTEGER), or null
|
|
94
|
+
*/
|
|
95
|
+
createdAt: string | null;
|
|
96
|
+
/** Substrate-specific metadata (source row fields, opaque to super-graph callers). */
|
|
97
|
+
meta: Record<string, unknown>;
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
* A directed edge between two nodes in the unified CLEO Brain graph.
|
|
101
|
+
*
|
|
102
|
+
* Both `source` and `target` reference `BrainNode.id` values
|
|
103
|
+
* (substrate-prefixed). Cross-substrate edges use `substrate: 'cross'`.
|
|
104
|
+
*
|
|
105
|
+
* @remarks
|
|
106
|
+
* This type uses `source`/`target`/`type` field names (matching D3/Cosmograph
|
|
107
|
+
* conventions). The wire-format type `BrainEdgeWire` in `./operations/brain.ts`
|
|
108
|
+
* uses `from`/`to`/`kind` and is a separate concern.
|
|
109
|
+
*/
|
|
110
|
+
export interface BrainEdge {
|
|
111
|
+
/** Source node ID (substrate-prefixed, references {@link BrainNode.id}). */
|
|
112
|
+
source: string;
|
|
113
|
+
/** Target node ID (substrate-prefixed, references {@link BrainNode.id}). */
|
|
114
|
+
target: string;
|
|
115
|
+
/**
|
|
116
|
+
* Semantic edge type.
|
|
117
|
+
*
|
|
118
|
+
* In-substrate examples: `'supersedes'` | `'derived_from'` | `'calls'` | `'imports'`
|
|
119
|
+
* Cross-substrate examples: `'mentions'` | `'applies_to'` | `'authored_by'` | `'modified'`
|
|
120
|
+
*/
|
|
121
|
+
type: string;
|
|
122
|
+
/**
|
|
123
|
+
* Edge weight in `[0, 1]`. Higher = stronger / more confident.
|
|
124
|
+
*
|
|
125
|
+
* - BRAIN: `brain_page_edges.weight` (Hebbian/STDP-trained)
|
|
126
|
+
* - NEXUS: relation `confidence`
|
|
127
|
+
* - Others: `0.5` default
|
|
128
|
+
*/
|
|
129
|
+
weight: number;
|
|
130
|
+
/** Which substrate produced this edge, or `'cross'` for synthesized cross-substrate edges. */
|
|
131
|
+
substrate: BrainSubstrate | 'cross';
|
|
132
|
+
}
|
|
133
|
+
/**
|
|
134
|
+
* Unified graph response returned by the Brain unified-graph API and the
|
|
135
|
+
* `getAllSubstrates` adapter in `@cleocode/brain`.
|
|
136
|
+
*
|
|
137
|
+
* - `nodes` / `edges`: combined projection across all requested substrates.
|
|
138
|
+
* - `counts`: per-substrate contribution breakdown.
|
|
139
|
+
* - `truncated`: `true` when results were capped by the `limit` parameter.
|
|
140
|
+
*/
|
|
141
|
+
export interface BrainGraph {
|
|
142
|
+
/** Merged, deduplicated nodes across all requested substrates. */
|
|
143
|
+
nodes: BrainNode[];
|
|
144
|
+
/** Directed edges (may reference stub nodes for cross-substrate targets). */
|
|
145
|
+
edges: BrainEdge[];
|
|
146
|
+
/** Per-substrate node/edge contribution counts. */
|
|
147
|
+
counts: {
|
|
148
|
+
/** Nodes contributed per substrate. */
|
|
149
|
+
nodes: Record<BrainSubstrate, number>;
|
|
150
|
+
/** Edges contributed per substrate (including `'cross'`). */
|
|
151
|
+
edges: Record<BrainSubstrate | 'cross', number>;
|
|
152
|
+
};
|
|
153
|
+
/** `true` when the response was capped by the node limit. */
|
|
154
|
+
truncated: boolean;
|
|
155
|
+
}
|
|
156
|
+
/**
|
|
157
|
+
* Minimum project context required by Brain substrate adapters to resolve
|
|
158
|
+
* per-project database paths.
|
|
159
|
+
*
|
|
160
|
+
* The studio's richer `ProjectContext` type carries additional fields
|
|
161
|
+
* (`projectId`, `name`, `brainDbExists`, etc.) and satisfies this interface
|
|
162
|
+
* via TypeScript structural typing.
|
|
163
|
+
*
|
|
164
|
+
* @remarks
|
|
165
|
+
* Defined here (rather than in `@cleocode/brain`) so that `BrainQueryOptions`
|
|
166
|
+
* can reference it without creating a circular dependency.
|
|
167
|
+
*/
|
|
168
|
+
export interface BrainProjectContext {
|
|
169
|
+
/** Absolute path to the project root. */
|
|
170
|
+
projectPath: string;
|
|
171
|
+
/** Absolute path to `brain.db` for this project. */
|
|
172
|
+
brainDbPath: string;
|
|
173
|
+
/** Absolute path to `tasks.db` for this project. */
|
|
174
|
+
tasksDbPath: string;
|
|
175
|
+
}
|
|
176
|
+
/**
|
|
177
|
+
* Query options forwarded from API route query parameters to substrate adapters.
|
|
178
|
+
*
|
|
179
|
+
* - `substrates`: filter to specific databases; omit for all five.
|
|
180
|
+
* - `limit`: cap on total node count (default 500, max 2000).
|
|
181
|
+
* - `minWeight`: excludes nodes/edges below this quality threshold.
|
|
182
|
+
* - `projectCtx`: resolves per-project DB paths; required for correct
|
|
183
|
+
* multi-project routing.
|
|
184
|
+
*/
|
|
185
|
+
export interface BrainQueryOptions {
|
|
186
|
+
/** Which substrates to include. Defaults to all five. */
|
|
187
|
+
substrates?: BrainSubstrate[];
|
|
188
|
+
/** Maximum number of nodes to return across all substrates. Default `500`. */
|
|
189
|
+
limit?: number;
|
|
190
|
+
/** Minimum quality/weight threshold for nodes and edges (0.0–1.0). Default `0`. */
|
|
191
|
+
minWeight?: number;
|
|
192
|
+
/**
|
|
193
|
+
* Active project context from `event.locals.projectCtx`.
|
|
194
|
+
* Per-project substrates (brain, tasks, conduit) use this to resolve DB paths.
|
|
195
|
+
* When absent, adapters fall back to the process-default paths.
|
|
196
|
+
*/
|
|
197
|
+
projectCtx?: BrainProjectContext;
|
|
198
|
+
}
|
|
199
|
+
/**
|
|
200
|
+
* Discriminated union of all SSE event payloads emitted by
|
|
201
|
+
* `GET /api/brain/stream`.
|
|
202
|
+
*
|
|
203
|
+
* Every variant carries a top-level `ts` field (ISO-8601 timestamp) so
|
|
204
|
+
* clients can sequence events even when they arrive out-of-order.
|
|
205
|
+
*
|
|
206
|
+
* - `hello` — sent immediately on connect; confirms the stream is live.
|
|
207
|
+
* - `heartbeat` — sent every 30 s to prevent connection timeout.
|
|
208
|
+
* - `node.create` — a new row was inserted into `brain_observations`.
|
|
209
|
+
* - `edge.strengthen` — a `brain_page_edges` row had its `weight` updated.
|
|
210
|
+
* - `task.status` — a `tasks` row changed its `status` column.
|
|
211
|
+
* - `message.send` — a new row was inserted into conduit messages.
|
|
212
|
+
*/
|
|
213
|
+
export type BrainStreamEvent = {
|
|
214
|
+
type: 'hello';
|
|
215
|
+
ts: string;
|
|
216
|
+
} | {
|
|
217
|
+
type: 'heartbeat';
|
|
218
|
+
ts: string;
|
|
219
|
+
} | {
|
|
220
|
+
type: 'node.create';
|
|
221
|
+
node: BrainNode;
|
|
222
|
+
ts: string;
|
|
223
|
+
} | {
|
|
224
|
+
type: 'edge.strengthen';
|
|
225
|
+
fromId: string;
|
|
226
|
+
toId: string;
|
|
227
|
+
edgeType: string;
|
|
228
|
+
weight: number;
|
|
229
|
+
ts: string;
|
|
230
|
+
} | {
|
|
231
|
+
type: 'task.status';
|
|
232
|
+
taskId: string;
|
|
233
|
+
status: string;
|
|
234
|
+
ts: string;
|
|
235
|
+
} | {
|
|
236
|
+
type: 'message.send';
|
|
237
|
+
messageId: string;
|
|
238
|
+
fromAgentId: string;
|
|
239
|
+
toAgentId: string;
|
|
240
|
+
preview: string;
|
|
241
|
+
ts: string;
|
|
242
|
+
};
|
|
243
|
+
/** Connection state for the SSE client subscription in the studio brain viewer. */
|
|
244
|
+
export type BrainConnectionStatus = 'connecting' | 'connected' | 'error' | 'disconnected';
|
|
245
|
+
//# sourceMappingURL=brain-graph.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"brain-graph.d.ts","sourceRoot":"","sources":["../src/brain-graph.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Canonical Brain unified-graph types.
|
|
3
|
+
*
|
|
4
|
+
* These are the **single source of truth** for `BrainNode`, `BrainEdge`,
|
|
5
|
+
* `BrainGraph`, and their supporting types across the entire CLEO monorepo.
|
|
6
|
+
*
|
|
7
|
+
* All other packages MUST import these types from `@cleocode/contracts`
|
|
8
|
+
* (or a relative path into this file) rather than defining their own copies.
|
|
9
|
+
* Runtime packages such as `@cleocode/brain` re-export these types directly
|
|
10
|
+
* so downstream consumers do not need to change their import path.
|
|
11
|
+
*
|
|
12
|
+
* ## Shape rationale
|
|
13
|
+
*
|
|
14
|
+
* The types here are the **runtime** shapes produced by the substrate
|
|
15
|
+
* adapters in `@cleocode/brain` and consumed by every graph renderer,
|
|
16
|
+
* SSE stream, and API route in `@cleocode/studio`. The wire-format
|
|
17
|
+
* operation contracts in `./operations/brain.ts` are intentionally distinct
|
|
18
|
+
* (they use `from`/`to`/`kind` field names and a separate `BrainSubstrateName`
|
|
19
|
+
* vocabulary) and are namespaced under `ops.*` to avoid collisions.
|
|
20
|
+
*
|
|
21
|
+
* @task T989 — canonical type unification (was split across packages/brain
|
|
22
|
+
* and packages/contracts/operations/brain)
|
|
23
|
+
* @task T973 — LB* → Brain* rename
|
|
24
|
+
* @task T969 — `@cleocode/brain` package extraction
|
|
25
|
+
* @see packages/brain/src/types.ts (re-exports from here for backwards compat)
|
|
26
|
+
* @see packages/contracts/src/operations/brain.ts (wire-format / ops contracts)
|
|
27
|
+
* @see docs/plans/brain-synaptic-visualization-research.md §5.2
|
|
28
|
+
*/
|
|
29
|
+
export {};
|
|
30
|
+
//# sourceMappingURL=brain-graph.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"brain-graph.js","sourceRoot":"","sources":["../src/brain-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}
|
package/dist/exit-codes.d.ts
CHANGED
package/dist/exit-codes.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../src/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oBAAY,QAAQ;IAElB,OAAO,IAAI;IAGX,aAAa,IAAI;IACjB,aAAa,IAAI;IACjB,UAAU,IAAI;IACd,SAAS,IAAI;IACb,gBAAgB,IAAI;IACpB,gBAAgB,IAAI;IACpB,YAAY,IAAI;IAChB,YAAY,IAAI;IAGhB,gBAAgB,KAAK;IACrB,cAAc,KAAK;IACnB,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,kBAAkB,KAAK;IACvB,eAAe,KAAK;IACpB,YAAY,KAAK;IACjB,cAAc,KAAK;IACnB,cAAc,KAAK;IACnB,cAAc,KAAK;IAGnB,iBAAiB,KAAK;IACtB,uBAAuB,KAAK;IAC5B,YAAY,KAAK;IAGjB,cAAc,KAAK;IACnB,iBAAiB,KAAK;IACtB,cAAc,KAAK;IACnB,aAAa,KAAK;IAClB,iBAAiB,KAAK;IACtB,YAAY,KAAK;IACjB,gBAAgB,KAAK;IACrB,qBAAqB,KAAK;IAC1B,oBAAoB,KAAK;IACzB,cAAc,KAAK;IAGnB,wBAAwB,KAAK;IAC7B,kBAAkB,KAAK;IACvB,YAAY,KAAK;IACjB,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,eAAe,KAAK;IACpB,mBAAmB,KAAK;IACxB,cAAc,KAAK;IAGnB,eAAe,KAAK;IACpB,eAAe,KAAK;IACpB,gBAAgB,KAAK;IACrB,iBAAiB,KAAK;IACtB,aAAa,KAAK;IAGlB,gBAAgB,KAAK;IACrB,sBAAsB,KAAK;IAC3B,sBAAsB,KAAK;IAC3B,uBAAuB,KAAK;IAC5B,mBAAmB,KAAK;IACxB,gBAAgB,KAAK;IACrB,aAAa,KAAK;IAClB,kBAAkB,KAAK;IACvB;;;;;;;;OAQG;IACH,oBAAoB,KAAK;IAEzB;;;;;;;;;;OAUG;IACH,mBAAmB,KAAK;IAGxB,qBAAqB,KAAK;IAC1B,uBAAuB,KAAK;IAC5B,uBAAuB,KAAK;IAC5B,oBAAoB,KAAK;IACzB,iBAAiB,KAAK;IACtB,sBAAsB,KAAK;IAC3B,oBAAoB,KAAK;IACzB,kBAAkB,KAAK;IACvB,iBAAiB,KAAK;IACtB,
|
|
1
|
+
{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../src/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,oBAAY,QAAQ;IAElB,OAAO,IAAI;IAGX,aAAa,IAAI;IACjB,aAAa,IAAI;IACjB,UAAU,IAAI;IACd,SAAS,IAAI;IACb,gBAAgB,IAAI;IACpB,gBAAgB,IAAI;IACpB,YAAY,IAAI;IAChB,YAAY,IAAI;IAGhB,gBAAgB,KAAK;IACrB,cAAc,KAAK;IACnB,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,kBAAkB,KAAK;IACvB,eAAe,KAAK;IACpB,YAAY,KAAK;IACjB,cAAc,KAAK;IACnB,cAAc,KAAK;IACnB,cAAc,KAAK;IAGnB,iBAAiB,KAAK;IACtB,uBAAuB,KAAK;IAC5B,YAAY,KAAK;IAGjB,cAAc,KAAK;IACnB,iBAAiB,KAAK;IACtB,cAAc,KAAK;IACnB,aAAa,KAAK;IAClB,iBAAiB,KAAK;IACtB,YAAY,KAAK;IACjB,gBAAgB,KAAK;IACrB,qBAAqB,KAAK;IAC1B,oBAAoB,KAAK;IACzB,cAAc,KAAK;IAGnB,wBAAwB,KAAK;IAC7B,kBAAkB,KAAK;IACvB,YAAY,KAAK;IACjB,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,eAAe,KAAK;IACpB,mBAAmB,KAAK;IACxB,cAAc,KAAK;IAGnB,eAAe,KAAK;IACpB,eAAe,KAAK;IACpB,gBAAgB,KAAK;IACrB,iBAAiB,KAAK;IACtB,aAAa,KAAK;IAGlB,gBAAgB,KAAK;IACrB,sBAAsB,KAAK;IAC3B,sBAAsB,KAAK;IAC3B,uBAAuB,KAAK;IAC5B,mBAAmB,KAAK;IACxB,gBAAgB,KAAK;IACrB,aAAa,KAAK;IAClB,kBAAkB,KAAK;IACvB;;;;;;;;OAQG;IACH,oBAAoB,KAAK;IAEzB;;;;;;;;;;OAUG;IACH,mBAAmB,KAAK;IAGxB,qBAAqB,KAAK;IAC1B,uBAAuB,KAAK;IAC5B,uBAAuB,KAAK;IAC5B,oBAAoB,KAAK;IACzB,iBAAiB,KAAK;IACtB,sBAAsB,KAAK;IAC3B,oBAAoB,KAAK;IACzB,kBAAkB,KAAK;IACvB,iBAAiB,KAAK;IACtB,qBAAqB,KAAK;IAG1B,qBAAqB,KAAK;IAC1B,aAAa,KAAK;IAClB,mBAAmB,KAAK;IACxB,4BAA4B,KAAK;IACjC,mBAAmB,KAAK;IAGxB,qBAAqB,KAAK;IAC1B,0BAA0B,KAAK;IAC/B,qBAAqB,KAAK;IAC1B,uBAAuB,KAAK;IAC5B,wBAAwB,KAAK;IAG7B,yBAAyB,KAAK;IAC9B,mBAAmB,KAAK;IACxB,iBAAiB,KAAK;IACtB,eAAe,KAAK;IACpB,mBAAmB,KAAK;IAGxB,iBAAiB,KAAK;IACtB,mBAAmB,KAAK;IACxB,mBAAmB,KAAK;IACxB,oBAAoB,KAAK;IACzB,sBAAsB,KAAK;IAG3B,OAAO,MAAM;IACb,cAAc,MAAM;IACpB,SAAS,MAAM;IACf,aAAa,MAAM;IAGnB;;;;;;;OAOG;IACH,cAAc,MAAM;CACrB;AAED,wDAAwD;AACxD,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEnD;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAErD;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED,gEAAgE;AAChE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CA0BzD;AAED,4CAA4C;AAC5C,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEtD"}
|
package/dist/exit-codes.js
CHANGED
|
@@ -102,7 +102,7 @@ export var ExitCode;
|
|
|
102
102
|
ExitCode[ExitCode["NEXUS_PROJECT_EXISTS"] = 76] = "NEXUS_PROJECT_EXISTS";
|
|
103
103
|
ExitCode[ExitCode["NEXUS_QUERY_FAILED"] = 77] = "NEXUS_QUERY_FAILED";
|
|
104
104
|
ExitCode[ExitCode["NEXUS_GRAPH_ERROR"] = 78] = "NEXUS_GRAPH_ERROR";
|
|
105
|
-
ExitCode[ExitCode["
|
|
105
|
+
ExitCode[ExitCode["NEXUS_IMPACT_CRITICAL"] = 79] = "NEXUS_IMPACT_CRITICAL";
|
|
106
106
|
// === LIFECYCLE ENFORCEMENT (80-84) ===
|
|
107
107
|
ExitCode[ExitCode["LIFECYCLE_GATE_FAILED"] = 80] = "LIFECYCLE_GATE_FAILED";
|
|
108
108
|
ExitCode[ExitCode["AUDIT_MISSING"] = 81] = "AUDIT_MISSING";
|
package/dist/exit-codes.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../src/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAN,IAAY,QAqJX;AArJD,WAAY,QAAQ;IAClB,sBAAsB;IACtB,6CAAW,CAAA;IAEX,+BAA+B;IAC/B,yDAAiB,CAAA;IACjB,yDAAiB,CAAA;IACjB,mDAAc,CAAA;IACd,iDAAa,CAAA;IACb,+DAAoB,CAAA;IACpB,+DAAoB,CAAA;IACpB,uDAAgB,CAAA;IAChB,uDAAgB,CAAA;IAEhB,mCAAmC;IACnC,gEAAqB,CAAA;IACrB,4DAAmB,CAAA;IACnB,0DAAkB,CAAA;IAClB,sEAAwB,CAAA;IACxB,oEAAuB,CAAA;IACvB,8DAAoB,CAAA;IACpB,wDAAiB,CAAA;IACjB,4DAAmB,CAAA;IACnB,4DAAmB,CAAA;IACnB,4DAAmB,CAAA;IAEnB,qCAAqC;IACrC,kEAAsB,CAAA;IACtB,8EAA4B,CAAA;IAC5B,wDAAiB,CAAA;IAEjB,iCAAiC;IACjC,4DAAmB,CAAA;IACnB,kEAAsB,CAAA;IACtB,4DAAmB,CAAA;IACnB,0DAAkB,CAAA;IAClB,kEAAsB,CAAA;IACtB,wDAAiB,CAAA;IACjB,gEAAqB,CAAA;IACrB,0EAA0B,CAAA;IAC1B,wEAAyB,CAAA;IACzB,4DAAmB,CAAA;IAEnB,sCAAsC;IACtC,gFAA6B,CAAA;IAC7B,oEAAuB,CAAA;IACvB,wDAAiB,CAAA;IACjB,0DAAkB,CAAA;IAClB,sEAAwB,CAAA;IACxB,8DAAoB,CAAA;IACpB,sEAAwB,CAAA;IACxB,4DAAmB,CAAA;IAEnB,oCAAoC;IACpC,8DAAoB,CAAA;IACpB,8DAAoB,CAAA;IACpB,gEAAqB,CAAA;IACrB,kEAAsB,CAAA;IACtB,0DAAkB,CAAA;IAElB,sCAAsC;IACtC,gEAAqB,CAAA;IACrB,4EAA2B,CAAA;IAC3B,4EAA2B,CAAA;IAC3B,8EAA4B,CAAA;IAC5B,sEAAwB,CAAA;IACxB,gEAAqB,CAAA;IACrB,0DAAkB,CAAA;IAClB,oEAAuB,CAAA;IACvB;;;;;;;;OAQG;IACH,wEAAyB,CAAA;IAEzB;;;;;;;;;;OAUG;IACH,sEAAwB,CAAA;IAExB,+BAA+B;IAC/B,0EAA0B,CAAA;IAC1B,8EAA4B,CAAA;IAC5B,8EAA4B,CAAA;IAC5B,wEAAyB,CAAA;IACzB,kEAAsB,CAAA;IACtB,4EAA2B,CAAA;IAC3B,wEAAyB,CAAA;IACzB,oEAAuB,CAAA;IACvB,kEAAsB,CAAA;IACtB,
|
|
1
|
+
{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../src/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAN,IAAY,QAqJX;AArJD,WAAY,QAAQ;IAClB,sBAAsB;IACtB,6CAAW,CAAA;IAEX,+BAA+B;IAC/B,yDAAiB,CAAA;IACjB,yDAAiB,CAAA;IACjB,mDAAc,CAAA;IACd,iDAAa,CAAA;IACb,+DAAoB,CAAA;IACpB,+DAAoB,CAAA;IACpB,uDAAgB,CAAA;IAChB,uDAAgB,CAAA;IAEhB,mCAAmC;IACnC,gEAAqB,CAAA;IACrB,4DAAmB,CAAA;IACnB,0DAAkB,CAAA;IAClB,sEAAwB,CAAA;IACxB,oEAAuB,CAAA;IACvB,8DAAoB,CAAA;IACpB,wDAAiB,CAAA;IACjB,4DAAmB,CAAA;IACnB,4DAAmB,CAAA;IACnB,4DAAmB,CAAA;IAEnB,qCAAqC;IACrC,kEAAsB,CAAA;IACtB,8EAA4B,CAAA;IAC5B,wDAAiB,CAAA;IAEjB,iCAAiC;IACjC,4DAAmB,CAAA;IACnB,kEAAsB,CAAA;IACtB,4DAAmB,CAAA;IACnB,0DAAkB,CAAA;IAClB,kEAAsB,CAAA;IACtB,wDAAiB,CAAA;IACjB,gEAAqB,CAAA;IACrB,0EAA0B,CAAA;IAC1B,wEAAyB,CAAA;IACzB,4DAAmB,CAAA;IAEnB,sCAAsC;IACtC,gFAA6B,CAAA;IAC7B,oEAAuB,CAAA;IACvB,wDAAiB,CAAA;IACjB,0DAAkB,CAAA;IAClB,sEAAwB,CAAA;IACxB,8DAAoB,CAAA;IACpB,sEAAwB,CAAA;IACxB,4DAAmB,CAAA;IAEnB,oCAAoC;IACpC,8DAAoB,CAAA;IACpB,8DAAoB,CAAA;IACpB,gEAAqB,CAAA;IACrB,kEAAsB,CAAA;IACtB,0DAAkB,CAAA;IAElB,sCAAsC;IACtC,gEAAqB,CAAA;IACrB,4EAA2B,CAAA;IAC3B,4EAA2B,CAAA;IAC3B,8EAA4B,CAAA;IAC5B,sEAAwB,CAAA;IACxB,gEAAqB,CAAA;IACrB,0DAAkB,CAAA;IAClB,oEAAuB,CAAA;IACvB;;;;;;;;OAQG;IACH,wEAAyB,CAAA;IAEzB;;;;;;;;;;OAUG;IACH,sEAAwB,CAAA;IAExB,+BAA+B;IAC/B,0EAA0B,CAAA;IAC1B,8EAA4B,CAAA;IAC5B,8EAA4B,CAAA;IAC5B,wEAAyB,CAAA;IACzB,kEAAsB,CAAA;IACtB,4EAA2B,CAAA;IAC3B,wEAAyB,CAAA;IACzB,oEAAuB,CAAA;IACvB,kEAAsB,CAAA;IACtB,0EAA0B,CAAA;IAE1B,wCAAwC;IACxC,0EAA0B,CAAA;IAC1B,0DAAkB,CAAA;IAClB,sEAAwB,CAAA;IACxB,wFAAiC,CAAA;IACjC,sEAAwB,CAAA;IAExB,mCAAmC;IACnC,0EAA0B,CAAA;IAC1B,oFAA+B,CAAA;IAC/B,0EAA0B,CAAA;IAC1B,8EAA4B,CAAA;IAC5B,gFAA6B,CAAA;IAE7B,6BAA6B;IAC7B,kFAA8B,CAAA;IAC9B,sEAAwB,CAAA;IACxB,kEAAsB,CAAA;IACtB,8DAAoB,CAAA;IACpB,sEAAwB,CAAA;IAExB,iCAAiC;IACjC,kEAAsB,CAAA;IACtB,sEAAwB,CAAA;IACxB,sEAAwB,CAAA;IACxB,wEAAyB,CAAA;IACzB,4EAA2B,CAAA;IAE3B,4CAA4C;IAC5C,+CAAa,CAAA;IACb,6DAAoB,CAAA;IACpB,mDAAe,CAAA;IACf,2DAAmB,CAAA;IAEnB,6CAA6C;IAC7C;;;;;;;OAOG;IACH,6DAAoB,CAAA;AACtB,CAAC,EArJW,QAAQ,KAAR,QAAQ,QAqJnB;AAED,wDAAwD;AACxD,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,OAAO,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,GAAG,CAAC;AACjC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAAC,IAAc;IAC1C,OAAO,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,GAAG,CAAC;AACnC,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,cAAc,CAAC,IAAc;IAC3C,OAAO,IAAI,KAAK,QAAQ,CAAC,SAAS,CAAC;AACrC,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,MAAM,cAAc,GAAG,IAAI,GAAG,CAAW;QACvC,QAAQ,CAAC,UAAU;QACnB,QAAQ,CAAC,gBAAgB;QACzB,QAAQ,CAAC,kBAAkB;QAC3B,QAAQ,CAAC,cAAc;QACvB,QAAQ,CAAC,qBAAqB;QAC9B,QAAQ,CAAC,mBAAmB;QAC5B,QAAQ,CAAC,eAAe;QACxB,QAAQ,CAAC,eAAe;QACxB,QAAQ,CAAC,gBAAgB;QACzB,QAAQ,CAAC,iBAAiB;QAC1B,QAAQ,CAAC,aAAa;QACtB,QAAQ,CAAC,mBAAmB;QAC5B,QAAQ,CAAC,gBAAgB;QACzB,QAAQ,CAAC,uBAAuB;QAChC,QAAQ,CAAC,sBAAsB;QAC/B,QAAQ,CAAC,mBAAmB;QAC5B,QAAQ,CAAC,4BAA4B;QACrC,QAAQ,CAAC,qBAAqB;QAC9B,QAAQ,CAAC,wBAAwB;QACjC,QAAQ,CAAC,eAAe;KACzB,CAAC,CAAC;IAEH,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,eAAe,CAAC,IAAc;IAC5C,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC;AACrC,CAAC"}
|
package/dist/graph.d.ts
CHANGED
|
@@ -66,6 +66,8 @@ export interface GraphNode {
|
|
|
66
66
|
processIds?: string[];
|
|
67
67
|
/** Kind-specific metadata blob (matches nexus_nodes.meta_json). */
|
|
68
68
|
meta?: Record<string, unknown>;
|
|
69
|
+
/** Whether this node represents an external module (unresolved import). */
|
|
70
|
+
isExternal?: boolean;
|
|
69
71
|
}
|
|
70
72
|
/**
|
|
71
73
|
* A directed relationship between two nodes in the code intelligence graph.
|
package/dist/graph.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAErB,MAAM,GACN,QAAQ,GAER,QAAQ,GACR,WAAW,GAEX,UAAU,GACV,QAAQ,GACR,aAAa,GAEb,OAAO,GACP,WAAW,GACX,QAAQ,GACR,OAAO,GACP,MAAM,GACN,YAAY,GACZ,MAAM,GAEN,UAAU,GACV,UAAU,GACV,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,UAAU,GAEV,OAAO,GACP,OAAO,GACP,SAAS,GACT,YAAY,GACZ,UAAU,GAEV,WAAW,GACX,SAAS,GACT,OAAO,GACP,MAAM,GACN,SAAS,GAET,QAAQ,GACR,QAAQ,GACR,MAAM,CAAC;AAMX;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAEzB,UAAU,GAEV,SAAS,GACT,SAAS,GACT,UAAU,GAEV,OAAO,GAEP,SAAS,GACT,YAAY,GACZ,kBAAkB,GAClB,mBAAmB,GAEnB,YAAY,GACZ,cAAc,GAEd,WAAW,GACX,iBAAiB,GAEjB,eAAe,GACf,SAAS,GAET,cAAc,GACd,gBAAgB,GAEhB,OAAO,GAEP,SAAS,GAET,WAAW,GACX,YAAY,CAAC;AAMjB;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,sEAAsE;IACtE,EAAE,EAAE,MAAM,CAAC;IACX,iDAAiD;IACjD,IAAI,EAAE,aAAa,CAAC;IACpB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,QAAQ,EAAE,OAAO,CAAC;IAClB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,mEAAmE;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;
|
|
1
|
+
{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"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"}
|
package/dist/index.d.ts
CHANGED
|
@@ -17,6 +17,7 @@ export type { AttachmentMetadataSchemaInput, AttachmentRefSchemaInput, Attachmen
|
|
|
17
17
|
export { attachmentMetadataSchema, attachmentRefSchema, attachmentSchema, blobAttachmentSchema, llmsTxtAttachmentSchema, llmtxtDocAttachmentSchema, localFileAttachmentSchema, urlAttachmentSchema, } from './attachment-schema.js';
|
|
18
18
|
export type { BackupDatabaseEntry, BackupGlobalFileEntry, BackupIntegrity, BackupJsonEntry, BackupManifest, BackupMetadata, BackupScope, } from './backup-manifest.js';
|
|
19
19
|
export type { BrainCognitiveType, BrainEntryRef, BrainEntrySummary, BrainMemoryTier, BrainSourceConfidence, ContradictionDetail, SupersededEntry, } from './brain.js';
|
|
20
|
+
export type { BrainConnectionStatus, BrainEdge, BrainGraph, BrainNode, BrainNodeKind, BrainProjectContext, BrainQueryOptions, BrainStreamEvent, BrainSubstrate, } from './brain-graph.js';
|
|
20
21
|
export type { AdapterCapabilities } from './capabilities.js';
|
|
21
22
|
export type { BatchParseResult, CodeSymbol, CodeSymbolKind, ParseResult, } from './code-symbol.js';
|
|
22
23
|
export type { Conduit, ConduitConfig, ConduitMessage, ConduitSendOptions, ConduitSendResult, ConduitState, ConduitStateChange, ConduitUnsubscribe, } from './conduit.js';
|
|
@@ -38,10 +39,17 @@ export type { AdapterInstallProvider, InstallOptions, InstallResult } from './in
|
|
|
38
39
|
export type { CleoResponse, ConformanceReport, FlagInput, GatewayEnvelope, GatewayError, GatewayMeta, GatewaySuccess, LAFSEnvelope, LAFSError, LAFSErrorCategory, LAFSMeta, LAFSPage, LAFSPageNone, LAFSPageOffset, LAFSTransport, LafsAlternative, LafsEnvelope, LafsError, LafsErrorDetail, LafsSuccess, MVILevel, Warning, } from './lafs.js';
|
|
39
40
|
export { isGatewayEnvelope, isLafsError, isLafsSuccess, } from './lafs.js';
|
|
40
41
|
export type { BridgeDecision, BridgeLearning, BridgeObservation, BridgePattern, MemoryBridgeConfig, MemoryBridgeContent, SessionSummary, } from './memory.js';
|
|
42
|
+
export type { Contract, ContractCompatibilityMatrix, ContractExtractionResult, ContractMatch, ContractMatchLevel, ContractTaskLink, GrpcContract, HttpContract, TopicContract, } from './nexus-contract-ops.js';
|
|
43
|
+
export type { BlastRadiusSummary, BrainMemoryRef, BrainRiskNote, CodeAnchorResult, CodeReasonTrace, ConduitThreadRef, DecisionRef, ImpactFullReport, LbTaskRef, NexusContext, NexusEdgeRef, NexusNodeAnchor, PlasticityMeasure, ProposalRef, ReasonTraceStep, RiskTier, SymbolFullContext, SymbolImpactEntry, TaskCodeImpact, TasksForNodeEntry, } from './nexus-living-brain-ops.js';
|
|
44
|
+
export type { NexusCteAlias, NexusCteMarkdownTable, NexusCteParams, NexusCtePlaceholder, NexusCteResult, } from './nexus-query-ops.js';
|
|
45
|
+
export type { RouteMapEntry, RouteMapResult, ShapeCheckCaller, ShapeCheckResult, ShapeCheckStatus, } from './nexus-route-ops.js';
|
|
46
|
+
export type { GitLogLinkerResult, LinkTaskResult, SymbolReference, TaskReference, } from './nexus-tasks-bridge-ops.js';
|
|
47
|
+
export type { CommunityWikiStats, NexusWikiResult, WikiSymbolRow, } from './nexus-wiki-ops.js';
|
|
41
48
|
export * as ops from './operations/index.js';
|
|
42
49
|
export type { BrainState } from './operations/orchestrate.js';
|
|
43
50
|
export type { CittyArgDef, OperationParams, ParamCliDef, ParamDef, ParamType, } from './operations/params.js';
|
|
44
51
|
export { paramsToCittyArgs } from './operations/params.js';
|
|
52
|
+
export type { DecisionRecord, SessionBriefingShowParams, SessionBriefingShowResult, SessionContextDriftParams, SessionContextDriftResult, SessionDecisionLogParams, SessionDecisionLogResult, SessionEndParams, SessionEndResult, SessionFindParams, SessionFindResult, SessionGcParams, SessionGcResult, SessionHandoffShowParams, SessionHandoffShowResult, SessionListParams, SessionListResult, SessionOps, SessionRecordAssumptionParams, SessionRecordAssumptionResult, SessionRecordDecisionParams, SessionRecordDecisionResult, SessionResumeParams, SessionResumeResult, SessionShowParams, SessionShowResult, SessionStartParams, SessionStatusParams, SessionStatusResult, SessionSuspendParams, SessionSuspendResult, } from './operations/session.js';
|
|
45
53
|
export { type AgentHierarchy, type AgentHierarchyEntry, type EscalationChain, type OrchestrationHierarchyAPI, OrchestrationLevel, } from './orchestration-hierarchy.js';
|
|
46
54
|
export type { PlaybookAgenticNode, PlaybookApproval, PlaybookApprovalNode, PlaybookApprovalStatus, PlaybookDefinition, PlaybookDeterministicNode, PlaybookEdge, PlaybookEnsures, PlaybookErrorHandler, PlaybookInput, PlaybookNode, PlaybookNodeBase, PlaybookNodeOnFailure, PlaybookNodeType, PlaybookPolicy, PlaybookRequires, PlaybookRun, PlaybookRunStatus, } from './playbook.js';
|
|
47
55
|
export type { AdapterPathProvider } from './provider-paths.js';
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,YAAY,EACV,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,QAAQ,GACT,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,6BAA6B,CAAC;AAErC,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAE7E,YAAY,EACV,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,YAAY,EACV,eAAe,EACf,kBAAkB,EAClB,2BAA2B,EAC3B,gBAAgB,EAChB,oBAAoB,EACpB,SAAS,EACT,YAAY,EACZ,aAAa,GACd,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,uBAAuB,EACvB,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,UAAU,EACV,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,6BAA6B,EAC7B,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAEhC,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,eAAe,EACf,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,qBAAqB,EACrB,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,2DAA2D;AAC3D,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,6BAA6B,CAAC;AA0DrC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,2DAA2D;AAC3D,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,6BAA6B,CAAC;AA0DrC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,yBAAyB,EACzB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAuGhC,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,aAAa,EACb,WAAW,EACX,cAAc,EACd,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAmBrB,2DAA2D;AAC3D,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,6BAA6B,CAAC;AACrC,qBAAqB;AACrB,OAAO,EACL,QAAQ,EACR,eAAe,EACf,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,aAAa,GACd,MAAM,iBAAiB,CAAC;AAgCzB,gCAAgC;AAChC,OAAO,EACL,uBAAuB,EACvB,WAAW,EACX,uBAAuB,GACxB,MAAM,aAAa,CAAC;AAuCrB,8BAA8B;AAC9B,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,aAAa,GACd,MAAM,WAAW,CAAC;AAwEnB,8FAA8F;AAC9F,OAAO,KAAK,GAAG,MAAM,uBAAuB,CAAC;AAW7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAoC3D,kCAAkC;AAClC,OAAO,EAKL,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AA4DtC,wBAAwB;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAa3C,uEAAuE;AACvE,OAAO,EACL,YAAY,EAIZ,aAAa,EAEb,aAAa,EACb,2BAA2B,EAC3B,wBAAwB,EACxB,iBAAiB;AAEjB,gBAAgB;AAChB,qBAAqB,EAErB,gBAAgB,EAEhB,kBAAkB,EAClB,eAAe,EAEf,yBAAyB,EACzB,2BAA2B;AAC3B,YAAY;AACZ,aAAa,EAGb,0BAA0B,EAC1B,uBAAuB;AACvB,sBAAsB;AACtB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AA8C9B,OAAO,EACL,2BAA2B,EAC3B,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAiD5B,yCAAyC"}
|
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Contract extraction and matching types for NEXUS cross-project compatibility.
|
|
3
|
+
*
|
|
4
|
+
* A contract represents a callable API (HTTP endpoint, gRPC service, pub/sub topic)
|
|
5
|
+
* that can be extracted from source code and matched with contracts from other projects
|
|
6
|
+
* to detect compatibility and integration points.
|
|
7
|
+
*
|
|
8
|
+
* @task T1065 — Contract Registry
|
|
9
|
+
*/
|
|
10
|
+
/**
|
|
11
|
+
* HTTP contract extracted from route analysis.
|
|
12
|
+
*
|
|
13
|
+
* Represents a single HTTP endpoint with its path, method, and request/response schemas.
|
|
14
|
+
*/
|
|
15
|
+
export interface HttpContract {
|
|
16
|
+
/** Unique contract ID (format: `http:<projectId>::<path>::<method>`) */
|
|
17
|
+
id: string;
|
|
18
|
+
/** Project ID this contract belongs to */
|
|
19
|
+
projectId: string;
|
|
20
|
+
/** Contract type — always 'http' */
|
|
21
|
+
type: 'http';
|
|
22
|
+
/** HTTP method (GET, POST, PUT, DELETE, PATCH, etc.) */
|
|
23
|
+
method: string;
|
|
24
|
+
/** Route path (e.g., `/api/v1/tasks`) */
|
|
25
|
+
path: string;
|
|
26
|
+
/** Request body schema as JSON string (or '{}' if no body) */
|
|
27
|
+
requestSchemaJson: string;
|
|
28
|
+
/** Response body schema as JSON string */
|
|
29
|
+
responseSchemaJson: string;
|
|
30
|
+
/** Source symbol ID (format: `<filePath>::<functionName>`) */
|
|
31
|
+
sourceSymbolId: string;
|
|
32
|
+
/** Route node ID from NEXUS graph */
|
|
33
|
+
routeNodeId?: string;
|
|
34
|
+
/** Confidence of extraction [0..1] */
|
|
35
|
+
confidence: number;
|
|
36
|
+
/** Human-readable summary */
|
|
37
|
+
description?: string;
|
|
38
|
+
}
|
|
39
|
+
/**
|
|
40
|
+
* gRPC contract extracted from proto file analysis.
|
|
41
|
+
*
|
|
42
|
+
* Represents a single gRPC service method.
|
|
43
|
+
* Extraction may be minimal/stub on projects without .proto files.
|
|
44
|
+
*/
|
|
45
|
+
export interface GrpcContract {
|
|
46
|
+
/** Unique contract ID (format: `grpc:<projectId>::<serviceName>::<methodName>`) */
|
|
47
|
+
id: string;
|
|
48
|
+
/** Project ID this contract belongs to */
|
|
49
|
+
projectId: string;
|
|
50
|
+
/** Contract type — always 'grpc' */
|
|
51
|
+
type: 'grpc';
|
|
52
|
+
/** Service name (e.g., `TaskService`) */
|
|
53
|
+
serviceName: string;
|
|
54
|
+
/** Method name (e.g., `CreateTask`) */
|
|
55
|
+
methodName: string;
|
|
56
|
+
/** Request message type name */
|
|
57
|
+
requestMessageType: string;
|
|
58
|
+
/** Response message type name */
|
|
59
|
+
responseMessageType: string;
|
|
60
|
+
/** Request message schema as JSON string */
|
|
61
|
+
requestSchemaJson: string;
|
|
62
|
+
/** Response message schema as JSON string */
|
|
63
|
+
responseSchemaJson: string;
|
|
64
|
+
/** Source proto file path */
|
|
65
|
+
sourceProtoFile: string;
|
|
66
|
+
/** Confidence of extraction [0..1] */
|
|
67
|
+
confidence: number;
|
|
68
|
+
/** Human-readable summary */
|
|
69
|
+
description?: string;
|
|
70
|
+
}
|
|
71
|
+
/**
|
|
72
|
+
* Topic/pub-sub contract extracted from message queue code patterns.
|
|
73
|
+
*
|
|
74
|
+
* Represents a single publish or subscribe to a message topic.
|
|
75
|
+
* Extraction may be minimal/stub on projects without pub/sub patterns.
|
|
76
|
+
*/
|
|
77
|
+
export interface TopicContract {
|
|
78
|
+
/** Unique contract ID (format: `topic:<projectId>::<topicName>::<direction>`) */
|
|
79
|
+
id: string;
|
|
80
|
+
/** Project ID this contract belongs to */
|
|
81
|
+
projectId: string;
|
|
82
|
+
/** Contract type — always 'topic' */
|
|
83
|
+
type: 'topic';
|
|
84
|
+
/** Topic name (e.g., `task.created`) */
|
|
85
|
+
topic: string;
|
|
86
|
+
/** Direction: 'publish' or 'subscribe' */
|
|
87
|
+
direction: 'publish' | 'subscribe';
|
|
88
|
+
/** Message payload schema as JSON string */
|
|
89
|
+
payloadSchemaJson: string;
|
|
90
|
+
/** Source symbol ID (format: `<filePath>::<functionName>`) */
|
|
91
|
+
sourceSymbolId: string;
|
|
92
|
+
/** Confidence of extraction [0..1] */
|
|
93
|
+
confidence: number;
|
|
94
|
+
/** Human-readable summary */
|
|
95
|
+
description?: string;
|
|
96
|
+
}
|
|
97
|
+
/** Union type of all contract kinds */
|
|
98
|
+
export type Contract = HttpContract | GrpcContract | TopicContract;
|
|
99
|
+
/**
|
|
100
|
+
* Matching level for contract compatibility.
|
|
101
|
+
*
|
|
102
|
+
* - 'exact': path + method match exactly (HTTP) or full signature match (gRPC)
|
|
103
|
+
* - 'name': service/method names match but signatures may differ
|
|
104
|
+
* - 'fuzzy': BM25 similarity above threshold on path/schema content
|
|
105
|
+
*/
|
|
106
|
+
export type ContractMatchLevel = 'exact' | 'name' | 'fuzzy';
|
|
107
|
+
/**
|
|
108
|
+
* Result of matching two contracts.
|
|
109
|
+
*
|
|
110
|
+
* Indicates compatibility between a contract in project A and project B.
|
|
111
|
+
*/
|
|
112
|
+
export interface ContractMatch {
|
|
113
|
+
/** Matched contract from project A */
|
|
114
|
+
contractA: Contract;
|
|
115
|
+
/** Matched contract from project B */
|
|
116
|
+
contractB: Contract;
|
|
117
|
+
/** Matching level (exact → name → fuzzy cascade) */
|
|
118
|
+
level: ContractMatchLevel;
|
|
119
|
+
/** Similarity score [0..1] where 1.0 is identical */
|
|
120
|
+
score: number;
|
|
121
|
+
/** Human-readable explanation of the match */
|
|
122
|
+
reason: string;
|
|
123
|
+
/** Compatibility verdict: 'compatible', 'incompatible', 'partial' */
|
|
124
|
+
compatibility: 'compatible' | 'incompatible' | 'partial';
|
|
125
|
+
/** Specific incompatibilities if any (e.g., schema mismatches) */
|
|
126
|
+
incompatibilities?: string[];
|
|
127
|
+
}
|
|
128
|
+
/**
|
|
129
|
+
* Contract compatibility matrix between two projects.
|
|
130
|
+
*
|
|
131
|
+
* Result of `cleo nexus contracts show --project-a <p> --project-b <p>`.
|
|
132
|
+
*/
|
|
133
|
+
export interface ContractCompatibilityMatrix {
|
|
134
|
+
/** Project A ID */
|
|
135
|
+
projectAId: string;
|
|
136
|
+
/** Project B ID */
|
|
137
|
+
projectBId: string;
|
|
138
|
+
/** All matched contracts */
|
|
139
|
+
matches: ContractMatch[];
|
|
140
|
+
/** Count of compatible matches */
|
|
141
|
+
compatibleCount: number;
|
|
142
|
+
/** Count of incompatible matches */
|
|
143
|
+
incompatibleCount: number;
|
|
144
|
+
/** Count of partial/unresolved matches */
|
|
145
|
+
partialCount: number;
|
|
146
|
+
/** Overall compatibility percentage */
|
|
147
|
+
overallCompatibility: number;
|
|
148
|
+
/** Recommendations for integration */
|
|
149
|
+
recommendations: string[];
|
|
150
|
+
}
|
|
151
|
+
/**
|
|
152
|
+
* Result of extracting contracts from a project.
|
|
153
|
+
*
|
|
154
|
+
* Returned by contract extractors.
|
|
155
|
+
*/
|
|
156
|
+
export interface ContractExtractionResult {
|
|
157
|
+
/** Project ID */
|
|
158
|
+
projectId: string;
|
|
159
|
+
/** HTTP contracts found */
|
|
160
|
+
httpContracts: HttpContract[];
|
|
161
|
+
/** gRPC contracts found */
|
|
162
|
+
grpcContracts: GrpcContract[];
|
|
163
|
+
/** Topic/pub-sub contracts found */
|
|
164
|
+
topicContracts: TopicContract[];
|
|
165
|
+
/** Total contracts extracted */
|
|
166
|
+
totalCount: number;
|
|
167
|
+
/** Any extraction warnings or notes */
|
|
168
|
+
notes: string[];
|
|
169
|
+
}
|
|
170
|
+
/**
|
|
171
|
+
* Result of linking contracts to affected tasks.
|
|
172
|
+
*
|
|
173
|
+
* When a contract's source symbol is touched by a task (via task_touches_symbol edge),
|
|
174
|
+
* we emit a contract_affected_by_task annotation.
|
|
175
|
+
*/
|
|
176
|
+
export interface ContractTaskLink {
|
|
177
|
+
/** Contract ID */
|
|
178
|
+
contractId: string;
|
|
179
|
+
/** Task ID that affects this contract */
|
|
180
|
+
taskId: string;
|
|
181
|
+
/** Type of change (modified, added, removed) */
|
|
182
|
+
changeType: 'modified' | 'added' | 'removed';
|
|
183
|
+
/** Timestamp of the linkage */
|
|
184
|
+
linkedAt: string;
|
|
185
|
+
}
|
|
186
|
+
//# sourceMappingURL=nexus-contract-ops.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"nexus-contract-ops.d.ts","sourceRoot":"","sources":["../src/nexus-contract-ops.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Contract extraction and matching types for NEXUS cross-project compatibility.
|
|
3
|
+
*
|
|
4
|
+
* A contract represents a callable API (HTTP endpoint, gRPC service, pub/sub topic)
|
|
5
|
+
* that can be extracted from source code and matched with contracts from other projects
|
|
6
|
+
* to detect compatibility and integration points.
|
|
7
|
+
*
|
|
8
|
+
* @task T1065 — Contract Registry
|
|
9
|
+
*/
|
|
10
|
+
export {};
|
|
11
|
+
//# sourceMappingURL=nexus-contract-ops.js.map
|