ds4-context-core 0.1.1 → 0.2.0-beta.1

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 (121) hide show
  1. package/README.md +17 -4
  2. package/dist/adapter/conformance.d.ts +35 -0
  3. package/dist/adapter/conformance.d.ts.map +1 -0
  4. package/dist/adapter/conformance.js +260 -0
  5. package/dist/adapter/conformance.js.map +1 -0
  6. package/dist/adapter/runtime-adapter.d.ts +119 -0
  7. package/dist/adapter/runtime-adapter.d.ts.map +1 -0
  8. package/dist/adapter/runtime-adapter.js +289 -0
  9. package/dist/adapter/runtime-adapter.js.map +1 -0
  10. package/dist/config/config-loader.d.ts +1 -0
  11. package/dist/config/config-loader.d.ts.map +1 -1
  12. package/dist/config/config-loader.js +107 -1
  13. package/dist/config/config-loader.js.map +1 -1
  14. package/dist/config/config.d.ts +45 -0
  15. package/dist/config/config.d.ts.map +1 -1
  16. package/dist/config/config.js +28 -0
  17. package/dist/config/config.js.map +1 -1
  18. package/dist/core/canonical-message.d.ts +2 -1
  19. package/dist/core/canonical-message.d.ts.map +1 -1
  20. package/dist/index.d.ts +12 -0
  21. package/dist/index.d.ts.map +1 -1
  22. package/dist/index.js +12 -0
  23. package/dist/index.js.map +1 -1
  24. package/dist/manifest/context-manifest.d.ts +12 -0
  25. package/dist/manifest/context-manifest.d.ts.map +1 -1
  26. package/dist/memory/memory-manager.d.ts +7 -1
  27. package/dist/memory/memory-manager.d.ts.map +1 -1
  28. package/dist/memory/memory-manager.js +100 -3
  29. package/dist/memory/memory-manager.js.map +1 -1
  30. package/dist/memory/memory-types.d.ts +43 -0
  31. package/dist/memory/memory-types.d.ts.map +1 -1
  32. package/dist/memory/memory-types.js.map +1 -1
  33. package/dist/persistence/migrations.d.ts +2 -1
  34. package/dist/persistence/migrations.d.ts.map +1 -1
  35. package/dist/persistence/migrations.js +155 -25
  36. package/dist/persistence/migrations.js.map +1 -1
  37. package/dist/persistence/repositories/artifact-repository.d.ts +3 -1
  38. package/dist/persistence/repositories/artifact-repository.d.ts.map +1 -1
  39. package/dist/persistence/repositories/artifact-repository.js +16 -27
  40. package/dist/persistence/repositories/artifact-repository.js.map +1 -1
  41. package/dist/persistence/repositories/context-manifest-repository.d.ts +3 -1
  42. package/dist/persistence/repositories/context-manifest-repository.d.ts.map +1 -1
  43. package/dist/persistence/repositories/context-manifest-repository.js +10 -18
  44. package/dist/persistence/repositories/context-manifest-repository.js.map +1 -1
  45. package/dist/persistence/repositories/context-quality-repository.d.ts +21 -0
  46. package/dist/persistence/repositories/context-quality-repository.d.ts.map +1 -0
  47. package/dist/persistence/repositories/context-quality-repository.js +83 -0
  48. package/dist/persistence/repositories/context-quality-repository.js.map +1 -0
  49. package/dist/persistence/repositories/embedding-repository.d.ts +37 -0
  50. package/dist/persistence/repositories/embedding-repository.d.ts.map +1 -0
  51. package/dist/persistence/repositories/embedding-repository.js +142 -0
  52. package/dist/persistence/repositories/embedding-repository.js.map +1 -0
  53. package/dist/persistence/repositories/lease-repository.d.ts +22 -0
  54. package/dist/persistence/repositories/lease-repository.d.ts.map +1 -0
  55. package/dist/persistence/repositories/lease-repository.js +113 -0
  56. package/dist/persistence/repositories/lease-repository.js.map +1 -0
  57. package/dist/persistence/repositories/memory-repository.d.ts +34 -3
  58. package/dist/persistence/repositories/memory-repository.d.ts.map +1 -1
  59. package/dist/persistence/repositories/memory-repository.js +426 -64
  60. package/dist/persistence/repositories/memory-repository.js.map +1 -1
  61. package/dist/persistence/repositories/project-knowledge-repository.d.ts +28 -5
  62. package/dist/persistence/repositories/project-knowledge-repository.d.ts.map +1 -1
  63. package/dist/persistence/repositories/project-knowledge-repository.js +123 -53
  64. package/dist/persistence/repositories/project-knowledge-repository.js.map +1 -1
  65. package/dist/persistence/repositories/session-index-repository.d.ts +9 -1
  66. package/dist/persistence/repositories/session-index-repository.d.ts.map +1 -1
  67. package/dist/persistence/repositories/session-index-repository.js +38 -17
  68. package/dist/persistence/repositories/session-index-repository.js.map +1 -1
  69. package/dist/persistence/repositories/summary-repository.d.ts +3 -1
  70. package/dist/persistence/repositories/summary-repository.d.ts.map +1 -1
  71. package/dist/persistence/repositories/summary-repository.js +35 -31
  72. package/dist/persistence/repositories/summary-repository.js.map +1 -1
  73. package/dist/persistence/sqlite.d.ts +10 -0
  74. package/dist/persistence/sqlite.d.ts.map +1 -1
  75. package/dist/persistence/sqlite.js +41 -12
  76. package/dist/persistence/sqlite.js.map +1 -1
  77. package/dist/persistence/write-coordinator.d.ts +37 -0
  78. package/dist/persistence/write-coordinator.d.ts.map +1 -0
  79. package/dist/persistence/write-coordinator.js +120 -0
  80. package/dist/persistence/write-coordinator.js.map +1 -0
  81. package/dist/planner/context-planner.d.ts +5 -0
  82. package/dist/planner/context-planner.d.ts.map +1 -1
  83. package/dist/planner/context-planner.js +41 -62
  84. package/dist/planner/context-planner.js.map +1 -1
  85. package/dist/project/file-indexer.d.ts +5 -3
  86. package/dist/project/file-indexer.d.ts.map +1 -1
  87. package/dist/project/file-indexer.js +108 -42
  88. package/dist/project/file-indexer.js.map +1 -1
  89. package/dist/project/project-knowledge.d.ts +15 -3
  90. package/dist/project/project-knowledge.d.ts.map +1 -1
  91. package/dist/project/project-knowledge.js +168 -42
  92. package/dist/project/project-knowledge.js.map +1 -1
  93. package/dist/project/symbol-parser.d.ts +48 -0
  94. package/dist/project/symbol-parser.d.ts.map +1 -0
  95. package/dist/project/symbol-parser.js +427 -0
  96. package/dist/project/symbol-parser.js.map +1 -0
  97. package/dist/quality/context-quality.d.ts +172 -0
  98. package/dist/quality/context-quality.d.ts.map +1 -0
  99. package/dist/quality/context-quality.js +624 -0
  100. package/dist/quality/context-quality.js.map +1 -0
  101. package/dist/ranking/learned-ranker.d.ts +174 -0
  102. package/dist/ranking/learned-ranker.d.ts.map +1 -0
  103. package/dist/ranking/learned-ranker.js +782 -0
  104. package/dist/ranking/learned-ranker.js.map +1 -0
  105. package/dist/retrieval/embedding.d.ts +92 -0
  106. package/dist/retrieval/embedding.d.ts.map +1 -0
  107. package/dist/retrieval/embedding.js +56 -0
  108. package/dist/retrieval/embedding.js.map +1 -0
  109. package/dist/retrieval/retrieval-engine.d.ts +9 -1
  110. package/dist/retrieval/retrieval-engine.d.ts.map +1 -1
  111. package/dist/retrieval/retrieval-engine.js +105 -7
  112. package/dist/retrieval/retrieval-engine.js.map +1 -1
  113. package/dist/retrieval/semantic-index.d.ts +30 -0
  114. package/dist/retrieval/semantic-index.d.ts.map +1 -0
  115. package/dist/retrieval/semantic-index.js +284 -0
  116. package/dist/retrieval/semantic-index.js.map +1 -0
  117. package/dist/retrieval/semantic-quality.d.ts +52 -0
  118. package/dist/retrieval/semantic-quality.d.ts.map +1 -0
  119. package/dist/retrieval/semantic-quality.js +117 -0
  120. package/dist/retrieval/semantic-quality.js.map +1 -0
  121. package/package.json +1 -1
@@ -0,0 +1,427 @@
1
+ import { sha256 } from "../shared/hash.js";
2
+ export const REGEX_SYMBOL_PARSER_VERSION = "regex-structural-v1";
3
+ const SUPPORTED_LANGUAGES = ["typescript", "javascript", "python", "go"];
4
+ const IDENTIFIER = /^[A-Za-z_$][\w$]*$/u;
5
+ const REFERENCE_STOP_WORDS = new Set([
6
+ "as", "async", "await", "break", "case", "catch", "class", "const", "continue",
7
+ "def", "defer", "delete", "do", "else", "enum", "export", "extends", "false",
8
+ "finally", "fn", "for", "from", "func", "function", "go", "if", "implements",
9
+ "import", "in", "interface", "let", "map", "namespace", "new", "nil", "none",
10
+ "package", "pass", "private", "protected", "public", "range", "return", "select",
11
+ "static", "struct", "switch", "this", "throw", "true", "try", "type", "undefined",
12
+ "var", "while", "with", "yield",
13
+ ]);
14
+ const CONTROL_METHOD_NAMES = new Set(["catch", "for", "if", "switch", "while", "with"]);
15
+ function unique(values, limit) {
16
+ const result = [];
17
+ const seen = new Set();
18
+ for (const raw of values) {
19
+ const value = raw.trim();
20
+ const key = value.toLowerCase();
21
+ if (!value || seen.has(key))
22
+ continue;
23
+ seen.add(key);
24
+ result.push(value);
25
+ if (result.length >= limit)
26
+ break;
27
+ }
28
+ return result;
29
+ }
30
+ function uniqueCaseSensitive(values, limit) {
31
+ const result = [];
32
+ const seen = new Set();
33
+ for (const raw of values) {
34
+ const value = raw.trim();
35
+ if (!value || seen.has(value))
36
+ continue;
37
+ seen.add(value);
38
+ result.push(value);
39
+ if (result.length >= limit)
40
+ break;
41
+ }
42
+ return result;
43
+ }
44
+ function lexicalLines(content, language) {
45
+ const lines = content.split(/\r?\n/u);
46
+ const output = [];
47
+ let quote;
48
+ let triple;
49
+ let blockComment = false;
50
+ let escaped = false;
51
+ const stack = [];
52
+ const closing = { ")": "(", "]": "[", "}": "{" };
53
+ for (const line of lines) {
54
+ let clean = "";
55
+ for (let index = 0; index < line.length; index++) {
56
+ const char = line[index] ?? "";
57
+ const next = line[index + 1] ?? "";
58
+ const three = line.slice(index, index + 3);
59
+ if (triple) {
60
+ if (three === triple) {
61
+ index += 2;
62
+ triple = undefined;
63
+ }
64
+ clean += " ";
65
+ continue;
66
+ }
67
+ if (blockComment) {
68
+ if (char === "*" && next === "/") {
69
+ index++;
70
+ blockComment = false;
71
+ }
72
+ clean += " ";
73
+ continue;
74
+ }
75
+ if (quote) {
76
+ if (escaped)
77
+ escaped = false;
78
+ else if (char === "\\")
79
+ escaped = true;
80
+ else if (char === quote)
81
+ quote = undefined;
82
+ clean += " ";
83
+ continue;
84
+ }
85
+ if (language === "python" && (three === "'''" || three === '\"\"\"')) {
86
+ triple = three;
87
+ index += 2;
88
+ clean += " ";
89
+ continue;
90
+ }
91
+ if (char === "/" && next === "*") {
92
+ index++;
93
+ blockComment = true;
94
+ clean += " ";
95
+ continue;
96
+ }
97
+ if ((char === "/" && next === "/") || (language === "python" && char === "#"))
98
+ break;
99
+ if (char === "'" || char === '"' || (char === "`" && language !== "python")) {
100
+ quote = char;
101
+ clean += " ";
102
+ continue;
103
+ }
104
+ clean += char;
105
+ if (char === "(" || char === "[" || char === "{")
106
+ stack.push(char);
107
+ else if (char in closing) {
108
+ if (stack.pop() !== closing[char])
109
+ return undefined;
110
+ }
111
+ }
112
+ output.push(clean);
113
+ if (quote && quote !== "`")
114
+ quote = undefined;
115
+ }
116
+ if (blockComment || triple || quote || stack.length > 0)
117
+ return undefined;
118
+ return output;
119
+ }
120
+ function braceEnd(lines, startIndex) {
121
+ let depth = 0;
122
+ let opened = false;
123
+ for (let index = startIndex; index < lines.length; index++) {
124
+ for (const char of lines[index] ?? "") {
125
+ if (char === "{") {
126
+ depth++;
127
+ opened = true;
128
+ }
129
+ else if (char === "}" && opened) {
130
+ depth--;
131
+ if (depth === 0)
132
+ return index + 1;
133
+ }
134
+ }
135
+ if (!opened && /;\s*$/u.test(lines[index] ?? ""))
136
+ return index + 1;
137
+ }
138
+ return startIndex + 1;
139
+ }
140
+ function signatureAt(lines, startIndex, language) {
141
+ const parts = [];
142
+ for (let index = startIndex; index < Math.min(lines.length, startIndex + 12); index++) {
143
+ const part = (lines[index] ?? "").trim();
144
+ if (part)
145
+ parts.push(part);
146
+ const joined = parts.join(" ");
147
+ if (language === "python" ? /:\s*$/u.test(joined) : /(?:\{|;|=>)\s*$/u.test(joined))
148
+ break;
149
+ }
150
+ return parts.join(" ").replace(/\s+/gu, " ").slice(0, 500);
151
+ }
152
+ function pythonEnd(lines, startIndex) {
153
+ const declaration = lines[startIndex] ?? "";
154
+ const indent = declaration.match(/^\s*/u)?.[0].length ?? 0;
155
+ let end = startIndex + 1;
156
+ for (let index = startIndex + 1; index < lines.length; index++) {
157
+ const line = lines[index] ?? "";
158
+ if (!line.trim())
159
+ continue;
160
+ const nextIndent = line.match(/^\s*/u)?.[0].length ?? 0;
161
+ if (nextIndent <= indent)
162
+ break;
163
+ end = index + 1;
164
+ }
165
+ return end;
166
+ }
167
+ function importsFor(lines, language) {
168
+ const imports = [];
169
+ let goImportBlock = false;
170
+ for (const line of lines) {
171
+ let match = null;
172
+ if (language === "typescript" || language === "javascript") {
173
+ match = line.match(/^\s*import(?:[\s\S]*?\sfrom\s*)?["']([^"']+)["']/u)
174
+ ?? line.match(/\brequire\(\s*["']([^"']+)["']\s*\)/u);
175
+ }
176
+ else if (language === "python") {
177
+ match = line.match(/^\s*(?:from\s+([A-Za-z_][\w.]*)\s+import|import\s+([A-Za-z_][\w.]*))/u);
178
+ if (match?.[2] && !match[1])
179
+ match[1] = match[2];
180
+ }
181
+ else if (language === "go") {
182
+ if (/^\s*import\s*\(\s*$/u.test(line)) {
183
+ goImportBlock = true;
184
+ continue;
185
+ }
186
+ if (goImportBlock && /^\s*\)\s*$/u.test(line)) {
187
+ goImportBlock = false;
188
+ continue;
189
+ }
190
+ match = goImportBlock
191
+ ? line.match(/^\s*(?:[A-Za-z_.]+\s+)?"([^"]+)"/u)
192
+ : line.match(/^\s*import\s+(?:[A-Za-z_.]+\s+)?"([^"]+)"/u);
193
+ }
194
+ if (match?.[1])
195
+ imports.push(match[1]);
196
+ }
197
+ return unique(imports, 64);
198
+ }
199
+ function referencesFor(lines, symbol, imports) {
200
+ const text = lines.slice(symbol.startLine - 1, symbol.endLine).join("\n");
201
+ const values = [];
202
+ for (const match of text.matchAll(/\b([A-Za-z_$][\w$]*)\b/gu)) {
203
+ const value = match[1];
204
+ if (!value || value === symbol.name || REFERENCE_STOP_WORDS.has(value.toLowerCase()))
205
+ continue;
206
+ if (IDENTIFIER.test(value))
207
+ values.push(value);
208
+ }
209
+ return uniqueCaseSensitive([...imports, ...values], 64);
210
+ }
211
+ function assignParents(symbols) {
212
+ const ordered = [...symbols].sort((left, right) => left.startLine - right.startLine || right.endLine - left.endLine);
213
+ for (const symbol of ordered) {
214
+ if (symbol.parentSymbol)
215
+ continue;
216
+ const parents = ordered.filter((candidate) => candidate !== symbol
217
+ && candidate.startLine <= symbol.startLine
218
+ && candidate.endLine >= symbol.endLine
219
+ && (candidate.startLine < symbol.startLine || candidate.endLine > symbol.endLine));
220
+ parents.sort((left, right) => (left.endLine - left.startLine) - (right.endLine - right.startLine)
221
+ || right.startLine - left.startLine);
222
+ if (parents[0])
223
+ symbol.parentSymbol = parents[0].name;
224
+ }
225
+ }
226
+ function parseTypeScript(lines, clean, language) {
227
+ const symbols = [];
228
+ const declaration = /^\s*(?:(?:export|declare|default|abstract)\s+)*(class|interface|enum|namespace|type)\s+([A-Za-z_$][\w$]*)/u;
229
+ const fn = /^\s*(?:(?:export|declare|default)\s+)*(?:async\s+)?function\s*\*?\s*([A-Za-z_$][\w$]*)/u;
230
+ const variable = /^\s*(?:(?:export|declare|default)\s+)*(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*(?::[^=]+)?=/u;
231
+ for (let index = 0; index < clean.length; index++) {
232
+ const line = clean[index] ?? "";
233
+ const declared = line.match(declaration);
234
+ const functionMatch = line.match(fn);
235
+ const variableMatch = line.match(variable);
236
+ const match = declared ?? functionMatch ?? variableMatch;
237
+ if (!match)
238
+ continue;
239
+ const rawKind = declared?.[1];
240
+ const kind = rawKind === "class" || rawKind === "interface" || rawKind === "enum"
241
+ || rawKind === "namespace" || rawKind === "type" ? rawKind : variableMatch ? "variable" : "function";
242
+ const name = (declared?.[2] ?? functionMatch?.[1] ?? variableMatch?.[1]);
243
+ symbols.push({
244
+ name,
245
+ kind,
246
+ signature: signatureAt(lines, index, language),
247
+ startLine: index + 1,
248
+ endLine: braceEnd(clean, index),
249
+ });
250
+ }
251
+ assignParents(symbols);
252
+ const containers = symbols.filter((symbol) => symbol.kind === "class" || symbol.kind === "interface");
253
+ const methodPattern = /^\s*(?:(?:public|private|protected|static|readonly|abstract|override|async|get|set)\s+)*(constructor|[A-Za-z_$][\w$]*)\s*(?:<[^>{}]*>)?\s*\([^;{}]*\)\s*(?::[^;{]+)?\s*(?:[{]|;)/u;
254
+ for (const parent of containers) {
255
+ const declarationLine = clean[parent.startLine - 1] ?? "";
256
+ let depth = [...declarationLine].reduce((value, char) => value + (char === "{" ? 1 : char === "}" ? -1 : 0), 0);
257
+ for (let index = parent.startLine; index < parent.endLine - 1; index++) {
258
+ const line = clean[index] ?? "";
259
+ if (depth === 1) {
260
+ const match = line.match(methodPattern);
261
+ const name = match?.[1];
262
+ if (name && !CONTROL_METHOD_NAMES.has(name) && !symbols.some((item) => item.startLine === index + 1)) {
263
+ symbols.push({
264
+ name,
265
+ kind: "method",
266
+ signature: signatureAt(lines, index, language),
267
+ parentSymbol: parent.name,
268
+ startLine: index + 1,
269
+ endLine: Math.min(parent.endLine, braceEnd(clean, index)),
270
+ });
271
+ }
272
+ }
273
+ for (const char of line)
274
+ depth += char === "{" ? 1 : char === "}" ? -1 : 0;
275
+ }
276
+ }
277
+ return symbols;
278
+ }
279
+ function parsePython(lines, clean) {
280
+ const symbols = [];
281
+ const pattern = /^(\s*)(?:(?:async)\s+)?(class|def)\s+([A-Za-z_][\w]*)/u;
282
+ const stack = [];
283
+ for (let index = 0; index < clean.length; index++) {
284
+ const match = (clean[index] ?? "").match(pattern);
285
+ if (!match)
286
+ continue;
287
+ const indent = match[1]?.length ?? 0;
288
+ while (stack.length > 0 && (stack.at(-1)?.indent ?? -1) >= indent)
289
+ stack.pop();
290
+ const parent = stack.at(-1)?.symbol;
291
+ const name = match[3];
292
+ const kind = match[2] === "class" ? "class" : parent ? "method" : "function";
293
+ const symbol = {
294
+ name,
295
+ kind,
296
+ signature: signatureAt(lines, index, "python"),
297
+ ...(parent ? { parentSymbol: parent.name } : {}),
298
+ startLine: index + 1,
299
+ endLine: pythonEnd(clean, index),
300
+ };
301
+ symbols.push(symbol);
302
+ stack.push({ indent, symbol });
303
+ }
304
+ return symbols;
305
+ }
306
+ function parseGo(lines, clean) {
307
+ const symbols = [];
308
+ const typePattern = /^\s*type\s+([A-Za-z_][\w]*)\s+(struct|interface)\b/u;
309
+ const functionPattern = /^\s*func\s+(?:\(\s*\w+\s+\*?([A-Za-z_][\w]*)\s*\)\s*)?([A-Za-z_][\w]*)\s*\(/u;
310
+ for (let index = 0; index < clean.length; index++) {
311
+ const typeMatch = (clean[index] ?? "").match(typePattern);
312
+ const functionMatch = (clean[index] ?? "").match(functionPattern);
313
+ if (!typeMatch && !functionMatch)
314
+ continue;
315
+ const parentSymbol = functionMatch?.[1];
316
+ const name = (typeMatch?.[1] ?? functionMatch?.[2]);
317
+ symbols.push({
318
+ name,
319
+ kind: typeMatch ? (typeMatch[2] === "struct" ? "struct" : "interface") : parentSymbol ? "method" : "function",
320
+ signature: signatureAt(lines, index, "go"),
321
+ ...(parentSymbol ? { parentSymbol } : {}),
322
+ startLine: index + 1,
323
+ endLine: braceEnd(clean, index),
324
+ });
325
+ }
326
+ return symbols;
327
+ }
328
+ function qualifiedName(symbol, all) {
329
+ const parent = symbol.parentSymbol;
330
+ if (!parent)
331
+ return symbol.name;
332
+ const parentSymbol = all.find((candidate) => candidate.name === parent && candidate !== symbol);
333
+ return `${parentSymbol ? qualifiedName(parentSymbol, all) : parent}.${symbol.name}`;
334
+ }
335
+ export class DeterministicRegexSymbolParser {
336
+ id = REGEX_SYMBOL_PARSER_VERSION;
337
+ languages = SUPPORTED_LANGUAGES;
338
+ parse(input) {
339
+ const language = input.language?.toLowerCase();
340
+ if (!language || !this.languages.includes(language))
341
+ return undefined;
342
+ const lines = input.content.split(/\r?\n/u);
343
+ const clean = lexicalLines(input.content, language);
344
+ if (!clean)
345
+ return undefined;
346
+ const imports = importsFor(lines, language);
347
+ const mutable = language === "python"
348
+ ? parsePython(lines, clean)
349
+ : language === "go"
350
+ ? parseGo(lines, clean)
351
+ : parseTypeScript(lines, clean, language);
352
+ const symbols = mutable.slice(0, 200).map((symbol) => ({
353
+ name: symbol.name,
354
+ qualifiedName: qualifiedName(symbol, mutable),
355
+ kind: symbol.kind,
356
+ signature: symbol.signature,
357
+ ...(symbol.parentSymbol ? { parentSymbol: symbol.parentSymbol } : {}),
358
+ startLine: symbol.startLine,
359
+ endLine: symbol.endLine,
360
+ imports: [...imports],
361
+ references: referencesFor(lines, symbol, imports),
362
+ }));
363
+ return { parserId: this.id, language, imports, symbols };
364
+ }
365
+ }
366
+ export class SymbolParserChain {
367
+ parsers;
368
+ id;
369
+ languages;
370
+ constructor(parsers) {
371
+ this.parsers = parsers;
372
+ if (parsers.length === 0)
373
+ throw new Error("SymbolParserChain requires at least one parser");
374
+ this.id = parsers.map((parser) => parser.id).join("+");
375
+ this.languages = unique(parsers.flatMap((parser) => parser.languages), 64);
376
+ }
377
+ parse(input) {
378
+ for (const parser of this.parsers) {
379
+ try {
380
+ const parsed = parser.parse(input);
381
+ if (parsed)
382
+ return parsed;
383
+ }
384
+ catch {
385
+ // Parser adapters are optional derived-index helpers. Continue to the deterministic fallback.
386
+ }
387
+ }
388
+ return undefined;
389
+ }
390
+ }
391
+ export const DEFAULT_SYMBOL_PARSER = new DeterministicRegexSymbolParser();
392
+ export function withRegexSymbolFallback(primary) {
393
+ return primary
394
+ ? new SymbolParserChain([primary, DEFAULT_SYMBOL_PARSER])
395
+ : DEFAULT_SYMBOL_PARSER;
396
+ }
397
+ export function stableSymbolId(input, symbol) {
398
+ return sha256([
399
+ input.projectPath,
400
+ input.filePath,
401
+ input.fileHash,
402
+ symbol.startLine,
403
+ symbol.endLine,
404
+ symbol.kind,
405
+ symbol.qualifiedName,
406
+ ].join("\0"));
407
+ }
408
+ export function extractLegacySymbols(content) {
409
+ const symbols = new Set();
410
+ const patterns = [
411
+ /\b(?:class|interface|enum|namespace|record|struct|trait|type)\s+([A-Za-z_$][\w$]*)/gu,
412
+ /\b(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/gu,
413
+ /^\s*(?:export\s+)?(?:const|let|var)\s+([A-Za-z_$][\w$]*)\s*[=:]/gmu,
414
+ /^\s*(?:def|fn|func)\s+([A-Za-z_$][\w$]*)/gmu,
415
+ ];
416
+ for (const pattern of patterns) {
417
+ pattern.lastIndex = 0;
418
+ for (const match of content.matchAll(pattern)) {
419
+ if (match[1])
420
+ symbols.add(match[1]);
421
+ if (symbols.size >= 128)
422
+ return [...symbols];
423
+ }
424
+ }
425
+ return [...symbols];
426
+ }
427
+ //# sourceMappingURL=symbol-parser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"symbol-parser.js","sourceRoot":"","sources":["../../src/project/symbol-parser.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,172 @@
1
+ import type { ContextManifest, ContextManifestItemKind } from "../manifest/context-manifest.ts";
2
+ export declare const CONTEXT_QUALITY_SCHEMA_VERSION: 1;
3
+ export declare const CONTEXT_QUALITY_METRICS_VERSION = "context-quality-v1";
4
+ export declare const LIVE_QUALITY_CORPUS_VERSION = "live-observation-v1";
5
+ export declare const STATIC_RANKING_STRATEGY_ID = "static-ranking-v0.1";
6
+ export declare const CANDIDATE_RANKING_STRATEGY_ID = "task-weighted-v0.2-candidate";
7
+ export interface QualityTaskDescriptor {
8
+ taskId: string;
9
+ taskType: string;
10
+ queryTags: string[];
11
+ }
12
+ export interface QualityReplayCandidate {
13
+ id: string;
14
+ kind: ContextManifestItemKind;
15
+ tokens: number;
16
+ groupId: string;
17
+ sourceIds: string[];
18
+ staticScore: number;
19
+ candidateScore?: number;
20
+ currentRequest?: boolean;
21
+ provenanceRequired?: boolean;
22
+ }
23
+ export interface QualityReplayFixture {
24
+ schemaVersion: 1;
25
+ corpusVersion: string;
26
+ sampleId: string;
27
+ plannerVersion: string;
28
+ profileKey: string;
29
+ task: QualityTaskDescriptor;
30
+ expectedEvidenceSourceIds: string[];
31
+ candidates: QualityReplayCandidate[];
32
+ totalBudgetTokens: number;
33
+ categoryBudgets: Partial<Record<ContextManifestItemKind, number>>;
34
+ outcomeLabels?: string[];
35
+ }
36
+ export interface QualityReplayCorpus {
37
+ schemaVersion: 1;
38
+ corpusVersion: string;
39
+ description: string;
40
+ fixtures: QualityReplayFixture[];
41
+ }
42
+ export interface QualityPlanDecision {
43
+ selectedCandidateIds: string[];
44
+ selectionReasons: Record<string, string>;
45
+ dropReasons: Record<string, string>;
46
+ fallback: boolean;
47
+ overflow: boolean;
48
+ }
49
+ export interface QualityStrategy {
50
+ id: string;
51
+ plan(fixture: QualityReplayFixture): QualityPlanDecision;
52
+ }
53
+ export interface QualityCountRate {
54
+ numerator: number;
55
+ denominator: number;
56
+ rate: number | null;
57
+ }
58
+ export interface QualityBudgetUtilization {
59
+ limitTokens: number;
60
+ selectedTokens: number;
61
+ droppedTokens: number;
62
+ utilization: number;
63
+ }
64
+ export interface QualitySourceKindCount {
65
+ available: number;
66
+ selected: number;
67
+ dropped: number;
68
+ }
69
+ export interface ContextQualityMetrics {
70
+ evidenceRecall: QualityCountRate;
71
+ irrelevantTokenRatio: QualityCountRate;
72
+ duplicateEvidence: {
73
+ duplicateReferences: number;
74
+ selectedReferences: number;
75
+ };
76
+ provenanceCoverage: QualityCountRate;
77
+ currentRequestRetention: QualityCountRate;
78
+ atomicGroupValidity: QualityCountRate;
79
+ overflow: boolean;
80
+ fallback: boolean;
81
+ qualityScore: number;
82
+ selectedTokens: number;
83
+ droppedTokens: number;
84
+ sourceKindCounts: Partial<Record<ContextManifestItemKind, QualitySourceKindCount>>;
85
+ budgetUtilization: Partial<Record<ContextManifestItemKind, QualityBudgetUtilization>>;
86
+ selectionReasons: Record<string, number>;
87
+ dropReasons: Record<string, number>;
88
+ }
89
+ export interface ContextQualitySample {
90
+ schemaVersion: 1;
91
+ metricsVersion: string;
92
+ sampleId: string;
93
+ corpusVersion: string;
94
+ strategyId: string;
95
+ plannerVersion: string;
96
+ profileKey: string;
97
+ outcomeLabels: string[];
98
+ metrics: ContextQualityMetrics;
99
+ timing?: {
100
+ planningDurationMs: number;
101
+ };
102
+ }
103
+ export interface ContextQualityAggregate {
104
+ schemaVersion: 1;
105
+ metricsVersion: string;
106
+ sampleCount: number;
107
+ labeledSampleCount: number;
108
+ strategyIds: string[];
109
+ plannerVersions: string[];
110
+ profileKeys: string[];
111
+ outcomeLabels: Record<string, number>;
112
+ evidenceRecall: QualityCountRate;
113
+ irrelevantTokenRatio: QualityCountRate;
114
+ duplicateEvidence: {
115
+ duplicateReferences: number;
116
+ selectedReferences: number;
117
+ };
118
+ provenanceCoverage: QualityCountRate;
119
+ currentRequestRetention: QualityCountRate;
120
+ atomicGroupValidity: QualityCountRate;
121
+ overflowRate: QualityCountRate;
122
+ fallbackRate: QualityCountRate;
123
+ qualityScore: number;
124
+ selectedTokens: number;
125
+ droppedTokens: number;
126
+ sourceKindCounts: Partial<Record<ContextManifestItemKind, QualitySourceKindCount>>;
127
+ budgetUtilization: Partial<Record<ContextManifestItemKind, QualityBudgetUtilization>>;
128
+ selectionReasons: Record<string, number>;
129
+ dropReasons: Record<string, number>;
130
+ }
131
+ export interface ContextQualityComparison {
132
+ schemaVersion: 1;
133
+ metricsVersion: string;
134
+ corpusVersion: string;
135
+ fixtureCount: number;
136
+ strategies: Array<{
137
+ strategyId: string;
138
+ aggregate: ContextQualityAggregate;
139
+ }>;
140
+ deltasFromBaseline: Array<{
141
+ strategyId: string;
142
+ qualityScore: number;
143
+ evidenceRecall: number;
144
+ irrelevantTokenRatio: number;
145
+ fallbackRate: number;
146
+ }>;
147
+ }
148
+ export interface ContextQualityDiagnostics {
149
+ enabled: boolean;
150
+ metricsVersion: string;
151
+ storedSamples: number;
152
+ ignoredSamples: number;
153
+ aggregate: ContextQualityAggregate;
154
+ timing: {
155
+ timedSamples: number;
156
+ meanPlanningDurationMs?: number;
157
+ p95PlanningDurationMs?: number;
158
+ latestPlanningDurationMs?: number;
159
+ };
160
+ lastError?: string;
161
+ }
162
+ export declare function validateQualityFixture(fixture: QualityReplayFixture): void;
163
+ export declare function staticRankingStrategy(): QualityStrategy;
164
+ export declare function taskWeightedCandidateStrategy(): QualityStrategy;
165
+ export declare function evaluateQualityPlan(fixture: QualityReplayFixture, strategyId: string, plan: QualityPlanDecision, planningDurationMs?: number): ContextQualitySample;
166
+ export declare function aggregateContextQuality(samples: readonly ContextQualitySample[]): ContextQualityAggregate;
167
+ export declare function compareQualityStrategies(corpus: QualityReplayCorpus, strategies: readonly QualityStrategy[]): ContextQualityComparison;
168
+ export declare function evaluateManifestQuality(manifest: ContextManifest, categoryBudgets: Partial<Record<ContextManifestItemKind, number>>): ContextQualitySample;
169
+ export declare function isContextQualitySample(value: unknown): value is ContextQualitySample;
170
+ export declare function qualityTiming(samples: readonly ContextQualitySample[]): ContextQualityDiagnostics["timing"];
171
+ export declare function disabledContextQualityDiagnostics(): ContextQualityDiagnostics;
172
+ //# sourceMappingURL=context-quality.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"context-quality.d.ts","sourceRoot":"","sources":["../../src/quality/context-quality.ts"],"names":[],"mappings":"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"}