mirror of
https://github.com/lukaszraczylo/harness-sync.git
synced 2026-10-12 00:45:22 +00:00
Add Rule as a first-class canonical kind (rules/<name>.md, loaded like agents) and propagate it the way each harness actually loads it: - claude-code: native ~/.claude/rules directory symlink (preserves rule path-scoping frontmatter); rules NOT folded into CLAUDE.md. - opencode/kilo/zed/crush: fold rule bodies into the global AGENTS.md always-on instructions file (frontmatter stripped). crush has no global instructions file, so register the absolute AGENTS.md path in options.context_paths (defaults are re-prepended at load, so nothing is clobbered). - goose: fold into ~/.config/goose/.goosehints. - cagent: fold into the per-agent instruction. Also: - Wire markdown agents to opencode (~/.config/opencode/agents) and fix the kilo agents symlink: plural ~/.config/kilo/agents (singular "agent" is a silent no-op on current Kilo CLI). - Add ManagesAgents/ManagesRules to HarnessCapabilities + ImportResult.Rules; claude-code/opencode import rules/agents round-trip. - Centralize instruction selection in Bundle.InstructionText / InstructionTextWithRules (replaces per-adapter override duplication). - init scaffolds + imports rules; README capability matrix gains Agents/Rules columns with native-vs-folded footnotes. Grounded each harness's sink against official docs + config source this session. Gate: gofmt, go vet, go test -race ./..., golangci-lint (0), govulncheck (clean).
130 lines
4.0 KiB
Go
130 lines
4.0 KiB
Go
// Package opencode is the opencode harness adapter.
|
|
package opencode
|
|
|
|
import (
|
|
"encoding/json"
|
|
"fmt"
|
|
"os"
|
|
"path/filepath"
|
|
|
|
"github.com/lukaszraczylo/harness-sync/internal/adapter"
|
|
"github.com/lukaszraczylo/harness-sync/internal/adapter/common"
|
|
"github.com/lukaszraczylo/harness-sync/internal/canonical"
|
|
)
|
|
|
|
const name = "opencode"
|
|
|
|
// Adapter implements adapter.Adapter for the opencode harness.
|
|
type Adapter struct {
|
|
*adapter.Base
|
|
}
|
|
|
|
// WithHome overrides the home directory used to resolve target paths.
|
|
func WithHome(h string) adapter.BaseOption { return func(b *adapter.Base) { b.Home = h } }
|
|
|
|
// New returns a new Adapter with the given options applied.
|
|
func New(opts ...adapter.BaseOption) *Adapter {
|
|
return &Adapter{Base: adapter.NewBase(opts...)}
|
|
}
|
|
|
|
// Name returns the harness identifier.
|
|
func (a *Adapter) Name() string { return name }
|
|
|
|
// Capabilities declares what opencode harness-sync manages.
|
|
func (a *Adapter) Capabilities() adapter.HarnessCapabilities {
|
|
return adapter.HarnessCapabilities{
|
|
ManagesProviders: true,
|
|
ManagesModels: true,
|
|
ManagesMCP: true,
|
|
ManagesSkills: true,
|
|
ManagesAgents: true,
|
|
ManagesRules: true,
|
|
ManagesInstructions: true,
|
|
HasBuiltInSub: false,
|
|
}
|
|
}
|
|
|
|
// Detect returns true when ~/.config/opencode exists.
|
|
func (a *Adapter) Detect() bool {
|
|
_, err := os.Stat(filepath.Join(a.Home, ".config", "opencode"))
|
|
return err == nil
|
|
}
|
|
|
|
// Render produces the FileSet that applies the canonical bundle to opencode.
|
|
// opencode.jsonc is MERGED to preserve user-managed keys ($schema, agent,
|
|
// instructions, …). Correct keys: "provider" (singular, map), "model" (string),
|
|
// "mcp" (map with type: local|remote entries).
|
|
func (a *Adapter) Render(b *canonical.Bundle) (*adapter.FileSet, error) {
|
|
fs := adapter.NewFileSet()
|
|
base := filepath.Join(a.Home, ".config", "opencode")
|
|
|
|
// opencode reads skills from ~/.config/opencode/skills/<name>/SKILL.md
|
|
fs.Add(adapter.File{
|
|
Dest: filepath.Join(base, "skills"),
|
|
Kind: adapter.SymlinkDir,
|
|
SymlinkTarget: filepath.Join(b.Root, "skills"),
|
|
})
|
|
// opencode reads markdown subagents from ~/.config/opencode/agents/<name>.md
|
|
fs.Add(adapter.File{
|
|
Dest: filepath.Join(base, "agents"),
|
|
Kind: adapter.SymlinkDir,
|
|
SymlinkTarget: filepath.Join(b.Root, "agents"),
|
|
})
|
|
|
|
cfgPath := filepath.Join(base, "opencode.jsonc")
|
|
existing, err := common.ReadExistingFile(cfgPath)
|
|
if err != nil {
|
|
return nil, fmt.Errorf("read %s: %w", cfgPath, err)
|
|
}
|
|
|
|
// Build the provider map, then absorb any existing providers at the same
|
|
// gateway URL so duplicates don't accumulate across apply runs.
|
|
provMap := common.ProvidersAsMap(&b.Profile)
|
|
if len(existing) > 0 {
|
|
var base map[string]any
|
|
clean := common.StripJSONComments(string(existing))
|
|
if json.Unmarshal([]byte(clean), &base) == nil {
|
|
if existingProv, ok := base["provider"].(map[string]any); ok {
|
|
for k, v := range existingProv {
|
|
if _, ours := provMap[k]; !ours {
|
|
provMap[k] = v
|
|
}
|
|
}
|
|
provMap = common.AbsorbDuplicateProviders(provMap, common.GatewayProviderKey(b.Profile.Gateway.URL), b.Profile.Gateway.URL)
|
|
}
|
|
}
|
|
}
|
|
|
|
overlay := map[string]any{
|
|
"provider": provMap,
|
|
"model": common.KiloModelString(&b.Profile),
|
|
}
|
|
if mcp := common.BuildMCPMapStyled(&b.MCP, common.MCPOpencodeStyle); len(mcp) > 0 {
|
|
overlay["mcp"] = mcp
|
|
}
|
|
merged, err := common.MergeJSONKeys(existing, overlay)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
fs.Add(adapter.File{
|
|
Dest: cfgPath,
|
|
Kind: adapter.RenderedFile,
|
|
Content: merged,
|
|
})
|
|
|
|
// opencode has no native rules directory; rule content reaches it only via
|
|
// the global AGENTS.md instructions file, so fold the rules in here.
|
|
fs.Add(adapter.File{
|
|
Dest: filepath.Join(base, "AGENTS.md"),
|
|
Kind: adapter.RenderedFile,
|
|
Content: []byte(b.InstructionTextWithRules(name)),
|
|
})
|
|
|
|
return fs, nil
|
|
}
|
|
|
|
// Import reads opencode config from home and returns a canonical ImportResult.
|
|
func (a *Adapter) Import(home string) (*adapter.ImportResult, error) {
|
|
return importFrom(home)
|
|
}
|