Crate ito_core 

Core Ito application behavior.

ito-core implements the main orchestration logic behind the CLI: reading and writing Ito state on disk, running workflows, validating inputs, and delegating to installers and harness integrations.

This crate is intentionally “policy heavy” but “UI light”: it defines the core semantics of commands without owning the CLI argument surface.

Modules

archive

Archive completed changes and update specifications. Archive completed changes.

artifact_mutations

Active change artifact mutation services for runtime-selected persistence. Active change artifact mutation services.

audit

Audit log infrastructure: writer, reader, reconciliation, worktree discovery. Audit log infrastructure: filesystem writer, event reader, reconciliation engine, worktree discovery, and stream watcher.

capabilities

Compile-time capability reporting and configuration preflight. Compile-time capability reporting and configuration preflight.

change_repository

Filesystem-backed change repository implementation. Filesystem-backed implementation of the domain change repository port.

config

JSON configuration file CRUD operations. JSON configuration file CRUD operations.

create

Create new modules/changes and initial scaffolding. Creation helpers for modules and changes.

distribution

Distribution/build metadata helpers. Embedded asset distribution helpers.

domain

Re-exported domain modules

errors

Core-layer error types and result alias. Core-layer error types.

front_matter

YAML front matter parsing, writing, and metadata utilities for artifacts. YAML front matter parsing, writing, and metadata utilities.

git_remote

Git remote URL resolution for org/repo namespace discovery. Git remote URL resolution for org/repo namespace discovery.

grep

Grep-style search over Ito change artifacts using ripgrep crates. Grep-style search over Ito change artifacts.

harness

Harness integrations for running AI-assisted workflows. Harness integrations for running AI-assisted workflows.

harness_context

Infer Ito change/module target context for harness sessions. Harness context inference helpers.

implementation_readiness

Main-first proposal authority and implementation readiness evaluation. Main-first proposal authority and implementation readiness evaluation.

installers

Installers for project/home templates and harness assets.

legacy_coordination

Read-only inspection of repositories using legacy coordination storage. Side-effect-free inspection of legacy coordination-worktree state.

list

List/query project entities (modules, changes, tasks). Listing helpers for modules, changes, and specs.

memory

Agent memory provider resolution and instruction rendering. Agent memory provider resolution and instruction rendering.

module_repository

Filesystem-backed module repository implementation. Filesystem-backed module repository implementation.

orchestrate

Orchestrator configuration helpers (user prompt + presets). Orchestrator configuration and shared helpers.

paths

Re-exported path utilities from ito_common::paths.

planning_init

Planning directory initialization (filesystem I/O). Planning directory initialization.

process

Process execution boundary and default runner. Process execution boundary for core-side command invocation.

ralph

Ralph Wiggum loop support. Ralph Wiggum iterative development loop.

repo_index

Indexing helpers for repository contents. Precomputed index of an Ito repository.

repo_paths

Resolve repository and worktree path roots. Repository and worktree path resolution.

repository_runtime

Repository runtime selection and composition. Repository runtime selection and composition.

schemas

Re-exported schema types from ito_domain::schemas.

show

Display and inspection commands. Convert Ito markdown artifacts into JSON-friendly structures.

spec_repository

Filesystem-backed promoted spec repository implementation. Filesystem-backed promoted spec repository.

sqlite_project_store

SQLite-backed backend project store proof-of-concept. SQLite-backed BackendProjectStore proof-of-concept implementation.

stats

Statistics collection and computation for command usage. Statistics collection and computation for Ito command usage.

task_mutations

Task mutation services for filesystem and backend persistence. Task mutation services for filesystem-backed persistence.

task_repository

Filesystem-backed task repository implementation. Filesystem-backed task repository implementation.

tasks

Task-focused orchestration use-cases. Task-oriented orchestration use-cases for adapters.

templates

Schema templates execution and planning. Schema/template helpers for change artifacts.

time

Clock helpers (now_time, now_date). Clock helpers for the application layer.

trace

Requirement traceability computation for the ito trace command. Core orchestration for the ito trace command.

validate

Validation utilities for on-disk state. Validate Ito repository artifacts.

validate_repo

Repository-level validation rules driven by ito_config::types::ItoConfig. Repository-level validation rules driven by ito_config::types::ItoConfig.

viewer

Proposal viewer artifact collection and backend dispatch. Proposal viewer support.

worktree_ensure

Change worktree ensure: verify or create the correct worktree for a change. Change worktree ensure: verify or create the correct worktree for a change.

worktree_init

Change worktree initialization: file copy-over and include-pattern resolution. Change worktree initialization: file copy-over, setup command execution, and include-pattern resolution.

worktree_validate

Read-only validation of whether the current checkout matches an expected change worktree. Read-only validation of whether the current checkout matches an expected change worktree.

Structs

AllocateResult

Result of an allocation operation.

ArchiveResult

Result of marking a change as archived on the backend.

ArtifactBundle

An artifact bundle pulled from the backend for a single change.

Change

Full change with all artifacts loaded.

ChangeArtifactMutationResult

Result of mutating a change artifact.

ChangeArtifactRef

Reference to a mutable artifact within an active change.

ChangeSummary

Lightweight change summary for listings.

ClaimResult

Result of a successful change lease claim.

EventBatch

A batch of audit events to send to the backend.

EventIngestResult

Result of a successful event ingest operation.

LeaseConflict

Conflict detail when a lease claim fails because another holder owns it.

Module

Full module with metadata loaded.

ModuleSummary

Lightweight module summary for listings.

ProgressInfo

Summary counts computed from the parsed tasks.

PushResult

Result of a push operation.

ReleaseResult

Result of a lease release operation.

RevisionConflict

Conflict detail when a push fails due to a stale revision.

SpecDocument

Full promoted spec document.

SpecSummary

Lightweight promoted spec summary.

TaskInitResult

Outcome of initializing task tracking.

TaskItem

A normalized task entry parsed from a tasks tracking file.

TaskMutationResult

Outcome of a task mutation.

TasksParseResult

Output of parsing a tasks.md file.

Enums

BackendError

Backend operation error category.

ChangeArtifactKind

A mutable artifact within an active change.

ChangeArtifactMutationError

Error type for change artifact mutation ports.

ChangeLifecycleFilter

Lifecycle filter for change repository queries.

ChangeTargetResolution

Deterministic resolution result for a change target input.

DomainError

Error type used by domain ports and domain utilities.

TaskKind

Task classification.

TaskMutationError

Error type for task mutation ports.

TaskStatus

Status values supported by Ito task tracking.

TasksFormat

The detected format of a tasks.md file.

Traits

BackendArchiveClient

Port for backend archive lifecycle operations.

BackendChangeReader

Port for backend-backed change listing (read path).

BackendEventIngestClient

Port for backend event ingestion.

BackendLeaseClient

Port for backend lease operations (claim, release, allocate).

BackendModuleReader

Port for backend-backed module listing.

BackendProjectStore

Port for resolving {org}/{repo} to project-level repositories.

BackendSpecReader

Port for backend-backed promoted spec reading.

BackendSyncClient

Port for backend artifact synchronization operations.

BackendTaskReader

Port for backend-backed task reading.

ChangeArtifactMutationService

Port for active-change artifact mutations.

ChangeRepository

Port for accessing change data.

DomainTaskRepository

Port for accessing task data.

ModuleRepository

Port for accessing module data.

SpecRepository

Port for accessing promoted spec data.

TaskMutationService

Port for task mutations and raw markdown access.

Functions

nearest_matches

Return up to max candidates closest to input.

parse_change_id

Parse a change identifier.

parse_module_id

Parse a module identifier.

Type Aliases

ChangeArtifactMutationServiceResult

Result alias for change artifact mutation operations.

TaskMutationServiceResult

Result alias for task mutation operations.