rdstudio 0.2.0__py3-none-any.whl

rdstudio/templates/skills/promote/SKILL.md

@@ -0,0 +1,25 @@
+---
+name: promote
+description: Move knowledge that is not specific to this project into the developer's global knowledge base. Use when a finding, procedure or practice would help in other projects, or when the developer asks to keep something globally.
+---
+
+# Promote to the global knowledge base
+
+The developer keeps a private, cross-project knowledge base (search it with
+`scope: "global"`). Project and global knowledge never link to each other, so
+a promoted concept must make sense on its own.
+
+1. **Propose, don't act.** Name the concept and say why it is general. Promote
+   only after the developer agrees.
+2. **Make it self-contained.** If it links to project concepts, either inline
+   the essential facts or accept that those links will not resolve in the
+   global base.
+3. **Promote:** use the rdstudio `promote` tool with the concept id. Use `keep: true`
+   to copy rather than move when the project still needs its own copy (the tool
+   refuses to move a concept other project concepts link to).
+4. Report the new global id to the developer.
+
+Material that is general from the start (tooling habits, reading notes outside
+this project) can be recorded straight into the global base with
+the rdstudio `record` tool and `scope: "global"`, again only when the developer
+asked for it.

rdstudio/templates/skills/question/SKILL.md

@@ -0,0 +1,33 @@
+---
+name: question
+description: Record an open question, or record the answer to one. Use when an unresolved question comes up that should not be forgotten, or when a recorded question gets answered.
+---
+
+# Questions
+
+## Opening a question
+
+Search `type: Question` first. Then record at `questions/<short-slug>`:
+
+```markdown
+---
+type: Question
+title: <the question, ending with ?>
+description: <why it matters, one sentence>
+tags: [open]
+---
+
+# Question
+
+The question in full, with context and what depends on it.
+
+# Leads
+
+What might answer it (references, experiments, people).
+```
+
+## Answering a question
+
+Update the concept: add an `# Answer` section (with sources or the experiment
+that settled it), change the `open` tag to `answered`, and link any decision
+that followed. Keep the question text unchanged so the history reads clearly.

rdstudio/templates/skills/record-okf/SKILL.md

@@ -0,0 +1,61 @@
+---
+name: record-okf
+description: Record knowledge in the project knowledge base (OKF) — findings, designs, references, procedures, research notes. Use whenever something worth remembering was learned or settled.
+---
+
+# Record knowledge
+
+Write to the knowledge base through the rdstudio `record` tool, which stamps
+provenance and regenerates indexes. Do not hand-edit `index.md` files; they are
+generated.
+
+## Before writing
+
+1. Search first (the `search-okf` skill). Update an existing concept rather than creating
+   a near-duplicate.
+2. Pick the directory that fits; list the root with
+   the rdstudio `list_concepts` tool if unsure. Create a new directory only when no
+   existing one fits, and mention it to the developer.
+
+## A good concept
+
+- **One idea per concept.** Split long material into linked concepts.
+- **Frontmatter:** `type` (required; e.g. `Design`, `Decision`, `Question`,
+  `Task`, `Procedure`, `Reference`, `Research`, `Experiment`), `title`, and a
+  one-sentence `description` (it appears in indexes and search results). Add
+  `tags` sparingly.
+- **Links** use bundle-absolute paths: `[model](/design/model.md)`. Linking to a
+  concept that does not exist yet is fine; it marks knowledge worth writing.
+- **Rate links** by how consequential they are, with the link's title:
+  `[model](/design/model.md "requires")`. `requires`: this concept cannot be
+  understood without that one (a prerequisite). `uses`: relies on it in a key
+  fact, example or proof, but not to define it. `see also`: a forward reference
+  (something that builds on this concept) or a tangent. Unrated links count as
+  `uses`. The map filters by rating and hides links implied by chains of
+  others, so honest ratings make it clearer. Do not rate a link `requires` in
+  both directions unless the concepts truly depend on each other; the Review
+  tab flags such cycles.
+- **Sources:** list external material under `sources` with a stable `id`, and
+  attribute claims with footnotes keyed by that id: `...text.[^tao-vu]`.
+- Prefer structure (headings, lists, tables) over long prose. Maths in `$...$`
+  and `$$...$$` renders in the dashboard.
+- **Diagrams** go in ` ```mermaid ` fences (flowchart, sequenceDiagram,
+  stateDiagram-v2, classDiagram, erDiagram, timeline, mindmap). The text is the
+  source of truth: anyone can read and edit it, and the dashboard draws it
+  offline. Keep each diagram small and focused; split rather than sprawl. If
+  the developer sketches something (a photo or screenshot), transcribe it into
+  Mermaid rather than storing only the image.
+
+## Significance
+
+A significant edit updates `generated` and, if a human had reviewed the
+concept, flags it as changed since review. Set `significant: false` for trivial
+edits (typos, formatting) or content the developer dictated verbatim, `true` for
+anything that changes meaning, or leave it out to let rdstudio judge from the
+size of the change. Never add `verified` entries yourself; only the developer verifies
+(`rdstudio verify <id>`).
+
+## Updating part of a concept
+
+Use `section_heading` with `body` to replace one section, or `append` to add to
+the end, instead of resending the whole body.

rdstudio/templates/skills/report/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: report
+description: Write an HTML report for the developer after substantial work — a task, an experiment, an investigation or a long session. Reports appear in the dashboard's Reports tab.
+---
+
+# Write a report
+
+Reports are the agent's channel to the developer: richer than chat, kept
+permanently, and browsable in the dashboard. They are HTML, not markdown, so
+they can hold charts, maths, figures and tables.
+
+## When
+
+After completing a task, running an experiment, finishing an investigation, or
+when the developer asks. One report per piece of work.
+
+## Where and how
+
+1. Copy `.claude/skills/report/template.html` to
+   `{reports}/YYYY-MM-DD-<short-slug>.html`.
+2. Fill in the `<meta name="rdstudio:...">` tags (title, date, author as your
+   actor id, activity) and the description.
+3. Write the body. Structure it for a reader who was not watching:
+   - **Summary**: two to four sentences on what was done and the result.
+   - **What changed**: files, concepts, decisions (link them).
+   - **Results**: figures, tables, charts, with honest caveats.
+   - **Deviations and issues**: anything that did not go to plan.
+   - **For you to do**: what the developer should check, test or decide.
+4. Link knowledge with `<a href="/{knowledge}/<id>.md">`. Those links open in the
+   dashboard and draw the report into the graph. Reports link to knowledge, never
+   the reverse.
+
+## Rich content
+
+The template loads the dashboard's bundled libraries (no internet needed):
+
+- Maths: `\( ... \)` inline and `\[ ... \]` display, rendered by KaTeX.
+- Charts: a Vega-Lite spec in `<script type="application/json" class="vega-lite">`
+  is rendered in place. Inline data under `data.values`, or reference a CSV/JSON
+  file saved next to the report.
+- Diagrams: Mermaid source in `<pre class="mermaid">...</pre>` is drawn in
+  place, in the dashboard's theme.
+- Figures: save images next to the report (e.g. `{reports}/media/`) and use
+  relative paths.
+
+Keep reports factual. State what was measured, not what you hoped.

rdstudio/templates/skills/report/template.html

@@ -0,0 +1,74 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>REPORT TITLE</title>
+<meta name="rdstudio:date" content="YYYY-MM-DD">
+<meta name="rdstudio:author" content="AGENT ACTOR ID">
+<meta name="rdstudio:activity" content="Task / Experiment / Investigation / Session">
+<meta name="description" content="One sentence: what this report is about.">
+<!-- Shared assets from the dashboard (paths are relative to reports/). -->
+<link rel="stylesheet" href="../vendor/katex/katex.min.css">
+<link rel="stylesheet" href="../report.css">
+<script defer src="../vendor/katex/katex.min.js"></script>
+<script defer src="../vendor/katex/auto-render.min.js"></script>
+<script defer src="../vendor/vega/vega.min.js"></script>
+<script defer src="../vendor/vega/vega-lite.min.js"></script>
+<script defer src="../vendor/vega/vega-embed.min.js"></script>
+<script defer src="../report.js"></script>
+</head>
+<body>
+<main>
+  <header class="report-head">
+    <p class="report-meta">Report, YYYY-MM-DD, AGENT ACTOR ID</p>
+    <h1>REPORT TITLE</h1>
+  </header>
+
+  <p class="summary">Two to four sentences: what was done and what came of it.</p>
+
+  <h2>What changed</h2>
+  <ul>
+    <li>Files, with a clause each on why.</li>
+    <li>Knowledge recorded, e.g. <a href="/knowledge/decisions/example.md">the decision</a>.</li>
+  </ul>
+
+  <h2>Results</h2>
+  <p>Inline maths like \( \rho(W) < 1 \) and display maths:</p>
+  \[ \lambda_{\max} \approx g \sqrt{N p (1 - p)} \]
+
+  <script type="application/json" class="vega-lite">
+  {
+    "$schema": "https://vega.github.io/schema/vega-lite/v6.json",
+    "data": { "values": [
+      { "g": 0.5, "radius": 0.49 }, { "g": 1.0, "radius": 1.01 }, { "g": 1.5, "radius": 1.52 }
+    ] },
+    "mark": { "type": "line", "point": true },
+    "encoding": {
+      "x": { "field": "g", "type": "quantitative", "title": "Gain g" },
+      "y": { "field": "radius", "type": "quantitative", "title": "Spectral radius" }
+    },
+    "height": 220
+  }
+  </script>
+  <p class="chart-caption">What the chart shows, and how it was produced.</p>
+
+  <p>Structure (pipelines, dependencies, state machines) as a Mermaid diagram:</p>
+  <pre class="mermaid">
+flowchart LR
+  G[Genome] --> M[Block matrix] --> S[Simulate] --> F{Fitness}
+  F -->|select| G
+  </pre>
+
+  <h2>Deviations and issues</h2>
+  <p>Anything that did not go to plan.</p>
+
+  <section class="todo">
+    <h2>For you to do</h2>
+    <ul>
+      <li>What to check, test or decide.</li>
+    </ul>
+  </section>
+</main>
+</body>
+</html>

rdstudio/templates/skills/search-okf/SKILL.md

@@ -0,0 +1,36 @@
+---
+name: search-okf
+description: Look something up in the project knowledge base (OKF) before re-deriving it. Use when a question may already be answered, a decision may already be recorded, or you need project context.
+---
+
+# Search the knowledge base
+
+The knowledge base in `{knowledge}/` records what this project has already
+settled: design, decisions, answered questions, procedures, references and
+findings. Check it before re-deriving anything or reopening a settled question.
+
+## Steps
+
+1. The rdstudio `search` tool with a few specific keywords. Filter with `type`
+   (e.g. `Decision`, `Question`, `Procedure`), `tags` or `under` (a directory)
+   when you know them.
+2. For promising hits, the rdstudio `outline` tool to see the headings.
+3. The rdstudio `read` tool with `section_heading` to read only the part you need.
+   Read a whole concept only when it is short or all of it is relevant.
+4. Follow `links_to` / `linked_from` from the outline when the answer spans
+   concepts.
+
+For lookups that need several searches, delegate to the **librarian** subagent
+so the intermediate results stay out of your context; it returns a short answer
+with concept ids.
+
+## Reporting what you found
+
+- Cite concept ids (e.g. `decisions/activation-function`) so the developer can
+  open them in the dashboard.
+- Say how much to trust each source: `human-reviewed`, `machine-confirmed` or
+  `unverified`, and whether it has changed since review.
+- If a recorded decision applies, follow it. If you believe its stated
+  assumption no longer holds, say so explicitly instead of silently diverging.
+- If nothing is recorded, say so. If the answer you then work out is worth
+  keeping, record it with the `record-okf` skill.

rdstudio/templates/skills/task/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: task
+description: Create or work through a task concept (prompt, plan, approval, implementation, outcome). Use when the developer hands over a piece of work as a task, or points at a task concept.
+---
+
+# Tasks
+
+Tasks are concepts in `tasks/` with `type: Task`. Their state is a tag:
+`todo`, `active`, `done` or `dropped`.
+
+## Creating a task
+
+```markdown
+---
+type: Task
+title: <imperative summary>
+description: <one sentence>
+tags: [task, todo]
+---
+
+# Prompt
+
+What is wanted, in the developer's words.
+
+# Plan
+
+(Filled in by the agent before implementation.)
+
+# Acceptance
+
+How we will know it is done.
+
+# Outcome
+
+Not started.
+```
+
+## Working a task
+
+1. Read the task. Search the knowledge base for related decisions and designs.
+2. Write the `# Plan` section: files to change, approach, assumptions, and open
+   questions. Set the tag to `active`. **Stop and wait for the developer's
+   approval.**
+3. Implement. Record decisions and findings as they arise (the `decision` skill,
+   the `record-okf` skill).
+4. Write `# Outcome`: what changed, deviations from the plan and why, follow-ups,
+   and anything the developer should test. Link the report if you wrote one.
+   Set the tag to `done`.
+5. Write a report with the `report` skill for substantial tasks.
+
+Never edit the `# Prompt` section.

rdstudio/web/app.js

@@ -0,0 +1,140 @@
+// rdstudio dashboard: hash router and shell.
+
+import { store, load, watch, loadLearner } from "./js/data.js";
+import { conceptView, dirView } from "./js/knowledge.js";
+import { graphView, leaveGraph } from "./js/graph.js";
+import { mapView } from "./js/map.js";
+import { changesView, reviewView, reviewCount, reportsView, reportView, skillsView, skillView } from "./js/pages.js";
+import { proceduresView, procedureView, procedures } from "./js/procedures.js";
+import { settingsView } from "./js/settings.js";
+import { learnView } from "./js/learn.js";
+import { renderDiagrams } from "./js/diagrams.js";
+import { h } from "./js/util.js";
+
+const view = document.getElementById("view");
+const menu = document.querySelector(".menu");
+let current = null; // { tab, key, node }
+
+function parse() {
+  const raw = location.hash.replace(/^#/, "") || "/";
+  const [, head = "", ...rest] = raw.split("/");
+  const tail = rest.map(decodeURIComponent).join("/");
+  switch (head) {
+    case "": return { tab: "knowledge", key: "d:", render: () => dirView("") };
+    case "d": return { tab: "knowledge", key: "d:" + tail, render: () => dirView(tail) };
+    case "k": return { tab: "knowledge", key: "k:" + tail, render: () => conceptView(tail) };
+    case "graph": return { tab: "graph", key: "graph", render: graphView };
+    case "map": return { tab: "map", key: "map:" + tail, render: () => mapView(tail) };
+    case "path": return { tab: "map", key: "path:" + tail, render: () => mapView("", { path: tail }) };
+    case "learn": return { tab: "learn", key: "learn", render: learnView };
+    case "changes": return { tab: "changes", key: "changes", render: changesView };
+    case "review": return { tab: "review", key: "review", render: reviewView };
+    case "reports": return { tab: "reports", key: "reports", render: reportsView };
+    case "r": return { tab: "reports", key: "r:" + tail, render: () => reportView(tail) };
+    case "procedures": return { tab: "procedures", key: "procedures", render: proceduresView };
+    case "p": return { tab: "procedures", key: "p:" + tail, render: () => procedureView(tail) };
+    case "settings": return { tab: "settings", key: "settings", render: settingsView };
+    case "skills": return { tab: "skills", key: "skills", render: skillsView };
+    case "skill": return { tab: "skills", key: "skill:" + tail, render: () => skillView("skill", tail) };
+    case "agent": return { tab: "skills", key: "agent:" + tail, render: () => skillView("agent", tail) };
+    default: return { tab: "knowledge", key: "404", render: () => h("div", { class: "page" }, h("h1", {}, "Page not found"), h("p", {}, h("a", { href: "#/" }, "Go to knowledge"))) };
+  }
+}
+
+function updateChrome(tab) {
+  for (const a of document.querySelectorAll(".tabs a, .settings-link")) {
+    a.toggleAttribute("aria-current", a.dataset.tab === tab);
+    if (a.dataset.tab === tab) a.setAttribute("aria-current", "page");
+  }
+  const brand = document.querySelector(".brand");
+  brand.textContent = store.site.title || "rdstudio";
+  const review = reviewCount();
+  const rc = document.querySelector('[data-count="review"]');
+  rc.textContent = review || "";
+  rc.hidden = !review;
+  const reports = store.reports.length;
+  const rp = document.querySelector('[data-count="reports"]');
+  rp.textContent = reports || "";
+  rp.hidden = !reports;
+  menu.hidden = tab !== "knowledge";
+  document.querySelector('[data-tab="procedures"]').hidden = !procedures().length && tab !== "procedures";
+}
+
+async function route({ keepScroll = false } = {}) {
+  const next = parse();
+  if (current?.tab === "graph" && next.tab !== "graph") leaveGraph();
+  current?.node?.leave?.();
+  closeDrawer();
+  const scroll = keepScroll ? window.scrollY : 0;
+  const node = await next.render();
+  if (!keepScroll || current?.key !== next.key) {
+    view.replaceChildren(node);
+    window.scrollTo(0, scroll);
+  } else {
+    view.replaceChildren(node);
+    window.scrollTo(0, scroll);
+  }
+  current = { ...next, node };
+  updateChrome(next.tab);
+  renderDiagrams(view);
+}
+
+function closeDrawer() {
+  document.body.classList.remove("drawer-open");
+  menu.setAttribute("aria-expanded", "false");
+}
+
+menu.addEventListener("click", () => {
+  const open = !document.body.classList.contains("drawer-open");
+  document.body.classList.toggle("drawer-open", open);
+  menu.setAttribute("aria-expanded", String(open));
+});
+document.querySelector(".scrim").addEventListener("click", closeDrawer);
+
+// Full screen (hides the phone's status and navigation bars), where supported.
+const fullscreen = document.querySelector(".fullscreen");
+if (document.fullscreenEnabled && !matchMedia("(display-mode: fullscreen)").matches) {
+  fullscreen.hidden = false;
+  fullscreen.addEventListener("click", () => {
+    if (document.fullscreenElement) document.exitFullscreen();
+    else document.documentElement.requestFullscreen({ navigationUI: "hide" }).catch(() => {});
+  });
+  document.addEventListener("fullscreenchange", () => fullscreen.setAttribute("aria-pressed", String(!!document.fullscreenElement)));
+}
+document.addEventListener("keydown", (e) => { if (e.key === "Escape") closeDrawer(); });
+window.addEventListener("hashchange", () => route());
+
+async function refresh() {
+  // Live update: the graph merges new data in place; other views re-render keeping scroll.
+  if ((current?.tab === "graph" || current?.tab === "map") && current.node?.refresh) {
+    current.node.refresh();
+    updateChrome(current.tab);
+    return;
+  }
+  await route({ keepScroll: true });
+}
+
+try {
+  await load();
+  await loadLearner();
+  await route();
+  const live = document.querySelector(".live");
+  if (store.site.static) {
+    live.hidden = true; // an exported snapshot does not change
+  } else {
+    watch(refresh, (ok) => { live.classList.toggle("offline", !ok); live.textContent = ok ? "Live" : "Offline"; });
+  }
+} catch (err) {
+  view.replaceChildren(h("div", { class: "page" }, h("h1", {}, "The dashboard data could not be loaded"),
+    h("p", { class: "lede" }, "Run rdstudio build (or rdstudio serve) in the project, then reload this page."),
+    h("pre", {}, String(err))));
+}
+
+// The service worker is registered in index.html. The first time, hand it the
+// files this page loaded before it was in control, so the next visit is served
+// from the cache.
+if ("serviceWorker" in navigator && !navigator.serviceWorker.controller) {
+  navigator.serviceWorker.ready.then((reg) => reg.active?.postMessage({
+    warm: [location.href.split("#")[0], ...performance.getEntriesByType("resource").map((e) => e.name)],
+  }));
+}

rdstudio/web/fonts.css

@@ -0,0 +1,48 @@
+/* Every font the themes use. Browsers download a face only when a theme uses it. */
+
+@font-face { font-family: "Literata"; font-style: normal; font-weight: 200 900; font-display: swap;
+  src: url(vendor/fonts/literata-latin-opsz-normal.woff2) format("woff2-variations");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "Literata"; font-style: normal; font-weight: 200 900; font-display: swap;
+  src: url(vendor/fonts/literata-latin-ext-opsz-normal.woff2) format("woff2-variations");
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF; }
+@font-face { font-family: "Literata"; font-style: italic; font-weight: 200 900; font-display: swap;
+  src: url(vendor/fonts/literata-latin-opsz-italic.woff2) format("woff2-variations");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "Literata"; font-style: italic; font-weight: 200 900; font-display: swap;
+  src: url(vendor/fonts/literata-latin-ext-opsz-italic.woff2) format("woff2-variations");
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+1E00-1E9F, U+2113, U+A720-A7FF; }
+@font-face { font-family: "Atkinson"; font-style: normal; font-weight: 200 800; font-display: swap;
+  src: url(vendor/fonts/atkinson-hyperlegible-next-latin-wght-normal.woff2) format("woff2-variations");
+  unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "Atkinson"; font-style: normal; font-weight: 200 800; font-display: swap;
+  src: url(vendor/fonts/atkinson-hyperlegible-next-latin-ext-wght-normal.woff2) format("woff2-variations");
+  unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+1E00-1E9F, U+2113, U+A720-A7FF; }
+@font-face { font-family: "Atkinson"; font-style: italic; font-weight: 200 800; font-display: swap;
+  src: url(vendor/fonts/atkinson-hyperlegible-next-latin-wght-italic.woff2) format("woff2-variations"); }
+@font-face { font-family: "JetBrains Mono"; font-style: normal; font-weight: 100 800; font-display: swap;
+  src: url(vendor/fonts/jetbrains-mono-latin-wght-normal.woff2) format("woff2-variations"); unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "JetBrains Mono"; font-style: italic; font-weight: 100 800; font-display: swap;
+  src: url(vendor/fonts/jetbrains-mono-latin-wght-italic.woff2) format("woff2-variations"); unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "Source Serif 4"; font-style: normal; font-weight: 200 900; font-display: swap;
+  src: url(vendor/fonts/source-serif-4-latin-opsz-normal.woff2) format("woff2-variations"); unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "Source Serif 4"; font-style: italic; font-weight: 200 900; font-display: swap;
+  src: url(vendor/fonts/source-serif-4-latin-opsz-italic.woff2) format("woff2-variations"); unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "Source Sans 3"; font-style: normal; font-weight: 200 900; font-display: swap;
+  src: url(vendor/fonts/source-sans-3-latin-wght-normal.woff2) format("woff2-variations"); unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "Source Sans 3"; font-style: italic; font-weight: 200 900; font-display: swap;
+  src: url(vendor/fonts/source-sans-3-latin-wght-italic.woff2) format("woff2-variations"); unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "Inter"; font-style: normal; font-weight: 100 900; font-display: swap;
+  src: url(vendor/fonts/inter-latin-opsz-normal.woff2) format("woff2-variations"); unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "Inter"; font-style: italic; font-weight: 100 900; font-display: swap;
+  src: url(vendor/fonts/inter-latin-opsz-italic.woff2) format("woff2-variations"); unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "IBM Plex Sans"; font-style: normal; font-weight: 100 700; font-display: swap;
+  src: url(vendor/fonts/ibm-plex-sans-latin-wght-normal.woff2) format("woff2-variations"); unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "IBM Plex Sans"; font-style: italic; font-weight: 100 700; font-display: swap;
+  src: url(vendor/fonts/ibm-plex-sans-latin-wght-italic.woff2) format("woff2-variations"); unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "IBM Plex Mono"; font-style: normal; font-weight: 400; font-display: swap;
+  src: url(vendor/fonts/ibm-plex-mono-latin-400-normal.woff2) format("woff2"); unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "IBM Plex Mono"; font-style: normal; font-weight: 600; font-display: swap;
+  src: url(vendor/fonts/ibm-plex-mono-latin-600-normal.woff2) format("woff2"); unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD; }
+@font-face { font-family: "Caveat"; font-style: normal; font-weight: 400 700; font-display: swap;
+  src: url(vendor/fonts/caveat-latin-wght-normal.woff2) format("woff2-variations"); }

rdstudio/web/index.html

@@ -0,0 +1,109 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover">
+<title>rdstudio</title>
+<link rel="manifest" href="manifest.webmanifest" crossorigin="use-credentials">
+<meta name="theme-color" content="#141a20">
+<meta name="mobile-web-app-capable" content="yes">
+<meta name="apple-mobile-web-app-capable" content="yes">
+<meta name="apple-mobile-web-app-status-bar-style" content="black-translucent">
+<link rel="apple-touch-icon" href="icon-192.png">
+<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' rx='7' fill='%235646c0'/%3E%3Ccircle cx='11' cy='12' r='3.2' fill='%23f4f6f2'/%3E%3Ccircle cx='22' cy='10' r='2.4' fill='%23f4f6f2'/%3E%3Ccircle cx='19' cy='22' r='3.6' fill='%23f4f6f2'/%3E%3Cpath d='M11 12 22 10M11 12l8 10M22 10l-3 12' stroke='%23f4f6f2' stroke-width='1.4'/%3E%3C/svg%3E">
+<script>
+  // Instant reopening and offline reading (sw.js), registered before anything
+  // else loads so it installs even when a file fails. Browsers allow it only
+  // on https or localhost; everything works without it. ?nosw skips it.
+  (function () {
+    if (!("serviceWorker" in navigator) || new URLSearchParams(location.search).has("nosw")) return;
+    var had = Boolean(navigator.serviceWorker.controller);
+    (function register(tries) {
+      navigator.serviceWorker.register("sw.js").catch(function () {
+        if (tries < 3) setTimeout(function () { register(tries + 1); }, 800);
+      });
+    })(0);
+    // A new rdstudio took over just as this page opened: show the new version.
+    navigator.serviceWorker.addEventListener("controllerchange", function () {
+      if (had && performance.now() < 10000) location.reload();
+    });
+    // Tunnels sometimes drop a request (a 504). If a script or style fails,
+    // reload once, when the service worker (which retries) is ready or after
+    // a few seconds without it.
+    var failed = false;
+    addEventListener("error", function (e) {
+      var t = e.target;
+      if (failed || !t || !/^(SCRIPT|LINK)$/.test(t.tagName)) return;
+      var last = Number(sessionStorage.getItem("rdstudio.retry") || 0);
+      if (Date.now() - last < 30000) return; // tried already: show the error instead
+      failed = true;
+      sessionStorage.setItem("rdstudio.retry", String(Date.now()));
+      var wait = new Promise(function (r) { setTimeout(r, 4000); });
+      Promise.race([navigator.serviceWorker.ready, wait]).then(function () { location.reload(); });
+    }, true);
+  })();
+</script>
+<link rel="stylesheet" href="vendor/katex/katex.min.css">
+<link id="code-light" rel="stylesheet" href="vendor/hljs/github.min.css" media="(prefers-color-scheme: light)">
+<link id="code-dark" rel="stylesheet" href="vendor/hljs/github-dark.min.css" media="(prefers-color-scheme: dark)">
+<link id="theme-css" rel="stylesheet" href="themes/studio.css">
+<script>
+  // Apply the saved theme before first paint (see js/settings.js).
+  (function () {
+    try {
+      var themes = ["studio", "notebook", "map", "space", "cyber"];
+      var former = { notebook: "studio", journal: "studio", modern: "studio", blueprint: "map", terminal: "cyber" };
+      var theme = localStorage.getItem("rdstudio.look") || former[localStorage.getItem("rdstudio.theme")];
+      var mode = localStorage.getItem("rdstudio.mode");
+      if (themes.indexOf(theme) > 0) document.getElementById("theme-css").href = "themes/" + theme + ".css";
+      if (mode === "light" || mode === "dark") {
+        document.documentElement.dataset.mode = mode;
+        document.getElementById("code-light").media = mode === "light" ? "all" : "not all";
+        document.getElementById("code-dark").media = mode === "dark" ? "all" : "not all";
+      }
+    } catch (e) { /* storage unavailable: defaults apply */ }
+  })();
+</script>
+<link rel="stylesheet" href="style.css">
+</head>
+<body>
+<header class="bar">
+  <button class="menu" type="button" aria-label="Show contents" aria-expanded="false">
+    <svg width="18" height="18" viewBox="0 0 18 18" aria-hidden="true"><path d="M2 4h14M2 9h14M2 14h14" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"/></svg>
+  </button>
+  <a class="brand" href="#/">rdstudio</a>
+  <nav class="tabs" aria-label="Sections">
+    <a href="#/" data-tab="knowledge">Knowledge</a>
+    <a href="#/map" data-tab="map">Map</a>
+    <a href="#/graph" data-tab="graph">Graph</a>
+    <a href="#/learn" data-tab="learn">Learn</a>
+    <a href="#/changes" data-tab="changes">Changes</a>
+    <a href="#/review" data-tab="review">Review <span class="count" data-count="review"></span></a>
+    <a href="#/reports" data-tab="reports">Reports <span class="count" data-count="reports"></span></a>
+    <a href="#/procedures" data-tab="procedures" hidden>Procedures</a>
+    <a href="#/skills" data-tab="skills">Skills &amp; agents</a>
+  </nav>
+  <span class="live" title="The page refreshes when files change">Live</span>
+  <button class="fullscreen" type="button" aria-label="Full screen" aria-pressed="false" title="Full screen" hidden>
+    <svg width="17" height="17" viewBox="0 0 24 24" aria-hidden="true"><path fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" stroke-linejoin="round" d="M4 9V4h5M15 4h5v5M20 15v5h-5M9 20H4v-5"/></svg>
+  </button>
+  <a class="settings-link" href="#/settings" data-tab="settings" aria-label="Settings">
+    <svg width="17" height="17" viewBox="0 0 24 24" aria-hidden="true"><path fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round" d="M4 7h10M18 7h2M4 17h4M12 17h8"/><circle cx="16" cy="7" r="2.2" fill="none" stroke="currentColor" stroke-width="1.8"/><circle cx="10" cy="17" r="2.2" fill="none" stroke="currentColor" stroke-width="1.8"/></svg>
+    <span>Settings</span>
+  </a>
+</header>
+<div class="scrim"></div>
+<main id="view" tabindex="-1"></main>
+
+<script src="vendor/markdown-it.min.js"></script>
+<script src="vendor/markdown-it-footnote.min.js"></script>
+<script src="vendor/katex/katex.min.js"></script>
+<script src="vendor/texmath.js"></script>
+<script src="vendor/hljs/highlight.min.js"></script>
+<script src="vendor/hljs/latex.min.js"></script>
+<script src="vendor/hljs/julia.min.js"></script>
+<script src="vendor/hljs/matlab.min.js"></script>
+<script src="vendor/d3.min.js"></script>
+<script type="module" src="app.js"></script>
+</body>
+</html>