81 lines
4.2 KiB
Markdown
81 lines
4.2 KiB
Markdown
# Session 0021.0 — Transcript
|
|
|
|
> App: ecomm
|
|
> Start: 2026-06-10T08-20 (PST)
|
|
> Type: planning-and-executing
|
|
> Claude-Session: 7f254528-630c-4d45-a898-0382927ce8a4
|
|
> Status: **PLACEHOLDER — claimed at session start; finalized at session end.**
|
|
>
|
|
> This file reserves session ID 0021 for ecomm. The driver replaces this
|
|
> body with the full transcript and renames the file to its final
|
|
> SESSION-0021.0-TRANSCRIPT-2026-06-10T08-20--<end>.md form at session end.
|
|
|
|
## Launch prompt
|
|
|
|
```
|
|
Implement SLICE-1 (walking skeleton) of SD-0001 v0.3.0 — repo scaffold (4-layer
|
|
backend + import-linter, Vite/React shell, scripts/check.sh, CI), dev Postgres
|
|
compose (single pinned service), platform/db (psycopg) migration runner +
|
|
migration 0001, /healthz, scripts/dev.sh (owns container lifecycle),
|
|
docs/BOOTSTRAP.md (localhost, Docker prereq) — per
|
|
wiggleverse-ecomm-content/specs/SD-0001-mvp-sign-up-and-single-storefront.md §7.2.
|
|
DoD: clean checkout → dev.sh → app up on an empty self-migrated Postgres, check
|
|
gate green in CI.
|
|
|
|
```
|
|
|
|
## Plan
|
|
|
|
> Anchor: design `wiggleverse-ecomm-content/specs/SD-0001-mvp-sign-up-and-single-storefront.md` (v0.3.0, graduated) — plan-eligibility ELIGIBLE (R2a).
|
|
|
|
**Goal:** Implement SLICE-1 (walking skeleton) of SD-0001 §7.2 — the localhost
|
|
half of BUC-5 (PUC-10).
|
|
|
|
**Ships:** repo scaffold (4-layer Python backend `main > domains > platform` +
|
|
import-linter contract; Vite/React shell; `scripts/check.sh`; Gitea CI); dev
|
|
Postgres compose (single pinned service, named volume, healthcheck); `platform/db`
|
|
(psycopg + small pool) with the forward-only migration runner (INV-7, advisory-lock
|
|
+ fail-stop) and migration `0001` (the §6.3 schema: account, auth_code, storefront,
|
|
storefront_membership); `/healthz` (process up + DB reachable + migrations current);
|
|
`scripts/dev.sh` (owns the container lifecycle); `docs/BOOTSTRAP.md` (localhost
|
|
section, Docker prerequisite).
|
|
|
|
**DoD:** clean checkout → `scripts/dev.sh` → app up on an empty, self-migrated
|
|
Postgres; `/healthz` green; `scripts/check.sh` gate green in CI; bootstrap test
|
|
skeleton runs migrate-from-empty + idempotent re-migrate (INV-1 partial).
|
|
|
|
Work on branch `claude/agitated-heyrovsky-1a1f47` (this worktree) → PR → merge to
|
|
`main`. Plan archived to the content repo `plans/` at finalize.
|
|
|
|
**Status: COMPLETE.** All 11 plan tasks done; 13 commits on the branch. DoD verified:
|
|
clean-checkout simulation (`.venv` + `node_modules` moved aside, `compose down -v`) →
|
|
`scripts/dev.sh` → `/healthz` 200 `{"status":"ok"}` on an empty self-migrated Postgres
|
|
(0 accounts, migration 0001 applied); `scripts/check.sh` green (lint-imports kept, 7
|
|
pytest passed, frontend tsc+build); CI workflow written (inert until a Gitea runner).
|
|
|
|
**Plan deviations (all green, recorded for the archived plan):**
|
|
1. **`app/main.py` stub added in Task 1** (not Task 5): import-linter's `layers`
|
|
contract requires every named layer module to exist, so the top layer needed a stub
|
|
from the start; Task 5 fleshed it into the real factory.
|
|
2. **Frontend tsconfig simplified**: the planned `tsconfig.node.json` project-reference
|
|
tripped `tsc` error TS6310 (composite project may not disable emit). Dropped the
|
|
split for a single `tsconfig.json` that typechecks `src`; Vite loads its own config
|
|
via esbuild (no tsc needed). One file, same gate.
|
|
3. **`scripts/dev.sh` portability fixes** (post-first-run): macOS ships bash 3.2 which
|
|
lacks `wait -n` → replaced with a `kill -0` poll loop; and `npm` spawns `vite` as a
|
|
grandchild, so cleanup now recurses `pgrep -P` to reap the whole subtree (Ctrl-C now
|
|
frees both :8000 and :5173). Both verified.
|
|
|
|
## Deferred decisions
|
|
|
|
_Autonomous-mode low-confidence calls the driver made and would have
|
|
liked operator input on. Appended as the session runs; surfaced at
|
|
finalize. Empty if none._
|
|
|
|
- **Postgres major version pin = 16.** Spec §6.7/D-7 says the dev container is
|
|
"pinned to the Cloud SQL major version" but the eventual Cloud SQL instance major
|
|
isn't fixed yet (SLICE-4 provisioning, Q-1-adjacent). Chose `postgres:16` —
|
|
mature, widely available, a safe Cloud SQL default. If the operator wants 17 (or to
|
|
match a specific Cloud SQL choice) it's a one-line change in `compose.yaml` +
|
|
`.gitea/workflows/ci.yml`. Low blast radius pre-data.
|