Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Entity Schema

ADR

FieldTypeDescription
idStringUUID
titleStringADR title
numberu32Sequential number
statusEnumproposed, accepted, deprecated, superseded
agentStringAuthor
contextStringContext and problem statement
decisionStringDecision description
consequencesStringConsequences of the decision
alternativesVec<Alternative>Options considered
implementationOption<String>Implementation notes
related_adrsVec<String>Related ADR IDs
superseded_byOption<String>Newer ADR
supersedesVec<String>Older ADRs replaced
stakeholdersVec<String>People involved
tagsVec<String>Tags
metadataHashMapAdditional data
created_atDateTimeCreation timestamp
updated_atDateTimeLast update
decision_dateOption<DateTime>When decided

AgentSandbox

FieldTypeDescription
idStringUUID
agent_idStringAgent this sandbox applies to
sandbox_levelEnumunrestricted, standard, restricted, isolated, training
permissionsPermissionSetAllowed commands, paths, file ops, network, quality gates, workflows
resource_limitsResourceLimitsMemory, CPU, disk, execution time, concurrency limits
command_filterCommandFilterWhitelist/blacklist mode, patterns, dangerous pattern detection
escalation_policyEscalationPolicyAuto-approve, human approval requirements, timeout, fallback
created_byStringWho created this sandbox
agentStringOwner
violation_countu32Number of violations recorded
metadataHashMapAdditional data
created_atDateTimeCreation timestamp
last_modifiedDateTimeLast modification

BottleneckReport

FieldTypeDescription
idStringUUID
project_pathStringRepo path
computed_atDateTimeComputation timestamp
agentStringAuthor
slowest_tasksVec<BottleneckEntry>Top-N longest-running tasks
blocked_tasksVec<BottleneckEntry>All blocked tasks
total_analyzedu64Total tasks analyzed
blocked_countu64Number of blocked tasks
metadataHashMapAdditional data

Compliance

FieldTypeDescription
idStringUUID
titleStringRequirement title
descriptionStringRequirement description
categoryStringCompliance category
statusEnumcompliant, non_compliant, pending, exempt
severityOption<Enum>low, medium, high, critical
agentStringAuthor
due_dateOption<DateTime>Compliance deadline
evidenceVec<ComplianceEvidence>Supporting evidence
violationsVec<ComplianceViolation>Violations found
related_standardsVec<String>Referenced standard IDs
tagsVec<String>Tags
metadataHashMapAdditional data
created_atDateTimeCreation timestamp
updated_atDateTimeLast update

Context

FieldTypeDescription
idStringUUID
titleStringContext title
contentStringActual content
sourceOption<String>URL or source
agentStringOwner
created_atDateTimeCreation timestamp

DocFragment

FieldTypeDescription
idStringUUID
topicStringTopic (e.g. “adrs”, “knowledge”)
chunk_idStringChunk identifier within topic
titleStringHuman-readable title
contentStringMarkdown content
orderu32Position within topic
written_atDateTimeWhen written
agentStringAuthor
source_entity_idsVec<String>Source material entity IDs
staleboolWhether source entities changed since written

DoraMetricsReport

FieldTypeDescription
idStringUUID
project_pathStringRepo path
computed_atDateTimeComputation timestamp
window_startDateTimeTime window start
window_endDateTimeTime window end
commits_analyzedu64Commits analyzed
executions_analyzedu64Execution results analyzed
escalations_analyzedu64Escalation requests analyzed
deployment_frequencyf64Deployments per week
lead_time_for_changesf64Days
change_failure_ratef640.0 - 1.0
mean_time_to_recoveryf64Hours
agentStringAuthor
metadataHashMapAdditional data

EscalationRequest

FieldTypeDescription
idStringUUID
agent_idStringRequesting agent
session_idOption<String>Session when requested
operation_typeEnumfile_system_access, network_access, command_execution, privilege_escalation, quality_gate_override, workflow_modification, resource_limit_increase, custom
statusEnumpending, approved, denied, expired, cancelled
priorityEnumlow, normal, high, critical
operation_contextOperationContextBlocked operation details
justificationStringAgent’s justification
impact_if_deniedOption<String>Impact if request denied
suggested_reviewerOption<String>Suggested reviewer
reviewerOption<ReviewerInfo>Assigned reviewer
decisionOption<ReviewDecision>Review decision
created_atDateTimeCreation timestamp
updated_atDateTimeLast update
expires_atDateTimeExpiration timestamp
reviewed_atOption<DateTime>When reviewed
similar_request_countu32Similar past requests
agentStringOwner
metadataHashMapAdditional data

ExecutionResult

FieldTypeDescription
idStringUUID
task_idStringAssociated task
workflow_stageStringWorkflow stage when executed
commandStringCommand executed
exit_codei32Exit code
stdoutStringStandard output
stderrStringStandard error
timestampDateTimeExecution timestamp
duration_msu64Duration in milliseconds
environmentHashMap<String, String>Environment variables
file_changesVec<String>Files changed
expected_resultOption<Enum>success, failure, any
validation_statusEnumpassed, failed, skipped
quality_gateStringQuality gate identifier
working_directoryOption<String>Working directory
retry_countu32Retry count
previous_execution_idOption<String>Previous execution if retry
agentStringAuthor
tagsVec<String>Tags
metadataHashMapAdditional data

Knowledge

FieldTypeDescription
idStringUUID
titleStringKnowledge title
contentStringThe knowledge
knowledge_typeEnumfact, pattern, rule, concept, procedure, heuristic
confidencef640.0-1.0
sourceOption<String>Source URL
tagsVec<String>Tags
agentStringAuthor
bounded_contextOption<String>Optional scope where this knowledge applies
related_knowledgeVec<String>Related knowledge IDs
contextsVec<String>Contexts where this applies
usage_countu64Times referenced
last_usedOption<DateTime>Last usage timestamp
decay_weightOption<f64>Freshness score computed as e^(-lambda * days_since_last_used), clamped to 0.0-1.0
citation_countu32Number of inbound entity relationships/citations
last_used_atOption<String>ISO 8601 timestamp of last reference
metadataHashMapAdditional data
created_atDateTimeCreation timestamp
updated_atDateTimeLast update

Lesson

FieldTypeDescription
idStringUUID
titleStringShort title summarising the lesson
mistakeStringDescription of the mistake
correctionStringCorrect approach
prevention_ruleStringRule to prevent recurrence
domainStringDomain (e.g. “rust”, “postgres”)
categoryEnumcode, domain, process, design
severityEnumlow, medium, high
agentStringAuthor
tagsVec<String>Tags
created_atDateTimeCreation timestamp
updated_atDateTimeLast update

Persona

FieldTypeDescription
idStringUUID
slugStringURL-safe slug ([a-z0-9-]+)
titleStringDisplay title
descriptionStringShort description
instructionsStringFull system-prompt instructions
domainStringSpecialisation domain
cov_questionsVec<String>Calibration of Values questions (3-5)
fap_tableHashMap<String, String>Foundational Assumptions & Principles
ov_requirementsVec<String>Operational Values / requirements
base_personaOption<String>Base persona slug this extends
agentStringAuthor
tagsVec<String>Tags
versionStringSemantic version (default “1.0.0”)
created_atDateTimeCreation timestamp
updated_atDateTimeLast update

ProgressiveGateConfig

FieldTypeDescription
idStringUUID
nameStringConfig name
descriptionStringDescription
gate_levelsVec<GateLevel>Defined gate levels with thresholds
escalation_rulesVec<EscalationRule>Escalation triggers and actions
optimization_settingsOptimizationSettingsHistorical learning, caching, adaptive timeouts
activeboolWhether config is active
agentStringAuthor
created_atDateTimeCreation timestamp
updated_atDateTimeLast update

Reasoning

FieldTypeDescription
idStringUUID
titleStringDecision title
task_idStringRelated task
stepsVec<ReasoningStep>Ordered reasoning steps
conclusionStringFinal conclusion
confidencef64Overall confidence, 0.0-1.0
agentStringAuthor
created_atDateTimeCreation timestamp
tagsVec<String>Tags
context_idsVec<String>Supporting context IDs
knowledge_idsVec<String>Supporting knowledge IDs
metadataHashMapAdditional data
ibis_modeOption<bool>Whether IBIS capture mode was used
positionsVec<IbisPosition>Captured issue/position/argument entries, flattened to steps for compatibility
prov_usedVec<String>W3C PROV entities used
prov_generatedVec<String>W3C PROV entities generated
prov_attributed_toStringW3C PROV attribution
prov_activity_idOption<String>External PROV activity ID
prov_was_informed_byVec<String>Informing activity IDs
ibis_node_typeOption<Enum>Chain-level IBIS node type: question, idea, pro, con, reference, note
ibis_parent_idOption<String>Parent IBIS node ID
ibis_positionOption<f64>Optional layout/order position

ReasoningStep

FieldTypeDescription
idStringStep ID
descriptionStringStep description
conclusionStringStep conclusion
evidenceVec<String>Supporting evidence
confidencef64Step confidence
timestampDateTimeStep timestamp
ibis_typeOption<Enum>question, idea, pro, con, reference, note
ibis_polarityOption<Enum>pro or con
parent_step_idOption<String>Parent step for IBIS hierarchy

IbisPosition

FieldTypeDescription
position_typeEnumissue, position, or argument
contentStringPosition text
responds_toOption<String>Parent issue/position/argument this position responds to

Relationship

FieldTypeDescription
idStringUUID
source_idStringSource entity ID
target_idStringTarget entity ID
relationship_typeStringType (references, depends_on, etc.)
agentStringAuthor
created_atDateTimeCreation timestamp

Rule

FieldTypeDescription
idStringUUID
titleStringRule title
descriptionStringRule description
rule_typeEnumvalidation, transformation, enforcement, notification
statusEnumactive, inactive, deprecated
priorityEnumlow, medium, high, critical
conditionJSONRule condition logic
actionJSONRule action to execute
entity_typesVec<String>Entity types this rule applies to
execution_historyVec<RuleExecution>Past executions
tagsVec<String>Tags
related_rulesVec<String>Related rule IDs
metadataHashMapAdditional data
agentStringAuthor
created_atDateTimeCreation timestamp
updated_atDateTimeLast update

Session

FieldTypeDescription
idStringUUID
titleStringSession title
agentStringAgent name
statusEnumactive, paused, completed, cancelled, reflecting
start_timeDateTimeSession start
end_timeOption<DateTime>Session end
duration_secondsOption<u64>Calculated duration
task_idsVec<String>Tasks worked on
context_idsVec<String>Context items used
knowledge_idsVec<String>Knowledge items referenced
active_theory_idOption<String>Bound theory
theory_idsVec<String>Referenced theories
reflection_idsVec<String>Generated reflections
goalsVec<String>Session goals
outcomesVec<String>Session outcomes
space_metricsOption<SpaceMetrics>SPACE framework scores
dora_metricsOption<DoraMetrics>DORA metrics
tagsVec<String>Tags
metadataHashMapAdditional data

Standard

FieldTypeDescription
idStringUUID
titleStringStandard title
descriptionStringStandard description
categoryEnumcoding, testing, documentation, security, performance, process, architecture
statusEnumdraft, active, deprecated, superseded
versionStringSemantic version
agentStringAuthor
effective_dateDateTimeWhen standard takes effect
superseded_byOption<String>Newer standard
supersedesVec<String>Older standards replaced
related_standardsVec<String>Related standard IDs
requirementsVec<StandardRequirement>Requirements/guidelines
tagsVec<String>Tags
metadataHashMapAdditional data
created_atDateTimeCreation timestamp
updated_atDateTimeLast update

StateReflection

FieldTypeDescription
idStringUUID
theory_idStringTheory being evaluated
observed_stateStringRaw observation/error
cognitive_dissonanceVec<String>Conflicts detected
proposed_theory_updatesVec<String>Proposed fixes
dissonance_scoref640.0-1.0
trigger_typeEnumtest_failure, runtime_error, etc.
severityEnumnone, low, medium, high, critical
resolvedboolResolution status
new_theory_idOption<String>Updated theory
agentStringAuthor
created_atDateTimeCreation timestamp

StaleTaskReport

FieldTypeDescription
idStringUUID
computed_atDateTimeComputation timestamp
stale_threshold_hoursi64Hours before considered stale
total_in_progressusizeTotal in-progress tasks
total_staleusizeStale tasks found
stale_tasksVec<StaleTaskEntry>Stale task details
metadataHashMapAdditional data

Task

FieldTypeDescription
idStringUUID
titleStringTask title
descriptionStringDetailed description
statusEnumtodo, in_progress, done, blocked, cancelled
priorityEnumlow, medium, high, critical
agentStringOwner
start_timeDateTimeStart timestamp
end_timeOption<DateTime>End timestamp
parentOption<String>Parent task ID
childrenVec<String>Child task IDs
tagsVec<String>Tags
context_idsVec<String>Associated context IDs
knowledgeVec<String>Knowledge items
filesVec<String>Related files
outcomeOption<String>Task outcome
block_reasonOption<String>Reason for blocking
workflow_idOption<String>Associated workflow ID
workflow_stateOption<String>Current workflow state
metadataHashMapAdditional data

TaskDurationReport

FieldTypeDescription
idStringUUID
project_pathStringRepo path
computed_atDateTimeComputation timestamp
agentStringAuthor
total_tasks_analyzedu64Total tasks
completed_tasksu64Completed tasks
task_durationsVec<TaskDurationEntry>Per-task duration details
median_duration_hoursf64Median (completed only)
mean_duration_hoursf64Mean (completed only)
min_duration_hoursf64Min (completed only)
max_duration_hoursf64Max (completed only)
metadataHashMapAdditional data

Theory

FieldTypeDescription
idStringUUID
domain_nameStringDomain identifier
conceptual_modelHashMapConcept to definition
system_mappingHashMapConcept to code location
design_rationaleHashMapDecision to reason
invariantsVec<String>Must-be-true statements
iteration_countu32Theory version
reflection_idsVec<String>Applied reflections
task_idOption<String>Associated task
agentStringAuthor
created_atDateTimeCreation timestamp
updated_atDateTimeLast update

Workflow

FieldTypeDescription
idStringUUID
titleStringWorkflow title
descriptionStringDescription
statusEnumactive, inactive, draft, archived
agentStringOwner
statesVec<WorkflowState>State definitions
transitionsVec<WorkflowTransition>Valid transitions
initial_stateStringStarting state
final_statesVec<String>Terminal states
entity_typesVec<String>Applicable entity types
permission_schemesVec<PermissionScheme>Permission rules
event_handlersVec<EventHandler>Event handlers
tagsVec<String>Tags
metadataHashMapAdditional data
created_atDateTimeCreation timestamp
updated_atDateTimeLast update

WorkflowInstance

FieldTypeDescription
idStringUUID
workflow_idStringAssociated workflow ID
current_stateStringCurrent state name
contextWorkflowExecutionContextExecution context (agent, variables, permissions)
statusEnumWorkflow execution status
started_atDateTimeStart timestamp
updated_atDateTimeLast update timestamp
completed_atOption<DateTime>Completion timestamp
execution_historyVec<WorkflowExecutionEvent>Execution history
step_countu64Transitions executed