@appport/integration 0.0.0-stage → 1.1.0

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 (95) hide show
  1. package/LICENSE +126 -0
  2. package/README.md +34 -2
  3. package/dist/base64url.d.ts +4 -0
  4. package/dist/base64url.d.ts.map +1 -0
  5. package/dist/base64url.js +36 -0
  6. package/dist/base64url.js.map +1 -0
  7. package/dist/behavior.d.ts +164 -0
  8. package/dist/behavior.d.ts.map +1 -0
  9. package/dist/behavior.js +493 -0
  10. package/dist/behavior.js.map +1 -0
  11. package/dist/coverage.d.ts +44 -0
  12. package/dist/coverage.d.ts.map +1 -0
  13. package/dist/coverage.js +43 -0
  14. package/dist/coverage.js.map +1 -0
  15. package/dist/declarations.d.ts +53 -0
  16. package/dist/declarations.d.ts.map +1 -0
  17. package/dist/declarations.js +45 -0
  18. package/dist/declarations.js.map +1 -0
  19. package/dist/ed25519.d.ts +8 -0
  20. package/dist/ed25519.d.ts.map +1 -0
  21. package/dist/ed25519.js +128 -0
  22. package/dist/ed25519.js.map +1 -0
  23. package/dist/encodings.d.ts +9 -0
  24. package/dist/encodings.d.ts.map +1 -0
  25. package/dist/encodings.js +75 -0
  26. package/dist/encodings.js.map +1 -0
  27. package/dist/fields.d.ts +29 -0
  28. package/dist/fields.d.ts.map +1 -0
  29. package/dist/fields.js +76 -0
  30. package/dist/fields.js.map +1 -0
  31. package/dist/findings.d.ts +189 -0
  32. package/dist/findings.d.ts.map +1 -0
  33. package/dist/findings.js +195 -0
  34. package/dist/findings.js.map +1 -0
  35. package/dist/footprint.d.ts +67 -0
  36. package/dist/footprint.d.ts.map +1 -0
  37. package/dist/footprint.js +78 -0
  38. package/dist/footprint.js.map +1 -0
  39. package/dist/graph.d.ts +111 -0
  40. package/dist/graph.d.ts.map +1 -0
  41. package/dist/graph.js +390 -0
  42. package/dist/graph.js.map +1 -0
  43. package/dist/index.d.ts +38 -0
  44. package/dist/index.d.ts.map +1 -0
  45. package/dist/index.js +38 -0
  46. package/dist/index.js.map +1 -0
  47. package/dist/lint.d.ts +35 -0
  48. package/dist/lint.d.ts.map +1 -0
  49. package/dist/lint.js +260 -0
  50. package/dist/lint.js.map +1 -0
  51. package/dist/mapping.d.ts +28 -0
  52. package/dist/mapping.d.ts.map +1 -0
  53. package/dist/mapping.js +282 -0
  54. package/dist/mapping.js.map +1 -0
  55. package/dist/normalize.d.ts +27 -0
  56. package/dist/normalize.d.ts.map +1 -0
  57. package/dist/normalize.js +56 -0
  58. package/dist/normalize.js.map +1 -0
  59. package/dist/plan.d.ts +240 -0
  60. package/dist/plan.d.ts.map +1 -0
  61. package/dist/plan.js +746 -0
  62. package/dist/plan.js.map +1 -0
  63. package/dist/readiness.d.ts +146 -0
  64. package/dist/readiness.d.ts.map +1 -0
  65. package/dist/readiness.js +346 -0
  66. package/dist/readiness.js.map +1 -0
  67. package/dist/reference.d.ts +39 -0
  68. package/dist/reference.d.ts.map +1 -0
  69. package/dist/reference.js +74 -0
  70. package/dist/reference.js.map +1 -0
  71. package/dist/scenario.d.ts +114 -0
  72. package/dist/scenario.d.ts.map +1 -0
  73. package/dist/scenario.js +117 -0
  74. package/dist/scenario.js.map +1 -0
  75. package/dist/select.d.ts +41 -0
  76. package/dist/select.d.ts.map +1 -0
  77. package/dist/select.js +71 -0
  78. package/dist/select.js.map +1 -0
  79. package/dist/trust.d.ts +237 -0
  80. package/dist/trust.d.ts.map +1 -0
  81. package/dist/trust.js +511 -0
  82. package/dist/trust.js.map +1 -0
  83. package/dist/types.d.ts +130 -0
  84. package/dist/types.d.ts.map +1 -0
  85. package/dist/types.js +19 -0
  86. package/dist/types.js.map +1 -0
  87. package/dist/units.d.ts +20 -0
  88. package/dist/units.d.ts.map +1 -0
  89. package/dist/units.js +47 -0
  90. package/dist/units.js.map +1 -0
  91. package/dist/verification.d.ts +54 -0
  92. package/dist/verification.d.ts.map +1 -0
  93. package/dist/verification.js +115 -0
  94. package/dist/verification.js.map +1 -0
  95. package/package.json +28 -4
@@ -0,0 +1,346 @@
1
+ import { compareManifests, getIntegration, integrationKey } from "@appport/protocol";
2
+ import { edgesOf, nodeId } from "./graph.js";
3
+ const LIMITS = [
4
+ "This is a readiness assessment, not an approval. Nothing here authorizes replacing a capability.",
5
+ "Matching schemas do not establish equivalent behaviour: business rules, ordering, timing, failure modes and data are not in the contract.",
6
+ "A shared resource identifier is a claim. Nothing establishes that the replacement uses, or may use, the same underlying state, and migrating data is out of scope.",
7
+ "Consumers, dependencies and state access are known only from the supplied manifests and findings; see the graph's boundary and its unknowns.",
8
+ "Evidence marked inferred or observed comes from tools outside the contract and is only as complete as those tools.",
9
+ "`no-known-blockers` is not attainable with the current evidence model: every behavioural report carries mandatory blind spots, and consumer-contract, mapping-vector and concurrency tests have no behavioural evidence that can demonstrate them. The best status is `unknowns-remain`; `unresolved` lists what is outstanding."
10
+ ];
11
+ const keyOf = (name, version) => integrationKey(name, version);
12
+ /** Published-contract breaks that mean "the replacement does not say it still does this", not "it no longer does". */
13
+ const DECLARATION_LOSS = ["integration.authority-removed", "integration.access-changes-removed", "integration.verify-removed", "integration.coverage-weakened", "integration.resource-removed"];
14
+ /** Published-contract breaks that mean "the replacement does more than was declared". They need review, not a veto. */
15
+ const FOOTPRINT_GROWTH = ["integration.access-changes-added", "integration.requires-added", "integration.requires-tightened", "integration.requires-changed", "integration.requires-version-changed"];
16
+ /** Restricts a manifest to one capability version and what is directly about it, so two implementations compare like for like. */
17
+ function restrict(manifest, ref, renameTo) {
18
+ const [name, versionText] = ref.split("@");
19
+ const version = Number(versionText);
20
+ const target = renameTo ?? ref;
21
+ const [targetName, targetVersion] = [target.split("@")[0], Number(target.split("@")[1])];
22
+ const entries = manifest.capabilities
23
+ .filter((c) => c.name === name)
24
+ .map((c) => ({ ...c, name: targetName, versions: [targetVersion], latestVersion: targetVersion, definitions: c.definitions.filter((d) => d.version === version).map((d) => ({ ...d, version: targetVersion })) }))
25
+ .filter((c) => c.definitions.length > 0);
26
+ const emitted = new Set(entries.flatMap((c) => c.definitions.flatMap((d) => d.emits ?? [])));
27
+ const descriptor = getIntegration(manifest);
28
+ const entry = descriptor?.capabilities[ref];
29
+ const resources = new Set((entry?.access ?? []).map((a) => a.resource));
30
+ const attributes = entry
31
+ ? { "appport.integration/1": {
32
+ capabilities: { [target]: entry },
33
+ ...(descriptor?.resources?.length ? { resources: descriptor.resources.filter((r) => resources.has(r.id)) } : {}),
34
+ ...(descriptor?.mappings?.length ? { mappings: descriptor.mappings.filter((m) => m.for === ref).map((m) => ({ ...m, for: target })) } : {})
35
+ } }
36
+ : undefined;
37
+ return {
38
+ ...manifest,
39
+ capabilities: entries,
40
+ events: manifest.events.filter((e) => emitted.has(e.name)),
41
+ ...(attributes ? { attributes: attributes, extensions: ["appport.integration/1"] } : { attributes: undefined, extensions: undefined })
42
+ };
43
+ }
44
+ function describeEffects(manifest, ref) {
45
+ const [name, version] = [ref.split("@")[0], Number(ref.split("@")[1])];
46
+ const definition = manifest.capabilities.find((c) => c.name === name)?.definitions.find((d) => d.version === version);
47
+ if (!definition)
48
+ return [];
49
+ const entry = getIntegration(manifest)?.capabilities[ref];
50
+ return [
51
+ ...(definition.effect ? [`effect:${definition.effect}`] : []),
52
+ ...(entry?.effects ?? []).map((e) => `declared-effect:${e.type}`),
53
+ ...(entry?.access ?? []).filter((a) => a.mode === "changes").map((a) => `changes:${a.resource}`),
54
+ ...(definition.emits ?? []).map((e) => `emits:${e}`),
55
+ ...(definition.idempotency ? [`idempotency:${definition.idempotency}`] : [])
56
+ ].sort();
57
+ }
58
+ export function assessReplacement(input) {
59
+ const { graph, current, subject } = input;
60
+ const proposedRef = input.proposed.capability ?? subject;
61
+ const application = current.application.id;
62
+ const subjectNode = nodeId.capability(application, subject);
63
+ const [subjectName, subjectVersion] = [subject.split("@")[0], Number(subject.split("@")[1])];
64
+ const currentDefinition = current.capabilities.find((c) => c.name === subjectName)?.definitions.find((d) => d.version === subjectVersion);
65
+ if (!currentDefinition)
66
+ throw new Error(`${subject} is not declared by ${application}`);
67
+ const proposedName = proposedRef.split("@")[0];
68
+ if (proposedName !== subjectName)
69
+ throw new Error(`a replacement must keep the capability name (${subjectName}); got ${proposedName}`);
70
+ const proposedManifest = input.proposed.manifest;
71
+ const proposedExists = proposedManifest.capabilities.some((c) => c.name === proposedName && c.definitions.some((d) => d.version === Number(proposedRef.split("@")[1])));
72
+ const reasons = [];
73
+ const blockers = [];
74
+ const attention = [];
75
+ // --- contract compatibility -------------------------------------------------------------
76
+ const before = restrict(current, subject);
77
+ const after = proposedExists ? restrict(proposedManifest, proposedRef, subject) : { ...before, capabilities: [], events: [], attributes: undefined, extensions: undefined };
78
+ const report = compareManifests(before, after);
79
+ if (!proposedExists)
80
+ blockers.push(`the proposed manifest does not declare ${proposedRef}`);
81
+ const proposedEntryEarly = proposedExists ? getIntegration(proposedManifest)?.capabilities[proposedRef] : undefined;
82
+ const claimsCompleteAccess = proposedEntryEarly?.coverage?.access === "complete";
83
+ const incompatibilities = [];
84
+ const declarationGaps = [];
85
+ const growth = [];
86
+ for (const change of report.breaking) {
87
+ if (DECLARATION_LOSS.includes(change.kind)) {
88
+ // A replacement that says it declares all its state access, and omits a change, is saying it does not make it.
89
+ if (change.kind === "integration.access-changes-removed" && claimsCompleteAccess) {
90
+ incompatibilities.push(change);
91
+ blockers.push(`incompatible: ${change.kind}: ${change.message}, and the replacement claims its access is complete`);
92
+ }
93
+ else
94
+ declarationGaps.push(change);
95
+ }
96
+ else if (FOOTPRINT_GROWTH.includes(change.kind))
97
+ growth.push(change);
98
+ else {
99
+ incompatibilities.push(change);
100
+ blockers.push(`incompatible: ${change.kind} ${change.target}: ${change.message}`);
101
+ }
102
+ }
103
+ for (const change of declarationGaps) {
104
+ if (change.kind !== "integration.verify-removed")
105
+ attention.push(`not carried by the replacement: ${change.message}. It may preserve this, but it does not say so`);
106
+ }
107
+ for (const change of growth)
108
+ attention.push(`the replacement's footprint grows: ${change.message}`);
109
+ // --- who is affected --------------------------------------------------------------------
110
+ const consumers = [];
111
+ const nodeLabel = (id) => graph.nodes.find((n) => n.id === id)?.label ?? id;
112
+ const push = (kind, edge, other, direction) => consumers.push({
113
+ node: other, label: nodeLabel(other), relationship: kind, provenance: edge.provenance,
114
+ ...(edge.required !== undefined ? { required: edge.required } : {}),
115
+ resolved: graph.nodes.find((n) => n.id === other)?.resolved ?? false,
116
+ ...(direction ? { direction } : {}), edge: edge.id
117
+ });
118
+ for (const edge of edgesOf(graph, subjectNode, "in", ["invokes", "observes", "delegates", "verified-by"]))
119
+ push(edge.kind, edge, edge.from);
120
+ for (const emit of edgesOf(graph, subjectNode, "out", ["emits"]))
121
+ for (const edge of edgesOf(graph, emit.to, "in", ["consumes-event"]))
122
+ push("consumes-event", edge, edge.from);
123
+ for (const edge of edgesOf(graph, subjectNode, "out", ["data-flow"]))
124
+ push("data-flow", edge, edge.to, "downstream");
125
+ for (const edge of edgesOf(graph, subjectNode, "in", ["data-flow"]))
126
+ push("data-flow", edge, edge.from, "upstream");
127
+ // --- effects ------------------------------------------------------------------------------
128
+ const currentEffects = describeEffects(current, subject);
129
+ const proposedEffects = proposedExists ? describeEffects(proposedManifest, proposedRef) : [];
130
+ const added = proposedEffects.filter((e) => !currentEffects.includes(e));
131
+ const removed = currentEffects.filter((e) => !proposedEffects.includes(e));
132
+ for (const effect of removed) {
133
+ if (!proposedExists || effect.startsWith("changes:") || effect.startsWith("declared-effect:"))
134
+ continue; // reported as declaration gaps
135
+ if (!incompatibilities.some((c) => c.kind.includes(effect.split(":")[0].replace("emits", "emit"))))
136
+ blockers.push(`the replacement no longer provides ${effect.replace(":", " ")}: consumers may rely on it`);
137
+ }
138
+ for (const effect of added)
139
+ if (!effect.startsWith("changes:"))
140
+ attention.push(`the replacement adds ${effect.replace(":", " ")}, which no consumer was told to expect`);
141
+ // --- shared state ---------------------------------------------------------------------------
142
+ const currentEntry = getIntegration(current)?.capabilities[subject];
143
+ const proposedEntry = proposedExists ? getIntegration(proposedManifest)?.capabilities[proposedRef] : undefined;
144
+ const resources = new Set([
145
+ ...(currentEntry?.access ?? []).map((a) => a.resource),
146
+ ...(proposedEntry?.access ?? []).map((a) => a.resource),
147
+ ...edgesOf(graph, subjectNode, "out", ["reads", "changes"]).map((e) => e.to.slice(4))
148
+ ]);
149
+ const sharedState = [...resources].sort().map((resource) => {
150
+ const node = nodeId.resource(resource);
151
+ const cur = { declared: [], inferred: [], observed: [] };
152
+ for (const edge of edgesOf(graph, subjectNode, "out", ["reads", "changes"]).filter((e) => e.to === node))
153
+ for (const p of edge.provenance)
154
+ cur[p].push(edge.kind);
155
+ for (const p of Object.keys(cur))
156
+ cur[p] = [...new Set(cur[p])].sort();
157
+ const proposedModes = [...new Set((proposedEntry?.access ?? []).filter((a) => a.resource === resource).map((a) => a.mode))].sort();
158
+ const others = edgesOf(graph, node, "in", ["reads", "changes"]).filter((e) => e.from !== subjectNode).map((e) => ({ node: e.from, kind: e.kind, provenance: e.provenance }));
159
+ const relation = graph.resourceRelations.find((r) => r.resource === resource);
160
+ const notes = [];
161
+ const evidenced = [...new Set([...cur.inferred, ...cur.observed])];
162
+ for (const mode of evidenced)
163
+ if (!proposedModes.includes(mode))
164
+ notes.push(`analysis or observation shows the current implementation ${mode} this resource; the replacement does not declare it`);
165
+ const strangers = others.filter((o) => o.kind === "changes" && (!o.provenance.includes("declared") || !o.node.startsWith(`cap:${application}:`)));
166
+ if (strangers.length)
167
+ attention.push(`${resource} is also changed by ${strangers.map((o) => `${o.node} (${o.provenance.join("+")})`).join(", ")}, which this replacement does not replace`);
168
+ if (others.some((o) => o.kind === "changes"))
169
+ notes.push(`other writers change this resource (${others.filter((o) => o.kind === "changes").map((o) => o.node).join(", ")}); replacing this capability does not replace them, and ordering and ownership must hold`);
170
+ if (relation?.ownership === "conflicting-owners")
171
+ notes.push("ownership of this resource is claimed inconsistently");
172
+ if (relation?.ownership === "no-owner")
173
+ notes.push("no application declares itself the system of record");
174
+ if (relation && relation.semantics !== "same-concept")
175
+ notes.push(`applications referencing this id do not all state the same meaning (${relation.semantics})`);
176
+ notes.push("a shared identifier is a claim: it does not show the replacement uses the same underlying state");
177
+ if (evidenced.some((m) => m === "changes") && !proposedModes.includes("changes"))
178
+ attention.push(`undeclared state change to ${resource} is evidenced for the current implementation`);
179
+ return { resource, current: cur, proposed: proposedModes, otherAccessors: others, ...(relation ? { relation } : {}), notes };
180
+ });
181
+ // --- verification -------------------------------------------------------------------------
182
+ const stateIds = (entry) => (entry?.verify ?? []).filter((m) => m.kind === "state").map((m) => m.id);
183
+ const currentStates = stateIds(currentEntry);
184
+ const proposedStates = stateIds(proposedEntry);
185
+ const missing = currentStates.filter((id) => !proposedStates.includes(id)).map((id) => `method ${id} is not declared by the replacement`);
186
+ const proposedDefinition = proposedManifest.capabilities.find((c) => c.name === proposedName)?.definitions.find((d) => d.version === Number(proposedRef.split("@")[1]));
187
+ if (proposedExists && proposedDefinition?.effect === "consequential" && proposedStates.length === 0)
188
+ missing.push("the replacement is consequential and declares no state verification");
189
+ for (const m of missing)
190
+ attention.push(m);
191
+ const dependents = edgesOf(graph, subjectNode, "in", ["verified-by"]).map((e) => e.from);
192
+ // --- unknowns and risks that touch the subject ----------------------------------------------
193
+ const touches = (id, edges) => id === subjectNode || id === nodeId.application(application) || (edges ?? []).some((e) => e.includes(subjectNode));
194
+ const investigations = graph.unknowns.filter((u) => u.kind !== "consumers-open" && (touches(u.subject, u.edges) || ((u.kind === "unattributed-dependency" || u.kind === "observation-limited" || u.kind === "observation-unstated") && u.subject === nodeId.application(application))));
195
+ const resourceNodes = new Set([...resources].map((r) => nodeId.resource(r)));
196
+ const risks = graph.risks.filter((r) => touches(r.subject, r.edges) || (r.edges ?? []).some((id) => resourceNodes.has(id.split("|")[2] ?? "")));
197
+ for (const risk of risks)
198
+ attention.push(risk.message);
199
+ const proposedCoverage = proposedEntry?.coverage;
200
+ const proposedUnknowns = proposedExists
201
+ ? ["requires", "access"].filter((d) => proposedCoverage?.[d] !== "complete").map((d) => ({
202
+ id: `proposed-coverage|${proposedRef}|${d}`,
203
+ kind: (proposedCoverage?.[d] === "partial" ? "coverage-partial" : "coverage-unstated"),
204
+ subject: nodeId.capability(proposedManifest.application.id, proposedRef),
205
+ message: `the replacement ${proposedCoverage?.[d] === "partial" ? "declares" : "does not state whether it declares"} its ${d === "requires" ? "dependencies" : "state access"} ${proposedCoverage?.[d] === "partial" ? "as partial" : "completely"}`
206
+ }))
207
+ : [];
208
+ // --- tests that follow from the evidence ------------------------------------------------
209
+ const tests = [
210
+ { id: "contract-equivalence", kind: "contract-equivalence", description: `Replay representative and recorded requests against both implementations of ${subject} and compare outputs, errors and effects; matching schemas are not enough.`, derivedFrom: ["contract"] }
211
+ ];
212
+ const seenConsumer = new Set();
213
+ for (const c of consumers) {
214
+ const key = `${c.relationship}|${c.node}`;
215
+ if (seenConsumer.has(key))
216
+ continue;
217
+ seenConsumer.add(key);
218
+ if (c.relationship === "data-flow")
219
+ tests.push({ id: `mapping-vectors|${c.edge}`, kind: "mapping-vectors", description: `Re-run lint and vectors of the mapping on this edge (${c.direction}: ${c.label}) against the replacement's published schemas.`, derivedFrom: [c.edge] });
220
+ else
221
+ tests.push({ id: `consumer|${key}`, kind: "consumer-contract", description: `Exercise the replacement through ${c.label} (${c.relationship}${c.required ? ", required" : ""}; ${c.provenance.join("+")}).`, derivedFrom: [c.edge] });
222
+ }
223
+ for (const id of currentStates)
224
+ tests.push({ id: `verification|${id}`, kind: "verification", description: `Declared verification method ${id} must pass against the replacement.`, derivedFrom: ["contract"] });
225
+ for (const row of sharedState) {
226
+ const changes = row.current.declared.includes("changes") || row.current.inferred.includes("changes") || row.current.observed.includes("changes") || row.proposed.includes("changes");
227
+ if (changes)
228
+ tests.push({ id: `state-effect|${row.resource}`, kind: "state-effect", description: `The replacement must make the same change to ${row.resource}; check through a reader${row.otherAccessors.some((o) => o.kind === "reads") ? ` (${row.otherAccessors.filter((o) => o.kind === "reads").map((o) => o.node).join(", ")})` : " (none is declared: a reader must be identified first)"}.`, derivedFrom: edgesOf(graph, subjectNode, "out", ["changes"]).filter((e) => e.to === nodeId.resource(row.resource)).map((e) => e.id) });
229
+ for (const other of row.otherAccessors.filter((o) => o.kind === "changes"))
230
+ tests.push({ id: `concurrency|${row.resource}|${other.node}`, kind: "concurrency-with-other-writers", description: `Exercise ${subject} and ${other.node} against ${row.resource} together; both change it.`, derivedFrom: [] });
231
+ }
232
+ for (const emit of edgesOf(graph, subjectNode, "out", ["emits"]))
233
+ tests.push({ id: `event|${emit.to}`, kind: "event-emission", description: `The replacement must emit ${nodeLabel(emit.to)} in the same circumstances (delivery is at most once).`, derivedFrom: [emit.id] });
234
+ if (currentDefinition.authorization.length)
235
+ tests.push({ id: "authorization", kind: "authorization", description: `Callers lacking ${currentDefinition.authorization.join(", ")} must still be refused, and with the same error codes.`, derivedFrom: ["contract"] });
236
+ if (currentDefinition.idempotency === "supported")
237
+ tests.push({ id: "idempotency", kind: "idempotency", description: "Identical retries must replay; a reused key with a different request must conflict.", derivedFrom: ["contract"] });
238
+ // --- behavioural evidence ---------------------------------------------------------------
239
+ let behavior;
240
+ if (input.behavior?.length) {
241
+ const reports = input.behavior.filter((r) => r.capability === subject);
242
+ const worst = (outcomes) => ["behavior-mismatch", "not-comparable", "unverified", "inconclusive", "equivalent-for-tested-scenarios"].find((o) => outcomes.includes(o)) ?? "inconclusive";
243
+ const scenarios = reports.flatMap((r) => r.scenarios);
244
+ const ids = (o) => scenarios.filter((x) => x.outcome === o).map((x) => x.id).sort();
245
+ const tagOutcome = (tag) => {
246
+ const attempted = scenarios.filter((x) => x.attempted.includes(tag) || x.tags.includes(tag));
247
+ const by = (o) => attempted.filter((x) => x.outcome === o).map((x) => x.id).sort();
248
+ if (attempted.some((x) => x.tags.includes(tag)))
249
+ return { status: "passed-for-tested-scenarios", scenarios: attempted.filter((x) => x.tags.includes(tag)).map((x) => x.id).sort() };
250
+ if (by("behavior-mismatch").length)
251
+ return { status: "failed", scenarios: by("behavior-mismatch") };
252
+ if (by("unverified").length)
253
+ return { status: "unverified", scenarios: by("unverified") };
254
+ if (by("inconclusive").length)
255
+ return { status: "inconclusive", scenarios: by("inconclusive") };
256
+ return { status: "not-run", scenarios: [] };
257
+ };
258
+ const results = tests.map((t) => {
259
+ const base = { id: t.id, kind: t.kind };
260
+ const overall = worst(reports.map((r) => r.outcome));
261
+ if (t.kind === "contract-equivalence")
262
+ return { ...base, status: reports.length === 0 ? "not-run" : overall === "equivalent-for-tested-scenarios" ? "passed-for-tested-scenarios" : overall === "behavior-mismatch" ? "failed" : overall === "unverified" ? "unverified" : "inconclusive", scenarios: scenarios.map((x) => x.id).sort() };
263
+ const tag = t.kind === "verification" ? `verify:${t.id.split("|")[1]}` : t.kind === "state-effect" ? `state:${t.id.split("|")[1]}` : t.kind === "event-emission" ? `event:${(t.id.split("|")[1] ?? "").split(":").slice(2).join(":")}` : t.kind === "idempotency" ? "idempotent-replay" : t.kind === "authorization" ? "authorization-refused" : undefined;
264
+ if (!tag)
265
+ return { ...base, status: "not-run", scenarios: [] };
266
+ return { ...base, ...tagOutcome(tag) };
267
+ });
268
+ const edgeOut = edgesOf(graph, subjectNode, "out", ["invokes", "observes", "delegates"]).filter((e) => e.provenance.includes("declared"));
269
+ const exercisedSet = new Set(reports.flatMap((r) => r.exercised.invocations));
270
+ const known = reports.length > 0 && reports.every((r) => r.exercised.known);
271
+ const dependencies = edgeOut.map((e) => {
272
+ const target = e.to.replace(/^cap:/, "").replace(":", "/");
273
+ return { edge: e.id, target, exercised: !known ? "unknown" : exercisedSet.has(target) ? "yes" : "no" };
274
+ });
275
+ const outcome = reports.length ? worst(reports.map((r) => r.outcome)) : "not-run";
276
+ const missing = [...new Set(reports.flatMap((r) => r.coverage.missing))].sort();
277
+ const unverifiedEffects = [...new Set([...missing.filter((m) => /^(state|event|verify):/.test(m)), ...reports.flatMap((r) => r.reasons.filter((x) => x.code === "facet.unverified").map((x) => `${x.scenario}:${x.facet}`))])].sort();
278
+ behavior = {
279
+ outcome,
280
+ scenarios: { passed: ids("equivalent-for-tested-scenarios"), mismatched: ids("behavior-mismatch"), unverified: ids("unverified"), inconclusive: ids("inconclusive"), notComparable: ids("not-comparable") },
281
+ requiredTests: results,
282
+ coverageMissing: missing,
283
+ unverifiedEffects,
284
+ dependencies,
285
+ instrumentation: reports[0]?.candidate.instrumentation ?? { invocationBoundary: false, stateBoundary: false, events: false },
286
+ blindSpots: [...new Set(reports.flatMap((r) => r.blindSpots))].sort(),
287
+ additionalWork: [
288
+ ...missing.map((m) => `add a scenario that demonstrates ${m}`),
289
+ ...results.filter((t) => t.status === "not-run").map((t) => `no behavioural scenario covers required test ${t.id}`),
290
+ ...dependencies.filter((d) => d.exercised !== "yes").map((d) => `${d.exercised === "no" ? "no scenario exercised" : "could not tell whether scenarios exercised"} the dependency ${d.target}`),
291
+ ...(reports.length === 0 ? [`no behavioural report for ${subject} was supplied`] : [])
292
+ ].sort()
293
+ };
294
+ if (outcome === "behavior-mismatch")
295
+ blockers.push(`behavioural comparison found a mismatch in: ${behavior.scenarios.mismatched.join(", ")}`);
296
+ else if (outcome !== "equivalent-for-tested-scenarios")
297
+ attention.push(`behavioural evidence is ${outcome}: ${[...behavior.scenarios.unverified, ...behavior.scenarios.inconclusive, ...behavior.scenarios.notComparable, ...missing.map((m) => `missing ${m}`)].join(", ") || "see the report"}`);
298
+ }
299
+ // --- status ---------------------------------------------------------------------------------
300
+ const allUnknowns = [...investigations, ...proposedUnknowns];
301
+ // A required test that no evidence demonstrated is an unresolved requirement, whether or not a behavioural report exists: less evidence never ranks above more.
302
+ const outstandingTests = (behavior ? behavior.requiredTests.filter((t) => t.status !== "passed-for-tested-scenarios") : tests).map((t) => t.id).sort();
303
+ const unresolved = { requiredTests: outstandingTests, coverage: behavior ? [...behavior.coverageMissing] : [] };
304
+ let status;
305
+ if (blockers.length)
306
+ status = "blocked";
307
+ else if (attention.length || report.nonBreaking.some((c) => !c.kind.startsWith("description") && !c.kind.endsWith("purpose-changed")))
308
+ status = "needs-attention";
309
+ else if (allUnknowns.length || behavior?.blindSpots.length || outstandingTests.length || unresolved.coverage.length)
310
+ status = "unknowns-remain";
311
+ else
312
+ status = "no-known-blockers";
313
+ reasons.push(...blockers, ...attention);
314
+ if (allUnknowns.length)
315
+ reasons.push(`${allUnknowns.length} unknown${allUnknowns.length === 1 ? "" : "s"} about the dependency picture remain`);
316
+ if (behavior?.blindSpots.length)
317
+ reasons.push(`behavioural evidence covers the tested scenarios only; ${behavior.blindSpots.length} blind spot${behavior.blindSpots.length === 1 ? "" : "s"} remain`);
318
+ if (outstandingTests.length)
319
+ reasons.push(`${outstandingTests.length} required test${outstandingTests.length === 1 ? "" : "s"} ${behavior ? "not demonstrated by the behavioural evidence" : "not run (no behavioural evidence supplied)"}`);
320
+ if (unresolved.coverage.length)
321
+ reasons.push(`scenario coverage missing: ${unresolved.coverage.join(", ")}`);
322
+ if (!reasons.length)
323
+ reasons.push("no blocker, difference or unknown is evidenced in the supplied material; see limits");
324
+ return {
325
+ type: "appport.replacement-readiness/1",
326
+ subject: { application, capability: subject },
327
+ proposed: { application: proposedManifest.application.id, capability: proposedRef },
328
+ status,
329
+ reasons,
330
+ affectedConsumers: consumers,
331
+ incompatibilities,
332
+ declarationGaps,
333
+ differences: [...report.nonBreaking, ...growth],
334
+ effects: { current: currentEffects, proposed: proposedEffects, added, removed },
335
+ sharedState,
336
+ verification: { current: currentStates, proposed: proposedStates, missing, dependents },
337
+ requiredTests: tests,
338
+ unresolved,
339
+ ...(behavior ? { behavior } : {}),
340
+ investigations: allUnknowns,
341
+ risks,
342
+ limits: [...LIMITS]
343
+ };
344
+ }
345
+ export { keyOf as capabilityKey };
346
+ //# sourceMappingURL=readiness.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"readiness.js","sourceRoot":"","sources":["../src/readiness.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,39 @@
1
+ import { type MappingReference } from "@appport/protocol";
2
+ import { type MappingArtifact } from "./types.js";
3
+ /**
4
+ * Accepts artifact bytes only if they are exactly what the reference promised:
5
+ * the same digest, the same identity. A reference's `uri` values are hints and
6
+ * carry no trust; the digest is the only thing that does.
7
+ */
8
+ export declare function verifyMappingArtifact(reference: MappingReference, artifact: unknown): MappingArtifact;
9
+ /**
10
+ * Records which digest each `(id, version)` has ever been seen with. Persist it
11
+ * to make immutability binding across runs: an identity that later appears with a
12
+ * different digest is a publisher error or an attack, never an update.
13
+ */
14
+ export declare class MappingPins {
15
+ #private;
16
+ constructor(initial?: Iterable<[string, string]>);
17
+ pin(reference: Pick<MappingReference, "id" | "version" | "digest">): void;
18
+ /**
19
+ * Whether an identity and digest agree with what is pinned, without recording anything. A pin protects
20
+ * identity-to-digest consistency only; it says nothing about who published the bytes.
21
+ */
22
+ check(reference: Pick<MappingReference, "id" | "version" | "digest">): {
23
+ status: "new";
24
+ } | {
25
+ status: "consistent";
26
+ } | {
27
+ status: "conflict";
28
+ pinned: string;
29
+ };
30
+ entries(): Array<[string, string]>;
31
+ }
32
+ /**
33
+ * Obtains and verifies the artifact a reference points to: the embedded artifact
34
+ * if present, otherwise the first location that yields bytes with the right
35
+ * digest. The fetcher is supplied by the caller (HTTP, file, an artifact store),
36
+ * so this package has no I/O and no registry.
37
+ */
38
+ export declare function resolveMapping(reference: MappingReference, fetcher: (uri: string) => Promise<unknown>, pins?: MappingPins): Promise<MappingArtifact>;
39
+ //# sourceMappingURL=reference.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reference.d.ts","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEhG,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,GAAG,eAAe,CAUrG;AAED;;;;GAIG;AACH,qBAAa,WAAW;;gBAGV,OAAO,GAAE,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM;IAIpD,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,SAAS,GAAG,QAAQ,CAAC,GAAG,IAAI;IASzE;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,SAAS,GAAG,QAAQ,CAAC,GAAG;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,YAAY,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAM5J,OAAO,IAAI,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAGnC;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EAC1C,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,eAAe,CAAC,CAY1B"}
@@ -0,0 +1,74 @@
1
+ import { digestOf, mappingKey } from "@appport/protocol";
2
+ import { parseMapping } from "./mapping.js";
3
+ import { MappingError } from "./types.js";
4
+ /**
5
+ * Accepts artifact bytes only if they are exactly what the reference promised:
6
+ * the same digest, the same identity. A reference's `uri` values are hints and
7
+ * carry no trust; the digest is the only thing that does.
8
+ */
9
+ export function verifyMappingArtifact(reference, artifact) {
10
+ const actual = digestOf(artifact);
11
+ if (actual !== reference.digest) {
12
+ throw new MappingError("DIGEST_MISMATCH", `artifact for ${mappingKey(reference)} hashes to ${actual}, not the referenced ${reference.digest}`);
13
+ }
14
+ const mapping = parseMapping(artifact);
15
+ if (mapping.id !== reference.id || mapping.version !== reference.version) {
16
+ throw new MappingError("IDENTITY_MISMATCH", `artifact declares ${mapping.id}@${mapping.version}, the reference names ${mappingKey(reference)}`);
17
+ }
18
+ return mapping;
19
+ }
20
+ /**
21
+ * Records which digest each `(id, version)` has ever been seen with. Persist it
22
+ * to make immutability binding across runs: an identity that later appears with a
23
+ * different digest is a publisher error or an attack, never an update.
24
+ */
25
+ export class MappingPins {
26
+ #pins = new Map();
27
+ constructor(initial = []) {
28
+ for (const [key, digest] of initial)
29
+ this.#pins.set(key, digest);
30
+ }
31
+ pin(reference) {
32
+ const key = mappingKey(reference);
33
+ const known = this.#pins.get(key);
34
+ if (known !== undefined && known !== reference.digest) {
35
+ throw new MappingError("IMMUTABILITY_VIOLATION", `${key} was pinned to ${known} and is now offered as ${reference.digest}; a published mapping identity never changes`);
36
+ }
37
+ this.#pins.set(key, reference.digest);
38
+ }
39
+ /**
40
+ * Whether an identity and digest agree with what is pinned, without recording anything. A pin protects
41
+ * identity-to-digest consistency only; it says nothing about who published the bytes.
42
+ */
43
+ check(reference) {
44
+ const known = this.#pins.get(mappingKey(reference));
45
+ if (known === undefined)
46
+ return { status: "new" };
47
+ return known === reference.digest ? { status: "consistent" } : { status: "conflict", pinned: known };
48
+ }
49
+ entries() {
50
+ return [...this.#pins.entries()];
51
+ }
52
+ }
53
+ /**
54
+ * Obtains and verifies the artifact a reference points to: the embedded artifact
55
+ * if present, otherwise the first location that yields bytes with the right
56
+ * digest. The fetcher is supplied by the caller (HTTP, file, an artifact store),
57
+ * so this package has no I/O and no registry.
58
+ */
59
+ export async function resolveMapping(reference, fetcher, pins) {
60
+ pins?.pin(reference);
61
+ const failures = [];
62
+ if (reference.artifact !== undefined)
63
+ return verifyMappingArtifact(reference, reference.artifact);
64
+ for (const uri of reference.uri ?? []) {
65
+ try {
66
+ return verifyMappingArtifact(reference, await fetcher(uri));
67
+ }
68
+ catch (error) {
69
+ failures.push(`${uri}: ${error instanceof Error ? error.message : String(error)}`);
70
+ }
71
+ }
72
+ throw new MappingError("UNRESOLVABLE", `no location produced a valid artifact for ${mappingKey(reference)}`, { issues: failures });
73
+ }
74
+ //# sourceMappingURL=reference.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reference.js","sourceRoot":"","sources":["../src/reference.ts"],"names":[],"mappings":"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"}