ultimate-brain 0.2.4 → 0.3.1

package/dist/lib/sync.js

@@ -8,11 +8,11 @@ import { assertStagedValid, checkNoteInput, stageNotes } from "./note-new.js";
 import { compareCodePoints } from "./notes.js";
 import { loadSchemas } from "./schemas.js";
 import { formatDate, formatTimestamp, normalizeTimestamp } from "./time.js";
-const DATABASES = ["areas", "goals", "key_results", "projects", "people", "orgs", "decisions", "questions", "review"];
+const DATABASES = ["areas", "goals", "key_results", "projects", "people", "orgs", "decisions", "questions", "concepts", "review"];
 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", review: "proposal" };
-const DATABASE_FOR_TYPE = { area: "areas", goal: "goals", project: "projects", person: "people", org: "orgs", decision: "decisions", question: "questions", meeting: "meetings", proposal: "review" };
-const PUBLISHED_TYPES = new Set(["area", "goal", "project", "person", "org", "decision", "question", "meeting", "proposal"]);
+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" };
+const PUBLISHED_TYPES = new Set(["area", "goal", "project", "person", "org", "decision", "question", "concept", "source", "meeting", "proposal"]);
 function property(value, key) {
     return Object.hasOwn(value, key) ? value[key] : undefined;
 }
@@ -299,7 +299,7 @@ function planDecision(row, proposal, out) {
         return;
     }
     const action = String(decision).toLowerCase();
-    const value = property(row.properties, "Edited Value");
+    const note = property(row.properties, "Note");
     if (!["approve", "reject", "edit"].includes(action)) {
         out.ignored.push({ database: row.database, page_id: row.page_id, brain_id: proposal.id, reason: "NOT_CORRECTABLE" });
         return;
@@ -308,11 +308,15 @@ function planDecision(row, proposal, out) {
         out.conflicts.push(conflict(row, "EDIT_NOT_ALLOWED", `Edit is not allowed on a ${String(proposal.attributes.kind)} proposal`, "Decision", decision));
         return;
     }
-    if (action === "edit" && (value === null || value === undefined || value === "")) {
-        out.conflicts.push(conflict(row, "EDIT_WITHOUT_VALUE", "Edit needs an Edited Value"));
+    if (action === "edit" && (note === null || note === undefined || note === "")) {
+        out.conflicts.push(conflict(row, "EDIT_WITHOUT_VALUE", "Edit needs a Note", "Note"));
         return;
     }
-    out.decisions.push({ proposal: proposal.id, action: action, ...(action === "edit" ? { value } : {}), decided_at: row.last_edited, decided_by: "notion" });
+    if (action !== "edit" && typeof note === "string" && note !== "") {
+        out.conflicts.push(conflict(row, "NOTE_TO_READ", "Review Note needs interpretation by the skill", "Note", note, decision));
+        return;
+    }
+    out.decisions.push({ proposal: proposal.id, action: action, ...(action === "edit" ? { value: note, note: note } : {}), decided_at: row.last_edited, decided_by: "notion" });
 }
 function planKeyResult(workspace, asOf, row, out) {
     const goals = relationIds(workspace, property(row.properties, "Goal"), out.conflicts, row, "Goal");
@@ -348,7 +352,7 @@ function notionFields(database, p, asOf) {
 }
 function brainProperties(database) {
     const common = [["Name", "title"], ["Summary", "summary"], ["Lifecycle", "lifecycle"]];
-    const extras = { goals: [["Why", "why"], ["Deadline", "facts.deadline"], ["Area", "area"]], projects: [["Key Facts", "facts"], ["Area", "area"], ["Goal", "goal"], ["Client", "client"], ["People", "people"]], people: [["Role", "facts.role"], ["Org", "org"]], decisions: [["Assessment", "assessment"]], questions: [["Kind", "kind"]] };
+    const extras = { goals: [["Why", "why"], ["Deadline", "facts.deadline"], ["Area", "area"]], projects: [["Key Facts", "facts"], ["Area", "area"], ["Goal", "goal"], ["Client", "client"], ["People", "people"]], people: [["Role", "facts.role"], ["Org", "org"]], decisions: [["Assessment", "assessment"], ["Project", "projects"], ["Area", "derived_area"]], questions: [["Kind", "kind"], ["Project", "projects"], ["Area", "derived_area"]], concepts: [["Project", "concept_projects"], ["Area", "concept_area"]] };
     return [...common, ...(extras[database] ?? [])];
 }
 function convertedValue(workspace, row, name, value, conflicts) {
@@ -511,13 +515,13 @@ 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)) : 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)) : 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];
-        if (database === undefined)
+        if (database === undefined || (note.type === "source" && note.attributes.kind === undefined))
             continue;
         const databaseId = databaseIdFor(workspace, database);
         if (databaseId === "") {
@@ -532,33 +536,39 @@ export function render(workspace, now, ids, held) {
             errors.push({ id: note.id, reason: "PROJECT_NOT_IN_NOTION" });
             continue;
         }
+        const capturePage = note.type === "source" && note.attributes.kind === "capture" && typeof note.attributes.source_key === "string" && note.attributes.source_key.startsWith("notion:") ? note.attributes.source_key.slice("notion:".length) : undefined;
+        if (note.type === "source" && note.attributes.kind === "capture" && (capturePage === undefined || (typeof note.attributes.notion === "string" && note.attributes.notion !== capturePage))) {
+            errors.push({ id: note.id, reason: "NOTION_ID_MISMATCH" });
+            continue;
+        }
         const rendered = renderedBrainValues(note, workspace);
         const published = isRecord(note.attributes.notion_published) ? note.attributes.notion_published : {};
         const properties = {};
         const pending = [];
         const heldProperties = held?.get(note.id) ?? new Set();
+        const isCreate = note.attributes.notion === undefined && capturePage === undefined;
         for (const [name, value] of Object.entries(rendered)) {
-            if (name === "@content" || heldProperties.has(name))
+            if (name === "@content" || heldProperties.has(name) || (capturePage !== undefined && name === "Name"))
                 continue;
             const encoded = notionProperty(name, value, note, workspace, pending);
-            if (encoded !== undefined && (note.attributes.notion === undefined || !Object.hasOwn(published, name) || !sameValue(value, published[name])))
+            if (encoded !== undefined && (isCreate || !Object.hasOwn(published, name) || !sameValue(value, published[name])))
                 properties[name] = encoded;
         }
         const content = renderedContent(note, workspace);
         if (content.hash !== undefined)
             rendered["@content"] = content.hash;
         const contentChanged = content.hash !== undefined && !isDeepStrictEqual(content.hash, published["@content"]);
-        const isCreate = note.attributes.notion === undefined;
         if (!isCreate && Object.keys(properties).length === 0 && !contentChanged)
             continue;
         if (!isCreate && note.type !== "meeting" && note.type !== "proposal")
             properties["Last Synced"] = { type: "date", value: { start: formatTimestamp(now), end: null } };
-        items.push({ id: note.id, type: note.type, database, database_id: databaseId, page_id: typeof note.attributes.notion === "string" ? note.attributes.notion : null, action: isCreate ? "create" : "update", properties, body: content.body, sections: content.sections, pending_relations: pending, published: rendered });
+        items.push({ id: note.id, type: note.type, database, database_id: databaseId, page_id: typeof note.attributes.notion === "string" ? note.attributes.notion : capturePage ?? null, action: isCreate ? "create" : "update", properties, body: content.body, sections: content.sections, pending_relations: pending, published: rendered });
     }
     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 };
 }
-function databaseIdFor(workspace, database) { const notion = workspace.config.notion; return isRecord(notion) && isRecord(notion.databases) && typeof notion.databases[database] === "string" ? notion.databases[database] : ""; }
+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) {
     const a = note.attributes;
     const values = {};
@@ -566,8 +576,8 @@ function renderedBrainValues(note, workspace) {
     if (note.type === "proposal") {
         const target = typeof a.target === "string" ? workspace.get(a.target) : undefined;
         const addLink = a.kind === "add_link";
-        const after = addLink && typeof a.field === "string"
-            ? `${fieldLabel(a.field)}: ${noteTitle(a.after, workspace)}`
+        const after = addLink
+            ? proposalLinks(a).map((link) => `${fieldLabel(String(link.field))}: ${noteTitle(link.value, workspace)}`).join("\n")
             : undefined;
         const reviewText = (value) => truncate(typeof value === "string" ? reviewMarkdown(value, target) : value);
         Object.assign(values, {
@@ -581,6 +591,8 @@ function renderedBrainValues(note, workspace) {
         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;
     }
+    if (note.type === "source")
+        return sourceValues(note, workspace);
     common();
     if (note.type === "goal")
         Object.assign(values, { Why: a.why ?? null, Deadline: dateOutput(isRecord(a.facts) ? a.facts.deadline : undefined), Area: relationPages(a.area === undefined ? [] : [a.area], workspace) });
@@ -589,20 +601,38 @@ function renderedBrainValues(note, workspace) {
     if (note.type === "person")
         Object.assign(values, { Role: isRecord(a.facts) ? a.facts.role ?? null : null, Org: relationPages(a.org === undefined ? [] : [a.org], workspace) });
     if (note.type === "decision")
-        Object.assign(values, { Date: dateOutput(a.date), Assessment: select(a.assessment), 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) });
+        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), Project: relationPages(a.projects, workspace), "Raised In": relationPages(a.raised_in === undefined ? [] : [a.raised_in], workspace) });
+        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) });
+    if (note.type === "concept")
+        Object.assign(values, { Project: relationPages(a.projects, workspace), Area: relationPages(a.area === undefined ? [] : [a.area], workspace) });
     return values;
 }
+/** Area on decisions and questions is a derived Notion relation (decision 0034). */
+function projectAreas(projects, workspace) {
+    const areas = (Array.isArray(projects) ? projects : []).flatMap((project) => {
+        const area = workspace.get(String(project))?.attributes.area;
+        return typeof area === "string" ? [area] : [];
+    });
+    return [...new Set(areas)].sort(compareCodePoints);
+}
+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 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);
+    return { Name: note.attributes.title, Kind: select(note.attributes.kind), Summary: note.attributes.summary ?? null, Decisions: relationPages(ids("decision"), workspace), Questions: relationPages(ids("question"), workspace), Concepts: relationPages(ids("concept"), workspace), People: relationPages(ids("person"), workspace), Project: relationPages(projects, workspace), Area: relationPages(areas, workspace), "Brain Status": "Processed", "Brain ID": note.id };
+}
 function notionProperty(name, value, note, workspace, pending) {
-    const relation = ["Area", "Goal", "Client", "People", "Org", "Project", "Decided In", "Raised In", "Supersedes", "Decisions", "Questions", "Attendees"].includes(name);
+    const relation = ["Area", "Goal", "Client", "People", "Org", "Project", "Decided In", "Raised In", "Supersedes", "Decisions", "Questions", "Concepts", "Attendees"].includes(name);
     if (relation) {
         const sourceField = { Area: "area", Goal: "goal", Client: "client", People: "people", Org: "org", Project: "projects", "Decided In": "decided_in", "Raised In": "raised_in", Decisions: "decisions", Questions: "questions", Attendees: "attendees" };
-        const raw = name === "Supersedes" ? (Array.isArray(note.attributes.relations) ? note.attributes.relations.filter(isRecord).filter((item) => item.type === "supersedes").map((item) => item.target) : []) : note.attributes[sourceField[name] ?? ""];
+        const raw = name === "Area" && (note.type === "decision" || note.type === "question") ? projectAreas(note.attributes.projects, workspace) : name === "Supersedes" ? (Array.isArray(note.attributes.relations) ? note.attributes.relations.filter(isRecord).filter((item) => item.type === "supersedes").map((item) => item.target) : []) : note.type === "source" ? sourceRelationIds(note, name, workspace) : note.attributes[sourceField[name] ?? ""];
         const missing = (Array.isArray(raw) ? raw : raw === undefined ? [] : [raw]).map(String).filter((id) => typeof workspace.get(id)?.attributes.notion !== "string");
         if (missing.length > 0)
             pending.push({ property: name, ids: missing });
-        return { type: "relation", value: Array.isArray(value) ? value : [], ...(note.type === "meeting" ? { mode: ["Project", "Area"].includes(name) ? "if_empty" : "add" } : {}) };
+        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))
         return { type: "select", value };
@@ -610,7 +640,29 @@ function notionProperty(name, value, note, workspace, pending) {
         return { type: "date", value };
     return { type: name === "Name" ? "title" : "rich_text", value };
 }
-function renderedContent(note, workspace) { if (note.type === "decision" || note.type === "question") {
+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));
+    if (name === "Decisions")
+        return produced.filter((candidate) => candidate.type === "decision").map((candidate) => candidate.id);
+    if (name === "Questions")
+        return produced.filter((candidate) => candidate.type === "question").map((candidate) => candidate.id);
+    if (name === "Concepts")
+        return produced.filter((candidate) => candidate.type === "concept").map((candidate) => candidate.id);
+    if (name === "People")
+        return produced.filter((candidate) => candidate.type === "person").map((candidate) => candidate.id);
+    const projects = [...new Set(produced.flatMap((candidate) => Array.isArray(candidate.attributes.projects) ? candidate.attributes.projects.filter((id) => typeof id === "string") : []))];
+    if (name === "Project")
+        return projects;
+    if (name === "Area")
+        return [...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] : []; })])];
+    return [];
+}
+function proposalLinks(attributes) {
+    if (Array.isArray(attributes.links))
+        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") {
@@ -667,17 +719,22 @@ function proposalAfter(attributes, workspace) {
         return noteTitle(attributes.merge_into, workspace);
     return attributes.after ?? null;
 }
-export function renderTasks(workspace, meetingId, input) {
+export function renderTasks(workspace, targetId, input) {
     if (!isRecord(input) || !Array.isArray(input.items))
         throw new BrainError("INPUT_INVALID", "tasks input needs an items list");
     const config = tasksConfig(workspace);
-    const meeting = workspace.get(meetingId);
-    if (meeting?.type !== "meeting")
-        throw new BrainError("UNKNOWN_ID", `No meeting with id ${meetingId}`);
+    const target = workspace.get(targetId);
+    const sourceMode = target?.type === "source";
+    if (target === undefined)
+        throw new BrainError("UNKNOWN_ID", `No meeting or source has id ${targetId}`);
+    if (target.type !== "meeting" && !sourceMode)
+        throw new BrainError("INPUT_INVALID", `${targetId} is not a meeting or source`);
+    if (sourceMode && target.attributes.kind === undefined)
+        throw new BrainError("INPUT_INVALID", "minutes sources use their meeting for tasks");
     const tasks = input.items.map((item, index) => {
         if (!isRecord(item) || typeof item.title !== "string" || item.title === "")
             throw new BrainError("INPUT_INVALID", "each task needs a title");
-        const projects = taskProjects(workspace, meeting, item.projects, index);
+        const projects = taskProjects(workspace, sourceMode ? undefined : target, item.projects, index);
         const properties = {};
         const pending_relations = [];
         const put = (key, type, value) => { const name = config.properties[key]; if (typeof name === "string" && name !== "")
@@ -686,7 +743,7 @@ export function renderTasks(workspace, meetingId, input) {
         put("status", "select", config.new_task_status);
         if (item.due !== undefined)
             put("due", "date", dateOutput(item.due));
-        if (item.owner !== undefined)
+        if (!sourceMode && item.owner !== undefined)
             put("owner", "person_name", item.owner);
         const projectProperty = config.properties.project;
         if (typeof projectProperty === "string" && projectProperty !== "") {
@@ -695,19 +752,28 @@ export function renderTasks(workspace, meetingId, input) {
                 pending_relations.push({ property: projectProperty, ids: unpublished });
             put("project", "relation", publishedPages(projects, workspace));
         }
-        put("area", "relation", publishedPages(meeting.attributes.area === undefined ? [] : [meeting.attributes.area], workspace));
-        if (config.properties.meeting !== "")
-            put("meeting", "relation", [meeting.attributes.notion]);
+        const areas = sourceMode ? [...new Set(projects.flatMap((id) => { const area = workspace.get(id)?.attributes.area; return typeof area === "string" ? [area] : []; }))] : target.attributes.area === undefined ? [] : [target.attributes.area];
+        put("area", "relation", publishedPages(areas, workspace));
+        if (sourceMode) {
+            if (typeof config.properties.source === "string" && config.properties.source !== "") {
+                if (typeof target.attributes.notion !== "string")
+                    pending_relations.push({ property: config.properties.source, ids: [target.id] });
+                else
+                    put("source", "relation", [target.attributes.notion]);
+            }
+        }
+        else if (config.properties.meeting !== "")
+            put("meeting", "relation", [target.attributes.notion]);
         else
-            put("meeting_url", "url", meeting.attributes.notion === undefined ? undefined : `https://www.notion.so/${String(meeting.attributes.notion).replaceAll("-", "")}`);
-        put("brain_id", "rich_text", meeting.id);
+            put("meeting_url", "url", target.attributes.notion === undefined ? undefined : `https://www.notion.so/${String(target.attributes.notion).replaceAll("-", "")}`);
+        put("brain_id", "rich_text", target.id);
         return { database_id: config.database, properties, pending_relations };
     });
     return { items: tasks };
 }
 function taskProjects(workspace, meeting, value, itemIndex) {
     if (value === undefined || (Array.isArray(value) && value.length === 0))
-        return Array.isArray(meeting.attributes.projects) ? meeting.attributes.projects.filter((id) => typeof id === "string") : [];
+        return Array.isArray(meeting?.attributes.projects) ? meeting.attributes.projects.filter((id) => typeof id === "string") : [];
     if (!Array.isArray(value))
         throw new BrainError("INPUT_INVALID", "task projects must be an array", [{ pointer: `/items/${itemIndex}/projects`, message: "must be an array of project ids" }]);
     const problems = [];
@@ -757,9 +823,9 @@ 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 !== "source" && note.type !== "view" && note.type !== "proposal")
+            if (note.type !== "view" && note.type !== "proposal")
                 doc.attributes.last_synced = syncedAt;
-            if (note.type === "meeting" && Array.isArray(entry.tasks))
+            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")])];
             workspace.save(note.path, doc);
             const errors = workspace.newErrors();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultimate-brain",
-  "version": "0.2.4",
+  "version": "0.3.1",
   "description": "CLI for an AI-assisted Markdown and Git second brain",
   "license": "MIT",
   "keywords": [
@@ -29,6 +29,7 @@
   "scripts": {
     "build": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\" && tsc --project tsconfig.build.json",
     "prepack": "npm run build",
+    "skills": "node --experimental-strip-types scripts/build-skills.ts && node --experimental-strip-types --test tests/skills.test.ts",
     "test:package": "node scripts/test-package.mjs",
     "test:scripts": "node --test tests/release-scripts.test.mjs",
     "test": "node --experimental-strip-types --test tests/*.test.ts tests/*.test.mjs",

package/spec/schemas/brain.schema.json

@@ -25,6 +25,10 @@
         "name": {
           "type": "string",
           "minLength": 1
+        },
+        "person": {
+          "type": "string",
+          "pattern": "^per-[0-9abcdefghjkmnpqrstvwxyz]{8}$"
         }
       }
     },
@@ -40,6 +44,26 @@
         }
       }
     },
+    "settings": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "publish": {
+          "enum": [
+            "ask",
+            "auto"
+          ],
+          "default": "ask"
+        },
+        "push": {
+          "enum": [
+            "auto",
+            "remind"
+          ],
+          "default": "auto"
+        }
+      }
+    },
     "notion": {
       "type": "object",
       "required": [
@@ -83,6 +107,14 @@
               "$ref": "#/$defs/dbId"
             },
             "capture_inbox": {
+              "$ref": "#/$defs/dbId",
+              "deprecated": true,
+              "description": "Old name of inbox; read as inbox when inbox is absent. brain upgrade renames it."
+            },
+            "inbox": {
+              "$ref": "#/$defs/dbId"
+            },
+            "concepts": {
               "$ref": "#/$defs/dbId"
             }
           }
@@ -130,6 +162,9 @@
                 "meeting_url": {
                   "type": "string"
                 },
+                "source": {
+                  "type": "string"
+                },
                 "brain_id": {
                   "type": "string"
                 }

package/spec/schemas/note.schema.json

@@ -833,6 +833,27 @@
         "converter": {
           "type": "string",
           "minLength": 1
+        },
+        "summary": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 400
+        },
+        "notion": {
+          "$ref": "#/$defs/notionPageId"
+        },
+        "notion_published": {
+          "description": "Notion property name → value last published to the Inbox (spec/cli.md §5.14).",
+          "type": "object"
+        },
+        "last_synced": {
+          "$ref": "#/$defs/timestamp"
+        },
+        "tasks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/notionPageId"
+          }
         }
       },
       "not": {
@@ -896,6 +917,25 @@
               }
             }
           }
+        },
+        {
+          "if": {
+            "required": [
+              "kind"
+            ],
+            "properties": {
+              "kind": {
+                "const": "capture"
+              }
+            }
+          },
+          "then": {
+            "properties": {
+              "source_key": {
+                "pattern": "^notion:"
+              }
+            }
+          }
         }
       ]
     },

package/spec/schemas/proposal.schema.json

@@ -104,6 +104,32 @@
         "value": {
           "$ref": "note.schema.json#/$defs/factValue"
         },
+        "note": {
+          "type": "string",
+          "minLength": 1
+        },
+        "exclude": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "object",
+            "required": [
+              "field",
+              "value"
+            ],
+            "additionalProperties": false,
+            "properties": {
+              "field": {
+                "type": "string"
+              },
+              "value": {
+                "type": "string",
+                "minLength": 1
+              }
+            }
+          }
+        },
         "decided_at": {
           "$ref": "note.schema.json#/$defs/timestamp"
         },
@@ -170,6 +196,35 @@
     "notion_published": {
       "description": "Review property name → value last published (spec/cli.md §5.14).",
       "type": "object"
+    },
+    "links": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": {
+        "type": "object",
+        "required": [
+          "field",
+          "value"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "field": {
+            "enum": [
+              "aliases",
+              "tags",
+              "projects",
+              "people",
+              "attendees",
+              "deciders"
+            ]
+          },
+          "value": {
+            "type": "string",
+            "minLength": 1
+          }
+        }
+      }
     }
   },
   "additionalProperties": false,
@@ -237,9 +292,7 @@
       },
       "then": {
         "required": [
-          "target",
-          "field",
-          "after"
+          "target"
         ],
         "properties": {
           "field": {
@@ -275,7 +328,39 @@
               ]
             }
           ]
-        }
+        },
+        "oneOf": [
+          {
+            "required": [
+              "links"
+            ],
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "field"
+                  ]
+                },
+                {
+                  "required": [
+                    "after"
+                  ]
+                }
+              ]
+            }
+          },
+          {
+            "required": [
+              "field",
+              "after"
+            ],
+            "not": {
+              "required": [
+                "links"
+              ]
+            }
+          }
+        ]
       }
     },
     {
@@ -554,6 +639,48 @@
           }
         }
       }
+    },
+    {
+      "if": {
+        "required": [
+          "links"
+        ]
+      },
+      "then": {
+        "properties": {
+          "kind": {
+            "const": "add_link"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": [
+          "decision"
+        ],
+        "properties": {
+          "decision": {
+            "required": [
+              "exclude"
+            ]
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "kind": {
+            "const": "add_link"
+          },
+          "decision": {
+            "properties": {
+              "action": {
+                "const": "approve"
+              }
+            }
+          }
+        }
+      }
     }
   ]
 }

package/templates/brain/AGENTS.md

@@ -13,7 +13,8 @@ Each operation has a skill; follow it end to end:
 | The user wants to… | Skill |
 |---|---|
 | connect the brain to Notion (after building the space) | `brain-connect-notion` |
-| ingest reviewed meeting minutes | `brain-ingest` |
+| catch up: do everything that's waiting (decided reviews, reviewed meetings, the Inbox, the drop folder) | `brain-catch-up` |
+| ingest one input: reviewed minutes, a document, a web page, a pasted email or note, the Inbox, the drop folder | `brain-ingest` |
 | apply decisions from the Notion Review queue | `brain-apply` |
 | pull Notion edits and new rows, republish notes | `brain-sync` |
 | answer a question from the brain | `brain-query` |
@@ -28,7 +29,8 @@ Each operation has a skill; follow it end to end:
 - **A new decision or question for a meeting that already exists**: a `new_item` proposal, because the meeting note must change too.
 - **Generated files** (`index.md`, `log/`, the `@generated` blocks of `brief.md` and `decision-log.md`) and **source snapshots** in `sources/` are written by the CLI only. To change what a view shows, change the canonical note and regenerate.
 - **After every write:** `brain index`, `brain views`, `brain lint`. Commit when lint shows no errors you introduced, e.g. `ingest: Acme sync 2026-12-03 (4 new, 3 proposals)`. A run that publishes to Notion commits again after `brain sync record`, so the stored page ids are in Git too.
-- **After the last commit:** `git push`. If it fails (offline, no remote), say so in the report's last line and carry on; the work is committed.
+- **Publishing** follows `settings.publish` in `brain.json` (see `brain status`): `ask` (the default) asks once per run before writing to Notion; `auto` publishes without asking. After a run the user was happy with and that asked, offer once to switch: `brain config set settings.publish '"auto"'`.
+- **After the last commit,** per `settings.push`: `auto` (the default) runs `git push`; if it fails (offline, no remote), say so in the report's last line and carry on, the work is committed. `remind` leaves it to the user, and the report's last line says how many commits are not pushed.
 
 ## Product files and findings
 

package/templates/brain/brain.json

@@ -2,6 +2,7 @@
   "schema_version": 1,
   "owner": { "name": "Owner" },
   "budgets": { "ingest_max_notes": 8 },
+  "settings": { "publish": "ask", "push": "auto" },
   "notion": {
     "databases": {
       "areas": "",
@@ -14,7 +15,8 @@
       "decisions": "",
       "questions": "",
       "review": "",
-      "capture_inbox": ""
+      "inbox": "",
+      "concepts": ""
     },
     "tasks": {
       "database": "",
@@ -27,6 +29,7 @@
         "owner": "",
         "meeting": "Meeting",
         "meeting_url": "",
+        "source": "Source",
         "brain_id": "Brain ID"
       },
       "new_task_status": "To Do"