anhedral 0.1.10 → 0.4.0

package/docs/output-tree-contract.md

@@ -0,0 +1,482 @@
+# Generated Output-Tree Contract
+
+<!-- Generated by tests/update-output-tree-contracts.js. Do not edit by hand. -->
+
+These source-only trees are generated with the stable toolchain and `--skip-install`.
+Each contract records every file or symlink path, Unix mode, byte length, and SHA-256 digest.
+Installed dependencies, compiler output, and framework caches are forbidden.
+Deterministic provider-placeholder `.env.example` files are hashed by the contract; generated real `.env` files are forbidden.
+
+Runtime E2E builds use disposable operating-system temp directories and are not part of these golden trees.
+A generated project may contain only the root `pnpm-workspace.yaml` and root `pnpm-lock.yaml`; nested pnpm workspace islands are rejected.
+
+Regenerate after an intentional scaffold change:
+
+```sh
+pnpm build
+node tests/update-output-tree-contracts.js
+```
+
+## Scenario summary
+
+| Scenario | Apps | Features | Contract | Entries | Tree SHA-256 |
+| --- | --- | --- | --- | ---: | --- |
+| `expo-extension` | web, mobile, api, desktop, extension | database, auth, billing, storage, nativeSubscriptions, electronUpdater | deterministic golden | 145 | `ffe0feed203c4cdfaeeadba03dd2acc93855296699570d81f856b989f45cde23` |
+| `web-api-minimal` | web, api | database, auth | deterministic golden | 65 | `25303118c1ee766afbfd9a707b5b16c25ad587021a62a68238696dda7cbc4385` |
+| `api-only` | api |  | deterministic golden | 32 | `a405e93cea274273bf46605e934e4a9be21018513b04c47c83ed1b1b8c9f187e` |
+| `add-desktop-flow` | api, desktop | database, auth | deterministic golden | 67 | `d6804478404c2bb62945f6a7dbb9d1184ebe75d3594b83347cab76e785b21051` |
+
+## expo-extension
+
+All app surfaces and feature modules
+
+```text
+expo-extension-sample/
+├── .env.example
+├── .github/
+│   └── workflows/
+│       └── anhedral-ci.yml
+├── .gitignore
+├── .vercelignore
+├── ANHEDRAL.md
+├── PRODUCTION.md
+├── README.md
+├── SKILL.md
+├── anhedral.json
+├── apps/
+│   ├── api/
+│   │   ├── .env.example
+│   │   ├── .gitignore
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   ├── application.ts
+│   │   │   ├── auth.ts
+│   │   │   ├── billing.ts
+│   │   │   ├── env.ts
+│   │   │   ├── index.ts
+│   │   │   ├── realtime.ts
+│   │   │   ├── routes/
+│   │   │   │   └── app.ts
+│   │   │   ├── routes.ts
+│   │   │   └── storage.ts
+│   │   ├── tests/
+│   │   │   ├── env.test.ts
+│   │   │   ├── health.test.ts
+│   │   │   ├── revenuecat-webhook.test.ts
+│   │   │   └── storage.test.ts
+│   │   ├── tsconfig.json
+│   │   └── vitest.config.ts
+│   ├── assets-private-proxy/
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   └── index.js
+│   │   └── wrangler.jsonc
+│   ├── desktop/
+│   │   ├── .env.example
+│   │   ├── components.json
+│   │   ├── electron-builder.env.example
+│   │   ├── index.html
+│   │   ├── package.json
+│   │   ├── postcss.config.mjs
+│   │   ├── scripts/
+│   │   │   ├── dev.mjs
+│   │   │   └── publish-updates.mjs
+│   │   ├── src/
+│   │   │   ├── main/
+│   │   │   │   ├── app-window.ts
+│   │   │   │   ├── main.ts
+│   │   │   │   └── preload.cts
+│   │   │   └── renderer/
+│   │   │       ├── components/
+│   │   │       │   └── ui/
+│   │   │       │       └── button.tsx
+│   │   │       ├── hooks/
+│   │   │       │   └── use-entitlement.ts
+│   │   │       ├── lib/
+│   │   │       │   ├── api.ts
+│   │   │       │   ├── auth.ts
+│   │   │       │   └── utils.ts
+│   │   │       ├── main.tsx
+│   │   │       └── styles.css
+│   │   ├── tsconfig.json
+│   │   ├── tsconfig.main.json
+│   │   └── vite.config.ts
+│   ├── desktop-updater-worker/
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   └── index.js
+│   │   ├── tests/
+│   │   │   └── worker.test.js
+│   │   └── wrangler.jsonc
+│   ├── extension/
+│   │   ├── .env.example
+│   │   ├── README.md
+│   │   ├── components.json
+│   │   ├── package.json
+│   │   ├── postcss.config.cjs
+│   │   ├── src/
+│   │   │   ├── components/
+│   │   │   │   └── ui/
+│   │   │   │       └── button.tsx
+│   │   │   ├── contexts/
+│   │   │   │   └── auth-context.tsx
+│   │   │   ├── entrypoints/
+│   │   │   │   ├── background.ts
+│   │   │   │   └── sidepanel/
+│   │   │   │       ├── app.tsx
+│   │   │   │       ├── index.html
+│   │   │   │       └── main.tsx
+│   │   │   ├── hooks/
+│   │   │   │   └── use-entitlement.ts
+│   │   │   ├── lib/
+│   │   │   │   ├── api.ts
+│   │   │   │   └── utils.ts
+│   │   │   └── styles/
+│   │   │       └── main.css
+│   │   ├── tailwind.config.cjs
+│   │   ├── tsconfig.json
+│   │   └── wxt.config.ts
+│   ├── mobile/
+│   │   ├── .env.example
+│   │   ├── .gitignore
+│   │   ├── app/
+│   │   │   ├── _layout.tsx
+│   │   │   └── index.tsx
+│   │   ├── app.json
+│   │   ├── babel.config.js
+│   │   ├── components/
+│   │   │   └── account-controls.tsx
+│   │   ├── components.json
+│   │   ├── eas.json
+│   │   ├── expo-env.d.ts
+│   │   ├── global.css
+│   │   ├── hooks/
+│   │   │   ├── use-api-client.ts
+│   │   │   └── use-entitlement.ts
+│   │   ├── lib/
+│   │   │   ├── api.ts
+│   │   │   ├── subscriptions.ts
+│   │   │   └── utils.ts
+│   │   ├── metro.config.js
+│   │   ├── nativewind-env.d.ts
+│   │   ├── package.json
+│   │   ├── tailwind.config.js
+│   │   └── tsconfig.json
+│   └── web/
+│       ├── .env.example
+│       ├── app/
+│       │   ├── globals.css
+│       │   ├── layout.tsx
+│       │   └── page.tsx
+│       ├── components/
+│       │   ├── account-actions.tsx
+│       │   ├── subscription-status.tsx
+│       │   └── ui/
+│       │       ├── button.tsx
+│       │       └── card.tsx
+│       ├── components.json
+│       ├── hooks/
+│       │   ├── use-api-client.ts
+│       │   └── use-entitlement.ts
+│       ├── lib/
+│       │   ├── api.ts
+│       │   └── utils.ts
+│       ├── next-env.d.ts
+│       ├── next.config.ts
+│       ├── package.json
+│       ├── postcss.config.mjs
+│       └── tsconfig.json
+├── cloudflare/
+│   ├── README.md
+│   ├── desktop-updates.md
+│   └── r2-cors.template.json
+├── docs/
+│   ├── DEVELOPMENT.md
+│   └── STACK.md
+├── package.json
+├── packages/
+│   ├── api-client/
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   ├── app.ts
+│   │   │   ├── generated.ts
+│   │   │   └── index.ts
+│   │   └── tsconfig.json
+│   ├── contracts/
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   ├── app.ts
+│   │   │   ├── generated.ts
+│   │   │   └── index.ts
+│   │   └── tsconfig.json
+│   ├── db/
+│   │   ├── .env.example
+│   │   ├── drizzle.config.ts
+│   │   ├── migrations/
+│   │   │   └── .gitkeep
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   ├── app-schema.ts
+│   │   │   ├── generated-schema.ts
+│   │   │   ├── index.ts
+│   │   │   ├── migrate.ts
+│   │   │   └── schema.ts
+│   │   └── tsconfig.json
+│   └── realtime/
+│       ├── package.json
+│       ├── src/
+│       │   └── index.ts
+│       └── tsconfig.json
+├── pnpm-workspace.yaml
+├── scripts/
+│   └── verify-db-migrations.mjs
+├── turbo.json
+└── vercel.json
+```
+
+## web-api-minimal
+
+Next.js, Fastify, database, and auth
+
+```text
+web-api-minimal/
+├── .env.example
+├── .github/
+│   └── workflows/
+│       └── anhedral-ci.yml
+├── .gitignore
+├── .vercelignore
+├── ANHEDRAL.md
+├── PRODUCTION.md
+├── README.md
+├── SKILL.md
+├── anhedral.json
+├── apps/
+│   ├── api/
+│   │   ├── .env.example
+│   │   ├── .gitignore
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   ├── application.ts
+│   │   │   ├── auth.ts
+│   │   │   ├── env.ts
+│   │   │   ├── index.ts
+│   │   │   ├── routes/
+│   │   │   │   └── app.ts
+│   │   │   └── routes.ts
+│   │   ├── tests/
+│   │   │   ├── env.test.ts
+│   │   │   └── health.test.ts
+│   │   ├── tsconfig.json
+│   │   └── vitest.config.ts
+│   └── web/
+│       ├── .env.example
+│       ├── app/
+│       │   ├── globals.css
+│       │   ├── layout.tsx
+│       │   └── page.tsx
+│       ├── components/
+│       │   ├── account-actions.tsx
+│       │   └── ui/
+│       │       ├── button.tsx
+│       │       └── card.tsx
+│       ├── components.json
+│       ├── hooks/
+│       │   └── use-api-client.ts
+│       ├── lib/
+│       │   ├── api.ts
+│       │   └── utils.ts
+│       ├── next-env.d.ts
+│       ├── next.config.ts
+│       ├── package.json
+│       ├── postcss.config.mjs
+│       └── tsconfig.json
+├── docs/
+│   ├── DEVELOPMENT.md
+│   └── STACK.md
+├── package.json
+├── packages/
+│   ├── api-client/
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   ├── app.ts
+│   │   │   ├── generated.ts
+│   │   │   └── index.ts
+│   │   └── tsconfig.json
+│   ├── contracts/
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   ├── app.ts
+│   │   │   ├── generated.ts
+│   │   │   └── index.ts
+│   │   └── tsconfig.json
+│   └── db/
+│       ├── .env.example
+│       ├── drizzle.config.ts
+│       ├── migrations/
+│       │   └── .gitkeep
+│       ├── package.json
+│       ├── src/
+│       │   ├── app-schema.ts
+│       │   ├── generated-schema.ts
+│       │   ├── index.ts
+│       │   ├── migrate.ts
+│       │   └── schema.ts
+│       └── tsconfig.json
+├── pnpm-workspace.yaml
+├── scripts/
+│   └── verify-db-migrations.mjs
+├── turbo.json
+└── vercel.json
+```
+
+## api-only
+
+Minimal Fastify API without database or auth
+
+```text
+api-only/
+├── .env.example
+├── .github/
+│   └── workflows/
+│       └── anhedral-ci.yml
+├── .gitignore
+├── .vercelignore
+├── ANHEDRAL.md
+├── PRODUCTION.md
+├── README.md
+├── SKILL.md
+├── anhedral.json
+├── apps/
+│   └── api/
+│       ├── .env.example
+│       ├── .gitignore
+│       ├── package.json
+│       ├── src/
+│       │   ├── application.ts
+│       │   ├── env.ts
+│       │   ├── index.ts
+│       │   ├── routes/
+│       │   │   └── app.ts
+│       │   └── routes.ts
+│       ├── tests/
+│       │   ├── env.test.ts
+│       │   └── health.test.ts
+│       ├── tsconfig.json
+│       └── vitest.config.ts
+├── docs/
+│   ├── DEVELOPMENT.md
+│   └── STACK.md
+├── package.json
+├── packages/
+│   └── contracts/
+│       ├── package.json
+│       ├── src/
+│       │   ├── app.ts
+│       │   ├── generated.ts
+│       │   └── index.ts
+│       └── tsconfig.json
+├── pnpm-workspace.yaml
+├── turbo.json
+└── vercel.json
+```
+
+## add-desktop-flow
+
+API-first project with desktop added afterward
+
+```text
+add-desktop-flow/
+├── .env.example
+├── .github/
+│   └── workflows/
+│       └── anhedral-ci.yml
+├── .gitignore
+├── .vercelignore
+├── ANHEDRAL.md
+├── PRODUCTION.md
+├── README.md
+├── SKILL.md
+├── anhedral.json
+├── apps/
+│   ├── api/
+│   │   ├── .env.example
+│   │   ├── .gitignore
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   ├── application.ts
+│   │   │   ├── auth.ts
+│   │   │   ├── env.ts
+│   │   │   ├── index.ts
+│   │   │   ├── routes/
+│   │   │   │   └── app.ts
+│   │   │   └── routes.ts
+│   │   ├── tests/
+│   │   │   ├── env.test.ts
+│   │   │   └── health.test.ts
+│   │   ├── tsconfig.json
+│   │   └── vitest.config.ts
+│   └── desktop/
+│       ├── .env.example
+│       ├── components.json
+│       ├── index.html
+│       ├── package.json
+│       ├── postcss.config.mjs
+│       ├── scripts/
+│       │   └── dev.mjs
+│       ├── src/
+│       │   ├── main/
+│       │   │   ├── app-window.ts
+│       │   │   ├── main.ts
+│       │   │   └── preload.cts
+│       │   └── renderer/
+│       │       ├── components/
+│       │       │   └── ui/
+│       │       │       └── button.tsx
+│       │       ├── lib/
+│       │       │   ├── api.ts
+│       │       │   ├── auth.ts
+│       │       │   └── utils.ts
+│       │       ├── main.tsx
+│       │       └── styles.css
+│       ├── tsconfig.json
+│       ├── tsconfig.main.json
+│       └── vite.config.ts
+├── docs/
+│   ├── DEVELOPMENT.md
+│   └── STACK.md
+├── package.json
+├── packages/
+│   ├── api-client/
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   ├── app.ts
+│   │   │   ├── generated.ts
+│   │   │   └── index.ts
+│   │   └── tsconfig.json
+│   ├── contracts/
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   ├── app.ts
+│   │   │   ├── generated.ts
+│   │   │   └── index.ts
+│   │   └── tsconfig.json
+│   └── db/
+│       ├── .env.example
+│       ├── drizzle.config.ts
+│       ├── migrations/
+│       │   └── .gitkeep
+│       ├── package.json
+│       ├── src/
+│       │   ├── app-schema.ts
+│       │   ├── generated-schema.ts
+│       │   ├── index.ts
+│       │   ├── migrate.ts
+│       │   └── schema.ts
+│       └── tsconfig.json
+├── pnpm-workspace.yaml
+├── scripts/
+│   └── verify-db-migrations.mjs
+├── turbo.json
+└── vercel.json
+```