329d7e2a4d
Final phase of agent substrate v1. 5 shipped agents now declare role at manifest level; assembler expands role's capability text fragments into the generated .md at a new `# AGENT SUBSTRATE — role <name>` section. Non-migrated agents byte-identical (golden snapshots green). Migrated agents: - kei-code-implementer → edit-local (8 caps: no-git-ops + scope/* + quality/* + safety::no-dep-bump + report-format) - kei-critic → read-only (tools::read-only + output::report-format + output::severity-grade) - kei-architect → read-only - kei-security-auditor → read-only - kei-validator → read-only _assembler/ extensions: - manifest.rs: substrate_role: Option<String> - assembler.rs: write_substrate() before blocks (backward-compat; no role = no substrate section) - substrate.rs (new, 102 LOC): loads _roles/<name>.toml, iterates capabilities.required, reads _capabilities/<cat>/<slug>/text.md, joins with \n\n---\n\n separator - validator.rs: substrate role existence + cap-text presence check - tests/substrate_role.rs (4 tests): happy path, unknown role, missing capability text, byte-parity on non-migrated - tests/regenerate_migrated.rs (ignored by default): regeneration gate _templates/task-examples/ — 5 example task.toml per migrated agent showing orchestrator the valid invocation shape. docs/AGENT-SUBSTRATE-SCHEMA.md: Phase 5 row ticked ✓ + Migrated agents subsection listing 5 agents with roles + pointer to examples. tests/substrate_integration.sh: +8 Phase-5 assertions - All 5 migrated .md files contain "# AGENT SUBSTRATE — role" - kei-code-implementer.md contains "MUST NOT invoke git" (policy::no-git-ops) - Every _templates/task-examples/*.toml parses as valid TOML - cargo check --workspace still passes post-migration - kei-agent-runtime compose works on edit-local-forge.toml example Tests: assembler 40/40 (was 30, +4 substrate_role + +1 ignored regen), kei-agent-runtime + kei-capability 37/37 preserved. Deferred: remaining 7 non-core agents (cost-guardian, modal-runner, fal-ai-runner, infra/ml-implementer, ml-researcher, researcher) migrate in v0.24 wave. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
50 lines
1.6 KiB
Rust
50 lines
1.6 KiB
Rust
//! Manifest struct — deserialized from _manifests/*.toml.
|
|
//! One manifest = one agent. Source of truth; the .md file is generated.
|
|
|
|
use serde::Deserialize;
|
|
|
|
#[derive(Deserialize)]
|
|
pub struct Manifest {
|
|
pub name: String,
|
|
pub description: String,
|
|
pub tools: Vec<String>,
|
|
pub model: String,
|
|
pub role: String,
|
|
pub blocks: Vec<String>,
|
|
/// v0.16 (phase 5): agent substrate role. When present, assembler loads
|
|
/// `_roles/<substrate_role>.toml` and emits each capability's `text.md`
|
|
/// fragment between the ROLE section and the existing blocks. Optional
|
|
/// for backward compatibility with pre-substrate manifests.
|
|
#[serde(default)]
|
|
pub substrate_role: Option<String>,
|
|
pub domain_in: Vec<String>,
|
|
pub forbidden_domain: Vec<String>,
|
|
pub handoff: Vec<Handoff>,
|
|
#[serde(default)]
|
|
pub output_extra_fields: Vec<String>,
|
|
pub memory_project: Option<String>,
|
|
pub project_claudemd: Option<String>,
|
|
pub references: Option<References>,
|
|
/// v0.15: optional typed-artifact schema this agent emits on completion.
|
|
/// Must be one of the names in `artifact_schemas::KNOWN`.
|
|
#[serde(default)]
|
|
pub produces_artifact: Option<String>,
|
|
}
|
|
|
|
#[derive(Deserialize)]
|
|
pub struct Handoff {
|
|
pub target: String,
|
|
pub trigger: String,
|
|
/// v0.15: optional schema name the target consumes from this handoff.
|
|
#[serde(default)]
|
|
pub expects_artifact: Option<String>,
|
|
/// v0.15: optional schema name this agent produces for the target.
|
|
#[serde(default)]
|
|
pub produces_artifact: Option<String>,
|
|
}
|
|
|
|
#[derive(Deserialize)]
|
|
pub struct References {
|
|
#[serde(default)]
|
|
pub extra: Vec<String>,
|
|
}
|