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
package/LICENSE ADDED
@@ -0,0 +1,4 @@
1
+ Copyright (c) 2026 Youngki Kang. All rights reserved.
2
+
3
+ This software is not licensed for redistribution or modification. No license
4
+ is granted except as required to download and execute an authorized copy.
package/README.md ADDED
@@ -0,0 +1,66 @@
1
+ # Agent Rulebook
2
+
3
+ TypeScript CLI and MCP foundation for managing reusable agent rules.
4
+
5
+ ## Requirements
6
+
7
+ The `0.1.0` release candidate supports Node.js 20 and 22 through 26. Node.js 21
8
+ is excluded because the pinned `better-sqlite3@12.11.1` native runtime does not
9
+ declare support for it. The local artifact matrix currently covers Node 26 on
10
+ Darwin arm64; Windows x64 remains a release gate before promotion to `latest`.
11
+
12
+ Agent Rulebook keeps rule YAML and its rebuildable SQLite index outside the npm
13
+ package in `~/.agent-rulebook` by default. Reinstalling the package or clearing
14
+ the npm cache must not remove that data.
15
+
16
+ ## Run the CLI
17
+
18
+ After the exact candidate is published, run it without a global install:
19
+
20
+ ```bash
21
+ npx -y agent-rulebook@0.1.0 --help
22
+ npx -y agent-rulebook@0.1.0 mcp
23
+ ```
24
+
25
+ `agent-rulebook@0.1.0` is currently a local release candidate, not a published
26
+ registry version. The actual `next` publish is a separate release step.
27
+
28
+ ## Documentation
29
+
30
+ - [Codex adapter setup](docs/adapters/codex.md)
31
+
32
+ ## Development
33
+
34
+ ```bash
35
+ npm run typecheck
36
+ npm test
37
+ npm run build
38
+ node dist/cli.js --help
39
+ ```
40
+
41
+ Verify the publish artifact without writing to the registry:
42
+
43
+ ```bash
44
+ npm run release:verify
45
+ npm pack --dry-run
46
+ npm run check:package
47
+ npm run smoke:package
48
+ ```
49
+
50
+ The packed smoke creates an empty custom npm cache, installs the local tarball,
51
+ runs CLI/init/native SQLite/MCP acceptance, then repeats from the warm cache in
52
+ a second isolated install. All package and rulebook homes are temporary.
53
+
54
+ The project uses `better-sqlite3` for the local SQLite store because the MVP
55
+ needs synchronous, embedded persistence with a small API surface. It is a native
56
+ dependency. Install or startup diagnostics include the exact Node version,
57
+ platform, and architecture so unsupported native combinations can be reported.
58
+
59
+ ## Release status
60
+
61
+ The candidate version is `0.1.0`, the package is explicitly `UNLICENSED`, and
62
+ no public repository, homepage, or issue tracker is currently advertised because
63
+ the source remote is not publicly accessible. The unscoped package name returned
64
+ `E404` on 2026-08-19, but availability must be checked again immediately before
65
+ publish; use an owned npm scope if it has been claimed. No publish or dist-tag
66
+ operation is performed by the local verification scripts.
package/dist/cli.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
package/dist/cli.js ADDED
@@ -0,0 +1,4 @@
1
+ #!/usr/bin/env node
2
+ import { createCliProgram } from './program.js';
3
+ createCliProgram().parse(process.argv);
4
+ //# sourceMappingURL=cli.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,gBAAgB,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerAddCommand(program: Command): Command;
@@ -0,0 +1,134 @@
1
+ import { readFile } from 'node:fs/promises';
2
+ import { RuleLanguageSchema, buildRulePreview, extractLessonCandidatesFromMarkdown, resolveRulebookHome, } from '../core/index.js';
3
+ import { rebuildRulebookIndex, saveRulePreview } from '../storage/index.js';
4
+ import { writeJson } from './output.js';
5
+ export function registerAddCommand(program) {
6
+ program
7
+ .command('add')
8
+ .description('Add a rule to the local Agent Rulebook')
9
+ .option('--title <title>', 'Rule title')
10
+ .option('--language <language>', 'Rule language')
11
+ .option('--tool <tool>', 'Rule tool tag', collectOption, [])
12
+ .option('--category <category>', 'Rule category tag', collectOption, [])
13
+ .option('--mistake <mistake>', 'Mistake to avoid')
14
+ .option('--fix <fix>', 'Recommended fix')
15
+ .option('--source-project <sourceProject>', 'Source project name')
16
+ .option('--from-file <path>', 'Import preview candidates from a markdown lessons file')
17
+ .option('--yes', 'Save without interactive confirmation')
18
+ .option('--json', 'Print JSON output')
19
+ .action(async (options) => {
20
+ const home = resolveRulebookHome();
21
+ const language = parseLanguageOption(options.language);
22
+ if (language.kind === 'invalid') {
23
+ process.stderr.write(`Invalid language: ${options.language}\n`);
24
+ process.exitCode = 1;
25
+ return;
26
+ }
27
+ if (options.fromFile !== undefined) {
28
+ await previewFromFile(options.fromFile, options, language.value);
29
+ return;
30
+ }
31
+ await addFromFlags(home, options, language.value);
32
+ });
33
+ return program;
34
+ }
35
+ async function previewFromFile(filePath, options, language) {
36
+ const source = await readFile(filePath, 'utf8');
37
+ const result = extractLessonCandidatesFromMarkdown(source, {
38
+ defaultLanguage: language,
39
+ sourceProject: options.sourceProject,
40
+ });
41
+ const output = {
42
+ status: 'preview',
43
+ ...result,
44
+ };
45
+ if (options.json === true) {
46
+ writeJson(output);
47
+ return;
48
+ }
49
+ for (const candidate of output.candidates) {
50
+ process.stdout.write(`title\t${candidate.title}\n`);
51
+ process.stdout.write(`mistake\t${candidate.mistake}\n`);
52
+ process.stdout.write(`fix\t${candidate.fix}\n\n`);
53
+ }
54
+ }
55
+ async function addFromFlags(home, options, language) {
56
+ const missing = collectMissingFields(options, language);
57
+ if (missing.length > 0) {
58
+ process.stderr.write(`Missing required fields: ${missing.join(', ')}\n`);
59
+ process.exitCode = 1;
60
+ return;
61
+ }
62
+ const draft = {
63
+ title: options.title?.trim() ?? '',
64
+ language,
65
+ tools: options.tool,
66
+ categories: options.category,
67
+ mistake: options.mistake?.trim() ?? '',
68
+ fix: options.fix?.trim() ?? '',
69
+ };
70
+ if (options.sourceProject !== undefined) {
71
+ draft.source_project = options.sourceProject;
72
+ }
73
+ const preview = await buildRulePreview(draft, { rulebookHome: home });
74
+ if (options.yes !== true) {
75
+ process.stdout.write(preview.yaml);
76
+ process.stderr.write('Review the YAML preview and rerun with --yes to save.\n');
77
+ process.exitCode = 1;
78
+ return;
79
+ }
80
+ if (!preview.can_save) {
81
+ process.stdout.write(preview.yaml);
82
+ process.stderr.write(formatRedactionBlockMessage(preview.warnings));
83
+ process.exitCode = 1;
84
+ return;
85
+ }
86
+ await saveRulePreview({ rulebookHome: home, preview });
87
+ const index = await rebuildRulebookIndex({ home });
88
+ const output = {
89
+ status: 'saved',
90
+ id: preview.id,
91
+ relativePath: preview.relativePath,
92
+ preview,
93
+ index,
94
+ };
95
+ if (options.json === true) {
96
+ writeJson(output);
97
+ return;
98
+ }
99
+ process.stdout.write(`saved\t${preview.relativePath}\n`);
100
+ process.stdout.write(`indexed\t${index.indexedCount}\n`);
101
+ }
102
+ function collectMissingFields(options, language) {
103
+ const missing = [];
104
+ if (options.title === undefined || options.title.trim().length === 0) {
105
+ missing.push('title');
106
+ }
107
+ if (language === undefined) {
108
+ missing.push('language');
109
+ }
110
+ if (options.mistake === undefined || options.mistake.trim().length === 0) {
111
+ missing.push('mistake');
112
+ }
113
+ if (options.fix === undefined || options.fix.trim().length === 0) {
114
+ missing.push('fix');
115
+ }
116
+ return missing;
117
+ }
118
+ function collectOption(value, previous) {
119
+ return [...previous, value];
120
+ }
121
+ function parseLanguageOption(value) {
122
+ if (value === undefined) {
123
+ return { kind: 'valid', value: undefined };
124
+ }
125
+ const result = RuleLanguageSchema.safeParse(value);
126
+ return result.success ? { kind: 'valid', value: result.data } : { kind: 'invalid' };
127
+ }
128
+ function formatRedactionBlockMessage(warnings) {
129
+ const summary = warnings
130
+ .map((warning) => `${warning.kind}:${warning.pattern}`)
131
+ .join(', ');
132
+ return `Blocked by unresolved redaction warnings: ${summary}\n`;
133
+ }
134
+ //# sourceMappingURL=add.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ import type { Command } from 'commander';
2
+ export { registerInitCommand } from './init.js';
3
+ export declare function registerIndexCommand(program: Command): Command;
@@ -0,0 +1,41 @@
1
+ import { resolveRulebookHome } from '../core/index.js';
2
+ import { checkRulebookIndex, rebuildRulebookIndex } from '../storage/index.js';
3
+ import { writeIndexCheckText, writeIndexRebuildText, writeJson, } from './output.js';
4
+ export { registerInitCommand } from './init.js';
5
+ export function registerIndexCommand(program) {
6
+ const indexCommand = program
7
+ .command('index')
8
+ .description('Inspect and rebuild the local SQLite rule index');
9
+ indexCommand
10
+ .command('rebuild')
11
+ .description('Rebuild the local SQLite rule index')
12
+ .option('--json', 'Print JSON output')
13
+ .action(async (options) => {
14
+ const home = resolveRulebookHome();
15
+ const result = await rebuildRulebookIndex({ home });
16
+ if (options.json === true) {
17
+ writeJson(result);
18
+ return;
19
+ }
20
+ writeIndexRebuildText(result);
21
+ });
22
+ indexCommand
23
+ .command('check')
24
+ .description('Check whether the local SQLite rule index is present and current')
25
+ .option('--json', 'Print JSON output')
26
+ .action(async (options) => {
27
+ const home = resolveRulebookHome();
28
+ const result = await checkRulebookIndex({ home });
29
+ if (options.json === true) {
30
+ writeJson(result);
31
+ }
32
+ else {
33
+ writeIndexCheckText(result);
34
+ }
35
+ if (result.status !== 'ok') {
36
+ process.exitCode = 1;
37
+ }
38
+ });
39
+ return program;
40
+ }
41
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,SAAS,GACV,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAMhD,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,YAAY,GAAG,OAAO;SACzB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,iDAAiD,CAAC,CAAC;IAElE,YAAY;SACT,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,OAA2B,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC1B,SAAS,CAAC,MAAM,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QAED,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEL,YAAY;SACT,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,kEAAkE,CAAC;SAC/E,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC;SACrC,MAAM,CAAC,KAAK,EAAE,OAA2B,EAAE,EAAE;QAC5C,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAElD,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC1B,SAAS,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,mBAAmB,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerInitCommand(program: Command): Command;
@@ -0,0 +1,17 @@
1
+ import { resolveRulebookHome } from '../core/paths.js';
2
+ import { createRulebookLayout } from '../storage/rulebook-home.js';
3
+ export function registerInitCommand(program) {
4
+ program
5
+ .command('init')
6
+ .description('Create the local Agent Rulebook home layout')
7
+ .action(async () => {
8
+ const home = resolveRulebookHome();
9
+ const result = await createRulebookLayout({ home });
10
+ process.stdout.write(`Rulebook home: ${result.home}\n`);
11
+ for (const entry of result.entries) {
12
+ process.stdout.write(`${entry.status}\t${entry.kind}\t${entry.relativePath}\n`);
13
+ }
14
+ });
15
+ return program;
16
+ }
17
+ //# sourceMappingURL=init.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAClD,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,6CAA6C,CAAC;SAC1D,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;QACxD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;QAClF,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerMcpCommand(program: Command): Command;
@@ -0,0 +1,17 @@
1
+ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
2
+ import { resolveRulebookHome } from '../core/index.js';
3
+ import { createAgentRulebookMcpServer } from '../mcp/index.js';
4
+ export function registerMcpCommand(program) {
5
+ program
6
+ .command('mcp')
7
+ .description('Start the Agent Rulebook MCP stdio server')
8
+ .action(async () => {
9
+ const server = createAgentRulebookMcpServer({
10
+ rulebookHome: resolveRulebookHome(),
11
+ });
12
+ const transport = new StdioServerTransport();
13
+ await server.connect(transport);
14
+ });
15
+ return program;
16
+ }
17
+ //# sourceMappingURL=mcp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAC;AAE/D,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,OAAO;SACJ,OAAO,CAAC,KAAK,CAAC;SACd,WAAW,CAAC,2CAA2C,CAAC;SACxD,MAAM,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,GAAG,4BAA4B,CAAC;YAC1C,YAAY,EAAE,mBAAmB,EAAE;SACpC,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC"}
@@ -0,0 +1,2 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerMigrateCommand(program: Command): Command;
@@ -0,0 +1,73 @@
1
+ import { mkdir, readFile, writeFile } from 'node:fs/promises';
2
+ import { dirname, resolve } from 'node:path';
3
+ import { applyMigration, MigrationManifestSchema, scanMigrationSources, verifyMigration, } from '../migration/index.js';
4
+ import { writeJson } from './output.js';
5
+ export function registerMigrateCommand(program) {
6
+ const migrate = program.command('migrate').description('Discover and migrate legacy rule sources');
7
+ migrate
8
+ .command('scan')
9
+ .description('Scan legacy sources without modifying them')
10
+ .argument('<roots...>', 'Source roots to scan')
11
+ .requiredOption('--output <file>', 'Write the local migration manifest to this file')
12
+ .action(async (roots, options) => {
13
+ const manifest = await scanMigrationSources(roots);
14
+ const outputPath = resolve(options.output);
15
+ await mkdir(dirname(outputPath), { recursive: true });
16
+ await writeFile(outputPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
17
+ process.stdout.write(`Migration scan complete: ${manifest.summary.candidates} candidates, ` +
18
+ `${manifest.summary.review_required} review required, ${manifest.summary.errors} errors.\n`);
19
+ });
20
+ migrate
21
+ .command('apply')
22
+ .description('Apply a migration manifest to an explicit Rulebook home')
23
+ .argument('<manifest>', 'Migration manifest JSON file')
24
+ .requiredOption('--home <directory>', 'Explicit target Rulebook home')
25
+ .option('--dry-run', 'Report changes without writing files or rebuilding the index')
26
+ .option('--confirm-real-home', 'Confirm writes to the default ~/.agent-rulebook home')
27
+ .option('--json', 'Print JSON output')
28
+ .action(async (manifestPath, options) => {
29
+ const manifest = await readManifest(manifestPath);
30
+ const report = await applyMigration(manifest, {
31
+ home: options.home,
32
+ dryRun: options.dryRun,
33
+ confirmRealHome: options.confirmRealHome,
34
+ });
35
+ if (options.json === true) {
36
+ writeJson(report);
37
+ }
38
+ else {
39
+ process.stdout.write(`Migration apply ${report.status}: ${report.totals.created} created, ` +
40
+ `${report.totals.unchanged} unchanged, ${report.totals.conflicts} conflicts.\n`);
41
+ }
42
+ if (report.status === 'blocked' || report.status === 'rolled_back') {
43
+ process.exitCode = 1;
44
+ }
45
+ });
46
+ migrate
47
+ .command('verify')
48
+ .description('Verify a migration manifest against an explicit Rulebook home')
49
+ .argument('<manifest>', 'Migration manifest JSON file')
50
+ .requiredOption('--home <directory>', 'Explicit target Rulebook home')
51
+ .option('--json', 'Print JSON output')
52
+ .action(async (manifestPath, options) => {
53
+ const manifest = await readManifest(manifestPath);
54
+ const report = await verifyMigration(manifest, { home: options.home });
55
+ if (options.json === true) {
56
+ writeJson(report);
57
+ }
58
+ else {
59
+ process.stdout.write(`Migration verify ${report.status}: ${report.totals.valid} valid, ` +
60
+ `${report.totals.invalid} invalid, ${report.totals.duplicates} duplicates.\n`);
61
+ }
62
+ if (report.status !== 'passed') {
63
+ process.exitCode = 1;
64
+ }
65
+ });
66
+ return program;
67
+ }
68
+ async function readManifest(path) {
69
+ const source = await readFile(resolve(path), 'utf8');
70
+ const parsedJson = JSON.parse(source);
71
+ return MigrationManifestSchema.parse(parsedJson);
72
+ }
73
+ //# sourceMappingURL=migrate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,6 @@
1
+ import type { IndexCheckResult, RebuildRulebookIndexResult } from '../storage/index.js';
2
+ import type { SearchResponse } from '../core/index.js';
3
+ export declare function writeJson(value: unknown): void;
4
+ export declare function writeSearchText(response: SearchResponse): void;
5
+ export declare function writeIndexRebuildText(result: RebuildRulebookIndexResult): void;
6
+ export declare function writeIndexCheckText(result: IndexCheckResult): void;
@@ -0,0 +1,49 @@
1
+ export function writeJson(value) {
2
+ process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
3
+ }
4
+ export function writeSearchText(response) {
5
+ if (response.results.length === 0) {
6
+ process.stdout.write(`${response.hint ?? 'No results'}\n`);
7
+ return;
8
+ }
9
+ process.stdout.write('score\tstatus\tconfidence\tid\ttitle\n');
10
+ for (const result of response.results) {
11
+ process.stdout.write(formatSearchResult(result));
12
+ }
13
+ }
14
+ export function writeIndexRebuildText(result) {
15
+ process.stdout.write(`indexPath\t${result.indexPath}\n`);
16
+ process.stdout.write(`indexed\t${result.indexedCount}\n`);
17
+ if (result.skipped.length === 0) {
18
+ process.stdout.write('skipped\t0\n');
19
+ return;
20
+ }
21
+ for (const skipped of result.skipped) {
22
+ process.stdout.write(`skipped\t${skipped.path}\t${skipped.reason}\n`);
23
+ }
24
+ }
25
+ export function writeIndexCheckText(result) {
26
+ process.stdout.write(`status\t${result.status}\n`);
27
+ process.stdout.write(`sourceCount\t${result.sourceCount}\n`);
28
+ process.stdout.write(`indexedCount\t${result.indexedCount}\n`);
29
+ process.stdout.write(`indexPath\t${result.indexPath}\n`);
30
+ if (result.runtime !== undefined) {
31
+ process.stdout.write(`userVersion\t${result.runtime.userVersion}\n`);
32
+ process.stdout.write(`expectedUserVersion\t${result.runtime.expectedUserVersion}\n`);
33
+ process.stdout.write(`fts5Available\t${result.runtime.fts5Available}\n`);
34
+ process.stdout.write(`integrity\t${result.runtime.integrity}\n`);
35
+ }
36
+ if (result.hint !== undefined) {
37
+ process.stdout.write(`hint\t${result.hint}\n`);
38
+ }
39
+ }
40
+ function formatSearchResult(result) {
41
+ return [
42
+ `${result.score.toFixed(3)}\t${result.status}\t${result.confidence}\t${result.id}\t${result.title}`,
43
+ `summary\t${result.summary}`,
44
+ `fix\t${result.fix}`,
45
+ `path\t${result.path}`,
46
+ '',
47
+ ].join('\n');
48
+ }
49
+ //# sourceMappingURL=output.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/commands/output.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ import type { Command } from 'commander';
2
+ export declare function registerSearchCommand(program: Command): Command;
@@ -0,0 +1,57 @@
1
+ import { existsSync } from 'node:fs';
2
+ import { join } from 'node:path';
3
+ import { resolveRulebookHome } from '../core/index.js';
4
+ import { SEARCH_LIMIT_POLICIES, searchRules } from '../storage/index.js';
5
+ import { writeJson, writeSearchText } from './output.js';
6
+ export function registerSearchCommand(program) {
7
+ program
8
+ .command('search')
9
+ .argument('<query>', 'Search query')
10
+ .description('Search indexed Agent Rulebook rules')
11
+ .option('--language <language>', 'Filter by rule language')
12
+ .option('--tool <tool>', 'Filter by tool', collectOption, [])
13
+ .option('--category <category>', 'Filter by category', collectOption, [])
14
+ .option('--platform <platform>', 'Filter by platform', collectOption, [])
15
+ .option('--limit <limit>', 'Maximum number of results')
16
+ .option('--json', 'Print JSON output')
17
+ .action((query, options) => {
18
+ const home = resolveRulebookHome();
19
+ const indexPath = join(home, 'index/rulebook.sqlite');
20
+ if (!existsSync(indexPath)) {
21
+ process.stderr.write(`Rulebook index is missing at ${indexPath}. Run agent-rulebook index rebuild first.\n`);
22
+ process.exitCode = 1;
23
+ return;
24
+ }
25
+ const response = searchRules({
26
+ indexPath,
27
+ query: {
28
+ text: query,
29
+ filters: {
30
+ language: options.language,
31
+ tools: options.tool,
32
+ categories: options.category,
33
+ platforms: options.platform,
34
+ },
35
+ limit: parseLimitOption(options.limit),
36
+ },
37
+ limitPolicy: SEARCH_LIMIT_POLICIES.cli,
38
+ });
39
+ if (options.json === true) {
40
+ writeJson(response);
41
+ return;
42
+ }
43
+ writeSearchText(response);
44
+ });
45
+ return program;
46
+ }
47
+ function collectOption(value, previous) {
48
+ return [...previous, value];
49
+ }
50
+ function parseLimitOption(value) {
51
+ if (value === undefined) {
52
+ return undefined;
53
+ }
54
+ const limit = Number.parseInt(value, 10);
55
+ return Number.isNaN(limit) ? undefined : limit;
56
+ }
57
+ //# sourceMappingURL=search.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/commands/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAWzD,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;SACnC,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,uBAAuB,EAAE,yBAAyB,CAAC;SAC1D,MAAM,CAAC,eAAe,EAAE,gBAAgB,EAAE,aAAa,EAAE,EAAE,CAAC;SAC5D,MAAM,CAAC,uBAAuB,EAAE,oBAAoB,EAAE,aAAa,EAAE,EAAE,CAAC;SACxE,MAAM,CAAC,uBAAuB,EAAE,oBAAoB,EAAE,aAAa,EAAE,EAAE,CAAC;SACxE,MAAM,CAAC,iBAAiB,EAAE,2BAA2B,CAAC;SACtD,MAAM,CAAC,QAAQ,EAAE,mBAAmB,CAAC;SACrC,MAAM,CAAC,CAAC,KAAa,EAAE,OAA6B,EAAE,EAAE;QACvD,MAAM,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,uBAAuB,CAAC,CAAC;QAEtD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,gCAAgC,SAAS,6CAA6C,CACvF,CAAC;YACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,WAAW,CAAC;YAC3B,SAAS;YACT,KAAK,EAAE;gBACL,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE;oBACP,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,KAAK,EAAE,OAAO,CAAC,IAAI;oBACnB,UAAU,EAAE,OAAO,CAAC,QAAQ;oBAC5B,SAAS,EAAE,OAAO,CAAC,QAAQ;iBAC5B;gBACD,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC;aACvC;YACD,WAAW,EAAE,qBAAqB,CAAC,GAAG;SACvC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;YAC1B,SAAS,CAAC,QAAQ,CAAC,CAAC;YACpB,OAAO;QACT,CAAC;QAED,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEL,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,KAAa,EAAE,QAAkB;IACtD,OAAO,CAAC,GAAG,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAyB;IACjD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzC,OAAO,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AACjD,CAAC"}
@@ -0,0 +1,17 @@
1
+ import type { CompatibilityComponentKind, RuleCompatibility } from './rule-compatibility.js';
2
+ export type CompatibilityEnvironmentComponent = {
3
+ kind: CompatibilityComponentKind;
4
+ name: string;
5
+ version: string;
6
+ };
7
+ export type CompatibilityWarning = {
8
+ code: 'compatibility_unknown' | 'environment_unknown' | 'unsupported_version_range';
9
+ message: string;
10
+ };
11
+ export type CompatibilityMatch = {
12
+ applicability: 'version_agnostic' | 'compatible' | 'unknown' | 'incompatible';
13
+ reason: string;
14
+ evidence: string[];
15
+ warnings: CompatibilityWarning[];
16
+ };
17
+ export declare function matchRuleCompatibility(compatibility: RuleCompatibility, environment: readonly CompatibilityEnvironmentComponent[]): CompatibilityMatch;