agent-rulebook 0.1.7 → 0.2.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/README.md +54 -143
- package/dist/commands/index.js +11 -10
- package/dist/commands/index.js.map +1 -1
- package/dist/commands/init.js +3 -6
- package/dist/commands/init.js.map +1 -1
- package/dist/commands/output.d.ts +0 -5
- package/dist/commands/output.js +0 -47
- package/dist/commands/output.js.map +1 -1
- package/dist/commands/project.d.ts +2 -0
- package/dist/commands/project.js +33 -0
- package/dist/commands/project.js.map +1 -0
- package/dist/commands/resolution.d.ts +2 -0
- package/dist/commands/resolution.js +32 -0
- package/dist/commands/resolution.js.map +1 -0
- package/dist/commands/sync.d.ts +6 -3
- package/dist/commands/sync.js +130 -177
- package/dist/commands/sync.js.map +1 -1
- package/dist/core/attempt-outcome.d.ts +21 -0
- package/dist/core/attempt-outcome.js +61 -0
- package/dist/core/attempt-outcome.js.map +1 -0
- package/dist/core/change-policy.d.ts +7 -0
- package/dist/core/change-policy.js +14 -0
- package/dist/core/change-policy.js.map +1 -0
- package/dist/core/index.d.ts +34 -33
- package/dist/core/index.js +18 -14
- package/dist/core/index.js.map +1 -1
- package/dist/core/outcome-schema.d.ts +55 -0
- package/dist/core/outcome-schema.js +44 -0
- package/dist/core/outcome-schema.js.map +1 -0
- package/dist/core/problem-fingerprint.d.ts +4 -0
- package/dist/core/problem-fingerprint.js +37 -0
- package/dist/core/problem-fingerprint.js.map +1 -0
- package/dist/core/problem-schema.d.ts +34 -0
- package/dist/core/problem-schema.js +37 -0
- package/dist/core/problem-schema.js.map +1 -0
- package/dist/core/project-environment-detector.d.ts +2 -2
- package/dist/core/project-environment-detector.js +8 -52
- package/dist/core/project-environment-detector.js.map +1 -1
- package/dist/core/project-file-scan.d.ts +17 -0
- package/dist/core/project-file-scan.js +73 -0
- package/dist/core/project-file-scan.js.map +1 -0
- package/dist/core/project-registry.d.ts +8 -0
- package/dist/core/project-registry.js +38 -0
- package/dist/core/project-registry.js.map +1 -0
- package/dist/core/repository-identity.d.ts +7 -0
- package/dist/core/repository-identity.js +27 -0
- package/dist/core/repository-identity.js.map +1 -0
- package/dist/core/resolution-applicability.d.ts +20 -0
- package/dist/core/resolution-applicability.js +38 -0
- package/dist/core/resolution-applicability.js.map +1 -0
- package/dist/core/resolution-parser.d.ts +20 -0
- package/dist/core/resolution-parser.js +47 -0
- package/dist/core/resolution-parser.js.map +1 -0
- package/dist/core/resolution-ranker.d.ts +34 -0
- package/dist/core/resolution-ranker.js +40 -0
- package/dist/core/resolution-ranker.js.map +1 -0
- package/dist/core/resolution-relation.d.ts +14 -0
- package/dist/core/resolution-relation.js +29 -0
- package/dist/core/resolution-relation.js.map +1 -0
- package/dist/core/resolution-schema.d.ts +109 -0
- package/dist/core/resolution-schema.js +29 -0
- package/dist/core/resolution-schema.js.map +1 -0
- package/dist/core/resolution-search-types.d.ts +37 -0
- package/dist/core/resolution-search-types.js +2 -0
- package/dist/core/resolution-search-types.js.map +1 -0
- package/dist/core/resolution-semantic-checksum.d.ts +12 -0
- package/dist/core/resolution-semantic-checksum.js +24 -0
- package/dist/core/resolution-semantic-checksum.js.map +1 -0
- package/dist/core/resolution-writer.d.ts +7 -0
- package/dist/core/resolution-writer.js +33 -0
- package/dist/core/resolution-writer.js.map +1 -0
- package/dist/core/solution-schema.d.ts +42 -0
- package/dist/core/solution-schema.js +28 -0
- package/dist/core/solution-schema.js.map +1 -0
- package/dist/core/source-evidence-schema.d.ts +26 -0
- package/dist/core/source-evidence-schema.js +29 -0
- package/dist/core/source-evidence-schema.js.map +1 -0
- package/dist/core/source-evidence.d.ts +14 -0
- package/dist/core/source-evidence.js +69 -0
- package/dist/core/source-evidence.js.map +1 -0
- package/dist/core/stack-detector.d.ts +2 -2
- package/dist/core/stack-detector.js +11 -63
- package/dist/core/stack-detector.js.map +1 -1
- package/dist/index.d.ts +3 -4
- package/dist/index.js +2 -2
- package/dist/index.js.map +1 -1
- package/dist/mcp/index.d.ts +3 -3
- package/dist/mcp/index.js +2 -2
- package/dist/mcp/index.js.map +1 -1
- package/dist/mcp/resolution-change.d.ts +19 -0
- package/dist/mcp/resolution-change.js +136 -0
- package/dist/mcp/resolution-change.js.map +1 -0
- package/dist/mcp/resolutions-commit-change-tool.d.ts +5 -0
- package/dist/mcp/resolutions-commit-change-tool.js +21 -0
- package/dist/mcp/resolutions-commit-change-tool.js.map +1 -0
- package/dist/mcp/resolutions-find-tool.d.ts +5 -0
- package/dist/mcp/resolutions-find-tool.js +75 -0
- package/dist/mcp/resolutions-find-tool.js.map +1 -0
- package/dist/mcp/resolutions-get-source-tool.d.ts +5 -0
- package/dist/mcp/resolutions-get-source-tool.js +30 -0
- package/dist/mcp/resolutions-get-source-tool.js.map +1 -0
- package/dist/mcp/resolutions-get-tool.d.ts +5 -0
- package/dist/mcp/resolutions-get-tool.js +27 -0
- package/dist/mcp/resolutions-get-tool.js.map +1 -0
- package/dist/mcp/resolutions-list-facets-tool.d.ts +4 -0
- package/dist/mcp/resolutions-list-facets-tool.js +18 -0
- package/dist/mcp/resolutions-list-facets-tool.js.map +1 -0
- package/dist/mcp/resolutions-prepare-change-tool.d.ts +5 -0
- package/dist/mcp/resolutions-prepare-change-tool.js +7 -0
- package/dist/mcp/resolutions-prepare-change-tool.js.map +1 -0
- package/dist/mcp/resolutions-report-attempt-tool.d.ts +5 -0
- package/dist/mcp/resolutions-report-attempt-tool.js +87 -0
- package/dist/mcp/resolutions-report-attempt-tool.js.map +1 -0
- package/dist/mcp/schemas.d.ts +265 -197
- package/dist/mcp/schemas.js +28 -93
- package/dist/mcp/schemas.js.map +1 -1
- package/dist/mcp/tool-output.d.ts +0 -34
- package/dist/mcp/tool-output.js +2 -71
- package/dist/mcp/tool-output.js.map +1 -1
- package/dist/mcp/tools.d.ts +973 -204
- package/dist/mcp/tools.js +47 -101
- package/dist/mcp/tools.js.map +1 -1
- package/dist/program.js +5 -9
- package/dist/program.js.map +1 -1
- package/dist/storage/index.d.ts +10 -15
- package/dist/storage/index.js +8 -8
- package/dist/storage/index.js.map +1 -1
- package/dist/storage/project-code-index-source.d.ts +2 -0
- package/dist/storage/project-code-index-source.js +23 -0
- package/dist/storage/project-code-index-source.js.map +1 -0
- package/dist/storage/resolution-candidate-service.d.ts +6 -0
- package/dist/storage/resolution-candidate-service.js +94 -0
- package/dist/storage/resolution-candidate-service.js.map +1 -0
- package/dist/storage/resolution-change-transaction.d.ts +11 -0
- package/dist/storage/resolution-change-transaction.js +56 -0
- package/dist/storage/resolution-change-transaction.js.map +1 -0
- package/dist/storage/resolution-home.d.ts +20 -0
- package/dist/storage/resolution-home.js +59 -0
- package/dist/storage/resolution-home.js.map +1 -0
- package/dist/storage/resolution-index-check.d.ts +28 -0
- package/dist/storage/resolution-index-check.js +30 -0
- package/dist/storage/resolution-index-check.js.map +1 -0
- package/dist/storage/resolution-indexer.d.ts +19 -0
- package/dist/storage/resolution-indexer.js +158 -0
- package/dist/storage/resolution-indexer.js.map +1 -0
- package/dist/storage/resolution-migrations.d.ts +3 -0
- package/dist/storage/resolution-migrations.js +39 -0
- package/dist/storage/resolution-migrations.js.map +1 -0
- package/package.json +5 -3
- package/dist/commands/add.d.ts +0 -2
- package/dist/commands/add.js +0 -134
- package/dist/commands/add.js.map +0 -1
- package/dist/commands/migrate.d.ts +0 -2
- package/dist/commands/migrate.js +0 -73
- package/dist/commands/migrate.js.map +0 -1
- package/dist/commands/rule.d.ts +0 -23
- package/dist/commands/rule.js +0 -158
- package/dist/commands/rule.js.map +0 -1
- package/dist/commands/search.d.ts +0 -2
- package/dist/commands/search.js +0 -57
- package/dist/commands/search.js.map +0 -1
- package/dist/core/capture-policy.d.ts +0 -6
- package/dist/core/capture-policy.js +0 -5
- package/dist/core/capture-policy.js.map +0 -1
- package/dist/core/compatibility-matcher.d.ts +0 -17
- package/dist/core/compatibility-matcher.js +0 -146
- package/dist/core/compatibility-matcher.js.map +0 -1
- package/dist/core/dedup.d.ts +0 -22
- package/dist/core/dedup.js +0 -54
- package/dist/core/dedup.js.map +0 -1
- package/dist/core/error-signature.d.ts +0 -15
- package/dist/core/error-signature.js +0 -59
- package/dist/core/error-signature.js.map +0 -1
- package/dist/core/facets.d.ts +0 -9
- package/dist/core/facets.js +0 -46
- package/dist/core/facets.js.map +0 -1
- package/dist/core/lesson-importer.d.ts +0 -22
- package/dist/core/lesson-importer.js +0 -94
- package/dist/core/lesson-importer.js.map +0 -1
- package/dist/core/ranker.d.ts +0 -3
- package/dist/core/ranker.js +0 -83
- package/dist/core/ranker.js.map +0 -1
- package/dist/core/rule-compatibility.d.ts +0 -66
- package/dist/core/rule-compatibility.js +0 -53
- package/dist/core/rule-compatibility.js.map +0 -1
- package/dist/core/rule-parser.d.ts +0 -25
- package/dist/core/rule-parser.js +0 -81
- package/dist/core/rule-parser.js.map +0 -1
- package/dist/core/rule-schema.d.ts +0 -283
- package/dist/core/rule-schema.js +0 -213
- package/dist/core/rule-schema.js.map +0 -1
- package/dist/core/rule-writer.d.ts +0 -35
- package/dist/core/rule-writer.js +0 -63
- package/dist/core/rule-writer.js.map +0 -1
- package/dist/core/search-types.d.ts +0 -57
- package/dist/core/search-types.js +0 -2
- package/dist/core/search-types.js.map +0 -1
- package/dist/core/semantic-checksum.d.ts +0 -6
- package/dist/core/semantic-checksum.js +0 -34
- package/dist/core/semantic-checksum.js.map +0 -1
- package/dist/core/slug.d.ts +0 -13
- package/dist/core/slug.js +0 -42
- package/dist/core/slug.js.map +0 -1
- package/dist/mcp/lesson-capture.d.ts +0 -30
- package/dist/mcp/lesson-capture.js +0 -148
- package/dist/mcp/lesson-capture.js.map +0 -1
- package/dist/mcp/rules-add-lesson-tool.d.ts +0 -4
- package/dist/mcp/rules-add-lesson-tool.js +0 -73
- package/dist/mcp/rules-add-lesson-tool.js.map +0 -1
- package/dist/mcp/rules-dedup-lesson-tool.d.ts +0 -4
- package/dist/mcp/rules-dedup-lesson-tool.js +0 -69
- package/dist/mcp/rules-dedup-lesson-tool.js.map +0 -1
- package/dist/mcp/rules-list-facets-tool.d.ts +0 -3
- package/dist/mcp/rules-list-facets-tool.js +0 -31
- package/dist/mcp/rules-list-facets-tool.js.map +0 -1
- package/dist/mcp/rules-prepare-lesson-tool.d.ts +0 -4
- package/dist/mcp/rules-prepare-lesson-tool.js +0 -7
- package/dist/mcp/rules-prepare-lesson-tool.js.map +0 -1
- package/dist/mcp/rules-search-error-tool.d.ts +0 -4
- package/dist/mcp/rules-search-error-tool.js +0 -103
- package/dist/mcp/rules-search-error-tool.js.map +0 -1
- package/dist/mcp/rules-search-for-project-tool.d.ts +0 -4
- package/dist/mcp/rules-search-for-project-tool.js +0 -105
- package/dist/mcp/rules-search-for-project-tool.js.map +0 -1
- package/dist/mcp/rules-search-tool.d.ts +0 -7
- package/dist/mcp/rules-search-tool.js +0 -65
- package/dist/mcp/rules-search-tool.js.map +0 -1
- package/dist/migration/adapters/fenced-lessons.d.ts +0 -2
- package/dist/migration/adapters/fenced-lessons.js +0 -55
- package/dist/migration/adapters/fenced-lessons.js.map +0 -1
- package/dist/migration/adapters/global-rules.d.ts +0 -2
- package/dist/migration/adapters/global-rules.js +0 -72
- package/dist/migration/adapters/global-rules.js.map +0 -1
- package/dist/migration/adapters/index.d.ts +0 -2
- package/dist/migration/adapters/index.js +0 -13
- package/dist/migration/adapters/index.js.map +0 -1
- package/dist/migration/adapters/markdown-lessons.d.ts +0 -2
- package/dist/migration/adapters/markdown-lessons.js +0 -36
- package/dist/migration/adapters/markdown-lessons.js.map +0 -1
- package/dist/migration/adapters/structured-lessons.d.ts +0 -2
- package/dist/migration/adapters/structured-lessons.js +0 -8
- package/dist/migration/adapters/structured-lessons.js.map +0 -1
- package/dist/migration/adapters/structured-shared.d.ts +0 -3
- package/dist/migration/adapters/structured-shared.js +0 -97
- package/dist/migration/adapters/structured-shared.js.map +0 -1
- package/dist/migration/applier.d.ts +0 -32
- package/dist/migration/applier.js +0 -559
- package/dist/migration/applier.js.map +0 -1
- package/dist/migration/index.d.ts +0 -11
- package/dist/migration/index.js +0 -7
- package/dist/migration/index.js.map +0 -1
- package/dist/migration/manifest.d.ts +0 -263
- package/dist/migration/manifest.js +0 -91
- package/dist/migration/manifest.js.map +0 -1
- package/dist/migration/migration-report.d.ts +0 -151
- package/dist/migration/migration-report.js +0 -85
- package/dist/migration/migration-report.js.map +0 -1
- package/dist/migration/scanner.d.ts +0 -2
- package/dist/migration/scanner.js +0 -312
- package/dist/migration/scanner.js.map +0 -1
- package/dist/migration/source-adapter.d.ts +0 -37
- package/dist/migration/source-adapter.js +0 -2
- package/dist/migration/source-adapter.js.map +0 -1
- package/dist/migration/verifier.d.ts +0 -5
- package/dist/migration/verifier.js +0 -218
- package/dist/migration/verifier.js.map +0 -1
- package/dist/storage/index-check.d.ts +0 -21
- package/dist/storage/index-check.js +0 -136
- package/dist/storage/index-check.js.map +0 -1
- package/dist/storage/indexer.d.ts +0 -19
- package/dist/storage/indexer.js +0 -367
- package/dist/storage/indexer.js.map +0 -1
- package/dist/storage/migrations.d.ts +0 -3
- package/dist/storage/migrations.js +0 -126
- package/dist/storage/migrations.js.map +0 -1
- package/dist/storage/rule-discovery.d.ts +0 -4
- package/dist/storage/rule-discovery.js +0 -34
- package/dist/storage/rule-discovery.js.map +0 -1
- package/dist/storage/rule-store.d.ts +0 -10
- package/dist/storage/rule-store.js +0 -12
- package/dist/storage/rule-store.js.map +0 -1
- package/dist/storage/rulebook-home.d.ts +0 -21
- package/dist/storage/rulebook-home.js +0 -78
- package/dist/storage/rulebook-home.js.map +0 -1
- package/dist/storage/search-service.d.ts +0 -17
- package/dist/storage/search-service.js +0 -275
- package/dist/storage/search-service.js.map +0 -1
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import { readdir } from 'node:fs/promises';
|
|
2
|
+
import { join, relative, sep } from 'node:path';
|
|
3
|
+
import { runGit, splitGitLines } from './git.js';
|
|
4
|
+
export const PROJECT_SCAN_EXCLUDED_DIRECTORIES = new Set([
|
|
5
|
+
'.git', '.build', '.gradle', '.codex', '.serena', 'node_modules',
|
|
6
|
+
'build', 'dist', 'artifacts', 'artifact', 'DerivedData', 'fixtures',
|
|
7
|
+
]);
|
|
8
|
+
export async function scanProjectFiles(root, options) {
|
|
9
|
+
const tracked = await runGit(root, ['ls-files']);
|
|
10
|
+
if (tracked.exitCode === 0) {
|
|
11
|
+
const paths = splitGitLines(tracked.stdout)
|
|
12
|
+
.filter((path) => !path.split('/').some((segment) => PROJECT_SCAN_EXCLUDED_DIRECTORIES.has(segment)))
|
|
13
|
+
.sort(rootFirst);
|
|
14
|
+
const selected = paths.slice(0, options.maxFiles);
|
|
15
|
+
const entries = new Map();
|
|
16
|
+
for (const relativePath of selected) {
|
|
17
|
+
const segments = relativePath.split('/');
|
|
18
|
+
for (let index = 1; index < segments.length; index += 1) {
|
|
19
|
+
const directory = segments.slice(0, index).join('/');
|
|
20
|
+
entries.set(`directory:${directory}`, {
|
|
21
|
+
kind: 'directory', absolutePath: join(root, directory), relativePath: directory, name: segments[index - 1],
|
|
22
|
+
});
|
|
23
|
+
}
|
|
24
|
+
entries.set(`file:${relativePath}`, {
|
|
25
|
+
kind: 'file', absolutePath: join(root, relativePath), relativePath, name: segments.at(-1),
|
|
26
|
+
});
|
|
27
|
+
}
|
|
28
|
+
return { entries: [...entries.values()], scannedFiles: selected.length, limitExceeded: paths.length > selected.length, source: 'git_tracked' };
|
|
29
|
+
}
|
|
30
|
+
const entries = [];
|
|
31
|
+
let scannedFiles = 0;
|
|
32
|
+
let limitExceeded = false;
|
|
33
|
+
async function walk(directory, depth) {
|
|
34
|
+
if (depth > options.maxDepth || limitExceeded)
|
|
35
|
+
return;
|
|
36
|
+
let dirents;
|
|
37
|
+
try {
|
|
38
|
+
dirents = await readdir(directory, { withFileTypes: true });
|
|
39
|
+
}
|
|
40
|
+
catch {
|
|
41
|
+
return;
|
|
42
|
+
}
|
|
43
|
+
const ordered = dirents.sort((left, right) => Number(left.isDirectory()) - Number(right.isDirectory()) || left.name.localeCompare(right.name));
|
|
44
|
+
for (const dirent of ordered) {
|
|
45
|
+
const absolutePath = join(directory, dirent.name);
|
|
46
|
+
const relativePath = relative(root, absolutePath).split(sep).join('/');
|
|
47
|
+
if (dirent.isDirectory()) {
|
|
48
|
+
if (PROJECT_SCAN_EXCLUDED_DIRECTORIES.has(dirent.name))
|
|
49
|
+
continue;
|
|
50
|
+
entries.push({ kind: 'directory', absolutePath, relativePath, name: dirent.name });
|
|
51
|
+
if (depth >= options.maxDepth) {
|
|
52
|
+
limitExceeded = true;
|
|
53
|
+
continue;
|
|
54
|
+
}
|
|
55
|
+
await walk(absolutePath, depth + 1);
|
|
56
|
+
}
|
|
57
|
+
else if (dirent.isFile()) {
|
|
58
|
+
if (scannedFiles >= options.maxFiles) {
|
|
59
|
+
limitExceeded = true;
|
|
60
|
+
return;
|
|
61
|
+
}
|
|
62
|
+
scannedFiles += 1;
|
|
63
|
+
entries.push({ kind: 'file', absolutePath, relativePath, name: dirent.name });
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
}
|
|
67
|
+
await walk(root, 1);
|
|
68
|
+
return { entries, scannedFiles, limitExceeded, source: 'filesystem' };
|
|
69
|
+
}
|
|
70
|
+
function rootFirst(left, right) {
|
|
71
|
+
return left.split('/').length - right.split('/').length || left.localeCompare(right);
|
|
72
|
+
}
|
|
73
|
+
//# sourceMappingURL=project-file-scan.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"project-file-scan.js","sourceRoot":"","sources":["../../src/core/project-file-scan.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
export declare const ProjectRegistrySchema: z.ZodObject<{
|
|
3
|
+
schema_version: z.ZodLiteral<1>;
|
|
4
|
+
projects: z.ZodRecord<z.ZodString, z.ZodString>;
|
|
5
|
+
}, z.core.$strict>;
|
|
6
|
+
export type ProjectRegistry = z.infer<typeof ProjectRegistrySchema>;
|
|
7
|
+
export declare function readProjectRegistry(home: string): Promise<ProjectRegistry>;
|
|
8
|
+
export declare function registerProject(home: string, projectKey: string, root: string): Promise<ProjectRegistry>;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
import { mkdir, readFile, realpath } from 'node:fs/promises';
|
|
2
|
+
import { dirname, join } from 'node:path';
|
|
3
|
+
import { parse, stringify } from 'yaml';
|
|
4
|
+
import { z } from 'zod';
|
|
5
|
+
import { normalizeProjectKey } from './project-key.js';
|
|
6
|
+
import { replaceFileAtomically } from '../storage/atomic-file.js';
|
|
7
|
+
export const ProjectRegistrySchema = z
|
|
8
|
+
.object({
|
|
9
|
+
schema_version: z.literal(1),
|
|
10
|
+
projects: z.record(z.string().regex(/^[a-z0-9][a-z0-9._-]*$/), z.string().min(1)),
|
|
11
|
+
})
|
|
12
|
+
.strict();
|
|
13
|
+
export async function readProjectRegistry(home) {
|
|
14
|
+
const path = join(home, 'projects.local.yaml');
|
|
15
|
+
try {
|
|
16
|
+
return ProjectRegistrySchema.parse(parse(await readFile(path, 'utf8')));
|
|
17
|
+
}
|
|
18
|
+
catch (error) {
|
|
19
|
+
if (error.code === 'ENOENT')
|
|
20
|
+
return { schema_version: 1, projects: {} };
|
|
21
|
+
throw error;
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
export async function registerProject(home, projectKey, root) {
|
|
25
|
+
const key = normalizeProjectKey(projectKey);
|
|
26
|
+
if (key === undefined)
|
|
27
|
+
throw new Error('A stable project key is required');
|
|
28
|
+
const resolvedRoot = await realpath(root);
|
|
29
|
+
const registry = await readProjectRegistry(home);
|
|
30
|
+
const updated = ProjectRegistrySchema.parse({
|
|
31
|
+
...registry,
|
|
32
|
+
projects: { ...registry.projects, [key]: resolvedRoot },
|
|
33
|
+
});
|
|
34
|
+
await mkdir(dirname(join(home, 'projects.local.yaml')), { recursive: true });
|
|
35
|
+
await replaceFileAtomically(join(home, 'projects.local.yaml'), stringify(updated, { lineWidth: 0 }));
|
|
36
|
+
return updated;
|
|
37
|
+
}
|
|
38
|
+
//# sourceMappingURL=project-registry.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"project-registry.js","sourceRoot":"","sources":["../../src/core/project-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC;KACnC,MAAM,CAAC;IACN,cAAc,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAClF,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY;IACpD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,cAAc,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;QACnG,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,UAAkB,EAAE,IAAY;IAClF,MAAM,GAAG,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC5C,IAAI,GAAG,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACjD,MAAM,OAAO,GAAG,qBAAqB,CAAC,KAAK,CAAC;QAC1C,GAAG,QAAQ;QACX,QAAQ,EAAE,EAAE,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE;KACxD,CAAC,CAAC;IACH,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7E,MAAM,qBAAqB,CAAC,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,EAAE,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACrG,OAAO,OAAO,CAAC;AACjB,CAAC"}
|
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
export type RepositoryIdentity = {
|
|
2
|
+
root: string;
|
|
3
|
+
normalizedRemote: string;
|
|
4
|
+
fingerprint: string;
|
|
5
|
+
};
|
|
6
|
+
export declare function inspectRepositoryIdentity(projectRoot: string): Promise<RepositoryIdentity>;
|
|
7
|
+
export declare function normalizeRemoteIdentity(remote: string): string;
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
import { createHash } from 'node:crypto';
|
|
2
|
+
import { realpath } from 'node:fs/promises';
|
|
3
|
+
import { runGit } from './git.js';
|
|
4
|
+
export async function inspectRepositoryIdentity(projectRoot) {
|
|
5
|
+
const rootResult = await runGit(projectRoot, ['rev-parse', '--show-toplevel']);
|
|
6
|
+
if (rootResult.exitCode !== 0)
|
|
7
|
+
throw new Error('Project root is not a Git worktree');
|
|
8
|
+
const root = await realpath(rootResult.stdout.trim());
|
|
9
|
+
const remoteResult = await runGit(root, ['remote', 'get-url', 'origin']);
|
|
10
|
+
if (remoteResult.exitCode !== 0)
|
|
11
|
+
throw new Error('Git origin is required for a portable repository identity');
|
|
12
|
+
const normalizedRemote = normalizeRemoteIdentity(remoteResult.stdout.trim());
|
|
13
|
+
return {
|
|
14
|
+
root,
|
|
15
|
+
normalizedRemote,
|
|
16
|
+
fingerprint: `sha256:${createHash('sha256').update(normalizedRemote).digest('hex')}`,
|
|
17
|
+
};
|
|
18
|
+
}
|
|
19
|
+
export function normalizeRemoteIdentity(remote) {
|
|
20
|
+
const withoutCredentials = remote.replace(/^(https?:\/\/)[^/@]+@/i, '$1');
|
|
21
|
+
return withoutCredentials
|
|
22
|
+
.replace(/^git@([^:]+):/i, 'ssh://$1/')
|
|
23
|
+
.replace(/\.git$/i, '')
|
|
24
|
+
.replace(/\/$/, '')
|
|
25
|
+
.toLowerCase();
|
|
26
|
+
}
|
|
27
|
+
//# sourceMappingURL=repository-identity.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"repository-identity.js","sourceRoot":"","sources":["../../src/core/repository-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAQlC,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAAC,WAAmB;IACjE,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC/E,IAAI,UAAU,CAAC,QAAQ,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACrF,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACzE,IAAI,YAAY,CAAC,QAAQ,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC9G,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7E,OAAO;QACL,IAAI;QACJ,gBAAgB;QAChB,WAAW,EAAE,UAAU,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;KACrF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,MAAM,kBAAkB,GAAG,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;IAC1E,OAAO,kBAAkB;SACtB,OAAO,CAAC,gBAAgB,EAAE,WAAW,CAAC;SACtC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,WAAW,EAAE,CAAC;AACnB,CAAC"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import type { ResolutionEnvironment } from './problem-schema.js';
|
|
2
|
+
import type { Solution } from './solution-schema.js';
|
|
3
|
+
export type SourceAvailability = 'available' | 'stale' | 'unavailable';
|
|
4
|
+
export type ResolutionApplicability = {
|
|
5
|
+
excluded: boolean;
|
|
6
|
+
classification: 'likely' | 'possible' | 'incompatible';
|
|
7
|
+
matched: string[];
|
|
8
|
+
mismatched: string[];
|
|
9
|
+
unknown: string[];
|
|
10
|
+
requiredChecks: string[];
|
|
11
|
+
sourceAvailability: SourceAvailability;
|
|
12
|
+
};
|
|
13
|
+
export declare function evaluateResolutionApplicability(options: {
|
|
14
|
+
solution: Solution;
|
|
15
|
+
solutionEnvironment: ResolutionEnvironment;
|
|
16
|
+
currentEnvironment: ResolutionEnvironment;
|
|
17
|
+
satisfiedConditions?: string[];
|
|
18
|
+
rejectedConditions?: string[];
|
|
19
|
+
sourceAvailability?: SourceAvailability;
|
|
20
|
+
}): ResolutionApplicability;
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
export function evaluateResolutionApplicability(options) {
|
|
2
|
+
const matched = [];
|
|
3
|
+
const mismatched = [];
|
|
4
|
+
const unknown = [];
|
|
5
|
+
for (const field of ['languages', 'platforms', 'runtimes', 'tools']) {
|
|
6
|
+
const expected = new Set(options.solutionEnvironment[field]);
|
|
7
|
+
const current = new Set(options.currentEnvironment[field]);
|
|
8
|
+
if (expected.size === 0)
|
|
9
|
+
continue;
|
|
10
|
+
if (current.size === 0)
|
|
11
|
+
unknown.push(`environment.${field}`);
|
|
12
|
+
else if ([...expected].some((value) => current.has(value)))
|
|
13
|
+
matched.push(`environment.${field}`);
|
|
14
|
+
else
|
|
15
|
+
mismatched.push(`environment.${field}`);
|
|
16
|
+
}
|
|
17
|
+
const satisfied = new Set((options.satisfiedConditions ?? []).map(normalize));
|
|
18
|
+
const rejected = new Set((options.rejectedConditions ?? []).map(normalize));
|
|
19
|
+
const rejectMatched = options.solution.reject_if.filter((condition) => satisfied.has(normalize(condition)));
|
|
20
|
+
const applicableRejected = options.solution.applicable_if.filter((condition) => rejected.has(normalize(condition)));
|
|
21
|
+
mismatched.push(...rejectMatched.map((condition) => `reject_if:${condition}`), ...applicableRejected.map((condition) => `applicable_if:${condition}`));
|
|
22
|
+
const requiredChecks = options.solution.applicable_if.filter((condition) => !satisfied.has(normalize(condition)) && !rejected.has(normalize(condition)));
|
|
23
|
+
unknown.push(...requiredChecks.map((condition) => `applicable_if:${condition}`));
|
|
24
|
+
const excluded = mismatched.length > 0;
|
|
25
|
+
return {
|
|
26
|
+
excluded,
|
|
27
|
+
classification: excluded ? 'incompatible' : requiredChecks.length === 0 && unknown.length === 0 ? 'likely' : 'possible',
|
|
28
|
+
matched,
|
|
29
|
+
mismatched,
|
|
30
|
+
unknown,
|
|
31
|
+
requiredChecks,
|
|
32
|
+
sourceAvailability: options.sourceAvailability ?? 'unavailable',
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
function normalize(value) {
|
|
36
|
+
return value.trim().toLocaleLowerCase().replace(/\s+/g, ' ');
|
|
37
|
+
}
|
|
38
|
+
//# sourceMappingURL=resolution-applicability.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolution-applicability.js","sourceRoot":"","sources":["../../src/core/resolution-applicability.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,+BAA+B,CAAC,OAO/C;IACC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,CAAU,EAAE,CAAC;QAC7E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3D,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;YAAE,SAAS;QAClC,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC;aACxD,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAAE,OAAO,CAAC,IAAI,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC;;YAC5F,UAAU,CAAC,IAAI,CAAC,eAAe,KAAK,EAAE,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5E,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAC5G,MAAM,kBAAkB,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACpH,UAAU,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,aAAa,SAAS,EAAE,CAAC,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC,CAAC;IACvJ,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACzJ,OAAO,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IACvC,OAAO;QACL,QAAQ;QACR,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU;QACvH,OAAO;QACP,UAAU;QACV,OAAO;QACP,cAAc;QACd,kBAAkB,EAAE,OAAO,CAAC,kBAAkB,IAAI,aAAa;KAChE,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,iBAAiB,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAC/D,CAAC"}
|
|
@@ -0,0 +1,20 @@
|
|
|
1
|
+
import { type ResolutionDocument } from './resolution-schema.js';
|
|
2
|
+
export type ResolutionValidationIssue = {
|
|
3
|
+
path: string;
|
|
4
|
+
message: string;
|
|
5
|
+
};
|
|
6
|
+
export type ResolutionParseError = {
|
|
7
|
+
kind: 'yaml_parse' | 'validation' | 'legacy_schema_unsupported_clean_reset_required';
|
|
8
|
+
filePath: string;
|
|
9
|
+
message: string;
|
|
10
|
+
issues: ResolutionValidationIssue[];
|
|
11
|
+
schemaVersion?: unknown;
|
|
12
|
+
};
|
|
13
|
+
export type ResolutionParseResult = {
|
|
14
|
+
success: true;
|
|
15
|
+
document: ResolutionDocument;
|
|
16
|
+
} | {
|
|
17
|
+
success: false;
|
|
18
|
+
error: ResolutionParseError;
|
|
19
|
+
};
|
|
20
|
+
export declare function parseResolutionYaml(source: string, filePath: string): ResolutionParseResult;
|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+
import { parse as parseYaml } from 'yaml';
|
|
2
|
+
import { ResolutionDocumentSchema } from './resolution-schema.js';
|
|
3
|
+
export function parseResolutionYaml(source, filePath) {
|
|
4
|
+
let input;
|
|
5
|
+
try {
|
|
6
|
+
input = parseYaml(source);
|
|
7
|
+
}
|
|
8
|
+
catch (error) {
|
|
9
|
+
return failure('yaml_parse', filePath, error instanceof Error ? error.message : 'Unable to parse YAML');
|
|
10
|
+
}
|
|
11
|
+
const schemaVersion = readSchemaVersion(input);
|
|
12
|
+
if (schemaVersion !== 3) {
|
|
13
|
+
return {
|
|
14
|
+
success: false,
|
|
15
|
+
error: {
|
|
16
|
+
kind: 'legacy_schema_unsupported_clean_reset_required',
|
|
17
|
+
filePath,
|
|
18
|
+
message: 'Legacy schema is unsupported; clean reset required',
|
|
19
|
+
issues: [{ path: 'schema_version', message: 'Legacy schema is unsupported; clean reset required' }],
|
|
20
|
+
schemaVersion,
|
|
21
|
+
},
|
|
22
|
+
};
|
|
23
|
+
}
|
|
24
|
+
const result = ResolutionDocumentSchema.safeParse(input);
|
|
25
|
+
if (!result.success) {
|
|
26
|
+
return {
|
|
27
|
+
success: false,
|
|
28
|
+
error: {
|
|
29
|
+
kind: 'validation',
|
|
30
|
+
filePath,
|
|
31
|
+
message: `Resolution validation failed for ${filePath}`,
|
|
32
|
+
issues: result.error.issues.map((issue) => ({ path: issue.path.join('.'), message: issue.message })),
|
|
33
|
+
schemaVersion,
|
|
34
|
+
},
|
|
35
|
+
};
|
|
36
|
+
}
|
|
37
|
+
return { success: true, document: result.data };
|
|
38
|
+
}
|
|
39
|
+
function readSchemaVersion(input) {
|
|
40
|
+
return typeof input === 'object' && input !== null && !Array.isArray(input)
|
|
41
|
+
? Reflect.get(input, 'schema_version')
|
|
42
|
+
: undefined;
|
|
43
|
+
}
|
|
44
|
+
function failure(kind, filePath, message) {
|
|
45
|
+
return { success: false, error: { kind, filePath, message, issues: [] } };
|
|
46
|
+
}
|
|
47
|
+
//# sourceMappingURL=resolution-parser.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolution-parser.js","sourceRoot":"","sources":["../../src/core/resolution-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAA2B,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAc3F,MAAM,UAAU,mBAAmB,CAAC,MAAc,EAAE,QAAgB;IAClE,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,OAAO,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC;IAC1G,CAAC;IAED,MAAM,aAAa,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,aAAa,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,gDAAgD;gBACtD,QAAQ;gBACR,OAAO,EAAE,oDAAoD;gBAC7D,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,oDAAoD,EAAE,CAAC;gBACnG,aAAa;aACd;SACF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,wBAAwB,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,YAAY;gBAClB,QAAQ;gBACR,OAAO,EAAE,oCAAoC,QAAQ,EAAE;gBACvD,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;gBACpG,aAAa;aACd;SACF,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,gBAAgB,CAAC;QACtC,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,OAAO,CAAC,IAAkB,EAAE,QAAgB,EAAE,OAAe;IACpE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;AAC5E,CAAC"}
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
import type { ResolutionCandidate } from './resolution-search-types.js';
|
|
2
|
+
import type { ResolutionApplicability } from './resolution-applicability.js';
|
|
3
|
+
export type ContextOutcome = {
|
|
4
|
+
solutionId: string;
|
|
5
|
+
solutionRevision: number;
|
|
6
|
+
contextFingerprint: string;
|
|
7
|
+
result: 'solved' | 'failed' | 'inapplicable' | 'inconclusive' | 'regressed';
|
|
8
|
+
count: number;
|
|
9
|
+
};
|
|
10
|
+
export type RankedResolutionCandidate = ResolutionCandidate & {
|
|
11
|
+
applicability: ResolutionApplicability;
|
|
12
|
+
usage: 'direct' | 'reference';
|
|
13
|
+
risk: 'low' | 'elevated' | 'high';
|
|
14
|
+
verificationCost: number;
|
|
15
|
+
solutionHandle: string;
|
|
16
|
+
sourceHandles: string[];
|
|
17
|
+
rankingEvidence: Array<{
|
|
18
|
+
factor: string;
|
|
19
|
+
effect: 'include' | 'boost' | 'penalty' | 'exclude';
|
|
20
|
+
value: number | string;
|
|
21
|
+
}>;
|
|
22
|
+
rankScore: number;
|
|
23
|
+
};
|
|
24
|
+
export declare function rankResolutionCandidates(options: {
|
|
25
|
+
candidates: Array<{
|
|
26
|
+
candidate: ResolutionCandidate;
|
|
27
|
+
applicability: ResolutionApplicability;
|
|
28
|
+
projectRelation: 'current_project' | 'shared' | 'foreign_project';
|
|
29
|
+
verificationSteps: number;
|
|
30
|
+
sourceHandles?: string[];
|
|
31
|
+
}>;
|
|
32
|
+
contextFingerprint: string;
|
|
33
|
+
outcomes?: ContextOutcome[];
|
|
34
|
+
}): RankedResolutionCandidate[];
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
export function rankResolutionCandidates(options) {
|
|
2
|
+
const ranked = [];
|
|
3
|
+
for (const item of options.candidates) {
|
|
4
|
+
if (item.applicability.excluded)
|
|
5
|
+
continue;
|
|
6
|
+
const matchingOutcomes = (options.outcomes ?? []).filter((outcome) => outcome.solutionId === item.candidate.solutionId && outcome.solutionRevision === item.candidate.solutionRevision);
|
|
7
|
+
const current = matchingOutcomes.filter(({ contextFingerprint }) => contextFingerprint === options.contextFingerprint);
|
|
8
|
+
if (current.some(({ result }) => result === 'failed' || result === 'inapplicable'))
|
|
9
|
+
continue;
|
|
10
|
+
const exact = item.candidate.matchEvidence.filter(({ channel }) => channel === 'error_signature').length;
|
|
11
|
+
const structural = item.candidate.matchEvidence.filter(({ channel }) => channel === 'symbol' || channel === 'operation' || channel === 'source_code').length;
|
|
12
|
+
const fact = item.candidate.matchEvidence.filter(({ confidence }) => confidence === 'fact').length;
|
|
13
|
+
const solved = current.filter(({ result }) => result === 'solved').reduce((sum, { count }) => sum + count, 0);
|
|
14
|
+
const regressed = matchingOutcomes.filter(({ result }) => result === 'regressed').reduce((sum, { count }) => sum + count, 0);
|
|
15
|
+
const projectBoost = item.projectRelation === 'current_project' ? 30 : item.projectRelation === 'shared' ? 12 : -12;
|
|
16
|
+
const applicabilityBoost = item.applicability.classification === 'likely' ? 20 : 0;
|
|
17
|
+
const sourceBoost = item.applicability.sourceAvailability === 'available' ? 10 : item.applicability.sourceAvailability === 'stale' ? -8 : -3;
|
|
18
|
+
const rankScore = item.candidate.recallScore + exact * 60 + structural * 25 + fact * 5 + solved * 25 + projectBoost + applicabilityBoost + sourceBoost - regressed * 30;
|
|
19
|
+
const sourceOnly = item.candidate.matchEvidence.length > 0 && item.candidate.matchEvidence.every(({ channel }) => channel === 'source_code');
|
|
20
|
+
ranked.push({
|
|
21
|
+
...item.candidate,
|
|
22
|
+
applicability: item.applicability,
|
|
23
|
+
usage: sourceOnly || item.projectRelation === 'foreign_project' ? 'reference' : 'direct',
|
|
24
|
+
risk: regressed > 0 ? 'high' : item.applicability.sourceAvailability === 'stale' || item.applicability.requiredChecks.length > 0 ? 'elevated' : 'low',
|
|
25
|
+
verificationCost: item.verificationSteps + regressed,
|
|
26
|
+
solutionHandle: `${item.candidate.solutionId}@${item.candidate.solutionRevision}`,
|
|
27
|
+
sourceHandles: item.sourceHandles ?? [],
|
|
28
|
+
rankingEvidence: [
|
|
29
|
+
{ factor: 'recall', effect: 'include', value: item.candidate.recallScore },
|
|
30
|
+
{ factor: 'project_relation', effect: projectBoost >= 0 ? 'boost' : 'penalty', value: item.projectRelation },
|
|
31
|
+
{ factor: 'applicability', effect: applicabilityBoost > 0 ? 'boost' : 'include', value: item.applicability.classification },
|
|
32
|
+
{ factor: 'source_availability', effect: sourceBoost >= 0 ? 'boost' : 'penalty', value: item.applicability.sourceAvailability },
|
|
33
|
+
...(regressed === 0 ? [] : [{ factor: 'regressed', effect: 'penalty', value: regressed }]),
|
|
34
|
+
],
|
|
35
|
+
rankScore,
|
|
36
|
+
});
|
|
37
|
+
}
|
|
38
|
+
return ranked.sort((left, right) => right.rankScore - left.rankScore || left.solutionId.localeCompare(right.solutionId) || left.solutionRevision - right.solutionRevision);
|
|
39
|
+
}
|
|
40
|
+
//# sourceMappingURL=resolution-ranker.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolution-ranker.js","sourceRoot":"","sources":["../../src/core/resolution-ranker.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
export declare const RESOLUTION_RELATIONS: readonly ["exact_solution", "same_problem_alternative", "refines_solution", "supersedes_solution", "contradicts_solution", "analogous_pattern", "weak_overlap", "new_problem"];
|
|
2
|
+
export type ResolutionRelation = (typeof RESOLUTION_RELATIONS)[number];
|
|
3
|
+
export type ResolutionComparison = {
|
|
4
|
+
sameProblem: boolean;
|
|
5
|
+
sameCause: boolean;
|
|
6
|
+
sameStrategy: boolean;
|
|
7
|
+
sameApplicability: boolean;
|
|
8
|
+
hasTarget: boolean;
|
|
9
|
+
replacementVerified: boolean;
|
|
10
|
+
conflictEvidence: readonly string[];
|
|
11
|
+
analogousEvidence: readonly string[];
|
|
12
|
+
weakTextOverlap: boolean;
|
|
13
|
+
};
|
|
14
|
+
export declare function classifyResolutionRelation(comparison: ResolutionComparison): ResolutionRelation;
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
export const RESOLUTION_RELATIONS = [
|
|
2
|
+
'exact_solution',
|
|
3
|
+
'same_problem_alternative',
|
|
4
|
+
'refines_solution',
|
|
5
|
+
'supersedes_solution',
|
|
6
|
+
'contradicts_solution',
|
|
7
|
+
'analogous_pattern',
|
|
8
|
+
'weak_overlap',
|
|
9
|
+
'new_problem',
|
|
10
|
+
];
|
|
11
|
+
export function classifyResolutionRelation(comparison) {
|
|
12
|
+
if (comparison.conflictEvidence.length > 0)
|
|
13
|
+
return 'contradicts_solution';
|
|
14
|
+
if (comparison.sameProblem) {
|
|
15
|
+
if (comparison.sameCause && comparison.sameStrategy && comparison.sameApplicability)
|
|
16
|
+
return 'exact_solution';
|
|
17
|
+
if (comparison.hasTarget && comparison.replacementVerified && (!comparison.sameCause || !comparison.sameStrategy))
|
|
18
|
+
return 'supersedes_solution';
|
|
19
|
+
if (comparison.hasTarget && comparison.sameCause && comparison.sameStrategy && !comparison.sameApplicability)
|
|
20
|
+
return 'refines_solution';
|
|
21
|
+
return 'same_problem_alternative';
|
|
22
|
+
}
|
|
23
|
+
if (comparison.analogousEvidence.length > 0 && comparison.sameStrategy)
|
|
24
|
+
return 'analogous_pattern';
|
|
25
|
+
if (comparison.weakTextOverlap)
|
|
26
|
+
return 'weak_overlap';
|
|
27
|
+
return 'new_problem';
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=resolution-relation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolution-relation.js","sourceRoot":"","sources":["../../src/core/resolution-relation.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,gBAAgB;IAChB,0BAA0B;IAC1B,kBAAkB;IAClB,qBAAqB;IACrB,sBAAsB;IACtB,mBAAmB;IACnB,cAAc;IACd,aAAa;CACL,CAAC;AAgBX,MAAM,UAAU,0BAA0B,CAAC,UAAgC;IACzE,IAAI,UAAU,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,sBAAsB,CAAC;IAC1E,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;QAC3B,IAAI,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,YAAY,IAAI,UAAU,CAAC,iBAAiB;YAAE,OAAO,gBAAgB,CAAC;QAC7G,IAAI,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,mBAAmB,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC;YAAE,OAAO,qBAAqB,CAAC;QAChJ,IAAI,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,YAAY,IAAI,CAAC,UAAU,CAAC,iBAAiB;YAAE,OAAO,kBAAkB,CAAC;QACxI,OAAO,0BAA0B,CAAC;IACpC,CAAC;IACD,IAAI,UAAU,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,IAAI,UAAU,CAAC,YAAY;QAAE,OAAO,mBAAmB,CAAC;IACnG,IAAI,UAAU,CAAC,eAAe;QAAE,OAAO,cAAc,CAAC;IACtD,OAAO,aAAa,CAAC;AACvB,CAAC"}
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
export declare const ResolutionDocumentSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
3
|
+
schema_version: z.ZodLiteral<3>;
|
|
4
|
+
kind: z.ZodLiteral<"problem">;
|
|
5
|
+
id: z.ZodString;
|
|
6
|
+
title: z.ZodString;
|
|
7
|
+
observations: z.ZodObject<{
|
|
8
|
+
symptoms: z.ZodArray<z.ZodString>;
|
|
9
|
+
error_signatures: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
10
|
+
symbols: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
11
|
+
operations: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
12
|
+
expected: z.ZodString;
|
|
13
|
+
observed: z.ZodString;
|
|
14
|
+
}, z.core.$strict>;
|
|
15
|
+
hypotheses: z.ZodObject<{
|
|
16
|
+
suspected_causes: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
17
|
+
components: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
18
|
+
}, z.core.$strict>;
|
|
19
|
+
environment: z.ZodObject<{
|
|
20
|
+
languages: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
21
|
+
platforms: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
22
|
+
runtimes: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
23
|
+
tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
24
|
+
}, z.core.$strict>;
|
|
25
|
+
created_at: z.ZodISODateTime;
|
|
26
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
27
|
+
schema_version: z.ZodLiteral<3>;
|
|
28
|
+
kind: z.ZodLiteral<"solution">;
|
|
29
|
+
id: z.ZodString;
|
|
30
|
+
problem_id: z.ZodString;
|
|
31
|
+
revision: z.ZodNumber;
|
|
32
|
+
title: z.ZodString;
|
|
33
|
+
cause: z.ZodString;
|
|
34
|
+
applicable_if: z.ZodArray<z.ZodString>;
|
|
35
|
+
reject_if: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
36
|
+
inspections: z.ZodArray<z.ZodString>;
|
|
37
|
+
actions: z.ZodArray<z.ZodString>;
|
|
38
|
+
verification: z.ZodArray<z.ZodString>;
|
|
39
|
+
safety: z.ZodArray<z.ZodString>;
|
|
40
|
+
source_evidence: z.ZodDefault<z.ZodArray<z.ZodObject<{
|
|
41
|
+
id: z.ZodString;
|
|
42
|
+
project_key: z.ZodString;
|
|
43
|
+
repository_fingerprint: z.ZodString;
|
|
44
|
+
revision: z.ZodDiscriminatedUnion<[z.ZodObject<{
|
|
45
|
+
kind: z.ZodLiteral<"git_commit">;
|
|
46
|
+
value: z.ZodString;
|
|
47
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
48
|
+
kind: z.ZodLiteral<"working_tree_hash">;
|
|
49
|
+
value: z.ZodString;
|
|
50
|
+
}, z.core.$strict>], "kind">;
|
|
51
|
+
relative_path: z.ZodString;
|
|
52
|
+
symbol: z.ZodOptional<z.ZodString>;
|
|
53
|
+
content_hash: z.ZodString;
|
|
54
|
+
tests: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
55
|
+
}, z.core.$strict>>>;
|
|
56
|
+
prior_solution: z.ZodOptional<z.ZodObject<{
|
|
57
|
+
id: z.ZodString;
|
|
58
|
+
revision: z.ZodNumber;
|
|
59
|
+
relation: z.ZodEnum<{
|
|
60
|
+
refines: "refines";
|
|
61
|
+
supersedes: "supersedes";
|
|
62
|
+
}>;
|
|
63
|
+
}, z.core.$strict>>;
|
|
64
|
+
created_at: z.ZodISODateTime;
|
|
65
|
+
}, z.core.$strict>, z.ZodObject<{
|
|
66
|
+
schema_version: z.ZodLiteral<3>;
|
|
67
|
+
kind: z.ZodLiteral<"outcome">;
|
|
68
|
+
id: z.ZodString;
|
|
69
|
+
problem_id: z.ZodString;
|
|
70
|
+
solution_id: z.ZodString;
|
|
71
|
+
solution_revision: z.ZodNumber;
|
|
72
|
+
result: z.ZodEnum<{
|
|
73
|
+
solved: "solved";
|
|
74
|
+
failed: "failed";
|
|
75
|
+
inapplicable: "inapplicable";
|
|
76
|
+
inconclusive: "inconclusive";
|
|
77
|
+
regressed: "regressed";
|
|
78
|
+
}>;
|
|
79
|
+
context_fingerprint: z.ZodString;
|
|
80
|
+
environment: z.ZodObject<{
|
|
81
|
+
languages: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
82
|
+
platforms: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
83
|
+
runtimes: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
84
|
+
tools: z.ZodDefault<z.ZodArray<z.ZodString>>;
|
|
85
|
+
}, z.core.$strict>;
|
|
86
|
+
reason_code: z.ZodOptional<z.ZodString>;
|
|
87
|
+
evidence: z.ZodArray<z.ZodObject<{
|
|
88
|
+
kind: z.ZodEnum<{
|
|
89
|
+
focused_test: "focused_test";
|
|
90
|
+
integration_test: "integration_test";
|
|
91
|
+
manual_verification: "manual_verification";
|
|
92
|
+
observation: "observation";
|
|
93
|
+
}>;
|
|
94
|
+
handle: z.ZodString;
|
|
95
|
+
summary: z.ZodString;
|
|
96
|
+
}, z.core.$strict>>;
|
|
97
|
+
created_at: z.ZodISODateTime;
|
|
98
|
+
}, z.core.$strict>], "kind">;
|
|
99
|
+
export type ResolutionDocument = z.infer<typeof ResolutionDocumentSchema>;
|
|
100
|
+
export type ResolutionReferenceSet = {
|
|
101
|
+
problemIds: ReadonlySet<string>;
|
|
102
|
+
solutionRevisions: ReadonlySet<string>;
|
|
103
|
+
};
|
|
104
|
+
export type ResolutionReferenceIssue = {
|
|
105
|
+
path: string;
|
|
106
|
+
message: string;
|
|
107
|
+
};
|
|
108
|
+
export declare function solutionRevisionKey(id: string, revision: number): string;
|
|
109
|
+
export declare function validateResolutionReferences(document: ResolutionDocument, references: ResolutionReferenceSet): ResolutionReferenceIssue[];
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { z } from 'zod';
|
|
2
|
+
import { OutcomeSchema } from './outcome-schema.js';
|
|
3
|
+
import { ProblemSchema } from './problem-schema.js';
|
|
4
|
+
import { SolutionSchema } from './solution-schema.js';
|
|
5
|
+
export const ResolutionDocumentSchema = z.discriminatedUnion('kind', [
|
|
6
|
+
ProblemSchema,
|
|
7
|
+
SolutionSchema,
|
|
8
|
+
OutcomeSchema,
|
|
9
|
+
]);
|
|
10
|
+
export function solutionRevisionKey(id, revision) {
|
|
11
|
+
return `${id}@${revision}`;
|
|
12
|
+
}
|
|
13
|
+
export function validateResolutionReferences(document, references) {
|
|
14
|
+
if (document.kind === 'problem')
|
|
15
|
+
return [];
|
|
16
|
+
const issues = [];
|
|
17
|
+
if (!references.problemIds.has(document.problem_id)) {
|
|
18
|
+
issues.push({ path: 'problem_id', message: `Unknown problem reference: ${document.problem_id}` });
|
|
19
|
+
}
|
|
20
|
+
if (document.kind === 'outcome'
|
|
21
|
+
&& !references.solutionRevisions.has(solutionRevisionKey(document.solution_id, document.solution_revision))) {
|
|
22
|
+
issues.push({
|
|
23
|
+
path: 'solution_revision',
|
|
24
|
+
message: `Unknown solution revision: ${document.solution_id}@${document.solution_revision}`,
|
|
25
|
+
});
|
|
26
|
+
}
|
|
27
|
+
return issues;
|
|
28
|
+
}
|
|
29
|
+
//# sourceMappingURL=resolution-schema.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolution-schema.js","sourceRoot":"","sources":["../../src/core/resolution-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACnE,aAAa;IACb,cAAc;IACd,aAAa;CACd,CAAC,CAAC;AAcH,MAAM,UAAU,mBAAmB,CAAC,EAAU,EAAE,QAAgB;IAC9D,OAAO,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,QAA4B,EAC5B,UAAkC;IAElC,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAE3C,MAAM,MAAM,GAA+B,EAAE,CAAC;IAC9C,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,8BAA8B,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACpG,CAAC;IACD,IACE,QAAQ,CAAC,IAAI,KAAK,SAAS;WACxB,CAAC,UAAU,CAAC,iBAAiB,CAAC,GAAG,CAAC,mBAAmB,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC,EAC3G,CAAC;QACD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,mBAAmB;YACzB,OAAO,EAAE,8BAA8B,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,iBAAiB,EAAE;SAC5F,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import type { ResolutionEnvironment } from './problem-schema.js';
|
|
2
|
+
export type ProblemSearchInput = {
|
|
3
|
+
observations: {
|
|
4
|
+
symptoms: string[];
|
|
5
|
+
error_signatures?: string[];
|
|
6
|
+
symbols?: string[];
|
|
7
|
+
operations?: string[];
|
|
8
|
+
expected: string;
|
|
9
|
+
observed: string;
|
|
10
|
+
};
|
|
11
|
+
hypotheses?: {
|
|
12
|
+
suspected_causes?: string[];
|
|
13
|
+
components?: string[];
|
|
14
|
+
};
|
|
15
|
+
environment: ResolutionEnvironment;
|
|
16
|
+
};
|
|
17
|
+
export type MatchEvidence = {
|
|
18
|
+
channel: 'error_signature' | 'symbol' | 'operation' | 'symptom' | 'expected_observed' | 'hypothesis' | 'source_code' | 'weak_lexical';
|
|
19
|
+
field: string;
|
|
20
|
+
matchedValue: string;
|
|
21
|
+
source: 'problem' | 'solution' | 'source_chunk';
|
|
22
|
+
confidence: 'fact' | 'hypothesis' | 'low_signal';
|
|
23
|
+
rawScore: number;
|
|
24
|
+
};
|
|
25
|
+
export type ResolutionCandidate = {
|
|
26
|
+
problemId: string;
|
|
27
|
+
solutionId: string;
|
|
28
|
+
solutionRevision: number;
|
|
29
|
+
title: string;
|
|
30
|
+
fingerprint: string;
|
|
31
|
+
matchEvidence: MatchEvidence[];
|
|
32
|
+
recallScore: number;
|
|
33
|
+
};
|
|
34
|
+
export type ResolutionCandidateResponse = {
|
|
35
|
+
fingerprint: string;
|
|
36
|
+
candidates: ResolutionCandidate[];
|
|
37
|
+
};
|