@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.
- package/README.md +51 -1
- package/dist/annotation-store.d.ts +5 -0
- package/dist/annotation-store.js +117 -0
- package/dist/annotation-store.js.map +1 -0
- package/dist/annotations.d.ts +57 -0
- package/dist/annotations.js +221 -0
- package/dist/annotations.js.map +1 -0
- package/dist/architecture-history.d.ts +33 -0
- package/dist/architecture-history.js +234 -0
- package/dist/architecture-history.js.map +1 -0
- package/dist/architecture.d.ts +124 -0
- package/dist/architecture.js +348 -0
- package/dist/architecture.js.map +1 -0
- package/dist/artifacts.d.ts +9 -0
- package/dist/artifacts.js +82 -0
- package/dist/artifacts.js.map +1 -0
- package/dist/ask.d.ts +48 -0
- package/dist/ask.js +182 -0
- package/dist/ask.js.map +1 -0
- package/dist/browser.d.ts +66 -3
- package/dist/browser.js +34 -2
- package/dist/browser.js.map +1 -1
- package/dist/capabilities.d.ts +39 -0
- package/dist/capabilities.js +172 -0
- package/dist/capabilities.js.map +1 -0
- package/dist/capability-history.d.ts +49 -0
- package/dist/capability-history.js +176 -0
- package/dist/capability-history.js.map +1 -0
- package/dist/change-conflicts.d.ts +34 -0
- package/dist/change-conflicts.js +140 -0
- package/dist/change-conflicts.js.map +1 -0
- package/dist/change-scope.d.ts +81 -0
- package/dist/change-scope.js +316 -0
- package/dist/change-scope.js.map +1 -0
- package/dist/characterization.d.ts +61 -0
- package/dist/characterization.js +169 -0
- package/dist/characterization.js.map +1 -0
- package/dist/ci-matrix.d.ts +53 -0
- package/dist/ci-matrix.js +170 -0
- package/dist/ci-matrix.js.map +1 -0
- package/dist/compare.js +2 -2
- package/dist/compare.js.map +1 -1
- package/dist/composer-projects.d.ts +32 -0
- package/dist/composer-projects.js +246 -0
- package/dist/composer-projects.js.map +1 -0
- package/dist/context.d.ts +1 -1
- package/dist/context.js +26 -4
- package/dist/context.js.map +1 -1
- package/dist/contracts.d.ts +75 -0
- package/dist/contracts.js +526 -0
- package/dist/contracts.js.map +1 -0
- package/dist/custom-language-context.d.ts +43 -0
- package/dist/custom-language-context.js +89 -0
- package/dist/custom-language-context.js.map +1 -0
- package/dist/decisions.d.ts +64 -0
- package/dist/decisions.js +338 -0
- package/dist/decisions.js.map +1 -0
- package/dist/dossier.d.ts +63 -0
- package/dist/dossier.js +176 -0
- package/dist/dossier.js.map +1 -0
- package/dist/dotnet-projects.d.ts +26 -0
- package/dist/dotnet-projects.js +171 -0
- package/dist/dotnet-projects.js.map +1 -0
- package/dist/editor-loader.d.ts +9 -0
- package/dist/editor-loader.js +18 -0
- package/dist/editor-loader.js.map +1 -0
- package/dist/editor-protocol.d.ts +35 -0
- package/dist/editor-protocol.js +200 -0
- package/dist/editor-protocol.js.map +1 -0
- package/dist/editor-session.d.ts +15 -0
- package/dist/editor-session.js +27 -0
- package/dist/editor-session.js.map +1 -0
- package/dist/editor-transport.d.ts +10 -0
- package/dist/editor-transport.js +75 -0
- package/dist/editor-transport.js.map +1 -0
- package/dist/enterprise-policy.d.ts +82 -0
- package/dist/enterprise-policy.js +170 -0
- package/dist/enterprise-policy.js.map +1 -0
- package/dist/evidence-bundle.d.ts +13 -0
- package/dist/evidence-bundle.js +105 -0
- package/dist/evidence-bundle.js.map +1 -0
- package/dist/evidence.d.ts +125 -0
- package/dist/evidence.js +252 -0
- package/dist/evidence.js.map +1 -0
- package/dist/explain.js +7 -0
- package/dist/explain.js.map +1 -1
- package/dist/go-projects.d.ts +22 -0
- package/dist/go-projects.js +146 -0
- package/dist/go-projects.js.map +1 -0
- package/dist/graph.js +9 -0
- package/dist/graph.js.map +1 -1
- package/dist/grounding.d.ts +4 -1
- package/dist/grounding.js +70 -13
- package/dist/grounding.js.map +1 -1
- package/dist/identity-graph.d.ts +106 -0
- package/dist/identity-graph.js +353 -0
- package/dist/identity-graph.js.map +1 -0
- package/dist/impact.d.ts +2 -1
- package/dist/impact.js +12 -4
- package/dist/impact.js.map +1 -1
- package/dist/import-graph.d.ts +7 -1
- package/dist/import-graph.js +616 -34
- package/dist/import-graph.js.map +1 -1
- package/dist/incident.d.ts +74 -0
- package/dist/incident.js +212 -0
- package/dist/incident.js.map +1 -0
- package/dist/index.d.ts +91 -4
- package/dist/index.js +47 -3
- package/dist/index.js.map +1 -1
- package/dist/language-adapters.d.ts +33 -0
- package/dist/language-adapters.js +390 -0
- package/dist/language-adapters.js.map +1 -0
- package/dist/language-registry.d.ts +26 -0
- package/dist/language-registry.js +57 -0
- package/dist/language-registry.js.map +1 -0
- package/dist/languages.d.ts +20 -5
- package/dist/languages.js +197 -19
- package/dist/languages.js.map +1 -1
- package/dist/markdown.d.ts +1 -0
- package/dist/markdown.js +7 -1
- package/dist/markdown.js.map +1 -1
- package/dist/migration.d.ts +56 -0
- package/dist/migration.js +154 -0
- package/dist/migration.js.map +1 -0
- package/dist/outcomes.d.ts +57 -0
- package/dist/outcomes.js +146 -0
- package/dist/outcomes.js.map +1 -0
- package/dist/ownership.d.ts +29 -0
- package/dist/ownership.js +189 -0
- package/dist/ownership.js.map +1 -0
- package/dist/plan-alternatives.d.ts +74 -0
- package/dist/plan-alternatives.js +205 -0
- package/dist/plan-alternatives.js.map +1 -0
- package/dist/plan.d.ts +7 -0
- package/dist/plan.js +41 -8
- package/dist/plan.js.map +1 -1
- package/dist/rank.d.ts +64 -1
- package/dist/rank.js +278 -26
- package/dist/rank.js.map +1 -1
- package/dist/repo-scan.d.ts +8 -1
- package/dist/repo-scan.js +341 -97
- package/dist/repo-scan.js.map +1 -1
- package/dist/report.d.ts +16 -0
- package/dist/report.js +298 -33
- package/dist/report.js.map +1 -1
- package/dist/retrieval.d.ts +37 -0
- package/dist/retrieval.js +150 -21
- package/dist/retrieval.js.map +1 -1
- package/dist/reverse-docs.d.ts +46 -0
- package/dist/reverse-docs.js +179 -0
- package/dist/reverse-docs.js.map +1 -0
- package/dist/ruby-projects.d.ts +20 -0
- package/dist/ruby-projects.js +114 -0
- package/dist/ruby-projects.js.map +1 -0
- package/dist/runtime-evidence.d.ts +90 -0
- package/dist/runtime-evidence.js +186 -0
- package/dist/runtime-evidence.js.map +1 -0
- package/dist/rust-projects.d.ts +17 -0
- package/dist/rust-projects.js +125 -0
- package/dist/rust-projects.js.map +1 -0
- package/dist/sandbox.d.ts +59 -0
- package/dist/sandbox.js +202 -0
- package/dist/sandbox.js.map +1 -0
- package/dist/semantic-cache.d.ts +8 -0
- package/dist/semantic-cache.js +149 -0
- package/dist/semantic-cache.js.map +1 -0
- package/dist/semantic.d.ts +78 -0
- package/dist/semantic.js +237 -0
- package/dist/semantic.js.map +1 -0
- package/dist/sensitive-data.d.ts +8 -0
- package/dist/sensitive-data.js +157 -0
- package/dist/sensitive-data.js.map +1 -0
- package/dist/signals.js +1 -1
- package/dist/signals.js.map +1 -1
- package/dist/supply-chain.d.ts +38 -0
- package/dist/supply-chain.js +206 -0
- package/dist/supply-chain.js.map +1 -0
- package/dist/test-reliability.d.ts +56 -0
- package/dist/test-reliability.js +191 -0
- package/dist/test-reliability.js.map +1 -0
- package/dist/text.js +8 -1
- package/dist/text.js.map +1 -1
- package/dist/transformers-embedding.d.ts +16 -0
- package/dist/transformers-embedding.js +127 -0
- package/dist/transformers-embedding.js.map +1 -0
- package/dist/types.d.ts +79 -2
- package/dist/validate.js +172 -0
- package/dist/validate.js.map +1 -1
- package/dist/verify.js +136 -2
- package/dist/verify.js.map +1 -1
- package/dist/workspace.d.ts +86 -0
- package/dist/workspace.js +557 -0
- package/dist/workspace.js.map +1 -0
- 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;
|