AutoMovie API
    Preparing search index...

    Interface IAutoMovieAuthoringDiagnostic

    One actionable failure at the public authoring boundary, as compileDefinedShot reports it in a failed IAutoMovieCompiledDefinedShot.

    Every diagnostic states the observed fact, why it blocks a trustworthy shot artifact, and the concrete correction. All diagnostics of one failure come from the first phase that failed, so a correction round never mixes a stage error with performance errors computed on a broken stage.

    interface IAutoMovieAuthoringDiagnostic {
        code:
            | "registration-invalid"
            | "builder-failed"
            | "contract-mismatch"
            | "contract-realization-failed"
            | "stage-invalid"
            | "blocking-invalid"
            | "performance-invalid"
            | "pipeline-failed";
        fact: string;
        impact: string;
        path: string;
        phase: | "registration"
        | "continuity"
        | "build"
        | "stage"
        | "blocking"
        | "performance"
        | "contract";
        recovery: string;
        violation?: IAutoMovieConstraintViolation;
    }
    Index
    code:
        | "registration-invalid"
        | "builder-failed"
        | "contract-mismatch"
        | "contract-realization-failed"
        | "stage-invalid"
        | "blocking-invalid"
        | "performance-invalid"
        | "pipeline-failed"

    Stable machine-readable category: registration-invalid in registration, builder-failed in build, contract-mismatch in build or performance, contract-realization-failed in contract, stage-invalid, blocking-invalid and performance-invalid in their own phases, and pipeline-failed for an unexpected exception in any phase.

    fact: string

    What was observed, including the offending identity or value.

    impact: string

    Why the failure prevents a trustworthy shot artifact.

    path: string

    Exact source or generated field that failed, such as a violation path, or $<phase> when an exception has no narrower field.

    phase:
        | "registration"
        | "continuity"
        | "build"
        | "stage"
        | "blocking"
        | "performance"
        | "contract"

    Pipeline phase that owns the correction.

    recovery: string

    Concrete source edit or input correction that permits the next attempt.

    Original domain violation, present for stage-invalid, blocking-invalid and performance-invalid; absent when no lower engine gate produced one.