Framework design upload

spec/cognition-object-model.md

@@ -0,0 +1,26 @@
+# Cognition object model (draft)
+
+This document defines the core objects that flow through the system.
+
+## Intent
+- What is being requested?
+- Expected outputs and side effects (if any)
+
+## Constraints
+- Budgets: time, compute, context, risk
+- Policy set references
+- Tool allow/deny lists
+
+## Capability
+- Granted authority for a specific action/tool
+- Scope, TTL, limits, revocation
+
+## Event (provenance)
+- Immutable record of an action taken
+- Includes: who/what, inputs, outputs, timestamps, capability IDs
+
+## Result
+- Output payload
+- Confidence/uncertainty metadata
+- Provenance links (event IDs)
+