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,110 @@
1
+ import { RulebookIndexMigrationError } from './sqlite-errors.js';
2
+ export const CURRENT_RULEBOOK_DATABASE_VERSION = 2;
3
+ export function migrateRulebookDatabase(database) {
4
+ const fromVersion = readUserVersion(database);
5
+ try {
6
+ if (fromVersion > CURRENT_RULEBOOK_DATABASE_VERSION) {
7
+ throw new Error(`Database version ${fromVersion} is newer than supported version ${CURRENT_RULEBOOK_DATABASE_VERSION}`);
8
+ }
9
+ if (fromVersion === 0) {
10
+ applyVersionOne(database);
11
+ }
12
+ if (readUserVersion(database) === 1) {
13
+ applyVersionTwo(database);
14
+ }
15
+ }
16
+ catch (error) {
17
+ if (error instanceof RulebookIndexMigrationError) {
18
+ throw error;
19
+ }
20
+ throw new RulebookIndexMigrationError(database.name, fromVersion, error);
21
+ }
22
+ }
23
+ function applyVersionOne(database) {
24
+ const migrate = database.transaction(() => {
25
+ database.exec(`
26
+ CREATE TABLE IF NOT EXISTS rules (
27
+ id TEXT PRIMARY KEY,
28
+ path TEXT NOT NULL,
29
+ title TEXT NOT NULL,
30
+ summary TEXT NOT NULL,
31
+ language TEXT,
32
+ confidence TEXT NOT NULL,
33
+ status TEXT NOT NULL,
34
+ created_at TEXT NOT NULL,
35
+ updated_at TEXT,
36
+ verified_at TEXT
37
+ );
38
+
39
+ CREATE TABLE IF NOT EXISTS rule_tags (
40
+ rule_id TEXT NOT NULL,
41
+ kind TEXT NOT NULL,
42
+ value TEXT NOT NULL,
43
+ PRIMARY KEY (rule_id, kind, value),
44
+ FOREIGN KEY (rule_id) REFERENCES rules(id) ON DELETE CASCADE
45
+ );
46
+
47
+ CREATE VIRTUAL TABLE IF NOT EXISTS rules_fts USING fts5(
48
+ rule_id UNINDEXED,
49
+ title,
50
+ summary,
51
+ trigger,
52
+ mistake,
53
+ fix,
54
+ error_signature
55
+ );
56
+
57
+ PRAGMA user_version = 1;
58
+ `);
59
+ });
60
+ migrate();
61
+ }
62
+ function applyVersionTwo(database) {
63
+ const migrate = database.transaction(() => {
64
+ database.exec(`
65
+ ALTER TABLE rules ADD COLUMN rule_scope TEXT NOT NULL DEFAULT 'shared';
66
+ ALTER TABLE rules ADD COLUMN project_key TEXT;
67
+ ALTER TABLE rules ADD COLUMN compatibility_scope TEXT NOT NULL DEFAULT 'unknown';
68
+
69
+ CREATE TABLE rule_compatibility (
70
+ rule_id TEXT NOT NULL,
71
+ kind TEXT NOT NULL,
72
+ component TEXT NOT NULL,
73
+ version_range TEXT NOT NULL,
74
+ scope TEXT NOT NULL,
75
+ PRIMARY KEY (rule_id, kind, component, version_range),
76
+ FOREIGN KEY (rule_id) REFERENCES rules(id) ON DELETE CASCADE
77
+ );
78
+
79
+ CREATE TABLE rule_sources (
80
+ rule_id TEXT NOT NULL,
81
+ source_kind TEXT NOT NULL,
82
+ source_project TEXT,
83
+ source_ref TEXT NOT NULL,
84
+ source_checksum TEXT NOT NULL,
85
+ PRIMARY KEY (rule_id, source_checksum),
86
+ FOREIGN KEY (rule_id) REFERENCES rules(id) ON DELETE CASCADE
87
+ );
88
+
89
+ CREATE TABLE rule_activation (
90
+ rule_id TEXT PRIMARY KEY,
91
+ basis TEXT NOT NULL,
92
+ capture_mode TEXT NOT NULL,
93
+ debugging_cost TEXT,
94
+ token_cost TEXT,
95
+ recurrence_risk TEXT,
96
+ dedup_result TEXT,
97
+ verification_kind TEXT,
98
+ verification_evidence TEXT,
99
+ FOREIGN KEY (rule_id) REFERENCES rules(id) ON DELETE CASCADE
100
+ );
101
+
102
+ PRAGMA user_version = 2;
103
+ `);
104
+ });
105
+ migrate();
106
+ }
107
+ function readUserVersion(database) {
108
+ return database.pragma('user_version', { simple: true });
109
+ }
110
+ //# sourceMappingURL=migrations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/storage/migrations.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAEjE,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC;AAEnD,MAAM,UAAU,uBAAuB,CAAC,QAA0B;IAChE,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,IAAI,WAAW,GAAG,iCAAiC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,CACb,oBAAoB,WAAW,oCAAoC,iCAAiC,EAAE,CACvG,CAAC;QACJ,CAAC;QAED,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;YACtB,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;QAED,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACpC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,2BAA2B,EAAE,CAAC;YACjD,MAAM,KAAK,CAAC;QACd,CAAC;QACD,MAAM,IAAI,2BAA2B,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,QAA0B;IACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE;QACxC,QAAQ,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAiCb,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,eAAe,CAAC,QAA0B;IACjD,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE;QACxC,QAAQ,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAuCb,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,eAAe,CAAC,QAA0B;IACjD,OAAO,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAW,CAAC;AACrE,CAAC"}
@@ -0,0 +1,4 @@
1
+ export type DiscoverRuleFilesOptions = {
2
+ rulesDir: string;
3
+ };
4
+ export declare function discoverRuleFiles(options: DiscoverRuleFilesOptions): Promise<string[]>;
@@ -0,0 +1,34 @@
1
+ import { readdir } from 'node:fs/promises';
2
+ import { join } from 'node:path';
3
+ export async function discoverRuleFiles(options) {
4
+ return discoverYamlFiles(options.rulesDir);
5
+ }
6
+ async function discoverYamlFiles(directory) {
7
+ let entries;
8
+ try {
9
+ entries = await readdir(directory, { withFileTypes: true });
10
+ }
11
+ catch (error) {
12
+ if (error.code === 'ENOENT') {
13
+ return [];
14
+ }
15
+ throw error;
16
+ }
17
+ const files = [];
18
+ const sortedEntries = [...entries].sort((left, right) => left.name.localeCompare(right.name));
19
+ for (const entry of sortedEntries) {
20
+ const absolutePath = join(directory, entry.name);
21
+ if (entry.isDirectory()) {
22
+ files.push(...(await discoverYamlFiles(absolutePath)));
23
+ continue;
24
+ }
25
+ if (entry.isFile() && isYamlFile(entry.name)) {
26
+ files.push(absolutePath);
27
+ }
28
+ }
29
+ return files;
30
+ }
31
+ function isYamlFile(fileName) {
32
+ return fileName.endsWith('.yaml') || fileName.endsWith('.yml');
33
+ }
34
+ //# sourceMappingURL=rule-discovery.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rule-discovery.js","sourceRoot":"","sources":["../../src/storage/rule-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAMjC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAiC;IACvE,OAAO,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC7C,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IAChD,IAAI,OAAO,CAAC;IAEZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,aAAa,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAE9F,KAAK,MAAM,KAAK,IAAI,aAAa,EAAE,CAAC;QAClC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAEjD,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,iBAAiB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACvD,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IAClC,OAAO,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACjE,CAAC"}
@@ -0,0 +1,10 @@
1
+ import type { RulePreview } from '../core/index.js';
2
+ export type SaveRulePreviewOptions = {
3
+ rulebookHome: string;
4
+ preview: RulePreview;
5
+ };
6
+ export type SaveRulePreviewResult = {
7
+ relativePath: string;
8
+ absolutePath: string;
9
+ };
10
+ export declare function saveRulePreview(options: SaveRulePreviewOptions): Promise<SaveRulePreviewResult>;
@@ -0,0 +1,12 @@
1
+ import { mkdir, writeFile } from 'node:fs/promises';
2
+ import { dirname, join } from 'node:path';
3
+ export async function saveRulePreview(options) {
4
+ const absolutePath = join(options.rulebookHome, options.preview.relativePath);
5
+ await mkdir(dirname(absolutePath), { recursive: true });
6
+ await writeFile(absolutePath, options.preview.yaml, { encoding: 'utf8', flag: 'wx' });
7
+ return {
8
+ relativePath: options.preview.relativePath,
9
+ absolutePath,
10
+ };
11
+ }
12
+ //# sourceMappingURL=rule-store.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rule-store.js","sourceRoot":"","sources":["../../src/storage/rule-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAa1C,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAA+B;IAE/B,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAE9E,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtF,OAAO;QACL,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY;QAC1C,YAAY;KACb,CAAC;AACJ,CAAC"}
@@ -0,0 +1,21 @@
1
+ export type RulebookLayoutEntryKind = 'directory' | 'file';
2
+ export type RulebookLayoutEntryStatus = 'created' | 'existing';
3
+ export type RulebookLayoutEntry = {
4
+ relativePath: string;
5
+ absolutePath: string;
6
+ kind: RulebookLayoutEntryKind;
7
+ status: RulebookLayoutEntryStatus;
8
+ };
9
+ export type CreateRulebookLayoutOptions = {
10
+ home: string;
11
+ };
12
+ export type CreateRulebookLayoutResult = {
13
+ home: string;
14
+ entries: RulebookLayoutEntry[];
15
+ };
16
+ export declare const DEFAULT_RULEBOOK_DIRECTORIES: readonly ["rules/swift", "rules/android", "rules/typescript", "rules/mcp", "rules/clients", "index", "logs"];
17
+ export declare const DEFAULT_RULEBOOK_FILES: {
18
+ readonly 'config.yaml': string;
19
+ readonly '.gitignore': string;
20
+ };
21
+ export declare function createRulebookLayout(options: CreateRulebookLayoutOptions): Promise<CreateRulebookLayoutResult>;
@@ -0,0 +1,75 @@
1
+ import { access, mkdir, writeFile } from 'node:fs/promises';
2
+ import { join } from 'node:path';
3
+ export const DEFAULT_RULEBOOK_DIRECTORIES = [
4
+ 'rules/swift',
5
+ 'rules/android',
6
+ 'rules/typescript',
7
+ 'rules/mcp',
8
+ 'rules/clients',
9
+ 'index',
10
+ 'logs',
11
+ ];
12
+ export const DEFAULT_RULEBOOK_FILES = {
13
+ 'config.yaml': [
14
+ 'version: 1',
15
+ 'rules_dir: rules',
16
+ 'index_dir: index',
17
+ 'logs_dir: logs',
18
+ '',
19
+ ].join('\n'),
20
+ '.gitignore': [
21
+ 'index/*.sqlite',
22
+ 'index/*.sqlite-*',
23
+ 'index/*.sqlite.lock',
24
+ 'index/*.sqlite.tmp-*',
25
+ 'logs/*.log',
26
+ '*.tmp',
27
+ '',
28
+ ].join('\n'),
29
+ };
30
+ const layoutDirectories = [...DEFAULT_RULEBOOK_DIRECTORIES];
31
+ const layoutFiles = new Map(Object.entries(DEFAULT_RULEBOOK_FILES));
32
+ export async function createRulebookLayout(options) {
33
+ const entries = [];
34
+ await mkdir(options.home, { recursive: true });
35
+ for (const relativePath of layoutDirectories) {
36
+ const absolutePath = join(options.home, relativePath);
37
+ const exists = await pathExists(absolutePath);
38
+ if (!exists) {
39
+ await mkdir(absolutePath, { recursive: true });
40
+ }
41
+ entries.push({
42
+ relativePath,
43
+ absolutePath,
44
+ kind: 'directory',
45
+ status: exists ? 'existing' : 'created',
46
+ });
47
+ }
48
+ for (const [relativePath, content] of layoutFiles) {
49
+ const absolutePath = join(options.home, relativePath);
50
+ const exists = await pathExists(absolutePath);
51
+ if (!exists) {
52
+ await writeFile(absolutePath, content, { encoding: 'utf8', flag: 'wx' });
53
+ }
54
+ entries.push({
55
+ relativePath,
56
+ absolutePath,
57
+ kind: 'file',
58
+ status: exists ? 'existing' : 'created',
59
+ });
60
+ }
61
+ return {
62
+ home: options.home,
63
+ entries,
64
+ };
65
+ }
66
+ async function pathExists(path) {
67
+ try {
68
+ await access(path);
69
+ return true;
70
+ }
71
+ catch {
72
+ return false;
73
+ }
74
+ }
75
+ //# sourceMappingURL=rulebook-home.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rulebook-home.js","sourceRoot":"","sources":["../../src/storage/rulebook-home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAqBjC,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,aAAa;IACb,eAAe;IACf,kBAAkB;IAClB,WAAW;IACX,eAAe;IACf,OAAO;IACP,MAAM;CACE,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,aAAa,EAAE;QACb,YAAY;QACZ,kBAAkB;QAClB,kBAAkB;QAClB,gBAAgB;QAChB,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC;IACZ,YAAY,EAAE;QACZ,gBAAgB;QAChB,kBAAkB;QAClB,qBAAqB;QACrB,sBAAsB;QACtB,YAAY;QACZ,OAAO;QACP,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC;CACJ,CAAC;AAEX,MAAM,iBAAiB,GAAG,CAAC,GAAG,4BAA4B,CAAC,CAAC;AAC5D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAEpE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAoC;IAEpC,MAAM,OAAO,GAA0B,EAAE,CAAC;IAE1C,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE/C,KAAK,MAAM,YAAY,IAAI,iBAAiB,EAAE,CAAC;QAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC;QAE9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,KAAK,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,YAAY;YACZ,YAAY;YACZ,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SACxC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,WAAW,EAAE,CAAC;QAClD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC;QAE9C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,SAAS,CAAC,YAAY,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,CAAC;QAED,OAAO,CAAC,IAAI,CAAC;YACX,YAAY;YACZ,YAAY;YACZ,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;SACxC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO;KACR,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
@@ -0,0 +1,17 @@
1
+ import type { SearchLimitPolicy, SearchQuery, SearchResponse } from '../core/index.js';
2
+ export declare const SEARCH_LIMIT_POLICIES: {
3
+ cli: {
4
+ defaultLimit: number;
5
+ maxLimit: number;
6
+ };
7
+ mcp: {
8
+ defaultLimit: number;
9
+ maxLimit: number;
10
+ };
11
+ };
12
+ export type SearchRulesOptions = {
13
+ indexPath: string;
14
+ query: SearchQuery;
15
+ limitPolicy?: SearchLimitPolicy;
16
+ };
17
+ export declare function searchRules(options: SearchRulesOptions): SearchResponse;
@@ -0,0 +1,252 @@
1
+ import { readFileSync } from 'node:fs';
2
+ import { matchRuleCompatibility, normalizeFacetFilter, parseRuleYaml, rankSearchResults, } from '../core/index.js';
3
+ import { closeRulebookDatabase, openRulebookDatabase } from './sqlite.js';
4
+ const DEFAULT_LIMIT_POLICY = {
5
+ defaultLimit: 5,
6
+ maxLimit: 5,
7
+ };
8
+ export const SEARCH_LIMIT_POLICIES = {
9
+ cli: {
10
+ defaultLimit: 5,
11
+ maxLimit: 20,
12
+ },
13
+ mcp: {
14
+ defaultLimit: 5,
15
+ maxLimit: 10,
16
+ },
17
+ };
18
+ export function searchRules(options) {
19
+ const tokens = tokenizeSearchText(options.query.text);
20
+ const context = prepareSearchContext(options.query);
21
+ if (tokens.length === 0) {
22
+ return {
23
+ results: [],
24
+ hint: 'Enter a search query or remove filters to broaden the search.',
25
+ diagnostics: context.diagnostics,
26
+ applied: context.applied,
27
+ };
28
+ }
29
+ if (context.diagnostics.some((diagnostic) => diagnostic.code === 'unknown_facet')) {
30
+ return {
31
+ results: [],
32
+ hint: `No results because ${context.diagnostics[0]?.message ?? 'a facet is unknown'}`,
33
+ diagnostics: context.diagnostics,
34
+ applied: context.applied,
35
+ };
36
+ }
37
+ const database = openRulebookDatabase({ databasePath: options.indexPath });
38
+ try {
39
+ const candidateResult = readSearchCandidates(database, { ...options.query, filters: context.filters }, tokens);
40
+ const diagnostics = deduplicateDiagnostics([
41
+ ...context.diagnostics,
42
+ ...candidateResult.diagnostics,
43
+ ]);
44
+ const limit = resolveLimit(options.query.limit, options.limitPolicy ?? DEFAULT_LIMIT_POLICY);
45
+ const results = rankSearchResults(candidateResult.candidates).slice(0, limit);
46
+ if (results.length === 0) {
47
+ return {
48
+ results,
49
+ hint: buildNoResultHint(diagnostics),
50
+ diagnostics,
51
+ applied: context.applied,
52
+ };
53
+ }
54
+ return { results, diagnostics, applied: context.applied };
55
+ }
56
+ finally {
57
+ closeRulebookDatabase(database);
58
+ }
59
+ }
60
+ function readSearchCandidates(database, query, tokens) {
61
+ const params = [buildFtsQuery(tokens)];
62
+ const whereClauses = ['rules_fts MATCH ?'];
63
+ const filters = query.filters;
64
+ if (filters?.language !== undefined) {
65
+ whereClauses.push('r.language = ?');
66
+ params.push(filters.language);
67
+ }
68
+ if (filters?.status !== undefined && filters.status.length > 0) {
69
+ whereClauses.push(`r.status IN (${filters.status.map(() => '?').join(', ')})`);
70
+ params.push(...filters.status);
71
+ }
72
+ else {
73
+ whereClauses.push('r.status = ?');
74
+ params.push('active');
75
+ }
76
+ addTagFilters(whereClauses, params, 'tool', filters?.tools);
77
+ addTagFilters(whereClauses, params, 'category', filters?.categories);
78
+ addTagFilters(whereClauses, params, 'platform', filters?.platforms);
79
+ const rows = database
80
+ .prepare(`SELECT
81
+ r.id,
82
+ r.title,
83
+ r.summary,
84
+ f.fix,
85
+ r.path,
86
+ r.confidence,
87
+ r.status,
88
+ bm25(rules_fts) AS bm25_score
89
+ FROM rules_fts AS f
90
+ JOIN rules AS r ON r.id = f.rule_id
91
+ WHERE ${whereClauses.join(' AND ')}`)
92
+ .all(...params);
93
+ const candidates = [];
94
+ const diagnostics = [];
95
+ for (const row of rows) {
96
+ let parsed;
97
+ try {
98
+ parsed = parseRuleYaml(readFileSync(row.path, 'utf8'), { filePath: row.path });
99
+ }
100
+ catch (error) {
101
+ diagnostics.push({
102
+ code: 'invalid_rule_source',
103
+ message: `Unable to read indexed rule ${row.id}: ${errorMessage(error)}`,
104
+ });
105
+ continue;
106
+ }
107
+ if (!parsed.success) {
108
+ diagnostics.push({
109
+ code: 'invalid_rule_source',
110
+ message: `Unable to parse indexed rule ${row.id}: ${parsed.error.message}`,
111
+ });
112
+ continue;
113
+ }
114
+ if (parsed.rule.rule_scope === 'project' && parsed.rule.project_key !== query.projectKey) {
115
+ diagnostics.push({
116
+ code: 'project_scope_mismatch',
117
+ message: `Rule ${row.id} is scoped to a different project key.`,
118
+ });
119
+ continue;
120
+ }
121
+ const compatibility = matchRuleCompatibility(parsed.rule.compatibility, query.environment ?? []);
122
+ if (compatibility.applicability === 'incompatible') {
123
+ diagnostics.push({
124
+ code: 'incompatible_environment',
125
+ message: compatibility.reason,
126
+ });
127
+ continue;
128
+ }
129
+ for (const warning of compatibility.warnings) {
130
+ if (warning.code === 'environment_unknown') {
131
+ diagnostics.push({ code: 'unknown_environment', message: warning.message });
132
+ }
133
+ }
134
+ candidates.push({
135
+ id: row.id,
136
+ title: row.title,
137
+ summary: row.summary,
138
+ fix: row.fix,
139
+ path: row.path,
140
+ confidence: row.confidence,
141
+ status: row.status,
142
+ applicability: compatibility.applicability,
143
+ applicabilityReason: compatibility.reason,
144
+ compatibilityEvidence: compatibility.evidence,
145
+ warnings: compatibility.warnings,
146
+ matchScore: Math.abs(row.bm25_score),
147
+ });
148
+ }
149
+ return { candidates, diagnostics };
150
+ }
151
+ function prepareSearchContext(query) {
152
+ const filters = {};
153
+ const diagnostics = [];
154
+ if (query.filters?.language !== undefined) {
155
+ const language = normalizeFacetFilter('language', [query.filters.language]);
156
+ addUnknownFacetDiagnostics(diagnostics, 'language', language.unknown);
157
+ if (language.values[0] !== undefined) {
158
+ filters.language = language.values[0];
159
+ }
160
+ }
161
+ for (const [facet, values] of [
162
+ ['tools', query.filters?.tools],
163
+ ['categories', query.filters?.categories],
164
+ ['platforms', query.filters?.platforms],
165
+ ]) {
166
+ if (values === undefined || values.length === 0) {
167
+ continue;
168
+ }
169
+ const normalized = normalizeFacetFilter(facet, values);
170
+ filters[facet] = normalized.values;
171
+ addUnknownFacetDiagnostics(diagnostics, facet, normalized.unknown);
172
+ }
173
+ if (query.filters?.status !== undefined) {
174
+ filters.status = query.filters.status;
175
+ }
176
+ for (const component of query.environment ?? []) {
177
+ if (component.version === 'unknown') {
178
+ diagnostics.push({
179
+ code: 'unknown_environment',
180
+ message: `${component.name} environment version is unknown.`,
181
+ });
182
+ }
183
+ }
184
+ return {
185
+ filters,
186
+ diagnostics,
187
+ applied: {
188
+ filters,
189
+ environment: (query.environment ?? []).map((component) => `${component.name}=${component.version}`),
190
+ ...(query.projectKey === undefined ? {} : { projectKey: query.projectKey }),
191
+ },
192
+ };
193
+ }
194
+ function addUnknownFacetDiagnostics(diagnostics, facet, unknown) {
195
+ for (const value of unknown) {
196
+ diagnostics.push({
197
+ code: 'unknown_facet',
198
+ message: `Unknown ${facet} facet: ${value}.`,
199
+ });
200
+ }
201
+ }
202
+ function deduplicateDiagnostics(diagnostics) {
203
+ const seen = new Set();
204
+ return diagnostics.filter((diagnostic) => {
205
+ const key = `${diagnostic.code}:${diagnostic.message}`;
206
+ if (seen.has(key)) {
207
+ return false;
208
+ }
209
+ seen.add(key);
210
+ return true;
211
+ });
212
+ }
213
+ function buildNoResultHint(diagnostics) {
214
+ const reason = diagnostics.find((diagnostic) => diagnostic.code === 'unknown_facet' ||
215
+ diagnostic.code === 'incompatible_environment' ||
216
+ diagnostic.code === 'unknown_environment');
217
+ return reason === undefined
218
+ ? 'No results. Try removing filters or broadening the query.'
219
+ : `No results. ${reason.message}`;
220
+ }
221
+ function errorMessage(error) {
222
+ return error instanceof Error ? error.message : String(error);
223
+ }
224
+ function addTagFilters(whereClauses, params, kind, values) {
225
+ if (values === undefined || values.length === 0) {
226
+ return;
227
+ }
228
+ for (const value of values) {
229
+ whereClauses.push(`EXISTS (
230
+ SELECT 1
231
+ FROM rule_tags AS tag
232
+ WHERE tag.rule_id = r.id
233
+ AND tag.kind = ?
234
+ AND tag.value = ?
235
+ )`);
236
+ params.push(kind, value);
237
+ }
238
+ }
239
+ function tokenizeSearchText(text) {
240
+ const matches = text.toLocaleLowerCase().match(/[\p{L}\p{N}_]+/gu) ?? [];
241
+ return Array.from(new Set(matches)).slice(0, 32);
242
+ }
243
+ function buildFtsQuery(tokens) {
244
+ return tokens.map((token) => `"${token}"`).join(' OR ');
245
+ }
246
+ function resolveLimit(limit, policy) {
247
+ if (limit === undefined || !Number.isFinite(limit)) {
248
+ return policy.defaultLimit;
249
+ }
250
+ return Math.min(policy.maxLimit, Math.max(1, Math.floor(limit)));
251
+ }
252
+ //# sourceMappingURL=search-service.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"search-service.js","sourceRoot":"","sources":["../../src/storage/search-service.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ export type RulebookIndexErrorCode = 'RULEBOOK_INDEX_CORRUPT' | 'RULEBOOK_INDEX_LOCK_TIMEOUT' | 'RULEBOOK_INDEX_MIGRATION_FAILED' | 'RULEBOOK_INDEX_REBUILD_FAILED';
2
+ export declare class RulebookIndexCorruptError extends Error {
3
+ readonly indexPath: string;
4
+ readonly code = "RULEBOOK_INDEX_CORRUPT";
5
+ readonly recoveryHint: string;
6
+ constructor(indexPath: string, cause?: unknown);
7
+ }
8
+ export declare class RulebookIndexLockTimeoutError extends Error {
9
+ readonly indexPath: string;
10
+ readonly lockPath: string;
11
+ readonly timeoutMs: number;
12
+ readonly code = "RULEBOOK_INDEX_LOCK_TIMEOUT";
13
+ constructor(indexPath: string, lockPath: string, timeoutMs: number);
14
+ }
15
+ export declare class RulebookIndexMigrationError extends Error {
16
+ readonly databasePath: string;
17
+ readonly fromVersion: number;
18
+ readonly code = "RULEBOOK_INDEX_MIGRATION_FAILED";
19
+ constructor(databasePath: string, fromVersion: number, cause?: unknown);
20
+ }
21
+ export declare class RulebookIndexRebuildError extends Error {
22
+ readonly indexPath: string;
23
+ readonly code = "RULEBOOK_INDEX_REBUILD_FAILED";
24
+ constructor(indexPath: string, cause?: unknown);
25
+ }
26
+ export declare function isSqliteCorruptionError(error: unknown): boolean;
@@ -0,0 +1,55 @@
1
+ export class RulebookIndexCorruptError extends Error {
2
+ indexPath;
3
+ code = 'RULEBOOK_INDEX_CORRUPT';
4
+ recoveryHint;
5
+ constructor(indexPath, cause) {
6
+ super(`SQLite index is corrupt: ${indexPath}`);
7
+ this.indexPath = indexPath;
8
+ this.name = 'RulebookIndexCorruptError';
9
+ this.cause = cause;
10
+ this.recoveryHint = `run agent-rulebook index rebuild to replace ${indexPath} from canonical YAML`;
11
+ }
12
+ }
13
+ export class RulebookIndexLockTimeoutError extends Error {
14
+ indexPath;
15
+ lockPath;
16
+ timeoutMs;
17
+ code = 'RULEBOOK_INDEX_LOCK_TIMEOUT';
18
+ constructor(indexPath, lockPath, timeoutMs) {
19
+ super(`Timed out after ${timeoutMs}ms waiting for SQLite rebuild lock: ${lockPath}`);
20
+ this.indexPath = indexPath;
21
+ this.lockPath = lockPath;
22
+ this.timeoutMs = timeoutMs;
23
+ this.name = 'RulebookIndexLockTimeoutError';
24
+ }
25
+ }
26
+ export class RulebookIndexMigrationError extends Error {
27
+ databasePath;
28
+ fromVersion;
29
+ code = 'RULEBOOK_INDEX_MIGRATION_FAILED';
30
+ constructor(databasePath, fromVersion, cause) {
31
+ super(`Unable to migrate SQLite index from version ${fromVersion}: ${databasePath}`);
32
+ this.databasePath = databasePath;
33
+ this.fromVersion = fromVersion;
34
+ this.name = 'RulebookIndexMigrationError';
35
+ this.cause = cause;
36
+ }
37
+ }
38
+ export class RulebookIndexRebuildError extends Error {
39
+ indexPath;
40
+ code = 'RULEBOOK_INDEX_REBUILD_FAILED';
41
+ constructor(indexPath, cause) {
42
+ super(`Unable to rebuild SQLite index: ${indexPath}`);
43
+ this.indexPath = indexPath;
44
+ this.name = 'RulebookIndexRebuildError';
45
+ this.cause = cause;
46
+ }
47
+ }
48
+ export function isSqliteCorruptionError(error) {
49
+ const code = error.code;
50
+ const message = error instanceof Error ? error.message : '';
51
+ return (code === 'SQLITE_NOTADB' ||
52
+ code === 'SQLITE_CORRUPT' ||
53
+ /file is not a database|database disk image is malformed/i.test(message));
54
+ }
55
+ //# sourceMappingURL=sqlite-errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"sqlite-errors.js","sourceRoot":"","sources":["../../src/storage/sqlite-errors.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAKvC;IAJF,IAAI,GAAG,wBAAyD,CAAC;IACjE,YAAY,CAAS;IAE9B,YACW,SAAiB,EAC1B,KAAe;QAEf,KAAK,CAAC,4BAA4B,SAAS,EAAE,CAAC,CAAC;QAHtC,cAAS,GAAT,SAAS,CAAQ;QAI1B,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,+CAA+C,SAAS,sBAAsB,CAAC;IACrG,CAAC;CACF;AAED,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAI3C;IACA;IACA;IALF,IAAI,GAAG,6BAA8D,CAAC;IAE/E,YACW,SAAiB,EACjB,QAAgB,EAChB,SAAiB;QAE1B,KAAK,CAAC,mBAAmB,SAAS,uCAAuC,QAAQ,EAAE,CAAC,CAAC;QAJ5E,cAAS,GAAT,SAAS,CAAQ;QACjB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,cAAS,GAAT,SAAS,CAAQ;QAG1B,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,OAAO,2BAA4B,SAAQ,KAAK;IAIzC;IACA;IAJF,IAAI,GAAG,iCAAkE,CAAC;IAEnF,YACW,YAAoB,EACpB,WAAmB,EAC5B,KAAe;QAEf,KAAK,CAAC,+CAA+C,WAAW,KAAK,YAAY,EAAE,CAAC,CAAC;QAJ5E,iBAAY,GAAZ,YAAY,CAAQ;QACpB,gBAAW,GAAX,WAAW,CAAQ;QAI5B,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAIvC;IAHF,IAAI,GAAG,+BAAgE,CAAC;IAEjF,YACW,SAAiB,EAC1B,KAAe;QAEf,KAAK,CAAC,mCAAmC,SAAS,EAAE,CAAC,CAAC;QAH7C,cAAS,GAAT,SAAS,CAAQ;QAI1B,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,MAAM,IAAI,GAAI,KAA4B,CAAC,IAAI,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAE5D,OAAO,CACL,IAAI,KAAK,eAAe;QACxB,IAAI,KAAK,gBAAgB;QACzB,0DAA0D,CAAC,IAAI,CAAC,OAAO,CAAC,CACzE,CAAC;AACJ,CAAC"}