anhedral 0.1.9 → 0.3.0

package/docs/output-tree-contract.md

@@ -0,0 +1,442 @@
+# 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 | deterministic golden | 130 | `997fff94b7a61b48b063634523e88146d9b454013285f233ddf44afa12b22693` |
+| `web-api-minimal` | web, api | database, auth | deterministic golden | 58 | `5e178bce3710dfbbbdd78acb7021f18c213d4ad80a93ac345c436e1372549f99` |
+| `api-only` | api |  | deterministic golden | 29 | `f067a459375b49d53e9c031b917851e30dc0c4c67a583018ba4972cd480467fc` |
+| `add-desktop-flow` | api, desktop | database, auth | deterministic golden | 59 | `7955805e03d0ee3cb1efadfffe2886f27335e29e1c0f22408b5df637f7c31a74` |
+
+## 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.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
+│   │   ├── index.html
+│   │   ├── package.json
+│   │   ├── postcss.config.mjs
+│   │   ├── scripts/
+│   │   │   └── dev.mjs
+│   │   ├── src/
+│   │   │   ├── main/
+│   │   │   │   ├── 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
+│   ├── 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
+│   └── r2-cors.template.json
+├── docs/
+│   ├── DEVELOPMENT.md
+│   └── STACK.md
+├── package.json
+├── packages/
+│   ├── api-client/
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   └── index.ts
+│   │   └── tsconfig.json
+│   ├── contracts/
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   └── index.ts
+│   │   └── tsconfig.json
+│   ├── db/
+│   │   ├── .env.example
+│   │   ├── drizzle.config.ts
+│   │   ├── migrations/
+│   │   │   └── .gitkeep
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   ├── 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.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/
+│   │   │   └── index.ts
+│   │   └── tsconfig.json
+│   ├── contracts/
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   └── index.ts
+│   │   └── tsconfig.json
+│   └── db/
+│       ├── .env.example
+│       ├── drizzle.config.ts
+│       ├── migrations/
+│       │   └── .gitkeep
+│       ├── package.json
+│       ├── src/
+│       │   ├── 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.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/
+│       │   └── 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.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/
+│       │   │   ├── 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/
+│   │   │   └── index.ts
+│   │   └── tsconfig.json
+│   ├── contracts/
+│   │   ├── package.json
+│   │   ├── src/
+│   │   │   └── index.ts
+│   │   └── tsconfig.json
+│   └── db/
+│       ├── .env.example
+│       ├── drizzle.config.ts
+│       ├── migrations/
+│       │   └── .gitkeep
+│       ├── package.json
+│       ├── src/
+│       │   ├── index.ts
+│       │   ├── migrate.ts
+│       │   └── schema.ts
+│       └── tsconfig.json
+├── pnpm-workspace.yaml
+├── scripts/
+│   └── verify-db-migrations.mjs
+├── turbo.json
+└── vercel.json
+```

package/package.json

@@ -1,55 +1,98 @@
 {
   "name": "anhedral",
-  "version": "0.1.9",
-  "description": "Opinionated init CLI for Expo, Fastify, WXT, shared packages, Neon, Drizzle, Clerk, RevenueCat, Stripe, R2, and Vercel.",
+  "version": "0.3.0",
+  "description": "Generate a complete, readable TypeScript product stack with Next.js, Expo, Fastify, Neon, Drizzle, Clerk, R2, Electron, WXT, and Vercel.",
   "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
   "bin": {
     "anhedral": "bin/anhedral.js"
   },
   "files": [
     "bin",
     "dist",
+    "docs/conventions.md",
+    "docs/output-tree-contract.md",
+    "templates",
+    "references",
+    "SKILL.md",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
     "LICENSE",
     "README.md",
+    "SECURITY.md",
     "anhedral.svg",
     "favicon.ico"
   ],
+  "homepage": "https://github.com/anhedral/anhedral-init#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/anhedral/anhedral-init.git"
   },
-  "homepage": "https://github.com/anhedral/anhedral-init#readme",
   "bugs": {
     "url": "https://github.com/anhedral/anhedral-init/issues"
   },
+  "author": "Anhedral, Inc.",
   "publishConfig": {
     "access": "public"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": "^20.19.0 || >=22.12.0"
   },
   "scripts": {
-    "scaffold": "node dist/index.js init",
-    "build": "tsc",
+    "scaffold": "node dist/bin.js init",
+    "clean": "node scripts/clean.mjs",
+    "build": "pnpm clean && tsc",
     "prepare": "pnpm build",
     "typecheck": "tsc --noEmit",
+    "check:hygiene": "node scripts/check-source-hygiene.mjs",
+    "check:security": "node scripts/check-security-policy.mjs",
+    "check:release-policy": "node scripts/check-release-policy.mjs",
+    "check:release-secrets": "node scripts/check-release-secrets.mjs",
+    "lint": "pnpm typecheck && pnpm check:hygiene && pnpm check:release-policy",
+    "audit:osv": "pnpm build && node scripts/audit-osv.mjs --generator",
     "test": "pnpm test:cli",
+    "test:coverage": "pnpm build && c8 --all --include='dist/**/*.js' --reporter=text --reporter=json-summary --check-coverage --lines 84 --statements 84 --functions 84 --branches 80 node tests/test-cli.js",
     "pretest": "pnpm build",
     "prepublishOnly": "pnpm test:all",
     "test:cli": "node tests/test-cli.js",
     "test:cli:validation": "node tests/test-cli-validation.js",
     "test:deps": "pnpm build && node tests/test-dependency-manifest.js",
+    "test:vercel-schema": "pnpm build && node tests/test-vercel-services-schema.js",
+    "test:pack": "pnpm build && node tests/test-packed-cli.js",
+    "test:pack:exact": "node tests/test-packed-cli.js release-artifact/metadata.json",
+    "test:packlist": "pnpm build && node tests/test-packlist.js",
+    "test:release-tooling": "node tests/test-release-tooling.js",
+    "test:topologies": "pnpm build && node tests/test-module-topology-invariants.js",
+    "test:templates": "pnpm build && node tests/test-template-source.js",
+    "pretest:e2e": "pnpm build",
     "test:e2e": "node tests/test-e2e-public-stacks.js",
+    "pretest:e2e:latest": "pnpm build",
     "test:e2e:latest": "node tests/test-e2e-public-stacks.js --toolchain latest",
-    "test:all": "pnpm test && pnpm test:deps && pnpm test:e2e",
-    "release:check": "pnpm test:all && npm pack --dry-run",
+    "test:acceptance:desktop": "pnpm build && node tests/test-runtime-acceptance.js desktop",
+    "test:acceptance:extension": "pnpm build && node tests/test-runtime-acceptance.js extension",
+    "test:acceptance:mobile": "pnpm build && node tests/test-runtime-acceptance.js mobile",
+    "test:all": "pnpm lint && pnpm check:security && pnpm audit:osv && pnpm test:coverage && pnpm test:deps && pnpm test:templates && pnpm test:vercel-schema && pnpm test:pack && pnpm test:packlist && pnpm test:e2e",
+    "release:check": "pnpm check:release-policy && pnpm test:all && npm pack --dry-run --ignore-scripts",
+    "release:pack": "pnpm build && node scripts/create-release-artifact.mjs && node scripts/check-release-secrets.mjs release-artifact/metadata.json",
+    "release:artifact:verify": "node scripts/verify-release-artifact.mjs release-artifact/metadata.json && node scripts/check-release-secrets.mjs release-artifact/metadata.json",
+    "release:artifact:smoke": "node tests/test-packed-cli.js release-artifact/metadata.json",
     "demo:refresh": "pnpm build && node tests/refresh-demo.js"
   },
   "keywords": [
     "cli",
     "scaffold",
+    "typescript",
+    "nextjs",
     "fastify",
     "expo",
+    "electron",
     "clerk",
     "drizzle",
     "neondb",
@@ -57,11 +100,11 @@
     "wxt",
     "vercel"
   ],
-  "license": "MIT",
-  "packageManager": "pnpm@10.15.1",
+  "license": "UNLICENSED",
+  "packageManager": "pnpm@10.34.5",
   "devDependencies": {
-    "@types/node": "^24.5.2",
-    "tsx": "^4.20.5",
-    "typescript": "^5.9.2"
+    "@types/node": "20.19.43",
+    "c8": "11.0.0",
+    "typescript": "5.9.3"
   }
 }