paperlint 13.3.1 → 13.4.0

package/dist/domain/repro-layout.d.ts.map

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

package/dist/domain/repro-layout.js

@@ -13,7 +13,7 @@
  *   ├── tools/                 scripts used across the paper (numbers, figures, anonymity check, harnesses)
  *   └── data/                  shared data (tables, caches)
  *
- * plus `.gitignore`. A loose note belongs in its study's folder or in the paper's `research/`.
+ * plus `.gitignore`, and optionally the agent instruction files `CLAUDE.md` and `AGENTS.md`. A loose note belongs in its study's folder or in the paper's `research/`.
  *
  * ── A STUDY'S NAME ───────────────────────────────────────────────────────────────
  * `<id>-<slug>` (`P1-S03-baseline`): the id of the study's row in `repro/studies.json` — the paper's
@@ -51,6 +51,14 @@ export const REPRO_FILE_NOTES = [
         note: "the study registry: id, title, status and result of each study",
     },
     { name: ".gitignore", note: "keeps the scripts' byproducts out of git" },
+    {
+        name: "CLAUDE.md",
+        note: "optional: instructions an agent loads when it works in repro/",
+    },
+    {
+        name: "AGENTS.md",
+        note: "optional: the same, for agents that read AGENTS.md",
+    },
 ];
 export const REPRO_FILES = REPRO_FILE_NOTES.map((f) => f.name);
 /** The shared folders `repro/` may hold besides its study folders. */

package/dist/domain/repro-layout.js.map

@@ -1 +1 @@
-{"version":3,"file":"repro-layout.js","sourceRoot":"","sources":["../../src/domain/repro-layout.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"repro-layout.js","sourceRoot":"","sources":["../../src/domain/repro-layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAiB,MAAM,kBAAkB,CAAC;AAEnE,kEAAkE;AAClE,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC;AAEjC,iFAAiF;AACjF,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,MAAM,GAAG,WAAW,CAAC;AAElC,6DAA6D;AAC7D,MAAM,CAAC,MAAM,gBAAgB,GAGvB;IACJ;QACE,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,4DAA4D;KACnE;IACD;QACE,IAAI,EAAE,YAAY;QAClB,IAAI,EAAE,gEAAgE;KACvE;IACD,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,0CAA0C,EAAE;IACxE;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,+DAA+D;KACtE;IACD;QACE,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,oDAAoD;KAC3D;CACF,CAAC;AACF,MAAM,CAAC,MAAM,WAAW,GAAsB,gBAAgB,CAAC,GAAG,CAChE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CACd,CAAC;AAEF,sEAAsE;AACtE,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC;AACjC,MAAM,CAAC,MAAM,QAAQ,GAAG,MAAM,CAAC;AAC/B,MAAM,CAAC,MAAM,eAAe,GAGtB;IACJ;QACE,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,8EAA8E;KACrF;IACD,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,8BAA8B,EAAE;CACzD,CAAC;AACF,MAAM,CAAC,MAAM,UAAU,GAAsB,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAEhF,iGAAiG;AACjG,MAAM,UAAU,GAAa;IAC3B,IAAI,EAAE,cAAc;IACpB,IAAI,EAAE,mFAAmF;IACzF,QAAQ,EAAE;QACR,IAAI,CAAC,MAAM,EAAE,sDAAsD,CAAC;KACrE;CACF,CAAC;AAEF,8CAA8C;AAC9C,MAAM,CAAC,MAAM,WAAW,GAAwB;IAC9C,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACpD,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;IACzD,UAAU;CACX,CAAC;AAEF,iGAAiG;AACjG,MAAM,CAAC,MAAM,iBAAiB,GAAW,UAAU,CACjD,GAAG,SAAS,GAAG,EACf,WAAW,CACZ,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAsB;IACjD,aAAa;IACb,eAAe;IACf,aAAa;IACb,aAAa;IACb,oBAAoB;IACpB,cAAc;IACd,OAAO;IACP,WAAW;IACX,WAAW;CACZ,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,MAAM,UAAU,GAAG,6BAA6B,CAAC;AAExD,+FAA+F;AAC/F,MAAM,UAAU,GAAG,4DAA4D,CAAC;AAEhF,6FAA6F;AAC7F,MAAM,qBAAqB,GACzB,oDAAoD,CAAC;AAEvD,0FAA0F;AAC1F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAY,EAAW,EAAE,CAC7D,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEnC,MAAM,UAAU,GAAG,CAAC,CAAS,EAAW,EAAE,CACxC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;AAElD,gDAAgD;AAChD,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CAC9C,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAE5E,sGAAsG;AACtG,SAAS,gBAAgB,CAAC,IAAY;IACpC,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,OAAO,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7E,CAAC;AAED,8GAA8G;AAC9G,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE,CACnD,qBAAqB,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,IAAI,GAAG,IAAI;SACd,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC5B,IAAI,gBAAgB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC;AAC7C,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,IAAI,GAAG,IAAI;SACd,WAAW,EAAE;SACb,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;SAC5B,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,OAAO,CAAC,iCAAiC,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,MAAM,iBAAiB,GAAsB;IAClD,KAAK;IACL,QAAQ;IACR,KAAK;IACL,OAAO;IACP,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,IAAI;IACJ,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;CACP,CAAC;AAEF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAsB;IAC3C,UAAU;IACV,YAAY;IACZ,kBAAkB;IAClB,gBAAgB;IAChB,SAAS;IACT,cAAc;IACd,mBAAmB;CACpB,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,eAAe,GAAsB;IAChD,MAAM;IACN,MAAM;IACN,OAAO;IACP,QAAQ;IACR,SAAS;IACT,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,UAAU;IACV,SAAS;IACT,KAAK;IACL,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;CACP,CAAC;AAEF,gCAAgC;AAChC,MAAM,CAAC,MAAM,eAAe,GAAsB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;AAEvE,2BAA2B;AAC3B,MAAM,CAAC,MAAM,WAAW,GACtB,uKAAuK,CAAC;AAE1K,uBAAuB;AACvB,MAAM,CAAC,MAAM,SAAS,GACpB,oIAAoI,CAAC;AAEvI,yBAAyB;AACzB,MAAM,CAAC,MAAM,SAAS,GACpB,sJAAsJ,CAAC;AAEzJ,2CAA2C;AAC3C,MAAM,CAAC,MAAM,iBAAiB,GAC5B,+KAA+K,CAAC;AAElL,mGAAmG;AACnG,MAAM,CAAC,MAAM,WAAW,GAGlB;IACJ;QACE,IAAI,EAAE,uBAAuB;QAC7B,IAAI,EAAE,0NAA0N;KACjO;IACD;QACE,IAAI,EAAE,iBAAiB;QACvB,IAAI,EAAE,oJAAoJ;KAC3J;IACD;QACE,IAAI,EAAE,kCAAkC;QACxC,IAAI,EAAE,uKAAuK;KAC9K;CACF,CAAC;AAEF,uFAAuF;AACvF,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACvD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IACxC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC9D,OAAO,WAAW,CAAC;IACrB,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACpD,IAAI,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACpD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE,CAC1C,uBAAuB,aAAa,CAAC,IAAI,CAAC,kCAAkC,YAAY,4KAA4K,kBAAkB,CAAC,IAAI,CAAC,qIAAqI,IAAI,iJAAiJ,CAAC;AAmBzjB,MAAM,SAAS,GAAG,CAAC,CAAa,EAAW,EAAE,CAC3C,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IACjC,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM;QAChB,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9B,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAE1D,gEAAgE;AAChE,SAAS,UAAU,CAAC,CAAa;IAC/B,MAAM,IAAI,GAAG,GAAG,SAAS,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACpE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;QACf,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;SAC/D,CAAC;IACJ,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACzD,OAAO;YACL,IAAI;YACJ,OAAO,EAAE,WAAW;YACpB,IAAI,EAAE,OAAO,IAAI,GAAG,MAAM,8FAA8F,YAAY,EAAE;SACvI,CAAC;IACJ,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0GAA0G;AAC1G,MAAM,UAAU,UAAU,CACxB,OAA8B;IAE9B,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAqB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,CAAe;IAC1C,MAAM,IAAI,GACR,CAAC,CAAC,OAAO,KAAK,OAAO;QACnB,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,2KAA2K,CAAC,CAAC,IAAI,GAAG;QACjM,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,kCAAkC,MAAM,oDAAoD,CAAC,CAAC,IAAI,GAAG,CAAC;IACvH,OAAO;QACL,IAAI;QACJ,iIAAiI;QACjI,iBAAiB;QACjB,qHAAqH;KACtH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/skills/build-label-page/scripts/label-page-core.d.ts

@@ -19,6 +19,9 @@ type SchemaNode = {
 } | {
     kind: "integer";
     required: boolean;
+} | {
+    kind: "boolean";
+    required: boolean;
 } | {
     kind: "array";
     required: boolean;
@@ -69,6 +72,7 @@ interface Config {
     readonly seed: number;
     readonly groups: Readonly<Record<string, string>>;
     readonly labeller_knows?: readonly string[];
+    readonly familiarity?: boolean;
     readonly familiarity_question?: string;
     readonly questions: readonly Question[];
     readonly practice: readonly Practice[];

package/docs/layout.md

@@ -72,6 +72,8 @@ creates one.
     │   ├── README.md                  ← the index: one line per study, generated from studies.json
     │   ├── studies.json               ← the study registry: id, title, status and result of each study
     │   ├── .gitignore                 ← keeps the scripts' byproducts out of git
+    │   ├── CLAUDE.md                  ← optional: instructions an agent loads when it works in repro/
+    │   ├── AGENTS.md                  ← optional: the same, for agents that read AGENTS.md
     │   ├── tools/                     ← scripts used across the paper (numbers, figures, anonymity check, harnesses)
     │   ├── data/                      ← shared data (tables, caches)
     │   └── <id>-<slug>/               ← one folder per study or spike, named by its row in studies.json (P1-S03-baseline)

package/docs/rules/paper/allowed-files-only.md

@@ -37,6 +37,8 @@ it: [the map](../../layout.md).
 │   ├── README.md                  ← the index: one line per study, generated from studies.json
 │   ├── studies.json               ← the study registry: id, title, status and result of each study
 │   ├── .gitignore                 ← keeps the scripts' byproducts out of git
+│   ├── CLAUDE.md                  ← optional: instructions an agent loads when it works in repro/
+│   ├── AGENTS.md                  ← optional: the same, for agents that read AGENTS.md
 │   ├── tools/                     ← scripts used across the paper (numbers, figures, anonymity check, harnesses)
 │   ├── data/                      ← shared data (tables, caches)
 │   └── <id>-<slug>/               ← one folder per study or spike, named by its row in studies.json (P1-S03-baseline)

package/docs/rules/repro/allowed-files-only.md

@@ -19,6 +19,8 @@ repro/
 ├── README.md      ← the index: one line per study, generated from studies.json
 ├── studies.json   ← the study registry: id, title, status and result of each study
 ├── .gitignore     ← keeps the scripts' byproducts out of git
+├── CLAUDE.md      ← optional: instructions an agent loads when it works in repro/
+├── AGENTS.md      ← optional: the same, for agents that read AGENTS.md
 ├── tools/         ← scripts used across the paper (numbers, figures, anonymity check, harnesses)
 ├── data/          ← shared data (tables, caches)
 └── <id>-<slug>/   ← one folder per study or spike, named by its row in studies.json (P1-S03-baseline)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "paperlint",
-  "version": "13.3.1",
+  "version": "13.4.0",
   "description": "A linter for scientific papers written in LaTeX: catches mistakes before you submit to a conference or journal.",
   "type": "module",
   "license": "MIT",

package/skills/assess-novelty/scripts/candidate_page.test.ts

@@ -26,42 +26,11 @@ import assert from "node:assert/strict";
 const here = dirname(fileURLToPath(import.meta.url));
 const TOOL = join(here, "candidate_page.ts");
 const FIXTURE = join(here, "fixtures", "novelty");
-// playwright-core is what package.json declares; the browser is whichever chromiumPath() finds (CHROMIUM_PATH, a
-// build in PLAYWRIGHT_BROWSERS_PATH, or the Chrome a GitHub runner ships), so nothing is downloaded.
 import { chromium } from "playwright-core";
-import { existsSync, readdirSync } from "node:fs";
+import { chromiumPath } from "../../../test/chromium.ts";
 import { test } from "vitest";
 
 test("candidate_page", async () => {
-  const BROWSERS_DIR =
-    process.env.PLAYWRIGHT_BROWSERS_PATH || "/opt/pw-browsers";
-  const SYSTEM_CHROME = [
-    "/usr/bin/google-chrome",
-    "/usr/bin/google-chrome-stable",
-    "/usr/bin/chromium",
-    "/usr/bin/chromium-browser",
-    "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome", // the macOS runner's Chrome
-  ];
-  const chromiumPath = (): string => {
-    const builds = existsSync(BROWSERS_DIR)
-      ? readdirSync(BROWSERS_DIR)
-          .filter((d) => /^chromium-\d+$/.test(d))
-          .sort((a, b) => Number(b.split("-")[1]) - Number(a.split("-")[1]))
-          .flatMap((d) =>
-            ["chrome-linux64", "chrome-linux"].map((sub) =>
-              join(BROWSERS_DIR, d, sub, "chrome"),
-            ),
-          )
-      : [];
-    const found = [process.env.CHROMIUM_PATH, ...builds, ...SYSTEM_CHROME].find(
-      (p) => p && existsSync(p),
-    );
-    if (!found)
-      throw new Error(
-        `no Chromium: set CHROMIUM_PATH, or install one in ${BROWSERS_DIR} or ${SYSTEM_CHROME[0]}`,
-      );
-    return found;
-  };
   // A 1x1 PNG, enough for an <img> to load.
   const PNG = Buffer.from(
     "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==",

package/skills/build-label-page/SKILL.md

@@ -4,7 +4,7 @@ description: Build a phone labelling page published as a claude.ai Artifact with
 allowed-tools: [Read, Write, Edit, Grep, Glob, Bash, Artifact, ArtifactData]
 ---
 
-<!-- vigiles:sha256:6323fa135f385e8b compiled from skills/build-label-page/SKILL.md.spec.ts -->
+<!-- vigiles:sha256:bd616b2694831fa1 compiled from skills/build-label-page/SKILL.md.spec.ts -->
 
 # build-label-page — a page the person labels on a phone, and the labels back in the repo
 
@@ -63,7 +63,8 @@ building. In one line each:
    source labels on the page. The generator refuses to build when an item carries a field outside an
    allow-list; a page written by hand checks its items against the same list.
 5. **Ask only what the labeller can answer.** Only the languages and tools they know; one "how well do
-   you know it" question per group, used later as an analysis filter; "clear-cut or real boundary"
+   you know it" question per group, used later as an analysis filter (off on an approval page,
+   `"familiarity": false`: the author has not seen those repositories); "clear-cut or real boundary"
    is the labeller's judgement, not the designer's.
 6. **Export into the repository right away**, one JSON per page into the study's `data/` with the
    export date, commit it, and record answers given in chat with `source: "chat"`. If the page fails,

package/skills/build-label-page/SKILL.md.spec.ts

@@ -74,7 +74,8 @@ building. In one line each:
    source labels on the page. The generator refuses to build when an item carries a field outside an
    allow-list; a page written by hand checks its items against the same list.
 5. **Ask only what the labeller can answer.** Only the languages and tools they know; one "how well do
-   you know it" question per group, used later as an analysis filter; "clear-cut or real boundary"
+   you know it" question per group, used later as an analysis filter (off on an approval page,
+   \`"familiarity": false\`: the author has not seen those repositories); "clear-cut or real boundary"
    is the labeller's judgement, not the designer's.
 6. **Export into the repository right away**, one JSON per page into the study's \`data/\` with the
    export date, commit it, and record answers given in chat with \`source: "chat"\`. If the page fails,

package/skills/build-label-page/references/checklist.md

@@ -83,7 +83,9 @@ the text of an allowed field says.
   other groups are not put on the page and get no id.
 - Add one question per group, "how well do you know this language / tool" (well / somewhat / not
   really). It is an analysis filter: the study can report the labels with and without the groups
-  the labeller does not know well.
+  the labeller does not know well. An approval page asks none (`"familiarity": false` in
+  `items.json`): its question is about a drawn unit, not about repositories the author has seen,
+  and an answer to "how well do you know the projects of this group" there means nothing.
 - The per-item judgement "clear-cut or a real boundary case" is the labeller's. The study design
   does not decide it in advance and does not pre-fill it.
 
@@ -92,7 +94,7 @@ answer is the only way to find it afterwards. And a boundary case is boundary be
 person hesitates; a designer who tags it in advance has measured the design, not the item.
 
 **Check.** The build prints how many items were left out; the export has a familiarity value for
-every group.
+every group, or the page was built with `"familiarity": false` and the export has no groups.
 
 ## 6. Export into the repository right away
 

package/skills/build-label-page/references/closed-choice-generator.md

@@ -42,7 +42,9 @@ length.
 - **`seed`**: fixes the order. Rebuilding with the same seed keeps every id, and a new item gets the
   next one; a different seed is refused once a key exists.
 - **`ask_why`** on an option: a prompt. That answer is incomplete, on the page and in the export,
-  until a reason is saved.
+  until a reason is saved. The reason saves as it is typed (after a pause, and when the page is
+  left), so a labeller who closes the page from inside the box does not leave a drop without its
+  reason; a store echo while typing keeps the box and its focus.
 
 ## The approval page
 
@@ -73,8 +75,15 @@ drop, the drop carrying `ask_why`.
 }
 ```
 
-The items are the drawn units verbatim. The practice is three units whose fate is obvious. Each
-dropped unit carries its reason in the labels file. The author's words, with the date, then go into
+The page sets `"familiarity": false`: the author is judging drawn units, not repositories they
+have seen, so the per-group "how well do you know it" question is left out (and a
+`familiarity_question` beside it is refused).
+
+The items are the drawn units verbatim, in a language the author reads. Units in other languages
+are taken out before the draw, as a population rule the study's `plan.json` states ("English-language
+units only") with the number excluded reported in the paper; a unit dropped at approval because the
+author cannot read it is an exclusion made after the draw and goes unrecorded. The practice is three
+units whose fate is obvious. Each dropped unit carries its reason in the labels file. The author's words, with the date, then go into
 `author_check` of the plan; a dropped unit is replaced by the next one in the draw.
 
 ## The export

package/skills/build-label-page/scripts/label-page-browser.test.ts

@@ -0,0 +1,187 @@
+/**
+ * The generator's page in a real Chromium, against a stand-in store whose writes come back as a
+ * snapshot a moment later (as the claude.ai store does). What the fake DOM of label-page-html.test.ts
+ * cannot show: focus, typing, and a page that is left without the box ever losing focus.
+ */
+import assert from "node:assert/strict";
+import { chromium, type Page } from "playwright-core";
+import { test } from "vitest";
+import { z } from "zod";
+import { chromiumPath } from "../../../test/chromium.ts";
+import {
+  APPROVAL_PRACTICE,
+  approval,
+  build,
+  setup,
+} from "../../../test/label-page-kit.ts";
+
+/** A store that keeps every write and echoes it back as a snapshot after `echoMs`. */
+const STORE = (practice: Record<string, unknown>, echoMs: number): string => `
+  window.__writes = [];
+  (function () {
+    var docs = { answers: {}, groups: {}, practice: ${JSON.stringify(practice)} };
+    var subs = {};
+    function snap(n) {
+      (subs[n] || []).forEach(function (cb) {
+        cb({ docs: Object.keys(docs[n]).map(function (id) { return { id: id, data: function () { return docs[n][id]; } }; }) });
+      });
+    }
+    var db = { collection: function (n) { return {
+      onSnapshot: function (cb) { (subs[n] = subs[n] || []).push(cb); snap(n); },
+      doc: function (id) { return { set: function (body) {
+        window.__writes.push(body);
+        docs[n][id] = body;
+        return new Promise(function (r) { setTimeout(function () { r(); snap(n); }, ${String(echoMs)}); });
+      } }; }
+    }; } };
+    window.claude = { use: function () { return Promise.resolve(db); } };
+  })();`;
+
+const PRACTICE_DONE = Object.fromEntries(
+  APPROVAL_PRACTICE.map((p, n) => [
+    `r1-P${String(n + 1)}`,
+    { answers: p.expected, source: "page" },
+  ]),
+);
+
+/** Every document the page wrote, in order, read back as JSON (the stand-in store keeps them). */
+const Writes = z.array(
+  z.object({ reasons: z.record(z.string(), z.string()) }).loose(),
+);
+const writes = async (page: Page) =>
+  Writes.parse(
+    JSON.parse(await page.evaluate("JSON.stringify(window.__writes)")),
+  );
+/** The reason the store was last given for the one question. */
+const storedReason = async (page: Page): Promise<string | undefined> =>
+  (await writes(page)).at(-1)?.reasons["keep"];
+
+/** Wait until the store's last write carries `text` as the reason (the page saves on its own). */
+async function reasonStored(page: Page, text: string): Promise<void> {
+  await page.waitForFunction(
+    `(window.__writes || []).at(-1)?.reasons?.keep === ${JSON.stringify(text)}`,
+    undefined,
+    { timeout: 10_000 },
+  );
+  assert.equal(await storedReason(page), text);
+}
+
+/** A browser test launches Chromium and types: far above vitest's 5 s default on a slow runner. */
+const BROWSER_TEST_MS = 60_000;
+
+async function onApprovalPage(
+  name: string,
+  echoMs: number,
+  steps: (page: Page) => Promise<void>,
+  filter: "all" | "next" = "all",
+): Promise<void> {
+  const { page: html } = build(setup(name, approval()));
+  const browser = await chromium.launch({
+    executablePath: chromiumPath(),
+    args: ["--no-sandbox"],
+  });
+  try {
+    const page = await browser.newPage();
+    await page.addInitScript(STORE(PRACTICE_DONE, echoMs));
+    await page.goto("about:blank");
+    await page.setContent(html, { waitUntil: "domcontentloaded" });
+    if (filter === "next")
+      await page.getByRole("button", { name: "Next unanswered" }).click();
+    await page.getByRole("button", { name: /Drop/ }).first().click();
+    await steps(page);
+  } finally {
+    await browser.close();
+  }
+}
+
+test(
+  "🔴 a reason typed and never blurred is saved: after a pause in typing, and when the page is left",
+  async () => {
+    await onApprovalPage("browser-pause", 20, async (page) => {
+      await page.locator("textarea").first().click();
+      await page.keyboard.type("a process rule");
+      await reasonStored(page, "a process rule");
+    });
+    await onApprovalPage("browser-leave", 20, async (page) => {
+      await page.locator("textarea").first().click();
+      await page.keyboard.type("not a rule");
+      await page.evaluate(() => {
+        window.dispatchEvent(new Event("pagehide"));
+      });
+      await reasonStored(page, "not a rule");
+    });
+  },
+  BROWSER_TEST_MS,
+);
+
+test(
+  "🔴 the store's echo while typing keeps the box, its focus and every keystroke",
+  async () => {
+    await onApprovalPage("browser-echo", 300, async (page) => {
+      await page.locator("textarea").first().click();
+      await page.keyboard.type("a pro");
+      await page.waitForTimeout(450); // the Drop's own write comes back and the page renders again
+      await page.keyboard.type("cess rule");
+      assert.equal(
+        await page.evaluate(() => document.activeElement?.tagName),
+        "TEXTAREA",
+      );
+      assert.equal(
+        await page.locator("textarea").first().inputValue(),
+        "a process rule",
+      );
+      await reasonStored(page, "a process rule");
+    });
+  },
+  BROWSER_TEST_MS,
+);
+
+test(
+  "🔴 under 'Next unanswered', the save that completes an item keeps the box being typed in on the page",
+  async () => {
+    await onApprovalPage(
+      "browser-next",
+      20,
+      async (page) => {
+        await page.locator("textarea").first().click();
+        await page.keyboard.type("a pro");
+        await reasonStored(page, "a pro"); // the item is complete now, and the filter hides complete items
+        await page.keyboard.type("cess rule");
+        assert.equal(
+          await page.evaluate(() => document.activeElement?.tagName),
+          "TEXTAREA",
+        );
+        await reasonStored(page, "a process rule");
+      },
+      "next",
+    );
+  },
+  BROWSER_TEST_MS,
+);
+
+test(
+  "a Keep needs no reason and writes none: the page stays quiet",
+  async () => {
+    const { page: html } = build(setup("browser-keep", approval()));
+    const browser = await chromium.launch({
+      executablePath: chromiumPath(),
+      args: ["--no-sandbox"],
+    });
+    try {
+      const page = await browser.newPage();
+      await page.addInitScript(STORE(PRACTICE_DONE, 20));
+      await page.goto("about:blank");
+      await page.setContent(html, { waitUntil: "domcontentloaded" });
+      await page.getByRole("button", { name: /Keep/ }).first().click();
+      await page.waitForTimeout(1200); // longer than the reason's pause: nothing more may arrive
+      assert.equal(await page.locator("textarea").count(), 0);
+      assert.deepEqual(
+        (await writes(page)).map((w) => w.reasons),
+        [{}],
+      );
+    } finally {
+      await browser.close();
+    }
+  },
+  BROWSER_TEST_MS,
+);

package/skills/build-label-page/scripts/label-page-core.js

@@ -123,6 +123,10 @@ const integer = (required = true) => ({
     kind: "integer",
     required,
 });
+const boolean = (required = true) => ({
+    kind: "boolean",
+    required,
+});
 const array = (items, required = true, min = 0) => ({
     kind: "array",
     required,
@@ -173,6 +177,9 @@ export const CONFIG_SCHEMA = obj({
     seed: integer(),
     groups: mapping(string(), NAME_PATTERN, 1), // ids become store document ids
     labeller_knows: array(string(true, NAME_PATTERN), false),
+    // false: no "how well do you know {group}" question (an approval page: the author has never seen
+    // these repositories, so its answer means nothing). Left out, every group is asked (rule 5).
+    familiarity: boolean(false),
     familiarity_question: string(false),
     questions: array(QUESTION_SCHEMA, true, 1),
     practice: array(PRACTICE_SCHEMA, true, MIN_PRACTICE),
@@ -227,6 +234,10 @@ function checkObject(value, node, path, where) {
         fail(`${at(path, unknown)}: not a known field (known: ${Object.keys(node.fields).join(", ")})`);
     }
 }
+function checkBoolean(value, where) {
+    if (typeof value !== "boolean")
+        fail(`${where}: must be true or false, got ${repr(value)}`);
+}
 /** Refuse the first place `value` departs from `node`; the message starts with the field's path. */
 function checkValue(value, node, path) {
     const where = path || "items.json";
@@ -239,6 +250,9 @@ function checkValue(value, node, path) {
                 fail(`${where}: must be an integer, got ${repr(value)}`);
             }
             break;
+        case "boolean":
+            checkBoolean(value, where);
+            break;
         case "array":
             checkArray(value, node, path, where);
             break;
@@ -258,15 +272,17 @@ function assertConfig(value) {
  * The page script (`DATA.allowed`) and the exporter (`key.json`) both read this one result, so a
  * stored value counts as an answer on the page exactly when it counts in the export.
  */
-const allowedValues = (questions) => ({
+const allowedValues = (questions, asksFamiliarity) => ({
     questions: Object.fromEntries(questions.map((q) => [q.id, q.options.map((o) => o.value)])),
     // The answers that need a reason, per question: the page and the export read the same list.
     needs_why: Object.fromEntries(questions.map((q) => [
         q.id,
         q.options.filter((o) => o.ask_why !== undefined).map((o) => o.value),
     ])),
-    familiarity: FAMILIARITY.map((o) => o.value),
+    // Empty when the page asks no familiarity: the export then expects no group document at all.
+    familiarity: asksFamiliarity ? FAMILIARITY.map((o) => o.value) : [],
 });
+const asksFamiliarity = (cfg) => cfg.familiarity !== false;
 /** Two values that read the same once case and surrounding space are gone. */
 const readsAs = (s) => s.trim().toLowerCase();
 /** The first entry whose reading repeats an earlier one, with the index of that earlier one. */
@@ -330,6 +346,9 @@ function checkPractice(cfg) {
 }
 function checkConfig(cfg) {
     checkGroups(cfg);
+    if (!asksFamiliarity(cfg) && cfg.familiarity_question !== undefined) {
+        fail(`familiarity_question: ${repr(cfg.familiarity_question)} is never asked, because \`familiarity\` is false — remove one of the two`);
+    }
     cfg.questions.forEach((q, qn) => {
         checkQuestion(q, qn, cfg.questions.slice(0, qn).map((x) => x.id));
     });
@@ -432,9 +451,11 @@ function payloadOf(cfg, page) {
         title: cfg.title,
         intro: cfg.intro ?? "",
         groups: used.map((g) => ({ id: g, label: String(cfg.groups[g]) })),
-        familiarity_question: cfg.familiarity_question ?? "How well do you know {group}?",
-        familiarity: FAMILIARITY,
-        allowed: allowedValues(cfg.questions),
+        familiarity_question: asksFamiliarity(cfg)
+            ? (cfg.familiarity_question ?? "How well do you know {group}?")
+            : "",
+        familiarity: asksFamiliarity(cfg) ? FAMILIARITY : [],
+        allowed: allowedValues(cfg.questions, asksFamiliarity(cfg)),
         questions: cfg.questions,
         practice: { round: practiceRound(cfg), items: practiceOf(cfg) },
         items: page.items.map((i) => ({ id: page.idOf(i), ...shownFields(i) })),
@@ -478,7 +499,7 @@ function keyOf(cfg, page, earlier) {
         questions: cfg.questions.map((q) => q.id),
         // What counts as an answer: the same lists the page was given (`allowedValues`). `export`
         // checks every stored answer and familiarity against them, so the build's options decide.
-        allowed: allowedValues(cfg.questions),
+        allowed: allowedValues(cfg.questions, asksFamiliarity(cfg)),
         // The practice is scored against this at export; its answers never go into the labels.
         practice: {
             round: practiceRound(cfg),
@@ -658,6 +679,14 @@ function checkDump(dump, key) {
         }
     }
 }
+/** A page built with `familiarity: false` asks no group anything: a group document came from elsewhere. */
+function checkNoFamiliarity(dump, allowed) {
+    const groups = isObject(dump["groups"]) ? dump["groups"] : {};
+    const [first] = Object.keys(groups).sort(byText);
+    if (allowed.familiarity.length === 0 && first !== undefined) {
+        fail(`groups/${first}: familiarity is off for this page (items.json \`familiarity: false\`), so no group document is expected — take it out of the dump`);
+    }
+}
 /** The key's `allowed` lists, or a refusal naming a key made by an older build. */
 function assertAllowed(a, key, keyPath) {
     const questions = isObject(a) ? a["questions"] : undefined;
@@ -818,7 +847,9 @@ function exportRound(study, round, items, at) {
 function labelsOf(dump, ctx, day) {
     const onPage = Object.entries(ctx.key.ids).filter(([, m]) => m.on_page);
     const items = onPage.map(([nid, meta]) => labelOf(nid, meta, docOf(dump["answers"], nid), ctx));
-    const groups = groupsOf([...new Set(onPage.map(([, m]) => m.group))], dump["groups"], ctx.allowed);
+    const groups = ctx.allowed.familiarity.length
+        ? groupsOf([...new Set(onPage.map(([, m]) => m.group))], dump["groups"], ctx.allowed)
+        : {};
     return {
         study: ctx.key.study,
         exported: day,
@@ -839,6 +870,7 @@ export function exportLabels(dumpPath, keyPath, outDir, day) {
     const allowed = key.allowed;
     assertAllowed(allowed, key, keyPath);
     checkDump(dump, key);
+    checkNoFamiliarity(dump, allowed);
     const out = labelsOf(dump, { key, allowed }, day);
     mkdirSync(outDir, { recursive: true });
     const path = join(outDir, `${key.study}-labels-${day}.json`);

package/skills/build-label-page/scripts/label-page-core.test.ts

@@ -14,6 +14,7 @@ import {
   ITEMS,
   PRACTICE,
   QUESTIONS,
+  WORK,
   approval,
   build,
   config,
@@ -26,7 +27,7 @@ import {
 /** A node of the declared config schema, as `example-generator.py schema` prints it. */
 const Node: z.ZodType<SchemaNode> = z.lazy(() =>
   z.object({
-    kind: z.enum(["string", "integer", "map", "array", "object"]),
+    kind: z.enum(["string", "integer", "boolean", "map", "array", "object"]),
     required: z.boolean(),
     pattern: z.string().optional(),
     key_pattern: z.string().optional(),
@@ -39,7 +40,7 @@ const Node: z.ZodType<SchemaNode> = z.lazy(() =>
 );
 
 interface SchemaNode {
-  readonly kind: "string" | "integer" | "map" | "array" | "object";
+  readonly kind: "string" | "integer" | "boolean" | "map" | "array" | "object";
   readonly required: boolean;
   readonly pattern?: string | undefined;
   readonly key_pattern?: string | undefined;
@@ -77,6 +78,7 @@ const FULL: DocObject = (() => {
         QUESTIONS[1],
       ],
       labeller_knows: ["python", "go", "rust"],
+      familiarity: true,
       familiarity_question: "How well do you know {group}?",
       items: ITEMS.map((i, n) =>
         n === 0 ? { ...i, title: "T", code: "c = 1", context: "ctx" } : i,
@@ -175,6 +177,7 @@ function spoil(path: string, bad: Doc | undefined): DocObject {
 const WRONG_TYPES: Readonly<Record<SchemaNode["kind"], readonly Doc[]>> = {
   string: [null, 1, true, ["x"], {}, "", "   "],
   integer: [null, "7", true, 7.5, []],
+  boolean: [null, "false", 0, [], {}],
   map: [null, "x", ["x"], 1],
   array: [null, "x", {}, 1],
   object: [null, "x", ["x"], 1],
@@ -238,6 +241,7 @@ const DOCUMENTED_FIELDS = [
   "seed",
   "groups",
   "labeller_knows",
+  "familiarity",
   "familiarity_question",
   "questions",
   "items",
@@ -1162,3 +1166,62 @@ test("🔴 a question dropped between practice rounds: the earlier round's answe
   assert.equal(r.status, 0, r.out);
   assert.match(r.out, /practice round 1: 3 of 3 matched/);
 });
+
+test("🔴 familiarity off: the key asks for none, the export reports no missing familiarity, and a stored one is refused", () => {
+  const dir = setup("familiarity-off", approval({ familiarity: false }));
+  const { key } = build(dir);
+  assert.deepEqual(key.allowed.familiarity, []);
+  const [a] = Object.keys(key.ids);
+  assert.ok(a !== undefined);
+  writeFileSync(
+    join(dir, "dump.json"),
+    JSON.stringify({
+      answers: { [a]: { answers: { keep: "keep" }, source: "page" } },
+      groups: {},
+    }),
+  );
+  const r = exportAt(dir);
+  assert.equal(r.status, 0, r.out);
+  assert.doesNotMatch(r.out, /no familiarity answer|invalid group/);
+  assert.deepEqual(Exported.parse(JSON.parse(labelsFile(dir))).groups, {});
+  writeFileSync(
+    join(dir, "dump.json"),
+    JSON.stringify({
+      answers: {},
+      groups: { python: { familiarity: "well", source: "chat" } },
+    }),
+  );
+  const refused = exportAt(dir);
+  assert.notEqual(refused.status, 0);
+  assert.match(refused.out, /groups\/python: .*familiarity is off/);
+});
+
+test("🔴 familiarity off with a familiarity_question is a contradiction the build refuses", () => {
+  const r = run([
+    "build",
+    join(
+      setup(
+        "familiarity-contradiction",
+        approval({ familiarity: false, familiarity_question: "How well?" }),
+      ),
+      "items.json",
+    ),
+    join(WORK, "contradiction-out"),
+  ]);
+  assert.notEqual(r.status, 0);
+  assert.match(
+    r.out,
+    /REFUSED: familiarity_question: .*`familiarity` is false/,
+  );
+});
+
+test("familiarity left out: every group is still asked (rule 5), and a missing one is reported", () => {
+  const dir = setup("familiarity-default", approval());
+  const { key } = build(dir);
+  assert.deepEqual(key.allowed.familiarity, ["well", "somewhat", "not_really"]);
+  writeFileSync(
+    join(dir, "dump.json"),
+    JSON.stringify({ answers: {}, groups: {} }),
+  );
+  assert.match(exportAt(dir).out, /group python: no familiarity answer/);
+});

package/skills/build-label-page/scripts/label-page-core.ts

@@ -132,6 +132,7 @@ const SOURCES_SHOWN = `(${SOURCES.map(quoted).join(", ")})`;
 type SchemaNode =
   | { kind: "string"; required: boolean; pattern?: string }
   | { kind: "integer"; required: boolean }
+  | { kind: "boolean"; required: boolean }
   | { kind: "array"; required: boolean; min: number; items: SchemaNode }
   | {
       kind: "map";
@@ -155,6 +156,10 @@ const integer = (required = true): SchemaNode => ({
   kind: "integer",
   required,
 });
+const boolean = (required = true): SchemaNode => ({
+  kind: "boolean",
+  required,
+});
 const array = (items: SchemaNode, required = true, min = 0): SchemaNode => ({
   kind: "array",
   required,
@@ -220,6 +225,9 @@ export const CONFIG_SCHEMA = obj({
   seed: integer(),
   groups: mapping(string(), NAME_PATTERN, 1), // ids become store document ids
   labeller_knows: array(string(true, NAME_PATTERN), false),
+  // false: no "how well do you know {group}" question (an approval page: the author has never seen
+  // these repositories, so its answer means nothing). Left out, every group is asked (rule 5).
+  familiarity: boolean(false),
   familiarity_question: string(false),
   questions: array(QUESTION_SCHEMA, true, 1),
   practice: array(PRACTICE_SCHEMA, true, MIN_PRACTICE),
@@ -296,6 +304,10 @@ function checkObject(
     );
   }
 }
+function checkBoolean(value: Json, where: string): void {
+  if (typeof value !== "boolean")
+    fail(`${where}: must be true or false, got ${repr(value)}`);
+}
 /** Refuse the first place `value` departs from `node`; the message starts with the field's path. */
 function checkValue(value: Json, node: SchemaNode, path: string): void {
   const where = path || "items.json";
@@ -308,6 +320,9 @@ function checkValue(value: Json, node: SchemaNode, path: string): void {
         fail(`${where}: must be an integer, got ${repr(value)}`);
       }
       break;
+    case "boolean":
+      checkBoolean(value, where);
+      break;
     case "array":
       checkArray(value, node, path, where);
       break;
@@ -352,6 +367,7 @@ interface Config {
   readonly seed: number;
   readonly groups: Readonly<Record<string, string>>;
   readonly labeller_knows?: readonly string[];
+  readonly familiarity?: boolean;
   readonly familiarity_question?: string;
   readonly questions: readonly Question[];
   readonly practice: readonly Practice[];
@@ -368,7 +384,10 @@ function assertConfig(value: Json): asserts value is Json & Config {
  * The page script (`DATA.allowed`) and the exporter (`key.json`) both read this one result, so a
  * stored value counts as an answer on the page exactly when it counts in the export.
  */
-const allowedValues = (questions: readonly Question[]): JsonObject => ({
+const allowedValues = (
+  questions: readonly Question[],
+  asksFamiliarity: boolean,
+): JsonObject => ({
   questions: Object.fromEntries(
     questions.map((q) => [q.id, q.options.map((o) => o.value)]),
   ),
@@ -379,8 +398,10 @@ const allowedValues = (questions: readonly Question[]): JsonObject => ({
       q.options.filter((o) => o.ask_why !== undefined).map((o) => o.value),
     ]),
   ),
-  familiarity: FAMILIARITY.map((o) => o.value),
+  // Empty when the page asks no familiarity: the export then expects no group document at all.
+  familiarity: asksFamiliarity ? FAMILIARITY.map((o) => o.value) : [],
 });
+const asksFamiliarity = (cfg: Config): boolean => cfg.familiarity !== false;
 
 /** Two values that read the same once case and surrounding space are gone. */
 const readsAs = (s: string): string => s.trim().toLowerCase();
@@ -464,6 +485,11 @@ function checkPractice(cfg: Config): void {
 }
 function checkConfig(cfg: Config): void {
   checkGroups(cfg);
+  if (!asksFamiliarity(cfg) && cfg.familiarity_question !== undefined) {
+    fail(
+      `familiarity_question: ${repr(cfg.familiarity_question)} is never asked, because \`familiarity\` is false — remove one of the two`,
+    );
+  }
   cfg.questions.forEach((q, qn) => {
     checkQuestion(
       q,
@@ -618,10 +644,11 @@ function payloadOf(cfg: Config, page: ReturnType<typeof itemsOnPage>) {
     title: cfg.title,
     intro: cfg.intro ?? "",
     groups: used.map((g) => ({ id: g, label: String(cfg.groups[g]) })),
-    familiarity_question:
-      cfg.familiarity_question ?? "How well do you know {group}?",
-    familiarity: FAMILIARITY,
-    allowed: allowedValues(cfg.questions),
+    familiarity_question: asksFamiliarity(cfg)
+      ? (cfg.familiarity_question ?? "How well do you know {group}?")
+      : "",
+    familiarity: asksFamiliarity(cfg) ? FAMILIARITY : [],
+    allowed: allowedValues(cfg.questions, asksFamiliarity(cfg)),
     questions: cfg.questions,
     practice: { round: practiceRound(cfg), items: practiceOf(cfg) },
     items: page.items.map((i) => ({ id: page.idOf(i), ...shownFields(i) })),
@@ -675,7 +702,7 @@ function keyOf(
     questions: cfg.questions.map((q) => q.id),
     // What counts as an answer: the same lists the page was given (`allowedValues`). `export`
     // checks every stored answer and familiarity against them, so the build's options decide.
-    allowed: allowedValues(cfg.questions),
+    allowed: allowedValues(cfg.questions, asksFamiliarity(cfg)),
     // The practice is scored against this at export; its answers never go into the labels.
     practice: {
       round: practiceRound(cfg),
@@ -931,6 +958,17 @@ function checkDump(dump: Json, key: Key): asserts dump is JsonObject {
   }
 }
 
+/** A page built with `familiarity: false` asks no group anything: a group document came from elsewhere. */
+function checkNoFamiliarity(dump: JsonObject, allowed: Allowed): void {
+  const groups = isObject(dump["groups"]) ? dump["groups"] : {};
+  const [first] = Object.keys(groups).sort(byText);
+  if (allowed.familiarity.length === 0 && first !== undefined) {
+    fail(
+      `groups/${first}: familiarity is off for this page (items.json \`familiarity: false\`), so no group document is expected — take it out of the dump`,
+    );
+  }
+}
+
 // ── export ────────────────────────────────────────────────────────────────────────────────────
 interface Allowed {
   readonly questions: Readonly<Record<string, readonly string[]>>;
@@ -1165,11 +1203,13 @@ function labelsOf(dump: JsonObject, ctx: Ctx, day: string) {
   const items = onPage.map(([nid, meta]) =>
     labelOf(nid, meta, docOf(dump["answers"], nid), ctx),
   );
-  const groups = groupsOf(
-    [...new Set(onPage.map(([, m]) => m.group))],
-    dump["groups"],
-    ctx.allowed,
-  );
+  const groups = ctx.allowed.familiarity.length
+    ? groupsOf(
+        [...new Set(onPage.map(([, m]) => m.group))],
+        dump["groups"],
+        ctx.allowed,
+      )
+    : {};
   return {
     study: ctx.key.study,
     exported: day,
@@ -1197,6 +1237,7 @@ export function exportLabels(
   const allowed = key.allowed;
   assertAllowed(allowed, key, keyPath);
   checkDump(dump, key);
+  checkNoFamiliarity(dump, allowed);
   const out = labelsOf(dump, { key, allowed }, day);
   mkdirSync(outDir, { recursive: true });
   const path = join(outDir, `${key.study}-labels-${day}.json`);

package/skills/build-label-page/scripts/label-page-html.test.ts

@@ -411,3 +411,25 @@ test("🔴 without the store the page is read-only, and the real items stay read
   assert.match(shown, /cannot be saved in this view/);
   assert.match(shown, /G001/, "a real item is shown read-only");
 });
+
+test("🔴 familiarity off: no group asks how well it is known, and a group is done when its items are", async () => {
+  const { page, key } = build(
+    setup("familiarity-off-page", approval({ familiarity: false })),
+  );
+  const practice = Object.fromEntries(
+    APPROVAL_PRACTICE.map((p, n) => [
+      `r1-P${String(n + 1)}`,
+      { answers: p.expected, source: "page" },
+    ]),
+  );
+  const answers = Object.fromEntries(
+    Object.keys(key.ids).map((id) => [
+      id,
+      { answers: { keep: "keep" }, source: "page" },
+    ]),
+  );
+  const shown = await showPage(page, answers, {}, practice);
+  assert.doesNotMatch(shown, /How well/);
+  assert.doesNotMatch(shown, /how well you know it/);
+  assert.match(shown, /Nothing left/, shown);
+});

package/skills/build-label-page/scripts/label-page.js

@@ -40,6 +40,7 @@
  *     "seed": 7,                            fixes the order; change it and every id changes
  *     "groups": {"python": "Python"},
  *     "labeller_knows": ["python"],         optional: items of other groups are not put on the page
+ *     "familiarity": false,                 optional: no "how well do you know" question (approval page)
  *     "familiarity_question": "How well do you know {group}?",          optional
  *     "questions": [{"id": "label", "text": "Is this correct?", "short": "correct?",
  *                    "options": [{"value": "yes", "label": "Yes", "example": "one real case",

package/skills/build-label-page/scripts/label-page.ts

@@ -40,6 +40,7 @@
  *     "seed": 7,                            fixes the order; change it and every id changes
  *     "groups": {"python": "Python"},
  *     "labeller_knows": ["python"],         optional: items of other groups are not put on the page
+ *     "familiarity": false,                 optional: no "how well do you know" question (approval page)
  *     "familiarity_question": "How well do you know {group}?",          optional
  *     "questions": [{"id": "label", "text": "Is this correct?", "short": "correct?",
  *                    "options": [{"value": "yes", "label": "Yes", "example": "one real case",

package/skills/build-label-page/scripts/page-template.html

@@ -90,6 +90,9 @@ pre { overflow-x: auto; background: var(--surface); border: 1px solid var(--line
     editing: {},      // item id -> the question id the labeller tapped "Change" on
     mineWhy: {},      // item id -> the reasons this page has just written (ahead of the store)
     draftWhy: {},     // item id -> {question id: text typed and not yet saved}
+    whyTimers: {},    // "<item id>|<question id>" -> the pending save of a reason being typed
+    whyBoxes: {},     // "<item id>|<question id>" -> the reason box of the last render
+    typingIn: null,   // the item whose reason box has the keyboard: shown even when complete
     mine: {},         // item/group key -> the answers this page has just written (ahead of the store)
     inflight: {},     // item/group key -> writes not yet confirmed
     failed: {},       // item/group key -> error code of the last refused write
@@ -99,6 +102,7 @@ pre { overflow-x: auto; background: var(--surface); border: 1px solid var(--line
   };
   var db = null;
   var chains = {};
+  var WHY_PAUSE_MS = 800;
 
   try { if (localStorage.getItem("label-filter") === "next") state.filter = "next"; } catch (e) {}
 
@@ -142,7 +146,11 @@ pre { overflow-x: auto; background: var(--surface); border: 1px solid var(--line
     }).filter(function (q) { return q !== null; });
   }
   function itemDone(id) { return missingFor(id).length === 0; }
+  // A page built with "familiarity": false asks no group anything (an approval page): every group
+  // counts as rated, and neither the question nor "how well you know it" is ever shown.
+  var ASKS_FAMILIARITY = DATA.familiarity.length > 0;
   function familiarity(g) {
+    if (!ASKS_FAMILIARITY) return null;
     var d = state.mine["group:" + g] || state.groups[g];
     return d && valid(DATA.allowed.familiarity, d.familiarity) ? d.familiarity : undefined;
   }
@@ -197,6 +205,8 @@ pre { overflow-x: auto; background: var(--surface); border: 1px solid var(--line
   }
   // A reason saves when the labeller leaves the box (the text equivalent of a tap).
   function setReason(id, qid, text) {
+    clearTimeout(state.whyTimers[id + "|" + qid]);
+    delete state.whyTimers[id + "|" + qid];
     if (!canWrite()) return;
     var why = Object.assign({}, reasonsOf(id));
     why[qid] = text;
@@ -315,8 +325,16 @@ pre { overflow-x: auto; background: var(--surface); border: 1px solid var(--line
       var draft = draftOf(item.id, q.id);
       box.value = draft !== undefined ? draft : reasonsOf(item.id)[q.id] || "";
       box.disabled = off;
-      // Every keystroke is kept as a draft, so a render from the store never erases unsaved text.
-      box.addEventListener("input", function () { keepDraft(item.id, q.id, box.value); });
+      // Every keystroke is kept as a draft, so a render from the store never erases unsaved text,
+      // and a pause in typing saves it: a reason that waits for the box to lose focus is lost when
+      // the labeller leaves the page from inside the box (measured: the store kept the drop alone).
+      box.addEventListener("input", function () {
+        keepDraft(item.id, q.id, box.value);
+        var k = item.id + "|" + q.id;
+        clearTimeout(state.whyTimers[k]);
+        state.whyTimers[k] = setTimeout(function () { setReason(item.id, q.id, box.value); }, WHY_PAUSE_MS);
+      });
+      state.whyBoxes[item.id + "|" + q.id] = box;
       box.addEventListener("change", function () { setReason(item.id, q.id, box.value); });
       card.appendChild(box);
     });
@@ -407,20 +425,56 @@ pre { overflow-x: auto; background: var(--surface); border: 1px solid var(--line
   function groupBlock(g, off, onlyOpen) {
     var sec = el("section");
     sec.appendChild(el("h2", "", g.label));
-    var fam = el("div", "ask");
-    fam.appendChild(el("p", "q", DATA.familiarity_question.replace("{group}", g.label)));
-    fam.appendChild(options(DATA.familiarity, familiarity(g.id), function (v) { setFamiliarity(g.id, v); }, off));
-    var gs = state.groups[g.id];
-    fam.appendChild(statusLine("group:" + g.id,
-      familiarity(g.id) === undefined ? [{ text: "an answer" }] : [], gs && gs.savedAt));
-    sec.appendChild(fam);
+    if (ASKS_FAMILIARITY) {
+      var fam = el("div", "ask");
+      fam.appendChild(el("p", "q", DATA.familiarity_question.replace("{group}", g.label)));
+      fam.appendChild(options(DATA.familiarity, familiarity(g.id), function (v) { setFamiliarity(g.id, v); }, off));
+      var gs = state.groups[g.id];
+      fam.appendChild(statusLine("group:" + g.id,
+        familiarity(g.id) === undefined ? [{ text: "an answer" }] : [], gs && gs.savedAt));
+      sec.appendChild(fam);
+    }
     groupItems(g.id).forEach(function (i) {
-      if (onlyOpen && itemDone(i.id)) return;
+      if (onlyOpen && itemDone(i.id) && i.id !== state.typingIn) return;
       sec.appendChild(itemCard(i, off));
     });
     return sec;
   }
+  // Every reason typed and not yet saved goes to the store now: the page is being left.
+  function flushReasons() {
+    Object.keys(state.whyTimers).forEach(function (k) {
+      var at = k.indexOf("|"), id = k.slice(0, at), qid = k.slice(at + 1);
+      var draft = draftOf(id, qid);
+      if (draft === undefined) { clearTimeout(state.whyTimers[k]); delete state.whyTimers[k]; return; }
+      setReason(id, qid, draft);
+    });
+  }
+  // The page is rebuilt on every store snapshot; the reason box being typed in gets the keyboard back,
+  // with its caret where it was, or the rest of the sentence goes nowhere.
+  // Chrome fires "change" on a focused box while a render is removing it, and that change saves and
+  // renders: a render started inside a render would paint with no box focused and hide the item being
+  // typed in. It is skipped; the write it started renders again when the store confirms it.
+  var painting = false;
   function render() {
+    if (painting) return;
+    painting = true;
+    try { renderOnce(); } finally { painting = false; }
+  }
+  function renderOnce() {
+    var typing = null;
+    Object.keys(state.whyBoxes).forEach(function (k) {
+      var b = state.whyBoxes[k];
+      if (document.activeElement === b) typing = { key: k, start: b.selectionStart, end: b.selectionEnd };
+    });
+    state.whyBoxes = {};
+    // Under "Next unanswered" the save that completes an item would hide it, box and all, mid-sentence:
+    // the item being typed in stays on the page until the labeller leaves its box.
+    state.typingIn = typing ? typing.key.slice(0, typing.key.indexOf("|")) : null;
+    paint();
+    var again = typing && state.whyBoxes[typing.key];
+    if (again) { again.focus(); again.setSelectionRange(typing.start, typing.end); }
+  }
+  function paint() {
     var off = !canWrite();
     var done = DATA.items.filter(function (i) { return itemDone(i.id); }).length;
     var total = DATA.items.length;
@@ -482,7 +536,8 @@ pre { overflow-x: auto; background: var(--surface); border: 1px solid var(--line
       progress.appendChild(note);
     }
     DATA.groups.forEach(function (g) {
-      if (onlyOpen && groupDone(g.id)) return;
+      var typingHere = groupItems(g.id).some(function (i) { return i.id === state.typingIn; });
+      if (onlyOpen && groupDone(g.id) && !typingHere) return;
       app.appendChild(groupBlock(g, off, onlyOpen));
     });
   }
@@ -499,6 +554,10 @@ pre { overflow-x: auto; background: var(--surface); border: 1px solid var(--line
   }
   function broken() { state.store = "none"; render(); }
 
+  document.addEventListener("visibilitychange", function () {
+    if (document.visibilityState !== "visible") flushReasons();
+  });
+  window.addEventListener("pagehide", flushReasons);
   render();
   if (!window.claude || typeof window.claude.use !== "function") { broken(); return; }
   window.claude.use("db").then(function (store) {

package/src/domain/repro-layout.test.ts

@@ -208,6 +208,8 @@ describe("reproMessage — stands alone", () => {
         "├── README.md      ← the index: one line per study, generated from studies.json",
         "├── studies.json   ← the study registry: id, title, status and result of each study",
         "├── .gitignore     ← keeps the scripts' byproducts out of git",
+        "├── CLAUDE.md      ← optional: instructions an agent loads when it works in repro/",
+        "├── AGENTS.md      ← optional: the same, for agents that read AGENTS.md",
         "├── tools/         ← scripts used across the paper (numbers, figures, anonymity check, harnesses)",
         "├── data/          ← shared data (tables, caches)",
         "└── <id>-<slug>/   ← one folder per study or spike, named by its row in studies.json (P1-S03-baseline)",

package/src/domain/repro-layout.ts

@@ -13,7 +13,7 @@
  *   ├── tools/                 scripts used across the paper (numbers, figures, anonymity check, harnesses)
  *   └── data/                  shared data (tables, caches)
  *
- * plus `.gitignore`. A loose note belongs in its study's folder or in the paper's `research/`.
+ * plus `.gitignore`, and optionally the agent instruction files `CLAUDE.md` and `AGENTS.md`. A loose note belongs in its study's folder or in the paper's `research/`.
  *
  * ── A STUDY'S NAME ───────────────────────────────────────────────────────────────
  * `<id>-<slug>` (`P1-S03-baseline`): the id of the study's row in `repro/studies.json` — the paper's
@@ -58,6 +58,14 @@ export const REPRO_FILE_NOTES: readonly {
     note: "the study registry: id, title, status and result of each study",
   },
   { name: ".gitignore", note: "keeps the scripts' byproducts out of git" },
+  {
+    name: "CLAUDE.md",
+    note: "optional: instructions an agent loads when it works in repro/",
+  },
+  {
+    name: "AGENTS.md",
+    note: "optional: the same, for agents that read AGENTS.md",
+  },
 ];
 export const REPRO_FILES: readonly string[] = REPRO_FILE_NOTES.map(
   (f) => f.name,

package/src/repro-layout-rule.test.ts

@@ -94,6 +94,16 @@ describe("repro/allowed-files-only — silent", () => {
     ).toEqual([]);
   });
 
+  it("on agent instruction files at the top (CLAUDE.md, AGENTS.md)", () => {
+    expect(
+      lint({
+        ...SCAFFOLD,
+        [`${DIR}/repro/CLAUDE.md`]: "x",
+        [`${DIR}/repro/AGENTS.md`]: "x",
+      }),
+    ).toEqual([]);
+  });
+
   it("on a paper with no repro/", () => {
     expect(lint(SCAFFOLD)).toEqual([]);
   });