@tryvitris/website-harness 0.0.0-stage → 0.1.0-beta.5

package/src/stock/coverage.json

@@ -0,0 +1,18 @@
+{
+  "version": 1,
+  "targets": ["trades", "professional-services"],
+  "imageQueries": [
+    {"query":"roofer roof installation", "industry":"trades"},
+    {"query":"electrician electrical work", "industry":"trades"},
+    {"query":"plumber pipe repair", "industry":"trades"},
+    {"query":"carpenter woodworking hands", "industry":"trades"},
+    {"query":"accounting paperwork desk", "industry":"professional-services"},
+    {"query":"consulting office meeting", "industry":"professional-services"},
+    {"query":"architecture blueprints desk", "industry":"professional-services"},
+    {"query":"minimal office interior natural light", "industry":"professional-services"}
+  ],
+  "videoQueries": [
+    {"query":"woodworking hands", "industry":"trades"},
+    {"query":"office desk working", "industry":"professional-services"}
+  ]
+}

package/src/stock/picker.css

@@ -0,0 +1,118 @@
+.stock-dialog {
+  width: min(56rem, calc(100% - 1.5rem));
+  max-height: min(42rem, calc(100% - 2rem));
+  padding: 0;
+  border: 1px solid var(--color-border, var(--admin-line, #d7e4e8));
+  border-radius: 12px;
+  background: var(--color-surface, var(--admin-surface, #fff));
+  color: var(--color-text, var(--admin-text, #164e63));
+  box-shadow: 0 24px 64px color-mix(in srgb, #000 18%, transparent);
+}
+.stock-dialog::backdrop {
+  background: color-mix(in srgb, #000 45%, transparent);
+}
+.stock-dialog__bar {
+  display: flex;
+  gap: 0.5rem;
+  align-items: center;
+  padding: 0.75rem 0.85rem;
+  border-bottom: 1px solid var(--color-border, var(--admin-line, #d7e4e8));
+}
+.stock-dialog__bar input {
+  flex: 1;
+  font: inherit;
+  min-height: 2.4rem;
+  padding: 0.4rem 0.65rem;
+  border: 1px solid var(--color-border, var(--admin-line, #d7e4e8));
+  border-radius: 8px;
+  background: var(--color-bg, var(--admin-bg, #f4f7f8));
+  color: inherit;
+}
+.stock-dialog__bar button,
+.stock-row button {
+  font: inherit;
+  cursor: pointer;
+  border: 1px solid var(--color-border, var(--admin-line, #d7e4e8));
+  background: var(--color-bg, var(--admin-bg, #f4f7f8));
+  color: inherit;
+  border-radius: 8px;
+  padding: 0.35rem 0.65rem;
+}
+.stock-chips {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.35rem;
+  padding: 0.65rem 0.85rem 0;
+}
+.stock-chips button {
+  font: inherit;
+  font-size: 0.78rem;
+  cursor: pointer;
+  border: 1px solid var(--color-border, var(--admin-line, #d7e4e8));
+  background: transparent;
+  color: inherit;
+  border-radius: 999px;
+  padding: 0.2rem 0.65rem;
+}
+.stock-chips button[aria-pressed="true"] {
+  background: var(--color-text, var(--admin-text, #164e63));
+  color: var(--color-bg, #fff);
+  border-color: transparent;
+}
+.stock-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(8.5rem, 1fr));
+  gap: 0.55rem;
+  padding: 0.85rem;
+  overflow: auto;
+  max-height: 28rem;
+}
+.stock-card {
+  display: grid;
+  gap: 0.3rem;
+  border: 0;
+  padding: 0;
+  background: transparent;
+  color: inherit;
+  text-align: left;
+  cursor: pointer;
+  font: inherit;
+}
+.stock-card img,
+.stock-card video {
+  width: 100%;
+  aspect-ratio: 4 / 3;
+  object-fit: cover;
+  border-radius: 8px;
+  background: var(--color-bg, var(--admin-bg, #ece8e1));
+  border: 1px solid var(--color-border, var(--admin-line, #d7e4e8));
+  font-size: 0;
+  color: transparent;
+}
+.stock-card span {
+  font-size: 0.72rem;
+  line-height: 1.3;
+  color: var(--color-muted, var(--admin-muted, #3d6570));
+}
+.stock-empty {
+  padding: 2rem 1rem;
+  text-align: center;
+  color: var(--color-muted, var(--admin-muted, #3d6570));
+}
+.stock-row {
+  display: flex;
+  gap: 0.4rem;
+  align-items: center;
+}
+.stock-row input { flex: 1; min-width: 0; }
+.stock-thumb {
+  width: 2.75rem;
+  height: 2.75rem;
+  object-fit: cover;
+  border-radius: 6px;
+  border: 1px solid var(--color-border, var(--admin-line, #d7e4e8));
+  background: var(--color-bg, var(--admin-bg, #f4f7f8));
+  flex-shrink: 0;
+}
+.stock-thumb:not([src]),
+.stock-thumb[src=""] { display: none; }

package/src/stock/picker.js

@@ -0,0 +1,191 @@
+(() => {
+  const existing = window.VitrisStock;
+  const state = {
+    catalog: existing?.catalog || { version: 1, items: [] },
+    base: existing?.base || "",
+    kind: "image",
+    query: "",
+    category: "all",
+    role: "", orientation: "", negativeSpace: "",
+    onSelect: null,
+  };
+
+  function resolve(path) {
+    if (!path) return "";
+    if (/^https?:/i.test(path) || path.startsWith("data:")) return path;
+    const rel = path.replace(/^\//, "");
+    if (state.base) {
+      const base = state.base.endsWith("/") ? state.base : `${state.base}/`;
+      return new URL(rel, base).href;
+    }
+    if (location.protocol === "file:" || /\.html?$/i.test(location.pathname)) {
+      return new URL(rel, new URL(".", location.href)).href;
+    }
+    return `${location.origin}/${rel}`;
+  }
+
+  function ensureDialog() {
+    let dialog = document.querySelector(".stock-dialog");
+    if (dialog) return dialog;
+    dialog = document.createElement("dialog");
+    dialog.className = "stock-dialog";
+    dialog.innerHTML = `<form method="dialog" class="stock-dialog__bar">
+        <input type="search" name="q" placeholder="Search the stock library" aria-label="Search stock">
+        <button type="submit" value="close">Close</button>
+      </form>
+      <div class="stock-filters">
+        <label>Use <select name="role"><option value="">Any</option><option>hero</option><option>context</option><option>detail</option><option>atmosphere</option></select></label>
+        <label>Shape <select name="orientation"><option value="">Any</option><option>landscape</option><option>portrait</option><option>square</option></select></label>
+        <label>Text space <select name="negativeSpace"><option value="">Any</option><option>left</option><option>right</option><option>top</option><option>all</option></select></label>
+      </div>
+      <div class="stock-chips" role="tablist" aria-label="Categories"></div>
+      <div class="stock-grid"></div>`;
+    document.body.append(dialog);
+    dialog.querySelector("input[name=q]").addEventListener("input", (event) => {
+      state.query = event.target.value.trim().toLowerCase();
+      paint();
+    });
+    for (const select of dialog.querySelectorAll("select")) select.addEventListener("change", () => { state[select.name] = select.value; paint(); });
+    return dialog;
+  }
+
+  function items() {
+    if (window.VitrisStockSearch) return window.VitrisStockSearch(state.catalog.items || [], {text: state.query, kind: state.kind, industry: state.category === "all" ? undefined : state.category, role: state.role || undefined, orientation: state.orientation || undefined, negativeSpace: state.negativeSpace || undefined});
+    const q = state.query;
+    return (state.catalog.items || []).filter((item) => {
+      if (state.kind && item.kind !== state.kind) return false;
+      if (state.category !== "all" && !(item.categories || []).includes(state.category)) return false;
+      if (!q) return true;
+      const blob = `${item.alt} ${item.id} ${(item.tags || []).join(" ")} ${(item.categories || []).join(" ")}`.toLowerCase();
+      return blob.includes(q);
+    });
+  }
+
+  function paint() {
+    const dialog = ensureDialog();
+    const chips = dialog.querySelector(".stock-chips");
+    const grid = dialog.querySelector(".stock-grid");
+    const cats = new Set(["all"]);
+    for (const item of state.catalog.items || []) {
+      if (state.kind && item.kind !== state.kind) continue;
+      if (item.status === "excluded" || item.status === "staged") continue;
+      for (const cat of item.inspection?.industries || item.categories || []) cats.add(cat);
+    }
+    chips.replaceChildren(
+      ...[...cats].map((cat) => {
+        const btn = document.createElement("button");
+        btn.type = "button";
+        btn.textContent = cat;
+        btn.setAttribute("aria-pressed", String(cat === state.category));
+        btn.addEventListener("click", () => {
+          state.category = cat;
+          paint();
+        });
+        return btn;
+      }),
+    );
+    const rows = items();
+    if (!rows.length) {
+      grid.innerHTML = `<p class="stock-empty">No matching stock yet. Run <code>npm run stock</code> with a Pexels API key to fill the library.</p>`;
+      return;
+    }
+    grid.replaceChildren(
+      ...rows.map((item) => {
+        const btn = document.createElement("button");
+        btn.type = "button";
+        btn.className = "stock-card";
+        const media = document.createElement(item.kind === "video" ? "video" : "img");
+        media.src = resolve(item.kind === "video" ? item.src : item.thumb || item.src);
+        media.alt = item.alt || "";
+        if (item.kind === "video") {
+          media.muted = true;
+          media.loop = true;
+          media.playsInline = true;
+          media.poster = resolve(item.thumb); media.preload = "none";
+          btn.addEventListener("pointerenter", () => { if (!matchMedia("(prefers-reduced-motion: reduce)").matches) media.play().catch(() => {}); });
+          btn.addEventListener("pointerleave", () => media.pause());
+        }
+        const cap = document.createElement("span");
+        cap.textContent = item.inspection?.description || item.alt || item.id;
+        btn.append(media, cap);
+        btn.addEventListener("click", () => {
+          state.onSelect?.(item.src, item);
+          dialog.close();
+        });
+        return btn;
+      }),
+    );
+  }
+
+  async function load() {
+    // Prefer the published catalog; the embedded copy is the offline fallback.
+    try {
+      const res = await fetch(`${state.base.replace(/\/$/, "")}/stock/catalog.json`, { credentials: "same-origin" });
+      if (res.ok) state.catalog = await res.json();
+    } catch {
+      /* gallery may embed the catalog instead */
+    }
+  }
+
+  window.VitrisStock = {
+    get catalog() {
+      return state.catalog;
+    },
+    set catalog(value) {
+      state.catalog = value || { version: 1, items: [] };
+    },
+    get base() {
+      return state.base;
+    },
+    set base(value) {
+      state.base = value || "";
+    },
+    resolve,
+    async open(opts) {
+      state.kind = opts?.kind === "video" ? "video" : "image";
+      state.category = "all";
+      state.role = ""; state.orientation = ""; state.negativeSpace = "";
+      state.query = "";
+      state.onSelect = opts?.onSelect || null;
+      await load();
+      const dialog = ensureDialog();
+      const search = dialog.querySelector("input[name=q]");
+      for (const select of dialog.querySelectorAll("select")) select.value = "";
+      search.value = "";
+      paint();
+      if (typeof dialog.showModal === "function") dialog.showModal();
+      else dialog.setAttribute("open", "");
+      search.focus();
+    },
+    bind(root) {
+      (root || document).addEventListener("click", (event) => {
+        const btn = event.target.closest("[data-stock-open]");
+        if (!btn) return;
+        event.preventDefault();
+        const wrap = btn.closest(".stock-field") || btn.parentElement;
+        const input = wrap?.querySelector("input, textarea");
+        const kind = btn.getAttribute("data-stock-kind") || input?.dataset.stockKind || "image";
+        window.VitrisStock.open({
+          kind,
+          onSelect(url, item) {
+            if (!input) return;
+            input.value = url;
+            input.dispatchEvent(new Event("input", { bubbles: true }));
+            input.dispatchEvent(new Event("change", { bubbles: true }));
+            const thumb = wrap.querySelector(".stock-thumb");
+            if (thumb) {
+              thumb.src = item?.thumb ? resolve(item.thumb) : url;
+              thumb.hidden = !thumb.src;
+            }
+          },
+        });
+      });
+    },
+  };
+
+  if (document.readyState === "loading") {
+    document.addEventListener("DOMContentLoaded", () => window.VitrisStock.bind(document), { once: true });
+  } else {
+    window.VitrisStock.bind(document);
+  }
+})();

package/templates/site/.env.example

@@ -0,0 +1,6 @@
+# Copy to .env and fill (never commit .env)
+VITRIS_BACKEND_ORIGIN=http://127.0.0.1:8787
+CLOUDFLARE_ACCOUNT_ID=
+CLOUDFLARE_API_TOKEN=
+# Optional: ASSETS_ORIGIN for public R2 URLs after harvest
+# ASSETS_ORIGIN=https://assets.example.com

package/templates/site/.github/workflows/deploy.yml

@@ -0,0 +1,59 @@
+name: Deploy
+# Prefer connecting the Cloudflare Pages project to this GitHub repo
+# (Dashboard → Pages → project → Settings → Builds → Connect to Git).
+# Then every branch, including update-* preview branches from the Vitris
+# concierge, builds automatically. Keep this workflow only if you are NOT
+# using Pages Git integration (Direct Upload fallback).
+on:
+  push:
+    branches: [main]
+  pull_request:
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    env:
+      VITRIS_TENANT_ID: ${{ secrets.VITRIS_TENANT_ID }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 24
+      - run: npm ci
+      - run: npx playwright install --with-deps chromium
+      - run: npm run build
+        env:
+          VITRIS_BACKEND_ORIGIN: ${{ secrets.VITRIS_BACKEND_ORIGIN || secrets.KERNEL_ORIGIN }}
+          VITRIS_SITE_ENVIRONMENT: ${{ github.ref == 'refs/heads/main' && 'production' || 'preview' }}
+      - name: Launch preflight
+        run: |
+          if [ "${{ github.ref }}" = "refs/heads/main" ]; then
+            node ./node_modules/@tryvitris/website-harness/bin/vitris-launch-preflight.js --environment production --site .
+          else
+            node ./node_modules/@tryvitris/website-harness/bin/vitris-launch-preflight.js --environment preview --site .
+          fi
+      - name: Deploy to Cloudflare Pages
+        if: github.ref != 'refs/heads/main' || env.VITRIS_TENANT_ID == ''
+        # On PRs / non-main, --branch creates a Pages preview deployment.
+        run: |
+          BRANCH="${{ github.head_ref || github.ref_name }}"
+          if [ "${{ github.ref }}" = "refs/heads/main" ]; then
+            npx wrangler pages deploy dist --project-name=__SLUG__
+          else
+            npx wrangler pages deploy dist --project-name=__SLUG__ --branch="$BRANCH"
+          fi
+        env:
+          CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+          CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+      - name: Publish authenticated exact bundle through the backend Worker
+        if: github.ref == 'refs/heads/main' && env.VITRIS_TENANT_ID != ''
+        env:
+          VITRIS_PUBLISH_ATTESTATION_SECRET: ${{ secrets.VITRIS_PUBLISH_ATTESTATION_SECRET }}
+          VITRIS_BACKEND_ORIGIN: ${{ secrets.VITRIS_BACKEND_ORIGIN || secrets.KERNEL_ORIGIN }}
+        run: |
+          node ./node_modules/@tryvitris/website-harness/bin/vitris-sign-publish-bundle.js \
+            --site . --tenant-id "$VITRIS_TENANT_ID" --slug __SLUG__ --project __SLUG__ \
+            --out "$RUNNER_TEMP/vitris-publish-bundle.json"
+          curl --fail-with-body --silent --show-error \
+            -H 'content-type: application/json' \
+            --data-binary @"$RUNNER_TEMP/vitris-publish-bundle.json" \
+            "${VITRIS_BACKEND_ORIGIN%/}/api/publish-attested"

package/templates/site/AGENTS.md

@@ -0,0 +1,35 @@
+# __NAME__ site agent
+
+This site uses the Vitris active-agent workflow. The active local agent executes workflow stages directly. The harness prepares context in `agent/CURRENT.md`, executes deterministic tools, evaluates artifacts, and advances the graph.
+
+## Active-Agent Loop
+
+If the initial request provides a source URL, template, and additional content, record them when scaffolding with `vitris site create --from URL --template "ID or name or hosted URL" --content "exact text"` (or `--content-file FILE`). Existing sites accept `vitris run` or `npm run go -- --template ... --content-file ...` before preparing a stage. Read `onboarding/additional-content.md` alongside source evidence throughout the build. A direct template request authorizes automatic section adaptation and continuation through local preview, using existing/stock media with AI imagery disabled. Do not stop to show the template picker, ask adaptation-policy questions, or solicit representative feedback on this route. Complete the actual reference, browser, critic and quality gates; retain visible fill-ins for unsupported missing content and do not claim human design approval. With no supplied template, the interactive selection workflow still applies.
+
+1. Run `npm run go` (or `npm run go -- --prepare`) to prepare the next eligible stage.
+2. Read the stage instructions and bounds in `agent/CURRENT.md`.
+3. Perform the work specified by editing allowed files in `pages/`, `components/`, `onboarding/`, or writing reviews in `agent/reviews/`.
+4. Complete the stage using the command shown in `agent/CURRENT.md`:
+   `npm run go -- --complete --preparation <PREPARATION_ID>`
+   (Optionally report host-provided agent token usage with `--agent-input-tokens <N> --agent-output-tokens <N>`).
+5. Repeat until preview is ready. The workflow advances through:
+   harvest → business + review → media → narrative + review → reference analysis → direction + review → storyboard → copy + review → representative + browser + review → pages → browser → visual + content reviews → preview.
+
+## Refinement (CLI & Chat Editing)
+
+When making later-life changes in Cursor or chat:
+1. **Discover Memory & Prepare**:
+   Run `npm run go -- --change "..." --prepare` to analyze impact, detect memory drift, and capture a baseline in `agent/requests/<requestId>/baseline.json`.
+2. **Edit Source Directly**:
+   Target sections by `id`, `data-slot`, or `slot`. Always protect notes (`.note`), captions (`.caption`), and action CTAs (`.btn`, `.cta`) from accidental body-copy overwriting. Do not invent business facts without source evidence.
+3. **Verify by Impact**:
+   Run `npm run go -- --complete --preparation <PREPARATION_ID>` to evaluate that stage, then continue preparing/completing the remaining stages. Browser tool stages compile and check the site. Site memory is updated after final regression checks pass.
+
+## Operator Guardrails
+
+- Never mark checks passed by hand or bypass gates.
+- Site-specific preferences belong in `agent/request.json` or site memory.
+- Plan managed-kit updates with `vitris upgrade --site . --plan`, inspect conflicts, then use `--apply`. `npm run refresh-agent` is a compatibility alias. Package defaults are selected only when their recorded hashes match `agent/managed-files.json`; place site-specific instructions under `agent/overrides/`. Unknown copied-kit edits remain conflicts. `launch.json`, authored files, `agent/STATE.json`, preparations, leases, and receipts are preserved.
+- Cloudflare deployment is explicit via `vitris deploy` (or `wrangler deploy`).
+
+Two identical failures block automatic continuation. Fix the cause and use an explicit restart with a reason; ordinary resume does not reset attempts or spend. Follow parent design-stage resume instructions exactly. Active-agent reviews and independent-model reviews are labeled separately; neither implies human approval.

package/templates/site/CLAUDE.md

@@ -0,0 +1,5 @@
+# Vitris site
+
+Read `AGENTS.md` and the active stage in `agent/CURRENT.md`. Do not copy the harness skill library into this file.
+
+Prepare with `npm run go -- --prepare`, do only the allowed writes, then complete with the preparation id printed in `agent/CURRENT.md`. Stop at local preview unless launch was explicitly requested.

package/templates/site/GEMINI.md

@@ -0,0 +1,5 @@
+# Vitris site
+
+Antigravity reads this file or `AGENTS.md`. Follow `agent/CURRENT.md` for the active stage. Do not load the whole harness skill library as an always-on rule.
+
+Prepare with `npm run go -- --prepare`, edit only the allowed paths, then complete with the preparation id in `agent/CURRENT.md`.

package/templates/site/README.md

@@ -0,0 +1,55 @@
+# __NAME__
+
+This is the starting directory for this customer website. Open this directory in your coding agent. The versioned `@tryvitris/website-harness` dependency supplies the tools; this repository owns the customer content, components, brand, and workflow progress.
+
+Vitris site repo. The harness compiles `pages/` + `components/` to static `dist/`.
+
+## Layout
+
+```
+agent/                 # workflow graph, stage prompt, evals, refs
+pages/                 # file-based routes (index.html → /)
+components/            # this site’s reusable blocks
+media/                 # harvest + composed assets
+onboarding/            # crawl + research artifacts
+launch.json            # backend + Cloudflare contract (no secrets)
+site.json              # name, slug, motion
+theme/defaults.json    # brand tokens
+```
+
+## Hit go
+
+```bash
+npm install
+npx playwright install chromium   # required for study and preview verification
+npm run go                        # prepare the next stage → preview_ready
+# or open this folder in Cursor and say "go"
+npm run build                     # → dist/ local preview
+```
+
+Default loop stops at a local preview. Launch (GitHub + Cloudflare Pages + backend tenant) is explicit — see `agent/refs/launch.md` and `launch.json`.
+
+For a production Pages deployment, set `launch.json.publicOrigin` to the final `https://` origin. Use `npm run build && npm run preflight` as the Cloudflare Git build command, with `VITRIS_SITE_ENVIRONMENT=production` and `VITRIS_BACKEND_ORIGIN` set in build environment variables; the output directory is `dist`. The preflight rebuilds and verifies the exact publishable files with Chromium, so the build must have Playwright's browser binary installed. Any failed required check exits nonzero and stops publication. Keep preview branches on `VITRIS_SITE_ENVIRONMENT=preview` and use the generated CI workflow when branch-specific gating is needed. Do not use a bare `npm run build` as a production build command.
+
+To ignore local Cursor-chat traces in an existing site, add `agent/runs/traces/` to `.gitignore`. See harness `docs/tracing.md`.
+
+If this site publishes through the backend Worker, protected CI needs `VITRIS_TENANT_ID`, `VITRIS_PUBLISH_ATTESTATION_SECRET`, and `VITRIS_BACKEND_ORIGIN`; the Worker needs the matching `PUBLISH_ATTESTATION_SECRET` and its Cloudflare API credentials. The generated workflow signs the exact verified `dist/` bundle and posts it to `/api/publish-attested`. The Worker rejects stale, altered, or mismatched evidence before changing hosted content. A Pages project using Git integration can continue using its normal build path; avoid configuring both paths for the same production release.
+
+For interactive workflow commands on Windows, call the installed bin directly when forwarding flags, for example `node ./node_modules/@tryvitris/website-harness/bin/vitris-go.js --prepare --jev-mode off`. `npm run go -- --prepare` may be parsed differently by some npm/PowerShell versions. A prepared `agent/CURRENT.md` is the active stage; complete it with the recorded preparation ID, then prepare the next stage. Do not edit `agent/STATE.json`.
+
+## Authoring
+
+```html
+---
+title: Home
+description: …
+---
+<header></header>
+<hero motion="off">
+  <h1>Headline for this page</h1>
+  <a class="btn" href="/contact">Get a quote</a>
+</hero>
+<footer></footer>
+```
+
+Build flattens `<hero>` into ordinary HTML. Lead forms use `data-lead-form` and POST to the backend (`VITRIS_BACKEND_ORIGIN`).

package/templates/site/components/README.md

@@ -0,0 +1,18 @@
+# Site components
+
+Every visual block for this website lives here — not in the harness.
+
+```
+components/<name>/
+  template.html   # layout + <slot> / <slot name="…">
+  styles.css      # scoped .c-<name>, tokens only
+  island.js       # optional; targets flattened DOM, no Shadow DOM
+```
+
+Invent components for this business (header, hero, offers, …), then reuse them across `pages/*.html`.
+
+Do not add `schema.json` — there is no owner visual editor. Agents read the template and `agent/refs/components.md`.
+
+Template roots should use `div` / `section` with class `c-<name>` — not a tag that matches the component folder name (avoids flatten loops).
+
+See `agent/refs/components.md`.

package/templates/site/gitignore

@@ -0,0 +1,10 @@
+node_modules/
+dist/
+.wrangler/
+.env
+.dev.vars
+scratch/
+agent/runs/traces/
+.cursor/vitris-trace-hooks.json
+.cursor/hooks.json.vitris-backup
+.cursor/hooks.json.malformed

package/templates/site/launch.json

@@ -0,0 +1,14 @@
+{
+  "slug": "__SLUG__",
+  "name": "__NAME__",
+  "sourceUrl": "",
+  "backendOrigin": "",
+  "ownerEmail": "",
+  "pagesProject": "__SLUG__",
+  "github": {
+    "owner": "",
+    "repo": ""
+  },
+  "publicOrigin": "",
+  "performance": { "enabled": true, "runs": 3 }
+}

package/templates/site/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "__SLUG__",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "build": "node ./node_modules/@tryvitris/website-harness/bin/vitris-build.js --site . --out dist --slug __SLUG__",
+    "harvest": "node ./node_modules/@tryvitris/website-harness/bin/vitris-harvest.js",
+    "media:prepare": "node ./node_modules/@tryvitris/website-harness/bin/vitris-prepare-media.js --site .",
+    "media:register": "node ./node_modules/@tryvitris/website-harness/bin/vitris-prepare-media.js --site . --register",
+    "media:serve": "node ./node_modules/@tryvitris/website-harness/bin/vitris-media-serve.js --site .",
+    "eval": "node ./node_modules/@tryvitris/website-harness/bin/vitris-eval.js",
+    "go": "node ./node_modules/@tryvitris/website-harness/bin/vitris-go.js",
+    "preflight": "node ./node_modules/@tryvitris/website-harness/bin/vitris-launch-preflight.js --environment production",
+    "deploy": "npm run build && npm run preflight && wrangler pages deploy dist --project-name=__SLUG__",
+    "verify:browser": "node ./node_modules/@tryvitris/website-harness/bin/vitris-verify-browser.js",
+    "verify:performance": "node ./node_modules/@tryvitris/website-harness/bin/vitris-verify-performance.js --site .",
+    "refresh-agent": "node ./node_modules/@tryvitris/website-harness/bin/vitris-refresh.js --site .",
+    "preview": "node ./node_modules/@tryvitris/website-harness/bin/vitris-preview.js"
+  },
+  "dependencies": {
+    "@tryvitris/website-harness": "__HARNESS__"
+  },
+  "devDependencies": {
+    "playwright": "^1.63.0",
+    "wrangler": "^4.152.0"
+  },
+  "overrides": {
+    "miniflare": {
+      "undici": "7.30.1",
+      "sharp": "0.35.5"
+    }
+  },
+  "engines": {
+    "node": ">=24"
+  }
+}

package/templates/site/pages/README.md

@@ -0,0 +1,31 @@
+# Pages
+
+Each HTML file under `pages/` becomes a public URL:
+
+| File | URL |
+|------|-----|
+| `index.html` | `/` |
+| `about.html` | `/about` |
+| `services.html` | `/services` |
+| `blog/index.html` | `/blog` |
+| `blog/my-post.html` | `/blog/my-post` |
+
+Optional frontmatter:
+
+```html
+---
+title: Home
+description: One-line SEO description.
+---
+<header></header>
+<hero motion="off">
+  <h1>Your headline</h1>
+</hero>
+<footer></footer>
+```
+
+Authoring tags (`<header>`, `<hero>`, …) must match folders in `components/`. Copy for a page lives in that page file (slots / children). Shared chrome copy lives inside `components/header` and `components/footer`.
+
+The build flattens authoring tags to ordinary HTML. Do not wrap `<main>` or add a skip-link in the page file — the harness injects those (`#main`).
+
+See `agent/refs/compose.md`, `sections.md`, `layout.md`, `counterpoint.md`, `usability.md`, `components.md`.

package/templates/site/site.json

@@ -0,0 +1,10 @@
+{
+  "name": "__NAME__",
+  "slug": "__SLUG__",
+  "sourceFormatVersion": 1,
+  "capabilities": [],
+  "knowledgeRelease": "2026-09-22",
+  "motion": { "strength": "off", "stagger": false },
+  "scrollMotion": { "version": 1, "policy": "enabled" },
+  "motionComposition": { "version": 2, "routes": "all-authored" }
+}

package/templates/site/theme/defaults.json

@@ -0,0 +1,17 @@
+{
+  "colorBg": "#F7F4EF",
+  "colorText": "#1A1714",
+  "colorMuted": "#5C574F",
+  "colorAccent": "#B44A2C",
+  "colorAccentText": "#FFFFFF",
+  "colorSurface": "#FFFFFF",
+  "colorSurface2": "#EFEAE3",
+  "colorBorder": "#E4DDD2",
+  "colorFocus": "#B44A2C",
+  "fontBody": "ui-sans-serif, system-ui, sans-serif",
+  "fontDisplay": "ui-serif, Georgia, serif",
+  "radius": "8px",
+  "radiusLg": "16px",
+  "radiusPill": "999px",
+  "maxWidth": "1120px"
+}