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,146 @@
1
+ export function matchRuleCompatibility(compatibility, environment) {
2
+ if (compatibility.scope === 'version_agnostic') {
3
+ return {
4
+ applicability: 'version_agnostic',
5
+ reason: 'Rule applicability is independent of component versions.',
6
+ evidence: compatibility.verified_with.map((item) => `${item.component} verified with ${item.version}`),
7
+ warnings: [],
8
+ };
9
+ }
10
+ if (compatibility.scope === 'unknown') {
11
+ const message = 'Rule compatibility evidence is unavailable.';
12
+ return {
13
+ applicability: 'unknown',
14
+ reason: message,
15
+ evidence: [],
16
+ warnings: [{ code: 'compatibility_unknown', message }],
17
+ };
18
+ }
19
+ const evidence = [];
20
+ const warnings = [];
21
+ for (const constraint of compatibility.constraints) {
22
+ const component = environment.find((item) => item.kind === constraint.kind &&
23
+ item.name.trim().toLowerCase() === constraint.component.trim().toLowerCase());
24
+ if (component === undefined || component.version === 'unknown') {
25
+ const message = `${constraint.component} environment version is unknown for ${constraint.range}.`;
26
+ warnings.push({ code: 'environment_unknown', message });
27
+ continue;
28
+ }
29
+ const matches = matchesVersionRange(component.version, constraint.range);
30
+ if (matches === undefined) {
31
+ const message = `Unsupported ${constraint.component} version range: ${constraint.range}.`;
32
+ warnings.push({ code: 'unsupported_version_range', message });
33
+ continue;
34
+ }
35
+ if (!matches) {
36
+ return {
37
+ applicability: 'incompatible',
38
+ reason: `${constraint.component} ${component.version} does not satisfy ${constraint.range}.`,
39
+ evidence,
40
+ warnings,
41
+ };
42
+ }
43
+ evidence.push(`${constraint.component} ${component.version} satisfies ${constraint.range}`);
44
+ }
45
+ if (warnings.length > 0) {
46
+ return {
47
+ applicability: 'unknown',
48
+ reason: warnings.map((warning) => warning.message).join(' '),
49
+ evidence,
50
+ warnings,
51
+ };
52
+ }
53
+ return {
54
+ applicability: 'compatible',
55
+ reason: 'Every compatibility constraint matches the detected environment.',
56
+ evidence,
57
+ warnings: [],
58
+ };
59
+ }
60
+ function matchesVersionRange(version, range) {
61
+ const alternatives = range.split('||').map((item) => item.trim());
62
+ let hasUnsupportedAlternative = false;
63
+ for (const alternative of alternatives) {
64
+ const result = matchesVersionRangeAlternative(version, alternative);
65
+ if (result === true) {
66
+ return true;
67
+ }
68
+ if (result === undefined) {
69
+ hasUnsupportedAlternative = true;
70
+ }
71
+ }
72
+ return hasUnsupportedAlternative ? undefined : false;
73
+ }
74
+ function matchesVersionRangeAlternative(version, range) {
75
+ const versionParts = parseVersion(version);
76
+ if (versionParts === undefined) {
77
+ return undefined;
78
+ }
79
+ const tokens = range.split(/\s+/).filter(Boolean);
80
+ if (tokens.length === 0) {
81
+ return undefined;
82
+ }
83
+ for (const token of tokens) {
84
+ const wildcard = /^(\d+(?:\.\d+)*)\.(?:x|\*)$/i.exec(token);
85
+ if (wildcard !== null) {
86
+ const prefix = parseVersion(wildcard[1]);
87
+ if (prefix === undefined || !prefix.every((part, index) => versionParts[index] === part)) {
88
+ return false;
89
+ }
90
+ continue;
91
+ }
92
+ const shorthand = /^([~^])(\d+(?:\.\d+)*)$/.exec(token);
93
+ if (shorthand !== null) {
94
+ const lower = parseVersion(shorthand[2]);
95
+ if (lower === undefined || compareVersionParts(versionParts, lower) < 0) {
96
+ return false;
97
+ }
98
+ const upper = [...lower];
99
+ const bumpIndex = shorthand[1] === '~'
100
+ ? Math.min(1, upper.length - 1)
101
+ : Math.max(0, upper.findIndex((part) => part !== 0));
102
+ upper[bumpIndex] = (upper[bumpIndex] ?? 0) + 1;
103
+ upper.splice(bumpIndex + 1);
104
+ if (compareVersionParts(versionParts, upper) >= 0) {
105
+ return false;
106
+ }
107
+ continue;
108
+ }
109
+ const comparator = /^(>=|<=|>|<|=)?(\d+(?:\.\d+)*)$/.exec(token);
110
+ if (comparator === null) {
111
+ return undefined;
112
+ }
113
+ const expected = parseVersion(comparator[2]);
114
+ if (expected === undefined) {
115
+ return undefined;
116
+ }
117
+ const comparison = compareVersionParts(versionParts, expected);
118
+ const operator = comparator[1] ?? '=';
119
+ if ((operator === '>=' && comparison < 0) ||
120
+ (operator === '<=' && comparison > 0) ||
121
+ (operator === '>' && comparison <= 0) ||
122
+ (operator === '<' && comparison >= 0) ||
123
+ (operator === '=' && comparison !== 0)) {
124
+ return false;
125
+ }
126
+ }
127
+ return true;
128
+ }
129
+ function parseVersion(version) {
130
+ const normalized = version.trim().replace(/^v/i, '');
131
+ if (!/^\d+(?:\.\d+)*$/.test(normalized)) {
132
+ return undefined;
133
+ }
134
+ return normalized.split('.').map(Number);
135
+ }
136
+ function compareVersionParts(left, right) {
137
+ const length = Math.max(left.length, right.length);
138
+ for (let index = 0; index < length; index += 1) {
139
+ const delta = (left[index] ?? 0) - (right[index] ?? 0);
140
+ if (delta !== 0) {
141
+ return delta;
142
+ }
143
+ }
144
+ return 0;
145
+ }
146
+ //# sourceMappingURL=compatibility-matcher.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compatibility-matcher.js","sourceRoot":"","sources":["../../src/core/compatibility-matcher.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,sBAAsB,CACpC,aAAgC,EAChC,WAAyD;IAEzD,IAAI,aAAa,CAAC,KAAK,KAAK,kBAAkB,EAAE,CAAC;QAC/C,OAAO;YACL,aAAa,EAAE,kBAAkB;YACjC,MAAM,EAAE,0DAA0D;YAClE,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,CACvC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,kBAAkB,IAAI,CAAC,OAAO,EAAE,CAC5D;YACD,QAAQ,EAAE,EAAE;SACb,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,6CAA6C,CAAC;QAC9D,OAAO;YACL,aAAa,EAAE,SAAS;YACxB,MAAM,EAAE,OAAO;YACf,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,CAAC;SACvD,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,KAAK,MAAM,UAAU,IAAI,aAAa,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAChC,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI;YAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,UAAU,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAC/E,CAAC;QAEF,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAC/D,MAAM,OAAO,GAAG,GAAG,UAAU,CAAC,SAAS,uCAAuC,UAAU,CAAC,KAAK,GAAG,CAAC;YAClG,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,CAAC,CAAC;YACxD,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,mBAAmB,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;QACzE,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,eAAe,UAAU,CAAC,SAAS,mBAAmB,UAAU,CAAC,KAAK,GAAG,CAAC;YAC1F,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,2BAA2B,EAAE,OAAO,EAAE,CAAC,CAAC;YAC9D,SAAS;QACX,CAAC;QAED,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,aAAa,EAAE,cAAc;gBAC7B,MAAM,EAAE,GAAG,UAAU,CAAC,SAAS,IAAI,SAAS,CAAC,OAAO,qBAAqB,UAAU,CAAC,KAAK,GAAG;gBAC5F,QAAQ;gBACR,QAAQ;aACT,CAAC;QACJ,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,SAAS,IAAI,SAAS,CAAC,OAAO,cAAc,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,aAAa,EAAE,SAAS;YACxB,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAC5D,QAAQ;YACR,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,OAAO;QACL,aAAa,EAAE,YAAY;QAC3B,MAAM,EAAE,kEAAkE;QAC1E,QAAQ;QACR,QAAQ,EAAE,EAAE;KACb,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe,EAAE,KAAa;IACzD,MAAM,YAAY,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAClE,IAAI,yBAAyB,GAAG,KAAK,CAAC;IAEtC,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,8BAA8B,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACpE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,yBAAyB,GAAG,IAAI,CAAC;QACnC,CAAC;IACH,CAAC;IAED,OAAO,yBAAyB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;AACvD,CAAC;AAED,SAAS,8BAA8B,CAAC,OAAe,EAAE,KAAa;IACpE,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAC3C,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;gBACzF,OAAO,KAAK,CAAC;YACf,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,IAAI,KAAK,KAAK,SAAS,IAAI,mBAAmB,CAAC,YAAY,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxE,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC;YACzB,MAAM,SAAS,GACb,SAAS,CAAC,CAAC,CAAC,KAAK,GAAG;gBAClB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC/B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;YACzD,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;YAC/C,KAAK,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;YAC5B,IAAI,mBAAmB,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClD,OAAO,KAAK,CAAC;YACf,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,UAAU,GAAG,iCAAiC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjE,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,UAAU,GAAG,mBAAmB,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;QACtC,IACE,CAAC,QAAQ,KAAK,IAAI,IAAI,UAAU,GAAG,CAAC,CAAC;YACrC,CAAC,QAAQ,KAAK,IAAI,IAAI,UAAU,GAAG,CAAC,CAAC;YACrC,CAAC,QAAQ,KAAK,GAAG,IAAI,UAAU,IAAI,CAAC,CAAC;YACrC,CAAC,QAAQ,KAAK,GAAG,IAAI,UAAU,IAAI,CAAC,CAAC;YACrC,CAAC,QAAQ,KAAK,GAAG,IAAI,UAAU,KAAK,CAAC,CAAC,EACtC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,YAAY,CAAC,OAAe;IACnC,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACrD,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAuB,EAAE,KAAwB;IAC5E,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACnD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,IAAI,KAAK,KAAK,CAAC,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}
@@ -0,0 +1,22 @@
1
+ import type { SearchResult } from './search-types.js';
2
+ export type LessonDedupInput = {
3
+ title: string;
4
+ mistake: string;
5
+ fix: string;
6
+ language?: string;
7
+ tools: string[];
8
+ categories: string[];
9
+ };
10
+ export type LessonDedupClassification = 'duplicate' | 'related' | 'new';
11
+ export type LessonDedupCandidate = {
12
+ id: string;
13
+ title: string;
14
+ score: number;
15
+ reason: string;
16
+ };
17
+ export type LessonDedupResult = {
18
+ classification: LessonDedupClassification;
19
+ confidence: 'low' | 'medium' | 'high';
20
+ candidates: LessonDedupCandidate[];
21
+ };
22
+ export declare function classifyLessonDeduplication(input: LessonDedupInput, candidates: SearchResult[]): LessonDedupResult;
@@ -0,0 +1,54 @@
1
+ const DUPLICATE_THRESHOLD = 0.35;
2
+ const RELATED_THRESHOLD = 0.08;
3
+ export function classifyLessonDeduplication(input, candidates) {
4
+ if (candidates.length === 0) {
5
+ return {
6
+ classification: 'new',
7
+ confidence: 'high',
8
+ candidates: [],
9
+ };
10
+ }
11
+ const scored = candidates
12
+ .map((candidate) => scoreCandidate(input, candidate))
13
+ .sort((left, right) => right.score - left.score);
14
+ const best = scored[0];
15
+ if (best !== undefined && best.score >= DUPLICATE_THRESHOLD) {
16
+ return {
17
+ classification: 'duplicate',
18
+ confidence: 'high',
19
+ candidates: scored,
20
+ };
21
+ }
22
+ if (best !== undefined && best.score >= RELATED_THRESHOLD) {
23
+ return {
24
+ classification: 'related',
25
+ confidence: 'medium',
26
+ candidates: scored,
27
+ };
28
+ }
29
+ return {
30
+ classification: 'new',
31
+ confidence: 'medium',
32
+ candidates: scored,
33
+ };
34
+ }
35
+ function scoreCandidate(input, candidate) {
36
+ const inputText = [input.title, input.mistake, input.fix, ...input.tools, ...input.categories].join(' ');
37
+ const candidateText = [candidate.title, candidate.summary, candidate.fix].join(' ');
38
+ const inputTokens = tokenize(inputText);
39
+ const candidateTokens = tokenize(candidateText);
40
+ const overlap = Array.from(inputTokens).filter((token) => candidateTokens.has(token));
41
+ const unionSize = new Set([...inputTokens, ...candidateTokens]).size || 1;
42
+ const score = overlap.length / unionSize;
43
+ return {
44
+ id: candidate.id,
45
+ title: candidate.title,
46
+ score,
47
+ reason: `Text overlap ${overlap.length}/${unionSize}`,
48
+ };
49
+ }
50
+ function tokenize(text) {
51
+ const tokens = text.toLocaleLowerCase().match(/[\p{L}\p{N}_]+/gu) ?? [];
52
+ return new Set(tokens.filter((token) => token.length > 2));
53
+ }
54
+ //# sourceMappingURL=dedup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dedup.js","sourceRoot":"","sources":["../../src/core/dedup.ts"],"names":[],"mappings":"AA0BA,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACjC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B,MAAM,UAAU,2BAA2B,CACzC,KAAuB,EACvB,UAA0B;IAE1B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,cAAc,EAAE,KAAK;YACrB,UAAU,EAAE,MAAM;YAClB,UAAU,EAAE,EAAE;SACf,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,UAAU;SACtB,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;SACpD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAEvB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI,mBAAmB,EAAE,CAAC;QAC5D,OAAO;YACL,cAAc,EAAE,WAAW;YAC3B,UAAU,EAAE,MAAM;YAClB,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI,iBAAiB,EAAE,CAAC;QAC1D,OAAO;YACL,cAAc,EAAE,SAAS;YACzB,UAAU,EAAE,QAAQ;YACpB,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,cAAc,EAAE,KAAK;QACrB,UAAU,EAAE,QAAQ;QACpB,UAAU,EAAE,MAAM;KACnB,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,KAAuB,EACvB,SAAuB;IAEvB,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,IAAI,CACjG,GAAG,CACJ,CAAC;IACF,MAAM,aAAa,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpF,MAAM,WAAW,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,eAAe,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACtF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,WAAW,EAAE,GAAG,eAAe,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAEzC,OAAO;QACL,EAAE,EAAE,SAAS,CAAC,EAAE;QAChB,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,KAAK;QACL,MAAM,EAAE,gBAAgB,OAAO,CAAC,MAAM,IAAI,SAAS,EAAE;KACtD,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC;IACxE,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC"}
@@ -0,0 +1,15 @@
1
+ export type ErrorSignatureWarning = {
2
+ code: 'error_log_truncated';
3
+ message: string;
4
+ };
5
+ export type ErrorSignatureResult = {
6
+ signature: string;
7
+ queryText: string;
8
+ evidenceLines: string[];
9
+ truncated: boolean;
10
+ warnings: ErrorSignatureWarning[];
11
+ };
12
+ export type ExtractErrorSignatureOptions = {
13
+ maxEvidenceLines?: number;
14
+ };
15
+ export declare function extractErrorSignature(errorLog: string, options?: ExtractErrorSignatureOptions): ErrorSignatureResult;
@@ -0,0 +1,59 @@
1
+ const DEFAULT_MAX_EVIDENCE_LINES = 8;
2
+ const ERROR_MARKER_PATTERN = /\b(?:fatal error|error|exception|cannot find|no such module)\b/i;
3
+ export function extractErrorSignature(errorLog, options = {}) {
4
+ const maxEvidenceLines = options.maxEvidenceLines ?? DEFAULT_MAX_EVIDENCE_LINES;
5
+ const lines = collectNonEmptyLines(errorLog);
6
+ const markerIndex = findMarkerLineIndex(lines);
7
+ const signatureLine = markerIndex === -1 ? selectFallbackLine(lines) : normalizeSignatureLine(lines[markerIndex] ?? '');
8
+ const evidenceLines = selectEvidenceLines(lines, markerIndex, maxEvidenceLines);
9
+ const truncated = lines.length > evidenceLines.length;
10
+ return {
11
+ signature: signatureLine,
12
+ queryText: buildQueryText(signatureLine, evidenceLines),
13
+ evidenceLines,
14
+ truncated,
15
+ warnings: truncated
16
+ ? [
17
+ {
18
+ code: 'error_log_truncated',
19
+ message: `Error log was truncated to ${evidenceLines.length} evidence lines.`,
20
+ },
21
+ ]
22
+ : [],
23
+ };
24
+ }
25
+ function collectNonEmptyLines(errorLog) {
26
+ return errorLog
27
+ .split(/\r?\n/)
28
+ .map((line) => line.trim())
29
+ .filter((line) => line.length > 0);
30
+ }
31
+ function findMarkerLineIndex(lines) {
32
+ return lines.findIndex((line) => ERROR_MARKER_PATTERN.test(line));
33
+ }
34
+ function selectFallbackLine(lines) {
35
+ return lines[Math.floor(lines.length / 2)] ?? '';
36
+ }
37
+ function normalizeSignatureLine(line) {
38
+ const errorIndex = line.search(/\b(?:fatal error|error|exception)\b/i);
39
+ if (errorIndex === -1) {
40
+ return line;
41
+ }
42
+ return line.slice(errorIndex).trim();
43
+ }
44
+ function selectEvidenceLines(lines, markerIndex, maxEvidenceLines) {
45
+ if (lines.length <= maxEvidenceLines) {
46
+ return lines;
47
+ }
48
+ if (markerIndex === -1) {
49
+ return lines.slice(0, maxEvidenceLines);
50
+ }
51
+ const start = markerIndex;
52
+ return lines.slice(start, start + maxEvidenceLines);
53
+ }
54
+ function buildQueryText(signature, evidenceLines) {
55
+ return Array.from(new Set([signature, ...evidenceLines]))
56
+ .filter((line) => line.length > 0)
57
+ .join(' ');
58
+ }
59
+ //# sourceMappingURL=error-signature.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"error-signature.js","sourceRoot":"","sources":["../../src/core/error-signature.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ export type CanonicalFacetKind = 'language' | 'platforms' | 'tools' | 'categories';
2
+ export declare const FACET_ALIASES: Readonly<Record<string, string>>;
3
+ export declare function normalizeFacetValue(value: string): string;
4
+ export declare function listCanonicalFacetValues(): Record<CanonicalFacetKind, string[]>;
5
+ export declare function isKnownFacetValue(facet: CanonicalFacetKind, value: string): boolean;
6
+ export declare function normalizeFacetFilter(facet: CanonicalFacetKind, values: readonly string[]): {
7
+ values: string[];
8
+ unknown: string[];
9
+ };
@@ -0,0 +1,46 @@
1
+ export const FACET_ALIASES = {
2
+ osx: 'macos',
3
+ ts: 'typescript',
4
+ };
5
+ const canonicalFacetValues = {
6
+ language: new Set(['swift', 'kotlin', 'typescript', 'javascript', 'python', 'mcp', 'other']),
7
+ platforms: new Set(['android', 'ios', 'linux', 'macos', 'web', 'windows']),
8
+ tools: new Set([
9
+ 'agp',
10
+ 'cloudkit',
11
+ 'gradle',
12
+ 'jdk',
13
+ 'mcp',
14
+ 'node',
15
+ 'sqlite',
16
+ 'swiftdata',
17
+ 'typescript',
18
+ 'vitest',
19
+ 'xcode',
20
+ 'zod',
21
+ ]),
22
+ categories: new Set(['build', 'persistence', 'storage', 'sync', 'testing']),
23
+ };
24
+ export function normalizeFacetValue(value) {
25
+ const normalized = value.trim().toLowerCase();
26
+ return FACET_ALIASES[normalized] ?? normalized;
27
+ }
28
+ export function listCanonicalFacetValues() {
29
+ return {
30
+ language: Array.from(canonicalFacetValues.language).sort(),
31
+ platforms: Array.from(canonicalFacetValues.platforms).sort(),
32
+ tools: Array.from(canonicalFacetValues.tools).sort(),
33
+ categories: Array.from(canonicalFacetValues.categories).sort(),
34
+ };
35
+ }
36
+ export function isKnownFacetValue(facet, value) {
37
+ return canonicalFacetValues[facet].has(normalizeFacetValue(value));
38
+ }
39
+ export function normalizeFacetFilter(facet, values) {
40
+ const normalized = Array.from(new Set(values.map(normalizeFacetValue)));
41
+ return {
42
+ values: normalized,
43
+ unknown: normalized.filter((value) => !canonicalFacetValues[facet].has(value)),
44
+ };
45
+ }
46
+ //# sourceMappingURL=facets.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"facets.js","sourceRoot":"","sources":["../../src/core/facets.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAqC;IAC7D,GAAG,EAAE,OAAO;IACZ,EAAE,EAAE,YAAY;CACjB,CAAC;AAEF,MAAM,oBAAoB,GAAoD;IAC5E,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC5F,SAAS,EAAE,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;IAC1E,KAAK,EAAE,IAAI,GAAG,CAAC;QACb,KAAK;QACL,UAAU;QACV,QAAQ;QACR,KAAK;QACL,KAAK;QACL,MAAM;QACN,QAAQ;QACR,WAAW;QACX,YAAY;QACZ,QAAQ;QACR,OAAO;QACP,KAAK;KACN,CAAC;IACF,UAAU,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;CAC5E,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC9C,OAAO,aAAa,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE;QAC1D,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE;QAC5D,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE;QACpD,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE;KAC/D,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAyB,EAAE,KAAa;IACxE,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,KAAyB,EACzB,MAAyB;IAEzB,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACxE,OAAO;QACL,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;KAC/E,CAAC;AACJ,CAAC"}
@@ -0,0 +1,30 @@
1
+ export { collectUnknownFacetWarnings, isKnownFacetValue, LegacyRuleSchema, RuleActivationSchema, RuleConfidenceSchema, RuleLanguageSchema, RuleProvenanceSchema, RuleSchema, RuleScopeSchema, RuleStatusSchema, toLegacyRuleCandidate, } from './rule-schema.js';
2
+ export { CompatibilityComponentKindSchema, CompatibilityConstraintSchema, CompatibilityScopeSchema, RuleCompatibilitySchema, VerifiedComponentSchema, } from './rule-compatibility.js';
3
+ export { rankSearchResults, scoreSearchResult } from './ranker.js';
4
+ export { matchRuleCompatibility } from './compatibility-matcher.js';
5
+ export { FACET_ALIASES, listCanonicalFacetValues, normalizeFacetFilter, normalizeFacetValue, } from './facets.js';
6
+ export type { CanonicalFacetKind } from './facets.js';
7
+ export { resolveRulebookHome } from './paths.js';
8
+ export { parseRuleYaml, validateRuleInput } from './rule-parser.js';
9
+ export { redactSecretText, redactSensitiveText, scanRuleDraftForRedactions } from './redaction.js';
10
+ export { buildRulePreview } from './rule-writer.js';
11
+ export { extractLessonCandidatesFromMarkdown } from './lesson-importer.js';
12
+ export { detectProjectStack } from './stack-detector.js';
13
+ export { detectProjectEnvironment } from './project-environment-detector.js';
14
+ export { extractErrorSignature } from './error-signature.js';
15
+ export { classifyLessonDeduplication } from './dedup.js';
16
+ export { generateRuleIdentity, slugifyTitle } from './slug.js';
17
+ export type { ResolveRulebookHomeOptions } from './paths.js';
18
+ export type { CompatibilityEnvironmentComponent, CompatibilityMatch, CompatibilityWarning, } from './compatibility-matcher.js';
19
+ export type { LegacyRuleDocument, LoadedRule, Rule, RuleActivation, RuleConfidence, RuleFacetWarning, RuleLanguage, RuleProvenance, RuleScope, RuleStatus, RuleV2, } from './rule-schema.js';
20
+ export type { CompatibilityComponentKind, CompatibilityConstraint, CompatibilityScope, RuleCompatibility, VerifiedComponent, } from './rule-compatibility.js';
21
+ export type { RedactionScanOptions, RedactionScanResult, RedactionWarning, RedactionWarningKind, RuleDraftRedactionInput, SuggestedRedaction, } from './redaction.js';
22
+ export type { BuildRulePreviewOptions, RuleDraftInput, RulePreview } from './rule-writer.js';
23
+ export type { ExtractLessonCandidatesOptions, LessonImportCandidate, LessonImportResult, SkippedLesson, } from './lesson-importer.js';
24
+ export type { DetectProjectStackOptions, ProjectStack, ProjectStackDetectorResult, ProjectStackMarker, ProjectStackMarkerKind, ProjectStackSearchHints, ProjectStackWarning, } from './stack-detector.js';
25
+ export type { ProjectEnvironmentComponent, ProjectEnvironmentEvidence, ProjectEnvironmentResult, ProjectEnvironmentWarning, } from './project-environment-detector.js';
26
+ export type { ErrorSignatureResult, ErrorSignatureWarning, ExtractErrorSignatureOptions, } from './error-signature.js';
27
+ export type { LessonDedupCandidate, LessonDedupClassification, LessonDedupInput, LessonDedupResult, } from './dedup.js';
28
+ export type { GeneratedRuleIdentity, GenerateRuleIdentityOptions } from './slug.js';
29
+ export type { RankableSearchCandidate, SearchFilters, SearchLimitPolicy, SearchQuery, SearchResponse, SearchResult, SearchDiagnostic, } from './search-types.js';
30
+ export type { RuleParseError, RuleParseOptions, RuleParseResult, RuleValidationIssue, } from './rule-parser.js';
@@ -0,0 +1,16 @@
1
+ export { collectUnknownFacetWarnings, isKnownFacetValue, LegacyRuleSchema, RuleActivationSchema, RuleConfidenceSchema, RuleLanguageSchema, RuleProvenanceSchema, RuleSchema, RuleScopeSchema, RuleStatusSchema, toLegacyRuleCandidate, } from './rule-schema.js';
2
+ export { CompatibilityComponentKindSchema, CompatibilityConstraintSchema, CompatibilityScopeSchema, RuleCompatibilitySchema, VerifiedComponentSchema, } from './rule-compatibility.js';
3
+ export { rankSearchResults, scoreSearchResult } from './ranker.js';
4
+ export { matchRuleCompatibility } from './compatibility-matcher.js';
5
+ export { FACET_ALIASES, listCanonicalFacetValues, normalizeFacetFilter, normalizeFacetValue, } from './facets.js';
6
+ export { resolveRulebookHome } from './paths.js';
7
+ export { parseRuleYaml, validateRuleInput } from './rule-parser.js';
8
+ export { redactSecretText, redactSensitiveText, scanRuleDraftForRedactions } from './redaction.js';
9
+ export { buildRulePreview } from './rule-writer.js';
10
+ export { extractLessonCandidatesFromMarkdown } from './lesson-importer.js';
11
+ export { detectProjectStack } from './stack-detector.js';
12
+ export { detectProjectEnvironment } from './project-environment-detector.js';
13
+ export { extractErrorSignature } from './error-signature.js';
14
+ export { classifyLessonDeduplication } from './dedup.js';
15
+ export { generateRuleIdentity, slugifyTitle } from './slug.js';
16
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2BAA2B,EAC3B,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,gCAAgC,EAChC,6BAA6B,EAC7B,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AACnG,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,mCAAmC,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC"}
@@ -0,0 +1,22 @@
1
+ import type { RuleLanguage } from './rule-schema.js';
2
+ export type LessonImportCandidate = {
3
+ title: string;
4
+ language?: RuleLanguage;
5
+ categories: string[];
6
+ mistake: string;
7
+ fix: string;
8
+ source_project?: string;
9
+ };
10
+ export type SkippedLesson = {
11
+ index: number;
12
+ reason: string;
13
+ };
14
+ export type LessonImportResult = {
15
+ candidates: LessonImportCandidate[];
16
+ skipped: SkippedLesson[];
17
+ };
18
+ export type ExtractLessonCandidatesOptions = {
19
+ defaultLanguage?: RuleLanguage;
20
+ sourceProject?: string;
21
+ };
22
+ export declare function extractLessonCandidatesFromMarkdown(source: string, options?: ExtractLessonCandidatesOptions): LessonImportResult;
@@ -0,0 +1,94 @@
1
+ import { parse as parseYaml } from 'yaml';
2
+ export function extractLessonCandidatesFromMarkdown(source, options = {}) {
3
+ const lessonsYaml = extractLessonsYaml(source);
4
+ if (lessonsYaml === undefined) {
5
+ return { candidates: [], skipped: [] };
6
+ }
7
+ const parsed = parseYaml(lessonsYaml);
8
+ const lessons = Array.isArray(parsed?.lessons) ? parsed.lessons : [];
9
+ const candidates = [];
10
+ const skipped = [];
11
+ lessons.forEach((lesson, index) => {
12
+ const item = toLessonItem(lesson);
13
+ const fields = readLessonFields(item);
14
+ if (!fields.success) {
15
+ skipped.push({
16
+ index,
17
+ reason: `Missing required lesson fields: ${fields.missing.join(', ')}`,
18
+ });
19
+ return;
20
+ }
21
+ const candidate = {
22
+ title: fields.title,
23
+ categories: fields.categories,
24
+ mistake: fields.mistake,
25
+ fix: fields.fix,
26
+ };
27
+ if (options.defaultLanguage !== undefined) {
28
+ candidate.language = options.defaultLanguage;
29
+ }
30
+ if (options.sourceProject !== undefined) {
31
+ candidate.source_project = options.sourceProject;
32
+ }
33
+ candidates.push(candidate);
34
+ });
35
+ return { candidates, skipped };
36
+ }
37
+ function extractLessonsYaml(source) {
38
+ const lines = source.split(/\r?\n/);
39
+ const startIndex = lines.findIndex((line) => /^lessons:\s*$/.test(line));
40
+ if (startIndex === -1) {
41
+ return undefined;
42
+ }
43
+ const selected = [lines[startIndex]];
44
+ for (const line of lines.slice(startIndex + 1)) {
45
+ if (line.trim() === '') {
46
+ selected.push(line);
47
+ continue;
48
+ }
49
+ if (/^\s/.test(line)) {
50
+ selected.push(line);
51
+ continue;
52
+ }
53
+ break;
54
+ }
55
+ return selected.join('\n');
56
+ }
57
+ function toLessonItem(value) {
58
+ return typeof value === 'object' && value !== null ? value : {};
59
+ }
60
+ function readLessonFields(item) {
61
+ const title = trimString(item.title);
62
+ const mistake = trimString(item.mistake);
63
+ const fix = trimString(item.fix);
64
+ const missing = [];
65
+ if (mistake === undefined) {
66
+ missing.push('mistake');
67
+ }
68
+ if (fix === undefined) {
69
+ missing.push('fix');
70
+ }
71
+ if (mistake === undefined || fix === undefined) {
72
+ return { success: false, missing };
73
+ }
74
+ return {
75
+ success: true,
76
+ title: title ?? mistake,
77
+ categories: collectCategories(item),
78
+ mistake,
79
+ fix,
80
+ };
81
+ }
82
+ function collectCategories(item) {
83
+ if (Array.isArray(item.categories)) {
84
+ return item.categories.filter(isNonEmptyString).map((category) => category.trim());
85
+ }
86
+ return isNonEmptyString(item.category) ? [item.category.trim()] : [];
87
+ }
88
+ function isNonEmptyString(value) {
89
+ return typeof value === 'string' && value.trim().length > 0;
90
+ }
91
+ function trimString(value) {
92
+ return isNonEmptyString(value) ? value.trim() : undefined;
93
+ }
94
+ //# sourceMappingURL=lesson-importer.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lesson-importer.js","sourceRoot":"","sources":["../../src/core/lesson-importer.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ export type ResolveRulebookHomeOptions = {
2
+ env?: NodeJS.ProcessEnv;
3
+ homeDir?: string;
4
+ };
5
+ export declare function resolveRulebookHome(options?: ResolveRulebookHomeOptions): string;
@@ -0,0 +1,11 @@
1
+ import { homedir } from 'node:os';
2
+ import { join, resolve } from 'node:path';
3
+ export function resolveRulebookHome(options = {}) {
4
+ const env = options.env ?? process.env;
5
+ const override = env.AGENT_RULEBOOK_HOME?.trim();
6
+ if (override) {
7
+ return resolve(override);
8
+ }
9
+ return join(options.homeDir ?? homedir(), '.agent-rulebook');
10
+ }
11
+ //# sourceMappingURL=paths.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/core/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAO1C,MAAM,UAAU,mBAAmB,CAAC,UAAsC,EAAE;IAC1E,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,QAAQ,GAAG,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;IAEjD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;AAC/D,CAAC"}
@@ -0,0 +1,43 @@
1
+ import type { CompatibilityComponentKind } from './rule-compatibility.js';
2
+ import type { DetectProjectStackOptions, ProjectStack } from './stack-detector.js';
3
+ export type ProjectEnvironmentEvidence = {
4
+ relativePath: string;
5
+ locator: string;
6
+ value: string | null;
7
+ };
8
+ export type ProjectEnvironmentComponent = {
9
+ kind: CompatibilityComponentKind;
10
+ name: string;
11
+ version: string;
12
+ evidence: ProjectEnvironmentEvidence[];
13
+ };
14
+ export type ProjectEnvironmentWarning = {
15
+ code: 'scan_limit_exceeded' | 'conflicting_component_evidence';
16
+ message: string;
17
+ sources?: string[];
18
+ };
19
+ export type ProjectEnvironmentResult = {
20
+ status: 'ok';
21
+ projectPath: string;
22
+ stacks: ProjectStack[];
23
+ components: ProjectEnvironmentComponent[];
24
+ warnings: ProjectEnvironmentWarning[];
25
+ partial: boolean;
26
+ } | {
27
+ status: 'no_stack';
28
+ projectPath: string;
29
+ stacks: [];
30
+ components: [];
31
+ warnings: ProjectEnvironmentWarning[];
32
+ partial: boolean;
33
+ } | {
34
+ status: 'error';
35
+ code: 'path_not_found' | 'path_not_directory' | 'access_denied';
36
+ projectPath: string;
37
+ message: string;
38
+ stacks: [];
39
+ components: [];
40
+ warnings: [];
41
+ partial: false;
42
+ };
43
+ export declare function detectProjectEnvironment(projectPath: string, options?: DetectProjectStackOptions): Promise<ProjectEnvironmentResult>;