generic

type Adapter ¶

type Adapter struct {
	// contains filtered or unexported fields
}

Adapter implements adapter.Adapter for one Spec.

func New(spec Spec, opts Options) *Adapter

func (a *Adapter) Apply(ops []adapter.FileOp, w adapter.DestWriter) error

func (a *Adapter) Capabilities() adapter.Capability

func (a *Adapter) Detect() (bool, error)

func (a *Adapter) Ingest(scope adapter.Scope, project string) (source.Canonical, error)

func (a *Adapter) KeyMergeStrategy() string

func (a *Adapter) Name() string

func (a *Adapter) Render(r secrets.Resolved, scope adapter.Scope, project string) ([]adapter.FileOp, []adapter.Skip, error)

type FileTarget ¶

type FileTarget struct {
	User    string // path under the user home (targetRoot)
	Project string // path under the project root
}

FileTarget is a per-scope path for a single file component (relative to the scope root). An empty path means the component is unsupported at that scope.

type MCPTarget ¶

type MCPTarget struct {
	User         string
	Project      string
	RootKey      string
	TransportKey string
	StdioValue   string
	RemoteValue  string
	RemoteURLKey string
	SSEURLKey    string
}

MCPTarget describes an agent's MCP servers JSON file and its on-disk dialect. The breadth tier only handles JSON `<rootKey>` server-map files; agents whose MCP is TOML, app-storage, or otherwise unmodeled simply leave User/Project empty (MCP unsupported) and are reported as a skip.

The dialect knobs capture the variance the prior-art research surfaced across the tail (all with Claude-compatible defaults):

• RootKey: the top-level object key. Default "mcpServers"; e.g. "servers" (VS Code Copilot), "mcp" (Crush).
• TransportKey: the per-server field naming the transport. "" = inferred from command-vs-url (no field). Else e.g. "type" or "transport".
• StdioValue / RemoteValue: the TransportKey values for stdio vs remote (defaults "stdio"/"http"; Copilot CLI uses "local" for stdio). Ignored when TransportKey == "".
• RemoteURLKey: the per-server field holding a remote server's URL. Default "url"; some agents use "httpUrl" (Qwen) or "serverUrl" (Antigravity).
• SSEURLKey: for Gemini-lineage agents that split remote transports across TWO url fields (Qwen: `httpUrl` = streamable HTTP, `url` = SSE), the field holding an SSE server's URL. "" = no split (SSE shares RemoteURLKey). When set, ingest reads both fields (RemoteURLKey wins when both are present, mirroring the upstream precedence) and render routes a canonical `sse` server to this key.

type Options ¶

type Options struct {
	TargetRoot string
	LookPath   func(file string) (string, error)
}

Options configure a generic adapter instance.

type Spec ¶

type Spec struct {
	Name      string     // agent name (Adapter.Name())
	DetectBin string     // binary on PATH (best-effort); "" to skip
	DetectDir string     // dir under targetRoot whose existence implies installed; "" to skip
	Memory    FileTarget // rules/instructions file (plain markdown)
	MCP       MCPTarget  // mcpServers JSON
}

Spec is the verified, data-driven description of one breadth-tier agent.

func Specs() []Spec