agent-rulebook 0.1.7 → 0.2.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 (290) hide show
  1. package/README.md +63 -140
  2. package/dist/commands/home.d.ts +2 -0
  3. package/dist/commands/home.js +59 -0
  4. package/dist/commands/home.js.map +1 -0
  5. package/dist/commands/index.js +11 -10
  6. package/dist/commands/index.js.map +1 -1
  7. package/dist/commands/init.js +3 -6
  8. package/dist/commands/init.js.map +1 -1
  9. package/dist/commands/output.d.ts +0 -5
  10. package/dist/commands/output.js +0 -47
  11. package/dist/commands/output.js.map +1 -1
  12. package/dist/commands/project.d.ts +2 -0
  13. package/dist/commands/project.js +33 -0
  14. package/dist/commands/project.js.map +1 -0
  15. package/dist/commands/resolution.d.ts +2 -0
  16. package/dist/commands/resolution.js +32 -0
  17. package/dist/commands/resolution.js.map +1 -0
  18. package/dist/commands/sync.d.ts +6 -3
  19. package/dist/commands/sync.js +130 -177
  20. package/dist/commands/sync.js.map +1 -1
  21. package/dist/core/attempt-outcome.d.ts +21 -0
  22. package/dist/core/attempt-outcome.js +61 -0
  23. package/dist/core/attempt-outcome.js.map +1 -0
  24. package/dist/core/change-policy.d.ts +7 -0
  25. package/dist/core/change-policy.js +14 -0
  26. package/dist/core/change-policy.js.map +1 -0
  27. package/dist/core/index.d.ts +34 -33
  28. package/dist/core/index.js +18 -14
  29. package/dist/core/index.js.map +1 -1
  30. package/dist/core/outcome-schema.d.ts +55 -0
  31. package/dist/core/outcome-schema.js +44 -0
  32. package/dist/core/outcome-schema.js.map +1 -0
  33. package/dist/core/problem-fingerprint.d.ts +4 -0
  34. package/dist/core/problem-fingerprint.js +37 -0
  35. package/dist/core/problem-fingerprint.js.map +1 -0
  36. package/dist/core/problem-schema.d.ts +34 -0
  37. package/dist/core/problem-schema.js +37 -0
  38. package/dist/core/problem-schema.js.map +1 -0
  39. package/dist/core/project-environment-detector.d.ts +2 -2
  40. package/dist/core/project-environment-detector.js +8 -52
  41. package/dist/core/project-environment-detector.js.map +1 -1
  42. package/dist/core/project-file-scan.d.ts +17 -0
  43. package/dist/core/project-file-scan.js +73 -0
  44. package/dist/core/project-file-scan.js.map +1 -0
  45. package/dist/core/project-registry.d.ts +8 -0
  46. package/dist/core/project-registry.js +38 -0
  47. package/dist/core/project-registry.js.map +1 -0
  48. package/dist/core/repository-identity.d.ts +7 -0
  49. package/dist/core/repository-identity.js +27 -0
  50. package/dist/core/repository-identity.js.map +1 -0
  51. package/dist/core/resolution-applicability.d.ts +20 -0
  52. package/dist/core/resolution-applicability.js +38 -0
  53. package/dist/core/resolution-applicability.js.map +1 -0
  54. package/dist/core/resolution-parser.d.ts +20 -0
  55. package/dist/core/resolution-parser.js +47 -0
  56. package/dist/core/resolution-parser.js.map +1 -0
  57. package/dist/core/resolution-ranker.d.ts +34 -0
  58. package/dist/core/resolution-ranker.js +40 -0
  59. package/dist/core/resolution-ranker.js.map +1 -0
  60. package/dist/core/resolution-relation.d.ts +14 -0
  61. package/dist/core/resolution-relation.js +29 -0
  62. package/dist/core/resolution-relation.js.map +1 -0
  63. package/dist/core/resolution-schema.d.ts +109 -0
  64. package/dist/core/resolution-schema.js +29 -0
  65. package/dist/core/resolution-schema.js.map +1 -0
  66. package/dist/core/resolution-search-types.d.ts +37 -0
  67. package/dist/core/resolution-search-types.js +2 -0
  68. package/dist/core/resolution-search-types.js.map +1 -0
  69. package/dist/core/resolution-semantic-checksum.d.ts +12 -0
  70. package/dist/core/resolution-semantic-checksum.js +24 -0
  71. package/dist/core/resolution-semantic-checksum.js.map +1 -0
  72. package/dist/core/resolution-writer.d.ts +7 -0
  73. package/dist/core/resolution-writer.js +33 -0
  74. package/dist/core/resolution-writer.js.map +1 -0
  75. package/dist/core/solution-schema.d.ts +42 -0
  76. package/dist/core/solution-schema.js +28 -0
  77. package/dist/core/solution-schema.js.map +1 -0
  78. package/dist/core/source-evidence-schema.d.ts +26 -0
  79. package/dist/core/source-evidence-schema.js +29 -0
  80. package/dist/core/source-evidence-schema.js.map +1 -0
  81. package/dist/core/source-evidence.d.ts +14 -0
  82. package/dist/core/source-evidence.js +69 -0
  83. package/dist/core/source-evidence.js.map +1 -0
  84. package/dist/core/stack-detector.d.ts +2 -2
  85. package/dist/core/stack-detector.js +11 -63
  86. package/dist/core/stack-detector.js.map +1 -1
  87. package/dist/index.d.ts +3 -4
  88. package/dist/index.js +2 -2
  89. package/dist/index.js.map +1 -1
  90. package/dist/mcp/index.d.ts +3 -3
  91. package/dist/mcp/index.js +2 -2
  92. package/dist/mcp/index.js.map +1 -1
  93. package/dist/mcp/resolution-change.d.ts +19 -0
  94. package/dist/mcp/resolution-change.js +136 -0
  95. package/dist/mcp/resolution-change.js.map +1 -0
  96. package/dist/mcp/resolutions-commit-change-tool.d.ts +5 -0
  97. package/dist/mcp/resolutions-commit-change-tool.js +21 -0
  98. package/dist/mcp/resolutions-commit-change-tool.js.map +1 -0
  99. package/dist/mcp/resolutions-find-tool.d.ts +5 -0
  100. package/dist/mcp/resolutions-find-tool.js +75 -0
  101. package/dist/mcp/resolutions-find-tool.js.map +1 -0
  102. package/dist/mcp/resolutions-get-source-tool.d.ts +5 -0
  103. package/dist/mcp/resolutions-get-source-tool.js +30 -0
  104. package/dist/mcp/resolutions-get-source-tool.js.map +1 -0
  105. package/dist/mcp/resolutions-get-tool.d.ts +5 -0
  106. package/dist/mcp/resolutions-get-tool.js +27 -0
  107. package/dist/mcp/resolutions-get-tool.js.map +1 -0
  108. package/dist/mcp/resolutions-list-facets-tool.d.ts +4 -0
  109. package/dist/mcp/resolutions-list-facets-tool.js +18 -0
  110. package/dist/mcp/resolutions-list-facets-tool.js.map +1 -0
  111. package/dist/mcp/resolutions-prepare-change-tool.d.ts +5 -0
  112. package/dist/mcp/resolutions-prepare-change-tool.js +7 -0
  113. package/dist/mcp/resolutions-prepare-change-tool.js.map +1 -0
  114. package/dist/mcp/resolutions-report-attempt-tool.d.ts +5 -0
  115. package/dist/mcp/resolutions-report-attempt-tool.js +87 -0
  116. package/dist/mcp/resolutions-report-attempt-tool.js.map +1 -0
  117. package/dist/mcp/schemas.d.ts +265 -197
  118. package/dist/mcp/schemas.js +28 -93
  119. package/dist/mcp/schemas.js.map +1 -1
  120. package/dist/mcp/tool-output.d.ts +0 -34
  121. package/dist/mcp/tool-output.js +2 -71
  122. package/dist/mcp/tool-output.js.map +1 -1
  123. package/dist/mcp/tools.d.ts +973 -204
  124. package/dist/mcp/tools.js +47 -101
  125. package/dist/mcp/tools.js.map +1 -1
  126. package/dist/program.js +7 -9
  127. package/dist/program.js.map +1 -1
  128. package/dist/storage/index.d.ts +10 -15
  129. package/dist/storage/index.js +8 -8
  130. package/dist/storage/index.js.map +1 -1
  131. package/dist/storage/project-code-index-source.d.ts +2 -0
  132. package/dist/storage/project-code-index-source.js +23 -0
  133. package/dist/storage/project-code-index-source.js.map +1 -0
  134. package/dist/storage/resolution-candidate-service.d.ts +6 -0
  135. package/dist/storage/resolution-candidate-service.js +94 -0
  136. package/dist/storage/resolution-candidate-service.js.map +1 -0
  137. package/dist/storage/resolution-change-transaction.d.ts +11 -0
  138. package/dist/storage/resolution-change-transaction.js +56 -0
  139. package/dist/storage/resolution-change-transaction.js.map +1 -0
  140. package/dist/storage/resolution-home.d.ts +21 -0
  141. package/dist/storage/resolution-home.js +62 -0
  142. package/dist/storage/resolution-home.js.map +1 -0
  143. package/dist/storage/resolution-index-check.d.ts +28 -0
  144. package/dist/storage/resolution-index-check.js +30 -0
  145. package/dist/storage/resolution-index-check.js.map +1 -0
  146. package/dist/storage/resolution-indexer.d.ts +19 -0
  147. package/dist/storage/resolution-indexer.js +158 -0
  148. package/dist/storage/resolution-indexer.js.map +1 -0
  149. package/dist/storage/resolution-migrations.d.ts +3 -0
  150. package/dist/storage/resolution-migrations.js +39 -0
  151. package/dist/storage/resolution-migrations.js.map +1 -0
  152. package/package.json +5 -3
  153. package/dist/commands/add.d.ts +0 -2
  154. package/dist/commands/add.js +0 -134
  155. package/dist/commands/add.js.map +0 -1
  156. package/dist/commands/migrate.d.ts +0 -2
  157. package/dist/commands/migrate.js +0 -73
  158. package/dist/commands/migrate.js.map +0 -1
  159. package/dist/commands/rule.d.ts +0 -23
  160. package/dist/commands/rule.js +0 -158
  161. package/dist/commands/rule.js.map +0 -1
  162. package/dist/commands/search.d.ts +0 -2
  163. package/dist/commands/search.js +0 -57
  164. package/dist/commands/search.js.map +0 -1
  165. package/dist/core/capture-policy.d.ts +0 -6
  166. package/dist/core/capture-policy.js +0 -5
  167. package/dist/core/capture-policy.js.map +0 -1
  168. package/dist/core/compatibility-matcher.d.ts +0 -17
  169. package/dist/core/compatibility-matcher.js +0 -146
  170. package/dist/core/compatibility-matcher.js.map +0 -1
  171. package/dist/core/dedup.d.ts +0 -22
  172. package/dist/core/dedup.js +0 -54
  173. package/dist/core/dedup.js.map +0 -1
  174. package/dist/core/error-signature.d.ts +0 -15
  175. package/dist/core/error-signature.js +0 -59
  176. package/dist/core/error-signature.js.map +0 -1
  177. package/dist/core/facets.d.ts +0 -9
  178. package/dist/core/facets.js +0 -46
  179. package/dist/core/facets.js.map +0 -1
  180. package/dist/core/lesson-importer.d.ts +0 -22
  181. package/dist/core/lesson-importer.js +0 -94
  182. package/dist/core/lesson-importer.js.map +0 -1
  183. package/dist/core/ranker.d.ts +0 -3
  184. package/dist/core/ranker.js +0 -83
  185. package/dist/core/ranker.js.map +0 -1
  186. package/dist/core/rule-compatibility.d.ts +0 -66
  187. package/dist/core/rule-compatibility.js +0 -53
  188. package/dist/core/rule-compatibility.js.map +0 -1
  189. package/dist/core/rule-parser.d.ts +0 -25
  190. package/dist/core/rule-parser.js +0 -81
  191. package/dist/core/rule-parser.js.map +0 -1
  192. package/dist/core/rule-schema.d.ts +0 -283
  193. package/dist/core/rule-schema.js +0 -213
  194. package/dist/core/rule-schema.js.map +0 -1
  195. package/dist/core/rule-writer.d.ts +0 -35
  196. package/dist/core/rule-writer.js +0 -63
  197. package/dist/core/rule-writer.js.map +0 -1
  198. package/dist/core/search-types.d.ts +0 -57
  199. package/dist/core/search-types.js +0 -2
  200. package/dist/core/search-types.js.map +0 -1
  201. package/dist/core/semantic-checksum.d.ts +0 -6
  202. package/dist/core/semantic-checksum.js +0 -34
  203. package/dist/core/semantic-checksum.js.map +0 -1
  204. package/dist/core/slug.d.ts +0 -13
  205. package/dist/core/slug.js +0 -42
  206. package/dist/core/slug.js.map +0 -1
  207. package/dist/mcp/lesson-capture.d.ts +0 -30
  208. package/dist/mcp/lesson-capture.js +0 -148
  209. package/dist/mcp/lesson-capture.js.map +0 -1
  210. package/dist/mcp/rules-add-lesson-tool.d.ts +0 -4
  211. package/dist/mcp/rules-add-lesson-tool.js +0 -73
  212. package/dist/mcp/rules-add-lesson-tool.js.map +0 -1
  213. package/dist/mcp/rules-dedup-lesson-tool.d.ts +0 -4
  214. package/dist/mcp/rules-dedup-lesson-tool.js +0 -69
  215. package/dist/mcp/rules-dedup-lesson-tool.js.map +0 -1
  216. package/dist/mcp/rules-list-facets-tool.d.ts +0 -3
  217. package/dist/mcp/rules-list-facets-tool.js +0 -31
  218. package/dist/mcp/rules-list-facets-tool.js.map +0 -1
  219. package/dist/mcp/rules-prepare-lesson-tool.d.ts +0 -4
  220. package/dist/mcp/rules-prepare-lesson-tool.js +0 -7
  221. package/dist/mcp/rules-prepare-lesson-tool.js.map +0 -1
  222. package/dist/mcp/rules-search-error-tool.d.ts +0 -4
  223. package/dist/mcp/rules-search-error-tool.js +0 -103
  224. package/dist/mcp/rules-search-error-tool.js.map +0 -1
  225. package/dist/mcp/rules-search-for-project-tool.d.ts +0 -4
  226. package/dist/mcp/rules-search-for-project-tool.js +0 -105
  227. package/dist/mcp/rules-search-for-project-tool.js.map +0 -1
  228. package/dist/mcp/rules-search-tool.d.ts +0 -7
  229. package/dist/mcp/rules-search-tool.js +0 -65
  230. package/dist/mcp/rules-search-tool.js.map +0 -1
  231. package/dist/migration/adapters/fenced-lessons.d.ts +0 -2
  232. package/dist/migration/adapters/fenced-lessons.js +0 -55
  233. package/dist/migration/adapters/fenced-lessons.js.map +0 -1
  234. package/dist/migration/adapters/global-rules.d.ts +0 -2
  235. package/dist/migration/adapters/global-rules.js +0 -72
  236. package/dist/migration/adapters/global-rules.js.map +0 -1
  237. package/dist/migration/adapters/index.d.ts +0 -2
  238. package/dist/migration/adapters/index.js +0 -13
  239. package/dist/migration/adapters/index.js.map +0 -1
  240. package/dist/migration/adapters/markdown-lessons.d.ts +0 -2
  241. package/dist/migration/adapters/markdown-lessons.js +0 -36
  242. package/dist/migration/adapters/markdown-lessons.js.map +0 -1
  243. package/dist/migration/adapters/structured-lessons.d.ts +0 -2
  244. package/dist/migration/adapters/structured-lessons.js +0 -8
  245. package/dist/migration/adapters/structured-lessons.js.map +0 -1
  246. package/dist/migration/adapters/structured-shared.d.ts +0 -3
  247. package/dist/migration/adapters/structured-shared.js +0 -97
  248. package/dist/migration/adapters/structured-shared.js.map +0 -1
  249. package/dist/migration/applier.d.ts +0 -32
  250. package/dist/migration/applier.js +0 -559
  251. package/dist/migration/applier.js.map +0 -1
  252. package/dist/migration/index.d.ts +0 -11
  253. package/dist/migration/index.js +0 -7
  254. package/dist/migration/index.js.map +0 -1
  255. package/dist/migration/manifest.d.ts +0 -263
  256. package/dist/migration/manifest.js +0 -91
  257. package/dist/migration/manifest.js.map +0 -1
  258. package/dist/migration/migration-report.d.ts +0 -151
  259. package/dist/migration/migration-report.js +0 -85
  260. package/dist/migration/migration-report.js.map +0 -1
  261. package/dist/migration/scanner.d.ts +0 -2
  262. package/dist/migration/scanner.js +0 -312
  263. package/dist/migration/scanner.js.map +0 -1
  264. package/dist/migration/source-adapter.d.ts +0 -37
  265. package/dist/migration/source-adapter.js +0 -2
  266. package/dist/migration/source-adapter.js.map +0 -1
  267. package/dist/migration/verifier.d.ts +0 -5
  268. package/dist/migration/verifier.js +0 -218
  269. package/dist/migration/verifier.js.map +0 -1
  270. package/dist/storage/index-check.d.ts +0 -21
  271. package/dist/storage/index-check.js +0 -136
  272. package/dist/storage/index-check.js.map +0 -1
  273. package/dist/storage/indexer.d.ts +0 -19
  274. package/dist/storage/indexer.js +0 -367
  275. package/dist/storage/indexer.js.map +0 -1
  276. package/dist/storage/migrations.d.ts +0 -3
  277. package/dist/storage/migrations.js +0 -126
  278. package/dist/storage/migrations.js.map +0 -1
  279. package/dist/storage/rule-discovery.d.ts +0 -4
  280. package/dist/storage/rule-discovery.js +0 -34
  281. package/dist/storage/rule-discovery.js.map +0 -1
  282. package/dist/storage/rule-store.d.ts +0 -10
  283. package/dist/storage/rule-store.js +0 -12
  284. package/dist/storage/rule-store.js.map +0 -1
  285. package/dist/storage/rulebook-home.d.ts +0 -21
  286. package/dist/storage/rulebook-home.js +0 -78
  287. package/dist/storage/rulebook-home.js.map +0 -1
  288. package/dist/storage/search-service.d.ts +0 -17
  289. package/dist/storage/search-service.js +0 -275
  290. package/dist/storage/search-service.js.map +0 -1
package/dist/mcp/tools.js CHANGED
@@ -1,123 +1,69 @@
1
- import { MCP_DEFAULT_SEARCH_LIMIT, MCP_MAX_SEARCH_LIMIT, McpAddLessonInputSchema, McpDedupLessonInputSchema, McpListFacetsInputSchema, McpPrepareLessonInputSchema, McpSearchErrorInputSchema, McpSearchForProjectInputSchema, McpSearchInputSchema, } from './schemas.js';
2
- import { handleRulesAddLesson } from './rules-add-lesson-tool.js';
3
- import { handleRulesDedupLesson } from './rules-dedup-lesson-tool.js';
4
- import { handleRulesListFacets } from './rules-list-facets-tool.js';
5
- import { handleRulesPrepareLesson } from './rules-prepare-lesson-tool.js';
6
- import { handleRulesSearchError } from './rules-search-error-tool.js';
7
- import { handleRulesSearchForProject } from './rules-search-for-project-tool.js';
8
- import { handleRulesSearch } from './rules-search-tool.js';
9
- import { jsonToolResult } from './tool-output.js';
10
- export const MCP_SEARCH_LIMIT_POLICY = {
11
- defaultLimit: MCP_DEFAULT_SEARCH_LIMIT,
12
- maxLimit: MCP_MAX_SEARCH_LIMIT,
13
- };
1
+ import { MCP_DEFAULT_SEARCH_LIMIT, MCP_MAX_SEARCH_LIMIT, McpResolutionsFindInputSchema, McpResolutionsGetInputSchema, McpResolutionsGetSourceInputSchema, McpResolutionsListFacetsInputSchema, McpResolutionsReportAttemptInputSchema, McpResolutionsPrepareChangeInputSchema, McpResolutionsCommitChangeInputSchema, } from './schemas.js';
2
+ import { handleResolutionsFind } from './resolutions-find-tool.js';
3
+ import { handleResolutionsGet } from './resolutions-get-tool.js';
4
+ import { handleResolutionsGetSource } from './resolutions-get-source-tool.js';
5
+ import { handleResolutionsListFacets } from './resolutions-list-facets-tool.js';
6
+ import { handleResolutionsReportAttempt } from './resolutions-report-attempt-tool.js';
7
+ import { handleResolutionsPrepareChange } from './resolutions-prepare-change-tool.js';
8
+ import { handleResolutionsCommitChange } from './resolutions-commit-change-tool.js';
9
+ export const MCP_SEARCH_LIMIT_POLICY = { defaultLimit: MCP_DEFAULT_SEARCH_LIMIT, maxLimit: MCP_MAX_SEARCH_LIMIT };
14
10
  export const AGENT_RULEBOOK_MCP_TOOL_NAMES = [
15
- 'rules.search',
16
- 'rules.search_for_project',
17
- 'rules.search_error',
18
- 'rules.list_facets',
19
- 'rules.dedup_lesson',
20
- 'rules.prepare_lesson',
21
- 'rules.add_lesson',
11
+ 'resolutions.find',
12
+ 'resolutions.get',
13
+ 'resolutions.get_source',
14
+ 'resolutions.list_facets',
15
+ 'resolutions.report_attempt',
16
+ 'resolutions.prepare_change',
17
+ 'resolutions.commit_change',
22
18
  ];
23
19
  export const AGENT_RULEBOOK_MCP_TOOLS = [
24
20
  {
25
- name: 'rules.search',
26
- title: 'Search rules',
27
- description: 'Search shared rules and compatible project-scoped reference candidates by natural-language query and optional filters.',
28
- inputSchema: McpSearchInputSchema,
29
- annotations: readOnlyAnnotations(),
30
- handler: handleSearch,
21
+ name: 'resolutions.find', title: 'Find applicable resolutions',
22
+ description: 'Call at the first unexpected problem. Separate observations from hypotheses, then inspect match evidence and required checks before applying one candidate.',
23
+ inputSchema: McpResolutionsFindInputSchema, annotations: readOnlyAnnotations(), handler: handleFind,
31
24
  },
32
25
  {
33
- name: 'rules.search_for_project',
34
- title: 'Search rules for project',
35
- description: 'Search current-project, shared, and compatible foreign-project reference rules using a project path and task description.',
36
- inputSchema: McpSearchForProjectInputSchema,
37
- annotations: readOnlyAnnotations(),
38
- handler: handleSearchForProject,
26
+ name: 'resolutions.get', title: 'Get a resolution',
27
+ description: 'Read the selected solution applicability, inspections, actions, verification, safety, and source handles.',
28
+ inputSchema: McpResolutionsGetInputSchema, annotations: readOnlyAnnotations(), handler: handleGet,
39
29
  },
40
30
  {
41
- name: 'rules.search_error',
42
- title: 'Search rules for error log',
43
- description: 'Search rules using a build or test error log.',
44
- inputSchema: McpSearchErrorInputSchema,
45
- annotations: readOnlyAnnotations(),
46
- handler: handleSearchError,
31
+ name: 'resolutions.get_source', title: 'Get exact source evidence',
32
+ description: 'Read one registered source handle at its recorded revision and hash; arbitrary paths are not accepted.',
33
+ inputSchema: McpResolutionsGetSourceInputSchema, annotations: readOnlyAnnotations(), handler: handleGetSource,
47
34
  },
48
35
  {
49
- name: 'rules.list_facets',
50
- title: 'List rule facets',
51
- description: 'List canonical rule facets, aliases, and indexed counts.',
52
- inputSchema: McpListFacetsInputSchema,
53
- annotations: readOnlyAnnotations(),
54
- handler: handleListFacets,
36
+ name: 'resolutions.list_facets', title: 'List resolution facets',
37
+ description: 'List canonical environment facets and indexed counts.',
38
+ inputSchema: McpResolutionsListFacetsInputSchema, annotations: readOnlyAnnotations(), handler: handleListFacets,
55
39
  },
56
40
  {
57
- name: 'rules.dedup_lesson',
58
- title: 'Deduplicate lesson',
59
- description: 'Classify a lesson candidate as duplicate, related, or new.',
60
- inputSchema: McpDedupLessonInputSchema,
61
- annotations: readOnlyAnnotations(),
62
- handler: handleDedupLesson,
41
+ name: 'resolutions.report_attempt', title: 'Report resolution attempt',
42
+ description: 'Report the verified result of one exact solution revision.',
43
+ inputSchema: McpResolutionsReportAttemptInputSchema, annotations: writeAnnotations(true), handler: handleReportAttempt,
63
44
  },
64
45
  {
65
- name: 'rules.prepare_lesson',
66
- title: 'Prepare lesson rule',
67
- description: 'Validate, redact, scope, deduplicate, and hash a lesson without writing.',
68
- inputSchema: McpPrepareLessonInputSchema,
69
- annotations: readOnlyAnnotations(),
70
- handler: handlePrepareLesson,
46
+ name: 'resolutions.prepare_change', title: 'Prepare verified resolution change',
47
+ description: 'Validate and classify a verified resolution change without writing.',
48
+ inputSchema: McpResolutionsPrepareChangeInputSchema, annotations: readOnlyAnnotations(), handler: handlePrepareChange,
71
49
  },
72
50
  {
73
- name: 'rules.add_lesson',
74
- title: 'Append lesson rule',
75
- description: 'Append an eligible prepared lesson as a new active rule and rebuild the index.',
76
- inputSchema: McpAddLessonInputSchema,
77
- annotations: {
78
- readOnlyHint: false,
79
- destructiveHint: false,
80
- idempotentHint: false,
81
- openWorldHint: false,
82
- },
83
- handler: handleAddLesson,
51
+ name: 'resolutions.commit_change', title: 'Commit verified resolution change',
52
+ description: 'Commit an unchanged prepared resolution payload and rebuild the index.',
53
+ inputSchema: McpResolutionsCommitChangeInputSchema, annotations: writeAnnotations(true), handler: handleCommitChange,
84
54
  },
85
55
  ];
86
- async function handleSearch(args, context) {
87
- return handleRulesSearch(args, context);
88
- }
89
- async function handleSearchForProject(args, context) {
90
- return handleRulesSearchForProject(args, context);
91
- }
92
- async function handleSearchError(args, context) {
93
- return handleRulesSearchError(args, context);
94
- }
95
- async function handleDedupLesson(args, context) {
96
- return handleRulesDedupLesson(args, context);
97
- }
98
- async function handleListFacets(args, context) {
99
- return handleRulesListFacets(args, context);
100
- }
101
- async function handlePrepareLesson(args, context) {
102
- return handleRulesPrepareLesson(args, context);
103
- }
104
- async function handleAddLesson(args, context) {
105
- return handleRulesAddLesson(args, context);
106
- }
56
+ async function handleFind(args, context) { return handleResolutionsFind(args, context); }
57
+ async function handleGet(args, context) { return handleResolutionsGet(args, context); }
58
+ async function handleGetSource(args, context) { return handleResolutionsGetSource(args, context); }
59
+ async function handleListFacets(args, context) { return handleResolutionsListFacets(args, context); }
60
+ async function handleReportAttempt(args, context) { return handleResolutionsReportAttempt(args, context); }
61
+ async function handlePrepareChange(args, context) { return handleResolutionsPrepareChange(args, context); }
62
+ async function handleCommitChange(args, context) { return handleResolutionsCommitChange(args, context); }
107
63
  function readOnlyAnnotations() {
108
- return {
109
- readOnlyHint: true,
110
- destructiveHint: false,
111
- idempotentHint: true,
112
- openWorldHint: false,
113
- };
64
+ return { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
114
65
  }
115
- export function notImplementedToolResult(tool) {
116
- return jsonToolResult({
117
- status: 'error',
118
- code: 'not_implemented',
119
- tool,
120
- message: `${tool} is registered but not implemented in this step.`,
121
- }, true);
66
+ function writeAnnotations(idempotent) {
67
+ return { readOnlyHint: false, destructiveHint: false, idempotentHint: idempotent, openWorldHint: false };
122
68
  }
123
69
  //# sourceMappingURL=tools.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"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"}
package/dist/program.js CHANGED
@@ -1,25 +1,23 @@
1
1
  import { Command } from 'commander';
2
- import { registerAddCommand } from './commands/add.js';
3
2
  import { registerIndexCommand } from './commands/index.js';
3
+ import { registerHomeCommand } from './commands/home.js';
4
4
  import { registerInitCommand } from './commands/init.js';
5
5
  import { registerMcpCommand } from './commands/mcp.js';
6
- import { registerMigrateCommand } from './commands/migrate.js';
7
- import { registerSearchCommand } from './commands/search.js';
8
- import { registerRuleCommand } from './commands/rule.js';
6
+ import { registerProjectCommand } from './commands/project.js';
7
+ import { registerResolutionCommand } from './commands/resolution.js';
9
8
  import { registerSyncCommand } from './commands/sync.js';
10
9
  import { AGENT_RULEBOOK_VERSION } from './version.js';
11
10
  export function createCliProgram() {
12
11
  const program = new Command()
13
12
  .name('agent-rulebook')
14
- .description('Manage reusable agent rules')
13
+ .description('Agent-native problem, solution, and verified outcome memory')
15
14
  .version(AGENT_RULEBOOK_VERSION);
16
15
  registerInitCommand(program);
17
- registerAddCommand(program);
16
+ registerHomeCommand(program);
18
17
  registerIndexCommand(program);
19
18
  registerMcpCommand(program);
20
- registerMigrateCommand(program);
21
- registerSearchCommand(program);
22
- registerRuleCommand(program);
19
+ registerProjectCommand(program);
20
+ registerResolutionCommand(program);
23
21
  registerSyncCommand(program);
24
22
  return program;
25
23
  }
@@ -1 +1 @@
1
- {"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,gBAAgB,CAAC;SACtB,WAAW,CAAC,6BAA6B,CAAC;SAC1C,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC/B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE7B,OAAO,OAAO,CAAC;AACjB,CAAC"}
1
+ {"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,gBAAgB,CAAC;SACtB,WAAW,CAAC,6DAA6D,CAAC;SAC1E,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE7B,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -1,16 +1,11 @@
1
- export { createRulebookLayout } from './rulebook-home.js';
1
+ export { createResolutionIndexSchema, RESOLUTION_DATABASE_VERSION } from './resolution-migrations.js';
2
+ export { loadCanonicalResolutions, rebuildResolutionIndex } from './resolution-indexer.js';
3
+ export { checkResolutionIndex } from './resolution-index-check.js';
4
+ export { findResolutionCandidates } from './resolution-candidate-service.js';
5
+ export { commitResolutionDocuments } from './resolution-change-transaction.js';
6
+ export { isSafeTrackedPath, listSafeTrackedFiles } from './project-code-index-source.js';
7
+ export { createResolutionHome, executeLegacyReset, previewLegacyReset, LEGACY_RESET_TARGETS, RESOLUTION_HOME_DIRECTORIES, RESOLUTION_HOME_FILES } from './resolution-home.js';
2
8
  export { replaceFileAtomically } from './atomic-file.js';
3
- export { checkRulebookIndex } from './index-check.js';
4
- export { RulebookIndexCorruptError, RulebookIndexLockTimeoutError, RulebookIndexMigrationError, RulebookIndexRebuildError, rebuildRulebookIndex, } from './indexer.js';
5
- export { CURRENT_RULEBOOK_DATABASE_VERSION, migrateRulebookDatabase, } from './migrations.js';
6
- export { SEARCH_LIMIT_POLICIES, searchRules } from './search-service.js';
7
- export { discoverRuleFiles } from './rule-discovery.js';
8
- export { closeRulebookDatabase, openRulebookDatabase, readRulebookDatabaseRuntime, } from './sqlite.js';
9
- export { saveRulePreview } from './rule-store.js';
10
- export type { CheckRulebookIndexOptions, IndexCheckResult, IndexRuntimeCheck, IndexCheckStatus, } from './index-check.js';
11
- export type { SearchRulesOptions } from './search-service.js';
12
- export type { RebuildRulebookIndexOptions, RebuildRulebookIndexResult, SkippedRuleFile, } from './indexer.js';
13
- export type { DiscoverRuleFilesOptions } from './rule-discovery.js';
14
- export type { OpenRulebookDatabaseOptions, RulebookDatabase, RulebookDatabaseRuntime, } from './sqlite.js';
15
- export type { SaveRulePreviewOptions, SaveRulePreviewResult } from './rule-store.js';
16
- export type { CreateRulebookLayoutOptions, CreateRulebookLayoutResult, RulebookLayoutEntry, RulebookLayoutEntryKind, RulebookLayoutEntryStatus, } from './rulebook-home.js';
9
+ export { closeRulebookDatabase, openRulebookDatabase, readRulebookDatabaseRuntime } from './sqlite.js';
10
+ export type { RebuildResolutionIndexOptions } from './resolution-indexer.js';
11
+ export type { OpenRulebookDatabaseOptions, RulebookDatabase, RulebookDatabaseRuntime } from './sqlite.js';
@@ -1,10 +1,10 @@
1
- export { createRulebookLayout } from './rulebook-home.js';
1
+ export { createResolutionIndexSchema, RESOLUTION_DATABASE_VERSION } from './resolution-migrations.js';
2
+ export { loadCanonicalResolutions, rebuildResolutionIndex } from './resolution-indexer.js';
3
+ export { checkResolutionIndex } from './resolution-index-check.js';
4
+ export { findResolutionCandidates } from './resolution-candidate-service.js';
5
+ export { commitResolutionDocuments } from './resolution-change-transaction.js';
6
+ export { isSafeTrackedPath, listSafeTrackedFiles } from './project-code-index-source.js';
7
+ export { createResolutionHome, executeLegacyReset, previewLegacyReset, LEGACY_RESET_TARGETS, RESOLUTION_HOME_DIRECTORIES, RESOLUTION_HOME_FILES } from './resolution-home.js';
2
8
  export { replaceFileAtomically } from './atomic-file.js';
3
- export { checkRulebookIndex } from './index-check.js';
4
- export { RulebookIndexCorruptError, RulebookIndexLockTimeoutError, RulebookIndexMigrationError, RulebookIndexRebuildError, rebuildRulebookIndex, } from './indexer.js';
5
- export { CURRENT_RULEBOOK_DATABASE_VERSION, migrateRulebookDatabase, } from './migrations.js';
6
- export { SEARCH_LIMIT_POLICIES, searchRules } from './search-service.js';
7
- export { discoverRuleFiles } from './rule-discovery.js';
8
- export { closeRulebookDatabase, openRulebookDatabase, readRulebookDatabaseRuntime, } from './sqlite.js';
9
- export { saveRulePreview } from './rule-store.js';
9
+ export { closeRulebookDatabase, openRulebookDatabase, readRulebookDatabaseRuntime } from './sqlite.js';
10
10
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EACL,yBAAyB,EACzB,6BAA6B,EAC7B,2BAA2B,EAC3B,yBAAyB,EACzB,oBAAoB,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,iCAAiC,EACjC,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC9K,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC"}
@@ -0,0 +1,2 @@
1
+ export declare function listSafeTrackedFiles(projectRoot: string): Promise<string[]>;
2
+ export declare function isSafeTrackedPath(relativePath: string): boolean;
@@ -0,0 +1,23 @@
1
+ import { extname } from 'node:path';
2
+ import { runGit, splitGitLines } from '../core/git.js';
3
+ const EXCLUDED_SEGMENTS = new Set([
4
+ '.build', 'build', 'dist', 'artifacts', 'artifact', 'deriveddata', 'node_modules', '.git',
5
+ ]);
6
+ const BINARY_EXTENSIONS = new Set([
7
+ '.png', '.jpg', '.jpeg', '.gif', '.pdf', '.zip', '.gz', '.sqlite', '.db', '.mov', '.mp4', '.a', '.o',
8
+ ]);
9
+ const SECRET_NAMES = /(^|\/)(\.env(?:\..*)?|id_rsa|id_ed25519|.*\.(?:pem|p12|key))$/i;
10
+ export async function listSafeTrackedFiles(projectRoot) {
11
+ const result = await runGit(projectRoot, ['ls-files']);
12
+ if (result.exitCode !== 0)
13
+ throw new Error('Unable to list tracked project files');
14
+ return splitGitLines(result.stdout).filter(isSafeTrackedPath);
15
+ }
16
+ export function isSafeTrackedPath(relativePath) {
17
+ const normalized = relativePath.replace(/\\/g, '/');
18
+ const segments = normalized.toLowerCase().split('/');
19
+ return !segments.some((segment) => EXCLUDED_SEGMENTS.has(segment))
20
+ && !BINARY_EXTENSIONS.has(extname(normalized).toLowerCase())
21
+ && !SECRET_NAMES.test(normalized);
22
+ }
23
+ //# sourceMappingURL=project-code-index-source.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"project-code-index-source.js","sourceRoot":"","sources":["../../src/storage/project-code-index-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM;CAC1F,CAAC,CAAC;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;CACrG,CAAC,CAAC;AACH,MAAM,YAAY,GAAG,gEAAgE,CAAC;AAEtF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB;IAC5D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACnF,OAAO,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;WAC7D,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;WACzD,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC"}
@@ -0,0 +1,6 @@
1
+ import type { ProblemSearchInput, ResolutionCandidateResponse } from '../core/resolution-search-types.js';
2
+ export declare function findResolutionCandidates(options: {
3
+ indexPath: string;
4
+ input: ProblemSearchInput;
5
+ limit?: number;
6
+ }): ResolutionCandidateResponse;
@@ -0,0 +1,94 @@
1
+ import { closeRulebookDatabase, openRulebookDatabase } from './sqlite.js';
2
+ import { fingerprintProblem, normalizeProblemInput, normalizeSearchText } from '../core/problem-fingerprint.js';
3
+ const STOP_TOKENS = new Set(['the', 'and', 'for', 'with', 'from', 'that', 'this', 'when', 'into', 'after', 'before', 'error', 'issue', 'problem']);
4
+ export function findResolutionCandidates(options) {
5
+ const input = normalizeProblemInput(options.input);
6
+ const fingerprint = fingerprintProblem(input);
7
+ const database = openRulebookDatabase({ databasePath: options.indexPath });
8
+ try {
9
+ const problems = database.prepare('SELECT id, title, observations, hypotheses FROM problems').all();
10
+ const solutions = database.prepare('SELECT * FROM solutions').all();
11
+ const sources = database.prepare('SELECT * FROM source_chunks').all();
12
+ const evidenceByProblem = new Map();
13
+ for (const problem of problems)
14
+ evidenceByProblem.set(problem.id, matchProblem(problem, input));
15
+ const candidates = [];
16
+ for (const solution of solutions) {
17
+ const evidence = [...(evidenceByProblem.get(solution.problem_id) ?? []), ...matchSolution(solution, input), ...matchSources(solution, sources, input)];
18
+ if (evidence.length === 0)
19
+ continue;
20
+ const deduped = deduplicateEvidence(evidence);
21
+ candidates.push({
22
+ problemId: solution.problem_id,
23
+ solutionId: solution.id,
24
+ solutionRevision: solution.revision,
25
+ title: solution.title,
26
+ fingerprint,
27
+ matchEvidence: deduped,
28
+ recallScore: deduped.reduce((sum, item) => sum + item.rawScore, 0),
29
+ });
30
+ }
31
+ candidates.sort((left, right) => right.recallScore - left.recallScore || left.solutionId.localeCompare(right.solutionId) || left.solutionRevision - right.solutionRevision);
32
+ return { fingerprint, candidates: candidates.slice(0, Math.max(1, Math.min(options.limit ?? 20, 50))) };
33
+ }
34
+ finally {
35
+ closeRulebookDatabase(database);
36
+ }
37
+ }
38
+ function matchProblem(row, input) {
39
+ const observations = JSON.parse(row.observations);
40
+ const hypotheses = JSON.parse(row.hypotheses);
41
+ return [
42
+ ...matchLists(input.observations.error_signatures ?? [], observations.error_signatures, 'error_signature', 'observations.error_signatures', 100, 'fact'),
43
+ ...matchLists(input.observations.symbols ?? [], observations.symbols, 'symbol', 'observations.symbols', 80, 'fact'),
44
+ ...matchLists(input.observations.operations ?? [], observations.operations, 'operation', 'observations.operations', 65, 'fact'),
45
+ ...matchLists(input.observations.symptoms, observations.symptoms, 'symptom', 'observations.symptoms', 55, 'fact'),
46
+ ...matchLists([input.observations.expected, input.observations.observed], [observations.expected, observations.observed], 'expected_observed', 'observations.expected_observed', 45, 'fact'),
47
+ ...matchLists([...(input.hypotheses?.suspected_causes ?? []), ...(input.hypotheses?.components ?? [])], [...hypotheses.suspected_causes, ...hypotheses.components], 'hypothesis', 'hypotheses', 15, 'hypothesis'),
48
+ ];
49
+ }
50
+ function matchSolution(row, input) {
51
+ const factTerms = [...input.observations.symptoms, ...(input.observations.operations ?? []), input.observations.expected, input.observations.observed];
52
+ return matchLists(factTerms, [row.title, row.cause, ...jsonStrings(row.inspections), ...jsonStrings(row.actions), ...jsonStrings(row.verification)], 'weak_lexical', 'solution', 5, 'low_signal', 'solution');
53
+ }
54
+ function matchSources(solution, sources, input) {
55
+ const locators = JSON.parse(solution.source_evidence);
56
+ const linked = sources.filter((source) => locators.some((locator) => locator.project_key === source.project_key && locator.relative_path === source.relative_path && locator.content_hash === source.content_hash));
57
+ const terms = [...(input.observations.symbols ?? []), ...(input.observations.error_signatures ?? [])];
58
+ return linked.flatMap((source) => matchLists(terms, [source.symbol ?? '', source.relative_path, source.content], 'source_code', `source:${source.handle}`, 60, 'fact', 'source_chunk'));
59
+ }
60
+ function matchLists(queries, targets, channel, field, score, confidence, source = 'problem') {
61
+ const normalizedTargets = targets.map(normalizeSearchText);
62
+ const matches = [];
63
+ for (const query of queries.map(normalizeSearchText).filter(Boolean)) {
64
+ const queryTokens = tokens(query);
65
+ for (const target of normalizedTargets) {
66
+ const exact = target === query;
67
+ const phrase = query.length >= 4 && (target.includes(query) || query.includes(target));
68
+ const overlap = queryTokens.filter((token) => target.includes(token));
69
+ if (!exact && !phrase && overlap.length < Math.min(2, queryTokens.length))
70
+ continue;
71
+ matches.push({ channel, field, matchedValue: query, source, confidence, rawScore: exact ? score : phrase ? Math.round(score * 0.8) : Math.round(score * 0.4) });
72
+ break;
73
+ }
74
+ }
75
+ return matches;
76
+ }
77
+ function tokens(value) {
78
+ return [...new Set((value.match(/[\p{L}\p{N}_]+/gu) ?? []).filter((token) => token.length > 2 && !STOP_TOKENS.has(token)))];
79
+ }
80
+ function jsonStrings(value) {
81
+ const parsed = JSON.parse(value);
82
+ return Array.isArray(parsed) ? parsed.filter((item) => typeof item === 'string') : [];
83
+ }
84
+ function deduplicateEvidence(evidence) {
85
+ const byKey = new Map();
86
+ for (const item of evidence) {
87
+ const key = `${item.channel}\0${item.field}\0${item.matchedValue}\0${item.source}`;
88
+ const existing = byKey.get(key);
89
+ if (existing === undefined || item.rawScore > existing.rawScore)
90
+ byKey.set(key, item);
91
+ }
92
+ return [...byKey.values()].sort((left, right) => right.rawScore - left.rawScore || left.channel.localeCompare(right.channel) || left.matchedValue.localeCompare(right.matchedValue));
93
+ }
94
+ //# sourceMappingURL=resolution-candidate-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolution-candidate-service.js","sourceRoot":"","sources":["../../src/storage/resolution-candidate-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import type { ResolutionDocument } from '../core/index.js';
2
+ import type { SourceChunkChecksumInput } from '../core/resolution-semantic-checksum.js';
3
+ export declare function commitResolutionDocuments(options: {
4
+ home: string;
5
+ documents: ResolutionDocument[];
6
+ rebuild?: (home: string, sourceChunks: SourceChunkChecksumInput[]) => Promise<unknown>;
7
+ }): Promise<{
8
+ status: "ok";
9
+ created: string[];
10
+ index: unknown;
11
+ }>;
@@ -0,0 +1,56 @@
1
+ import { access, readFile, rm } from 'node:fs/promises';
2
+ import { join } from 'node:path';
3
+ import { canonicalResolutionPath, parseResolutionYaml, writeCanonicalResolution } from '../core/index.js';
4
+ import { closeRulebookDatabase, openRulebookDatabase } from './sqlite.js';
5
+ import { rebuildResolutionIndex } from './resolution-indexer.js';
6
+ export async function commitResolutionDocuments(options) {
7
+ const created = [];
8
+ try {
9
+ for (const document of options.documents) {
10
+ const path = canonicalResolutionPath(options.home, document);
11
+ if (await exists(path)) {
12
+ const parsed = parseResolutionYaml(await readFile(path, 'utf8'), path);
13
+ if (parsed.success && JSON.stringify(parsed.document) === JSON.stringify(document))
14
+ continue;
15
+ throw new Error(`Immutable canonical target already exists: ${path}`);
16
+ }
17
+ created.push((await writeCanonicalResolution(options.home, document)).path);
18
+ }
19
+ const sourceChunks = readIndexedSourceChunks(options.home);
20
+ const index = options.rebuild === undefined
21
+ ? await rebuildResolutionIndex({ home: options.home, sourceChunks })
22
+ : await options.rebuild(options.home, sourceChunks);
23
+ return { status: 'ok', created, index };
24
+ }
25
+ catch (error) {
26
+ for (const path of created.reverse())
27
+ await rm(path, { force: true });
28
+ throw error;
29
+ }
30
+ }
31
+ function readIndexedSourceChunks(home) {
32
+ const indexPath = join(home, 'index/resolutions.sqlite');
33
+ try {
34
+ const database = openRulebookDatabase({ databasePath: indexPath });
35
+ try {
36
+ const rows = database.prepare('SELECT handle, project_key, revision, relative_path, symbol, content_hash, content FROM source_chunks').all();
37
+ return rows.map((row) => ({ handle: row.handle, projectKey: row.project_key, revision: row.revision, relativePath: row.relative_path, ...(row.symbol === null ? {} : { symbol: row.symbol }), contentHash: row.content_hash, content: row.content }));
38
+ }
39
+ finally {
40
+ closeRulebookDatabase(database);
41
+ }
42
+ }
43
+ catch {
44
+ return [];
45
+ }
46
+ }
47
+ async function exists(path) {
48
+ try {
49
+ await access(path);
50
+ return true;
51
+ }
52
+ catch {
53
+ return false;
54
+ }
55
+ }
56
+ //# sourceMappingURL=resolution-change-transaction.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolution-change-transaction.js","sourceRoot":"","sources":["../../src/storage/resolution-change-transaction.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,21 @@
1
+ export declare const RESOLUTION_HOME_DIRECTORIES: readonly ["problems", "solutions", "outcomes", "index", "logs"];
2
+ export declare const RESOLUTION_HOME_FILES: {
3
+ readonly 'config.yaml': "schema_version: 3\nlayout: resolution-memory\n";
4
+ readonly 'projects.local.yaml': "schema_version: 1\nprojects: {}\n";
5
+ readonly '.gitignore': string;
6
+ };
7
+ export declare const LEGACY_RESET_TARGETS: readonly ["rules", "index"];
8
+ export declare function createResolutionHome(home: string): Promise<void>;
9
+ export type LegacyResetPreview = {
10
+ home: string;
11
+ deletionTargets: string[];
12
+ rewritten: string[];
13
+ preserved: string[];
14
+ };
15
+ export declare function previewLegacyReset(home: string): Promise<LegacyResetPreview>;
16
+ export declare function executeLegacyReset(options: {
17
+ home: string;
18
+ expectedHome: string;
19
+ confirmation: string;
20
+ privateGitVerified: boolean;
21
+ }): Promise<LegacyResetPreview>;
@@ -0,0 +1,62 @@
1
+ import { access, mkdir, realpath, rm, writeFile } from 'node:fs/promises';
2
+ import { join } from 'node:path';
3
+ export const RESOLUTION_HOME_DIRECTORIES = ['problems', 'solutions', 'outcomes', 'index', 'logs'];
4
+ export const RESOLUTION_HOME_FILES = {
5
+ 'config.yaml': 'schema_version: 3\nlayout: resolution-memory\n',
6
+ 'projects.local.yaml': 'schema_version: 1\nprojects: {}\n',
7
+ '.gitignore': ['projects.local.yaml', 'index/', 'logs/', '*.lock', '*.tmp', ''].join('\n'),
8
+ };
9
+ export const LEGACY_RESET_TARGETS = ['rules', 'index'];
10
+ export async function createResolutionHome(home) {
11
+ await mkdir(home, { recursive: true });
12
+ for (const directory of RESOLUTION_HOME_DIRECTORIES)
13
+ await mkdir(join(home, directory), { recursive: true });
14
+ for (const [relativePath, content] of Object.entries(RESOLUTION_HOME_FILES)) {
15
+ if (!(await exists(join(home, relativePath)))) {
16
+ await writeFile(join(home, relativePath), content, { encoding: 'utf8', flag: 'wx' });
17
+ }
18
+ }
19
+ }
20
+ export async function previewLegacyReset(home) {
21
+ const resolvedHome = await realpath(home);
22
+ const deletionTargets = [];
23
+ for (const target of LEGACY_RESET_TARGETS) {
24
+ const absolutePath = join(resolvedHome, target);
25
+ if (await exists(absolutePath))
26
+ deletionTargets.push(absolutePath);
27
+ }
28
+ return {
29
+ home: resolvedHome,
30
+ deletionTargets,
31
+ rewritten: ['config.yaml', '.gitignore'].map((item) => join(resolvedHome, item)),
32
+ preserved: ['.git', 'projects.local.yaml', 'logs'].map((item) => join(resolvedHome, item)),
33
+ };
34
+ }
35
+ export async function executeLegacyReset(options) {
36
+ const preview = await previewLegacyReset(options.home);
37
+ const expectedHome = await realpath(options.expectedHome);
38
+ if (preview.home !== expectedHome) {
39
+ throw new Error('Resolved home does not match the exact reset target');
40
+ }
41
+ if (!options.privateGitVerified || !(await exists(join(preview.home, '.git')))) {
42
+ throw new Error('Reset requires a verified private Git worktree');
43
+ }
44
+ if (options.confirmation !== 'RESET LEGACY RULEBOOK')
45
+ throw new Error('Explicit reset confirmation is required');
46
+ for (const target of preview.deletionTargets)
47
+ await rm(target, { recursive: true, force: false });
48
+ await writeFile(join(preview.home, 'config.yaml'), RESOLUTION_HOME_FILES['config.yaml'], 'utf8');
49
+ await writeFile(join(preview.home, '.gitignore'), RESOLUTION_HOME_FILES['.gitignore'], 'utf8');
50
+ await createResolutionHome(preview.home);
51
+ return preview;
52
+ }
53
+ async function exists(path) {
54
+ try {
55
+ await access(path);
56
+ return true;
57
+ }
58
+ catch {
59
+ return false;
60
+ }
61
+ }
62
+ //# sourceMappingURL=resolution-home.js.map