@aryam/fixmap-core 0.9.0 → 0.9.2

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 (194) hide show
  1. package/README.md +51 -1
  2. package/dist/annotation-store.d.ts +5 -0
  3. package/dist/annotation-store.js +117 -0
  4. package/dist/annotation-store.js.map +1 -0
  5. package/dist/annotations.d.ts +57 -0
  6. package/dist/annotations.js +221 -0
  7. package/dist/annotations.js.map +1 -0
  8. package/dist/architecture-history.d.ts +33 -0
  9. package/dist/architecture-history.js +234 -0
  10. package/dist/architecture-history.js.map +1 -0
  11. package/dist/architecture.d.ts +124 -0
  12. package/dist/architecture.js +348 -0
  13. package/dist/architecture.js.map +1 -0
  14. package/dist/artifacts.d.ts +9 -0
  15. package/dist/artifacts.js +82 -0
  16. package/dist/artifacts.js.map +1 -0
  17. package/dist/ask.d.ts +48 -0
  18. package/dist/ask.js +182 -0
  19. package/dist/ask.js.map +1 -0
  20. package/dist/browser.d.ts +66 -3
  21. package/dist/browser.js +34 -2
  22. package/dist/browser.js.map +1 -1
  23. package/dist/capabilities.d.ts +39 -0
  24. package/dist/capabilities.js +172 -0
  25. package/dist/capabilities.js.map +1 -0
  26. package/dist/capability-history.d.ts +49 -0
  27. package/dist/capability-history.js +176 -0
  28. package/dist/capability-history.js.map +1 -0
  29. package/dist/change-conflicts.d.ts +34 -0
  30. package/dist/change-conflicts.js +140 -0
  31. package/dist/change-conflicts.js.map +1 -0
  32. package/dist/change-scope.d.ts +81 -0
  33. package/dist/change-scope.js +316 -0
  34. package/dist/change-scope.js.map +1 -0
  35. package/dist/characterization.d.ts +61 -0
  36. package/dist/characterization.js +169 -0
  37. package/dist/characterization.js.map +1 -0
  38. package/dist/ci-matrix.d.ts +53 -0
  39. package/dist/ci-matrix.js +170 -0
  40. package/dist/ci-matrix.js.map +1 -0
  41. package/dist/compare.js +2 -2
  42. package/dist/compare.js.map +1 -1
  43. package/dist/composer-projects.d.ts +32 -0
  44. package/dist/composer-projects.js +246 -0
  45. package/dist/composer-projects.js.map +1 -0
  46. package/dist/context.d.ts +1 -1
  47. package/dist/context.js +26 -4
  48. package/dist/context.js.map +1 -1
  49. package/dist/contracts.d.ts +75 -0
  50. package/dist/contracts.js +526 -0
  51. package/dist/contracts.js.map +1 -0
  52. package/dist/custom-language-context.d.ts +43 -0
  53. package/dist/custom-language-context.js +89 -0
  54. package/dist/custom-language-context.js.map +1 -0
  55. package/dist/decisions.d.ts +64 -0
  56. package/dist/decisions.js +338 -0
  57. package/dist/decisions.js.map +1 -0
  58. package/dist/dossier.d.ts +63 -0
  59. package/dist/dossier.js +176 -0
  60. package/dist/dossier.js.map +1 -0
  61. package/dist/dotnet-projects.d.ts +26 -0
  62. package/dist/dotnet-projects.js +171 -0
  63. package/dist/dotnet-projects.js.map +1 -0
  64. package/dist/editor-loader.d.ts +9 -0
  65. package/dist/editor-loader.js +18 -0
  66. package/dist/editor-loader.js.map +1 -0
  67. package/dist/editor-protocol.d.ts +35 -0
  68. package/dist/editor-protocol.js +200 -0
  69. package/dist/editor-protocol.js.map +1 -0
  70. package/dist/editor-session.d.ts +15 -0
  71. package/dist/editor-session.js +27 -0
  72. package/dist/editor-session.js.map +1 -0
  73. package/dist/editor-transport.d.ts +10 -0
  74. package/dist/editor-transport.js +75 -0
  75. package/dist/editor-transport.js.map +1 -0
  76. package/dist/enterprise-policy.d.ts +82 -0
  77. package/dist/enterprise-policy.js +170 -0
  78. package/dist/enterprise-policy.js.map +1 -0
  79. package/dist/evidence-bundle.d.ts +13 -0
  80. package/dist/evidence-bundle.js +105 -0
  81. package/dist/evidence-bundle.js.map +1 -0
  82. package/dist/evidence.d.ts +125 -0
  83. package/dist/evidence.js +252 -0
  84. package/dist/evidence.js.map +1 -0
  85. package/dist/explain.js +7 -0
  86. package/dist/explain.js.map +1 -1
  87. package/dist/go-projects.d.ts +22 -0
  88. package/dist/go-projects.js +146 -0
  89. package/dist/go-projects.js.map +1 -0
  90. package/dist/graph.js +9 -0
  91. package/dist/graph.js.map +1 -1
  92. package/dist/grounding.d.ts +4 -1
  93. package/dist/grounding.js +70 -13
  94. package/dist/grounding.js.map +1 -1
  95. package/dist/identity-graph.d.ts +106 -0
  96. package/dist/identity-graph.js +353 -0
  97. package/dist/identity-graph.js.map +1 -0
  98. package/dist/impact.d.ts +2 -1
  99. package/dist/impact.js +12 -4
  100. package/dist/impact.js.map +1 -1
  101. package/dist/import-graph.d.ts +7 -1
  102. package/dist/import-graph.js +616 -34
  103. package/dist/import-graph.js.map +1 -1
  104. package/dist/incident.d.ts +74 -0
  105. package/dist/incident.js +212 -0
  106. package/dist/incident.js.map +1 -0
  107. package/dist/index.d.ts +91 -4
  108. package/dist/index.js +47 -3
  109. package/dist/index.js.map +1 -1
  110. package/dist/language-adapters.d.ts +33 -0
  111. package/dist/language-adapters.js +390 -0
  112. package/dist/language-adapters.js.map +1 -0
  113. package/dist/language-registry.d.ts +26 -0
  114. package/dist/language-registry.js +57 -0
  115. package/dist/language-registry.js.map +1 -0
  116. package/dist/languages.d.ts +20 -5
  117. package/dist/languages.js +197 -19
  118. package/dist/languages.js.map +1 -1
  119. package/dist/markdown.d.ts +1 -0
  120. package/dist/markdown.js +7 -1
  121. package/dist/markdown.js.map +1 -1
  122. package/dist/migration.d.ts +56 -0
  123. package/dist/migration.js +154 -0
  124. package/dist/migration.js.map +1 -0
  125. package/dist/outcomes.d.ts +57 -0
  126. package/dist/outcomes.js +146 -0
  127. package/dist/outcomes.js.map +1 -0
  128. package/dist/ownership.d.ts +29 -0
  129. package/dist/ownership.js +189 -0
  130. package/dist/ownership.js.map +1 -0
  131. package/dist/plan-alternatives.d.ts +74 -0
  132. package/dist/plan-alternatives.js +205 -0
  133. package/dist/plan-alternatives.js.map +1 -0
  134. package/dist/plan.d.ts +7 -0
  135. package/dist/plan.js +41 -8
  136. package/dist/plan.js.map +1 -1
  137. package/dist/rank.d.ts +64 -1
  138. package/dist/rank.js +278 -26
  139. package/dist/rank.js.map +1 -1
  140. package/dist/repo-scan.d.ts +8 -1
  141. package/dist/repo-scan.js +341 -97
  142. package/dist/repo-scan.js.map +1 -1
  143. package/dist/report.d.ts +16 -0
  144. package/dist/report.js +298 -33
  145. package/dist/report.js.map +1 -1
  146. package/dist/retrieval.d.ts +37 -0
  147. package/dist/retrieval.js +150 -21
  148. package/dist/retrieval.js.map +1 -1
  149. package/dist/reverse-docs.d.ts +46 -0
  150. package/dist/reverse-docs.js +179 -0
  151. package/dist/reverse-docs.js.map +1 -0
  152. package/dist/ruby-projects.d.ts +20 -0
  153. package/dist/ruby-projects.js +114 -0
  154. package/dist/ruby-projects.js.map +1 -0
  155. package/dist/runtime-evidence.d.ts +90 -0
  156. package/dist/runtime-evidence.js +186 -0
  157. package/dist/runtime-evidence.js.map +1 -0
  158. package/dist/rust-projects.d.ts +17 -0
  159. package/dist/rust-projects.js +125 -0
  160. package/dist/rust-projects.js.map +1 -0
  161. package/dist/sandbox.d.ts +59 -0
  162. package/dist/sandbox.js +202 -0
  163. package/dist/sandbox.js.map +1 -0
  164. package/dist/semantic-cache.d.ts +8 -0
  165. package/dist/semantic-cache.js +149 -0
  166. package/dist/semantic-cache.js.map +1 -0
  167. package/dist/semantic.d.ts +78 -0
  168. package/dist/semantic.js +237 -0
  169. package/dist/semantic.js.map +1 -0
  170. package/dist/sensitive-data.d.ts +8 -0
  171. package/dist/sensitive-data.js +157 -0
  172. package/dist/sensitive-data.js.map +1 -0
  173. package/dist/signals.js +1 -1
  174. package/dist/signals.js.map +1 -1
  175. package/dist/supply-chain.d.ts +38 -0
  176. package/dist/supply-chain.js +206 -0
  177. package/dist/supply-chain.js.map +1 -0
  178. package/dist/test-reliability.d.ts +56 -0
  179. package/dist/test-reliability.js +191 -0
  180. package/dist/test-reliability.js.map +1 -0
  181. package/dist/text.js +8 -1
  182. package/dist/text.js.map +1 -1
  183. package/dist/transformers-embedding.d.ts +16 -0
  184. package/dist/transformers-embedding.js +127 -0
  185. package/dist/transformers-embedding.js.map +1 -0
  186. package/dist/types.d.ts +79 -2
  187. package/dist/validate.js +172 -0
  188. package/dist/validate.js.map +1 -1
  189. package/dist/verify.js +136 -2
  190. package/dist/verify.js.map +1 -1
  191. package/dist/workspace.d.ts +86 -0
  192. package/dist/workspace.js +557 -0
  193. package/dist/workspace.js.map +1 -0
  194. package/package.json +2 -2
@@ -0,0 +1,57 @@
1
+ export type TestOutcomeStatus = "passed" | "failed" | "timeout" | "crashed" | "unavailable";
2
+ export type OutcomeRecord = {
3
+ outcomeRecordVersion: 1;
4
+ id: string;
5
+ taskId: string;
6
+ repositoryIdentity: string;
7
+ planFingerprint: string;
8
+ recordedAt: string;
9
+ predictedPaths: string[];
10
+ editedPaths: string[];
11
+ testOutcomes: Array<{
12
+ command: string;
13
+ status: TestOutcomeStatus;
14
+ relatedPaths: string[];
15
+ evidence: string;
16
+ }>;
17
+ taskAssessment: {
18
+ status: "succeeded" | "failed" | "partial" | "unknown";
19
+ source: "human" | "agent" | "external-system" | "unassessed";
20
+ reason: string;
21
+ };
22
+ };
23
+ export type OutcomeStore = {
24
+ outcomeStoreVersion: 1;
25
+ records: OutcomeRecord[];
26
+ };
27
+ export type OutcomeCalibration = {
28
+ outcomeCalibrationVersion: 1;
29
+ records: number;
30
+ totals: {
31
+ predictedPaths: number;
32
+ editedPaths: number;
33
+ correctlyPredictedEdits: number;
34
+ predictedButUnedited: number;
35
+ editedButUnpredicted: number;
36
+ };
37
+ precision: number | null;
38
+ recall: number | null;
39
+ testOutcomes: Record<TestOutcomeStatus, number>;
40
+ taskAssessments: Record<OutcomeRecord["taskAssessment"]["status"], number>;
41
+ perRecord: Array<{
42
+ id: string;
43
+ correctlyPredicted: string[];
44
+ predictedButUnedited: string[];
45
+ editedButUnpredicted: string[];
46
+ precision: number | null;
47
+ recall: number | null;
48
+ }>;
49
+ automaticWeightChanges: false;
50
+ };
51
+ export declare function emptyOutcomeStore(): OutcomeStore;
52
+ export declare function createOutcomeRecord(input: Omit<OutcomeRecord, "outcomeRecordVersion">): OutcomeRecord;
53
+ export declare function validateOutcomeStore(candidate: unknown): OutcomeStore;
54
+ export declare function addOutcomeRecord(store: OutcomeStore, record: OutcomeRecord): OutcomeStore;
55
+ export declare function removeOutcomeRecord(store: OutcomeStore, id: string): OutcomeStore;
56
+ /** Visible calibration only. This function has no access to, and never changes, ranking weights. */
57
+ export declare function summarizeOutcomeCalibration(store: OutcomeStore): OutcomeCalibration;
@@ -0,0 +1,146 @@
1
+ const ID = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/;
2
+ const FINGERPRINT = /^[A-Za-z0-9][A-Za-z0-9._:-]{5,255}$/;
3
+ const MAX_RECORDS = 50_000;
4
+ const MAX_PATHS = 5_000;
5
+ const MAX_TESTS = 1_000;
6
+ export function emptyOutcomeStore() { return { outcomeStoreVersion: 1, records: [] }; }
7
+ export function createOutcomeRecord(input) {
8
+ return validateOutcomeRecord({ outcomeRecordVersion: 1, ...input });
9
+ }
10
+ export function validateOutcomeStore(candidate) {
11
+ if (!isRecord(candidate) || candidate.outcomeStoreVersion !== 1 ||
12
+ !Array.isArray(candidate.records) || candidate.records.length > MAX_RECORDS) {
13
+ throw new Error("Invalid outcome store envelope.");
14
+ }
15
+ const records = candidate.records.map(validateOutcomeRecord).sort((a, b) => a.recordedAt.localeCompare(b.recordedAt) || a.id.localeCompare(b.id));
16
+ const duplicate = records.find((record, index) => records.findIndex((value) => value.id === record.id) !== index);
17
+ if (duplicate)
18
+ throw new Error(`Duplicate outcome record id: ${duplicate.id}`);
19
+ return { outcomeStoreVersion: 1, records };
20
+ }
21
+ export function addOutcomeRecord(store, record) {
22
+ const current = validateOutcomeStore(store);
23
+ const next = validateOutcomeRecord(record);
24
+ if (current.records.some((value) => value.id === next.id))
25
+ throw new Error(`Outcome record already exists: ${next.id}`);
26
+ return validateOutcomeStore({ outcomeStoreVersion: 1, records: [...current.records, next] });
27
+ }
28
+ export function removeOutcomeRecord(store, id) {
29
+ if (!ID.test(id))
30
+ throw new Error("Invalid outcome record id.");
31
+ const current = validateOutcomeStore(store);
32
+ if (!current.records.some((record) => record.id === id))
33
+ throw new Error(`Outcome record not found: ${id}`);
34
+ return { outcomeStoreVersion: 1, records: current.records.filter((record) => record.id !== id) };
35
+ }
36
+ /** Visible calibration only. This function has no access to, and never changes, ranking weights. */
37
+ export function summarizeOutcomeCalibration(store) {
38
+ const records = validateOutcomeStore(store).records;
39
+ const perRecord = records.map((record) => {
40
+ const predicted = new Set(record.predictedPaths);
41
+ const edited = new Set(record.editedPaths);
42
+ const correctlyPredicted = record.predictedPaths.filter((path) => edited.has(path));
43
+ const predictedButUnedited = record.predictedPaths.filter((path) => !edited.has(path));
44
+ const editedButUnpredicted = record.editedPaths.filter((path) => !predicted.has(path));
45
+ return {
46
+ id: record.id,
47
+ correctlyPredicted,
48
+ predictedButUnedited,
49
+ editedButUnpredicted,
50
+ precision: ratio(correctlyPredicted.length, record.predictedPaths.length),
51
+ recall: ratio(correctlyPredicted.length, record.editedPaths.length)
52
+ };
53
+ });
54
+ const totals = {
55
+ predictedPaths: records.reduce((sum, record) => sum + record.predictedPaths.length, 0),
56
+ editedPaths: records.reduce((sum, record) => sum + record.editedPaths.length, 0),
57
+ correctlyPredictedEdits: perRecord.reduce((sum, record) => sum + record.correctlyPredicted.length, 0),
58
+ predictedButUnedited: perRecord.reduce((sum, record) => sum + record.predictedButUnedited.length, 0),
59
+ editedButUnpredicted: perRecord.reduce((sum, record) => sum + record.editedButUnpredicted.length, 0)
60
+ };
61
+ const testOutcomes = countValues(["passed", "failed", "timeout", "crashed", "unavailable"]);
62
+ const taskAssessments = countValues(["succeeded", "failed", "partial", "unknown"]);
63
+ for (const record of records) {
64
+ for (const outcome of record.testOutcomes)
65
+ testOutcomes[outcome.status] += 1;
66
+ taskAssessments[record.taskAssessment.status] += 1;
67
+ }
68
+ return {
69
+ outcomeCalibrationVersion: 1,
70
+ records: records.length,
71
+ totals,
72
+ precision: ratio(totals.correctlyPredictedEdits, totals.predictedPaths),
73
+ recall: ratio(totals.correctlyPredictedEdits, totals.editedPaths),
74
+ testOutcomes,
75
+ taskAssessments,
76
+ perRecord,
77
+ automaticWeightChanges: false
78
+ };
79
+ }
80
+ function validateOutcomeRecord(candidate) {
81
+ if (!isRecord(candidate) || candidate.outcomeRecordVersion !== 1 || typeof candidate.id !== "string" || !ID.test(candidate.id) ||
82
+ typeof candidate.taskId !== "string" || !ID.test(candidate.taskId) ||
83
+ typeof candidate.repositoryIdentity !== "string" || !candidate.repositoryIdentity.startsWith("fixmap://") || candidate.repositoryIdentity.length > 2_048 ||
84
+ typeof candidate.planFingerprint !== "string" || !FINGERPRINT.test(candidate.planFingerprint) ||
85
+ typeof candidate.recordedAt !== "string" || !Number.isFinite(Date.parse(candidate.recordedAt)) ||
86
+ !Array.isArray(candidate.predictedPaths) || candidate.predictedPaths.length > MAX_PATHS ||
87
+ !Array.isArray(candidate.editedPaths) || candidate.editedPaths.length > MAX_PATHS ||
88
+ !Array.isArray(candidate.testOutcomes) || candidate.testOutcomes.length > MAX_TESTS || !isRecord(candidate.taskAssessment)) {
89
+ throw new Error("Invalid outcome record envelope.");
90
+ }
91
+ const predictedPaths = paths(candidate.predictedPaths, "predicted");
92
+ const editedPaths = paths(candidate.editedPaths, "edited");
93
+ const testOutcomes = candidate.testOutcomes.map((value, index) => {
94
+ if (!isRecord(value) || !bounded(value.command, 1_000) ||
95
+ !["passed", "failed", "timeout", "crashed", "unavailable"].includes(String(value.status)) ||
96
+ !Array.isArray(value.relatedPaths) || !bounded(value.evidence, 2_000)) {
97
+ throw new Error(`Invalid test outcome at index ${index}.`);
98
+ }
99
+ return {
100
+ command: value.command.trim(),
101
+ status: value.status,
102
+ relatedPaths: paths(value.relatedPaths, "test-related"),
103
+ evidence: value.evidence.trim()
104
+ };
105
+ }).sort((a, b) => a.command.localeCompare(b.command));
106
+ const assessment = candidate.taskAssessment;
107
+ if (!["succeeded", "failed", "partial", "unknown"].includes(String(assessment.status)) ||
108
+ !["human", "agent", "external-system", "unassessed"].includes(String(assessment.source)) || !bounded(assessment.reason, 2_000) ||
109
+ (assessment.source === "unassessed" && assessment.status !== "unknown")) {
110
+ throw new Error("Invalid task outcome assessment.");
111
+ }
112
+ return {
113
+ outcomeRecordVersion: 1,
114
+ id: candidate.id,
115
+ taskId: candidate.taskId,
116
+ repositoryIdentity: candidate.repositoryIdentity,
117
+ planFingerprint: candidate.planFingerprint,
118
+ recordedAt: new Date(candidate.recordedAt).toISOString(),
119
+ predictedPaths,
120
+ editedPaths,
121
+ testOutcomes,
122
+ taskAssessment: {
123
+ status: assessment.status,
124
+ source: assessment.source,
125
+ reason: assessment.reason.trim()
126
+ }
127
+ };
128
+ }
129
+ function paths(values, label) {
130
+ if (values.length > MAX_PATHS || !values.every((value) => typeof value === "string" && safePath(value))) {
131
+ throw new Error(`Invalid ${label} outcome paths.`);
132
+ }
133
+ return [...new Set(values.map((value) => value.replace(/\\/g, "/")))].sort();
134
+ }
135
+ function safePath(value) {
136
+ const normalized = value.replace(/\\/g, "/");
137
+ return Boolean(normalized) && normalized.length <= 1_000 && !normalized.includes("\0") && !/^(?:[\/]|[A-Za-z]:)/.test(value) &&
138
+ normalized.split("/").every((part) => part && part !== "." && part !== "..");
139
+ }
140
+ function bounded(value, max) { return typeof value === "string" && value.trim().length > 0 && value.length <= max; }
141
+ function ratio(numerator, denominator) { return denominator === 0 ? null : Number((numerator / denominator).toFixed(6)); }
142
+ function countValues(values) {
143
+ return Object.fromEntries(values.map((value) => [value, 0]));
144
+ }
145
+ function isRecord(value) { return typeof value === "object" && value !== null && !Array.isArray(value); }
146
+ //# sourceMappingURL=outcomes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"outcomes.js","sourceRoot":"","sources":["../src/outcomes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,29 @@
1
+ import type { RepoMap } from "./types.js";
2
+ export type ReviewEvidence = {
3
+ kind: "codeowners" | "annotation" | "architecture-policy" | "git-history";
4
+ sourceFingerprint: string;
5
+ detail: string;
6
+ path?: string;
7
+ line?: number;
8
+ };
9
+ export type ReviewSuggestion = {
10
+ reviewer: string;
11
+ confidence: "high" | "medium" | "low";
12
+ paths: string[];
13
+ evidence: ReviewEvidence[];
14
+ availabilityInferred: false;
15
+ };
16
+ export type ReviewRoutingResult = {
17
+ reviewRoutingVersion: 1;
18
+ changedPaths: string[];
19
+ suggestions: ReviewSuggestion[];
20
+ diagnostics: Array<{
21
+ source: string;
22
+ severity: "info" | "warning";
23
+ message: string;
24
+ }>;
25
+ };
26
+ export declare function routeReviewers(repo: RepoMap, input: {
27
+ changedPaths?: readonly string[];
28
+ now: string;
29
+ }): ReviewRoutingResult;
@@ -0,0 +1,189 @@
1
+ import { architecturePolicyFromRepo, evaluateArchitecturePolicy } from "./architecture.js";
2
+ import { assessAnnotations, validateAnnotationStore } from "./annotations.js";
3
+ import { buildPathExcluder } from "./exclude.js";
4
+ const CODEOWNERS_PATHS = [".github/CODEOWNERS", "CODEOWNERS", "docs/CODEOWNERS"];
5
+ const MAX_RULES = 10_000;
6
+ const MAX_HISTORY_COMMITS = 250;
7
+ export function routeReviewers(repo, input) {
8
+ if (!Number.isFinite(Date.parse(input.now)))
9
+ throw new Error("Review routing requires a valid assessment time.");
10
+ const changedPaths = normalizePaths(input.changedPaths ?? repo.changedFiles);
11
+ const diagnostics = [];
12
+ const accumulated = new Map();
13
+ addCodeOwners(repo, changedPaths, accumulated, diagnostics);
14
+ addAnnotations(repo, changedPaths, input.now, accumulated, diagnostics);
15
+ addPolicy(repo, changedPaths, accumulated, diagnostics);
16
+ addHistory(repo, changedPaths, accumulated);
17
+ const suggestions = [...accumulated].map(([reviewer, value]) => ({
18
+ reviewer,
19
+ confidence: value.confidence,
20
+ paths: [...value.paths].sort(),
21
+ evidence: value.evidence.sort(evidenceOrder),
22
+ availabilityInferred: false
23
+ })).sort((a, b) => confidenceOrder(a.confidence) - confidenceOrder(b.confidence) || a.reviewer.localeCompare(b.reviewer));
24
+ return { reviewRoutingVersion: 1, changedPaths, suggestions, diagnostics };
25
+ }
26
+ function addCodeOwners(repo, paths, accumulated, diagnostics) {
27
+ const source = CODEOWNERS_PATHS.map((path) => repo.files.find((file) => file.path === path)).find(Boolean);
28
+ if (!source)
29
+ return;
30
+ if (source.textSampleComplete === false || !source.contentFingerprint) {
31
+ diagnostics.push({ source: source.path, severity: "warning", message: `${source.path} is incomplete or lacks an exact fingerprint; CODEOWNERS routing was skipped.` });
32
+ return;
33
+ }
34
+ const parsed = parseCodeOwners(source.textSample);
35
+ diagnostics.push(...parsed.diagnostics.map((message) => ({ source: source.path, severity: "warning", message })));
36
+ for (const path of paths) {
37
+ const rule = [...parsed.rules].reverse().find((candidate) => matchesCodeOwners(path, candidate.pattern));
38
+ if (!rule)
39
+ continue;
40
+ for (const owner of rule.owners)
41
+ add(accumulated, owner, "high", path, {
42
+ kind: "codeowners",
43
+ sourceFingerprint: source.contentFingerprint,
44
+ path: source.path,
45
+ line: rule.line,
46
+ detail: `${source.path}:${rule.line} assigns ${owner} through pattern ${rule.pattern}.`
47
+ });
48
+ }
49
+ }
50
+ function parseCodeOwners(content) {
51
+ const rules = [];
52
+ const diagnostics = [];
53
+ for (const [index, raw] of content.split(/\r?\n/).entries()) {
54
+ const lineNumber = index + 1;
55
+ const trimmed = raw.trim();
56
+ if (!trimmed || trimmed.startsWith("#"))
57
+ continue;
58
+ const tokens = trimmed.split(/\s+/);
59
+ const pattern = tokens.shift() ?? "";
60
+ const owners = [...new Set(tokens.filter(validOwner))].sort();
61
+ if (!pattern || pattern.startsWith("!") || pattern.includes("[") || owners.length === 0) {
62
+ diagnostics.push(`Ignored unsupported or ownerless CODEOWNERS rule at line ${lineNumber}.`);
63
+ continue;
64
+ }
65
+ if (rules.length >= MAX_RULES) {
66
+ diagnostics.push(`CODEOWNERS rules were bounded to ${MAX_RULES.toLocaleString()} entries.`);
67
+ break;
68
+ }
69
+ rules.push({ pattern, owners, line: lineNumber });
70
+ }
71
+ return { rules, diagnostics };
72
+ }
73
+ function matchesCodeOwners(path, pattern) {
74
+ try {
75
+ const normalized = pattern.startsWith("/") ? pattern.slice(1) : pattern;
76
+ return buildPathExcluder([normalized]).excludes(path);
77
+ }
78
+ catch {
79
+ return false;
80
+ }
81
+ }
82
+ function addAnnotations(repo, paths, now, accumulated, diagnostics) {
83
+ const source = repo.files.find((file) => file.path === ".fixmap/annotations.json");
84
+ if (!source)
85
+ return;
86
+ if (source.textSampleComplete === false || !source.contentFingerprint) {
87
+ diagnostics.push({ source: source.path, severity: "warning", message: "Annotation owners were skipped because the store is incomplete or unversioned." });
88
+ return;
89
+ }
90
+ try {
91
+ const assessments = assessAnnotations(validateAnnotationStore(JSON.parse(source.textSample)), repo, { now });
92
+ for (const assessment of assessments) {
93
+ const annotation = assessment.annotation;
94
+ if (assessment.status !== "active" || !annotation.owner)
95
+ continue;
96
+ const scopePath = annotation.scope.kind === "file" || annotation.scope.kind === "symbol" || annotation.scope.kind === "contract"
97
+ ? annotation.scope.path
98
+ : undefined;
99
+ const matchedPaths = scopePath ? paths.filter((path) => path === scopePath) : [];
100
+ for (const path of matchedPaths)
101
+ add(accumulated, annotation.owner, "high", path, {
102
+ kind: "annotation",
103
+ sourceFingerprint: source.contentFingerprint,
104
+ path: source.path,
105
+ detail: `${annotation.id} explicitly names ${annotation.owner} for ${path}.`
106
+ });
107
+ }
108
+ }
109
+ catch (error) {
110
+ diagnostics.push({ source: source.path, severity: "warning", message: `Annotation owners were skipped: ${error instanceof Error ? error.message : String(error)}` });
111
+ }
112
+ }
113
+ function addPolicy(repo, paths, accumulated, diagnostics) {
114
+ try {
115
+ const policy = architecturePolicyFromRepo(repo);
116
+ if (!policy)
117
+ return;
118
+ const policyRepo = { ...repo, changedFiles: [...paths] };
119
+ const findings = evaluateArchitecturePolicy(policy, { repo: policyRepo, focusPaths: paths }).findings;
120
+ for (const finding of findings.filter((entry) => entry.code === "review-required")) {
121
+ for (const evidence of finding.evidence.filter((entry) => entry.kind === "reviewer")) {
122
+ for (const path of finding.paths)
123
+ add(accumulated, evidence.detail, "high", path, {
124
+ kind: "architecture-policy",
125
+ sourceFingerprint: policy.source.fingerprint,
126
+ path: policy.source.path,
127
+ detail: `${finding.ruleId} requires ${evidence.detail} for ${path}.`
128
+ });
129
+ }
130
+ }
131
+ }
132
+ catch (error) {
133
+ diagnostics.push({ source: ".fixmap/policy.json", severity: "warning", message: `Policy reviewers were skipped: ${error instanceof Error ? error.message : String(error)}` });
134
+ }
135
+ }
136
+ function addHistory(repo, paths, accumulated) {
137
+ for (const path of paths) {
138
+ const counts = new Map();
139
+ for (const commit of (repo.history?.commits ?? []).slice(0, MAX_HISTORY_COMMITS)) {
140
+ if (!commit.author || !commit.files.includes(path))
141
+ continue;
142
+ const previous = counts.get(commit.author);
143
+ counts.set(commit.author, {
144
+ count: (previous?.count ?? 0) + 1,
145
+ latest: Math.max(previous?.latest ?? 0, commit.committedAt),
146
+ hash: previous && previous.latest > commit.committedAt ? previous.hash : commit.hash
147
+ });
148
+ }
149
+ for (const [author, evidence] of [...counts].sort((a, b) => b[1].count - a[1].count || b[1].latest - a[1].latest || a[0].localeCompare(b[0])).slice(0, 3)) {
150
+ add(accumulated, author, "low", path, {
151
+ kind: "git-history",
152
+ sourceFingerprint: `git:${evidence.hash}`,
153
+ path,
154
+ detail: `${author} authored ${evidence.count} bounded non-merge commit${evidence.count === 1 ? "" : "s"} touching ${path}; current availability or employment is not inferred.`
155
+ });
156
+ }
157
+ }
158
+ }
159
+ function add(accumulated, reviewer, confidence, path, evidence) {
160
+ const identity = reviewer.trim();
161
+ if (!identity || identity.length > 200 || /[\0-\x1f\x7f]/.test(identity))
162
+ return;
163
+ const existing = accumulated.get(identity) ?? { confidence, paths: new Set(), evidence: [] };
164
+ if (confidenceOrder(confidence) < confidenceOrder(existing.confidence))
165
+ existing.confidence = confidence;
166
+ existing.paths.add(path);
167
+ if (!existing.evidence.some((entry) => evidenceKey(entry) === evidenceKey(evidence)))
168
+ existing.evidence.push(evidence);
169
+ accumulated.set(identity, existing);
170
+ }
171
+ function normalizePaths(values) {
172
+ const normalized = values.map((value) => value.replace(/\\/g, "/"));
173
+ const invalid = normalized.find((value) => !safePath(value));
174
+ if (invalid !== undefined)
175
+ throw new Error(`Invalid review-routing path: ${String(invalid)}`);
176
+ return [...new Set(normalized)].sort();
177
+ }
178
+ function safePath(value) {
179
+ return Boolean(value) && value.length <= 1_000 && !value.includes("\0") && !/^(?:[\/]|[A-Za-z]:)/.test(value) &&
180
+ value.split("/").every((part) => part && part !== "." && part !== "..");
181
+ }
182
+ function validOwner(value) {
183
+ return value.length <= 200 && (/^@[A-Za-z0-9][A-Za-z0-9_.-]*(?:\/[A-Za-z0-9][A-Za-z0-9_.-]*)?$/.test(value) ||
184
+ /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value));
185
+ }
186
+ function evidenceKey(value) { return `${value.kind}\0${value.sourceFingerprint}\0${value.path ?? ""}\0${value.line ?? ""}\0${value.detail}`; }
187
+ function evidenceOrder(a, b) { return a.kind.localeCompare(b.kind) || (a.path ?? "").localeCompare(b.path ?? "") || (a.line ?? 0) - (b.line ?? 0); }
188
+ function confidenceOrder(value) { return value === "high" ? 0 : value === "medium" ? 1 : 2; }
189
+ //# sourceMappingURL=ownership.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ownership.js","sourceRoot":"","sources":["../src/ownership.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,74 @@
1
+ export type PlanAlternative = {
2
+ planAlternativeVersion: 1;
3
+ id: string;
4
+ graphFingerprint: string;
5
+ edits: string[];
6
+ impacts: string[];
7
+ contracts: Array<{
8
+ identity: string;
9
+ compatibility: "compatible" | "breaking" | "unknown";
10
+ reason: string;
11
+ }>;
12
+ policyFindings: Array<{
13
+ ruleId: string;
14
+ severity: "info" | "warning" | "error";
15
+ message: string;
16
+ }>;
17
+ tests: Array<{
18
+ command: string;
19
+ covers: string[];
20
+ reason: string;
21
+ }>;
22
+ reversibility: {
23
+ mode: "full" | "partial" | "none";
24
+ reason: string;
25
+ rollbackSteps: string[];
26
+ };
27
+ uncertainties: Array<{
28
+ id: string;
29
+ severity: "low" | "medium" | "high";
30
+ detail: string;
31
+ }>;
32
+ };
33
+ export type PlanAlternativeAssessment = {
34
+ id: string;
35
+ metrics: {
36
+ editIdentities: number;
37
+ impactIdentities: number;
38
+ contractIdentities: number;
39
+ totalBlastRadiusIdentities: number;
40
+ breakingContracts: number;
41
+ unknownContracts: number;
42
+ policyErrors: number;
43
+ policyWarnings: number;
44
+ plannedTests: number;
45
+ coveredEditIdentities: number;
46
+ uncoveredEditIdentities: string[];
47
+ reversibility: "full" | "partial" | "none";
48
+ highUncertainties: number;
49
+ mediumUncertainties: number;
50
+ };
51
+ evidence: Array<{
52
+ axis: string;
53
+ detail: string;
54
+ identities?: string[];
55
+ }>;
56
+ };
57
+ export type AlternativePlanComparison = {
58
+ alternativePlanComparisonVersion: 1;
59
+ graphFingerprint: string;
60
+ fingerprint: string;
61
+ alternatives: PlanAlternativeAssessment[];
62
+ pairwise: Array<{
63
+ left: string;
64
+ right: string;
65
+ differences: Array<{
66
+ axis: string;
67
+ left: string | number;
68
+ right: string | number;
69
+ }>;
70
+ }>;
71
+ nonDominatedAlternatives: string[];
72
+ };
73
+ /** Compare tradeoffs on an identical graph state without collapsing them into an arbitrary score. */
74
+ export declare function comparePlanAlternatives(candidates: readonly PlanAlternative[]): AlternativePlanComparison;