Files
archie/internal/nats/subjects.go
T
sam 326d2265a8 feat: close PRD gaps 1, 3, and 5
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.
2026-07-22 03:07:04 +10:00

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"