@tiagojct/subsub 0.13.1 → 0.14.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 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.14.0 (2026-10-08)
+
+For students:
+
+- `/lit` works in the Reader profile. It gives a reading list: the same search, screening and screening log, then the works to read, the order to read them in, what each one studies and questions to read it with. It states no results or conclusions.
+- The site has a page for students, in English and in European Portuguese: what Sub-Sub does and does not do, how to start for free, what it costs, and the words you will meet.
+- The Models page starts with which model to choose and what it costs. The Install page explains the install command. The About page says what you keep if Sub-Sub stops.
+
 ## 0.13.1 (2026-10-07)
 
 - A change that would change nothing (for example, citekeys for items that already have one) is no longer offered for approval. Sub-Sub says why instead.

package/dist/profiles.js

@@ -4,7 +4,8 @@
  * Scholar. A profile is the user's own choice (/profile changes it), not a lock.
  *
  * - reader:  explains each step; reading notes are quotes with page numbers and
- *            questions; no summaries or syntheses; no bulk library changes.
+ *            questions; no summaries or syntheses; /lit gives a reading list;
+ *            no bulk library changes.
  * - 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.
@@ -16,15 +17,16 @@ export const PROFILE_SPECS = {
     reader: {
         name: "reader",
         label: "Reader",
-        summary: "explains each step; reading notes are quotes and questions; no summaries; no bulk library changes",
+        summary: "explains each step; reading notes are quotes and questions; /lit gives a reading list; no summaries; no bulk library changes",
         without: [...BULK_LIBRARY, ...MANUSCRIPT],
-        withoutPrompts: ["lit", "compare", "review", "digest"],
+        withoutPrompts: ["compare", "review", "digest"],
         batch: 10,
         rules: [
             "Profile: Reader. {{User}} is learning to work with the literature and wants to do the reading and the writing.",
             "- Before each step, say in one or two lines what you will do and why.",
             "- 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.",
+            "- /lit gives a reading list, not a review: plan, search, screen and read as the prompt says, then write the note in the Reader form that the prompt gives (no answer, no agreement or disagreement, no conclusions).",
             "- 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.",
             "- Tag review notes: at most 10 items. Explain each proposed tag in the Reason column.",
         ].join("\n"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tiagojct/subsub",
-  "version": "0.13.1",
+  "version": "0.14.0",
   "description": "Sub-Sub: a research assistant that works from your own Zotero library, in the browser or the terminal, built on pi",
   "type": "module",
   "license": "MIT",

package/prompts/lit.md

@@ -84,4 +84,25 @@ reference_check: "<path of the Starbuck report, or none>"
 
 If a step fails (a service does not answer, a full text cannot be read), do not stop. Finish the note, mark the step "BLOCKED: <what failed>", and set verification: BLOCKED.
 
+## In the Reader profile: a reading list
+
+When the profile is Reader, do sections 1, 2, 4 and 5 as written, but do not synthesise (skip section 3). Write the note with `type: reading-list` and this body in place of Answer, Agreement, Disagreement and Open questions:
+
+```markdown
+## How to read this list
+(two or three lines: the order to read the works in, and why; for example the systematic review first, then the trials)
+
+## Reading list
+| # | Source | Design | Population | What it studies | Read | In library |
+|---|---|---|---|---|---|---|
+
+## Questions to read with
+(for each work, one or two questions that the user answers while reading, such as "How was asthma control measured, and when?")
+
+## Methods
+## Sources
+```
+
+"What it studies" says what the work asks and how, never what it found. Do not state results, effect sizes or conclusions anywhere in the note. Then give the user the path, the first work to read and why, and the works worth adding to the library.
+
 Before you answer, read the note back to confirm that it exists. Then give the user the path, the answer in three lines, and the works worth adding to the library (offer to import them).

package/src/profiles.ts

@@ -4,7 +4,8 @@
  * Scholar. A profile is the user's own choice (/profile changes it), not a lock.
  *
  * - reader:  explains each step; reading notes are quotes with page numbers and
- *            questions; no summaries or syntheses; no bulk library changes.
+ *            questions; no summaries or syntheses; /lit gives a reading list;
+ *            no bulk library changes.
  * - 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.
@@ -36,15 +37,16 @@ export const PROFILE_SPECS: Record<Profile, ProfileSpec> = {
 	reader: {
 		name: "reader",
 		label: "Reader",
-		summary: "explains each step; reading notes are quotes and questions; no summaries; no bulk library changes",
+		summary: "explains each step; reading notes are quotes and questions; /lit gives a reading list; no summaries; no bulk library changes",
 		without: [...BULK_LIBRARY, ...MANUSCRIPT],
-		withoutPrompts: ["lit", "compare", "review", "digest"],
+		withoutPrompts: ["compare", "review", "digest"],
 		batch: 10,
 		rules: [
 			"Profile: Reader. {{User}} is learning to work with the literature and wants to do the reading and the writing.",
 			"- Before each step, say in one or two lines what you will do and why.",
 			"- 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.",
+			"- /lit gives a reading list, not a review: plan, search, screen and read as the prompt says, then write the note in the Reader form that the prompt gives (no answer, no agreement or disagreement, no conclusions).",
 			"- 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.",
 			"- Tag review notes: at most 10 items. Explain each proposed tag in the Reason column.",
 		].join("\n"),

package/web/i18n.js

@@ -260,7 +260,7 @@ export const STRINGS = {
  */
 export const ACTIONS = {
 	research: [
-		{ cmd: "lit", fill: true, profiles: ["scholar", "author", "editor"], en: "Literature review", pt: "Revisão da literatura" },
+		{ cmd: "lit", fill: true, en: "Literature review", pt: "Revisão da literatura" },
 		{ cmd: "compare", fill: true, profiles: ["scholar", "author", "editor"], en: "Compare sources", pt: "Comparar fontes" },
 		{ cmd: "lit-note", fill: true, en: "Literature note", pt: "Nota de leitura" },
 		{ cmd: "synthesis", fill: true, en: "Synthesis", pt: "Síntese" },