@aryam/fixmap-core 0.9.1 → 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 +1 -1
@@ -0,0 +1,49 @@
1
+ import type { CapabilityDefinition, CapabilityMap } from "./capabilities.js";
2
+ export type CapabilityRefSnapshot = {
3
+ requestedRef: string;
4
+ commit: string;
5
+ state: "present" | "absent";
6
+ capability?: CapabilityDefinition;
7
+ map?: CapabilityMap;
8
+ testAssociations: Array<{
9
+ path: string;
10
+ sourceFingerprint: string;
11
+ }>;
12
+ reason?: string;
13
+ };
14
+ export type CapabilityPathDiff = {
15
+ added: string[];
16
+ removed: string[];
17
+ modified: string[];
18
+ unchanged: string[];
19
+ };
20
+ export type CapabilityEntityDiff = {
21
+ added: string[];
22
+ removed: string[];
23
+ modified: string[];
24
+ unchanged: string[];
25
+ };
26
+ export type CapabilityHistoryDiff = {
27
+ capabilityHistoryVersion: 1;
28
+ id: string;
29
+ from: CapabilityRefSnapshot;
30
+ to: CapabilityRefSnapshot;
31
+ definitionChanged: boolean;
32
+ selected: CapabilityPathDiff;
33
+ affected: CapabilityPathDiff;
34
+ contracts: CapabilityEntityDiff;
35
+ decisions: CapabilityEntityDiff;
36
+ testAssociations: CapabilityEntityDiff;
37
+ reviewers: CapabilityEntityDiff;
38
+ architectureFindings: CapabilityEntityDiff;
39
+ summary: string;
40
+ };
41
+ /** Compare two exact committed capability maps without checkout or worktree mutation. */
42
+ export declare function compareCapabilityRefs(input: {
43
+ repoRoot: string;
44
+ id: string;
45
+ fromRef: string;
46
+ toRef: string;
47
+ asOf: string;
48
+ }): Promise<CapabilityHistoryDiff>;
49
+ export declare function renderCapabilityHistoryMarkdown(diff: CapabilityHistoryDiff): string;
@@ -0,0 +1,176 @@
1
+ import { scanRepoAtRef } from "./architecture-history.js";
2
+ import { buildCapabilityMap, capabilityStoreFromRepo } from "./capabilities.js";
3
+ import { markdownCode } from "./markdown.js";
4
+ /** Compare two exact committed capability maps without checkout or worktree mutation. */
5
+ export async function compareCapabilityRefs(input) {
6
+ if (!Number.isFinite(Date.parse(input.asOf)))
7
+ throw new Error("Capability history requires a valid asOf timestamp.");
8
+ const id = input.id.trim().toLowerCase();
9
+ if (!/^[a-z0-9][a-z0-9._-]{0,63}$/.test(id))
10
+ throw new Error("Capability history requires a valid capability id.");
11
+ const [historicalFrom, historicalTo] = await Promise.all([
12
+ scanRepoAtRef({ repoRoot: input.repoRoot, ref: input.fromRef }),
13
+ scanRepoAtRef({ repoRoot: input.repoRoot, ref: input.toRef })
14
+ ]);
15
+ const from = capabilitySnapshot(historicalFrom, id, input.asOf);
16
+ const to = capabilitySnapshot(historicalTo, id, input.asOf);
17
+ const selected = comparePaths(from.map?.scope.selected ?? [], to.map?.scope.selected ?? []);
18
+ const affected = comparePaths(from.map?.scope.affected ?? [], to.map?.scope.affected ?? []);
19
+ const contracts = compareEntities(from.map?.scope.contracts.map((entry) => ({ id: entry.id, fingerprint: `${entry.sourceFingerprint}\0${canonicalize(entry.entries)}` })) ?? [], to.map?.scope.contracts.map((entry) => ({ id: entry.id, fingerprint: `${entry.sourceFingerprint}\0${canonicalize(entry.entries)}` })) ?? []);
20
+ const decisions = compareEntities(from.map?.scope.decisions.map((entry) => ({ id: entry.id, fingerprint: entry.sourceFingerprint })) ?? [], to.map?.scope.decisions.map((entry) => ({ id: entry.id, fingerprint: entry.sourceFingerprint })) ?? []);
21
+ const testAssociations = compareEntities(from.testAssociations.map((entry) => ({ id: entry.path, fingerprint: entry.sourceFingerprint })), to.testAssociations.map((entry) => ({ id: entry.path, fingerprint: entry.sourceFingerprint })));
22
+ const reviewers = compareEntities(reviewerEntities(from.map), reviewerEntities(to.map));
23
+ const architectureFindings = compareEntities(findingEntities(from.map), findingEntities(to.map));
24
+ const definitionChanged = canonicalize(from.capability ?? null) !== canonicalize(to.capability ?? null);
25
+ const totalChanges = [selected, affected, contracts, decisions, testAssociations, reviewers, architectureFindings]
26
+ .reduce((total, diff) => total + diff.added.length + diff.removed.length + diff.modified.length, definitionChanged ? 1 : 0);
27
+ return {
28
+ capabilityHistoryVersion: 1,
29
+ id,
30
+ from,
31
+ to,
32
+ definitionChanged,
33
+ selected,
34
+ affected,
35
+ contracts,
36
+ decisions,
37
+ testAssociations,
38
+ reviewers,
39
+ architectureFindings,
40
+ summary: totalChanges === 0
41
+ ? `Capability ${id} has no evidenced change between ${from.commit} and ${to.commit}.`
42
+ : `Capability ${id} has ${totalChanges.toLocaleString()} evidenced ${totalChanges === 1 ? "change" : "changes"} between ${from.commit} and ${to.commit}.`
43
+ };
44
+ }
45
+ export function renderCapabilityHistoryMarkdown(diff) {
46
+ const lines = [
47
+ `# FixMap Capability Diff: ${diff.id}`,
48
+ "",
49
+ diff.summary,
50
+ "",
51
+ `From ${markdownCode(diff.from.requestedRef)} at ${markdownCode(diff.from.commit)}: ${diff.from.state}.`,
52
+ `To ${markdownCode(diff.to.requestedRef)} at ${markdownCode(diff.to.commit)}: ${diff.to.state}.`,
53
+ `Definition changed: ${diff.definitionChanged ? "yes" : "no"}.`,
54
+ "",
55
+ "## Selected scope",
56
+ "",
57
+ ...renderDiff(diff.selected),
58
+ "",
59
+ "## Structural consequences",
60
+ "",
61
+ ...renderDiff(diff.affected),
62
+ "",
63
+ "## Contracts",
64
+ "",
65
+ ...renderDiff(diff.contracts),
66
+ "",
67
+ "## Decisions",
68
+ "",
69
+ ...renderDiff(diff.decisions),
70
+ "",
71
+ "## Test associations",
72
+ "",
73
+ ...renderDiff(diff.testAssociations),
74
+ "",
75
+ "## Reviewers",
76
+ "",
77
+ ...renderDiff(diff.reviewers),
78
+ "",
79
+ "## Architecture findings",
80
+ "",
81
+ ...renderDiff(diff.architectureFindings),
82
+ "",
83
+ "Both sides were read from immutable Git objects. FixMap did not check out either ref or interpret product semantics.",
84
+ ""
85
+ ];
86
+ return lines.join("\n");
87
+ }
88
+ function capabilitySnapshot(historical, id, asOf) {
89
+ const loaded = capabilityStoreFromRepo(historical.repo);
90
+ if (!loaded) {
91
+ return {
92
+ requestedRef: historical.requestedRef,
93
+ commit: historical.commit,
94
+ state: "absent",
95
+ testAssociations: [],
96
+ reason: ".fixmap/capabilities.json is absent at this ref."
97
+ };
98
+ }
99
+ const capability = loaded.store.capabilities.find((entry) => entry.id === id);
100
+ if (!capability) {
101
+ return {
102
+ requestedRef: historical.requestedRef,
103
+ commit: historical.commit,
104
+ state: "absent",
105
+ testAssociations: [],
106
+ reason: `Capability ${id} is absent at this ref.`
107
+ };
108
+ }
109
+ const map = buildCapabilityMap(historical.repo, { id, asOf });
110
+ const scopedPaths = new Set([...map.scope.selected, ...map.scope.affected].map((entry) => entry.path));
111
+ const testAssociations = historical.repo.files
112
+ .filter((file) => file.isTest && scopedPaths.has(file.path) && file.contentFingerprint)
113
+ .map((file) => ({ path: file.path, sourceFingerprint: file.contentFingerprint }))
114
+ .sort((left, right) => left.path.localeCompare(right.path));
115
+ return {
116
+ requestedRef: historical.requestedRef,
117
+ commit: historical.commit,
118
+ state: "present",
119
+ capability,
120
+ map,
121
+ testAssociations
122
+ };
123
+ }
124
+ function comparePaths(previous, current) {
125
+ return compareMaps(new Map(previous.map((entry) => [entry.path, entry.sourceFingerprint ?? "unknown"])), new Map(current.map((entry) => [entry.path, entry.sourceFingerprint ?? "unknown"])));
126
+ }
127
+ function compareEntities(previous, current) {
128
+ return compareMaps(new Map(previous.map((entry) => [entry.id, entry.fingerprint])), new Map(current.map((entry) => [entry.id, entry.fingerprint])));
129
+ }
130
+ function compareMaps(previous, current) {
131
+ const keys = [...new Set([...previous.keys(), ...current.keys()])].sort();
132
+ const result = { added: [], removed: [], modified: [], unchanged: [] };
133
+ for (const key of keys) {
134
+ if (!previous.has(key))
135
+ result.added.push(key);
136
+ else if (!current.has(key))
137
+ result.removed.push(key);
138
+ else if (previous.get(key) !== current.get(key))
139
+ result.modified.push(key);
140
+ else
141
+ result.unchanged.push(key);
142
+ }
143
+ return result;
144
+ }
145
+ function reviewerEntities(map) {
146
+ return (map?.scope.reviewers ?? []).map((reviewer) => ({
147
+ id: reviewer.reviewer,
148
+ fingerprint: canonicalize({ paths: reviewer.paths, evidence: reviewer.evidence })
149
+ }));
150
+ }
151
+ function findingEntities(map) {
152
+ return (map?.scope.architectureFindings ?? []).map((finding) => ({
153
+ id: `${finding.ruleId}:${finding.code}:${finding.paths.join("|")}`,
154
+ fingerprint: canonicalize(finding)
155
+ }));
156
+ }
157
+ function renderDiff(diff) {
158
+ const lines = [
159
+ ...diff.added.map((entry) => `- added ${markdownCode(entry)}`),
160
+ ...diff.removed.map((entry) => `- removed ${markdownCode(entry)}`),
161
+ ...diff.modified.map((entry) => `- modified ${markdownCode(entry)}`)
162
+ ];
163
+ return lines.length > 0 ? lines : ["- No evidenced changes"];
164
+ }
165
+ function canonicalize(value) {
166
+ if (Array.isArray(value))
167
+ return `[${value.map(canonicalize).join(",")}]`;
168
+ if (value && typeof value === "object") {
169
+ return `{${Object.entries(value)
170
+ .filter(([, entry]) => entry !== undefined)
171
+ .sort(([left], [right]) => left.localeCompare(right))
172
+ .map(([key, entry]) => `${JSON.stringify(key)}:${canonicalize(entry)}`).join(",")}}`;
173
+ }
174
+ return JSON.stringify(value);
175
+ }
176
+ //# sourceMappingURL=capability-history.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"capability-history.js","sourceRoot":"","sources":["../src/capability-history.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,34 @@
1
+ import type { IdentityGraph } from "./identity-graph.js";
2
+ export type ChangeZone = {
3
+ identity: string;
4
+ label?: string;
5
+ };
6
+ export type ChangeIntent = {
7
+ changeIntentVersion: 1;
8
+ id: string;
9
+ baseGraphFingerprint: string;
10
+ edits: ChangeZone[];
11
+ impacts: ChangeZone[];
12
+ contracts: ChangeZone[];
13
+ };
14
+ export type ChangeConflict = {
15
+ id: string;
16
+ kind: "edit-edit" | "edit-impact" | "contract-contract" | "stale-baseline";
17
+ severity: "warning" | "error";
18
+ intents: [string, string];
19
+ identities: string[];
20
+ message: string;
21
+ evidence: Array<{
22
+ intent: string;
23
+ zone: "edit" | "impact" | "contract" | "baseline";
24
+ identity?: string;
25
+ detail: string;
26
+ }>;
27
+ };
28
+ export type ChangeConflictAnalysis = {
29
+ changeConflictAnalysisVersion: 1;
30
+ intents: string[];
31
+ conflicts: ChangeConflict[];
32
+ };
33
+ /** Compare explicit change zones. Names and labels never establish identity or equivalence. */
34
+ export declare function detectChangeConflicts(candidates: readonly ChangeIntent[], graph?: IdentityGraph): ChangeConflictAnalysis;
@@ -0,0 +1,140 @@
1
+ const INTENT_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_INTENTS = 100;
4
+ const MAX_ZONES = 1_000;
5
+ /** Compare explicit change zones. Names and labels never establish identity or equivalence. */
6
+ export function detectChangeConflicts(candidates, graph) {
7
+ if (candidates.length > MAX_INTENTS)
8
+ throw new Error(`Conflict analysis supports at most ${MAX_INTENTS} intents.`);
9
+ const intents = candidates.map(validateIntent).sort((a, b) => a.id.localeCompare(b.id));
10
+ const duplicate = intents.find((intent, index) => intents.findIndex((value) => value.id === intent.id) !== index);
11
+ if (duplicate)
12
+ throw new Error(`Duplicate change intent id: ${duplicate.id}`);
13
+ const canonical = equivalenceResolver(graph);
14
+ const conflicts = [];
15
+ for (let leftIndex = 0; leftIndex < intents.length; leftIndex += 1) {
16
+ for (let rightIndex = leftIndex + 1; rightIndex < intents.length; rightIndex += 1) {
17
+ const left = intents[leftIndex];
18
+ const right = intents[rightIndex];
19
+ if (left.baseGraphFingerprint !== right.baseGraphFingerprint) {
20
+ conflicts.push(conflict("stale-baseline", "warning", left, right, [], [
21
+ { intent: left.id, zone: "baseline", detail: left.baseGraphFingerprint },
22
+ { intent: right.id, zone: "baseline", detail: right.baseGraphFingerprint }
23
+ ], "The plans were built from different graph versions; refresh before treating non-overlap as safe."));
24
+ }
25
+ const leftEdits = zoneMap(left.edits, canonical);
26
+ const rightEdits = zoneMap(right.edits, canonical);
27
+ const leftImpacts = zoneMap(left.impacts, canonical);
28
+ const rightImpacts = zoneMap(right.impacts, canonical);
29
+ const leftContracts = zoneMap(left.contracts, canonical);
30
+ const rightContracts = zoneMap(right.contracts, canonical);
31
+ const sharedEdits = intersection(leftEdits, rightEdits);
32
+ if (sharedEdits.length > 0)
33
+ conflicts.push(zoneConflict("edit-edit", "error", left, right, sharedEdits, "edit", "edit", "Both plans intend to edit the same graph identity."));
34
+ const leftIntoRight = intersection(leftEdits, rightImpacts);
35
+ if (leftIntoRight.length > 0)
36
+ conflicts.push(zoneConflict("edit-impact", "warning", left, right, leftIntoRight, "edit", "impact", `${left.id} edits identities in ${right.id}'s impact zone.`));
37
+ const rightIntoLeft = intersection(rightEdits, leftImpacts);
38
+ if (rightIntoLeft.length > 0)
39
+ conflicts.push(zoneConflict("edit-impact", "warning", right, left, rightIntoLeft, "edit", "impact", `${right.id} edits identities in ${left.id}'s impact zone.`));
40
+ const sharedContracts = intersection(leftContracts, rightContracts);
41
+ if (sharedContracts.length > 0)
42
+ conflicts.push(zoneConflict("contract-contract", "warning", left, right, sharedContracts, "contract", "contract", "Both plans touch the same contract identity."));
43
+ }
44
+ }
45
+ return {
46
+ changeConflictAnalysisVersion: 1,
47
+ intents: intents.map((intent) => intent.id),
48
+ conflicts: conflicts.sort((a, b) => severityOrder(a.severity) - severityOrder(b.severity) ||
49
+ a.kind.localeCompare(b.kind) || a.id.localeCompare(b.id))
50
+ };
51
+ }
52
+ function validateIntent(intent) {
53
+ if (!intent || intent.changeIntentVersion !== 1 || !INTENT_ID.test(intent.id) || !FINGERPRINT.test(intent.baseGraphFingerprint)) {
54
+ throw new Error("Invalid change intent envelope.");
55
+ }
56
+ return {
57
+ changeIntentVersion: 1,
58
+ id: intent.id,
59
+ baseGraphFingerprint: intent.baseGraphFingerprint,
60
+ edits: validateZones(intent.edits, "edits"),
61
+ impacts: validateZones(intent.impacts, "impacts"),
62
+ contracts: validateZones(intent.contracts, "contracts")
63
+ };
64
+ }
65
+ function validateZones(zones, label) {
66
+ if (!Array.isArray(zones) || zones.length > MAX_ZONES)
67
+ throw new Error(`Invalid or excessive ${label} zones.`);
68
+ const result = zones.map((zone) => {
69
+ if (!zone || typeof zone.identity !== "string" || !zone.identity.startsWith("fixmap://") || zone.identity.length > 2_048 ||
70
+ (zone.label !== undefined && (typeof zone.label !== "string" || !zone.label.trim() || zone.label.length > 500))) {
71
+ throw new Error(`Invalid ${label} change zone.`);
72
+ }
73
+ return { identity: zone.identity, ...(zone.label ? { label: zone.label.trim() } : {}) };
74
+ }).sort((a, b) => a.identity.localeCompare(b.identity));
75
+ return result.filter((zone, index) => result.findIndex((value) => value.identity === zone.identity) === index);
76
+ }
77
+ function equivalenceResolver(graph) {
78
+ const parent = new Map();
79
+ const find = (value) => {
80
+ const current = parent.get(value);
81
+ if (!current || current === value)
82
+ return value;
83
+ const root = find(current);
84
+ parent.set(value, root);
85
+ return root;
86
+ };
87
+ const union = (left, right) => {
88
+ const a = find(left);
89
+ const b = find(right);
90
+ if (a === b)
91
+ return;
92
+ const [root, child] = [a, b].sort();
93
+ parent.set(child, root);
94
+ parent.set(root, root);
95
+ };
96
+ for (const edge of graph?.edges ?? []) {
97
+ if (edge.kind === "aliases" || edge.kind === "equivalent-to")
98
+ union(edge.from, edge.to);
99
+ }
100
+ return find;
101
+ }
102
+ function zoneMap(zones, canonical) {
103
+ const result = new Map();
104
+ for (const zone of zones)
105
+ if (!result.has(canonical(zone.identity)))
106
+ result.set(canonical(zone.identity), zone);
107
+ return result;
108
+ }
109
+ function intersection(left, right) {
110
+ return [...left.keys()].filter((identity) => right.has(identity)).sort();
111
+ }
112
+ function zoneConflict(kind, severity, left, right, identities, leftZone, rightZone, message) {
113
+ return conflict(kind, severity, left, right, identities, identities.flatMap((identity) => [
114
+ { intent: left.id, zone: leftZone, identity, detail: `${left.id} declares ${identity} as ${leftZone}.` },
115
+ { intent: right.id, zone: rightZone, identity, detail: `${right.id} declares ${identity} as ${rightZone}.` }
116
+ ]), message);
117
+ }
118
+ function conflict(kind, severity, left, right, identities, evidence, message) {
119
+ const intents = [left.id, right.id].sort();
120
+ const evidenceKey = evidence.map((entry) => `${entry.intent}:${entry.zone}:${entry.identity ?? entry.detail}`).sort().join("\0");
121
+ return {
122
+ id: `change-conflict:${stableHash(`${kind}\0${intents.join("\0")}\0${identities.join("\0")}\0${evidenceKey}`)}`,
123
+ kind,
124
+ severity,
125
+ intents,
126
+ identities,
127
+ message,
128
+ evidence
129
+ };
130
+ }
131
+ function severityOrder(value) { return value === "error" ? 0 : 1; }
132
+ function stableHash(value) {
133
+ let hash = 0xcbf29ce484222325n;
134
+ for (const byte of new TextEncoder().encode(value)) {
135
+ hash ^= BigInt(byte);
136
+ hash = BigInt.asUintN(64, hash * 0x100000001b3n);
137
+ }
138
+ return hash.toString(16).padStart(16, "0");
139
+ }
140
+ //# sourceMappingURL=change-conflicts.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"change-conflicts.js","sourceRoot":"","sources":["../src/change-conflicts.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,81 @@
1
+ import type { ArchitecturePolicyFinding } from "./architecture.js";
2
+ import type { ContractSurface } from "./contracts.js";
3
+ import type { DecisionRecord } from "./decisions.js";
4
+ import type { ReviewSuggestion } from "./ownership.js";
5
+ import type { RepoMap, TestRoute } from "./types.js";
6
+ export type ChangeScopeDirection = "dependencies" | "dependents" | "both";
7
+ export type ChangeScopeAnchor = {
8
+ operation: "touch" | "add";
9
+ path: string;
10
+ };
11
+ export type ChangeScopeTraversal = {
12
+ direction: ChangeScopeDirection;
13
+ maxDepth: number;
14
+ maxNodes: number;
15
+ };
16
+ export type ChangeScopeEvidence = {
17
+ kind: "declared" | "dependency" | "dependent";
18
+ from?: string;
19
+ to: string;
20
+ reason: string;
21
+ };
22
+ export type ChangeScopePath = {
23
+ identity: string;
24
+ path: string;
25
+ role: "selected" | "affected";
26
+ distance: number;
27
+ sourceFingerprint?: string;
28
+ evidence: ChangeScopeEvidence[];
29
+ };
30
+ export type ResolvedChangeScopeAnchor = ChangeScopeAnchor & {
31
+ status: "resolved" | "unresolved";
32
+ matchedPaths: string[];
33
+ };
34
+ export type ChangeScopeDiagnostic = {
35
+ code: "scope-anchor-unresolved" | "scope-bounded" | "scope-contract-warning" | "scope-decision-warning" | "scope-ownership-warning" | "scope-policy-warning";
36
+ severity: "info" | "warning";
37
+ message: string;
38
+ paths?: string[];
39
+ };
40
+ export type ChangeScopeResult = {
41
+ changeScopeVersion: 1;
42
+ workspace: string;
43
+ repository: string;
44
+ repositoryIdentity: string;
45
+ traversal: ChangeScopeTraversal;
46
+ anchors: ResolvedChangeScopeAnchor[];
47
+ selected: ChangeScopePath[];
48
+ affected: ChangeScopePath[];
49
+ testRoutes: TestRoute[];
50
+ contracts: ContractSurface[];
51
+ decisions: DecisionRecord[];
52
+ reviewers: ReviewSuggestion[];
53
+ architectureFindings: ArchitecturePolicyFinding[];
54
+ evidenceCounts: {
55
+ declared: number;
56
+ observed: number;
57
+ derived: number;
58
+ unresolved: number;
59
+ };
60
+ bounded: {
61
+ truncated: boolean;
62
+ omittedNodes: number;
63
+ };
64
+ diagnostics: ChangeScopeDiagnostic[];
65
+ };
66
+ export type ChangeScopeInput = {
67
+ workspace: string;
68
+ repository: string;
69
+ anchors: readonly ChangeScopeAnchor[];
70
+ direction?: ChangeScopeDirection;
71
+ maxDepth?: number;
72
+ maxNodes?: number;
73
+ /** Explicit assessment time keeps annotation expiry deterministic in Core/browser use. */
74
+ asOf: string;
75
+ };
76
+ /**
77
+ * Expands only explicit path anchors over exact repository import edges. Product meaning is
78
+ * never inferred from anchor names or file text.
79
+ */
80
+ export declare function buildChangeScope(repo: RepoMap, input: ChangeScopeInput): ChangeScopeResult;
81
+ export declare function renderChangeScopeMarkdown(result: ChangeScopeResult): string;