@tiagojct/subsub 0.15.0 → 0.17.0

package/src/init.ts

@@ -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.
  */
 
@@ -33,10 +33,8 @@ import {
 	EU_MODELS,
 	FREE_MODELS,
 	expand,
-	isProfile,
 	loadConfig,
 	parseEnvFile,
-	PROFILES,
 	readConfigFile,
 	saveConfig,
 	starbuckEnabled,
@@ -46,7 +44,6 @@ import {
 import { defaultRunner, starbuckCheck } from "./doctor.ts";
 import { applyMoves, FOLDER_NAME, leftBehind, NOTE_DIRS, planMoves, SETTINGS_DIR, SETTINGS_FILES, subsubFolder } from "./layout.ts";
 import { KEY_PROVIDERS, saveApiKey } from "./keys.ts";
-import { PROFILE_SPECS } from "./profiles.ts";
 
 const TEMPLATES = resolve(dirname(fileURLToPath(import.meta.url)), "..", "templates");
 
@@ -176,40 +173,18 @@ export async function runInit(
 		}
 	}
 
-	// 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)]);
@@ -322,7 +297,7 @@ export async function runInit(
 	if (brave || hadBrave) chmodSync(envFile, 0o600); // the file holds a key
 
 	const patch: Record<string, unknown> = {
-		profile,
+		profile: undefined,
 		userName: userName || undefined,
 		about: about || undefined,
 		language,

package/src/look.ts

@@ -84,8 +84,6 @@ export function libraryLine(st: LibraryState): { text: string; warn: boolean } {
 export function headerLines(opts: {
 	version: string;
 	mode: "librarian" | "researcher";
-	/** Profile label, e.g. "Scholar". */
-	profile?: string;
 	model: string;
 	library: LibraryState;
 	quote?: [string, string];
@@ -94,7 +92,7 @@ export function headerLines(opts: {
 }): string[] {
 	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))];
@@ -107,7 +105,7 @@ export function headerLines(opts: {
 		if ([...one].length <= w) out.push(p.dim(one));
 		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/src/prompt.ts

@@ -1,9 +1,9 @@
 /**
  * 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}}.
  */
 
@@ -11,7 +11,6 @@ import { existsSync, readFileSync } from "node:fs";
 import { dirname, isAbsolute, join, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { type Mode, type SubsubConfig, who } from "./config.ts";
-import { profileSpec } from "./profiles.ts";
 
 const ROLE_DIR = join(dirname(fileURLToPath(import.meta.url)), "..", "roles");
 
@@ -41,18 +40,18 @@ function capital(s: string): string {
 	return s.charAt(0).toUpperCase() + s.slice(1);
 }
 
-export function fill(text: string, cfg: Pick<SubsubConfig, "userName" | "about" | "profile">): string {
+export function fill(text: string, cfg: Pick<SubsubConfig, "userName" | "about">): string {
 	const user = who(cfg);
 	const about = cfg.about ? `${capital(user)} is ${cfg.about}.` : "";
 	return text
 		.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: Mode, cfg?: Pick<SubsubConfig, "userName" | "about" | "profile">): string {
+export function roleText(mode: Mode, cfg?: Pick<SubsubConfig, "userName" | "about">): string {
 	const raw = readIf(join(ROLE_DIR, `${mode}.md`)) ?? `You are Sub-Sub, the ${mode}.`;
 	return cfg ? fill(raw, cfg) : raw;
 }
@@ -86,8 +85,7 @@ export function systemAddition(mode: Mode, cfg: SubsubConfig, cwd: string): stri
 			`${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/src/read.ts

@@ -0,0 +1,107 @@
+/**
+ * /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)"],
+} as const;
+
+export type Purpose = keyof typeof PURPOSES;
+
+export interface ReadRequest {
+	ref: string;
+	purpose: Purpose;
+	date: string;
+	/** fact: what the user looks for. */
+	fact?: string;
+	/** extract: an existing sheet, relative to the Sub-Sub folder. */
+	sheet?: string;
+	/** extract: the review question of a new sheet. */
+	question?: string;
+}
+
+/** "/read extract smith2026" -> purpose and reference; the first word is a purpose only when it is one exactly. */
+export function readArgs(args: string): { purpose?: Purpose; ref: string } {
+	const words = args.trim().split(/\s+/).filter(Boolean);
+	const first = words[0]?.toLowerCase();
+	if (first && Object.hasOwn(PURPOSES, first)) return { purpose: first as Purpose, 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: ReadRequest): string[] {
+	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: ReadRequest): string {
+	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/src/roles.ts

@@ -2,12 +2,11 @@
  * Which tools each mode may use, and which calls need the user's approval.
  */
 
-import type { Mode, Profile } from "./config.ts";
-import { profileSpec } from "./profiles.ts";
+import type { Mode } from "./config.ts";
 
 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 = [
@@ -66,19 +65,17 @@ export const ZOTERO_CHECKS = [
 
 
 export interface ToolOptions {
-	profile?: Profile;
 	/** The model test: also the bakeoff_ tools. */
 	bench?: boolean;
 }
 
 /**
  * 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: Mode, registered: string[], opts: ToolOptions = {}): string[] {
 	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,
@@ -87,16 +84,12 @@ export function toolsFor(mode: Mode, registered: string[], opts: ToolOptions = {
 		...(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: string, mode: Mode, registered: string[], opts: ToolOptions = {}): string | undefined {
 	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/src/statement.ts

@@ -0,0 +1,45 @@
+/**
+ * /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";
+
+export interface StatementFacts {
+	version: string;
+	models: Partial<Record<"librarian" | "researcher", string>>;
+	uses?: string;
+	date: string;
+	starbuck: boolean;
+}
+
+/** "opencode-go/mimo-v2.6-pro" -> "mimo-v2.6-pro (OpenCode Go)". */
+export function modelLabel(spec: string): string {
+	const i = spec.indexOf("/");
+	if (i < 0) return spec;
+	const provider = spec.slice(0, i);
+	const names: Record<string, string> = { "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: StatementFacts): string {
+	const models = [...new Set(Object.values(f.models).filter(Boolean) as string[])].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");
+}

package/src/subsub.ts

@@ -6,9 +6,7 @@
  *   and writes notes. Each mode can have its own model.
  * - An approval gate: every library change is previewed by the server (dry run)
  *   and shown to the user; nothing is applied without a yes.
- * - Profiles (reader, scholar, author, editor) set what Sub-Sub writes and which
- *   tools it offers; /profile changes it.
- * - Commands: /librarian, /researcher, /profile, /subsub, /history, /undo.
+ * - Commands: /librarian, /researcher, /read, /subsub, /history, /undo.
  * - Add-on: with "addons": ["starbuck"], Starbuck runs as a third server
  *   ("verify") for reference checks.
  *
@@ -17,7 +15,7 @@
  */
 
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { Bridge, type ServerSpec } from "./bridge.ts";
@@ -25,12 +23,9 @@ import {
 	expand,
 	findUv,
 	FREE_MODELS,
-	isProfile,
 	loadConfig,
 	parseEnvFile,
-	type Profile,
 	type Mode,
-	saveConfig,
 	serverCommand,
 	starbuckCommand,
 	starbuckEnabled,
@@ -38,8 +33,9 @@ import {
 	uiLanguage,
 	who,
 } from "./config.ts";
-import { profileList, profileSpec, promptBlocked } from "./profiles.ts";
 import { coerceArgs, loosenArrays, resolvePathArgs } from "./args.ts";
+import { aiStatement } from "./statement.ts";
+import { PURPOSES, type Purpose, readArgs, readInstruction, type ReadRequest } from "./read.ts";
 import { applyEdits, checkLiteratureNote, field, frontMatter, itemKeyOf, missingQuotes, quoteProblem, quotesIn } from "./notes.ts";
 import { buildPolicy, isSecret, judgePath, normalizeToolPath, realish, within } from "./paths.ts";
 import { describeArgs, formatPreview, isEmptyPreview } from "./preview.ts";
@@ -142,8 +138,7 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 
 	let mode: Mode = cfg.defaultMode;
 	const benchRun = Boolean(process.env.SUBSUB_BENCH_OUT);
-	const toolOpts = () => ({ profile, bench: benchRun });
-	let profile: Profile = cfg.profile;
+	const toolOpts = () => ({ bench: benchRun });
 	const user = who(cfg);
 	/** True when started with the `subsub` command (not as a package inside plain pi). */
 	const standalone = process.env.SUBSUB_CLI === "1";
@@ -170,8 +165,6 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 		const down = bridge ? Object.keys(bridge.errors) : ["zotero", "scholar"];
 		const state = {
 			mode,
-			profile,
-			profileLabel: profileSpec(profile).label,
 			model: ctx.model ? { provider: ctx.model.provider, id: ctx.model.id } : null,
 			down,
 			library,
@@ -237,7 +230,6 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 					return headerLines({
 						version,
 						mode,
-						profile: profileSpec(profile).label,
 						model: modelId,
 						library,
 						quote,
@@ -259,7 +251,7 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 	function status(ctx: ExtensionContext): void {
 		modelId = ctx.model ? `${ctx.model.id}` : "no model";
 		const down = bridge ? Object.keys(bridge.errors) : ["zotero", "scholar"];
-		ctx.ui.setStatus("subsub", `Sub-Sub: ${mode} | ${profileSpec(profile).label} | ${modelId}${down.length ? ` | not running: ${down.join(", ")}` : ""}`);
+		ctx.ui.setStatus("subsub", `Sub-Sub: ${mode} | ${modelId}${down.length ? ` | not running: ${down.join(", ")}` : ""}`);
 		if (standalone) ctx.ui.setTitle(`Sub-Sub: ${mode}`);
 		headerTui?.requestRender();
 		webCtx = ctx;
@@ -323,7 +315,7 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 		if (lookOn(ctx)) scheme ??= schemeFromAnsi(ctx.ui.theme.getFgAnsi("text"), ctx.ui.theme.name);
 		applyTheme(ctx);
 		await applyMode(ctx, restored ?? (pi.getFlag("librarian") ? "librarian" : pi.getFlag("researcher") ? "researcher" : cfg.defaultMode), false, !modelChosen);
-		logUsage(cfg.usageLog, { ev: "session", mode, profile, model: ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : undefined });
+		logUsage(cfg.usageLog, { ev: "session", mode, model: ctx.model ? `${ctx.model.provider}/${ctx.model.id}` : undefined });
 		if (lookOn(ctx)) {
 			setHeader(ctx);
 			void refreshLibrary();
@@ -346,6 +338,7 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 
 	/** Prompt commands for the Researcher; the Librarian has the library ones (tag-batch, clean-tags, import-queue). */
 	const RESEARCH_PROMPTS = ["lit", "compare", "lit-note", "synthesis", "gaps", "manuscript", "verify", "review", "alert", "request-copy", "digest"];
+	const researcherOnly = (cmd: string) => L(`Sub-Sub: /${cmd} is part of the Researcher. Switch with /researcher.`, `Sub-Sub: /${cmd} faz parte do Investigador. Mude com /researcher.`);
 
 	// /tree moves to another branch: take that branch's mode (pi restores its model itself).
 	pi.on("session_tree", async (_event, ctx) => {
@@ -392,8 +385,7 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 	});
 
 
-	// Prompt commands that the profile does not run (/lit for Reader, /review for Reader and Scholar).
-	// The input event comes before pi expands a prompt template.
+	// Research prompts in the Librarian. The input event comes before pi expands a prompt template.
 	pi.on("input", async (event, ctx) => {
 		if (resumeTimer) clearTimeout(resumeTimer);
 		resumeTimer = undefined;
@@ -402,13 +394,15 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 		// The usage log keeps the kind of request and its length, never its text.
 		if (cmd !== "subsub-refresh") logUsage(cfg.usageLog, { ev: "ask", kind: cmd ? `/${cmd}` : "message", words: event.text.trim().split(/\s+/).filter(Boolean).length });
 		if (mode === "librarian" && cmd && RESEARCH_PROMPTS.includes(cmd)) {
-			ctx.ui.notify(L(`Sub-Sub: /${cmd} is part of the Researcher. Switch with /researcher.`, `Sub-Sub: /${cmd} faz parte do Investigador. Mude com /researcher.`), "warning");
+			ctx.ui.notify(researcherOnly(cmd), "warning");
 			return { action: "handled" };
 		}
-		const why = promptBlocked(event.text, profile);
-		if (!why) return { action: "continue" };
-		ctx.ui.notify(`Sub-Sub: ${why}`, "warning");
-		return { action: "handled" };
+		// shortcut: a notice for the habit of 0.16 and earlier; drop it a few versions on.
+		if (cmd === "profile") {
+			ctx.ui.notify(L("Sub-Sub no longer has profiles: every command is in the Researcher. To read a paper with guidance, type /read.", "O Sub-Sub já não tem perfis: todos os comandos estão no Investigador. Para ler um artigo com orientação, escreva /read."), "info");
+			return { action: "handled" };
+		}
+		return { action: "continue" };
 	});
 
 	pi.on("agent_start", async () => {
@@ -417,7 +411,7 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 	});
 
 	pi.on("before_agent_start", async (event, ctx) => ({
-		systemPrompt: `${event.systemPrompt}\n\n${systemAddition(mode, { ...cfg, profile }, ctx.cwd)}`,
+		systemPrompt: `${event.systemPrompt}\n\n${systemAddition(mode, cfg, ctx.cwd)}`,
 	}));
 
 	/** Model test (subsub-bench): record every change instead of asking, and apply none. */
@@ -632,34 +626,10 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 		},
 	});
 
-	pi.registerCommand("profile", {
-		description: "Sub-Sub: show or change the profile (reader, scholar, author, editor)",
-		handler: async (args, ctx) => {
-			const want = args.trim().toLowerCase();
-			if (!want) {
-				ctx.ui.notify(`Profile: ${profileSpec(profile).label}. To change it, type /profile <name>.\n${profileList(profile)}`, "info");
-				return;
-			}
-			if (!isProfile(want)) {
-				ctx.ui.notify(`Unknown profile "${want}". Choose one of:\n${profileList(profile)}`, "warning");
-				return;
-			}
-			profile = want;
-			let saved = "";
-			try {
-				saved = ` Saved in ${saveConfig({ profile })}.`;
-			} catch (err) {
-				saved = ` Not saved: ${(err as Error).message}`;
-			}
-			await applyMode(ctx, mode, false, false);
-			ctx.ui.notify(`Sub-Sub: ${profileSpec(profile).label} profile (${profileSpec(profile).summary}).${saved}`, "info");
-		},
-	});
-
 	pi.registerCommand("subsub", {
 		description: "Sub-Sub: Zotero connection and library overview",
 		handler: async (_args, ctx) => {
-			const lines = [`Mode: ${mode}. Profile: ${profileSpec(profile).label}. Model: ${ctx.model?.id ?? "none"}.`];
+			const lines = [`Mode: ${mode}. Model: ${ctx.model?.id ?? "none"}.`];
 			if (!bridge) {
 				ctx.ui.notify(`${lines[0]}\nThe Zotero servers are not running. Try /reload.`, "warning");
 				return;
@@ -695,6 +665,85 @@ export async function createSubsub(pi: ExtensionAPI, deps: SubsubDeps = {}): Pro
 		},
 	});
 
+	// The web view's library search: the result goes to the page through a status, like the library counts.
+	pi.registerCommand("subsub-find", {
+		description: "Sub-Sub: search the library for the web view",
+		handler: async (args, ctx) => {
+			if (ctx.mode !== "rpc") return;
+			const q = String(args ?? "").trim();
+			let out: Record<string, unknown>;
+			try {
+				const r = await current().call("zotero_find_items", { query: q, limit: 25 });
+				out = r.isError ? { error: r.text } : { items: (r.data as { items?: unknown[] })?.items ?? [] };
+			} catch (err) {
+				out = { error: (err as Error).message };
+			}
+			ctx.ui.setStatus("subsub.find", JSON.stringify({ q, ...out }));
+		},
+	});
+
+	pi.registerCommand("ai-statement", {
+		description: "Sub-Sub: a draft statement on the use of AI for a manuscript (what journals ask for)",
+		handler: async (args, ctx) => {
+			const date = new Date().toISOString().slice(0, 10);
+			const text = aiStatement({ version: ownVersion(), models: cfg.models, uses: String(args ?? ""), date, starbuck: starbuckEnabled(cfg) });
+			const dir = join(cfg.vault ?? ctx.cwd, "Research");
+			let file = join(dir, `${date} AI use statement.md`);
+			for (let n = 2; existsSync(file); n++) file = join(dir, `${date} AI use statement-${n}.md`);
+			try {
+				mkdirSync(dir, { recursive: true });
+				writeFileSync(file, text);
+			} catch (err) {
+				ctx.ui.notify(`${text}\n${L("Could not save it", "Não foi possível guardar")}: ${(err as Error).message}`, "warning");
+				return;
+			}
+			ctx.ui.notify(
+				L(
+					`Sub-Sub: a draft statement on the use of AI is in ${file}. Complete the parts in brackets. To name the tasks, type /ai-statement followed by them, for example: /ai-statement literature searches and reading notes.`,
+					`Sub-Sub: há um rascunho da declaração sobre o uso de IA em ${file}. Complete as partes entre parênteses retos. Para indicar as tarefas, escreva /ai-statement seguido delas, por exemplo: /ai-statement literature searches and reading notes.`,
+				),
+				"info",
+			);
+		},
+	});
+
+	// A registered command runs before the input hook, so /read checks the mode itself.
+	pi.registerCommand("read", {
+		description: "Sub-Sub: read a paper with guidance; Sub-Sub finds the passages and asks, you write the answers. /read [background|fact|extract|critique] <citekey, DOI, PMID or title words>",
+		handler: async (args, ctx) => {
+			if (mode === "librarian") return ctx.ui.notify(researcherOnly("read"), "warning");
+			let { purpose, ref } = readArgs(String(args ?? ""));
+			ref ||= (await ctx.ui.input(L("Which paper?", "Que artigo?"), L("citekey, DOI, PMID or title words", "citekey, DOI, PMID ou palavras do título")))?.trim() ?? "";
+			if (!ref) return;
+			if (!purpose) {
+				const labels = Object.values(PURPOSES).map(([en, pt]) => L(en, pt));
+				purpose = (Object.keys(PURPOSES) as Purpose[])[labels.indexOf((await ctx.ui.select(L("Why are you reading it?", "Porque vai ler este artigo?"), labels)) ?? "")];
+				if (!purpose) return;
+			}
+			const req: ReadRequest = { ref, purpose, date: new Date().toISOString().slice(0, 10) };
+			if (purpose === "fact") {
+				req.fact = (await ctx.ui.input(L("Which fact are you looking for?", "Que dado procura?")))?.trim();
+				if (!req.fact) return;
+			}
+			if (purpose === "extract") {
+				let sheets: string[] = [];
+				try {
+					sheets = readdirSync(join(cfg.vault ?? ctx.cwd, "Research")).filter((f) => f.endsWith(" extraction.md")).sort();
+				} catch {
+					// No Research folder yet: the first sheet is a new one.
+				}
+				const fresh = L("New sheet", "Nova folha");
+				const pick = sheets.length ? await ctx.ui.select(L("Which extraction sheet?", "Que folha de extração?"), [...sheets, fresh]) : fresh;
+				if (!pick) return;
+				if (pick === fresh) {
+					req.question = (await ctx.ui.input(L("The question of your review", "A pergunta da sua revisão")))?.trim();
+					if (!req.question) return;
+				} else req.sheet = `Research/${pick}`;
+			}
+			pi.sendUserMessage(readInstruction(req), ctx.isIdle() ? undefined : { deliverAs: "followUp" });
+		},
+	});
+
 	pi.registerCommand("history", {
 		description: "Sub-Sub: recent library changes",
 		handler: async (_args, ctx) => {

package/src/usage.ts

@@ -10,7 +10,7 @@ import { homedir } from "node:os";
 import { dirname, join } from "node:path";
 
 export type UsageEvent =
-	| { ev: "session"; mode: string; profile: string; model?: string }
+	| { ev: "session"; mode: string; model?: string }
 	| { ev: "ask"; kind: string; words: number }
 	| { ev: "turn"; seconds: number; tools: number; error?: string }
 	| { ev: "change"; tool: string; approved: boolean };