Define adapter interfaces and fake implementations

internal/adapters/analyzer/fake.go

@@ -0,0 +1,40 @@
+package analyzer
+
+import "context"
+
+// NoopRunner is a deterministic no-op analyzer adapter.
+type NoopRunner struct{}
+
+// Run returns the requested output path with placeholder metadata.
+func (n *NoopRunner) Run(ctx context.Context, req AnalyzeRequest) (AnalyzeResult, error) {
+	if err := ctx.Err(); err != nil {
+		return AnalyzeResult{}, err
+	}
+	return AnalyzeResult{ArtifactPath: req.OutputPath, Metadata: map[string]any{"placeholder": true}}, nil
+}
+
+// FakeRunner captures analyze requests and returns deterministic responses.
+type FakeRunner struct {
+	Requests []AnalyzeRequest
+	Err      error
+	Result   AnalyzeResult
+}
+
+// Run records request and returns configured response.
+func (f *FakeRunner) Run(ctx context.Context, req AnalyzeRequest) (AnalyzeResult, error) {
+	if err := ctx.Err(); err != nil {
+		return AnalyzeResult{}, err
+	}
+	f.Requests = append(f.Requests, req)
+	if f.Err != nil {
+		return AnalyzeResult{}, f.Err
+	}
+	res := f.Result
+	if res.ArtifactPath == "" {
+		res.ArtifactPath = req.OutputPath
+	}
+	if res.Metadata == nil {
+		res.Metadata = map[string]any{"fake": true}
+	}
+	return res, nil
+}

internal/adapters/analyzer/fake_test.go

@@ -0,0 +1,31 @@
+package analyzer
+
+import (
+	"context"
+	"errors"
+	"testing"
+)
+
+func TestFakeRunnerCapturesRequestAndReturnsPath(t *testing.T) {
+	fake := &FakeRunner{}
+	req := AnalyzeRequest{ArtifactType: "session-log", OutputPath: "artifacts/session-log.md"}
+
+	res, err := fake.Run(context.Background(), req)
+	if err != nil {
+		t.Fatalf("Run() error = %v", err)
+	}
+	if len(fake.Requests) != 1 || fake.Requests[0].ArtifactType != "session-log" {
+		t.Fatalf("requests = %#v, want captured request", fake.Requests)
+	}
+	if res.ArtifactPath != req.OutputPath {
+		t.Fatalf("artifact path = %q, want %q", res.ArtifactPath, req.OutputPath)
+	}
+}
+
+func TestFakeRunnerError(t *testing.T) {
+	fake := &FakeRunner{Err: errors.New("boom")}
+	_, err := fake.Run(context.Background(), AnalyzeRequest{})
+	if err == nil {
+		t.Fatal("expected error, got nil")
+	}
+}

internal/adapters/analyzer/runner.go

@@ -3,18 +3,24 @@ package analyzer
 
 import "context"
 
-// Runner is a placeholder adapter interface for session artifact generation.
+// Runner is the adapter boundary for analyzer invocations.
 type Runner interface {
-	Run(ctx context.Context, req AnalysisRequest) (AnalysisResult, error)
+	Run(ctx context.Context, req AnalyzeRequest) (AnalyzeResult, error)
 }
 
-// AnalysisRequest is a placeholder analyzer input.
-type AnalysisRequest struct {
+// AnalyzeRequest describes one analyzer artifact generation request.
+type AnalyzeRequest struct {
+	ArtifactType            string
 	ProcessedTranscriptPath string
-	OutputDir               string
+	ContextReferences       []string
+	OutputPath              string
+	GeneratedConfigPath     string
+	StdoutLogPath           string
+	StderrLogPath           string
 }
 
-// AnalysisResult is a placeholder analyzer output.
-type AnalysisResult struct {
-	ArtifactPaths []string
+// AnalyzeResult describes analyzer output.
+type AnalyzeResult struct {
+	ArtifactPath string
+	Metadata     map[string]any
 }