Changelog

Cambiamo perimetro. Da oggi PunxFilm Breakdown fa una cosa: sceneggiatura → spoglio → breakdown. Tutto sotto il modulo Regia. PdL, DOOD, ODG, Budget e Fondi non sono più visibili nell'app.

Perché. Avevamo cinque moduli funzionanti ma con livelli di rifinitura diversi. Lanciare la beta con cinque mezze cose ci avrebbe fatto passare per tool generalista approssimativo. Lanciare con un modulo solo, finito bene, ci dà il diritto di dire una cosa precisa: lo spoglio italiano lo facciamo meglio di chiunque altro.

Cosa cambia per chi entra oggi. Il canvas Regia è una sola pagina con tre pannelli affiancati e ridimensionabili: a sinistra la sceneggiatura, in centro lo spoglio scena per scena con strips MMS, a destra il breakdown con cast, location, props, costumi, effetti. I pannelli laterali si comprimono in barre verticali e si riaprono con un click. La chat "Aiuto Regista" resta come overlay laterale on-demand.

Cosa cambia per chi aveva già un piano. I tier Studio (€149/mo) e Production House (€349/mo) promettevano PdL/DOOD/ODG/Budget. Ora questi moduli non sono accessibili dall'app, quindi il checkout di questi tier è disabilitato fino a che non saranno live. Chi aveva già pagato riceve email diretta nelle prossime 48h con scelta tra refund automatico o credit verso il modulo Produzione quando uscirà. Free, Trial e Pay-per-project restano attivi senza modifiche.

Cosa promettiamo. Il modulo Produzione (PdL, DOOD, ODG, Budget) arriva quando sarà allo stesso standard di Regia. Nessuna data finta. Quando sarà pronto, lo annunciamo qui prima di abilitarlo.

Cosa è già pronto sotto il cofano. La pipeline Asset Banks (8 bank + multi-pass LLM + handoff brief) resta attiva e usata dal modulo Regia. Tutti i 1422 test passano. La migration pricing v2 e analytics events sono live. Stiamo solo coprendo le porte con un cartello "in lavorazione" finché il pavimento non è finito.

Cinque blocchi di lavoro chiusi tra il 24 e il 30 aprile. La pipeline di analisi è ora completa dalla sceneggiatura ai brief di handoff.

Multi-format loader (BLOCCO 17). L'import accetta ora cinque formati: PDF testuale, PDF scansionato (OCR Claude Vision), Final Draft .fdx, Fountain .fountain/.ftx e plain text .txt (export Trelby/Celtx). Prima funzionava solo PDF e FDX. Il parser plain text rileva automaticamente heading di scena in italiano e inglese con regex calibrate su Trelby e Celtx export.

4-pass LLM (BLOCCO 18-19). L'analisi della sceneggiatura avviene ora in quattro passate separate con ruoli distinti. Pass 1: script supervisor — verifica continuity, errori temporali, incongruenze. Pass 2: screenwriter — note su ritmo, sottotesto, archi. Pass 3: cross-scene aggregator — cluster semantici tra scene (personaggi ricorrenti, location correlate, oggetti chiave). Pass 4: quality check finale con deduplicazione semantica AI sulle entità estratte. Il costo per run è 8 crediti AI. Le passate sono idempotenti: se una scena non è cambiata, il risultato viene riusato senza ri-spendere crediti.

Asset Banks auto-populate (BLOCCO 19-20). Otto bank di elementi di produzione (personaggi, location, costumi, oggetti, veicoli, animali, suoni, effetti speciali) vengono popolati automaticamente dopo le 4 passate. La logica usa prima euristica (pattern regex + categoria scena) poi AI semantic dedup per eliminare varianti dello stesso elemento. L'operatore può confermare, modificare, eliminare o richiedere spiegazione per ogni entry.

Operator review loop (BLOCCO 20). Ogni entry del bank ha cinque azioni: conferma (bloccata nel bank), modifica inline, eliminazione con undo 5 secondi, richiesta insight AI contestuale, risoluzione stale quando il testo della scena è cambiato. Le entry non confermate mostrano badge "Da rivedere" e bloccano il conteggio finale.

Dirty-flag propagation R1→R2 (BLOCCO 20). Se una scena viene modificata dopo che il bank è stato popolato, le entry derivate da quella scena ricevono stato OPERATOR_STALE automaticamente. La firma di ciascuna entry include uno snapshot dell'hash della scena al momento dell'analisi: se l'hash cambia, lo stato cambia senza intervento manuale.

Handoff pre-produzione: 5 brief (BLOCCO 21). Dalla pipeline confermata si generano cinque brief strutturati per altrettanti reparti: casting (schede personaggi con note fisiche e psicologiche), sopralluogo (lista location con requisiti tecnici), costume (schede personaggio × scena con note continuity), schedule-prep (suggerimenti grouping scene per location e giornata), director treatment (note di regia aggregate per ogni sequenza). Ogni brief è scaricabile in markdown o copiabile negli appunti.

Stato test: 1416/1416 verdi. Build TypeScript clean. Nessuna regressione rilevata sul parser né sulle viste downstream.

Lo sprint più denso dall'inizio. Cambia il modello del prodotto.

Il cambio di rotta. Fino a marzo PunxFilm Breakdown era pensato per vivere come tool locale open-source. Dopo un giro di field test con case di produzione indie IT e qualche Line Producer freelance, due cose sono diventate chiare: (1) il software così com'è serve davvero, ma le case di produzione vogliono sync multi-device e un referente a cui chiedere conto; (2) il costo reale di far girare AI sull'analisi di sceneggiatura + breakdown + consigli di schedule non è sostenibile come "best-effort pubblico". Quindi: pivot a SaaS privato, accesso su invito, pricing trasparente, crediti AI a consumo. L'open-source non torna per ora — troppo overhead per due persone.

Cosa è entrato:

• ›Auth Clerk + sync Supabase (T1906, T1907): login, session, device tracking, cloud sync con conflict detection near-real-time. Progetti locali restano locali, ma se vuoi aprire lo stesso progetto su iPad in sopralluogo ora funziona.
• ›Sistema crediti AI (T1907a–d, T1908): ogni call AI costa crediti trasparenti (1 per spoglio scena, 1 per breakdown scena, 3 per pre-analisi sceneggiatura). Balance in header sempre visibile, ledger server-side idempotente, pre-flight check che blocca la spesa se il saldo non basta — niente errori a costo già imputato.
• ›Stripe checkout (T1909): piani trial 14 giorni, Starter/Pro/Studio, top-up crediti. Webhook verificato, fallback metadata su subscription_data per gestire edge case Clerk↔Stripe email mismatch.
• ›Onboarding Wizard (T1916, T1918, T1919): upload PDF/FDX → pre-analisi con preview → conferma formato+giornate → auto-spoglio leggero + PdL iniziale in 4 fasi visibili, l'utente atterra sullo stripboard con qualcosa di vero già costruito. Fine dell'onboarding che chiedeva di cliccare dieci bottoni diversi.
• ›IdempotencyBanner balance-aware (T1918c): prima di ogni batch AI mostra quante scene sono già analizzate (costo 0), quante nuove, quante modificate, e il saldo accanto al costo stimato. Niente più click che fallisce al pre-flight. Pattern preso dal topsheet MovieMagic: costo riga sempre accanto al fondo disponibile.
• ›Landing pubblica v3 (T1921a–c): sei sezioni argomentative (Hero, Problem, HowItWorks, Features, Pricing, EcosystemTimeline, TrialCTA). Copy Line Producer-first, zero buzzword "AI era", pricing diretto in home senza funnel.
• ›Direttiva terminologica "sempre sceneggiatura" (T1922): scelta editoriale non negoziabile, applicata a tutto il codice, gli agent interni e i futuri copy. L'app parla ai Line Producer con il vocabolario che usano i contratti MiBACT e SIAE — non quello del set visto da fuori. CI gate in `lib/brand/tokens.test.ts` fallisce se qualcuno regredisce.

Fase 5b UX polish — empty states production-ready su ScreenplayEditor, SpoglioView, BreakdownTable, ODG quando la catena upstream è incompleta. Prima l'utente vedeva tab vuote senza spiegazione, ora arriva un hero con CTA che lo porta al passo bloccante.

Cosa abbiamo scartato: auth con magic-link puro senza password (troppa friction per il DP che controlla in auto tra due location), e un primo tentativo di "wizard a 3 step" per onboarding (troppi click — ora è 2 step + auto-elaborazione in background).

Stato test: 1213 green, stabili. Build-time tsc strict clean. CI terminology veto attivo.

Chiuso in anticipo di tre giorni rispetto alla stima. Non capita spesso, quindi vale la pena scriverlo.

Cosa è entrato:

• ›Governance UI end-to-end (T505): le DecisionMemo ora hanno una superficie concreta — elenco, stato, chi ha firmato cosa, quando è stata invalidata da un cambio upstream. Prima era logica backend senza modo di ispezionarla.
• ›DayPressurePill (T503): indicatore di pressione per giornata in stripboard. Legge set-up reparti, scene, location, cast e restituisce un punteggio leggibile. Non è un oracolo, è una sintesi visiva di cose che l'Organizzatore Generale sa già leggere a mente — ma ora le leggi tutte insieme.
• ›Weekly Report + DaySummary a 7 KPI (T701, T801, T802): il report settimanale ora ha numeri stabili, non derivati a runtime ogni volta. Abbiamo spostato la derivazione in snapshot, così le cifre che vedi nel PDF sono le stesse che vedi in UI.

Cosa abbiamo imparato: il field test della DayPressurePill ha sollevato due bug minori sul punteggio notturno che non avevano coverage test. Aggiunti regression test, adesso stanno.

Stato test: 966 green, stabili.

Lo sprint #002 ha chiuso il Blocco 1 (Sicurezza dati / Parser Hardening) e aperto il Blocco 5 (Governance Primitives).

Cosa è entrato:

• ›Baseline regressione su quattro film reali (T101): abbiamo preso quattro sceneggiature che usiamo come benchmark interno — generi e strutture diverse — e le abbiamo congelate come baseline parser. Ogni modifica al parser ora deve dimostrare di non peggiorare su queste quattro. Niente PR che "sembra funzionare sul film X".
• ›Artefatti pagina eliminati (T102): header, numeri pagina, footer dello script non finivano più nei dati delle scene. Sembra un dettaglio, ma era la fonte principale di spoglio sporco.
• ›Repair pass editor-safe (T103): se il parser trova una riga ambigua, ora la marca invece di tirare a indovinare. La responsabilità torna all'umano, che è dove deve stare.
• ›Governance Primitives v3 (T203): prima versione reale di DecisionMemo, RoleConstraint, DayPressureScore, CreativeProtection. Non ancora UI completa (arriva sprint #003), ma il modello dati è definito.

Scelta che ha pagato: tenere il parser separato dall'AI. L'AI serve per spoglio e classificazione, non per parsare il layout di un PDF. Sono problemi diversi con test diversi.

Primo sprint strutturato dopo un lungo giro di refactor di consolidamento.

Cosa è entrato:

• ›Stripboard con undo/redo (T501): history buffer limitato a 20 step. Perché 20? Perché più di così la gente non si ricorda cosa aveva fatto prima e l'undo smette di essere utile.
• ›Global search comando K (T502): palette fuzzy multi-entità — scene, personaggi, location, giornate. Il kind di cosa che dopo averla avuta non capisci come facevi prima.
• ›Keyboard shortcuts + cheat-sheet (T504): sul set nessuno ha tempo di andare col mouse. Shortcuts per le operazioni più frequenti, cheat-sheet accessibile con tasto ?.
• ›Notifications center (T67): stream di eventi importanti (scene invalidata, export pronto, giornata congelata). Non invasive — è una bell icon, non un toast che interrompe il lavoro.
• ›Insurance + equipment rentals tracker (T61, T62): polizze con warnings scadenza e noleggi con link opzionale a budget BTL. Roba operativa che in Excel occupa uno sheet a parte e si dimentica sempre.

Questo sprint ha anche stabilizzato la base test: prima viaggiavamo con coverage incerta, adesso abbiamo un baseline che gira in CI a ogni push.