Cognition-OS/spec/cognition-object-model.md

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)