retire legacy web template and split redesign work into tracked issues

Author: snissn

AGENTS.md

@@ -13,11 +13,11 @@ Spec-aligned (new) pipeline:
 - Build output: `th build <schema> --out <dir>` writes `contracts/App.sol`, `compiled/App.json`, `schema.json`, `manifest.json`.
 - Deploy: `th deploy <buildDir> --chain anvil|sepolia` (anvil deploy works; sepolia verify still TBD).
 
-Legacy (kept temporarily; deprecated):
+Legacy (deprecated path; no longer source-of-truth in this repo):
 - Input: legacy `contracts.json` shape (`contracts{}` with `fields`, `initRules`, `readRules`, `writeRules`).
 - Generator: `solidityGenerator.js` generates an `App` contract + per-record child contracts (one contract deployed per record).
-- UI: Handlebars templates in `tokenhost-web-template/` and generator script `handlebar.cjs` that writes a Next.js app into `site/`.
-- Build/deploy: `build.sh` compiles via `solcjs`, generates UI, then deploys via `tokenhost-web-template/contracts/deploy.js` (Foundry `forge create`).
+- UI legacy source now lives in separate repo: `tokenhost/app-tokenhost-com-frontend`.
+- Build/deploy references to `tokenhost-web-template/` in this repo are retired.
 
 Tests:
 - `pnpm test` and `pnpm test:integration` pass.

README.md

@@ -5,6 +5,12 @@ Token Host Builder is a schema-to-dapp generator framework for EVM CRUD apps.
 Canonical product behavior is defined in `SPEC.md`.  
 Execution backlog and current gap-tracking is in `AGENTS.md`.
 
+## Legacy template status
+
+- `tokenhost-web-template/` is retired from this repo.
+- Legacy frontend continuity lives in `tokenhost/app-tokenhost-com-frontend`.
+- Preserved migration/behavior notes: `docs/legacy-tokenhost-web-template-notes.md`.
+
 ## Current generated-app testing model
 
 - `th generate <schema> --with-tests` emits generated app tests and a generated app CI workflow.

docs/legacy-tokenhost-web-template-notes.md

@@ -0,0 +1,35 @@
+# Legacy `tokenhost-web-template` Notes (Archived)
+
+This document preserves practical insights from the deprecated in-repo `tokenhost-web-template/` before removal.
+
+Status:
+- Source of truth now lives outside this repo: `tokenhost/app-tokenhost-com-frontend`.
+- In this repo, the legacy template is removed to reduce dependency/security noise and avoid dual UI pipelines.
+
+## What was worth preserving
+
+1. Chain mismatch handling and wallet chain add/switch UX
+- Legacy helper implemented explicit `wallet_switchEthereumChain` and fallback `wallet_addEthereumChain`.
+- This behavior remains important for local Anvil onboarding and should be retained in generated UI runtimes.
+
+2. Read/write provider separation
+- Legacy runtime kept a read-capable contract binding and swapped in a signer-backed contract after wallet connect.
+- This pattern avoids write failures during unauthenticated reads and should remain part of runtime architecture.
+
+3. Auth endpoint base URL normalization
+- Legacy utility normalized external auth host using `NEXT_PUBLIC_GOOGLE_AUTH_DOMAIN` with trailing-slash cleanup.
+- Keep this pattern (or equivalent) whenever cross-origin auth endpoints are used by generated UIs.
+
+4. Practical UX components to keep in mind
+- Pagination (`Pager.hbs`) and upload progress UI (`ImageUpload.js`) are useful behavior references.
+- The specific implementation/dependencies are outdated, but the interaction patterns are still relevant.
+
+## What was intentionally not preserved
+
+- Dependency stack and lockfile (`next@13`, `web3`, mixed lint/prettier setup) due to drift and security churn.
+- Handlebars-era file/layout conventions that conflict with the current THS + generated Next export flow.
+
+## Follow-up expectations
+
+- Any necessary visual/UX patterns should be reintroduced in the spec-aligned UI generator under `packages/templates/next-export-ui`.
+- Keep design evolution tied to generated-app test coverage and CI, not legacy template branches.