Module validate 

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

This module provides lightweight validation helpers for specs, changes, and modules.

The primary consumer is the CLI and any APIs that need a structured report (ValidationReport) rather than a single error.

Structs

ReportBuilder

A stateful builder for collecting validation issues.

ResolvedModule

A resolved module reference (directory + key paths).

ValidationIssue

One validation finding.

ValidationReport

A validation report with a computed summary.

ValidationSummary

Aggregated counts for a validation run.

Constants

LEVEL_ERROR

Validation issue is an error (always fails validation).

LEVEL_INFO

Validation issue is informational (never fails validation).

LEVEL_WARNING

Validation issue is a warning (fails validation in strict mode).

Functions

error

Creates an ERROR level issue.

info

Creates an INFO level issue.

issue

Construct a ValidationIssue with a fixed level, path, and message.

report

Convenience constructor for a ReportBuilder.

resolve_module

Resolve a module directory name from user input.

validate_change

Validate a change’s delta specs by change id.

validate_change_dirs_repo_integrity

Validate change directory naming and cross-references.

validate_module

Validate a module’s module.md for minimal required sections.

validate_spec

Validate a spec by id from .ito/specs/<id>/spec.md.

validate_spec_markdown

Validate a spec markdown string and return a structured report.

validate_tasks_file

Validate a change’s tasks.md file and return any issues found.

warning

Creates a WARNING level issue.

with_line

Attach a 1-based line number to an existing issue.

with_loc

Attach a 1-based line + column location to an existing issue.

with_metadata

Attach structured metadata to an existing issue.

Type Aliases

ValidationLevel

Severity level for a ValidationIssue.