coursecode 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Seth Vincent
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,322 @@
+# CourseCode
+
+**A modern framework for building interactive e-learning courses with AI-assisted authoring.**
+
+Drop in your existing PDFs, Word docs, or PowerPoints — AI converts them into complete, interactive courses. No vendor lock-in, no subscriptions. Your content, your code, deployed to any LMS.
+
+## Features
+
+- 🔌 **MCP integration**: AI connects directly to your course — previews, screenshots, linting, and testing without manual file sharing
+- 🎓 **Full LMS integration**: SCORM 1.2, SCORM 2004, cmi5, and LTI with complete tracking records
+- 🤖 **AI-ready authoring**: Structured guides and MCP tools for AI-assisted course development
+- 🧩 **Rich UI components**: Images, video, accordions, tabs, and custom sandboxed HTML/JS embeds
+- 🎯 **Rich interactions**: Multiple choice, drag-drop, fill-in-the-blank, matching, sequencing, and more
+- ♿ **Fully accessible**: WCAG 2.1 AA compliant with dark mode, high contrast, and reduced motion
+- 🔊 **TTS audio narration**: Built-in player with AI text-to-speech generation (ElevenLabs, Deepgram, Google, BYO API Key)
+- 📊 **Smart tracking**: Engagement requirements, learning objectives, and progress persistence
+- 🎨 **Themeable design**: CSS custom properties for easy brand customization
+- 🔗 **Custom endpoints**: Optional webhooks for error reporting and learning record storage
+- 📥 **Drop-in content conversion**: Feed existing PDFs, Word docs, or PowerPoint files to AI and get a complete, interactive course
+- 🖥️ **Live preview**: Visual editing, status dashboard, config panels, catalog browser, and full LMS simulation with debug tools
+
+---
+
+## Installation
+
+### Required
+
+Install [Node.js](https://nodejs.org/) (v18 or later), then run:
+
+```bash
+npm install -g coursecode
+```
+
+### Recommended
+
+- A code or text editor — [VS Code](https://code.visualstudio.com/), [Cursor](https://cursor.com/), or similar
+- An AI coding assistant with MCP support — [Claude Code](https://claude.ai/code), [Cursor](https://cursor.com/), [Windsurf](https://codeium.com/windsurf), etc.
+- [GitHub Desktop](https://desktop.github.com/) for version control
+
+---
+
+## Quick Start
+
+```bash
+
+# Create a new course project
+coursecode create my-course
+cd my-course
+
+# Start the preview server
+coursecode preview
+```
+
+Open `http://localhost:4173` to view and edit your course.
+
+The example course included with every new project is a complete guide to using CourseCode.
+
+📖 **New to CourseCode?** Read the [User Guide](framework/docs/USER_GUIDE.md) for step-by-step instructions.
+
+---
+
+## MCP Integration
+
+CourseCode includes a built-in [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server. When your AI tool supports MCP, it connects directly to your course project — no manual file sharing needed.
+
+```bash
+coursecode mcp
+```
+
+With MCP, your AI can:
+- **Preview and screenshot** slides to verify layout and design
+- **Lint its own code** and catch errors automatically
+- **Navigate and test** interactions directly
+- **Browse the component catalog** to discover available UI elements
+- **Read course state** including engagement, scoring, and LMS data
+
+See the [User Guide](framework/docs/USER_GUIDE.md#mcp-model-context-protocol) for setup instructions.
+
+---
+
+## The Course Directory
+
+All your course content lives in the `course/` folder:
+
+```
+my-course/
+├── course/                     # ← Your content goes here
+│   ├── course-config.js        # Course structure, format, objectives, settings
+│   ├── slides/                 # Slide content files
+│   │   ├── intro.js
+│   │   ├── content-01.js
+│   │   └── assessment.js
+│   ├── assets/                 # Images, audio, video
+│   │   ├── images/
+│   │   └── audio/
+│   ├── theme.css               # Brand customization
+
+├── framework/                  # Framework code (don't edit)
+│   └── docs/                   # Guides and templates
+```
+
+### Your Course
+
+| Location | What's There |
+|----------|--------------|
+| `course/course-config.js` | Course settings — structure, objectives, navigation rules |
+| `course/slides/` | Your slide content (one file per slide) |
+| `course/theme.css` | Brand colors and typography |
+| `course/assets/` | Images, audio, and video files |
+
+### Key Documentation
+
+All guides are in `framework/docs/`:
+
+| Document | Audience | Purpose |
+|----------|----------|---------|
+| `README.md` | Humans | Project overview and getting started |
+| `USER_GUIDE.md` | Humans | Complete guide — workflows, features, deployment |
+| `COURSE_AUTHORING_GUIDE.md` | AI Agents | Slide authoring, interactions, CSS styling |
+| `COURSE_OUTLINE_GUIDE.md` | AI Agents | How to write effective course outlines |
+| `COURSE_OUTLINE_TEMPLATE.md` | AI Agents | Blank template to start an outline |
+| `FRAMEWORK_GUIDE.md` | AI Agents | Framework internals (advanced) |
+
+---
+
+## AI-Driven Authoring Workflow
+
+Four steps to go from source materials to a deployed course.
+
+### Step 1: Convert Your Source Materials
+
+Place existing content (PDFs, Word docs, PowerPoints) in `course/references/`, then run:
+
+```bash
+coursecode convert
+```
+
+Converts to markdown in `course/references/converted/`. Skip this step if starting from scratch.
+
+### Step 2: Create Your Course Outline
+
+Ask your AI to create a course outline based on your content.
+
+- **With MCP**: The AI reads your references and outline template automatically
+- **Without MCP**: Share your converted docs, `COURSE_OUTLINE_TEMPLATE.md`, and `COURSE_OUTLINE_GUIDE.md` with your AI
+
+Review and refine the outline before building.
+
+### Step 3: Build the Course
+
+Ask your AI to build slides from your approved outline.
+
+- **With MCP**: The AI reads all docs, lints its code, and screenshots slides to verify
+- **Without MCP**: Share your outline and `COURSE_AUTHORING_GUIDE.md` with your AI
+
+### Step 4: Preview, Iterate, and Deploy
+
+```bash
+coursecode preview
+```
+
+The preview server provides:
+- **Live reload**: Changes appear instantly
+- **Visual editing**: Click elements to edit content directly
+- **Status dashboard**: Course health, errors, and build status at a glance
+- **Config panels**: Adjust settings, interactions, and assessments
+- **Component catalog**: Browse available UI elements with live previews
+- **Debug tools**: Inspect LMS state, test interactions, verify tracking
+
+When ready, build and deploy:
+
+```bash
+coursecode build
+```
+
+This creates a ZIP package ready for upload to any LMS.
+
+**Share for review:** Export a standalone preview for stakeholders:
+
+```bash
+coursecode preview --export
+```
+
+Deploy to GitHub Pages, Netlify, or any static host. Optional password protection keeps content secure.
+
+---
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `coursecode create <name>` | Create a new course project |
+| `coursecode preview` | Preview your course locally |
+| `coursecode build` | Build course package (ZIP for LMS upload) |
+| `coursecode build --format scorm1.2` | Build for specific LMS format |
+| `coursecode mcp` | Start the MCP server for AI integration |
+| `coursecode narration` | Generate audio narration from text |
+| `coursecode convert` | Convert PDFs, Word, PowerPoint to markdown |
+| `coursecode upgrade` | Upgrade to latest version |
+
+### Output Format Options
+
+```bash
+coursecode build --format cmi5       # cmi5/xAPI (default, recommended)
+coursecode build --format scorm2004  # SCORM 2004 4th Edition
+coursecode build --format scorm1.2   # SCORM 1.2 (widest LMS support)
+coursecode build --format lti        # LTI 1.3
+```
+
+---
+
+## UI Components
+
+Build engaging slides with interactive elements. No coding required — your AI assistant handles the implementation.
+
+### Media & Widgets
+
+| Component | Description |
+|-----------|-------------|
+| Tabs | Switch between content panels |
+| Accordion | Expandable/collapsible sections |
+| Flip Cards | Reveal content on click |
+| Carousel | Swipe through slides |
+| Modal | Pop-up detail views |
+| Interactive Timeline | Clickable timeline events |
+| Interactive Image | Hotspots on images |
+| Embed Frame | Sandboxed HTML/JS content |
+| Audio Player | Narration with controls |
+| Video Player | Native, YouTube, or Vimeo |
+
+### Slide Templates
+
+Pre-designed layouts for common slide types. Just tell your AI assistant what you need.
+
+| Template | Use Case |
+|----------|----------|
+| Intro Cards | Overview slide with key points below |
+| Steps | Sequential instructions (numbered) |
+| Features | Highlight 3-4 key capabilities |
+| Comparison | Side-by-side options |
+| Stats | Metrics and numbers with impact |
+| Content + Image | Text alongside diagrams |
+| Hero | Full-width intro with call-to-action |
+| Timeline | Chronological events |
+| Quote | Testimonials and citations |
+| Checklist | Task lists and requirements |
+
+---
+
+## Interaction Types
+
+Practice activities that engage learners and check understanding.
+
+| Type | Description |
+|------|-------------|
+| Multiple Choice | Select one or more correct answers |
+| True/False | Simple yes/no questions |
+| Fill-in-the-Blank | Enter missing text (supports typo tolerance) |
+| Matching | Connect related items |
+| Drag-and-Drop | Sort items into categories |
+| Sequencing | Arrange items in correct order |
+| Numeric | Enter numbers (exact or range) |
+| Hotspot | Click correct areas on an image |
+| Likert Scale | Rating scales for surveys |
+
+All interactions provide immediate feedback and can be required for slide completion.
+
+---
+
+## Tracking & Scoring
+
+### Engagement
+
+Require learners to complete activities before advancing:
+- View all tabs or accordion panels
+- Complete interactions
+- Watch video or listen to audio
+- Spend minimum time on slide
+
+### Gating
+
+Lock slides until conditions are met:
+- Complete previous slides
+- Pass an assessment
+- Achieve a learning objective
+
+### Assessments
+
+Graded quizzes that determine course completion:
+- Randomized question order
+- Question banks for variety
+- Configurable passing scores
+- Retry attempts with remediation
+- Scores reported to your LMS
+
+### Learning Objectives
+
+Track learner progress against defined goals:
+- Automatic: track when slides are visited
+- Linked: tie objectives to assessment scores
+- Reported: completion status sent to LMS
+
+---
+
+## Learn More
+
+The [User Guide](framework/docs/USER_GUIDE.md) covers everything in detail:
+
+- Using the preview and visual editing tools
+- All interaction types (multiple choice, drag-drop, matching, and more)
+- Assessments and grading
+- Audio and video
+- Theming and branding
+- Navigation and learner flow control
+- Deployment options
+- Troubleshooting
+
+---
+
+## License
+
+MIT © Seth Vincent

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,22 @@
+# Third-Party Notices
+
+This project includes third-party components and standards artifacts.
+
+## pipwerks SCORM Wrapper
+
+- Path: `framework/js/vendor/pipwerks.js`
+- Upstream: https://github.com/pipwerks/scorm-api-wrapper
+- License: MIT-style (as stated in the file header)
+
+## IEEE LOM / SCORM Schema Files
+
+- Path: `schemas/` and `schemas/common/`
+- Notes: Several schema files include embedded attribution text referencing
+  Creative Commons Attribution-ShareAlike.
+- Local license reference file: `schemas/license.txt`
+- License URL: https://creativecommons.org/licenses/by-sa/1.0/legalcode
+
+## Project License
+
+- This project’s primary license is MIT.
+- See: `LICENSE`

package/bin/cli.js

@@ -0,0 +1,331 @@
+#!/usr/bin/env node
+
+/**
+ * CourseCode CLI
+ * 
+ * Commands:
+ *   coursecode create <name>  - Create a new course project
+ *   coursecode dev            - Start development server
+ *   coursecode build          - Build course package
+ *   coursecode upgrade        - Upgrade framework in current project
+ *   coursecode clean          - Remove example files from project
+ *   coursecode new <type>     - Create new slide, assessment, or config
+ *   coursecode test-errors    - Test error reporting configuration
+ *   coursecode test-data      - Test data reporting configuration
+ *   coursecode --version      - Show version
+ */
+
+import { Command } from 'commander';
+import { fileURLToPath } from 'url';
+import path from 'path';
+import fs from 'fs';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const packageJson = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf-8'));
+
+const program = new Command();
+
+program
+  .name('coursecode')
+  .description('Multi-format course authoring framework CLI')
+  .version(packageJson.version);
+
+// Create command
+program
+  .command('create <name>')
+  .description('Create a new course project')
+  .option('--blank', 'Create without example slides (clean starter)')
+  .option('--no-install', 'Skip npm install')
+  .action(async (name, options) => {
+    const { create } = await import('../lib/create.js');
+    await create(name, options);
+  });
+
+// Dev command
+program
+  .command('dev')
+  .description('Start development server with hot reload')
+  .option('-p, --port <port>', 'Port to run on', '5173')
+  .option('-f, --format <format>', 'LMS format: scorm2004, scorm1.2, cmi5, lti, scorm1.2-proxy, scorm2004-proxy, or cmi5-remote')
+  .action(async (options) => {
+    const { dev } = await import('../lib/dev.js');
+    await dev(options);
+  });
+
+// Build command
+program
+  .command('build')
+  .description('Build course package for LMS deployment')
+  .option('--no-zip', 'Skip ZIP archive creation')
+  .option('--no-lint', 'Skip linting')
+  .option('-f, --format <format>', 'LMS format: scorm2004, scorm1.2, cmi5, lti, scorm1.2-proxy, scorm2004-proxy, or cmi5-remote')
+  .action(async (options) => {
+    const { build } = await import('../lib/build.js');
+    await build(options);
+  });
+
+// Lint command
+program
+  .command('lint')
+  .description('Validate course configuration and structure')
+  .option('--course-path <path>', 'Path to course directory (default: ./course)', './course')
+  .option('-v, --verbose', 'Show detailed error output')
+  .action(async (options) => {
+    const { lint } = await import('../lib/build-linter.js');
+    await lint(options);
+  });
+
+// Upgrade command
+program
+  .command('upgrade')
+  .description('Upgrade framework in current project to latest version')
+  .option('-f, --force', 'Force upgrade even if versions match')
+  .option('-c, --configs', 'Also update vite.config.js and eslint.config.js (creates backups)')
+  .option('--dry-run', 'Show what would be changed without making changes')
+  .action(async (options) => {
+    const { upgrade } = await import('../lib/upgrade.js');
+    await upgrade(options);
+  });
+
+// Narration command
+program
+  .command('narration')
+  .description('Generate audio narration from text using ElevenLabs')
+  .option('-f, --force', 'Regenerate all narration (ignore cache)')
+  .option('-s, --slide <id>', 'Generate narration for a specific slide only')
+  .option('--dry-run', 'Preview what would be generated')
+  .action(async (options) => {
+    const { narration } = await import('../lib/narration.js');
+    await narration(options);
+  });
+
+// Export content command
+program
+  .command('export-content')
+  .description('Export course content to Markdown or JSON for review/localization. Extracts: headers, tabs, accordions, callouts, cards, flip-cards, tables, pattern layouts, and all interaction types.')
+  .option('-o, --output <file>', 'Output file path (defaults to stdout)')
+  .option('--no-answers', 'Exclude correct answers for interactions (included by default)')
+  .option('--no-feedback', 'Exclude feedback text (included by default)')
+  .option('--no-interactions', 'Exclude interactions and assessment questions from output')
+  .option('--include-narration', 'Include narration transcripts')
+  .option('--interactions-only', 'Export only interactions and assessment questions (no slide content)')
+  .option('--slides <ids>', 'Comma-separated slide IDs to export')
+  .option('--format <type>', 'Output format: md or json (default: md)', 'md')
+  .option('--course-path <path>', 'Path to course directory (default: ./course)', './course')
+  .option('--include-anchors', 'Include HTML anchor tags for internal linking (used by preview content viewer)')
+  .action(async (options) => {
+    const { exportContent } = await import('../lib/export-content.js');
+    // Commander uses --no-X pattern: answers defaults to true, --no-answers sets it to false
+    const exportOptions = {
+      ...options,
+      includeAnswers: options.answers !== false,
+      includeFeedback: options.feedback !== false,
+      excludeInteractions: options.interactions === false,
+      includeAnchors: options.includeAnchors === true ? true : undefined,
+    };
+    await exportContent(exportOptions);
+  });
+
+// Convert command
+program
+  .command('convert [source]')
+  .description('Convert docx, pptx, and pdf files to markdown for course authoring')
+  .option('-o, --output <dir>', 'Output directory for converted files', './course/references/converted')
+  .option('-f, --format <type>', 'Limit to format: docx, pptx, pdf, or all', 'all')
+  .option('--dry-run', 'Show what would be converted without writing files')
+  .option('--overwrite', 'Overwrite existing markdown files')
+  .option('--flatten', 'Output all files to single directory (no subdirs)')
+  .action(async (source = './course/references', options) => {
+    const { convert } = await import('../lib/convert.js');
+    await convert(source, options);
+  });
+
+// Import command - PowerPoint to presentation course
+program
+  .command('import <source>')
+  .description('Import a PowerPoint file as a presentation course')
+  .option('-n, --name <name>', 'Project name (default: derived from filename)')
+  .option('--slides-dir <dir>', 'Use pre-exported slide images from this directory (skips PowerPoint)')
+  .option('--no-install', 'Skip npm install')
+  .action(async (source, options) => {
+    const { importPresentation } = await import('../lib/import.js');
+    await importPresentation(source, options);
+  });
+
+// Preview command - live preview with stub LMS, or export static preview
+program
+  .command('preview')
+  .description('Live preview with stub LMS + auto-rebuild, or export static preview')
+  .option('-e, --export', 'Export static preview folder for sharing (instead of live server)')
+  .option('-o, --output <dir>', 'Output directory for export (default: ./course-preview)', './course-preview')
+  .option('-p, --password <password>', 'Require password to access preview (export only)')
+  .option('--title <title>', 'Custom title (default: course title)')
+  .option('--port <port>', 'Preview server port (default: 4173)', '4173')
+  .option('--skip-build', 'Skip build step for export (use existing dist folder)')
+  .option('--nojekyll', 'Add .nojekyll file (required for GitHub Pages)')
+  .option('--no-content', 'Exclude course content viewer from preview toolbar')
+  .option('-f, --format <format>', 'LMS format: scorm2004, scorm1.2, cmi5, lti, scorm1.2-proxy, scorm2004-proxy, or cmi5-remote')
+  .option('--desktop', 'Signal that preview is launched via the desktop companion app')
+  .action(async (options) => {
+    if (options.export) {
+      const { previewExport } = await import('../lib/preview-export.js');
+      await previewExport(options);
+    } else {
+      const { previewServer } = await import('../lib/preview-server.js');
+      await previewServer(options);
+    }
+  });
+
+// Info command (useful for debugging)
+program
+  .command('info')
+  .description('Show info about current project')
+  .action(async () => {
+    const { info } = await import('../lib/info.js');
+    await info();
+  });
+
+// Test error reporting command
+program
+  .command('test-errors')
+  .description('Send a test error to verify error reporting is configured correctly')
+  .option('-t, --type <type>', 'Type of test: error or report', 'error')
+  .option('-m, --message <message>', 'Custom message to include in the test')
+  .option('--insecure', 'Skip TLS certificate verification (for corporate proxies)')
+  .action(async (options) => {
+    const { testErrorReporting } = await import('../lib/test-error-reporting.js');
+    await testErrorReporting(options);
+  });
+
+// Test data reporting command
+program
+  .command('test-data')
+  .description('Send a test data record to verify data reporting is configured correctly')
+  .option('-t, --type <type>', 'Type of record: assessment, objective, or interaction', 'assessment')
+  .option('-m, --message <message>', 'Custom message to include in the test')
+  .option('--insecure', 'Skip TLS certificate verification (for corporate proxies)')
+  .action(async (options) => {
+    const { testDataReporting } = await import('../lib/test-data-reporting.js');
+    await testDataReporting(options);
+  });
+
+// MCP server command
+program
+  .command('mcp')
+  .description('Start MCP server for AI agent integration (connects to running preview server)')
+  .option('--port <port>', 'Preview server port to connect to', '4173')
+  .action(async (options) => {
+    const { startMcpServer } = await import('../lib/mcp-server.js');
+    await startMcpServer(options);
+  });
+// Token generation command
+program
+  .command('token')
+  .description('Generate access token for multi-tenant CDN deployment')
+  .option('--add <clientId>', 'Add client to course-config with generated token')
+  .action(async (options) => {
+    const { token } = await import('../lib/token.js');
+    await token(options);
+  });
+
+// Clean command - remove example files from project
+program
+  .command('clean')
+  .description('Remove example slides, audio, and reset course-config.js to minimal starter')
+  .action(async () => {
+    const { clean } = await import('../lib/scaffold.js');
+    clean();
+  });
+
+// New command - scaffold new files
+const newCmd = program
+  .command('new')
+  .description('Create new course files (slide, assessment, or config)');
+
+newCmd
+  .command('slide <id>')
+  .description('Create a new slide file in course/slides/')
+  .action(async (id) => {
+    const { newSlide } = await import('../lib/scaffold.js');
+    newSlide(id);
+  });
+
+newCmd
+  .command('assessment <id>')
+  .description('Create a new assessment file in course/slides/')
+  .action(async (id) => {
+    const { newAssessment } = await import('../lib/scaffold.js');
+    newAssessment(id);
+  });
+
+newCmd
+  .command('config')
+  .description('Create a minimal course-config.js (errors if one exists)')
+  .action(async () => {
+    const { newConfig } = await import('../lib/scaffold.js');
+    newConfig();
+  });
+
+// Cloud commands — all support --local to target http://localhost:3000
+program
+  .command('login')
+  .description('Log in to CourseCode Cloud')
+  .option('--local', 'Use local Cloud instance (http://localhost:3000)')
+  .action(async (options) => {
+    const { login, setLocalMode } = await import('../lib/cloud.js');
+    if (options.local) setLocalMode();
+    await login();
+  });
+
+program
+  .command('logout')
+  .description('Log out of CourseCode Cloud')
+  .action(async () => {
+    const { logout } = await import('../lib/cloud.js');
+    await logout();
+  });
+
+program
+  .command('whoami')
+  .description('Show current Cloud user and organizations')
+  .option('--local', 'Use local Cloud instance (http://localhost:3000)')
+  .option('--json', 'Output raw JSON')
+  .action(async (options) => {
+    const { whoami, setLocalMode } = await import('../lib/cloud.js');
+    if (options.local) setLocalMode();
+    await whoami({ json: options.json });
+  });
+
+program
+  .command('courses')
+  .description('List courses on CourseCode Cloud')
+  .option('--local', 'Use local Cloud instance (http://localhost:3000)')
+  .action(async (options) => {
+    const { listCourses, setLocalMode } = await import('../lib/cloud.js');
+    if (options.local) setLocalMode();
+    await listCourses();
+  });
+
+program
+  .command('deploy')
+  .description('Build and deploy course to CourseCode Cloud')
+  .option('--preview', 'Deploy as preview (expires in 7 days)')
+  .option('--password', 'Password-protect preview (interactive prompt)')
+  .option('--local', 'Use local Cloud instance (http://localhost:3000)')
+  .action(async (options) => {
+    const { deploy, setLocalMode } = await import('../lib/cloud.js');
+    if (options.local) setLocalMode();
+    await deploy(options);
+  });
+
+program
+  .command('status')
+  .description('Show deployment status for current course')
+  .option('--local', 'Use local Cloud instance (http://localhost:3000)')
+  .action(async (options) => {
+    const { status, setLocalMode } = await import('../lib/cloud.js');
+    if (options.local) setLocalMode();
+    await status();
+  });
+
+program.parse();