agent-rulebook 0.1.6 → 0.2.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 (284) hide show
  1. package/README.md +54 -138
  2. package/dist/commands/index.js +11 -10
  3. package/dist/commands/index.js.map +1 -1
  4. package/dist/commands/init.js +3 -6
  5. package/dist/commands/init.js.map +1 -1
  6. package/dist/commands/output.d.ts +0 -5
  7. package/dist/commands/output.js +0 -47
  8. package/dist/commands/output.js.map +1 -1
  9. package/dist/commands/project.d.ts +2 -0
  10. package/dist/commands/project.js +33 -0
  11. package/dist/commands/project.js.map +1 -0
  12. package/dist/commands/resolution.d.ts +2 -0
  13. package/dist/commands/resolution.js +32 -0
  14. package/dist/commands/resolution.js.map +1 -0
  15. package/dist/commands/sync.d.ts +6 -3
  16. package/dist/commands/sync.js +130 -177
  17. package/dist/commands/sync.js.map +1 -1
  18. package/dist/core/attempt-outcome.d.ts +21 -0
  19. package/dist/core/attempt-outcome.js +61 -0
  20. package/dist/core/attempt-outcome.js.map +1 -0
  21. package/dist/core/change-policy.d.ts +7 -0
  22. package/dist/core/change-policy.js +14 -0
  23. package/dist/core/change-policy.js.map +1 -0
  24. package/dist/core/index.d.ts +34 -31
  25. package/dist/core/index.js +18 -13
  26. package/dist/core/index.js.map +1 -1
  27. package/dist/core/outcome-schema.d.ts +55 -0
  28. package/dist/core/outcome-schema.js +44 -0
  29. package/dist/core/outcome-schema.js.map +1 -0
  30. package/dist/core/problem-fingerprint.d.ts +4 -0
  31. package/dist/core/problem-fingerprint.js +37 -0
  32. package/dist/core/problem-fingerprint.js.map +1 -0
  33. package/dist/core/problem-schema.d.ts +34 -0
  34. package/dist/core/problem-schema.js +37 -0
  35. package/dist/core/problem-schema.js.map +1 -0
  36. package/dist/core/project-environment-detector.d.ts +2 -2
  37. package/dist/core/project-environment-detector.js +8 -52
  38. package/dist/core/project-environment-detector.js.map +1 -1
  39. package/dist/core/project-file-scan.d.ts +17 -0
  40. package/dist/core/project-file-scan.js +73 -0
  41. package/dist/core/project-file-scan.js.map +1 -0
  42. package/dist/core/project-registry.d.ts +8 -0
  43. package/dist/core/project-registry.js +38 -0
  44. package/dist/core/project-registry.js.map +1 -0
  45. package/dist/core/repository-identity.d.ts +7 -0
  46. package/dist/core/repository-identity.js +27 -0
  47. package/dist/core/repository-identity.js.map +1 -0
  48. package/dist/core/resolution-applicability.d.ts +20 -0
  49. package/dist/core/resolution-applicability.js +38 -0
  50. package/dist/core/resolution-applicability.js.map +1 -0
  51. package/dist/core/resolution-parser.d.ts +20 -0
  52. package/dist/core/resolution-parser.js +47 -0
  53. package/dist/core/resolution-parser.js.map +1 -0
  54. package/dist/core/resolution-ranker.d.ts +34 -0
  55. package/dist/core/resolution-ranker.js +40 -0
  56. package/dist/core/resolution-ranker.js.map +1 -0
  57. package/dist/core/resolution-relation.d.ts +14 -0
  58. package/dist/core/resolution-relation.js +29 -0
  59. package/dist/core/resolution-relation.js.map +1 -0
  60. package/dist/core/resolution-schema.d.ts +109 -0
  61. package/dist/core/resolution-schema.js +29 -0
  62. package/dist/core/resolution-schema.js.map +1 -0
  63. package/dist/core/resolution-search-types.d.ts +37 -0
  64. package/dist/core/resolution-search-types.js +2 -0
  65. package/dist/core/resolution-search-types.js.map +1 -0
  66. package/dist/core/resolution-semantic-checksum.d.ts +12 -0
  67. package/dist/core/resolution-semantic-checksum.js +24 -0
  68. package/dist/core/resolution-semantic-checksum.js.map +1 -0
  69. package/dist/core/resolution-writer.d.ts +7 -0
  70. package/dist/core/resolution-writer.js +33 -0
  71. package/dist/core/resolution-writer.js.map +1 -0
  72. package/dist/core/solution-schema.d.ts +42 -0
  73. package/dist/core/solution-schema.js +28 -0
  74. package/dist/core/solution-schema.js.map +1 -0
  75. package/dist/core/source-evidence-schema.d.ts +26 -0
  76. package/dist/core/source-evidence-schema.js +29 -0
  77. package/dist/core/source-evidence-schema.js.map +1 -0
  78. package/dist/core/source-evidence.d.ts +14 -0
  79. package/dist/core/source-evidence.js +69 -0
  80. package/dist/core/source-evidence.js.map +1 -0
  81. package/dist/core/stack-detector.d.ts +2 -2
  82. package/dist/core/stack-detector.js +11 -63
  83. package/dist/core/stack-detector.js.map +1 -1
  84. package/dist/index.d.ts +3 -4
  85. package/dist/index.js +2 -2
  86. package/dist/index.js.map +1 -1
  87. package/dist/mcp/index.d.ts +3 -3
  88. package/dist/mcp/index.js +2 -2
  89. package/dist/mcp/index.js.map +1 -1
  90. package/dist/mcp/resolution-change.d.ts +19 -0
  91. package/dist/mcp/resolution-change.js +136 -0
  92. package/dist/mcp/resolution-change.js.map +1 -0
  93. package/dist/mcp/resolutions-commit-change-tool.d.ts +5 -0
  94. package/dist/mcp/resolutions-commit-change-tool.js +21 -0
  95. package/dist/mcp/resolutions-commit-change-tool.js.map +1 -0
  96. package/dist/mcp/resolutions-find-tool.d.ts +5 -0
  97. package/dist/mcp/resolutions-find-tool.js +75 -0
  98. package/dist/mcp/resolutions-find-tool.js.map +1 -0
  99. package/dist/mcp/resolutions-get-source-tool.d.ts +5 -0
  100. package/dist/mcp/resolutions-get-source-tool.js +30 -0
  101. package/dist/mcp/resolutions-get-source-tool.js.map +1 -0
  102. package/dist/mcp/resolutions-get-tool.d.ts +5 -0
  103. package/dist/mcp/resolutions-get-tool.js +27 -0
  104. package/dist/mcp/resolutions-get-tool.js.map +1 -0
  105. package/dist/mcp/resolutions-list-facets-tool.d.ts +4 -0
  106. package/dist/mcp/resolutions-list-facets-tool.js +18 -0
  107. package/dist/mcp/resolutions-list-facets-tool.js.map +1 -0
  108. package/dist/mcp/resolutions-prepare-change-tool.d.ts +5 -0
  109. package/dist/mcp/resolutions-prepare-change-tool.js +7 -0
  110. package/dist/mcp/resolutions-prepare-change-tool.js.map +1 -0
  111. package/dist/mcp/resolutions-report-attempt-tool.d.ts +5 -0
  112. package/dist/mcp/resolutions-report-attempt-tool.js +87 -0
  113. package/dist/mcp/resolutions-report-attempt-tool.js.map +1 -0
  114. package/dist/mcp/schemas.d.ts +265 -197
  115. package/dist/mcp/schemas.js +28 -93
  116. package/dist/mcp/schemas.js.map +1 -1
  117. package/dist/mcp/tool-output.d.ts +0 -34
  118. package/dist/mcp/tool-output.js +2 -71
  119. package/dist/mcp/tool-output.js.map +1 -1
  120. package/dist/mcp/tools.d.ts +973 -204
  121. package/dist/mcp/tools.js +47 -101
  122. package/dist/mcp/tools.js.map +1 -1
  123. package/dist/program.js +5 -9
  124. package/dist/program.js.map +1 -1
  125. package/dist/storage/index.d.ts +10 -15
  126. package/dist/storage/index.js +8 -8
  127. package/dist/storage/index.js.map +1 -1
  128. package/dist/storage/project-code-index-source.d.ts +2 -0
  129. package/dist/storage/project-code-index-source.js +23 -0
  130. package/dist/storage/project-code-index-source.js.map +1 -0
  131. package/dist/storage/resolution-candidate-service.d.ts +6 -0
  132. package/dist/storage/resolution-candidate-service.js +94 -0
  133. package/dist/storage/resolution-candidate-service.js.map +1 -0
  134. package/dist/storage/resolution-change-transaction.d.ts +11 -0
  135. package/dist/storage/resolution-change-transaction.js +56 -0
  136. package/dist/storage/resolution-change-transaction.js.map +1 -0
  137. package/dist/storage/resolution-home.d.ts +20 -0
  138. package/dist/storage/resolution-home.js +59 -0
  139. package/dist/storage/resolution-home.js.map +1 -0
  140. package/dist/storage/resolution-index-check.d.ts +28 -0
  141. package/dist/storage/resolution-index-check.js +30 -0
  142. package/dist/storage/resolution-index-check.js.map +1 -0
  143. package/dist/storage/resolution-indexer.d.ts +19 -0
  144. package/dist/storage/resolution-indexer.js +158 -0
  145. package/dist/storage/resolution-indexer.js.map +1 -0
  146. package/dist/storage/resolution-migrations.d.ts +3 -0
  147. package/dist/storage/resolution-migrations.js +39 -0
  148. package/dist/storage/resolution-migrations.js.map +1 -0
  149. package/package.json +5 -3
  150. package/dist/commands/add.d.ts +0 -2
  151. package/dist/commands/add.js +0 -134
  152. package/dist/commands/add.js.map +0 -1
  153. package/dist/commands/migrate.d.ts +0 -2
  154. package/dist/commands/migrate.js +0 -73
  155. package/dist/commands/migrate.js.map +0 -1
  156. package/dist/commands/rule.d.ts +0 -23
  157. package/dist/commands/rule.js +0 -158
  158. package/dist/commands/rule.js.map +0 -1
  159. package/dist/commands/search.d.ts +0 -2
  160. package/dist/commands/search.js +0 -57
  161. package/dist/commands/search.js.map +0 -1
  162. package/dist/core/compatibility-matcher.d.ts +0 -17
  163. package/dist/core/compatibility-matcher.js +0 -146
  164. package/dist/core/compatibility-matcher.js.map +0 -1
  165. package/dist/core/dedup.d.ts +0 -22
  166. package/dist/core/dedup.js +0 -54
  167. package/dist/core/dedup.js.map +0 -1
  168. package/dist/core/error-signature.d.ts +0 -15
  169. package/dist/core/error-signature.js +0 -59
  170. package/dist/core/error-signature.js.map +0 -1
  171. package/dist/core/facets.d.ts +0 -9
  172. package/dist/core/facets.js +0 -46
  173. package/dist/core/facets.js.map +0 -1
  174. package/dist/core/lesson-importer.d.ts +0 -22
  175. package/dist/core/lesson-importer.js +0 -94
  176. package/dist/core/lesson-importer.js.map +0 -1
  177. package/dist/core/ranker.d.ts +0 -3
  178. package/dist/core/ranker.js +0 -83
  179. package/dist/core/ranker.js.map +0 -1
  180. package/dist/core/rule-compatibility.d.ts +0 -66
  181. package/dist/core/rule-compatibility.js +0 -53
  182. package/dist/core/rule-compatibility.js.map +0 -1
  183. package/dist/core/rule-parser.d.ts +0 -25
  184. package/dist/core/rule-parser.js +0 -81
  185. package/dist/core/rule-parser.js.map +0 -1
  186. package/dist/core/rule-schema.d.ts +0 -265
  187. package/dist/core/rule-schema.js +0 -202
  188. package/dist/core/rule-schema.js.map +0 -1
  189. package/dist/core/rule-writer.d.ts +0 -35
  190. package/dist/core/rule-writer.js +0 -63
  191. package/dist/core/rule-writer.js.map +0 -1
  192. package/dist/core/search-types.d.ts +0 -57
  193. package/dist/core/search-types.js +0 -2
  194. package/dist/core/search-types.js.map +0 -1
  195. package/dist/core/semantic-checksum.d.ts +0 -6
  196. package/dist/core/semantic-checksum.js +0 -34
  197. package/dist/core/semantic-checksum.js.map +0 -1
  198. package/dist/core/slug.d.ts +0 -13
  199. package/dist/core/slug.js +0 -42
  200. package/dist/core/slug.js.map +0 -1
  201. package/dist/mcp/lesson-capture.d.ts +0 -30
  202. package/dist/mcp/lesson-capture.js +0 -144
  203. package/dist/mcp/lesson-capture.js.map +0 -1
  204. package/dist/mcp/rules-add-lesson-tool.d.ts +0 -4
  205. package/dist/mcp/rules-add-lesson-tool.js +0 -73
  206. package/dist/mcp/rules-add-lesson-tool.js.map +0 -1
  207. package/dist/mcp/rules-dedup-lesson-tool.d.ts +0 -4
  208. package/dist/mcp/rules-dedup-lesson-tool.js +0 -69
  209. package/dist/mcp/rules-dedup-lesson-tool.js.map +0 -1
  210. package/dist/mcp/rules-list-facets-tool.d.ts +0 -3
  211. package/dist/mcp/rules-list-facets-tool.js +0 -31
  212. package/dist/mcp/rules-list-facets-tool.js.map +0 -1
  213. package/dist/mcp/rules-prepare-lesson-tool.d.ts +0 -4
  214. package/dist/mcp/rules-prepare-lesson-tool.js +0 -7
  215. package/dist/mcp/rules-prepare-lesson-tool.js.map +0 -1
  216. package/dist/mcp/rules-search-error-tool.d.ts +0 -4
  217. package/dist/mcp/rules-search-error-tool.js +0 -103
  218. package/dist/mcp/rules-search-error-tool.js.map +0 -1
  219. package/dist/mcp/rules-search-for-project-tool.d.ts +0 -4
  220. package/dist/mcp/rules-search-for-project-tool.js +0 -105
  221. package/dist/mcp/rules-search-for-project-tool.js.map +0 -1
  222. package/dist/mcp/rules-search-tool.d.ts +0 -7
  223. package/dist/mcp/rules-search-tool.js +0 -65
  224. package/dist/mcp/rules-search-tool.js.map +0 -1
  225. package/dist/migration/adapters/fenced-lessons.d.ts +0 -2
  226. package/dist/migration/adapters/fenced-lessons.js +0 -55
  227. package/dist/migration/adapters/fenced-lessons.js.map +0 -1
  228. package/dist/migration/adapters/global-rules.d.ts +0 -2
  229. package/dist/migration/adapters/global-rules.js +0 -72
  230. package/dist/migration/adapters/global-rules.js.map +0 -1
  231. package/dist/migration/adapters/index.d.ts +0 -2
  232. package/dist/migration/adapters/index.js +0 -13
  233. package/dist/migration/adapters/index.js.map +0 -1
  234. package/dist/migration/adapters/markdown-lessons.d.ts +0 -2
  235. package/dist/migration/adapters/markdown-lessons.js +0 -36
  236. package/dist/migration/adapters/markdown-lessons.js.map +0 -1
  237. package/dist/migration/adapters/structured-lessons.d.ts +0 -2
  238. package/dist/migration/adapters/structured-lessons.js +0 -8
  239. package/dist/migration/adapters/structured-lessons.js.map +0 -1
  240. package/dist/migration/adapters/structured-shared.d.ts +0 -3
  241. package/dist/migration/adapters/structured-shared.js +0 -97
  242. package/dist/migration/adapters/structured-shared.js.map +0 -1
  243. package/dist/migration/applier.d.ts +0 -32
  244. package/dist/migration/applier.js +0 -559
  245. package/dist/migration/applier.js.map +0 -1
  246. package/dist/migration/index.d.ts +0 -11
  247. package/dist/migration/index.js +0 -7
  248. package/dist/migration/index.js.map +0 -1
  249. package/dist/migration/manifest.d.ts +0 -263
  250. package/dist/migration/manifest.js +0 -91
  251. package/dist/migration/manifest.js.map +0 -1
  252. package/dist/migration/migration-report.d.ts +0 -151
  253. package/dist/migration/migration-report.js +0 -85
  254. package/dist/migration/migration-report.js.map +0 -1
  255. package/dist/migration/scanner.d.ts +0 -2
  256. package/dist/migration/scanner.js +0 -312
  257. package/dist/migration/scanner.js.map +0 -1
  258. package/dist/migration/source-adapter.d.ts +0 -37
  259. package/dist/migration/source-adapter.js +0 -2
  260. package/dist/migration/source-adapter.js.map +0 -1
  261. package/dist/migration/verifier.d.ts +0 -5
  262. package/dist/migration/verifier.js +0 -218
  263. package/dist/migration/verifier.js.map +0 -1
  264. package/dist/storage/index-check.d.ts +0 -21
  265. package/dist/storage/index-check.js +0 -136
  266. package/dist/storage/index-check.js.map +0 -1
  267. package/dist/storage/indexer.d.ts +0 -19
  268. package/dist/storage/indexer.js +0 -367
  269. package/dist/storage/indexer.js.map +0 -1
  270. package/dist/storage/migrations.d.ts +0 -3
  271. package/dist/storage/migrations.js +0 -126
  272. package/dist/storage/migrations.js.map +0 -1
  273. package/dist/storage/rule-discovery.d.ts +0 -4
  274. package/dist/storage/rule-discovery.js +0 -34
  275. package/dist/storage/rule-discovery.js.map +0 -1
  276. package/dist/storage/rule-store.d.ts +0 -10
  277. package/dist/storage/rule-store.js +0 -12
  278. package/dist/storage/rule-store.js.map +0 -1
  279. package/dist/storage/rulebook-home.d.ts +0 -21
  280. package/dist/storage/rulebook-home.js +0 -78
  281. package/dist/storage/rulebook-home.js.map +0 -1
  282. package/dist/storage/search-service.d.ts +0 -17
  283. package/dist/storage/search-service.js +0 -275
  284. package/dist/storage/search-service.js.map +0 -1
@@ -0,0 +1,73 @@
1
+ import { readdir } from 'node:fs/promises';
2
+ import { join, relative, sep } from 'node:path';
3
+ import { runGit, splitGitLines } from './git.js';
4
+ export const PROJECT_SCAN_EXCLUDED_DIRECTORIES = new Set([
5
+ '.git', '.build', '.gradle', '.codex', '.serena', 'node_modules',
6
+ 'build', 'dist', 'artifacts', 'artifact', 'DerivedData', 'fixtures',
7
+ ]);
8
+ export async function scanProjectFiles(root, options) {
9
+ const tracked = await runGit(root, ['ls-files']);
10
+ if (tracked.exitCode === 0) {
11
+ const paths = splitGitLines(tracked.stdout)
12
+ .filter((path) => !path.split('/').some((segment) => PROJECT_SCAN_EXCLUDED_DIRECTORIES.has(segment)))
13
+ .sort(rootFirst);
14
+ const selected = paths.slice(0, options.maxFiles);
15
+ const entries = new Map();
16
+ for (const relativePath of selected) {
17
+ const segments = relativePath.split('/');
18
+ for (let index = 1; index < segments.length; index += 1) {
19
+ const directory = segments.slice(0, index).join('/');
20
+ entries.set(`directory:${directory}`, {
21
+ kind: 'directory', absolutePath: join(root, directory), relativePath: directory, name: segments[index - 1],
22
+ });
23
+ }
24
+ entries.set(`file:${relativePath}`, {
25
+ kind: 'file', absolutePath: join(root, relativePath), relativePath, name: segments.at(-1),
26
+ });
27
+ }
28
+ return { entries: [...entries.values()], scannedFiles: selected.length, limitExceeded: paths.length > selected.length, source: 'git_tracked' };
29
+ }
30
+ const entries = [];
31
+ let scannedFiles = 0;
32
+ let limitExceeded = false;
33
+ async function walk(directory, depth) {
34
+ if (depth > options.maxDepth || limitExceeded)
35
+ return;
36
+ let dirents;
37
+ try {
38
+ dirents = await readdir(directory, { withFileTypes: true });
39
+ }
40
+ catch {
41
+ return;
42
+ }
43
+ const ordered = dirents.sort((left, right) => Number(left.isDirectory()) - Number(right.isDirectory()) || left.name.localeCompare(right.name));
44
+ for (const dirent of ordered) {
45
+ const absolutePath = join(directory, dirent.name);
46
+ const relativePath = relative(root, absolutePath).split(sep).join('/');
47
+ if (dirent.isDirectory()) {
48
+ if (PROJECT_SCAN_EXCLUDED_DIRECTORIES.has(dirent.name))
49
+ continue;
50
+ entries.push({ kind: 'directory', absolutePath, relativePath, name: dirent.name });
51
+ if (depth >= options.maxDepth) {
52
+ limitExceeded = true;
53
+ continue;
54
+ }
55
+ await walk(absolutePath, depth + 1);
56
+ }
57
+ else if (dirent.isFile()) {
58
+ if (scannedFiles >= options.maxFiles) {
59
+ limitExceeded = true;
60
+ return;
61
+ }
62
+ scannedFiles += 1;
63
+ entries.push({ kind: 'file', absolutePath, relativePath, name: dirent.name });
64
+ }
65
+ }
66
+ }
67
+ await walk(root, 1);
68
+ return { entries, scannedFiles, limitExceeded, source: 'filesystem' };
69
+ }
70
+ function rootFirst(left, right) {
71
+ return left.split('/').length - right.split('/').length || left.localeCompare(right);
72
+ }
73
+ //# sourceMappingURL=project-file-scan.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-file-scan.js","sourceRoot":"","sources":["../../src/core/project-file-scan.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import { z } from 'zod';
2
+ export declare const ProjectRegistrySchema: z.ZodObject<{
3
+ schema_version: z.ZodLiteral<1>;
4
+ projects: z.ZodRecord<z.ZodString, z.ZodString>;
5
+ }, z.core.$strict>;
6
+ export type ProjectRegistry = z.infer<typeof ProjectRegistrySchema>;
7
+ export declare function readProjectRegistry(home: string): Promise<ProjectRegistry>;
8
+ export declare function registerProject(home: string, projectKey: string, root: string): Promise<ProjectRegistry>;
@@ -0,0 +1,38 @@
1
+ import { mkdir, readFile, realpath } from 'node:fs/promises';
2
+ import { dirname, join } from 'node:path';
3
+ import { parse, stringify } from 'yaml';
4
+ import { z } from 'zod';
5
+ import { normalizeProjectKey } from './project-key.js';
6
+ import { replaceFileAtomically } from '../storage/atomic-file.js';
7
+ export const ProjectRegistrySchema = z
8
+ .object({
9
+ schema_version: z.literal(1),
10
+ projects: z.record(z.string().regex(/^[a-z0-9][a-z0-9._-]*$/), z.string().min(1)),
11
+ })
12
+ .strict();
13
+ export async function readProjectRegistry(home) {
14
+ const path = join(home, 'projects.local.yaml');
15
+ try {
16
+ return ProjectRegistrySchema.parse(parse(await readFile(path, 'utf8')));
17
+ }
18
+ catch (error) {
19
+ if (error.code === 'ENOENT')
20
+ return { schema_version: 1, projects: {} };
21
+ throw error;
22
+ }
23
+ }
24
+ export async function registerProject(home, projectKey, root) {
25
+ const key = normalizeProjectKey(projectKey);
26
+ if (key === undefined)
27
+ throw new Error('A stable project key is required');
28
+ const resolvedRoot = await realpath(root);
29
+ const registry = await readProjectRegistry(home);
30
+ const updated = ProjectRegistrySchema.parse({
31
+ ...registry,
32
+ projects: { ...registry.projects, [key]: resolvedRoot },
33
+ });
34
+ await mkdir(dirname(join(home, 'projects.local.yaml')), { recursive: true });
35
+ await replaceFileAtomically(join(home, 'projects.local.yaml'), stringify(updated, { lineWidth: 0 }));
36
+ return updated;
37
+ }
38
+ //# sourceMappingURL=project-registry.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-registry.js","sourceRoot":"","sources":["../../src/core/project-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAClF,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACnG,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,UAAkB,EAAE,IAAY;IAClF,MAAM,GAAG,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC;QAC1C,GAAG,QAAQ;QACX,QAAQ,EAAE,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE;KACxD,CAAC,CAAC;IACH,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,MAAM,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,EAAE,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACrG,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,7 @@
1
+ export type RepositoryIdentity = {
2
+ root: string;
3
+ normalizedRemote: string;
4
+ fingerprint: string;
5
+ };
6
+ export declare function inspectRepositoryIdentity(projectRoot: string): Promise<RepositoryIdentity>;
7
+ export declare function normalizeRemoteIdentity(remote: string): string;
@@ -0,0 +1,27 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { realpath } from 'node:fs/promises';
3
+ import { runGit } from './git.js';
4
+ export async function inspectRepositoryIdentity(projectRoot) {
5
+ const rootResult = await runGit(projectRoot, ['rev-parse', '--show-toplevel']);
6
+ if (rootResult.exitCode !== 0)
7
+ throw new Error('Project root is not a Git worktree');
8
+ const root = await realpath(rootResult.stdout.trim());
9
+ const remoteResult = await runGit(root, ['remote', 'get-url', 'origin']);
10
+ if (remoteResult.exitCode !== 0)
11
+ throw new Error('Git origin is required for a portable repository identity');
12
+ const normalizedRemote = normalizeRemoteIdentity(remoteResult.stdout.trim());
13
+ return {
14
+ root,
15
+ normalizedRemote,
16
+ fingerprint: `sha256:${createHash('sha256').update(normalizedRemote).digest('hex')}`,
17
+ };
18
+ }
19
+ export function normalizeRemoteIdentity(remote) {
20
+ const withoutCredentials = remote.replace(/^(https?:\/\/)[^/@]+@/i, '$1');
21
+ return withoutCredentials
22
+ .replace(/^git@([^:]+):/i, 'ssh://$1/')
23
+ .replace(/\.git$/i, '')
24
+ .replace(/\/$/, '')
25
+ .toLowerCase();
26
+ }
27
+ //# sourceMappingURL=repository-identity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"repository-identity.js","sourceRoot":"","sources":["../../src/core/repository-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAQlC,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,WAAmB;IACjE,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC/E,IAAI,UAAU,CAAC,QAAQ,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,IAAI,YAAY,CAAC,QAAQ,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC9G,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7E,OAAO;QACL,IAAI;QACJ,gBAAgB;QAChB,WAAW,EAAE,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;KACrF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;IAC1E,OAAO,kBAAkB;SACtB,OAAO,CAAC,gBAAgB,EAAE,WAAW,CAAC;SACtC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,WAAW,EAAE,CAAC;AACnB,CAAC"}
@@ -0,0 +1,20 @@
1
+ import type { ResolutionEnvironment } from './problem-schema.js';
2
+ import type { Solution } from './solution-schema.js';
3
+ export type SourceAvailability = 'available' | 'stale' | 'unavailable';
4
+ export type ResolutionApplicability = {
5
+ excluded: boolean;
6
+ classification: 'likely' | 'possible' | 'incompatible';
7
+ matched: string[];
8
+ mismatched: string[];
9
+ unknown: string[];
10
+ requiredChecks: string[];
11
+ sourceAvailability: SourceAvailability;
12
+ };
13
+ export declare function evaluateResolutionApplicability(options: {
14
+ solution: Solution;
15
+ solutionEnvironment: ResolutionEnvironment;
16
+ currentEnvironment: ResolutionEnvironment;
17
+ satisfiedConditions?: string[];
18
+ rejectedConditions?: string[];
19
+ sourceAvailability?: SourceAvailability;
20
+ }): ResolutionApplicability;
@@ -0,0 +1,38 @@
1
+ export function evaluateResolutionApplicability(options) {
2
+ const matched = [];
3
+ const mismatched = [];
4
+ const unknown = [];
5
+ for (const field of ['languages', 'platforms', 'runtimes', 'tools']) {
6
+ const expected = new Set(options.solutionEnvironment[field]);
7
+ const current = new Set(options.currentEnvironment[field]);
8
+ if (expected.size === 0)
9
+ continue;
10
+ if (current.size === 0)
11
+ unknown.push(`environment.${field}`);
12
+ else if ([...expected].some((value) => current.has(value)))
13
+ matched.push(`environment.${field}`);
14
+ else
15
+ mismatched.push(`environment.${field}`);
16
+ }
17
+ const satisfied = new Set((options.satisfiedConditions ?? []).map(normalize));
18
+ const rejected = new Set((options.rejectedConditions ?? []).map(normalize));
19
+ const rejectMatched = options.solution.reject_if.filter((condition) => satisfied.has(normalize(condition)));
20
+ const applicableRejected = options.solution.applicable_if.filter((condition) => rejected.has(normalize(condition)));
21
+ mismatched.push(...rejectMatched.map((condition) => `reject_if:${condition}`), ...applicableRejected.map((condition) => `applicable_if:${condition}`));
22
+ const requiredChecks = options.solution.applicable_if.filter((condition) => !satisfied.has(normalize(condition)) && !rejected.has(normalize(condition)));
23
+ unknown.push(...requiredChecks.map((condition) => `applicable_if:${condition}`));
24
+ const excluded = mismatched.length > 0;
25
+ return {
26
+ excluded,
27
+ classification: excluded ? 'incompatible' : requiredChecks.length === 0 && unknown.length === 0 ? 'likely' : 'possible',
28
+ matched,
29
+ mismatched,
30
+ unknown,
31
+ requiredChecks,
32
+ sourceAvailability: options.sourceAvailability ?? 'unavailable',
33
+ };
34
+ }
35
+ function normalize(value) {
36
+ return value.trim().toLocaleLowerCase().replace(/\s+/g, ' ');
37
+ }
38
+ //# sourceMappingURL=resolution-applicability.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolution-applicability.js","sourceRoot":"","sources":["../../src/core/resolution-applicability.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ import { type ResolutionDocument } from './resolution-schema.js';
2
+ export type ResolutionValidationIssue = {
3
+ path: string;
4
+ message: string;
5
+ };
6
+ export type ResolutionParseError = {
7
+ kind: 'yaml_parse' | 'validation' | 'legacy_schema_unsupported_clean_reset_required';
8
+ filePath: string;
9
+ message: string;
10
+ issues: ResolutionValidationIssue[];
11
+ schemaVersion?: unknown;
12
+ };
13
+ export type ResolutionParseResult = {
14
+ success: true;
15
+ document: ResolutionDocument;
16
+ } | {
17
+ success: false;
18
+ error: ResolutionParseError;
19
+ };
20
+ export declare function parseResolutionYaml(source: string, filePath: string): ResolutionParseResult;
@@ -0,0 +1,47 @@
1
+ import { parse as parseYaml } from 'yaml';
2
+ import { ResolutionDocumentSchema } from './resolution-schema.js';
3
+ export function parseResolutionYaml(source, filePath) {
4
+ let input;
5
+ try {
6
+ input = parseYaml(source);
7
+ }
8
+ catch (error) {
9
+ return failure('yaml_parse', filePath, error instanceof Error ? error.message : 'Unable to parse YAML');
10
+ }
11
+ const schemaVersion = readSchemaVersion(input);
12
+ if (schemaVersion !== 3) {
13
+ return {
14
+ success: false,
15
+ error: {
16
+ kind: 'legacy_schema_unsupported_clean_reset_required',
17
+ filePath,
18
+ message: 'Legacy schema is unsupported; clean reset required',
19
+ issues: [{ path: 'schema_version', message: 'Legacy schema is unsupported; clean reset required' }],
20
+ schemaVersion,
21
+ },
22
+ };
23
+ }
24
+ const result = ResolutionDocumentSchema.safeParse(input);
25
+ if (!result.success) {
26
+ return {
27
+ success: false,
28
+ error: {
29
+ kind: 'validation',
30
+ filePath,
31
+ message: `Resolution validation failed for ${filePath}`,
32
+ issues: result.error.issues.map((issue) => ({ path: issue.path.join('.'), message: issue.message })),
33
+ schemaVersion,
34
+ },
35
+ };
36
+ }
37
+ return { success: true, document: result.data };
38
+ }
39
+ function readSchemaVersion(input) {
40
+ return typeof input === 'object' && input !== null && !Array.isArray(input)
41
+ ? Reflect.get(input, 'schema_version')
42
+ : undefined;
43
+ }
44
+ function failure(kind, filePath, message) {
45
+ return { success: false, error: { kind, filePath, message, issues: [] } };
46
+ }
47
+ //# sourceMappingURL=resolution-parser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolution-parser.js","sourceRoot":"","sources":["../../src/core/resolution-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAA2B,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAc3F,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,QAAgB;IAClE,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;IAC1G,CAAC;IAED,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,gDAAgD;gBACtD,QAAQ;gBACR,OAAO,EAAE,oDAAoD;gBAC7D,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;gBACnG,aAAa;aACd;SACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,YAAY;gBAClB,QAAQ;gBACR,OAAO,EAAE,oCAAoC,QAAQ,EAAE;gBACvD,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACpG,aAAa;aACd;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,gBAAgB,CAAC;QACtC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,OAAO,CAAC,IAAkB,EAAE,QAAgB,EAAE,OAAe;IACpE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;AAC5E,CAAC"}
@@ -0,0 +1,34 @@
1
+ import type { ResolutionCandidate } from './resolution-search-types.js';
2
+ import type { ResolutionApplicability } from './resolution-applicability.js';
3
+ export type ContextOutcome = {
4
+ solutionId: string;
5
+ solutionRevision: number;
6
+ contextFingerprint: string;
7
+ result: 'solved' | 'failed' | 'inapplicable' | 'inconclusive' | 'regressed';
8
+ count: number;
9
+ };
10
+ export type RankedResolutionCandidate = ResolutionCandidate & {
11
+ applicability: ResolutionApplicability;
12
+ usage: 'direct' | 'reference';
13
+ risk: 'low' | 'elevated' | 'high';
14
+ verificationCost: number;
15
+ solutionHandle: string;
16
+ sourceHandles: string[];
17
+ rankingEvidence: Array<{
18
+ factor: string;
19
+ effect: 'include' | 'boost' | 'penalty' | 'exclude';
20
+ value: number | string;
21
+ }>;
22
+ rankScore: number;
23
+ };
24
+ export declare function rankResolutionCandidates(options: {
25
+ candidates: Array<{
26
+ candidate: ResolutionCandidate;
27
+ applicability: ResolutionApplicability;
28
+ projectRelation: 'current_project' | 'shared' | 'foreign_project';
29
+ verificationSteps: number;
30
+ sourceHandles?: string[];
31
+ }>;
32
+ contextFingerprint: string;
33
+ outcomes?: ContextOutcome[];
34
+ }): RankedResolutionCandidate[];
@@ -0,0 +1,40 @@
1
+ export function rankResolutionCandidates(options) {
2
+ const ranked = [];
3
+ for (const item of options.candidates) {
4
+ if (item.applicability.excluded)
5
+ continue;
6
+ const matchingOutcomes = (options.outcomes ?? []).filter((outcome) => outcome.solutionId === item.candidate.solutionId && outcome.solutionRevision === item.candidate.solutionRevision);
7
+ const current = matchingOutcomes.filter(({ contextFingerprint }) => contextFingerprint === options.contextFingerprint);
8
+ if (current.some(({ result }) => result === 'failed' || result === 'inapplicable'))
9
+ continue;
10
+ const exact = item.candidate.matchEvidence.filter(({ channel }) => channel === 'error_signature').length;
11
+ const structural = item.candidate.matchEvidence.filter(({ channel }) => channel === 'symbol' || channel === 'operation' || channel === 'source_code').length;
12
+ const fact = item.candidate.matchEvidence.filter(({ confidence }) => confidence === 'fact').length;
13
+ const solved = current.filter(({ result }) => result === 'solved').reduce((sum, { count }) => sum + count, 0);
14
+ const regressed = matchingOutcomes.filter(({ result }) => result === 'regressed').reduce((sum, { count }) => sum + count, 0);
15
+ const projectBoost = item.projectRelation === 'current_project' ? 30 : item.projectRelation === 'shared' ? 12 : -12;
16
+ const applicabilityBoost = item.applicability.classification === 'likely' ? 20 : 0;
17
+ const sourceBoost = item.applicability.sourceAvailability === 'available' ? 10 : item.applicability.sourceAvailability === 'stale' ? -8 : -3;
18
+ const rankScore = item.candidate.recallScore + exact * 60 + structural * 25 + fact * 5 + solved * 25 + projectBoost + applicabilityBoost + sourceBoost - regressed * 30;
19
+ const sourceOnly = item.candidate.matchEvidence.length > 0 && item.candidate.matchEvidence.every(({ channel }) => channel === 'source_code');
20
+ ranked.push({
21
+ ...item.candidate,
22
+ applicability: item.applicability,
23
+ usage: sourceOnly || item.projectRelation === 'foreign_project' ? 'reference' : 'direct',
24
+ risk: regressed > 0 ? 'high' : item.applicability.sourceAvailability === 'stale' || item.applicability.requiredChecks.length > 0 ? 'elevated' : 'low',
25
+ verificationCost: item.verificationSteps + regressed,
26
+ solutionHandle: `${item.candidate.solutionId}@${item.candidate.solutionRevision}`,
27
+ sourceHandles: item.sourceHandles ?? [],
28
+ rankingEvidence: [
29
+ { factor: 'recall', effect: 'include', value: item.candidate.recallScore },
30
+ { factor: 'project_relation', effect: projectBoost >= 0 ? 'boost' : 'penalty', value: item.projectRelation },
31
+ { factor: 'applicability', effect: applicabilityBoost > 0 ? 'boost' : 'include', value: item.applicability.classification },
32
+ { factor: 'source_availability', effect: sourceBoost >= 0 ? 'boost' : 'penalty', value: item.applicability.sourceAvailability },
33
+ ...(regressed === 0 ? [] : [{ factor: 'regressed', effect: 'penalty', value: regressed }]),
34
+ ],
35
+ rankScore,
36
+ });
37
+ }
38
+ return ranked.sort((left, right) => right.rankScore - left.rankScore || left.solutionId.localeCompare(right.solutionId) || left.solutionRevision - right.solutionRevision);
39
+ }
40
+ //# sourceMappingURL=resolution-ranker.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolution-ranker.js","sourceRoot":"","sources":["../../src/core/resolution-ranker.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ export declare const RESOLUTION_RELATIONS: readonly ["exact_solution", "same_problem_alternative", "refines_solution", "supersedes_solution", "contradicts_solution", "analogous_pattern", "weak_overlap", "new_problem"];
2
+ export type ResolutionRelation = (typeof RESOLUTION_RELATIONS)[number];
3
+ export type ResolutionComparison = {
4
+ sameProblem: boolean;
5
+ sameCause: boolean;
6
+ sameStrategy: boolean;
7
+ sameApplicability: boolean;
8
+ hasTarget: boolean;
9
+ replacementVerified: boolean;
10
+ conflictEvidence: readonly string[];
11
+ analogousEvidence: readonly string[];
12
+ weakTextOverlap: boolean;
13
+ };
14
+ export declare function classifyResolutionRelation(comparison: ResolutionComparison): ResolutionRelation;
@@ -0,0 +1,29 @@
1
+ export const RESOLUTION_RELATIONS = [
2
+ 'exact_solution',
3
+ 'same_problem_alternative',
4
+ 'refines_solution',
5
+ 'supersedes_solution',
6
+ 'contradicts_solution',
7
+ 'analogous_pattern',
8
+ 'weak_overlap',
9
+ 'new_problem',
10
+ ];
11
+ export function classifyResolutionRelation(comparison) {
12
+ if (comparison.conflictEvidence.length > 0)
13
+ return 'contradicts_solution';
14
+ if (comparison.sameProblem) {
15
+ if (comparison.sameCause && comparison.sameStrategy && comparison.sameApplicability)
16
+ return 'exact_solution';
17
+ if (comparison.hasTarget && comparison.replacementVerified && (!comparison.sameCause || !comparison.sameStrategy))
18
+ return 'supersedes_solution';
19
+ if (comparison.hasTarget && comparison.sameCause && comparison.sameStrategy && !comparison.sameApplicability)
20
+ return 'refines_solution';
21
+ return 'same_problem_alternative';
22
+ }
23
+ if (comparison.analogousEvidence.length > 0 && comparison.sameStrategy)
24
+ return 'analogous_pattern';
25
+ if (comparison.weakTextOverlap)
26
+ return 'weak_overlap';
27
+ return 'new_problem';
28
+ }
29
+ //# sourceMappingURL=resolution-relation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolution-relation.js","sourceRoot":"","sources":["../../src/core/resolution-relation.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,gBAAgB;IAChB,0BAA0B;IAC1B,kBAAkB;IAClB,qBAAqB;IACrB,sBAAsB;IACtB,mBAAmB;IACnB,cAAc;IACd,aAAa;CACL,CAAC;AAgBX,MAAM,UAAU,0BAA0B,CAAC,UAAgC;IACzE,IAAI,UAAU,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,sBAAsB,CAAC;IAC1E,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,YAAY,IAAI,UAAU,CAAC,iBAAiB;YAAE,OAAO,gBAAgB,CAAC;QAC7G,IAAI,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,mBAAmB,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,OAAO,qBAAqB,CAAC;QAChJ,IAAI,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,YAAY,IAAI,CAAC,UAAU,CAAC,iBAAiB;YAAE,OAAO,kBAAkB,CAAC;QACxI,OAAO,0BAA0B,CAAC;IACpC,CAAC;IACD,IAAI,UAAU,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,YAAY;QAAE,OAAO,mBAAmB,CAAC;IACnG,IAAI,UAAU,CAAC,eAAe;QAAE,OAAO,cAAc,CAAC;IACtD,OAAO,aAAa,CAAC;AACvB,CAAC"}
@@ -0,0 +1,109 @@
1
+ import { z } from 'zod';
2
+ export declare const ResolutionDocumentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
3
+ schema_version: z.ZodLiteral<3>;
4
+ kind: z.ZodLiteral<"problem">;
5
+ id: z.ZodString;
6
+ title: z.ZodString;
7
+ observations: z.ZodObject<{
8
+ symptoms: z.ZodArray<z.ZodString>;
9
+ error_signatures: z.ZodDefault<z.ZodArray<z.ZodString>>;
10
+ symbols: z.ZodDefault<z.ZodArray<z.ZodString>>;
11
+ operations: z.ZodDefault<z.ZodArray<z.ZodString>>;
12
+ expected: z.ZodString;
13
+ observed: z.ZodString;
14
+ }, z.core.$strict>;
15
+ hypotheses: z.ZodObject<{
16
+ suspected_causes: z.ZodDefault<z.ZodArray<z.ZodString>>;
17
+ components: z.ZodDefault<z.ZodArray<z.ZodString>>;
18
+ }, z.core.$strict>;
19
+ environment: z.ZodObject<{
20
+ languages: z.ZodDefault<z.ZodArray<z.ZodString>>;
21
+ platforms: z.ZodDefault<z.ZodArray<z.ZodString>>;
22
+ runtimes: z.ZodDefault<z.ZodArray<z.ZodString>>;
23
+ tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
24
+ }, z.core.$strict>;
25
+ created_at: z.ZodISODateTime;
26
+ }, z.core.$strict>, z.ZodObject<{
27
+ schema_version: z.ZodLiteral<3>;
28
+ kind: z.ZodLiteral<"solution">;
29
+ id: z.ZodString;
30
+ problem_id: z.ZodString;
31
+ revision: z.ZodNumber;
32
+ title: z.ZodString;
33
+ cause: z.ZodString;
34
+ applicable_if: z.ZodArray<z.ZodString>;
35
+ reject_if: z.ZodDefault<z.ZodArray<z.ZodString>>;
36
+ inspections: z.ZodArray<z.ZodString>;
37
+ actions: z.ZodArray<z.ZodString>;
38
+ verification: z.ZodArray<z.ZodString>;
39
+ safety: z.ZodArray<z.ZodString>;
40
+ source_evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
41
+ id: z.ZodString;
42
+ project_key: z.ZodString;
43
+ repository_fingerprint: z.ZodString;
44
+ revision: z.ZodDiscriminatedUnion<[z.ZodObject<{
45
+ kind: z.ZodLiteral<"git_commit">;
46
+ value: z.ZodString;
47
+ }, z.core.$strict>, z.ZodObject<{
48
+ kind: z.ZodLiteral<"working_tree_hash">;
49
+ value: z.ZodString;
50
+ }, z.core.$strict>], "kind">;
51
+ relative_path: z.ZodString;
52
+ symbol: z.ZodOptional<z.ZodString>;
53
+ content_hash: z.ZodString;
54
+ tests: z.ZodDefault<z.ZodArray<z.ZodString>>;
55
+ }, z.core.$strict>>>;
56
+ prior_solution: z.ZodOptional<z.ZodObject<{
57
+ id: z.ZodString;
58
+ revision: z.ZodNumber;
59
+ relation: z.ZodEnum<{
60
+ refines: "refines";
61
+ supersedes: "supersedes";
62
+ }>;
63
+ }, z.core.$strict>>;
64
+ created_at: z.ZodISODateTime;
65
+ }, z.core.$strict>, z.ZodObject<{
66
+ schema_version: z.ZodLiteral<3>;
67
+ kind: z.ZodLiteral<"outcome">;
68
+ id: z.ZodString;
69
+ problem_id: z.ZodString;
70
+ solution_id: z.ZodString;
71
+ solution_revision: z.ZodNumber;
72
+ result: z.ZodEnum<{
73
+ solved: "solved";
74
+ failed: "failed";
75
+ inapplicable: "inapplicable";
76
+ inconclusive: "inconclusive";
77
+ regressed: "regressed";
78
+ }>;
79
+ context_fingerprint: z.ZodString;
80
+ environment: z.ZodObject<{
81
+ languages: z.ZodDefault<z.ZodArray<z.ZodString>>;
82
+ platforms: z.ZodDefault<z.ZodArray<z.ZodString>>;
83
+ runtimes: z.ZodDefault<z.ZodArray<z.ZodString>>;
84
+ tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
85
+ }, z.core.$strict>;
86
+ reason_code: z.ZodOptional<z.ZodString>;
87
+ evidence: z.ZodArray<z.ZodObject<{
88
+ kind: z.ZodEnum<{
89
+ focused_test: "focused_test";
90
+ integration_test: "integration_test";
91
+ manual_verification: "manual_verification";
92
+ observation: "observation";
93
+ }>;
94
+ handle: z.ZodString;
95
+ summary: z.ZodString;
96
+ }, z.core.$strict>>;
97
+ created_at: z.ZodISODateTime;
98
+ }, z.core.$strict>], "kind">;
99
+ export type ResolutionDocument = z.infer<typeof ResolutionDocumentSchema>;
100
+ export type ResolutionReferenceSet = {
101
+ problemIds: ReadonlySet<string>;
102
+ solutionRevisions: ReadonlySet<string>;
103
+ };
104
+ export type ResolutionReferenceIssue = {
105
+ path: string;
106
+ message: string;
107
+ };
108
+ export declare function solutionRevisionKey(id: string, revision: number): string;
109
+ export declare function validateResolutionReferences(document: ResolutionDocument, references: ResolutionReferenceSet): ResolutionReferenceIssue[];
@@ -0,0 +1,29 @@
1
+ import { z } from 'zod';
2
+ import { OutcomeSchema } from './outcome-schema.js';
3
+ import { ProblemSchema } from './problem-schema.js';
4
+ import { SolutionSchema } from './solution-schema.js';
5
+ export const ResolutionDocumentSchema = z.discriminatedUnion('kind', [
6
+ ProblemSchema,
7
+ SolutionSchema,
8
+ OutcomeSchema,
9
+ ]);
10
+ export function solutionRevisionKey(id, revision) {
11
+ return `${id}@${revision}`;
12
+ }
13
+ export function validateResolutionReferences(document, references) {
14
+ if (document.kind === 'problem')
15
+ return [];
16
+ const issues = [];
17
+ if (!references.problemIds.has(document.problem_id)) {
18
+ issues.push({ path: 'problem_id', message: `Unknown problem reference: ${document.problem_id}` });
19
+ }
20
+ if (document.kind === 'outcome'
21
+ && !references.solutionRevisions.has(solutionRevisionKey(document.solution_id, document.solution_revision))) {
22
+ issues.push({
23
+ path: 'solution_revision',
24
+ message: `Unknown solution revision: ${document.solution_id}@${document.solution_revision}`,
25
+ });
26
+ }
27
+ return issues;
28
+ }
29
+ //# sourceMappingURL=resolution-schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolution-schema.js","sourceRoot":"","sources":["../../src/core/resolution-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACnE,aAAa;IACb,cAAc;IACd,aAAa;CACd,CAAC,CAAC;AAcH,MAAM,UAAU,mBAAmB,CAAC,EAAU,EAAE,QAAgB;IAC9D,OAAO,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAA4B,EAC5B,UAAkC;IAElC,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAE3C,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,8BAA8B,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,IACE,QAAQ,CAAC,IAAI,KAAK,SAAS;WACxB,CAAC,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC,EAC3G,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,8BAA8B,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,iBAAiB,EAAE;SAC5F,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
@@ -0,0 +1,37 @@
1
+ import type { ResolutionEnvironment } from './problem-schema.js';
2
+ export type ProblemSearchInput = {
3
+ observations: {
4
+ symptoms: string[];
5
+ error_signatures?: string[];
6
+ symbols?: string[];
7
+ operations?: string[];
8
+ expected: string;
9
+ observed: string;
10
+ };
11
+ hypotheses?: {
12
+ suspected_causes?: string[];
13
+ components?: string[];
14
+ };
15
+ environment: ResolutionEnvironment;
16
+ };
17
+ export type MatchEvidence = {
18
+ channel: 'error_signature' | 'symbol' | 'operation' | 'symptom' | 'expected_observed' | 'hypothesis' | 'source_code' | 'weak_lexical';
19
+ field: string;
20
+ matchedValue: string;
21
+ source: 'problem' | 'solution' | 'source_chunk';
22
+ confidence: 'fact' | 'hypothesis' | 'low_signal';
23
+ rawScore: number;
24
+ };
25
+ export type ResolutionCandidate = {
26
+ problemId: string;
27
+ solutionId: string;
28
+ solutionRevision: number;
29
+ title: string;
30
+ fingerprint: string;
31
+ matchEvidence: MatchEvidence[];
32
+ recallScore: number;
33
+ };
34
+ export type ResolutionCandidateResponse = {
35
+ fingerprint: string;
36
+ candidates: ResolutionCandidate[];
37
+ };