Changelog

All notable changes to the Auteur Script Knowledge Base & Open Specification will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

I. Framework & Theory (Auteur Script Specification)

Changed

  • [Documentation / Homepage Roadmap] Modular Knowledge Base Explorer & Verified Entry Point (index.qmd):
    • Restructured the homepage modular explorer to reflect the 5 canonical sections matching the site navigation (Theory, Macro-Blocks, Sub-State Tags, Modules, Reference Scripts), linking directly to their respective landing hubs (overview.qmd).
    • Highlighted The Auteur Script Blueprint (grammar/conceptual_model.qmd) and Glossary (grammar/glossary.qmd) as the author-verified (✅) foundations to read first, framing specialized coordinates and modules as active working drafts.
    • Re-anchored the “Where to Start” onboarding sequence with a step-by-step reading flow.

II. Documentation Website (Quarto Platform & Extension)

Added

  • [Interactive Annotations / Homepage] Grounded Glossary Terms (index.qmd):
    • Integrated interactive glossary term spans across the homepage hero prologue, workflow pipeline diagram, macro-block callout containers, and foundational directorial principles.
    • Enabled instant popover definitions for first-time visitors for core concepts (latent_priors, auteur_script, coordinate_fences, phase_staging, phase_execution, the 5 macro-blocks, macro_state, physical_baggage, and diagnostic_ledger).

Removed

  • [CSS / Cleanup] Unused Card Explorer Styles (custom.css):
    • Purged unused .kb-card styles and related classes to eliminate dead CSS rules and keep the stylesheet lean.

[0.3.0] - 2026-09-03

I. Framework & Theory (Auteur Script Specification)

Added

  • [Theory / Glossary Grounding] Grounded Framework Dictionary (grammar/glossary.yml):
    • Rewrote the centralized dictionary to strictly feature 27 verified terms grounded in active documentation (The Auteur Script Blueprint), eliminating speculative terminology and academic jargon.
    • Implemented a streamlined 5-field schema (term, symbol, category, brief, detail), separating definitions into a 1-sentence quick-glance meaning (brief) and practical operational context (detail).
    • Categorized terms across three primary domains: Staging Architecture (staging), State Mathematics & Timeline (math), and Directorial Craft & Continuity (craft).
  • [Theory / Interactive Annotations] Article-Level Term Grounding (grammar/conceptual_model.qmd):
    • Grounded all 27 dictionary terms across their primary introductions in The Auteur Script Blueprint using native bracketed spans ([phrase]{term="key"}).
    • Enabled responsive margin card popovers and mobile expansion folds for seamless reading flow.

Changed

  • [Theory / Glossary Presentation] Quick-Glance Master Glossary (grammar/glossary.qmd):
    • Designated the document as author-verified (✅ Glossary) following comprehensive structural and terminological audit.
    • Restructured the master glossary presentation into three dedicated sections mirroring The Auteur Script Blueprint, utilizing dynamic category rendering via {{< glossary-entries category="..." >}} (or {{< glossary-table >}}).
    • Added introductory guidance framing the glossary as quick-glance cognitive handles and explaining interactive margin cards.

II. Documentation Website (Quarto Platform & Extension)

Added

  • [Extension / Trackbacks] Automated Trackback Discovery Engine (_extensions/glossary/glossary-shortcodes.lua):
    • Implemented an automated Lua trackback scanner that traverses workspace .qmd and .md articles during Pandoc compilation to locate term citations (term="key" and {{< term key >}}).
    • Automatically derives document titles and heading anchors (#sec-...), generating bidirectional links back to the exact sections where terms are introduced without manual YAML anchor maintenance.
  • [Extension / Quarto] Standalone Quarto Glossary Extension (_extensions/glossary/):
    • Authored a fully decoupled Quarto extension providing dual authoring interfaces: native Pandoc bracketed spans ([phrase]{term="key"} / [Term]{.term}) and shortcodes ({{< term key >}}, {{< glossary-table category="..." >}}).
    • Implemented editorial right-margin sidenotes on desktop (>= 992px) with hover preview, click-to-pin interaction, and responsive inline fold expansion on mobile (< 992px).
    • Designed card typography with distinct styling for concise definitions and detailed explanations, complete with MathJax LaTeX math rendering and master glossary jump links.

Changed

  • [Website / Information Architecture] Flat Utility Sidebar & Uninterrupted Tutorial Flow (_quarto.yml, grammar/overview.qmd):
    • Decoupled the Master Glossary from the sequential Theory & Grammar chapter progression, repositioning Glossary alongside Changelog as flat, unnested utility links at the bottom of the sidebar.
    • Eliminated the single-document Release Notes collapsible dropdown in favor of clean, direct sidebar navigation.
    • Streamlined the sequential pagination flow so completing The Auteur Script Blueprint (grammar/conceptual_model.qmd) directly advances the reader to Block Grammar & Orthogonality (grammar/block_rules.md).
    • Updated the Core Theory Reading Roadmap in grammar/overview.qmd to a cohesive 6-chapter sequence with a dedicated callout linking to the Glossary for instant terminology reference.
  • [Extension / Interaction UX] Streamlined Glanceable Term Popovers (_extensions/glossary/):
    • Decoupled in-context reading popovers from the comprehensive Master Glossary presentation by restricting margin sidenotes and mobile folds strictly to the single-sentence brief definition.
    • Omitted the extensive detail elaboration paragraph from inline popovers to preserve the reader’s narrative flow and prevent cognitive competition with surrounding article prose.
    • Refined .glossary-card-def typography to clean, unbolded body styling (font-weight: 400, font-size: 0.84rem, line-height: 1.45), reducing card height by ~55% and reserving in-depth breakdowns exclusively for the Master Glossary reference page.
  • [Extension / Visual Layout] 2-Column Responsive Card Grid (_extensions/glossary/):
    • Replaced the full-width list with an ergonomic 2-column responsive card grid, reducing reading eye strain and balancing vertical line lengths.
    • Simplified symbols to clean, unboxed notation (($S_0$), ($S_n = \dots$)) baseline-aligned immediately adjacent to the term title.
    • Unified the persistent # mark and term title into a single clickable anchor link (.glossary-title-link), dramatically expanding the click target for term selection while keeping all body definitions selectable.
    • Embraced pure typography by removing decorative item icons, letting bold definition leads and nuanced directorial details flow naturally.
    • Anchored chapter trackbacks to the bottom of each card with multi-article hover tooltips.
    • Added CSS rules in glossary.css for light/dark theme contrast, card hover states, target anchor highlighting (:target), and responsive layout across mobile and desktop.
    • Added {{< glossary-entries >}} and {{< glossary-dictionary >}} shortcode aliases alongside {{< glossary-table >}} for backward compatibility.
  • [Documentation / Editorial] Streamlined Glossary Intro & Metadata (grammar/glossary.qmd):
    • Simplified document title to “Glossary” and subtitle to “A quick guide to framework terminology.”
    • Revamped introductory prose into a concise, anti-slop orientation paragraph describing terms as practical mental handles.
    • Removed outdated labels and restrictive source claims, relying on automated trackbacks and native Quarto sidebar navigation.
  • [Governance / Protocols] Protocol Updates on Git Diff Verification, Schema Grounding & Card UX (AGENTS.md):
    • Mandated full working-tree diff verification via git diff HEAD before formulating ready-to-copy commit messages.
    • Established strict schema field grounding rule (Section 6.7) prohibiting invented compound terminology.
    • Codified card and anchor UX invariants: unified heading links, selectable body prose, persistent left anchors, and pure typography.
    • Formulated Layer 0 hyperlink prohibition (Sections 5.2 and 5.7) preventing dead 404 links to unrendered governance documents in published HTML pages.

[0.2.0] - 2026-09-03

I. Framework & Theory (Auteur Script Specification)

Changed

  • [Theory / Framing] Grounding State Math as Thinking Notation & Latent Prior Fences (grammar/conceptual_model.qmd, index.qmd):
    • Re-anchored mathematical state formulation (\(S_n = f(S_{n-1} \mid \text{STAGING})\)) explicitly as the creator’s personal “thinking notation” and visual shorthand, rather than formal claims about AI neural network internals.
    • Reframed the model interaction model: generative video engines draw upon deeply learned physical and temporal priors from video datasets, where structured staging and coordinate fences collapse latent ambiguity rather than executing deterministic code.
    • Clarified the dual role of the chaining operator (->): sequential temporal progression across Macro-State lines vs. hierarchical multi-modal layering (camera \(\to\) action \(\to\) dialogue \(\to\) audio) resolving into synchronized beat intervals (\(\Delta t\)) within an execution line.
    • Re-anchored the diagnostic post-mortem as an empirical learning and evaluation feedback loop for building human directorial intuition and distinguishing prompt omission from latent variance.
    • Updated homepage status badge to “Open Research Notes & Practitioner Framework”.
  • [Layer 0 / Governance] Synchronizing North Star Intent & 7-Point Litmus Test (FRAMEWORK_INTENT.md, AGENTS.md):
    • Replaced legacy “reasoning layers” claims with learned visual, physical, and temporal priors absorbed from video training datasets.
    • Re-anchored [LOGIC] block definition from “The Reasoning Bridge” to “The Invariant Anchor” (anchoring persistent spatial invariants so learned priors maintain consistency).
    • Formalized the diagnostic post-mortem as an empirical learning and evaluation feedback loop for human creators.
    • Added Criterion 7 (“The Thinking Notation vs. Machine Reality Test”) to the concept litmus test and co-architect evaluation toolkit.
    • Enshrined the empirical diagnostic ledger in the author persona guidelines (§6.1).

II. Documentation Website (Quarto Platform & Extension)

Added

  • [Deployment / Domain] Persistent Custom Domain Configuration (CNAME, _quarto.yml):
    • Bound custom domain auteur-script.taruma.my.id via root CNAME file.
    • Registered CNAME in Quarto project resources so it persists into _site across automated GitHub Actions deployments.
    • Updated website.site-url to https://auteur-script.taruma.my.id for canonical SEO and metadata consistency.

Changed

  • [CI/CD / Deployment] Modern Artifact-Based GitHub Pages Deployment (.github/workflows/publish.yml):
    • Migrated publishing pipeline from legacy gh-pages Git branch commits (quarto-actions/publish@v2) to modern direct Pages deployment using actions/upload-pages-artifact@v3 and actions/deploy-pages@v4.
    • Tightened workflow permissions to least-privilege contents: read (removing contents: write), eliminating race conditions, worktree locks, and non-fast-forward push rejections.

[0.1.1] - 2026-09-03

I. Framework & Theory (Auteur Script Specification)

Changed

  • [Theory / State Math] Author-Verified Status Designation (grammar/conceptual_model.qmd):
    • Designated The Auteur Script Blueprint as an author-verified document with the ✅ title indicator.

II. Documentation Website (Quarto Platform & Extension)

Added

  • [Website / UX] Global Site-Wide Announcement Banner (_quarto.yml):
    • Implemented an above-navbar dismissable warning banner informing visitors of early experimental development and directing attention to author-verified documents marked with ✅.
    • Bound announcement dismissal ID to repository release versions (v0.1.1), ensuring banner resets automatically upon new release milestones.

[0.1.0] - 2026-09-03

I. Framework & Theory (Auteur Script Specification)

Added

  • [Theory / Philosophy] Human-Centric Pre-Visualization Thesis & North Star Anchor (grammar/conceptual_model.qmd):
    • Established Auteur Script as a cognitive pre-visualization scaffold for the human director to mentally simulate and direct the scene before clicking generate, meeting the generative model halfway rather than fighting for illusory pixel-level control.
    • Introduced the Film Crew Metaphor: the human creator establishes coordinates and physical boundaries in Staging and Execution, while the model’s visual planning layer calculates natural momentum and physical gap-filling.
    • Codified the Causal Beats vs. Artificial Timestamps principle: pacing transitions through causal state transformations (\(S_0 \mapsto S_1 \dots\)) matching human cognitive sequencing.
    • Defined the Dual Function: pre-generation mental staging scaffold and post-generation root-cause diagnostics (evaluating script ambiguity vs. stochastic AI variance).
  • [Theory / State Math] Mathematical State Equation (\(S_n = f(S_{n-1} \mid \text{STAGING})\)) (grammar/conceptual_model.qmd):
    • Formalized the core state equation defining \(S_n\) as a beat-state trajectory across duration \(\Delta t\), with \(\text{STAGING}\) operating as the global invariant conditioning baseline.
    • Articulated the intra-line Sub-State chaining operator (->) establishing multi-modal synchronization and causal priority (framing \(\to\) action \(\to\) dialogue \(\to\) audio) for model visual planning.
  • [Theory / Pillars] The 3 Core Pillars (Meta-Ontology) (grammar/conceptual_model.qmd, grammar/block_rules.md):
    • Organized all scene instructions across three cognitive layers: Intent (The “Why” & Directorial Rules), Aesthetic (The Physical World & Visual Anchor), and Execution (The Kinetic Flow & Timeline Progression).
  • [Theory / Phases] Two Production Phases Architecture (grammar/conceptual_model.qmd, grammar/block_rules.md):
    • Formalized Phase 1: STAGING (Pre-Production Setup): “Before shooting, we setup the stage first.” All invariant setup blocks ([INTENT], [LOGIC], [AESTHETIC], [OPENING]) establish the initial frame canvas (\(S_0\)) with zero kinetic progression.
    • Formalized Phase 2: EXECUTION (Kinetic Production / Rolling Camera): Active timeline blocks ([EXECUTION]) where sequential state transitions unfold (\(S_n = f(S_{n-1} \mid \text{STAGING})\)).
  • [Theory / Macroblocks] 5 Core Macro-Block Specifications (grammar/macroblocks/):
    • Authored dedicated 1-to-1 specifications for the foundational containers:
      • [INTENT]: High-level creative north star, subtext, and anti-bloat focus.
      • [LOGIC]: Reasoning bridge guiding model visual planning and priming upstream LLM token prediction.
      • [AESTHETIC]: Visual lookbook, wardrobe, lighting ratio, and invariant cinematic texture.
      • [OPENING]: Static first-frame visual anchor (\(S_0\)) with zero kinetic movement.
      • [EXECUTION]: Sequential, line-by-line kinetic state transitions (\(1\text{ line} = 1\text{ macro-state}\)).
    • Codified the Open Block Principle (\(B \in \mathcal{B}\)), allowing creators to declare custom macro containers for specialized pipelines.
    • Explicitly disambiguated Macro-Blocks (standalone container headers) from the spatial staging tag [BLOCK].
  • [Theory / Substates] 16 Single-Dimension Coordinate Tags (grammar/substates/):
    • Formalized the Single-Dimension Law: each sub-state tag governs strictly one isolated physical or optical dimension.
    • Authored dedicated coordinate specifications:
      • Core Triad: Camera Optics & Movement ([CAM]), Physical Performance & Micro-Anatomy ([ACT]), Foley & Diegetic Sound ([AUDIO]).
      • Spatial & Motion Coordinates: Spatial Staging ([BLOCK]), 180-Degree Line & Eyelines ([AXIS]), Optical Focus & DoF ([FOCUS]), Dynamic Lighting ([LIGHT]), Motion Speed ([SPEED]).
      • Production & Narrative Elements: Spoken Dialogue ([DIAL]), Musical Score ([MUSIC]), Prop State Machine ([PROP]), Crowd Density ([CROWD]), Environmental Physics ([ENV]), Visual FX ([VFX]), State Mutation ([STATE]), Transitions ([TRANS]), and Custom Protocols ([CUSTOM]).
  • [Theory / Audit Engine] Dedicated Script Supervisor Audit Engine (grammar/script_supervisor_audit.md):
    • 4 Scene Topologies: Context-aware continuity rules for Continuous Real-Time, Parallel Cross-Cutting / Intercut, Discontinuous Montage / Trailer, and Spatial Journey / Portal.
    • 5 Script Supervisor Audit Lenses: Rigorous verification covering Spatial & Axis, Temporal & State Progression, Prop & Inventory State Machine, Acoustic & Dialogue Architecture, and Block & Grammar Orthogonality.
    • Pre-Flight State Ledger: Mental pre-visualization staging protocol for LLMs before line-by-line token generation.
    • Automated Directorial Repair Recipes: Deterministic self-correction formulas for axis violations, ghost props, lookbook bleeding, and AI morphing risks.
  • [Theory / Modules] Production Modules Architecture (modules/):
  • [Theory / Glossary] Master Framework Glossary Hub (grammar/glossary.qmd):
    • Authored a standalone glossary organizing 25+ framework terms into 4 functional domains (Foundations & Pillars, Structural Units, Directorial Laws, Extensibility & Protocols) with cross-references to theoretical definitions.
  • [Theory / Reference Gallery] Directorial Reference Gallery (scripts/):
  • [Theory / Workflows] Directorial Workflows & Script Density Profiles (grammar/directorial_workflows.md):
    • Codified formal directorial workflows, script density profiles (Full, Concise, Tagless, Audit), and pipeline integration standards.

II. Documentation Website (Quarto Platform & Extension)

Added

  • [Extension / Lua] Auteur Script Visual Renderer (_extensions/auteur/):
    • Pandoc / Quarto Lua Filter (_extensions/auteur/auteur.lua): Converts raw ```{.auteur} code blocks into visual shooting boards with interactive Bootstrap 5 Staging modals ([INTENT], [LOGIC], [AESTHETIC], [OPENING]), optional centered scene titles with rules, and dashed waterfall Execution shot cards (\(1\text{ line} = 1\text{ macro-state card}\)).
    • Interactive Plain / Visual Script Toggle: Built-in floating action button (<i class="bi bi-code-slash"></i>) allowing instant client-side switching between the interactive Visual Canvas and the raw Plain Script across all ```auteur blocks.
    • Visual Design Tokens (_extensions/auteur/auteur.css): Capsule badge pills, dashed shot cards, bold [TAG] coordinate formatting, blue character entity highlight (.auteur-char) scoped to explicit @ref as <label> staging declarations, and copy-script toolbar with light/dark theme parity.
  • [Site / Portal] Comprehensive Documentation Portal (Quarto):
    • 5 Structured Section Landing Hubs: Authored uniform Quarto overview documents across all 5 sections (grammar/overview.qmd, grammar/macroblocks/overview.qmd, grammar/substates/overview.qmd, modules/overview.qmd, and scripts/overview.qmd) with architecture maps and chapter roadmaps.
    • Posit Brand System Integration (_brand.yml, custom.css): Established cinematic color palette (Sapphire blue #3b82f6, Amber gold #f59e0b, Emerald, Slate), Google Fonts typography (Inter, JetBrains Mono), and dual light (cosmo + brand) and dark (darkly + brand) theme layering.
    • Mobile-Responsive Architecture: Optimized viewport layouts with touch-scrolling (overflow-x: auto) for MathJax/KaTeX display containers and normalized grid vertical rhythm.
  • [Site / Showcase] Homepage Production Exhibit Showcase (index.qmd):
    • Interactive specification homepage featuring a curated narrative roadmap, responsive .workflow-pipeline visual banners, and live production exhibits with native Quarto video playback, floating model indicator badges (Seedance 2.0 / Seedance 2.5), and Dreamina platform links.
Back to top