anhedral 0.4.1 → 0.6.0

package/docs/master-stack-map.md

@@ -1,199 +0,0 @@
-# Anhedral master stack map
-
-This is the canonical whole-stack map for Anhedral. It shows the ordered flow
-from skill-led planning through deterministic generation, source layout,
-connected capabilities, cloud provisioning, command-driven operations, agent
-experience, and production verification.
-
-![Anhedral master stack diagram](../assets/anhedral-cli-init.svg)
-
-The diagram is generated from `scripts/render-master-stack-map.mjs`. Change the
-content or geometry there, then run `pnpm docs:stack-map`; do not hand-edit the
-SVG. The fixed-width map below remains the detailed text and accessibility
-reference.
-
-Read top to bottom. Arrows represent lifecycle order, not runtime network calls.
-Runtime and provider connections are stated explicitly inside each stage.
-
-```text
-+==========================================================================================================================+
-|                                                ANHEDRAL MASTER STACK MAP                                                 |
-+--------------------------------------------------------------------------------------------------------------------------+
-|OUTCOME One readable TypeScript codebase and one command surface connecting every application, cloud resource, release    |
-|path, runbook, and coding agent.                                                                                          |
-|PRINCIPLE Ordinary framework code, source ownership, and generated integration boundaries. Anhedral assembles the stack;  |
-|it is not the application runtime.                                                                                        |
-+==========================================================================================================================+
-                                                             |
-                                                             v
-+==========================================================================================================================+
-|                                                     1  SELECT + PLAN                                                     |
-+--------------------------------------------------------------------------------------------------------------------------+
-|SKILL FIRST Install and invoke $anhedral-init. Ask for project name and custom-domain status before generating or         |
-|provisioning.                                                                                                             |
-|CREATE anhedral new <directory> | anhedral init EXTEND anhedral add <modules> | anhedral ui add <components>              |
-|INSPECT anhedral doctor AUTOMATE --dry-run | --json | --verbose | --skip-install                                          |
-|SURFACES web | mobile | api | desktop | extension                                                                         |
-|FEATURES db | auth | billing | storage | native-subscriptions | electron-updater                                          |
-|UI shadcn/ui for DOM clients | React Native Reusables for Expo | NativeWind or Uniwind                                    |
-|CLOSURE auth -> api + db | billing -> auth | storage -> auth | native-subscriptions -> mobile + billing |                 |
-|electron-updater -> desktop                                                                                               |
-+==========================================================================================================================+
-                                                             |
-                                                             v
-+==========================================================================================================================+
-|                                                    2  GENERATE SAFELY                                                    |
-+--------------------------------------------------------------------------------------------------------------------------+
-|PIPELINE Resolve modules -> select immutable templates -> verify SHA-256 catalog -> stage files -> compose typed          |
-|contributions.                                                                                                            |
-|PIPELINE Run pinned UI providers only in staging -> record provenance and ownership -> atomic commit -> one root pnpm     |
-|install.                                                                                                                  |
-|REFUSES traversal | symlinks | nested repositories/workspaces | caches | oversized files | unowned collisions | managed   |
-|drift.                                                                                                                    |
-|OWNERSHIP Product source plus README/PRODUCTION are user-owned | root configuration is mergeable | integration substrate  |
-|is managed.                                                                                                               |
-|STATE anhedral.json records modules, versions, template/UI provenance, styling, file hashes, modes, and ownership.        |
-|WHY Deterministic, inspectable generation and safe incremental adds without replacing user work.                          |
-+==========================================================================================================================+
-                                                             |
-                                                             v
-+==========================================================================================================================+
-|                                       3  ONE PNPM + TURBOREPO TYPESCRIPT WORKSPACE                                       |
-+--------------------------------------------------------------------------------------------------------------------------+
-|apps/web Next.js App Router + React + shadcn/ui. WHY: SSR, routing, server-first web, and source-owned UI.                |
-|apps/mobile Expo Router + React Native Reusables. WHY: one native TypeScript product for iOS and Android.                 |
-|apps/api Fastify + validation/security plugins. WHY: thin routes, services, structured logs, and explicit boundaries.     |
-|apps/desktop Electron + Vite + sandboxed React renderer. WHY: cross-platform desktop with a narrow privileged bridge.     |
-|apps/extension WXT + React + MV3 entrypoints. WHY: browser permissions, side panel/background, builds, and packaging.     |
-|apps/assets-private-proxy Cloudflare Worker + private R2 binding. WHY: controlled GET/HEAD media delivery without bucket  |
-|listing.                                                                                                                  |
-|apps/desktop-updater-worker Cloudflare Worker + private R2 binding. WHY: custom-domain Electron metadata, ranges, and     |
-|downloads.                                                                                                                |
-|packages/contracts Zod schemas. WHY: one validated network contract shared across every boundary.                         |
-|packages/api-client Typed client-safe HTTP. WHY: one request path for web, mobile, desktop, and extension.                |
-|packages/db Drizzle schema + reviewed SQL migrations. WHY: readable TypeScript schema and explicit release artifacts.     |
-|packages/realtime Ably client. WHY: scoped invalidation events while clients refetch authoritative state.                 |
-+==========================================================================================================================+
-                                                             |
-                                                             v
-+==========================================================================================================================+
-|                                            4  CONNECTED PRODUCT CAPABILITIES                                             |
-+--------------------------------------------------------------------------------------------------------------------------+
-|REQUESTS Zod contract -> service/Drizzle query -> Fastify route -> typed API client -> every selected client.             |
-|IDENTITY Clerk sessions in clients -> verified server identity; never trust a client-supplied user ID.                    |
-|DATABASE Fastify -> Drizzle -> managed Neon Postgres with isolated dev/preview/production; no generated local Postgres.   |
-|STORAGE API presigns R2 PUT -> client uploads -> API confirms -> Worker streams confirmed assets or owner-authorized      |
-|reads.                                                                                                                    |
-|BILLING Expo purchase -> RevenueCat -> signed webhook -> Neon entitlement + transactional outbox.                         |
-|REALTIME Outbox -> scoped Ably event -> every client refetches the authoritative entitlement.                             |
-|DESKTOP UPDATE Signed native build -> artifacts then latest metadata -> private R2 -> updates.<domain> Worker ->          |
-|electron-updater.                                                                                                         |
-|SECURITY Server-only secrets | exact CORS | rate limits/headers | Electron isolation | least privilege | private buckets. |
-+==========================================================================================================================+
-                                                             |
-                                                             v
-+==========================================================================================================================+
-|                                            5  PROVISION + CONFIGURE THE CLOUD                                            |
-+--------------------------------------------------------------------------------------------------------------------------+
-|DOMAIN Buy/confirm domain -> add Cloudflare zone -> preserve mail records -> delegate nameservers -> activate DNSSEC.     |
-|GITHUB + CI Organization repository, protected environments, pinned Actions, PR checks, branches, and release artifacts.  |
-|NEON Projects/branches per environment, pooled DATABASE_URL, backups, reviewed migrations, and controlled deploy gates.   |
-|CLERK Development/production instances, publishable/secret keys, domains, OAuth, redirects, webhooks, native and CRX IDs. |
-|CLOUDFLARE Authoritative DNS, private R2 buckets, scoped tokens, CORS/lifecycle, Worker bindings, logs, and custom        |
-|domains.                                                                                                                  |
-|VERCEL Services deployment for web/API, rewrites, environment scopes, preview/production, cron endpoints, domains, and    |
-|TLS.                                                                                                                      |
-|REVENUECAT + ABLY Products, offerings, entitlements, store credentials, signed webhook, scoped realtime, and retry cron.  |
-|EAS + STORES Expo project, credentials, internal builds, TestFlight/Play testing, metadata, privacy, review, and rollout. |
-|BROWSER STORE Stable extension ID, least host permissions, OAuth sync, privacy disclosure, trusted testing, and review.   |
-|DESKTOP Native-OS signing/notarization, electron-builder installers, private update channel, upgrade tests, and rollback. |
-|DNS app.<domain> points from Cloudflare DNS to Vercel and stays DNS-only; assets/updates are Cloudflare Worker Custom     |
-|Domains.                                                                                                                  |
-|AGENT STOPS User handles sign-in/MFA, purchases, secret generation/reveal, destructive confirmations, and final           |
-|submissions.                                                                                                              |
-+==========================================================================================================================+
-                                                             |
-                                                             v
-+==========================================================================================================================+
-|                                        6  GENERATED package.json COMMAND SURFACE                                         |
-+--------------------------------------------------------------------------------------------------------------------------+
-|WORKSPACE dev | build | typecheck | verify WHY: run and validate exactly the selected monorepo.                           |
-|APP LOOPS dev:web | dev:mobile | dev:api | dev:desktop | dev:extension                                                    |
-|APP CHECKS verify:web | verify:mobile | verify:api | verify:desktop | verify:extension                                    |
-|VERCEL deploy:vercel:{link,preview,production,inspect,domain:inspect} WHY: connect, release, diagnose, and configure DNS. |
-|MOBILE mobile:eas:{login,init} | mobile:build:{internal,production}:{ios,android} | mobile:submit:{ios,android}           |
-|DATABASE neon:{login,project:create} | db:{generate,migrate,check,studio} | verify:db                                     |
-|STORAGE r2:{login,bucket:create,cors:list,cors:set} | assets:proxy:{check,dev,deploy} | verify:assets-proxy               |
-|UPDATES desktop:updates:{cloudflare:login,bucket:create,provision,publish}                                                |
-|UPDATES desktop:updates:worker:{check,dev,deploy,types} | desktop:updates:build:{mac,win,linux} | verify:desktop-updates  |
-|DESKTOP desktop:build | verify:desktop EXTENSION extension:zip | verify:extension                                         |
-|STRUCTURE anhedral doctor | add/ui --dry-run WHY: detect drift and preview safe structural changes.                       |
-+==========================================================================================================================+
-                                                             |
-                                                             v
-+==========================================================================================================================+
-|                                      7  DEVELOPER, AGENT + COMPUTER-USE EXPERIENCE                                       |
-+--------------------------------------------------------------------------------------------------------------------------+
-|DOCS README.md first run/source map | docs/DEVELOPMENT.md recipes | docs/STACK.md tool map | PRODUCTION.md cloud runbook. |
-|CONTROL SKILL.md agent workflow | ANHEDRAL.md ownership notes | anhedral.json source of truth | .env.example inventories. |
-|CODING AGENT Ask name/domain -> resolve modules -> generate -> read docs/manifest -> doctor -> provision -> verify ->     |
-|hand off.                                                                                                                 |
-|SUBAGENTS Lead owns mutations; delegate docs/env inventory, read-only DNS checks, and final verification without secrets. |
-|COMPUTER USE Drive provider consoles after user authentication; configure accounts, domains, OAuth, DNS, stores, and      |
-|rollout.                                                                                                                  |
-|SECRET HANDOFF Stop before Generate/Reveal/Create; name the variable/file; user pastes directly into uncommitted          |
-|env/provider UI.                                                                                                          |
-|UI DX Source-owned components, target routing, accessibility, ordinary framework APIs, and no hidden proprietary runtime. |
-|OPERATIONS DX Exact root commands, selection-aware docs/scripts, machine-readable plans, provider ledger, and explicit    |
-|stop gates.                                                                                                               |
-+==========================================================================================================================+
-                                                             |
-                                                             v
-+==========================================================================================================================+
-|                                               8  VERIFY, RELEASE + OPERATE                                               |
-+--------------------------------------------------------------------------------------------------------------------------+
-|LOCAL Smallest package check -> typecheck -> full verify -> build -> doctor; never weaken a failing gate.                 |
-|DATABASE Generate -> review/commit SQL -> drift gate -> controlled migrate -> health/readiness checks.                    |
-|RUNTIME API coverage, auth/CORS, billing replay/order, Ably reconnect, R2 upload/read/range/cache, Worker method/host     |
-|security.                                                                                                                 |
-|CLIENTS Next build | Expo compatibility/device checks | packaged Electron smoke/upgrade | live WXT MV3 worker in Chrome.  |
-|INFRA Confirm provider team/resource names, protected env presence, DNS answers, TLS, Vercel health, Worker bindings, and |
-|logs.                                                                                                                     |
-|CI Pinned toolchain, strict pnpm policy, allowed build scripts, OSV audit, secret scan, deterministic outputs, and        |
-|release checks.                                                                                                           |
-|RELEASES Vercel preview/prod | TestFlight/Play tracks | browser-store trusted/review | signed desktop staged update       |
-|channel.                                                                                                                  |
-|RECOVERY Transaction rollback, provider backups, database rollback plan, staged/phased rollout, telemetry, and documented |
-|owners.                                                                                                                   |
-+==========================================================================================================================+
-```
-
-## Runtime connection summary
-
-```text
-web / mobile / desktop / extension
-                |
-                v
-       packages/api-client
-                |
-                v
-       Fastify API + Zod contracts
-          |         |          |
-          v         v          v
-   Clerk identity  Neon     private R2
-                    |
-                    v
-          RevenueCat entitlement
-                    |
-                    v
-               Ably event
-                    |
-                    v
-           clients refetch state
-
-signed desktop release -> private update R2 -> updates.<domain> Worker -> electron-updater
-```
-
-The runtime summary is intentionally smaller than the lifecycle map. It shows
-only application data flow; DNS, provisioning, release gates, and agent actions
-remain in the master map above.

package/docs/output-tree-contract.md

@@ -1,482 +0,0 @@
-# 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 | `bc2ffd2b31666349e9fbf385b5c8e2df520968a6a2ef1eeba9c431f3b1690ed2` |
-| `web-api-minimal` | web, api | database, auth | deterministic golden | 65 | `3311e164a5ec03c232dbfeabb35209f9c8206422c1864179d39a65d2d54cf443` |
-| `api-only` | api |  | deterministic golden | 32 | `3f0c4317a7c3aa06d5e51f7196dc835c6f47ec34c0a4d6daf8d17355a541baaa` |
-| `add-desktop-flow` | api, desktop | database, auth | deterministic golden | 67 | `f78d74dc4d32688ebb5b88bbe16bc01f68590254c1799be8b7b18f3566ed8c7a` |
-
-## 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
-```