anhedral 0.11.0 → 0.11.1

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 (148) hide show
  1. package/README.md +73 -157
  2. package/assets/patches/LICENSE.braces +21 -0
  3. package/assets/patches/LICENSE.node-forge +50 -0
  4. package/assets/patches/audit-deps.mjs +167 -0
  5. package/assets/patches/braces@3.0.3.patch +127 -0
  6. package/assets/patches/node-forge@1.4.0.patch +41 -0
  7. package/dist/auth-schema.js +3 -3
  8. package/dist/bin.js +15 -11
  9. package/dist/capabilities.d.ts +4 -4
  10. package/dist/capabilities.js +6 -2
  11. package/dist/capability-contract.js +22 -5
  12. package/dist/catalog-model.d.ts +24 -0
  13. package/dist/catalog-model.js +1 -0
  14. package/dist/catalog-registration.d.ts +16 -0
  15. package/dist/catalog-registration.js +22 -0
  16. package/dist/catalog-snapshot.d.ts +5 -0
  17. package/dist/catalog-snapshot.js +97 -0
  18. package/dist/cli-arguments.js +1 -1
  19. package/dist/cli-output.js +27 -2
  20. package/dist/cloudflare.d.ts +7 -1
  21. package/dist/cloudflare.js +36 -6
  22. package/dist/command-schema.js +49 -5
  23. package/dist/delivery.d.ts +10 -3
  24. package/dist/delivery.js +154 -37
  25. package/dist/dependencies.d.ts +24 -0
  26. package/dist/dependencies.js +48 -0
  27. package/dist/dependency-patches.d.ts +7 -0
  28. package/dist/dependency-patches.js +125 -0
  29. package/dist/index.d.ts +3 -0
  30. package/dist/index.js +2 -0
  31. package/dist/inspector-model.d.ts +9 -1
  32. package/dist/integration-service-readers.d.ts +13 -0
  33. package/dist/integration-service-readers.js +173 -0
  34. package/dist/lifecycle.d.ts +0 -1
  35. package/dist/lifecycle.js +0 -1
  36. package/dist/neon-service-data.d.ts +8 -0
  37. package/dist/neon-service-data.js +117 -0
  38. package/dist/pnpm-policy.d.ts +2 -2
  39. package/dist/pnpm-policy.js +19 -45
  40. package/dist/project-catalog.d.ts +41 -0
  41. package/dist/project-catalog.js +288 -0
  42. package/dist/project-config.d.ts +14 -0
  43. package/dist/project-config.js +89 -0
  44. package/dist/project-inspector.js +73 -17
  45. package/dist/project-lifecycle.d.ts +25 -0
  46. package/dist/project-lifecycle.js +57 -0
  47. package/dist/project-state.d.ts +5 -1
  48. package/dist/project-state.js +122 -16
  49. package/dist/provider-auth.js +2 -3
  50. package/dist/provider-readiness.js +27 -10
  51. package/dist/providers/adapters.js +4 -1
  52. package/dist/providers/api.d.ts +1 -0
  53. package/dist/providers/api.js +1 -0
  54. package/dist/providers/config.js +6 -8
  55. package/dist/providers/provision.js +1 -1
  56. package/dist/providers/recovery.d.ts +1 -1
  57. package/dist/providers/runtime.d.ts +1 -1
  58. package/dist/providers/runtime.js +46 -23
  59. package/dist/providers/state.d.ts +1 -2
  60. package/dist/providers/state.js +14 -54
  61. package/dist/provision.d.ts +9 -0
  62. package/dist/provision.js +30 -1
  63. package/dist/r2-service-data.d.ts +2 -0
  64. package/dist/r2-service-data.js +136 -0
  65. package/dist/readiness.js +9 -13
  66. package/dist/registry/add.js +64 -21
  67. package/dist/registry/commands.js +7 -9
  68. package/dist/registry/options.d.ts +1 -1
  69. package/dist/registry/options.js +4 -4
  70. package/dist/registry/receipt.d.ts +1 -0
  71. package/dist/registry/receipt.js +19 -4
  72. package/dist/registry/resolve.js +5 -1
  73. package/dist/registry/usage.js +1 -5
  74. package/dist/render.d.ts +2 -0
  75. package/dist/render.js +6 -0
  76. package/dist/runtime-policy.d.ts +4 -0
  77. package/dist/runtime-policy.js +21 -0
  78. package/dist/scaffold/bootstrap.js +2 -2
  79. package/dist/scaffold/compose.js +9 -3
  80. package/dist/scaffold/database.js +107 -25
  81. package/dist/scaffold/documentation.js +18 -13
  82. package/dist/scaffold/lint.d.ts +4 -0
  83. package/dist/scaffold/lint.js +56 -0
  84. package/dist/scaffold/neon-realtime.d.ts +2 -0
  85. package/dist/scaffold/neon-realtime.js +97 -0
  86. package/dist/scaffold/stack-documentation.js +1 -1
  87. package/dist/scaffold/void.d.ts +4 -0
  88. package/dist/scaffold/void.js +256 -0
  89. package/dist/scaffold/web.js +7 -1
  90. package/dist/scaffold/workspace.js +120 -29
  91. package/dist/service-deletion.d.ts +29 -0
  92. package/dist/service-deletion.js +195 -0
  93. package/dist/service-descriptor.d.ts +10 -0
  94. package/dist/service-descriptor.js +78 -0
  95. package/dist/service-model.d.ts +49 -0
  96. package/dist/service-model.js +8 -0
  97. package/dist/service-operations.d.ts +29 -0
  98. package/dist/service-operations.js +78 -0
  99. package/dist/service-readers.d.ts +8 -0
  100. package/dist/service-readers.js +247 -0
  101. package/dist/services-command.d.ts +39 -0
  102. package/dist/services-command.js +100 -0
  103. package/dist/ship.d.ts +36 -8
  104. package/dist/ship.js +39 -13
  105. package/dist/stack-registry.d.ts +4 -2
  106. package/dist/stack-registry.js +41 -11
  107. package/dist/standard.js +23 -4
  108. package/dist/transaction.d.ts +2 -0
  109. package/dist/transaction.js +10 -0
  110. package/dist/util.js +17 -2
  111. package/dist/vercel.d.ts +2 -0
  112. package/dist/vercel.js +69 -13
  113. package/dist/version.d.ts +1 -1
  114. package/dist/version.js +1 -1
  115. package/dist/vinext.d.ts +1 -0
  116. package/dist/vinext.js +13 -1
  117. package/dist/void-execution.d.ts +10 -0
  118. package/dist/void-execution.js +94 -0
  119. package/dist/void-migrations.d.ts +6 -0
  120. package/dist/void-migrations.js +110 -0
  121. package/dist/void-state.d.ts +16 -0
  122. package/dist/void-state.js +65 -0
  123. package/dist/void.d.ts +3 -0
  124. package/dist/void.js +5 -0
  125. package/docs/cli-design.md +2 -2
  126. package/docs/delivery-workflow.md +8 -7
  127. package/docs/plugin-ui.md +51 -10
  128. package/docs/provider-configuration.md +10 -11
  129. package/docs/stack-standard.md +175 -0
  130. package/docs/void-verification.md +185 -0
  131. package/package.json +22 -20
  132. package/assets/anhedral-mark.svg +0 -4
  133. package/assets/anhedral-stack-technical.svg +0 -322
  134. package/assets/anhedral-stack.svg +0 -322
  135. package/assets/anhedral.svg +0 -4
  136. package/assets/favicon.ico +0 -0
  137. package/assets/security/LICENSES.txt +0 -63
  138. package/assets/security/audit-deps.mjs +0 -300
  139. package/assets/security/braces-regression.mjs +0 -102
  140. package/assets/security/braces@3.0.3.patch +0 -285
  141. package/assets/security/decode-uri-component@0.2.2.patch +0 -149
  142. package/assets/security/decoder-regression.mjs +0 -37
  143. package/assets/security/forge-regression.mjs +0 -46
  144. package/assets/security/manifest.json +0 -53
  145. package/assets/security/node-forge@1.4.0.patch +0 -26
  146. package/dist/security-backports.d.ts +0 -3
  147. package/dist/security-backports.js +0 -26
  148. package/docs/application-stack-standard.md +0 -75
@@ -14,9 +14,10 @@ export interface Release {
14
14
  commit: string;
15
15
  startedAt: string;
16
16
  finishedAt?: string;
17
- state: 'running' | 'checked' | 'deployed' | 'failed';
17
+ state: 'running' | 'checked' | 'deployed' | 'configuration-required' | 'failed';
18
18
  targets: TargetRelease[];
19
19
  failure?: string;
20
+ configurationChanges?: string[];
20
21
  operation?: 'ship' | 'rollback';
21
22
  restoredReleaseId?: string;
22
23
  verification?: {
@@ -42,12 +43,18 @@ interface ActiveVersion {
42
43
  versionId: string;
43
44
  percentage: number;
44
45
  }
45
- export declare function shipApplication(root: string, run?: import("./project-state.js").DeliveryRunner, suppliedRequest?: CloudflareRequest): Promise<{
46
+ export declare function shipApplication(root: string, run?: import("./project-state.js").DeliveryRunner, suppliedRequest?: CloudflareRequest, options?: {
47
+ voidLogsDirectory?: string;
48
+ }): Promise<{
49
+ management: string;
50
+ state?: "configuration-required" | undefined;
51
+ deployed?: false | undefined;
52
+ activated?: true | undefined;
53
+ nextAction?: string | undefined;
46
54
  projectId: string;
47
55
  release: Release;
48
56
  managementFile: string;
49
57
  productVerification: string;
50
- management: string;
51
58
  }>;
52
59
  export declare function applicationStatus(root: string, refresh?: boolean, run?: import("./project-state.js").DeliveryRunner): Promise<{
53
60
  project: ApplicationProject;
package/dist/delivery.js CHANGED
@@ -1,3 +1,6 @@
1
+ import { projectConfigPath, writeProjectSection } from './project-config.js';
2
+ import { deployVoidTarget, rollbackVoidTarget } from './void-execution.js';
3
+ import { voidLogSnapshot, readVoidDeploymentReceipt } from './void-state.js';
1
4
  import { createHash, randomUUID } from 'node:crypto';
2
5
  import { existsSync, mkdirSync, readFileSync, realpathSync, rmSync } from 'node:fs';
3
6
  import { tmpdir } from 'node:os';
@@ -6,9 +9,9 @@ import { writeManagementOverview } from './management.js';
6
9
  import { reconcileAccess, validatePrivateAudience } from './access.js';
7
10
  import { inspectApplicationResources } from './provision.js';
8
11
  import { cloudflareRequest } from './cloudflare.js';
9
- import { atomicJson, authenticate, defaultRunner, environment, readApplication, readConfig, targetDirectory, withApplicationLock, } from './project-state.js';
12
+ import { atomicJson, configurationFile, usesVoid, authenticate, defaultRunner, environment, readApplication, readConfig, targetDirectory, withApplicationLock, } from './project-state.js';
10
13
  export { registerApplication, readApplication, defaultRunner, environment, targetDirectory, } from './project-state.js';
11
- const manifestName = 'anhedral.project.json';
14
+ const manifestName = 'anhedral.json';
12
15
  const stateDirectory = '.anhedral';
13
16
  const accountPattern = /^[a-f0-9]{32}$/i;
14
17
  export async function connectApplication(root, accountId, audience, run = defaultRunner, emails = []) {
@@ -56,7 +59,7 @@ export async function connectApplication(root, accountId, audience, run = defaul
56
59
  else if (emails.length)
57
60
  throw new Error('--allow-email applies only to private delivery.');
58
61
  await authenticate(root, connected, run);
59
- atomicJson(path.join(root, manifestName), connected);
62
+ writeProjectSection(root, 'cloudflare', connected);
60
63
  return connected;
61
64
  });
62
65
  }
@@ -95,9 +98,9 @@ function checkTargets(root, project, allowResourcePlaceholders = false) {
95
98
  }
96
99
  }
97
100
  }
98
- if (/REPLACE_WITH_|YOUR_[A-Z_]+/.test(allowResourcePlaceholders
101
+ if (/REPLACE_WITH_|YOUR_[A-Z_]+/.test(allowResourcePlaceholders || usesVoid(project)
99
102
  ? JSON.stringify(pending)
100
- : readFileSync(path.join(directory, 'wrangler.jsonc'), 'utf8')))
103
+ : readFileSync(configurationFile(directory), 'utf8')))
101
104
  throw new Error('Configure selected resources before shipping; placeholder bindings remain.');
102
105
  const pkg = JSON.parse(readFileSync(path.join(directory, 'package.json'), 'utf8'));
103
106
  if (typeof pkg.scripts?.deploy !== 'string')
@@ -105,21 +108,41 @@ function checkTargets(root, project, allowResourcePlaceholders = false) {
105
108
  }
106
109
  }
107
110
  function configurationFingerprint(root, project) {
108
- const hash = createHash('sha256').update(JSON.stringify(project));
109
- for (const target of project.targets)
110
- hash.update(readFileSync(path.join(targetDirectory(root, target), 'wrangler.jsonc')));
111
+ const hash = createHash('sha256').update(readFileSync(projectConfigPath(root)));
112
+ for (const target of project.targets) {
113
+ const directory = targetDirectory(root, target);
114
+ hash.update(readFileSync(configurationFile(directory)));
115
+ if (usesVoid(project))
116
+ for (const name of ['void.config.ts', 'env.ts']) {
117
+ const file = path.join(directory, name);
118
+ hash.update(name).update(existsSync(file) ? readFileSync(file) : '<absent>');
119
+ }
120
+ }
111
121
  return hash.digest('hex');
112
122
  }
113
123
  export function planDelivery(root, allowResourcePlaceholders = false) {
114
124
  const project = readApplication(root);
115
125
  checkTargets(root, project, allowResourcePlaceholders);
126
+ if (usesVoid(project)) {
127
+ const owners = project.targets.filter((target) => {
128
+ // Ownership is authored. Void may add a conventional migrations_dir to
129
+ // resolved consumer locks; those consumers must not become migration owners.
130
+ const config = JSON.parse(readFileSync(configurationFile(targetDirectory(root, target)), 'utf8'));
131
+ return (Array.isArray(config.d1_databases) &&
132
+ config.d1_databases.some((database) => database?.migrations_dir));
133
+ });
134
+ if (owners.length > 1)
135
+ throw new Error('Void delivery requires one D1 migration owner; other server targets must consume the shared database without deployment migrations.');
136
+ }
116
137
  return {
117
138
  project,
118
139
  checks: [['pnpm', 'run', 'check']],
119
140
  deployments: project.targets.map((target) => ({
120
141
  target: target.id,
121
142
  directory: target.directory,
122
- command: ['pnpm', 'run', 'deploy'],
143
+ command: usesVoid(project)
144
+ ? ['pnpm', 'exec', 'void', 'deploy', '--platform', 'cloudflare']
145
+ : ['pnpm', 'run', 'deploy'],
123
146
  })),
124
147
  resourcesProvisioned: false,
125
148
  audience: project.audience,
@@ -175,6 +198,16 @@ function activeVersions(value) {
175
198
  throw new Error('Invalid provider traffic allocation.');
176
199
  return versions;
177
200
  }
201
+ async function providerStatus(root, project, target, run, request) {
202
+ if (!usesVoid(project))
203
+ return JSON.parse(await run('pnpm', ['exec', 'wrangler', 'deployments', 'status', '--json'], targetDirectory(root, target), environment(project)));
204
+ const api = request ??
205
+ (await cloudflareRequest(project, targetDirectory(root, target), run, environment(project)));
206
+ const result = (await api('GET', `/workers/scripts/${encodeURIComponent(target.workerName)}/deployments`)).result;
207
+ if (!Array.isArray(result?.deployments) || !result.deployments.length)
208
+ throw new Error('No active Cloudflare deployment evidence.');
209
+ return result.deployments[0];
210
+ }
178
211
  function fullyActive(versions, versionId) {
179
212
  return (versions.length === 1 && versions[0].versionId === versionId && versions[0].percentage === 100);
180
213
  }
@@ -209,9 +242,10 @@ function describeArchitecture(root, project) {
209
242
  };
210
243
  });
211
244
  }
212
- export async function shipApplication(root, run = defaultRunner, suppliedRequest) {
245
+ export async function shipApplication(root, run = defaultRunner, suppliedRequest, options = {}) {
213
246
  root = realpathSync(root);
214
- const { project } = planDelivery(root);
247
+ const registered = readApplication(root);
248
+ const { project } = planDelivery(root, usesVoid(registered));
215
249
  if (project.audience === 'unconfigured')
216
250
  throw new Error('Select an explicit audience before shipping: public or private with allowed members.');
217
251
  const env = environment(project);
@@ -233,6 +267,22 @@ export async function shipApplication(root, run = defaultRunner, suppliedRequest
233
267
  if (!/^[a-f0-9]{40,64}$/.test(commit))
234
268
  throw new Error('Invalid source commit.');
235
269
  const fingerprint = configurationFingerprint(root, project);
270
+ const lockChanges = new Set();
271
+ const sourceChanged = async () => {
272
+ const dirty = (await run('git', ['status', '--porcelain'], root, env)).trimEnd();
273
+ if (!dirty)
274
+ return false;
275
+ if (!usesVoid(project))
276
+ return true;
277
+ for (const line of dirty.split('\n')) {
278
+ const file = line.slice(3);
279
+ if (!/^ [M?]|^\?\?/.test(line) ||
280
+ !project.targets.some((target) => file === `${target.directory}/void.lock.json`))
281
+ return true;
282
+ lockChanges.add(file);
283
+ }
284
+ return false;
285
+ };
236
286
  records = history(root, project);
237
287
  release = {
238
288
  operation: 'ship',
@@ -256,17 +306,61 @@ export async function shipApplication(root, run = defaultRunner, suppliedRequest
256
306
  for (const target of project.targets) {
257
307
  if (configurationFingerprint(root, readApplication(root)) !== fingerprint ||
258
308
  (await run('git', ['rev-parse', 'HEAD'], root, env)).trim() !== commit ||
259
- (await run('git', ['status', '--porcelain'], root, env)).trim())
309
+ (await sourceChanged()))
260
310
  throw new Error('Source or configuration changed during delivery; preserve the release record and rebuild.');
261
311
  const output = path.join(outputDirectory, `${target.id}.ndjson`);
262
- await run('pnpm', ['run', 'deploy'], targetDirectory(root, target), {
263
- ...env,
264
- WRANGLER_OUTPUT_FILE_PATH: output,
265
- });
266
- const receipt = parseDeploymentOutput(readFileSync(output, 'utf8'), target);
267
- release.targets.push(receipt);
312
+ let receipt;
313
+ if (usesVoid(project)) {
314
+ const before = voidLogSnapshot(options.voidLogsDirectory);
315
+ const startedAt = Date.now();
316
+ await deployVoidTarget(targetDirectory(root, target), run, env);
317
+ receipt = readVoidDeploymentReceipt(before, targetDirectory(root, target), target, startedAt, options.voidLogsDirectory);
318
+ release.targets.push(receipt);
319
+ save();
320
+ const api = suppliedRequest ??
321
+ (await cloudflareRequest(project, targetDirectory(root, target), run, env));
322
+ const visibility = (await api('GET', `/workers/scripts/${encodeURIComponent(target.workerName)}/subdomain`)).result;
323
+ const accountDomain = visibility?.enabled === true
324
+ ? (await api('GET', '/workers/subdomain')).result
325
+ : undefined;
326
+ const workersDevUrl = typeof accountDomain?.subdomain === 'string' &&
327
+ /^[a-z0-9-]+$/i.test(accountDomain.subdomain)
328
+ ? `https://${target.workerName}.${accountDomain.subdomain}.workers.dev`
329
+ : undefined;
330
+ const config = readConfig(targetDirectory(root, target));
331
+ const hasCustomDomains = Array.isArray(config.routes) &&
332
+ config.routes.some((route) => route?.custom_domain === true);
333
+ const domains = hasCustomDomains
334
+ ? (await api('GET', `/workers/domains?service=${encodeURIComponent(target.workerName)}`)).result
335
+ : [];
336
+ if (!Array.isArray(domains))
337
+ throw new Error('Cloudflare custom-domain evidence is unavailable.');
338
+ receipt.urls = Array.isArray(config.routes)
339
+ ? config.routes.flatMap((route) => {
340
+ if (!route || typeof route !== 'object')
341
+ return [];
342
+ const value = route;
343
+ return value.custom_domain === true &&
344
+ typeof value.pattern === 'string' &&
345
+ /^[a-z0-9.-]+$/i.test(value.pattern) &&
346
+ domains.some((domain) => domain?.hostname === value.pattern && domain?.service === target.workerName)
347
+ ? [`https://${value.pattern}`]
348
+ : [];
349
+ })
350
+ : [];
351
+ if (workersDevUrl)
352
+ receipt.urls.push(workersDevUrl);
353
+ }
354
+ else {
355
+ await run('pnpm', ['run', 'deploy'], targetDirectory(root, target), {
356
+ ...env,
357
+ WRANGLER_OUTPUT_FILE_PATH: output,
358
+ });
359
+ receipt = parseDeploymentOutput(readFileSync(output, 'utf8'), target);
360
+ release.targets.push(receipt);
361
+ }
268
362
  save();
269
- const provider = JSON.parse(await run('pnpm', ['exec', 'wrangler', 'deployments', 'status', '--json'], targetDirectory(root, target), env));
363
+ const provider = await providerStatus(root, project, target, run, suppliedRequest);
270
364
  if (!fullyActive(activeVersions(provider), receipt.versionId))
271
365
  throw new Error('Provider active version differs from the deployment receipt.');
272
366
  if (accessRequest)
@@ -276,9 +370,16 @@ export async function shipApplication(root, run = defaultRunner, suppliedRequest
276
370
  }
277
371
  if (configurationFingerprint(root, readApplication(root)) !== fingerprint ||
278
372
  (await run('git', ['rev-parse', 'HEAD'], root, env)).trim() !== commit ||
279
- (await run('git', ['status', '--porcelain'], root, env)).trim())
373
+ (await sourceChanged()))
280
374
  throw new Error('Source or configuration changed during deployment.');
281
- release.state = 'deployed';
375
+ if (usesVoid(project)) {
376
+ const api = suppliedRequest ??
377
+ (await cloudflareRequest(project, targetDirectory(root, project.targets[0]), run, env));
378
+ await inspectApplicationResources(root, api);
379
+ }
380
+ release.state = lockChanges.size ? 'configuration-required' : 'deployed';
381
+ if (lockChanges.size)
382
+ release.configurationChanges = [...lockChanges].sort();
282
383
  release.finishedAt = new Date().toISOString();
283
384
  save();
284
385
  const managementFile = writeManagementOverview(root, await applicationStatus(root));
@@ -287,6 +388,14 @@ export async function shipApplication(root, run = defaultRunner, suppliedRequest
287
388
  release,
288
389
  managementFile,
289
390
  productVerification: 'required',
391
+ ...(lockChanges.size
392
+ ? {
393
+ state: 'configuration-required',
394
+ deployed: false,
395
+ activated: true,
396
+ nextAction: 'Review and commit the recorded void.lock.json resource identities, then ship the clean committed configuration before running verify. Active target receipts are retained; product verification has not passed.',
397
+ }
398
+ : {}),
290
399
  management: `https://dash.cloudflare.com/${project.accountId}/workers-and-pages`,
291
400
  };
292
401
  }
@@ -314,7 +423,7 @@ export async function applicationStatus(root, refresh = false, run = defaultRunn
314
423
  checkTargets(root, project);
315
424
  await authenticate(root, project, run);
316
425
  for (const target of project.targets) {
317
- const data = JSON.parse(await run('pnpm', ['exec', 'wrangler', 'deployments', 'status', '--json'], targetDirectory(root, target), environment(project)));
426
+ const data = await providerStatus(root, project, target, run);
318
427
  const receipt = current?.targets.find((item) => item.target === target.id);
319
428
  const versions = activeVersions(data);
320
429
  provider.push({
@@ -428,7 +537,9 @@ export async function rollbackApplication(root, releaseId, dataCompatible, run =
428
537
  // Resolve every version before changing the first target; unavailable resources still make provider rollback fail closed.
429
538
  for (const target of project.targets) {
430
539
  const version = desired.targets.find((item) => item.target === target.id);
431
- const data = JSON.parse(await run('pnpm', ['exec', 'wrangler', 'versions', 'view', version.versionId, '--json'], targetDirectory(root, target), env));
540
+ const data = usesVoid(project)
541
+ ? (await (request ?? (await cloudflareRequest(project, targetDirectory(root, target), run, env)))('GET', `/workers/scripts/${encodeURIComponent(target.workerName)}/versions/${encodeURIComponent(version.versionId)}`)).result
542
+ : JSON.parse(await run('pnpm', ['exec', 'wrangler', 'versions', 'view', version.versionId, '--json'], targetDirectory(root, target), env));
432
543
  if (data.id !== version.versionId)
433
544
  throw new Error('Recorded Worker version is unavailable.');
434
545
  }
@@ -447,18 +558,21 @@ export async function rollbackApplication(root, releaseId, dataCompatible, run =
447
558
  try {
448
559
  for (const target of [...project.targets].reverse()) {
449
560
  const receipt = desired.targets.find((item) => item.target === target.id);
450
- await run('pnpm', [
451
- 'exec',
452
- 'wrangler',
453
- 'rollback',
454
- receipt.versionId,
455
- '--message',
456
- `Anhedral restore ${desired.id}`,
457
- ], targetDirectory(root, target), env);
561
+ if (usesVoid(project))
562
+ await rollbackVoidTarget(targetDirectory(root, target), receipt.versionId, run, env);
563
+ else
564
+ await run('pnpm', [
565
+ 'exec',
566
+ 'wrangler',
567
+ 'rollback',
568
+ receipt.versionId,
569
+ '--message',
570
+ `Anhedral restore ${desired.id}`,
571
+ ], targetDirectory(root, target), env);
458
572
  const restored = { ...receipt, providerConfirmed: false };
459
573
  release.targets.push(restored);
460
574
  save();
461
- const provider = JSON.parse(await run('pnpm', ['exec', 'wrangler', 'deployments', 'status', '--json'], targetDirectory(root, target), env));
575
+ const provider = await providerStatus(root, project, target, run);
462
576
  if (!fullyActive(activeVersions(provider), receipt.versionId))
463
577
  throw new Error('Rollback version did not become fully active.');
464
578
  if (request)
@@ -510,12 +624,15 @@ export async function recoverApplication(root, run = defaultRunner, suppliedRequ
510
624
  const commit = await source();
511
625
  const fingerprint = configurationFingerprint(root, project);
512
626
  if ((await run('git', ['show', `HEAD:${manifestName}`], root, env)) !==
513
- readFileSync(path.join(root, manifestName), 'utf8'))
627
+ readFileSync(projectConfigPath(root), 'utf8'))
514
628
  throw new Error('Recovery requires the exact committed application manifest.');
515
629
  for (const target of project.targets) {
516
- const file = `${target.directory}/wrangler.jsonc`;
630
+ const file = path
631
+ .relative(root, configurationFile(targetDirectory(root, target)))
632
+ .split(path.sep)
633
+ .join('/');
517
634
  if ((await run('git', ['show', `HEAD:${file}`], root, env)) !==
518
- readFileSync(path.join(targetDirectory(root, target), 'wrangler.jsonc'), 'utf8'))
635
+ readFileSync(configurationFile(targetDirectory(root, target)), 'utf8'))
519
636
  throw new Error('Recovery requires exact committed Worker configuration.');
520
637
  }
521
638
  await authenticate(root, project, run);
@@ -562,7 +679,7 @@ export async function recoverApplication(root, run = defaultRunner, suppliedRequ
562
679
  for (const field of ['queues', 'durable_objects', 'workflows', 'hyperdrive', 'pipelines'])
563
680
  if (config[field])
564
681
  unsupportedBindings.add(field);
565
- const versions = activeVersions(JSON.parse(await run('pnpm', ['exec', 'wrangler', 'deployments', 'status', '--json'], directory, env)));
682
+ const versions = activeVersions(await providerStatus(root, project, target, run, request));
566
683
  if (!versions.length)
567
684
  throw new Error('No active Worker deployment to recover.');
568
685
  provider.push({
@@ -579,7 +696,7 @@ export async function recoverApplication(root, run = defaultRunner, suppliedRequ
579
696
  throw new Error('Source or configuration changed during recovery.');
580
697
  const records = history(root, project);
581
698
  for (const target of project.targets) {
582
- const after = activeVersions(JSON.parse(await run('pnpm', ['exec', 'wrangler', 'deployments', 'status', '--json'], targetDirectory(root, target), env)));
699
+ const after = activeVersions(await providerStatus(root, project, target, run));
583
700
  if (JSON.stringify(after) !==
584
701
  JSON.stringify(provider.find((item) => item.target === target.id).versions))
585
702
  throw new Error('Active deployment changed during recovery.');
@@ -14,9 +14,16 @@ export declare const SHADCN_VERSION = "4.21.4";
14
14
  export declare const NEXT_VERCEL_VERSION = "16.4.0";
15
15
  export declare const NEXT_OPENNEXT_VERSION = "16.3.8";
16
16
  export declare const STACK_DEPENDENCIES: {
17
+ readonly '@typescript-eslint/parser': "8.71.2";
18
+ readonly '@typescript-eslint/eslint-plugin': "8.71.2";
19
+ readonly '@next/eslint-plugin-next': "16.4.2";
20
+ readonly turbo: "2.11.7";
21
+ readonly tsx: "4.23.15";
17
22
  readonly 'better-auth': "1.7.7";
18
23
  readonly '@better-auth/drizzle-adapter': "1.7.7";
19
24
  readonly '@neondatabase/serverless': "1.2.0";
25
+ readonly '@neon/realtime': "0.1.0";
26
+ readonly '@neon/realtime-drizzle': "0.1.0";
20
27
  readonly 'drizzle-orm': "0.45.4";
21
28
  readonly '@clerk/nextjs': "7.9.14";
22
29
  readonly '@clerk/backend': "3.23.2";
@@ -62,3 +69,20 @@ export declare const WORKER_DEV_PORTS: {
62
69
  readonly inspector: 9235;
63
70
  };
64
71
  };
72
+ /** Compatible security overrides are catalog pins and must be audited too. */
73
+ export declare const SECURITY_OVERRIDE_DEPENDENCIES: {
74
+ readonly '@vitejs/plugin-react': "5.2.0";
75
+ readonly sharp: "0.35.5";
76
+ readonly 'source-map-js': "1.2.2";
77
+ readonly 'shell-quote': "1.12.0";
78
+ readonly tmp: "0.2.7";
79
+ readonly 'adm-zip': "0.6.1";
80
+ readonly 'baseline-browser-mapping': "2.11.27";
81
+ readonly browserslist: "4.29.3";
82
+ readonly esbuild: "0.25.12";
83
+ };
84
+ export declare const GLOB_10_OVERRIDE_VERSION = "10.5.0";
85
+ export declare const GLOB_11_OVERRIDE_VERSION = "11.1.0";
86
+ export declare const BRACE_EXPANSION_1_OVERRIDE_VERSION = "1.1.21";
87
+ export declare const BRACE_EXPANSION_2_OVERRIDE_VERSION = "2.1.7";
88
+ export declare const BRACE_EXPANSION_5_OVERRIDE_VERSION = "5.0.12";
@@ -142,12 +142,26 @@ export const NEXT_VERCEL_VERSION = '16.4.0';
142
142
  // renovate: datasource=npm depName=next
143
143
  export const NEXT_OPENNEXT_VERSION = '16.3.8';
144
144
  export const STACK_DEPENDENCIES = {
145
+ // renovate: datasource=npm depName=@typescript-eslint/parser
146
+ '@typescript-eslint/parser': '8.71.2',
147
+ // renovate: datasource=npm depName=@typescript-eslint/eslint-plugin
148
+ '@typescript-eslint/eslint-plugin': '8.71.2',
149
+ // renovate: datasource=npm depName=@next/eslint-plugin-next
150
+ '@next/eslint-plugin-next': '16.4.2',
151
+ // renovate: datasource=npm depName=turbo
152
+ turbo: '2.11.7',
153
+ // renovate: datasource=npm depName=tsx
154
+ tsx: '4.23.15',
145
155
  // renovate: datasource=npm depName=better-auth
146
156
  'better-auth': '1.7.7',
147
157
  // renovate: datasource=npm depName=@better-auth/drizzle-adapter
148
158
  '@better-auth/drizzle-adapter': '1.7.7',
149
159
  // renovate: datasource=npm depName=@neondatabase/serverless
150
160
  '@neondatabase/serverless': '1.2.0',
161
+ // renovate: datasource=npm depName=@neon/realtime
162
+ '@neon/realtime': '0.1.0',
163
+ // renovate: datasource=npm depName=@neon/realtime-drizzle
164
+ '@neon/realtime-drizzle': '0.1.0',
151
165
  // renovate: datasource=npm depName=drizzle-orm
152
166
  'drizzle-orm': '0.45.4',
153
167
  // renovate: datasource=npm depName=@clerk/nextjs
@@ -220,3 +234,37 @@ export const WORKER_DEV_PORTS = {
220
234
  scheduled: { http: 8790, inspector: 9234 },
221
235
  workflows: { http: 8791, inspector: 9235 },
222
236
  };
237
+ /** Compatible security overrides are catalog pins and must be audited too. */
238
+ export const SECURITY_OVERRIDE_DEPENDENCIES = {
239
+ // renovate: datasource=npm depName=@vitejs/plugin-react
240
+ '@vitejs/plugin-react': '5.2.0',
241
+ // renovate: datasource=npm depName=sharp
242
+ sharp: '0.35.5',
243
+ // renovate: datasource=npm depName=source-map-js
244
+ 'source-map-js': '1.2.2',
245
+ // renovate: datasource=npm depName=shell-quote
246
+ 'shell-quote': '1.12.0',
247
+ // renovate: datasource=npm depName=tmp
248
+ tmp: '0.2.7',
249
+ // renovate: datasource=npm depName=adm-zip
250
+ 'adm-zip': '0.6.1',
251
+ // renovate: datasource=npm depName=baseline-browser-mapping
252
+ 'baseline-browser-mapping': '2.11.27',
253
+ // renovate: datasource=npm depName=browserslist
254
+ browserslist: '4.29.3',
255
+ // renovate: datasource=npm depName=esbuild
256
+ esbuild: '0.25.12',
257
+ };
258
+ // Keep each compatible major independently reviewed.
259
+ // renovate: datasource=npm depName=glob
260
+ export const GLOB_10_OVERRIDE_VERSION = '10.5.0';
261
+ // renovate: datasource=npm depName=glob
262
+ export const GLOB_11_OVERRIDE_VERSION = '11.1.0';
263
+ // renovate: datasource=npm depName=brace-expansion
264
+ export const BRACE_EXPANSION_1_OVERRIDE_VERSION = '1.1.21';
265
+ // renovate: datasource=npm depName=brace-expansion
266
+ export const BRACE_EXPANSION_2_OVERRIDE_VERSION = '2.1.7';
267
+ // No blanket 3.x override: GHSA-3jxr-9vmj-r5cp lists no repaired 3.x
268
+ // release, and supported locked profiles do not consume that major.
269
+ // renovate: datasource=npm depName=brace-expansion
270
+ export const BRACE_EXPANSION_5_OVERRIDE_VERSION = '5.0.12';
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Apply only explicitly reviewed temporary patches to the exact resolved
3
+ * package. Standard pnpm audit remains unchanged and reports its advisory.
4
+ */
5
+ export declare function configureDependencyPatches(root: string): boolean;
6
+ /** Install the standard audit gate for every profile, including braces-free apps. */
7
+ export declare function writeDependencyAudit(root: string, replaceManaged?: boolean): void;
@@ -0,0 +1,125 @@
1
+ import { existsSync, lstatSync, mkdirSync, realpathSync, writeFileSync } from 'node:fs';
2
+ import path from 'node:path';
3
+ import { fileURLToPath } from 'node:url';
4
+ import { readBoundedFile } from './bounded-file.js';
5
+ import { pnpmPatchPolicy } from './pnpm-policy.js';
6
+ import { writeFile } from './util.js';
7
+ // Additional coordinates require reviewed fixes for every shipped entry point.
8
+ const reviewedPatches = [
9
+ { coordinate: 'braces@3.0.3', packageName: 'braces', license: 'LICENSE.braces' },
10
+ { coordinate: 'node-forge@1.4.0', packageName: 'node-forge', license: 'LICENSE.node-forge' },
11
+ ];
12
+ const lockMaximum = 16 * 1024 * 1024;
13
+ const policyMaximum = 2 * 1024 * 1024;
14
+ const patchMaximum = 256 * 1024;
15
+ const patchAssetMaximum = 2 * 1024 * 1024;
16
+ function patchAttributes(source, selected) {
17
+ const rules = selected.flatMap(({ coordinate, license }) => [
18
+ `/patches/${coordinate}.patch text eol=lf -whitespace`,
19
+ `/patches/${license} text eol=lf`,
20
+ ]);
21
+ const newline = source.includes('\r\n') ? '\r\n' : '\n';
22
+ const lines = source.split(/(?<=\n)/);
23
+ // Keep every unrelated rule/comment byte-for-byte, then make these exact
24
+ // asset rules last so a customer wildcard cannot convert patch line endings.
25
+ const preserved = lines.filter((line) => !rules.includes(line.replace(/\r?\n$/, ''))).join('');
26
+ return (preserved +
27
+ (preserved && !/\r?\n$/.test(preserved) ? newline : '') +
28
+ rules.join(newline) +
29
+ newline);
30
+ }
31
+ /**
32
+ * Apply only explicitly reviewed temporary patches to the exact resolved
33
+ * package. Standard pnpm audit remains unchanged and reports its advisory.
34
+ */
35
+ export function configureDependencyPatches(root) {
36
+ root = realpathSync(root);
37
+ const lock = readBoundedFile(path.join(root, 'pnpm-lock.yaml'), lockMaximum).toString('utf8');
38
+ const selected = reviewedPatches.filter(({ coordinate }) => {
39
+ const escaped = [...coordinate]
40
+ .map((character) => ('.^$|?*+()[]{}\\'.includes(character) ? `\\${character}` : character))
41
+ .join('');
42
+ return new RegExp(String.raw `^ ['"]?${escaped}(?:\([^'"\r\n]*\))?['"]?:[ \t]*(?:\r?\n|$)`, 'm').test(lock);
43
+ });
44
+ if (!selected.length)
45
+ return false;
46
+ const manifestFile = path.join(root, 'package.json');
47
+ if (existsSync(manifestFile)) {
48
+ const manifest = JSON.parse(readBoundedFile(manifestFile, policyMaximum).toString('utf8'));
49
+ if (manifest.pnpm && Object.hasOwn(manifest.pnpm, 'patchedDependencies'))
50
+ throw new Error('Review package-level pnpm.patchedDependencies before configuring a workspace patch; existing patch maps must not be shadowed.');
51
+ }
52
+ const workspaceFile = path.join(root, 'pnpm-workspace.yaml');
53
+ const before = readBoundedFile(workspaceFile, policyMaximum).toString('utf8');
54
+ const after = selected.reduce((policy, { coordinate }) => pnpmPatchPolicy(policy, coordinate, `patches/${coordinate}.patch`), before);
55
+ const attributesFile = path.join(root, '.gitattributes');
56
+ const attributesStat = lstatSync(attributesFile, { throwIfNoEntry: false });
57
+ const attributesBefore = attributesStat
58
+ ? readBoundedFile(attributesFile, policyMaximum).toString('utf8')
59
+ : '';
60
+ const attributesAfter = patchAttributes(attributesBefore, selected);
61
+ const directory = path.join(root, 'patches');
62
+ const directoryStat = lstatSync(directory, { throwIfNoEntry: false });
63
+ if (directoryStat && (!directoryStat.isDirectory() || directoryStat.isSymbolicLink()))
64
+ throw new Error('Patch directory must be a real directory inside the project.');
65
+ const artifacts = selected
66
+ .flatMap(({ coordinate, packageName, license }) => [
67
+ { name: `${coordinate}.patch`, packageName, label: 'patch' },
68
+ { name: license, packageName, label: 'license notice' },
69
+ ])
70
+ .map(({ name, label, packageName }) => ({
71
+ target: path.join(directory, name),
72
+ label,
73
+ packageName,
74
+ maximum: name.endsWith('.patch') ? patchAssetMaximum : patchMaximum,
75
+ bytes: readBoundedFile(fileURLToPath(new URL(`../assets/patches/${name}`, import.meta.url)), name.endsWith('.patch') ? patchAssetMaximum : patchMaximum),
76
+ }));
77
+ const missing = [];
78
+ // Validate every destination before writing any artifact or the YAML map.
79
+ for (const artifact of artifacts) {
80
+ if (lstatSync(artifact.target, { throwIfNoEntry: false })) {
81
+ if (!readBoundedFile(artifact.target, artifact.maximum).equals(artifact.bytes))
82
+ throw new Error(`The ${artifact.packageName} ${artifact.label} path already contains different customer content.`);
83
+ }
84
+ else
85
+ missing.push(artifact);
86
+ }
87
+ if (!missing.length && after === before && attributesAfter === attributesBefore)
88
+ return false;
89
+ if (missing.length)
90
+ mkdirSync(directory, { recursive: true });
91
+ for (const artifact of missing)
92
+ writeFileSync(artifact.target, artifact.bytes, { flag: 'wx', mode: 0o644 });
93
+ if (after !== before)
94
+ writeFile(workspaceFile, after);
95
+ if (attributesAfter !== attributesBefore) {
96
+ if (attributesStat)
97
+ writeFile(attributesFile, attributesAfter);
98
+ else
99
+ writeFileSync(attributesFile, attributesAfter, { flag: 'wx', mode: 0o644 });
100
+ }
101
+ return true;
102
+ }
103
+ /** Install the standard audit gate for every profile, including braces-free apps. */
104
+ export function writeDependencyAudit(root, replaceManaged = false) {
105
+ root = realpathSync(root);
106
+ const trusted = readBoundedFile(fileURLToPath(new URL('../assets/patches/audit-deps.mjs', import.meta.url)), patchMaximum);
107
+ const directory = path.join(root, 'scripts');
108
+ const directoryStat = lstatSync(directory, { throwIfNoEntry: false });
109
+ if (directoryStat && (!directoryStat.isDirectory() || directoryStat.isSymbolicLink()))
110
+ throw new Error('Audit script directory must be a real directory inside the project.');
111
+ const target = path.join(directory, 'audit-deps.mjs');
112
+ if (lstatSync(target, { throwIfNoEntry: false })) {
113
+ const current = readBoundedFile(target, patchMaximum);
114
+ if (current.equals(trusted))
115
+ return;
116
+ if (!replaceManaged)
117
+ throw new Error('The dependency audit script path contains different customer content.');
118
+ // Replacements occur only inside the add staging transaction. Its source
119
+ // fingerprints reject edited or untracked customer files before commit.
120
+ writeFile(target, trusted.toString('utf8'));
121
+ return;
122
+ }
123
+ mkdirSync(directory, { recursive: true });
124
+ writeFileSync(target, trusted, { flag: 'wx', mode: 0o644 });
125
+ }
package/dist/index.d.ts CHANGED
@@ -7,6 +7,7 @@ export { inspectProject, validateSetupPlan } from './readiness.js';
7
7
  export { registerApplication, readApplication, connectApplication, planDelivery, shipApplication, applicationStatus, verifyApplication, rollbackApplication, recoverApplication, } from './delivery.js';
8
8
  export type { ApplicationProject, DeploymentTarget, DeliveryRunner } from './delivery.js';
9
9
  export { planProvisioning, provisionApplication } from './provision.js';
10
+ export { supportsVoidRuntime, VOID_VERSION, VOID_NODE_ENGINE } from './void.js';
10
11
  export { registerVercelApplication, connectVercelApplication, planVercelDelivery, shipVercelApplication, vercelApplicationStatus, verifyVercelApplication, rollbackVercelApplication, adoptVercelApplication, recoverVercelApplication, } from './vercel.js';
11
12
  export { setupRepository, githubRepository } from './repository.js';
12
13
  export { inspectProviderReadiness } from './provider-readiness.js';
@@ -41,3 +42,5 @@ export type { CapabilitySupport, CapabilityEvidence, CapabilityStage, ProductCap
41
42
  export { recoverDeliveryLock } from './project-state.js';
42
43
  export { inspectApplication } from './project-inspector.js';
43
44
  export type { ProjectInspection } from './inspector-model.js';
45
+ export { PROJECT_CONFIG_FILE, readProjectConfig, readProjectSection, writeProjectSection, hasProjectSection, } from './project-config.js';
46
+ export type { ProjectConfig, ProjectSection } from './project-config.js';
package/dist/index.js CHANGED
@@ -4,6 +4,7 @@ export { CAPABILITIES, CAPABILITY_REGISTRY, createSetupPlan } from './capabiliti
4
4
  export { inspectProject, validateSetupPlan } from './readiness.js';
5
5
  export { registerApplication, readApplication, connectApplication, planDelivery, shipApplication, applicationStatus, verifyApplication, rollbackApplication, recoverApplication, } from './delivery.js';
6
6
  export { planProvisioning, provisionApplication } from './provision.js';
7
+ export { supportsVoidRuntime, VOID_VERSION, VOID_NODE_ENGINE } from './void.js';
7
8
  export { registerVercelApplication, connectVercelApplication, planVercelDelivery, shipVercelApplication, vercelApplicationStatus, verifyVercelApplication, rollbackVercelApplication, adoptVercelApplication, recoverVercelApplication, } from './vercel.js';
8
9
  export { setupRepository, githubRepository } from './repository.js';
9
10
  export { inspectProviderReadiness } from './provider-readiness.js';
@@ -26,3 +27,4 @@ export { integrationStatus, recoverIntegrationResource } from './providers/recov
26
27
  export { CAPABILITY_CONTRACT, formatCapabilityContract } from './capability-contract.js';
27
28
  export { recoverDeliveryLock } from './project-state.js';
28
29
  export { inspectApplication } from './project-inspector.js';
30
+ export { PROJECT_CONFIG_FILE, readProjectConfig, readProjectSection, writeProjectSection, hasProjectSection, } from './project-config.js';