ultimate-brain 0.3.0 → 0.3.1

package/.agents/skills/brain-connect-notion/SKILL.md

@@ -40,7 +40,7 @@ Run CLI commands as `brain <command> --brain <brain> --json`. If `brain` is not
    - **Don't fix anything in Notion.** Structure changes go through the `brain-notion-change` skill (decision 0022).
 4. **Store the ids.** For each database found, run `brain config set notion.databases.<key> '"<database id>"'`. Store the **database** id, not the data source id; skills resolve the data source when they query.
 5. **Tasks** (decision 0018):
-   - **The default Tasks database on Brain Data:** set `notion.tasks.database` to its id, and `notion.tasks.properties.source` to `"Source"` when it has that relation (built from 0.3.0 on, or after migration 0005). The rest of the template's mapping (Name, Status, Due, Project, Area, Meeting, Brain ID) already matches it.
+   - **The default Tasks database on Brain Data:** set `notion.tasks.database` to its id. The template's mapping (Name, Status, Due, Project, Area, Meeting, Source, Brain ID) already matches it; check `notion.tasks.properties.source` is `"Source"` when the database has that relation (built from 0.3.0 on, or after migration 0005), and set it to `""` when it doesn't, so sync never writes to a missing property.
    - **The user's own tasks database:** ask which one, read its properties, and propose a mapping for `title` (required), `status`, `due`, `project`, `area`, `owner`, either `meeting` (a relation to Meetings, preferred) or `meeting_url` (a URL property), and `source` (a relation to the Inbox, optional: the backlink for the owner's tasks from documents and emails).
      - Show the mapping and get a yes before running `brain config set notion.tasks '<json>'`.
      - Also set `new_task_status` to the status option new tasks should get.

package/.agents/skills/brain-howto/references/guide.md

@@ -21,7 +21,7 @@ The navigation on the left of every page lists the Spaces. Each one has tabs tha
 | **Projects** | Keep projects moving | Active · By area · Deadlines · Gone quiet |
 | **Plan** | Check that your work serves your goals | Goals · Key results · Areas · Projects by goal |
 | **Review** | Decide on the changes the brain proposes | Needs my decision · Sources disagree · Approved recently · Rejected |
-| **Knowledge** | Find what the brain knows, and everything that came in | Decisions · Questions · Concepts · People · Orgs · Inbox (Inbox: new captures · History: everything ingested, with what it produced) |
+| **Knowledge** | Find what the brain knows, and everything that came in | Decisions · Questions · Concepts · People · Orgs · Inbox (What's in my inbox?: new captures · What came in?: everything ingested, with what it produced) |
 | **Archive** (under System) | Find finished and archived records | One tab per database |
 
 **Area pages** collect everything for one area: its goals, projects, tasks, meetings, decisions and open questions in views, and its people and clients as lists at the top. Open one from Plan → Areas.
@@ -182,4 +182,4 @@ Run these in Claude Code or Codex, from your brain's folder.
 | A record shows Draft | You haven't reviewed it yet | Read it; set **Reviewed**, or **Disputed** if it's wrong |
 | An Area page doesn't list a decision | A decision's Area comes from its project | Link the decision's project to the area, then "sync with Notion" |
 | A Review row with a Note is still pending | The agent couldn't tell what the Note meant, or it described a different change | Answer the agent's question, or look for the new row it proposed |
-| You want to see what the brain made from a document | Every input has a row in Knowledge → Inbox → History | Open the row: Decisions, Questions, Concepts and People list what it produced |
+| You want to see what the brain made from a document | Every input has a row in Knowledge → Inbox → What came in? | Open the row: Decisions, Questions, Concepts and People list what it produced |

package/dist/cli.js

@@ -18,6 +18,7 @@ import { syncApplyCommand, syncPlanCommand, syncRecordCommand, syncRenderCommand
 import { viewsCommand } from "./commands/views.js";
 import { runCommand } from "./lib/command.js";
 import { exitCodeFor } from "./lib/errors.js";
+import { installedProduct } from "./lib/skills.js";
 /** Registered commands, in help order. */
 export const COMMANDS = [
     initCommand, statusCommand, configGetCommand, configSetCommand, idNewCommand, indexCommand, lintCommand, logCommand, noteNewCommand, proposalNewCommand, proposalListCommand, applyCommand,
@@ -32,6 +33,7 @@ Global options:
   --json            Print one JSON document on stdout
   --now <time>      Use this ISO 8601 UTC time as "now"
   -h, --help        Show help
+  --version         Print the installed version
 
 Commands:
 ${COMMANDS.map((command) => `  ${command.name.padEnd(16)}${command.summary.split(". ")[0].replace(/\.$/, "")}`).join("\n")}
@@ -47,6 +49,14 @@ export async function runCli(args, options = {}) {
         io.stdout.write(HELP_TEXT);
         return 0;
     }
+    // spec/cli.md §3.1: --version ignores any command and every other option but --json.
+    if (args.includes("--version")) {
+        const { version } = installedProduct();
+        io.stdout.write(args.includes("--json")
+            ? `${JSON.stringify({ ok: true, command: "version", brain: null, data: { version }, warnings: [] })}\n`
+            : `${version}\n`);
+        return 0;
+    }
     const handlers = new Map();
     for (const command of COMMANDS) {
         handlers.set(command.name, (rest, commandIo) => runCommand(command, rest, commandIo, options));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultimate-brain",
-  "version": "0.3.0",
+  "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/templates/brain/brain.json

@@ -29,7 +29,7 @@
         "owner": "",
         "meeting": "Meeting",
         "meeting_url": "",
-        "source": "",
+        "source": "Source",
         "brain_id": "Brain ID"
       },
       "new_task_status": "To Do"