@vltrn/cut-lab

The Cut Lab — 10-specialist AI content editing department, packaged as a standalone npm module.

Specialists

| Agent | Role | |-------|------| | CUTMASTER-V (Lead) | Editorial strategy, pacing, oversight | | HOOK-V | First 3 seconds, scrollback optimization | | BLADE-V | Clip assembly, B-roll, cut timing | | PIXEL-V | Thumbnail design, visual optimization | | MOTION-V | Kinetic typography, motion graphics | | SONIC-V | Sound design, SFX, audio engineering | | DEPLOY-V | Distribution, platform optimization | | FLUX-V | Transitions, speed ramps, effect chains | | TEMPO-V | Pacing, text sync, caption timing | | CHROMA-V | Color grading, LUTs, color psychology |

Install

npm install @vltrn/cut-lab
# or
bun add @vltrn/cut-lab

Requires Bun runtime (auto-installed via postinstall).

CLI Usage

# Pipeline management (standalone SQLite at ~/.cut-lab/cut-lab.db)
cut-lab pipeline list
cut-lab pipeline create "My TikTok Edit" --type tiktok
cut-lab pipeline advance <id>
cut-lab pipeline note <id> --stage draft --note "Hook needs more energy"

# Knowledge corpus (15 modules, 95 drills)
cut-lab lexicon list
cut-lab lexicon search "hook trinity"
cut-lab lexicon topic hooks
cut-lab drills

# Team info
cut-lab team
cut-lab roles

NEO Plugin Mode

import { CUT_LAB_TOOLS, initCutLabTools } from '@vltrn/cut-lab';

// Initialize with NEO vault backend
await initCutLabTools({ neo_vault: true });

// Register tools into NEO's registry
for (const tool of CUT_LAB_TOOLS) {
  toolRegistry.register(tool);
}
registerExtensionTools(CUT_LAB_TOOLS);

Programmatic API

import {
  detectsCutLab,        // Auto-routing detection (42 patterns)
  CUT_LAB_TEAM,         // Team metadata
  ROLES_DIR,            // Path to specialist YAMLs
  LEXICON_DIR,          // Path to knowledge corpus
  PipelineStore,        // Direct SQLite CRUD
  contentPipelineTool,  // Tool definition
  contentLexiconTool,   // Tool definition
} from '@vltrn/cut-lab';

// Detection
detectsCutLab("edit this video with speed ramps"); // true

// Direct store access
const item = PipelineStore.createContent("Hook Test", { content_type: 'tiktok' });
PipelineStore.advanceStage(item.id);

Knowledge Corpus

15 modules in lexicon/:

• Editing Theory, Hook Mastery, Visual Storytelling
• Sound Design, Thumbnail Optimization, Platform Specs
• Tool Stack, Brand Consistency, Analytics & Iteration
• Playbooks, Transitions & Effects, Unicorn Architecture
• AI Force Multiplier, Kinetic Typography, Color Grading, Render QA

Plus: Training Curriculum, 4-tier Certification, 95 Drills (general + Flux/Tempo/Chroma/Render QA).

License

MIT