Add stage planning and placeholder runner

internal/stage/stage.go

@@ -2,20 +2,48 @@ package stage
 
 import (
 	"context"
+	"log/slog"
 
-	"gitea.maximumdirect.net/eric/narratio/internal/app"
+	"gitea.maximumdirect.net/eric/narratio/internal/adapters/analyzer"
+	"gitea.maximumdirect.net/eric/narratio/internal/adapters/audita"
+	"gitea.maximumdirect.net/eric/narratio/internal/adapters/notify"
+	"gitea.maximumdirect.net/eric/narratio/internal/adapters/seriatim"
+	"gitea.maximumdirect.net/eric/narratio/internal/adapters/whisperx"
 	"gitea.maximumdirect.net/eric/narratio/internal/artifacts"
+	"gitea.maximumdirect.net/eric/narratio/internal/config"
 	"gitea.maximumdirect.net/eric/narratio/internal/manifest"
 )
 
+// Env is the shared dependency container visible to stages.
+type Env struct {
+	Config        *config.Config
+	ArtifactStore artifacts.Store
+	Logger        *slog.Logger
+
+	WhisperX whisperx.Client
+	Seriatim seriatim.Runner
+	Audita   audita.Runner
+	Analyzer analyzer.Runner
+	Notifier notify.Sender
+}
+
+// IODecl declares the intended input/output artifact kinds for a stage.
+type IODecl struct {
+	Inputs  []artifacts.Ref
+	Outputs []artifacts.Ref
+}
+
 // Stage is the pipeline unit contract.
 type Stage interface {
 	Name() string
-	Run(ctx context.Context, env *app.Env, m *manifest.Manifest) (*Result, error)
+	Declares() IODecl
+	Run(ctx context.Context, env *Env, m *manifest.Manifest) (*StageResult, error)
 }
 
-// Result is the declared output of a stage execution.
-type Result struct {
-	Outputs  []artifacts.Ref
-	Metadata map[string]any
+// StageResult is the declared output of a stage execution.
+type StageResult struct {
+	Outputs          []artifacts.Ref
+	Logs             []string
+	GeneratedConfigs []string
+	Metadata         map[string]any
 }