feat: live class sessions, CE workflow, and docs (#683)

Adds live-class session scheduling on lessons (join link, date/time,
timezone) with automatic 24h and 1h reminder emails plus a calendar
invite (.ics), a time-change notification with an updated invite, a
teacher-authored welcome email and session invite on enrollment, and a
"Notify students" quiz nudge.

LMS gets an upcoming live-sessions card and Join buttons, plus a
reusable live-session card component (3 states) in @cio/ui with a
Storybook story. The sidebar content tree now reflects sequential
progression locking like the content list, and the course-completion
confetti regression is fixed.

Org-based emails no longer reference ClassroomIO by name. Docs add
live-class, welcome-email, and course-progression guides, expand the
certificates guide (design, signatures, corrected labels), move
plan-required callouts to the top, flatten how-to-guides to the docs
root with redirects, and add screenshots. Includes an add-docs-image
skill.

packages/jobs/src/queues/index.ts

@@ -1,3 +1,4 @@
 export * from './names';
 export * from './defaults';
 export * from './factories';
+export * from './job-state';

packages/jobs/src/queues/job-state.ts

@@ -0,0 +1,56 @@
+import { getQueue } from './factories';
+import type { QueueName } from './names';
+import { JOB_STATUS, type JobEnvelope, type JobStatus, suggestNextPollMs } from '../status';
+
+function mapBullState(state: string): JobStatus {
+  switch (state) {
+    case 'completed':
+      return JOB_STATUS.completed;
+    case 'failed':
+      return JOB_STATUS.failed;
+    case 'active':
+      return JOB_STATUS.running;
+    default:
+      // waiting | waiting-children | delayed | prioritized | paused
+      return JOB_STATUS.queued;
+  }
+}
+
+/**
+ * Read a queued job's status as a `JobEnvelope` directly from BullMQ — no DB
+ * ledger. Used by domains (e.g. notify-course-exercise) that don't need a
+ * durable run history, just "is it done yet?" polling. Returns null if the
+ * job no longer exists (e.g. retention swept it).
+ */
+export async function getQueueJobEnvelope(
+  queueName: QueueName,
+  jobId: string,
+  domain: string,
+  pollCount = 0
+): Promise<JobEnvelope | null> {
+  const job = await getQueue(queueName).getJob(jobId);
+  if (!job) {
+    return null;
+  }
+
+  const status = mapBullState(await job.getState());
+  const finishedOn = job.finishedOn ?? job.processedOn ?? job.timestamp;
+
+  return {
+    job: {
+      id: String(job.id),
+      domain,
+      status,
+      stage: null,
+      progressPercent: typeof job.progress === 'number' ? job.progress : null,
+      createdAt: new Date(job.timestamp).toISOString(),
+      updatedAt: new Date(finishedOn).toISOString(),
+      result: (job.returnvalue as Record<string, unknown> | null) ?? null,
+      error: job.failedReason ? { code: 'JOB_FAILED', message: job.failedReason } : null,
+      attempt: job.attemptsMade,
+      maxAttempts: job.opts.attempts ?? 1
+    },
+    events: [],
+    nextPollMs: suggestNextPollMs(status, pollCount)
+  };
+}

packages/jobs/src/queues/names.ts

@@ -33,6 +33,11 @@ export const JOB_NAMES = {
   emails: {
     send: 'send'
   },
+  notifications: {
+    notifyCourseExercise: 'notify-course-exercise',
+    sessionReminderScan: 'session-reminder-scan',
+    notifyCourseSessionUpdate: 'notify-course-session-update'
+  },
   webhooks: {
     deliver: 'deliver'
   },