anhedral 0.10.1 → 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.
- package/README.md +79 -124
- package/assets/patches/LICENSE.braces +21 -0
- package/assets/patches/LICENSE.node-forge +50 -0
- package/assets/patches/audit-deps.mjs +167 -0
- package/assets/patches/braces@3.0.3.patch +127 -0
- package/assets/patches/node-forge@1.4.0.patch +41 -0
- package/dist/auth-schema.js +3 -3
- package/dist/bin.js +284 -163
- package/dist/capabilities.d.ts +4 -4
- package/dist/capabilities.js +6 -2
- package/dist/capability-contract.d.ts +47 -0
- package/dist/capability-contract.js +153 -0
- package/dist/catalog-model.d.ts +24 -0
- package/dist/catalog-model.js +1 -0
- package/dist/catalog-registration.d.ts +16 -0
- package/dist/catalog-registration.js +22 -0
- package/dist/catalog-snapshot.d.ts +5 -0
- package/dist/catalog-snapshot.js +97 -0
- package/dist/cli-arguments.d.ts +16 -0
- package/dist/cli-arguments.js +115 -0
- package/dist/cli-output.d.ts +8 -0
- package/dist/cli-output.js +236 -0
- package/dist/cloudflare.d.ts +14 -3
- package/dist/cloudflare.js +196 -36
- package/dist/command-schema.d.ts +21 -0
- package/dist/command-schema.js +418 -0
- package/dist/delivery.d.ts +12 -5
- package/dist/delivery.js +173 -39
- package/dist/dependencies.d.ts +24 -0
- package/dist/dependencies.js +48 -0
- package/dist/dependency-patches.d.ts +7 -0
- package/dist/dependency-patches.js +125 -0
- package/dist/index.d.ts +26 -1
- package/dist/index.js +17 -1
- package/dist/inspector-model.d.ts +123 -0
- package/dist/inspector-model.js +1 -0
- package/dist/integration-service-readers.d.ts +13 -0
- package/dist/integration-service-readers.js +173 -0
- package/dist/lifecycle-model.d.ts +15 -0
- package/dist/lifecycle-model.js +20 -0
- package/dist/lifecycle.d.ts +11 -0
- package/dist/lifecycle.js +91 -0
- package/dist/mobile-delivery.d.ts +100 -0
- package/dist/mobile-delivery.js +319 -0
- package/dist/neon-service-data.d.ts +8 -0
- package/dist/neon-service-data.js +117 -0
- package/dist/platforms/mobile.js +8 -5
- package/dist/pnpm-policy.d.ts +2 -2
- package/dist/pnpm-policy.js +19 -45
- package/dist/project-catalog.d.ts +41 -0
- package/dist/project-catalog.js +288 -0
- package/dist/project-config.d.ts +14 -0
- package/dist/project-config.js +89 -0
- package/dist/project-inspector.d.ts +4 -0
- package/dist/project-inspector.js +702 -0
- package/dist/project-lifecycle.d.ts +25 -0
- package/dist/project-lifecycle.js +57 -0
- package/dist/project-state.d.ts +22 -1
- package/dist/project-state.js +361 -27
- package/dist/provider-auth.d.ts +41 -0
- package/dist/provider-auth.js +209 -0
- package/dist/provider-readiness.js +27 -10
- package/dist/providers/adapters.d.ts +17 -0
- package/dist/providers/adapters.js +272 -0
- package/dist/providers/api.d.ts +29 -0
- package/dist/providers/api.js +253 -0
- package/dist/providers/config.d.ts +15 -0
- package/dist/providers/config.js +182 -0
- package/dist/providers/definitions.d.ts +318 -0
- package/dist/providers/definitions.js +127 -0
- package/dist/providers/provision.d.ts +24 -0
- package/dist/providers/provision.js +76 -0
- package/dist/providers/receipts.d.ts +20 -0
- package/dist/providers/receipts.js +66 -0
- package/dist/providers/recovery-verification.d.ts +7 -0
- package/dist/providers/recovery-verification.js +112 -0
- package/dist/providers/recovery.d.ts +30 -0
- package/dist/providers/recovery.js +34 -0
- package/dist/providers/runtime.d.ts +10 -0
- package/dist/providers/runtime.js +254 -0
- package/dist/providers/schema.d.ts +28 -0
- package/dist/providers/schema.js +49 -0
- package/dist/providers/state.d.ts +55 -0
- package/dist/providers/state.js +289 -0
- package/dist/provision.d.ts +10 -1
- package/dist/provision.js +91 -4
- package/dist/r2-service-data.d.ts +2 -0
- package/dist/r2-service-data.js +136 -0
- package/dist/readiness.js +9 -13
- package/dist/registry/add.d.ts +6 -0
- package/dist/registry/add.js +93 -22
- package/dist/registry/commands.d.ts +3 -2
- package/dist/registry/commands.js +52 -15
- package/dist/registry/options.d.ts +1 -1
- package/dist/registry/options.js +5 -4
- package/dist/registry/preview.d.ts +11 -0
- package/dist/registry/preview.js +91 -0
- package/dist/registry/receipt.d.ts +1 -0
- package/dist/registry/receipt.js +19 -4
- package/dist/registry/resolve.js +5 -1
- package/dist/registry/usage.d.ts +10 -0
- package/dist/registry/usage.js +18 -37
- package/dist/render.d.ts +2 -0
- package/dist/render.js +6 -0
- package/dist/runtime-policy.d.ts +4 -0
- package/dist/runtime-policy.js +21 -0
- package/dist/scaffold/auth.js +3 -19
- package/dist/scaffold/bootstrap.js +2 -2
- package/dist/scaffold/compose.js +9 -3
- package/dist/scaffold/database.js +107 -25
- package/dist/scaffold/documentation.js +18 -13
- package/dist/scaffold/lint.d.ts +4 -0
- package/dist/scaffold/lint.js +56 -0
- package/dist/scaffold/neon-realtime.d.ts +2 -0
- package/dist/scaffold/neon-realtime.js +97 -0
- package/dist/scaffold/stack-documentation.js +1 -1
- package/dist/scaffold/void.d.ts +4 -0
- package/dist/scaffold/void.js +256 -0
- package/dist/scaffold/web.js +7 -1
- package/dist/scaffold/workspace.js +127 -25
- package/dist/service-deletion.d.ts +29 -0
- package/dist/service-deletion.js +195 -0
- package/dist/service-descriptor.d.ts +10 -0
- package/dist/service-descriptor.js +78 -0
- package/dist/service-model.d.ts +49 -0
- package/dist/service-model.js +8 -0
- package/dist/service-operations.d.ts +29 -0
- package/dist/service-operations.js +78 -0
- package/dist/service-readers.d.ts +8 -0
- package/dist/service-readers.js +247 -0
- package/dist/services-command.d.ts +39 -0
- package/dist/services-command.js +100 -0
- package/dist/ship.d.ts +348 -0
- package/dist/ship.js +237 -0
- package/dist/stack-registry.d.ts +4 -2
- package/dist/stack-registry.js +48 -12
- package/dist/standard.d.ts +2 -1
- package/dist/standard.js +33 -14
- package/dist/transaction.d.ts +2 -0
- package/dist/transaction.js +10 -0
- package/dist/util.js +17 -2
- package/dist/vercel.d.ts +5 -3
- package/dist/vercel.js +96 -14
- package/dist/version.d.ts +1 -1
- package/dist/version.js +1 -1
- package/dist/vinext.d.ts +1 -0
- package/dist/vinext.js +13 -1
- package/dist/void-execution.d.ts +10 -0
- package/dist/void-execution.js +94 -0
- package/dist/void-migrations.d.ts +6 -0
- package/dist/void-migrations.js +110 -0
- package/dist/void-state.d.ts +16 -0
- package/dist/void-state.js +65 -0
- package/dist/void.d.ts +3 -0
- package/dist/void.js +5 -0
- package/docs/cli-design.md +67 -0
- package/docs/delivery-workflow.md +32 -17
- package/docs/plugin-ui.md +102 -0
- package/docs/provider-configuration.md +116 -0
- package/docs/stack-standard.md +175 -0
- package/docs/void-verification.md +185 -0
- package/package.json +29 -23
- package/assets/anhedral-cli-init-technical.svg +0 -322
- package/assets/anhedral-cli-init.svg +0 -322
- package/assets/anhedral-mark.svg +0 -4
- package/assets/anhedral.svg +0 -4
- package/assets/favicon.ico +0 -0
- package/assets/security/LICENSES.txt +0 -63
- package/assets/security/audit-deps.mjs +0 -300
- package/assets/security/braces-regression.mjs +0 -102
- package/assets/security/braces@3.0.3.patch +0 -285
- package/assets/security/decode-uri-component@0.2.2.patch +0 -149
- package/assets/security/decoder-regression.mjs +0 -37
- package/assets/security/forge-regression.mjs +0 -46
- package/assets/security/manifest.json +0 -53
- package/assets/security/node-forge@1.4.0.patch +0 -26
- package/dist/managed-hosting.d.ts +0 -49
- package/dist/managed-hosting.js +0 -373
- package/dist/security-backports.d.ts +0 -3
- package/dist/security-backports.js +0 -26
- package/docs/application-stack-standard.md +0 -104
- package/docs/managed-hosting-architecture.md +0 -87
- package/docs/sponsorships.md +0 -25
|
@@ -0,0 +1,418 @@
|
|
|
1
|
+
import { STANDARD_PRODUCTS } from './stack-registry.js';
|
|
2
|
+
export const GLOBAL_OPTIONS = [
|
|
3
|
+
{
|
|
4
|
+
flag: '--cwd',
|
|
5
|
+
aliases: ['-c'],
|
|
6
|
+
value: 'directory',
|
|
7
|
+
arity: 'required',
|
|
8
|
+
description: 'Run from a selected working directory.',
|
|
9
|
+
},
|
|
10
|
+
{ flag: '--json', description: 'Return machine-readable output.' },
|
|
11
|
+
{
|
|
12
|
+
flag: '--quiet',
|
|
13
|
+
aliases: ['-q'],
|
|
14
|
+
description: 'Suppress human output; retain JSON and errors.',
|
|
15
|
+
},
|
|
16
|
+
{ flag: '--verbose', description: 'Show local scaffolding tool output (human mode only).' },
|
|
17
|
+
{ flag: '--help', aliases: ['-h'], description: 'Show command help.' },
|
|
18
|
+
];
|
|
19
|
+
export function optionHelp(option) {
|
|
20
|
+
const flags = [...(option.aliases ?? []), option.flag].join(', ');
|
|
21
|
+
const argument = option.arity === 'required'
|
|
22
|
+
? ` <${option.value}>`
|
|
23
|
+
: option.arity === 'optional'
|
|
24
|
+
? ` [${option.value}]`
|
|
25
|
+
: '';
|
|
26
|
+
return `${flags}${argument} ${option.description}`;
|
|
27
|
+
}
|
|
28
|
+
export function commandDefinition(command) {
|
|
29
|
+
return COMMANDS[command ?? ''];
|
|
30
|
+
}
|
|
31
|
+
export const COMMANDS = {
|
|
32
|
+
services: {
|
|
33
|
+
description: 'Inspect live Cloudflare services, analytics, data, or a confirmed resource deletion.',
|
|
34
|
+
usage: 'services list | status | metrics | tables | data | delete-plan | delete [service-key] [options]',
|
|
35
|
+
options: [
|
|
36
|
+
{
|
|
37
|
+
flag: '--hours',
|
|
38
|
+
value: '1|24|168',
|
|
39
|
+
arity: 'required',
|
|
40
|
+
description: 'Analytics window; D1 uses complete UTC days.',
|
|
41
|
+
},
|
|
42
|
+
{
|
|
43
|
+
flag: '--table',
|
|
44
|
+
value: 'table',
|
|
45
|
+
arity: 'required',
|
|
46
|
+
description: 'Existing database table or keys for KV metadata.',
|
|
47
|
+
},
|
|
48
|
+
{
|
|
49
|
+
flag: '--offset',
|
|
50
|
+
value: 'number',
|
|
51
|
+
arity: 'required',
|
|
52
|
+
description: 'Bounded database page offset.',
|
|
53
|
+
},
|
|
54
|
+
{
|
|
55
|
+
flag: '--cursor',
|
|
56
|
+
value: 'cursor',
|
|
57
|
+
arity: 'required',
|
|
58
|
+
description: 'Provider cursor for object metadata pages.',
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
flag: '--token',
|
|
62
|
+
value: 'token',
|
|
63
|
+
arity: 'required',
|
|
64
|
+
description: 'Single-use deletion-plan token.',
|
|
65
|
+
},
|
|
66
|
+
{
|
|
67
|
+
flag: '--confirm-name',
|
|
68
|
+
value: 'name',
|
|
69
|
+
arity: 'required',
|
|
70
|
+
description: 'Exact resource name from the deletion plan.',
|
|
71
|
+
},
|
|
72
|
+
],
|
|
73
|
+
examples: ['services list --json', 'services status binding:apps/api:D1:DB --json'],
|
|
74
|
+
note: 'Provider calls occur only when requested. Data output can contain private values. Deletion is limited to verified project-created D1/KV resources and requires a fresh plan and typed resource name.',
|
|
75
|
+
},
|
|
76
|
+
inspect: {
|
|
77
|
+
description: 'Inspect local stack, setup requirements and recorded delivery evidence.',
|
|
78
|
+
usage: 'inspect [directory] [options]',
|
|
79
|
+
options: [],
|
|
80
|
+
examples: ['inspect', 'inspect --json'],
|
|
81
|
+
note: 'Read-only and offline. Recorded results do not establish live provider status or permissions.',
|
|
82
|
+
},
|
|
83
|
+
integrations: {
|
|
84
|
+
description: 'Inspect private integration receipts or reconcile a verified pending resource.',
|
|
85
|
+
usage: 'integrations status | recover [directory] [options]',
|
|
86
|
+
options: [
|
|
87
|
+
{
|
|
88
|
+
flag: '--provider',
|
|
89
|
+
value: 'name',
|
|
90
|
+
arity: 'required',
|
|
91
|
+
description: 'Select a bundled integration provider for recovery.',
|
|
92
|
+
},
|
|
93
|
+
{
|
|
94
|
+
flag: '--operation',
|
|
95
|
+
value: 'hash',
|
|
96
|
+
arity: 'required',
|
|
97
|
+
description: 'Select the exact pending operation from status.',
|
|
98
|
+
},
|
|
99
|
+
{
|
|
100
|
+
flag: '--resource',
|
|
101
|
+
value: 'id',
|
|
102
|
+
arity: 'required',
|
|
103
|
+
description: 'Verify and adopt this existing resource; never recreate it.',
|
|
104
|
+
},
|
|
105
|
+
],
|
|
106
|
+
examples: [
|
|
107
|
+
'integrations status --json',
|
|
108
|
+
'integrations recover --provider neon --operation recorded-hash --resource existing-id',
|
|
109
|
+
],
|
|
110
|
+
note: 'Status is read-only. Recovery verifies provider identity before updating a local receipt. Unsupported receipt schemas are rejected. Recovery cannot reconstruct missing one-time credentials.',
|
|
111
|
+
},
|
|
112
|
+
init: {
|
|
113
|
+
description: 'Scaffold a project from the bundled stack registry.',
|
|
114
|
+
usage: 'init [directory] [products...] [options]',
|
|
115
|
+
options: [
|
|
116
|
+
...STANDARD_PRODUCTS.map((name) => ({
|
|
117
|
+
flag: `--${name}`,
|
|
118
|
+
description: `Include ${name}.`,
|
|
119
|
+
hidden: true,
|
|
120
|
+
})),
|
|
121
|
+
{
|
|
122
|
+
flag: '--hosting',
|
|
123
|
+
description: 'Select web hosting.',
|
|
124
|
+
value: 'cloudflare|vercel',
|
|
125
|
+
arity: 'required',
|
|
126
|
+
},
|
|
127
|
+
{
|
|
128
|
+
flag: '--skip-install',
|
|
129
|
+
description: 'Skip the final install (bootstrap still needs network).',
|
|
130
|
+
},
|
|
131
|
+
{ flag: '--git', description: 'Initialize a project repository or skip it.' },
|
|
132
|
+
{ flag: '--no-git', description: 'Initialize a project repository or skip it.' },
|
|
133
|
+
{ flag: '--dry-run', description: 'Preview the selected stack without writes or network.' },
|
|
134
|
+
],
|
|
135
|
+
examples: [
|
|
136
|
+
'init client-app',
|
|
137
|
+
'init mobile-app --expo',
|
|
138
|
+
'init product --next --hono --neon --clerk --dry-run',
|
|
139
|
+
],
|
|
140
|
+
note: `Default: Vinext on Cloudflare Workers, using the official shadcn pnpm/Turborepo monorepo.\nProducts: ${STANDARD_PRODUCTS.join(', ')}\nOnly bundled options are supported. --all is intentionally unsupported.`,
|
|
141
|
+
},
|
|
142
|
+
auth: {
|
|
143
|
+
description: 'Check or guide authentication for the selected providers.',
|
|
144
|
+
usage: 'auth [directory] [options]',
|
|
145
|
+
options: [
|
|
146
|
+
{
|
|
147
|
+
flag: '--provider',
|
|
148
|
+
description: 'Check one provider required by this project.',
|
|
149
|
+
value: 'name',
|
|
150
|
+
arity: 'required',
|
|
151
|
+
},
|
|
152
|
+
{ flag: '--status', description: 'Check existing access without opening login.' },
|
|
153
|
+
{ flag: '--non-interactive', description: 'Never open an interactive login.' },
|
|
154
|
+
],
|
|
155
|
+
examples: ['auth', 'auth --status --json', 'auth --provider neon'],
|
|
156
|
+
note: 'Management keys come from the environment. Login does not establish all write permissions or complete provider setup. Complete provider settings in anhedral.json (providers) before shipping.',
|
|
157
|
+
},
|
|
158
|
+
ship: {
|
|
159
|
+
description: 'Provision, configure and deploy the supported selected stack.',
|
|
160
|
+
usage: 'ship [directory] [options]',
|
|
161
|
+
options: [
|
|
162
|
+
{ flag: '--dry-run', description: 'Preview provisioning and deployment without mutations.' },
|
|
163
|
+
{
|
|
164
|
+
flag: '--provider',
|
|
165
|
+
description: 'Select hosting in a mixed project.',
|
|
166
|
+
value: 'cloudflare|vercel',
|
|
167
|
+
arity: 'required',
|
|
168
|
+
},
|
|
169
|
+
{
|
|
170
|
+
flag: '--platform',
|
|
171
|
+
description: 'Build a selected mobile platform.',
|
|
172
|
+
value: 'ios|android',
|
|
173
|
+
arity: 'required',
|
|
174
|
+
},
|
|
175
|
+
{
|
|
176
|
+
flag: '--profile',
|
|
177
|
+
description: 'Select the configured EAS build profile.',
|
|
178
|
+
value: 'name',
|
|
179
|
+
arity: 'required',
|
|
180
|
+
},
|
|
181
|
+
],
|
|
182
|
+
examples: ['ship --dry-run', 'ship --json', 'ship --platform android --profile preview'],
|
|
183
|
+
note: 'Connect the intended hosting account and audience first. Commit source before shipping; resolved tracked bindings require review and another commit. Mobile builds return links and never submit to stores.',
|
|
184
|
+
},
|
|
185
|
+
add: {
|
|
186
|
+
description: 'Add bundled stack parts while preserving edited source.',
|
|
187
|
+
usage: 'add <items...> [options]',
|
|
188
|
+
options: [
|
|
189
|
+
{ flag: '--dry-run', description: 'Preview changed paths without installing them.' },
|
|
190
|
+
{
|
|
191
|
+
flag: '--diff',
|
|
192
|
+
description: 'Preview source changes; implies --dry-run.',
|
|
193
|
+
value: 'path',
|
|
194
|
+
arity: 'optional',
|
|
195
|
+
},
|
|
196
|
+
{
|
|
197
|
+
flag: '--view',
|
|
198
|
+
description: 'Preview generated source; implies --dry-run.',
|
|
199
|
+
value: 'path',
|
|
200
|
+
arity: 'optional',
|
|
201
|
+
},
|
|
202
|
+
{ flag: '--skip-install', description: 'Skip the final dependency install.' },
|
|
203
|
+
],
|
|
204
|
+
examples: [
|
|
205
|
+
'add resend',
|
|
206
|
+
'--cwd client-app add resend --dry-run',
|
|
207
|
+
'add resend --diff --cwd client-app',
|
|
208
|
+
],
|
|
209
|
+
note: 'Source previews are local and bounded. A new web bootstrap cannot be previewed offline; the plan reports that limitation. Edited-source conflicts require review; there is no force overwrite.',
|
|
210
|
+
},
|
|
211
|
+
registry: {
|
|
212
|
+
description: 'Inspect the bundled stack catalog and setup requirements.',
|
|
213
|
+
usage: 'registry list | view <item> | capabilities [options]',
|
|
214
|
+
options: [],
|
|
215
|
+
examples: [
|
|
216
|
+
'registry list',
|
|
217
|
+
'registry view neon',
|
|
218
|
+
'registry capabilities',
|
|
219
|
+
'registry capabilities --json',
|
|
220
|
+
],
|
|
221
|
+
},
|
|
222
|
+
doctor: {
|
|
223
|
+
description: 'Check project provenance and local readiness without writes.',
|
|
224
|
+
usage: 'doctor [directory] [options]',
|
|
225
|
+
options: [
|
|
226
|
+
{ flag: '--providers', description: 'Also check tools and existing provider context.' },
|
|
227
|
+
],
|
|
228
|
+
examples: ['doctor', 'doctor client-app --providers --json'],
|
|
229
|
+
},
|
|
230
|
+
connect: {
|
|
231
|
+
description: 'Select the intended hosting account, project and audience.',
|
|
232
|
+
usage: 'connect [directory] [options]',
|
|
233
|
+
options: [
|
|
234
|
+
{
|
|
235
|
+
flag: '--provider',
|
|
236
|
+
description: 'Select the hosting provider.',
|
|
237
|
+
value: 'cloudflare|vercel',
|
|
238
|
+
arity: 'required',
|
|
239
|
+
},
|
|
240
|
+
{
|
|
241
|
+
flag: '--account',
|
|
242
|
+
description: 'Select the Cloudflare account.',
|
|
243
|
+
value: 'id',
|
|
244
|
+
arity: 'required',
|
|
245
|
+
},
|
|
246
|
+
{
|
|
247
|
+
flag: '--audience',
|
|
248
|
+
description: 'Set the explicit hosting audience.',
|
|
249
|
+
value: 'public|private',
|
|
250
|
+
arity: 'required',
|
|
251
|
+
},
|
|
252
|
+
{
|
|
253
|
+
flag: '--allow-email',
|
|
254
|
+
description: 'Allow a private Cloudflare member (repeatable).',
|
|
255
|
+
value: 'email',
|
|
256
|
+
arity: 'required',
|
|
257
|
+
repeatable: true,
|
|
258
|
+
},
|
|
259
|
+
{ flag: '--scope', description: 'Select the Vercel team.', value: 'team', arity: 'required' },
|
|
260
|
+
{
|
|
261
|
+
flag: '--use',
|
|
262
|
+
description: 'Declare Vercel usage.',
|
|
263
|
+
value: 'personal|commercial',
|
|
264
|
+
arity: 'required',
|
|
265
|
+
},
|
|
266
|
+
{ flag: '--create', description: 'Create the selected Vercel project.' },
|
|
267
|
+
{ flag: '--git', description: 'Connect the verified GitHub repository.' },
|
|
268
|
+
],
|
|
269
|
+
examples: [
|
|
270
|
+
'connect --provider cloudflare --audience public',
|
|
271
|
+
'connect --scope customer --audience private --use commercial --create',
|
|
272
|
+
],
|
|
273
|
+
note: 'Vercel Hobby is personal/non-commercial. Commercial applications need an eligible existing plan; no paid plan is activated automatically.',
|
|
274
|
+
},
|
|
275
|
+
repository: {
|
|
276
|
+
description: 'Connect or create the application owner’s GitHub repository.',
|
|
277
|
+
usage: 'repository [directory] [--owner <account>] [options]',
|
|
278
|
+
options: [
|
|
279
|
+
{
|
|
280
|
+
flag: '--owner',
|
|
281
|
+
description: 'Select the GitHub owner.',
|
|
282
|
+
value: 'account',
|
|
283
|
+
arity: 'required',
|
|
284
|
+
},
|
|
285
|
+
{ flag: '--name', description: 'Set the repository name.', value: 'name', arity: 'required' },
|
|
286
|
+
{
|
|
287
|
+
flag: '--visibility',
|
|
288
|
+
description: 'Set visibility (default: private).',
|
|
289
|
+
value: 'private|public',
|
|
290
|
+
arity: 'required',
|
|
291
|
+
},
|
|
292
|
+
{ flag: '--create', description: 'Create the repository when needed.' },
|
|
293
|
+
],
|
|
294
|
+
examples: ['repository --owner customer --create'],
|
|
295
|
+
},
|
|
296
|
+
register: {
|
|
297
|
+
description: 'Record application identity and delivery targets.',
|
|
298
|
+
usage: 'register [directory] [--provider cloudflare|vercel]',
|
|
299
|
+
options: [
|
|
300
|
+
{
|
|
301
|
+
flag: '--provider',
|
|
302
|
+
description: 'Select the provider.',
|
|
303
|
+
value: 'cloudflare|vercel',
|
|
304
|
+
arity: 'required',
|
|
305
|
+
},
|
|
306
|
+
],
|
|
307
|
+
examples: ['register'],
|
|
308
|
+
},
|
|
309
|
+
provision: {
|
|
310
|
+
description: 'Reconcile Cloudflare resources without deploying code.',
|
|
311
|
+
usage: 'provision [directory] [options]',
|
|
312
|
+
options: [
|
|
313
|
+
{
|
|
314
|
+
flag: '--provider',
|
|
315
|
+
description: 'Select Cloudflare in a mixed project.',
|
|
316
|
+
value: 'cloudflare',
|
|
317
|
+
arity: 'required',
|
|
318
|
+
},
|
|
319
|
+
{ flag: '--dry-run', description: 'Preview resources without mutations.' },
|
|
320
|
+
],
|
|
321
|
+
examples: ['provision --dry-run'],
|
|
322
|
+
note: 'Use ship for the full selected-integration and hosting flow.',
|
|
323
|
+
},
|
|
324
|
+
status: {
|
|
325
|
+
description: 'Inspect recorded release and provider evidence.',
|
|
326
|
+
usage: 'status [directory] [options]',
|
|
327
|
+
options: [
|
|
328
|
+
{
|
|
329
|
+
flag: '--provider',
|
|
330
|
+
description: 'Select hosting.',
|
|
331
|
+
value: 'cloudflare|vercel',
|
|
332
|
+
arity: 'required',
|
|
333
|
+
},
|
|
334
|
+
{ flag: '--refresh', description: 'Refresh provider evidence.' },
|
|
335
|
+
],
|
|
336
|
+
examples: ['status --refresh'],
|
|
337
|
+
},
|
|
338
|
+
manage: {
|
|
339
|
+
description: 'Write a local overview of recorded delivery evidence.',
|
|
340
|
+
usage: 'manage [directory] [options]',
|
|
341
|
+
options: [
|
|
342
|
+
{
|
|
343
|
+
flag: '--provider',
|
|
344
|
+
description: 'Select hosting.',
|
|
345
|
+
value: 'cloudflare|vercel',
|
|
346
|
+
arity: 'required',
|
|
347
|
+
},
|
|
348
|
+
{ flag: '--local', description: 'Use local evidence without provider refresh.' },
|
|
349
|
+
{ flag: '--refresh', description: 'Refresh provider evidence.' },
|
|
350
|
+
],
|
|
351
|
+
examples: ['manage --local'],
|
|
352
|
+
},
|
|
353
|
+
verify: {
|
|
354
|
+
description: 'Exercise the application’s configured live acceptance checks.',
|
|
355
|
+
usage: 'verify [directory] [options]',
|
|
356
|
+
options: [
|
|
357
|
+
{
|
|
358
|
+
flag: '--provider',
|
|
359
|
+
description: 'Select hosting.',
|
|
360
|
+
value: 'cloudflare|vercel',
|
|
361
|
+
arity: 'required',
|
|
362
|
+
},
|
|
363
|
+
{ flag: '--refresh', description: 'Refresh provider evidence.' },
|
|
364
|
+
],
|
|
365
|
+
examples: ['verify'],
|
|
366
|
+
},
|
|
367
|
+
adopt: {
|
|
368
|
+
description: 'Record a verified existing Vercel Git deployment.',
|
|
369
|
+
usage: 'adopt [directory] [--provider vercel]',
|
|
370
|
+
options: [
|
|
371
|
+
{ flag: '--provider', description: 'Select Vercel.', value: 'vercel', arity: 'required' },
|
|
372
|
+
{ flag: '--refresh', description: 'Refresh provider evidence.' },
|
|
373
|
+
],
|
|
374
|
+
examples: ['adopt --provider vercel'],
|
|
375
|
+
note: 'Does not push or deploy.',
|
|
376
|
+
},
|
|
377
|
+
recover: {
|
|
378
|
+
description: 'Recover verified hosting state or a proven interrupted local lock.',
|
|
379
|
+
usage: 'recover [directory] [options]',
|
|
380
|
+
options: [
|
|
381
|
+
{
|
|
382
|
+
flag: '--lock',
|
|
383
|
+
description: 'Release only a proven dead local delivery lock; never replay provider operations.',
|
|
384
|
+
},
|
|
385
|
+
{
|
|
386
|
+
flag: '--provider',
|
|
387
|
+
description: 'Select hosting.',
|
|
388
|
+
value: 'cloudflare|vercel',
|
|
389
|
+
arity: 'required',
|
|
390
|
+
},
|
|
391
|
+
{ flag: '--refresh', description: 'Refresh provider evidence.' },
|
|
392
|
+
],
|
|
393
|
+
examples: ['recover'],
|
|
394
|
+
note: 'Does not recreate missing integration credentials or historical product checks.',
|
|
395
|
+
},
|
|
396
|
+
rollback: {
|
|
397
|
+
description: 'Restore a recorded code release after compatibility review.',
|
|
398
|
+
usage: 'rollback [directory] --release <id> --data-compatible [options]',
|
|
399
|
+
options: [
|
|
400
|
+
{
|
|
401
|
+
flag: '--provider',
|
|
402
|
+
description: 'Select hosting.',
|
|
403
|
+
value: 'cloudflare|vercel',
|
|
404
|
+
arity: 'required',
|
|
405
|
+
},
|
|
406
|
+
{
|
|
407
|
+
flag: '--release',
|
|
408
|
+
description: 'Select a recorded release.',
|
|
409
|
+
value: 'id',
|
|
410
|
+
arity: 'required',
|
|
411
|
+
},
|
|
412
|
+
{ flag: '--data-compatible', description: 'Confirm data/schema compatibility.' },
|
|
413
|
+
{ flag: '--refresh', description: 'Refresh provider evidence.' },
|
|
414
|
+
],
|
|
415
|
+
examples: ['rollback --release recorded-id --data-compatible'],
|
|
416
|
+
note: 'Code rollback does not restore data.',
|
|
417
|
+
},
|
|
418
|
+
};
|
package/dist/delivery.d.ts
CHANGED
|
@@ -9,14 +9,15 @@ interface TargetRelease {
|
|
|
9
9
|
urls: string[];
|
|
10
10
|
providerConfirmed: boolean;
|
|
11
11
|
}
|
|
12
|
-
interface Release {
|
|
12
|
+
export interface Release {
|
|
13
13
|
id: string;
|
|
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?: {
|
|
@@ -26,7 +27,7 @@ interface Release {
|
|
|
26
27
|
};
|
|
27
28
|
}
|
|
28
29
|
export declare function connectApplication(root: string, accountId: string | undefined, audience: 'public' | 'private' | undefined, run?: import("./project-state.js").DeliveryRunner, emails?: string[]): Promise<ApplicationProject>;
|
|
29
|
-
export declare function planDelivery(root: string): {
|
|
30
|
+
export declare function planDelivery(root: string, allowResourcePlaceholders?: boolean): {
|
|
30
31
|
project: ApplicationProject;
|
|
31
32
|
checks: string[][];
|
|
32
33
|
deployments: {
|
|
@@ -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
|
|
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;
|