@kungfu-tech/buildchain 3.0.9-alpha.9 → 4.0.0-alpha.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 (262) hide show
  1. package/AGENTS.md +39 -0
  2. package/README.md +17 -13
  3. package/actions/promote-buildchain-ref/README.md +0 -10
  4. package/actions/release-tail/README.md +6 -10
  5. package/architecture/internal-capabilities.json +502 -0
  6. package/architecture/maintainability-baseline.json +59 -0
  7. package/architecture/maintainability-policy.json +1384 -0
  8. package/architecture/release-tail-contract-inventory.json +587 -0
  9. package/architecture/v3-core-mechanism-inventory.json +1043 -0
  10. package/architecture/v3-core-mechanism-inventory.md +67 -0
  11. package/architecture/v4-adopter-delivery-parity.json +47 -0
  12. package/architecture/v4-architecture-constitution.md +210 -0
  13. package/architecture/v4-bootstrap-authority.json +56 -0
  14. package/architecture/v4-canonical-contract-fixtures.json +105 -0
  15. package/architecture/v4-capability-state-machine-manifest.json +480 -0
  16. package/architecture/v4-capability-state-machine-manifest.schema.json +202 -0
  17. package/architecture/v4-delivery-warrant-shadow-bootstrap-plan.json +830 -0
  18. package/architecture/v4-delivery-warrant-shadow-bootstrap-plan.md +223 -0
  19. package/architecture/v4-delivery-warrant-shadow-bootstrap-plan.schema.json +318 -0
  20. package/architecture/v4-delivery-warrant-shadow-fixtures.json +227 -0
  21. package/architecture/v4-delivery-warrant-shadow-fixtures.schema.json +67 -0
  22. package/architecture/v4-exception-ledger.json +5 -0
  23. package/architecture/v4-exception-ledger.schema.json +56 -0
  24. package/architecture/v4-partial-mutation-recovery-qualification.json +65 -0
  25. package/architecture/v4-platform-stage-checkpoints.json +97 -0
  26. package/architecture/v4-provider-operation-journal-contract.json +113 -0
  27. package/architecture/v4-release-activation-shadow-domain.json +61 -0
  28. package/architecture/v4-release-train-parity.json +68 -0
  29. package/architecture/v4-rust-libnode-bridge-evaluation.json +107 -0
  30. package/architecture/v4-rust-libnode-bridge-spike.md +85 -0
  31. package/architecture/v4-stable-publication-fence.json +66 -0
  32. package/architecture/v4-stage-capsule-contract.json +90 -0
  33. package/architecture/v4-stage-capsule-qualification.json +99 -0
  34. package/architecture/v4-stage-capsule-resume-planner.json +52 -0
  35. package/architecture/v4-stage-capsule-store-contract.json +72 -0
  36. package/bin/buildchain.mjs +15 -10
  37. package/contracts/auditable-demo-scenario-v1.schema.json +1 -1
  38. package/contracts/buildchain-v2-residuals-v1.json +2 -2
  39. package/contracts/fixtures/v4-delivery-warrant-trace-v1/golden.json +158 -0
  40. package/contracts/fixtures/v4-delivery-warrant-trace-v1/property.json +380 -0
  41. package/contracts/fixtures/v4-delivery-warrant-trace-v1/replay.json +163 -0
  42. package/contracts/fixtures/v4-partial-mutation-recovery-v1/shared.json +155 -0
  43. package/contracts/fixtures/v4-provider-operation-journal-v1/shared.json +457 -0
  44. package/contracts/fixtures/v4-provider-readback-idempotency-v1/shared.json +682 -0
  45. package/contracts/fixtures/v4-release-activation-shadow-v1/shared.json +53 -0
  46. package/contracts/fixtures/v4-stable-publication-fence-v1/shared.json +56 -0
  47. package/contracts/fixtures/v4-stage-capsule-resume-v1/late-platform-failure.json +176 -0
  48. package/contracts/fixtures/v4-stage-capsule-store-v1/shared.json +132 -0
  49. package/contracts/fixtures/v4-stage-capsule-v1/shared.json +111 -0
  50. package/contracts/v4-canonical-contracts-v1.schema.json +182 -0
  51. package/contracts/v4-delivery-warrant-semantic-diff-report-v1.schema.json +284 -0
  52. package/contracts/v4-delivery-warrant-trace-v1.schema.json +215 -0
  53. package/contracts/v4-host-contract-v1.schema.json +135 -0
  54. package/contracts/v4-partial-mutation-recovery-v1.schema.json +168 -0
  55. package/contracts/v4-provider-operation-journal-v1.schema.json +381 -0
  56. package/contracts/v4-release-activation-shadow-v1.schema.json +186 -0
  57. package/contracts/v4-stable-publication-fence-v1.schema.json +125 -0
  58. package/contracts/v4-stage-capsule-resume-v1.schema.json +225 -0
  59. package/contracts/v4-stage-capsule-store-v1.schema.json +154 -0
  60. package/contracts/v4-stage-capsule-v1.schema.json +178 -0
  61. package/crates/buildchain-v4-bridge/Cargo.lock +213 -0
  62. package/crates/buildchain-v4-bridge/Cargo.toml +12 -0
  63. package/crates/buildchain-v4-bridge/src/main.rs +495 -0
  64. package/dist/site/agent-index.json +0 -4
  65. package/dist/site/artifact-schemas.json +0 -8
  66. package/dist/site/buildchain-contract.json +103 -397
  67. package/dist/site/buildchain-site.json +302 -386
  68. package/dist/site/capability-registry.json +9 -11
  69. package/dist/site/cli-registry.json +8 -53
  70. package/dist/site/controller-registry.json +48 -8
  71. package/dist/site/kfd-claims.json +129 -167
  72. package/dist/site/kfd-upstream-aggregate.json +9 -9
  73. package/dist/site/manual-registry.json +18 -49
  74. package/dist/site/node-api-registry.json +4345 -7345
  75. package/dist/site/page-registry.json +278 -346
  76. package/dist/site/public-surface-audit.json +85 -404
  77. package/dist/site/publication-authority-registry.json +11 -1
  78. package/dist/site/publication-registry.json +4 -4
  79. package/dist/site/release-provenance.json +3 -9
  80. package/dist/site/schemas/kfd-support-projection-v1.schema.json +106 -0
  81. package/dist/site/site-manifest.json +22 -38
  82. package/dist/site/workflow-registry.json +78 -35
  83. package/docs/MAP.md +8 -5
  84. package/docs/auditable-demo.md +2 -2
  85. package/docs/aws-us-elastic-runner-burst-plane.md +7 -59
  86. package/docs/cli-reference.md +15 -213
  87. package/docs/cli.md +14 -14
  88. package/docs/dev-alpha-candidate-patrol.md +3 -11
  89. package/docs/dev-delivery-warrant.md +29 -194
  90. package/docs/engineering-housekeeper.md +12 -4
  91. package/docs/getting-started.md +1 -1
  92. package/docs/install.md +5 -5
  93. package/docs/kfd-support.md +2 -7
  94. package/docs/lifecycle-protocol.md +2 -4
  95. package/docs/node-api-reference.md +414 -554
  96. package/docs/release-flow.md +31 -31
  97. package/docs/release-governance.md +16 -28
  98. package/docs/release-passport.md +2 -15
  99. package/docs/release-tail-contract.md +13 -6
  100. package/docs/release-tail-provider-plane.md +13 -19
  101. package/docs/release-train.md +4 -4
  102. package/docs/reusable-build-surface.md +14 -27
  103. package/docs/site-bundle-contract.md +1 -5
  104. package/docs/stable-candidate-patrol.md +7 -7
  105. package/docs/v4-canonical-contracts.md +92 -0
  106. package/docs/v4-delivery-warrant-read-candidate.md +73 -0
  107. package/docs/v4-delivery-warrant-semantic-diff.md +75 -0
  108. package/docs/v4-production-release.md +63 -0
  109. package/docs/v4-stage-capsule.md +193 -0
  110. package/docs/versioning.md +3 -5
  111. package/package.json +19 -19
  112. package/packages/core/adopter-delivery-gate.js +576 -0
  113. package/packages/core/adopter-delivery-json.js +66 -0
  114. package/packages/core/artifact-signing.js +0 -61
  115. package/packages/core/artifact-verification-envelope.js +5 -5
  116. package/packages/core/build-facts.js +12 -4
  117. package/packages/core/buildchain-agent-manuals.js +0 -2
  118. package/packages/core/buildchain-channel-identity.js +3 -2
  119. package/packages/core/buildchain-config.js +4 -69
  120. package/packages/core/buildchain-contract.js +232 -46
  121. package/packages/core/buildchain-kfd-claims.js +1 -1
  122. package/packages/core/channel-candidate.js +0 -8
  123. package/packages/core/channel-promotion-baseline.js +0 -52
  124. package/packages/core/controller-evidence.js +3 -4
  125. package/packages/core/dev-alpha-candidate-selection.js +2 -10
  126. package/packages/core/dev-delivery-warrant-cancellation.js +0 -1
  127. package/packages/core/dev-delivery-warrant-settlement.js +20 -67
  128. package/packages/core/dev-delivery-warrant.js +50 -138
  129. package/packages/core/diagnostics.js +3 -8
  130. package/packages/core/github-governance-authority.js +3 -1
  131. package/packages/core/kfd-adopter-category-driver.js +167 -0
  132. package/packages/core/kfd-adopter-manifest.js +47 -46
  133. package/packages/core/kfd-gate.js +15 -45
  134. package/packages/core/paper-agent-entry.js +7 -16
  135. package/packages/core/paper-fleet.js +2 -2
  136. package/packages/core/paper-repository.js +2 -3
  137. package/packages/core/paper-scaffold-content.js +2 -23
  138. package/packages/core/paper.js +11 -43
  139. package/packages/core/publication-reproducibility.js +4 -4
  140. package/packages/core/release-line-bootstrap.js +21 -8
  141. package/packages/core/release-passport-contract.js +5 -5
  142. package/packages/core/release-passport.js +20 -131
  143. package/packages/core/self-dogfood-version.js +48 -35
  144. package/packages/core/spawn-command.js +232 -8
  145. package/packages/core/v4-adopter-delivery-parity.js +219 -0
  146. package/packages/core/v4-canonical-contracts.js +284 -0
  147. package/packages/core/v4-delivery-warrant-fixture-runner.js +371 -0
  148. package/packages/core/v4-delivery-warrant-read-candidate.js +279 -0
  149. package/packages/core/v4-delivery-warrant-semantic-diff-gate.js +352 -0
  150. package/packages/core/v4-delivery-warrant-shadow-adapter.js +447 -0
  151. package/packages/core/v4-partial-mutation-recovery-qualification.js +395 -0
  152. package/packages/core/v4-platform-stage-checkpoints.js +471 -0
  153. package/packages/core/v4-provider-operation-journal.js +531 -0
  154. package/packages/core/v4-provider-readback-idempotency.js +394 -0
  155. package/packages/core/v4-release-activation-shadow.js +519 -0
  156. package/packages/core/v4-stable-publication-fence.js +357 -0
  157. package/packages/core/v4-stage-capsule-local-store.js +426 -0
  158. package/packages/core/v4-stage-capsule-qualification-campaign.js +512 -0
  159. package/packages/core/v4-stage-capsule-qualification.js +456 -0
  160. package/packages/core/v4-stage-capsule-resume-planner.js +397 -0
  161. package/packages/core/v4-stage-capsule-store.js +401 -0
  162. package/packages/core/v4-stage-capsule.js +319 -0
  163. package/scripts/assemble-self-publication-admission.mjs +1 -1
  164. package/scripts/audit-publication-control-plane.mjs +5 -5
  165. package/scripts/auditable-demo-bundle-verification.mjs +3 -2
  166. package/scripts/auditable-demo-platform.mjs +2 -2
  167. package/scripts/auditable-demo-renditions.mjs +1 -1
  168. package/scripts/auditable-demo.mjs +2 -2
  169. package/scripts/aws-macos-jit-controller-core.mjs +13 -346
  170. package/scripts/aws-macos-jit-controller-runtime.mjs +2 -210
  171. package/scripts/aws-macos-jit-controller.mjs +37 -275
  172. package/scripts/aws-macos-jit-core.mjs +3 -41
  173. package/scripts/aws-macos-jit.mjs +0 -12
  174. package/scripts/aws-windows-jit-campaign.mjs +2 -2
  175. package/scripts/aws-windows-jit-controller-core.mjs +1 -1
  176. package/scripts/aws-windows-jit-controller.mjs +3 -3
  177. package/scripts/build-contract-core.mjs +3 -8
  178. package/scripts/build-standalone-binary.mjs +3 -14
  179. package/scripts/buildchain-channel-router.mjs +4 -0
  180. package/scripts/buildchain-cli-help.mjs +7 -16
  181. package/scripts/buildchain-contract-lock.mjs +0 -6
  182. package/scripts/check-action-bundles.mjs +3 -4
  183. package/scripts/check-internal-architecture.mjs +7 -6
  184. package/scripts/check-inventory.mjs +30 -25
  185. package/scripts/check-v4-public-dogfood-contract.mjs +270 -0
  186. package/scripts/create-release-bundle.mjs +8 -4
  187. package/scripts/dev-alpha-candidate-patrol.mjs +1 -22
  188. package/scripts/dev-delivery-proof.mjs +2 -64
  189. package/scripts/dev-delivery-warrant.mjs +61 -86
  190. package/scripts/dev-pr-auto-merge.mjs +4 -30
  191. package/scripts/dev-pr-delivery-warrant.mjs +0 -55
  192. package/scripts/dispatch-artifact-signing-authority.mjs +7 -4
  193. package/scripts/generate-buildchain-kfd-witnesses.mjs +94 -88
  194. package/scripts/generate-channel-build-workflow.mjs +54 -24
  195. package/scripts/generate-channel-promotion-workflow.mjs +15 -6
  196. package/scripts/generate-site-bundle.mjs +8 -27
  197. package/scripts/git-fetch-process-tree.mjs +34 -1
  198. package/scripts/init-repo.mjs +64 -159
  199. package/scripts/inspect-artifact-signing-requests.mjs +0 -6
  200. package/scripts/locked-source-checkout.mjs +3 -4
  201. package/scripts/maintainability-metrics.mjs +8 -2
  202. package/scripts/npm-publish-dry-run.mjs +2 -2
  203. package/scripts/npm-publish-transaction.mjs +2 -2
  204. package/scripts/publication-commit-evidence.mjs +23 -69
  205. package/scripts/release-candidate-resolver.mjs +11 -17
  206. package/scripts/release-tail.mjs +3 -49
  207. package/scripts/resume-from-candidate-run.mjs +9 -123
  208. package/scripts/run-lifecycle-core.mjs +12 -13
  209. package/scripts/seal-artifact-signing-requests.mjs +17 -21
  210. package/scripts/site-capability-metadata.mjs +3 -20
  211. package/scripts/stable-candidate-qualification.mjs +10 -10
  212. package/scripts/v4-architecture.mjs +12 -2
  213. package/scripts/v4-bridge-bootstrap.mjs +141 -0
  214. package/scripts/v4-bridge-evidence.mjs +141 -0
  215. package/scripts/v4-host-adapter.mjs +182 -0
  216. package/scripts/v4-platform-stage-checkpoint-rehearsal.mjs +207 -0
  217. package/scripts/v4-stage-capsule-qualification.mjs +528 -0
  218. package/scripts/v4-stage-capsule-resume-rehearsal.mjs +57 -0
  219. package/scripts/v4-warrant-shadow-plan.mjs +601 -0
  220. package/scripts/verify-golden-path.mjs +5 -5
  221. package/scripts/web-surface-cloudfront-rewrite.mjs +15 -15
  222. package/scripts/web-surface-core.mjs +2 -8
  223. package/scripts/workflow-call-contract.mjs +5 -184
  224. package/contracts/dev-delivery-authority-v2.schema.json +0 -253
  225. package/contracts/fixtures/kfd-adopter-release-v1/kfd-4-perspective.json +0 -16
  226. package/contracts/fixtures/kfd-adopter-release-v1/kfd-4-replay.json +0 -57
  227. package/contracts/fixtures/next-development-transition-v1/anchored-manual-waiting.json +0 -47
  228. package/contracts/fixtures/next-development-transition-v1/semver-auto-planned.json +0 -47
  229. package/contracts/fixtures/next-development-transition-v1/version-model-cases.json +0 -40
  230. package/contracts/next-development-request-v1.schema.json +0 -66
  231. package/contracts/next-development-transition-v1.schema.json +0 -292
  232. package/contracts/publication-rehearsal-capsule-v1.schema.json +0 -173
  233. package/dist/site/schemas/dev-delivery-authority-v2.schema.json +0 -442
  234. package/dist/site/schemas/publication-rehearsal-capsule-v1.schema.json +0 -269
  235. package/dist/site/schemas/release-tail-capabilities-v1.schema.json +0 -353
  236. package/dist/site/schemas/release-tail-provider-bindings-v1.schema.json +0 -94
  237. package/docs/dev-delivery-qualification-landing-adr.md +0 -137
  238. package/docs/next-development-transition.md +0 -119
  239. package/docs/publication-rehearsal.md +0 -94
  240. package/packages/core/buildchain-compatibility-proof.js +0 -631
  241. package/packages/core/dev-delivery-authority.js +0 -996
  242. package/packages/core/dev-delivery-native-proof.js +0 -418
  243. package/packages/core/dev-delivery-warrant-shadow.js +0 -502
  244. package/packages/core/next-development-candidate-reservation.js +0 -186
  245. package/packages/core/next-development-controller.js +0 -726
  246. package/packages/core/next-development-projection.js +0 -288
  247. package/packages/core/next-development-transition.js +0 -738
  248. package/packages/core/publication-rehearsal-projection.js +0 -173
  249. package/packages/core/publication-rehearsal-runtime.js +0 -921
  250. package/scripts/aws-macos-jit-instance-rehydrate.mjs +0 -260
  251. package/scripts/aws-macos-jit-source-rebind.mjs +0 -724
  252. package/scripts/dev-delivery-authority.mjs +0 -368
  253. package/scripts/dev-delivery-native-run.mjs +0 -235
  254. package/scripts/dev-delivery-two-phase-resume.mjs +0 -90
  255. package/scripts/dev-delivery-two-phase.mjs +0 -577
  256. package/scripts/generate-next-development-guidance.mjs +0 -49
  257. package/scripts/materialize-self-release-candidate-version.mjs +0 -137
  258. package/scripts/next-development-self-dogfood-harness.mjs +0 -409
  259. package/scripts/next-development-self-dogfood.mjs +0 -532
  260. package/scripts/next-development-transition.mjs +0 -47
  261. package/scripts/release-candidate-tail-reseal.mjs +0 -426
  262. package/templates/native-dev-delivery.yml +0 -86
@@ -1,260 +0,0 @@
1
- // SPDX-License-Identifier: Apache-2.0
2
-
3
- import {
4
- AWS_MACOS_JIT_CONTROLLER_CONTRACT,
5
- macosRunInstancesArgs,
6
- } from "./aws-macos-jit-controller-core.mjs";
7
- import { MACOS_EC2_JIT_REGIONS } from "./aws-macos-jit-core.mjs";
8
- import {
9
- assertDryRun,
10
- assertMacosBudgetLaunchGate,
11
- assertOwnership,
12
- awsArgs,
13
- awsJson,
14
- commandResult,
15
- ghJson,
16
- requireSuccess,
17
- } from "./aws-macos-jit-controller-runtime.mjs";
18
-
19
- function assertInstanceRehydratePreflight(plan, profile) {
20
- const launchGate = assertMacosBudgetLaunchGate(plan, profile);
21
- const commit = ghJson(
22
- ["api", `repos/${plan.repository}/commits/${plan.source.sha}`],
23
- undefined,
24
- "GitHub exact-source preflight",
25
- );
26
- if (String(commit.sha || "").toLowerCase() !== plan.source.sha) {
27
- throw new Error("GitHub did not resolve the exact campaign source SHA");
28
- }
29
- const host = awsJson(
30
- plan,
31
- profile,
32
- [
33
- "ec2",
34
- "describe-hosts",
35
- "--host-ids",
36
- plan.aws.hostId,
37
- "--output",
38
- "json",
39
- ],
40
- "macOS rehydration host preflight",
41
- ).Hosts?.[0];
42
- if (
43
- !host ||
44
- host.State !== "available" ||
45
- host.AvailabilityZone !== plan.aws.availabilityZone ||
46
- host.HostProperties?.InstanceType !== plan.aws.instanceType ||
47
- (host.Instances || []).length !== 0 ||
48
- new Date(host.AllocationTime).toISOString() !== plan.aws.hostAllocatedAt
49
- ) {
50
- throw new Error("macOS rehydration host identity or capacity mismatch");
51
- }
52
- assertOwnership(host.Tags, plan);
53
-
54
- const regionalPlans = Object.keys(MACOS_EC2_JIT_REGIONS).map((region) => ({
55
- ...plan,
56
- aws: { ...plan.aws, region },
57
- }));
58
- const otherHosts = regionalPlans.flatMap((regionalPlan) =>
59
- (
60
- awsJson(
61
- regionalPlan,
62
- profile,
63
- [
64
- "ec2",
65
- "describe-hosts",
66
- "--filter",
67
- "Name=tag:kungfu:plane,Values=aws-us-elastic-runner-burst",
68
- "Name=tag:kungfu:provider,Values=macos-ec2-jit",
69
- "Name=state,Values=available,pending,under-assessment",
70
- "--output",
71
- "json",
72
- ],
73
- `macOS rehydration host ceiling in ${regionalPlan.aws.region}`,
74
- ).Hosts || []
75
- ).filter((candidate) => candidate.HostId !== plan.aws.hostId),
76
- );
77
- if (otherHosts.length !== 0) {
78
- throw new Error("macOS rehydration found another active Dedicated Host");
79
- }
80
- const activeInstances = regionalPlans.flatMap((regionalPlan) => {
81
- const active = awsJson(
82
- regionalPlan,
83
- profile,
84
- [
85
- "ec2",
86
- "describe-instances",
87
- "--filters",
88
- "Name=tag:kungfu:plane,Values=aws-us-elastic-runner-burst",
89
- "Name=tag:kungfu:provider,Values=macos-ec2-jit",
90
- "Name=instance-state-name,Values=pending,running,stopping,stopped,shutting-down",
91
- "--output",
92
- "json",
93
- ],
94
- `active macOS JIT instance preflight in ${regionalPlan.aws.region}`,
95
- );
96
- return (active.Reservations || []).flatMap(
97
- (reservation) => reservation.Instances || [],
98
- );
99
- });
100
- if (activeInstances.length !== 0) {
101
- throw new Error("macOS rehydration requires zero active JIT instances");
102
- }
103
- const runners = ghJson(
104
- ["api", `repos/${plan.repository}/actions/runners?per_page=100`],
105
- undefined,
106
- "macOS rehydration runner preflight",
107
- ).runners;
108
- if (
109
- (runners || []).some((runner) =>
110
- (runner.labels || []).some((label) =>
111
- String(label.name || label).startsWith("aws-us-ec2-macos-jit-"),
112
- ),
113
- )
114
- ) {
115
- throw new Error("macOS rehydration requires zero JIT runner residue");
116
- }
117
- const image = awsJson(
118
- plan,
119
- profile,
120
- [
121
- "ec2",
122
- "describe-images",
123
- "--image-ids",
124
- plan.aws.amiId,
125
- "--output",
126
- "json",
127
- ],
128
- "macOS rehydration AMI preflight",
129
- ).Images?.[0];
130
- if (
131
- !image ||
132
- image.Name !== plan.aws.amiName ||
133
- image.Architecture !== "arm64_mac" ||
134
- image.State !== "available"
135
- ) {
136
- throw new Error("macOS AMI identity or availability mismatch");
137
- }
138
- const subnet = awsJson(
139
- plan,
140
- profile,
141
- [
142
- "ec2",
143
- "describe-subnets",
144
- "--subnet-ids",
145
- plan.aws.subnetId,
146
- "--output",
147
- "json",
148
- ],
149
- "macOS rehydration subnet preflight",
150
- ).Subnets?.[0];
151
- if (!subnet || subnet.AvailabilityZone !== plan.aws.availabilityZone) {
152
- throw new Error(
153
- "macOS subnet and Dedicated Host availability zone mismatch",
154
- );
155
- }
156
- return {
157
- ...launchGate,
158
- exactCommit: plan.source.sha,
159
- hostId: host.HostId,
160
- hostState: host.State,
161
- activeInstances: 0,
162
- otherActiveHosts: 0,
163
- amiOwnerId: image.OwnerId,
164
- subnetAvailabilityZone: subnet.AvailabilityZone,
165
- };
166
- }
167
-
168
- export function executeMacosJitInstanceRehydrate(plan, { profile = "" } = {}) {
169
- if (
170
- plan?.contract !== AWS_MACOS_JIT_CONTROLLER_CONTRACT ||
171
- plan.kind !== "instance-rehydrate-plan"
172
- ) {
173
- throw new Error("macOS JIT instance rehydrate plan contract is invalid");
174
- }
175
- const preflight = assertInstanceRehydratePreflight(plan, profile);
176
- assertDryRun(
177
- commandResult(
178
- "aws",
179
- awsArgs(
180
- plan,
181
- profile,
182
- macosRunInstancesArgs(plan, { hostId: plan.aws.hostId, dryRun: true }),
183
- ),
184
- ),
185
- "EC2 same-host RunInstances DryRun",
186
- );
187
- const launched = awsJson(
188
- plan,
189
- profile,
190
- macosRunInstancesArgs(plan, { hostId: plan.aws.hostId }),
191
- "EC2 same-host RunInstances",
192
- );
193
- const instanceId = launched.Instances?.[0]?.InstanceId;
194
- if (!/^i-[0-9a-f]+$/.test(String(instanceId || ""))) {
195
- throw new Error("EC2 same-host RunInstances returned no instance identity");
196
- }
197
- requireSuccess(
198
- commandResult(
199
- "aws",
200
- awsArgs(plan, profile, [
201
- "ec2",
202
- "wait",
203
- "instance-running",
204
- "--instance-ids",
205
- instanceId,
206
- ]),
207
- ),
208
- "macOS rehydrated instance-running waiter",
209
- );
210
- const instance = awsJson(
211
- plan,
212
- profile,
213
- [
214
- "ec2",
215
- "describe-instances",
216
- "--instance-ids",
217
- instanceId,
218
- "--output",
219
- "json",
220
- ],
221
- "macOS rehydrated instance readback",
222
- ).Reservations?.[0]?.Instances?.[0];
223
- if (
224
- !instance ||
225
- instance.State?.Name !== "running" ||
226
- instance.Placement?.HostId !== plan.aws.hostId ||
227
- instance.ImageId !== plan.aws.amiId ||
228
- instance.InstanceType !== plan.aws.instanceType
229
- ) {
230
- throw new Error("macOS rehydrated instance identity or placement mismatch");
231
- }
232
- assertOwnership(instance.Tags, plan);
233
- return {
234
- schemaVersion: 1,
235
- contract: AWS_MACOS_JIT_CONTROLLER_CONTRACT,
236
- kind: "instance-rehydrate-result",
237
- status: "rehydrated",
238
- repository: plan.repository,
239
- campaign: plan.campaign,
240
- source: plan.source,
241
- replacement: {
242
- rehydrationId: plan.aws.rehydrationId,
243
- replacesInstanceId: plan.aws.replacesInstanceId,
244
- },
245
- aws: {
246
- region: plan.aws.region,
247
- availabilityZone: plan.aws.availabilityZone,
248
- hostId: plan.aws.hostId,
249
- hostAllocatedAt: plan.aws.hostAllocatedAt,
250
- instanceId,
251
- instanceType: instance.InstanceType,
252
- imageId: instance.ImageId,
253
- launchTime: new Date(instance.LaunchTime).toISOString(),
254
- },
255
- preflight,
256
- dryRun: "RunInstances:DryRunOperation",
257
- hostAllocated: false,
258
- planDigest: plan.digest,
259
- };
260
- }