anhedral 0.17.0 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (174) hide show
  1. package/README.md +33 -68
  2. package/assets/contracts/LICENSE +201 -0
  3. package/assets/contracts/LICENSE.environment +201 -0
  4. package/assets/contracts/LICENSE.operations +201 -0
  5. package/assets/contracts/deployment-provenance.json +15 -0
  6. package/assets/contracts/environment-provenance.json +11 -0
  7. package/assets/contracts/operations-provenance.json +12 -0
  8. package/assets/launch/application.server.ts.txt +13 -0
  9. package/assets/launch/auth-client.ts.txt +4 -0
  10. package/assets/launch/home.tsx.txt +20 -0
  11. package/assets/launch/minimal-application.server.ts.txt +5 -0
  12. package/assets/launch/minimal-server.ts.txt +7 -0
  13. package/assets/launch/oj/OJ.LICENSE +21 -0
  14. package/assets/launch/oj/run.mjs +82 -0
  15. package/assets/launch/oj/runtime.json +21 -0
  16. package/assets/launch/request-context.ts.txt +3 -0
  17. package/assets/launch/root.tsx.txt +26 -0
  18. package/assets/launch/router.tsx.txt +21 -0
  19. package/assets/launch/server.ts.txt +15 -0
  20. package/assets/launch/sign-in.tsx.txt +53 -0
  21. package/assets/launch/styles.css.txt +19 -0
  22. package/assets/security/credential-patterns.d.mts +3 -0
  23. package/assets/security/credential-patterns.mjs +59 -0
  24. package/assets/stack/api-index.ts.txt +6 -1
  25. package/assets/stack/stripe.ts.txt +30 -13
  26. package/assets/ui/catalog.json +36 -324
  27. package/dist/{platforms/web.d.ts → api-proxy.d.ts} +1 -3
  28. package/dist/api-proxy.js +48 -0
  29. package/dist/bin.js +55 -36
  30. package/dist/capability-catalog.d.ts +36 -57
  31. package/dist/capability-catalog.js +65 -67
  32. package/dist/capability-command.d.ts +3 -3
  33. package/dist/capability-command.js +146 -59
  34. package/dist/capability-editor.js +6 -5
  35. package/dist/capability-recipes.js +9 -296
  36. package/dist/cli-arguments.d.ts +2 -0
  37. package/dist/cli-arguments.js +101 -50
  38. package/dist/cli-commands.d.ts +1 -1
  39. package/dist/cli-commands.js +31 -5
  40. package/dist/cli-errors.d.ts +18 -0
  41. package/dist/cli-errors.js +63 -0
  42. package/dist/cli-output.d.ts +22 -0
  43. package/dist/cli-output.js +42 -7
  44. package/dist/command-runner.js +88 -0
  45. package/dist/command-schema.d.ts +16 -0
  46. package/dist/command-schema.js +496 -21
  47. package/dist/command-types.d.ts +1 -0
  48. package/dist/command-types.js +1 -0
  49. package/dist/completion.d.ts +2 -0
  50. package/dist/completion.js +201 -0
  51. package/dist/composition.d.ts +25 -0
  52. package/dist/composition.js +28 -0
  53. package/dist/contracts/cli-transport.d.ts +316 -0
  54. package/dist/contracts/cli-transport.js +236 -0
  55. package/dist/contracts/deployment.d.ts +233 -0
  56. package/dist/contracts/deployment.js +198 -0
  57. package/dist/contracts/environment-file.d.ts +7 -0
  58. package/dist/contracts/environment-file.js +112 -0
  59. package/dist/contracts/environment-transport.d.ts +79 -0
  60. package/dist/contracts/environment-transport.js +110 -0
  61. package/dist/contracts/production-transport.d.ts +71 -0
  62. package/dist/contracts/production-transport.js +56 -0
  63. package/dist/contracts/runtime-logs-transport.d.ts +127 -0
  64. package/dist/contracts/runtime-logs-transport.js +50 -0
  65. package/dist/contracts/source-bundle.d.ts +11 -0
  66. package/dist/contracts/source-bundle.js +197 -0
  67. package/dist/contracts/source-profile.d.ts +4 -0
  68. package/dist/contracts/source-profile.js +5 -0
  69. package/dist/contracts/staging-transport.d.ts +79 -0
  70. package/dist/contracts/staging-transport.js +43 -0
  71. package/dist/dependencies.d.ts +9 -27
  72. package/dist/dependencies.js +19 -66
  73. package/dist/index.d.ts +4 -2
  74. package/dist/index.js +3 -1
  75. package/dist/launch.d.ts +27 -0
  76. package/dist/launch.js +262 -0
  77. package/dist/platform-command.d.ts +9 -0
  78. package/dist/platform-command.js +787 -0
  79. package/dist/platform-environment.d.ts +18 -0
  80. package/dist/platform-environment.js +257 -0
  81. package/dist/platform-operations.d.ts +26 -0
  82. package/dist/platform-operations.js +155 -0
  83. package/dist/platform-production.d.ts +16 -0
  84. package/dist/platform-production.js +135 -0
  85. package/dist/platform-source.d.ts +8 -0
  86. package/dist/platform-source.js +111 -0
  87. package/dist/platform-state.d.ts +15 -0
  88. package/dist/platform-state.js +229 -0
  89. package/dist/platforms/tanstack.d.ts +10 -0
  90. package/dist/platforms/tanstack.js +248 -0
  91. package/dist/registry/usage.d.ts +4 -1
  92. package/dist/registry/usage.js +59 -4
  93. package/dist/scaffold/bootstrap.d.ts +3 -3
  94. package/dist/scaffold/styling.d.ts +3 -2
  95. package/dist/transaction.js +28 -3
  96. package/dist/ui-catalog.d.ts +3 -5
  97. package/dist/ui-catalog.js +8 -24
  98. package/dist/ui-command.d.ts +3 -1
  99. package/dist/ui-command.js +74 -72
  100. package/dist/ui-project.d.ts +4 -2
  101. package/dist/ui-project.js +40 -38
  102. package/dist/util.js +40 -61
  103. package/dist/version.d.ts +1 -1
  104. package/dist/version.js +1 -1
  105. package/docs/capabilities.md +23 -89
  106. package/docs/software-factory.md +208 -9
  107. package/docs/stack-standard.md +7 -17
  108. package/docs/ui.md +9 -22
  109. package/package.json +26 -22
  110. package/assets/stack/ai-schema.ts.txt +0 -5
  111. package/assets/stack/ai.ts.txt +0 -30
  112. package/assets/stack/desktop.rs.txt +0 -21
  113. package/assets/stack/events-schema.ts.txt +0 -12
  114. package/assets/stack/events.ts.txt +0 -59
  115. package/assets/stack/mobile-auth.ts.txt +0 -25
  116. package/assets/stack/mobile-billing.tsx.txt +0 -63
  117. package/assets/stack/mobile-session.tsx.txt +0 -83
  118. package/assets/stack/native-button.tsx.txt +0 -108
  119. package/assets/stack/native-global.css.txt +0 -4
  120. package/assets/stack/native-lib-utils.ts.txt +0 -5
  121. package/assets/stack/native-metro.config.js.txt +0 -6
  122. package/assets/stack/native-nativewind-env.d.ts.txt +0 -1
  123. package/assets/stack/native-tailwind.config.js.txt +0 -73
  124. package/assets/stack/native-text.tsx.txt +0 -89
  125. package/assets/stack/purchases.ts.txt +0 -65
  126. package/assets/stack/revenuecat.ts.txt +0 -88
  127. package/assets/stack/rtc-schema.ts.txt +0 -10
  128. package/assets/stack/rtc.ts.txt +0 -122
  129. package/assets/stack/web-sign-in.tsx.txt +0 -51
  130. package/dist/capabilities.d.ts +0 -11
  131. package/dist/capabilities.js +0 -14
  132. package/dist/dependency-order.d.ts +0 -2
  133. package/dist/dependency-order.js +0 -24
  134. package/dist/platforms/lint.d.ts +0 -1
  135. package/dist/platforms/lint.js +0 -5
  136. package/dist/platforms/web.js +0 -251
  137. package/dist/project-config.d.ts +0 -3
  138. package/dist/project-config.js +0 -16
  139. package/dist/registry/context.d.ts +0 -3
  140. package/dist/registry/context.js +0 -20
  141. package/dist/registry/options.d.ts +0 -2
  142. package/dist/registry/options.js +0 -44
  143. package/dist/registry/resolve.d.ts +0 -11
  144. package/dist/registry/resolve.js +0 -46
  145. package/dist/registry/types.d.ts +0 -60
  146. package/dist/scaffold/api.d.ts +0 -2
  147. package/dist/scaffold/api.js +0 -38
  148. package/dist/scaffold/backend.d.ts +0 -2
  149. package/dist/scaffold/backend.js +0 -36
  150. package/dist/scaffold/compose.d.ts +0 -4
  151. package/dist/scaffold/compose.js +0 -30
  152. package/dist/scaffold/database.d.ts +0 -2
  153. package/dist/scaffold/database.js +0 -41
  154. package/dist/scaffold/documentation.d.ts +0 -2
  155. package/dist/scaffold/documentation.js +0 -71
  156. package/dist/scaffold/environment.d.ts +0 -4
  157. package/dist/scaffold/environment.js +0 -22
  158. package/dist/scaffold/stack-documentation.d.ts +0 -2
  159. package/dist/scaffold/stack-documentation.js +0 -6
  160. package/dist/scaffold/storage.d.ts +0 -2
  161. package/dist/scaffold/storage.js +0 -21
  162. package/dist/scaffold/workspace.d.ts +0 -3
  163. package/dist/scaffold/workspace.js +0 -131
  164. package/dist/stack-registry.d.ts +0 -35
  165. package/dist/stack-registry.js +0 -189
  166. package/dist/standard.d.ts +0 -8
  167. package/dist/standard.js +0 -94
  168. package/dist/workspace-graph.d.ts +0 -7
  169. package/dist/workspace-graph.js +0 -74
  170. package/docs/anhedral-stack.md +0 -12
  171. package/docs/assets/anhedral-stack-light.png +0 -0
  172. package/docs/assets/anhedral-stack.png +0 -0
  173. package/docs/native-ui.md +0 -47
  174. /package/dist/{registry/types.js → command-runner.d.ts} +0 -0
package/dist/launch.js ADDED
@@ -0,0 +1,262 @@
1
+ import { existsSync, lstatSync, mkdirSync, readdirSync, realpathSync, rmdirSync } from 'node:fs';
2
+ import { randomUUID } from 'node:crypto';
3
+ import { spawnSync } from 'node:child_process';
4
+ import path from 'node:path';
5
+ import { scaffoldTanstack } from './platforms/tanstack.js';
6
+ import { bootstrapWorkspace, assertWorkspaceRuntime } from './scaffold/bootstrap.js';
7
+ import { scaffoldStyling } from './scaffold/styling.js';
8
+ import { json, put, sharedPackage } from './scaffold/files.js';
9
+ import { CapabilityEditor } from './capability-editor.js';
10
+ import { addCapabilityRecipe, composeCapabilities } from './capability-recipes.js';
11
+ import { launchCompositionSchema } from './composition.js';
12
+ import { runStagedTransaction } from './transaction.js';
13
+ import { configureDependencyPatches, writeDependencyAudit } from './dependency-patches.js';
14
+ import { setPnpmPolicy } from './pnpm-policy.js';
15
+ import { GENERATOR_VERSION } from './version.js';
16
+ import { PACKAGE_MANAGER, STACK_DEPENDENCIES, WORKSPACE_NODE_ENGINE } from './dependencies.js';
17
+ import { execFile, appendGitignore } from './util.js';
18
+ import { printProgress, printResult } from './cli-output.js';
19
+ import { CliArgumentError, commandArguments } from './cli-arguments.js';
20
+ import { packageNameFromText } from './render.js';
21
+ export function parseAnhedralStackOptions(args) {
22
+ const parsed = commandArguments('init', args);
23
+ const hasDirectory = parsed.positional.length > 0;
24
+ const directory = hasDirectory ? parsed.positional[0] : process.cwd();
25
+ if (!directory)
26
+ throw new CliArgumentError('Specify a valid initialization directory.', 'Run anhedral init --help.');
27
+ const root = path.resolve(directory);
28
+ return {
29
+ root,
30
+ name: packageNameFromText(path.basename(root)),
31
+ skipInstall: parsed.has('--skip-install'),
32
+ dryRun: parsed.has('--dry-run'),
33
+ json: parsed.has('--json'),
34
+ initializeGit: parsed.has('--git') || (!parsed.has('--no-git') && hasDirectory),
35
+ };
36
+ }
37
+ const launchCapabilities = [];
38
+ function rootFiles(root, name) {
39
+ json(root, 'package.json', {
40
+ name,
41
+ private: true,
42
+ packageManager: PACKAGE_MANAGER,
43
+ engines: { node: WORKSPACE_NODE_ENGINE },
44
+ scripts: {
45
+ dev: 'pnpm --filter @workspace/web dev',
46
+ build: 'turbo build --concurrency=1',
47
+ lint: 'turbo lint',
48
+ typecheck: 'turbo typecheck',
49
+ test: 'turbo test',
50
+ check: 'pnpm lint && pnpm typecheck && pnpm test && pnpm build',
51
+ 'audit:deps': 'node scripts/audit-deps.mjs',
52
+ },
53
+ devDependencies: { turbo: STACK_DEPENDENCIES.turbo },
54
+ });
55
+ json(root, 'turbo.json', {
56
+ $schema: 'https://turborepo.com/schema.json',
57
+ globalDependencies: ['**/.dev.vars', '**/.dev.vars.*', '**/.env', '**/.env.*'],
58
+ tasks: {
59
+ build: { dependsOn: ['^build'], outputs: ['dist/**'] },
60
+ lint: { dependsOn: ['^lint'] },
61
+ typecheck: {
62
+ dependsOn: ['^typecheck'],
63
+ outputs: ['worker-configuration.d.ts', 'src/routeTree.gen.ts'],
64
+ },
65
+ test: { dependsOn: ['^build'], outputs: ['coverage/**'] },
66
+ },
67
+ });
68
+ setPnpmPolicy(root, {
69
+ packages: ['apps/*', 'packages/*'],
70
+ sharedWorkspaceLockfile: true,
71
+ allowBuilds: { esbuild: true, workerd: true },
72
+ });
73
+ json(root, 'anhedral.json', {
74
+ schemaVersion: 1,
75
+ identity: { schemaVersion: 1, id: randomUUID() },
76
+ setup: {
77
+ schemaVersion: 1,
78
+ cliVersion: GENERATOR_VERSION,
79
+ stack: 'anhedral-stack',
80
+ resourcesProvisioned: false,
81
+ },
82
+ standard: {
83
+ schemaVersion: 1,
84
+ standard: 'anhedral-stack',
85
+ hosting: 'cloudflare',
86
+ resourcesProvisioned: false,
87
+ },
88
+ composition: launchCompositionSchema.parse({
89
+ contractVersion: 2,
90
+ foundation: 'tanstack-start',
91
+ generatorVersion: GENERATOR_VERSION,
92
+ identity: 'none',
93
+ capabilities: Object.fromEntries(launchCapabilities.map((id) => [id, GENERATOR_VERSION])),
94
+ }),
95
+ });
96
+ appendGitignore(root, 'node_modules/\ndist/\n.turbo/\n.wrangler/\n.tanstack/\n.oj-cache/\n*.tsbuildinfo\nworker-configuration.d.ts\n.dev.vars\n.dev.vars.*\n!.dev.vars.example\n.env\n.env.*\n!.env.example\n.anhedral/\n'
97
+ .trim()
98
+ .split('\n'));
99
+ writeDependencyAudit(root);
100
+ }
101
+ function documentation(root, name) {
102
+ put(root, 'README.md', `# ${name}
103
+
104
+ Anhedral Stack: web UI powered by OJ and TanStack Start server rendering/server functions
105
+ and source-owned shadcn Anhedral UI.
106
+ Only the web application is created initially. No backend or provider is provisioned.
107
+
108
+ ## Develop
109
+
110
+ Use the Node/pnpm versions in package.json. Run pnpm install if generation skipped
111
+ installation, then pnpm dev and open http://localhost:3000. Run pnpm check and
112
+ pnpm audit:deps before deployment. Editable routes live in apps/web/src/routes.
113
+ Use anhedral ui add card --web for more shadcn components; preserve local edits.
114
+
115
+ ## Add services progressively
116
+
117
+ Run anhedral add backend to add Hono, Drizzle/D1 and Better Auth together.
118
+ Then run anhedral add r2 for private storage, or anhedral add stripe for payments.
119
+ Missing prerequisites stop before writes; --with-dependencies opts into them.
120
+ The public additions are backend, r2 and stripe; this application is web-only.
121
+
122
+ After adding backend, copy apps/api/.dev.vars.example to apps/api/.dev.vars.
123
+ Set PUBLIC_APP_URL=http://localhost:3000 and generate BETTER_AUTH_SECRET with
124
+ \`node -e "console.log(require('node:crypto').randomBytes(32).toString('hex'))"\`.
125
+ Auth methods start disabled. Deliberately enable chosen methods in
126
+ apps/api/src/auth-features.ts after configuring email/credentials and policies.
127
+ Run pnpm db:migrate --local explicitly to initialize the isolated local D1 database,
128
+ then pnpm dev. OJ runs the web and auxiliary API Workers with shared local
129
+ persistence. Remote bindings are disabled for local development.
130
+
131
+ R2 routes enforce authenticated owner access. Stripe adds schema and source only:
132
+ run pnpm db:generate, review the SQL, then deliberately apply the local migration
133
+ before exercising subscription/webhook flows. Configure Stripe test credentials,
134
+ allowed prices and signed webhooks; activation and live payments are separate.
135
+
136
+ ## Ownership and deployment
137
+
138
+ Hono owns data, identity and private storage. Web server functions call its scoped
139
+ service binding, never import another application's source or provider credentials.
140
+ Custom API routes belong in apps/api/src/index.ts; schema/migrations in packages/db.
141
+ Composition adapters are fingerprinted and customized files are never overwritten.
142
+
143
+ Builds/startup never migrate databases. Provision D1/R2 only when selected and
144
+ configure environment-specific resources/secrets separately. pnpm build emits web
145
+ Worker artifacts under apps/web/dist and selected API artifacts under apps/api/dist. Anhedral Platform admission
146
+ requires its separately reviewed Anhedral Stack runtime/artifact; generation is not activation.
147
+ `);
148
+ put(root, 'AGENTS.md', `# Anhedral Stack application
149
+
150
+ Use the single Anhedral Stack, starting with TanStack Start and source-owned shadcn UI. Add backend for Hono,
151
+ Drizzle/D1 and Better Auth together. Add r2 and stripe only when required. Mobile,
152
+ extensions and desktop are outside launch scope.
153
+
154
+ Edit web product routes in apps/web/src/routes, API routes in apps/api/src/index.ts,
155
+ and database schema in packages/db/src. Preserve customized composition adapters,
156
+ semantic UI tokens and attribution. No cross-application source imports.
157
+ Web server functions receive scoped API bindings through request context; keep
158
+ identity, database/storage access and secrets inside Hono. Auth methods require
159
+ explicit activation. Run pnpm check and pnpm audit:deps. Never migrate a configured
160
+ database in builds/tests/startup; apply reviewed SQL deliberately to isolated fixtures.
161
+ `);
162
+ }
163
+ export function launchPlan(options) {
164
+ return {
165
+ schemaVersion: 1,
166
+ cliVersion: GENERATOR_VERSION,
167
+ root: options.root,
168
+ name: options.name,
169
+ products: ['tanstack-start', ...launchCapabilities],
170
+ stack: 'anhedral-stack',
171
+ foundation: 'tanstack-start',
172
+ capabilities: [...launchCapabilities],
173
+ targets: ['apps/web'],
174
+ dryRun: options.dryRun,
175
+ resourcesProvisioned: false,
176
+ hostedAdmission: 'not evaluated',
177
+ };
178
+ }
179
+ /** Fresh directories only; source commit and installation retain the existing recovery contract. */
180
+ export async function scaffoldLaunchProject(options, run = execFile, output = {}) {
181
+ const root = options.root;
182
+ const info = lstatSync(root, { throwIfNoEntry: false });
183
+ if (info && (info.isSymbolicLink() || !info.isDirectory()))
184
+ throw Error('Destination must be a real directory.');
185
+ const plan = launchPlan(options);
186
+ const display = { ...output, json: options.json };
187
+ const assertEmpty = (recovery = false) => {
188
+ if (!existsSync(root))
189
+ return;
190
+ const allowed = [
191
+ '.git',
192
+ '.gitignore',
193
+ ...(recovery ? ['.anhedral.lock', '.anhedral-txn', '.anhedral-journal.json'] : []),
194
+ ];
195
+ const extra = readdirSync(root).find((name) => !allowed.includes(name));
196
+ if (extra)
197
+ throw Error(`Destination must be empty (apart from .git/.gitignore): ${extra}`);
198
+ };
199
+ if (options.dryRun) {
200
+ assertEmpty();
201
+ printResult('init', plan, display);
202
+ return;
203
+ }
204
+ assertWorkspaceRuntime(run);
205
+ const created = !info;
206
+ if (created)
207
+ mkdirSync(root, { recursive: true });
208
+ try {
209
+ const commitPaths = [];
210
+ await runStagedTransaction(root, {
211
+ commitPaths,
212
+ seedPaths: existsSync(path.join(root, '.gitignore')) ? ['.gitignore'] : [],
213
+ prepare: () => assertEmpty(true),
214
+ build: async (stage) => {
215
+ printProgress('Creating the Anhedral Stack…', display);
216
+ bootstrapWorkspace(stage, options.name, run);
217
+ rootFiles(stage, options.name);
218
+ sharedPackage(stage, 'styling', "export { light, dark, spacing } from './tokens.cjs';\n", {});
219
+ scaffoldStyling({ root: stage });
220
+ scaffoldTanstack(stage, options.name);
221
+ const editor = new CapabilityEditor(stage, {});
222
+ const installed = [];
223
+ for (const capability of installed)
224
+ addCapabilityRecipe(editor, capability, options.name);
225
+ composeCapabilities(editor, installed);
226
+ editor.set('anhedral.json', ['capabilities'], {
227
+ schemaVersion: 1,
228
+ installed,
229
+ managedFiles: editor.managed,
230
+ resourcesProvisionedByCli: false,
231
+ });
232
+ for (const [file, source] of editor.writes)
233
+ put(stage, file, source);
234
+ documentation(stage, options.name);
235
+ if (!options.skipInstall) {
236
+ printProgress('Resolving Anhedral Stack dependencies…', display);
237
+ run('pnpm', ['install', '--lockfile-only', '--no-frozen-lockfile'], stage);
238
+ if (configureDependencyPatches(stage))
239
+ run('pnpm', ['install', '--lockfile-only', '--no-frozen-lockfile'], stage);
240
+ }
241
+ commitPaths.push(...readdirSync(stage).filter((name) => name !== 'node_modules'));
242
+ },
243
+ afterCommit: () => {
244
+ if (options.initializeGit) {
245
+ const checkout = spawnSync('git', ['rev-parse', '--show-toplevel'], {
246
+ cwd: root,
247
+ encoding: 'utf8',
248
+ });
249
+ if (checkout.status !== 0 || realpathSync(checkout.stdout.trim()) !== realpathSync(root))
250
+ run('git', ['init'], root);
251
+ }
252
+ if (!options.skipInstall)
253
+ run('pnpm', ['install', '--frozen-lockfile'], root);
254
+ },
255
+ });
256
+ printResult('init', { ...plan, generated: true, dependenciesInstalled: !options.skipInstall }, display);
257
+ }
258
+ finally {
259
+ if (created && existsSync(root) && readdirSync(root).length === 0)
260
+ rmdirSync(root);
261
+ }
262
+ }
@@ -0,0 +1,9 @@
1
+ import { type OutputOptions } from './cli-output.js';
2
+ import { type SecretStore } from './platform-state.js';
3
+ interface PlatformDependencies {
4
+ store?: SecretStore;
5
+ fetch?: typeof fetch;
6
+ sleep?: (ms: number) => Promise<void>;
7
+ }
8
+ export declare function runPlatformCommand(command: string, args: string[], output: OutputOptions, dependencies?: PlatformDependencies): Promise<void>;
9
+ export {};