Architecture
CI result JSON contract
Homeboy CI results are exposed through the existing global --output <path> flag. The flag writes the same JSON envelope Homeboy...
API Client System
The API client provides HTTP request capabilities with template-based authentication per project. Overview Homeboy projects can configure an API client...
Embedded docs: topic resolution and keys
Homeboy embeds markdown files from docs/ into the CLI binary at build time. In addition, homeboy self docs reads documentation...
Agent Runtime Contract Handshake
Homeboy owns the generic protocol for agent runtime handoff. Extensions own the runtime-specific facts that populate that protocol. Core records...
Artifact Postprocess Runner Contract
Homeboy core owns a product-neutral artifact postprocess contract for persisted artifact roots. The contract schema is homeboy/artifact-postprocess/v1. A plan declares:...
Provider fanout boundary
Homeboy core owns durable orchestration and provider-neutral evidence. Runtime providers own backend-specific execution details. The seam is the AgentTaskRequest/AgentTaskOutcome adapter...
Execution Context
Execution context is the environment Homeboy passes to extension runners and extension-backed pipeline steps. Overview When Homeboy executes an extension,...
Agent Task Generic Loop Contract
Homeboy owns the generic loop, action, artifact, evidence, provider-outcome, and diagnostic-ranking contracts. Runtime providers own their runtime-package execution details and...
Composable Workload Evidence Contract
Homeboy ranks and compares generic evidence. Product and workload meaning stays outside Homeboy core so new scenarios can compose without...
Lifecycle Contracts
Homeboy defines a product-neutral lifecycle contract for workloads that mutate state and need fuzz-safe cleanup. Core owns the vocabulary and...
Apply And Publish Contract
Homeboy uses a shared execution vocabulary for generated changes: execute produces proposed results. artifact preserves proposed changes with provenance and...
Secret Env Contract
Homeboy core owns the generic contract for passing required secret environment variables across runners, agent tasks, trace workloads, lab offload,...