changelog

Changelog

Release notes for the cutmaster-ai Python package. This page mirrors the most recent entries from the GitHub CHANGELOG ↗. For the canonical and complete history, follow the link.

Unreleased

Fixed

• Shot-tag cache miss for cut-timeline items with non-zero in-points. Reader now reconstructs the writer-canonical sample grid and intersects with the cut item's in/out range. Verified live: a cut that previously hit cache 2/9 → 9/9 painted, 9/9 stamped. Falls back to legacy plan_samples when no manifest exists.

Added

• POST /cutmaster/stamp-shot-metadata + /clear-shot-metadata endpoints + Review-screen "Stamp shot metadata" button. Two complementary writes: per-cut TimelineItem markers at frame 0 with structured shot record packed into customData (namespaced cutmaster.shot.v1), and optional MediaPoolItem keyword writes so Resolve smart bins can search by shot type.
• POST /cutmaster/paint-shot-colors endpoint + Review-screen "Paint shot colors" button. After build, paints each cut-timeline item by its modal cached shot_type (closeup → Orange, medium → Lime, wide → Teal, over-shoulder → Violet, broll → Blue, title-card → Pink). No new Gemini calls; idempotent.
• Pre-merge CI workflow with four parallel jobs — ruff lint + format check, pytest matrix on Python 3.11 and 3.12, gitleaks secrets scan, and an absolute home-path hygiene grep.
• SURFACE.md snapshot enforcement (tests/surface_snapshot.json + scripts/dump_surface.py). A new surface CI job fails PRs that change a @mcp.tool signature without a matching CHANGELOG entry.

0.3.0 — 2026-04-20

Major rename and consolidation pass. The full BREAKING list and migration steps live in the GitHub CHANGELOG ↗.

BREAKING

• Renamed Python distribution from celavii-resolve to cutmaster-ai. pip uninstall celavii-resolve && pip install cutmaster-ai. Imports change from celavii_resolve to cutmaster_ai.
• MCP tool names renamed from celavii_* prefix to cutmaster_* prefix. Skills, agents, and hook matchers using mcp__celavii-resolve__celavii_* must update to mcp__cutmaster-ai__cutmaster_*.
• Environment variables renamed CELAVII_* → CUTMASTER_*.
• Default filesystem paths renamed ~/.celavii/* → ~/.cutmaster/*.
• launchd Label and plist filename changed to ai.cutmaster.mcp.
• LUT vendor directory renamed LUT/Celavii/ → LUT/CutMaster/.

Added

• Plugin discovery via two entry-point groups: cutmaster_ai.tools (FastMCP) and cutmaster_ai.panel_routes (FastAPI). Third-party packages can register on either surface without touching OSS code.
• GET /pro/status endpoint reporting {tier, plugins: {tools, panel_routes}}.
• cutmaster_ai.licensing.current_tier() — returns "oss" or "standard".
• Idempotent SQLite migration runner for the panel state DB.
• Stable Pydantic model re-exports at cutmaster_ai.http.models.
• SURFACE.md documenting the versioned consumption contract for plugin authors.

0.2.0 — 2026-04-18

Restructuring pass for open-source release. No behaviour changes. Notable moves: ai/ → intelligence/, cutmaster/ split into 6 subpackages (core/, stt/, analysis/, media/, resolve_ops/, data/), panel/ → apps/panel/, top-level scripts → scripts/. Added SECURITY.md, .github/CODEOWNERS, docs/CONTRIBUTING.md, docs/ARCHITECTURE.md, docs/MCP_TOOLS.md. Repository history audited with trufflehog and gitleaks (0 secrets).

0.1.0 — 2026-04-10

Initial pre-release. ~240 tools, CutMaster v2-8 (per-clip STT, speakers, clip hunter), and the React Workflow Integration panel.