Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.rkat.ai/llms.txt

Use this file to discover all available pages before exploring further.

Finite Ownership Ledger

Status: Generated Source: xtask ownership-ledger This document is generated from the typed ownership registry in xtask. It is the authoritative inventory of semantic state, semantic-operation boundaries, and keyed-store invariants for the current closure program.
Note: historical path references below that point at meerkat-runtime/src/meerkat_machine/ should now be read as the split module tree under meerkat-runtime/src/meerkat_machine/.

Summary

SubsystemState CellsSemantic OperationsCoupling InvariantsOpen State CellsOpen OperationsOpen Invariants
runtime7215000
mcp11212000
mob6433000

Boundary Manifest

FamilyKindPathType / TraitMethods
runtime-control-planetrait-implmeerkat-runtime/src/meerkat_machine/MeerkatMachine / RuntimeControlPlaneingest, publish_event, retire, recycle, reset, recover, destroy
runtime-session-adapterpublic-inherentmeerkat-runtime/src/meerkat_machine/MeerkatMachineregister_session, set_session_silent_intents, register_session_with_executor, ensure_session_with_executor, unregister_session, interrupt_current_run, stop_runtime_executor, accept_input_and_run, accept_input_with_completion, update_peer_ingress_context, abort_comms_drains, abort_comms_drain, wait_comms_drain
mcp-routerpublic-inherentmeerkat-mcp/src/router.rsMcpRouterset_removal_timeout, add_server, stage_add, stage_remove, stage_reload, apply_staged, take_lifecycle_actions, take_external_updates, progress_removals, call_tool, shutdown
mcp-router-adapterpublic-inherentmeerkat-mcp/src/adapter.rsMcpRouterAdapterrefresh_tools, stage_add, stage_remove, stage_reload, apply_staged, poll_lifecycle_actions, progress_removals, wait_until_ready, shutdown
mob-handlepublic-inherentmeerkat-mob/src/runtime/handle.rsMobHandlespawn_spec, spawn_many, retire, respawn, retire_all, wire, unwire, internal_turn, run_flow, run_flow_with_stream, cancel_flow, stop, resume, complete, reset, destroy, task_create, task_update, set_spawn_policy, shutdown, force_cancel_member, wait_one, wait_all, spawn_helper, fork_helper
mob-command-dispatchenum-dispatchmeerkat-mob/src/runtime/actor.rsMobActor / MobCommandenqueue_spawn, handle_force_cancel, handle_retire, handle_respawn, handle_wire, handle_unwire, handle_external_turn, handle_internal_turn, retire_all_members, handle_task_create, handle_task_update, handle_run_flow, handle_cancel_flow, handle_flow_cleanup, handle_complete, handle_destroy, handle_reset
manual-callbackmanual-callbackmeerkat-runtime/src/meerkat_machine/MeerkatMachinenotify_comms_drain_exited
manual-callbackmanual-callbackmeerkat-mcp/src/router.rsMcpRouterprocess_pending_result
manual-callbackmanual-callbackmeerkat-mob/src/runtime/actor.rsMobActorhandle_spawn_provisioned_batch
shell-background-job-viewexport-contract (app-facing)meerkat-tools/src/builtin/shell/types.rsBackgroundJobexports_raw_operation_id=false
shell-job-summary-viewexport-contract (app-facing)meerkat-tools/src/builtin/shell/types.rsJobSummaryexports_raw_operation_id=false
mob-member-refexport-contract (app-facing)meerkat-mob/src/event.rsMemberRefexports_raw_operation_id=false
mob-infra-member-spawn-receiptexport-contract (infra-canonical-op)meerkat-mob/src/runtime/handle.rsMemberSpawnReceiptexports_raw_operation_id=true

Runtime State Cells

PathSymbolClassStatusAnchorContract
meerkat-runtime/src/meerkat_machine/MeerkatMachine.sessionscapability-indexclosedMeerkatMachine registered-session + attachment publication contractsrc: registered session entries with recovered driver/completion capabilities; trigger: register/ensure/attach/detach/unregister/destroy transitions + dead-attachment normalization; stale: forbidden
meerkat-runtime/src/meerkat_machine/MeerkatMachine.comms_drain_slotscapability-indexclosedMeerkatMachine registered-session contract + drain-control regionsrc: registered session keys + comms drain lifecycle slot allocation; trigger: register/unregister/destroy + drain lifecycle transitions + control installation; stale: forbidden
meerkat-runtime/src/meerkat_machine/RuntimeSessionEntry.drivercapability-handleclosedMeerkatMachine control + admission + input-lifecycle regions-
meerkat-runtime/src/meerkat_machine/RuntimeSessionEntry.phasecapability-handleclosedMeerkatMachine attachment publication contract-
meerkat-runtime/src/meerkat_machine/RuntimeSessionEntry.completionscapability-handleclosedInputLifecycle terminal wait plumbing-
meerkat-runtime/src/driver/ephemeral.rsEphemeralRuntimeDriver.queuederived-projectionclosedMeerkatMachine admission queue lanesrc: MeerkatMachine admission queue entries; trigger: any ingress queue mutation or rollback/recovery rebuild; stale: forbidden
meerkat-runtime/src/driver/ephemeral.rsEphemeralRuntimeDriver.steer_queuederived-projectionclosedMeerkatMachine admission steer lanesrc: MeerkatMachine admission steer entries; trigger: any ingress steer mutation or rollback/recovery rebuild; stale: forbidden

Runtime Semantic Operations

PathSymbolBoundaryStatusAnchor
meerkat-runtime/src/meerkat_machine/register_sessionpublic-inherentclosedMeerkatMachine registration + recovery publication contract
meerkat-runtime/src/meerkat_machine/set_session_silent_intentspublic-inherentclosedMeerkatMachine admission/control policy truth
meerkat-runtime/src/meerkat_machine/register_session_with_executorpublic-inherentclosedMeerkatMachine registration + attachment publication contract
meerkat-runtime/src/meerkat_machine/ensure_session_with_executorpublic-inherentclosedMeerkatMachine attachment publication contract + RuntimeControl transitions
meerkat-runtime/src/meerkat_machine/unregister_sessionpublic-inherentclosedregistered-session contract + MeerkatMachine drain-control region
meerkat-runtime/src/meerkat_machine/interrupt_current_runpublic-inherentclosedMeerkatMachine control region + runtime attachment publication contract
meerkat-runtime/src/meerkat_machine/stop_runtime_executorpublic-inherentclosedMeerkatMachine control region + runtime attachment publication contract
meerkat-runtime/src/meerkat_machine/accept_input_and_runpublic-inherentclosedMeerkatMachine admission + input lifecycle + control regions
meerkat-runtime/src/meerkat_machine/accept_input_with_completionpublic-inherentclosedMeerkatMachine admission + input-lifecycle regions
meerkat-runtime/src/meerkat_machine/update_peer_ingress_contextpublic-inherentclosedMeerkatMachine drain-control region
meerkat-runtime/src/meerkat_machine/notify_comms_drain_exitedmanual-callbackclosedMeerkatMachine drain-control region
meerkat-runtime/src/meerkat_machine/abort_comms_drainspublic-inherentclosedMeerkatMachine drain-control region
meerkat-runtime/src/meerkat_machine/abort_comms_drainpublic-inherentclosedMeerkatMachine drain-control region
meerkat-runtime/src/meerkat_machine/wait_comms_drainpublic-inherentclosedMeerkatMachine drain-control region
meerkat-runtime/src/meerkat_machine/publish_eventtrait-implclosedMeerkatMachine control + input-lifecycle regions
meerkat-runtime/src/meerkat_machine/retiretrait-implclosedMeerkatMachine control region
meerkat-runtime/src/meerkat_machine/recycletrait-implclosedMeerkatMachine control region
meerkat-runtime/src/meerkat_machine/resettrait-implclosedMeerkatMachine control region
meerkat-runtime/src/meerkat_machine/recovertrait-implclosedMeerkatMachine control region
meerkat-runtime/src/meerkat_machine/destroytrait-implclosedMeerkatMachine control region
meerkat-runtime/src/meerkat_machine/ingesttrait-implclosedMeerkatMachine admission + input-lifecycle regions

Runtime Coupling Invariants

NameStoresStatusAnchor
runtime_session_drain_subsetMeerkatMachine.sessions, MeerkatMachine.comms_drain_slotsclosedregistered-session contract + MeerkatMachine drain-control region
runtime_attachment_alignmentRuntimeSessionEntry.phase, RuntimeSessionEntry.driverclosedMeerkatMachine attachment publication contract + RuntimeControl transitions
runtime_queue_projection_alignmentMeerkatMachine.admission.queue, EphemeralRuntimeDriver.queue, EphemeralRuntimeDriver.steer_queueclosedMeerkatMachine admission region
runtime_comms_bridge_projection_alignmentMeerkatMachine.peer_ingress.classified_interactions, RuntimeCommsBridge.runtime_input_projectionclosedMeerkatMachine peer-ingress classification + RuntimeCommsBridge projection contract
runtime_external_event_projection_alignmentCLI.stdin_external_event_projection, MeerkatMachine.peer_ingress.plain_events, Runtime.ExternalEventInput, RuntimeLoop.external_event_renderingclosedExternalEventInput projection contract + runtime external-event render contract

MCP State Cells

PathSymbolClassStatusAnchorContract
meerkat-mcp/src/router.rsMcpRouter.serverscapability-indexclosedExternalToolSurfaceAuthority + RouterProjectionSnapshot publication contractsrc: canonical surface state + live server handles; trigger: apply_staged completion, pending completion, removal finalization, shutdown; stale: forbidden
meerkat-mcp/src/router.rsMcpRouter.projectionderived-projectionclosedRouterProjectionSnapshotsrc: ExternalToolSurfaceAuthority visibility + server manifests; trigger: snapshot rebuild at every visibility/routing invalidation; stale: forbidden
meerkat-mcp/src/router.rsRouterProjectionSnapshot.tool_to_serverderived-projectionclosedRouterProjectionSnapshotsrc: ExternalToolSurfaceAuthority visibility + server manifests; trigger: snapshot rebuild at every visibility/routing invalidation; stale: forbidden
meerkat-mcp/src/router.rsRouterProjectionSnapshot.visible_toolsderived-projectionclosedRouterProjectionSnapshotsrc: ExternalToolSurfaceAuthority visibility + server manifests; trigger: snapshot rebuild at every visibility/routing invalidation; stale: forbidden
meerkat-mcp/src/router.rsRouterProjectionSnapshot.epochderived-projectionclosedExternalToolSurfaceAuthority snapshot_epochsrc: ExternalToolSurfaceAuthority snapshot publication epoch; trigger: projection snapshot rebuild/publication; stale: forbidden
meerkat-mcp/src/router.rsMcpRouter.pending_obligationscapability-indexclosedsurface_completion handoff protocol obligation identitysrc: generated SurfaceCompletionObligation tokens from authority effects; trigger: schedule-surface-completion spawn + pending-result consumption; stale: forbidden
meerkat-mcp/src/router.rsMcpRouter.pending_snapshot_alignmentcapability-indexclosedsurface_snapshot_alignment handoff protocol obligation identitysrc: generated SurfaceSnapshotAlignmentObligation token from authority effects; trigger: snapshot-alignment scheduling + alignment application; stale: forbidden
meerkat-mcp/src/router.rsMcpRouter.pending_txcapability-handleclosedsurface handoff protocol async completion transport-
meerkat-mcp/src/router.rsMcpRouter.pending_rxtransport-bufferclosedsurface handoff protocol async completion transport-
meerkat-mcp/src/router.rsMcpRouter.completed_updatestransport-bufferclosedExternalToolSurfaceAuthority lifecycle deltas-
meerkat-mcp/src/router.rsMcpRouter.staged_payloadstransport-bufferclosedExternalToolSurfaceAuthority staged intent sequence-

MCP Semantic Operations

PathSymbolBoundaryStatusAnchor
meerkat-mcp/src/router.rsset_removal_timeoutpublic-inherentclosedExternalToolSurfaceAuthority
meerkat-mcp/src/router.rsadd_serverpublic-inherentclosedExternalToolSurfaceAuthority + RouterProjectionSnapshot publication contract
meerkat-mcp/src/router.rsstage_addpublic-inherentclosedExternalToolSurfaceAuthority staged intent sequence
meerkat-mcp/src/router.rsstage_removepublic-inherentclosedExternalToolSurfaceAuthority staged intent sequence
meerkat-mcp/src/router.rsstage_reloadpublic-inherentclosedExternalToolSurfaceAuthority staged intent sequence
meerkat-mcp/src/router.rsapply_stagedpublic-inherentclosedExternalToolSurfaceAuthority + surface_completion/snapshot_alignment handoff protocols + RouterProjectionSnapshot publication contract
meerkat-mcp/src/router.rsprocess_pending_resultmanual-callbackclosedExternalToolSurfaceAuthority + surface_completion/snapshot_alignment handoff protocols + RouterProjectionSnapshot publication contract
meerkat-mcp/src/router.rstake_lifecycle_actionspublic-inherentclosedExternalToolSurfaceAuthority + RouterProjectionSnapshot publication contract
meerkat-mcp/src/router.rstake_external_updatespublic-inherentclosedExternalToolSurfaceAuthority + surface_completion/snapshot_alignment handoff protocols + RouterProjectionSnapshot publication contract
meerkat-mcp/src/router.rsprogress_removalspublic-inherentclosedExternalToolSurfaceAuthority + surface_snapshot_alignment handoff protocol + RouterProjectionSnapshot publication contract
meerkat-mcp/src/router.rscall_toolpublic-inherentclosedExternalToolSurfaceAuthority
meerkat-mcp/src/router.rsshutdownpublic-inherentclosedExternalToolSurfaceAuthority + surface_completion/snapshot_alignment handoff protocols + RouterProjectionSnapshot publication contract
meerkat-mcp/src/adapter.rsrefresh_toolspublic-inherentclosedRouterProjectionSnapshot
meerkat-mcp/src/adapter.rsstage_addpublic-inherentclosedExternalToolSurfaceAuthority staged intent sequence
meerkat-mcp/src/adapter.rsstage_removepublic-inherentclosedExternalToolSurfaceAuthority staged intent sequence
meerkat-mcp/src/adapter.rsstage_reloadpublic-inherentclosedExternalToolSurfaceAuthority staged intent sequence
meerkat-mcp/src/adapter.rsapply_stagedpublic-inherentclosedRouterProjectionSnapshot
meerkat-mcp/src/adapter.rspoll_lifecycle_actionspublic-inherentclosedExternalToolSurfaceAuthority + RouterProjectionSnapshot publication contract
meerkat-mcp/src/adapter.rsprogress_removalspublic-inherentclosedExternalToolSurfaceAuthority + surface_snapshot_alignment handoff protocol + RouterProjectionSnapshot publication contract
meerkat-mcp/src/adapter.rswait_until_readypublic-inherentclosedExternalToolSurfaceAuthority + surface_completion/snapshot_alignment handoff protocols + RouterProjectionSnapshot publication contract
meerkat-mcp/src/adapter.rsshutdownpublic-inherentclosedExternalToolSurfaceAuthority + surface_completion/snapshot_alignment handoff protocols + RouterProjectionSnapshot publication contract

MCP Coupling Invariants

NameStoresStatusAnchor
mcp_snapshot_alignmentMcpRouter.servers, RouterProjectionSnapshotclosedExternalToolSurfaceAuthority + surface_snapshot_alignment handoff protocol + RouterProjectionSnapshot publication contract
mcp_pending_lineage_alignmentMcpRouter.pending_obligations, ExternalToolSurfaceAuthority pending lineage + surface_completion obligationsclosedExternalToolSurfaceAuthority pending lineage + surface_completion handoff protocol obligations

Mob State Cells

PathSymbolClassStatusAnchorContract
meerkat-mob/src/runtime/actor.rsMobActor.rosterderived-projectionclosedRosterAuthority + spawn/retire/wire event projection contractsrc: MeerkatSpawned/Retired + PeersWired/PeersUnwired event lineage + session-bridge assignment updates; trigger: spawn finalization, disposal retirement, wire/unwire mutation, resume replay; stale: forbidden
meerkat-mob/src/runtime/actor.rsMobActor.pending_spawnsderived-projectionclosedPendingSpawnLineage + MobOrchestratorAuthority.pending_spawn_countsrc: staged spawn receipts + reply obligations + provision task handles; trigger: enqueue_spawn, spawn completion, respawn cancellation, lifecycle drain; stale: forbidden
meerkat-mob/src/runtime/pending_spawn_lineage.rsPendingSpawnLineage.taskscapability-indexclosedPendingSpawnLineage metadata + MobOrchestratorAuthority.pending_spawn_countsrc: machine-owned pending spawn set; trigger: spawn begin/complete/rollback transitions; stale: forbidden
meerkat-mob/src/runtime/provisioner.rsSessionBackend.runtime_sessionscapability-indexclosedMeerkatMachine registered sessionssrc: runtime adapter registration truth + runtime bridge sidecar handles; trigger: runtime session ensure/reattach + retire/unregister + interrupt stale-bridge cleanup; stale: forbidden
meerkat-mob/src/runtime/provisioner.rsRuntimeSessionState.queued_turnstransport-bufferclosedInputLifecycle canonical input identity + runtime primitive contributing idssrc: event transport handles keyed by canonical input ids; trigger: accept/dedup rekey + primitive contributing-id consumption + retire/unregister clear; stale: forbidden
meerkat-mob/src/runtime/ops_adapter.rsMobOpsAdapter.fallback_registrycapability-handleclosedRuntimeOpsLifecycleRegistry-

Mob Semantic Operations

PathSymbolBoundaryStatusAnchor
meerkat-mob/src/runtime/handle.rsspawn_specpublic-inherentclosedPendingSpawnLineage + RosterAuthority
meerkat-mob/src/runtime/handle.rsspawn_manypublic-inherentclosedPendingSpawnLineage + RosterAuthority
meerkat-mob/src/runtime/handle.rsretirepublic-inherentclosedRosterAuthority + disposal pipeline
meerkat-mob/src/runtime/handle.rsrespawnpublic-inherentclosedrespawn helper contract + PendingSpawnLineage + RosterAuthority
meerkat-mob/src/runtime/handle.rsretire_allpublic-inherentclosedPendingSpawnLineage + RosterAuthority + disposal pipeline
meerkat-mob/src/runtime/handle.rswirepublic-inherentclosedRosterAuthority wiring projection contract + trust-edge mutation + edge-lock discipline
meerkat-mob/src/runtime/handle.rsunwirepublic-inherentclosedRosterAuthority wiring projection contract + trust-edge mutation + edge-lock discipline
meerkat-mob/src/runtime/handle.rsinternal_turnpublic-inherentclosedSessionBackend runtime bridge + InputLifecycle truth
meerkat-mob/src/runtime/handle.rsrun_flowpublic-inherentclosedMobOrchestratorAuthority + MobLifecycleAuthority
meerkat-mob/src/runtime/handle.rsrun_flow_with_streampublic-inherentclosedMobOrchestratorAuthority + MobLifecycleAuthority
meerkat-mob/src/runtime/handle.rscancel_flowpublic-inherentclosedMobOrchestratorAuthority + MobLifecycleAuthority
meerkat-mob/src/runtime/handle.rsstoppublic-inherentclosedMobLifecycleAuthority + RosterAuthority
meerkat-mob/src/runtime/handle.rsresumepublic-inherentclosedMobLifecycleAuthority + RosterAuthority
meerkat-mob/src/runtime/handle.rscompletepublic-inherentclosedMobLifecycleAuthority + RosterAuthority
meerkat-mob/src/runtime/handle.rsresetpublic-inherentclosedMobLifecycleAuthority + RosterAuthority + SessionBackend runtime bridge
meerkat-mob/src/runtime/handle.rsdestroypublic-inherentclosedMobLifecycleAuthority + RosterAuthority + SessionBackend runtime bridge
meerkat-mob/src/runtime/handle.rstask_createpublic-inherentclosedMobTaskBoardService event + projection contract
meerkat-mob/src/runtime/handle.rstask_updatepublic-inherentclosedMobTaskBoardService event + projection contract
meerkat-mob/src/runtime/handle.rsset_spawn_policypublic-inherentclosedMobSpawnPolicySurface
meerkat-mob/src/runtime/handle.rsshutdownpublic-inherentclosedMobLifecycleAuthority + SessionBackend runtime bridge
meerkat-mob/src/runtime/handle.rsforce_cancel_memberpublic-inherentclosedSessionBackend runtime bridge + InputLifecycle truth
meerkat-mob/src/runtime/handle.rsspawn_helperpublic-inherentclosedMobMemberLifecycleAuthority
meerkat-mob/src/runtime/handle.rsfork_helperpublic-inherentclosedMobMemberLifecycleAuthority
meerkat-mob/src/runtime/handle.rswait_onepublic-inherentclosedMobMemberLifecycleAuthority
meerkat-mob/src/runtime/handle.rswait_allpublic-inherentclosedMobMemberLifecycleAuthority
meerkat-mob/src/runtime/actor.rshandle_spawn_provisioned_batchmanual-callbackclosedPendingSpawnLineage + RosterAuthority + PendingProvision rollback contract
meerkat-mob/src/runtime/actor.rsenqueue_spawnenum-dispatchclosedPendingSpawnLineage + MobOrchestratorAuthority + RosterAuthority
meerkat-mob/src/runtime/actor.rshandle_force_cancelenum-dispatchclosedMobLifecycleAuthority active-member gate + SessionBackend::interrupt_member runtime-adapter ownership contract + InputLifecycle cancellation semantics
meerkat-mob/src/runtime/actor.rshandle_retireenum-dispatchclosedRosterAuthority + disposal pipeline + SessionBackend retire contract
meerkat-mob/src/runtime/actor.rshandle_respawnenum-dispatchclosedrespawn helper contract + PendingSpawnLineage + RosterAuthority
meerkat-mob/src/runtime/actor.rshandle_wireenum-dispatchclosedRoster wiring projection contract + trust-edge mutation + edge-lock discipline
meerkat-mob/src/runtime/actor.rshandle_unwireenum-dispatchclosedRoster wiring projection contract + trust-edge mutation + edge-lock discipline
meerkat-mob/src/runtime/actor.rshandle_external_turnenum-dispatchclosedRosterAuthority + SessionBackend runtime bridge + spawn_from_policy_inline contract
meerkat-mob/src/runtime/actor.rshandle_internal_turnenum-dispatchclosedRosterAuthority + SessionBackend runtime bridge
meerkat-mob/src/runtime/actor.rsretire_all_membersenum-dispatchclosedPendingSpawnLineage + RosterAuthority + disposal pipeline
meerkat-mob/src/runtime/actor.rshandle_task_createenum-dispatchclosedMobTaskBoardService event + projection contract
meerkat-mob/src/runtime/actor.rshandle_task_updateenum-dispatchclosedMobTaskBoardService event + projection contract
meerkat-mob/src/runtime/actor.rshandle_run_flowenum-dispatchclosedMobOrchestratorAuthority + MobLifecycleAuthority
meerkat-mob/src/runtime/actor.rshandle_cancel_flowenum-dispatchclosedMobOrchestratorAuthority + MobLifecycleAuthority
meerkat-mob/src/runtime/actor.rshandle_flow_cleanupenum-dispatchclosedMobOrchestratorAuthority + MobLifecycleAuthority
meerkat-mob/src/runtime/actor.rshandle_completeenum-dispatchclosedMobLifecycleAuthority + retire_all_members + PendingSpawnLineage
meerkat-mob/src/runtime/actor.rshandle_destroyenum-dispatchclosedMobLifecycleAuthority + retire_all_members + PendingSpawnLineage
meerkat-mob/src/runtime/actor.rshandle_resetenum-dispatchclosedMobLifecycleAuthority + retire_all_members + PendingSpawnLineage

Mob Coupling Invariants

NameStoresStatusAnchor
mob_pending_spawn_alignmentMobActor.pending_spawns, PendingSpawnLineage.tasks, MobOrchestratorAuthority.pending_spawn_countclosedpending spawn lineage helpers + MobOrchestratorAuthority.pending_spawn_count
mob_runtime_bridge_alignmentSessionBackend.runtime_sessions, RuntimeSessionState.queued_turns, MobOpsAdapter.fallback_registryclosedSessionBackend runtime session sidecar contract + MeerkatMachine registration truth + RuntimeOpsLifecycleRegistry
mob_wiring_alignmentRoster.wired_to, trust edges, edge locksclosedRoster wiring projection contract + do_wire/handle_unwire edge-lock discipline

Open Findings

No ownership findings.