agent-rulebook 0.1.7 → 0.2.1
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 +63 -140
- package/dist/commands/home.d.ts +2 -0
- package/dist/commands/home.js +59 -0
- package/dist/commands/home.js.map +1 -0
- 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 +7 -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 +21 -0
- package/dist/storage/resolution-home.js +62 -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
package/dist/mcp/tools.js
CHANGED
|
@@ -1,123 +1,69 @@
|
|
|
1
|
-
import { MCP_DEFAULT_SEARCH_LIMIT, MCP_MAX_SEARCH_LIMIT,
|
|
2
|
-
import {
|
|
3
|
-
import {
|
|
4
|
-
import {
|
|
5
|
-
import {
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
8
|
-
import {
|
|
9
|
-
|
|
10
|
-
export const MCP_SEARCH_LIMIT_POLICY = {
|
|
11
|
-
defaultLimit: MCP_DEFAULT_SEARCH_LIMIT,
|
|
12
|
-
maxLimit: MCP_MAX_SEARCH_LIMIT,
|
|
13
|
-
};
|
|
1
|
+
import { MCP_DEFAULT_SEARCH_LIMIT, MCP_MAX_SEARCH_LIMIT, McpResolutionsFindInputSchema, McpResolutionsGetInputSchema, McpResolutionsGetSourceInputSchema, McpResolutionsListFacetsInputSchema, McpResolutionsReportAttemptInputSchema, McpResolutionsPrepareChangeInputSchema, McpResolutionsCommitChangeInputSchema, } from './schemas.js';
|
|
2
|
+
import { handleResolutionsFind } from './resolutions-find-tool.js';
|
|
3
|
+
import { handleResolutionsGet } from './resolutions-get-tool.js';
|
|
4
|
+
import { handleResolutionsGetSource } from './resolutions-get-source-tool.js';
|
|
5
|
+
import { handleResolutionsListFacets } from './resolutions-list-facets-tool.js';
|
|
6
|
+
import { handleResolutionsReportAttempt } from './resolutions-report-attempt-tool.js';
|
|
7
|
+
import { handleResolutionsPrepareChange } from './resolutions-prepare-change-tool.js';
|
|
8
|
+
import { handleResolutionsCommitChange } from './resolutions-commit-change-tool.js';
|
|
9
|
+
export const MCP_SEARCH_LIMIT_POLICY = { defaultLimit: MCP_DEFAULT_SEARCH_LIMIT, maxLimit: MCP_MAX_SEARCH_LIMIT };
|
|
14
10
|
export const AGENT_RULEBOOK_MCP_TOOL_NAMES = [
|
|
15
|
-
'
|
|
16
|
-
'
|
|
17
|
-
'
|
|
18
|
-
'
|
|
19
|
-
'
|
|
20
|
-
'
|
|
21
|
-
'
|
|
11
|
+
'resolutions.find',
|
|
12
|
+
'resolutions.get',
|
|
13
|
+
'resolutions.get_source',
|
|
14
|
+
'resolutions.list_facets',
|
|
15
|
+
'resolutions.report_attempt',
|
|
16
|
+
'resolutions.prepare_change',
|
|
17
|
+
'resolutions.commit_change',
|
|
22
18
|
];
|
|
23
19
|
export const AGENT_RULEBOOK_MCP_TOOLS = [
|
|
24
20
|
{
|
|
25
|
-
name: '
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
inputSchema: McpSearchInputSchema,
|
|
29
|
-
annotations: readOnlyAnnotations(),
|
|
30
|
-
handler: handleSearch,
|
|
21
|
+
name: 'resolutions.find', title: 'Find applicable resolutions',
|
|
22
|
+
description: 'Call at the first unexpected problem. Separate observations from hypotheses, then inspect match evidence and required checks before applying one candidate.',
|
|
23
|
+
inputSchema: McpResolutionsFindInputSchema, annotations: readOnlyAnnotations(), handler: handleFind,
|
|
31
24
|
},
|
|
32
25
|
{
|
|
33
|
-
name: '
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
inputSchema: McpSearchForProjectInputSchema,
|
|
37
|
-
annotations: readOnlyAnnotations(),
|
|
38
|
-
handler: handleSearchForProject,
|
|
26
|
+
name: 'resolutions.get', title: 'Get a resolution',
|
|
27
|
+
description: 'Read the selected solution applicability, inspections, actions, verification, safety, and source handles.',
|
|
28
|
+
inputSchema: McpResolutionsGetInputSchema, annotations: readOnlyAnnotations(), handler: handleGet,
|
|
39
29
|
},
|
|
40
30
|
{
|
|
41
|
-
name: '
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
inputSchema: McpSearchErrorInputSchema,
|
|
45
|
-
annotations: readOnlyAnnotations(),
|
|
46
|
-
handler: handleSearchError,
|
|
31
|
+
name: 'resolutions.get_source', title: 'Get exact source evidence',
|
|
32
|
+
description: 'Read one registered source handle at its recorded revision and hash; arbitrary paths are not accepted.',
|
|
33
|
+
inputSchema: McpResolutionsGetSourceInputSchema, annotations: readOnlyAnnotations(), handler: handleGetSource,
|
|
47
34
|
},
|
|
48
35
|
{
|
|
49
|
-
name: '
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
inputSchema: McpListFacetsInputSchema,
|
|
53
|
-
annotations: readOnlyAnnotations(),
|
|
54
|
-
handler: handleListFacets,
|
|
36
|
+
name: 'resolutions.list_facets', title: 'List resolution facets',
|
|
37
|
+
description: 'List canonical environment facets and indexed counts.',
|
|
38
|
+
inputSchema: McpResolutionsListFacetsInputSchema, annotations: readOnlyAnnotations(), handler: handleListFacets,
|
|
55
39
|
},
|
|
56
40
|
{
|
|
57
|
-
name: '
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
inputSchema: McpDedupLessonInputSchema,
|
|
61
|
-
annotations: readOnlyAnnotations(),
|
|
62
|
-
handler: handleDedupLesson,
|
|
41
|
+
name: 'resolutions.report_attempt', title: 'Report resolution attempt',
|
|
42
|
+
description: 'Report the verified result of one exact solution revision.',
|
|
43
|
+
inputSchema: McpResolutionsReportAttemptInputSchema, annotations: writeAnnotations(true), handler: handleReportAttempt,
|
|
63
44
|
},
|
|
64
45
|
{
|
|
65
|
-
name: '
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
inputSchema: McpPrepareLessonInputSchema,
|
|
69
|
-
annotations: readOnlyAnnotations(),
|
|
70
|
-
handler: handlePrepareLesson,
|
|
46
|
+
name: 'resolutions.prepare_change', title: 'Prepare verified resolution change',
|
|
47
|
+
description: 'Validate and classify a verified resolution change without writing.',
|
|
48
|
+
inputSchema: McpResolutionsPrepareChangeInputSchema, annotations: readOnlyAnnotations(), handler: handlePrepareChange,
|
|
71
49
|
},
|
|
72
50
|
{
|
|
73
|
-
name: '
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
inputSchema: McpAddLessonInputSchema,
|
|
77
|
-
annotations: {
|
|
78
|
-
readOnlyHint: false,
|
|
79
|
-
destructiveHint: false,
|
|
80
|
-
idempotentHint: false,
|
|
81
|
-
openWorldHint: false,
|
|
82
|
-
},
|
|
83
|
-
handler: handleAddLesson,
|
|
51
|
+
name: 'resolutions.commit_change', title: 'Commit verified resolution change',
|
|
52
|
+
description: 'Commit an unchanged prepared resolution payload and rebuild the index.',
|
|
53
|
+
inputSchema: McpResolutionsCommitChangeInputSchema, annotations: writeAnnotations(true), handler: handleCommitChange,
|
|
84
54
|
},
|
|
85
55
|
];
|
|
86
|
-
async function
|
|
87
|
-
|
|
88
|
-
}
|
|
89
|
-
async function
|
|
90
|
-
|
|
91
|
-
}
|
|
92
|
-
async function
|
|
93
|
-
return handleRulesSearchError(args, context);
|
|
94
|
-
}
|
|
95
|
-
async function handleDedupLesson(args, context) {
|
|
96
|
-
return handleRulesDedupLesson(args, context);
|
|
97
|
-
}
|
|
98
|
-
async function handleListFacets(args, context) {
|
|
99
|
-
return handleRulesListFacets(args, context);
|
|
100
|
-
}
|
|
101
|
-
async function handlePrepareLesson(args, context) {
|
|
102
|
-
return handleRulesPrepareLesson(args, context);
|
|
103
|
-
}
|
|
104
|
-
async function handleAddLesson(args, context) {
|
|
105
|
-
return handleRulesAddLesson(args, context);
|
|
106
|
-
}
|
|
56
|
+
async function handleFind(args, context) { return handleResolutionsFind(args, context); }
|
|
57
|
+
async function handleGet(args, context) { return handleResolutionsGet(args, context); }
|
|
58
|
+
async function handleGetSource(args, context) { return handleResolutionsGetSource(args, context); }
|
|
59
|
+
async function handleListFacets(args, context) { return handleResolutionsListFacets(args, context); }
|
|
60
|
+
async function handleReportAttempt(args, context) { return handleResolutionsReportAttempt(args, context); }
|
|
61
|
+
async function handlePrepareChange(args, context) { return handleResolutionsPrepareChange(args, context); }
|
|
62
|
+
async function handleCommitChange(args, context) { return handleResolutionsCommitChange(args, context); }
|
|
107
63
|
function readOnlyAnnotations() {
|
|
108
|
-
return {
|
|
109
|
-
readOnlyHint: true,
|
|
110
|
-
destructiveHint: false,
|
|
111
|
-
idempotentHint: true,
|
|
112
|
-
openWorldHint: false,
|
|
113
|
-
};
|
|
64
|
+
return { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false };
|
|
114
65
|
}
|
|
115
|
-
|
|
116
|
-
return
|
|
117
|
-
status: 'error',
|
|
118
|
-
code: 'not_implemented',
|
|
119
|
-
tool,
|
|
120
|
-
message: `${tool} is registered but not implemented in this step.`,
|
|
121
|
-
}, true);
|
|
66
|
+
function writeAnnotations(idempotent) {
|
|
67
|
+
return { readOnlyHint: false, destructiveHint: false, idempotentHint: idempotent, openWorldHint: false };
|
|
122
68
|
}
|
|
123
69
|
//# sourceMappingURL=tools.js.map
|
package/dist/mcp/tools.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"AACA,OAAO,EACL,wBAAwB,EACxB,oBAAoB,EACpB,
|
|
1
|
+
{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/mcp/tools.ts"],"names":[],"mappings":"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"}
|
package/dist/program.js
CHANGED
|
@@ -1,25 +1,23 @@
|
|
|
1
1
|
import { Command } from 'commander';
|
|
2
|
-
import { registerAddCommand } from './commands/add.js';
|
|
3
2
|
import { registerIndexCommand } from './commands/index.js';
|
|
3
|
+
import { registerHomeCommand } from './commands/home.js';
|
|
4
4
|
import { registerInitCommand } from './commands/init.js';
|
|
5
5
|
import { registerMcpCommand } from './commands/mcp.js';
|
|
6
|
-
import {
|
|
7
|
-
import {
|
|
8
|
-
import { registerRuleCommand } from './commands/rule.js';
|
|
6
|
+
import { registerProjectCommand } from './commands/project.js';
|
|
7
|
+
import { registerResolutionCommand } from './commands/resolution.js';
|
|
9
8
|
import { registerSyncCommand } from './commands/sync.js';
|
|
10
9
|
import { AGENT_RULEBOOK_VERSION } from './version.js';
|
|
11
10
|
export function createCliProgram() {
|
|
12
11
|
const program = new Command()
|
|
13
12
|
.name('agent-rulebook')
|
|
14
|
-
.description('
|
|
13
|
+
.description('Agent-native problem, solution, and verified outcome memory')
|
|
15
14
|
.version(AGENT_RULEBOOK_VERSION);
|
|
16
15
|
registerInitCommand(program);
|
|
17
|
-
|
|
16
|
+
registerHomeCommand(program);
|
|
18
17
|
registerIndexCommand(program);
|
|
19
18
|
registerMcpCommand(program);
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
registerRuleCommand(program);
|
|
19
|
+
registerProjectCommand(program);
|
|
20
|
+
registerResolutionCommand(program);
|
|
23
21
|
registerSyncCommand(program);
|
|
24
22
|
return program;
|
|
25
23
|
}
|
package/dist/program.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"program.js","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,gBAAgB,CAAC;SACtB,WAAW,CAAC,6DAA6D,CAAC;SAC1E,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC7B,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,yBAAyB,CAAC,OAAO,CAAC,CAAC;IACnC,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAE7B,OAAO,OAAO,CAAC;AACjB,CAAC"}
|
package/dist/storage/index.d.ts
CHANGED
|
@@ -1,16 +1,11 @@
|
|
|
1
|
-
export {
|
|
1
|
+
export { createResolutionIndexSchema, RESOLUTION_DATABASE_VERSION } from './resolution-migrations.js';
|
|
2
|
+
export { loadCanonicalResolutions, rebuildResolutionIndex } from './resolution-indexer.js';
|
|
3
|
+
export { checkResolutionIndex } from './resolution-index-check.js';
|
|
4
|
+
export { findResolutionCandidates } from './resolution-candidate-service.js';
|
|
5
|
+
export { commitResolutionDocuments } from './resolution-change-transaction.js';
|
|
6
|
+
export { isSafeTrackedPath, listSafeTrackedFiles } from './project-code-index-source.js';
|
|
7
|
+
export { createResolutionHome, executeLegacyReset, previewLegacyReset, LEGACY_RESET_TARGETS, RESOLUTION_HOME_DIRECTORIES, RESOLUTION_HOME_FILES } from './resolution-home.js';
|
|
2
8
|
export { replaceFileAtomically } from './atomic-file.js';
|
|
3
|
-
export {
|
|
4
|
-
export {
|
|
5
|
-
export {
|
|
6
|
-
export { SEARCH_LIMIT_POLICIES, searchRules } from './search-service.js';
|
|
7
|
-
export { discoverRuleFiles } from './rule-discovery.js';
|
|
8
|
-
export { closeRulebookDatabase, openRulebookDatabase, readRulebookDatabaseRuntime, } from './sqlite.js';
|
|
9
|
-
export { saveRulePreview } from './rule-store.js';
|
|
10
|
-
export type { CheckRulebookIndexOptions, IndexCheckResult, IndexRuntimeCheck, IndexCheckStatus, } from './index-check.js';
|
|
11
|
-
export type { SearchRulesOptions } from './search-service.js';
|
|
12
|
-
export type { RebuildRulebookIndexOptions, RebuildRulebookIndexResult, SkippedRuleFile, } from './indexer.js';
|
|
13
|
-
export type { DiscoverRuleFilesOptions } from './rule-discovery.js';
|
|
14
|
-
export type { OpenRulebookDatabaseOptions, RulebookDatabase, RulebookDatabaseRuntime, } from './sqlite.js';
|
|
15
|
-
export type { SaveRulePreviewOptions, SaveRulePreviewResult } from './rule-store.js';
|
|
16
|
-
export type { CreateRulebookLayoutOptions, CreateRulebookLayoutResult, RulebookLayoutEntry, RulebookLayoutEntryKind, RulebookLayoutEntryStatus, } from './rulebook-home.js';
|
|
9
|
+
export { closeRulebookDatabase, openRulebookDatabase, readRulebookDatabaseRuntime } from './sqlite.js';
|
|
10
|
+
export type { RebuildResolutionIndexOptions } from './resolution-indexer.js';
|
|
11
|
+
export type { OpenRulebookDatabaseOptions, RulebookDatabase, RulebookDatabaseRuntime } from './sqlite.js';
|
package/dist/storage/index.js
CHANGED
|
@@ -1,10 +1,10 @@
|
|
|
1
|
-
export {
|
|
1
|
+
export { createResolutionIndexSchema, RESOLUTION_DATABASE_VERSION } from './resolution-migrations.js';
|
|
2
|
+
export { loadCanonicalResolutions, rebuildResolutionIndex } from './resolution-indexer.js';
|
|
3
|
+
export { checkResolutionIndex } from './resolution-index-check.js';
|
|
4
|
+
export { findResolutionCandidates } from './resolution-candidate-service.js';
|
|
5
|
+
export { commitResolutionDocuments } from './resolution-change-transaction.js';
|
|
6
|
+
export { isSafeTrackedPath, listSafeTrackedFiles } from './project-code-index-source.js';
|
|
7
|
+
export { createResolutionHome, executeLegacyReset, previewLegacyReset, LEGACY_RESET_TARGETS, RESOLUTION_HOME_DIRECTORIES, RESOLUTION_HOME_FILES } from './resolution-home.js';
|
|
2
8
|
export { replaceFileAtomically } from './atomic-file.js';
|
|
3
|
-
export {
|
|
4
|
-
export { RulebookIndexCorruptError, RulebookIndexLockTimeoutError, RulebookIndexMigrationError, RulebookIndexRebuildError, rebuildRulebookIndex, } from './indexer.js';
|
|
5
|
-
export { CURRENT_RULEBOOK_DATABASE_VERSION, migrateRulebookDatabase, } from './migrations.js';
|
|
6
|
-
export { SEARCH_LIMIT_POLICIES, searchRules } from './search-service.js';
|
|
7
|
-
export { discoverRuleFiles } from './rule-discovery.js';
|
|
8
|
-
export { closeRulebookDatabase, openRulebookDatabase, readRulebookDatabaseRuntime, } from './sqlite.js';
|
|
9
|
-
export { saveRulePreview } from './rule-store.js';
|
|
9
|
+
export { closeRulebookDatabase, openRulebookDatabase, readRulebookDatabaseRuntime } from './sqlite.js';
|
|
10
10
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACtG,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACzF,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC9K,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC"}
|
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { extname } from 'node:path';
|
|
2
|
+
import { runGit, splitGitLines } from '../core/git.js';
|
|
3
|
+
const EXCLUDED_SEGMENTS = new Set([
|
|
4
|
+
'.build', 'build', 'dist', 'artifacts', 'artifact', 'deriveddata', 'node_modules', '.git',
|
|
5
|
+
]);
|
|
6
|
+
const BINARY_EXTENSIONS = new Set([
|
|
7
|
+
'.png', '.jpg', '.jpeg', '.gif', '.pdf', '.zip', '.gz', '.sqlite', '.db', '.mov', '.mp4', '.a', '.o',
|
|
8
|
+
]);
|
|
9
|
+
const SECRET_NAMES = /(^|\/)(\.env(?:\..*)?|id_rsa|id_ed25519|.*\.(?:pem|p12|key))$/i;
|
|
10
|
+
export async function listSafeTrackedFiles(projectRoot) {
|
|
11
|
+
const result = await runGit(projectRoot, ['ls-files']);
|
|
12
|
+
if (result.exitCode !== 0)
|
|
13
|
+
throw new Error('Unable to list tracked project files');
|
|
14
|
+
return splitGitLines(result.stdout).filter(isSafeTrackedPath);
|
|
15
|
+
}
|
|
16
|
+
export function isSafeTrackedPath(relativePath) {
|
|
17
|
+
const normalized = relativePath.replace(/\\/g, '/');
|
|
18
|
+
const segments = normalized.toLowerCase().split('/');
|
|
19
|
+
return !segments.some((segment) => EXCLUDED_SEGMENTS.has(segment))
|
|
20
|
+
&& !BINARY_EXTENSIONS.has(extname(normalized).toLowerCase())
|
|
21
|
+
&& !SECRET_NAMES.test(normalized);
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=project-code-index-source.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"project-code-index-source.js","sourceRoot":"","sources":["../../src/storage/project-code-index-source.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEvD,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM;CAC1F,CAAC,CAAC;AACH,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI;CACrG,CAAC,CAAC;AACH,MAAM,YAAY,GAAG,gEAAgE,CAAC;AAEtF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,WAAmB;IAC5D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IACnF,OAAO,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrD,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;WAC7D,CAAC,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;WACzD,CAAC,YAAY,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
import type { ProblemSearchInput, ResolutionCandidateResponse } from '../core/resolution-search-types.js';
|
|
2
|
+
export declare function findResolutionCandidates(options: {
|
|
3
|
+
indexPath: string;
|
|
4
|
+
input: ProblemSearchInput;
|
|
5
|
+
limit?: number;
|
|
6
|
+
}): ResolutionCandidateResponse;
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
import { closeRulebookDatabase, openRulebookDatabase } from './sqlite.js';
|
|
2
|
+
import { fingerprintProblem, normalizeProblemInput, normalizeSearchText } from '../core/problem-fingerprint.js';
|
|
3
|
+
const STOP_TOKENS = new Set(['the', 'and', 'for', 'with', 'from', 'that', 'this', 'when', 'into', 'after', 'before', 'error', 'issue', 'problem']);
|
|
4
|
+
export function findResolutionCandidates(options) {
|
|
5
|
+
const input = normalizeProblemInput(options.input);
|
|
6
|
+
const fingerprint = fingerprintProblem(input);
|
|
7
|
+
const database = openRulebookDatabase({ databasePath: options.indexPath });
|
|
8
|
+
try {
|
|
9
|
+
const problems = database.prepare('SELECT id, title, observations, hypotheses FROM problems').all();
|
|
10
|
+
const solutions = database.prepare('SELECT * FROM solutions').all();
|
|
11
|
+
const sources = database.prepare('SELECT * FROM source_chunks').all();
|
|
12
|
+
const evidenceByProblem = new Map();
|
|
13
|
+
for (const problem of problems)
|
|
14
|
+
evidenceByProblem.set(problem.id, matchProblem(problem, input));
|
|
15
|
+
const candidates = [];
|
|
16
|
+
for (const solution of solutions) {
|
|
17
|
+
const evidence = [...(evidenceByProblem.get(solution.problem_id) ?? []), ...matchSolution(solution, input), ...matchSources(solution, sources, input)];
|
|
18
|
+
if (evidence.length === 0)
|
|
19
|
+
continue;
|
|
20
|
+
const deduped = deduplicateEvidence(evidence);
|
|
21
|
+
candidates.push({
|
|
22
|
+
problemId: solution.problem_id,
|
|
23
|
+
solutionId: solution.id,
|
|
24
|
+
solutionRevision: solution.revision,
|
|
25
|
+
title: solution.title,
|
|
26
|
+
fingerprint,
|
|
27
|
+
matchEvidence: deduped,
|
|
28
|
+
recallScore: deduped.reduce((sum, item) => sum + item.rawScore, 0),
|
|
29
|
+
});
|
|
30
|
+
}
|
|
31
|
+
candidates.sort((left, right) => right.recallScore - left.recallScore || left.solutionId.localeCompare(right.solutionId) || left.solutionRevision - right.solutionRevision);
|
|
32
|
+
return { fingerprint, candidates: candidates.slice(0, Math.max(1, Math.min(options.limit ?? 20, 50))) };
|
|
33
|
+
}
|
|
34
|
+
finally {
|
|
35
|
+
closeRulebookDatabase(database);
|
|
36
|
+
}
|
|
37
|
+
}
|
|
38
|
+
function matchProblem(row, input) {
|
|
39
|
+
const observations = JSON.parse(row.observations);
|
|
40
|
+
const hypotheses = JSON.parse(row.hypotheses);
|
|
41
|
+
return [
|
|
42
|
+
...matchLists(input.observations.error_signatures ?? [], observations.error_signatures, 'error_signature', 'observations.error_signatures', 100, 'fact'),
|
|
43
|
+
...matchLists(input.observations.symbols ?? [], observations.symbols, 'symbol', 'observations.symbols', 80, 'fact'),
|
|
44
|
+
...matchLists(input.observations.operations ?? [], observations.operations, 'operation', 'observations.operations', 65, 'fact'),
|
|
45
|
+
...matchLists(input.observations.symptoms, observations.symptoms, 'symptom', 'observations.symptoms', 55, 'fact'),
|
|
46
|
+
...matchLists([input.observations.expected, input.observations.observed], [observations.expected, observations.observed], 'expected_observed', 'observations.expected_observed', 45, 'fact'),
|
|
47
|
+
...matchLists([...(input.hypotheses?.suspected_causes ?? []), ...(input.hypotheses?.components ?? [])], [...hypotheses.suspected_causes, ...hypotheses.components], 'hypothesis', 'hypotheses', 15, 'hypothesis'),
|
|
48
|
+
];
|
|
49
|
+
}
|
|
50
|
+
function matchSolution(row, input) {
|
|
51
|
+
const factTerms = [...input.observations.symptoms, ...(input.observations.operations ?? []), input.observations.expected, input.observations.observed];
|
|
52
|
+
return matchLists(factTerms, [row.title, row.cause, ...jsonStrings(row.inspections), ...jsonStrings(row.actions), ...jsonStrings(row.verification)], 'weak_lexical', 'solution', 5, 'low_signal', 'solution');
|
|
53
|
+
}
|
|
54
|
+
function matchSources(solution, sources, input) {
|
|
55
|
+
const locators = JSON.parse(solution.source_evidence);
|
|
56
|
+
const linked = sources.filter((source) => locators.some((locator) => locator.project_key === source.project_key && locator.relative_path === source.relative_path && locator.content_hash === source.content_hash));
|
|
57
|
+
const terms = [...(input.observations.symbols ?? []), ...(input.observations.error_signatures ?? [])];
|
|
58
|
+
return linked.flatMap((source) => matchLists(terms, [source.symbol ?? '', source.relative_path, source.content], 'source_code', `source:${source.handle}`, 60, 'fact', 'source_chunk'));
|
|
59
|
+
}
|
|
60
|
+
function matchLists(queries, targets, channel, field, score, confidence, source = 'problem') {
|
|
61
|
+
const normalizedTargets = targets.map(normalizeSearchText);
|
|
62
|
+
const matches = [];
|
|
63
|
+
for (const query of queries.map(normalizeSearchText).filter(Boolean)) {
|
|
64
|
+
const queryTokens = tokens(query);
|
|
65
|
+
for (const target of normalizedTargets) {
|
|
66
|
+
const exact = target === query;
|
|
67
|
+
const phrase = query.length >= 4 && (target.includes(query) || query.includes(target));
|
|
68
|
+
const overlap = queryTokens.filter((token) => target.includes(token));
|
|
69
|
+
if (!exact && !phrase && overlap.length < Math.min(2, queryTokens.length))
|
|
70
|
+
continue;
|
|
71
|
+
matches.push({ channel, field, matchedValue: query, source, confidence, rawScore: exact ? score : phrase ? Math.round(score * 0.8) : Math.round(score * 0.4) });
|
|
72
|
+
break;
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
return matches;
|
|
76
|
+
}
|
|
77
|
+
function tokens(value) {
|
|
78
|
+
return [...new Set((value.match(/[\p{L}\p{N}_]+/gu) ?? []).filter((token) => token.length > 2 && !STOP_TOKENS.has(token)))];
|
|
79
|
+
}
|
|
80
|
+
function jsonStrings(value) {
|
|
81
|
+
const parsed = JSON.parse(value);
|
|
82
|
+
return Array.isArray(parsed) ? parsed.filter((item) => typeof item === 'string') : [];
|
|
83
|
+
}
|
|
84
|
+
function deduplicateEvidence(evidence) {
|
|
85
|
+
const byKey = new Map();
|
|
86
|
+
for (const item of evidence) {
|
|
87
|
+
const key = `${item.channel}\0${item.field}\0${item.matchedValue}\0${item.source}`;
|
|
88
|
+
const existing = byKey.get(key);
|
|
89
|
+
if (existing === undefined || item.rawScore > existing.rawScore)
|
|
90
|
+
byKey.set(key, item);
|
|
91
|
+
}
|
|
92
|
+
return [...byKey.values()].sort((left, right) => right.rawScore - left.rawScore || left.channel.localeCompare(right.channel) || left.matchedValue.localeCompare(right.matchedValue));
|
|
93
|
+
}
|
|
94
|
+
//# sourceMappingURL=resolution-candidate-service.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolution-candidate-service.js","sourceRoot":"","sources":["../../src/storage/resolution-candidate-service.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { ResolutionDocument } from '../core/index.js';
|
|
2
|
+
import type { SourceChunkChecksumInput } from '../core/resolution-semantic-checksum.js';
|
|
3
|
+
export declare function commitResolutionDocuments(options: {
|
|
4
|
+
home: string;
|
|
5
|
+
documents: ResolutionDocument[];
|
|
6
|
+
rebuild?: (home: string, sourceChunks: SourceChunkChecksumInput[]) => Promise<unknown>;
|
|
7
|
+
}): Promise<{
|
|
8
|
+
status: "ok";
|
|
9
|
+
created: string[];
|
|
10
|
+
index: unknown;
|
|
11
|
+
}>;
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import { access, readFile, rm } from 'node:fs/promises';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
import { canonicalResolutionPath, parseResolutionYaml, writeCanonicalResolution } from '../core/index.js';
|
|
4
|
+
import { closeRulebookDatabase, openRulebookDatabase } from './sqlite.js';
|
|
5
|
+
import { rebuildResolutionIndex } from './resolution-indexer.js';
|
|
6
|
+
export async function commitResolutionDocuments(options) {
|
|
7
|
+
const created = [];
|
|
8
|
+
try {
|
|
9
|
+
for (const document of options.documents) {
|
|
10
|
+
const path = canonicalResolutionPath(options.home, document);
|
|
11
|
+
if (await exists(path)) {
|
|
12
|
+
const parsed = parseResolutionYaml(await readFile(path, 'utf8'), path);
|
|
13
|
+
if (parsed.success && JSON.stringify(parsed.document) === JSON.stringify(document))
|
|
14
|
+
continue;
|
|
15
|
+
throw new Error(`Immutable canonical target already exists: ${path}`);
|
|
16
|
+
}
|
|
17
|
+
created.push((await writeCanonicalResolution(options.home, document)).path);
|
|
18
|
+
}
|
|
19
|
+
const sourceChunks = readIndexedSourceChunks(options.home);
|
|
20
|
+
const index = options.rebuild === undefined
|
|
21
|
+
? await rebuildResolutionIndex({ home: options.home, sourceChunks })
|
|
22
|
+
: await options.rebuild(options.home, sourceChunks);
|
|
23
|
+
return { status: 'ok', created, index };
|
|
24
|
+
}
|
|
25
|
+
catch (error) {
|
|
26
|
+
for (const path of created.reverse())
|
|
27
|
+
await rm(path, { force: true });
|
|
28
|
+
throw error;
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
function readIndexedSourceChunks(home) {
|
|
32
|
+
const indexPath = join(home, 'index/resolutions.sqlite');
|
|
33
|
+
try {
|
|
34
|
+
const database = openRulebookDatabase({ databasePath: indexPath });
|
|
35
|
+
try {
|
|
36
|
+
const rows = database.prepare('SELECT handle, project_key, revision, relative_path, symbol, content_hash, content FROM source_chunks').all();
|
|
37
|
+
return rows.map((row) => ({ handle: row.handle, projectKey: row.project_key, revision: row.revision, relativePath: row.relative_path, ...(row.symbol === null ? {} : { symbol: row.symbol }), contentHash: row.content_hash, content: row.content }));
|
|
38
|
+
}
|
|
39
|
+
finally {
|
|
40
|
+
closeRulebookDatabase(database);
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
catch {
|
|
44
|
+
return [];
|
|
45
|
+
}
|
|
46
|
+
}
|
|
47
|
+
async function exists(path) {
|
|
48
|
+
try {
|
|
49
|
+
await access(path);
|
|
50
|
+
return true;
|
|
51
|
+
}
|
|
52
|
+
catch {
|
|
53
|
+
return false;
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
//# sourceMappingURL=resolution-change-transaction.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"resolution-change-transaction.js","sourceRoot":"","sources":["../../src/storage/resolution-change-transaction.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
export declare const RESOLUTION_HOME_DIRECTORIES: readonly ["problems", "solutions", "outcomes", "index", "logs"];
|
|
2
|
+
export declare const RESOLUTION_HOME_FILES: {
|
|
3
|
+
readonly 'config.yaml': "schema_version: 3\nlayout: resolution-memory\n";
|
|
4
|
+
readonly 'projects.local.yaml': "schema_version: 1\nprojects: {}\n";
|
|
5
|
+
readonly '.gitignore': string;
|
|
6
|
+
};
|
|
7
|
+
export declare const LEGACY_RESET_TARGETS: readonly ["rules", "index"];
|
|
8
|
+
export declare function createResolutionHome(home: string): Promise<void>;
|
|
9
|
+
export type LegacyResetPreview = {
|
|
10
|
+
home: string;
|
|
11
|
+
deletionTargets: string[];
|
|
12
|
+
rewritten: string[];
|
|
13
|
+
preserved: string[];
|
|
14
|
+
};
|
|
15
|
+
export declare function previewLegacyReset(home: string): Promise<LegacyResetPreview>;
|
|
16
|
+
export declare function executeLegacyReset(options: {
|
|
17
|
+
home: string;
|
|
18
|
+
expectedHome: string;
|
|
19
|
+
confirmation: string;
|
|
20
|
+
privateGitVerified: boolean;
|
|
21
|
+
}): Promise<LegacyResetPreview>;
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
import { access, mkdir, realpath, rm, writeFile } from 'node:fs/promises';
|
|
2
|
+
import { join } from 'node:path';
|
|
3
|
+
export const RESOLUTION_HOME_DIRECTORIES = ['problems', 'solutions', 'outcomes', 'index', 'logs'];
|
|
4
|
+
export const RESOLUTION_HOME_FILES = {
|
|
5
|
+
'config.yaml': 'schema_version: 3\nlayout: resolution-memory\n',
|
|
6
|
+
'projects.local.yaml': 'schema_version: 1\nprojects: {}\n',
|
|
7
|
+
'.gitignore': ['projects.local.yaml', 'index/', 'logs/', '*.lock', '*.tmp', ''].join('\n'),
|
|
8
|
+
};
|
|
9
|
+
export const LEGACY_RESET_TARGETS = ['rules', 'index'];
|
|
10
|
+
export async function createResolutionHome(home) {
|
|
11
|
+
await mkdir(home, { recursive: true });
|
|
12
|
+
for (const directory of RESOLUTION_HOME_DIRECTORIES)
|
|
13
|
+
await mkdir(join(home, directory), { recursive: true });
|
|
14
|
+
for (const [relativePath, content] of Object.entries(RESOLUTION_HOME_FILES)) {
|
|
15
|
+
if (!(await exists(join(home, relativePath)))) {
|
|
16
|
+
await writeFile(join(home, relativePath), content, { encoding: 'utf8', flag: 'wx' });
|
|
17
|
+
}
|
|
18
|
+
}
|
|
19
|
+
}
|
|
20
|
+
export async function previewLegacyReset(home) {
|
|
21
|
+
const resolvedHome = await realpath(home);
|
|
22
|
+
const deletionTargets = [];
|
|
23
|
+
for (const target of LEGACY_RESET_TARGETS) {
|
|
24
|
+
const absolutePath = join(resolvedHome, target);
|
|
25
|
+
if (await exists(absolutePath))
|
|
26
|
+
deletionTargets.push(absolutePath);
|
|
27
|
+
}
|
|
28
|
+
return {
|
|
29
|
+
home: resolvedHome,
|
|
30
|
+
deletionTargets,
|
|
31
|
+
rewritten: ['config.yaml', '.gitignore'].map((item) => join(resolvedHome, item)),
|
|
32
|
+
preserved: ['.git', 'projects.local.yaml', 'logs'].map((item) => join(resolvedHome, item)),
|
|
33
|
+
};
|
|
34
|
+
}
|
|
35
|
+
export async function executeLegacyReset(options) {
|
|
36
|
+
const preview = await previewLegacyReset(options.home);
|
|
37
|
+
const expectedHome = await realpath(options.expectedHome);
|
|
38
|
+
if (preview.home !== expectedHome) {
|
|
39
|
+
throw new Error('Resolved home does not match the exact reset target');
|
|
40
|
+
}
|
|
41
|
+
if (!options.privateGitVerified || !(await exists(join(preview.home, '.git')))) {
|
|
42
|
+
throw new Error('Reset requires a verified private Git worktree');
|
|
43
|
+
}
|
|
44
|
+
if (options.confirmation !== 'RESET LEGACY RULEBOOK')
|
|
45
|
+
throw new Error('Explicit reset confirmation is required');
|
|
46
|
+
for (const target of preview.deletionTargets)
|
|
47
|
+
await rm(target, { recursive: true, force: false });
|
|
48
|
+
await writeFile(join(preview.home, 'config.yaml'), RESOLUTION_HOME_FILES['config.yaml'], 'utf8');
|
|
49
|
+
await writeFile(join(preview.home, '.gitignore'), RESOLUTION_HOME_FILES['.gitignore'], 'utf8');
|
|
50
|
+
await createResolutionHome(preview.home);
|
|
51
|
+
return preview;
|
|
52
|
+
}
|
|
53
|
+
async function exists(path) {
|
|
54
|
+
try {
|
|
55
|
+
await access(path);
|
|
56
|
+
return true;
|
|
57
|
+
}
|
|
58
|
+
catch {
|
|
59
|
+
return false;
|
|
60
|
+
}
|
|
61
|
+
}
|
|
62
|
+
//# sourceMappingURL=resolution-home.js.map
|