core

type AgentQuery struct {
	Type       string            `json:"type"`                 // function, struct, class, etc
	Name       string            `json:"name,omitempty"`       // name pattern with wildcards
	Contains   *AgentQuery       `json:"contains,omitempty"`   // nested queries
	Operator   string            `json:"operator,omitempty"`   // AND, OR, NOT
	Operands   []AgentQuery      `json:"operands,omitempty"`   // for compound queries
	Attributes map[string]string `json:"attributes,omitempty"` // extra constraints, such as type
}

type AtomicWriteConfig struct {
	UseFsync       bool          // Force fsync for durability
	LockTimeout    time.Duration // Max time to wait for file lock
	TempSuffix     string        // Suffix for temporary files
	BackupOriginal bool          // Create backup before writing
}

type AtomicWriter struct {
	// contains filtered or unexported fields
}

type CodeMatch struct {
	Name      string `json:"name"`      // Extracted name/identifier
	Type      string `json:"type"`      // Query type that matched
	NodeType  string `json:"node_type"` // AST node type
	StartByte uint32 `json:"start_byte"`
	EndByte   uint32 `json:"end_byte"`
	Line      uint32 `json:"line"`
	Column    uint32 `json:"column"`
}

type ConfidenceFactor struct {
	Name   string  `json:"name"`
	Impact float64 `json:"impact"` // -1.0 to 1.0
	Reason string  `json:"reason"`
}

type ConfidenceScore struct {
	Score   float64            `json:"score"` // 0.0 to 1.0
	Level   string             `json:"level"` // high, medium, low
	Factors []ConfidenceFactor `json:"factors"`
}

type FileLock struct {
	// contains filtered or unexported fields
}

type FileMatch struct {
	Match           // Embedded base match
	FilePath string `json:"file_path"` // Absolute file path
	FileSize int64  `json:"file_size"` // File size in bytes
	ModTime  int64  `json:"mod_time"`  // Last modification time (Unix timestamp)
	Language string `json:"language"`  // Detected language
}

type FileProcessor struct {
	// contains filtered or unexported fields
}

type FileSafety interface {
	ValidateBatch(scope FileScope, files []WalkResult) error
	ValidateFileChange(file WalkResult, confidence ConfidenceScore) error
}

type FileScope struct {
	Path           string   `json:"path"`                // Root path to scan
	Include        []string `json:"include,omitempty"`   // File patterns to include (*.go, **/*.ts)
	Exclude        []string `json:"exclude,omitempty"`   // File patterns to exclude
	MaxDepth       int      `json:"max_depth,omitempty"` // Max directory depth (0 = unlimited)
	MaxFiles       int      `json:"max_files,omitempty"` // Max files to process (0 = unlimited)
	FollowSymlinks bool     `json:"follow_symlinks"`     // Follow symbolic links
	Language       string   `json:"language,omitempty"`  // Auto-detect by extension if empty
}

type FileTransformDetail struct {
	FilePath     string          `json:"file_path"`
	Language     string          `json:"language"`
	MatchCount   int             `json:"match_count"`
	Modified     bool            `json:"modified"`
	Diff         string          `json:"diff,omitempty"`
	Confidence   ConfidenceScore `json:"confidence"`
	Error        string          `json:"error,omitempty"`
	BackupPath   string          `json:"backup_path,omitempty"`
	OriginalSize int64           `json:"original_size"`
	ModifiedSize int64           `json:"modified_size"`
}

type FileTransformOp struct {
	TransformOp           // Embedded base operation
	Scope       FileScope `json:"scope"`    // Files to operate on
	DryRun      bool      `json:"dry_run"`  // Preview only, don't modify files
	Backup      bool      `json:"backup"`   // Create .bak files before modifying
	Parallel    bool      `json:"parallel"` // Use parallel processing
}

type FileTransformResult struct {
	FilesScanned      int                   `json:"files_scanned"`            // Total files processed
	FilesModified     int                   `json:"files_modified"`           // Files actually changed
	TotalMatches      int                   `json:"total_matches"`            // Total matches across all files
	ScanDuration      int64                 `json:"scan_duration_ms"`         // Time spent scanning (ms)
	TransformDuration int64                 `json:"transform_duration_ms"`    // Time spent transforming (ms)
	Files             []FileTransformDetail `json:"files"`                    // Per-file results
	Confidence        ConfidenceScore       `json:"confidence"`               // Overall confidence
	TransactionID     string                `json:"transaction_id,omitempty"` // Transaction ID for rollback
	Errors            []string              `json:"errors,omitempty"`         // Non-fatal errors encountered during processing
	Error             error                 `json:"-"`
}

type FileWalker struct {
	// contains filtered or unexported fields
}

type Location struct {
	File      string `json:"file,omitempty"`
	Line      int    `json:"line"`
	Column    int    `json:"column"`
	EndLine   int    `json:"end_line,omitempty"`
	EndColumn int    `json:"end_column,omitempty"`
}

type Match struct {
	Type     string   `json:"type"`
	Name     string   `json:"name"`
	Location Location `json:"location"`
	Content  string   `json:"content,omitempty"`
	Scope    string   `json:"scope,omitempty"`  // file, function, class
	Parent   string   `json:"parent,omitempty"` // parent element name
}

type Provider interface {
	Language() string
	Query(source string, query AgentQuery) QueryResult
	Transform(source string, op TransformOp) TransformResult
}

type ProviderRegistry interface {
	Get(language string) (Provider, bool)
}

type QueryResult struct {
	Matches []Match `json:"matches"`
	Total   int     `json:"total"`
	Error   error   `json:"-"`
}

type Recipe struct {
	Name          string       `json:"name"`
	Description   string       `json:"description,omitempty"`
	DryRun        bool         `json:"dry_run,omitempty"`
	MinConfidence float64      `json:"min_confidence,omitempty"`
	Steps         []RecipeStep `json:"steps"`
}

type RecipeProcessor interface {
	TransformFiles(context.Context, FileTransformOp) (*FileTransformResult, error)
}

type RecipeResult struct {
	Name           string             `json:"name"`
	DryRun         bool               `json:"dry_run"`
	StepsRun       int                `json:"steps_run"`
	FilesScanned   int                `json:"files_scanned"`
	FilesModified  int                `json:"files_modified"`
	TotalMatches   int                `json:"total_matches"`
	TransactionIDs []string           `json:"transaction_ids,omitempty"`
	Steps          []RecipeStepResult `json:"steps"`
}

type RecipeStep struct {
	Name          string     `json:"name"`
	Description   string     `json:"description,omitempty"`
	Method        string     `json:"method"`
	Scope         FileScope  `json:"scope"`
	Target        AgentQuery `json:"target"`
	TargetDSL     string     `json:"target_dsl,omitempty"`
	Replacement   string     `json:"replacement,omitempty"`
	Content       string     `json:"content,omitempty"`
	MinConfidence float64    `json:"min_confidence,omitempty"`
	Backup        bool       `json:"backup,omitempty"`
}

type RecipeStepResult struct {
	Name          string               `json:"name"`
	Method        string               `json:"method"`
	DryRun        bool                 `json:"dry_run"`
	MinConfidence float64              `json:"min_confidence"`
	Result        *FileTransformResult `json:"result"`
	AppliedResult *FileTransformResult `json:"applied_result,omitempty"`
}

type Rule = RecipeStep

type TransactionLog struct {
	ID          string                 `json:"id"`
	Started     time.Time              `json:"started"`
	Completed   time.Time              `json:"completed"`
	Operations  []TransactionOperation `json:"operations"`
	Status      string                 `json:"status"` // "pending", "committed", "rolled_back"
	Description string                 `json:"description"`
}

type TransactionManager struct {
	// contains filtered or unexported fields
}

type TransactionOperation struct {
	Type       string    `json:"type"` // "modify", "create", "delete"
	FilePath   string    `json:"file_path"`
	BackupPath string    `json:"backup_path"` // For rollback
	Checksum   string    `json:"checksum"`    // Original file checksum
	Timestamp  time.Time `json:"timestamp"`
	Completed  bool      `json:"completed"`
	Error      string    `json:"error,omitempty"`
}

type TransformOp struct {
	Method      string     `json:"method"`                // replace, delete, insert_before, etc
	Target      AgentQuery `json:"target"`                // what to find
	Content     string     `json:"content,omitempty"`     // for insert/append
	Replacement string     `json:"replacement,omitempty"` // for replace
}

type TransformResult struct {
	Modified   string          `json:"modified"`
	Diff       string          `json:"diff"`
	Confidence ConfidenceScore `json:"confidence"`
	MatchCount int             `json:"match_count"`        // Number of elements matched/transformed
	Metadata   map[string]any  `json:"metadata,omitempty"` // Additional info (strategy, etc)
	Error      error           `json:"-"`
}

type WalkResult struct {
	Path     string
	Info     fs.FileInfo
	Language string
	Error    error
}