Data Model – Genkit renameFlow & AI CLI

Entity: RenameFlowInput

Fields
- fileNames []string — Ordered list of basenames collected from scope traversal.
- userPrompt string — Optional user guidance merged into the prompt template.
Validation Rules
- Require at least one filename; enforce maximum of 200 per invocation (soft limit before batching).
- Reject names containing path separators; traversal supplies basenames only.
- Trim whitespace from userPrompt; clamp length (e.g., 1–500 characters) to guard against prompt injection.
Relationships
- Serialized to JSON and passed into genkit.Generate() as the model input payload.
- Logged with invocation metadata to support replay/debugging.

Fields
- suggestions []RenameSuggestion — AI-produced rename pairs in same order as input list when possible.
Validation Rules
- len(suggestions) MUST equal length of input fileNames before approval.
- Each suggestion MUST pass filename safety checks (see RenameSuggestion).
- JSON payload MUST parse cleanly with no additional top-level properties.
Relationships
- Returned to the CLI bridge, transformed into preview rows and ledger entries.

Fields
- original string — Original basename (must match an item from input list).
- suggested string — Proposed basename with identical extension as original.
Validation Rules
- Preserve extension suffix (text after last .); fail if changed or removed.
- Disallow illegal filesystem characters: / \ : * ? " < > | and control bytes.
- Enforce case-insensitive uniqueness across all suggested values to avoid collisions.
- Reject empty or whitespace-only suggestions; trim incidental spaces.
Relationships
- Consumed by preview renderer to display mappings.
- Persisted in ledger metadata alongside user prompt and model ID.

Fields
- Scope traversal.ScopeResult — Snapshot of files selected for AI processing.
- Prompt string — Rendered prompt sent to Genkit (stored for debugging).
- ModelID string — Identifier for the AI model used during generation.
- Suggestions []RenameSuggestion — Parsed results aligned with scope entries.
- Warnings []string — Issues detected during validation (duplicates, unchanged names, limit truncation).
Validation Rules
- Warnings that correspond to hard failures (duplicate targets, invalid characters) block apply until resolved.
- Scope result order MUST align with suggestion order to keep preview deterministic.
Relationships
- Passed into output renderer for table display.
- Written to ledger with history.RecordBatch for undo.

Fields
- InvocationID string — UUID tying output to ledger entry.
- Timestamp time.Time — Invocation time for audit trail.
- Duration time.Duration — Round-trip latency for success criteria tracking.
- InputSize int — Number of filenames processed (used for batching heuristics).
- Errors []string — Captured model or validation errors.
Validation Rules
- Duration recorded only on successful completions; errors populated otherwise.
Relationships
- Optional: appended to debug logs or analytics for performance monitoring (non-ledger).