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,28 @@
|
|
|
1
|
+
export declare function checkResolutionIndex(home: string, indexPath?: string): Promise<{
|
|
2
|
+
status: "missing";
|
|
3
|
+
indexPath: string;
|
|
4
|
+
userVersion?: undefined;
|
|
5
|
+
readonly sourceCount?: undefined;
|
|
6
|
+
readonly indexedCount?: undefined;
|
|
7
|
+
readonly portableChecksum?: undefined;
|
|
8
|
+
readonly indexedChecksum?: undefined;
|
|
9
|
+
readonly sourceChecksum?: undefined;
|
|
10
|
+
} | {
|
|
11
|
+
status: "clean_rebuild_required";
|
|
12
|
+
indexPath: string;
|
|
13
|
+
userVersion: number;
|
|
14
|
+
readonly sourceCount?: undefined;
|
|
15
|
+
readonly indexedCount?: undefined;
|
|
16
|
+
readonly portableChecksum?: undefined;
|
|
17
|
+
readonly indexedChecksum?: undefined;
|
|
18
|
+
readonly sourceChecksum?: undefined;
|
|
19
|
+
} | {
|
|
20
|
+
readonly status: "ok" | "stale";
|
|
21
|
+
readonly indexPath: string;
|
|
22
|
+
readonly sourceCount: number;
|
|
23
|
+
readonly indexedCount: number;
|
|
24
|
+
readonly portableChecksum: string;
|
|
25
|
+
readonly indexedChecksum: string;
|
|
26
|
+
readonly sourceChecksum: string;
|
|
27
|
+
userVersion?: undefined;
|
|
28
|
+
}>;
|
|
@@ -0,0 +1,30 @@
|
|
|
1
|
+
import { access } from 'node:fs/promises';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
import { computeResolutionSemanticChecksum } from '../core/index.js';
|
|
4
|
+
import { loadCanonicalResolutions } from './resolution-indexer.js';
|
|
5
|
+
import { closeRulebookDatabase, openRulebookDatabase } from './sqlite.js';
|
|
6
|
+
export async function checkResolutionIndex(home, indexPath = join(home, 'index/resolutions.sqlite')) {
|
|
7
|
+
try {
|
|
8
|
+
await access(indexPath);
|
|
9
|
+
}
|
|
10
|
+
catch {
|
|
11
|
+
return { status: 'missing', indexPath };
|
|
12
|
+
}
|
|
13
|
+
const loaded = await loadCanonicalResolutions(home);
|
|
14
|
+
const expected = computeResolutionSemanticChecksum(loaded.map(({ document }) => document));
|
|
15
|
+
const database = openRulebookDatabase({ databasePath: indexPath });
|
|
16
|
+
try {
|
|
17
|
+
const userVersion = database.pragma('user_version', { simple: true });
|
|
18
|
+
const hasV3 = database.prepare("SELECT count(*) AS count FROM sqlite_master WHERE type='table' AND name='problems'").get();
|
|
19
|
+
if (userVersion !== 3 || hasV3.count !== 1)
|
|
20
|
+
return { status: 'clean_rebuild_required', indexPath, userVersion };
|
|
21
|
+
const metadata = Object.fromEntries(database.prepare('SELECT key, value FROM index_metadata').all().map(({ key, value }) => [key, value]));
|
|
22
|
+
const indexedCount = Number(metadata.canonical_count ?? -1);
|
|
23
|
+
const status = metadata.portable_checksum === expected && indexedCount === loaded.length ? 'ok' : 'stale';
|
|
24
|
+
return { status, indexPath, sourceCount: loaded.length, indexedCount, portableChecksum: expected, indexedChecksum: metadata.portable_checksum, sourceChecksum: metadata.source_checksum };
|
|
25
|
+
}
|
|
26
|
+
finally {
|
|
27
|
+
closeRulebookDatabase(database);
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
//# sourceMappingURL=resolution-index-check.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolution-index-check.js","sourceRoot":"","sources":["../../src/storage/resolution-index-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,iCAAiC,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAE1E,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,0BAA0B,CAAC;IACzG,IAAI,CAAC;QAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,SAAkB,EAAE,SAAS,EAAE,CAAC;IAAC,CAAC;IAC5F,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,iCAAiC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3F,MAAM,QAAQ,GAAG,oBAAoB,CAAC,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAW,CAAC;QAChF,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,oFAAoF,CAAC,CAAC,GAAG,EAAuB,CAAC;QAChJ,IAAI,WAAW,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,wBAAiC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC;QACzH,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAE,QAAQ,CAAC,OAAO,CAAC,uCAAuC,CAAC,CAAC,GAAG,EAA4C,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;QACtL,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,eAAe,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,QAAQ,CAAC,iBAAiB,KAAK,QAAQ,IAAI,YAAY,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QAC1G,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,eAAe,EAAE,QAAQ,CAAC,iBAAiB,EAAE,cAAc,EAAE,QAAQ,CAAC,eAAe,EAAW,CAAC;IACrM,CAAC;YAAS,CAAC;QACT,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;AACH,CAAC"}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
import type { ResolutionDocument } from '../core/index.js';
|
|
2
|
+
import type { SourceChunkChecksumInput } from '../core/resolution-semantic-checksum.js';
|
|
3
|
+
export type RebuildResolutionIndexOptions = {
|
|
4
|
+
home: string;
|
|
5
|
+
indexPath?: string;
|
|
6
|
+
sourceChunks?: SourceChunkChecksumInput[];
|
|
7
|
+
};
|
|
8
|
+
export declare function loadCanonicalResolutions(home: string): Promise<Array<{
|
|
9
|
+
path: string;
|
|
10
|
+
document: ResolutionDocument;
|
|
11
|
+
}>>;
|
|
12
|
+
export declare function rebuildResolutionIndex(options: RebuildResolutionIndexOptions): Promise<{
|
|
13
|
+
status: "ok";
|
|
14
|
+
indexPath: string;
|
|
15
|
+
canonicalCount: number;
|
|
16
|
+
sourceChunkCount: number;
|
|
17
|
+
portableChecksum: string;
|
|
18
|
+
sourceChecksum: string;
|
|
19
|
+
}>;
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
import { randomUUID } from 'node:crypto';
|
|
2
|
+
import { mkdir, open, readFile, readdir, rename, rm, stat } from 'node:fs/promises';
|
|
3
|
+
import { basename, dirname, join, relative } from 'node:path';
|
|
4
|
+
import { computeResolutionSemanticChecksum, computeSourceChunkChecksum, parseResolutionYaml } from '../core/index.js';
|
|
5
|
+
import { createResolutionIndexSchema } from './resolution-migrations.js';
|
|
6
|
+
import { closeRulebookDatabase, openRulebookDatabase } from './sqlite.js';
|
|
7
|
+
export async function loadCanonicalResolutions(home) {
|
|
8
|
+
const loaded = [];
|
|
9
|
+
for (const directory of ['problems', 'solutions', 'outcomes']) {
|
|
10
|
+
for (const path of await yamlFiles(join(home, directory))) {
|
|
11
|
+
const parsed = parseResolutionYaml(await readFile(path, 'utf8'), path);
|
|
12
|
+
if (!parsed.success)
|
|
13
|
+
throw new Error(`${parsed.error.kind}: ${path}: ${parsed.error.message}`);
|
|
14
|
+
loaded.push({ path, document: parsed.document });
|
|
15
|
+
}
|
|
16
|
+
}
|
|
17
|
+
return loaded;
|
|
18
|
+
}
|
|
19
|
+
export async function rebuildResolutionIndex(options) {
|
|
20
|
+
const indexPath = options.indexPath ?? join(options.home, 'index/resolutions.sqlite');
|
|
21
|
+
const tempPath = `${indexPath}.tmp-${process.pid}-${randomUUID()}`;
|
|
22
|
+
const lockPath = `${indexPath}.lock`;
|
|
23
|
+
await mkdir(dirname(indexPath), { recursive: true });
|
|
24
|
+
await removeStaleLock(lockPath);
|
|
25
|
+
const lock = await open(lockPath, 'wx').catch((error) => {
|
|
26
|
+
throw new Error(error.code === 'EEXIST' ? 'Resolution index rebuild already in progress' : error.message);
|
|
27
|
+
});
|
|
28
|
+
try {
|
|
29
|
+
await cleanupStaleTemps(indexPath);
|
|
30
|
+
const loaded = await loadCanonicalResolutions(options.home);
|
|
31
|
+
const documents = loaded.map(({ document }) => document);
|
|
32
|
+
validateReferences(documents);
|
|
33
|
+
const chunks = options.sourceChunks ?? [];
|
|
34
|
+
let database;
|
|
35
|
+
try {
|
|
36
|
+
database = openRulebookDatabase({ databasePath: tempPath });
|
|
37
|
+
createResolutionIndexSchema(database);
|
|
38
|
+
const write = database.transaction(() => {
|
|
39
|
+
for (const item of loaded)
|
|
40
|
+
insertDocument(database, options.home, item.path, item.document);
|
|
41
|
+
for (const chunk of chunks)
|
|
42
|
+
insertChunk(database, chunk);
|
|
43
|
+
const metadata = database.prepare('INSERT INTO index_metadata (key, value) VALUES (?, ?)');
|
|
44
|
+
metadata.run('portable_checksum', computeResolutionSemanticChecksum(documents));
|
|
45
|
+
metadata.run('source_checksum', computeSourceChunkChecksum(chunks));
|
|
46
|
+
metadata.run('canonical_count', String(documents.length));
|
|
47
|
+
});
|
|
48
|
+
write();
|
|
49
|
+
const integrity = database.pragma('integrity_check', { simple: true });
|
|
50
|
+
if (integrity !== 'ok')
|
|
51
|
+
throw new Error(`Resolution index integrity failed: ${String(integrity)}`);
|
|
52
|
+
database.pragma('wal_checkpoint(TRUNCATE)');
|
|
53
|
+
}
|
|
54
|
+
finally {
|
|
55
|
+
if (database !== undefined)
|
|
56
|
+
closeRulebookDatabase(database);
|
|
57
|
+
}
|
|
58
|
+
await rename(tempPath, indexPath);
|
|
59
|
+
return {
|
|
60
|
+
status: 'ok',
|
|
61
|
+
indexPath,
|
|
62
|
+
canonicalCount: documents.length,
|
|
63
|
+
sourceChunkCount: chunks.length,
|
|
64
|
+
portableChecksum: computeResolutionSemanticChecksum(documents),
|
|
65
|
+
sourceChecksum: computeSourceChunkChecksum(chunks),
|
|
66
|
+
};
|
|
67
|
+
}
|
|
68
|
+
finally {
|
|
69
|
+
await lock.close().catch(() => undefined);
|
|
70
|
+
await rm(lockPath, { force: true });
|
|
71
|
+
await rm(tempPath, { force: true });
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
async function removeStaleLock(lockPath) {
|
|
75
|
+
try {
|
|
76
|
+
const metadata = await stat(lockPath);
|
|
77
|
+
if (Date.now() - metadata.mtimeMs > 30_000)
|
|
78
|
+
await rm(lockPath, { force: true });
|
|
79
|
+
}
|
|
80
|
+
catch (error) {
|
|
81
|
+
if (error.code !== 'ENOENT')
|
|
82
|
+
throw error;
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
async function cleanupStaleTemps(indexPath) {
|
|
86
|
+
const directory = dirname(indexPath);
|
|
87
|
+
const prefix = `${basename(indexPath)}.tmp-`;
|
|
88
|
+
for (const entry of await readdir(directory)) {
|
|
89
|
+
if (entry.startsWith(prefix))
|
|
90
|
+
await rm(join(directory, entry), { force: true });
|
|
91
|
+
}
|
|
92
|
+
}
|
|
93
|
+
function insertDocument(database, home, path, document) {
|
|
94
|
+
const storedPath = relative(home, path).replace(/\\/g, '/');
|
|
95
|
+
if (document.kind === 'problem')
|
|
96
|
+
return insertProblem(database, storedPath, document);
|
|
97
|
+
if (document.kind === 'solution')
|
|
98
|
+
return insertSolution(database, storedPath, document);
|
|
99
|
+
insertOutcome(database, document);
|
|
100
|
+
}
|
|
101
|
+
function insertProblem(database, path, problem) {
|
|
102
|
+
database.prepare('INSERT INTO problems VALUES (?, ?, ?, ?, ?, ?)').run(problem.id, path, problem.title, JSON.stringify(problem.observations), JSON.stringify(problem.hypotheses), JSON.stringify(problem.environment));
|
|
103
|
+
database.prepare('INSERT INTO problem_fts VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)').run(problem.id, problem.title, problem.observations.symptoms.join('\n'), problem.observations.error_signatures.join('\n'), problem.observations.symbols.join('\n'), problem.observations.operations.join('\n'), problem.observations.expected, problem.observations.observed, [...problem.hypotheses.suspected_causes, ...problem.hypotheses.components].join('\n'));
|
|
104
|
+
insertEnvironmentFacets(database, 'problem', problem.id, problem.environment);
|
|
105
|
+
}
|
|
106
|
+
function insertSolution(database, path, solution) {
|
|
107
|
+
const key = `${solution.id}@${solution.revision}`;
|
|
108
|
+
database.prepare('INSERT INTO solutions VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)').run(solution.id, solution.revision, solution.problem_id, path, solution.title, solution.cause, JSON.stringify(solution.applicable_if), JSON.stringify(solution.reject_if), JSON.stringify(solution.inspections), JSON.stringify(solution.actions), JSON.stringify(solution.verification), JSON.stringify(solution.safety), JSON.stringify(solution.source_evidence), JSON.stringify(solution.prior_solution ?? null));
|
|
109
|
+
database.prepare('INSERT INTO solution_fts VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)').run(key, solution.title, solution.cause, solution.applicable_if.join('\n'), solution.reject_if.join('\n'), solution.inspections.join('\n'), solution.actions.join('\n'), solution.verification.join('\n'), solution.safety.join('\n'));
|
|
110
|
+
}
|
|
111
|
+
function insertOutcome(database, outcome) {
|
|
112
|
+
const handles = outcome.evidence.map(({ handle }) => handle);
|
|
113
|
+
database.prepare(`INSERT INTO outcome_aggregates VALUES (?, ?, ?, ?, ?, 1, ?)
|
|
114
|
+
ON CONFLICT(problem_id, solution_id, solution_revision, context_fingerprint, result)
|
|
115
|
+
DO UPDATE SET outcome_count = outcome_count + 1, evidence_handles = json_patch(evidence_handles, excluded.evidence_handles)`)
|
|
116
|
+
.run(outcome.problem_id, outcome.solution_id, outcome.solution_revision, outcome.context_fingerprint, outcome.result, JSON.stringify(handles));
|
|
117
|
+
}
|
|
118
|
+
function insertEnvironmentFacets(database, type, key, environment) {
|
|
119
|
+
const insert = database.prepare('INSERT INTO facets VALUES (?, ?, ?, ?)');
|
|
120
|
+
for (const [kind, values] of Object.entries(environment))
|
|
121
|
+
for (const value of values)
|
|
122
|
+
insert.run(type, key, kind, value);
|
|
123
|
+
}
|
|
124
|
+
function insertChunk(database, chunk) {
|
|
125
|
+
database.prepare('INSERT INTO source_chunks VALUES (?, ?, ?, ?, ?, ?, ?)').run(chunk.handle, chunk.projectKey, chunk.revision, chunk.relativePath, chunk.symbol ?? null, chunk.contentHash, chunk.content);
|
|
126
|
+
database.prepare('INSERT INTO source_chunks_fts VALUES (?, ?, ?, ?)').run(chunk.handle, chunk.relativePath, chunk.symbol ?? '', chunk.content);
|
|
127
|
+
}
|
|
128
|
+
function validateReferences(documents) {
|
|
129
|
+
const problems = new Set(documents.filter((item) => item.kind === 'problem').map(({ id }) => id));
|
|
130
|
+
const solutions = new Set(documents.filter((item) => item.kind === 'solution').map(({ id, revision }) => `${id}@${revision}`));
|
|
131
|
+
for (const document of documents) {
|
|
132
|
+
if (document.kind !== 'problem' && !problems.has(document.problem_id))
|
|
133
|
+
throw new Error(`Unknown problem reference: ${document.problem_id}`);
|
|
134
|
+
if (document.kind === 'outcome' && !solutions.has(`${document.solution_id}@${document.solution_revision}`))
|
|
135
|
+
throw new Error(`Unknown solution revision: ${document.solution_id}@${document.solution_revision}`);
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
async function yamlFiles(directory) {
|
|
139
|
+
let entries;
|
|
140
|
+
try {
|
|
141
|
+
entries = await readdir(directory, { withFileTypes: true });
|
|
142
|
+
}
|
|
143
|
+
catch (error) {
|
|
144
|
+
if (error.code === 'ENOENT')
|
|
145
|
+
return [];
|
|
146
|
+
throw error;
|
|
147
|
+
}
|
|
148
|
+
const files = [];
|
|
149
|
+
for (const entry of entries) {
|
|
150
|
+
const path = join(directory, entry.name);
|
|
151
|
+
if (entry.isDirectory())
|
|
152
|
+
files.push(...await yamlFiles(path));
|
|
153
|
+
else if (entry.isFile() && /\.ya?ml$/i.test(entry.name))
|
|
154
|
+
files.push(path);
|
|
155
|
+
}
|
|
156
|
+
return files.sort();
|
|
157
|
+
}
|
|
158
|
+
//# sourceMappingURL=resolution-indexer.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolution-indexer.js","sourceRoot":"","sources":["../../src/storage/resolution-indexer.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
export const RESOLUTION_DATABASE_VERSION = 3;
|
|
2
|
+
export function createResolutionIndexSchema(database) {
|
|
3
|
+
if (database.pragma('user_version', { simple: true }) !== 0) {
|
|
4
|
+
throw new Error('Existing index requires a clean rebuild');
|
|
5
|
+
}
|
|
6
|
+
database.exec(`
|
|
7
|
+
CREATE TABLE index_metadata (key TEXT PRIMARY KEY, value TEXT NOT NULL);
|
|
8
|
+
CREATE TABLE problems (
|
|
9
|
+
id TEXT PRIMARY KEY, path TEXT NOT NULL, title TEXT NOT NULL,
|
|
10
|
+
observations TEXT NOT NULL, hypotheses TEXT NOT NULL, environment TEXT NOT NULL
|
|
11
|
+
);
|
|
12
|
+
CREATE TABLE solutions (
|
|
13
|
+
id TEXT NOT NULL, revision INTEGER NOT NULL, problem_id TEXT NOT NULL, path TEXT NOT NULL,
|
|
14
|
+
title TEXT NOT NULL, cause TEXT NOT NULL, applicable_if TEXT NOT NULL, reject_if TEXT NOT NULL,
|
|
15
|
+
inspections TEXT NOT NULL, actions TEXT NOT NULL, verification TEXT NOT NULL, safety TEXT NOT NULL,
|
|
16
|
+
source_evidence TEXT NOT NULL, lineage TEXT NOT NULL,
|
|
17
|
+
PRIMARY KEY (id, revision), FOREIGN KEY (problem_id) REFERENCES problems(id)
|
|
18
|
+
);
|
|
19
|
+
CREATE TABLE outcome_aggregates (
|
|
20
|
+
problem_id TEXT NOT NULL, solution_id TEXT NOT NULL, solution_revision INTEGER NOT NULL,
|
|
21
|
+
context_fingerprint TEXT NOT NULL, result TEXT NOT NULL, outcome_count INTEGER NOT NULL,
|
|
22
|
+
evidence_handles TEXT NOT NULL,
|
|
23
|
+
PRIMARY KEY (problem_id, solution_id, solution_revision, context_fingerprint, result)
|
|
24
|
+
);
|
|
25
|
+
CREATE TABLE facets (
|
|
26
|
+
record_type TEXT NOT NULL, record_key TEXT NOT NULL, kind TEXT NOT NULL, value TEXT NOT NULL,
|
|
27
|
+
PRIMARY KEY (record_type, record_key, kind, value)
|
|
28
|
+
);
|
|
29
|
+
CREATE VIRTUAL TABLE problem_fts USING fts5(problem_id UNINDEXED, title, symptoms, signatures, symbols, operations, expected, observed, hypotheses);
|
|
30
|
+
CREATE VIRTUAL TABLE solution_fts USING fts5(solution_key UNINDEXED, title, cause, applicable_if, reject_if, inspections, actions, verification, safety);
|
|
31
|
+
CREATE TABLE source_chunks (
|
|
32
|
+
handle TEXT PRIMARY KEY, project_key TEXT NOT NULL, revision TEXT NOT NULL,
|
|
33
|
+
relative_path TEXT NOT NULL, symbol TEXT, content_hash TEXT NOT NULL, content TEXT NOT NULL
|
|
34
|
+
);
|
|
35
|
+
CREATE VIRTUAL TABLE source_chunks_fts USING fts5(handle UNINDEXED, relative_path, symbol, content);
|
|
36
|
+
PRAGMA user_version = 3;
|
|
37
|
+
`);
|
|
38
|
+
}
|
|
39
|
+
//# sourceMappingURL=resolution-migrations.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolution-migrations.js","sourceRoot":"","sources":["../../src/storage/resolution-migrations.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC;AAE7C,MAAM,UAAU,2BAA2B,CAAC,QAA0B;IACpE,IAAK,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAY,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+Bb,CAAC,CAAC;AACL,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,10 +1,12 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "agent-rulebook",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"description": "Agent-native MCP memory for retrieving verified problems, solutions, outcomes, and source evidence.",
|
|
5
5
|
"license": "UNLICENSED",
|
|
6
6
|
"keywords": [
|
|
7
|
-
"agent-
|
|
7
|
+
"agent-memory",
|
|
8
|
+
"resolution-memory",
|
|
9
|
+
"problem-solving",
|
|
8
10
|
"cli",
|
|
9
11
|
"codex",
|
|
10
12
|
"mcp",
|
package/dist/commands/add.d.ts
DELETED
package/dist/commands/add.js
DELETED
|
@@ -1,134 +0,0 @@
|
|
|
1
|
-
import { readFile } from 'node:fs/promises';
|
|
2
|
-
import { RuleLanguageSchema, buildRulePreview, extractLessonCandidatesFromMarkdown, resolveRulebookHome, } from '../core/index.js';
|
|
3
|
-
import { rebuildRulebookIndex, saveRulePreview } from '../storage/index.js';
|
|
4
|
-
import { writeJson } from './output.js';
|
|
5
|
-
export function registerAddCommand(program) {
|
|
6
|
-
program
|
|
7
|
-
.command('add')
|
|
8
|
-
.description('Add a rule to the local Agent Rulebook')
|
|
9
|
-
.option('--title <title>', 'Rule title')
|
|
10
|
-
.option('--language <language>', 'Rule language')
|
|
11
|
-
.option('--tool <tool>', 'Rule tool tag', collectOption, [])
|
|
12
|
-
.option('--category <category>', 'Rule category tag', collectOption, [])
|
|
13
|
-
.option('--mistake <mistake>', 'Mistake to avoid')
|
|
14
|
-
.option('--fix <fix>', 'Recommended fix')
|
|
15
|
-
.option('--source-project <sourceProject>', 'Source project name')
|
|
16
|
-
.option('--from-file <path>', 'Import preview candidates from a markdown lessons file')
|
|
17
|
-
.option('--yes', 'Save without interactive confirmation')
|
|
18
|
-
.option('--json', 'Print JSON output')
|
|
19
|
-
.action(async (options) => {
|
|
20
|
-
const home = resolveRulebookHome();
|
|
21
|
-
const language = parseLanguageOption(options.language);
|
|
22
|
-
if (language.kind === 'invalid') {
|
|
23
|
-
process.stderr.write(`Invalid language: ${options.language}\n`);
|
|
24
|
-
process.exitCode = 1;
|
|
25
|
-
return;
|
|
26
|
-
}
|
|
27
|
-
if (options.fromFile !== undefined) {
|
|
28
|
-
await previewFromFile(options.fromFile, options, language.value);
|
|
29
|
-
return;
|
|
30
|
-
}
|
|
31
|
-
await addFromFlags(home, options, language.value);
|
|
32
|
-
});
|
|
33
|
-
return program;
|
|
34
|
-
}
|
|
35
|
-
async function previewFromFile(filePath, options, language) {
|
|
36
|
-
const source = await readFile(filePath, 'utf8');
|
|
37
|
-
const result = extractLessonCandidatesFromMarkdown(source, {
|
|
38
|
-
defaultLanguage: language,
|
|
39
|
-
sourceProject: options.sourceProject,
|
|
40
|
-
});
|
|
41
|
-
const output = {
|
|
42
|
-
status: 'preview',
|
|
43
|
-
...result,
|
|
44
|
-
};
|
|
45
|
-
if (options.json === true) {
|
|
46
|
-
writeJson(output);
|
|
47
|
-
return;
|
|
48
|
-
}
|
|
49
|
-
for (const candidate of output.candidates) {
|
|
50
|
-
process.stdout.write(`title\t${candidate.title}\n`);
|
|
51
|
-
process.stdout.write(`mistake\t${candidate.mistake}\n`);
|
|
52
|
-
process.stdout.write(`fix\t${candidate.fix}\n\n`);
|
|
53
|
-
}
|
|
54
|
-
}
|
|
55
|
-
async function addFromFlags(home, options, language) {
|
|
56
|
-
const missing = collectMissingFields(options, language);
|
|
57
|
-
if (missing.length > 0) {
|
|
58
|
-
process.stderr.write(`Missing required fields: ${missing.join(', ')}\n`);
|
|
59
|
-
process.exitCode = 1;
|
|
60
|
-
return;
|
|
61
|
-
}
|
|
62
|
-
const draft = {
|
|
63
|
-
title: options.title?.trim() ?? '',
|
|
64
|
-
language,
|
|
65
|
-
tools: options.tool,
|
|
66
|
-
categories: options.category,
|
|
67
|
-
mistake: options.mistake?.trim() ?? '',
|
|
68
|
-
fix: options.fix?.trim() ?? '',
|
|
69
|
-
};
|
|
70
|
-
if (options.sourceProject !== undefined) {
|
|
71
|
-
draft.source_project = options.sourceProject;
|
|
72
|
-
}
|
|
73
|
-
const preview = await buildRulePreview(draft, { rulebookHome: home });
|
|
74
|
-
if (options.yes !== true) {
|
|
75
|
-
process.stdout.write(preview.yaml);
|
|
76
|
-
process.stderr.write('Review the YAML preview and rerun with --yes to save.\n');
|
|
77
|
-
process.exitCode = 1;
|
|
78
|
-
return;
|
|
79
|
-
}
|
|
80
|
-
if (!preview.can_save) {
|
|
81
|
-
process.stdout.write(preview.yaml);
|
|
82
|
-
process.stderr.write(formatRedactionBlockMessage(preview.warnings));
|
|
83
|
-
process.exitCode = 1;
|
|
84
|
-
return;
|
|
85
|
-
}
|
|
86
|
-
await saveRulePreview({ rulebookHome: home, preview });
|
|
87
|
-
const index = await rebuildRulebookIndex({ home });
|
|
88
|
-
const output = {
|
|
89
|
-
status: 'saved',
|
|
90
|
-
id: preview.id,
|
|
91
|
-
relativePath: preview.relativePath,
|
|
92
|
-
preview,
|
|
93
|
-
index,
|
|
94
|
-
};
|
|
95
|
-
if (options.json === true) {
|
|
96
|
-
writeJson(output);
|
|
97
|
-
return;
|
|
98
|
-
}
|
|
99
|
-
process.stdout.write(`saved\t${preview.relativePath}\n`);
|
|
100
|
-
process.stdout.write(`indexed\t${index.indexedCount}\n`);
|
|
101
|
-
}
|
|
102
|
-
function collectMissingFields(options, language) {
|
|
103
|
-
const missing = [];
|
|
104
|
-
if (options.title === undefined || options.title.trim().length === 0) {
|
|
105
|
-
missing.push('title');
|
|
106
|
-
}
|
|
107
|
-
if (language === undefined) {
|
|
108
|
-
missing.push('language');
|
|
109
|
-
}
|
|
110
|
-
if (options.mistake === undefined || options.mistake.trim().length === 0) {
|
|
111
|
-
missing.push('mistake');
|
|
112
|
-
}
|
|
113
|
-
if (options.fix === undefined || options.fix.trim().length === 0) {
|
|
114
|
-
missing.push('fix');
|
|
115
|
-
}
|
|
116
|
-
return missing;
|
|
117
|
-
}
|
|
118
|
-
function collectOption(value, previous) {
|
|
119
|
-
return [...previous, value];
|
|
120
|
-
}
|
|
121
|
-
function parseLanguageOption(value) {
|
|
122
|
-
if (value === undefined) {
|
|
123
|
-
return { kind: 'valid', value: undefined };
|
|
124
|
-
}
|
|
125
|
-
const result = RuleLanguageSchema.safeParse(value);
|
|
126
|
-
return result.success ? { kind: 'valid', value: result.data } : { kind: 'invalid' };
|
|
127
|
-
}
|
|
128
|
-
function formatRedactionBlockMessage(warnings) {
|
|
129
|
-
const summary = warnings
|
|
130
|
-
.map((warning) => `${warning.kind}:${warning.pattern}`)
|
|
131
|
-
.join(', ');
|
|
132
|
-
return `Blocked by unresolved redaction warnings: ${summary}\n`;
|
|
133
|
-
}
|
|
134
|
-
//# sourceMappingURL=add.js.map
|
package/dist/commands/add.js.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"add.js","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"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"}
|
package/dist/commands/migrate.js
DELETED
|
@@ -1,73 +0,0 @@
|
|
|
1
|
-
import { mkdir, readFile, writeFile } from 'node:fs/promises';
|
|
2
|
-
import { dirname, resolve } from 'node:path';
|
|
3
|
-
import { applyMigration, MigrationManifestSchema, scanMigrationSources, verifyMigration, } from '../migration/index.js';
|
|
4
|
-
import { writeJson } from './output.js';
|
|
5
|
-
export function registerMigrateCommand(program) {
|
|
6
|
-
const migrate = program.command('migrate').description('Discover and migrate legacy rule sources');
|
|
7
|
-
migrate
|
|
8
|
-
.command('scan')
|
|
9
|
-
.description('Scan legacy sources without modifying them')
|
|
10
|
-
.argument('<roots...>', 'Source roots to scan')
|
|
11
|
-
.requiredOption('--output <file>', 'Write the local migration manifest to this file')
|
|
12
|
-
.action(async (roots, options) => {
|
|
13
|
-
const manifest = await scanMigrationSources(roots);
|
|
14
|
-
const outputPath = resolve(options.output);
|
|
15
|
-
await mkdir(dirname(outputPath), { recursive: true });
|
|
16
|
-
await writeFile(outputPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
|
|
17
|
-
process.stdout.write(`Migration scan complete: ${manifest.summary.candidates} candidates, ` +
|
|
18
|
-
`${manifest.summary.review_required} review required, ${manifest.summary.errors} errors.\n`);
|
|
19
|
-
});
|
|
20
|
-
migrate
|
|
21
|
-
.command('apply')
|
|
22
|
-
.description('Apply a migration manifest to an explicit Rulebook home')
|
|
23
|
-
.argument('<manifest>', 'Migration manifest JSON file')
|
|
24
|
-
.requiredOption('--home <directory>', 'Explicit target Rulebook home')
|
|
25
|
-
.option('--dry-run', 'Report changes without writing files or rebuilding the index')
|
|
26
|
-
.option('--confirm-real-home', 'Confirm writes to the default ~/.agent-rulebook home')
|
|
27
|
-
.option('--json', 'Print JSON output')
|
|
28
|
-
.action(async (manifestPath, options) => {
|
|
29
|
-
const manifest = await readManifest(manifestPath);
|
|
30
|
-
const report = await applyMigration(manifest, {
|
|
31
|
-
home: options.home,
|
|
32
|
-
dryRun: options.dryRun,
|
|
33
|
-
confirmRealHome: options.confirmRealHome,
|
|
34
|
-
});
|
|
35
|
-
if (options.json === true) {
|
|
36
|
-
writeJson(report);
|
|
37
|
-
}
|
|
38
|
-
else {
|
|
39
|
-
process.stdout.write(`Migration apply ${report.status}: ${report.totals.created} created, ` +
|
|
40
|
-
`${report.totals.unchanged} unchanged, ${report.totals.conflicts} conflicts.\n`);
|
|
41
|
-
}
|
|
42
|
-
if (report.status === 'blocked' || report.status === 'rolled_back') {
|
|
43
|
-
process.exitCode = 1;
|
|
44
|
-
}
|
|
45
|
-
});
|
|
46
|
-
migrate
|
|
47
|
-
.command('verify')
|
|
48
|
-
.description('Verify a migration manifest against an explicit Rulebook home')
|
|
49
|
-
.argument('<manifest>', 'Migration manifest JSON file')
|
|
50
|
-
.requiredOption('--home <directory>', 'Explicit target Rulebook home')
|
|
51
|
-
.option('--json', 'Print JSON output')
|
|
52
|
-
.action(async (manifestPath, options) => {
|
|
53
|
-
const manifest = await readManifest(manifestPath);
|
|
54
|
-
const report = await verifyMigration(manifest, { home: options.home });
|
|
55
|
-
if (options.json === true) {
|
|
56
|
-
writeJson(report);
|
|
57
|
-
}
|
|
58
|
-
else {
|
|
59
|
-
process.stdout.write(`Migration verify ${report.status}: ${report.totals.valid} valid, ` +
|
|
60
|
-
`${report.totals.invalid} invalid, ${report.totals.duplicates} duplicates.\n`);
|
|
61
|
-
}
|
|
62
|
-
if (report.status !== 'passed') {
|
|
63
|
-
process.exitCode = 1;
|
|
64
|
-
}
|
|
65
|
-
});
|
|
66
|
-
return program;
|
|
67
|
-
}
|
|
68
|
-
async function readManifest(path) {
|
|
69
|
-
const source = await readFile(resolve(path), 'utf8');
|
|
70
|
-
const parsedJson = JSON.parse(source);
|
|
71
|
-
return MigrationManifestSchema.parse(parsedJson);
|
|
72
|
-
}
|
|
73
|
-
//# sourceMappingURL=migrate.js.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../src/commands/migrate.ts"],"names":[],"mappings":"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"}
|
package/dist/commands/rule.d.ts
DELETED
|
@@ -1,23 +0,0 @@
|
|
|
1
|
-
import type { Command } from 'commander';
|
|
2
|
-
type LifecycleAction = 'deprecate' | 'supersede' | 'verify';
|
|
3
|
-
type LifecycleIssue = {
|
|
4
|
-
code: string;
|
|
5
|
-
message: string;
|
|
6
|
-
ruleId?: string;
|
|
7
|
-
};
|
|
8
|
-
type LifecycleOptions = {
|
|
9
|
-
evidence?: string;
|
|
10
|
-
replacement?: string;
|
|
11
|
-
yes?: boolean;
|
|
12
|
-
json?: boolean;
|
|
13
|
-
};
|
|
14
|
-
type LifecycleResult = {
|
|
15
|
-
status: 'blocked' | 'preview' | 'updated';
|
|
16
|
-
action: LifecycleAction;
|
|
17
|
-
ruleId: string;
|
|
18
|
-
replacement?: string;
|
|
19
|
-
issues: LifecycleIssue[];
|
|
20
|
-
};
|
|
21
|
-
export declare function registerRuleCommand(program: Command): Command;
|
|
22
|
-
export declare function changeRuleLifecycle(home: string, action: LifecycleAction, ruleId: string, options: LifecycleOptions): Promise<LifecycleResult>;
|
|
23
|
-
export {};
|