narratio/internal/adapters/audita/runner.go

// Package audita declares the adapter contract for transcript polishing.
package audita

import (
	"context"
	"time"
)

// TODO: implement a real Audita subprocess/service adapter.

// Runner is the adapter boundary for audita polish invocations.
type Runner interface {
	Run(ctx context.Context, req PolishRequest) (PolishResult, error)
}

// PolishRequest describes an audita invocation.
type PolishRequest struct {
	GeneratedConfigPath      string
	MergedTranscriptPath     string
	OutputProcessedPath      string
	GlossaryPath             string
	ReportPath               string
	WorkDir                  string
	Modules                  []string
	BaseURL                  string
	Model                    string
	TranscriptDescription    string
	ConfigPath               string
	OutputSchema             string
	WorkDirRetention         string
	TotalLLMConcurrency      *int
	ProposalLLMConcurrency   *int
	ValidationModel          string
	ValidationLLMConcurrency *int
	StdoutLogPath            string
	StderrLogPath            string
}

// PolishResult describes a polish output.
type PolishResult struct {
	ProcessedTranscriptPath string
	ReportPath              string
	WorkDir                 string
	StdoutLogPath           string
	StderrLogPath           string
	GeneratedConfigPath     string
	ExitCode                int
	Duration                time.Duration
	InvokedBinary           string
	Metadata                map[string]any
}