ultimate-brain 0.0.0-stage → 0.2.0

package/spec/schemas/note.schema.json

@@ -0,0 +1,1102 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://ultimate-brain.dev/schemas/v1/note.schema.json",
+  "title": "Brain note frontmatter (v1)",
+  "description": "Frontmatter of every Markdown note in a user's brain, except proposals (proposal.schema.json). See spec/schema.md.",
+  "type": "object",
+  "required": [
+    "id",
+    "type",
+    "title",
+    "created",
+    "updated"
+  ],
+  "properties": {
+    "id": {
+      "$ref": "#/$defs/id"
+    },
+    "type": {
+      "enum": [
+        "area",
+        "goal",
+        "project",
+        "person",
+        "org",
+        "meeting",
+        "decision",
+        "question",
+        "concept",
+        "source",
+        "view",
+        "memory"
+      ]
+    },
+    "title": {
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 120
+    },
+    "created": {
+      "$ref": "#/$defs/date"
+    },
+    "updated": {
+      "$ref": "#/$defs/date"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "area"
+          }
+        }
+      },
+      "then": {
+        "$ref": "#/$defs/area"
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "goal"
+          }
+        }
+      },
+      "then": {
+        "$ref": "#/$defs/goal"
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "project"
+          }
+        }
+      },
+      "then": {
+        "$ref": "#/$defs/project"
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "person"
+          }
+        }
+      },
+      "then": {
+        "$ref": "#/$defs/person"
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "org"
+          }
+        }
+      },
+      "then": {
+        "$ref": "#/$defs/org"
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "meeting"
+          }
+        }
+      },
+      "then": {
+        "$ref": "#/$defs/meeting"
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "decision"
+          }
+        }
+      },
+      "then": {
+        "$ref": "#/$defs/decision"
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "question"
+          }
+        }
+      },
+      "then": {
+        "$ref": "#/$defs/question"
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "concept"
+          }
+        }
+      },
+      "then": {
+        "$ref": "#/$defs/concept"
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "source"
+          }
+        }
+      },
+      "then": {
+        "$ref": "#/$defs/source"
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "view"
+          }
+        }
+      },
+      "then": {
+        "$ref": "#/$defs/view"
+      }
+    },
+    {
+      "if": {
+        "properties": {
+          "type": {
+            "const": "memory"
+          }
+        }
+      },
+      "then": {
+        "$ref": "#/$defs/memory"
+      }
+    }
+  ],
+  "$defs": {
+    "idChars": {
+      "type": "string",
+      "pattern": "^[0-9abcdefghjkmnpqrstvwxyz]{8}$"
+    },
+    "id": {
+      "type": "string",
+      "pattern": "^(area|gol|prj|per|org|mtg|dec|que|con|src|mem|prp|vw)-[0-9abcdefghjkmnpqrstvwxyz]{8}$"
+    },
+    "areaId": {
+      "type": "string",
+      "pattern": "^area-[0-9abcdefghjkmnpqrstvwxyz]{8}$"
+    },
+    "goalId": {
+      "type": "string",
+      "pattern": "^gol-[0-9abcdefghjkmnpqrstvwxyz]{8}$"
+    },
+    "projectId": {
+      "type": "string",
+      "pattern": "^prj-[0-9abcdefghjkmnpqrstvwxyz]{8}$"
+    },
+    "personId": {
+      "type": "string",
+      "pattern": "^per-[0-9abcdefghjkmnpqrstvwxyz]{8}$"
+    },
+    "orgId": {
+      "type": "string",
+      "pattern": "^org-[0-9abcdefghjkmnpqrstvwxyz]{8}$"
+    },
+    "meetingId": {
+      "type": "string",
+      "pattern": "^mtg-[0-9abcdefghjkmnpqrstvwxyz]{8}$"
+    },
+    "decisionId": {
+      "type": "string",
+      "pattern": "^dec-[0-9abcdefghjkmnpqrstvwxyz]{8}$"
+    },
+    "questionId": {
+      "type": "string",
+      "pattern": "^que-[0-9abcdefghjkmnpqrstvwxyz]{8}$"
+    },
+    "sourceId": {
+      "type": "string",
+      "pattern": "^src-[0-9abcdefghjkmnpqrstvwxyz]{8}$"
+    },
+    "date": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
+    },
+    "month": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}$"
+    },
+    "dateOrMonth": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$"
+    },
+    "timestamp": {
+      "type": "string",
+      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?Z$"
+    },
+    "sourceKey": {
+      "type": "string",
+      "anyOf": [
+        {
+          "pattern": "^notion:[0-9a-f-]{32,36}$"
+        },
+        {
+          "pattern": "^url:https://\\S+$"
+        },
+        {
+          "pattern": "^file:sha256:[0-9a-f]{64}$"
+        },
+        {
+          "pattern": "^agent:[a-z0-9-]+/\\S+$"
+        },
+        {
+          "pattern": "^notion-edit$"
+        },
+        {
+          "pattern": "^(area|gol|prj|per|org|mtg|dec|que|con|src|mem)-[0-9abcdefghjkmnpqrstvwxyz]{8}$"
+        }
+      ]
+    },
+    "lifecycle": {
+      "enum": [
+        "draft",
+        "reviewed",
+        "disputed",
+        "archived"
+      ]
+    },
+    "assessment": {
+      "enum": [
+        "accepted",
+        "provisional",
+        "contested",
+        "superseded"
+      ]
+    },
+    "notionPageId": {
+      "type": "string",
+      "pattern": "^[0-9a-f]{8}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{4}-?[0-9a-f]{12}$"
+    },
+    "factValue": {
+      "type": [
+        "string",
+        "number"
+      ]
+    },
+    "relation": {
+      "type": "object",
+      "required": [
+        "type",
+        "target"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "type": {
+          "enum": [
+            "supersedes",
+            "superseded_by",
+            "about",
+            "depends_on",
+            "contradicts",
+            "derived_from",
+            "related_to"
+          ]
+        },
+        "target": {
+          "$ref": "#/$defs/id"
+        }
+      }
+    },
+    "timelineEntry": {
+      "type": "object",
+      "required": [
+        "field",
+        "value",
+        "from",
+        "learned",
+        "source",
+        "assessment"
+      ],
+      "additionalProperties": false,
+      "properties": {
+        "field": {
+          "type": "string",
+          "pattern": "^[a-z][a-z0-9_]*$"
+        },
+        "value": {
+          "$ref": "#/$defs/factValue"
+        },
+        "from": {
+          "$ref": "#/$defs/dateOrMonth"
+        },
+        "until": {
+          "$ref": "#/$defs/dateOrMonth"
+        },
+        "learned": {
+          "$ref": "#/$defs/date"
+        },
+        "source": {
+          "$ref": "#/$defs/sourceKey"
+        },
+        "assessment": {
+          "$ref": "#/$defs/assessment"
+        },
+        "note": {
+          "type": "string"
+        }
+      }
+    },
+    "notionFieldsBase": {
+      "type": "object",
+      "required": [
+        "as_of"
+      ],
+      "properties": {
+        "as_of": {
+          "$ref": "#/$defs/timestamp"
+        }
+      }
+    },
+    "knowledge": {
+      "type": "object",
+      "required": [
+        "summary",
+        "lifecycle"
+      ],
+      "properties": {
+        "summary": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 400
+        },
+        "lifecycle": {
+          "$ref": "#/$defs/lifecycle"
+        },
+        "aliases": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+          }
+        },
+        "area": {
+          "$ref": "#/$defs/areaId"
+        },
+        "projects": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/projectId"
+          }
+        },
+        "sources": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/sourceKey"
+          }
+        },
+        "relations": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/relation"
+          }
+        },
+        "facts": {
+          "type": "object",
+          "propertyNames": {
+            "pattern": "^[a-z][a-z0-9_]*$"
+          },
+          "additionalProperties": {
+            "$ref": "#/$defs/factValue"
+          }
+        },
+        "timeline": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/timelineEntry"
+          }
+        },
+        "notion": {
+          "$ref": "#/$defs/notionPageId"
+        },
+        "last_synced": {
+          "$ref": "#/$defs/timestamp"
+        },
+        "notion_fields": {
+          "$ref": "#/$defs/notionFieldsBase"
+        },
+        "notion_published": {
+          "description": "Notion property name → value last published or imported (spec/cli.md §5.14).",
+          "type": "object"
+        }
+      }
+    },
+    "area": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/knowledge"
+        }
+      ],
+      "properties": {
+        "notion_fields": {
+          "properties": {
+            "type": {
+              "enum": [
+                "Business",
+                "Personal"
+              ]
+            },
+            "archived": {
+              "type": "boolean"
+            }
+          }
+        }
+      }
+    },
+    "goal": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/knowledge"
+        }
+      ],
+      "required": [
+        "why",
+        "area"
+      ],
+      "properties": {
+        "why": {
+          "type": "string",
+          "minLength": 1,
+          "maxLength": 300
+        },
+        "facts": {
+          "properties": {
+            "deadline": {
+              "$ref": "#/$defs/dateOrMonth"
+            }
+          }
+        },
+        "notion_fields": {
+          "properties": {
+            "status": {
+              "enum": [
+                "Not Started",
+                "Active",
+                "Achieved",
+                "Dropped"
+              ]
+            },
+            "progress": {
+              "type": "number",
+              "minimum": 0,
+              "maximum": 1
+            },
+            "archived": {
+              "type": "boolean"
+            },
+            "key_results": {
+              "type": "array",
+              "items": {
+                "type": "object",
+                "required": [
+                  "name",
+                  "kind"
+                ],
+                "properties": {
+                  "name": {
+                    "type": "string"
+                  },
+                  "kind": {
+                    "enum": [
+                      "Number",
+                      "Milestone"
+                    ]
+                  },
+                  "start": {
+                    "type": "number"
+                  },
+                  "current": {
+                    "type": "number"
+                  },
+                  "target": {
+                    "type": "number"
+                  },
+                  "unit": {
+                    "type": "string"
+                  },
+                  "done": {
+                    "type": "boolean"
+                  },
+                  "due": {
+                    "$ref": "#/$defs/date"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "project": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/knowledge"
+        }
+      ],
+      "required": [
+        "area"
+      ],
+      "properties": {
+        "goal": {
+          "$ref": "#/$defs/goalId"
+        },
+        "client": {
+          "$ref": "#/$defs/orgId"
+        },
+        "people": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/personId"
+          }
+        },
+        "notion_fields": {
+          "properties": {
+            "status": {
+              "enum": [
+                "Planned",
+                "Active",
+                "On Hold",
+                "Done"
+              ]
+            },
+            "priority": {
+              "enum": [
+                "High",
+                "Medium",
+                "Low"
+              ]
+            },
+            "dates": {
+              "type": "object",
+              "properties": {
+                "start": {
+                  "$ref": "#/$defs/date"
+                },
+                "end": {
+                  "$ref": "#/$defs/date"
+                }
+              }
+            },
+            "archived": {
+              "type": "boolean"
+            }
+          }
+        }
+      }
+    },
+    "person": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/knowledge"
+        }
+      ],
+      "properties": {
+        "org": {
+          "$ref": "#/$defs/orgId"
+        },
+        "notion_fields": {
+          "properties": {
+            "email": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "org": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/knowledge"
+        }
+      ],
+      "properties": {
+        "notion_fields": {
+          "properties": {
+            "relationship": {
+              "enum": [
+                "Client",
+                "Prospect",
+                "Partner",
+                "Supplier",
+                "Other"
+              ]
+            },
+            "website": {
+              "type": "string"
+            }
+          }
+        }
+      }
+    },
+    "meeting": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/knowledge"
+        }
+      ],
+      "required": [
+        "date",
+        "attendees",
+        "source"
+      ],
+      "properties": {
+        "date": {
+          "$ref": "#/$defs/date"
+        },
+        "attendees": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/personId"
+          }
+        },
+        "source": {
+          "$ref": "#/$defs/sourceId"
+        },
+        "decisions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/decisionId"
+          }
+        },
+        "questions": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/questionId"
+          }
+        },
+        "tasks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/notionPageId"
+          }
+        }
+      }
+    },
+    "decision": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/knowledge"
+        }
+      ],
+      "required": [
+        "date",
+        "assessment"
+      ],
+      "properties": {
+        "date": {
+          "$ref": "#/$defs/date"
+        },
+        "assessment": {
+          "$ref": "#/$defs/assessment"
+        },
+        "decided_in": {
+          "$ref": "#/$defs/meetingId"
+        },
+        "deciders": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/personId"
+          }
+        },
+        "valid_from": {
+          "$ref": "#/$defs/date"
+        },
+        "valid_until": {
+          "$ref": "#/$defs/date"
+        }
+      },
+      "if": {
+        "properties": {
+          "assessment": {
+            "const": "superseded"
+          }
+        },
+        "required": [
+          "assessment"
+        ]
+      },
+      "then": {
+        "required": [
+          "valid_until"
+        ]
+      }
+    },
+    "question": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/knowledge"
+        }
+      ],
+      "required": [
+        "kind"
+      ],
+      "properties": {
+        "kind": {
+          "enum": [
+            "question",
+            "risk"
+          ]
+        },
+        "raised_in": {
+          "$ref": "#/$defs/meetingId"
+        },
+        "answer": {
+          "type": "string"
+        },
+        "notion_fields": {
+          "properties": {
+            "status": {
+              "enum": [
+                "Open",
+                "Answered",
+                "Dropped"
+              ]
+            }
+          }
+        }
+      }
+    },
+    "concept": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/knowledge"
+        }
+      ]
+    },
+    "source": {
+      "required": [
+        "source_key",
+        "content_hash",
+        "captured"
+      ],
+      "properties": {
+        "source_key": {
+          "$ref": "#/$defs/sourceKey"
+        },
+        "content_hash": {
+          "type": "string",
+          "pattern": "^sha256:[0-9a-f]{64}$"
+        },
+        "captured": {
+          "$ref": "#/$defs/timestamp"
+        },
+        "origin_edited": {
+          "$ref": "#/$defs/timestamp"
+        },
+        "kind": {
+          "enum": [
+            "minutes",
+            "document",
+            "email",
+            "chat",
+            "note",
+            "capture"
+          ]
+        },
+        "file_name": {
+          "type": "string",
+          "minLength": 1,
+          "pattern": "^[^/\\\\]+$"
+        },
+        "converter": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "not": {
+        "anyOf": [
+          {
+            "required": [
+              "lifecycle"
+            ]
+          },
+          {
+            "required": [
+              "facts"
+            ]
+          },
+          {
+            "required": [
+              "timeline"
+            ]
+          }
+        ]
+      },
+      "allOf": [
+        {
+          "if": {
+            "required": [
+              "source_key"
+            ],
+            "properties": {
+              "source_key": {
+                "pattern": "^file:"
+              }
+            }
+          },
+          "then": {
+            "required": [
+              "kind",
+              "file_name",
+              "converter"
+            ]
+          }
+        }
+      ]
+    },
+    "view": {
+      "required": [
+        "view_kind",
+        "project",
+        "generated_from",
+        "generated_at"
+      ],
+      "properties": {
+        "view_kind": {
+          "enum": [
+            "brief",
+            "decision_log"
+          ]
+        },
+        "project": {
+          "$ref": "#/$defs/projectId"
+        },
+        "generated_from": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/id"
+          }
+        },
+        "generated_at": {
+          "$ref": "#/$defs/timestamp"
+        }
+      },
+      "not": {
+        "anyOf": [
+          {
+            "required": [
+              "lifecycle"
+            ]
+          },
+          {
+            "required": [
+              "facts"
+            ]
+          },
+          {
+            "required": [
+              "timeline"
+            ]
+          }
+        ]
+      }
+    },
+    "memory": {
+      "required": [
+        "scope",
+        "confidence",
+        "origin"
+      ],
+      "properties": {
+        "scope": {
+          "enum": [
+            "general",
+            "area",
+            "project",
+            "stack"
+          ]
+        },
+        "areas": {
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/areaId"
+          }
+        },
+        "stacks": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$"
+          }
+        },
+        "confidence": {
+          "enum": [
+            "verified",
+            "inferred",
+            "unverified"
+          ]
+        },
+        "origin": {
+          "type": "string",
+          "minLength": 1
+        }
+      },
+      "allOf": [
+        {
+          "$ref": "#/$defs/knowledge"
+        },
+        {
+          "if": {
+            "properties": {
+              "scope": {
+                "const": "general"
+              }
+            }
+          },
+          "then": {
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "areas"
+                  ]
+                },
+                {
+                  "required": [
+                    "projects"
+                  ]
+                },
+                {
+                  "required": [
+                    "stacks"
+                  ]
+                }
+              ]
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "scope": {
+                "const": "area"
+              }
+            }
+          },
+          "then": {
+            "required": [
+              "areas"
+            ],
+            "properties": {
+              "areas": {
+                "minItems": 1
+              }
+            },
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "projects"
+                  ]
+                },
+                {
+                  "required": [
+                    "stacks"
+                  ]
+                }
+              ]
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "scope": {
+                "const": "project"
+              }
+            }
+          },
+          "then": {
+            "required": [
+              "projects"
+            ],
+            "properties": {
+              "projects": {
+                "minItems": 1
+              }
+            },
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "areas"
+                  ]
+                },
+                {
+                  "required": [
+                    "stacks"
+                  ]
+                }
+              ]
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "scope": {
+                "const": "stack"
+              }
+            }
+          },
+          "then": {
+            "required": [
+              "stacks"
+            ],
+            "properties": {
+              "stacks": {
+                "minItems": 1
+              }
+            },
+            "not": {
+              "anyOf": [
+                {
+                  "required": [
+                    "areas"
+                  ]
+                },
+                {
+                  "required": [
+                    "projects"
+                  ]
+                }
+              ]
+            }
+          }
+        }
+      ]
+    }
+  }
+}