agent-rulebook 0.2.1 → 0.3.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.
Files changed (177) hide show
  1. package/README.md +69 -5
  2. package/dist/commands/dashboard.d.ts +7 -0
  3. package/dist/commands/dashboard.js +42 -0
  4. package/dist/commands/dashboard.js.map +1 -0
  5. package/dist/commands/diagnostics.d.ts +2 -0
  6. package/dist/commands/diagnostics.js +38 -0
  7. package/dist/commands/diagnostics.js.map +1 -0
  8. package/dist/commands/import.d.ts +2 -0
  9. package/dist/commands/import.js +34 -0
  10. package/dist/commands/import.js.map +1 -0
  11. package/dist/commands/pending.d.ts +2 -0
  12. package/dist/commands/pending.js +27 -0
  13. package/dist/commands/pending.js.map +1 -0
  14. package/dist/commands/resolution.js +25 -11
  15. package/dist/commands/resolution.js.map +1 -1
  16. package/dist/commands/stats-renderer.d.ts +3 -0
  17. package/dist/commands/stats-renderer.js +76 -0
  18. package/dist/commands/stats-renderer.js.map +1 -0
  19. package/dist/commands/stats.d.ts +4 -0
  20. package/dist/commands/stats.js +107 -0
  21. package/dist/commands/stats.js.map +1 -0
  22. package/dist/commands/status.d.ts +2 -0
  23. package/dist/commands/status.js +17 -0
  24. package/dist/commands/status.js.map +1 -0
  25. package/dist/commands/sync.js +1 -1
  26. package/dist/commands/sync.js.map +1 -1
  27. package/dist/commands/usage.d.ts +2 -0
  28. package/dist/commands/usage.js +25 -0
  29. package/dist/commands/usage.js.map +1 -0
  30. package/dist/core/codex-call-parser.d.ts +10 -0
  31. package/dist/core/codex-call-parser.js +97 -0
  32. package/dist/core/codex-call-parser.js.map +1 -0
  33. package/dist/core/codex-usage-import.d.ts +24 -0
  34. package/dist/core/codex-usage-import.js +259 -0
  35. package/dist/core/codex-usage-import.js.map +1 -0
  36. package/dist/core/diagnostic-cluster.d.ts +37 -0
  37. package/dist/core/diagnostic-cluster.js +20 -0
  38. package/dist/core/diagnostic-cluster.js.map +1 -0
  39. package/dist/core/environment-normalization.d.ts +21 -0
  40. package/dist/core/environment-normalization.js +42 -0
  41. package/dist/core/environment-normalization.js.map +1 -0
  42. package/dist/core/index.d.ts +1 -0
  43. package/dist/core/index.js +1 -0
  44. package/dist/core/index.js.map +1 -1
  45. package/dist/core/invocation-diagnostics.d.ts +40 -0
  46. package/dist/core/invocation-diagnostics.js +91 -0
  47. package/dist/core/invocation-diagnostics.js.map +1 -0
  48. package/dist/core/legacy-candidate.d.ts +159 -0
  49. package/dist/core/legacy-candidate.js +73 -0
  50. package/dist/core/legacy-candidate.js.map +1 -0
  51. package/dist/core/legacy-import-apply.d.ts +215 -0
  52. package/dist/core/legacy-import-apply.js +172 -0
  53. package/dist/core/legacy-import-apply.js.map +1 -0
  54. package/dist/core/legacy-import-manifest.d.ts +197 -0
  55. package/dist/core/legacy-import-manifest.js +63 -0
  56. package/dist/core/legacy-import-manifest.js.map +1 -0
  57. package/dist/core/legacy-scan.d.ts +71 -0
  58. package/dist/core/legacy-scan.js +99 -0
  59. package/dist/core/legacy-scan.js.map +1 -0
  60. package/dist/core/pending-replay.d.ts +4 -0
  61. package/dist/core/pending-replay.js +96 -0
  62. package/dist/core/pending-replay.js.map +1 -0
  63. package/dist/core/resolution-applicability.d.ts +1 -0
  64. package/dist/core/resolution-applicability.js +28 -11
  65. package/dist/core/resolution-applicability.js.map +1 -1
  66. package/dist/core/resolution-ranker.js +9 -2
  67. package/dist/core/resolution-ranker.js.map +1 -1
  68. package/dist/core/resolution-search-types.d.ts +9 -0
  69. package/dist/core/statistics-data.d.ts +98 -0
  70. package/dist/core/statistics-data.js +53 -0
  71. package/dist/core/statistics-data.js.map +1 -0
  72. package/dist/core/statistics-pages.d.ts +3 -0
  73. package/dist/core/statistics-pages.js +107 -0
  74. package/dist/core/statistics-pages.js.map +1 -0
  75. package/dist/core/statistics-query.d.ts +86 -0
  76. package/dist/core/statistics-query.js +51 -0
  77. package/dist/core/statistics-query.js.map +1 -0
  78. package/dist/core/statistics-types.d.ts +286 -0
  79. package/dist/core/statistics-types.js +2 -0
  80. package/dist/core/statistics-types.js.map +1 -0
  81. package/dist/core/statistics.d.ts +5 -0
  82. package/dist/core/statistics.js +101 -0
  83. package/dist/core/statistics.js.map +1 -0
  84. package/dist/core/sync-status.d.ts +53 -0
  85. package/dist/core/sync-status.js +85 -0
  86. package/dist/core/sync-status.js.map +1 -0
  87. package/dist/core/usage-context.d.ts +15 -0
  88. package/dist/core/usage-context.js +22 -0
  89. package/dist/core/usage-context.js.map +1 -0
  90. package/dist/core/usage-observer.d.ts +36 -0
  91. package/dist/core/usage-observer.js +112 -0
  92. package/dist/core/usage-observer.js.map +1 -0
  93. package/dist/core/usage-schema.d.ts +113 -0
  94. package/dist/core/usage-schema.js +33 -0
  95. package/dist/core/usage-schema.js.map +1 -0
  96. package/dist/dashboard/public/api.js +41 -0
  97. package/dist/dashboard/public/app.js +111 -0
  98. package/dist/dashboard/public/components/detail-panel.js +21 -0
  99. package/dist/dashboard/public/components/index.js +216 -0
  100. package/dist/dashboard/public/components/input-diff.js +15 -0
  101. package/dist/dashboard/public/diagnostic-detail.js +25 -0
  102. package/dist/dashboard/public/diagnostics.js +46 -0
  103. package/dist/dashboard/public/index.html +28 -0
  104. package/dist/dashboard/public/knowledge.js +57 -0
  105. package/dist/dashboard/public/overview.js +101 -0
  106. package/dist/dashboard/public/solution-detail.js +42 -0
  107. package/dist/dashboard/public/styles.css +205 -0
  108. package/dist/dashboard/server.d.ts +10 -0
  109. package/dist/dashboard/server.js +133 -0
  110. package/dist/dashboard/server.js.map +1 -0
  111. package/dist/index.d.ts +4 -0
  112. package/dist/index.js +3 -0
  113. package/dist/index.js.map +1 -1
  114. package/dist/mcp/observed-transport.d.ts +20 -0
  115. package/dist/mcp/observed-transport.js +99 -0
  116. package/dist/mcp/observed-transport.js.map +1 -0
  117. package/dist/mcp/resolution-change.d.ts +1 -1
  118. package/dist/mcp/resolution-change.js +24 -9
  119. package/dist/mcp/resolution-change.js.map +1 -1
  120. package/dist/mcp/resolutions-commit-change-tool.d.ts +5 -0
  121. package/dist/mcp/resolutions-commit-change-tool.js +22 -4
  122. package/dist/mcp/resolutions-commit-change-tool.js.map +1 -1
  123. package/dist/mcp/resolutions-find-tool.d.ts +1 -2
  124. package/dist/mcp/resolutions-find-tool.js +43 -8
  125. package/dist/mcp/resolutions-find-tool.js.map +1 -1
  126. package/dist/mcp/resolutions-list-facets-tool.d.ts +1 -1
  127. package/dist/mcp/resolutions-list-facets-tool.js +16 -2
  128. package/dist/mcp/resolutions-list-facets-tool.js.map +1 -1
  129. package/dist/mcp/resolutions-report-attempt-tool.d.ts +1 -0
  130. package/dist/mcp/resolutions-report-attempt-tool.js +44 -55
  131. package/dist/mcp/resolutions-report-attempt-tool.js.map +1 -1
  132. package/dist/mcp/schemas.d.ts +299 -14
  133. package/dist/mcp/schemas.js +31 -10
  134. package/dist/mcp/schemas.js.map +1 -1
  135. package/dist/mcp/server.js +20 -5
  136. package/dist/mcp/server.js.map +1 -1
  137. package/dist/mcp/stats-get-tool.d.ts +99 -0
  138. package/dist/mcp/stats-get-tool.js +17 -0
  139. package/dist/mcp/stats-get-tool.js.map +1 -0
  140. package/dist/mcp/tool-call.d.ts +99 -0
  141. package/dist/mcp/tool-call.js +20 -0
  142. package/dist/mcp/tool-call.js.map +1 -0
  143. package/dist/mcp/tool-output.d.ts +9 -0
  144. package/dist/mcp/tool-output.js +22 -0
  145. package/dist/mcp/tool-output.js.map +1 -1
  146. package/dist/mcp/tools.d.ts +182 -27
  147. package/dist/mcp/tools.js +10 -3
  148. package/dist/mcp/tools.js.map +1 -1
  149. package/dist/program.js +14 -0
  150. package/dist/program.js.map +1 -1
  151. package/dist/storage/canonical-write-lock.d.ts +2 -0
  152. package/dist/storage/canonical-write-lock.js +32 -0
  153. package/dist/storage/canonical-write-lock.js.map +1 -0
  154. package/dist/storage/diagnostic-store.d.ts +21 -0
  155. package/dist/storage/diagnostic-store.js +50 -0
  156. package/dist/storage/diagnostic-store.js.map +1 -0
  157. package/dist/storage/import-manifest.d.ts +6 -0
  158. package/dist/storage/import-manifest.js +41 -0
  159. package/dist/storage/import-manifest.js.map +1 -0
  160. package/dist/storage/pending-store.d.ts +329 -0
  161. package/dist/storage/pending-store.js +164 -0
  162. package/dist/storage/pending-store.js.map +1 -0
  163. package/dist/storage/resolution-candidate-service.js +2 -1
  164. package/dist/storage/resolution-candidate-service.js.map +1 -1
  165. package/dist/storage/resolution-change-transaction.d.ts +41 -3
  166. package/dist/storage/resolution-change-transaction.js +101 -12
  167. package/dist/storage/resolution-change-transaction.js.map +1 -1
  168. package/dist/storage/resolution-home.js +1 -1
  169. package/dist/storage/resolution-home.js.map +1 -1
  170. package/dist/storage/resolution-index-check.js +3 -2
  171. package/dist/storage/resolution-index-check.js.map +1 -1
  172. package/dist/storage/resolution-indexer.js +3 -1
  173. package/dist/storage/resolution-indexer.js.map +1 -1
  174. package/dist/storage/usage-store.d.ts +80 -0
  175. package/dist/storage/usage-store.js +239 -0
  176. package/dist/storage/usage-store.js.map +1 -0
  177. package/package.json +11 -4
@@ -0,0 +1,63 @@
1
+ import { z } from 'zod';
2
+ import { loadCanonicalResolutions } from '../storage/resolution-indexer.js';
3
+ import { readImportManifest, writeImportManifest, assertImportPath, withImportManifestLock } from '../storage/import-manifest.js';
4
+ import { buildLegacyCandidate, LegacyCandidateSchema, ReviewedLegacyDraftSchema, stableImportJson } from './legacy-candidate.js';
5
+ import { hasUnsafeImportContent, importHash, LegacyRuleImportSchema } from './legacy-scan.js';
6
+ const hash = z.string().regex(/^sha256:[a-f0-9]{64}$/);
7
+ export const LegacyManifestSchema = z.object({
8
+ schema_version: z.literal(1), source_kind: z.literal('git_snapshot'), source_commit: z.string().regex(/^[a-f0-9]{40,64}$/), source_checksum: hash, parser_version: z.literal(1),
9
+ counts: z.object({ parsed: z.number().int().nonnegative(), review_required: z.number().int().nonnegative(), skipped: z.number().int().nonnegative() }).strict(),
10
+ entries: z.array(z.object({ entry_id: z.string().regex(/^[a-f0-9]{64}$/), source_kind: z.literal('legacy_git_blob'), source_path: z.string(), blob_sha: z.string().regex(/^[a-f0-9]{40,64}$/), content_hash: z.union([hash, z.literal('')]), parser_version: z.literal(1), disposition: z.enum(['parsed', 'review_required', 'skipped']), reason: z.string(), status: z.enum(['historical_only', 'needs_review', 'staged', 'duplicate', 'verified', 'imported', 'discarded']), legacy: LegacyRuleImportSchema.optional(), candidate: LegacyCandidateSchema.optional(), import_receipt: z.object({ receipt_id: hash, solution_handle: z.string(), verified_at: z.iso.datetime() }).strict().optional() }).strict()),
11
+ }).strict();
12
+ export function validateLegacyManifest(value) {
13
+ const manifest = LegacyManifestSchema.parse(value);
14
+ if (hasUnsafeImportContent(manifest))
15
+ throw new Error('unsafe_import_manifest');
16
+ const counts = { parsed: 0, review_required: 0, skipped: 0 };
17
+ const ids = new Set();
18
+ for (const entry of manifest.entries) {
19
+ counts[entry.disposition]++;
20
+ if (ids.has(entry.entry_id))
21
+ throw new Error('duplicate_import_entry');
22
+ ids.add(entry.entry_id);
23
+ if (entry.source_path !== '[quarantined-path]' && (!/^rules\/.+\.ya?ml$/i.test(entry.source_path) || entry.source_path.split('/').includes('..') || importHash(`${manifest.source_commit}\0${entry.source_path}\0${entry.blob_sha}`).slice(7) !== entry.entry_id))
24
+ throw new Error('import_provenance_mismatch');
25
+ if (entry.disposition === 'parsed' && !entry.legacy)
26
+ throw new Error('missing_legacy_projection');
27
+ if (entry.candidate && entry.candidate.content_hash !== importHash(stableImportJson({ draft: entry.candidate.draft, conflict_evidence: entry.candidate.conflict_evidence })))
28
+ throw new Error('candidate_hash_mismatch');
29
+ }
30
+ if (JSON.stringify(counts) !== JSON.stringify(manifest.counts) || manifest.source_checksum !== importHash(manifest.entries.map((entry) => `${entry.entry_id}:${entry.blob_sha}`).join('\n')))
31
+ throw new Error('import_manifest_checksum_mismatch');
32
+ return manifest;
33
+ }
34
+ export async function stageLegacyManifest(path, home, drafts = {}) {
35
+ return withImportManifestLock(path, home, () => stageLegacyManifestLocked(path, home, drafts));
36
+ }
37
+ async function stageLegacyManifestLocked(path, home, drafts) {
38
+ await assertImportPath(path, home);
39
+ const overrides = z.record(z.string().regex(/^[a-f0-9]{64}$/), ReviewedLegacyDraftSchema).parse(drafts);
40
+ if (hasUnsafeImportContent(overrides))
41
+ throw new Error('unsafe_reviewed_draft');
42
+ const manifest = await readImportManifest(path);
43
+ const canonical = (await loadCanonicalResolutions(home)).map(({ document }) => document);
44
+ for (const id of Object.keys(overrides))
45
+ if (!manifest.entries.some((entry) => entry.entry_id === id && entry.disposition === 'parsed'))
46
+ throw new Error('unknown_reviewed_entry');
47
+ for (const entry of manifest.entries) {
48
+ if (entry.disposition !== 'parsed' || entry.import_receipt || ['imported', 'discarded'].includes(entry.status))
49
+ continue;
50
+ const previous = entry.candidate;
51
+ // Preserve a completed user review on repeat stage; never invent its missing facts.
52
+ const retained = previous && previous.missing_fields.length === 0 ? ReviewedLegacyDraftSchema.parse({ ...previous.draft, conflict_evidence: previous.conflict_evidence }) : undefined;
53
+ entry.candidate = buildLegacyCandidate(entry, manifest.source_commit, canonical, overrides[entry.entry_id] ?? retained);
54
+ entry.status = entry.candidate.missing_fields.length || entry.candidate.conflict_evidence.length ? 'needs_review' : entry.candidate.relation === 'exact_solution' ? 'duplicate' : 'staged';
55
+ entry.reason = entry.candidate.conflict_evidence.length ? 'resolution_conflict' : entry.candidate.missing_fields.length ? 'missing_current_contract' : 'current_verification_required';
56
+ }
57
+ await writeImportManifest(path, home, manifest);
58
+ return listLegacyCandidates(manifest);
59
+ }
60
+ export function listLegacyCandidates(manifest) {
61
+ return { status: 'ok', source_commit: manifest.source_commit, items: manifest.entries.map((entry) => ({ entry_id: entry.entry_id, status: entry.status, reason: entry.reason, source_path: entry.source_path, ...(entry.candidate ? { candidate_id: entry.candidate.candidate_id, content_hash: entry.candidate.content_hash, verification_status: entry.import_receipt ? 'verified' : entry.candidate.verification_status, missing_fields: entry.candidate.missing_fields, reuse_priority: entry.candidate.reuse_priority, relation: entry.candidate.relation, related_solution_handles: entry.candidate.related_solution_handles } : {}) })).sort((a, b) => Number(b.reuse_priority === 'high') - Number(a.reuse_priority === 'high') || a.entry_id.localeCompare(b.entry_id)) };
62
+ }
63
+ //# sourceMappingURL=legacy-import-manifest.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"legacy-import-manifest.js","sourceRoot":"","sources":["../../src/core/legacy-import-manifest.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,71 @@
1
+ import { z } from 'zod';
2
+ export declare const LegacyRuleImportSchema: z.ZodObject<{
3
+ schema_version: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
4
+ id: z.ZodString;
5
+ title: z.ZodString;
6
+ summary: z.ZodString;
7
+ mistake: z.ZodString;
8
+ fix: z.ZodString;
9
+ status: z.ZodEnum<{
10
+ draft: "draft";
11
+ active: "active";
12
+ deprecated: "deprecated";
13
+ superseded: "superseded";
14
+ }>;
15
+ confidence: z.ZodEnum<{
16
+ low: "low";
17
+ high: "high";
18
+ medium: "medium";
19
+ }>;
20
+ language: z.ZodOptional<z.ZodString>;
21
+ platforms: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodNull]>>, z.ZodTransform<string[], string | string[] | null | undefined>>;
22
+ tools: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodNull]>>, z.ZodTransform<string[], string | string[] | null | undefined>>;
23
+ categories: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodNull]>>, z.ZodTransform<string[], string | string[] | null | undefined>>;
24
+ trigger: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodNull]>>, z.ZodTransform<string[], string | string[] | null | undefined>>;
25
+ anti_conditions: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodNull]>>, z.ZodTransform<string[], string | string[] | null | undefined>>;
26
+ error_signature: z.ZodOptional<z.ZodString>;
27
+ source_project: z.ZodOptional<z.ZodString>;
28
+ project_key: z.ZodOptional<z.ZodString>;
29
+ rule_scope: z.ZodOptional<z.ZodEnum<{
30
+ shared: "shared";
31
+ project: "project";
32
+ }>>;
33
+ created_at: z.ZodString;
34
+ verified_at: z.ZodOptional<z.ZodString>;
35
+ superseded_by: z.ZodOptional<z.ZodNullable<z.ZodString>>;
36
+ }, z.core.$strip>;
37
+ export type LegacyRuleImport = z.infer<typeof LegacyRuleImportSchema>;
38
+ export type LegacyScanEntry = {
39
+ entry_id: string;
40
+ source_kind: 'legacy_git_blob';
41
+ source_path: string;
42
+ blob_sha: string;
43
+ content_hash: string;
44
+ parser_version: 1;
45
+ disposition: 'parsed' | 'review_required' | 'skipped';
46
+ reason: string;
47
+ status: string;
48
+ legacy?: LegacyRuleImport;
49
+ candidate?: import('./legacy-candidate.js').LegacyCandidate;
50
+ import_receipt?: {
51
+ receipt_id: string;
52
+ solution_handle: string;
53
+ verified_at: string;
54
+ };
55
+ };
56
+ export type LegacyManifest = {
57
+ schema_version: 1;
58
+ source_kind: 'git_snapshot';
59
+ source_commit: string;
60
+ source_checksum: string;
61
+ parser_version: 1;
62
+ counts: {
63
+ parsed: number;
64
+ review_required: number;
65
+ skipped: number;
66
+ };
67
+ entries: LegacyScanEntry[];
68
+ };
69
+ export declare function importHash(value: string): string;
70
+ export declare function scanLegacySnapshot(repo: string, ref: string): Promise<LegacyManifest>;
71
+ export declare function hasUnsafeImportContent(value: unknown, depth?: number, seen?: WeakSet<object>): boolean;
@@ -0,0 +1,99 @@
1
+ import { createHash } from 'node:crypto';
2
+ import { parse } from 'yaml';
3
+ import { z } from 'zod';
4
+ import { runGit } from './git.js';
5
+ import { scanRuleDraftForRedactions } from './redaction.js';
6
+ // Import-only projection. It deliberately does not reactivate the removed rule loader.
7
+ const texts = z.union([z.string(), z.array(z.string()), z.null()]).optional().transform((v) => typeof v === 'string' ? [v] : v ?? []);
8
+ export const LegacyRuleImportSchema = z.object({
9
+ schema_version: z.union([z.literal(1), z.literal(2)]).default(1),
10
+ id: z.string().min(1), title: z.string().min(1), summary: z.string().min(1), mistake: z.string().min(1), fix: z.string().min(1),
11
+ status: z.enum(['draft', 'active', 'deprecated', 'superseded']), confidence: z.enum(['low', 'medium', 'high']),
12
+ language: z.string().optional(), platforms: texts, tools: texts, categories: texts, trigger: texts, anti_conditions: texts,
13
+ error_signature: z.string().optional(), source_project: z.string().optional(), project_key: z.string().optional(),
14
+ rule_scope: z.enum(['shared', 'project']).optional(), created_at: z.string().min(1), verified_at: z.string().optional(),
15
+ superseded_by: z.string().nullable().optional(),
16
+ });
17
+ export function importHash(value) { return `sha256:${createHash('sha256').update(value).digest('hex')}`; }
18
+ export async function scanLegacySnapshot(repo, ref) {
19
+ const commit = await gitObject(repo, ['rev-parse', '--verify', '--end-of-options', `${ref}^{commit}`]);
20
+ const source_commit = commit.trim();
21
+ if (!/^[a-f0-9]{40,64}$/.test(source_commit))
22
+ throw new Error('invalid_source_commit');
23
+ const tree = await gitObject(repo, ['ls-tree', '-r', '-z', source_commit, '--', 'rules']);
24
+ const entries = [];
25
+ for (const item of tree.split('\0').filter(Boolean)) {
26
+ const tab = item.indexOf('\t');
27
+ const path = item.slice(tab + 1);
28
+ if (!/^rules\/.+\.ya?ml$/i.test(path))
29
+ continue;
30
+ const [mode, type, blob_sha] = item.slice(0, tab).split(' ');
31
+ const safePath = !hasUnsafeImportContent(path) && !/[\x00-\x1f\x7f]/.test(path);
32
+ const entry = { entry_id: importHash(`${source_commit}\0${path}\0${blob_sha}`).slice(7), source_kind: 'legacy_git_blob', source_path: safePath ? path : '[quarantined-path]', blob_sha, content_hash: '', parser_version: 1, disposition: 'skipped', reason: 'not_regular_file', status: 'needs_review' };
33
+ entries.push(entry);
34
+ if (type !== 'blob' || !['100644', '100755'].includes(mode))
35
+ continue;
36
+ if (!safePath) {
37
+ entry.reason = 'quarantined_path';
38
+ continue;
39
+ }
40
+ const size = Number((await gitObject(repo, ['cat-file', '-s', blob_sha])).trim());
41
+ if (size > 1024 * 1024) {
42
+ entry.reason = 'oversized_blob';
43
+ continue;
44
+ }
45
+ const raw = await gitObject(repo, ['show', blob_sha]);
46
+ entry.content_hash = importHash(raw);
47
+ try {
48
+ const value = parse(raw, { maxAliasCount: 20 });
49
+ if (hasUnsafeImportContent(value)) {
50
+ entry.reason = 'quarantined_content';
51
+ continue;
52
+ }
53
+ const parsed = LegacyRuleImportSchema.safeParse(value);
54
+ if (!parsed.success) {
55
+ entry.disposition = 'review_required';
56
+ entry.reason = 'unsupported_or_incomplete_schema';
57
+ continue;
58
+ }
59
+ if (parsed.data.schema_version === 2 && (!parsed.data.rule_scope || (parsed.data.rule_scope === 'project' && !parsed.data.project_key))) {
60
+ entry.disposition = 'review_required';
61
+ entry.reason = 'missing_v2_scope';
62
+ continue;
63
+ }
64
+ entry.disposition = 'parsed';
65
+ entry.reason = 'historical_evidence_only';
66
+ entry.status = 'historical_only';
67
+ entry.legacy = parsed.data;
68
+ }
69
+ catch {
70
+ entry.disposition = 'review_required';
71
+ entry.reason = 'invalid_yaml';
72
+ }
73
+ }
74
+ const counts = { parsed: 0, review_required: 0, skipped: 0 };
75
+ for (const entry of entries)
76
+ counts[entry.disposition]++;
77
+ return { schema_version: 1, source_kind: 'git_snapshot', source_commit, source_checksum: importHash(entries.map((entry) => `${entry.entry_id}:${entry.blob_sha}`).join('\n')), parser_version: 1, counts, entries };
78
+ }
79
+ export function hasUnsafeImportContent(value, depth = 0, seen = new WeakSet()) {
80
+ if (depth > 20)
81
+ return true;
82
+ if (typeof value === 'string')
83
+ return /```|(?:^|\n)\s*(?:import .* from |export (?:function|class)|function \w+\(|class \w+\s*\{|const \w+\s*=)/.test(value) || scanRuleDraftForRedactions({ summary: value }).warnings.length > 0;
84
+ if (!value || typeof value !== 'object')
85
+ return false;
86
+ if (seen.has(value))
87
+ return true;
88
+ seen.add(value);
89
+ const unsafe = Object.entries(value).some(([key, item]) => hasUnsafeImportContent(key, depth + 1, seen) || hasUnsafeImportContent(item, depth + 1, seen));
90
+ seen.delete(value);
91
+ return unsafe;
92
+ }
93
+ async function gitObject(repo, args) {
94
+ const result = await runGit(repo, args);
95
+ if (result.exitCode !== 0)
96
+ throw new Error('legacy_git_read_failed');
97
+ return result.stdout;
98
+ }
99
+ //# sourceMappingURL=legacy-scan.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"legacy-scan.js","sourceRoot":"","sources":["../../src/core/legacy-scan.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { ResolutionEnvironment } from './problem-schema.js';
2
+ import { type PendingRecord } from '../storage/pending-store.js';
3
+ /** One explicit bounded attempt; current evidence is rechecked before any new canonical write. */
4
+ export declare function retryPending(home: string, id: string, currentEnvironment?: ResolutionEnvironment): Promise<PendingRecord>;
@@ -0,0 +1,96 @@
1
+ import { fingerprintProblem } from './problem-fingerprint.js';
2
+ import { resolveSourceEvidence } from './source-evidence.js';
3
+ import { readPending, withPendingLock, writePending } from '../storage/pending-store.js';
4
+ import { readChangeReceipt, withResolutionTransaction } from '../storage/resolution-change-transaction.js';
5
+ import { prepareResolutionChange } from '../mcp/resolution-change.js';
6
+ import { handleResolutionsCommitChange } from '../mcp/resolutions-commit-change-tool.js';
7
+ import { handleResolutionsReportAttempt } from '../mcp/resolutions-report-attempt-tool.js';
8
+ import { loadCanonicalResolutions } from '../storage/resolution-indexer.js';
9
+ import { buildAttemptOutcome } from './attempt-outcome.js';
10
+ /** One explicit bounded attempt; current evidence is rechecked before any new canonical write. */
11
+ export async function retryPending(home, id, currentEnvironment) {
12
+ return withPendingLock(home, id, async () => {
13
+ const item = await readPending(home, id);
14
+ if (!item)
15
+ throw new Error('pending_not_found');
16
+ if (item.status === 'completed' || item.status === 'discarded')
17
+ return item;
18
+ if (item.receipt)
19
+ return finish(home, item, 'completed', 'receipt_recovered');
20
+ if (item.input.kind === 'change') {
21
+ const request = item.input.request;
22
+ const receipt = await withResolutionTransaction(home, () => readChangeReceipt(home, request.payload_hash));
23
+ if (receipt) {
24
+ item.receipt = receipt;
25
+ await writePending(home, item);
26
+ return finish(home, item, 'completed', 'already_committed');
27
+ }
28
+ }
29
+ else {
30
+ const request = item.input.request;
31
+ const documents = await withResolutionTransaction(home, () => loadCanonicalResolutions(home));
32
+ const solution = documents.map(({ document }) => document).find((document) => document.kind === 'solution' && `${document.id}@${document.revision}` === request.solution_handle);
33
+ if (solution?.kind === 'solution') {
34
+ const outcome = buildAttemptOutcome({ problemId: solution.problem_id, problemFingerprint: request.problem_fingerprint, projectKey: request.project_key, environment: request.environment, solutionId: solution.id, solutionRevision: solution.revision, result: request.result, reasonCode: request.reason_code, evidence: request.evidence, createdAt: '2000-01-01T00:00:00.000Z' }).outcome;
35
+ if (documents.some(({ document }) => document.kind === 'outcome' && document.id === outcome.id)) {
36
+ item.receipt = { status: 'already_recorded', outcome_id: outcome.id, solution_handle: request.solution_handle };
37
+ await writePending(home, item);
38
+ return finish(home, item, 'completed', 'already_recorded');
39
+ }
40
+ }
41
+ }
42
+ const verification = item.input.verification;
43
+ if (!verification || !currentEnvironment)
44
+ return finish(home, item, 'needs_review', 'verification_provenance_required');
45
+ const originalEnvironment = item.input.kind === 'change' ? item.input.request.payload.problem.environment : item.input.request.environment;
46
+ if (environmentHash(verification.environment) !== environmentHash(currentEnvironment) || environmentHash(originalEnvironment) !== environmentHash(currentEnvironment))
47
+ return finish(home, item, 'needs_review', 'verification_environment_changed');
48
+ if (!['code', 'test', 'environment'].every((role) => verification.sources.some((source) => source.role === role)))
49
+ return finish(home, item, 'needs_review', 'verification_scope_incomplete');
50
+ for (const source of verification.sources) {
51
+ if (source.locator.revision.kind !== 'working_tree_hash')
52
+ return finish(home, item, 'needs_review', 'current_source_verification_required');
53
+ if ((await resolveSourceEvidence(home, source.locator)).status !== 'ok')
54
+ return finish(home, item, 'needs_review', 'verification_source_changed');
55
+ }
56
+ item.status = 'retrying';
57
+ item.retries++;
58
+ item.updated_at = new Date().toISOString();
59
+ await writePending(home, item);
60
+ try {
61
+ let result;
62
+ if (item.input.kind === 'change') {
63
+ const request = item.input.request;
64
+ const prepared = await prepareResolutionChange(request.payload, home);
65
+ if (!prepared.eligible || prepared.relation !== request.relation || prepared.solution_handle !== `${request.payload.solution.id}@${request.payload.solution.revision}` || prepared.payload_hash !== request.payload_hash)
66
+ return finish(home, item, 'needs_review', prepared.code ?? 'proposal_changed');
67
+ result = await handleResolutionsCommitChange({ payload: prepared.normalized_payload, payload_hash: prepared.payload_hash, state_hash: prepared.state_hash, relation: prepared.relation }, { rulebookHome: home, skipPending: true });
68
+ }
69
+ else
70
+ result = await handleResolutionsReportAttempt(item.input.request, { rulebookHome: home, skipPending: true });
71
+ const block = result.content[0];
72
+ if (block.type !== 'text')
73
+ throw new Error('pending_invalid_result');
74
+ const body = JSON.parse(block.text);
75
+ if (!['committed', 'already_committed', 'recorded', 'already_recorded'].includes(String(body.status)))
76
+ return finish(home, item, 'needs_review', String(body.code ?? 'proposal_changed'));
77
+ item.receipt = body;
78
+ await writePending(home, item); // Receipt first, completion second: replay never loses success.
79
+ return finish(home, item, 'completed', String(body.status));
80
+ }
81
+ catch {
82
+ return finish(home, item, 'retryable_error', 'write_failed');
83
+ }
84
+ });
85
+ }
86
+ function environmentHash(environment) {
87
+ return fingerprintProblem({ observations: { symptoms: ['pending environment'], expected: 'same', observed: 'same' }, environment });
88
+ }
89
+ async function finish(home, item, status, code) {
90
+ item.status = status;
91
+ item.failure = { stage: 'retry', code };
92
+ item.updated_at = new Date().toISOString();
93
+ await writePending(home, item);
94
+ return item;
95
+ }
96
+ //# sourceMappingURL=pending-replay.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pending-replay.js","sourceRoot":"","sources":["../../src/core/pending-replay.ts"],"names":[],"mappings":"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"}
@@ -2,6 +2,7 @@ import type { ResolutionEnvironment } from './problem-schema.js';
2
2
  import type { Solution } from './solution-schema.js';
3
3
  export type SourceAvailability = 'available' | 'stale' | 'unavailable';
4
4
  export type ResolutionApplicability = {
5
+ referenceOnly?: boolean;
5
6
  excluded: boolean;
6
7
  classification: 'likely' | 'possible' | 'incompatible';
7
8
  matched: string[];
@@ -1,29 +1,46 @@
1
+ import { normalizeEnvironmentForComparison } from './environment-normalization.js';
1
2
  export function evaluateResolutionApplicability(options) {
2
3
  const matched = [];
3
4
  const mismatched = [];
4
5
  const unknown = [];
6
+ const environmentChecks = [];
7
+ const observedEnvironment = normalizeEnvironmentForComparison(options.solutionEnvironment);
8
+ const currentEnvironment = normalizeEnvironmentForComparison(options.currentEnvironment);
5
9
  for (const field of ['languages', 'platforms', 'runtimes', 'tools']) {
6
- const expected = new Set(options.solutionEnvironment[field]);
7
- const current = new Set(options.currentEnvironment[field]);
8
- if (expected.size === 0)
10
+ const expected = observedEnvironment[field];
11
+ const current = currentEnvironment[field];
12
+ if (expected.length === 0)
9
13
  continue;
10
- if (current.size === 0)
11
- unknown.push(`environment.${field}`);
12
- else if ([...expected].some((value) => current.has(value)))
13
- matched.push(`environment.${field}`);
14
+ const path = `environment.${field}`;
15
+ const familiesMatch = expected.every((entry) => current.some((value) => value.family === entry.family));
16
+ const observationsMatch = familiesMatch && expected.every((entry) => current.some((value) => value.family === entry.family && value.version === entry.version && value.qualifier === entry.qualifier && value.confidence === 'known' && entry.confidence === 'known'));
17
+ if (current.length === 0)
18
+ unknown.push(path);
19
+ else if (!familiesMatch)
20
+ mismatched.push(path);
21
+ else if (!observationsMatch)
22
+ unknown.push(`${path}.version_or_qualifier`);
14
23
  else
15
- mismatched.push(`environment.${field}`);
24
+ matched.push(path);
25
+ if (!observationsMatch)
26
+ environmentChecks.push(`Verify ${path}: historical observations do not establish current compatibility.`);
27
+ }
28
+ if (Object.values(options.solutionEnvironment).every((values) => values.length === 0)) {
29
+ unknown.push('environment');
30
+ environmentChecks.push('Verify environment: no historical environment observations are available.');
16
31
  }
17
32
  const satisfied = new Set((options.satisfiedConditions ?? []).map(normalize));
18
33
  const rejected = new Set((options.rejectedConditions ?? []).map(normalize));
19
34
  const rejectMatched = options.solution.reject_if.filter((condition) => satisfied.has(normalize(condition)));
20
35
  const applicableRejected = options.solution.applicable_if.filter((condition) => rejected.has(normalize(condition)));
21
36
  mismatched.push(...rejectMatched.map((condition) => `reject_if:${condition}`), ...applicableRejected.map((condition) => `applicable_if:${condition}`));
22
- const requiredChecks = options.solution.applicable_if.filter((condition) => !satisfied.has(normalize(condition)) && !rejected.has(normalize(condition)));
23
- unknown.push(...requiredChecks.map((condition) => `applicable_if:${condition}`));
24
- const excluded = mismatched.length > 0;
37
+ const conditionChecks = options.solution.applicable_if.filter((condition) => !satisfied.has(normalize(condition)) && !rejected.has(normalize(condition)));
38
+ unknown.push(...conditionChecks.map((condition) => `applicable_if:${condition}`));
39
+ const requiredChecks = [...conditionChecks, ...environmentChecks];
40
+ const excluded = rejectMatched.length > 0 || applicableRejected.length > 0;
25
41
  return {
26
42
  excluded,
43
+ referenceOnly: environmentChecks.length > 0,
27
44
  classification: excluded ? 'incompatible' : requiredChecks.length === 0 && unknown.length === 0 ? 'likely' : 'possible',
28
45
  matched,
29
46
  mismatched,
@@ -1 +1 @@
1
- {"version":3,"file":"resolution-applicability.js","sourceRoot":"","sources":["../../src/core/resolution-applicability.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"resolution-applicability.js","sourceRoot":"","sources":["../../src/core/resolution-applicability.ts"],"names":[],"mappings":"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"}
@@ -20,7 +20,7 @@ export function rankResolutionCandidates(options) {
20
20
  ranked.push({
21
21
  ...item.candidate,
22
22
  applicability: item.applicability,
23
- usage: sourceOnly || item.projectRelation === 'foreign_project' ? 'reference' : 'direct',
23
+ usage: sourceOnly || item.projectRelation === 'foreign_project' || item.applicability.referenceOnly ? 'reference' : 'direct',
24
24
  risk: regressed > 0 ? 'high' : item.applicability.sourceAvailability === 'stale' || item.applicability.requiredChecks.length > 0 ? 'elevated' : 'low',
25
25
  verificationCost: item.verificationSteps + regressed,
26
26
  solutionHandle: `${item.candidate.solutionId}@${item.candidate.solutionRevision}`,
@@ -35,6 +35,13 @@ export function rankResolutionCandidates(options) {
35
35
  rankScore,
36
36
  });
37
37
  }
38
- return ranked.sort((left, right) => right.rankScore - left.rankScore || left.solutionId.localeCompare(right.solutionId) || left.solutionRevision - right.solutionRevision);
38
+ return ranked.sort((left, right) => Number(left.usage === 'reference') - Number(right.usage === 'reference') || evidencePriority(right) - evidencePriority(left) || right.rankScore - left.rankScore || left.solutionId.localeCompare(right.solutionId) || left.solutionRevision - right.solutionRevision);
39
+ }
40
+ function evidencePriority(candidate) {
41
+ if (candidate.matchEvidence.some(({ channel }) => channel === 'error_signature'))
42
+ return 3;
43
+ if (candidate.matchEvidence.some(({ channel }) => channel === 'symbol' || channel === 'operation'))
44
+ return 2;
45
+ return candidate.matchEvidence.some(({ confidence }) => confidence === 'fact') ? 1 : 0;
39
46
  }
40
47
  //# sourceMappingURL=resolution-ranker.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"resolution-ranker.js","sourceRoot":"","sources":["../../src/core/resolution-ranker.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"resolution-ranker.js","sourceRoot":"","sources":["../../src/core/resolution-ranker.ts"],"names":[],"mappings":"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"}
@@ -35,3 +35,12 @@ export type ResolutionCandidateResponse = {
35
35
  fingerprint: string;
36
36
  candidates: ResolutionCandidate[];
37
37
  };
38
+ export type SearchDiagnostics = {
39
+ retrieved: number;
40
+ hard_excluded: number;
41
+ reference: number;
42
+ returned: number;
43
+ truncated: boolean;
44
+ completeness: 'complete' | 'partial';
45
+ reason_counts: Record<string, number>;
46
+ };