feat(adapter): define Adapter interface and FileSet

internal/adapter/adapter.go

@@ -0,0 +1,39 @@
+// Package adapter defines the harness adapter interface and FileSet.
+package adapter
+
+import "github.com/lukaszraczylo/harness-sync/internal/canonical"
+
+type Kind int
+
+const (
+	RenderedFile Kind = iota
+	SymlinkFile
+	SymlinkDir
+)
+
+func (k Kind) String() string {
+	switch k {
+	case RenderedFile:
+		return "rendered"
+	case SymlinkFile:
+		return "symlink-file"
+	case SymlinkDir:
+		return "symlink-dir"
+	}
+	return "unknown"
+}
+
+type Adapter interface {
+	Name() string
+	Detect() bool
+	Render(b *canonical.Bundle) (*FileSet, error)
+	Import(home string) (*ImportResult, error)
+}
+
+type ImportResult struct {
+	Instructions string
+	Skills       []canonical.Skill
+	Agents       []canonical.Agent
+	MCP          []canonical.MCPServer
+	Profiles     []canonical.Profile
+}

internal/adapter/adapter_test.go

@@ -0,0 +1,25 @@
+package adapter
+
+import (
+	"testing"
+
+	"github.com/stretchr/testify/assert"
+)
+
+func TestFileSetAddAndIterate(t *testing.T) {
+	fs := NewFileSet()
+	fs.Add(File{Dest: "/tmp/a", Kind: RenderedFile, Content: []byte("a")})
+	fs.Add(File{Dest: "/tmp/b", Kind: SymlinkFile, SymlinkTarget: "/canon/b"})
+
+	seen := map[string]Kind{}
+	fs.ForEach(func(f File) {
+		seen[f.Dest] = f.Kind
+	})
+	assert.Equal(t, RenderedFile, seen["/tmp/a"])
+	assert.Equal(t, SymlinkFile, seen["/tmp/b"])
+}
+
+func TestKindString(t *testing.T) {
+	assert.Equal(t, "rendered", RenderedFile.String())
+	assert.Equal(t, "symlink-file", SymlinkFile.String())
+}

internal/adapter/fileset.go

@@ -0,0 +1,32 @@
+package adapter
+
+import "os"
+
+type File struct {
+	Dest          string
+	SymlinkTarget string
+	Content       []byte
+	Mode          os.FileMode
+	Kind          Kind
+}
+
+type FileSet struct {
+	files []File
+}
+
+func NewFileSet() *FileSet { return &FileSet{} }
+
+func (fs *FileSet) Add(f File) {
+	if f.Mode == 0 && f.Kind == RenderedFile {
+		f.Mode = 0o644
+	}
+	fs.files = append(fs.files, f)
+}
+
+func (fs *FileSet) ForEach(fn func(File)) {
+	for _, f := range fs.files {
+		fn(f)
+	}
+}
+
+func (fs *FileSet) Len() int { return len(fs.files) }