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.

audit

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

backend_auth

Backend server authentication setup and token resolution. Backend server authentication setup and token resolution.

backend_change_repository

Backend-backed change repository adapter. Backend-backed change repository adapter.

backend_client

Backend API client factory, runtime, and coordination services. Backend API client factory and runtime.

backend_coordination

Backend coordination use-cases (claim, release, allocate, sync). Backend coordination use-cases for CLI commands.

backend_sync

Artifact synchronization (pull/push) for backend mode. Artifact synchronization service for backend mode.

backend_task_repository

Backend-backed task repository adapter. Backend-backed task repository adapter.

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.

event_forwarder

Client-side forwarding of local audit events to the backend. Client-side forwarding of locally produced audit events to the backend.

front_matter

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

fs_project_store

Filesystem-backed backend project store implementation. Filesystem-backed BackendProjectStore implementation.

git

Git synchronization helpers for coordination workflows. Git synchronization helpers for coordination workflows.

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.

installers

Installers for project/home templates and harness assets.

list

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

module_repository

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

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.

schemas

Re-exported schema types from ito_domain::schemas.

show

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

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_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.

token

Cryptographic token generation for backend server authentication. Cryptographic token generation for backend server authentication.

validate

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

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.

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.

TaskItem

A normalized task entry parsed from a tasks tracking file.

TasksParseResult

Output of parsing a tasks.md file.

Enums

BackendError

Backend operation error category.

ChangeTargetResolution

Deterministic resolution result for a change target input.

DomainError

Error type used by domain ports and domain utilities.

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).

BackendProjectStore

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

BackendSyncClient

Port for backend artifact synchronization operations.

BackendTaskReader

Port for backend-backed task reading.

ChangeRepository

Port for accessing change data.

DomainTaskRepository

Port for accessing task data.

ModuleRepository

Port for accessing module data.

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.