# Backlog

Features and improvements for future implementation.

## Version Tags

Important milestones tagged for easy rollback/reference:

| Tag | Date | Commit | Description |
|-----|------|--------|-------------|
| `cinematic-only-2026-01-18` | 2026-01-18 | 1a84bb4 | Last version before visual styles & video kinds. Single cinematic style, no creative variations. |

**To restore a tagged version:**
```bash
git checkout <tag-name>           # detached HEAD at tag
git checkout -b <branch> <tag>    # new branch from tag
```

## Streaming Progress Updates

**Priority:** Medium
**Complexity:** High (requires refactoring)

### Current State
- Pipeline runs synchronously, blocks until complete
- All results sent at the end

### Desired State
- Send category/archetype info after Stage 2 completes
- Send preview images as they're generated (act1, then act2)
- Show Veo3 progress percentage in real-time

### Implementation Notes
- Need callback mechanism in pipeline OR
- Make pipeline async with yield/events
- Handle partial failures gracefully
- Consider using telegram "edit message" for progress updates

### Why Deferred
- Requires significant architecture change
- Current flow works, just not as responsive
- Will implement when rewriting pipeline code

## 1-Act Video Structure

**Priority:** Medium
**Complexity:** Medium

### Current State
- All videos use 2-act structure (Act 1 → transition → Act 2)
- Some products don't need story arc, just beautiful product presentation

### Desired State
- Support 1-act videos: single scene, no transition, 5-8 seconds
- Claude decides between 1-act and 2-act based on product
- 1-act is simpler, lower risk, good for:
  - Pure product beauty shots
  - Gift items just shown elegantly
  - Products where "story" adds complexity without value

### Implementation Notes
- Add `structure: "1-act" | "2-act"` to story_vision output
- Skip Act 1 frame generation if 1-act
- Adjust Veo3 prompt format for single scene
- May need different duration (5-8 sec instead of 3+5)

### Why Deferred
- 2-act structure works for most cases
- Gift archetype with 2-act can handle novelty items
- Implement when we see clear pattern of products failing with 2-act
