coursecode 0.1.11 → 0.1.14

package/README.md

@@ -191,6 +191,12 @@ When ready, deploy:
 coursecode deploy
 ```
 
+If the cloud course was deleted but the project still has the old local binding, redeploy with:
+
+```bash
+coursecode deploy --repair-binding
+```
+
 **Without Cloud**: Build a ZIP package and upload it to your LMS manually:
 
 ```bash

package/bin/cli.js

@@ -166,12 +166,13 @@ program
 // Convert command
 program
   .command('convert [source]')
-  .description('Convert docx, pptx, and pdf files to markdown for course authoring')
+  .description('Convert docx, pptx, and pdf files to markdown for course authoring (PDF JSON sidecars optional)')
   .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)')
+  .option('--pdf-json', 'Also write PDF structure JSON sidecars (.json) next to converted markdown')
   .action(async (source = './course/references', options) => {
     const { convert } = await import('../lib/convert.js');
     await convert(source, options);
@@ -352,6 +353,7 @@ program
   .option('--preview', 'Deploy as preview-only (production untouched, preview pointer always moved). Combine with --promote or --stage for a full deploy that also moves the preview pointer.')
   .option('--promote', 'Force-promote: always move production pointer regardless of deploy_mode setting. Mutually exclusive with --stage.')
   .option('--stage', 'Force-stage: never move production pointer regardless of deploy_mode setting. Mutually exclusive with --promote.')
+  .option('--repair-binding', 'Clear a stale local Cloud binding if the remote course was deleted, then continue')
   .option('--password', 'Password-protect preview (interactive prompt, requires --preview)')
   .option('-m, --message <message>', 'Deploy reason (e.g. "Fixed accessibility issues")')
   .option('--local', 'Use local Cloud instance (http://localhost:3000)')
@@ -368,6 +370,7 @@ program
   .option('--production', 'Promote to the production pointer')
   .option('--preview', 'Promote to the preview pointer')
   .option('--deployment <id>', 'Deployment ID to promote (skip interactive prompt)')
+  .option('--repair-binding', 'Clear a stale local Cloud binding if the remote course was deleted')
   .option('-m, --message <message>', 'Reason for promotion')
   .option('--local', 'Use local Cloud instance (http://localhost:3000)')
   .option('--json', 'Emit machine-readable JSON result')
@@ -381,24 +384,26 @@ program
 program
   .command('status')
   .description('Show deployment status for current course')
+  .option('--repair-binding', 'Clear a stale local Cloud binding if the remote course was deleted')
   .option('--local', 'Use local Cloud instance (http://localhost:3000)')
   .option('--json', 'Output raw JSON')
   .action(async (options) => {
     const { status, setLocalMode } = await import('../lib/cloud.js');
     if (options.local) setLocalMode();
-    await status({ json: options.json });
+    await status({ json: options.json, repairBinding: options.repairBinding });
   });
 
 program
   .command('delete')
   .description('Remove course from CourseCode Cloud (does not delete local files)')
   .option('--force', 'Skip confirmation prompt')
+  .option('--repair-binding', 'Clear a stale local Cloud binding if the remote course was already deleted')
   .option('--local', 'Use local Cloud instance (http://localhost:3000)')
   .option('--json', 'Emit machine-readable JSON result')
   .action(async (options) => {
     const { deleteCourse, setLocalMode } = await import('../lib/cloud.js');
     if (options.local) setLocalMode();
-    await deleteCourse({ force: options.force, json: options.json });
+    await deleteCourse({ force: options.force, json: options.json, repairBinding: options.repairBinding });
   });
 
 program.parse();

package/framework/docs/FRAMEWORK_GUIDE.md

@@ -123,7 +123,7 @@ The browser only downloads the one chunk matching the meta tag. Unused driver ch
 | `coursecode build` | `dist/` | Universal build + format manifest + meta tag stamped |
 | `coursecode build` (with `PACKAGE=true`) | `dist/` + ZIP | Same + format-specific ZIP for LMS upload |
 | `coursecode preview --export` | `course-preview/` | Copy of `dist/` wrapped in stub player (for Netlify/GitHub Pages) |
-| `coursecode deploy` | Uploads `dist/` | Cloud hosts universal build, assembles format ZIPs on demand. Flags: `--promote` (force live), `--stage` (force staged), `--preview` (preview-only: production untouched, preview always moved). `--promote`/`--stage` are mutually exclusive; `--preview` stacks with either. |
+| `coursecode deploy` | Uploads `dist/` | Cloud hosts universal build, assembles format ZIPs on demand. Flags: `--promote` (force live), `--stage` (force staged), `--preview` (preview-only: production untouched, preview always moved), `--repair-binding` (clear stale local cloud binding first if the remote course was deleted). `--promote`/`--stage` are mutually exclusive; `--preview` stacks with either. |
 
 The ZIP never includes preview/stub player assets. Preview is a separate concern (see below).
 

package/framework/docs/USER_GUIDE.md

@@ -740,6 +740,7 @@ Open the URL in any browser, log in with your CourseCode account, and enter the
 - **Preview pointer** — the version served on the cloud preview link (for stakeholder review).
 - **deploy_mode** — a per-course or org setting in the Cloud dashboard. Default is auto-promote (new uploads immediately go live). Can be set to staged (new uploads require a manual promote step).
 - `--promote` and `--stage` are mutually exclusive.
+- If a cloud deployment was deleted outside the CLI and this project still has the old local binding, rerun with `coursecode deploy --repair-binding`. To clear the stale binding without deploying yet, run `coursecode status --repair-binding`.
 
 **Typical Cloud workflow:**
 1. Run `coursecode login` once, open the URL shown, and enter the code.

package/lib/cloud.js

@@ -29,8 +29,11 @@ const DEFAULT_CLOUD_URL = 'https://coursecodecloud.com';
 const FALLBACK_CLOUD_URL = 'https://coursecode-cloud-web.vercel.app';
 const LOCAL_CLOUD_URL = 'http://localhost:3000';
 let useLocal = false;
+let activeCloudUrl = null;
 const CREDENTIALS_DIR = path.join(os.homedir(), '.coursecode');
 const CREDENTIALS_PATH = path.join(CREDENTIALS_DIR, 'credentials.json');
+const PROJECT_CONFIG_DIR = '.coursecode';
+const PROJECT_CONFIG_PATH = path.join(PROJECT_CONFIG_DIR, 'project.json');
 
 const POLL_INTERVAL_MS = 2000;
 const POLL_TIMEOUT_MS = 15 * 60 * 1000; // 15 minutes (device code expiry)
@@ -91,12 +94,19 @@ function writeCredentials(token, cloudUrl = DEFAULT_CLOUD_URL) {
   fs.writeFileSync(getCredentialsPath(), data, { mode: 0o600 });
 }
 
+function updateCredentialsCloudUrl(cloudUrl) {
+  const creds = readCredentials();
+  if (!creds?.token) return;
+  writeCredentials(creds.token, cloudUrl);
+}
+
 function deleteCredentials() {
   try { fs.unlinkSync(getCredentialsPath()); } catch { /* already gone */ }
 }
 
 function getCloudUrl() {
   if (useLocal) return LOCAL_CLOUD_URL;
+  if (activeCloudUrl) return activeCloudUrl;
   return readCredentials()?.cloud_url || DEFAULT_CLOUD_URL;
 }
 
@@ -106,6 +116,41 @@ function getCloudUrl() {
  */
 export function setLocalMode() {
   useLocal = true;
+  activeCloudUrl = LOCAL_CLOUD_URL;
+}
+
+// =============================================================================
+// PROJECT BINDING (local: .coursecode/project.json)
+// =============================================================================
+
+function readProjectConfig() {
+  try {
+    const fullPath = path.join(process.cwd(), PROJECT_CONFIG_PATH);
+    if (!fs.existsSync(fullPath)) return null;
+    return JSON.parse(fs.readFileSync(fullPath, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+function writeProjectConfig(data) {
+  const dir = path.join(process.cwd(), PROJECT_CONFIG_DIR);
+  fs.mkdirSync(dir, { recursive: true });
+  const existing = readProjectConfig() || {};
+  Object.assign(existing, data);
+  fs.writeFileSync(
+    path.join(process.cwd(), PROJECT_CONFIG_PATH),
+    JSON.stringify(existing, null, 2) + '\n'
+  );
+}
+
+function updateProjectConfig(mutator) {
+  const dir = path.join(process.cwd(), PROJECT_CONFIG_DIR);
+  fs.mkdirSync(dir, { recursive: true });
+  const fullPath = path.join(process.cwd(), PROJECT_CONFIG_PATH);
+  const existing = readProjectConfig() || {};
+  const next = mutator({ ...existing }) || existing;
+  fs.writeFileSync(fullPath, JSON.stringify(next, null, 2) + '\n');
 }
 
 // =============================================================================
@@ -136,6 +181,117 @@ function writeRcConfig(fields) {
   fs.writeFileSync(rcPath, JSON.stringify(existing, null, 2) + '\n');
 }
 
+function updateRcConfig(mutator) {
+  const rcPath = path.join(process.cwd(), '.coursecoderc.json');
+  const existing = readRcConfig() || {};
+  const next = mutator({ ...existing }) || existing;
+  fs.writeFileSync(rcPath, JSON.stringify(next, null, 2) + '\n');
+}
+
+function emitJson(payload) {
+  process.stdout.write(JSON.stringify(payload) + '\n');
+}
+
+function getBindingSnapshot(slug = resolveSlug()) {
+  const rcConfig = readRcConfig() || {};
+  const projectConfig = readProjectConfig() || {};
+  return {
+    slug,
+    cloudId: rcConfig.cloudId || projectConfig.courseId || null,
+    orgId: projectConfig.orgId || rcConfig.orgId || null,
+    hasBinding: Boolean(rcConfig.cloudId || projectConfig.courseId),
+  };
+}
+
+function clearCloudBinding() {
+  updateRcConfig((rc) => {
+    delete rc.cloudId;
+    delete rc.orgId;
+    return rc;
+  });
+  updateProjectConfig((project) => {
+    delete project.courseId;
+    delete project.orgId;
+    return project;
+  });
+}
+
+function buildStaleBindingPayload({
+  slug,
+  operation,
+  binding,
+  bindingCleared = false,
+  success = false,
+  alreadyDeleted = false,
+}) {
+  return {
+    success,
+    error: 'Cloud course was deleted. Local binding is stale.',
+    errorCode: 'stale_cloud_binding',
+    staleBinding: true,
+    bindingCleared,
+    repairable: true,
+    needsRedeploy: true,
+    alreadyDeleted,
+    operation,
+    suggestedAction: 'redeploy',
+    suggestedCommand: 'coursecode deploy --repair-binding',
+    repairFlag: '--repair-binding',
+    binding,
+    slug,
+  };
+}
+
+async function resolveStaleBinding({
+  operation,
+  slug,
+  options = {},
+  promptText,
+  onRepaired,
+  onDeclined,
+  onJson,
+}) {
+  const binding = getBindingSnapshot(slug);
+  if (!binding.hasBinding) return false;
+
+  const payload = buildStaleBindingPayload({ slug, operation, binding });
+
+  if (options.repairBinding) {
+    clearCloudBinding();
+    return onRepaired(buildStaleBindingPayload({
+      slug,
+      operation,
+      binding,
+      bindingCleared: true,
+      success: operation === 'delete',
+      alreadyDeleted: operation === 'delete',
+    }));
+  }
+
+  if (options.json || !process.stdin.isTTY) {
+    if (onJson) return onJson(payload);
+    emitJson(payload);
+    return true;
+  }
+
+  const answer = await prompt(`${promptText} [Y/n] `);
+  if (answer && !['y', 'yes'].includes(answer.toLowerCase())) {
+    if (onDeclined) return onDeclined(payload);
+    console.log('  Cancelled.\n');
+    process.exit(1);
+  }
+
+  clearCloudBinding();
+  return onRepaired(buildStaleBindingPayload({
+    slug,
+    operation,
+    binding,
+    bindingCleared: true,
+    success: operation === 'delete',
+    alreadyDeleted: operation === 'delete',
+  }));
+}
+
 // =============================================================================
 // HTTP HELPERS
 // =============================================================================
@@ -176,7 +332,10 @@ async function cloudFetch(urlPath, options = {}, token = null) {
     // Primary unreachable — try fallback before giving up
     if (!useLocal) {
       const fallback = await attemptFetch(FALLBACK_CLOUD_URL);
-      if (fallback) return fallback;
+      if (fallback) {
+        activeCloudUrl = FALLBACK_CLOUD_URL;
+        return fallback;
+      }
     }
     console.error('\n❌ Could not connect to CourseCode Cloud. Check your internet connection.\n');
     process.exit(1);
@@ -185,11 +344,29 @@ async function cloudFetch(urlPath, options = {}, token = null) {
   // Peek at the body: if it's an HTML block page, silently retry on the fallback.
   // We must buffer the text here since Response bodies can only be read once.
   const text = await res.text();
+
+  // Token may be valid on the alternate cloud origin. Before triggering re-auth,
+  // retry authenticated 401s once on the other known origin.
+  if (res.status === 401 && token && !useLocal) {
+    const alternateUrl = primaryUrl === FALLBACK_CLOUD_URL ? DEFAULT_CLOUD_URL : FALLBACK_CLOUD_URL;
+    const alternateRes = await attemptFetch(alternateUrl);
+    if (alternateRes) {
+      const alternateText = await alternateRes.text();
+      if (!isBlockPage(alternateText) && alternateRes.status !== 401) {
+        activeCloudUrl = alternateUrl;
+        updateCredentialsCloudUrl(alternateUrl);
+        return syntheticResponse(alternateText, alternateRes.status);
+      }
+    }
+  }
+
   if (isBlockPage(text) && !useLocal) {
     const fallbackRes = await attemptFetch(FALLBACK_CLOUD_URL);
     if (fallbackRes) {
       const fallbackText = await fallbackRes.text();
       if (!isBlockPage(fallbackText)) {
+        activeCloudUrl = FALLBACK_CLOUD_URL;
+        updateCredentialsCloudUrl(FALLBACK_CLOUD_URL);
         // Fallback succeeded — return a synthetic Response with the buffered text
         return syntheticResponse(fallbackText, fallbackRes.status);
       }
@@ -200,6 +377,7 @@ async function cloudFetch(urlPath, options = {}, token = null) {
   }
 
   // Primary response is fine — return a synthetic Response with the buffered text
+  activeCloudUrl = primaryUrl;
   return syntheticResponse(text, res.status);
 }
 
@@ -435,7 +613,7 @@ async function runLoginFlow({ jsonMode = false } = {}) {
     if (data.pending) continue;
 
     if (data.token) {
-      writeCredentials(data.token, getCloudUrl());
+      writeCredentials(data.token, activeCloudUrl || getCloudUrl());
       log('  ✓ Logged in successfully\n');
       return data.token;
     }
@@ -453,7 +631,7 @@ async function runLoginFlow({ jsonMode = false } = {}) {
  */
 async function runLegacyLoginFlow() {
   const nonce = crypto.randomBytes(32).toString('hex');
-  const cloudUrl = getCloudUrl();
+  const initialCloudUrl = getCloudUrl();
 
   console.log('  → Registering session...');
   const createRes = await cloudFetch('/api/auth/connect', {
@@ -469,7 +647,8 @@ async function runLegacyLoginFlow() {
     process.exit(1);
   }
 
-  const loginUrl = `${cloudUrl}/auth/connect?session=${nonce}`;
+  const effectiveCloudUrl = activeCloudUrl || initialCloudUrl;
+  const loginUrl = `${effectiveCloudUrl}/auth/connect?session=${nonce}`;
   console.log('  → Opening browser for authentication...');
   openBrowser(loginUrl);
 
@@ -490,7 +669,7 @@ async function runLegacyLoginFlow() {
     if (data.pending) continue;
 
     if (data.token) {
-      writeCredentials(data.token, cloudUrl);
+      writeCredentials(data.token, activeCloudUrl || initialCloudUrl);
       console.log('  ✓ Logged in successfully');
       return data.token;
     }
@@ -528,11 +707,21 @@ export async function ensureAuthenticated() {
  * Returns { orgId, courseId, orgName } or prompts the user.
  */
 async function resolveOrgAndCourse(slug, token) {
-  // .coursecoderc.json is committed and shared — it is the single source of truth
-  // for the cloud binding. If both cloudId and orgId are present, short-circuit.
+  // Shared binding (committed): cloudId in .coursecoderc.json.
+  // Local binding (per-user): orgId/courseId in .coursecode/project.json.
+  // This keeps login global while allowing per-course auth context.
   const rcConfig = readRcConfig();
-  if (rcConfig?.cloudId && rcConfig?.orgId) {
-    return { orgId: rcConfig.orgId, courseId: rcConfig.cloudId };
+  const projectConfig = readProjectConfig();
+  const rcCloudId = rcConfig?.cloudId;
+  const localOrgId = projectConfig?.orgId;
+  const localCourseId = projectConfig?.courseId;
+
+  if (rcCloudId && localOrgId) {
+    return { orgId: localOrgId, courseId: rcCloudId };
+  }
+
+  if (localOrgId && localCourseId) {
+    return { orgId: localOrgId, courseId: localCourseId };
   }
 
   // Call resolve endpoint
@@ -541,7 +730,8 @@ async function resolveOrgAndCourse(slug, token) {
 
   // Found in exactly one org
   if (data.found) {
-    writeRcConfig({ orgId: data.orgId, cloudId: data.courseId });
+    writeProjectConfig({ slug, orgId: data.orgId, courseId: data.courseId });
+    writeRcConfig({ cloudId: data.courseId, orgId: data.orgId });
     return { orgId: data.orgId, courseId: data.courseId, orgName: data.orgName };
   }
 
@@ -558,7 +748,8 @@ async function resolveOrgAndCourse(slug, token) {
       process.exit(1);
     }
     const match = data.matches[idx];
-    writeRcConfig({ orgId: match.orgId, cloudId: match.courseId });
+    writeProjectConfig({ slug, orgId: match.orgId, courseId: match.courseId });
+    writeRcConfig({ cloudId: match.courseId, orgId: match.orgId });
     return { orgId: match.orgId, courseId: match.courseId, orgName: match.orgName };
   }
 
@@ -638,7 +829,7 @@ export async function login(options = {}) {
 }
 
 /**
- * coursecode logout — delete credentials and local project.json
+ * coursecode logout — delete Cloud credentials
  */
 export async function logout(options = {}) {
   deleteCredentials();
@@ -734,6 +925,39 @@ export async function deploy(options = {}) {
   const log = (...args) => { if (!options.json) console.log(...args); };
   const logErr = (...args) => { if (!options.json) console.error(...args); };
 
+  // Preflight a cached binding so deleted cloud courses can be repaired
+  // before we spend time building and uploading.
+  const binding = getBindingSnapshot(slug);
+  if (binding.hasBinding && binding.orgId) {
+    const statusRes = await cloudFetch(
+      `/api/cli/courses/${encodeURIComponent(slug)}/status?orgId=${binding.orgId}`,
+      {},
+      readCredentials()?.token
+    );
+
+    if (statusRes.status === 404) {
+      const handled = await resolveStaleBinding({
+        operation: 'deploy',
+        slug,
+        options,
+        promptText: '\n  This project is still linked locally, but the Cloud course was deleted. Clear the stale binding and rebuild/redeploy?',
+        onRepaired: () => false,
+        onDeclined: () => {
+          logErr('\n❌ Deploy cancelled. Local binding still points to a deleted Cloud course.\n');
+          process.exit(1);
+        },
+        onJson: (payload) => {
+          emitJson(payload);
+          console.error('\n❌ Cloud course was deleted. Re-run deploy with --repair-binding to clear the stale binding first.\n');
+          process.exit(1);
+        },
+      });
+      if (handled) return;
+    } else if (!statusRes.ok) {
+      await handleResponse(statusRes);
+    }
+  }
+
   // Validate mutually exclusive flags
   if (options.promote && options.stage) {
     logErr('\n❌ --promote and --stage are mutually exclusive.\n');
@@ -817,8 +1041,9 @@ export async function deploy(options = {}) {
 
   const result = await makeRequest();
 
-  // Step 6: Stamp cloudId + orgId into .coursecoderc.json (committed, shared with team)
+  // Step 6: Persist per-user binding and stamp cloud identity into .coursecoderc.json
   const finalCourseId = result.courseId || courseId;
+  writeProjectConfig({ slug, orgId: result.orgId || orgId, courseId: finalCourseId });
   writeRcConfig({
     cloudId: finalCourseId,
     orgId: result.orgId || orgId,
@@ -926,7 +1151,46 @@ export async function promote(options = {}) {
     return handleResponse(res, { retryFn: makeRequest, _isRetry });
   };
 
-  const result = await makeRequest();
+  const token = readCredentials()?.token;
+  const firstRes = await cloudFetch(
+    `/api/cli/courses/${encodeURIComponent(slug)}/promote`,
+    {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ deployment_id: deploymentId, target, reason }),
+    },
+    token
+  );
+
+  if (firstRes.status === 404 && getBindingSnapshot(slug).hasBinding) {
+    const handled = await resolveStaleBinding({
+      operation: 'promote',
+      slug,
+      options,
+      promptText: '\n  This project is still linked locally, but the Cloud course was deleted. Clear the stale binding?',
+      onRepaired: (payload) => {
+        if (options.json) {
+          emitJson(payload);
+        } else {
+          console.log('\n  Cleared stale Cloud binding.');
+          console.log('  The course is no longer deployed. Run `coursecode deploy` before promoting.\n');
+        }
+        return true;
+      },
+      onDeclined: () => {
+        console.error('\n❌ Promote cancelled. Local binding still points to a deleted Cloud course.\n');
+        process.exit(1);
+      },
+      onJson: (payload) => {
+        emitJson(payload);
+        console.error('\n❌ Cloud course was deleted. Deploy again before promoting.\n');
+        process.exit(1);
+      },
+    });
+    if (handled) return;
+  }
+
+  const result = await handleResponse(firstRes, { retryFn: makeRequest, _isRetry: false });
 
   if (options.json) {
     process.stdout.write(JSON.stringify({ success: true, ...result }) + '\n');
@@ -965,7 +1229,43 @@ export async function status(options = {}) {
     return handleResponse(res, { retryFn: makeRequest, _isRetry });
   };
 
-  const data = await makeRequest();
+  const token = readCredentials()?.token;
+  const firstRes = await cloudFetch(
+    `/api/cli/courses/${encodeURIComponent(slug)}/status${orgQuery}`,
+    {},
+    token
+  );
+
+  if (firstRes.status === 404 && getBindingSnapshot(slug).hasBinding) {
+    const handled = await resolveStaleBinding({
+      operation: 'status',
+      slug,
+      options,
+      promptText: '\n  This project is still linked locally, but the Cloud course was deleted. Clear the stale binding?',
+      onRepaired: (payload) => {
+        const result = {
+          ...payload,
+          success: true,
+          deployed: false,
+          message: 'Local stale Cloud binding cleared. This course is no longer deployed.',
+        };
+        if (options.json) {
+          emitJson(result);
+        } else {
+          console.log('\n  Cleared stale Cloud binding.');
+          console.log('  This course is no longer deployed. Run `coursecode deploy` to create a new Cloud deployment.\n');
+        }
+        return true;
+      },
+      onJson: (payload) => {
+        emitJson(payload);
+        return true;
+      },
+    });
+    if (handled) return;
+  }
+
+  const data = await handleResponse(firstRes, { retryFn: makeRequest, _isRetry: false });
 
   if (options.json) {
     process.stdout.write(JSON.stringify(data) + '\n');
@@ -1050,7 +1350,52 @@ export async function deleteCourse(options = {}) {
     return handleResponse(res, { retryFn: makeRequest, _isRetry });
   };
 
-  const result = await makeRequest();
+  const token = readCredentials()?.token;
+  const firstRes = await cloudFetch(
+    `/api/cli/courses/${encodeURIComponent(slug)}${orgQuery}`,
+    {
+      method: 'DELETE',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ cloudId: rcConfig.cloudId }),
+    },
+    token
+  );
+
+  if (firstRes.status === 404 && getBindingSnapshot(slug).hasBinding) {
+    const handled = await resolveStaleBinding({
+      operation: 'delete',
+      slug,
+      options,
+      promptText: '\n  The Cloud course is already gone, but this project still has a local binding. Clear the stale binding too?',
+      onRepaired: (payload) => {
+        const result = {
+          ...payload,
+          success: true,
+          alreadyDeleted: true,
+          message: 'Cloud course was already deleted. Local stale binding cleared.',
+        };
+        if (options.json) {
+          emitJson(result);
+        } else {
+          console.log('\n✓ Course was already deleted from CourseCode Cloud.');
+          console.log('  Cleared stale local Cloud binding.\n');
+        }
+        return true;
+      },
+      onJson: (payload) => {
+        emitJson({
+          ...payload,
+          success: true,
+          alreadyDeleted: true,
+          message: 'Cloud course was already deleted. Local binding still needs cleanup.',
+        });
+        return true;
+      },
+    });
+    if (handled) return;
+  }
+
+  const result = await handleResponse(firstRes, { retryFn: makeRequest, _isRetry: false });
 
   if (options.json) {
     process.stdout.write(JSON.stringify({ success: true, ...result }) + '\n');

package/lib/convert.js

@@ -18,7 +18,8 @@ export async function convert(source, options) {
         format = 'all',
         dryRun = false,
         overwrite = false,
-        flatten = false
+        flatten = false,
+        pdfJson = false
     } = options;
 
     console.log('\n📄 Converting documents to markdown...\n');
@@ -111,8 +112,8 @@ export async function convert(source, options) {
             // Write output
             await fs.writeFile(outputFile, result.markdown, 'utf-8');
 
-            // Write structured data if available (for AI analysis)
-            if (result.data) {
+            // PDF structure sidecar is optional because it is much larger/token-heavier than markdown.
+            if (result.data && pdfJson) {
                 const jsonPath = outputFile.replace(/\.md$/, '.json');
                 await fs.writeFile(jsonPath, JSON.stringify(result.data, null, 2), 'utf-8');
             }

package/lib/manifest/cmi5-manifest.js

@@ -19,22 +19,20 @@
  * @returns {string} The cmi5.xml content
  */
 export function generateCmi5Manifest(config, _files, options = {}) {
-    // cmi5 course identifier - use configured identifier or generate from title
-    const courseId = config.identifier || 
-        `urn:coursecode:${config.title.replace(/[^a-zA-Z0-9]/g, '-').toLowerCase()}`;
-    
-    // Calculate mastery score from passing percentage (convert percentage to 0-1 scale)
-    const masteryScore = config.passingScore ? (config.passingScore / 100).toFixed(2) : '0.8';
-    
-    // AU identifier - derive from course ID
-    const auId = `${courseId}/au/1`;
-
-    // URL: absolute for cmi5-remote, relative for standard cmi5
-    const auUrl = options.externalUrl 
-        ? `${options.externalUrl.replace(/\/$/, '')}/index.html`
-        : 'index.html';
-
-    return `<?xml version="1.0" encoding="UTF-8"?>
+  // cmi5 course identifier - use configured identifier or generate from title
+  const courseId = config.identifier ||
+    `urn:coursecode:${config.title.replace(/[^a-zA-Z0-9]/g, '-').toLowerCase()}`;
+
+  // Calculate mastery score from passing percentage (convert percentage to 0-1 scale)
+  const masteryScore = config.passingScore ? (config.passingScore / 100).toFixed(2) : '0.8';
+
+  // AU identifier - derive from course ID
+  const auId = `${courseId}/au/1`;
+
+  // URL: absolute for cmi5-remote (use as-is), relative for standard cmi5
+  const auUrl = options.externalUrl || 'index.html';
+
+  return `<?xml version="1.0" encoding="UTF-8"?>
 <!-- cmi5 Course Structure - GENERATED FILE - DO NOT EDIT MANUALLY -->
 <courseStructure xmlns="https://w3id.org/xapi/profiles/cmi5/v1/CourseStructure.xsd">
 

package/lib/stub-player/lms-api.js

@@ -9,7 +9,7 @@
  * Enforces real LMS behavior — lifecycle violations return 'false' with proper
  * error codes, read-only elements reject SetValue, and format-specific rules
  * are enforced. This catches bugs that silently pass in dev but explode in
- * production LMSs like SCORM Cloud, Moodle, Cornerstone, etc.
+ * production SCORM/cmi5/LTI environments and LMSs like Moodle or Cornerstone.
  */
 
 const isBrowser = typeof window !== 'undefined';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "coursecode",
-  "version": "0.1.11",
+  "version": "0.1.14",
   "description": "Multi-format course authoring framework with CLI tools (SCORM 2004, SCORM 1.2, cmi5, LTI 1.3)",
   "type": "module",
   "bin": {