@tiagojct/subsub 0.15.0 → 0.17.0

package/CHANGELOG.md

@@ -2,6 +2,28 @@
 
 Sub-Sub follows the version numbers of npm: a change in the second number (0.13) adds features or changes how you use it; a change in the third (0.13.1) only fixes.
 
+## 0.17.0 (2026-10-14)
+
+For people who are learning to read the literature:
+
+- `/read <citekey>` is a guided reading of one paper. Sub-Sub asks why you read it: background (the title and abstract, then keep or drop), one fact, extraction for a review, or critique. It reads only as deep as that reason needs, quotes the passages with their place and asks questions; you write the answers. It writes no results or summaries in this note. For an extraction, it also adds a row for the paper to your extraction sheet in `Research/`, with where to find each value. Put the reason first to skip the question: `/read extract smith2021`. In the browser it is the button Read a paper.
+- Sub-Sub has no profiles any more (Reader, Scholar, Author, Editor). The two modes stay: the Researcher has every command and tool, and every library change still needs your yes. Sub-Sub writes notes and syntheses with a source for every claim, drafts text for a manuscript or thesis only when you ask, and does not draft text for assignments. What the Reader profile did is now `/read` (a guided reading of one paper) and `/lit reading list: <topic>` (a reading list with questions, no results). `subsub init` no longer asks whether you are a student or which profile you want, and removes the old setting. `/profile` says where things went.
+- The browser view is more useful:
+  - A library search in the left panel. Each result has Read, Note and a link to the item in Zotero.
+  - A notes pane: Notes at the top lists the notes in your Sub-Sub folder, and a note opens next to the conversation. Note paths in replies, `[[links]]` and the Open button on a written file open there too; Open in app still hands it to Obsidian or your editor.
+  - After a command and a space, the message box shows what the command needs.
+  - Conversations can be renamed and deleted. Delete moves the file to `~/.subsub/trash`. Export is in the language of the interface and includes the tools that Sub-Sub used and their results.
+  - The reasons of `/read` show as a list. The undo question has its own title again, and the page no longer scrolls as a whole when the left panel is long.
+- In the browser, a command that asks a question (`/read`, `/undo`) no longer shows an error when the answer takes more than 30 seconds.
+
+## 0.16.0 (2026-10-08)
+
+For clinical researchers:
+
+- `/ai-statement [what you used it for]` writes a draft of the statement on the use of AI that journals ask for, with the Sub-Sub version, its DOI, your models and Sub-Sub's checks, in `Research/`. The parts in brackets are for you to complete. It is also a button in the browser view.
+- A `/lit` note now says what it is: an AI-assisted rapid review, with one AI screener, no second reviewer and no formal risk-of-bias assessment, for scoping, a background section or a first search, and not a systematic review.
+- The site has a page for clinical researchers, in English and Portuguese: what Sub-Sub does for them, what it is not, how to get it on a hospital computer, moving from EndNote or Mendeley, data protection, and journals and AI. The Install page has a section for your IT service: what is installed, what runs and which addresses it contacts.
+
 ## 0.15.0 (2026-10-08)
 
 Checks:

package/README.md

@@ -29,18 +29,13 @@ Every library change works the same way in both modes:
 - Every change is journaled, including new collections. `/undo` reverts the last one, and the browser view shows an Undo button under each change.
 - Nothing is deleted: items go to the Zotero trash. Only tags from your tag list can be added.
 
-## Profiles
+## What Sub-Sub writes
 
-The profile sets how much Sub-Sub writes for you and which tools it offers. Choose it in `subsub init`, or change it with `/profile`. Students start with Reader.
+Sub-Sub writes literature notes, syntheses and reviews from what it read, with a source for every claim. It drafts text for your manuscript or thesis only when you ask, and marks the drafted text so that you can check it. It does not draft text for assignments, even when you ask.
 
-| Profile | What Sub-Sub does |
-|---|---|
-| Reader | Reading notes with quotations, page numbers and questions for you. No summaries or syntheses unless you ask. No bulk library changes. |
-| Scholar | Literature notes, syntheses, searches, alerts and all library changes. |
-| Author | Scholar, plus manuscript work: citation checks against your library, bibliographies for Pandoc and Quarto, and comments on the argument. It does not write your paragraphs. |
-| Editor | Everything, including drafts of manuscript sections and abstracts when you ask. |
+To learn to read papers yourself, use `/read`: Sub-Sub finds the passages and asks questions, and you write the answers. `/lit reading list: <topic>` gives a reading list with questions to read with, and no results.
 
-The [Profiles page](https://subsub.tiagojacinto.eu/profiles/) lists the tools and commands for each profile and mode.
+The [Commands page](https://subsub.tiagojacinto.eu/profiles/) lists the tools and commands of each mode.
 
 ## Requirements
 
@@ -91,17 +86,20 @@ subsub --help        # all commands
 
 In the browser view, connect a model provider with the model button. In the terminal, type `/login`.
 
+The browser view also has a library search (each result can start `/read` or `/lit-note`), a notes pane that shows the notes of your Sub-Sub folder next to the conversation (note paths and `[[links]]` in replies open there), argument hints for the commands, and rename, delete (to `~/.subsub/trash`) and export for conversations.
+
 Commands in Sub-Sub:
 
 | Command | What it does |
 |---|---|
 | `/researcher`, `/librarian` | Switch the mode |
-| `/profile [name]` | Show or change the profile |
 | `/subsub` | Zotero connection, mode, model and library counts |
 | `/history`, `/undo [id]` | Recent library changes; undo the last one or one by its id |
+| `/ai-statement [uses]` | A draft statement on the use of AI for a manuscript, with the Sub-Sub version, its DOI and your models |
 | `/tag-batch [size]` | Tag items that have no topic, with your tag list |
 | `/clean-tags` | Find tags that are not in your tag list and propose fixes |
 | `/import-queue [path]` | Import the references in the import queue note |
+| `/read [reason] <citekey>` | Guided reading of one paper. Sub-Sub asks why you read it (background, one fact, extraction for a review, critique), finds the passages and asks questions; you write the answers. For extraction it adds a row to your extraction sheet in `Research/` |
 | `/lit <question>` | Literature review: the library first, then one merged search; an evidence table, agreement, disagreement and open questions; one note in `Research/` |
 | `/compare <question or citekeys>` | A matrix of sources: claim, evidence, caveats, confidence |
 | `/lit-note <citekey>` | A literature note on one item, from its full text |
@@ -114,7 +112,7 @@ Commands in Sub-Sub:
 | `/digest [days] [topic]` | What changed in the last days: new notes, alerts, works worth reading |
 | `/request-copy <citekey, DOI or PMID>` | A draft email to the corresponding author for a paper that is not open access. You send it yourself |
 
-The library commands work in both modes; the research commands need the Researcher. Some commands depend on the profile (see the Profiles page).
+The library commands work in both modes; the research commands need the Researcher.
 
 To check or apply a tag review note from `Inbox/` outside Sub-Sub:
 
@@ -129,7 +127,6 @@ subsub review apply 13-31
 
 | Setting | Meaning | Default |
 |---|---|---|
-| `profile` | `reader`, `scholar`, `author` or `editor` | `reader` for students, `scholar` for others (`subsub init` asks) |
 | `userName`, `about` | Your name and one line about you, for the replies | none |
 | `language` | Language of replies and notes, or `auto` for the language you write in | `English` |
 | `vault` | The Sub-Sub folder | from the server settings |
@@ -177,6 +174,12 @@ End-to-end tests (real pi and Python servers, a fake Zotero, a scripted model):
 
 See [CHANGELOG.md](CHANGELOG.md).
 
+## Cite
+
+Jacinto T. Sub-Sub: a research assistant for Zotero [software]. Porto: Faculdade de Medicina da Universidade do Porto; 2026. doi:[10.5281/zenodo.23238602](https://doi.org/10.5281/zenodo.23238602)
+
+This DOI always points to the latest version; each version also has its own DOI on [Zenodo](https://doi.org/10.5281/zenodo.23238602). `CITATION.cff` has the same reference for citation managers.
+
 ## Licence
 
 [MIT](LICENSE), Tiago Jacinto. The `/lit`, `/compare` and `/review` prompts adapt text from [Feynman](https://github.com/Companion-Inc/feynman) (MIT); see [THIRD_PARTY_NOTICES](THIRD_PARTY_NOTICES). IBM Plex fonts: SIL Open Font License.

package/dist/bench.js

@@ -844,7 +844,7 @@ export async function main(argv = process.argv.slice(2)) {
             const cf = join(cfgDir, `${j.code}.json`);
             // A bare name is an OpenCode Go model; provider/id (google/gemini-..., openrouter/x/y:free) is any provider.
             const spec = j.model.includes("/") ? j.model : `opencode-go/${j.model}`;
-            writeFileSync(cf, JSON.stringify({ ...userCfg, profile: "editor", models: { librarian: spec, researcher: spec }, model: undefined, libraryChanges: undefined }));
+            writeFileSync(cf, JSON.stringify({ ...userCfg, profile: undefined, models: { librarian: spec, researcher: spec }, model: undefined, libraryChanges: undefined }));
             const s = await runOne({ ...j, prompt, out, cwd: cfg.vault, configFile: cf, timeoutSec });
             n++;
             console.log(`${n}/${jobs.length}  ${j.code}  ${j.task}  ${s.seconds}s  ${s.error ?? (s.settled ? "done" : "?")}`);

package/dist/cli.js

@@ -149,7 +149,7 @@ Usage:
   subsub                 Start Sub-Sub in the terminal
   subsub --librarian     Start in the Librarian, which only manages the library
   subsub web             Open Sub-Sub in the browser
-  subsub init            Set up or change the settings (folder, tag list, profile, models)
+  subsub init            Set up or change the settings (folder, tag list, models)
   subsub doctor          Check the set-up; each line marked FIX says what to do
   subsub usage           The pilot's usage log (if turned on): a summary and where the file is
   subsub shortcut        Add a Sub-Sub shortcut (--remove takes it away)
@@ -161,7 +161,7 @@ Options:
   --here                 Work in the current folder, not in the Sub-Sub folder
 
 In Sub-Sub, type /subsub for the state, /researcher or /librarian to switch modes,
-/profile to change the profile, /undo to undo the last change, and / for all commands.
+/read to read a paper with guidance, /undo to undo the last change, and / for all commands.
 Sub-Sub runs on pi: pi's options (for example --model, --resume) also work.
 
 Docs: https://subsub.tiagojacinto.eu`;

package/dist/config.js

@@ -3,7 +3,6 @@
  * (~/.config/subsub/config.json, or SUBSUB_CONFIG) overrides it.
  *
  * {
- *   "profile": "scholar",
  *   "userName": "Ana", "about": "a master's student in health informatics", "language": "English",
  *   "vault": "~/Documents/Sub-Sub",
  *   "models": { "librarian": "opencode-go/mimo-v2.6-flash", "researcher": "opencode-go/mimo-v2.6-pro" },
@@ -57,7 +56,6 @@ export const RECOMMENDED_MODELS = [
 export function uiLanguage(language) {
     return /portug|^pt\b|^pt-/i.test(language ?? "") ? "pt" : "en";
 }
-export const PROFILES = ["reader", "scholar", "author", "editor"];
 /** The Zotero server release that this Sub-Sub version runs when there is no local server folder. */
 export const SERVER_VERSION = "0.5.5";
 /** The Starbuck release (PyPI) that this Sub-Sub version runs when there is no local Starbuck folder. */
@@ -109,9 +107,6 @@ export function saveConfig(patch, env = process.env) {
     writeFileSync(file, `${JSON.stringify(merged, null, 2)}\n`);
     return file;
 }
-export function isProfile(x) {
-    return typeof x === "string" && PROFILES.includes(x);
-}
 export function loadConfig(env = process.env) {
     const home = env.HOME;
     const file = configPath(env);
@@ -148,7 +143,6 @@ export function loadConfig(env = process.env) {
     const themes = user.themes === false ? false : typeof user.themes === "string" ? user.themes : user.themes?.researcher;
     return {
         configFile: file,
-        profile: isProfile(user.profile) ? user.profile : "scholar",
         userName: typeof user.userName === "string" && user.userName.trim() ? user.userName.trim() : undefined,
         about: typeof user.about === "string" && user.about.trim() ? user.about.trim() : undefined,
         language: typeof user.language === "string" && user.language.trim() ? user.language.trim() : "English",

package/dist/doctor.js

@@ -12,7 +12,6 @@ import { homedir } from "node:os";
 import { join } from "node:path";
 import { findUv, loadConfig, SERVER_VERSION, serverCommand, STARBUCK_SOURCE, starbuckCommand, starbuckEnabled, refreshedArgs, } from "./config.js";
 import { isObsidianVault, LEGACY_SETTINGS_DIR, SETTINGS_FILES, settingsFile } from "./layout.js";
-import { profileSpec } from "./profiles.js";
 export const defaultRunner = (command, args, env) => {
     const r = spawnSync(command, args, { env, encoding: "utf8", timeout: 120_000 });
     return { status: r.status, stdout: r.stdout ?? "", stderr: r.stderr ?? "", error: r.error?.message };
@@ -39,7 +38,7 @@ export function runChecks(cfg, env, deps = {}) {
         ? { name: "Node", ok: true, detail: node }
         : { name: "Node", ok: false, detail: node, fix: "Install Node.js 22.19 or later (https://nodejs.org), or run the Sub-Sub installer again." });
     out.push(existsSync(cfg.configFile)
-        ? { name: "Settings", ok: true, detail: `${cfg.configFile}, profile ${profileSpec(cfg.profile).label}, replies in ${cfg.language}` }
+        ? { name: "Settings", ok: true, detail: `${cfg.configFile}, replies in ${cfg.language}` }
         : { name: "Settings", ok: false, detail: `no ${cfg.configFile}`, fix: "Type subsub init." });
     const uv = findUv(cfg, env);
     const uvRun = run(uv, ["--version"], env);

package/dist/init.js

@@ -3,7 +3,7 @@
  * existing one. Press Enter to keep the value in brackets.
  *
  * Writes:
- * - the settings file (~/.config/subsub/config.json): profile, name, language,
+ * - the settings file (~/.config/subsub/config.json): name, language,
  *   Sub-Sub folder, models;
  * - the server settings file (~/.config/zotero-local-mcp/env, or the one that
  *   already exists): the Sub-Sub folder, tag list, alerts file, contact email.
@@ -18,7 +18,7 @@
  *
  * Flags (for scripts and tests): --yes (take every default), --setup
  * standard|fmup, --name, --about, --language, --folder (or --notes), --move
- * yes|no, --profile, --tags health-sciences|health-informatics|any-field,
+ * yes|no, --tags health-sciences|health-informatics|any-field,
  * --email, --starbuck on|off, --models keep|later|opencode-go|mistral-eu|google-free.
  */
 import { chmodSync, copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
@@ -26,11 +26,10 @@ import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
-import { configPath, DEFAULT_MODELS, EU_MODELS, FREE_MODELS, expand, isProfile, loadConfig, parseEnvFile, PROFILES, readConfigFile, saveConfig, starbuckEnabled, withStarbuck, } from "./config.js";
+import { configPath, DEFAULT_MODELS, EU_MODELS, FREE_MODELS, expand, loadConfig, parseEnvFile, readConfigFile, saveConfig, starbuckEnabled, withStarbuck, } from "./config.js";
 import { defaultRunner, starbuckCheck } from "./doctor.js";
 import { applyMoves, FOLDER_NAME, leftBehind, NOTE_DIRS, planMoves, SETTINGS_DIR, SETTINGS_FILES, subsubFolder } from "./layout.js";
 import { KEY_PROVIDERS, saveApiKey } from "./keys.js";
-import { PROFILE_SPECS } from "./profiles.js";
 const TEMPLATES = resolve(dirname(fileURLToPath(import.meta.url)), "..", "templates");
 export const STARTER_TAGS = {
     "health-sciences": "Health sciences: clinical areas, public health, methods and study designs",
@@ -125,25 +124,13 @@ export async function runInit(io, flags, env = process.env, deps = {}) {
             io.say(`Sub-Sub keeps using ${notes}.`);
         }
     }
-    // Asked here, not first: it only changes the defaults of the next two questions.
-    explain("Faculty of Medicine, Porto", "Sub-Sub has a set-up for the Faculty of Medicine of the University of Porto (FMUP): health-sciences tags and the Reader profile. Everyone else keeps the standard set-up.");
+    // Asked here, not first: it only changes the default of the tag list question.
+    explain("Faculty of Medicine, Porto", "Sub-Sub has a set-up for the Faculty of Medicine of the University of Porto (FMUP): health-sciences tags. Everyone else keeps the standard set-up.");
     const setup = await io.choose("Set-up", [
         { value: "standard", label: "Standard (any field, any institution)" },
-        { value: "fmup", label: "FMUP / U.Porto: health-sciences tags, Reader profile (the FMUP model service is coming soon)" },
+        { value: "fmup", label: "FMUP / U.Porto: health-sciences tags (the FMUP model service is coming soon)" },
     ], flags.setup ?? existing.setup ?? "standard");
     const fmup = setup === "fmup";
-    // Students start in Reader: Sub-Sub helps them read and does not write syntheses for them unless asked.
-    let student = fmup;
-    if (!flags.profile && !existing.profile && !fmup) {
-        explain("Who you are", "Students start with the Reader profile: Sub-Sub helps you read (notes with quotations, page numbers and questions) and does not write summaries or syntheses unless you ask. You can change the profile at any time.");
-        student = (await io.choose("You are", [
-            { value: "student", label: "A student" },
-            { value: "researcher", label: "A researcher, teacher or clinician" },
-        ], flags.student === "no" ? "researcher" : "student")) === "student";
-    }
-    explain("Profile", "The profile sets how much Sub-Sub writes for you and which tools it offers. Change it at any time with /profile.");
-    const profileDefault = flags.profile ?? existing.profile ?? (student ? "reader" : "scholar");
-    const profile = await io.choose("Profile", PROFILES.map((p) => ({ value: p, label: `${PROFILE_SPECS[p].label}: ${PROFILE_SPECS[p].summary}` })), isProfile(profileDefault) ? profileDefault : "scholar");
     // The tag list: a custom path in the server settings stays; otherwise Zotero/Zotero tags.md (moved, kept or new).
     const vocabTarget = join(notes, SETTINGS_DIR, SETTINGS_FILES.tags);
     const oldDefaults = new Set([join(from, "Systems", SETTINGS_FILES.tags), join(from, SETTINGS_DIR, SETTINGS_FILES.tags)]);
@@ -225,7 +212,7 @@ export async function runInit(io, flags, env = process.env, deps = {}) {
     if (brave || hadBrave)
         chmodSync(envFile, 0o600); // the file holds a key
     const patch = {
-        profile,
+        profile: undefined,
         userName: userName || undefined,
         about: about || undefined,
         language,

package/dist/look.js

@@ -63,7 +63,7 @@ export function libraryLine(st) {
 export function headerLines(opts) {
     const p = opts.paint ?? plain;
     const w = Math.max(10, opts.width);
-    const modeLabel = (opts.mode === "librarian" ? "Librarian" : "Researcher") + (opts.profile ? `, ${opts.profile}` : "");
+    const modeLabel = opts.mode === "librarian" ? "Librarian" : "Researcher";
     const lib = libraryLine(opts.library);
     if (w < BANNER[0].length + 2) {
         return [p.mark(cut(`Sub-Sub ${opts.version}`, w)), p.text(cut(`${modeLabel} | ${opts.model}`, w)), (lib.warn ? p.warn : p.muted)(cut(lib.text, w))];
@@ -78,7 +78,7 @@ export function headerLines(opts) {
         else
             out.push(p.dim(cut(`"${opts.quote[0]}"`, w)), p.dim(cut(`  (${opts.quote[1]})`, w)));
     }
-    out.push(p.dim(cut("/researcher  /librarian  /profile  /history  /undo  |  / for all commands", w)), "");
+    out.push(p.dim(cut("/researcher  /librarian  /read  /history  /undo  |  / for all commands", w)), "");
     return out;
 }
 /**

package/dist/prompt.js

@@ -1,16 +1,15 @@
 /**
  * The Sub-Sub part of the system prompt: role text for the current mode, the
- * profile rules, the shared Zotero rules from the Sub-Sub folder, the vault
+ * shared Zotero rules from the Sub-Sub folder, the vault
  * conventions when pi runs inside the Sub-Sub folder, and the language rule.
  *
- * Role and profile texts use placeholders: {{user}} / {{User}} (the user's name,
+ * Role texts use placeholders: {{user}} / {{User}} (the user's name,
  * or "the user"), {{about}} (one line about the user) and {{batch}}.
  */
 import { existsSync, readFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { who } from "./config.js";
-import { profileSpec } from "./profiles.js";
 const ROLE_DIR = join(dirname(fileURLToPath(import.meta.url)), "..", "roles");
 function readIf(path) {
     if (!path || !existsSync(path))
@@ -44,7 +43,7 @@ export function fill(text, cfg) {
         .replaceAll("{{User}}", capital(user))
         .replaceAll("{{user}}", user)
         .replaceAll("{{about}}", about)
-        .replaceAll("{{batch}}", String(profileSpec(cfg.profile).batch))
+        .replaceAll("{{batch}}", "25")
         .replace(/[ \t]+\n/g, "\n");
 }
 export function roleText(mode, cfg) {
@@ -71,8 +70,7 @@ export function systemAddition(mode, cfg, cwd) {
     if (cfg.setup === "fmup") {
         parts.push("# U.Porto", `${capital(user)} works at the University of Porto. Papers that are not open access often open through the university's subscriptions when ${user} uses Sub-Sub on the U.Porto network: say so when a work is not open access.`);
     }
-    // The profile and the language rule come last, so they win over the shared rules and the vault conventions.
-    parts.push("# Profile", fill(profileSpec(cfg.profile).rules, cfg));
+    // The language rule comes last, so it wins over the shared rules and the vault conventions.
     parts.push("# Language", languageRule(cfg.language, user));
     return parts.join("\n\n");
 }

package/dist/read.js

@@ -0,0 +1,88 @@
+/**
+ * /read: guided reading of one paper, for people who are learning to read the literature.
+ * Sub-Sub asks why the user reads the paper and reads only as deep as that reason needs. It finds
+ * the passages (quotes with their place) and asks questions; the user writes the answers. It states
+ * no results: /lit-note is the note that Sub-Sub writes for you.
+ */
+/** The reasons to read, with the labels of the choice (English, Portuguese). */
+export const PURPOSES = {
+    background: ["Background: is it worth reading? (title and abstract, keep or drop)", "Contexto: vale a pena ler? (título e resumo, manter ou pôr de parte)"],
+    fact: ["One fact: find a specific detail", "Um dado: encontrar um pormenor concreto"],
+    extract: ["Extraction: one row for my review (question, design, population, setting, finding)", "Extração: uma linha para a minha revisão (pergunta, desenho, população, contexto, resultado)"],
+    critique: ["Critique: read it closely (peer review, the paper closest to mine)", "Crítica: ler com atenção (revisão por pares, o artigo mais próximo do meu)"],
+};
+/** "/read extract smith2026" -> purpose and reference; the first word is a purpose only when it is one exactly. */
+export function readArgs(args) {
+    const words = args.trim().split(/\s+/).filter(Boolean);
+    const first = words[0]?.toLowerCase();
+    if (first && Object.hasOwn(PURPOSES, first))
+        return { purpose: first, ref: words.slice(1).join(" ") };
+    return { ref: words.join(" ") };
+}
+const GUIDELINES = "CONSORT for randomised trials, STROBE for observational studies, PRISMA for systematic reviews, STARD for diagnostic accuracy, TRIPOD or TRIPOD+AI for prediction models, CHEERS for economic evaluations, SRQR or COREQ for qualitative research";
+function depth(r) {
+    switch (r.purpose) {
+        case "background":
+            return [
+                "Depth: the title and the abstract only. Do not read the full text.",
+                'Under "## The paper at a glance":',
+                "- What it asks: the sentence of the title or abstract that states the question or aim, quoted.",
+                "- How: the sentence that names the design and the population, quoted.",
+                'Under "## Keep or drop": the question "Does this paper fit your reason? Look at the population, the design and the outcome.", then the lines "- [ ] Keep", "- [ ] Drop" and "Reason:", empty for the user.',
+            ];
+        case "fact":
+            return [
+                `The user looks for: ${r.fact}`,
+                "Depth: only the passages that hold this fact. Get the section list first and read only the sections you need.",
+                'Under "## Where the paper says it": each passage, quoted, with its place. Under each passage, one question that makes the user read it closely (for example: what exactly does it say, for which population, at what time?) and an empty line "Your answer:".',
+                "If the paper does not say it, write that you did not find it and where you looked.",
+            ];
+        case "extract": {
+            const sheet = r.sheet
+                ? `the sheet ${r.sheet}: read it first for its columns, then add the row under its table with edit.`
+                : `a new sheet Research/<slug> extraction.md (slug: the review question in lower case with hyphens, at most five words; do not overwrite an existing file). Front matter: title, question: "${r.question}", type: extraction-sheet, created: ${r.date}. Then a table with the columns | Study | Question | Design | Population | Setting | Outcome | Main finding |.`;
+            return [
+                "Depth: the methods and the results (the full text when there is one).",
+                'Under "## Extraction": for each field below, the passage that answers it, quoted with its place, then an empty line "Your answer:".',
+                "- The question or aim",
+                "- The design",
+                "- The population (who, how many)",
+                "- The setting (where, when)",
+                "- The outcome and how it was measured",
+                "- The main finding: quote the sentence of the results that answers the question. Do not restate it.",
+                `Then add one row for this paper to ${sheet}`,
+                "The row: [[citekey]] in the Study column, and in every other column only where the user finds it (the page or the section). Leave the content of the cells for the user.",
+            ];
+        }
+        case "critique":
+            return [
+                "Depth: the whole paper, section by section. A critique needs the full text: if you can read only the abstract, say so, write what the abstract allows, and offer /request-copy to ask the authors for the paper.",
+                'Under "## Methods", "## Results" and "## Discussion": the passages that matter to judge the study, quoted with their place, each with one question for the user (for example: how were the participants selected? what was compared? what else could explain the result?).',
+                `Under "## Appraisal": name the design and the reporting guideline that applies (${GUIDELINES}), and tell the user to check the paper against it item by item. Do not copy the checklist. Then five to eight questions on the risk of bias for this design (selection, confounding, measurement, missing data, selective reporting), each with the passage to look at.`,
+            ];
+    }
+}
+/**
+ * The instruction for the model. The first line is the command itself: the chat shows a long
+ * message folded under its first line, so the user sees what they asked for.
+ */
+export function readInstruction(r) {
+    return [
+        `/read ${r.purpose} ${r.ref}`,
+        "",
+        `Guided reading of ${r.ref}. The user is learning to read papers: you find the passages and ask; the user reads and writes the answers.`,
+        "",
+        "1. Find the work: zotero_find_items first. For a DOI or PMID that is not in the library, scholar_get_work, and offer to import it.",
+        "2. Read only what the depth below needs: zotero_get_fulltext for a library item; otherwise scholar_read_oa_fulltext (the section list first, then only the sections you need); otherwise scholar_get_work for the abstract.",
+        "3. Write the reading note as described below.",
+        "4. Give the user the path of the note and the first question to answer. Do not answer the questions.",
+        "",
+        "Rules:",
+        "- State no results, effect sizes, summaries or conclusions, in the note or in the chat. Quote the paper and ask; the user writes the answers.",
+        "- Copy quotes word for word from what you read. After each quote give its place: the page only with evidence: full text, otherwise the section (Abstract, Methods, Results).",
+        `- The note is Literature/<citekey>.md in the Sub-Sub folder, with the front matter of a literature note from the shared rules plus type: reading-note and purpose: ${r.purpose}; evidence says what you read. If the note exists, do not overwrite it: add a section "## Reading ${r.date}: ${r.purpose}" at the end with edit, with the content below one heading level lower.`,
+        '- Start with "## Why I am reading this" (the reason, in the user\'s words when they gave them) and end with one line "Next step:" (what to read or do next).',
+        "",
+        ...depth(r),
+    ].join("\n");
+}

package/dist/roles.js

@@ -1,9 +1,8 @@
 /**
  * Which tools each mode may use, and which calls need the user's approval.
  */
-import { profileSpec } from "./profiles.js";
 export const FILE_TOOLS = ["read", "edit", "write", "grep", "find", "ls"];
-/** Prefixes of the tools that Sub-Sub's servers provide (the gate checks the mode and the profile for these). */
+/** Prefixes of the tools that Sub-Sub's servers provide (the gate checks the mode for these). */
 export const SERVER_PREFIXES = ["zotero_", "scholar_", "verify_"];
 export const ZOTERO_READ = [
     "status",
@@ -55,12 +54,11 @@ export const ZOTERO_CHECKS = [
 ].map((n) => `zotero_${n}`);
 /**
  * The tools of a mode. The Librarian manages the library: Zotero tools and files.
- * The Researcher has the same, plus searches, notes and reference checks. The
- * profile then removes tools. Every library change is still previewed (gateKind).
+ * The Researcher has the same, plus searches, notes and reference checks. Every
+ * library change is still previewed (gateKind).
  */
 export function toolsFor(mode, registered, opts = {}) {
     const has = new Set(registered);
-    const without = new Set(profileSpec(opts.profile ?? "editor").without);
     const zotero = registered.filter((n) => n.startsWith("zotero_") && (opts.bench || !n.startsWith("zotero_bakeoff_")));
     const wanted = [
         ...ZOTERO_READ,
@@ -69,16 +67,12 @@ export function toolsFor(mode, registered, opts = {}) {
         ...(mode === "researcher" ? registered.filter((n) => n.startsWith("scholar_") || n.startsWith("verify_")) : []),
         ...FILE_TOOLS,
     ];
-    return [...new Set(wanted)].filter((n) => has.has(n) && !without.has(n));
+    return [...new Set(wanted)].filter((n) => has.has(n));
 }
 /** Why a Sub-Sub tool is not available now, or undefined when it is. */
 export function unavailableReason(name, mode, registered, opts = {}) {
     if (toolsFor(mode, registered, opts).includes(name))
         return undefined;
-    const profile = opts.profile ?? "editor";
-    if (profileSpec(profile).without.includes(name)) {
-        return `${name} is not part of the ${profileSpec(profile).label} profile. The user can change the profile with /profile.`;
-    }
     if (mode === "librarian" && toolsFor("researcher", registered, opts).includes(name)) {
         return `${name} is part of the Researcher, which also does everything the Librarian does. The user can switch with /researcher.`;
     }

package/dist/statement.js

@@ -0,0 +1,35 @@
+/**
+ * /ai-statement: a draft of the statement on the use of AI that journals ask for (ICMJE and
+ * most publishers), with the facts Sub-Sub knows: its version, the models of each mode and their
+ * providers, and the checks the program makes. The authors complete the bracketed parts.
+ */
+export const SUBSUB_DOI = "10.5281/zenodo.23238602";
+/** "opencode-go/mimo-v2.6-pro" -> "mimo-v2.6-pro (OpenCode Go)". */
+export function modelLabel(spec) {
+    const i = spec.indexOf("/");
+    if (i < 0)
+        return spec;
+    const provider = spec.slice(0, i);
+    const names = { "opencode-go": "OpenCode Go", google: "Google", mistral: "Mistral AI", openai: "OpenAI", anthropic: "Anthropic", openrouter: "OpenRouter", deepseek: "DeepSeek" };
+    return `${spec.slice(i + 1)} (${names[provider] ?? provider})`;
+}
+export function aiStatement(f) {
+    const models = [...new Set(Object.values(f.models).filter(Boolean))].map(modelLabel);
+    const modelText = models.length ? `the language model${models.length > 1 ? "s" : ""} ${models.join(" and ")}` : "[the language model and its provider]";
+    const uses = f.uses?.trim() || "[the tasks: for example, literature searches, screening of search results, reading notes on included studies, checks of the references]";
+    return [
+        "## Use of AI tools",
+        "",
+        `We used Sub-Sub ${f.version} (Jacinto T., doi:${SUBSUB_DOI}), an open-source research assistant that works from a Zotero reference library, with ${modelText}, in [month and year]. We used it for ${uses}.`,
+        "",
+        "Sub-Sub records in each note whether it was written from the full text, the abstract or the bibliographic record, checks that quotations are in the full text, and makes no change to the reference library without the authors' approval." +
+            (f.starbuck ? " The cited works were checked for existence, bibliographic accuracy and retraction with Starbuck." : ""),
+        "",
+        "[Choose one: No text of this manuscript was written by an AI tool. | Sub-Sub drafted [which parts]; the authors revised and rewrote this text.]",
+        "",
+        "The authors checked every reference and every statement taken from the sources against the original publications, and take full responsibility for the content of this article.",
+        "",
+        "<!-- Draft made by Sub-Sub on " + f.date + ". Complete the parts in brackets, delete this line, and follow the journal's instructions on where the statement goes (often the Methods or the Acknowledgements). -->",
+        "",
+    ].join("\n");
+}