Generate Lectures And Render

• outline_path (required)
• --physician ID (optional)
• --course ID (optional)
• --dry-run, --start N, --end N, --materials PATH, --no-llm-parser (pass to generator)

Step 1.2: Prompt for Missing Info

If --physician not provided, ask:

What is the physician ID? (e.g., dr-john-smith)

If --course not provided, ask:

What is the course ID? (e.g., metabolic-health)

Step 1.3: Check Registry

Read the registry file:

content/physician-courses/registry.ts

Check if physician ID exists in physicianRegistry.

Step 1.4: Handle New vs Existing Physician

If NEW physician, collect metadata:

• Physician name (e.g., "Dr. John Smith")
• Credentials (e.g., "MD", "MD, PhD")
• Specialty (e.g., "Metabolic Medicine")
• Bio (optional, one sentence)

If EXISTING physician, check if course exists:

• If course exists: will add lectures to existing course
• If course is new: collect course title and description

Step 1.5: Collect Course Info (if new course)

Ask for:

• Course title (e.g., "Advanced Cardiovascular Therapies")
• Course description (one sentence)

Step 1.6: Show Execution Plan

Display summary:

PHYSICIAN: dr-john-smith (New/Existing)
COURSE: metabolic-health (New/Existing)
OUTLINE: path/to/outline.md
LECTURES: N found in outline
OUTPUT: content/physician-courses/dr-john-smith/metabolic-health/

Proceed with generation? [Y/n]

Phase 2: Generation

Step 2.1: Run the Generator

Execute the Python runner (same as /generate-lectures):

python3 "/Users/anantvinjamoori/Vectorshift Pipelines/cli/iterative_lecture_runner.py" \
    "{outline_path}" \
    {--dry-run if specified} \
    {--start N if specified} \
    {--end N if specified} \
    {--materials PATH if specified} \
    {--no-llm-parser if specified}

Step 2.2: Monitor Progress

The runner will:

1. Parse outline to find lectures
2. Match materials to PDFs
3. Submit async jobs to VectorShift
4. Poll for results (5-sec intervals, max 30 min per lecture)
5. Save outputs to outputs/{course_name}/

Output files per lecture:

• lecture_N_slides.json - The JSON we need
• lecture_N_transcript.md
• lecture_N_blueprint.md
• lecture_N_research_dossier.md
• lecture_N_kb_context.md

Phase 3: Copy and Register

After generation completes (or for each successful lecture), perform these steps:

Step 3.1: Create Target Directory

mkdir -p "content/physician-courses/{physician}/{course}"

Example:

mkdir -p "content/physician-courses/dr-john-smith/metabolic-health"

Step 3.2: Copy and Rename JSON Files

For each generated lecture:

cp "outputs/{course_name}/lecture_N_slides.json" \
   "content/physician-courses/{physician}/{course}/lecture-N.json"

Example:

cp "outputs/Metabolic_Health/lecture_1_slides.json" \
   "content/physician-courses/dr-john-smith/metabolic-health/lecture-1.json"

Step 3.3: Read Lecture Titles from JSON

For each copied JSON file, read the title field for registry entry.

Step 3.4: Update Registry

Edit content/physician-courses/registry.ts:

A. Add Import Statements

Insert after existing imports (after line ~10):

import drSmithMetabolicLecture1 from './dr-john-smith/metabolic-health/lecture-1.json';
import drSmithMetabolicLecture2 from './dr-john-smith/metabolic-health/lecture-2.json';

Import naming convention: dr{LastName}{CourseShort}Lecture{N}

• Extract last name from physician ID: dr-john-smith → Smith
• Shorten course ID: metabolic-health → Metabolic
• Add lecture number: Lecture1, Lecture2, etc.

B. Add/Update Physician Entry

For NEW physician, add before the closing }; of physicianRegistry:

  'dr-john-smith': {
    physician: {
      id: 'dr-john-smith',
      name: 'Dr. John Smith',
      credentials: 'MD',
      specialty: 'Metabolic Medicine',
    },
    courses: [
      {
        id: 'metabolic-health',
        title: 'Metabolic Health Fundamentals',
        description: 'A comprehensive course on metabolic optimization.',
        status: 'preview',
        lectures: [
          {
            id: 'lecture-1',
            title: 'Introduction to Metabolic Health',
            order: 1,
            lecture: drSmithMetabolicLecture1 as Lecture,
          },
          {
            id: 'lecture-2',
            title: 'Metabolic Pathways',
            order: 2,
            lecture: drSmithMetabolicLecture2 as Lecture,
          },
        ],
      },
    ],
  },

For EXISTING physician with NEW course, add to their courses array:

      {
        id: 'new-course-id',
        title: 'New Course Title',
        description: 'Course description.',
        status: 'preview',
        lectures: [
          { id: 'lecture-1', title: 'Lecture 1 Title', order: 1, lecture: importVar as Lecture },
        ],
      },

For EXISTING course, add to the lectures array:

          {
            id: 'lecture-3',
            title: 'New Lecture Title',
            order: 3,
            lecture: drSmithMetabolicLecture3 as Lecture,
          },

Phase 4: Render and Review

Step 4.1: Construct Preview URLs

URL pattern: