thurview 0.18.0 → 0.20.0

package/dist/ui/index.html

@@ -4,6 +4,27 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>thurview</title>
+    <script>
+      // Before first paint, so the page never flashes the other palette: the
+      // reader's pick from the menu wins, and "system" follows the OS, live.
+      (() => {
+        const os = matchMedia("(prefers-color-scheme: dark)");
+        // `chosen` is the menu's pick, so it applies even where storage is blocked
+        const apply = (chosen) => {
+          let pick = typeof chosen === "string" ? chosen : "system";
+          if (typeof chosen !== "string")
+            try {
+              pick = localStorage.getItem("thurview.theme") || "system";
+            } catch {}
+          const root = document.documentElement;
+          root.dataset.themePick = pick;
+          root.dataset.theme = pick === "system" ? (os.matches ? "dark" : "light") : pick;
+        };
+        os.addEventListener("change", () => apply(document.documentElement.dataset.themePick));
+        window.thurviewTheme = apply;
+        apply();
+      })();
+    </script>
     <link rel="stylesheet" href="/app.css" />
   </head>
   <body>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thurview",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "Guided, evidence-anchored reviews of agent-written code. A coding agent authors the review; you read, ask, comment and decide in the browser.",
   "license": "MIT",
   "type": "module",

package/skills/thurview/SKILL.md

@@ -85,8 +85,7 @@ Read [Document authoring](references/document-authoring.md) before you write.
 Read [Components](references/components.md) before you edit `data.yaml` or add
 a fenced component. Read [Lifecycle](references/lifecycle.md) for statuses,
 storage and thread rules. Read [Software map](references/software-map.md)
-before you author `map.yaml`. Read [Theme](references/theme.md) before you
-write `theme.yaml`.
+before you author `map.yaml`.
 
 ## Workflow
 
@@ -110,7 +109,7 @@ head), when you need to choose between several.
 
 Record from the output: `review.id` (the short id, accepted everywhere),
 `review.dir`, `review.base`, `review.head`, `files.document`, `files.data`,
-`files.map`, `files.theme`, `change` (files, additions, deletions) and
+`files.map`, `change` (files, additions, deletions) and
 `guidance`.
 
 Resolve refs before passing them. Pass commit ids or plain ref names; do not
@@ -237,14 +236,7 @@ not, and publishes as "not assessed". See
 [Document authoring](references/document-authoring.md) and
 [Components](references/components.md).
 
-### 6. Theme the review after the project
-
-Read [Theme](references/theme.md). Decide the look in its order: what the
-user asked for, then the reviewed project's own design system read from its
-files at head, then the default skin. Write `theme.yaml` in the review
-directory when steps 1 or 2 yield tokens; leave it empty otherwise.
-
-### 7. Publish
+### 6. Publish
 
 ```sh
 thurview publish --review <id>
@@ -252,7 +244,7 @@ thurview publish --review <id>
 
 Read every row of `diagnostics`. Fix each `error` and publish again. A
 `warning` does not block. `publish` refuses (code `THREADS_OPEN`) when a
-submitted comment thread is still open (see step 10). On success `published`
+submitted comment thread is still open (see step 9). On success `published`
 carries `rev` and `url`; the status becomes `awaiting-review`.
 
 Then open it for the reader, unless step 2 already did:
@@ -261,7 +253,7 @@ Then open it for the reader, unless step 2 already did:
 thurview open --review <id>            # prints url; --view files|commits|map
 ```
 
-### 8. Hand over
+### 7. Hand over
 
 Tell the user, in a few lines and nothing more:
 
@@ -271,8 +263,6 @@ Tell the user, in a few lines and nothing more:
 - the interface delta `verdict`, in its own words
 - the `security` verdict, in one clause: what the change crosses, or that it
   crosses nothing
-- which theme source you used: the user's request, the project's design
-  system (name the files), or the default skin
 - when the review has no map, why not, in one clause
 - that you are now waiting for their questions and their decision, and that
   a question asked after you stop waiting is queued rather than lost - the
@@ -280,7 +270,7 @@ Tell the user, in a few lines and nothing more:
 
 The page explains its own controls; do not describe them.
 
-### 9. Wait for the reader
+### 8. Wait for the reader
 
 ```sh
 thurview wait --review <id> --timeout <seconds>
@@ -307,14 +297,14 @@ worktree.
   not change the document for a question. Wait again.
 - `awaiting-agent-updates`: the reader submitted with "Request changes".
   `threads` lists what to address and `wait.decision` the summary. Go to
-  step 10.
+  step 9.
 - `accepted`: approved. Report and stop.
 - `closed`: the reader ended the review without approving it. Report and stop.
 - `review-dismissed` or `review-deleted`: stop.
 - `timeout`: nothing happened. Wait again, or tell the user the reader has not
   responded and stop.
 
-### 10. Address requested changes
+### 9. Address requested changes
 
 For each thread in `thurview threads list --review <id> --open`:
 
@@ -327,10 +317,29 @@ For each thread in `thurview threads list --review <id> --open`:
 - `thurview threads resolve <threadId> --review <id>` once the requested
   change is present. Do not resolve a thread you did not address.
 
-Then publish again (step 7), tell the user what changed since the previous
-revision in a line or two, and wait again (step 9). A republish requires zero
+Then publish again (step 6), tell the user what changed since the previous
+revision in a line or two, and wait again (step 8). A republish requires zero
 open submitted comment threads; questions do not block.
 
+## Sharing a copy that needs no server
+
+When the user asks to share, export or publish the rendered page somewhere -
+a file to send, a Pages site, a static host - write it from the published
+revision:
+
+```sh
+thurview export --review <id> --out <file.html | folder>   # --no-threads
+```
+
+It writes one self-contained HTML file (a folder gets `index.html`): the same
+page, read only, with every snippet, diagram and diff resolved at the pins,
+fetching nothing, naming no server and no local path. The reader's sent
+threads and decisions appear as static notes; their unsent drafts never do.
+Pass `--no-threads` when the copy goes beyond the people in the conversation.
+It refuses a document with no published revision, and a copy does not update:
+export again after each publish. Committing or uploading the file is the
+user's step - name where it was written and leave it there unless asked.
+
 ## Explaining a codebase rather than a change
 
 Do not pin the same commit as base and head to fake it. That leaves a review

package/skills/thurview/references/document-authoring.md

@@ -148,7 +148,6 @@ sequence diagram beats one with four.
 
 ## Files you edit
 
-Only `review.md`, `data.yaml`, `map.yaml` and `theme.yaml` in the review
-directory. Never
+Only `review.md`, `data.yaml` and `map.yaml` in the review directory. Never
 edit `review.json`, `threads.json` or `revisions/`. Threads change only
 through `thurview threads`.

package/skills/thurview/references/lifecycle.md

@@ -139,7 +139,6 @@ ${THURVIEW_HOME:-~/.thurview}/
     ├── review.md            you edit
     ├── data.yaml            you edit
     ├── map.yaml             you edit
-    ├── theme.yaml           you edit (project look; empty = default skin)
     ├── review.json          binding, pins, status, presented revision
     ├── threads.json         threads and decisions (use the CLI)
     └── revisions/<n>/       sealed copies plus compiled document.json, map.json

package/skills/thurview-design/SKILL.md

@@ -75,11 +75,11 @@ Read the guidance files that exist, in this order; the second wins on conflict.
 `thurview design` lists the ones it found under `guidance`.
 
 The `thurview` skill ships the references this one shares — components,
-software map, theme, lifecycle. `thurview skill` prints the path of every
+software map, lifecycle. `thurview skill` prints the path of every
 bundled SKILL.md; the references sit beside each one. Read **Components**
 before you edit `data.yaml`, **Software map** before you author `map.yaml`,
-**Theme** before you write `theme.yaml`, and **Lifecycle** for statuses,
-storage and thread rules — they are identical for all three kinds.
+and **Lifecycle** for statuses, storage and thread rules — they are identical
+for all three kinds.
 
 ## Workflow
 
@@ -213,10 +213,7 @@ The Map tab is where a design shows structure. Put the structure it
 A design that changes one part in place does not raise the question: leave
 `nodes: []` and say so in the handover.
 
-### 6. Theme, then publish
-
-Write `theme.yaml` per the `thurview` skill's Theme reference, or leave it
-empty for the default skin. Then:
+### 6. Publish
 
 ```sh
 thurview publish --review <id>
@@ -230,6 +227,10 @@ reader sees above the document, and `published.url` is the page.
 thurview open --review <id>
 ```
 
+To share it beyond the browser, `thurview export --review <id> --out <path>`
+writes a static, read-only copy - see the `thurview` skill's **Sharing a copy
+that needs no server**.
+
 ### 7. Hand over
 
 In a few lines, and nothing more: the `url`; the commit and scope it argues

package/skills/thurview-explain/SKILL.md

@@ -62,12 +62,12 @@ Read the guidance files that exist, in this order; the second wins on conflict.
 `thurview explain` lists the ones it found under `guidance`.
 
 The `thurview` skill ships the references this one shares - document authoring,
-components, software map, searching the code, theme, lifecycle. `thurview skill` prints the path of
+components, software map, searching the code, lifecycle. `thurview skill` prints the path of
 every bundled SKILL.md; the references sit beside each one. Read **Document
 authoring** before you write `review.md`, **Components** before you edit
 `data.yaml`, **Software map** before you author `map.yaml`, **Searching the
-code** before you look for callers, tests or importers, **Theme** before you
-write `theme.yaml`, and **Lifecycle** for statuses, storage and thread rules -
+code** before you look for callers, tests or importers, and **Lifecycle** for
+statuses, storage and thread rules -
 they are identical for all three kinds.
 
 Run the CLI as `thurview`; `npx -y thurview` runs the published package with
@@ -212,13 +212,15 @@ the code" - not a finding.
    `interfaces` in `data.yaml` is an error. So is `security`, which is what a
    change carries input across and an explainer has no change. So is
    `graph: base` on an anchor - there is one commit.
-5. `theme.yaml` as usual - see **Theme**.
-6. `thurview publish --review <id>`. Read `coverage` and `notExamined`. If the
+5. `thurview publish --review <id>`. Read `coverage` and `notExamined`. If the
    split is not the one you meant, anchor, place or search more and publish
    again.
-7. `thurview open --review <id>`, then `thurview wait --review <id>`. The loop,
+6. `thurview open --review <id>`, then `thurview wait --review <id>`. The loop,
    the statuses and the thread rules are identical to a review; see
    **Lifecycle**.
+7. To share it beyond the browser, `thurview export --review <id> --out <path>`
+   writes a static, read-only copy - see the `thurview` skill's **Sharing a
+   copy that needs no server**.
 
 ## Hand over
 

package/dist/theme.js

@@ -1,290 +0,0 @@
-import { createHash } from "node:crypto";
-import { parse as parseYaml } from "yaml";
-import { z } from "zod";
-const color = z.string().min(1).max(64);
-export const ThemeSchema = z
-    .object({
-    name: z.string().min(1),
-    /** where the tokens came from: files inspected in the project, or "default" */
-    source: z.string().optional(),
-    mode: z.enum(["dark", "light"]).default("dark"),
-    colors: z
-        .object({
-        bg: color.optional(),
-        bg2: color.optional(),
-        bg3: color.optional(),
-        code: color.optional(),
-        fg: color.optional(),
-        fg2: color.optional(),
-        muted: color.optional(),
-        line: color.optional(),
-        accent: color.optional(),
-        link: color.optional(),
-        ok: color.optional(),
-        warn: color.optional(),
-        del: color.optional(),
-        add: color.optional(),
-        remove: color.optional(),
-        select: color.optional(),
-    })
-        .strict()
-        .prefault({}),
-    fonts: z
-        .object({
-        display: z.string().optional(),
-        body: z.string().optional(),
-        mono: z.string().optional(),
-        /** external stylesheets, e.g. Google Fonts css2 urls */
-        stylesheets: z.array(z.string().url()).default([]),
-        /** font files inside the reviewed repository at the head commit */
-        files: z
-            .array(z
-            .object({
-            family: z.string().min(1),
-            path: z.string().min(1),
-            weight: z.string().optional(),
-            style: z.string().optional(),
-        })
-            .strict())
-            .default([]),
-    })
-        .strict()
-        .prefault({}),
-    shape: z
-        .object({
-        radius: z.string().optional(),
-        bevel: z.boolean().optional(),
-        glow: z.boolean().optional(),
-        scanlines: z.boolean().optional(),
-        /** text-transform for display headings, e.g. none or uppercase */
-        headingTransform: z.string().optional(),
-    })
-        .strict()
-        .prefault({}),
-    code: z
-        .object({
-        keyword: color.optional(),
-        string: color.optional(),
-        function: color.optional(),
-        type: color.optional(),
-        variable: color.optional(),
-        number: color.optional(),
-        comment: color.optional(),
-        punctuation: color.optional(),
-        operator: color.optional(),
-        tag: color.optional(),
-        fg: color.optional(),
-    })
-        .strict()
-        .prefault({}),
-    /** extra rules appended verbatim */
-    css: z.string().optional(),
-})
-    .strict();
-export function parseTheme(yaml) {
-    const diagnostics = [];
-    let raw;
-    try {
-        raw = parseYaml(yaml);
-    }
-    catch (e) {
-        diagnostics.push({
-            level: "error",
-            file: "theme.yaml",
-            message: `YAML: ${e.message}`,
-        });
-        return { theme: null, diagnostics };
-    }
-    if (raw === null || raw === undefined)
-        return { theme: null, diagnostics };
-    const r = ThemeSchema.safeParse(raw);
-    if (!r.success) {
-        for (const i of r.error.issues)
-            diagnostics.push({
-                level: "error",
-                file: "theme.yaml",
-                message: `${i.path.join(".") || "root"}: ${i.message}`,
-            });
-        return { theme: null, diagnostics };
-    }
-    return { theme: r.data, diagnostics };
-}
-const DEFAULT_CODE = {
-    fg: "#e6e8eb",
-    keyword: "#ff7b72",
-    string: "#a5d6ff",
-    function: "#d2a8ff",
-    type: "#ffa657",
-    variable: "#79c0ff",
-    number: "#79c0ff",
-    comment: "#8b949e",
-    punctuation: "#8b949e",
-    operator: "#ff7b72",
-    tag: "#7ee787",
-};
-const DEFAULT_CODE_BG = "#0b0d10";
-export function shikiTheme(name, code, mode, bg = DEFAULT_CODE_BG) {
-    const c = { ...DEFAULT_CODE, ...code };
-    return {
-        name,
-        type: mode,
-        colors: { "editor.background": bg, "editor.foreground": c.fg },
-        tokenColors: [
-            {
-                scope: ["comment", "punctuation.definition.comment", "string.comment"],
-                settings: { foreground: c.comment, fontStyle: "italic" },
-            },
-            {
-                scope: ["punctuation", "meta.brace", "punctuation.separator", "punctuation.terminator"],
-                settings: { foreground: c.punctuation },
-            },
-            {
-                scope: [
-                    "keyword",
-                    "storage",
-                    "storage.type",
-                    "storage.modifier",
-                    "keyword.control",
-                    "constant.language",
-                    "variable.language",
-                ],
-                settings: { foreground: c.keyword },
-            },
-            {
-                scope: ["keyword.operator", "keyword.operator.assignment", "keyword.operator.arrow"],
-                settings: { foreground: c.operator },
-            },
-            {
-                scope: [
-                    "string",
-                    "string.quoted",
-                    "string.template",
-                    "punctuation.definition.string",
-                    "markup.inserted",
-                ],
-                settings: { foreground: c.string },
-            },
-            {
-                scope: [
-                    "entity.name.function",
-                    "support.function",
-                    "meta.function-call entity.name.function",
-                ],
-                settings: { foreground: c.function },
-            },
-            {
-                scope: [
-                    "entity.name.type",
-                    "entity.name.class",
-                    "support.class",
-                    "support.type",
-                    "entity.other.inherited-class",
-                    "entity.name.namespace",
-                ],
-                settings: { foreground: c.type },
-            },
-            {
-                scope: [
-                    "constant.numeric",
-                    "constant.character",
-                    "constant.other",
-                    "constant.language.boolean",
-                ],
-                settings: { foreground: c.number },
-            },
-            {
-                scope: [
-                    "entity.name.tag",
-                    "support.type.property-name",
-                    "meta.object-literal.key",
-                    "entity.other.attribute-name",
-                    "meta.property-name",
-                ],
-                settings: { foreground: c.tag },
-            },
-            {
-                scope: [
-                    "variable",
-                    "variable.parameter",
-                    "variable.other",
-                    "meta.definition.variable",
-                    "entity.name.variable",
-                ],
-                settings: { foreground: c.variable },
-            },
-            { scope: ["markup.deleted"], settings: { foreground: c.operator } },
-            {
-                scope: ["markup.heading", "entity.name.section"],
-                settings: { foreground: c.tag, fontStyle: "bold" },
-            },
-            { scope: ["markup.bold"], settings: { fontStyle: "bold" } },
-            { scope: ["markup.italic"], settings: { fontStyle: "italic" } },
-        ],
-    };
-}
-/** Build the stylesheet and highlighter theme for a review. `blobUrl` maps a repo path to a served url. */
-export function compileTheme(theme, blobUrl) {
-    const hash = createHash("sha1").update(JSON.stringify(theme)).digest("hex").slice(0, 8);
-    const name = `theme-${hash}`;
-    const v = [];
-    const c = theme.colors;
-    const map = {
-        "--bg": c.bg,
-        "--bg2": c.bg2,
-        "--bg3": c.bg3,
-        "--bg-code": c.code,
-        "--fg": c.fg,
-        "--fg2": c.fg2,
-        "--muted": c.muted,
-        "--line": c.line,
-        "--line2": c.line,
-        "--accent": c.accent,
-        "--link": c.link,
-        "--ok": c.ok,
-        "--warn": c.warn,
-        "--del": c.del,
-        "--font-display": theme.fonts.display,
-        "--font-body": theme.fonts.body,
-        "--font-mono": theme.fonts.mono,
-        "--radius": theme.shape.radius,
-        "--heading-transform": theme.shape.headingTransform,
-    };
-    for (const [k, val] of Object.entries(map))
-        if (val)
-            v.push(`${k}: ${val};`);
-    if (c.add)
-        v.push(`--add-bg: ${c.add};`);
-    if (c.remove)
-        v.push(`--del-bg: ${c.remove};`);
-    if (c.select)
-        v.push(`--sel: ${c.select};`);
-    if (c.accent)
-        v.push(`--accent-bg: color-mix(in srgb, ${c.accent} 16%, transparent);`);
-    if (theme.mode === "light")
-        v.push("color-scheme: light; --shadow: 0 1px 2px rgb(0 0 0 / 0.08); --shadow-lg: 0 12px 32px rgb(0 0 0 / 0.14);");
-    // retro options, each off in the default skin
-    if (theme.shape.glow)
-        v.push("--glow: 0 0 5px color-mix(in srgb, var(--accent) 70%, transparent), 0 0 12px color-mix(in srgb, var(--accent) 40%, transparent);");
-    if (theme.shape.bevel)
-        v.push("--shadow: 0 0 0 1px rgb(0 0 0 / 0.6), inset 1px 1px 0 0 rgb(255 255 255 / 0.14), inset -1px -1px 0 0 rgb(0 0 0 / 0.6);");
-    const out = [];
-    for (const s of theme.fonts.stylesheets)
-        out.push(`@import url("${s}");`);
-    for (const f of theme.fonts.files) {
-        const ext = f.path.split(".").pop()?.toLowerCase() ?? "";
-        const fmt = ext === "woff2" ? "woff2" : ext === "woff" ? "woff" : ext === "otf" ? "opentype" : "truetype";
-        out.push(`@font-face { font-family: "${f.family}"; src: url("${blobUrl(f.path)}") format("${fmt}"); font-weight: ${f.weight ?? "400"}; font-style: ${f.style ?? "normal"}; font-display: swap; }`);
-    }
-    out.push(`:root { ${v.join(" ")} }`);
-    if (theme.shape.scanlines)
-        out.push("body::after { content: ''; position: fixed; inset: 0; z-index: 9999; pointer-events: none; background: repeating-linear-gradient(to bottom, transparent 0, transparent 2px, rgb(0 0 0 / 0.1) 2px, rgb(0 0 0 / 0.1) 3px); mix-blend-mode: multiply; }");
-    if (theme.css)
-        out.push(theme.css);
-    return {
-        name: theme.name,
-        ...(theme.source ? { source: theme.source } : {}),
-        css: out.join("\n"),
-        shiki: shikiTheme(name, theme.code, theme.mode, c.code ?? (theme.mode === "light" ? "#ffffff" : DEFAULT_CODE_BG)),
-    };
-}
-//# sourceMappingURL=theme.js.map

package/dist/theme.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"theme.js","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"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"}

package/skills/thurview/references/theme.md

@@ -1,89 +0,0 @@
-# Theme
-
-A review looks like the project it reviews. `theme.yaml` in the review
-directory carries the tokens; `publish` validates it and seals it with the
-revision. An empty or absent file gives the default skin.
-
-## Decide the look, in this order
-
-Move to the next step only when the current one yields nothing.
-
-1. The user asked for a specific look or named a design system: use that.
-2. Inspect the reviewed project at the head commit and match its own design
-   system: a Tailwind or theme config, CSS custom properties or design
-   tokens, a component library theme, brand assets, an existing styled page
-   or website directory, font files it ships. Read the real values; do not
-   guess. Record what you read in `source`.
-3. Nothing found: keep the default skin. Do not invent a palette.
-
-State which of the three you used when you hand over the review.
-
-## theme.yaml
-
-```yaml
-name: acme-web                       # shown in the review menu
-source: tailwind.config.ts, src/styles/tokens.css
-mode: light                          # dark (default) or light
-
-colors:                              # any CSS color; every key optional
-  bg: "#ffffff"                      # page
-  bg2: "#f6f7f9"                     # panels, bars
-  bg3: "#eef0f3"                     # hover
-  code: "#f8fafc"                    # code surfaces
-  fg: "#111827"                      # text
-  fg2: "#4b5563"                     # secondary text
-  muted: "#9ca3af"
-  line: "#e5e7eb"                    # borders
-  accent: "#2563eb"                  # headings, primary actions, status
-  link: "#2563eb"                    # links and anchor links
-  ok: "#16a34a"
-  warn: "#d97706"
-  del: "#dc2626"
-  add: "rgb(22 163 74 / .12)"        # added-line background
-  remove: "rgb(220 38 38 / .12)"     # deleted-line background
-  select: "rgb(217 119 6 / .18)"     # highlighted-line background
-
-fonts:
-  display: "Inter, sans-serif"       # brand, buttons, document headings
-  body: "Inter, sans-serif"
-  mono: "'JetBrains Mono', monospace"
-  stylesheets:                       # external font css, loaded by the page
-    - https://fonts.googleapis.com/css2?family=Inter:wght@400;700&display=swap
-  files:                             # font files the project ships, read at head
-    - { family: Acme Sans, path: web/public/fonts/acme-sans.woff2, weight: "400 700" }
-
-shape:
-  radius: 8px                        # 6px in the default skin
-  headingTransform: none             # none in the default skin
-  bevel: true                        # retro extras, all off unless set: pixel
-  glow: true                         #   bevels on panels, neon glow on headings
-  scanlines: true                    #   and tabs, a CRT overlay
-
-code:                                # syntax palette; any key optional
-  keyword: "#7c3aed"
-  string: "#15803d"
-  function: "#b45309"
-  type: "#b45309"
-  variable: "#0369a1"
-  number: "#b45309"
-  comment: "#9ca3af"
-  punctuation: "#6b7280"
-  operator: "#374151"
-  tag: "#be185d"
-  fg: "#111827"
-
-css: |                               # optional extra rules, appended last
-  .doc h1 { letter-spacing: 0; }
-```
-
-Rules:
-
-- Keep contrast readable: body text against `bg`, code against `code`.
-- A light project gets `mode: light` and light backgrounds; the default skin
-  is dark and neutral, with one blue accent.
-- `fonts.files` paths must exist at the pinned head commit; `publish`
-  rejects a missing one. Font stylesheets are fetched by the reader's
-  browser.
-- Map the project's semantic roles, not its whole palette: primary to
-  `accent` and `link`, success/warning/danger to `ok`/`warn`/`del`.
-- Unknown keys fail validation.