anhedral 0.11.0 → 0.11.2
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 +50 -170
- 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 +15 -11
- package/dist/capabilities.d.ts +4 -4
- package/dist/capabilities.js +6 -2
- package/dist/capability-contract.js +22 -5
- 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.js +1 -1
- package/dist/cli-output.js +27 -2
- package/dist/cloudflare.d.ts +7 -1
- package/dist/cloudflare.js +36 -6
- package/dist/command-schema.js +49 -5
- package/dist/delivery.d.ts +10 -3
- package/dist/delivery.js +154 -37
- 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 +3 -0
- package/dist/index.js +2 -0
- package/dist/inspector-model.d.ts +9 -1
- package/dist/integration-service-readers.d.ts +13 -0
- package/dist/integration-service-readers.js +173 -0
- package/dist/lifecycle.d.ts +0 -1
- package/dist/lifecycle.js +0 -1
- package/dist/neon-service-data.d.ts +8 -0
- package/dist/neon-service-data.js +117 -0
- 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.js +73 -17
- package/dist/project-lifecycle.d.ts +25 -0
- package/dist/project-lifecycle.js +57 -0
- package/dist/project-state.d.ts +5 -1
- package/dist/project-state.js +122 -16
- package/dist/provider-auth.js +2 -3
- package/dist/provider-readiness.js +27 -10
- package/dist/providers/adapters.js +4 -1
- package/dist/providers/api.d.ts +1 -0
- package/dist/providers/api.js +1 -0
- package/dist/providers/config.js +6 -8
- package/dist/providers/provision.js +1 -1
- package/dist/providers/recovery.d.ts +1 -1
- package/dist/providers/runtime.d.ts +1 -1
- package/dist/providers/runtime.js +46 -23
- package/dist/providers/state.d.ts +1 -2
- package/dist/providers/state.js +14 -54
- package/dist/provision.d.ts +9 -0
- package/dist/provision.js +30 -1
- 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.js +64 -21
- package/dist/registry/commands.js +7 -9
- package/dist/registry/options.d.ts +1 -1
- package/dist/registry/options.js +4 -4
- 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.js +1 -5
- 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/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 +120 -29
- 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 +36 -8
- package/dist/ship.js +39 -13
- package/dist/stack-registry.d.ts +4 -2
- package/dist/stack-registry.js +41 -11
- package/dist/standard.js +23 -4
- package/dist/transaction.d.ts +2 -0
- package/dist/transaction.js +10 -0
- package/dist/util.js +17 -2
- package/dist/vercel.d.ts +2 -0
- package/dist/vercel.js +69 -13
- 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 +2 -2
- package/docs/plugin-ui.md +51 -10
- package/docs/provider-configuration.md +10 -11
- package/docs/software-factory.md +192 -0
- package/docs/stack-standard.md +142 -0
- package/docs/void-verification.md +185 -0
- package/package.json +23 -21
- package/assets/anhedral-mark.svg +0 -4
- package/assets/anhedral-stack-technical.svg +0 -322
- package/assets/anhedral-stack.svg +0 -322
- 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/security-backports.d.ts +0 -3
- package/dist/security-backports.js +0 -26
- package/docs/application-stack-standard.md +0 -75
- package/docs/delivery-workflow.md +0 -97
package/dist/auth-schema.js
CHANGED
|
@@ -37,8 +37,8 @@ export const verification = ${table}('verification', {
|
|
|
37
37
|
`;
|
|
38
38
|
writeFile(path.join(root, 'packages/db/src/schema.ts'), schema);
|
|
39
39
|
if (!postgres) {
|
|
40
|
-
writeFile(path.join(root, 'packages/db/
|
|
41
|
-
writeFile(path.join(root, 'packages/db/
|
|
40
|
+
writeFile(path.join(root, 'packages/db/drizzle/meta/0000_snapshot.json'), JSON.stringify(betterAuthSqliteSnapshot, null, 2) + '\n');
|
|
41
|
+
writeFile(path.join(root, 'packages/db/drizzle/meta/_journal.json'), JSON.stringify({
|
|
42
42
|
version: '7',
|
|
43
43
|
dialect: 'sqlite',
|
|
44
44
|
entries: [
|
|
@@ -53,5 +53,5 @@ export const verification = ${table}('verification', {
|
|
|
53
53
|
}, null, 2) + '\n');
|
|
54
54
|
}
|
|
55
55
|
if (!postgres)
|
|
56
|
-
writeFile(path.join(root, 'packages/db/
|
|
56
|
+
writeFile(path.join(root, 'packages/db/drizzle/0000_better_auth.sql'), 'CREATE TABLE `account` (\n\t`id` text PRIMARY KEY NOT NULL,\n\t`account_id` text NOT NULL,\n\t`provider_id` text NOT NULL,\n\t`user_id` text NOT NULL,\n\t`access_token` text,\n\t`refresh_token` text,\n\t`id_token` text,\n\t`access_token_expires_at` integer,\n\t`refresh_token_expires_at` integer,\n\t`scope` text,\n\t`password` text,\n\t`created_at` integer NOT NULL,\n\t`updated_at` integer NOT NULL,\n\tFOREIGN KEY (`user_id`) REFERENCES `user`(`id`) ON UPDATE no action ON DELETE cascade\n);\n--> statement-breakpoint\nCREATE INDEX `account_user_id_idx` ON `account` (`user_id`);--> statement-breakpoint\nCREATE TABLE `session` (\n\t`id` text PRIMARY KEY NOT NULL,\n\t`expires_at` integer NOT NULL,\n\t`token` text NOT NULL,\n\t`created_at` integer NOT NULL,\n\t`updated_at` integer NOT NULL,\n\t`ip_address` text,\n\t`user_agent` text,\n\t`user_id` text NOT NULL,\n\tFOREIGN KEY (`user_id`) REFERENCES `user`(`id`) ON UPDATE no action ON DELETE cascade\n);\n--> statement-breakpoint\nCREATE UNIQUE INDEX `session_token_unique` ON `session` (`token`);--> statement-breakpoint\nCREATE INDEX `session_user_id_idx` ON `session` (`user_id`);--> statement-breakpoint\nCREATE TABLE `user` (\n\t`id` text PRIMARY KEY NOT NULL,\n\t`name` text NOT NULL,\n\t`email` text NOT NULL,\n\t`email_verified` integer DEFAULT false NOT NULL,\n\t`image` text,\n\t`created_at` integer NOT NULL,\n\t`updated_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE UNIQUE INDEX `user_email_unique` ON `user` (`email`);--> statement-breakpoint\nCREATE TABLE `verification` (\n\t`id` text PRIMARY KEY NOT NULL,\n\t`identifier` text NOT NULL,\n\t`value` text NOT NULL,\n\t`expires_at` integer NOT NULL,\n\t`created_at` integer NOT NULL,\n\t`updated_at` integer NOT NULL\n);\n--> statement-breakpoint\nCREATE INDEX `verification_identifier_idx` ON `verification` (`identifier`);');
|
|
57
57
|
}
|
package/dist/bin.js
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
+
import { runServiceCommand } from './services-command.js';
|
|
2
3
|
import { shipCloudflareApplication, shipSelectedVercelApplication, shipSelectedStack, } from './ship.js';
|
|
3
4
|
import { integrationStatus, recoverIntegrationResource } from './providers/recovery.js';
|
|
4
5
|
import { INTEGRATION_PROVIDERS } from './providers/config.js';
|
|
@@ -9,7 +10,7 @@ import { authenticateProviders } from './provider-auth.js';
|
|
|
9
10
|
import { runAdd, runRegistry } from './registry/commands.js';
|
|
10
11
|
import { setupRepository } from './repository.js';
|
|
11
12
|
import path from 'node:path';
|
|
12
|
-
import {
|
|
13
|
+
import { hasProjectSection, readProjectSection } from './project-config.js';
|
|
13
14
|
import { registerVercelApplication, connectVercelApplication, vercelApplicationStatus, verifyVercelApplication, rollbackVercelApplication, adoptVercelApplication, recoverVercelApplication, writeVercelOverview, } from './vercel.js';
|
|
14
15
|
import { registerApplication, connectApplication, applicationStatus, verifyApplication, rollbackApplication, recoverApplication, } from './delivery.js';
|
|
15
16
|
import { planProvisioning, provisionApplication } from './provision.js';
|
|
@@ -69,6 +70,10 @@ async function main() {
|
|
|
69
70
|
process.env.ANHEDRAL_QUIET = '1';
|
|
70
71
|
if (global.verbose && !json && !global.quiet)
|
|
71
72
|
process.env.ANHEDRAL_VERBOSE = '1';
|
|
73
|
+
if (command === 'services') {
|
|
74
|
+
printResult(command, await runServiceCommand(process.cwd(), args), output);
|
|
75
|
+
return;
|
|
76
|
+
}
|
|
72
77
|
if (command === 'inspect') {
|
|
73
78
|
const directories = args.filter((arg) => arg !== '--json');
|
|
74
79
|
if (directories.length > 1 || directories.some((arg) => arg.startsWith('-')))
|
|
@@ -221,10 +226,10 @@ async function main() {
|
|
|
221
226
|
await runDoctor(args);
|
|
222
227
|
return;
|
|
223
228
|
}
|
|
224
|
-
if (command !== '
|
|
225
|
-
throw argumentError(`Unknown command: ${command}. Use init, auth, ship, add, registry, inspect, doctor, repository, register, connect, provision, status, manage, verify, rollback, adopt, recover,
|
|
229
|
+
if (command !== 'init') {
|
|
230
|
+
throw argumentError(`Unknown command: ${command}. Use init, auth, ship, add, registry, inspect, doctor, repository, register, connect, provision, status, manage, verify, rollback, adopt, recover, --help, or --version.`);
|
|
226
231
|
}
|
|
227
|
-
const options = readOptions(
|
|
232
|
+
const options = readOptions(args);
|
|
228
233
|
if (options)
|
|
229
234
|
await scaffoldStandardProject(options, undefined, output);
|
|
230
235
|
}
|
|
@@ -359,11 +364,10 @@ async function runDelivery(command, args) {
|
|
|
359
364
|
}
|
|
360
365
|
const web = provider === 'vercel' ||
|
|
361
366
|
(provider !== 'cloudflare' &&
|
|
362
|
-
(
|
|
367
|
+
(hasProjectSection(root, 'vercel') ||
|
|
363
368
|
(command === 'register' &&
|
|
364
|
-
|
|
365
|
-
|
|
366
|
-
'vercel')));
|
|
369
|
+
hasProjectSection(root, 'setup') &&
|
|
370
|
+
readProjectSection(root, 'setup').hosting === 'vercel')));
|
|
367
371
|
if (command === 'ship' && !provider) {
|
|
368
372
|
result = await shipSelectedStack(root, args.includes('--dry-run'));
|
|
369
373
|
printResult(command, result, output);
|
|
@@ -466,9 +470,9 @@ async function runDoctor(args) {
|
|
|
466
470
|
(!report.prerequisitesReady || report.providerVerification !== 'verified-existing-context')))
|
|
467
471
|
process.exitCode = 1;
|
|
468
472
|
}
|
|
469
|
-
function readOptions(
|
|
473
|
+
function readOptions(args) {
|
|
470
474
|
try {
|
|
471
|
-
return parseStandardOptions(
|
|
475
|
+
return parseStandardOptions(args);
|
|
472
476
|
}
|
|
473
477
|
catch (error) {
|
|
474
478
|
const message = error instanceof Error ? error.message : String(error);
|
|
@@ -511,7 +515,7 @@ catch (error) {
|
|
|
511
515
|
? 'AUTH_FAILED'
|
|
512
516
|
: command === 'doctor'
|
|
513
517
|
? 'INVALID_ARGUMENT'
|
|
514
|
-
: command === '
|
|
518
|
+
: command === 'init'
|
|
515
519
|
? 'GENERATION_FAILED'
|
|
516
520
|
: command === 'add'
|
|
517
521
|
? 'ADDITION_FAILED'
|
package/dist/capabilities.d.ts
CHANGED
|
@@ -6,7 +6,7 @@ export declare const CAPABILITIES: Record<StandardProduct, Capability>;
|
|
|
6
6
|
export declare const CAPABILITY_REGISTRY: {
|
|
7
7
|
schemaVersion: number;
|
|
8
8
|
cliVersion: string;
|
|
9
|
-
capabilities: Record<"
|
|
9
|
+
capabilities: Record<"next" | "queues" | "basin" | "vinext" | "hono" | "realtime" | "cron" | "workflows" | "electron" | "wxt" | "expo" | "styling" | "neon" | "d1" | "neon-realtime" | "local-data" | "clerk" | "better-auth" | "r2" | "kv" | "openai" | "ai-sdk" | "workers-ai" | "resend" | "stripe" | "revenuecat" | "sentry" | "posthog", Capability>;
|
|
10
10
|
};
|
|
11
11
|
export declare function createSetupPlan(options: StandardOptions, registry?: import("./registry/resolve.js").ResolvedStackRegistry): {
|
|
12
12
|
schemaVersion: number;
|
|
@@ -15,10 +15,10 @@ export declare function createSetupPlan(options: StandardOptions, registry?: imp
|
|
|
15
15
|
standard: string;
|
|
16
16
|
root: string;
|
|
17
17
|
name: string;
|
|
18
|
-
products: ("
|
|
18
|
+
products: ("next" | "queues" | "basin" | "vinext" | "hono" | "realtime" | "cron" | "workflows" | "electron" | "wxt" | "expo" | "styling" | "neon" | "d1" | "neon-realtime" | "local-data" | "clerk" | "better-auth" | "r2" | "kv" | "openai" | "ai-sdk" | "workers-ai" | "resend" | "stripe" | "revenuecat" | "sentry" | "posthog")[];
|
|
19
19
|
hosting: import("./registry/types.js").Hosting;
|
|
20
20
|
registry: import("./registry/resolve.js").ResolvedStackRegistry;
|
|
21
|
-
bootstrap: ("
|
|
21
|
+
bootstrap: ("next" | "pnpm" | "shadcn@4.21.4" | "dlx" | "init" | "--monorepo" | "--template")[];
|
|
22
22
|
dryRun: boolean;
|
|
23
23
|
setup: {
|
|
24
24
|
tools: string[];
|
|
@@ -32,7 +32,7 @@ export declare function createSetupPlan(options: StandardOptions, registry?: imp
|
|
|
32
32
|
credentials: readonly string[];
|
|
33
33
|
resources: readonly string[];
|
|
34
34
|
verify: readonly string[];
|
|
35
|
-
id: "
|
|
35
|
+
id: "next" | "queues" | "basin" | "vinext" | "hono" | "realtime" | "cron" | "workflows" | "electron" | "wxt" | "expo" | "styling" | "neon" | "d1" | "neon-realtime" | "local-data" | "clerk" | "better-auth" | "r2" | "kv" | "openai" | "ai-sdk" | "workers-ai" | "resend" | "stripe" | "revenuecat" | "sentry" | "posthog";
|
|
36
36
|
}[];
|
|
37
37
|
completion: string[];
|
|
38
38
|
resourcesProvisioned: boolean;
|
package/dist/capabilities.js
CHANGED
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { usesVoidSelection } from './runtime-policy.js';
|
|
1
2
|
import { resolveStackRegistry } from './registry/resolve.js';
|
|
2
3
|
import { BOOTSTRAP_COMMAND } from './registry/bootstrap.js';
|
|
3
4
|
import { GENERATOR_VERSION } from './version.js';
|
|
@@ -14,7 +15,7 @@ export const CAPABILITY_REGISTRY = {
|
|
|
14
15
|
};
|
|
15
16
|
const HOSTING_SETUP = {
|
|
16
17
|
cloudflare: {
|
|
17
|
-
tools: ['Cloudflare integration or API', 'Wrangler'],
|
|
18
|
+
tools: ['Cloudflare integration or API', 'Void', 'Wrangler'],
|
|
18
19
|
access: [
|
|
19
20
|
'Client-owned Cloudflare account; account ID; scoped OAuth/API access; service-compatible plan; DNS access only when needed',
|
|
20
21
|
],
|
|
@@ -27,6 +28,7 @@ const HOSTING_SETUP = {
|
|
|
27
28
|
},
|
|
28
29
|
};
|
|
29
30
|
export function createSetupPlan(options, registry = resolveStackRegistry(options)) {
|
|
31
|
+
const voidWorkspace = usesVoidSelection(options.products, options.hosting);
|
|
30
32
|
const items = new Map(registry.items.map((item) => [item.name, item]));
|
|
31
33
|
const capabilities = options.products.map((id) => {
|
|
32
34
|
const item = items.get(id);
|
|
@@ -61,7 +63,9 @@ export function createSetupPlan(options, registry = resolveStackRegistry(options
|
|
|
61
63
|
tools: [
|
|
62
64
|
...new Set([
|
|
63
65
|
'Git',
|
|
64
|
-
|
|
66
|
+
voidWorkspace
|
|
67
|
+
? 'Node.js 24.21.0+ for Void workspaces'
|
|
68
|
+
: 'Node.js 22.13+ on 22.x, or Node.js 24+ for generated workspaces',
|
|
65
69
|
PACKAGE_MANAGER.replace('@', ' '),
|
|
66
70
|
'GitHub integration or gh',
|
|
67
71
|
'Fallow',
|
|
@@ -49,6 +49,10 @@ function productCapability(id) {
|
|
|
49
49
|
? 'Signing, notarization, installers, updates, and distribution require a separate delivery workflow.'
|
|
50
50
|
: 'Extension signing, store submission, review, and distribution require a separate delivery workflow.');
|
|
51
51
|
}
|
|
52
|
+
if (id === 'neon-realtime') {
|
|
53
|
+
provisioning = stage('scaffold-only', 'Manually enable Realtime on the intended Neon branch, configure allowed origins and supply its private secret and public URL; no automatic Realtime provisioning.', 'unverified');
|
|
54
|
+
limits.push('Neon Realtime is beta and does not support RLS; authenticate requests and seal only explicitly scoped, read-only application queries.', 'Keep DATABASE_URL and NEON_REALTIME_SECRET server-only; clients use the public NEON_REALTIME_URL and short-lived sealed queries.', 'The package exposes separate server/client factories and a Drizzle adapter; no arbitrary SQL endpoint or application subscription flow is generated.', 'Live subscriptions, renewal, revocation, allowed origins and cross-tenant isolation require authorized acceptance; live behavior remains unverified.');
|
|
55
|
+
}
|
|
52
56
|
if (id === 'better-auth')
|
|
53
57
|
limits.push('Configure private authentication secret and public origin; apply and verify database migrations and authorization rules.');
|
|
54
58
|
return {
|
|
@@ -104,10 +108,22 @@ export const CAPABILITY_CONTRACT = {
|
|
|
104
108
|
id: 'native-host-installation',
|
|
105
109
|
capability: stage('implemented', 'Packaged plugin and host integration.', 'unverified'),
|
|
106
110
|
},
|
|
107
|
-
|
|
108
|
-
id,
|
|
109
|
-
capability: stage('
|
|
110
|
-
}
|
|
111
|
+
{
|
|
112
|
+
id: 'live-analytics',
|
|
113
|
+
capability: stage('implemented', 'Explicit selected-resource analytics for Cloudflare Workers/D1, Vercel and PostHog; provider access and metric availability require live acceptance.'),
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
id: 'live-database-reader',
|
|
117
|
+
capability: stage('implemented', 'Explicit bounded D1 and restricted read-only Neon data reads; masked rows and schema are private app metadata.'),
|
|
118
|
+
},
|
|
119
|
+
{
|
|
120
|
+
id: 'live-provider-health',
|
|
121
|
+
capability: stage('implemented', 'Explicit resource existence, identity and recorded deployment status checks; these do not certify application health.'),
|
|
122
|
+
},
|
|
123
|
+
{
|
|
124
|
+
id: 'schedule-execution',
|
|
125
|
+
capability: stage('unsupported', 'Schedules are declared configuration; no execution-history reader is implemented.', 'unverified'),
|
|
126
|
+
},
|
|
111
127
|
],
|
|
112
128
|
limits: [
|
|
113
129
|
'Local contract tests are separate from live provider acceptance and completed application verification.',
|
|
@@ -127,7 +143,8 @@ export function formatCapabilityContract() {
|
|
|
127
143
|
'Providers: ' + CAPABILITY_CONTRACT.providers.map((provider) => provider.id).join(', '),
|
|
128
144
|
'Expo delivery returns EAS artifacts; it does not submit to stores.',
|
|
129
145
|
'Electron and WXT distribution: scaffold only.',
|
|
130
|
-
'Plugin
|
|
146
|
+
'Plugin: explicit selected-resource analytics, bounded database reads and provider status checks; live acceptance remains unverified.',
|
|
147
|
+
'Schedule execution history: unavailable. Resource status does not certify application health.',
|
|
131
148
|
'',
|
|
132
149
|
...CAPABILITY_CONTRACT.limits,
|
|
133
150
|
'',
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
import type { ProjectInspection } from './inspector-model.js';
|
|
2
|
+
export interface ProjectSummary {
|
|
3
|
+
id: string;
|
|
4
|
+
name: string;
|
|
5
|
+
sourceName: string;
|
|
6
|
+
updatedAt: string;
|
|
7
|
+
products: string[];
|
|
8
|
+
status: 'recorded' | 'source' | 'unavailable';
|
|
9
|
+
message?: string;
|
|
10
|
+
inspection?: ProjectInspection;
|
|
11
|
+
}
|
|
12
|
+
export interface Dashboard {
|
|
13
|
+
projects: ProjectSummary[];
|
|
14
|
+
selectedId: string | null;
|
|
15
|
+
preferences: {
|
|
16
|
+
view: 'list' | 'grid';
|
|
17
|
+
};
|
|
18
|
+
}
|
|
19
|
+
export interface ToolArguments {
|
|
20
|
+
id?: string;
|
|
21
|
+
name?: string;
|
|
22
|
+
view?: 'list' | 'grid';
|
|
23
|
+
}
|
|
24
|
+
export type DashboardTool = 'list_projects' | 'get_project' | 'rename_project' | 'forget_project' | 'set_view';
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export {};
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
export declare function catalogDirectory(env?: NodeJS.ProcessEnv): string;
|
|
2
|
+
/** Every successful CLI init records a local app unless explicitly disabled.
|
|
3
|
+
* Registration failure never undoes generated source. */
|
|
4
|
+
export declare function registerGeneratedProject(root: string, env?: NodeJS.ProcessEnv): {
|
|
5
|
+
state: "not-enabled";
|
|
6
|
+
id?: undefined;
|
|
7
|
+
nextAction?: undefined;
|
|
8
|
+
} | {
|
|
9
|
+
state: "registered";
|
|
10
|
+
id: string;
|
|
11
|
+
nextAction?: undefined;
|
|
12
|
+
} | {
|
|
13
|
+
state: "pending";
|
|
14
|
+
nextAction: string;
|
|
15
|
+
id?: undefined;
|
|
16
|
+
};
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
import { homedir } from 'node:os';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { ProjectStore } from './project-catalog.js';
|
|
4
|
+
export function catalogDirectory(env = process.env) {
|
|
5
|
+
return (env.ANHEDRAL_PLUGIN_DATA ?? path.join(homedir(), '.local', 'share', 'anhedral', 'projects'));
|
|
6
|
+
}
|
|
7
|
+
/** Every successful CLI init records a local app unless explicitly disabled.
|
|
8
|
+
* Registration failure never undoes generated source. */
|
|
9
|
+
export function registerGeneratedProject(root, env = process.env) {
|
|
10
|
+
const directory = catalogDirectory(env);
|
|
11
|
+
if (env.ANHEDRAL_DISABLE_CATALOG === '1')
|
|
12
|
+
return { state: 'not-enabled' };
|
|
13
|
+
try {
|
|
14
|
+
return { state: 'registered', id: new ProjectStore(directory).register(root) };
|
|
15
|
+
}
|
|
16
|
+
catch {
|
|
17
|
+
return {
|
|
18
|
+
state: 'pending',
|
|
19
|
+
nextAction: 'Project generated. Catalog registration could not complete; refresh or register the source after restoring catalog access.',
|
|
20
|
+
};
|
|
21
|
+
}
|
|
22
|
+
}
|
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import type { ProjectSummary } from './catalog-model.js';
|
|
2
|
+
import type { ProjectEntry } from './project-catalog.js';
|
|
3
|
+
/** List views read bounded package and project configuration; detailed evidence is opt-in by ID. */
|
|
4
|
+
export declare function projectSnapshot(entry: ProjectEntry, detail?: boolean): ProjectSummary;
|
|
5
|
+
export declare function readCatalogSourceIdentity(root: string): string | undefined;
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import { lstatSync, realpathSync } from 'node:fs';
|
|
2
|
+
import path from 'node:path';
|
|
3
|
+
import { readBoundedFile } from './bounded-file.js';
|
|
4
|
+
import { readProjectConfig, projectConfigPath } from './project-config.js';
|
|
5
|
+
import { inspectApplication } from './project-inspector.js';
|
|
6
|
+
import { STANDARD_PRODUCTS } from './stack-registry.js';
|
|
7
|
+
import { z } from 'zod';
|
|
8
|
+
/** List views read bounded package and project configuration; detailed evidence is opt-in by ID. */
|
|
9
|
+
export function projectSnapshot(entry, detail = false) {
|
|
10
|
+
const summary = {
|
|
11
|
+
id: entry.id,
|
|
12
|
+
name: entry.name,
|
|
13
|
+
sourceName: '',
|
|
14
|
+
updatedAt: entry.updatedAt,
|
|
15
|
+
products: [],
|
|
16
|
+
status: 'source',
|
|
17
|
+
};
|
|
18
|
+
try {
|
|
19
|
+
if (realpathSync(entry.root) !== entry.root)
|
|
20
|
+
throw new Error();
|
|
21
|
+
const configuration = catalogConfiguration(entry.root);
|
|
22
|
+
if (entry.sourceIdentity !== sourceIdentity(configuration))
|
|
23
|
+
return {
|
|
24
|
+
...summary,
|
|
25
|
+
status: 'unavailable',
|
|
26
|
+
message: 'This directory contains a different app. Select its new catalog entry or restore the registered source.',
|
|
27
|
+
};
|
|
28
|
+
if (realpathSync(entry.root) !== entry.root)
|
|
29
|
+
throw new Error();
|
|
30
|
+
const read = (relative) => {
|
|
31
|
+
const file = path.join(entry.root, relative);
|
|
32
|
+
if (!realpathSync(file).startsWith(entry.root + path.sep))
|
|
33
|
+
throw new Error();
|
|
34
|
+
return JSON.parse(readBoundedFile(file, 256 * 1024).toString('utf8'));
|
|
35
|
+
};
|
|
36
|
+
const manifest = read('package.json');
|
|
37
|
+
if (typeof manifest.name !== 'string' ||
|
|
38
|
+
!/^(@[a-z0-9._-]+\/)?[a-z0-9._-]+$/i.test(manifest.name) ||
|
|
39
|
+
manifest.name.length > 214)
|
|
40
|
+
throw new Error();
|
|
41
|
+
summary.sourceName = manifest.name;
|
|
42
|
+
const rawSetup = configuration?.setup;
|
|
43
|
+
if (rawSetup !== undefined) {
|
|
44
|
+
if (!rawSetup || typeof rawSetup !== 'object' || Array.isArray(rawSetup))
|
|
45
|
+
throw new Error();
|
|
46
|
+
if (Buffer.byteLength(JSON.stringify(rawSetup)) > 256 * 1024)
|
|
47
|
+
throw new Error();
|
|
48
|
+
const setup = rawSetup;
|
|
49
|
+
summary.products = Array.isArray(setup.products)
|
|
50
|
+
? setup.products
|
|
51
|
+
.filter((p) => typeof p === 'string' &&
|
|
52
|
+
STANDARD_PRODUCTS.includes(p))
|
|
53
|
+
.slice(0, 100)
|
|
54
|
+
: [];
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
catch {
|
|
58
|
+
summary.status = 'unavailable';
|
|
59
|
+
summary.message =
|
|
60
|
+
'Source summary is unavailable. Restore or inspect the registered source, then refresh.';
|
|
61
|
+
}
|
|
62
|
+
if (detail) {
|
|
63
|
+
try {
|
|
64
|
+
if (realpathSync(entry.root) !== entry.root)
|
|
65
|
+
throw new Error();
|
|
66
|
+
summary.inspection = inspectApplication(entry.root);
|
|
67
|
+
summary.status =
|
|
68
|
+
summary.status !== 'unavailable' &&
|
|
69
|
+
summary.inspection.targets.data.some((target) => target.latestAttempt || target.lastSuccessful)
|
|
70
|
+
? 'recorded'
|
|
71
|
+
: summary.status;
|
|
72
|
+
}
|
|
73
|
+
catch {
|
|
74
|
+
summary.status = 'unavailable';
|
|
75
|
+
summary.message = 'Registered source is unavailable. Restore the directory, then refresh.';
|
|
76
|
+
}
|
|
77
|
+
}
|
|
78
|
+
return summary;
|
|
79
|
+
}
|
|
80
|
+
function catalogConfiguration(root) {
|
|
81
|
+
return lstatSync(projectConfigPath(root), { throwIfNoEntry: false })
|
|
82
|
+
? readProjectConfig(root)
|
|
83
|
+
: null;
|
|
84
|
+
}
|
|
85
|
+
function sourceIdentity(configuration) {
|
|
86
|
+
if (configuration?.identity === undefined)
|
|
87
|
+
return undefined;
|
|
88
|
+
if (Buffer.byteLength(JSON.stringify(configuration.identity)) > 4096)
|
|
89
|
+
throw new Error('Project identity exceeds its size limit.');
|
|
90
|
+
return z
|
|
91
|
+
.object({ schemaVersion: z.literal(1), id: z.string().uuid() })
|
|
92
|
+
.strict()
|
|
93
|
+
.parse(configuration.identity).id;
|
|
94
|
+
}
|
|
95
|
+
export function readCatalogSourceIdentity(root) {
|
|
96
|
+
return sourceIdentity(catalogConfiguration(root));
|
|
97
|
+
}
|
package/dist/cli-arguments.js
CHANGED
|
@@ -62,7 +62,7 @@ export function validateCommand(command, args) {
|
|
|
62
62
|
return;
|
|
63
63
|
const definition = commandDefinition(command);
|
|
64
64
|
if (!definition) {
|
|
65
|
-
const recommendation = suggest(command, [...Object.keys(COMMANDS), '
|
|
65
|
+
const recommendation = suggest(command, [...Object.keys(COMMANDS), 'help']);
|
|
66
66
|
const name = /^[a-z-]{1,32}$/.test(command) ? `: ${command}` : '';
|
|
67
67
|
throw new CliArgumentError(`Unknown command${name}.${recommendation ? ` Did you mean ${recommendation}?` : ''}`, 'Run anhedral --help.', 'UNKNOWN_COMMAND');
|
|
68
68
|
}
|
package/dist/cli-output.js
CHANGED
|
@@ -15,13 +15,38 @@ export function formatResult(command, value) {
|
|
|
15
15
|
if (string(action))
|
|
16
16
|
lines.push(`Next: ${string(action)}`);
|
|
17
17
|
};
|
|
18
|
-
if (command === 'init'
|
|
18
|
+
if (command === 'init') {
|
|
19
19
|
lines.push(data.generated ? `Created ${string(data.root)}.` : `Stack preview for ${string(data.root)}.`, `Stack: ${names(data.products)}.`, `Hosting: ${string(data.hosting)}.`, '');
|
|
20
|
+
const catalog = record(data.catalog);
|
|
21
|
+
if (catalog.state === 'registered')
|
|
22
|
+
lines.push('Registered in your local Anhedral dashboard.');
|
|
23
|
+
if (catalog.state === 'pending')
|
|
24
|
+
next(catalog.nextAction);
|
|
20
25
|
if (data.generated)
|
|
21
|
-
lines.push('Review the generated source and anhedral.providers.
|
|
26
|
+
lines.push('Review the generated source and provider settings in anhedral.json (providers).', 'In the project directory, start development with pnpm dev. Run pnpm check before delivery.', 'Next: anhedral auth, then connect the intended hosting account and preview anhedral ship --dry-run.');
|
|
22
27
|
else
|
|
23
28
|
lines.push('No files, provider resources or deployments were created.');
|
|
24
29
|
}
|
|
30
|
+
else if (command === 'services') {
|
|
31
|
+
if (Array.isArray(data.services)) {
|
|
32
|
+
lines.push(`${data.services.length} local service entries.`);
|
|
33
|
+
for (const service of entries(data.services))
|
|
34
|
+
lines.push(` ${string(service.key)}${service.state ? ` — ${string(service.state)}` : ''}`);
|
|
35
|
+
}
|
|
36
|
+
else if (Array.isArray(data.points)) {
|
|
37
|
+
lines.push(`Analytics: ${string(data.source)}.`, `Window: ${string(data.start)} to ${string(data.end)} (UTC).`, `${data.points.length} provider data points.`, 'Use --json for the complete aggregate values.');
|
|
38
|
+
}
|
|
39
|
+
else if (Array.isArray(data.rows)) {
|
|
40
|
+
lines.push(`Read ${data.rows.length} rows.`, `Private data${data.masked ? '; sensitive fields are masked' : ''}. Use --json to inspect values.`);
|
|
41
|
+
}
|
|
42
|
+
else if (string(data.token)) {
|
|
43
|
+
lines.push(`Deletion plan: ${string(data.kind)} ${string(data.name)}.`, string(data.impact), `Affected apps: ${names(data.applications) || 'None recorded'}.`, `Expires: ${string(data.expiresAt)}.`, 'Use --json for the single-use confirmation token; deleting requires the exact resource name.');
|
|
44
|
+
}
|
|
45
|
+
else if (Array.isArray(value))
|
|
46
|
+
lines.push(`Tables: ${names(value) || 'None'}.`);
|
|
47
|
+
else
|
|
48
|
+
lines.push(`Service: ${string(data.state) || 'Checked'}.`, string(data.message));
|
|
49
|
+
}
|
|
25
50
|
else if (command === 'add') {
|
|
26
51
|
lines.push(data.dryRun ? 'Addition preview.' : 'Stack parts added.', names(data.items) ? `Parts: ${names(data.items)}.` : 'No new stack parts.', `Project: ${string(data.root)}.`);
|
|
27
52
|
const files = Array.isArray(data.files) ? data.files : [];
|
package/dist/cloudflare.d.ts
CHANGED
|
@@ -6,12 +6,18 @@ export interface CloudflareResponse {
|
|
|
6
6
|
total_pages?: number;
|
|
7
7
|
count?: number;
|
|
8
8
|
per_page?: number;
|
|
9
|
+
cursor?: string;
|
|
9
10
|
};
|
|
10
11
|
}
|
|
11
|
-
export type CloudflareRequest = (method: 'GET' | 'POST', endpoint: string, body?: unknown) => Promise<CloudflareResponse>;
|
|
12
|
+
export type CloudflareRequest = (method: 'GET' | 'POST' | 'DELETE', endpoint: string, body?: unknown) => Promise<CloudflareResponse>;
|
|
12
13
|
export interface CloudflareRequestOptions {
|
|
13
14
|
send?: typeof fetch;
|
|
14
15
|
timeoutMs?: number;
|
|
16
|
+
analytics?: boolean;
|
|
17
|
+
}
|
|
18
|
+
export declare class CloudflareRequestError extends Error {
|
|
19
|
+
readonly status: number;
|
|
20
|
+
constructor(message: string, status: number);
|
|
15
21
|
}
|
|
16
22
|
/** Credentials stay in this closure. Fixed account paths, bounded response reads and
|
|
17
23
|
* a whole-request deadline apply to reads and mutations; mutations never retry. */
|
package/dist/cloudflare.js
CHANGED
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
const ORIGIN = 'https://api.cloudflare.com';
|
|
2
2
|
const MAX_RESPONSE_BYTES = 2 * 1024 * 1024;
|
|
3
|
+
export class CloudflareRequestError extends Error {
|
|
4
|
+
status;
|
|
5
|
+
constructor(message, status) {
|
|
6
|
+
super(message);
|
|
7
|
+
this.status = status;
|
|
8
|
+
}
|
|
9
|
+
}
|
|
3
10
|
function object(value) {
|
|
4
11
|
return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
|
|
5
12
|
}
|
|
@@ -52,6 +59,13 @@ function responseInfo(value) {
|
|
|
52
59
|
if (!object(value))
|
|
53
60
|
throw new Error('Cloudflare returned unsupported pagination.');
|
|
54
61
|
const info = {};
|
|
62
|
+
if (value.cursor !== undefined) {
|
|
63
|
+
if (typeof value.cursor !== 'string' ||
|
|
64
|
+
value.cursor.length > 4096 ||
|
|
65
|
+
/[\x00-\x1f\x7f]/.test(value.cursor))
|
|
66
|
+
throw new Error('Cloudflare returned an invalid pagination cursor.');
|
|
67
|
+
info.cursor = value.cursor;
|
|
68
|
+
}
|
|
55
69
|
for (const field of ['page', 'total_pages', 'count', 'per_page']) {
|
|
56
70
|
const entry = value[field];
|
|
57
71
|
if (entry !== undefined) {
|
|
@@ -96,7 +110,7 @@ export async function cloudflareRequest(project, directory, run, env, options =
|
|
|
96
110
|
if (typeof endpoint !== 'string')
|
|
97
111
|
throw new Error();
|
|
98
112
|
const decodedPath = decodeURIComponent(endpoint.split('?')[0]);
|
|
99
|
-
if (!['GET', 'POST'].includes(method) ||
|
|
113
|
+
if (!['GET', 'POST', 'DELETE'].includes(method) ||
|
|
100
114
|
endpoint.length > 4096 ||
|
|
101
115
|
!endpoint.startsWith('/') ||
|
|
102
116
|
endpoint.startsWith('//') ||
|
|
@@ -104,9 +118,20 @@ export async function cloudflareRequest(project, directory, run, env, options =
|
|
|
104
118
|
decodedPath.includes('..') ||
|
|
105
119
|
/[\x00-\x20\x7f#\\%]/.test(decodedPath))
|
|
106
120
|
throw new Error();
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
121
|
+
if (options.analytics) {
|
|
122
|
+
if (endpoint !== '/graphql' ||
|
|
123
|
+
method !== 'POST' ||
|
|
124
|
+
!object(body) ||
|
|
125
|
+
!object(body.variables) ||
|
|
126
|
+
body.variables.accountTag !== account)
|
|
127
|
+
throw new Error();
|
|
128
|
+
url = new URL('/client/v4/graphql', ORIGIN);
|
|
129
|
+
}
|
|
130
|
+
else {
|
|
131
|
+
url = new URL(`${prefix}${endpoint}`, ORIGIN);
|
|
132
|
+
if (url.origin !== ORIGIN || !url.pathname.startsWith(`${prefix}/`))
|
|
133
|
+
throw new Error();
|
|
134
|
+
}
|
|
110
135
|
}
|
|
111
136
|
catch {
|
|
112
137
|
throw new Error('Invalid account-scoped provider request.');
|
|
@@ -144,7 +169,10 @@ export async function cloudflareRequest(project, directory, run, env, options =
|
|
|
144
169
|
}
|
|
145
170
|
if (!object(data))
|
|
146
171
|
throw new Error(`Cloudflare returned unsupported output (HTTP ${response.status}).`);
|
|
147
|
-
if (!response.ok ||
|
|
172
|
+
if (!response.ok ||
|
|
173
|
+
(options.analytics
|
|
174
|
+
? data.errors != null && (!Array.isArray(data.errors) || data.errors.length > 0)
|
|
175
|
+
: data.success !== true)) {
|
|
148
176
|
const codes = Array.isArray(data.errors)
|
|
149
177
|
? data.errors
|
|
150
178
|
.slice(0, 20)
|
|
@@ -156,8 +184,10 @@ export async function cloudflareRequest(project, directory, run, env, options =
|
|
|
156
184
|
code <= 1_000_000)
|
|
157
185
|
.join(',')
|
|
158
186
|
: '';
|
|
159
|
-
throw new
|
|
187
|
+
throw new CloudflareRequestError(`Cloudflare operation failed (HTTP ${response.status}${codes ? `; codes ${codes}` : ''}). Check scoped permissions and service eligibility; no paid plan is activated automatically.`, response.status);
|
|
160
188
|
}
|
|
189
|
+
if (options.analytics)
|
|
190
|
+
return { result: data.data };
|
|
161
191
|
if (!Object.hasOwn(data, 'result'))
|
|
162
192
|
throw new Error('Cloudflare returned no operation result.');
|
|
163
193
|
return { result: data.result, result_info: responseInfo(data.result_info) };
|
package/dist/command-schema.js
CHANGED
|
@@ -26,9 +26,53 @@ export function optionHelp(option) {
|
|
|
26
26
|
return `${flags}${argument} ${option.description}`;
|
|
27
27
|
}
|
|
28
28
|
export function commandDefinition(command) {
|
|
29
|
-
return COMMANDS[command
|
|
29
|
+
return COMMANDS[command ?? ''];
|
|
30
30
|
}
|
|
31
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
|
+
},
|
|
32
76
|
inspect: {
|
|
33
77
|
description: 'Inspect local stack, setup requirements and recorded delivery evidence.',
|
|
34
78
|
usage: 'inspect [directory] [options]',
|
|
@@ -63,7 +107,7 @@ export const COMMANDS = {
|
|
|
63
107
|
'integrations status --json',
|
|
64
108
|
'integrations recover --provider neon --operation recorded-hash --resource existing-id',
|
|
65
109
|
],
|
|
66
|
-
note: 'Status is read-only. Recovery verifies provider identity before updating a local receipt.
|
|
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.',
|
|
67
111
|
},
|
|
68
112
|
init: {
|
|
69
113
|
description: 'Scaffold a project from the bundled stack registry.',
|
|
@@ -109,7 +153,7 @@ export const COMMANDS = {
|
|
|
109
153
|
{ flag: '--non-interactive', description: 'Never open an interactive login.' },
|
|
110
154
|
],
|
|
111
155
|
examples: ['auth', 'auth --status --json', 'auth --provider neon'],
|
|
112
|
-
note: 'Management keys come from the environment. Login does not establish all write permissions or complete provider setup. Complete anhedral.
|
|
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.',
|
|
113
157
|
},
|
|
114
158
|
ship: {
|
|
115
159
|
description: 'Provision, configure and deploy the supported selected stack.',
|
|
@@ -140,7 +184,7 @@ export const COMMANDS = {
|
|
|
140
184
|
},
|
|
141
185
|
add: {
|
|
142
186
|
description: 'Add bundled stack parts while preserving edited source.',
|
|
143
|
-
usage: 'add
|
|
187
|
+
usage: 'add <items...> [options]',
|
|
144
188
|
options: [
|
|
145
189
|
{ flag: '--dry-run', description: 'Preview changed paths without installing them.' },
|
|
146
190
|
{
|
|
@@ -159,7 +203,7 @@ export const COMMANDS = {
|
|
|
159
203
|
],
|
|
160
204
|
examples: [
|
|
161
205
|
'add resend',
|
|
162
|
-
'
|
|
206
|
+
'--cwd client-app add resend --dry-run',
|
|
163
207
|
'add resend --diff --cwd client-app',
|
|
164
208
|
],
|
|
165
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.',
|