ultimate-brain 0.3.2 → 0.4.1

package/dist/lib/sync.js

@@ -6,9 +6,10 @@ import { assertNoProblems, isRecord, unknownKeys } from "./input.js";
 import { generateId, TYPE_PREFIX } from "./ids.js";
 import { assertStagedValid, checkNoteInput, stageNotes } from "./note-new.js";
 import { compareCodePoints } from "./notes.js";
+import { fullText, splitParts } from "./parts.js";
 import { loadSchemas } from "./schemas.js";
 import { formatDate, formatTimestamp, normalizeTimestamp } from "./time.js";
-const DATABASES = ["areas", "goals", "key_results", "projects", "people", "orgs", "decisions", "questions", "concepts", "review"];
+const DATABASES = ["areas", "goals", "key_results", "projects", "people", "orgs", "decisions", "questions", "concepts", "review", "inbox"];
 const CREATABLE = new Set(["areas", "goals", "projects", "people", "orgs"]);
 const TYPE_FOR_DATABASE = { areas: "area", goals: "goal", projects: "project", people: "person", orgs: "org", decisions: "decision", questions: "question", concepts: "concept", review: "proposal" };
 const DATABASE_FOR_TYPE = { area: "areas", goal: "goals", project: "projects", person: "people", org: "orgs", decision: "decisions", question: "questions", concept: "concepts", source: "inbox", meeting: "meetings", proposal: "review" };
@@ -71,7 +72,7 @@ export function parseSnapshot(input) {
 }
 /** Compute the deterministic, no-network Notion pull plan (cli §5.14.2). */
 export function buildPlan(workspace, snapshot) {
-    const result = { as_of: snapshot.as_of, create: [], updates: [], corrections: [], decisions: [], conflicts: [], ignored: [] };
+    const result = { as_of: snapshot.as_of, create: [], updates: [], corrections: [], decisions: [], full_text_requests: [], conflicts: [], ignored: [] };
     const createsByPage = new Map();
     for (const row of snapshot.rows)
         if (CREATABLE.has(row.database) && blank(property(row.properties, "Brain ID"))) {
@@ -84,6 +85,10 @@ export function buildPlan(workspace, snapshot) {
             planKeyResult(workspace, snapshot.as_of, row, result);
             continue;
         }
+        if (row.database === "inbox") {
+            planInbox(workspace, row, result);
+            continue;
+        }
         const brainId = property(row.properties, "Brain ID");
         let note = typeof brainId === "string" && brainId !== "" ? workspace.get(brainId) : noteByNotion(workspace, row.page_id);
         if (typeof brainId === "string" && brainId !== "" && note === undefined) {
@@ -318,6 +323,31 @@ function planDecision(row, proposal, out) {
     }
     out.decisions.push({ proposal: proposal.id, action: action, ...(action === "edit" ? { value: note, note: note } : {}), decided_at: row.last_edited, decided_by: "notion" });
 }
+/** An Inbox row is read only for its Full text box (cli §5.14.2, 0043). */
+function planInbox(workspace, row, out) {
+    if (property(row.properties, "Full text") !== true)
+        return;
+    const brainId = property(row.properties, "Brain ID");
+    const ignore = (id) => out.ignored.push({ database: row.database, page_id: row.page_id, brain_id: id, property: "Full text", reason: "NO_FULL_TEXT" });
+    if (typeof brainId !== "string" || brainId === "") {
+        ignore(null);
+        return;
+    }
+    const note = workspace.get(brainId);
+    if (note === undefined) {
+        out.conflicts.push(conflict(row, "UNKNOWN_BRAIN_ID", `No note has Brain ID ${brainId}`));
+        return;
+    }
+    if (hasInboxBody(note))
+        out.full_text_requests.push({ page_id: row.page_id, source: note.id });
+    else
+        ignore(note.id);
+}
+/** A source whose Inbox row the brain writes: not minutes, a capture or an attached file (0042, 0043). */
+export function hasInboxBody(note) {
+    const kind = note.attributes.kind;
+    return note.type === "source" && kind !== undefined && kind !== "minutes" && kind !== "capture" && note.attributes.attached_to === undefined;
+}
 function planKeyResult(workspace, asOf, row, out) {
     const goals = relationIds(workspace, property(row.properties, "Goal"), out.conflicts, row, "Goal");
     const goal = goals?.[0];
@@ -339,7 +369,7 @@ function planKeyResult(workspace, asOf, row, out) {
 }
 function sortPlan(plan) {
     const order = (item) => [DATABASES.indexOf(String(item.database)), String(item.page_id ?? item.id), String(item.field ?? item.property ?? "")].join("\u0000");
-    for (const values of [plan.create, plan.updates, plan.corrections, plan.decisions, plan.conflicts, plan.ignored])
+    for (const values of [plan.create, plan.updates, plan.corrections, plan.decisions, plan.full_text_requests, plan.conflicts, plan.ignored])
         values.sort((a, b) => order(a).localeCompare(order(b)));
 }
 function notionFields(database, p, asOf) {
@@ -416,7 +446,9 @@ export function parsePlan(input) {
     if (!isRecord(input))
         assertNoProblems([{ pointer: "", message: "must be an object" }]);
     const p = input;
-    const problems = unknownKeys(p, ["as_of", "create", "updates", "corrections", "decisions", "conflicts", "ignored"], "");
+    const problems = unknownKeys(p, ["as_of", "create", "updates", "corrections", "decisions", "full_text_requests", "conflicts", "ignored"], "");
+    if (p.full_text_requests !== undefined && !Array.isArray(p.full_text_requests))
+        problems.push({ pointer: "/full_text_requests", message: "must be a list" });
     if (!isTimestamp(p.as_of))
         problems.push({ pointer: "/as_of", message: "must be an ISO 8601 UTC timestamp" });
     for (const key of ["create", "updates", "corrections", "decisions", "conflicts", "ignored"])
@@ -434,7 +466,7 @@ export function parsePlan(input) {
             problems.push({ pointer: `/create/${index}/lifecycle`, message: "must be a lifecycle string" });
     });
     assertNoProblems(problems);
-    return { ...p, as_of: normalizeTimestamp(p.as_of) };
+    return { ...p, full_text_requests: p.full_text_requests ?? [], as_of: normalizeTimestamp(p.as_of) };
 }
 export function applyPlan(workspace, plan, now, recordOnly) {
     const create = [];
@@ -506,7 +538,7 @@ export function applyPlan(workspace, plan, now, recordOnly) {
         ...updates.filter((item) => item.result === "applied").map((item) => ({ op: "sync-update", id: String(item.id), title: String(workspace.get(String(item.id))?.attributes.title ?? item.id) })),
         ...(correctionApply?.log ?? []), ...(decisionApply.log ?? []),
     ];
-    return { create, updates, corrections, decisions: decisionResult, conflicts: plan.conflicts, ignored: plan.ignored, summary: summarize([...create, ...updates, ...corrections, ...decisionResult].map((item) => ({ ...item }))), log };
+    return { create, updates, corrections, decisions: decisionResult, full_text_requests: plan.full_text_requests, conflicts: plan.conflicts, ignored: plan.ignored, summary: summarize([...create, ...updates, ...corrections, ...decisionResult].map((item) => ({ ...item }))), log };
 }
 function references(value) { if (Array.isArray(value))
     return value.flatMap(references); if (isRecord(value))
@@ -515,19 +547,34 @@ function summarize(items) { const result = { applied: 0, closed: 0, recorded: 0,
     if (typeof item.result === "string" && Object.hasOwn(result, item.result))
         result[item.result] += 1; return result; }
 export function render(workspace, now, ids, held) {
-    const selected = ids === undefined ? workspace.notes.filter((note) => PUBLISHED_TYPES.has(note.type) && !(note.type === "source" && note.attributes.kind === undefined)) : ids.map((id) => workspace.get(id)).filter(Boolean);
+    const selected = ids === undefined
+        ? workspace.notes.filter((note) => (PUBLISHED_TYPES.has(note.type) && !(note.type === "source" && note.attributes.kind === undefined)) || (isReport(note) && note.attributes.notion === undefined))
+        : ids.map((id) => workspace.get(id)).filter(Boolean);
     const items = [];
     const errors = [];
     const warnings = [];
     for (const note of selected) {
-        const database = DATABASE_FOR_TYPE[note.type];
+        const database = isReport(note) ? "inbox" : DATABASE_FOR_TYPE[note.type];
         if (database === undefined || (note.type === "source" && note.attributes.kind === undefined))
             continue;
+        // A published report is never rendered again (0043).
+        if (isReport(note) && note.attributes.notion !== undefined)
+            continue;
+        // An attached source has no Inbox row: its notes go on the parent's (0042).
+        if (note.type === "source" && note.attributes.attached_to !== undefined)
+            continue;
+        // A decided Review row leaves Notion 30 days after its decision, once (0045).
+        if (note.type === "proposal" && isRecord(note.attributes.notion_published) && note.attributes.notion_published["@trashed"] !== undefined)
+            continue;
         const databaseId = databaseIdFor(workspace, database);
         if (databaseId === "") {
             warnings.push({ code: "DATABASE_NOT_CONFIGURED", message: `${database} database is not configured`, id: note.id });
             continue;
         }
+        if (note.type === "proposal" && trashDue(note, now)) {
+            items.push({ id: note.id, type: note.type, database, database_id: databaseId, page_id: String(note.attributes.notion), action: "trash", properties: {}, body: null, sections: null, pending_relations: [], published: { "@trashed": formatTimestamp(now) } });
+            continue;
+        }
         if (note.type === "meeting" && typeof note.attributes.notion !== "string") {
             errors.push({ id: note.id, reason: "MEETING_NOT_PUBLISHED" });
             continue;
@@ -546,7 +593,7 @@ export function render(workspace, now, ids, held) {
         const properties = {};
         const pending = [];
         const heldProperties = held?.get(note.id) ?? new Set();
-        const isCreate = note.attributes.notion === undefined && capturePage === undefined;
+        const isCreate = isReport(note) || (note.attributes.notion === undefined && capturePage === undefined);
         for (const [name, value] of Object.entries(rendered)) {
             if (name === "@content" || heldProperties.has(name) || (capturePage !== undefined && name === "Name"))
                 continue;
@@ -558,7 +605,16 @@ export function render(workspace, now, ids, held) {
         if (content.hash !== undefined)
             rendered["@content"] = content.hash;
         const contentChanged = content.hash !== undefined && !isDeepStrictEqual(content.hash, published["@content"]);
-        if (!isCreate && Object.keys(properties).length === 0 && !contentChanged)
+        // Full text (0043): the text goes out once per choice, and a ticked box is cleared once per request.
+        const full = note.type === "source" && hasInboxBody(note) ? fullTextDue(note, published["@full_text"]) : undefined;
+        if (full?.sections !== undefined)
+            content.sections = { ...(content.sections ?? {}), ...full.sections };
+        if (full?.clear === true)
+            properties["Full text"] = { type: "checkbox", value: false };
+        if (full !== undefined && (full.sections !== undefined || full.clear))
+            rendered["@full_text"] = full.record;
+        const fullTextDueNow = full !== undefined && (full.sections !== undefined || full.clear);
+        if (!isCreate && Object.keys(properties).length === 0 && !contentChanged && !fullTextDueNow)
             continue;
         if (!isCreate && note.type !== "meeting" && note.type !== "proposal")
             properties["Last Synced"] = { type: "date", value: { start: formatTimestamp(now), end: null } };
@@ -567,6 +623,16 @@ export function render(workspace, now, ids, held) {
     items.sort((a, b) => DATABASES.concat(["meetings"]).indexOf(a.database) - DATABASES.concat(["meetings"]).indexOf(b.database) || compareCodePoints(a.id, b.id));
     return { items, errors, warnings };
 }
+const TRASH_AFTER_MS = 30 * 24 * 60 * 60 * 1000;
+/** A published Review row whose proposal was applied or closed more than 30 days before `now` (0045). */
+function trashDue(note, now) {
+    const a = note.attributes;
+    if (typeof a.notion !== "string" || (a.status !== "applied" && a.status !== "closed"))
+        return false;
+    const decided = isRecord(a.decision) && typeof a.decision.decided_at === "string" ? a.decision.decided_at : a.updated;
+    const time = typeof decided === "string" ? Date.parse(decided) : Number.NaN;
+    return Number.isFinite(time) && now.getTime() - time > TRASH_AFTER_MS;
+}
 function databaseIdFor(workspace, database) { const notion = workspace.config.notion; if (!isRecord(notion) || !isRecord(notion.databases))
     return ""; return typeof notion.databases[database] === "string" ? notion.databases[database] : database === "inbox" && typeof notion.databases.capture_inbox === "string" ? notion.databases.capture_inbox : ""; }
 function renderedBrainValues(note, workspace) {
@@ -578,15 +644,26 @@ function renderedBrainValues(note, workspace) {
         const addLink = a.kind === "add_link";
         const after = addLink
             ? proposalLinks(a).map((link) => `${fieldLabel(String(link.field))}: ${noteTitle(link.value, workspace)}`).join("\n")
-            : undefined;
+            : a.kind === "review_notes" ? reviewNotesAfter(a, workspace) : undefined;
         const reviewText = (value) => truncate(typeof value === "string" ? reviewMarkdown(value, target) : value);
+        // A Review notes row names its source: the meeting for minutes, else the source (0041).
+        const source = a.kind === "review_notes" && typeof a.source === "string" ? workspace.get(a.source) : undefined;
+        const targetText = source !== undefined ? `${source.attributes.title} (${source.id})` : target === undefined ? null : `${target.attributes.title} (${target.id})`;
+        const page = (source ?? target)?.attributes.notion;
+        const meeting = typeof a.source === "string" ? workspace.get(a.source) : undefined;
         Object.assign(values, {
-            Name: a.title, Kind: select(a.kind), Target: target === undefined ? null : `${target.attributes.title} (${target.id})`,
+            Name: a.title, Kind: select(a.kind), Target: targetText,
+            "Target Page": typeof page === "string" ? `https://www.notion.so/${page.replaceAll("-", "")}` : null,
+            "Source Meeting": meeting?.type === "meeting" && typeof meeting.attributes.notion === "string" ? [meeting.attributes.notion] : [],
             Before: reviewText(proposalBefore(a, workspace)), After: reviewText(after ?? proposalAfter(a, workspace)),
             Why: reviewText(a.why), State: select(proposalState(a.status)), "Brain ID": note.id,
         });
         return values;
     }
+    if (isReport(note)) {
+        Object.assign(values, { Name: a.title, Kind: "Report", Project: relationPages(a.projects, workspace), Area: relationPages(a.area === undefined ? [] : [a.area], workspace), Ask: typeof a.asked_in === "string" ? [a.asked_in] : [], "Brain Status": "Processed", "Brain ID": note.id });
+        return values;
+    }
     if (note.type === "meeting") {
         Object.assign(values, { Decisions: relationPages(a.decisions, workspace), Questions: relationPages(a.questions, workspace), Attendees: relationPages(a.attendees, workspace), Project: relationPages(a.projects, workspace), Area: relationPages(a.area === undefined ? [] : [a.area], workspace), "Brain Status": "Ingested", "Ingested At": dateOutput(a.created), "Brain ID": note.id });
         return values;
@@ -604,6 +681,17 @@ function renderedBrainValues(note, workspace) {
         Object.assign(values, { Date: dateOutput(a.date), Assessment: select(a.assessment), Area: relationPages(projectAreas(a.projects, workspace), workspace), Project: relationPages(a.projects, workspace), "Decided In": relationPages(a.decided_in === undefined ? [] : [a.decided_in], workspace), Supersedes: relationPages((Array.isArray(a.relations) ? a.relations.filter(isRecord).filter((x) => x.type === "supersedes").map((x) => x.target) : []), workspace) });
     if (note.type === "question")
         Object.assign(values, { Kind: select(a.kind), Area: relationPages(projectAreas(a.projects, workspace), workspace), Project: relationPages(a.projects, workspace), "Raised In": relationPages(a.raised_in === undefined ? [] : [a.raised_in], workspace) });
+    // Status goes out once as Open while you never set one, and once as Answered after an approved answer; it stays yours otherwise (0041, 0045).
+    if (note.type === "question") {
+        const published = isRecord(a.notion_published) ? a.notion_published : {};
+        const yours = isRecord(a.notion_fields) && a.notion_fields.status !== undefined;
+        if (a.answer !== undefined) {
+            if (published.Status !== "Answered")
+                values.Status = "Answered";
+        }
+        else if (published.Status === undefined && !yours)
+            values.Status = "Open";
+    }
     if (note.type === "concept")
         Object.assign(values, { Project: relationPages(a.projects, workspace), Area: relationPages(a.area === undefined ? [] : [a.area], workspace) });
     return values;
@@ -616,8 +704,13 @@ function projectAreas(projects, workspace) {
     });
     return [...new Set(areas)].sort(compareCodePoints);
 }
+/** The notes a source produced, with those of the sources attached to it (cli §5.14.4, 0042). */
+function producedBy(note, workspace) {
+    const sources = new Set([note.id, ...workspace.notes.filter((candidate) => candidate.type === "source" && candidate.attributes.attached_to === note.id).map((candidate) => candidate.id)]);
+    return workspace.notes.filter((candidate) => ["decision", "question", "concept", "person"].includes(candidate.type) && Array.isArray(candidate.attributes.sources) && candidate.attributes.sources.some((id) => sources.has(String(id))));
+}
 function sourceValues(note, workspace) {
-    const produced = workspace.notes.filter((candidate) => ["decision", "question", "concept", "person"].includes(candidate.type) && Array.isArray(candidate.attributes.sources) && candidate.attributes.sources.includes(note.id));
+    const produced = producedBy(note, workspace);
     const ids = (type) => produced.filter((candidate) => candidate.type === type).map((candidate) => candidate.id).sort(compareCodePoints);
     const projects = [...new Set(produced.flatMap((candidate) => Array.isArray(candidate.attributes.projects) ? candidate.attributes.projects.filter((id) => typeof id === "string") : []))].sort(compareCodePoints);
     const areas = [...new Set([...produced.map((candidate) => candidate.attributes.area).filter((id) => typeof id === "string"), ...projects.flatMap((id) => { const area = workspace.get(id)?.attributes.area; return typeof area === "string" ? [area] : []; })])].sort(compareCodePoints);
@@ -634,14 +727,24 @@ function notionProperty(name, value, note, workspace, pending) {
         const mode = (note.type === "meeting" || note.type === "source") ? (["Project", "Area"].includes(name) ? "if_empty" : note.type === "meeting" ? "add" : undefined) : undefined;
         return { type: "relation", value: Array.isArray(value) ? value : [], ...(mode === undefined ? {} : { mode }) };
     }
-    if (["Lifecycle", "Assessment", "Kind", "State", "Brain Status"].includes(name))
+    if (name === "Source Meeting") {
+        const meeting = typeof note.attributes.source === "string" ? workspace.get(note.attributes.source) : undefined;
+        if (meeting?.type === "meeting" && typeof meeting.attributes.notion !== "string")
+            pending.push({ property: name, ids: [meeting.id] });
+        return { type: "relation", value: Array.isArray(value) ? value : [] };
+    }
+    if (name === "Ask")
+        return { type: "relation", value: Array.isArray(value) ? value : [] };
+    if (name === "Target Page")
+        return { type: "url", value };
+    if (["Lifecycle", "Assessment", "Kind", "State", "Brain Status", "Status"].includes(name))
         return { type: "select", value };
     if (name === "Last Synced" || name === "Date" || name === "Deadline" || name === "Ingested At")
         return { type: "date", value };
     return { type: name === "Name" ? "title" : "rich_text", value };
 }
 function sourceRelationIds(note, name, workspace) {
-    const produced = workspace.notes.filter((candidate) => ["decision", "question", "concept", "person"].includes(candidate.type) && Array.isArray(candidate.attributes.sources) && candidate.attributes.sources.includes(note.id));
+    const produced = producedBy(note, workspace);
     if (name === "Decisions")
         return produced.filter((candidate) => candidate.type === "decision").map((candidate) => candidate.id);
     if (name === "Questions")
@@ -662,15 +765,37 @@ function proposalLinks(attributes) {
         return attributes.links.filter(isRecord).map((link) => ({ field: link.field, value: link.value }));
     return attributes.field === undefined ? [] : [{ field: attributes.field, value: attributes.after }];
 }
-function renderedContent(note, workspace) { if (note.type === "decision" || note.type === "question" || note.type === "concept") {
-    const body = notionMarkdown(note.body, note, workspace);
-    return { body, sections: null, hash: hash(body) };
-} if (note.type === "project") {
-    const brief = workspace.notes.find((x) => x.path === `${note.path.slice(0, note.path.lastIndexOf("/"))}/brief.md`);
-    const log = workspace.notes.find((x) => x.path === `${note.path.slice(0, note.path.lastIndexOf("/"))}/decision-log.md`);
-    const sections = { Brief: notionMarkdown(generatedBlock(brief?.body ?? ""), note, workspace), "Decision log": notionMarkdown(generatedBlock(log?.body ?? ""), note, workspace) };
-    return { body: null, sections, hash: hash(JSON.stringify(sections)) };
-} return { body: null, sections: null }; }
+function renderedContent(note, workspace) {
+    if (note.type === "area") {
+        const brief = workspace.notes.find((x) => x.type === "view" && x.attributes.view_kind === "area_brief" && x.attributes.area === note.id);
+        if (brief === undefined)
+            return { body: null, sections: null };
+        const sections = { Brief: notionMarkdown(generatedBlock(brief.body), brief, workspace) };
+        return { body: null, sections, hash: hash(JSON.stringify(sections)) };
+    }
+    // A source's digest is written once; its Full text is tracked by @full_text, not @content (0043).
+    if (note.type === "source") {
+        if (!hasInboxBody(note))
+            return { body: null, sections: null };
+        const body = digestBody(note);
+        return { body, sections: null, hash: hash(body) };
+    }
+    if (isReport(note)) {
+        const body = notionMarkdown(note.body.replace(/^\n+/, ""), note, workspace);
+        return { body, sections: null, hash: hash(body) };
+    }
+    if (note.type === "decision" || note.type === "question" || note.type === "concept") {
+        const body = notionMarkdown(note.body, note, workspace);
+        return { body, sections: null, hash: hash(body) };
+    }
+    if (note.type === "project") {
+        const brief = workspace.notes.find((x) => x.path === `${note.path.slice(0, note.path.lastIndexOf("/"))}/brief.md`);
+        const log = workspace.notes.find((x) => x.path === `${note.path.slice(0, note.path.lastIndexOf("/"))}/decision-log.md`);
+        const sections = { Brief: notionMarkdown(generatedBlock(brief?.body ?? ""), note, workspace), "Decision log": notionMarkdown(generatedBlock(log?.body ?? ""), note, workspace) };
+        return { body: null, sections, hash: hash(JSON.stringify(sections)) };
+    }
+    return { body: null, sections: null };
+}
 function generatedBlock(body) { const start = body.indexOf("<!-- @generated:start -->"); const end = body.indexOf("<!-- @generated:end -->"); return start >= 0 && end > start ? body.slice(start + "<!-- @generated:start -->".length, end).trim() : body.trim(); }
 function notionMarkdown(body, source, workspace) { const fromFolder = source.path.includes("/") ? source.path.slice(0, source.path.lastIndexOf("/")) : ""; return body.replace(/\^\[(inferred|ambiguous)\]/g, (_, kind) => kind === "inferred" ? " (AI inference)" : " (ambiguous)").replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_all, title, link) => { const targetPath = normalizeRelative(fromFolder, link); const target = workspace.notes.find((note) => note.path === targetPath); return typeof target?.attributes.notion === "string" ? `[${title}](https://www.notion.so/${target.attributes.notion.replaceAll("-", "")})` : title; }); }
 function reviewMarkdown(body, target) {
@@ -699,8 +824,45 @@ function personTitle(value, workspace) { return typeof value === "string" && wor
 function noteTitle(value, workspace) { return typeof value === "string" ? workspace.get(value)?.attributes.title ?? value : value ?? null; }
 function fieldLabel(field) { return field[0]?.toUpperCase() + field.slice(1).replaceAll("_", " "); }
 function truncate(value) { return typeof value === "string" ? value.slice(0, 2000) : value; }
+/** The lettered lines of a Review notes row: its notes, then its links (cli §5.14.4). */
+function reviewNotesAfter(attributes, workspace) {
+    const notes = (Array.isArray(attributes.notes) ? attributes.notes : []).map((id) => {
+        const note = workspace.get(String(id));
+        return `${note === undefined ? "Note" : fieldLabel(note.type)}: ${String(noteTitle(id, workspace))}`;
+    });
+    const links = (Array.isArray(attributes.links) ? attributes.links.filter(isRecord) : []).map((link) => `${fieldLabel(String(link.field))} on ${String(noteTitle(link.target, workspace))}: ${String(noteTitle(link.value, workspace))}`);
+    return [...notes, ...links].map((line, index) => `${letters(index)}) ${line}`).join("\n");
+}
+/** a, b, … z, then aa, ab, … */
+export function letters(index) {
+    return index < 26 ? String.fromCharCode(97 + index) : `${letters(Math.floor(index / 26) - 1)}${letters(index % 26)}`;
+}
+function isReport(note) { return note.type === "view" && note.attributes.view_kind === "report"; }
+/**
+ * Whether a source's Full text is due (cli §5.14.4): B of `@full_text` against S. The text goes out
+ * when it is chosen and S doesn't hold the same choice; the box is cleared when a request is new.
+ */
+function fullTextDue(note, stored) {
+    const a = note.attributes;
+    const record = { text: a.notion_text ?? "digest", parts: Array.isArray(a.notion_parts) ? a.notion_parts : null, requested: a.notion_text_requested ?? null };
+    const s = isRecord(stored) ? stored : undefined;
+    const send = record.text === "full" && (s === undefined || s.text !== record.text || !isDeepStrictEqual(s.parts ?? null, record.parts));
+    const clear = record.requested !== null && record.requested !== (s?.requested ?? null);
+    return { record, ...(send ? { sections: { "Full text": fullText(note.body, record.parts) } } : {}), clear };
+}
+/** A brain-created Inbox row's body: a line about the source, its summary and its digest (cli §5.14.4). */
+function digestBody(note) {
+    const a = note.attributes;
+    const origin = typeof a.file_name === "string" ? a.file_name : typeof a.source_key === "string" && a.source_key.startsWith("url:") ? a.source_key.slice(4) : "pasted text";
+    const date = typeof a.captured === "string" ? a.captured.slice(0, 10) : "";
+    const fileDate = /^sources\/[^/]+\/(\d{4}-\d{2}-\d{2})-/.exec(note.path)?.[1] ?? date;
+    const parts = splitParts(note.body);
+    const words = note.body.split(/\s+/).filter((word) => word !== "").length;
+    const line = `*${String(select(a.kind))} · ${origin} · ${fileDate} · ${words} words${parts.kind === "slides" ? ` · ${parts.parts.length} slides` : ""}*`;
+    return [line, typeof a.summary === "string" ? a.summary : undefined, typeof a.digest === "string" ? a.digest.replace(/\n+$/, "") : undefined].filter((part) => part !== undefined).join("\n\n");
+}
 function proposalBefore(attributes, workspace) {
-    if (attributes.kind === "add_link")
+    if (attributes.kind === "add_link" || attributes.kind === "review_notes" || attributes.kind === "answer")
         return null;
     if (attributes.kind === "supersede")
         return truncate(noteTitle(attributes.supersedes, workspace));
@@ -717,6 +879,8 @@ function proposalAfter(attributes, workspace) {
         return noteTitle(attributes.target, workspace);
     if (attributes.kind === "merge")
         return noteTitle(attributes.merge_into, workspace);
+    if (attributes.kind === "answer")
+        return `${String(attributes.answer)}${attributes.answer_note === undefined ? "" : ` → ${String(noteTitle(attributes.answer_note, workspace))}`}`;
     return attributes.after ?? null;
 }
 export function renderTasks(workspace, targetId, input) {
@@ -823,7 +987,7 @@ export function record(workspace, input) {
             }
             if (isRecord(entry.published))
                 doc.attributes.notion_published = { ...(isRecord(doc.attributes.notion_published) ? doc.attributes.notion_published : {}), ...entry.published };
-            if (note.type !== "view" && note.type !== "proposal")
+            if ((note.type !== "view" || isReport(note)) && note.type !== "proposal")
                 doc.attributes.last_synced = syncedAt;
             if ((note.type === "meeting" || note.type === "source") && Array.isArray(entry.tasks))
                 doc.attributes.tasks = [...new Set([...(Array.isArray(doc.attributes.tasks) ? doc.attributes.tasks : []), ...entry.tasks.filter((id) => typeof id === "string")])];

package/dist/lib/views.js

@@ -1,12 +1,12 @@
 import { posix } from "node:path";
 import { compareCodePoints } from "./notes.js";
 const CURRENT_ASSESSMENTS = new Set(["accepted", "provisional", "contested"]);
-/** Render one project view from canonical notes only (spec/schema.md §16). */
+/** Render one project view, or an area's brief, from canonical notes only (spec/schema.md §16). */
 export function deriveView(project, kind, notes) {
     const canonical = notes.filter((note) => note.type !== "view");
     const byId = new Map(canonical.map((note) => [note.id, note]));
     const generated = new Set([project.id]);
-    const link = (note) => noteLink(projectViewPath(project, kind), note);
+    const link = (note) => noteLink(kind === "area_brief" ? areaBriefPath(project) : projectViewPath(project, kind), note);
     const title = (note) => text(note.attributes.title);
     const add = (note) => {
         generated.add(note.id);
@@ -14,10 +14,16 @@ export function deriveView(project, kind, notes) {
     };
     const sections = kind === "brief"
         ? briefSections(project, canonical, byId, title, add)
-        : decisionLogSections(project, canonical, byId, title, add, link);
+        : kind === "area_brief"
+            ? areaBriefSections(project, canonical, byId, title, add)
+            : decisionLogSections(project, canonical, byId, title, add, link);
     const generatedBlock = ["<!-- @generated:start -->", ...sections.flatMap((section, index) => index === 0 ? section : ["", ...section]), "<!-- @generated:end -->"].join("\n");
     return { kind, generatedBlock, generatedFrom: [...generated].sort(compareCodePoints) };
 }
+/** An area's brief: `areas/briefs/<slug of the area's file name>.md` (spec/schema.md §16.3). */
+export function areaBriefPath(area) {
+    return `areas/briefs/${posix.basename(area.path, ".md")}.md`;
+}
 /** The standard view filename beside a project's `project.md`. */
 export function projectViewPath(project, kind) {
     return `${posix.dirname(project.path)}/${kind === "brief" ? "brief.md" : "decision-log.md"}`;
@@ -59,25 +65,57 @@ function briefSections(project, notes, byId, title, add) {
             const role = scalar(record(person.attributes.facts).role);
             return `- ${add(person)}${role === undefined ? "" : ` — ${role}`}`;
         }))];
-    const decisions = notes
-        .filter((note) => note.type === "decision" && belongsToProject(note, project) && CURRENT_ASSESSMENTS.has(String(note.attributes.assessment)))
+    const decisionsSection = recentDecisions(notes, (note) => belongsToProject(note, project), add);
+    const questionsSection = openQuestions(notes, (note) => belongsToProject(note, project), add, Infinity);
+    const meetings = notes
+        .filter((note) => note.type === "meeting" && belongsToProject(note, project))
         .sort(sortDescendingBy("date"))
         .slice(0, 5);
-    const decisionsSection = ["## Recent decisions", ...(decisions.length === 0 ? ["- None"] : decisions.map((decision) => `- ${text(decision.attributes.date)} — ${add(decision)} (${text(decision.attributes.assessment)})`))];
-    const questions = notes
-        .filter((note) => note.type === "question" && belongsToProject(note, project))
+    const meetingsSection = ["## Recent meetings", ...(meetings.length === 0 ? ["- None"] : meetings.map((meeting) => `- ${text(meeting.attributes.date)} — ${add(meeting)}`))];
+    return [status, goalSection, peopleSection, decisionsSection, questionsSection, meetingsSection];
+}
+/** An area's brief (spec/schema.md §16.3). */
+function areaBriefSections(area, notes, byId, title, add) {
+    const projects = notes
+        .filter((note) => note.type === "project" && note.attributes.area === area.id && record(note.attributes.notion_fields).archived !== true)
+        .sort((left, right) => compareCodePoints(title(left), title(right)) || compareCodePoints(left.id, right.id));
+    const projectsSection = ["## Projects", ...(projects.length === 0 ? ["- None"] : projects.map((project) => {
+            const status = scalar(record(project.attributes.notion_fields).status);
+            return `- ${add(project)}${status === undefined ? "" : ` — ${status}`}`;
+        }))];
+    // A note belongs to the area through its own area or the area of one of its projects.
+    const belongs = (note) => note.attributes.area === area.id
+        || list(note.attributes.projects).some((id) => typeof id === "string" && byId.get(id)?.attributes.area === area.id);
+    return [projectsSection, recentDecisions(notes, belongs, add), openQuestions(notes, belongs, add, 10)];
+}
+/** `## Recent decisions`: reviewed current decisions, newest first, at most 5 (spec/schema.md §16.1 item 4). */
+function recentDecisions(notes, belongs, add) {
+    const candidates = notes
+        .filter((note) => note.type === "decision" && belongs(note) && CURRENT_ASSESSMENTS.has(String(note.attributes.assessment)))
+        .sort(sortDescendingBy("date"));
+    return reviewedSection("## Recent decisions", candidates, 5, (decision) => `- ${text(decision.attributes.date)} — ${add(decision)} (${text(decision.attributes.assessment)})`);
+}
+/** `## Open questions`: reviewed, unanswered questions still Open, newest first (spec/schema.md §16.1 item 5). */
+function openQuestions(notes, belongs, add, limit) {
+    const candidates = notes
+        .filter((note) => note.type === "question" && belongs(note) && note.attributes.answer === undefined)
         .filter((note) => {
         const status = record(note.attributes.notion_fields).status;
         return status === undefined || status === "Open";
     })
         .sort(sortDescendingBy("created"));
-    const questionsSection = ["## Open questions", ...(questions.length === 0 ? ["- None"] : questions.map((question) => `- ${add(question)} (${text(question.attributes.kind)})`))];
-    const meetings = notes
-        .filter((note) => note.type === "meeting" && belongsToProject(note, project))
-        .sort(sortDescendingBy("date"))
-        .slice(0, 5);
-    const meetingsSection = ["## Recent meetings", ...(meetings.length === 0 ? ["- None"] : meetings.map((meeting) => `- ${text(meeting.attributes.date)} — ${add(meeting)}`))];
-    return [status, goalSection, peopleSection, decisionsSection, questionsSection, meetingsSection];
+    return reviewedSection("## Open questions", candidates, limit, (question) => `- ${add(question)} (${text(question.attributes.kind)})`);
+}
+/**
+ * Only `reviewed` notes make item lines (0041). With none, the drafts that would qualify are
+ * counted in a waiting line, and produce no item line.
+ */
+function reviewedSection(heading, candidates, limit, line) {
+    const reviewed = candidates.filter((note) => note.attributes.lifecycle === "reviewed").slice(0, limit);
+    if (reviewed.length > 0)
+        return [heading, ...reviewed.map(line)];
+    const waiting = candidates.filter((note) => note.attributes.lifecycle === "draft").length;
+    return [heading, waiting === 0 ? "- None" : `- Nothing reviewed yet: ${waiting} note${waiting === 1 ? "" : "s"} waiting in Review`];
 }
 function decisionLogSections(project, notes, byId, _title, add, link) {
     const decisions = notes.filter((note) => note.type === "decision" && belongsToProject(note, project));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultimate-brain",
-  "version": "0.3.2",
+  "version": "0.4.1",
   "description": "CLI for an AI-assisted Markdown and Git second brain",
   "license": "MIT",
   "keywords": [

package/spec/schemas/brain.schema.json

@@ -156,6 +156,9 @@
             },
             "concepts": {
               "$ref": "#/$defs/dbId"
+            },
+            "references": {
+              "$ref": "#/$defs/dbId"
             }
           }
         },