bymilon · bymilon · Jul 18, 2026 · Jul 18, 2026
diff --git a/.docs/design-partner-operating-ledger.md b/.docs/design-partner-operating-ledger.md
@@ -1,6 +1,6 @@
 # Design-Partner Operating Ledger
 
-Track aggregates only. Keep names, emails, company details, and conversation notes in a private approved system—not Git.
+Track aggregates only. Keep names, emails, company details, and conversation notes in a private approved system, not Git.
 
 ## Qualified Prospect
 
@@ -18,7 +18,7 @@ A qualified prospect is part of a small software team that actively maintains an
 
 | Week | Landing visitors | CTA clicks | Qualified replies | Conversations | Design partners | $29 willingness-to-pay | Dominant objection | Decision       |
 | ---- | ---------------: | ---------: | ----------------: | ------------: | --------------: | ---------------------: | ------------------ | -------------- |
-| —    |                0 |          0 |                 0 |             0 |               0 |                      0 | —                  | Start outreach |
+| TBD  |                0 |          0 |                 0 |             0 |               0 |                      0 | None               | Start outreach |
 
 ## Conversation Prompts
 

diff --git a/.docs/session-handoff-2026-07-18.md b/.docs/session-handoff-2026-07-18.md
@@ -1,10 +1,10 @@
-# Session Handoff — 2026-07-18
+# Session Handoff: 2026-07-18
 
 ## Restart Context
 
 The active repository is `D:\PROJECTS\OMAZYAI\OPENAPISTUDIO\openapi-studio-tanstack`, not the legacy `openapi-studio` workspace. Repository: `github.com/bymilon/openapi-studio-tanstack` (public).
 
-The product is a fresh OpenAPI Studio rebuild for small API teams. Architecture is a feature-based, flattened vertical-slice modular monolith—not a monorepo. The delivery stack is TanStack Start with Solid, Bun, Vite, Tailwind CSS, Hono where an HTTP boundary benefits from it, Valibot, Drizzle, Turso/libSQL, and Cloudflare Workers. Oxlint and Oxfmt are the quality tools.
+The product is a fresh OpenAPI Studio rebuild for small API teams. Architecture is a feature-based, flattened vertical-slice modular monolith, not a monorepo. The delivery stack is TanStack Start with Solid, Bun, Vite, Tailwind CSS, Hono where an HTTP boundary benefits from it, Valibot, Drizzle, Turso/libSQL, and Cloudflare Workers. Oxlint and Oxfmt are the quality tools.
 
 Read `AGENTS.md`, `specs/mission.md`, `specs/tech-stack.md`, and `specs/roadmap.md` before acting. Follow spec-driven development and keep `.tasks/` as the execution source of truth. Avoid speculative abstractions and feature-parity work.
 

diff --git a/.docs/stack-audit-9.8-plan.md b/.docs/stack-audit-9.8-plan.md
@@ -127,4 +127,4 @@ TSK-1 may begin only when all are true:
 - TG-001 has an owner and exact validation commands.
 - No cloud resource, secret, production database, deployment, push, or merge is implicitly authorized.
 
-Meeting this gate raises the design to approximately **9.0/10**. The remaining score must be earned through clean-install, CI, Worker preview, migration, security, rollback, and production evidence—not documentation.
+Meeting this gate raises the design to approximately **9.0/10**. The remaining score must be earned through clean-install, CI, Worker preview, migration, security, rollback, and production evidence, not documentation.
diff --git a/.tasks/2026-07-18-TSK-1-delivery-foundation-TASKS.md b/.tasks/2026-07-18-TSK-1-delivery-foundation-TASKS.md
@@ -1,4 +1,4 @@
-# TSK-1 — Delivery Foundation Tasks
+# TSK-1: Delivery Foundation Tasks
 
 | Field        | Value                                                     |
 | ------------ | --------------------------------------------------------- |
@@ -11,7 +11,7 @@
 
 Only this file owns execution status, assignment, dependencies, and evidence for TSK-1.
 
-## TG-001 — Runtime Skeleton
+## TG-001: Runtime Skeleton
 
 - **Owner:** Main agent
 - **Dependencies:** Complete
@@ -22,7 +22,7 @@ Only this file owns execution status, assignment, dependencies, and evidence for
 - **Validation command:** `bun run check`; then time-bounded `bun run preview`, `GET /health`, dependency inspection, and bundle inspection.
 - **Evidence:** `bun install --frozen-lockfile`, `bun run check`, and `git diff --check` pass on Bun 1.3.14. The production build prerenders `/` and emits the Worker entry. Built preview smoke checks return `GET /health` 200 with `{"status":"ok"}`, `HEAD /health` 200, `POST /health` 405, and `/` 200. Independent review findings were resolved; no deployment occurred.
 
-## TG-002 — Database Baseline
+## TG-002: Database Baseline
 
 - **Owner:** Main agent
 - **Dependencies:** TG-001
@@ -33,7 +33,7 @@ Only this file owns execution status, assignment, dependencies, and evidence for
 - **Validation command:** `bun run db:check`, `bun run db:smoke`, and `bun run check`.
 - **Evidence:** Drizzle ORM 0.45.2, Drizzle Kit 0.31.10, and `@libsql/client` 0.17.4 are pinned. `db:check` validates the generated migration graph. `db:smoke` applies the committed migration twice to in-memory libSQL, then completes a typed insert/query. TanStack's `server-only` guard protects the credential-bearing factory. On 2026-07-18, `db:integration` applied the migration twice and completed the same query against disposable Turso database `oas-tsk1-val-6bfd6949` through `@libsql/client/web`; the one-day token remained in process memory and the database was destroyed immediately afterward.
 
-## TG-003 — Automated Quality Gates
+## TG-003: Automated Quality Gates
 
 - **Owner:** Main agent
 - **Dependencies:** TG-001, TG-002
@@ -44,7 +44,7 @@ Only this file owns execution status, assignment, dependencies, and evidence for
 - **Validation command:** `bun run check`; then observe the required GitHub pull-request run and a temporary deliberately failing validation commit.
 - **Evidence:** Local `bun ci` and `bun run check` pass. The workflow uses SHA-pinned official actions, Bun 1.3.14, Ubuntu 24.04, read-only repository permissions, concurrency cancellation, a ten-minute timeout, no secrets, and no deployment job. PR #1 run `29637211097` passed; deliberate failing commit `51d1be9` was rejected by run `29637241493`; revert commit `072bdb2` restored green run `29637270052`. Independent review found no workflow security blocker.
 
-## TG-004 — Preview and Observability
+## TG-004: Preview and Observability
 
 - **Owner:** Main agent
 - **Dependencies:** TG-001, TG-003
@@ -65,4 +65,4 @@ TSK-1 completed its approved implementation and preview-validation scope on 2026
 - **Risk:** Medium for local scaffold; high for credentials, data, and deployment.
 - **Routing:** Main agent writes; independent agents research, review, and validate. Models remain unpinned and are routed by task risk.
 - **Retry limit:** Stop and re-triage after two materially similar failed approaches.
-- **Metrics:** Record accepted outcome, checks, review findings, retries, interventions, and deployment health—not lines of code or token volume.
+- **Metrics:** Record accepted outcome, checks, review findings, retries, interventions, and deployment health, not lines of code or token volume.
diff --git a/.tasks/2026-07-18-TSK-2-demand-conversion-TASKS.md b/.tasks/2026-07-18-TSK-2-demand-conversion-TASKS.md
@@ -1,4 +1,4 @@
-# TSK-2 — Demand and Conversion Tasks
+# TSK-2: Demand and Conversion Tasks
 
 | Field        | Value                                                     |
 | ------------ | --------------------------------------------------------- |
@@ -11,7 +11,7 @@
 
 Only this file owns execution status, assignment, dependencies, and evidence for TSK-2.
 
-## TG-001 — Positioning and Offer
+## TG-001: Positioning and Offer
 
 - **Owner:** Product owner
 - **Dependencies:** TSK-1, approved TSK-2 specification
@@ -22,7 +22,7 @@ Only this file owns execution status, assignment, dependencies, and evidence for
 - **Validation command:** Product content review against the approved specification.
 - **Evidence:** Product owner approved the positioning, revised $29/workspace/month hypothesis, `pitechae@gmail.com` contact flow, qualification prompts, Tailwind, and first-party Cloudflare event logging on 2026-07-18.
 
-## TG-002 — Marketing Page
+## TG-002: Marketing Page
 
 - **Owner:** Main agent
 - **Dependencies:** TG-001
@@ -33,7 +33,7 @@ Only this file owns execution status, assignment, dependencies, and evidence for
 - **Validation command:** `bun run check` plus responsive, keyboard, and JavaScript-disabled browser review.
 - **Evidence:** The prerendered page implements the approved buyer, problem, pilot offer, $29 hypothesis, RFC-safe qualified mailto flow, and truthful pilot terms. Tailwind 4.3.3 is the only UI system. Desktop and 390px screenshots were reviewed; Chromium passes axe, keyboard order, JavaScript-disabled, CTA, metadata, and horizontal-overflow checks. GitHub confirms the linked repository is public.
 
-## TG-003 — Measurement and Operating Ledger
+## TG-003: Measurement and Operating Ledger
 
 - **Dependencies:** TG-001, approved analytics decision
 - **Owner:** Main agent
@@ -44,7 +44,7 @@ Only this file owns execution status, assignment, dependencies, and evidence for
 - **Validation command:** Event payload inspection and operating-ledger review.
 - **Evidence:** Strict Valibot events allow only page view, design-partner click, and repository click. The endpoint requires same-origin browser metadata, rejects unsupported content types and extra fields, and streams at most 64 bytes. Tests cover valid, schema-invalid, cross-origin, oversized, and unsupported requests. Analytics failure cannot block CTA behavior. `.docs/design-partner-operating-ledger.md` stores aggregates only.
 
-## TG-004 — Preview Acceptance
+## TG-004: Preview Acceptance
 
 - **Owner:** Main agent
 - **Dependencies:** TG-002, TG-003

diff --git a/.tasks/2026-07-18-TSK-3-landing-redesign-TASKS.md b/.tasks/2026-07-18-TSK-3-landing-redesign-TASKS.md
@@ -1,23 +1,23 @@
-# TSK-3 — Landing Redesign
+# TSK-3: Landing Redesign
 
 **Overall status:** DONE
 
-## TG-001 — Product and Design Context
+## TG-001: Product and Design Context
 
 - **Owner:** Main agent
 - **Status:** DONE
 - **Acceptance:** `PRODUCT.md`, `DESIGN.md`, official benchmark, and critique define a truthful non-generic direction.
 - **Evidence:** Official Apple, Google, GitHub, Stripe, Cloudflare, and Linear surfaces were reviewed for hierarchy, proof, CTA, trust, and responsive patterns without copying trade dress. Impeccable v3.9.1 context, brand register, palette, and independent critique informed `PRODUCT.md` and `DESIGN.md`. Live mode is configured for the TanStack root document; no CSP was detected.
 
-## TG-002 — Product-Led Landing Surface
+## TG-002: Product-Led Landing Surface
 
 - **Owner:** Main agent
 - **Dependencies:** TG-001
 - **Status:** DONE
 - **Acceptance:** Responsive page implements REQ-001 through REQ-007 without new UI dependencies.
 - **Evidence:** The product owner rejected the true-white/cobalt pass as generic. The replacement uses a distinctive redline identity, a custom contract-path mark, locally hosted Martian Grotesk, an immediate breaking-change painkiller, and a clearly labelled review prototype. Desktop and 390px mobile full-page screenshots have been inspected. No UI dependency was added.
 
-## TG-003 — Release Validation
+## TG-003: Release Validation
 
 - **Owner:** Main agent
 - **Dependencies:** TG-002

diff --git a/.tasks/2026-07-18-TSK-4-public-repository-trust-TASKS.md b/.tasks/2026-07-18-TSK-4-public-repository-trust-TASKS.md
@@ -1,22 +1,22 @@
-# TSK-4 — Public Repository Trust
+# TSK-4: Public Repository Trust
 
 **Overall status:** DONE
 
-## TG-001 — Public narrative and boundaries
+## TG-001: Public narrative and boundaries
 
 - **Owner:** Main agent
 - **Status:** DONE
 - **Acceptance:** README and root guidance explain the problem, evidence, limitations, contribution, security, and source terms.
 - **Evidence:** Product-first README, real website screenshot, explicit available/unavailable table, `CONTRIBUTING.md`, `SECURITY.md`, and source-available `LICENSE` are present.
 
-## TG-002 — GitHub presentation
+## TG-002: GitHub presentation
 
 - **Owner:** Main agent
 - **Status:** DONE
 - **Acceptance:** Description, homepage, topics, and landing-page repository language are accurate.
 - **Evidence:** GitHub description, preview homepage, ten relevant topics, private vulnerability reporting, and protected `main` are configured. Landing copy now says design-partner research, price hypothesis, proposed workflow, and public build.
 
-## TG-003 — Validation
+## TG-003: Validation
 
 - **Owner:** Main agent
 - **Status:** DONE

diff --git a/.tasks/2026-07-18-TSK-5-social-brand-asset-TASKS.md b/.tasks/2026-07-18-TSK-5-social-brand-asset-TASKS.md
@@ -1,22 +1,22 @@
-# TSK-5 — Social Brand Asset
+# TSK-5: Social Brand Asset
 
 **Overall status:** DONE
 
-## TG-001 — Brand composition
+## TG-001: Brand composition
 
 - **Owner:** Main agent
 - **Status:** DONE
 - **Acceptance:** Dedicated 1200×630 master and PNG communicate the brand and truthful product status.
 - **Evidence:** Deterministic SVG master uses the real mark, Martian Grotesk, redline system, concise positioning, explicit demand-validation status, and illustrative contract concept. Final RGB PNG is exactly 1200×630 and visually inspected.
 
-## TG-002 — Distribution metadata
+## TG-002: Distribution metadata
 
 - **Owner:** Main agent
 - **Status:** DONE
 - **Acceptance:** README, Open Graph, Twitter, canonical, and tests reference the asset correctly.
 - **Evidence:** README hero references the PNG; route metadata includes absolute Open Graph image, type, dimensions, alt text, canonical URL, and Twitter large-card metadata.
 
-## TG-003 — Validation
+## TG-003: Validation
 
 - **Owner:** Main agent
 - **Status:** DONE

diff --git a/AGENTS.md b/AGENTS.md
@@ -25,7 +25,11 @@ Stop and request a product decision when requirements conflict, scope expands, s
 - Use Valibot at external trust boundaries and `drizzle-orm/valibot` only for persistence validation; public contracts must not be generated from database schemas.
 - Keep server-only code, bindings, credentials, and database access outside client bundles.
 - Prefer platform features and existing dependencies. Add abstractions only for a current approved requirement.
-- Test public behavior, authorization, failure paths, and data boundaries—not implementation details.
+- Test public behavior, authorization, failure paths, and data boundaries, not implementation details.
+
+### Content punctuation
+
+- Never use em dashes (`—`) in user-facing content or metadata. Use periods, commas, colons, or parentheses instead.
 - Never commit secrets or local environment files.
 
 ## Architecture and Ownership

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -6,7 +6,7 @@ OpenAPI Studio is an evidence-gated founding build. Discuss substantial product
 
 1. Read `AGENTS.md`, `PRODUCT.md`, `DESIGN.md`, and `specs/roadmap.md`.
 2. Keep changes inside one small vertical slice.
-3. Preserve truthful product boundaries—do not imply unfinished capabilities exist.
+3. Preserve truthful product boundaries. Do not imply unfinished capabilities exist.
 4. Do not include real API contracts, customer information, credentials, or generated secrets.
 5. Run `bun run check`.
 

diff --git a/DESIGN.md b/DESIGN.md
@@ -49,7 +49,7 @@ Stay structurally flat: square controls, hard rules, no ornamental radius, gradi
 - The desktop hero uses a literal `7:5` copy-to-artifact grid and collapses to one column at `64rem`.
 - The 1440×900 and 2048×1000 folds must include the primary CTA, price condition, and complete review artifact without scrolling.
 - Header plus hero may not exceed the initial viewport height at supported desktop sizes.
-- Consequential copy—prototype status, pricing terms, privacy guidance, and artifact captions—never renders below `0.75rem`.
+- Consequential copy, including prototype status, pricing terms, privacy guidance, and artifact captions, never renders below `0.75rem`.
 - Full-page screenshots validate rhythm; viewport-only screenshots validate conversion. Both are required.
 
 ## Components

diff --git a/PRODUCT.md b/PRODUCT.md
@@ -41,7 +41,7 @@ Do not resemble generic AI-generated SaaS, anonymous white/cobalt enterprise min
 1. Evidence before persuasion: every claim sits beside a truthful artifact, boundary, or verifiable delivery fact.
 2. One decision per fold: establish fit, show the workflow, resolve trust, then present the offer.
 3. Enterprise restraint, startup honesty: use disciplined hierarchy and finish without pretending to have customers, scale, or capabilities that do not exist.
-4. The contract is the visual subject: OpenAPI structure, changes, validation, and publishing provide the imagery—not generic decoration.
+4. The contract is the visual subject: OpenAPI structure, changes, validation, and publishing provide the imagery, not generic decoration.
 5. Conversion without pressure: make the five-team pilot, response expectation, and $29 post-pilot price explicit.
 
 ## Accessibility & Inclusion

diff --git a/README.md b/README.md
@@ -6,9 +6,9 @@ Review consequential OpenAPI contract changes before they reach users.
 
 [![Quality](https://github.com/bymilon/openapi-studio-tanstack/actions/workflows/quality.yml/badge.svg)](https://github.com/bymilon/openapi-studio-tanstack/actions/workflows/quality.yml)
 
-![OpenAPI Studio — Contract changes, made reviewable](public/og/openapi-studio-og.png)
+![OpenAPI Studio: Contract changes, made reviewable](public/og/openapi-studio-og.png)
 
-_Brand preview with an illustrative product concept—not product UI._
+_Brand preview with an illustrative product concept, not product UI._
 
 [View the live preview](https://openapi-studio-tanstack-preview.pibin.workers.dev) · [Join design-partner research](mailto:pitechae@gmail.com?subject=OpenAPI%20Studio%20design-partner%20research) · [Read the product roadmap](specs/roadmap.md)
 

diff --git a/specs/features/2026-07-18-delivery-foundation/spec.md b/specs/features/2026-07-18-delivery-foundation/spec.md
@@ -1,12 +1,12 @@
 # Delivery Foundation
 
-| Field           | Value                         |
-| --------------- | ----------------------------- |
-| Feature ID      | TSK-1                         |
-| Roadmap outcome | Phase 0 — Delivery Foundation |
-| Status          | SPEC_APPROVED                 |
-| Owner           | Product owner                 |
-| Updated         | 2026-07-18                    |
+| Field           | Value                        |
+| --------------- | ---------------------------- |
+| Feature ID      | TSK-1                        |
+| Roadmap outcome | Phase 0: Delivery Foundation |
+| Status          | SPEC_APPROVED                |
+| Owner           | Product owner                |
+| Updated         | 2026-07-18                   |
 
 ## Problem and Outcome
 

diff --git a/specs/features/2026-07-18-demand-conversion/spec.md b/specs/features/2026-07-18-demand-conversion/spec.md
@@ -1,12 +1,12 @@
 # Demand and Conversion
 
-| Field           | Value                           |
-| --------------- | ------------------------------- |
-| Feature ID      | TSK-2                           |
-| Roadmap outcome | Phase 1 — Demand and Conversion |
-| Status          | SPEC_APPROVED                   |
-| Owner           | Product owner                   |
-| Updated         | 2026-07-18                      |
+| Field           | Value                          |
+| --------------- | ------------------------------ |
+| Feature ID      | TSK-2                          |
+| Roadmap outcome | Phase 1: Demand and Conversion |
+| Status          | SPEC_APPROVED                  |
+| Owner           | Product owner                  |
+| Updated         | 2026-07-18                     |
 
 ## Problem and Outcome
 

diff --git a/specs/features/2026-07-18-landing-redesign/spec.md b/specs/features/2026-07-18-landing-redesign/spec.md
@@ -1,12 +1,12 @@
 # Landing Redesign
 
-| Field           | Value                           |
-| --------------- | ------------------------------- |
-| Feature ID      | TSK-3                           |
-| Roadmap outcome | Phase 1 — Demand and Conversion |
-| Status          | SPEC_APPROVED                   |
-| Owner           | Product owner                   |
-| Updated         | 2026-07-18                      |
+| Field           | Value                          |
+| --------------- | ------------------------------ |
+| Feature ID      | TSK-3                          |
+| Roadmap outcome | Phase 1: Demand and Conversion |
+| Status          | SPEC_APPROVED                  |
+| Owner           | Product owner                  |
+| Updated         | 2026-07-18                     |
 
 ## Problem and Outcome
 

diff --git a/specs/mission.md b/specs/mission.md
@@ -6,7 +6,7 @@ OpenAPI Studio helps small API teams turn an OpenAPI document into a dependable
 
 ## Commercial Goal
 
-Reach the first **$1,000 MRR** through a narrow, reliable paid product before pursuing broad legacy parity. Optimize for activation, repeated use, conversion, and retention—not feature count.
+Reach the first **$1,000 MRR** through a narrow, reliable paid product before pursuing broad legacy parity. Optimize for activation, repeated use, conversion, and retention, not feature count.
 
 ## Primary Customer