jackin-core

Universal vocabulary types shared across every jackin❯ crate. This is the leaf at the bottom of the workspace dependency graph: no jackin❯ dependencies, no tokio, no subprocess, no filesystem, no presentation.

What this crate owns

Domain nouns every other crate speaks in: agent identity, instance, isolation, manifest fragments, env model, status, launch progress, operator notices.
Port traits and shared abstractions higher crates implement (e.g. CommandRunner, Clock), plus the constants, paths, and selector/url/path text helpers reused everywhere.
Small self-contained widgets/ansi/host-color tokens re-exported by presentation crates.

Because everything depends on jackin-core, it must stay dependency-free, side-effect-free, and cheap to compile. Anything that needs tokio, the filesystem, a subprocess, or a real adapter belongs in a higher crate.

Architecture tier and allowed dependencies

L0 leaf/domain. Allowed workspace dependencies: none. No tokio, no I/O, no presentation. This is the floor; nothing in jackin-core may depend upward.

Structure

Module	Owns	Tests
`lib.rs`	crate root, re-exports	—
`agent.rs` · `agent/`	agent identity	`tests.rs`
`instance.rs`	instance type	—
`manifest.rs`	manifest fragment	—
`status.rs` · `status/`	status type	`tests.rs`
`operator_notice.rs`	operator notice	—
`auth.rs`	auth model	—
`account_key.rs` · `account_key/`	account key	`tests.rs`
`env_model.rs` · `env_model/`	env model	`tests.rs`
`env_value.rs` · `env_value/`	env value	`tests.rs`
`paths.rs` · `paths/`	host paths + `PathsError`	`tests.rs`
`isolation.rs`	isolation type	—
`isolation_record.rs`	isolation record	—
`worktree_dirty.rs` · `worktree_dirty/`	worktree-dirty check	`tests.rs`
`runner.rs`	`CommandRunner` port	—
`clock.rs` · `clock/`	`Clock` port + `ManualClock`	`tests.rs`
`launch_progress.rs`	launch progress	—
`prompt_result.rs`	prompt result	—
`selector.rs`	selector	—
`docker.rs`	docker types	—
`docker_security.rs` · `docker_security/`	docker security	`tests.rs`
`debug_log.rs`	`debug_log` stub	—
`build_log_sink.rs`	build-log sink stub	—
`host_colors.rs`	host color tokens	—
`ansi_tokens.rs`	ansi tokens	—
`tui_widgets.rs`	tui widget stubs	—
`standalone_dialog.rs` · `standalone_dialog/`	standalone dialog	`tests.rs`
`url_text.rs`	url text	—
`path_text.rs` · `path_text/`	path text	`tests.rs`
`op_cache.rs` · `op_cache/`	op cache	`tests.rs`
`op_probe_error.rs` · `op_probe_error/`	typed `op` probe errors	`tests.rs`
`op_reference.rs` · `op_reference/`	op reference	`tests.rs`
`op_types.rs`	op types	—
`constants.rs`	shared constants	—
`container_paths.rs` · `container_paths/`	container-side `/jackin/` path chokepoint	`tests.rs`

Public API

The crate is a vocabulary library: re-export the types/ports/constants you need from jackin_core::…. Higher crates implement the port traits defined here (e.g. CommandRunner) and pass the domain types through.

Typed construction/parse errors (thiserror): ParseProfileError, ParseMountIsolationError, ParseAgentError, SelectorError, EnvCycleError (env_model), PathsError, OpProbeError.

How to verify

cargo nextest run -p jackin-core
cargo clippy -p jackin-core --all-targets -- -D warnings