jackin-core

Shared jackin❯ vocabulary and pure cross-surface projections. This L0 leaf has no jackin❯ dependencies, async runtime, filesystem, subprocess, or side effects.

What this crate owns

Domain nouns every other crate speaks in: agent identity, instance, isolation, manifest fragments, env model, status, launch progress, operator notices.
Ports, constants, paths, and selector/URL/path helpers reused by higher crates.
Renderer-neutral product identity tokens live in jackin-brand; terminal protocol encoding and Ratatui adapters live in their presentation owners.

Cross-surface product presentation (Debug-info paint, product brand/domain Ratatui tokens, shared product chrome composition) lives in jackin-tui, not here.

Architecture tier and allowed dependencies

L0 leaf/domain + pure projections. No workspace dependencies or effects. No Ratatui frame paint, layout adapters, or widget bodies. Presentation layout, hover builders, terminal-protocol scroll decode, Debug-info rendering, and product tokens live in jackin-tui and surface crates (jackin-console / jackin-capsule / jackin-launch) — not here. Neutral TermRock Theme/Role resolution is done at the surface call site.

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`
`claude_keychain.rs` · `claude_keychain/`	Claude Code macOS Keychain service derivation (`claude_keychain_scope`) shared by instance provisioning and the usage probe	`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`
`build_log_sink.rs`	build-log sink stub	—
`standalone_dialog.rs` · `standalone_dialog/`	standalone dialog port (trait + sink; render impl in `jackin-launch`)	`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

Plan 019 surface: implementation modules are private; the intentional API is the root re-export list in lib.rs (use jackin_core::\{Agent, JackinPaths, …}).

Remaining root pub mods (individually justified):

Module	Why public
`container_paths`	Namespace for container-side `/jackin/` path constants (`use jackin_core::container_paths`) across runtime/capsule/usage

Higher crates implement the port traits defined here (e.g. CommandRunner) and pass the domain types through. Debug-info product presentation is jackin_tui::operator_info.

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

How to verify

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