Files
archie/internal/gateway/prompt.go
T
sam cd2ab3516b feat(gateway): render workspace, managed repos and operator into chat env
The chat agent had no way to know where it lives without probing the
filesystem (pwd, find, git remote), wasting turns on every orientation.
Per docs/architecture/identity.md the <env> block is Layer 1 invariants,
so the daemon's own facts belong there, driven from live configuration.

Render into the prompt's <env> block:
- workspace path (chat.workspace)
- repositories under management with forge host and default branch
- operator identity (chat.operator, which was dead plumbing)

Unconfigured values render explicitly as unknown / none configured
rather than a plausible-looking default, and a repo with no forge
reports forge unknown, so the model never claims a fact the daemon
cannot confirm. Repos are resolved per active chat identity, mirroring
chatTaskProfiles.

gateway: add RepoEnv, SystemPromptConfig Workspace/Repos/Operator,
TurnRunnerConfig Workspace/Repos.
app: chatRepoEnv resolver wired through newChatTurnRunner.
tests: prompt rendering (incl. explicit-unknown + hostile-SOUL guard)
and chatRepoEnv identity resolution. go.sum gains module-graph
/go.mod checksum lines.
2026-09-05 22:52:03 +10:00

118 lines
3.9 KiB
Go

package gateway
import (
_ "embed"
"strings"
"text/template"
"time"
)
//go:embed templates/archie.md.tpl
var archiePromptTpl string
// ToolSummary is the capability metadata for one registered tool, as it is
// advertised to the model.
type ToolSummary struct {
Name string
Description string
}
// RepoEnv is the runtime-metadata summary of one repository under
// management, rendered into the chat prompt's <env> block so the agent knows
// which checkouts it is responsible for without probing the filesystem. It is
// built only from live configuration; it never names a repository the daemon
// cannot confirm.
type RepoEnv struct {
// FullName is the configured owner/name.
FullName string
// Forge is the forge host the repository lives on (forge.host). Empty
// means no forge is configured for the active identity.
Forge string
// DefaultBranch is the branch PRs target (repos[].base, "main" when
// unset) -- the branch the daemon actually uses, not a guess.
DefaultBranch string
}
// SystemPromptConfig holds the inputs for one rendered system prompt.
type SystemPromptConfig struct {
// Persona is the active persona prompt.
Persona string
// Tools is the complete set of tools available for this turn.
Tools []ToolSummary
// Channel names the communication channel.
Channel string
Model string
SessionID string
// Page is the dashboard route the operator is on right now (e.g.
// "/tasks"). It is supplied per message by the web channel; empty for
// non-web channels, which have no page context. Rendered in the <env>
// runtime-metadata block so the agent knows where the operator is
// looking and can point them somewhere relevant.
Page string
// Now stamps the prompt's date.
Now time.Time
// Workspace is the directory the chat agent's file and shell tools are
// rooted at (chat.workspace). Empty means the agent has no rooted
// workspace: a real fact the prompt must say explicitly ("unknown") so the
// agent does not guess a path the daemon never granted it.
Workspace string
// Repos lists the repositories under management with their forge host and
// default branch. Rendered from live configuration (repos entries) so the
// agent knows its scope without probing the filesystem.
Repos []RepoEnv
// Operator is the display name of the person this deployment assists
// (chat.operator). Rendered so the agent knows the identity context it
// serves under; empty means unconfigured and must be said explicitly.
Operator string
}
// promptData is the template execution context. It exists so the template
// sees a pre-formatted date and pre-flattened tool metadata rather than
// calling methods during rendering.
type promptData struct {
SystemPromptConfig
Date string
}
var archiePromptTemplate = template.Must(
template.New("archie").
Funcs(template.FuncMap{"xml": strings.NewReplacer(
"&", "&amp;",
"<", "&lt;",
">", "&gt;",
).Replace}).
Parse(archiePromptTpl),
)
// BuildSystemPrompt renders the chat agent's system prompt.
func BuildSystemPrompt(cfg SystemPromptConfig) string {
tools := make([]ToolSummary, len(cfg.Tools))
for i, tool := range cfg.Tools {
tools[i] = ToolSummary{
Name: strings.Join(strings.Fields(tool.Name), " "),
Description: strings.Join(strings.Fields(tool.Description), " "),
}
}
data := promptData{
Persona: cfg.Persona,
Tools: tools,
Channel: cfg.Channel,
Model: cfg.Model,
SessionID: cfg.SessionID,
Page: cfg.Page,
Now: cfg.Now,
Date: cfg.Now.Format("2006-01-02"),
Workspace: cfg.Workspace,
Repos: cfg.Repos,
Operator: cfg.Operator,
}
var buf strings.Builder
if err := archiePromptTemplate.Execute(&buf, data); err != nil {
tpl := "You are Archie, a coding and project assistant. " +
"Never claim a tool, file, memory, action or result you have not verified. " +
"Keep replies short and lead with the answer."
return tpl
}
return strings.TrimSpace(buf.String())
}