@agent-teams/engineering-foundation 0.3.0 → 0.4.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 (197) hide show
  1. package/README.md +11 -2
  2. package/dist/capabilities/public-api-compatibility/adapters/outbound/api-extractor/microsoft-public-api-extractor.d.ts +6 -0
  3. package/dist/capabilities/public-api-compatibility/adapters/outbound/api-extractor/microsoft-public-api-extractor.d.ts.map +1 -0
  4. package/dist/capabilities/public-api-compatibility/adapters/outbound/api-extractor/microsoft-public-api-extractor.js +143 -0
  5. package/dist/capabilities/public-api-compatibility/adapters/outbound/api-extractor/microsoft-public-api-extractor.js.map +1 -0
  6. package/dist/capabilities/public-api-compatibility/adapters/outbound/crypto/node-change-fingerprint.d.ts +5 -0
  7. package/dist/capabilities/public-api-compatibility/adapters/outbound/crypto/node-change-fingerprint.d.ts.map +1 -0
  8. package/dist/capabilities/public-api-compatibility/adapters/outbound/crypto/node-change-fingerprint.js +7 -0
  9. package/dist/capabilities/public-api-compatibility/adapters/outbound/crypto/node-change-fingerprint.js.map +1 -0
  10. package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/filesystem-public-api-repository.d.ts +9 -0
  11. package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/filesystem-public-api-repository.d.ts.map +1 -0
  12. package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/filesystem-public-api-repository.js +205 -0
  13. package/dist/capabilities/public-api-compatibility/adapters/outbound/filesystem/filesystem-public-api-repository.js.map +1 -0
  14. package/dist/capabilities/public-api-compatibility/application/model/public-api.d.ts +46 -0
  15. package/dist/capabilities/public-api-compatibility/application/model/public-api.d.ts.map +1 -0
  16. package/dist/capabilities/public-api-compatibility/application/model/public-api.js +4 -0
  17. package/dist/capabilities/public-api-compatibility/application/model/public-api.js.map +1 -0
  18. package/dist/capabilities/public-api-compatibility/application/policies/evaluate-public-api-compatibility.d.ts +13 -0
  19. package/dist/capabilities/public-api-compatibility/application/policies/evaluate-public-api-compatibility.d.ts.map +1 -0
  20. package/dist/capabilities/public-api-compatibility/application/policies/evaluate-public-api-compatibility.js +168 -0
  21. package/dist/capabilities/public-api-compatibility/application/policies/evaluate-public-api-compatibility.js.map +1 -0
  22. package/dist/capabilities/public-api-compatibility/application/ports/change-fingerprint.d.ts +4 -0
  23. package/dist/capabilities/public-api-compatibility/application/ports/change-fingerprint.d.ts.map +1 -0
  24. package/dist/capabilities/public-api-compatibility/application/ports/change-fingerprint.js +2 -0
  25. package/dist/capabilities/public-api-compatibility/application/ports/change-fingerprint.js.map +1 -0
  26. package/dist/capabilities/public-api-compatibility/application/ports/public-api-extractor.d.ts +5 -0
  27. package/dist/capabilities/public-api-compatibility/application/ports/public-api-extractor.d.ts.map +1 -0
  28. package/dist/capabilities/public-api-compatibility/application/ports/public-api-extractor.js +2 -0
  29. package/dist/capabilities/public-api-compatibility/application/ports/public-api-extractor.js.map +1 -0
  30. package/dist/capabilities/public-api-compatibility/application/ports/public-api-repository.d.ts +8 -0
  31. package/dist/capabilities/public-api-compatibility/application/ports/public-api-repository.d.ts.map +1 -0
  32. package/dist/capabilities/public-api-compatibility/application/ports/public-api-repository.js +2 -0
  33. package/dist/capabilities/public-api-compatibility/application/ports/public-api-repository.js.map +1 -0
  34. package/dist/capabilities/public-api-compatibility/application/rules.d.ts +19 -0
  35. package/dist/capabilities/public-api-compatibility/application/rules.d.ts.map +1 -0
  36. package/dist/capabilities/public-api-compatibility/application/rules.js +20 -0
  37. package/dist/capabilities/public-api-compatibility/application/rules.js.map +1 -0
  38. package/dist/capabilities/public-api-compatibility/application/use-cases/analyze-public-api-compatibility.d.ts +15 -0
  39. package/dist/capabilities/public-api-compatibility/application/use-cases/analyze-public-api-compatibility.d.ts.map +1 -0
  40. package/dist/capabilities/public-api-compatibility/application/use-cases/analyze-public-api-compatibility.js +30 -0
  41. package/dist/capabilities/public-api-compatibility/application/use-cases/analyze-public-api-compatibility.js.map +1 -0
  42. package/dist/capabilities/public-api-compatibility/application/use-cases/promote-public-api-baselines.d.ts +14 -0
  43. package/dist/capabilities/public-api-compatibility/application/use-cases/promote-public-api-baselines.d.ts.map +1 -0
  44. package/dist/capabilities/public-api-compatibility/application/use-cases/promote-public-api-baselines.js +62 -0
  45. package/dist/capabilities/public-api-compatibility/application/use-cases/promote-public-api-baselines.js.map +1 -0
  46. package/dist/capabilities/public-api-compatibility/contract/config.d.ts +5 -0
  47. package/dist/capabilities/public-api-compatibility/contract/config.d.ts.map +1 -0
  48. package/dist/capabilities/public-api-compatibility/contract/config.js +104 -0
  49. package/dist/capabilities/public-api-compatibility/contract/config.js.map +1 -0
  50. package/dist/capabilities/public-api-compatibility/module.d.ts +10 -0
  51. package/dist/capabilities/public-api-compatibility/module.d.ts.map +1 -0
  52. package/dist/capabilities/public-api-compatibility/module.js +69 -0
  53. package/dist/capabilities/public-api-compatibility/module.js.map +1 -0
  54. package/dist/capabilities/repository-security-baseline/adapters/outbound/filesystem/filesystem-repository-security-reader.d.ts +6 -0
  55. package/dist/capabilities/repository-security-baseline/adapters/outbound/filesystem/filesystem-repository-security-reader.d.ts.map +1 -0
  56. package/dist/capabilities/repository-security-baseline/adapters/outbound/filesystem/filesystem-repository-security-reader.js +200 -0
  57. package/dist/capabilities/repository-security-baseline/adapters/outbound/filesystem/filesystem-repository-security-reader.js.map +1 -0
  58. package/dist/capabilities/repository-security-baseline/application/model/repository-security.d.ts +46 -0
  59. package/dist/capabilities/repository-security-baseline/application/model/repository-security.d.ts.map +1 -0
  60. package/dist/capabilities/repository-security-baseline/application/model/repository-security.js +2 -0
  61. package/dist/capabilities/repository-security-baseline/application/model/repository-security.js.map +1 -0
  62. package/dist/capabilities/repository-security-baseline/application/policies/evaluate-repository-security.d.ts +4 -0
  63. package/dist/capabilities/repository-security-baseline/application/policies/evaluate-repository-security.d.ts.map +1 -0
  64. package/dist/capabilities/repository-security-baseline/application/policies/evaluate-repository-security.js +218 -0
  65. package/dist/capabilities/repository-security-baseline/application/policies/evaluate-repository-security.js.map +1 -0
  66. package/dist/capabilities/repository-security-baseline/application/ports/repository-security-reader.d.ts +5 -0
  67. package/dist/capabilities/repository-security-baseline/application/ports/repository-security-reader.d.ts.map +1 -0
  68. package/dist/capabilities/repository-security-baseline/application/ports/repository-security-reader.js +2 -0
  69. package/dist/capabilities/repository-security-baseline/application/ports/repository-security-reader.js.map +1 -0
  70. package/dist/capabilities/repository-security-baseline/application/rules.d.ts +23 -0
  71. package/dist/capabilities/repository-security-baseline/application/rules.d.ts.map +1 -0
  72. package/dist/capabilities/repository-security-baseline/application/rules.js +24 -0
  73. package/dist/capabilities/repository-security-baseline/application/rules.js.map +1 -0
  74. package/dist/capabilities/repository-security-baseline/application/use-cases/analyze-repository-security.d.ts +9 -0
  75. package/dist/capabilities/repository-security-baseline/application/use-cases/analyze-repository-security.d.ts.map +1 -0
  76. package/dist/capabilities/repository-security-baseline/application/use-cases/analyze-repository-security.js +7 -0
  77. package/dist/capabilities/repository-security-baseline/application/use-cases/analyze-repository-security.js.map +1 -0
  78. package/dist/capabilities/repository-security-baseline/contract/config.d.ts +5 -0
  79. package/dist/capabilities/repository-security-baseline/contract/config.d.ts.map +1 -0
  80. package/dist/capabilities/repository-security-baseline/contract/config.js +86 -0
  81. package/dist/capabilities/repository-security-baseline/contract/config.js.map +1 -0
  82. package/dist/capabilities/repository-security-baseline/module.d.ts +5 -0
  83. package/dist/capabilities/repository-security-baseline/module.d.ts.map +1 -0
  84. package/dist/capabilities/repository-security-baseline/module.js +49 -0
  85. package/dist/capabilities/repository-security-baseline/module.js.map +1 -0
  86. package/dist/capabilities/source-dependencies/adapters/outbound/oxc/oxc-source-dependency-parser.d.ts +2 -1
  87. package/dist/capabilities/source-dependencies/adapters/outbound/oxc/oxc-source-dependency-parser.d.ts.map +1 -1
  88. package/dist/capabilities/source-dependencies/application/model/source-workspace.d.ts +1 -4
  89. package/dist/capabilities/source-dependencies/application/model/source-workspace.d.ts.map +1 -1
  90. package/dist/capabilities/source-dependencies/application/model/source-workspace.js.map +1 -1
  91. package/dist/capabilities/source-dependencies/application/policies/evaluate-source-dependencies.d.ts +2 -1
  92. package/dist/capabilities/source-dependencies/application/policies/evaluate-source-dependencies.d.ts.map +1 -1
  93. package/dist/capabilities/source-dependencies/application/ports/source-dependency-parser.d.ts +2 -1
  94. package/dist/capabilities/source-dependencies/application/ports/source-dependency-parser.d.ts.map +1 -1
  95. package/dist/capabilities/source-dependencies/application/use-cases/analyze-source-dependencies.d.ts +1 -1
  96. package/dist/capabilities/source-dependencies/application/use-cases/analyze-source-dependencies.d.ts.map +1 -1
  97. package/dist/capabilities/source-dependencies/application/use-cases/analyze-source-dependencies.js.map +1 -1
  98. package/dist/capabilities/source-dependencies/module.js +1 -1
  99. package/dist/capabilities/source-dependencies/module.js.map +1 -1
  100. package/dist/capabilities/suppression-governance/adapters/outbound/oxc/oxc-suppression-scanner.d.ts +7 -0
  101. package/dist/capabilities/suppression-governance/adapters/outbound/oxc/oxc-suppression-scanner.d.ts.map +1 -0
  102. package/dist/capabilities/suppression-governance/adapters/outbound/oxc/oxc-suppression-scanner.js +115 -0
  103. package/dist/capabilities/suppression-governance/adapters/outbound/oxc/oxc-suppression-scanner.js.map +1 -0
  104. package/dist/capabilities/suppression-governance/adapters/outbound/time/system-clock.d.ts +5 -0
  105. package/dist/capabilities/suppression-governance/adapters/outbound/time/system-clock.d.ts.map +1 -0
  106. package/dist/capabilities/suppression-governance/adapters/outbound/time/system-clock.js +6 -0
  107. package/dist/capabilities/suppression-governance/adapters/outbound/time/system-clock.js.map +1 -0
  108. package/dist/capabilities/suppression-governance/application/model/iso-date.d.ts +2 -0
  109. package/dist/capabilities/suppression-governance/application/model/iso-date.d.ts.map +1 -0
  110. package/dist/capabilities/suppression-governance/application/model/iso-date.js +27 -0
  111. package/dist/capabilities/suppression-governance/application/model/iso-date.js.map +1 -0
  112. package/dist/capabilities/suppression-governance/application/model/suppression-governance.d.ts +35 -0
  113. package/dist/capabilities/suppression-governance/application/model/suppression-governance.d.ts.map +1 -0
  114. package/dist/capabilities/suppression-governance/application/model/suppression-governance.js +8 -0
  115. package/dist/capabilities/suppression-governance/application/model/suppression-governance.js.map +1 -0
  116. package/dist/capabilities/suppression-governance/application/policies/evaluate-suppression-governance.d.ts +8 -0
  117. package/dist/capabilities/suppression-governance/application/policies/evaluate-suppression-governance.d.ts.map +1 -0
  118. package/dist/capabilities/suppression-governance/application/policies/evaluate-suppression-governance.js +196 -0
  119. package/dist/capabilities/suppression-governance/application/policies/evaluate-suppression-governance.js.map +1 -0
  120. package/dist/capabilities/suppression-governance/application/ports/calendar-clock.d.ts +4 -0
  121. package/dist/capabilities/suppression-governance/application/ports/calendar-clock.d.ts.map +1 -0
  122. package/dist/capabilities/suppression-governance/application/ports/calendar-clock.js +2 -0
  123. package/dist/capabilities/suppression-governance/application/ports/calendar-clock.js.map +1 -0
  124. package/dist/capabilities/suppression-governance/application/ports/suppression-scanner.d.ts +6 -0
  125. package/dist/capabilities/suppression-governance/application/ports/suppression-scanner.d.ts.map +1 -0
  126. package/dist/capabilities/suppression-governance/application/ports/suppression-scanner.js +2 -0
  127. package/dist/capabilities/suppression-governance/application/ports/suppression-scanner.js.map +1 -0
  128. package/dist/capabilities/suppression-governance/application/rules.d.ts +25 -0
  129. package/dist/capabilities/suppression-governance/application/rules.d.ts.map +1 -0
  130. package/dist/capabilities/suppression-governance/application/rules.js +26 -0
  131. package/dist/capabilities/suppression-governance/application/rules.js.map +1 -0
  132. package/dist/capabilities/suppression-governance/application/use-cases/analyze-suppression-governance.d.ts +15 -0
  133. package/dist/capabilities/suppression-governance/application/use-cases/analyze-suppression-governance.d.ts.map +1 -0
  134. package/dist/capabilities/suppression-governance/application/use-cases/analyze-suppression-governance.js +15 -0
  135. package/dist/capabilities/suppression-governance/application/use-cases/analyze-suppression-governance.js.map +1 -0
  136. package/dist/capabilities/suppression-governance/contract/config.d.ts +5 -0
  137. package/dist/capabilities/suppression-governance/contract/config.d.ts.map +1 -0
  138. package/dist/capabilities/suppression-governance/contract/config.js +108 -0
  139. package/dist/capabilities/suppression-governance/contract/config.js.map +1 -0
  140. package/dist/capabilities/suppression-governance/module.d.ts +5 -0
  141. package/dist/capabilities/suppression-governance/module.d.ts.map +1 -0
  142. package/dist/capabilities/suppression-governance/module.js +57 -0
  143. package/dist/capabilities/suppression-governance/module.js.map +1 -0
  144. package/dist/cli.js +25 -2
  145. package/dist/cli.js.map +1 -1
  146. package/dist/composition/capability-registry.d.ts.map +1 -1
  147. package/dist/composition/capability-registry.js +6 -0
  148. package/dist/composition/capability-registry.js.map +1 -1
  149. package/dist/composition/rule-registry.d.ts.map +1 -1
  150. package/dist/composition/rule-registry.js +6 -0
  151. package/dist/composition/rule-registry.js.map +1 -1
  152. package/dist/foundation-config.d.ts +1 -1
  153. package/dist/foundation-config.d.ts.map +1 -1
  154. package/dist/foundation-config.js +6 -0
  155. package/dist/foundation-config.js.map +1 -1
  156. package/dist/package-self-check.d.ts +2 -3
  157. package/dist/package-self-check.d.ts.map +1 -1
  158. package/dist/package-self-check.js +2 -4
  159. package/dist/package-self-check.js.map +1 -1
  160. package/dist/schema-catalog.d.ts +1 -3
  161. package/dist/schema-catalog.d.ts.map +1 -1
  162. package/dist/schema-catalog.js +1 -6
  163. package/dist/schema-catalog.js.map +1 -1
  164. package/dist/schema-ids.d.ts +3 -0
  165. package/dist/schema-ids.d.ts.map +1 -0
  166. package/dist/schema-ids.js +11 -0
  167. package/dist/schema-ids.js.map +1 -0
  168. package/dist/semantic-version.d.ts +2 -0
  169. package/dist/semantic-version.d.ts.map +1 -1
  170. package/dist/semantic-version.js +72 -1
  171. package/dist/semantic-version.js.map +1 -1
  172. package/dist/{capabilities/source-dependencies → source-inventory}/adapters/outbound/filesystem/filesystem-source-tree-reader.d.ts +1 -1
  173. package/dist/source-inventory/adapters/outbound/filesystem/filesystem-source-tree-reader.d.ts.map +1 -0
  174. package/dist/{capabilities/source-dependencies → source-inventory}/adapters/outbound/filesystem/filesystem-source-tree-reader.js +3 -3
  175. package/dist/source-inventory/adapters/outbound/filesystem/filesystem-source-tree-reader.js.map +1 -0
  176. package/dist/source-inventory/application/model/source-file-snapshot.d.ts +5 -0
  177. package/dist/source-inventory/application/model/source-file-snapshot.d.ts.map +1 -0
  178. package/dist/source-inventory/application/model/source-file-snapshot.js +2 -0
  179. package/dist/source-inventory/application/model/source-file-snapshot.js.map +1 -0
  180. package/dist/{capabilities/source-dependencies → source-inventory}/application/ports/source-tree-reader.d.ts +1 -1
  181. package/dist/source-inventory/application/ports/source-tree-reader.d.ts.map +1 -0
  182. package/dist/source-inventory/application/ports/source-tree-reader.js.map +1 -0
  183. package/dist/strict-yaml.d.ts +1 -0
  184. package/dist/strict-yaml.d.ts.map +1 -1
  185. package/dist/strict-yaml.js +2 -2
  186. package/dist/strict-yaml.js.map +1 -1
  187. package/package.json +3 -1
  188. package/schemas/foundation-config/v1.schema.json +30 -0
  189. package/schemas/package-public-api-baseline/v1.schema.json +39 -0
  190. package/schemas/package-public-api-compatibility/v1.schema.json +70 -0
  191. package/schemas/quality-suppression-governance/v1.schema.json +109 -0
  192. package/schemas/repository-security-baseline/v1.schema.json +57 -0
  193. package/dist/capabilities/source-dependencies/adapters/outbound/filesystem/filesystem-source-tree-reader.d.ts.map +0 -1
  194. package/dist/capabilities/source-dependencies/adapters/outbound/filesystem/filesystem-source-tree-reader.js.map +0 -1
  195. package/dist/capabilities/source-dependencies/application/ports/source-tree-reader.d.ts.map +0 -1
  196. package/dist/capabilities/source-dependencies/application/ports/source-tree-reader.js.map +0 -1
  197. /package/dist/{capabilities/source-dependencies → source-inventory}/application/ports/source-tree-reader.js +0 -0
@@ -0,0 +1,168 @@
1
+ import { semanticVersionBumpBetween } from "../../../../semantic-version.js";
2
+ import { compareCanonicalReferences } from "../model/public-api.js";
3
+ import { PUBLIC_API_COMPATIBILITY_RULES } from "../rules.js";
4
+ const BUMP_RANK = {
5
+ patch: 0,
6
+ minor: 1,
7
+ major: 2
8
+ };
9
+ function diagnostic(input) {
10
+ return {
11
+ ruleId: input.rule.id,
12
+ severity: input.rule.severity,
13
+ subject: input.subject,
14
+ message: input.message,
15
+ location: { path: input.path },
16
+ relatedLocations: [],
17
+ evidence: input.evidence ?? [],
18
+ remediation: input.rule.remediation,
19
+ requiresArchitectureReview: input.rule.requiresArchitectureReview
20
+ };
21
+ }
22
+ function itemChanged(released, current) {
23
+ return (released.kind !== current.kind ||
24
+ released.parentKind !== current.parentKind ||
25
+ released.parentReference !== current.parentReference ||
26
+ released.signature !== current.signature);
27
+ }
28
+ function addedItemIsBreaking(item, released, current) {
29
+ if (item.parentKind === "EntryPoint") {
30
+ return false;
31
+ }
32
+ let parentReference = item.parentReference;
33
+ const visited = new Set();
34
+ while (parentReference !== undefined && !visited.has(parentReference)) {
35
+ visited.add(parentReference);
36
+ if (released.has(parentReference)) {
37
+ return true;
38
+ }
39
+ const parent = current.get(parentReference);
40
+ if (parent === undefined || parent.parentKind === "EntryPoint") {
41
+ return false;
42
+ }
43
+ parentReference = parent.parentReference;
44
+ }
45
+ return true;
46
+ }
47
+ export function classifyPublicApiChange(releasedSnapshot, currentSnapshot, fingerprint) {
48
+ const released = new Map(releasedSnapshot.items.map((item) => [item.canonicalReference, item]));
49
+ const current = new Map(currentSnapshot.items.map((item) => [item.canonicalReference, item]));
50
+ const removed = [...released.keys()]
51
+ .filter((key) => !current.has(key))
52
+ .toSorted(compareCanonicalReferences);
53
+ const changed = [...released.entries()]
54
+ .filter(([key, item]) => {
55
+ const currentItem = current.get(key);
56
+ return currentItem !== undefined && itemChanged(item, currentItem);
57
+ })
58
+ .map(([key]) => key)
59
+ .toSorted(compareCanonicalReferences);
60
+ const addedItems = [...current.values()]
61
+ .filter((item) => !released.has(item.canonicalReference))
62
+ .toSorted((left, right) => compareCanonicalReferences(left.canonicalReference, right.canonicalReference));
63
+ const added = addedItems.map((item) => item.canonicalReference);
64
+ const breakingAdded = addedItems
65
+ .filter((item) => addedItemIsBreaking(item, released, current))
66
+ .map((item) => item.canonicalReference);
67
+ const breaking = removed.length > 0 || changed.length > 0 || breakingAdded.length > 0;
68
+ const changeEvidence = {
69
+ added: added.map((reference) => current.get(reference)),
70
+ changed: changed.map((reference) => ({
71
+ before: released.get(reference),
72
+ after: current.get(reference)
73
+ })),
74
+ removed: removed.map((reference) => released.get(reference))
75
+ };
76
+ return {
77
+ classification: breaking ? "breaking" : added.length > 0 ? "additive" : "none",
78
+ ...(breaking
79
+ ? { fingerprint: `sha256:${fingerprint.sha256(JSON.stringify(changeEvidence))}` }
80
+ : {}),
81
+ added,
82
+ changed,
83
+ removed
84
+ };
85
+ }
86
+ function requiredBump(change, packageVersion) {
87
+ if (change.classification === "breaking") {
88
+ return packageVersion.startsWith("0.") ? "minor" : "major";
89
+ }
90
+ return "minor";
91
+ }
92
+ export function evaluatePublicApiCompatibility(input) {
93
+ const diagnostics = [];
94
+ const subject = input.policy.packageName;
95
+ if (input.released.extractorVersion !== input.current.extractorVersion) {
96
+ diagnostics.push(diagnostic({
97
+ rule: PUBLIC_API_COMPATIBILITY_RULES.baselineToolMismatch,
98
+ subject,
99
+ message: `Released baseline uses API Extractor ${input.released.extractorVersion}; current adapter uses ${input.current.extractorVersion}.`,
100
+ path: input.policy.releasedBaselinePath
101
+ }));
102
+ return diagnostics;
103
+ }
104
+ if (semanticVersionBumpBetween(input.releaseEvidence.packageVersion, input.released.packageVersion) !== undefined) {
105
+ diagnostics.push(diagnostic({
106
+ rule: PUBLIC_API_COMPATIBILITY_RULES.baselineVersionMismatch,
107
+ subject,
108
+ message: `Package version ${input.releaseEvidence.packageVersion} is older than released baseline ${input.released.packageVersion}.`,
109
+ path: input.policy.manifestPath
110
+ }));
111
+ return diagnostics;
112
+ }
113
+ if (input.change.classification === "none" &&
114
+ input.released.packageVersion !== input.releaseEvidence.packageVersion) {
115
+ diagnostics.push(diagnostic({
116
+ rule: PUBLIC_API_COMPATIBILITY_RULES.baselineVersionMismatch,
117
+ subject,
118
+ message: `Released baseline version ${input.released.packageVersion} does not match package version ${input.releaseEvidence.packageVersion}.`,
119
+ path: input.policy.releasedBaselinePath
120
+ }));
121
+ return diagnostics;
122
+ }
123
+ if (input.change.classification === "none") {
124
+ return diagnostics;
125
+ }
126
+ const required = requiredBump(input.change, input.released.packageVersion);
127
+ if (input.releaseEvidence.declaredBump === undefined) {
128
+ diagnostics.push(diagnostic({
129
+ rule: PUBLIC_API_COMPATIBILITY_RULES.missingChangeset,
130
+ subject,
131
+ message: `Public API change has no Changeset for ${subject}.`,
132
+ path: input.policy.declarationEntryPoint
133
+ }));
134
+ }
135
+ else if (BUMP_RANK[input.releaseEvidence.declaredBump] < BUMP_RANK[required]) {
136
+ diagnostics.push(diagnostic({
137
+ rule: PUBLIC_API_COMPATIBILITY_RULES.insufficientChangeset,
138
+ subject,
139
+ message: `Public API change requires ${required}; Changeset declares ${input.releaseEvidence.declaredBump}.`,
140
+ path: input.policy.declarationEntryPoint
141
+ }));
142
+ }
143
+ if (input.change.classification === "breaking") {
144
+ const approval = input.policy.approvedBreakingChanges.find((candidate) => candidate.fingerprint === input.change.fingerprint);
145
+ if (approval === undefined) {
146
+ diagnostics.push(diagnostic({
147
+ rule: PUBLIC_API_COMPATIBILITY_RULES.breakingChangeNotApproved,
148
+ subject,
149
+ message: "Breaking public API change does not have an approved fingerprint.",
150
+ path: input.policy.declarationEntryPoint,
151
+ evidence: [
152
+ { kind: "change-fingerprint", value: input.change.fingerprint ?? "missing" }
153
+ ]
154
+ }));
155
+ }
156
+ else if (input.acceptedDecision !== true) {
157
+ diagnostics.push(diagnostic({
158
+ rule: PUBLIC_API_COMPATIBILITY_RULES.decisionNotAccepted,
159
+ subject,
160
+ message: `Breaking change references a decision that is not accepted: ${approval.decisionPath}.`,
161
+ path: approval.decisionPath,
162
+ evidence: [{ kind: "change-fingerprint", value: approval.fingerprint }]
163
+ }));
164
+ }
165
+ }
166
+ return diagnostics;
167
+ }
168
+ //# sourceMappingURL=evaluate-public-api-compatibility.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"evaluate-public-api-compatibility.js","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/policies/evaluate-public-api-compatibility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iCAAiC,CAAC;AAE7E,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AASpE,OAAO,EACL,8BAA8B,EAE/B,MAAM,aAAa,CAAC;AAErB,MAAM,SAAS,GAA0C;IACvD,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;IACR,KAAK,EAAE,CAAC;CACT,CAAC;AAEF,SAAS,UAAU,CAAC,KAMnB;IACC,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;QACrB,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ;QAC7B,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE;QAC9B,gBAAgB,EAAE,EAAE;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,EAAE;QAC9B,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,WAAW;QACnC,0BAA0B,EAAE,KAAK,CAAC,IAAI,CAAC,0BAA0B;KAClE,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,QAAuB,EAAE,OAAsB;IAClE,OAAO,CACL,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI;QAC9B,QAAQ,CAAC,UAAU,KAAK,OAAO,CAAC,UAAU;QAC1C,QAAQ,CAAC,eAAe,KAAK,OAAO,CAAC,eAAe;QACpD,QAAQ,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS,CACzC,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,IAAmB,EACnB,QAA4C,EAC5C,OAA2C;IAE3C,IAAI,IAAI,CAAC,UAAU,KAAK,YAAY,EAAE,CAAC;QACrC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,eAAe,GAAG,IAAI,CAAC,eAAe,CAAC;IAC3C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,OAAO,eAAe,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;QACtE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7B,IAAI,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC5C,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,UAAU,KAAK,YAAY,EAAE,CAAC;YAC/D,OAAO,KAAK,CAAC;QACf,CAAC;QACD,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;IAC3C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,gBAAmC,EACnC,eAAkC,EAClC,WAA8B;IAE9B,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,gBAAgB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC,CACtE,CAAC;IACF,MAAM,OAAO,GAAG,IAAI,GAAG,CACrB,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC,CACrE,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;SACjC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;SAClC,QAAQ,CAAC,0BAA0B,CAAC,CAAC;IACxC,MAAM,OAAO,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;SACpC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;QACtB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACrC,OAAO,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrE,CAAC,CAAC;SACD,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC;SACnB,QAAQ,CAAC,0BAA0B,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;SACrC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;SACxD,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACxB,0BAA0B,CAAC,IAAI,CAAC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAC9E,CAAC;IACJ,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAChE,MAAM,aAAa,GAAG,UAAU;SAC7B,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;SAC9D,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IACtF,MAAM,cAAc,GAAG;QACrB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACnC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC;YAC/B,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;SAC9B,CAAC,CAAC;QACH,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;KAC7D,CAAC;IACF,OAAO;QACL,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM;QAC9E,GAAG,CAAC,QAAQ;YACV,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,EAAE,EAAE;YACjF,CAAC,CAAC,EAAE,CAAC;QACP,KAAK;QACL,OAAO;QACP,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAA0B,EAAE,cAAsB;IACtE,IAAI,MAAM,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QACzC,OAAO,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC7D,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,KAO9C;IACC,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC;IACzC,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,KAAK,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QACvE,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;YACT,IAAI,EAAE,8BAA8B,CAAC,oBAAoB;YACzD,OAAO;YACP,OAAO,EAAE,wCAAwC,KAAK,CAAC,QAAQ,CAAC,gBAAgB,0BAA0B,KAAK,CAAC,OAAO,CAAC,gBAAgB,GAAG;YAC3I,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,oBAAoB;SACxC,CAAC,CACH,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IACE,0BAA0B,CACxB,KAAK,CAAC,eAAe,CAAC,cAAc,EACpC,KAAK,CAAC,QAAQ,CAAC,cAAc,CAC9B,KAAK,SAAS,EACf,CAAC;QACD,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;YACT,IAAI,EAAE,8BAA8B,CAAC,uBAAuB;YAC5D,OAAO;YACP,OAAO,EAAE,mBAAmB,KAAK,CAAC,eAAe,CAAC,cAAc,oCAAoC,KAAK,CAAC,QAAQ,CAAC,cAAc,GAAG;YACpI,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,YAAY;SAChC,CAAC,CACH,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IACE,KAAK,CAAC,MAAM,CAAC,cAAc,KAAK,MAAM;QACtC,KAAK,CAAC,QAAQ,CAAC,cAAc,KAAK,KAAK,CAAC,eAAe,CAAC,cAAc,EACtE,CAAC;QACD,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;YACT,IAAI,EAAE,8BAA8B,CAAC,uBAAuB;YAC5D,OAAO;YACP,OAAO,EAAE,6BAA6B,KAAK,CAAC,QAAQ,CAAC,cAAc,mCAAmC,KAAK,CAAC,eAAe,CAAC,cAAc,GAAG;YAC7I,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,oBAAoB;SACxC,CAAC,CACH,CAAC;QACF,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,KAAK,MAAM,EAAE,CAAC;QAC3C,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC3E,IAAI,KAAK,CAAC,eAAe,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACrD,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;YACT,IAAI,EAAE,8BAA8B,CAAC,gBAAgB;YACrD,OAAO;YACP,OAAO,EAAE,0CAA0C,OAAO,GAAG;YAC7D,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,qBAAqB;SACzC,CAAC,CACH,CAAC;IACJ,CAAC;SAAM,IAAI,SAAS,CAAC,KAAK,CAAC,eAAe,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/E,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;YACT,IAAI,EAAE,8BAA8B,CAAC,qBAAqB;YAC1D,OAAO;YACP,OAAO,EAAE,8BAA8B,QAAQ,wBAAwB,KAAK,CAAC,eAAe,CAAC,YAAY,GAAG;YAC5G,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,qBAAqB;SACzC,CAAC,CACH,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,CAAC,MAAM,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;QAC/C,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,uBAAuB,CAAC,IAAI,CACxD,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,KAAK,KAAK,CAAC,MAAM,CAAC,WAAW,CAClE,CAAC;QACF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;gBACT,IAAI,EAAE,8BAA8B,CAAC,yBAAyB;gBAC9D,OAAO;gBACP,OAAO,EAAE,mEAAmE;gBAC5E,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,qBAAqB;gBACxC,QAAQ,EAAE;oBACR,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW,IAAI,SAAS,EAAE;iBAC7E;aACF,CAAC,CACH,CAAC;QACJ,CAAC;aAAM,IAAI,KAAK,CAAC,gBAAgB,KAAK,IAAI,EAAE,CAAC;YAC3C,WAAW,CAAC,IAAI,CACd,UAAU,CAAC;gBACT,IAAI,EAAE,8BAA8B,CAAC,mBAAmB;gBACxD,OAAO;gBACP,OAAO,EAAE,+DAA+D,QAAQ,CAAC,YAAY,GAAG;gBAChG,IAAI,EAAE,QAAQ,CAAC,YAAY;gBAC3B,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,KAAK,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC;aACxE,CAAC,CACH,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}
@@ -0,0 +1,4 @@
1
+ export interface ChangeFingerprint {
2
+ sha256(value: string): string;
3
+ }
4
+ //# sourceMappingURL=change-fingerprint.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"change-fingerprint.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/ports/change-fingerprint.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC/B"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=change-fingerprint.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"change-fingerprint.js","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/ports/change-fingerprint.ts"],"names":[],"mappings":""}
@@ -0,0 +1,5 @@
1
+ import type { PublicApiPackagePolicy, PublicApiSnapshot } from "../model/public-api.js";
2
+ export interface PublicApiExtractor {
3
+ extract(consumerRoot: string, policy: PublicApiPackagePolicy, packageVersion: string, signal?: AbortSignal): Promise<PublicApiSnapshot>;
4
+ }
5
+ //# sourceMappingURL=public-api-extractor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"public-api-extractor.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/ports/public-api-extractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,kBAAkB;IACjC,OAAO,CACL,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,sBAAsB,EAC9B,cAAc,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/B"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=public-api-extractor.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"public-api-extractor.js","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/ports/public-api-extractor.ts"],"names":[],"mappings":""}
@@ -0,0 +1,8 @@
1
+ import type { PackageReleaseEvidence, PublicApiPackagePolicy, PublicApiSnapshot } from "../model/public-api.js";
2
+ export interface PublicApiRepository {
3
+ readReleasedBaseline(consumerRoot: string, policy: PublicApiPackagePolicy, signal?: AbortSignal): Promise<PublicApiSnapshot>;
4
+ readReleaseEvidence(consumerRoot: string, changesetDirectory: string, policy: PublicApiPackagePolicy, signal?: AbortSignal): Promise<PackageReleaseEvidence>;
5
+ isAcceptedDecision(consumerRoot: string, decisionPath: string, signal?: AbortSignal): Promise<boolean>;
6
+ writeReleasedBaseline(consumerRoot: string, policy: PublicApiPackagePolicy, snapshot: PublicApiSnapshot, signal?: AbortSignal): Promise<void>;
7
+ }
8
+ //# sourceMappingURL=public-api-repository.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"public-api-repository.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/ports/public-api-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,WAAW,mBAAmB;IAClC,oBAAoB,CAClB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,sBAAsB,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE9B,mBAAmB,CACjB,YAAY,EAAE,MAAM,EACpB,kBAAkB,EAAE,MAAM,EAC1B,MAAM,EAAE,sBAAsB,EAC9B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAEnC,kBAAkB,CAChB,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,MAAM,EACpB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB,qBAAqB,CACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,EAAE,iBAAiB,EAC3B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}
@@ -0,0 +1,2 @@
1
+ export {};
2
+ //# sourceMappingURL=public-api-repository.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"public-api-repository.js","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/ports/public-api-repository.ts"],"names":[],"mappings":""}
@@ -0,0 +1,19 @@
1
+ import type { DiagnosticSeverity } from "../../../check-contract.js";
2
+ export interface PublicApiCompatibilityRuleMetadata {
3
+ readonly id: string;
4
+ readonly severity: DiagnosticSeverity;
5
+ readonly rationale: string;
6
+ readonly remediation: string;
7
+ readonly documentation: string;
8
+ readonly requiresArchitectureReview: boolean;
9
+ }
10
+ export declare const PUBLIC_API_COMPATIBILITY_RULES: Readonly<{
11
+ baselineToolMismatch: PublicApiCompatibilityRuleMetadata;
12
+ baselineVersionMismatch: PublicApiCompatibilityRuleMetadata;
13
+ breakingChangeNotApproved: PublicApiCompatibilityRuleMetadata;
14
+ decisionNotAccepted: PublicApiCompatibilityRuleMetadata;
15
+ insufficientChangeset: PublicApiCompatibilityRuleMetadata;
16
+ missingChangeset: PublicApiCompatibilityRuleMetadata;
17
+ }>;
18
+ export declare const PUBLIC_API_COMPATIBILITY_RULES_BY_ID: ReadonlyMap<string, PublicApiCompatibilityRuleMetadata>;
19
+ //# sourceMappingURL=rules.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/public-api-compatibility/application/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAErE,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,0BAA0B,EAAE,OAAO,CAAC;CAC9C;AAkBD,eAAO,MAAM,8BAA8B;;;;;;;EAkCzC,CAAC;AAEH,eAAO,MAAM,oCAAoC,EAAE,WAAW,CAC5D,MAAM,EACN,kCAAkC,CAGnC,CAAC"}
@@ -0,0 +1,20 @@
1
+ function rule(suffix, rationale, remediation, requiresArchitectureReview = false) {
2
+ return Object.freeze({
3
+ id: `package.public-api-compatibility.${suffix}`,
4
+ severity: "error",
5
+ rationale,
6
+ remediation,
7
+ documentation: "docs/architecture/public-api-compatibility.md",
8
+ requiresArchitectureReview
9
+ });
10
+ }
11
+ export const PUBLIC_API_COMPATIBILITY_RULES = Object.freeze({
12
+ baselineToolMismatch: rule("baseline-tool-mismatch", "API surfaces produced by different extractor versions are not directly comparable evidence.", "Regenerate the released baseline only through the release workflow after reviewing the tool upgrade.", true),
13
+ baselineVersionMismatch: rule("baseline-version-mismatch", "The released API baseline must identify the currently versioned package release.", "Promote the current surface during the version release workflow."),
14
+ breakingChangeNotApproved: rule("breaking-change-not-approved", "A breaking public API change needs an explicit accepted architecture decision.", "Approve the reported fingerprint in an ADR-backed breaking-change entry.", true),
15
+ decisionNotAccepted: rule("decision-not-accepted", "A breaking-change approval is authoritative only when its referenced decision is accepted.", "Accept the referenced ADR or remove the breaking API change.", true),
16
+ insufficientChangeset: rule("insufficient-changeset", "A public API change must request a release bump compatible with its risk.", "Raise the package Changeset to the required minor or major bump."),
17
+ missingChangeset: rule("missing-changeset", "Public API changes must be visible in release intent before merge.", "Add a Changeset for the affected package.")
18
+ });
19
+ export const PUBLIC_API_COMPATIBILITY_RULES_BY_ID = new Map(Object.values(PUBLIC_API_COMPATIBILITY_RULES).map((metadata) => [metadata.id, metadata]));
20
+ //# sourceMappingURL=rules.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../../src/capabilities/public-api-compatibility/application/rules.ts"],"names":[],"mappings":"AAWA,SAAS,IAAI,CACX,MAAc,EACd,SAAiB,EACjB,WAAmB,EACnB,0BAA0B,GAAG,KAAK;IAElC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,oCAAoC,MAAM,EAAE;QAChD,QAAQ,EAAE,OAAO;QACjB,SAAS;QACT,WAAW;QACX,aAAa,EAAE,+CAA+C;QAC9D,0BAA0B;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,MAAM,8BAA8B,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1D,oBAAoB,EAAE,IAAI,CACxB,wBAAwB,EACxB,6FAA6F,EAC7F,sGAAsG,EACtG,IAAI,CACL;IACD,uBAAuB,EAAE,IAAI,CAC3B,2BAA2B,EAC3B,kFAAkF,EAClF,kEAAkE,CACnE;IACD,yBAAyB,EAAE,IAAI,CAC7B,8BAA8B,EAC9B,gFAAgF,EAChF,0EAA0E,EAC1E,IAAI,CACL;IACD,mBAAmB,EAAE,IAAI,CACvB,uBAAuB,EACvB,4FAA4F,EAC5F,8DAA8D,EAC9D,IAAI,CACL;IACD,qBAAqB,EAAE,IAAI,CACzB,wBAAwB,EACxB,2EAA2E,EAC3E,kEAAkE,CACnE;IACD,gBAAgB,EAAE,IAAI,CACpB,mBAAmB,EACnB,oEAAoE,EACpE,2CAA2C,CAC5C;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oCAAoC,GAG7C,IAAI,GAAG,CACT,MAAM,CAAC,MAAM,CAAC,8BAA8B,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC,CACzF,CAAC"}
@@ -0,0 +1,15 @@
1
+ import type { FoundationDiagnostic } from "../../../../check-contract.js";
2
+ import type { PublicApiCompatibilityPolicy } from "../model/public-api.js";
3
+ import type { ChangeFingerprint } from "../ports/change-fingerprint.js";
4
+ import type { PublicApiExtractor } from "../ports/public-api-extractor.js";
5
+ import type { PublicApiRepository } from "../ports/public-api-repository.js";
6
+ export declare function analyzePublicApiCompatibility(input: {
7
+ readonly consumerRoot: string;
8
+ readonly policy: PublicApiCompatibilityPolicy;
9
+ readonly signal?: AbortSignal;
10
+ }, dependencies: {
11
+ readonly extractor: PublicApiExtractor;
12
+ readonly fingerprint: ChangeFingerprint;
13
+ readonly repository: PublicApiRepository;
14
+ }): Promise<readonly FoundationDiagnostic[]>;
15
+ //# sourceMappingURL=analyze-public-api-compatibility.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"analyze-public-api-compatibility.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/use-cases/analyze-public-api-compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAE1E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAM7E,wBAAsB,6BAA6B,CACjD,KAAK,EAAE;IACL,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,EACD,YAAY,EAAE;IACZ,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAC1C,GACA,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAsD1C"}
@@ -0,0 +1,30 @@
1
+ import { assertNotCancelled } from "../../../../strict-yaml.js";
2
+ import { classifyPublicApiChange, evaluatePublicApiCompatibility } from "../policies/evaluate-public-api-compatibility.js";
3
+ export async function analyzePublicApiCompatibility(input, dependencies) {
4
+ const diagnostics = [];
5
+ for (const packagePolicy of input.policy.packages) {
6
+ assertNotCancelled(input.signal);
7
+ const [released, releaseEvidence] = await Promise.all([
8
+ dependencies.repository.readReleasedBaseline(input.consumerRoot, packagePolicy, input.signal),
9
+ dependencies.repository.readReleaseEvidence(input.consumerRoot, input.policy.changesetDirectory, packagePolicy, input.signal)
10
+ ]);
11
+ const current = await dependencies.extractor.extract(input.consumerRoot, packagePolicy, releaseEvidence.packageVersion, input.signal);
12
+ const change = classifyPublicApiChange(released, current, dependencies.fingerprint);
13
+ const approval = change.classification === "breaking"
14
+ ? packagePolicy.approvedBreakingChanges.find((candidate) => candidate.fingerprint === change.fingerprint)
15
+ : undefined;
16
+ const acceptedDecision = approval === undefined
17
+ ? undefined
18
+ : await dependencies.repository.isAcceptedDecision(input.consumerRoot, approval.decisionPath, input.signal);
19
+ diagnostics.push(...evaluatePublicApiCompatibility({
20
+ policy: packagePolicy,
21
+ released,
22
+ current,
23
+ change,
24
+ releaseEvidence,
25
+ acceptedDecision
26
+ }));
27
+ }
28
+ return diagnostics;
29
+ }
30
+ //# sourceMappingURL=analyze-public-api-compatibility.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"analyze-public-api-compatibility.js","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/use-cases/analyze-public-api-compatibility.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAKhE,OAAO,EACL,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,kDAAkD,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,KAIC,EACD,YAIC;IAED,MAAM,WAAW,GAA2B,EAAE,CAAC;IAC/C,KAAK,MAAM,aAAa,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QAClD,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACpD,YAAY,CAAC,UAAU,CAAC,oBAAoB,CAC1C,KAAK,CAAC,YAAY,EAClB,aAAa,EACb,KAAK,CAAC,MAAM,CACb;YACD,YAAY,CAAC,UAAU,CAAC,mBAAmB,CACzC,KAAK,CAAC,YAAY,EAClB,KAAK,CAAC,MAAM,CAAC,kBAAkB,EAC/B,aAAa,EACb,KAAK,CAAC,MAAM,CACb;SACF,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,OAAO,CAClD,KAAK,CAAC,YAAY,EAClB,aAAa,EACb,eAAe,CAAC,cAAc,EAC9B,KAAK,CAAC,MAAM,CACb,CAAC;QACF,MAAM,MAAM,GAAG,uBAAuB,CACpC,QAAQ,EACR,OAAO,EACP,YAAY,CAAC,WAAW,CACzB,CAAC;QACF,MAAM,QAAQ,GACZ,MAAM,CAAC,cAAc,KAAK,UAAU;YAClC,CAAC,CAAC,aAAa,CAAC,uBAAuB,CAAC,IAAI,CACxC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,KAAK,MAAM,CAAC,WAAW,CAC5D;YACH,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,gBAAgB,GACpB,QAAQ,KAAK,SAAS;YACpB,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,MAAM,YAAY,CAAC,UAAU,CAAC,kBAAkB,CAC9C,KAAK,CAAC,YAAY,EAClB,QAAQ,CAAC,YAAY,EACrB,KAAK,CAAC,MAAM,CACb,CAAC;QACR,WAAW,CAAC,IAAI,CACd,GAAG,8BAA8B,CAAC;YAChC,MAAM,EAAE,aAAa;YACrB,QAAQ;YACR,OAAO;YACP,MAAM;YACN,eAAe;YACf,gBAAgB;SACjB,CAAC,CACH,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}
@@ -0,0 +1,14 @@
1
+ import type { PublicApiCompatibilityPolicy, PublicApiSnapshot } from "../model/public-api.js";
2
+ import type { PublicApiExtractor } from "../ports/public-api-extractor.js";
3
+ import type { ChangeFingerprint } from "../ports/change-fingerprint.js";
4
+ import type { PublicApiRepository } from "../ports/public-api-repository.js";
5
+ export declare function promotePublicApiBaselines(input: {
6
+ readonly consumerRoot: string;
7
+ readonly policy: PublicApiCompatibilityPolicy;
8
+ readonly signal?: AbortSignal;
9
+ }, dependencies: {
10
+ readonly extractor: PublicApiExtractor;
11
+ readonly fingerprint: ChangeFingerprint;
12
+ readonly repository: PublicApiRepository;
13
+ }): Promise<readonly PublicApiSnapshot[]>;
14
+ //# sourceMappingURL=promote-public-api-baselines.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"promote-public-api-baselines.d.ts","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/use-cases/promote-public-api-baselines.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,4BAA4B,EAC5B,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAc7E,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE;IACL,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,4BAA4B,CAAC;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,EACD,YAAY,EAAE;IACZ,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;CAC1C,GACA,OAAO,CAAC,SAAS,iBAAiB,EAAE,CAAC,CAqGvC"}
@@ -0,0 +1,62 @@
1
+ import { CapabilityInputError } from "../../../../capability-runtime.js";
2
+ import { semanticVersionBumpBetween } from "../../../../semantic-version.js";
3
+ import { assertNotCancelled } from "../../../../strict-yaml.js";
4
+ import { classifyPublicApiChange } from "../policies/evaluate-public-api-compatibility.js";
5
+ function promotionError(code, message) {
6
+ throw new CapabilityInputError({
7
+ code,
8
+ message,
9
+ phase: "public-api-baseline-promotion",
10
+ retryable: false
11
+ });
12
+ }
13
+ const BUMP_RANK = Object.freeze({ patch: 0, minor: 1, major: 2 });
14
+ export async function promotePublicApiBaselines(input, dependencies) {
15
+ const promotions = [];
16
+ for (const packagePolicy of input.policy.packages) {
17
+ assertNotCancelled(input.signal);
18
+ const [released, releaseEvidence] = await Promise.all([
19
+ dependencies.repository.readReleasedBaseline(input.consumerRoot, packagePolicy, input.signal),
20
+ dependencies.repository.readReleaseEvidence(input.consumerRoot, input.policy.changesetDirectory, packagePolicy, input.signal)
21
+ ]);
22
+ const current = await dependencies.extractor.extract(input.consumerRoot, packagePolicy, releaseEvidence.packageVersion, input.signal);
23
+ if (released.extractorVersion !== current.extractorVersion) {
24
+ promotionError("PUBLIC_API_BASELINE_PROMOTION_TOOL_MISMATCH", `API Extractor changed from ${released.extractorVersion} to ${current.extractorVersion}; migrate the baseline in an explicitly reviewed tool-upgrade change.`);
25
+ }
26
+ const change = classifyPublicApiChange(released, current, dependencies.fingerprint);
27
+ if (released.packageVersion === releaseEvidence.packageVersion) {
28
+ if (change.classification !== "none") {
29
+ promotionError("PUBLIC_API_BASELINE_PROMOTION_RELEASE_DRIFT", `Package ${packagePolicy.packageName} changed after baseline ${released.packageVersion} was promoted.`);
30
+ }
31
+ continue;
32
+ }
33
+ const actualBump = semanticVersionBumpBetween(released.packageVersion, releaseEvidence.packageVersion);
34
+ if (actualBump === undefined) {
35
+ promotionError("PUBLIC_API_BASELINE_PROMOTION_NOT_RELEASE", `Package ${packagePolicy.packageName} must have a version newer than released baseline ${released.packageVersion}.`);
36
+ }
37
+ const requiredBump = change.classification === "none"
38
+ ? "patch"
39
+ : change.classification === "additive" || released.packageVersion.startsWith("0.")
40
+ ? "minor"
41
+ : "major";
42
+ if (BUMP_RANK[actualBump] < BUMP_RANK[requiredBump]) {
43
+ promotionError("PUBLIC_API_BASELINE_PROMOTION_VERSION_INSUFFICIENT", `API change for ${packagePolicy.packageName} requires ${requiredBump}; release advances by ${actualBump}.`);
44
+ }
45
+ if (change.classification === "breaking") {
46
+ const approval = packagePolicy.approvedBreakingChanges.find((candidate) => candidate.fingerprint === change.fingerprint);
47
+ if (approval === undefined) {
48
+ promotionError("PUBLIC_API_BASELINE_PROMOTION_UNAPPROVED_BREAK", `Breaking API fingerprint is not approved: ${change.fingerprint ?? "missing"}.`);
49
+ }
50
+ if (!(await dependencies.repository.isAcceptedDecision(input.consumerRoot, approval.decisionPath, input.signal))) {
51
+ promotionError("PUBLIC_API_BASELINE_PROMOTION_DECISION_NOT_ACCEPTED", `Breaking API decision is not accepted: ${approval.decisionPath}.`);
52
+ }
53
+ }
54
+ promotions.push({ packagePolicy, snapshot: current });
55
+ }
56
+ for (const promotion of promotions) {
57
+ assertNotCancelled(input.signal);
58
+ await dependencies.repository.writeReleasedBaseline(input.consumerRoot, promotion.packagePolicy, promotion.snapshot, input.signal);
59
+ }
60
+ return Object.freeze(promotions.map(({ snapshot }) => snapshot));
61
+ }
62
+ //# sourceMappingURL=promote-public-api-baselines.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"promote-public-api-baselines.js","sourceRoot":"","sources":["../../../../../src/capabilities/public-api-compatibility/application/use-cases/promote-public-api-baselines.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import type { PublicApiCompatibilityPolicy } from "../application/model/public-api.js";
2
+ export declare const CAPABILITY_ID: "package.public-api-compatibility";
3
+ export declare const CAPABILITY_CONFIG_SCHEMA_VERSION: 1;
4
+ export declare function loadCapabilityConfig(consumerRoot: string, configPath: string, signal?: AbortSignal): Promise<PublicApiCompatibilityPolicy>;
5
+ //# sourceMappingURL=config.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/capabilities/public-api-compatibility/contract/config.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,4BAA4B,EAE7B,MAAM,oCAAoC,CAAC;AAE5C,eAAO,MAAM,aAAa,EAAG,kCAA2C,CAAC;AACzE,eAAO,MAAM,gCAAgC,EAAG,CAAU,CAAC;AAuG3D,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,4BAA4B,CAAC,CAuBvC"}
@@ -0,0 +1,104 @@
1
+ import { CapabilityInputError } from "../../../capability-runtime.js";
2
+ import { assertSchema } from "../../../schema-catalog.js";
3
+ import { assertRepositoryRelativePath, loadStrictYamlFile } from "../../../strict-yaml.js";
4
+ export const CAPABILITY_ID = "package.public-api-compatibility";
5
+ export const CAPABILITY_CONFIG_SCHEMA_VERSION = 1;
6
+ function inputError(message) {
7
+ throw new CapabilityInputError({
8
+ code: "PUBLIC_API_COMPATIBILITY_CONFIG_INVALID",
9
+ message,
10
+ phase: "public-api-compatibility-config",
11
+ retryable: false
12
+ });
13
+ }
14
+ function record(value, field) {
15
+ if (typeof value !== "object" || value === null || Array.isArray(value)) {
16
+ inputError(`${field} must be an object.`);
17
+ }
18
+ return value;
19
+ }
20
+ function string(value, field) {
21
+ if (typeof value !== "string") {
22
+ inputError(`${field} must be a string.`);
23
+ }
24
+ return value;
25
+ }
26
+ function path(value, field) {
27
+ const repositoryPath = string(value, field);
28
+ assertRepositoryRelativePath(repositoryPath, "public-api-compatibility-config");
29
+ return repositoryPath;
30
+ }
31
+ function pathInside(candidate, root) {
32
+ return candidate === root || candidate.startsWith(`${root}/`);
33
+ }
34
+ function mapApproval(value, packageIndex, index) {
35
+ const field = `packages[${packageIndex}].approvedBreakingChanges[${index}]`;
36
+ const approval = record(value, field);
37
+ return Object.freeze({
38
+ fingerprint: string(approval["fingerprint"], `${field}.fingerprint`),
39
+ decisionPath: path(approval["decisionPath"], `${field}.decisionPath`)
40
+ });
41
+ }
42
+ function mapPackage(value, index) {
43
+ const field = `packages[${index}]`;
44
+ const input = record(value, field);
45
+ const packageRoot = path(input["packageRoot"], `${field}.packageRoot`);
46
+ const manifestPath = path(input["manifestPath"], `${field}.manifestPath`);
47
+ const declarationEntryPoint = path(input["declarationEntryPoint"], `${field}.declarationEntryPoint`);
48
+ const tsconfigPath = path(input["tsconfigPath"], `${field}.tsconfigPath`);
49
+ const approvals = input["approvedBreakingChanges"];
50
+ if (!Array.isArray(approvals)) {
51
+ inputError(`${field}.approvedBreakingChanges must be an array.`);
52
+ }
53
+ for (const repositoryPath of [manifestPath, declarationEntryPoint, tsconfigPath]) {
54
+ if (!pathInside(repositoryPath, packageRoot)) {
55
+ inputError(`${repositoryPath} must be inside package root ${packageRoot}.`);
56
+ }
57
+ }
58
+ return Object.freeze({
59
+ packageName: string(input["packageName"], `${field}.packageName`),
60
+ packageRoot,
61
+ manifestPath,
62
+ declarationEntryPoint,
63
+ tsconfigPath,
64
+ releasedBaselinePath: path(input["releasedBaselinePath"], `${field}.releasedBaselinePath`),
65
+ approvedBreakingChanges: Object.freeze(approvals.map((approval, approvalIndex) => mapApproval(approval, index, approvalIndex)))
66
+ });
67
+ }
68
+ function validatePolicy(policy) {
69
+ const names = new Set();
70
+ const baselines = new Set();
71
+ for (const packagePolicy of policy.packages) {
72
+ if (names.has(packagePolicy.packageName)) {
73
+ inputError(`Package identity is duplicated: ${packagePolicy.packageName}.`);
74
+ }
75
+ names.add(packagePolicy.packageName);
76
+ if (baselines.has(packagePolicy.releasedBaselinePath)) {
77
+ inputError(`Released baseline path is duplicated: ${packagePolicy.releasedBaselinePath}.`);
78
+ }
79
+ baselines.add(packagePolicy.releasedBaselinePath);
80
+ const fingerprints = new Set();
81
+ for (const approval of packagePolicy.approvedBreakingChanges) {
82
+ if (fingerprints.has(approval.fingerprint)) {
83
+ inputError(`Breaking-change fingerprint is duplicated: ${approval.fingerprint}.`);
84
+ }
85
+ fingerprints.add(approval.fingerprint);
86
+ }
87
+ }
88
+ }
89
+ export async function loadCapabilityConfig(consumerRoot, configPath, signal) {
90
+ const input = await loadStrictYamlFile(consumerRoot, configPath, "public-api-compatibility-config", signal);
91
+ await assertSchema("package-public-api-compatibility/v1", input, "public-api-compatibility-config");
92
+ const root = record(input, "public API compatibility config");
93
+ const packages = root["packages"];
94
+ if (!Array.isArray(packages)) {
95
+ inputError("packages must be an array.");
96
+ }
97
+ const policy = Object.freeze({
98
+ changesetDirectory: path(root["changesetDirectory"], "changesetDirectory"),
99
+ packages: Object.freeze(packages.map(mapPackage))
100
+ });
101
+ validatePolicy(policy);
102
+ return policy;
103
+ }
104
+ //# sourceMappingURL=config.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/capabilities/public-api-compatibility/contract/config.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import { type CapabilityDefinition } from "../../capability-runtime.js";
2
+ import { PUBLIC_API_COMPATIBILITY_RULES_BY_ID } from "./application/rules.js";
3
+ export { PUBLIC_API_COMPATIBILITY_RULES_BY_ID };
4
+ export declare function promotePublicApiRelease(input: {
5
+ readonly consumerRoot: string;
6
+ readonly configPath: string;
7
+ readonly signal?: AbortSignal;
8
+ }): Promise<readonly import("./application/model/public-api.js").PublicApiSnapshot[]>;
9
+ export declare function createPublicApiCompatibilityCapability(): CapabilityDefinition;
10
+ //# sourceMappingURL=module.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../../src/capabilities/public-api-compatibility/module.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,oBAAoB,EAE1B,MAAM,6BAA6B,CAAC;AAIrC,OAAO,EAAE,oCAAoC,EAAE,MAAM,wBAAwB,CAAC;AAS9E,OAAO,EAAE,oCAAoC,EAAE,CAAC;AAUhD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE;IACnD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B,qFAcA;AAED,wBAAgB,sCAAsC,IAAI,oBAAoB,CAkD7E"}