coursecast 0.1.0 → 0.2.1

package/README.md

@@ -18,11 +18,11 @@ Requires Node 18+.
 ## Use
 
 ```bash
-# one interactive lesson
-coursecast new "how DNS works"
+# a whole course (~12 lessons + mastery dashboard), from one prompt
+coursecast "how DNS works"
 
-# a whole course (~12 lessons + dashboard), deployed live
-coursecast course "intro to nuclear power" --deploy
+# generate and deploy live to your own Vercel
+coursecast "intro to nuclear power" --deploy
 ```
 
 Open the printed `index.html` — that's the whole product: no server, no build step,
@@ -40,10 +40,10 @@ The engine is what writes the content. Pick with `--engine`:
 | `stub` | nothing — offline placeholder content | nothing |
 
 ```bash
-coursecast course "learn rust" --engine gemini
+coursecast "learn rust" --engine gemini
 ```
 
-Gemini extras: `GEMINI_MODEL` overrides the model (default `gemini-2.5-flash`);
+Gemini extras: `GEMINI_MODEL` overrides the model (default `gemini-3.5-flash`);
 `COURSECAST_RESEARCH=0` skips the web-search research pass (faster, cheaper, less current).
 
 ## All flags

package/bin/coursecast.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
-// coursecast — one prompt → an interactive lesson → deployed live.
+// coursecast — one prompt → a whole interactive course → deployed live.
 
-import { createLesson, createCourse, deployDir, slugify } from '../src/index.mjs';
+import { createCourse, deployDir } from '../src/index.mjs';
 
 const argv = process.argv.slice(2);
 
@@ -18,19 +18,18 @@ const log = (...a) => console.log(...a);
 
 function usage() {
   log(`
-coursecast — generate an interactive lesson from one prompt, and deploy it.
+coursecast — one prompt → a whole interactive course, deployed live.
 
 USAGE
-  coursecast new    "<topic>" [options]     generate ONE interactive lesson
-  coursecast course "<topic>" [options]     generate a whole multi-lesson course + dashboard
+  coursecast "<topic>" [options]
 
 OPTIONS
   --engine <id>      generation engine: claude-code (default), gemini, codex, stub
-  --model <id>       model hint passed to the engine (e.g. gemini-2.5-flash)
+  --model <id>       model hint passed to the engine (e.g. gemini-3.5-flash)
   --storage <id>     progress storage: local (default, no setup), cloud (sync across devices)
   --provider <id>    deploy target: vercel (default), netlify
-  --lessons <n>      (course) target number of lessons (default ~12)
-  --concurrency <n>  (course) how many lessons to generate at once (default 4)
+  --lessons <n>      target number of lessons (default ~12)
+  --concurrency <n>  how many lessons to generate at once (default 4)
   --deploy           deploy after generating (otherwise generate only)
   --dry-run          with --deploy, print the deploy command without running it
   --preview          deploy as a preview instead of production
@@ -38,21 +37,24 @@ OPTIONS
   -h, --help         show this help
 
 EXAMPLES
-  coursecast new "kubernetes basics" --engine stub
-  coursecast course "how DNS works" --engine gemini      # cheap, search-grounded
-  GEMINI_API_KEY=... coursecast course "learn rust" --engine gemini
-  coursecast course "intro to nuclear power" --deploy --provider netlify
+  coursecast "kubernetes basics" --engine stub          # offline test, no AI
+  coursecast "how DNS works" --engine gemini            # cheap, search-grounded
+  coursecast "intro to nuclear power" --deploy          # generate + ship to your Vercel
 `);
 }
 
 async function main() {
-  const cmd = argv[0];
-  if (!cmd || has('help') || argv.includes('-h')) { usage(); process.exit(cmd ? 0 : 1); }
+  if (has('help') || argv.includes('-h')) { usage(); process.exit(0); }
 
-  if (cmd !== 'new' && cmd !== 'course') { log(`Unknown command "${cmd}".`); usage(); process.exit(1); }
-
-  const topic = argv[1] && !argv[1].startsWith('--') ? argv[1] : null;
-  if (!topic) { log(`❌  Provide a topic:  coursecast ${cmd} "your topic"`); process.exit(1); }
+  // The topic is the whole interface: the first non-flag argument.
+  const topic = argv[0] && !argv[0].startsWith('--') ? argv[0] : null;
+  if (!topic) { log(`❌  Provide a topic:  coursecast "your topic"`); usage(); process.exit(1); }
+  // Old two-word syntax (`coursecast course "x"`) would silently make a course about
+  // "course" — catch it and point at the new shape instead.
+  if ((topic === 'course' || topic === 'lesson' || topic === 'new') && argv[1] && !argv[1].startsWith('--')) {
+    log(`❌  Subcommands are gone — it's just:  coursecast "${argv[1]}"`);
+    process.exit(1);
+  }
 
   const engine = getFlag('engine', 'claude-code');
   const provider = getFlag('provider', 'vercel');
@@ -63,26 +65,19 @@ async function main() {
   const concurrency = parseInt(getFlag('concurrency', ''), 10) || undefined;
 
   try {
-    let dir, entry;
-    if (cmd === 'course') {
-      const res = await createCourse({ topic, engine, model, storage, outDir: out, lessons, concurrency, log });
-      dir = res.dir; entry = `${res.dir}/index.html`;
-      log(`✅  Course ready: ${res.lessons.length} lessons${res.failed.length ? ` (${res.failed.length} failed: ${res.failed.join(', ')})` : ''}`);
-    } else {
-      const res = await createLesson({ topic, engine, model, storage, outDir: out, log });
-      dir = res.dir; entry = res.file;
-      log(`✅  Lesson ready: ${res.file}`);
-    }
+    const res = await createCourse({ topic, engine, model, storage, outDir: out, lessons, concurrency, log });
+    const dir = res.dir;
+    log(`✅  Course ready: ${res.lessons.length} lessons${res.failed.length ? ` (${res.failed.length} failed: ${res.failed.join(', ')})` : ''}`);
 
     if (has('deploy')) {
-      const res = await deployDir({
+      const dep = await deployDir({
         dir, provider, prod: !has('preview'), dryRun: has('dry-run'), log,
       });
-      if (res.dryRun) log(`ℹ️  Dry run — would run:  ${res.command}`);
-      else log(`\n🎉  Live at: ${res.url}`);
+      if (dep.dryRun) log(`ℹ️  Dry run — would run:  ${dep.command}`);
+      else log(`\n🎉  Live at: ${dep.url}`);
     } else {
-      log(`\nPreview locally:  npx serve "${dir}"   (or open ${entry})`);
-      log(`Deploy:           coursecast ${cmd} "${topic}" --deploy --provider ${provider}`);
+      log(`\nPreview locally:  npx serve "${dir}"   (or open ${dir}/index.html)`);
+      log(`Deploy:           coursecast "${topic}" --deploy --provider ${provider}`);
     }
   } catch (e) {
     log(`\n❌  ${e.message}`);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "coursecast",
-  "version": "0.1.0",
-  "description": "One prompt → an interactive lesson or a full multi-lesson course with a mastery dashboard — rendered to self-contained HTML and deployed live.",
+  "version": "0.2.1",
+  "description": "One prompt → a full interactive course — live widgets, quizzes, a mastery dashboard — rendered to self-contained HTML and deployed live.",
   "type": "module",
   "bin": {
     "coursecast": "bin/coursecast.mjs"

package/src/engines/gemini.mjs

@@ -4,14 +4,14 @@
 // schema rather than inventing them from stale training data.
 //
 //   Requires: GEMINI_API_KEY   (free tier works — https://aistudio.google.com/apikey)
-//   Optional: GEMINI_MODEL     (default "gemini-2.5-flash"), COURSECAST_RESEARCH=0 to skip search.
+//   Optional: GEMINI_MODEL     (default "gemini-3.5-flash"), COURSECAST_RESEARCH=0 to skip search.
 
 import { buildSyllabusPrompt, buildLessonPrompt, finalizeLesson, extractJsonObject } from './shared-prompts.mjs'
 
 export const name = 'gemini'
 
 const API = 'https://generativelanguage.googleapis.com/v1beta/models'
-const DEFAULT_MODEL = process.env.GEMINI_MODEL || 'gemini-2.5-flash'
+const DEFAULT_MODEL = process.env.GEMINI_MODEL || 'gemini-3.5-flash'
 const RESEARCH_ON = process.env.COURSECAST_RESEARCH !== '0'
 
 function apiKey() {

package/src/engines/stub.mjs

@@ -54,8 +54,8 @@ export async function generateLesson({ topic, slug, context }) {
       js: `document.getElementById('stubBtn').addEventListener('click',function(){document.getElementById('stubOut').textContent='✅ Pipeline works — this is where a real simulation lives.';});`,
     },
     terminal: [
-      { cmd: `coursecast new "${t}"`, explain: 'Generates this lesson from a single prompt.' },
-      { cmd: `coursecast course "${t}" --deploy`, explain: 'Generates a whole course and deploys it live.' },
+      { cmd: `coursecast "${t}"`, explain: 'Generates this whole course from a single prompt.' },
+      { cmd: `coursecast "${t}" --deploy`, explain: 'Generates and deploys it live in one go.' },
     ],
     checklist: [
       { title: 'Confirm the page renders', desc: 'You are reading it — the render step works.', hint: 'If styles are missing, the CSS did not inline correctly.' },