ultimate-brain 0.3.1 → 0.4.0

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/AGENTS.md

@@ -13,11 +13,11 @@ 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` |
-| 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` |
+| catch up: do everything that's waiting (decided reviews, reviewed meetings, the Inbox and its attachments, the drop folder, linked repos, reports asked for) | `brain-catch-up` |
+| ingest one input: reviewed minutes, a document, a web page, a pasted email or note, the Inbox, the drop folder, a linked repo; link a repo | `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` |
+| answer a question from the brain, or write a report on a subject | `brain-query` |
 | learn how the system works ("how do I…", "why didn't…") | `brain-howto` |
 | change the Notion structure (databases, properties, views) | `brain-notion-change`; structure is changed in the product repo first, never edited directly in Notion (0022) |
 
@@ -47,7 +47,7 @@ Each operation has a skill; follow it end to end:
 6. **Decision gate.** A decision note is for a choice that is hard to reverse, surprising without context, or a real trade-off. Anything smaller becomes a dated line in the project, through a proposal.
 7. **Dated, not "current".** Write facts as timeless, dated ("as of 2026-12-03"), or as pointers ("status: see Notion"). Volatile status (task state, project status, priority) lives in Notion.
 8. **Cite canonical notes.** `index.md` and the views are navigation; cite the note or source they point to.
-9. **Answering is read-only.** Answering the user's questions from the brain writes nothing; save an answer to the brain only when the user asks.
+9. **Answering is read-only.** Answering the user's questions from the brain writes nothing; save an answer to the brain only when the user asks. A report the user asks for is stored as a dated view in `reports/` and published, never as knowledge: it is never ingested or cited as a source (decision 0043).
 10. **Unattended runs add, never apply.** With no user present, an agent may add drafts and proposals; applying proposals waits for the user.
 
 ## Reading notes

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"
     }
   }
 }