feat(handoff): create a standalone report from a chat session

.gitattributes

@@ -0,0 +1 @@
+pkg-r/tests/testthat/_snaps/*.md whitespace=-blank-at-eof

.github/workflows/js-check.yml

@@ -1,21 +1,55 @@
-name: Check - Shared Viz Assets
+name: Check - Shared Web Assets
 
 on:
   workflow_dispatch:
   push:
     branches: ["main", "rc-*"]
     paths:
       - "js/**"
+      - "pkg-py/src/querychat/static/css/handoff.css"
       - "pkg-py/src/querychat/static/css/viz.css"
+      - "pkg-py/src/querychat/static/img/handoff-language-python.svg"
+      - "pkg-py/src/querychat/static/img/handoff-language-r.svg"
+      - "pkg-py/src/querychat/static/js/handoff.js"
+      - "pkg-py/src/querychat/static/js/schema-display.js"
       - "pkg-py/src/querychat/static/js/viz.js"
+      - "pkg-r/inst/htmldep/handoff.css"
+      - "pkg-r/inst/htmldep/handoff.js"
+      - "pkg-r/inst/htmldep/img/handoff-language-python.svg"
+      - "pkg-r/inst/htmldep/img/handoff-language-r.svg"
+      - "pkg-r/inst/htmldep/schema-display.js"
+      - "pkg-r/inst/htmldep/viz.css"
+      - "pkg-r/inst/htmldep/viz.js"
+      - "shared/handoff-formats.yml"
+      - "shared/img/handoff-language-python.svg"
+      - "shared/img/handoff-language-r.svg"
+      - "pkg-py/src/querychat/handoff-formats.yml"
+      - "pkg-r/inst/handoff-formats.yml"
       - "Makefile"
       - ".github/workflows/js-check.yml"
   pull_request:
     types: [opened, synchronize, reopened, ready_for_review]
     paths:
       - "js/**"
+      - "pkg-py/src/querychat/static/css/handoff.css"
       - "pkg-py/src/querychat/static/css/viz.css"
+      - "pkg-py/src/querychat/static/img/handoff-language-python.svg"
+      - "pkg-py/src/querychat/static/img/handoff-language-r.svg"
+      - "pkg-py/src/querychat/static/js/handoff.js"
+      - "pkg-py/src/querychat/static/js/schema-display.js"
       - "pkg-py/src/querychat/static/js/viz.js"
+      - "pkg-r/inst/htmldep/handoff.css"
+      - "pkg-r/inst/htmldep/handoff.js"
+      - "pkg-r/inst/htmldep/img/handoff-language-python.svg"
+      - "pkg-r/inst/htmldep/img/handoff-language-r.svg"
+      - "pkg-r/inst/htmldep/schema-display.js"
+      - "pkg-r/inst/htmldep/viz.css"
+      - "pkg-r/inst/htmldep/viz.js"
+      - "shared/handoff-formats.yml"
+      - "shared/img/handoff-language-python.svg"
+      - "shared/img/handoff-language-r.svg"
+      - "pkg-py/src/querychat/handoff-formats.yml"
+      - "pkg-r/inst/handoff-formats.yml"
       - "Makefile"
       - ".github/workflows/js-check.yml"
 

CLAUDE.md

@@ -188,7 +188,8 @@ The package has deprecated the old functional API (`querychat_init()`, `querycha
 1. Always test changes with both R and Python implementations to maintain consistency
 2. Use the provided Make commands for development tasks
 3. Follow the existing code style (ruff for Python, `air format .` for R)
-4. Ask before running tests (the user may want to run them themselves)
+4. Run normal local tests and checks autonomously. Ask first only for destructive,
+   external, or unusually expensive commands.
 5. Update documentation when adding new features
 6. Always ask about file names before writing any new code
 7. Always pay attention to your working directory when running commands, especially when working in a sub-package.

js/build.mjs

@@ -24,6 +24,14 @@ const jsTargets = [
     source: "src/viz.ts",
     output: "../pkg-r/inst/htmldep/viz.js",
   },
+  {
+    source: "src/handoff.ts",
+    output: "../pkg-py/src/querychat/static/js/handoff.js",
+  },
+  {
+    source: "src/handoff.ts",
+    output: "../pkg-r/inst/htmldep/handoff.js",
+  },
   {
     source: "src/schema-display.js",
     output: "../pkg-py/src/querychat/static/js/schema-display.js",
@@ -43,6 +51,43 @@ const cssTargets = [
     source: "src/viz.css",
     output: "../pkg-r/inst/htmldep/viz.css",
   },
+  {
+    source: "src/handoff.css",
+    output: "../pkg-py/src/querychat/static/css/handoff.css",
+  },
+  {
+    source: "src/handoff.css",
+    output: "../pkg-r/inst/htmldep/handoff.css",
+    transform: (source) =>
+      source.replaceAll("../img/handoff-language-", "img/handoff-language-"),
+  },
+];
+
+const rawTargets = [
+  {
+    source: "../shared/img/handoff-language-python.svg",
+    output: "../pkg-py/src/querychat/static/img/handoff-language-python.svg",
+  },
+  {
+    source: "../shared/img/handoff-language-python.svg",
+    output: "../pkg-r/inst/htmldep/img/handoff-language-python.svg",
+  },
+  {
+    source: "../shared/img/handoff-language-r.svg",
+    output: "../pkg-py/src/querychat/static/img/handoff-language-r.svg",
+  },
+  {
+    source: "../shared/img/handoff-language-r.svg",
+    output: "../pkg-r/inst/htmldep/img/handoff-language-r.svg",
+  },
+  {
+    source: "../shared/handoff-formats.yml",
+    output: "../pkg-py/src/querychat/handoff-formats.yml",
+  },
+  {
+    source: "../shared/handoff-formats.yml",
+    output: "../pkg-r/inst/handoff-formats.yml",
+  },
 ];
 
 const ensureParentDir = async (relativePath) => {
@@ -51,7 +96,7 @@ const ensureParentDir = async (relativePath) => {
   return absolutePath;
 };
 
-export const assetTargets = [...cssTargets, ...jsTargets];
+export const assetTargets = [...cssTargets, ...jsTargets, ...rawTargets];
 
 export const resolveOutputPath = (baseDir, relativePath) =>
   path.resolve(baseDir, path.relative(repoDir, path.resolve(rootDir, relativePath)));
@@ -65,10 +110,11 @@ const findMissingSources = async (targets) => {
   const missingSources = [];
 
   for (const source of uniqueSources(targets)) {
+    const sourcePath = path.resolve(rootDir, source);
     try {
-      await access(path.resolve(rootDir, source));
+      await access(sourcePath);
     } catch {
-      missingSources.push(`js/${source}`);
+      missingSources.push(path.relative(repoDir, sourcePath));
     }
   }
 
@@ -78,8 +124,13 @@ const findMissingSources = async (targets) => {
 const reportMissingSources = async () => {
   const missingCssSources = await findMissingSources(cssTargets);
   const missingJsSources = await findMissingSources(jsTargets);
+  const missingRawSources = await findMissingSources(rawTargets);
 
-  if (missingCssSources.length === 0 && missingJsSources.length === 0) {
+  if (
+    missingCssSources.length === 0 &&
+    missingJsSources.length === 0 &&
+    missingRawSources.length === 0
+  ) {
     return;
   }
 
@@ -93,6 +144,10 @@ const reportMissingSources = async () => {
     messages.push(`Missing JS source files:\n- ${missingJsSources.join("\n- ")}`);
   }
 
+  if (missingRawSources.length > 0) {
+    messages.push(`Missing raw source files:\n- ${missingRawSources.join("\n- ")}`);
+  }
+
   throw new Error(messages.join("\n\n"));
 };
 
@@ -101,8 +156,9 @@ export const stageBuildOutputs = async (stageDir) => {
     const cssSourcePath = path.resolve(rootDir, target.source);
     const cssSource = await readFile(cssSourcePath, "utf8");
     const outputPath = resolveOutputPath(stageDir, target.output);
+    const outputSource = target.transform ? target.transform(cssSource) : cssSource;
     await mkdir(path.dirname(outputPath), { recursive: true });
-    await writeFile(outputPath, `${banner(target.source)}${cssSource}`, "utf8");
+    await writeFile(outputPath, `${banner(target.source)}${outputSource}`, "utf8");
   }
 
   for (const target of jsTargets) {
@@ -121,6 +177,13 @@ export const stageBuildOutputs = async (stageDir) => {
       },
     });
   }
+
+  for (const target of rawTargets) {
+    const sourcePath = path.resolve(rootDir, target.source);
+    const outputPath = resolveOutputPath(stageDir, target.output);
+    await mkdir(path.dirname(outputPath), { recursive: true });
+    await copyFile(sourcePath, outputPath);
+  }
 };
 
 export const commitBuildOutputs = async (stageDir) => {

js/check.mjs

@@ -75,7 +75,7 @@ await withStagedBuild(async (stageDir) => {
 });
 
 if (staleOutputs.length > 0) {
-  console.error("Generated web assets are out of sync. Run `make js-build`.");
+  console.error("Generated shared assets are out of sync. Run `make js-build`.");
   for (const outputPath of staleOutputs) {
     console.error(`- ${outputPath}`);
   }