feat(site): tools.culture.dev Astro site — cream/katvan-green catalog (M2) (#3)

* feat(site): tools.culture.dev Astro site — Anthropic-cream catalog (M2)

Land the public index front-end under site-astro/. Astro 6, output:
'static' with no adapter, so `astro build` emits a pure-static dist/ that
Cloudflare Pages serves directly (M3).

The site renders from one generated file, src/data/catalog.json, produced
by the M1 generator (`culture-tools index build`). Pages:

- Landing: hero + `uv tool install` one-liner + a grid of certified tools
  (version / backend / verb-count chips, copy-install, conformance badge),
  plus a "Candidates not yet conformant" roadmap section listing excluded
  tools with the rubric bundles each still fails — honest about what the
  gate dropped.
- Per-tool detail (/tools/<name>/): install block, repo/PyPI links, backend
  and model facts, and the tool's command surface table.
- 404, sitemap, robots, favicon.

Theme: Anthropic-cream, light by default (warm #FFFAF5, clay accent
#D97706) with a dark mirror and a no-flash toggle — palette aligned with
the sibling agentic-human / humanic-ai sites. Catalog-first card grid.
(Diverges from katvan's dark-terminal start, per the style call; katvan
supplied the static-Astro structure, not the skin.)

scripts/sync-catalog.sh (`npm run catalog`) runs `index build` and
distributes its two artifacts: catalog.json -> src/data/ (imported, typed
via catalog.ts) and the PEP 503 simple/ tree -> public/simple/ (served
verbatim). Both are committed so the site builds without the Python
toolchain; CI (M3) regenerates them against live conformance.

Verified: `npm run check` (astro type-check) 0 errors, `npm run build`
green (5 pages + sitemap, /simple/ ships), light + dark render correctly.
Repo gates unaffected: 44 pytest, markdownlint, rubric doctor all green.

Docs: design doc M2 marked done + style decision recorded; CLAUDE.md site
section fleshed out from placeholder; markdownlint ignores hardened for
the nested site-astro/node_modules + dist. Version 0.4.0 -> 0.5.0.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LdsNvR24i1fGosuQ9AgtVG

* feat(site): dark mode wears katvan's terminal green

In dark mode the accent swaps from the light-mode clay (#D97706) to
katvan's terminal green (--accent #41d67a, hover #7cff9e) so the site joins
the AgentCulture cream family in light and katvan's terminal aesthetic in
dark. Only the --accent trio differs between modes; cream/clay light is
untouched. Added an --on-accent token so ::selection (and any accent-fill)
keeps readable contrast — dark text on the bright green, white on clay.

Synced the CHANGELOG (0.5.0), design doc, and CLAUDE.md theme notes.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LdsNvR24i1fGosuQ9AgtVG

* fix(site): address Qodo review on PR #3 (3 findings + a drift guard)

All three findings valid; a colleague review (Qwen) concurred and helped
shape the durable fix for #1. Fixes:

1. Stale catalog.json versions (correctness) — the committed catalog said
   culture-tools 0.4.0 while pyproject is 0.5.0. Root cause is structural: a
   committed *generated* artifact drifts on every version bump. Regenerated
   (`npm run catalog` → 0.5.0) AND added tests/test_site_catalog.py, a guard
   that fails when the committed catalog's generated_with / culture-tools entry
   lags pyproject. It reads committed files only (no uv/agentfront needed in
   CI). CLAUDE.md's version-bump convention now says to regenerate after a bump.

2. Catalog type-safety bypass (maintainability) — catalog.ts replaced
   `catalogJson as unknown as Catalog` (which silenced all structural checking)
   with a typed import `const catalog: Catalog = catalogJson`. astro check / tsc
   now validates the catalog shape at build; no runtime validator shipped, so
   the zero-runtime-dep ethos holds.

3. Clipboard copy lacks fallback (reliability) — the copy handlers now
   feature-detect navigator.clipboard, handle rejection, and fall back to a
   hidden-textarea execCommand('copy') for insecure contexts (e.g. the
   http://localhost preview) so they never throw an unhandled rejection.

Verified: astro check 0 errors, build green; 45 pytest (incl. the new guard);
black/isort/flake8/markdownlint clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01LdsNvR24i1fGosuQ9AgtVG

---------

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: OriNachum

.markdownlint-cli2.yaml

@@ -15,7 +15,10 @@ config:
     siblings_only: true
 
 ignores:
-  - "node_modules/**"
+  # Matches both the repo-root node_modules and site-astro/node_modules.
+  - "**/node_modules/**"
+  # Astro build output (site-astro/dist) — generated, not authored.
+  - "**/dist/**"
   - ".local/**"
   - ".afi/**"
   - ".teken/**"

CHANGELOG.md

@@ -5,6 +5,31 @@ All notable changes to this project will be documented in this file.
 Format follows [Keep a Changelog](https://keepachangelog.com/). This project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.5.0] - 2026-06-22
+
+### Added
+
+- `site-astro/` — the **tools.culture.dev** front-end (M2). An Astro 6 static
+  site (`output: 'static'`, no adapter → pure-static `dist/` for Cloudflare
+  Pages) that renders from `culture-tools index build`'s `catalog.json`. Pages:
+  a catalog landing (hero + `uv tool install` one-liner + a grid of certified
+  tools + a roadmap section listing pending candidates with the rubric bundles
+  each still fails) and per-tool detail pages (install, repo/PyPI links, command
+  surface). Conformance badges throughout; light/dark theme toggle.
+- Theme is **Anthropic-cream** in light (default — warm `#FFFAF5`, clay accent
+  `#D97706`), aligned with the sibling `agentic-human` / `humanic-ai` sites;
+  **dark mode wears `../katvan`'s terminal green** (`#41d67a`, hover `#7cff9e`)
+  so the two AgentCulture aesthetics meet in one site. Catalog-first card-grid
+  layout; no-flash light/dark toggle.
+- `site-astro/scripts/sync-catalog.sh` (`npm run catalog`) runs
+  `culture-tools index build` and distributes its two artifacts into the Astro
+  tree: `catalog.json` → `src/data/` (imported, typed via `catalog.ts`) and the
+  static PEP 503 `simple/` tree → `public/simple/` (served verbatim).
+  `catalog.json` + `public/simple/` are committed so the site builds without the
+  Python toolchain.
+- Design doc + `CLAUDE.md` site section updated to reflect the landed M2 site
+  (was a placeholder pointer).
+
 ## [0.4.0] - 2026-06-22
 
 ### Added

CLAUDE.md

@@ -133,6 +133,11 @@ redundant otherwise — don't "simplify" them away:
   `pyproject.toml` version equals `main`'s — even docs/CI-only changes. Use the
   `version-bump` skill (or `/version-bump patch|minor|major`); it updates
   `pyproject.toml` and prepends a Keep-a-Changelog entry to `CHANGELOG.md`.
+  **After bumping, regenerate the committed site catalog** — `cd site-astro &&
+  npm run catalog` — so `catalog.json`'s `generated_with` and the `culture-tools`
+  entry track the new version. `tests/test_site_catalog.py` fails the build if the
+  committed catalog drifts from `pyproject` (it reads committed files only, so it
+  needs neither `uv` nor `agentfront`).
 - **SonarCloud coverage needs repo-relative paths.** `[tool.coverage.run]
   relative_files = true` is set so `coverage.xml` filenames map onto
   `sonar.sources=culture_tools`; without it Sonar silently reports 0% coverage.
@@ -171,8 +176,35 @@ re-vendor only the skills you need (`docs/skill-sources.md`).
 
 ## Site build (tools.culture.dev)
 
-The public index site is being built **`../katvan`-style with `../auntiepypi`
-infra, with `../cultureflare` (Cloudflare) help**. Those sibling repos in the
-workspace are the templates/infra references; consult them before adding site
-scaffolding here. (This section is a placeholder pointer — flesh it out as the
-site lands.)
+The public index site lives under **`site-astro/`** — an Astro 6 static site
+(`output: 'static'`, no adapter, so `astro build` emits a pure-static `dist/`
+for Cloudflare Pages). Architecture of record: `docs/design/tools-culture-dev.md`.
+
+**The site renders from one generated file**, `site-astro/src/data/catalog.json`,
+produced by the M1 generator in this package (`culture-tools index build`). The
+data flow is one-way:
+
+```text
+culture-tools index build  →  catalog.json  →  src/data/      (imported, typed via catalog.ts)
+                           →  simple/        →  public/simple/  (static PEP 503, served verbatim)
+```
+
+`site-astro/scripts/sync-catalog.sh` (`npm run catalog`) runs the generator and
+distributes both artifacts. `catalog.json` + `public/simple/` are **committed**
+so the site builds without the Python toolchain; regenerate them against live
+conformance with `npm run catalog` before a deploy. Don't hand-edit
+`catalog.json` — every entry passed `agentfront cli doctor <repo> --strict`.
+
+Site commands (run inside `site-astro/`): `npm install`, `npm run dev`
+(localhost:4321), `npm run build`, `npm run check` (astro type-check),
+`npm run catalog` (refresh the data).
+
+**Theme:** Anthropic-cream, light by default (warm `#FFFAF5`, clay accent
+`#D97706`, palette aligned with the sibling `../agentic-human` / `../humanic-ai`
+sites); **dark mode wears `../katvan`'s terminal green** (`#41d67a`). The accent
+is the only token that differs between modes — both swap a single `--accent`
+trio. The katvan / auntiepypi / cultureflare
+siblings supplied the static-Astro structure, the PEP 503 emitter, and the
+Cloudflare deploy path respectively; consult them before extending site infra.
+M3 (Cloudflare deploy lane) and M4 (llms.txt, markdown twins, S3 durable tier)
+are still ahead — see the design doc's milestones.

docs/design/tools-culture-dev.md

@@ -27,7 +27,7 @@ and not a mirror of PyPI.
 | Repo location | **In this `culture-tools` repo** — Astro site under `site-astro/`, catalog generator in the `culture_tools` package. | One repo; `culture-tools` *is* the index's backend (per its own description). |
 | Catalog source | **AgentFront metadata** — generated by running each tool's `learn` / `overview` / `doctor` `--json` verbs, plus `culture.yaml` + `pyproject.toml`. | Self-describing and self-validating; the index dogfoods the very contract it certifies. New conformant tools surface from their own output. |
 | Conformance gate | **Delegate to `agentfront cli doctor <repo> --strict --json`** (`healthy == true`). | `agentfront` (formerly `teken`/`afi-cli`) is the canonical rubric authority; we don't reinvent the verdict. |
-| Front-end style | **`../katvan` dark-terminal Astro** as the starting point — free to diverge. | Proven CF-Pages-static stack and house aesthetic; not a constraint. |
+| Front-end style | **Astro static, Anthropic-cream (light) + katvan-green (dark)** — catalog-first card grid. Took `../katvan`'s Astro/CF-Pages *structure*; light mode wears the warm-cream palette of the sibling `agentic-human` / `humanic-ai` sites, dark mode wears katvan's terminal green (`#41d67a`). | Registry scannability + AgentCulture house look; the two family aesthetics meet in one site. |
 | Hosting (v1) | **Cloudflare only** (CF Pages, static), domain bound via `../cultureflare`. | Simplest near-zero-cost static host; DNS for `culture.dev` already lives at Cloudflare. |
 | Hosting (later) | AWS **S3 as the durable DATA / backup / deep-cache tier** behind the CF edge; recent/hot load served from Cloudflare. | Deferred; the artifacts are plain files, so adding an S3 origin/backup later is additive, not a rewrite. |
 
@@ -98,8 +98,14 @@ Each milestone is one PR (this repo bumps the version every PR; the
   (delegates to `agentfront cli doctor`), tool introspection → catalog entries,
   the static PEP 503 `/simple/` emitter, a starter manifest, `catalog.json`
   output, tests, explain entry. *Hosting-independent; the durable core.*
-- **M2 — Astro site.** `site-astro/` (dark-terminal start) consuming
-  `catalog.json`: landing, per-tool pages, ecosystem grid, conformance badges.
+- **M2 — Astro site. ✅ Done.** `site-astro/` (Astro 6, `output: 'static'`, no
+  adapter) consuming `catalog.json`: a cream catalog landing (hero + install
+  one-liner + certified-tool grid + a roadmap section listing pending candidates
+  with the bundles they still fail), per-tool detail pages (install, repo/PyPI
+  links, command surface), conformance badges, and a light/dark toggle.
+  `scripts/sync-catalog.sh` runs `culture-tools index build` and distributes its
+  output → `src/data/catalog.json` (imported, typed) + `public/simple/` (served
+  verbatim). Theme is Anthropic-cream, light by default.
 - **M3 — Cloudflare deploy lane.** CF Pages build of `site-astro/` (with the
   `index build` step wired in), `_worker.js`/`_redirects` as needed, domain bind
   via `cultureflare`. CI to regenerate the catalog.

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "culture-tools"
-version = "0.4.0"
+version = "0.5.0"
 description = "tools.culture.dev — the package index for agent-first CLI tools that conform to the agentfront contract."
 readme = "README.md"
 license = "Apache-2.0"

site-astro/.gitignore

@@ -0,0 +1,7 @@
+# Astro build output + tooling
+dist/
+.astro/
+node_modules/
+
+# npm
+npm-debug.log*

site-astro/README.md

@@ -0,0 +1,46 @@
+# site-astro — tools.culture.dev
+
+The public index site for **tools.culture.dev**: a catalog of agent-first CLI
+tools, each certified against the AgentFront contract. Astro, fully static
+(`output: 'static'`, no adapter), so `astro build` emits a `dist/` that
+Cloudflare Pages serves directly (M3).
+
+## Data flow
+
+The site renders from a single generated file, `src/data/catalog.json`, produced
+by the M1 generator in the parent package:
+
+```text
+culture-tools index build  ──►  catalog.json   ──►  src/data/   (imported, typed)
+                           └─►  simple/         ──►  public/simple/   (static PEP 503)
+```
+
+`scripts/sync-catalog.sh` runs the generator and distributes both artifacts.
+Every tool in `catalog.json` passed `agentfront cli doctor <repo> --strict`;
+the `excluded` roster records the candidates that did not.
+
+## Develop
+
+```bash
+npm install
+npm run catalog     # regenerate src/data/catalog.json + public/simple/ (needs uv + agentfront)
+npm run dev         # http://localhost:4321
+npm run build       # -> dist/
+npm run preview
+```
+
+`catalog.json` is committed so the site builds without the Python toolchain;
+`npm run catalog` refreshes it against live conformance.
+
+## Layout
+
+- `src/data/catalog.ts` — typed view over `catalog.json`.
+- `src/layouts/Base.astro` — HTML shell, fonts, theme toggle (light cream default).
+- `src/components/` — `ToolCard`, `ConformanceBadge`, header, footer.
+- `src/pages/index.astro` — hero + certified-tool grid + roadmap of pending candidates.
+- `src/pages/tools/[name].astro` — per-tool detail (install, links, command surface).
+
+## Theme
+
+Anthropic-cream, light by default (warm `#FFFAF5`, clay accent `#D97706`), with a
+dark mirror. Palette matches the sibling `agentic-human` / `humanic-ai` sites.

site-astro/astro.config.mjs

@@ -0,0 +1,15 @@
+// @ts-check
+import { defineConfig } from 'astro/config';
+import sitemap from '@astrojs/sitemap';
+
+// tools.culture.dev — the package index for agent-first CLI tools.
+//
+// output: 'static' with NO adapter => `astro build` emits a fully static dist/
+// (HTML + assets, zero server runtime). That is exactly what Cloudflare Pages
+// serves (M3). The static PEP 503 `/simple/` tree lives under public/ and ships
+// verbatim alongside the rendered catalog.
+export default defineConfig({
+  site: 'https://tools.culture.dev',
+  output: 'static',
+  integrations: [sitemap()],
+});