export

type Bundle struct {
	// Name is the safe on-disk name segment (kebab-case) used for file/section
	// names in the target format.
	Name string
	// Description is the human description surfaced in the target's frontmatter.
	// May be empty.
	Description string
	// Body is the markdown body written into the target rule (frontmatter already
	// stripped for skills).
	Body string
	// Files are bundled resources to write alongside the rule (skills only).
	// Cursor/Windsurf write them under a per-rule subdirectory; Codex skips them.
	Files []BundleFile
}

type BundleFile struct {
	Path        string
	DownloadURL string
	SizeBytes   int64
}

type FileWrite struct {
	RelPath     string
	Content     []byte
	DownloadURL string
	// Append requests append-or-create semantics instead of replace. Only the
	// Codex adapter sets it (AGENTS.md accumulates sections).
	Append bool
}

type Target interface {
	// Name is the flag value that selects this target (e.g. "cursor").
	Name() string
	// Path returns the primary rule file's path relative to the target root for
	// an item named name. Used by --dry-run previews.
	Path(name string) string
	// Transform maps a bundle onto the ordered list of files to write. The first
	// entry is always the primary rule file. Bundled resources (DownloadURL set)
	// follow. The returned paths are relative to the target root.
	Transform(b Bundle) ([]FileWrite, error)
}