docs(plugins): add execution spine contract, health schema, handoff packet, retry/dead-letter policy

This commit is contained in:
Aine 2026-03-15 16:16:21 -06:00
parent 14137bef22
commit 59bfbb0c55
4 changed files with 46 additions and 0 deletions

View File

@ -0,0 +1,12 @@
# Plugin Execution Spine Contract (v1)
## Flow
`propose -> approve(if risky) -> execute -> verify`
## ACK-first
Actionable requests SHOULD emit immediate ACK before long-running work.
## Goals
- Lean core, stronger plugins
- Predictable safety behavior
- Auditable execution trail

View File

@ -0,0 +1,13 @@
# Resumable Handoff Packet (v1)
## Purpose
Allow model/agent/plugin swap mid-run without continuity loss.
## Core fields
- `runId`
- `goalId`
- `currentStep`
- `acceptance`
- `artifacts[]`
- `status`
- `updatedAt`

View File

@ -0,0 +1,12 @@
# Plugin Health Schema (v1)
## Status enum
- `healthy`
- `degraded`
- `blocked`
## Required fields
- `status`
- `lastError` (nullable)
- `nextAction` (nullable)
- `updatedAt`

View File

@ -0,0 +1,9 @@
# Retry + Dead-letter Policy (v1)
## Retry
- Bounded retries only (no infinite loops)
- Explicit retry count + backoff
## Dead-letter
- Failed items after max retries move to dead-letter queue
- Must include failure reason + next operator action