agent-rulebook 0.1.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 (192) hide show
  1. package/LICENSE +4 -0
  2. package/README.md +66 -0
  3. package/dist/cli.d.ts +2 -0
  4. package/dist/cli.js +4 -0
  5. package/dist/cli.js.map +1 -0
  6. package/dist/commands/add.d.ts +2 -0
  7. package/dist/commands/add.js +134 -0
  8. package/dist/commands/add.js.map +1 -0
  9. package/dist/commands/index.d.ts +3 -0
  10. package/dist/commands/index.js +41 -0
  11. package/dist/commands/index.js.map +1 -0
  12. package/dist/commands/init.d.ts +2 -0
  13. package/dist/commands/init.js +17 -0
  14. package/dist/commands/init.js.map +1 -0
  15. package/dist/commands/mcp.d.ts +2 -0
  16. package/dist/commands/mcp.js +17 -0
  17. package/dist/commands/mcp.js.map +1 -0
  18. package/dist/commands/migrate.d.ts +2 -0
  19. package/dist/commands/migrate.js +73 -0
  20. package/dist/commands/migrate.js.map +1 -0
  21. package/dist/commands/output.d.ts +6 -0
  22. package/dist/commands/output.js +49 -0
  23. package/dist/commands/output.js.map +1 -0
  24. package/dist/commands/search.d.ts +2 -0
  25. package/dist/commands/search.js +57 -0
  26. package/dist/commands/search.js.map +1 -0
  27. package/dist/core/compatibility-matcher.d.ts +17 -0
  28. package/dist/core/compatibility-matcher.js +146 -0
  29. package/dist/core/compatibility-matcher.js.map +1 -0
  30. package/dist/core/dedup.d.ts +22 -0
  31. package/dist/core/dedup.js +54 -0
  32. package/dist/core/dedup.js.map +1 -0
  33. package/dist/core/error-signature.d.ts +15 -0
  34. package/dist/core/error-signature.js +59 -0
  35. package/dist/core/error-signature.js.map +1 -0
  36. package/dist/core/facets.d.ts +9 -0
  37. package/dist/core/facets.js +46 -0
  38. package/dist/core/facets.js.map +1 -0
  39. package/dist/core/index.d.ts +30 -0
  40. package/dist/core/index.js +16 -0
  41. package/dist/core/index.js.map +1 -0
  42. package/dist/core/lesson-importer.d.ts +22 -0
  43. package/dist/core/lesson-importer.js +94 -0
  44. package/dist/core/lesson-importer.js.map +1 -0
  45. package/dist/core/paths.d.ts +5 -0
  46. package/dist/core/paths.js +11 -0
  47. package/dist/core/paths.js.map +1 -0
  48. package/dist/core/project-environment-detector.d.ts +43 -0
  49. package/dist/core/project-environment-detector.js +464 -0
  50. package/dist/core/project-environment-detector.js.map +1 -0
  51. package/dist/core/ranker.d.ts +3 -0
  52. package/dist/core/ranker.js +47 -0
  53. package/dist/core/ranker.js.map +1 -0
  54. package/dist/core/redaction.d.ts +35 -0
  55. package/dist/core/redaction.js +149 -0
  56. package/dist/core/redaction.js.map +1 -0
  57. package/dist/core/rule-compatibility.d.ts +66 -0
  58. package/dist/core/rule-compatibility.js +53 -0
  59. package/dist/core/rule-compatibility.js.map +1 -0
  60. package/dist/core/rule-parser.d.ts +25 -0
  61. package/dist/core/rule-parser.js +81 -0
  62. package/dist/core/rule-parser.js.map +1 -0
  63. package/dist/core/rule-schema.d.ts +231 -0
  64. package/dist/core/rule-schema.js +184 -0
  65. package/dist/core/rule-schema.js.map +1 -0
  66. package/dist/core/rule-writer.d.ts +35 -0
  67. package/dist/core/rule-writer.js +63 -0
  68. package/dist/core/rule-writer.js.map +1 -0
  69. package/dist/core/search-types.d.ts +51 -0
  70. package/dist/core/search-types.js +2 -0
  71. package/dist/core/search-types.js.map +1 -0
  72. package/dist/core/slug.d.ts +13 -0
  73. package/dist/core/slug.js +42 -0
  74. package/dist/core/slug.js.map +1 -0
  75. package/dist/core/stack-detector.d.ts +56 -0
  76. package/dist/core/stack-detector.js +358 -0
  77. package/dist/core/stack-detector.js.map +1 -0
  78. package/dist/index.d.ts +5 -0
  79. package/dist/index.js +4 -0
  80. package/dist/index.js.map +1 -0
  81. package/dist/mcp/index.d.ts +7 -0
  82. package/dist/mcp/index.js +5 -0
  83. package/dist/mcp/index.js.map +1 -0
  84. package/dist/mcp/lesson-capture.d.ts +30 -0
  85. package/dist/mcp/lesson-capture.js +146 -0
  86. package/dist/mcp/lesson-capture.js.map +1 -0
  87. package/dist/mcp/rules-add-lesson-tool.d.ts +4 -0
  88. package/dist/mcp/rules-add-lesson-tool.js +73 -0
  89. package/dist/mcp/rules-add-lesson-tool.js.map +1 -0
  90. package/dist/mcp/rules-dedup-lesson-tool.d.ts +4 -0
  91. package/dist/mcp/rules-dedup-lesson-tool.js +69 -0
  92. package/dist/mcp/rules-dedup-lesson-tool.js.map +1 -0
  93. package/dist/mcp/rules-list-facets-tool.d.ts +3 -0
  94. package/dist/mcp/rules-list-facets-tool.js +31 -0
  95. package/dist/mcp/rules-list-facets-tool.js.map +1 -0
  96. package/dist/mcp/rules-prepare-lesson-tool.d.ts +4 -0
  97. package/dist/mcp/rules-prepare-lesson-tool.js +7 -0
  98. package/dist/mcp/rules-prepare-lesson-tool.js.map +1 -0
  99. package/dist/mcp/rules-search-error-tool.d.ts +4 -0
  100. package/dist/mcp/rules-search-error-tool.js +99 -0
  101. package/dist/mcp/rules-search-error-tool.js.map +1 -0
  102. package/dist/mcp/rules-search-for-project-tool.d.ts +4 -0
  103. package/dist/mcp/rules-search-for-project-tool.js +103 -0
  104. package/dist/mcp/rules-search-for-project-tool.js.map +1 -0
  105. package/dist/mcp/rules-search-tool.d.ts +7 -0
  106. package/dist/mcp/rules-search-tool.js +65 -0
  107. package/dist/mcp/rules-search-tool.js.map +1 -0
  108. package/dist/mcp/schemas.d.ts +222 -0
  109. package/dist/mcp/schemas.js +99 -0
  110. package/dist/mcp/schemas.js.map +1 -0
  111. package/dist/mcp/server.d.ts +5 -0
  112. package/dist/mcp/server.js +29 -0
  113. package/dist/mcp/server.js.map +1 -0
  114. package/dist/mcp/tool-output.d.ts +32 -0
  115. package/dist/mcp/tool-output.js +74 -0
  116. package/dist/mcp/tool-output.js.map +1 -0
  117. package/dist/mcp/tools.d.ts +300 -0
  118. package/dist/mcp/tools.js +123 -0
  119. package/dist/mcp/tools.js.map +1 -0
  120. package/dist/migration/adapters/fenced-lessons.d.ts +2 -0
  121. package/dist/migration/adapters/fenced-lessons.js +55 -0
  122. package/dist/migration/adapters/fenced-lessons.js.map +1 -0
  123. package/dist/migration/adapters/global-rules.d.ts +2 -0
  124. package/dist/migration/adapters/global-rules.js +72 -0
  125. package/dist/migration/adapters/global-rules.js.map +1 -0
  126. package/dist/migration/adapters/index.d.ts +2 -0
  127. package/dist/migration/adapters/index.js +13 -0
  128. package/dist/migration/adapters/index.js.map +1 -0
  129. package/dist/migration/adapters/markdown-lessons.d.ts +2 -0
  130. package/dist/migration/adapters/markdown-lessons.js +36 -0
  131. package/dist/migration/adapters/markdown-lessons.js.map +1 -0
  132. package/dist/migration/adapters/structured-lessons.d.ts +2 -0
  133. package/dist/migration/adapters/structured-lessons.js +8 -0
  134. package/dist/migration/adapters/structured-lessons.js.map +1 -0
  135. package/dist/migration/adapters/structured-shared.d.ts +3 -0
  136. package/dist/migration/adapters/structured-shared.js +97 -0
  137. package/dist/migration/adapters/structured-shared.js.map +1 -0
  138. package/dist/migration/applier.d.ts +32 -0
  139. package/dist/migration/applier.js +469 -0
  140. package/dist/migration/applier.js.map +1 -0
  141. package/dist/migration/index.d.ts +11 -0
  142. package/dist/migration/index.js +7 -0
  143. package/dist/migration/index.js.map +1 -0
  144. package/dist/migration/manifest.d.ts +262 -0
  145. package/dist/migration/manifest.js +89 -0
  146. package/dist/migration/manifest.js.map +1 -0
  147. package/dist/migration/migration-report.d.ts +147 -0
  148. package/dist/migration/migration-report.js +81 -0
  149. package/dist/migration/migration-report.js.map +1 -0
  150. package/dist/migration/scanner.d.ts +2 -0
  151. package/dist/migration/scanner.js +314 -0
  152. package/dist/migration/scanner.js.map +1 -0
  153. package/dist/migration/source-adapter.d.ts +37 -0
  154. package/dist/migration/source-adapter.js +2 -0
  155. package/dist/migration/source-adapter.js.map +1 -0
  156. package/dist/migration/verifier.d.ts +5 -0
  157. package/dist/migration/verifier.js +217 -0
  158. package/dist/migration/verifier.js.map +1 -0
  159. package/dist/program.d.ts +2 -0
  160. package/dist/program.js +21 -0
  161. package/dist/program.js.map +1 -0
  162. package/dist/storage/index-check.d.ts +19 -0
  163. package/dist/storage/index-check.js +114 -0
  164. package/dist/storage/index-check.js.map +1 -0
  165. package/dist/storage/index.d.ts +15 -0
  166. package/dist/storage/index.js +9 -0
  167. package/dist/storage/index.js.map +1 -0
  168. package/dist/storage/indexer.d.ts +19 -0
  169. package/dist/storage/indexer.js +354 -0
  170. package/dist/storage/indexer.js.map +1 -0
  171. package/dist/storage/migrations.d.ts +3 -0
  172. package/dist/storage/migrations.js +110 -0
  173. package/dist/storage/migrations.js.map +1 -0
  174. package/dist/storage/rule-discovery.d.ts +4 -0
  175. package/dist/storage/rule-discovery.js +34 -0
  176. package/dist/storage/rule-discovery.js.map +1 -0
  177. package/dist/storage/rule-store.d.ts +10 -0
  178. package/dist/storage/rule-store.js +12 -0
  179. package/dist/storage/rule-store.js.map +1 -0
  180. package/dist/storage/rulebook-home.d.ts +21 -0
  181. package/dist/storage/rulebook-home.js +75 -0
  182. package/dist/storage/rulebook-home.js.map +1 -0
  183. package/dist/storage/search-service.d.ts +17 -0
  184. package/dist/storage/search-service.js +252 -0
  185. package/dist/storage/search-service.js.map +1 -0
  186. package/dist/storage/sqlite-errors.d.ts +26 -0
  187. package/dist/storage/sqlite-errors.js +55 -0
  188. package/dist/storage/sqlite-errors.js.map +1 -0
  189. package/dist/storage/sqlite.d.ts +13 -0
  190. package/dist/storage/sqlite.js +34 -0
  191. package/dist/storage/sqlite.js.map +1 -0
  192. package/package.json +62 -0
@@ -0,0 +1,73 @@
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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules-add-lesson-tool.js","sourceRoot":"","sources":["../../src/mcp/rules-add-lesson-tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
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>;
@@ -0,0 +1,69 @@
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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules-dedup-lesson-tool.js","sourceRoot":"","sources":["../../src/mcp/rules-dedup-lesson-tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
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>;
@@ -0,0 +1,31 @@
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
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,4 @@
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>;
@@ -0,0 +1,7 @@
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
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,4 @@
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>;
@@ -0,0 +1,99 @@
1
+ import { existsSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { detectProjectEnvironment, detectProjectStack, extractErrorSignature } 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
+ if (!existsSync(indexPath)) {
23
+ return indexMissingToolResult({
24
+ indexPath,
25
+ queryText,
26
+ filters,
27
+ stackHints,
28
+ limit,
29
+ projectPath: stackContext.errorProjectPath,
30
+ });
31
+ }
32
+ const response = searchRules({
33
+ indexPath,
34
+ query: {
35
+ text: queryText,
36
+ filters,
37
+ limit: args.limit,
38
+ environment: environmentResult?.components,
39
+ },
40
+ limitPolicy: SEARCH_LIMIT_POLICIES.mcp,
41
+ });
42
+ if (response.results.length === 0) {
43
+ warnings.push(noResultsWarning(response.hint));
44
+ }
45
+ return jsonToolResult({
46
+ status: response.results.length > 0 ? 'ok' : 'no_results',
47
+ signature: signature.signature,
48
+ evidence_lines: signature.evidenceLines,
49
+ rules: toCompactRuleOutputs(response.results, queryText),
50
+ query_used: {
51
+ text: queryText,
52
+ filters,
53
+ },
54
+ applied: {
55
+ status: ['active'],
56
+ scope: args.project_path === undefined ? 'shared_and_project' : 'project_context',
57
+ environment: response.applied.environment,
58
+ },
59
+ diagnostics: response.diagnostics,
60
+ stack_hints: stackHints,
61
+ warnings,
62
+ limit,
63
+ });
64
+ }
65
+ function buildSearchErrorQueryText(signatureText, stackHints) {
66
+ return Array.from(new Set([signatureText, ...stackHints]))
67
+ .filter((term) => term.trim().length > 0)
68
+ .join(' ');
69
+ }
70
+ function buildSearchErrorStackContext(stackResult) {
71
+ if (stackResult?.status !== 'ok' && stackResult?.status !== 'no_stack') {
72
+ return {
73
+ filters: {},
74
+ stackHints: [],
75
+ warnings: stackResult?.status === 'error'
76
+ ? [
77
+ {
78
+ code: stackResult.code,
79
+ message: stackResult.message,
80
+ },
81
+ ]
82
+ : [],
83
+ errorProjectPath: stackResult?.status === 'error' ? stackResult.projectPath : undefined,
84
+ };
85
+ }
86
+ const filters = {};
87
+ if (stackResult.search.filters.language !== undefined) {
88
+ filters.language = stackResult.search.filters.language;
89
+ }
90
+ if (stackResult.search.filters.platforms.length > 0) {
91
+ filters.platforms = stackResult.search.filters.platforms;
92
+ }
93
+ return {
94
+ filters,
95
+ stackHints: stackResult.hints,
96
+ warnings: stackResult.warnings,
97
+ };
98
+ }
99
+ //# sourceMappingURL=rules-search-error-tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules-search-error-tool.js","sourceRoot":"","sources":["../../src/mcp/rules-search-error-tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
+ import type { McpSearchForProjectInput } from './schemas.js';
3
+ import type { AgentRulebookToolContext } from './tools.js';
4
+ export declare function handleRulesSearchForProject(args: McpSearchForProjectInput, context: AgentRulebookToolContext): Promise<CallToolResult>;
@@ -0,0 +1,103 @@
1
+ import { existsSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { detectProjectEnvironment, detectProjectStack } 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 handleRulesSearchForProject(args, context) {
8
+ const limit = resolveMcpLimit(args.limit);
9
+ const [stackResult, environmentResult] = await Promise.all([
10
+ detectProjectStack(args.project_path),
11
+ detectProjectEnvironment(args.project_path),
12
+ ]);
13
+ if (stackResult.status === 'error') {
14
+ return jsonToolResult({
15
+ status: 'error',
16
+ code: stackResult.code,
17
+ message: stackResult.message,
18
+ project_path: stackResult.projectPath,
19
+ rules: [],
20
+ query_used: {
21
+ text: args.task,
22
+ filters: {},
23
+ },
24
+ stack_hints: [],
25
+ warnings: [
26
+ {
27
+ code: stackResult.code,
28
+ message: stackResult.message,
29
+ },
30
+ ],
31
+ limit,
32
+ }, true);
33
+ }
34
+ const indexPath = join(context.rulebookHome, 'index/rulebook.sqlite');
35
+ const queryText = buildProjectSearchText(args.task, stackResult);
36
+ const filters = buildProjectSearchFilters(stackResult);
37
+ const stackHints = stackResult.hints;
38
+ if (!existsSync(indexPath)) {
39
+ return indexMissingToolResult({
40
+ indexPath,
41
+ queryText,
42
+ filters,
43
+ stackHints,
44
+ limit,
45
+ projectPath: stackResult.projectPath,
46
+ });
47
+ }
48
+ const response = searchRules({
49
+ indexPath,
50
+ query: {
51
+ text: queryText,
52
+ filters,
53
+ limit: args.limit,
54
+ environment: environmentResult.components,
55
+ },
56
+ limitPolicy: SEARCH_LIMIT_POLICIES.mcp,
57
+ });
58
+ const warnings = buildProjectWarnings(stackResult, response.hint, response.results.length);
59
+ return jsonToolResult({
60
+ status: response.results.length > 0 ? 'ok' : 'no_results',
61
+ project_path: stackResult.projectPath,
62
+ rules: toCompactRuleOutputs(response.results, queryText),
63
+ query_used: {
64
+ text: queryText,
65
+ filters,
66
+ },
67
+ applied: {
68
+ status: ['active'],
69
+ scope: 'project_context',
70
+ environment: response.applied.environment,
71
+ },
72
+ diagnostics: response.diagnostics,
73
+ stack_hints: stackHints,
74
+ warnings,
75
+ limit,
76
+ });
77
+ }
78
+ function buildProjectSearchText(task, stackResult) {
79
+ const terms = [task, ...stackResult.search.queryTerms];
80
+ return Array.from(new Set(terms.filter((term) => term.trim().length > 0))).join(' ');
81
+ }
82
+ function buildProjectSearchFilters(stackResult) {
83
+ const filters = {};
84
+ const stackFilters = stackResult.search.filters;
85
+ if (stackFilters.language !== undefined) {
86
+ filters.language = stackFilters.language;
87
+ }
88
+ if (stackFilters.platforms.length > 0) {
89
+ filters.platforms = stackFilters.platforms;
90
+ }
91
+ return filters;
92
+ }
93
+ function buildProjectWarnings(stackResult, searchHint, resultCount) {
94
+ const warnings = stackResult.warnings.map((warning) => ({
95
+ code: warning.code,
96
+ message: warning.message,
97
+ }));
98
+ if (resultCount === 0) {
99
+ warnings.push(noResultsWarning(searchHint));
100
+ }
101
+ return warnings;
102
+ }
103
+ //# sourceMappingURL=rules-search-for-project-tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules-search-for-project-tool.js","sourceRoot":"","sources":["../../src/mcp/rules-search-for-project-tool.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,7 @@
1
+ import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
2
+ import type { SearchFilters } from '../core/index.js';
3
+ import type { AgentRulebookToolContext } from './tools.js';
4
+ import type { McpSearchInput } from './schemas.js';
5
+ export declare function handleRulesSearch(args: McpSearchInput, context: AgentRulebookToolContext): Promise<CallToolResult>;
6
+ export declare function resolveMcpLimit(limit: number | undefined): number;
7
+ export declare function compactFilters(filters: McpSearchInput['filters']): SearchFilters;
@@ -0,0 +1,65 @@
1
+ import { existsSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { SEARCH_LIMIT_POLICIES, searchRules } from '../storage/index.js';
4
+ import { indexMissingToolResult, jsonToolResult, noResultsWarning, toCompactRuleOutputs, } from './tool-output.js';
5
+ export function handleRulesSearch(args, context) {
6
+ const indexPath = join(context.rulebookHome, 'index/rulebook.sqlite');
7
+ const limit = resolveMcpLimit(args.limit);
8
+ const filters = compactFilters(args.filters);
9
+ if (!existsSync(indexPath)) {
10
+ return Promise.resolve(indexMissingToolResult({
11
+ indexPath,
12
+ queryText: args.query,
13
+ filters,
14
+ stackHints: [],
15
+ limit,
16
+ }));
17
+ }
18
+ const response = searchRules({
19
+ indexPath,
20
+ query: {
21
+ text: args.query,
22
+ filters,
23
+ limit: args.limit,
24
+ },
25
+ limitPolicy: SEARCH_LIMIT_POLICIES.mcp,
26
+ });
27
+ const warnings = response.results.length === 0 ? [noResultsWarning(response.hint)] : [];
28
+ return Promise.resolve(jsonToolResult({
29
+ status: response.results.length > 0 ? 'ok' : 'no_results',
30
+ rules: toCompactRuleOutputs(response.results, args.query),
31
+ query_used: {
32
+ text: args.query,
33
+ filters,
34
+ },
35
+ applied: {
36
+ status: ['active'],
37
+ scope: 'shared_and_project',
38
+ environment: response.applied.environment,
39
+ },
40
+ diagnostics: response.diagnostics,
41
+ stack_hints: [],
42
+ warnings,
43
+ limit,
44
+ }));
45
+ }
46
+ export function resolveMcpLimit(limit) {
47
+ return limit ?? SEARCH_LIMIT_POLICIES.mcp.defaultLimit;
48
+ }
49
+ export function compactFilters(filters) {
50
+ const compact = {};
51
+ if (filters?.language !== undefined) {
52
+ compact.language = filters.language;
53
+ }
54
+ if (filters?.tools !== undefined && filters.tools.length > 0) {
55
+ compact.tools = filters.tools;
56
+ }
57
+ if (filters?.categories !== undefined && filters.categories.length > 0) {
58
+ compact.categories = filters.categories;
59
+ }
60
+ if (filters?.platforms !== undefined && filters.platforms.length > 0) {
61
+ compact.platforms = filters.platforms;
62
+ }
63
+ return compact;
64
+ }
65
+ //# sourceMappingURL=rules-search-tool.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules-search-tool.js","sourceRoot":"","sources":["../../src/mcp/rules-search-tool.ts"],"names":[],"mappings":"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"}