Expand description
Controller-side lifecycle transitions and canonical-to-backend conversion.
Modules§
- local_
profile_ homes - What earlier releases left in the profile homes on this machine.
- move_
session - One recoverable stop/restore operation, independent of its initiating viewer.
- profile_
config - Automatically populated, persistent profile capabilities.
- update
- Install-aware startup update checks for
mj.
Structs§
- Checkpoint
Artifact - Checkpoint
Deferred - The session was working, so this checkpoint did not run. Nothing is wrong with the session, the target, or the last archive.
- Controller
- Controller
Store Guard - Machine-wide advisory lock for one controller data store. This prevents a dashboard, server, or CLI lifecycle command from concurrently acting as a second controller against the same SQLite state and relay sessions.
- Idle
Workspace Lease - An idle workspace operation holds the managed connection and a worker barrier. Dropping this value disconnects and cancels the barrier; releasing it resumes dispatch without claiming that an archive covers the journal.
- NewSession
Preflight - A repair proposal is returned before any remote branch checks are attempted.
- NewSession
Repository - Repository endpoints sanitized for presentation in either control surface.
- Quick
Bundle Creation - The durable result of creating a quick bundle. The returned config is the same fresh config that was written, allowing a serving projection to publish the new bundle before acknowledging the request that created it.
- Recovery
Candidate - Recovery
Scan - Register
Subagent Request - Resume
Repository Source Mismatch - Resume
Repository Source Receipt - Session
Export Layout - Where one session’s work lives on its target.
- Session
Launch Options - Session
Resume Options
Enums§
- Branch
Disposition - What destroying a session does with its managed worktree’s git branch.
- Checkout
Disposition - What destroying a session does with its managed worktree’s checkout.
- Park
Outcome - How one park attempt ended. Only
ParkOutcome::Parkedchanged anything. - Quick
Bundle Failure - Failure stages exposed to a viewer request without exposing the underlying filesystem/configuration error. The detailed error remains available to the caller for logs and terminal notices.
- Resume
Plan - What a resume has to do to the session record before it provisions.
- Resume
Repository Source Preflight - Worker
Binary Availability - Worker
Upgrade Outcome - What an upgrade attempt found. Nothing here is a failure: a worker that is already current and a session that started working again are both ordinary.
Functions§
- checkpoint_
was_ deferred - Whether a failed checkpoint only means the session was busy.
- config_
only_ controller - create_
bundle_ from_ sources - Create one bundle from one or more local repositories or GitHub sources.
- create_
bundle_ from_ sources_ in_ config - Add a bundle for all
sourcesto an already-loaded config. The source interpretation is shared with the persistedcreate_bundle_from_sourcesentry point and the legacy quick-bundle helper. - create_
quick_ bundle - Create a quick bundle from a local repository or GitHub source and persist it as one serialized fresh-config transaction. Identical sources reuse the existing configured bundle, matching the terminal’s behavior. The returned config is the same fresh config that was written, allowing a serving projection to publish the new bundle before acknowledging the request.
- create_
quick_ bundle_ in_ config - Add a quick bundle to an already-loaded config. The helper still performs
the local repository canonicalization/GitHub-source parsing, but callers
that persist a config should use
create_quick_bundleso concurrent saves cannot clobber one another. - has_
nothing_ to_ checkpoint - Whether a close of this session has no workspace to archive.
- image_
refresh_ plan - Every container image the daemon downloads in the background, once per (host, image, platform).
- local_
project_ repository - Inspect a local launch directory using the same Git error handling and linked-worktree identity as existing sessions.
- native_
worker_ binary_ prerequisite - The worker a
local-baresession on this host would use. - pin_
worker_ binary_ sources - Capture the worker sources used by this daemon before its asynchronous managers start. Missing sources are retained as per-architecture errors so an unused architecture does not prevent daemon startup.
- preview_
build_ cache - What the settings screen shows for one machine’s blank build cache fields:
the same host inspection a session runs, without creating the directory.
Nonewhen the machine has no standing host to share a cache on. - raw_
conversion_ preview_ for - reconcile_
managed_ checkpoint_ archives - Remove checkpoint archives installed by a process that exited before its database transaction committed. Call this only while holding the machine-wide controller-store guard and before starting background work.
- resolve_
machine_ input_ path - Resolve the login home on a configured machine, for the Settings screen’s path fields. A machine, not a runtime, is what owns a home directory.
- resolve_
target_ input_ path - Resolve the login home on the machine that owns an editable path.
- resume_
compatibility - Whether
sessionmay resume ontarget_id, and what the resume must do to the session record. The error is shown to the person choosing the target, so it says where the session is tied down and what to pick instead. - reviewer_
stager - Build the capability used by client-side chat views to stage reviewers. The blocking filesystem and target work remains implemented by the controller and is invoked from chat’s supervised blocking task.
- stopped_
subagent - What a parent’s record keeps about a child its suspend stops: the child’s listed title, one line of its task, and whether it had handed back.
- subagent_
has_ handed_ back - Whether a sub-agent child has handed back its report for its parent’s
newest task, from what the store holds; see
mj_core::subagent::has_handed_back. A session that is not a child, or that has never finished a turn, has not. - worker_
binary_ prerequisite_ for_ arch - Find a worker source without downloading it.
Type Aliases§
- Before
Close - Work a close runs once the session is about to close: its checkpoint is verified and recorded, and its relay is not sealed yet. A daemon suspend stops the session’s sub-agents here, so a close that fails at its checkpoint leaves them running. When this fails, the close does not proceed: the session returns to its previous state with its relay unsealed.