ito_core/

lib.rs

//! 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.

#![warn(missing_docs)]

/// Archive completed changes and update specifications.
pub mod archive;

/// Active change artifact mutation services for runtime-selected persistence.
pub mod artifact_mutations;

/// Backend server authentication setup and token resolution.
pub mod backend_auth;

/// Backend API client factory, runtime, and coordination services.
pub mod backend_client;

/// Backend-backed change repository adapter.
pub mod backend_change_repository;

/// Backend HTTP client for repository reads.
pub mod backend_http;

/// Backend-backed module repository adapter.
pub mod backend_module_repository;

/// Backend-backed promoted spec repository adapter.
pub mod backend_spec_repository;

/// Backend-backed task repository adapter.
pub mod backend_task_repository;

/// Backend coordination use-cases (claim, release, allocate, sync).
pub mod backend_coordination;

/// Backend health-check client for connectivity and auth validation.
pub mod backend_health;

/// Local-to-backend import orchestration.
pub mod backend_import;

/// Artifact synchronization (pull/push) for backend mode.
pub mod backend_sync;

/// Audit log infrastructure: writer, reader, reconciliation, worktree discovery.
pub mod audit;

/// Filesystem-backed change repository implementation.
pub mod change_repository;

mod change_meta;

/// JSON configuration file CRUD operations.
pub mod config;

/// Symlink wiring for coordination worktrees.
pub mod coordination;

/// Coordination worktree lifecycle management (create / remove).
pub mod coordination_worktree;

/// Create new modules/changes and initial scaffolding.
pub mod create;

/// Distribution/build metadata helpers.
pub mod distribution;

/// Core-layer error types and result alias.
pub mod errors;

/// Grep-style search over Ito change artifacts using ripgrep crates.
pub mod grep;

/// Client-side forwarding of local audit events to the backend.
pub mod event_forwarder;

/// Filesystem-backed backend project store implementation.
pub mod fs_project_store;

/// SQLite-backed backend project store proof-of-concept.
pub mod sqlite_project_store;

/// YAML front matter parsing, writing, and metadata utilities for artifacts.
pub mod front_matter;

/// Orchestrator configuration helpers (user prompt + presets).
pub mod orchestrate;

/// Git synchronization helpers for coordination workflows.
pub mod git;

/// Git remote URL resolution for org/repo namespace discovery.
pub mod git_remote;

/// Resolve repository and worktree path roots.
pub mod repo_paths;

/// Infer Ito change/module target context for harness sessions.
pub mod harness_context;

mod error_bridge;

/// Process execution boundary and default runner.
pub mod process;

/// Installers for project/home templates and harness assets.
pub mod installers;

/// List/query project entities (modules, changes, tasks).
pub mod list;

/// Agent memory provider resolution and instruction rendering.
pub mod memory;

/// Filesystem-backed module repository implementation.
pub mod module_repository;

/// Planning directory initialization (filesystem I/O).
pub mod planning_init;

/// Filesystem-backed task repository implementation.
pub mod task_repository;

/// Filesystem-backed promoted spec repository implementation.
pub mod spec_repository;

/// Task mutation services for filesystem and backend persistence.
pub mod task_mutations;

/// Remote task repository backed by the backend API.
pub mod remote_task_repository;

/// Clock helpers (`now_time`, `now_date`).
pub mod time;

/// Cryptographic token generation for backend server authentication.
pub mod token;

/// Task-focused orchestration use-cases.
pub mod tasks;

/// Ralph Wiggum loop support.
pub mod ralph;

/// Indexing helpers for repository contents.
pub mod repo_index;

/// Display and inspection commands.
pub mod show;

/// Requirement traceability computation for the `ito trace` command.
pub mod trace;

/// Proposal viewer artifact collection and backend dispatch.
pub mod viewer;

/// Repository runtime selection and composition.
pub mod repository_runtime;

/// Statistics collection and computation for command usage.
pub mod stats;

/// Validation utilities for on-disk state.
pub mod validate;

/// Change worktree ensure: verify or create the correct worktree for a change.
pub mod worktree_ensure;

/// Change worktree initialization: file copy-over and include-pattern resolution.
pub mod worktree_init;

/// Read-only validation of whether the current checkout matches an expected change worktree.
pub mod worktree_validate;

/// Schema templates execution and planning.
pub mod templates;

// Re-export domain types for CLI and adapter convenience
pub use ito_domain::backend::{
    AllocateResult, ArchiveResult, ArtifactBundle, BackendArchiveClient, BackendChangeReader,
    BackendError, BackendEventIngestClient, BackendLeaseClient, BackendModuleReader,
    BackendProjectStore, BackendSpecReader, BackendSyncClient, BackendTaskReader, ClaimResult,
    EventBatch, EventIngestResult, LeaseConflict, PushResult, ReleaseResult, RevisionConflict,
};
pub use ito_domain::changes::{
    Change, ChangeArtifactKind, ChangeArtifactMutationError, ChangeArtifactMutationResult,
    ChangeArtifactMutationService, ChangeArtifactMutationServiceResult, ChangeArtifactRef,
    ChangeLifecycleFilter, ChangeRepository, ChangeSummary, ChangeTargetResolution,
};
pub use ito_domain::errors::DomainError;
pub use ito_domain::modules::{Module, ModuleRepository, ModuleSummary};
pub use ito_domain::specs::{SpecDocument, SpecRepository, SpecSummary};
pub use ito_domain::tasks::{
    ProgressInfo, TaskInitResult, TaskItem, TaskKind, TaskMutationError, TaskMutationResult,
    TaskMutationService, TaskMutationServiceResult, TaskRepository as DomainTaskRepository,
    TaskStatus, TasksFormat, TasksParseResult,
};

/// Harness integrations for running AI-assisted workflows.
pub mod harness;

/// Re-exported schema types from [`ito_domain::schemas`].
pub mod schemas {
    pub use ito_domain::schemas::*;
}

/// Re-exported domain modules
pub mod domain {
    /// Planning domain module
    pub use ito_domain::planning;
}

// Re-export utility functions for CLI convenience
pub use ito_common::id::parse_change_id;
pub use ito_common::id::parse_module_id;
pub use ito_common::match_::nearest_matches;

/// Re-exported path utilities from [`ito_common::paths`].
pub mod paths {
    pub use ito_common::paths::changes_dir;
    pub use ito_common::paths::spec_markdown_path;
    pub use ito_common::paths::specs_dir;
}