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.
- package/LICENSE +4 -0
- package/README.md +66 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +4 -0
- package/dist/cli.js.map +1 -0
- package/dist/commands/add.d.ts +2 -0
- package/dist/commands/add.js +134 -0
- package/dist/commands/add.js.map +1 -0
- package/dist/commands/index.d.ts +3 -0
- package/dist/commands/index.js +41 -0
- package/dist/commands/index.js.map +1 -0
- package/dist/commands/init.d.ts +2 -0
- package/dist/commands/init.js +17 -0
- package/dist/commands/init.js.map +1 -0
- package/dist/commands/mcp.d.ts +2 -0
- package/dist/commands/mcp.js +17 -0
- package/dist/commands/mcp.js.map +1 -0
- package/dist/commands/migrate.d.ts +2 -0
- package/dist/commands/migrate.js +73 -0
- package/dist/commands/migrate.js.map +1 -0
- package/dist/commands/output.d.ts +6 -0
- package/dist/commands/output.js +49 -0
- package/dist/commands/output.js.map +1 -0
- package/dist/commands/search.d.ts +2 -0
- package/dist/commands/search.js +57 -0
- package/dist/commands/search.js.map +1 -0
- package/dist/core/compatibility-matcher.d.ts +17 -0
- package/dist/core/compatibility-matcher.js +146 -0
- package/dist/core/compatibility-matcher.js.map +1 -0
- package/dist/core/dedup.d.ts +22 -0
- package/dist/core/dedup.js +54 -0
- package/dist/core/dedup.js.map +1 -0
- package/dist/core/error-signature.d.ts +15 -0
- package/dist/core/error-signature.js +59 -0
- package/dist/core/error-signature.js.map +1 -0
- package/dist/core/facets.d.ts +9 -0
- package/dist/core/facets.js +46 -0
- package/dist/core/facets.js.map +1 -0
- package/dist/core/index.d.ts +30 -0
- package/dist/core/index.js +16 -0
- package/dist/core/index.js.map +1 -0
- package/dist/core/lesson-importer.d.ts +22 -0
- package/dist/core/lesson-importer.js +94 -0
- package/dist/core/lesson-importer.js.map +1 -0
- package/dist/core/paths.d.ts +5 -0
- package/dist/core/paths.js +11 -0
- package/dist/core/paths.js.map +1 -0
- package/dist/core/project-environment-detector.d.ts +43 -0
- package/dist/core/project-environment-detector.js +464 -0
- package/dist/core/project-environment-detector.js.map +1 -0
- package/dist/core/ranker.d.ts +3 -0
- package/dist/core/ranker.js +47 -0
- package/dist/core/ranker.js.map +1 -0
- package/dist/core/redaction.d.ts +35 -0
- package/dist/core/redaction.js +149 -0
- package/dist/core/redaction.js.map +1 -0
- package/dist/core/rule-compatibility.d.ts +66 -0
- package/dist/core/rule-compatibility.js +53 -0
- package/dist/core/rule-compatibility.js.map +1 -0
- package/dist/core/rule-parser.d.ts +25 -0
- package/dist/core/rule-parser.js +81 -0
- package/dist/core/rule-parser.js.map +1 -0
- package/dist/core/rule-schema.d.ts +231 -0
- package/dist/core/rule-schema.js +184 -0
- package/dist/core/rule-schema.js.map +1 -0
- package/dist/core/rule-writer.d.ts +35 -0
- package/dist/core/rule-writer.js +63 -0
- package/dist/core/rule-writer.js.map +1 -0
- package/dist/core/search-types.d.ts +51 -0
- package/dist/core/search-types.js +2 -0
- package/dist/core/search-types.js.map +1 -0
- package/dist/core/slug.d.ts +13 -0
- package/dist/core/slug.js +42 -0
- package/dist/core/slug.js.map +1 -0
- package/dist/core/stack-detector.d.ts +56 -0
- package/dist/core/stack-detector.js +358 -0
- package/dist/core/stack-detector.js.map +1 -0
- package/dist/index.d.ts +5 -0
- package/dist/index.js +4 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp/index.d.ts +7 -0
- package/dist/mcp/index.js +5 -0
- package/dist/mcp/index.js.map +1 -0
- package/dist/mcp/lesson-capture.d.ts +30 -0
- package/dist/mcp/lesson-capture.js +146 -0
- package/dist/mcp/lesson-capture.js.map +1 -0
- package/dist/mcp/rules-add-lesson-tool.d.ts +4 -0
- package/dist/mcp/rules-add-lesson-tool.js +73 -0
- package/dist/mcp/rules-add-lesson-tool.js.map +1 -0
- package/dist/mcp/rules-dedup-lesson-tool.d.ts +4 -0
- package/dist/mcp/rules-dedup-lesson-tool.js +69 -0
- package/dist/mcp/rules-dedup-lesson-tool.js.map +1 -0
- package/dist/mcp/rules-list-facets-tool.d.ts +3 -0
- package/dist/mcp/rules-list-facets-tool.js +31 -0
- package/dist/mcp/rules-list-facets-tool.js.map +1 -0
- package/dist/mcp/rules-prepare-lesson-tool.d.ts +4 -0
- package/dist/mcp/rules-prepare-lesson-tool.js +7 -0
- package/dist/mcp/rules-prepare-lesson-tool.js.map +1 -0
- package/dist/mcp/rules-search-error-tool.d.ts +4 -0
- package/dist/mcp/rules-search-error-tool.js +99 -0
- package/dist/mcp/rules-search-error-tool.js.map +1 -0
- package/dist/mcp/rules-search-for-project-tool.d.ts +4 -0
- package/dist/mcp/rules-search-for-project-tool.js +103 -0
- package/dist/mcp/rules-search-for-project-tool.js.map +1 -0
- package/dist/mcp/rules-search-tool.d.ts +7 -0
- package/dist/mcp/rules-search-tool.js +65 -0
- package/dist/mcp/rules-search-tool.js.map +1 -0
- package/dist/mcp/schemas.d.ts +222 -0
- package/dist/mcp/schemas.js +99 -0
- package/dist/mcp/schemas.js.map +1 -0
- package/dist/mcp/server.d.ts +5 -0
- package/dist/mcp/server.js +29 -0
- package/dist/mcp/server.js.map +1 -0
- package/dist/mcp/tool-output.d.ts +32 -0
- package/dist/mcp/tool-output.js +74 -0
- package/dist/mcp/tool-output.js.map +1 -0
- package/dist/mcp/tools.d.ts +300 -0
- package/dist/mcp/tools.js +123 -0
- package/dist/mcp/tools.js.map +1 -0
- package/dist/migration/adapters/fenced-lessons.d.ts +2 -0
- package/dist/migration/adapters/fenced-lessons.js +55 -0
- package/dist/migration/adapters/fenced-lessons.js.map +1 -0
- package/dist/migration/adapters/global-rules.d.ts +2 -0
- package/dist/migration/adapters/global-rules.js +72 -0
- package/dist/migration/adapters/global-rules.js.map +1 -0
- package/dist/migration/adapters/index.d.ts +2 -0
- package/dist/migration/adapters/index.js +13 -0
- package/dist/migration/adapters/index.js.map +1 -0
- package/dist/migration/adapters/markdown-lessons.d.ts +2 -0
- package/dist/migration/adapters/markdown-lessons.js +36 -0
- package/dist/migration/adapters/markdown-lessons.js.map +1 -0
- package/dist/migration/adapters/structured-lessons.d.ts +2 -0
- package/dist/migration/adapters/structured-lessons.js +8 -0
- package/dist/migration/adapters/structured-lessons.js.map +1 -0
- package/dist/migration/adapters/structured-shared.d.ts +3 -0
- package/dist/migration/adapters/structured-shared.js +97 -0
- package/dist/migration/adapters/structured-shared.js.map +1 -0
- package/dist/migration/applier.d.ts +32 -0
- package/dist/migration/applier.js +469 -0
- package/dist/migration/applier.js.map +1 -0
- package/dist/migration/index.d.ts +11 -0
- package/dist/migration/index.js +7 -0
- package/dist/migration/index.js.map +1 -0
- package/dist/migration/manifest.d.ts +262 -0
- package/dist/migration/manifest.js +89 -0
- package/dist/migration/manifest.js.map +1 -0
- package/dist/migration/migration-report.d.ts +147 -0
- package/dist/migration/migration-report.js +81 -0
- package/dist/migration/migration-report.js.map +1 -0
- package/dist/migration/scanner.d.ts +2 -0
- package/dist/migration/scanner.js +314 -0
- package/dist/migration/scanner.js.map +1 -0
- package/dist/migration/source-adapter.d.ts +37 -0
- package/dist/migration/source-adapter.js +2 -0
- package/dist/migration/source-adapter.js.map +1 -0
- package/dist/migration/verifier.d.ts +5 -0
- package/dist/migration/verifier.js +217 -0
- package/dist/migration/verifier.js.map +1 -0
- package/dist/program.d.ts +2 -0
- package/dist/program.js +21 -0
- package/dist/program.js.map +1 -0
- package/dist/storage/index-check.d.ts +19 -0
- package/dist/storage/index-check.js +114 -0
- package/dist/storage/index-check.js.map +1 -0
- package/dist/storage/index.d.ts +15 -0
- package/dist/storage/index.js +9 -0
- package/dist/storage/index.js.map +1 -0
- package/dist/storage/indexer.d.ts +19 -0
- package/dist/storage/indexer.js +354 -0
- package/dist/storage/indexer.js.map +1 -0
- package/dist/storage/migrations.d.ts +3 -0
- package/dist/storage/migrations.js +110 -0
- package/dist/storage/migrations.js.map +1 -0
- package/dist/storage/rule-discovery.d.ts +4 -0
- package/dist/storage/rule-discovery.js +34 -0
- package/dist/storage/rule-discovery.js.map +1 -0
- package/dist/storage/rule-store.d.ts +10 -0
- package/dist/storage/rule-store.js +12 -0
- package/dist/storage/rule-store.js.map +1 -0
- package/dist/storage/rulebook-home.d.ts +21 -0
- package/dist/storage/rulebook-home.js +75 -0
- package/dist/storage/rulebook-home.js.map +1 -0
- package/dist/storage/search-service.d.ts +17 -0
- package/dist/storage/search-service.js +252 -0
- package/dist/storage/search-service.js.map +1 -0
- package/dist/storage/sqlite-errors.d.ts +26 -0
- package/dist/storage/sqlite-errors.js +55 -0
- package/dist/storage/sqlite-errors.js.map +1 -0
- package/dist/storage/sqlite.d.ts +13 -0
- package/dist/storage/sqlite.js +34 -0
- package/dist/storage/sqlite.js.map +1 -0
- 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":"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"}
|
|
@@ -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":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAoD1C,MAAM,UAAU,mCAAmC,CACjD,MAAc,EACd,UAA0C,EAAE;IAE5C,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,CAA8B,CAAC;IACnE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChC,MAAM,IAAI,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEtC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC;gBACX,KAAK;gBACL,MAAM,EAAE,mCAAmC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;aACvE,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,SAAS,GAA0B;YACvC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG,EAAE,MAAM,CAAC,GAAG;SAChB,CAAC;QAEF,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YAC1C,SAAS,CAAC,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC;QAC/C,CAAC;QACD,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACxC,SAAS,CAAC,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;QACnD,CAAC;QAED,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAc;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAEzE,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,EAAE,CAAC;QAC/C,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACvB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QAED,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACrB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QAED,MAAM;IACR,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAE,KAAoB,CAAC,CAAC,CAAC,EAAE,CAAC;AAClF,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAgB;IACxC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QAC/C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACrC,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,KAAK,EAAE,KAAK,IAAI,OAAO;QACvB,UAAU,EAAE,iBAAiB,CAAC,IAAI,CAAC;QACnC,OAAO;QACP,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAgB;IACzC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACvE,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5D,CAAC"}
|
|
@@ -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>;
|