agent-rulebook 0.1.7 → 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 (287) hide show
  1. package/README.md +54 -143
  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 -33
  25. package/dist/core/index.js +18 -14
  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/capture-policy.d.ts +0 -6
  163. package/dist/core/capture-policy.js +0 -5
  164. package/dist/core/capture-policy.js.map +0 -1
  165. package/dist/core/compatibility-matcher.d.ts +0 -17
  166. package/dist/core/compatibility-matcher.js +0 -146
  167. package/dist/core/compatibility-matcher.js.map +0 -1
  168. package/dist/core/dedup.d.ts +0 -22
  169. package/dist/core/dedup.js +0 -54
  170. package/dist/core/dedup.js.map +0 -1
  171. package/dist/core/error-signature.d.ts +0 -15
  172. package/dist/core/error-signature.js +0 -59
  173. package/dist/core/error-signature.js.map +0 -1
  174. package/dist/core/facets.d.ts +0 -9
  175. package/dist/core/facets.js +0 -46
  176. package/dist/core/facets.js.map +0 -1
  177. package/dist/core/lesson-importer.d.ts +0 -22
  178. package/dist/core/lesson-importer.js +0 -94
  179. package/dist/core/lesson-importer.js.map +0 -1
  180. package/dist/core/ranker.d.ts +0 -3
  181. package/dist/core/ranker.js +0 -83
  182. package/dist/core/ranker.js.map +0 -1
  183. package/dist/core/rule-compatibility.d.ts +0 -66
  184. package/dist/core/rule-compatibility.js +0 -53
  185. package/dist/core/rule-compatibility.js.map +0 -1
  186. package/dist/core/rule-parser.d.ts +0 -25
  187. package/dist/core/rule-parser.js +0 -81
  188. package/dist/core/rule-parser.js.map +0 -1
  189. package/dist/core/rule-schema.d.ts +0 -283
  190. package/dist/core/rule-schema.js +0 -213
  191. package/dist/core/rule-schema.js.map +0 -1
  192. package/dist/core/rule-writer.d.ts +0 -35
  193. package/dist/core/rule-writer.js +0 -63
  194. package/dist/core/rule-writer.js.map +0 -1
  195. package/dist/core/search-types.d.ts +0 -57
  196. package/dist/core/search-types.js +0 -2
  197. package/dist/core/search-types.js.map +0 -1
  198. package/dist/core/semantic-checksum.d.ts +0 -6
  199. package/dist/core/semantic-checksum.js +0 -34
  200. package/dist/core/semantic-checksum.js.map +0 -1
  201. package/dist/core/slug.d.ts +0 -13
  202. package/dist/core/slug.js +0 -42
  203. package/dist/core/slug.js.map +0 -1
  204. package/dist/mcp/lesson-capture.d.ts +0 -30
  205. package/dist/mcp/lesson-capture.js +0 -148
  206. package/dist/mcp/lesson-capture.js.map +0 -1
  207. package/dist/mcp/rules-add-lesson-tool.d.ts +0 -4
  208. package/dist/mcp/rules-add-lesson-tool.js +0 -73
  209. package/dist/mcp/rules-add-lesson-tool.js.map +0 -1
  210. package/dist/mcp/rules-dedup-lesson-tool.d.ts +0 -4
  211. package/dist/mcp/rules-dedup-lesson-tool.js +0 -69
  212. package/dist/mcp/rules-dedup-lesson-tool.js.map +0 -1
  213. package/dist/mcp/rules-list-facets-tool.d.ts +0 -3
  214. package/dist/mcp/rules-list-facets-tool.js +0 -31
  215. package/dist/mcp/rules-list-facets-tool.js.map +0 -1
  216. package/dist/mcp/rules-prepare-lesson-tool.d.ts +0 -4
  217. package/dist/mcp/rules-prepare-lesson-tool.js +0 -7
  218. package/dist/mcp/rules-prepare-lesson-tool.js.map +0 -1
  219. package/dist/mcp/rules-search-error-tool.d.ts +0 -4
  220. package/dist/mcp/rules-search-error-tool.js +0 -103
  221. package/dist/mcp/rules-search-error-tool.js.map +0 -1
  222. package/dist/mcp/rules-search-for-project-tool.d.ts +0 -4
  223. package/dist/mcp/rules-search-for-project-tool.js +0 -105
  224. package/dist/mcp/rules-search-for-project-tool.js.map +0 -1
  225. package/dist/mcp/rules-search-tool.d.ts +0 -7
  226. package/dist/mcp/rules-search-tool.js +0 -65
  227. package/dist/mcp/rules-search-tool.js.map +0 -1
  228. package/dist/migration/adapters/fenced-lessons.d.ts +0 -2
  229. package/dist/migration/adapters/fenced-lessons.js +0 -55
  230. package/dist/migration/adapters/fenced-lessons.js.map +0 -1
  231. package/dist/migration/adapters/global-rules.d.ts +0 -2
  232. package/dist/migration/adapters/global-rules.js +0 -72
  233. package/dist/migration/adapters/global-rules.js.map +0 -1
  234. package/dist/migration/adapters/index.d.ts +0 -2
  235. package/dist/migration/adapters/index.js +0 -13
  236. package/dist/migration/adapters/index.js.map +0 -1
  237. package/dist/migration/adapters/markdown-lessons.d.ts +0 -2
  238. package/dist/migration/adapters/markdown-lessons.js +0 -36
  239. package/dist/migration/adapters/markdown-lessons.js.map +0 -1
  240. package/dist/migration/adapters/structured-lessons.d.ts +0 -2
  241. package/dist/migration/adapters/structured-lessons.js +0 -8
  242. package/dist/migration/adapters/structured-lessons.js.map +0 -1
  243. package/dist/migration/adapters/structured-shared.d.ts +0 -3
  244. package/dist/migration/adapters/structured-shared.js +0 -97
  245. package/dist/migration/adapters/structured-shared.js.map +0 -1
  246. package/dist/migration/applier.d.ts +0 -32
  247. package/dist/migration/applier.js +0 -559
  248. package/dist/migration/applier.js.map +0 -1
  249. package/dist/migration/index.d.ts +0 -11
  250. package/dist/migration/index.js +0 -7
  251. package/dist/migration/index.js.map +0 -1
  252. package/dist/migration/manifest.d.ts +0 -263
  253. package/dist/migration/manifest.js +0 -91
  254. package/dist/migration/manifest.js.map +0 -1
  255. package/dist/migration/migration-report.d.ts +0 -151
  256. package/dist/migration/migration-report.js +0 -85
  257. package/dist/migration/migration-report.js.map +0 -1
  258. package/dist/migration/scanner.d.ts +0 -2
  259. package/dist/migration/scanner.js +0 -312
  260. package/dist/migration/scanner.js.map +0 -1
  261. package/dist/migration/source-adapter.d.ts +0 -37
  262. package/dist/migration/source-adapter.js +0 -2
  263. package/dist/migration/source-adapter.js.map +0 -1
  264. package/dist/migration/verifier.d.ts +0 -5
  265. package/dist/migration/verifier.js +0 -218
  266. package/dist/migration/verifier.js.map +0 -1
  267. package/dist/storage/index-check.d.ts +0 -21
  268. package/dist/storage/index-check.js +0 -136
  269. package/dist/storage/index-check.js.map +0 -1
  270. package/dist/storage/indexer.d.ts +0 -19
  271. package/dist/storage/indexer.js +0 -367
  272. package/dist/storage/indexer.js.map +0 -1
  273. package/dist/storage/migrations.d.ts +0 -3
  274. package/dist/storage/migrations.js +0 -126
  275. package/dist/storage/migrations.js.map +0 -1
  276. package/dist/storage/rule-discovery.d.ts +0 -4
  277. package/dist/storage/rule-discovery.js +0 -34
  278. package/dist/storage/rule-discovery.js.map +0 -1
  279. package/dist/storage/rule-store.d.ts +0 -10
  280. package/dist/storage/rule-store.js +0 -12
  281. package/dist/storage/rule-store.js.map +0 -1
  282. package/dist/storage/rulebook-home.d.ts +0 -21
  283. package/dist/storage/rulebook-home.js +0 -78
  284. package/dist/storage/rulebook-home.js.map +0 -1
  285. package/dist/storage/search-service.d.ts +0 -17
  286. package/dist/storage/search-service.js +0 -275
  287. package/dist/storage/search-service.js.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"file":"search-types.js","sourceRoot":"","sources":["../../src/core/search-types.ts"],"names":[],"mappings":""}
@@ -1,6 +0,0 @@
1
- import type { LoadedRule } from './rule-schema.js';
2
- export type SemanticRuleSource = {
3
- path: string;
4
- rule: LoadedRule;
5
- };
6
- export declare function computeSemanticRuleChecksum(rulesDir: string, sources: SemanticRuleSource[]): string;
@@ -1,34 +0,0 @@
1
- import { createHash } from 'node:crypto';
2
- import { relative } from 'node:path';
3
- export function computeSemanticRuleChecksum(rulesDir, sources) {
4
- const normalized = sources
5
- .map((source) => ({
6
- path: relativeRulePath(rulesDir, source.path),
7
- rule: normalizeValue(source.rule),
8
- }))
9
- .sort((left, right) => left.path.localeCompare(right.path));
10
- const digest = createHash('sha256').update(JSON.stringify(normalized)).digest('hex');
11
- return `sha256:${digest}`;
12
- }
13
- function relativeRulePath(rulesDir, path) {
14
- const normalizedRoot = rulesDir.replaceAll('\\', '/').replace(/\/$/, '');
15
- const normalizedPath = path.replaceAll('\\', '/');
16
- const prefix = `${normalizedRoot}/`;
17
- if (normalizedPath.toLowerCase().startsWith(prefix.toLowerCase())) {
18
- return normalizedPath.slice(prefix.length);
19
- }
20
- return relative(rulesDir, path).replaceAll('\\', '/');
21
- }
22
- function normalizeValue(value) {
23
- if (Array.isArray(value)) {
24
- return value.map(normalizeValue);
25
- }
26
- if (value !== null && typeof value === 'object') {
27
- return Object.fromEntries(Object.entries(value)
28
- .filter(([, child]) => child !== undefined)
29
- .sort(([left], [right]) => left.localeCompare(right))
30
- .map(([key, child]) => [key, normalizeValue(child)]));
31
- }
32
- return value;
33
- }
34
- //# sourceMappingURL=semantic-checksum.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"semantic-checksum.js","sourceRoot":"","sources":["../../src/core/semantic-checksum.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAQrC,MAAM,UAAU,2BAA2B,CACzC,QAAgB,EAChB,OAA6B;IAE7B,MAAM,UAAU,GAAG,OAAO;SACvB,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAChB,IAAI,EAAE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC;QAC7C,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC;KAClC,CAAC,CAAC;SACF,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrF,OAAO,UAAU,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB,EAAE,IAAY;IACtD,MAAM,cAAc,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzE,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,GAAG,cAAc,GAAG,CAAC;IACpC,IAAI,cAAc,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QAClE,OAAO,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IACnC,CAAC;IACD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;aAC1C,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;aACpD,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CACvD,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
@@ -1,13 +0,0 @@
1
- import type { RuleLanguage } from './rule-schema.js';
2
- export type GenerateRuleIdentityOptions = {
3
- rulebookHome: string;
4
- title: string;
5
- language?: RuleLanguage;
6
- };
7
- export type GeneratedRuleIdentity = {
8
- id: string;
9
- slug: string;
10
- relativePath: string;
11
- };
12
- export declare function slugifyTitle(title: string): string;
13
- export declare function generateRuleIdentity(options: GenerateRuleIdentityOptions): Promise<GeneratedRuleIdentity>;
package/dist/core/slug.js DELETED
@@ -1,42 +0,0 @@
1
- import { access } from 'node:fs/promises';
2
- import { join } from 'node:path';
3
- const DEFAULT_RULE_LANGUAGE = 'other';
4
- export function slugifyTitle(title) {
5
- const slug = title
6
- .normalize('NFKD')
7
- .replace(/[\u0300-\u036f]/g, '')
8
- .toLowerCase()
9
- .replace(/[^a-z0-9]+/g, '-')
10
- .replace(/^-+|-+$/g, '')
11
- .slice(0, 80)
12
- .replace(/-+$/g, '');
13
- return slug.length > 0 ? slug : 'rule';
14
- }
15
- export async function generateRuleIdentity(options) {
16
- const language = options.language ?? DEFAULT_RULE_LANGUAGE;
17
- const slug = slugifyTitle(options.title);
18
- let suffix = 1;
19
- while (true) {
20
- const suffixText = suffix.toString().padStart(3, '0');
21
- const candidateSlug = suffix === 1 ? slug : `${slug}-${suffixText}`;
22
- const relativePath = `rules/${language}/${candidateSlug}.yaml`;
23
- if (!(await fileExists(join(options.rulebookHome, relativePath)))) {
24
- return {
25
- id: `${language}-${slug}-${suffixText}`,
26
- slug: candidateSlug,
27
- relativePath,
28
- };
29
- }
30
- suffix += 1;
31
- }
32
- }
33
- async function fileExists(filePath) {
34
- try {
35
- await access(filePath);
36
- return true;
37
- }
38
- catch {
39
- return false;
40
- }
41
- }
42
- //# sourceMappingURL=slug.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"slug.js","sourceRoot":"","sources":["../../src/core/slug.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAejC,MAAM,qBAAqB,GAAiB,OAAO,CAAC;AAEpD,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,MAAM,IAAI,GAAG,KAAK;SACf,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEvB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAoC;IAEpC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,qBAAqB,CAAC;IAC3D,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,MAAM,GAAG,CAAC,CAAC;IAEf,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,UAAU,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACtD,MAAM,aAAa,GAAG,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,UAAU,EAAE,CAAC;QACpE,MAAM,YAAY,GAAG,SAAS,QAAQ,IAAI,aAAa,OAAO,CAAC;QAE/D,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,OAAO;gBACL,EAAE,EAAE,GAAG,QAAQ,IAAI,IAAI,IAAI,UAAU,EAAE;gBACvC,IAAI,EAAE,aAAa;gBACnB,YAAY;aACb,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,CAAC,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
@@ -1,30 +0,0 @@
1
- import { type RuleV2 } from '../core/index.js';
2
- import type { AgentRulebookToolContext } from './tools.js';
3
- import type { McpPrepareLessonInput } from './schemas.js';
4
- export type PreparedLesson = {
5
- status: 'prepared' | 'blocked' | 'error';
6
- code?: string;
7
- eligible: boolean;
8
- dedup_result: 'duplicate' | 'related' | 'new';
9
- payload_hash: string;
10
- normalized_payload: NormalizedLessonPayload;
11
- warnings: Array<Record<string, unknown>>;
12
- candidates: Array<{
13
- id: string;
14
- title: string;
15
- reason: string;
16
- }>;
17
- };
18
- type NormalizedLessonPayload = Omit<McpPrepareLessonInput, 'platforms' | 'tools' | 'categories'> & {
19
- platforms: string[];
20
- tools: string[];
21
- categories: string[];
22
- };
23
- export declare function prepareLesson(input: McpPrepareLessonInput, context: AgentRulebookToolContext): Promise<PreparedLesson>;
24
- export declare function hashLessonPayload(payload: McpPrepareLessonInput): string;
25
- export declare function buildActiveLesson(input: McpPrepareLessonInput, context: AgentRulebookToolContext): Promise<{
26
- rule: RuleV2;
27
- relativePath: string;
28
- yaml: string;
29
- }>;
30
- export {};
@@ -1,148 +0,0 @@
1
- import { createHash } from 'node:crypto';
2
- import { access, readFile } from 'node:fs/promises';
3
- import { join } from 'node:path';
4
- import { stringify } from 'yaml';
5
- import { classifyLessonDeduplication, isCaptureCriteriaEligible, parseRuleYaml, RuleSchema, scanRuleDraftForRedactions, slugifyTitle, } from '../core/index.js';
6
- import { discoverRuleFiles, SEARCH_LIMIT_POLICIES, searchRules } from '../storage/index.js';
7
- export async function prepareLesson(input, context) {
8
- const normalized = normalizeLessonPayload(input);
9
- const payloadHash = hashLessonPayload(normalized);
10
- const indexPath = join(context.rulebookHome, 'index/rulebook.sqlite');
11
- const redaction = scanRuleDraftForRedactions(normalized);
12
- const warnings = redaction.warnings.map((warning) => ({ ...warning }));
13
- if (!(await pathExists(indexPath))) {
14
- return {
15
- status: 'error', code: 'index_missing', eligible: false, dedup_result: 'new',
16
- payload_hash: payloadHash, normalized_payload: normalized, warnings, candidates: [],
17
- };
18
- }
19
- const response = searchRules({
20
- indexPath,
21
- query: {
22
- text: [normalized.title, normalized.mistake, normalized.fix, ...normalized.tools, ...normalized.categories].join(' '),
23
- filters: {
24
- language: normalized.language,
25
- status: ['active', 'draft', 'deprecated', 'superseded'],
26
- },
27
- limit: SEARCH_LIMIT_POLICIES.mcp.maxLimit,
28
- },
29
- limitPolicy: SEARCH_LIMIT_POLICIES.mcp,
30
- });
31
- const dedup = classifyLessonDeduplication(normalized, response.results);
32
- const criteriaEligible = isCaptureCriteriaEligible(normalized.criteria);
33
- if (!criteriaEligible) {
34
- warnings.push({
35
- code: 'capture_criteria_low',
36
- message: 'Recurrence risk must be high and at least one capture cost must be high.',
37
- });
38
- }
39
- if (dedup.classification !== 'new')
40
- warnings.push({ code: `dedup_${dedup.classification}`, message: 'Only new lessons can be appended automatically.' });
41
- const eligible = criteriaEligible && redaction.can_save && dedup.classification === 'new';
42
- return {
43
- status: eligible ? 'prepared' : 'blocked',
44
- eligible,
45
- dedup_result: dedup.classification,
46
- payload_hash: payloadHash,
47
- normalized_payload: normalized,
48
- warnings,
49
- candidates: dedup.candidates,
50
- };
51
- }
52
- export function hashLessonPayload(payload) {
53
- return `sha256:${createHash('sha256').update(JSON.stringify(sortValue(payload))).digest('hex')}`;
54
- }
55
- export async function buildActiveLesson(input, context) {
56
- const slug = slugifyTitle(input.title);
57
- const directory = input.rule_scope === 'shared'
58
- ? 'rules/shared'
59
- : `rules/projects/${input.project_key}`;
60
- let suffix = 1;
61
- const existingIds = await readExistingRuleIds(context.rulebookHome);
62
- while (true) {
63
- const suffixText = suffix.toString().padStart(3, '0');
64
- const fileSlug = suffix === 1 ? slug : `${slug}-${suffixText}`;
65
- const relativePath = `${directory}/${fileSlug}.yaml`;
66
- const id = `${input.language}-${slug}-${suffixText}`;
67
- if (!(await pathExists(join(context.rulebookHome, relativePath))) && !existingIds.has(id)) {
68
- const now = new Date().toISOString().slice(0, 10);
69
- const candidate = {
70
- schema_version: 2,
71
- id,
72
- title: input.title,
73
- summary: input.summary ?? input.title,
74
- mistake: input.mistake,
75
- fix: input.fix,
76
- confidence: 'high',
77
- status: 'active',
78
- created_at: now,
79
- language: input.language,
80
- platforms: input.platforms ?? [],
81
- tools: input.tools ?? [],
82
- categories: input.categories ?? [],
83
- trigger: [],
84
- anti_conditions: [],
85
- rule_scope: input.rule_scope,
86
- ...(input.project_key === undefined ? {} : { project_key: input.project_key }),
87
- ...(input.source_project === undefined ? {} : { source_project: input.source_project }),
88
- compatibility: input.compatibility,
89
- provenance: { imported: false },
90
- activation: {
91
- basis: 'tdd_verified',
92
- capture_mode: 'tdd_auto',
93
- criteria: input.criteria,
94
- dedup_result: 'new',
95
- verification: input.verification,
96
- },
97
- };
98
- const rule = RuleSchema.parse(candidate);
99
- return { rule, relativePath, yaml: stringify(rule), };
100
- }
101
- suffix += 1;
102
- }
103
- }
104
- function normalizeLessonPayload(input) {
105
- return {
106
- title: input.title.trim(),
107
- ...(input.summary === undefined ? {} : { summary: input.summary.trim() }),
108
- language: input.language,
109
- platforms: [...(input.platforms ?? [])],
110
- tools: [...(input.tools ?? [])],
111
- categories: [...(input.categories ?? [])],
112
- mistake: input.mistake.trim(),
113
- fix: input.fix.trim(),
114
- ...(input.source_project === undefined ? {} : { source_project: input.source_project.trim() }),
115
- rule_scope: input.rule_scope,
116
- ...(input.project_key === undefined ? {} : { project_key: input.project_key }),
117
- compatibility: input.compatibility,
118
- criteria: input.criteria,
119
- verification: { ...input.verification, evidence: input.verification.evidence.trim() },
120
- };
121
- }
122
- function sortValue(value) {
123
- if (Array.isArray(value))
124
- return value.map(sortValue);
125
- if (typeof value !== 'object' || value === null)
126
- return value;
127
- return Object.fromEntries(Object.entries(value).sort(([left], [right]) => left.localeCompare(right)).map(([key, item]) => [key, sortValue(item)]));
128
- }
129
- async function pathExists(path) {
130
- try {
131
- await access(path);
132
- return true;
133
- }
134
- catch {
135
- return false;
136
- }
137
- }
138
- async function readExistingRuleIds(rulebookHome) {
139
- const ids = new Set();
140
- const files = await discoverRuleFiles({ rulesDir: join(rulebookHome, 'rules') });
141
- for (const file of files) {
142
- const parsed = parseRuleYaml(await readFile(file, 'utf8'), { filePath: file });
143
- if (parsed.success)
144
- ids.add(parsed.rule.id);
145
- }
146
- return ids;
147
- }
148
- //# sourceMappingURL=lesson-capture.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"lesson-capture.js","sourceRoot":"","sources":["../../src/mcp/lesson-capture.ts"],"names":[],"mappings":"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"}
@@ -1,4 +0,0 @@
1
- import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
- import type { McpAddLessonInput } from './schemas.js';
3
- import type { AgentRulebookToolContext } from './tools.js';
4
- export declare function handleRulesAddLesson(args: McpAddLessonInput, context: AgentRulebookToolContext): Promise<CallToolResult>;
@@ -1,73 +0,0 @@
1
- import { rebuildRulebookIndex, saveRulePreview } from '../storage/index.js';
2
- import { buildActiveLesson, prepareLesson } from './lesson-capture.js';
3
- import { jsonToolResult } from './tool-output.js';
4
- export async function handleRulesAddLesson(args, context) {
5
- const { payload_hash: suppliedHash, ...payload } = args;
6
- const prepared = await prepareLesson(payload, context);
7
- if (prepared.payload_hash !== suppliedHash) {
8
- return jsonToolResult({
9
- status: 'blocked',
10
- code: 'payload_hash_mismatch',
11
- message: 'The submitted payload does not match the prepared lesson hash.',
12
- }, true);
13
- }
14
- if (!prepared.eligible) {
15
- return jsonToolResult({
16
- ...prepared,
17
- status: 'blocked',
18
- code: prepared.code ?? `lesson_${prepared.dedup_result}`,
19
- }, true);
20
- }
21
- try {
22
- const active = await buildActiveLesson(payload, context);
23
- const saved = await saveRulePreview({
24
- rulebookHome: context.rulebookHome,
25
- preview: {
26
- id: active.rule.id,
27
- relativePath: active.relativePath,
28
- yaml: active.yaml,
29
- requires_confirmation: false,
30
- can_save: true,
31
- warnings: [],
32
- suggested_redactions: [],
33
- },
34
- });
35
- const index = await rebuildRulebookIndex({ home: context.rulebookHome });
36
- return jsonToolResult({
37
- status: 'saved',
38
- id: active.rule.id,
39
- lifecycle: {
40
- status: active.rule.status,
41
- activation_basis: active.rule.activation.basis,
42
- capture_mode: active.rule.activation.capture_mode,
43
- },
44
- scope: {
45
- rule_scope: active.rule.rule_scope,
46
- ...(active.rule.project_key === undefined ? {} : { project_key: active.rule.project_key }),
47
- },
48
- saved,
49
- index,
50
- });
51
- }
52
- catch (error) {
53
- const code = mapWriteError(error);
54
- return jsonToolResult({
55
- status: 'error',
56
- code,
57
- message: error instanceof Error ? error.message : 'Lesson append failed.',
58
- }, true);
59
- }
60
- }
61
- function mapWriteError(error) {
62
- const candidate = error;
63
- if (candidate.code === 'EEXIST')
64
- return 'rule_already_exists';
65
- if (candidate.name === 'RulebookIndexLockTimeoutError')
66
- return 'index_lock_timeout';
67
- if (candidate.name === 'RulebookIndexMigrationError')
68
- return 'index_migration_failed';
69
- if (candidate.name === 'RulebookIndexCorruptError')
70
- return 'index_corrupt';
71
- return 'lesson_write_failed';
72
- }
73
- //# sourceMappingURL=rules-add-lesson-tool.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"rules-add-lesson-tool.js","sourceRoot":"","sources":["../../src/mcp/rules-add-lesson-tool.ts"],"names":[],"mappings":"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"}
@@ -1,4 +0,0 @@
1
- import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
- import type { McpDedupLessonInput } from './schemas.js';
3
- import type { AgentRulebookToolContext } from './tools.js';
4
- export declare function handleRulesDedupLesson(args: McpDedupLessonInput, context: AgentRulebookToolContext): Promise<CallToolResult>;
@@ -1,69 +0,0 @@
1
- import { existsSync } from 'node:fs';
2
- import { join } from 'node:path';
3
- import { classifyLessonDeduplication } from '../core/index.js';
4
- import { SEARCH_LIMIT_POLICIES, searchRules } from '../storage/index.js';
5
- import { resolveMcpLimit } from './rules-search-tool.js';
6
- import { indexMissingToolResult, jsonToolResult } from './tool-output.js';
7
- export function handleRulesDedupLesson(args, context) {
8
- const indexPath = join(context.rulebookHome, 'index/rulebook.sqlite');
9
- const limit = resolveMcpLimit(undefined);
10
- const queryText = buildDedupQueryText(args);
11
- const filters = buildDedupFilters(args);
12
- if (!existsSync(indexPath)) {
13
- return Promise.resolve(indexMissingToolResult({
14
- indexPath,
15
- queryText,
16
- filters,
17
- stackHints: [],
18
- limit,
19
- }));
20
- }
21
- const response = searchRules({
22
- indexPath,
23
- query: {
24
- text: queryText,
25
- filters,
26
- limit: SEARCH_LIMIT_POLICIES.mcp.maxLimit,
27
- },
28
- limitPolicy: SEARCH_LIMIT_POLICIES.mcp,
29
- });
30
- const dedup = classifyLessonDeduplication({
31
- title: args.title,
32
- mistake: args.mistake,
33
- fix: args.fix,
34
- language: args.language,
35
- tools: args.tools ?? [],
36
- categories: args.categories ?? [],
37
- }, response.results);
38
- return Promise.resolve(jsonToolResult({
39
- status: 'ok',
40
- classification: dedup.classification,
41
- confidence: dedup.confidence,
42
- candidates: dedup.candidates,
43
- query_used: {
44
- text: queryText,
45
- filters,
46
- },
47
- warnings: [],
48
- limit,
49
- }));
50
- }
51
- function buildDedupQueryText(args) {
52
- return [args.title, args.mistake, args.fix, ...(args.tools ?? []), ...(args.categories ?? [])]
53
- .filter((item) => item.trim().length > 0)
54
- .join(' ');
55
- }
56
- function buildDedupFilters(args) {
57
- const filters = {
58
- status: ['active', 'draft', 'deprecated', 'superseded'],
59
- };
60
- filters.language = args.language;
61
- if (args.tools !== undefined && args.tools.length > 0) {
62
- filters.tools = args.tools;
63
- }
64
- if (args.categories !== undefined && args.categories.length > 0) {
65
- filters.categories = args.categories;
66
- }
67
- return filters;
68
- }
69
- //# sourceMappingURL=rules-dedup-lesson-tool.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"rules-dedup-lesson-tool.js","sourceRoot":"","sources":["../../src/mcp/rules-dedup-lesson-tool.ts"],"names":[],"mappings":"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"}
@@ -1,3 +0,0 @@
1
- import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
- import type { AgentRulebookToolContext } from './tools.js';
3
- export declare function handleRulesListFacets(_args: Record<string, never>, context: AgentRulebookToolContext): Promise<CallToolResult>;
@@ -1,31 +0,0 @@
1
- import { readFile } from 'node:fs/promises';
2
- import { join } from 'node:path';
3
- import { FACET_ALIASES, listCanonicalFacetValues, parseRuleYaml, } from '../core/index.js';
4
- import { discoverRuleFiles } from '../storage/index.js';
5
- import { jsonToolResult } from './tool-output.js';
6
- export async function handleRulesListFacets(_args, context) {
7
- const values = listCanonicalFacetValues();
8
- const counts = new Map();
9
- const files = await discoverRuleFiles({ rulesDir: join(context.rulebookHome, 'rules') });
10
- for (const file of files) {
11
- const parsed = parseRuleYaml(await readFile(file, 'utf8'), { filePath: file });
12
- if (!parsed.success)
13
- continue;
14
- increment(counts, 'language', parsed.rule.language === undefined ? [] : [parsed.rule.language]);
15
- increment(counts, 'platforms', parsed.rule.platforms);
16
- increment(counts, 'tools', parsed.rule.tools);
17
- increment(counts, 'categories', parsed.rule.categories);
18
- }
19
- const facets = Object.fromEntries(Object.keys(values).map((kind) => [
20
- kind,
21
- values[kind].map((value) => ({ value, count: counts.get(`${kind}:${value}`) ?? 0 })),
22
- ]));
23
- return jsonToolResult({ status: 'ok', aliases: FACET_ALIASES, facets });
24
- }
25
- function increment(counts, kind, values) {
26
- for (const value of new Set(values)) {
27
- const key = `${kind}:${value}`;
28
- counts.set(key, (counts.get(key) ?? 0) + 1);
29
- }
30
- }
31
- //# sourceMappingURL=rules-list-facets-tool.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"rules-list-facets-tool.js","sourceRoot":"","sources":["../../src/mcp/rules-list-facets-tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,aAAa,GAEd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,KAA4B,EAC5B,OAAiC;IAEjC,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAEzF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,SAAS;QAC9B,SAAS,CAAC,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QAChG,SAAS,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtD,SAAS,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9C,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAC9B,MAAM,CAAC,IAAI,CAAC,MAAM,CAA0B,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC1D,IAAI;QACJ,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;KACrF,CAAC,CACH,CAAC;IAEF,OAAO,cAAc,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,SAAS,CAAC,MAA2B,EAAE,IAAwB,EAAE,MAAgB;IACxF,KAAK,MAAM,KAAK,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC"}
@@ -1,4 +0,0 @@
1
- import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
- import type { McpPrepareLessonInput } from './schemas.js';
3
- import type { AgentRulebookToolContext } from './tools.js';
4
- export declare function handleRulesPrepareLesson(args: McpPrepareLessonInput, context: AgentRulebookToolContext): Promise<CallToolResult>;
@@ -1,7 +0,0 @@
1
- import { prepareLesson } from './lesson-capture.js';
2
- import { jsonToolResult } from './tool-output.js';
3
- export async function handleRulesPrepareLesson(args, context) {
4
- const result = await prepareLesson(args, context);
5
- return jsonToolResult(result, result.status === 'error');
6
- }
7
- //# sourceMappingURL=rules-prepare-lesson-tool.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"rules-prepare-lesson-tool.js","sourceRoot":"","sources":["../../src/mcp/rules-prepare-lesson-tool.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlD,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,IAA2B,EAC3B,OAAiC;IAEjC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAClD,OAAO,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC;AAC3D,CAAC"}
@@ -1,4 +0,0 @@
1
- import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
- import type { McpSearchErrorInput } from './schemas.js';
3
- import type { AgentRulebookToolContext } from './tools.js';
4
- export declare function handleRulesSearchError(args: McpSearchErrorInput, context: AgentRulebookToolContext): Promise<CallToolResult>;
@@ -1,103 +0,0 @@
1
- import { existsSync } from 'node:fs';
2
- import { join } from 'node:path';
3
- import { detectProjectEnvironment, detectProjectStack, extractErrorSignature, resolveProjectKey, } from '../core/index.js';
4
- import { SEARCH_LIMIT_POLICIES, searchRules } from '../storage/index.js';
5
- import { resolveMcpLimit } from './rules-search-tool.js';
6
- import { indexMissingToolResult, jsonToolResult, noResultsWarning, toCompactRuleOutputs, } from './tool-output.js';
7
- export async function handleRulesSearchError(args, context) {
8
- const limit = resolveMcpLimit(args.limit);
9
- const indexPath = join(context.rulebookHome, 'index/rulebook.sqlite');
10
- const signature = extractErrorSignature(args.error_log);
11
- const [stackResult, environmentResult] = args.project_path === undefined
12
- ? [undefined, undefined]
13
- : await Promise.all([
14
- detectProjectStack(args.project_path),
15
- detectProjectEnvironment(args.project_path),
16
- ]);
17
- const stackContext = buildSearchErrorStackContext(stackResult);
18
- const filters = stackContext.filters;
19
- const stackHints = stackContext.stackHints;
20
- const queryText = buildSearchErrorQueryText(signature.queryText, stackHints);
21
- const warnings = [...signature.warnings, ...stackContext.warnings];
22
- const projectKey = args.project_path === undefined
23
- ? undefined
24
- : await resolveProjectKey(args.project_path);
25
- if (!existsSync(indexPath)) {
26
- return indexMissingToolResult({
27
- indexPath,
28
- queryText,
29
- filters,
30
- stackHints,
31
- limit,
32
- projectPath: stackContext.errorProjectPath,
33
- });
34
- }
35
- const response = searchRules({
36
- indexPath,
37
- query: {
38
- text: queryText,
39
- filters,
40
- limit: args.limit,
41
- environment: environmentResult?.components,
42
- ...(projectKey === undefined ? {} : { projectKey }),
43
- },
44
- limitPolicy: SEARCH_LIMIT_POLICIES.mcp,
45
- });
46
- if (response.results.length === 0) {
47
- warnings.push(noResultsWarning(response.hint));
48
- }
49
- return jsonToolResult({
50
- status: response.results.length > 0 ? 'ok' : 'no_results',
51
- signature: signature.signature,
52
- evidence_lines: signature.evidenceLines,
53
- rules: toCompactRuleOutputs(response.results, queryText),
54
- query_used: {
55
- text: queryText,
56
- filters,
57
- },
58
- applied: {
59
- status: ['active'],
60
- scope: args.project_path === undefined ? 'shared_and_project' : 'project_context',
61
- environment: response.applied.environment,
62
- },
63
- diagnostics: response.diagnostics,
64
- stack_hints: stackHints,
65
- warnings,
66
- limit,
67
- });
68
- }
69
- function buildSearchErrorQueryText(signatureText, stackHints) {
70
- return Array.from(new Set([signatureText, ...stackHints]))
71
- .filter((term) => term.trim().length > 0)
72
- .join(' ');
73
- }
74
- function buildSearchErrorStackContext(stackResult) {
75
- if (stackResult?.status !== 'ok' && stackResult?.status !== 'no_stack') {
76
- return {
77
- filters: {},
78
- stackHints: [],
79
- warnings: stackResult?.status === 'error'
80
- ? [
81
- {
82
- code: stackResult.code,
83
- message: stackResult.message,
84
- },
85
- ]
86
- : [],
87
- errorProjectPath: stackResult?.status === 'error' ? stackResult.projectPath : undefined,
88
- };
89
- }
90
- const filters = {};
91
- if (stackResult.search.filters.language !== undefined) {
92
- filters.language = stackResult.search.filters.language;
93
- }
94
- if (stackResult.search.filters.platforms.length > 0) {
95
- filters.platforms = stackResult.search.filters.platforms;
96
- }
97
- return {
98
- filters,
99
- stackHints: stackResult.hints,
100
- warnings: stackResult.warnings,
101
- };
102
- }
103
- //# sourceMappingURL=rules-search-error-tool.js.map