@tiagojct/subsub 0.9.0 → 0.10.0

package/README.md

@@ -17,9 +17,7 @@ A Zotero librarian and research assistant that runs on your computer, in your br
 
 * **Code-Enforced Safety Gate**: The model **cannot** modify your library without your explicit approval. Every change is calculated first as a dry-run preview (+added in green, -removed in red) and executed only when you confirm.
 * **Full Journal & Reversible Edits**: Every library modification is recorded with a unique journal ID and can be reverted anytime using `/undo`.
-* **Two Dedicated Roles**:
-  * 📚 **The Librarian**: Cleans tags, imports references (DOI, PMID, ISBN), deduplicates, fixes metadata, retrieves open-access PDFs, creates collections, and checks retractions. *Runs completely offline with no web search access.*
-  * 🔬 **The Researcher**: Reads items, searches PubMed and OpenAlex, finds gaps, checks citations in manuscripts, and writes structured Markdown notes in your Sub-Sub folder (it can sit inside an Obsidian vault). *Cannot modify library records.*
+* **One assistant, one switch**: Sub-Sub reads items, searches PubMed, Europe PMC and OpenAlex, finds gaps, checks citations in manuscripts and writes Markdown notes in your Sub-Sub folder (it can sit inside an Obsidian vault). With **library changes** on (the default), it also tags, imports by DOI, PMID or ISBN, repairs metadata, finds duplicates, attaches open-access PDFs and checks retractions, in the same conversation. Turn library changes off (`/library off`, or the switch in the browser view) to read only.
 * **Local & Private**: Listens strictly on `127.0.0.1` protected by an authenticated single-origin session cookie. Your library contents remain on your computer.
 * **Modern Web Interface & Terminal UI**: Use Sub-Sub in your browser with desktop shortcuts (`~/Applications/Sub-Sub.app`, Start menu, or `.desktop`), or launch it right in your terminal with adaptive color themes.
 
@@ -32,7 +30,7 @@ Profiles calibrate how much Sub-Sub drafts and executes for you. Choose your pro
 | Profile | Description |
 |---|---|
 | **Reader** | Guided and instructional. Reading notes are quotes with page numbers and reflective questions. Never generates unrequested summaries or syntheses. No bulk library edits. |
-| **Scholar** | Full research workflow: literature notes, conceptual syntheses, database searches, alerts, and the full librarian toolkit. |
+| **Scholar** | Full research workflow: literature notes, conceptual syntheses, database searches, alerts, and all library changes. |
 | **Author** | Scholar capabilities plus manuscript workflows: citation auditing against your library, automated Pandoc/Quarto bibliographies, and argument analysis. It critiques but does not write your paragraphs. |
 | **Editor** | Everything unlocked, including drafting full manuscript sections and abstracts upon request. |
 
@@ -106,7 +104,8 @@ Starting Sub-Sub with `subsub web` (or `subsub serve`) launches the browser appl
 
 * **Approval Previews**: Shows server-computed dry-run diffs directly in the UI. Changes are applied only after clicking **Yes** or pressing <kbd>Y</kbd>.
 * **Keyboard-First Review**: In approval dialogs, press <kbd>Y</kbd> or <kbd>Cmd</kbd>/<kbd>Ctrl</kbd>+<kbd>Enter</kbd> to approve, or <kbd>N</kbd>/<kbd>Esc</kbd> to decline.
-* **Theme Switcher**: Header toggle between **Light**, **Dark**, and **System** themes, with tailored styling for each mode (Try-Works amber for Librarian, Glauca blue for Researcher).
+* **Library changes switch**: In the header. Off, Sub-Sub reads, searches and writes notes only; the Library actions in the side panel are hidden.
+* **Theme Switcher**: Header toggle between **Light**, **Dark**, and **System** themes.
 * **One-Click Copy**: Built-in copy buttons on all code snippets, BibTeX records, and assistant literature notes.
 * **Session Search & Markdown Export**: Filter conversation history in real time and download full discussions as Markdown notes.
 * **Local Security**: Binds strictly to `127.0.0.1`. The initial link carries a random token that converts into an `HttpOnly`, `SameSite=Strict` cookie. Protected with strict Content Security Policy (CSP), origin validation, and sanitized output.
@@ -116,11 +115,11 @@ Starting Sub-Sub with `subsub web` (or `subsub serve`) launches the browser appl
 
 ## Usage
 
-### Interactive Modes & Commands
+### Starting and commands
 
 ```sh
-subsub             # Start in researcher mode
-subsub --librarian # Start in librarian mode
+subsub             # Start in the terminal
+subsub --read-only # Start with library changes off (this session only)
 subsub web         # Start browser view
 subsub -c          # Continue the previous session
 subsub -r          # Resume an older session
@@ -128,8 +127,7 @@ subsub -r          # Resume an older session
 
 Commands available within Sub-Sub:
 
-* `/librarian`: Switch to the librarian (modify library, tag, import; offline).
-* `/researcher`: Switch to the researcher (read library, search literature, write notes).
+* `/library on|off`: Turn library changes on or off (saved). Without an argument, it toggles. `/librarian` and `/researcher`, the two modes before 0.10, still work: on and off.
 * `/profile [name]`: View or change active profile (`reader`, `scholar`, `author`, `editor`).
 * `/subsub`: Display Zotero connection health and library statistics.
 * `/history`: List recent library changes with journal IDs.
@@ -139,11 +137,11 @@ Commands available within Sub-Sub:
 
 Type the command followed by arguments:
 
-* **Librarian**:
+* **Library** (need library changes on):
   * `/tag-batch [size]`: Tag untagged items using your tag vocabulary.
   * `/clean-tags`: Find irregular tags and reconcile with your vocabulary.
   * `/import-queue [path]`: Import pending references from an inbox note.
-* **Researcher**:
+* **Research**:
   * `/lit <question>`: Literature review: the library first, then PubMed, Europe PMC and OpenAlex in one merged search; reads before it summarises; an evidence table, agreement, disagreement and open questions; references checked; one note in `Research/` (Scholar, Author, Editor).
   * `/compare <question or citekeys>`: Source matrix (claim, evidence type, caveats, confidence), agreements and disagreements (Scholar, Author, Editor).
   * `/review <path>`: Critical review of your own manuscript: FATAL, MAJOR and MINOR issues against the reporting guideline that applies (CONSORT, STROBE, PRISMA, STARD, TRIPOD), with quotations and a revision plan. Comments only (Author, Editor).
@@ -177,12 +175,12 @@ subsub review apply 13-31
 | `about` | string | Brief background context about your research domain | `null` |
 | `language` | string | Response language, or `"auto"` to match your input | `"English"` |
 | `vault` | string | Path to your Sub-Sub folder | `$ZOTERO_VAULT` |
-| `models` | object | Model overrides per mode (e.g. `{"librarian": "opencode-go/glm-5.3-flash"}`) | Current model |
-| `defaultMode`| string | Default launch mode (`"researcher"` or `"librarian"`) | `"researcher"` |
+| `model` | string | The model, as provider/id; `""` to choose it in Sub-Sub | `"opencode-go/mimo-v2.6-pro"` |
+| `libraryChanges` | boolean | Library changes on (each change still needs your Yes) | `true` |
 | `serverDir` | string | Local development path for `zotero-local-mcp` | PyPI package |
 | `look` | boolean| Show header banners and status lines in terminal | `true` |
 | `quotes` | boolean| Display quotes from *Moby-Dick* in terminal banner | `true` |
-| `themes` | object | Mode-specific terminal themes | `true` |
+| `themes` | string or false | Terminal theme family (`subsub-glauca` or `subsub-try-works`); `false` keeps your pi theme | `"subsub-glauca"` |
 | `addons` | array | Optional servers; `["starbuck"]` adds reference checks | `[]` |
 | `starbuckDir` | string | Local Starbuck folder (used when it has a `pyproject.toml`) | `~/Projects/starbuck` |
 
@@ -203,7 +201,7 @@ Sub-Sub finds open-access copies (Unpaywall, Europe PMC). For other papers, use
 2. Optional: set `"starbuckDir"` to a local copy of Starbuck. Without it, Sub-Sub runs the pinned Starbuck release with uv.
 3. Start Sub-Sub again and run `subsub doctor`. The line `Starbuck` must show `ok`.
 
-The researcher gets four tools: `verify_check_manuscript`, `verify_check_references`, `verify_prepare_claims` and `verify_record_claims`. Starbuck writes its report to a `_starbuck` folder next to the manuscript. Inside the Sub-Sub folder or the working folder this needs no approval; elsewhere Sub-Sub asks first. Starbuck gets the contact email from the zotero-local-mcp env file. For the claim check, Sub-Sub's own model judges; Starbuck checks that every quoted passage is in the source.
+Sub-Sub gets four tools: `verify_check_manuscript`, `verify_check_references`, `verify_prepare_claims` and `verify_record_claims`. Starbuck writes its report to a `_starbuck` folder next to the manuscript. Inside the Sub-Sub folder or the working folder this needs no approval; elsewhere Sub-Sub asks first. Starbuck gets the contact email from the zotero-local-mcp env file. For the claim check, Sub-Sub's own model judges; Starbuck checks that every quoted passage is in the source.
 
 ---
 

package/dist/args.js

@@ -65,3 +65,26 @@ export function coerceArgs(original, input) {
     }
     return input;
 }
+/**
+ * Arguments that name a file in the user's working folder (a manuscript, a report
+ * folder, a bibliography to write). The servers run in their own working folder, so
+ * Sub-Sub makes these paths absolute against its own, as pi's file tools read them.
+ * Note paths (tag reviews, the import queue, linked notes) are not here: the servers
+ * read those from the Sub-Sub folder.
+ */
+export const CWD_PATH_ARGS = {
+    scholar_check_manuscript: ["path"],
+    scholar_export_bibliography: ["output_path"],
+    verify_check_manuscript: ["path", "report_dir"],
+    verify_prepare_claims: ["path", "report_dir"],
+    verify_record_claims: ["path", "report_dir"],
+};
+/** Make the working-folder paths of a tool call absolute. Changes input in place. */
+export function resolvePathArgs(tool, input, toAbsolute) {
+    for (const k of CWD_PATH_ARGS[tool] ?? []) {
+        const v = input[k];
+        if (typeof v === "string" && v.trim())
+            input[k] = toAbsolute(v);
+    }
+    return input;
+}

package/dist/bench.js

@@ -3,7 +3,8 @@
  * with no changes applied. See docs/Subsub.md ("Model test").
  *
  *   subsub-bench prepare [--seed 7]        pick the tasks (read-only)
- *   subsub-bench run [--librarian a,b] [--researcher c,d] [--parallel 3] [--only task]
+ *   subsub-bench run [--models a,b] [--librarian a,b] [--researcher c,d] [--parallel 3] [--only task]
+ *   (--models sets the models for both task groups.)
  *   subsub-bench score                     objective checks -> results.md
  *
  * Results go to ~/Projects/subsub/bench-results/<date>/ (or --dir). Each model gets
@@ -80,8 +81,7 @@ const KEEP = new Set(["tool_execution_start", "tool_execution_end", "message_end
 export function runOne(opts) {
     mkdirSync(opts.out, { recursive: true });
     const args = ["--mode", "rpc", "--no-session", "--provider", opts.provider ?? "opencode-go", "--model", opts.model];
-    if (opts.role === "librarian")
-        args.push("--librarian");
+    args.push("--librarian"); // library changes on for every task
     const env = { ...process.env, ...opts.extraEnv, SUBSUB_BENCH_OUT: opts.out, SUBSUB_CONFIG: opts.configFile };
     const proc = spawn(process.execPath, [opts.cli ?? join(PACKAGE_DIR, "bin", "subsub.js"), ...args], { cwd: opts.cwd, env });
     const events = [];
@@ -530,9 +530,10 @@ export async function main(argv = process.argv.slice(2)) {
         if (!cfg.vault)
             throw new Error("No vault configured (ZOTERO_VAULT).");
         const t = JSON.parse(readFileSync(tasksFile, "utf8"));
+        const both = arg(argv, "models")?.split(",").filter(Boolean);
         const lists = {
-            librarian: arg(argv, "librarian")?.split(",").filter(Boolean) ?? DEFAULT_MODELS.librarian,
-            researcher: arg(argv, "researcher")?.split(",").filter(Boolean) ?? DEFAULT_MODELS.researcher,
+            librarian: arg(argv, "librarian")?.split(",").filter(Boolean) ?? both ?? DEFAULT_MODELS.librarian,
+            researcher: arg(argv, "researcher")?.split(",").filter(Boolean) ?? both ?? DEFAULT_MODELS.researcher,
         };
         const only = arg(argv, "only")?.split(",");
         const codes = codesFor([...new Set([...lists.librarian, ...lists.researcher])], dir);
@@ -556,7 +557,7 @@ export async function main(argv = process.argv.slice(2)) {
             if (!prompt)
                 return;
             const cf = join(cfgDir, `${j.code}.json`);
-            writeFileSync(cf, JSON.stringify({ ...userCfg, profile: "editor", models: { librarian: `opencode-go/${j.model}`, researcher: `opencode-go/${j.model}` } }));
+            writeFileSync(cf, JSON.stringify({ ...userCfg, profile: "editor", model: `opencode-go/${j.model}`, models: undefined, libraryChanges: true }));
             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" : "?")}`);
@@ -585,5 +586,5 @@ export async function main(argv = process.argv.slice(2)) {
         console.log(`Wrote ${join(dir, "results.md")}`);
         return;
     }
-    console.log("Usage: subsub-bench prepare | run [--librarian a,b] [--researcher c,d] [--only task] [--parallel 3] | score  [--dir DIR]");
+    console.log("Usage: subsub-bench prepare | run [--models a,b] [--librarian a,b] [--researcher c,d] [--only task] [--parallel 3] | score  [--dir DIR]");
 }

package/dist/bridge.js

@@ -1,6 +1,6 @@
 /**
- * Bridge to the Python MCP servers of zotero-local-mcp (librarian "zotero" and
- * researcher "scholar"). Starts them over stdio, lists their tools, and calls them.
+ * Bridge to the Python MCP servers of zotero-local-mcp ("zotero" for the library,
+ * "scholar" for searches and notes). Starts them over stdio, lists their tools, and calls them.
  * All safety logic (dry runs, version checks, journal, vocabulary, the researcher's
  * note-only client) stays in the Python servers.
  */

package/dist/config.js

@@ -6,10 +6,14 @@
  *   "profile": "scholar",
  *   "userName": "Ana", "about": "a master's student in health informatics", "language": "English",
  *   "vault": "~/Documents/Sub-Sub",
- *   "models": { "librarian": "opencode-go/glm-5.3-flash", "researcher": "opencode-go/mimo-v2.6-pro" },
- *   "defaultMode": "researcher"
+ *   "model": "opencode-go/mimo-v2.6-pro",
+ *   "libraryChanges": true
  * }
  *
+ * Before 0.10 there were two modes, each with a model ("models": {"librarian",
+ * "researcher"}) and "defaultMode". Those keys are still read: the researcher's
+ * model becomes the model.
+ *
  * `subsub init` writes this file. Without "serverDir" (or when that folder does
  * not exist), the Zotero servers run from PyPI with uv.
  *
@@ -22,9 +26,11 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 import { isObsidianVault, settingsFile } from "./layout.js";
+/** The tested model (September 2026 model test). */
+export const DEFAULT_MODEL = "opencode-go/mimo-v2.6-pro";
 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.0";
+export const SERVER_VERSION = "0.5.1";
 /** The Starbuck release (PyPI) that this Sub-Sub version runs when there is no local Starbuck folder. */
 export const STARBUCK_VERSION = "0.2.0";
 export const STARBUCK_SOURCE = `starbuck==${STARBUCK_VERSION}`;
@@ -101,7 +107,11 @@ export function loadConfig(env = process.env) {
     const envValues = envFile && existsSync(envFile) ? parseEnvFile(envFile) : {};
     const vaultRaw = user.vault ?? env.ZOTERO_VAULT ?? envValues.ZOTERO_VAULT;
     const vault = vaultRaw ? expand(vaultRaw, home) : undefined;
-    const mode = user.defaultMode === "librarian" ? "librarian" : "researcher";
+    // Before 0.10: a model per mode, and themes per mode.
+    const legacyModels = user.models && typeof user.models === "object" ? user.models : undefined;
+    // "model": "" means: the user chooses in pi (/login, /model).
+    const model = "model" in user ? (typeof user.model === "string" && user.model) || undefined : legacyModels ? legacyModels.researcher || legacyModels.librarian || undefined : DEFAULT_MODEL;
+    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",
@@ -112,11 +122,8 @@ export function loadConfig(env = process.env) {
         serverDir: expand(user.serverDir ?? "~/Projects/zotero-local-mcp", home),
         envFile,
         vault,
-        models: user.models ?? {
-            librarian: "opencode-go/glm-5.3-flash",
-            researcher: "opencode-go/mimo-v2.6-pro",
-        },
-        defaultMode: mode,
+        model,
+        libraryChanges: user.libraryChanges !== false,
         // A Sub-Sub folder inside an Obsidian vault also reads the vault's context file.
         vaultContext: (user.vaultContext ??
             (vault ? [join(vault, ".claude", "CLAUDE.md"), ...(isObsidianVault(dirname(vault)) ? [join(dirname(vault), ".claude", "CLAUDE.md")] : [])] : [])).map((p) => expand(p, home)),
@@ -129,7 +136,7 @@ export function loadConfig(env = process.env) {
         uvPath: user.uvPath ? expand(user.uvPath, home) : undefined,
         look: user.look,
         quotes: user.quotes,
-        themes: user.themes,
+        themes,
         addons: Array.isArray(user.addons) ? user.addons.filter((a) => typeof a === "string") : [],
         starbuckDir: expand(user.starbuckDir ?? "~/Projects/starbuck", home),
     };

package/dist/doctor.js

@@ -92,7 +92,7 @@ export function runChecks(cfg, env, deps = {}) {
             fix: v.problems?.length
                 ? `Fix these lines in the tag list: ${v.problems.slice(0, 3).join("; ")}`
                 : noTopics
-                    ? "In Sub-Sub (librarian), ask: propose topics for my tag list."
+                    ? "In Sub-Sub, ask: propose topics for my tag list."
                     : undefined,
         });
     }
@@ -104,7 +104,7 @@ export function runChecks(cfg, env, deps = {}) {
         out.push(starbuckCheck(cfg, env, run));
     const agentDir = deps.agentDir ?? (env.SUBSUB_AGENT_DIR ? env.SUBSUB_AGENT_DIR : join(homedir(), ".subsub", "agent"));
     out.push(hasLogin(agentDir)
-        ? { name: "Model login", ok: true, detail: Object.keys(cfg.models).length ? Object.values(cfg.models).join(", ") : "pi's default model" }
+        ? { name: "Model login", ok: true, detail: cfg.model ?? "pi's default model" }
         : { name: "Model login", ok: false, detail: "no model provider yet", fix: "Type subsub, then /login." });
     return out;
 }

package/dist/init.js

@@ -4,7 +4,7 @@
  *
  * Writes:
  * - the settings file (~/.config/subsub/config.json): profile, name, language,
- *   notes folder, models;
+ *   Sub-Sub folder, library changes, model;
  * - 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.
  *   Other lines stay;
@@ -19,14 +19,14 @@
  * 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,
- * --email, --starbuck on|off, --models keep|later|opencode-go.
+ * --library on|off, --email, --starbuck on|off, --models keep|later|opencode-go.
  */
 import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 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, expand, isProfile, loadConfig, parseEnvFile, PROFILES, readConfigFile, saveConfig, starbuckEnabled, withStarbuck, } from "./config.js";
+import { configPath, DEFAULT_MODEL, expand, isProfile, loadConfig, parseEnvFile, PROFILES, 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 { PROFILE_SPECS } from "./profiles.js";
@@ -34,9 +34,9 @@ const TEMPLATES = resolve(dirname(fileURLToPath(import.meta.url)), "..", "templa
 export const STARTER_TAGS = {
     "health-sciences": "Health sciences: clinical areas, public health, methods and study designs",
     "health-informatics": "Health informatics: information systems, data, AI, digital health",
-    "any-field": "Any field: methods and document types only; the librarian proposes topics from your library",
+    "any-field": "Any field: methods and document types only; Sub-Sub proposes topics from your library",
 };
-export const TESTED_MODELS = { librarian: "opencode-go/glm-5.3-flash", researcher: "opencode-go/mimo-v2.6-pro" };
+export const TESTED_MODEL = DEFAULT_MODEL;
 /** Set KEY=VALUE lines in an env file text; other lines and comments stay. */
 export function upsertEnv(text, values) {
     const lines = text ? text.replace(/\n$/, "").split("\n") : [];
@@ -125,6 +125,11 @@ export async function runInit(io, flags, env = process.env, deps = {}) {
     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 ?? (fmup ? "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");
+    explain("Library changes", "With library changes on, Sub-Sub can import, tag and repair items in Zotero. It shows a preview of every change, and nothing changes until you select Yes. With them off, it only reads, searches and writes notes. Switch at any time with /library on or /library off.");
+    const library = await io.choose("Library changes", [
+        { value: "on", label: "On (recommended): every change shows a preview first" },
+        { value: "off", label: "Off: read, search and write notes only" },
+    ], flags.library ?? (existing.libraryChanges === false ? "off" : "on"));
     // 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)]);
@@ -140,25 +145,26 @@ export async function runInit(io, flags, env = process.env, deps = {}) {
         io.say(`Tag list: keeping ${vocab}.`);
     }
     else {
-        explain("Tag list", `The librarian tags items only with the tags in this list. Pick a start; you edit the list later in ${SETTINGS_DIR}/${SETTINGS_FILES.tags}.`);
+        explain("Tag list", `Sub-Sub tags items only with the tags in this list. Pick a start; you edit the list later in ${SETTINGS_DIR}/${SETTINGS_FILES.tags}.`);
         tags = await io.choose("Starter tag list", Object.entries(STARTER_TAGS).map(([value, label]) => ({ value, label })), flags.tags ?? (fmup ? "health-sciences" : "any-field"));
     }
     explain("Contact email", "Unpaywall needs an email address to find open-access PDFs. Sub-Sub sends it only to Unpaywall, Crossref, OpenAlex and PubMed, as they ask.");
     const email = (await io.ask("Email (optional)", flags.email ?? envValues.ZOTERO_CONTACT_EMAIL ?? "")).trim();
-    explain("Reference checks (Starbuck)", "An optional add-on for manuscripts: it checks that each cited work exists, matches its citation and was not retracted. The researcher then has /verify.");
+    explain("Reference checks (Starbuck)", "An optional add-on for manuscripts: it checks that each cited work exists, matches its citation and was not retracted. Sub-Sub then has /verify.");
     const starbuck = await io.choose("Reference checks", [
         { value: "off", label: "Off" },
         { value: "on", label: "On (downloads Starbuck now; uses the email above)" },
     ], flags.starbuck ?? (starbuckEnabled(current) ? "on" : "off"));
     explain("Models", "Sub-Sub needs an account with a model provider. You can connect one later in Sub-Sub with the model button (or /login in the terminal).");
+    const hadModel = "model" in existing || "models" in existing;
     const modelOptions = [
-        ...(existing.models ? [{ value: "keep", label: `Keep: ${JSON.stringify(existing.models)}` }] : []),
+        ...(hadModel ? [{ value: "keep", label: `Keep: ${current.model ?? "choose in Sub-Sub"}` }] : []),
         { value: "later", label: "Choose later in Sub-Sub" },
-        { value: "opencode-go", label: `OpenCode Go, tested: ${TESTED_MODELS.librarian} for the librarian, ${TESTED_MODELS.researcher} for the researcher` },
+        { value: "opencode-go", label: `OpenCode Go, tested: ${TESTED_MODEL}` },
     ];
     const agentDir = initEnv.SUBSUB_AGENT_DIR ? expand(initEnv.SUBSUB_AGENT_DIR, home) : join(home, ".subsub", "agent");
-    const modelDefault = existing.models ? "keep" : hasProvider(agentDir, "opencode") ? "opencode-go" : "later";
-    const models = await io.choose("Models", modelOptions, flags.models ?? modelDefault);
+    const modelDefault = hadModel ? "keep" : hasProvider(agentDir, "opencode") ? "opencode-go" : "later";
+    const models = await io.choose("Model", modelOptions, flags.models ?? modelDefault);
     // ---- write
     if (move === "yes")
         applyMoves(moves);
@@ -193,12 +199,18 @@ export async function runInit(io, flags, env = process.env, deps = {}) {
         setup: fmup ? "fmup" : undefined,
         vault: notes,
         envFile,
+        libraryChanges: library === "on",
+        defaultMode: undefined,
         addons: withStarbuck(current.addons, starbuck === "on"),
     };
+    // One model since 0.10: the per-mode models are replaced.
+    patch.models = undefined;
+    if (models === "keep")
+        patch.model = current.model ?? "";
     if (models === "later")
-        patch.models = {};
+        patch.model = "";
     if (models === "opencode-go")
-        patch.models = TESTED_MODELS;
+        patch.model = TESTED_MODEL;
     saveConfig(patch, initEnv);
     const zotero = await zoteroReachable(deps.fetch);
     const starbuckNote = starbuck === "on" && deps.prepareStarbuck ? deps.prepareStarbuck(loadConfig(initEnv)) : "";

package/dist/layout.js

@@ -24,6 +24,15 @@ export const SETTINGS_FILES = { tags: "Zotero tags.md", rules: "Zotero agent.md"
 export function isObsidianVault(dir) {
     return existsSync(join(dir, ".obsidian"));
 }
+/** The Obsidian vault that holds a folder: the folder itself or the nearest parent with .obsidian/. */
+export function obsidianRoot(dir) {
+    for (let d = dir;; d = dirname(d)) {
+        if (isObsidianVault(d))
+            return d;
+        if (dirname(d) === d)
+            return undefined;
+    }
+}
 /** The folder that a user's answer means: a vault root becomes <vault>/Sub-Sub. */
 export function subsubFolder(answer) {
     return isObsidianVault(answer) && basename(answer) !== FOLDER_NAME ? join(answer, FOLDER_NAME) : answer;

package/dist/look.js

@@ -20,7 +20,8 @@ export const QUOTES = [
     ["God keep me from ever completing anything.", "Moby-Dick, ch. 32"],
     ["Call me Ishmael.", "Moby-Dick, ch. 1"],
 ];
-export const MODE_THEMES = { librarian: "subsub-try-works", researcher: "subsub-glauca" };
+/** The terminal theme, without -dark/-light. subsub-try-works is the other one shipped. */
+export const DEFAULT_THEME = "subsub-glauca";
 /** Light or dark terminal, judged from the text colour of the current theme (dark text means a light background). */
 export function schemeFromAnsi(fgAnsi, themeName) {
     if (themeName?.endsWith("-light") || themeName === "light")
@@ -41,8 +42,7 @@ export function schemeFromAnsi(fgAnsi, themeName) {
     }
     return "dark";
 }
-export function themeName(mode, scheme, map = MODE_THEMES) {
-    const base = map[mode];
+export function themeName(scheme, base = DEFAULT_THEME) {
     return base ? `${base}-${scheme}` : undefined;
 }
 const plain = { mark: (s) => s, text: (s) => s, muted: (s) => s, dim: (s) => s, warn: (s) => s };
@@ -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 = `Assistant${opts.profile ? `, ${opts.profile}` : ""}${opts.libraryChanges ? "" : ", read only"}`;
     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("/library  /profile  /history  /undo  |  / for all commands", w)), "");
     return out;
 }
 /**

package/dist/profiles.js

@@ -5,7 +5,7 @@
  *
  * - reader:  explains each step; reading notes are quotes with page numbers and
  *            questions; no summaries or syntheses; no bulk library changes.
- * - scholar: literature notes, syntheses, searches, alerts; the full librarian.
+ * - scholar: literature notes, syntheses, searches, alerts; all library changes.
  * - author:  scholar plus manuscript work: citation check, bibliography, comments
  *            on the argument. Does not write the manuscript's paragraphs.
  * - editor:  everything, including drafting text for a manuscript on request.
@@ -26,13 +26,13 @@ export const PROFILE_SPECS = {
             "- A literature note is a reading note: the full reference, then direct quotes with page numbers (or section names), and under each quote one question for {{user}} to answer. Do not write summaries, syntheses, conclusions or paragraphs that {{user}} could hand in as their own text. When a prompt or the shared rules ask for a literature note or a synthesis, make a reading note instead and say so.",
             "- For searches, list works with one line each on what they study, not on what they conclude.",
             "- If {{user}} asks for a summary, a synthesis or text for an assignment, say that the Reader profile does not write these, and offer quotes and questions. {{User}} can change the profile with /profile.",
-            "- Librarian: at most 10 items per review note. Explain each proposed tag in the Reason column.",
+            "- Tag review notes: at most 10 items. Explain each proposed tag in the Reason column.",
         ].join("\n"),
     },
     scholar: {
         name: "scholar",
         label: "Scholar",
-        summary: "literature notes, syntheses, searches and alerts; the full librarian",
+        summary: "literature notes, syntheses, searches and alerts; all library changes",
         without: MANUSCRIPT,
         withoutPrompts: ["review"],
         batch: 25,
@@ -40,7 +40,7 @@ export const PROFILE_SPECS = {
             "Profile: Scholar.",
             "- Write literature notes and syntheses from what you read, with a source for every claim.",
             "- Do not draft text for {{user}}'s manuscripts, theses or assignments. If asked, say that the Author and Editor profiles help with manuscripts (/profile).",
-            "- Librarian: 25 items per review note.",
+            "- Tag review notes: 25 items.",
         ].join("\n"),
     },
     author: {
@@ -55,7 +55,7 @@ export const PROFILE_SPECS = {
             "- Write literature notes and syntheses from what you read, with a source for every claim.",
             "- Help with {{user}}'s manuscripts: check citations against the library, export the bibliography, and comment on the argument, the structure and the evidence that is missing, with the sources that could support each point.",
             "- Do not write the manuscript's paragraphs. Say what is missing and where the support is; {{user}} writes the text. The Editor profile drafts text (/profile).",
-            "- Librarian: 25 items per review note.",
+            "- Tag review notes: 25 items.",
         ].join("\n"),
     },
     editor: {
@@ -69,7 +69,7 @@ export const PROFILE_SPECS = {
             "Profile: Editor. All tools.",
             "- Write literature notes and syntheses from what you read, with a source for every claim.",
             "- When {{user}} asks, draft text for a manuscript: cite library items as [@citekey], use only claims from sources you read, and mark drafted text clearly so that {{user}} can check it.",
-            "- Librarian: 25 items per review note unless {{user}} asks for more.",
+            "- Tag review notes: 25 items unless {{user}} asks for more.",
         ].join("\n"),
     },
 };

package/dist/prompt.js

@@ -47,13 +47,16 @@ export function fill(text, cfg) {
         .replaceAll("{{batch}}", String(profileSpec(cfg.profile).batch))
         .replace(/[ \t]+\n/g, "\n");
 }
-export function roleText(mode, cfg) {
-    const raw = readIf(join(ROLE_DIR, `${mode}.md`)) ?? `You are the ${mode}.`;
+export function roleText(cfg) {
+    const raw = readIf(join(ROLE_DIR, "assistant.md")) ?? "You are Sub-Sub, a Zotero librarian and research assistant.";
     return cfg ? fill(raw, cfg) : raw;
 }
-export function systemAddition(mode, cfg, cwd) {
+export function systemAddition(cfg, cwd, libraryChanges = cfg.libraryChanges) {
     const user = who(cfg);
-    const parts = [`# Sub-Sub: ${mode} mode`, roleText(mode, cfg)];
+    const parts = ["# Sub-Sub", roleText(cfg)];
+    if (!libraryChanges) {
+        parts.push(`Library changes are off: you read the library, search, write notes and queue imports. To import, tag or change items, ask ${user} to turn library changes on (/library on, or the switch in the browser view).`);
+    }
     const shared = readIf(cfg.sharedRules);
     if (shared) {
         parts.push("# Shared Zotero rules (from the Sub-Sub folder)", shared, `Sub-Sub note: in Sub-Sub you do not need a separate dry run before a change. Call the write tool with dry_run=false; Sub-Sub shows ${user} the server's preview and applies it only on approval. This replaces the dry-run steps above.`);

package/dist/roles.js

@@ -1,9 +1,9 @@
 /**
- * Which tools each mode may use, and which calls need the user's approval.
+ * Which tools the Assistant 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 for these). */
+/** Prefixes of the tools that Sub-Sub's servers provide (the gate checks the switch and the profile for these). */
 export const SERVER_PREFIXES = ["zotero_", "scholar_", "verify_"];
 export const ZOTERO_READ = [
     "status",
@@ -40,26 +40,38 @@ export const PREVIEW_WRITES = new Set([
 ]);
 /** Writes without a dry run that still need a yes. */
 export const CONFIRM_WRITES = new Set(["scholar_export_bibliography"]);
-export function toolsFor(mode, registered, profile = "editor") {
+/** Zotero tools that look at the library or write only a note in the Sub-Sub folder. */
+export const ZOTERO_CHECKS = ["tag_audit", "audit_metadata", "find_duplicates", "check_retractions", "missing_pdfs", "write_tag_review"].map((n) => `zotero_${n}`);
+/**
+ * The Assistant's tools: reading the library, searching, notes and reference
+ * checks always; the Zotero write tools when library changes are on. The profile
+ * then removes tools.
+ */
+export function toolsFor(registered, opts) {
     const has = new Set(registered);
-    const without = new Set(profileSpec(profile).without);
-    const wanted = mode === "librarian"
-        ? [...registered.filter((n) => n.startsWith("zotero_")), ...FILE_TOOLS]
-        : [
-            ...ZOTERO_READ,
-            ...registered.filter((n) => n.startsWith("scholar_") || n.startsWith("verify_")),
-            ...FILE_TOOLS,
-        ];
+    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,
+        ...ZOTERO_CHECKS,
+        ...(opts.libraryChanges ? zotero : []),
+        ...registered.filter((n) => n.startsWith("scholar_") || n.startsWith("verify_")),
+        ...FILE_TOOLS,
+    ];
     return [...new Set(wanted)].filter((n) => has.has(n) && !without.has(n));
 }
 /** Why a Sub-Sub tool is not available now, or undefined when it is. */
-export function unavailableReason(name, mode, registered, profile) {
-    if (toolsFor(mode, registered, profile).includes(name))
+export function unavailableReason(name, registered, opts) {
+    if (toolsFor(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.`;
     }
-    return `${name} is not available in ${mode} mode. The user can switch with /${otherMode(mode)}.`;
+    if (!opts.libraryChanges && toolsFor(registered, { ...opts, libraryChanges: true }).includes(name)) {
+        return `${name} changes the library, and library changes are off. The user can turn them on with /library on.`;
+    }
+    return `${name} is not available.`;
 }
 /** A dry run only when dry_run is absent (server default true) or clearly true. */
 export function isDryRun(value) {
@@ -74,6 +86,3 @@ export function gateKind(toolName, input) {
         return "path";
     return null;
 }
-export function otherMode(mode) {
-    return mode === "librarian" ? "researcher" : "librarian";
-}