Skip to content

feat(orchestration): MAST-informed handoff hardening — Phase 1 (issue #2023)#2076

Merged
bug-ops merged 2 commits intomainfrom
feat/issue-2023/mast-informed-handoff-harden
Mar 21, 2026
Merged

feat(orchestration): MAST-informed handoff hardening — Phase 1 (issue #2023)#2076
bug-ops merged 2 commits intomainfrom
feat/issue-2023/mast-informed-handoff-harden

Conversation

@bug-ops
Copy link
Owner

@bug-ops bug-ops commented Mar 20, 2026

Implements Phase 1 of MAST-informed handoff hardening to reduce multi-agent coordination failures (issue #2023).

Based on MAST research (arxiv 2503.13657): coordination failures account for 36.9% of multi-agent system failures.

Phase 1: Types & Schema

  • New module: crates/zeph-orchestration/src/handoff.rs

    • HandoffContext struct with objective, acceptance_criteria, role_context, dependency_outputs, constraints
    • RoleContext enum: Architect/Developer/Tester/Critic/Reviewer/Generic with role-specific fields
    • HandoffOutput for verification (criteria_results, test_delta, artifacts, risks, next_steps)
    • HandoffMetrics for tracking
  • Updated TaskNode/TaskResult with optional handoff fields (backward compat)

  • Added HandoffConfig to experiment.rs

  • All 6280 tests passing, zero clippy warnings

Spec & Review

✅ Spec: .local/specs/2023-handoff-hardening/spec.md (architect + critic approved)
✅ Code review: GO (3 low-priority Phase 2 prep items, no blockers)
✅ Tests: 6280 passed, serialization and backward-compat verified

Implements typed inter-agent handoff context per MAST taxonomy (#2023).
Adds HandoffContext, RoleContext (6 variants), HandoffOutput, DependencyOutput,
HandoffMetrics, and no-op validation stubs in zeph-orchestration::handoff.
HandoffConfig added to [orchestration.handoff] TOML section.
TaskNode and TaskResult gain optional handoff fields for Phase 2 wiring.
No behavior change; all validation methods are no-ops in Phase 1.
16 new unit tests: serialization round-trips, variant coverage, backward compat.
@github-actions github-actions bot added documentation Improvements or additions to documentation rust Rust code changes core zeph-core crate dependencies Dependency updates enhancement New feature or request size/XL Extra large PR (500+ lines) labels Mar 20, 2026
@bug-ops bug-ops merged commit bbb7c9c into main Mar 21, 2026
25 checks passed
@bug-ops bug-ops deleted the feat/issue-2023/mast-informed-handoff-harden branch March 21, 2026 00:03
bug-ops added a commit that referenced this pull request Mar 21, 2026
, #2078)

The typed HandoffContext enum, RoleContext variants, and validation layer
introduced in #2076 and #2078 are superseded by the rust-agent-handoff
skill. Agents follow the handoff protocol via skill instructions injected
into their system prompt — no compile-time struct enforcement is needed.

Reverts:
- handoff.rs (deleted)
- typed HandoffConfig in zeph-config
- handoff fields in TaskResult/TaskNode
- handoff validation metrics in OrchestrationMetrics
- scheduler.rs validation/verification wiring

Closes #2023
bug-ops added a commit that referenced this pull request Mar 21, 2026
, #2078) (#2082)

The typed HandoffContext enum, RoleContext variants, and validation layer
introduced in #2076 and #2078 are superseded by the rust-agent-handoff
skill. Agents follow the handoff protocol via skill instructions injected
into their system prompt — no compile-time struct enforcement is needed.

Reverts:
- handoff.rs (deleted)
- typed HandoffConfig in zeph-config
- handoff fields in TaskResult/TaskNode
- handoff validation metrics in OrchestrationMetrics
- scheduler.rs validation/verification wiring

Closes #2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

core zeph-core crate dependencies Dependency updates documentation Improvements or additions to documentation enhancement New feature or request rust Rust code changes size/XL Extra large PR (500+ lines)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant