Continuity Director is an installable ComfyUI custom-node package for repeatable AI video production. It converts project rules, identity constraints, scenes, shots, references, quality metrics, execution dependencies, approvals, retry plans, checkpoints, environment records, and export state into structured, traceable production data.

Important

Continuity Director does not replace a video model and cannot guarantee pixel-perfect identity. It controls production inputs and decisions so drift, failed handoffs, and inconsistent runs can be detected and corrected systematically.

Why Continuity Director

Production problem	Continuity Director response
Character or wardrobe drift	Explicit character locks, reference records, and continuity comparison
Inconsistent shots	Scene and shot locks with deterministic manifests
Too many uncontrolled generations	Storyboard-to-Take expansion, quality gates, and weighted ranking
Failed long-running batches	Dependency-safe execution waves, retry policy, and resumable checkpoints
Difficult collaboration	Audit events, revision-safe three-way merge, and portable packages
Non-reproducible environments	Runtime environment locks, integrity hashes, and idempotency keys
Unclear production state	Native dashboard, reliability sidebar, and structured JSON outputs

At a glance

Capability	Included in v0.8.20
ComfyUI nodes	20 registered nodes across 7 production stages
Interface	Native production dashboard and reliability sidebar
Languages	English, Simplified Chinese, and bilingual display modes
Workflow acceleration	One-click connected starter chain
Reliability	Hash verification, schema migration, retry policy, checkpoints, and environment locks
Validation	Python 3.10–3.12 CI, lifecycle smoke tests, unit tests, frontend tests, and ZIP validation
Runtime dependencies	No mandatory third-party Python packages

Production workflow

flowchart LR
    A[Project / Character / Scene Locks] --> B[Shot Lock]
    B --> C[Manifest Builder]
    C --> D[Batch Director]
    D --> E[Execution Plan]
    E --> F[Quality Gate / Take Ranker]
    F --> G[Audit / Merge]
    G --> H[Verified Export Package]

    R[Reference Handoff] --> D
    V[Retry / Checkpoint / Environment Lock] --> E
    Q[Continuity Report] --> F

The dashboard action Add starter chain inserts and connects the primary production path automatically.

Node map

Continuity locks — 5 nodes

Node	Purpose
`CDProjectLock`	Project title, aspect ratio, FPS, language, and production notes
`CDCharacterLock`	Appearance, wardrobe, prohibited changes, references, and identity seed
`CDSceneLock`	Location, time, lighting, palette, and environment state
`CDShotLock`	Prompt, camera, duration, seed, and continuity context
`CDManifestBuilder`	Portable deterministic production manifest

Directing — 2 nodes

Node	Purpose
`CDBatchDirector`	Expand storyboard JSON into deterministic Take variants
`CDReferenceHandoff`	Record reference transfer between adjacent shots

Quality — 3 nodes

Node	Purpose
`CDQualityGate`	Evaluate metrics against declared thresholds
`CDTakeRanker`	Rank Takes with deterministic weighted scoring
`CDContinuityReport`	Compare JSON state and report exact changed paths

Runtime, collaboration, and export — 4 nodes

Node	Purpose
`CDExecutionPlan`	Build dependency-safe parallel execution waves
`CDAuditEvent`	Append a hash-linked production audit event
`CDThreeWayMerge`	Merge revisions and report exact conflict paths
`CDExportPackage`	Produce a hashed portable production package

Reliability — 6 nodes

Node	Purpose
`CDVerifyPackage`	Verify package integrity without executing imported data
`CDMigratePayload`	Update schema version markers and regenerate hashes
`CDRetryPolicy`	Create a bounded deterministic retry schedule
`CDQueueCheckpoint`	Record completed, failed, and remaining tasks
`CDIdempotencyKey`	Generate stable keys for duplicate-request detection
`CDEnvironmentLock`	Record ComfyUI, frontend, Python, platform, and model environment

Installation

From ComfyUI/custom_nodes:

git clone https://github.com/xinjian0101/continuity-director.git ComfyUI-ContinuityDirector

Restart ComfyUI, then search for node names beginning with CD · or open the Continuity Director sidebar.

Update an existing installation

cd ComfyUI/custom_nodes/ComfyUI-ContinuityDirector
git pull

Build an installable ZIP

python scripts/build_release.py

The archive is created at dist/continuity-director-v0.8.20.zip.

First production run

Open the Continuity Director sidebar.
Select English, 中文, or bilingual mode.
Click Add starter chain.
Configure Project, Character, Scene, and Shot locks.
Build a manifest and provide storyboard JSON to Batch Director.
Generate an execution plan.
Apply quality and reliability nodes before exporting the package.

Example input files are available in examples/.

Validation

Run the same core checks used by GitHub Actions:

python -m compileall -q .
python scripts/smoke_import.py
PYTHONPATH=tests python -m unittest discover -s tests -p "test_*.py"
python scripts/validate_release.py
python scripts/build_release.py --check
node tests/frontend_smoke.mjs
node tests/reliability_frontend_smoke.mjs

Documentation

Document	Purpose
Documentation hub	Entry point for users and contributors
Architecture	Modules, data flow, and execution boundaries
Interface rules	Dashboard behavior and localization requirements
Contributing	Development workflow and pull-request checklist
Security policy	Supported versions and vulnerability reporting
Support	Installation and troubleshooting guidance
Changelog	Release history

Repository structure

continuity-director/
├── nodes.py                    # Core ComfyUI nodes
├── extended_nodes.py           # Reliability nodes
├── environment_nodes.py        # Environment lock node
├── *_core.py                   # Deterministic data and execution logic
├── js/                         # Dashboard, reliability sidebar, styles, and help pages
├── examples/                   # Starter production inputs
├── tests/                      # Backend and frontend regression tests
├── scripts/                    # Validation and release builders
├── docs/                       # Architecture and interface documentation
└── .github/                    # CI and contribution templates

Compatibility and security

Python 3.10–3.12 is tested in CI.
Imported JSON is treated as declarative data and is not executed.
Production packages must not contain API keys or credentials.
Integrity hashes detect changes; they are not an access-control mechanism.
External models, operating systems, ComfyUI installations, and third-party nodes remain separate trust boundaries.

Contributing

Bug reports, workflow compatibility reports, documentation fixes, and focused feature proposals are welcome. Start with the contributing guide and use the structured issue forms.

License

Released under the MIT License.

README.md Unescape Escape

Continuity Director