Gap 1 (per-task agent): add Workflow field to Request and
AgentRequestMessage. Populated from TaskContext by AgentStage
and forwarded through NATSRunner to the agent.
Gap 3 (response/system split): add SubjectForAgentResponse and
SubjectForAgentSystem to subjects.go. Add Channel field to
AgentResponseEnvelope ("response"|"system").
Gap 5 (daemon review): add ReviewResult hook to AgentStage.
Called after status check and before OnResult. Nil = pass-through
(current behaviour). When set, errors block the stage.
All seven regression tests pass.
75 lines
2.6 KiB
Go
75 lines
2.6 KiB
Go
// Package nats manages the NATS JetStream connection for task distribution
|
|
// and agent communication. When configured, the daemon publishes discovered
|
|
// issues to NATS subjects and consumes them back via a JetStream pull
|
|
// consumer. Agent workers consume stage execution requests and reply via
|
|
// core NATS inboxes. When not configured (nil client), the existing SQLite
|
|
// ClaimNext flow is used unchanged.
|
|
package nats
|
|
|
|
import (
|
|
"fmt"
|
|
"strings"
|
|
)
|
|
|
|
// Task distribution subjects. Each subject encodes the workflow type so
|
|
// future multi-daemon deployments can filter by workflow.
|
|
const (
|
|
SubjectTaskBug = "archie.task.bug"
|
|
SubjectTaskFeature = "archie.task.feature"
|
|
SubjectTaskDefault = "archie.task.default"
|
|
SubjectTaskBootstrap = "archie.task.bootstrap"
|
|
)
|
|
|
|
// SubjectForLabels picks the NATS subject based on issue labels, mirroring
|
|
// the label-to-workflow mapping in workflow.Route.
|
|
//
|
|
// "bug" -> archie.task.bug
|
|
// "feature" -> archie.task.feature
|
|
// "bootstrap" -> archie.task.bootstrap
|
|
// default -> archie.task.default
|
|
func SubjectForLabels(labels []string) string {
|
|
for _, l := range labels {
|
|
switch strings.TrimSpace(l) {
|
|
case "bug":
|
|
return SubjectTaskBug
|
|
case "feature":
|
|
return SubjectTaskFeature
|
|
case "bootstrap":
|
|
return SubjectTaskBootstrap
|
|
}
|
|
}
|
|
return SubjectTaskDefault
|
|
}
|
|
|
|
// Agent communication subjects.
|
|
const (
|
|
// SubjectAgentWildcard matches all agent stage execution requests.
|
|
SubjectAgentWildcard = "archie.agent.>"
|
|
)
|
|
|
|
// SubjectForAgentRequest returns the JetStream subject for a per-task
|
|
// agent request. The stage is carried in the message payload, not the
|
|
// subject — one subject per task with sequential stage messages. PRD §2.
|
|
func SubjectForAgentRequest(taskID int64) string {
|
|
return fmt.Sprintf("archie.agent.%d.request", taskID)
|
|
}
|
|
|
|
// SubjectForAgentResponse returns the subject for agent output destined
|
|
// for human channels. The daemon reviews messages on this subject before
|
|
// forwarding to issue comments, labels, or PRs. PRD §2.
|
|
func SubjectForAgentResponse(taskID int64) string {
|
|
return fmt.Sprintf("archie.agent.%d.response", taskID)
|
|
}
|
|
|
|
// SubjectForAgentSystem returns the subject for internal agent messages
|
|
// (log dumps, health, PII warnings). The daemon reads these for
|
|
// observability and never forwards them. PRD §2.
|
|
func SubjectForAgentSystem(taskID int64) string {
|
|
return fmt.Sprintf("archie.agent.%d.system", taskID)
|
|
}
|
|
|
|
// ReplyHeader is the custom NATS header carrying the daemon's reply inbox.
|
|
// JetStream's PublishMsg consumes the Reply field internally for PubAck, so
|
|
// the reply address is carried via this header instead.
|
|
const ReplyHeader = "X-Archie-Reply"
|