ultimate-brain 0.3.1 → 0.3.2

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

@@ -40,10 +40,10 @@ 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. 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 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; set `notion.tasks.status_type` to `"status"` with `brain config set` when it's absent or different (its Status is Notion's built-in type; a brain made before 0.3.2 has no such field), and 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.
+     - Also set `new_task_status` to the status option new tasks should get, and `status_type` to the mapped Status property's type: `status` (Notion's built-in Status) or `select`. Always set it: absent means `select`.
    - **No tasks database:** leave `notion.tasks.database` empty. The ingest then lists action items in its report instead.
 6. **Your identities** (decision 0037), when `brain.json` has no `owner.person`. Ask once: "Which names and work email addresses do you appear under in meetings, documents and emails?" (for example a nickname, a work name, two email addresses). Find the owner's person note in `brain index --json` by the owner name in `brain.json` and its aliases. Then:
    - add each name and email the note doesn't list yet as an alias, with one `add_link` proposal per value (`field: aliases`, `why` = the user's answer, `source` = an owner-ruling source as in brain-ingest references/extraction.md, "Owner rulings"); the CLI groups them into one Review row, which the user approves here in chat (brain-apply, chat mode). In a catch-up, the answer to its batch question is that approval: apply them with `decided_by: chat` without asking again;

package/README.md

@@ -44,7 +44,7 @@ To try a release candidate: `npm install -g ultimate-brain@next`. To go back: `n
 | [synthesis/synthesis.md](synthesis/synthesis.md) | The v1 design: schema, meeting-ingest workflow, Notion bridge |
 | [docs/notion-space-design.md](docs/notion-space-design.md) | Notion databases, views, and the Notion AI prompts to build them |
 | [decisions/](decisions/) | Every accepted architecture decision |
-| [build/TASKS.md](build/TASKS.md) | Build plan split between Claude Code and Codex |
+| [build/TASKS.md](build/TASKS.md) | Build plan: Claude Code builds, Codex reviews (decision 0044) |
 | [reviews/](reviews/) | Research: reviews of five open-source second-brain repos |
 
 Agent rules live in [AGENTS.md](AGENTS.md); `CLAUDE.md` imports it.

package/dist/lib/sync.js

@@ -740,7 +740,7 @@ export function renderTasks(workspace, targetId, input) {
         const put = (key, type, value) => { const name = config.properties[key]; if (typeof name === "string" && name !== "")
             properties[name] = { type, value }; };
         put("title", "title", item.title);
-        put("status", "select", config.new_task_status);
+        put("status", config.status_type, config.new_task_status);
         if (item.due !== undefined)
             put("due", "date", dateOutput(item.due));
         if (!sourceMode && item.owner !== undefined)
@@ -799,7 +799,7 @@ function taskProjects(workspace, meeting, value, itemIndex) {
 function publishedPages(value, workspace) { return (Array.isArray(value) ? value : []).map((id) => workspace.get(String(id))?.attributes.notion).filter((id) => typeof id === "string"); }
 function tasksConfig(workspace) { if (!loadSchemas().brain(workspace.config))
     throw new BrainError("BRAIN_CONFIG_INVALID", "brain.json fails its schema"); const notion = workspace.config.notion; const tasks = notion.tasks; if (typeof tasks.database !== "string" || tasks.database === "")
-    throw new BrainError("BRAIN_CONFIG_INVALID", "Tasks database is not configured"); return { database: tasks.database, properties: tasks.properties, new_task_status: tasks.new_task_status }; }
+    throw new BrainError("BRAIN_CONFIG_INVALID", "Tasks database is not configured"); return { database: tasks.database, properties: tasks.properties, new_task_status: tasks.new_task_status, status_type: tasks.status_type === "status" ? "status" : "select" }; }
 export function record(workspace, input) {
     if (!isRecord(input) || !Array.isArray(input.records))
         throw new BrainError("INPUT_INVALID", "record input needs a records list");

package/package.json

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

package/spec/schemas/brain.schema.json

@@ -64,6 +64,46 @@
         }
       }
     },
+    "repos": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": [
+          "name",
+          "path",
+          "area",
+          "patterns",
+          "commit"
+        ],
+        "additionalProperties": false,
+        "properties": {
+          "name": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+          },
+          "path": {
+            "type": "string",
+            "pattern": "^(/|~/)"
+          },
+          "area": {
+            "type": "string",
+            "pattern": "^area-[0-9abcdefghjkmnpqrstvwxyz]{8}$"
+          },
+          "patterns": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          "commit": {
+            "type": "string",
+            "pattern": "^([0-9a-f]{40})?$"
+          }
+        }
+      }
+    },
     "notion": {
       "type": "object",
       "required": [
@@ -172,6 +212,12 @@
             },
             "new_task_status": {
               "type": "string"
+            },
+            "status_type": {
+              "enum": [
+                "status",
+                "select"
+              ]
             }
           },
           "allOf": [

package/spec/schemas/note.schema.json

@@ -834,11 +834,49 @@
           "type": "string",
           "minLength": 1
         },
+        "repo": {
+          "type": "string",
+          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+        },
+        "repo_path": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^/\\\\].*$"
+        },
+        "commit": {
+          "type": "string",
+          "pattern": "^[0-9a-f]{40}$"
+        },
+        "attached_to": {
+          "$ref": "#/$defs/sourceId"
+        },
         "summary": {
           "type": "string",
           "minLength": 1,
           "maxLength": 400
         },
+        "digest": {
+          "type": "string",
+          "minLength": 1
+        },
+        "notion_text": {
+          "enum": [
+            "digest",
+            "full"
+          ]
+        },
+        "notion_parts": {
+          "type": "array",
+          "minItems": 1,
+          "uniqueItems": true,
+          "items": {
+            "type": "string",
+            "pattern": "^[1-9][0-9]*(-[1-9][0-9]*)?$"
+          }
+        },
+        "notion_text_requested": {
+          "$ref": "#/$defs/timestamp"
+        },
         "notion": {
           "$ref": "#/$defs/notionPageId"
         },
@@ -936,13 +974,136 @@
               }
             }
           }
+        },
+        {
+          "description": "repo, repo_path and commit come together (0042).",
+          "if": {
+            "anyOf": [
+              {
+                "required": [
+                  "repo"
+                ]
+              },
+              {
+                "required": [
+                  "repo_path"
+                ]
+              },
+              {
+                "required": [
+                  "commit"
+                ]
+              }
+            ]
+          },
+          "then": {
+            "required": [
+              "repo",
+              "repo_path",
+              "commit"
+            ],
+            "properties": {
+              "source_key": {
+                "pattern": "^file:"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "required": [
+              "attached_to"
+            ]
+          },
+          "then": {
+            "properties": {
+              "source_key": {
+                "pattern": "^file:"
+              }
+            }
+          }
+        },
+        {
+          "description": "notion_parts only with notion_text: full (0043).",
+          "if": {
+            "required": [
+              "notion_parts"
+            ]
+          },
+          "then": {
+            "required": [
+              "notion_text"
+            ],
+            "properties": {
+              "notion_text": {
+                "const": "full"
+              }
+            }
+          }
+        },
+        {
+          "description": "No brain-written Inbox body on minutes, captures or attachments (0043).",
+          "if": {
+            "anyOf": [
+              {
+                "required": [
+                  "attached_to"
+                ]
+              },
+              {
+                "required": [
+                  "kind"
+                ],
+                "properties": {
+                  "kind": {
+                    "enum": [
+                      "minutes",
+                      "capture"
+                    ]
+                  }
+                }
+              },
+              {
+                "not": {
+                  "required": [
+                    "kind"
+                  ]
+                }
+              }
+            ]
+          },
+          "then": {
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "digest"
+                  ]
+                },
+                {
+                  "required": [
+                    "notion_text"
+                  ]
+                },
+                {
+                  "required": [
+                    "notion_parts"
+                  ]
+                },
+                {
+                  "required": [
+                    "notion_text_requested"
+                  ]
+                }
+              ]
+            }
+          }
         }
       ]
     },
     "view": {
       "required": [
         "view_kind",
-        "project",
         "generated_from",
         "generated_at"
       ],
@@ -950,12 +1111,30 @@
         "view_kind": {
           "enum": [
             "brief",
-            "decision_log"
+            "decision_log",
+            "area_brief",
+            "report"
           ]
         },
         "project": {
           "$ref": "#/$defs/projectId"
         },
+        "area": {
+          "$ref": "#/$defs/areaId"
+        },
+        "projects": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/projectId"
+          }
+        },
+        "question": {
+          "type": "string",
+          "minLength": 1
+        },
+        "asked_in": {
+          "$ref": "#/$defs/notionPageId"
+        },
         "generated_from": {
           "type": "array",
           "items": {
@@ -964,6 +1143,15 @@
         },
         "generated_at": {
           "$ref": "#/$defs/timestamp"
+        },
+        "notion": {
+          "$ref": "#/$defs/notionPageId"
+        },
+        "last_synced": {
+          "$ref": "#/$defs/timestamp"
+        },
+        "notion_published": {
+          "type": "object"
         }
       },
       "not": {
@@ -984,7 +1172,159 @@
             ]
           }
         ]
-      }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "view_kind": {
+                "enum": [
+                  "brief",
+                  "decision_log"
+                ]
+              }
+            }
+          },
+          "then": {
+            "allOf": [
+              {
+                "required": [
+                  "project"
+                ]
+              },
+              {
+                "not": {
+                  "anyOf": [
+                    {
+                      "required": [
+                        "area"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "projects"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "question"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "asked_in"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "notion"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "last_synced"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "notion_published"
+                      ]
+                    }
+                  ]
+                }
+              }
+            ]
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "view_kind": {
+                "const": "area_brief"
+              }
+            }
+          },
+          "then": {
+            "allOf": [
+              {
+                "required": [
+                  "area"
+                ]
+              },
+              {
+                "not": {
+                  "anyOf": [
+                    {
+                      "required": [
+                        "project"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "projects"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "question"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "asked_in"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "notion"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "last_synced"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "notion_published"
+                      ]
+                    }
+                  ]
+                }
+              }
+            ]
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "view_kind": {
+                "const": "report"
+              }
+            }
+          },
+          "then": {
+            "allOf": [
+              {
+                "required": [
+                  "question"
+                ]
+              },
+              {
+                "not": {
+                  "anyOf": [
+                    {
+                      "required": [
+                        "project"
+                      ]
+                    }
+                  ]
+                }
+              }
+            ]
+          }
+        }
+      ]
     },
     "memory": {
       "required": [

package/spec/schemas/proposal.schema.json

@@ -42,7 +42,9 @@
         "supersede",
         "contradiction",
         "merge",
-        "new_item"
+        "new_item",
+        "review_notes",
+        "answer"
       ]
     },
     "target": {
@@ -114,12 +116,14 @@
           "uniqueItems": true,
           "items": {
             "type": "object",
-            "required": [
-              "field",
-              "value"
-            ],
             "additionalProperties": false,
             "properties": {
+              "note": {
+                "$ref": "note.schema.json#/$defs/id"
+              },
+              "target": {
+                "$ref": "note.schema.json#/$defs/id"
+              },
               "field": {
                 "type": "string"
               },
@@ -127,7 +131,44 @@
                 "type": "string",
                 "minLength": 1
               }
-            }
+            },
+            "oneOf": [
+              {
+                "required": [
+                  "note"
+                ],
+                "not": {
+                  "anyOf": [
+                    {
+                      "required": [
+                        "field"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "value"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "target"
+                      ]
+                    }
+                  ]
+                }
+              },
+              {
+                "required": [
+                  "field",
+                  "value"
+                ],
+                "not": {
+                  "required": [
+                    "note"
+                  ]
+                }
+              }
+            ]
           }
         },
         "decided_at": {
@@ -199,7 +240,6 @@
     },
     "links": {
       "type": "array",
-      "minItems": 1,
       "uniqueItems": true,
       "items": {
         "type": "object",
@@ -209,6 +249,9 @@
         ],
         "additionalProperties": false,
         "properties": {
+          "target": {
+            "$ref": "note.schema.json#/$defs/id"
+          },
           "field": {
             "enum": [
               "aliases",
@@ -225,6 +268,20 @@
           }
         }
       }
+    },
+    "notes": {
+      "type": "array",
+      "uniqueItems": true,
+      "items": {
+        "$ref": "note.schema.json#/$defs/id"
+      }
+    },
+    "answer": {
+      "type": "string",
+      "minLength": 1
+    },
+    "answer_note": {
+      "$ref": "note.schema.json#/$defs/id"
     }
   },
   "additionalProperties": false,
@@ -326,6 +383,21 @@
               "required": [
                 "before"
               ]
+            },
+            {
+              "required": [
+                "notes"
+              ]
+            },
+            {
+              "required": [
+                "answer"
+              ]
+            },
+            {
+              "required": [
+                "answer_note"
+              ]
             }
           ]
         },
@@ -347,6 +419,18 @@
                   ]
                 }
               ]
+            },
+            "properties": {
+              "links": {
+                "minItems": 1,
+                "items": {
+                  "not": {
+                    "required": [
+                      "target"
+                    ]
+                  }
+                }
+              }
             }
           },
           {
@@ -620,7 +704,8 @@
             "enum": [
               "update_fact",
               "contradiction",
-              "add_to_note"
+              "add_to_note",
+              "answer"
             ]
           }
         }
@@ -649,7 +734,10 @@
       "then": {
         "properties": {
           "kind": {
-            "const": "add_link"
+            "enum": [
+              "add_link",
+              "review_notes"
+            ]
           }
         }
       }
@@ -670,7 +758,10 @@
       "then": {
         "properties": {
           "kind": {
-            "const": "add_link"
+            "enum": [
+              "add_link",
+              "review_notes"
+            ]
           },
           "decision": {
             "properties": {
@@ -681,6 +772,298 @@
           }
         }
       }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "review_notes"
+          }
+        }
+      },
+      "then": {
+        "required": [
+          "notes",
+          "links"
+        ],
+        "properties": {
+          "links": {
+            "items": {
+              "required": [
+                "target"
+              ]
+            }
+          }
+        },
+        "anyOf": [
+          {
+            "properties": {
+              "notes": {
+                "minItems": 1
+              }
+            }
+          },
+          {
+            "properties": {
+              "links": {
+                "minItems": 1
+              }
+            }
+          }
+        ],
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "target"
+              ]
+            },
+            {
+              "required": [
+                "field"
+              ]
+            },
+            {
+              "required": [
+                "before"
+              ]
+            },
+            {
+              "required": [
+                "after"
+              ]
+            },
+            {
+              "required": [
+                "content"
+              ]
+            },
+            {
+              "required": [
+                "note"
+              ]
+            },
+            {
+              "required": [
+                "supersedes"
+              ]
+            },
+            {
+              "required": [
+                "merge_into"
+              ]
+            },
+            {
+              "required": [
+                "answer"
+              ]
+            },
+            {
+              "required": [
+                "answer_note"
+              ]
+            }
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "kind": {
+            "const": "answer"
+          }
+        }
+      },
+      "then": {
+        "required": [
+          "target",
+          "answer"
+        ],
+        "not": {
+          "anyOf": [
+            {
+              "required": [
+                "field"
+              ]
+            },
+            {
+              "required": [
+                "before"
+              ]
+            },
+            {
+              "required": [
+                "after"
+              ]
+            },
+            {
+              "required": [
+                "content"
+              ]
+            },
+            {
+              "required": [
+                "note"
+              ]
+            },
+            {
+              "required": [
+                "links"
+              ]
+            },
+            {
+              "required": [
+                "notes"
+              ]
+            },
+            {
+              "required": [
+                "supersedes"
+              ]
+            },
+            {
+              "required": [
+                "merge_into"
+              ]
+            }
+          ]
+        }
+      }
+    },
+    {
+      "if": {
+        "anyOf": [
+          {
+            "required": [
+              "notes"
+            ]
+          }
+        ]
+      },
+      "then": {
+        "properties": {
+          "kind": {
+            "const": "review_notes"
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "anyOf": [
+          {
+            "required": [
+              "answer"
+            ]
+          },
+          {
+            "required": [
+              "answer_note"
+            ]
+          }
+        ]
+      },
+      "then": {
+        "properties": {
+          "kind": {
+            "const": "answer"
+          }
+        }
+      }
+    },
+    {
+      "description": "exclude entries fit the kind: {field, value} on add_link, {note} or {target, field, value} on review_notes.",
+      "if": {
+        "required": [
+          "kind",
+          "decision"
+        ],
+        "properties": {
+          "kind": {
+            "const": "add_link"
+          },
+          "decision": {
+            "required": [
+              "exclude"
+            ]
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "decision": {
+            "properties": {
+              "exclude": {
+                "items": {
+                  "required": [
+                    "field",
+                    "value"
+                  ],
+                  "not": {
+                    "anyOf": [
+                      {
+                        "required": [
+                          "target"
+                        ]
+                      },
+                      {
+                        "required": [
+                          "note"
+                        ]
+                      }
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "if": {
+        "required": [
+          "kind",
+          "decision"
+        ],
+        "properties": {
+          "kind": {
+            "const": "review_notes"
+          },
+          "decision": {
+            "required": [
+              "exclude"
+            ]
+          }
+        }
+      },
+      "then": {
+        "properties": {
+          "decision": {
+            "properties": {
+              "exclude": {
+                "items": {
+                  "anyOf": [
+                    {
+                      "required": [
+                        "note"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "target",
+                        "field",
+                        "value"
+                      ]
+                    }
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
     }
   ]
 }

package/templates/brain/brain.json

@@ -32,7 +32,8 @@
         "source": "Source",
         "brain_id": "Brain ID"
       },
-      "new_task_status": "To Do"
+      "new_task_status": "To Do",
+      "status_type": "status"
     }
   }
 }