Module workflow 

Workflow execution and planning. Schema-driven change workflow helpers.

This module reads a change directory and a workflow schema (schema.yaml) and produces JSON-friendly status and instruction payloads.

These types are designed for use by the CLI and by any web/API layer that wants to present “what should I do next?” without duplicating the filesystem logic.

Structs

AgentInstructionResponse

Instruction payload for agent-oriented endpoints.

ApplyInstructionsResponse

Instruction payload for applying a change.

ApplyYaml

Apply-stage configuration from a schema.

ArtifactStatus

Status for one schema artifact for a given change directory.

ArtifactYaml

One artifact definition from a schema.

ChangeStatus

High-level status for a change against a resolved schema.

DependencyInfo

One dependency entry shown alongside artifact instructions.

InstructionsResponse

Instruction payload for building a single artifact.

ProgressInfo

Progress totals derived from parsed tasks.

ResolvedSchema

A fully-resolved schema (yaml + directory + source).

SchemaYaml

Schema file model (schema.yaml).

TaskDiagnostic

Diagnostic message associated with a task file.

TaskItem

One task parsed from a tracking file (e.g. tasks.md).

TemplateInfo

Information about an artifact template resolved from a schema.

Enums

SchemaSource

Where a schema was resolved from.

WorkflowError

Errors returned by workflow helpers.

Functions

compute_apply_instructions

Compute apply-stage instructions and progress for a change.

compute_change_status

Compute per-artifact status for a change.

default_schema_name

Default schema name used when a change does not specify one.

list_available_changes

List available change directory names under .ito/changes/.

list_available_schemas

List available schema names from package and user schema directories.

load_user_guidance

Load user guidance text from user-guidance.md.

read_change_schema

Read a change’s configured schema name from its metadata.

resolve_instructions

Resolve build instructions for a single artifact.

resolve_schema

Resolve a schema name into a ResolvedSchema.

resolve_templates

Resolve template file paths for all artifacts in a schema.

validate_change_name_input

Validate a user-provided change id for safe filesystem access.