epicshop 6.82.0 → 6.83.0

package/dist/cli.js

@@ -29,7 +29,9 @@ function formatHelp(helpText) {
         .replace(/-\w(?=\s|,)/g, (match) => chalk.yellow(match));
 }
 function resolveWorkshopContextCwd(explicitWorkshopDir) {
-    const fromFlag = explicitWorkshopDir?.trim() ? explicitWorkshopDir.trim() : undefined;
+    const fromFlag = explicitWorkshopDir?.trim()
+        ? explicitWorkshopDir.trim()
+        : undefined;
     if (fromFlag)
         return fromFlag;
     const fromEnv = process.env.EPICSHOP_CONTEXT_CWD;
@@ -1032,7 +1034,7 @@ const cli = yargs(args)
     .command('exercises [exercise] [step]', 'List exercises or show exercise details (context-aware)', (yargs) => {
     return yargs
         .positional('exercise', {
-        describe: 'Exercise number to show details for (e.g., 1 or 01)',
+        describe: 'Exercise number or "context" to export all workshop context',
         type: 'string',
     })
         .positional('step', {
@@ -1054,8 +1056,15 @@ const cli = yargs(args)
         alias: 'w',
         type: 'string',
         description: 'Path to a workshop directory to use as context (instead of the current working directory)',
+    })
+        .option('output', {
+        alias: 'o',
+        type: 'string',
+        description: 'Write context output to file (for exercises context subcommand)',
     })
         .example('$0 exercises', 'List all exercises with progress')
+        .example('$0 exercises context', 'Export all workshop context as JSON')
+        .example('$0 exercises context -o context.json', 'Export context to file')
         .example('$0 exercises 1', 'Show details for exercise 1')
         .example('$0 exercises 1 2', 'Show details for exercise 1 step 2')
         .example('$0 exercises --json', 'Output exercises as JSON');
@@ -1069,11 +1078,22 @@ const cli = yargs(args)
     const originalCwd = process.cwd();
     process.chdir(workshopRoot);
     try {
+        // "context" subcommand: export all workshop context
+        if (argv.exercise === 'context') {
+            const { exportContext } = await import("./commands/exercises.js");
+            const result = await exportContext({
+                silent: argv.silent,
+                output: argv.output,
+            });
+            if (!result.success)
+                process.exit(1);
+            return;
+        }
         const { list, showExercise } = await import("./commands/exercises.js");
         if (argv.exercise) {
             const exerciseNumber = parseInt(argv.exercise, 10);
             if (isNaN(exerciseNumber)) {
-                console.error(chalk.red(`❌ Invalid exercise number: "${argv.exercise}". Expected a number.`));
+                console.error(chalk.red(`❌ Invalid exercise number: "${argv.exercise}". Expected a number or "context".`));
                 process.exit(1);
             }
             const stepNumber = argv.step ? parseInt(argv.step, 10) : undefined;

package/dist/commands/exercises.d.ts

@@ -13,6 +13,15 @@ export type ExerciseContextOptions = {
     silent?: boolean;
     json?: boolean;
 };
+export type ExportContextOptions = {
+    silent?: boolean;
+    output?: string;
+};
+/**
+ * Export all workshop context (instructions, diffs, transcripts) as JSON.
+ * Excludes user-specific data (progress, auth, playground state).
+ */
+export declare function exportContext(options?: ExportContextOptions): Promise<ExercisesResult>;
 /**
  * List all exercises with progress
  */

package/dist/commands/exercises.js

@@ -1,4 +1,144 @@
+import path from 'node:path';
 import chalk from 'chalk';
+/**
+ * Export all workshop context (instructions, diffs, transcripts) as JSON.
+ * Excludes user-specific data (progress, auth, playground state).
+ */
+export async function exportContext(options = {}) {
+    const { silent = false, output: outputPath } = options;
+    try {
+        const { init, getExercises, getApps, getWorkshopRoot, isProblemApp, isSolutionApp, } = await import('@epic-web/workshop-utils/apps.server');
+        const { getWorkshopConfig } = await import('@epic-web/workshop-utils/config.server');
+        const { getDiffOutputWithRelativePaths } = await import('@epic-web/workshop-utils/diff.server');
+        const { getEpicVideoInfos } = await import('@epic-web/workshop-utils/epic-api.server');
+        const fs = await import('node:fs/promises');
+        await init();
+        const config = getWorkshopConfig();
+        const exercises = await getExercises();
+        const apps = await getApps();
+        // Workshop-level instructions (raw MDX)
+        const workshopRoot = getWorkshopRoot();
+        const instructionsContent = await safeReadFile(path.join(workshopRoot, 'exercises', 'README.mdx'));
+        const finishedInstructionsContent = await safeReadFile(path.join(workshopRoot, 'exercises', 'FINISHED.mdx'));
+        const output = {
+            workshop: {
+                title: config.title,
+                subtitle: config.subtitle,
+            },
+            instructions: { content: instructionsContent ?? null },
+            finishedInstructions: { content: finishedInstructionsContent ?? null },
+            exercises: [],
+        };
+        for (const exercise of exercises) {
+            const exerciseInstructions = await safeReadFile(path.join(exercise.fullPath, 'README.mdx'));
+            const exerciseFinished = await safeReadFile(path.join(exercise.fullPath, 'FINISHED.mdx'));
+            const steps = [];
+            for (const step of exercise.steps) {
+                const stepTitle = step.problem?.title ?? step.solution?.title ?? 'Untitled';
+                // Collect all embeds for this step and fetch once
+                const problemEmbeds = step.problem?.epicVideoEmbeds ?? [];
+                const solutionEmbeds = step.solution?.epicVideoEmbeds ?? [];
+                const allStepEmbeds = [
+                    ...new Set([...problemEmbeds, ...solutionEmbeds]),
+                ];
+                const videoInfos = await getEpicVideoInfos(allStepEmbeds);
+                // Problem instructions and transcripts
+                let problemData = null;
+                if (step.problem) {
+                    const problemInstructions = await safeReadFile(path.join(step.problem.fullPath, 'README.mdx'));
+                    const problemTranscripts = buildTranscriptsForExport(problemEmbeds, videoInfos);
+                    problemData = {
+                        instructions: problemInstructions,
+                        transcripts: problemTranscripts,
+                    };
+                }
+                // Solution instructions and transcripts
+                let solutionData = null;
+                if (step.solution) {
+                    const solutionInstructions = await safeReadFile(path.join(step.solution.fullPath, 'README.mdx'));
+                    const solutionTranscripts = buildTranscriptsForExport(solutionEmbeds, videoInfos);
+                    solutionData = {
+                        instructions: solutionInstructions,
+                        transcripts: solutionTranscripts,
+                    };
+                }
+                // Diff (problem vs solution)
+                let diffOutput = null;
+                if (step.problem && step.solution) {
+                    const problemApp = apps.find((a) => isProblemApp(a) &&
+                        a.exerciseNumber === exercise.exerciseNumber &&
+                        a.stepNumber === step.stepNumber);
+                    const solutionApp = apps.find((a) => isSolutionApp(a) &&
+                        a.exerciseNumber === exercise.exerciseNumber &&
+                        a.stepNumber === step.stepNumber);
+                    if (problemApp && solutionApp) {
+                        diffOutput =
+                            await getDiffOutputWithRelativePaths(problemApp, solutionApp) || null;
+                    }
+                }
+                steps.push({
+                    stepNumber: step.stepNumber,
+                    title: stepTitle,
+                    problem: problemData,
+                    solution: solutionData,
+                    diff: diffOutput,
+                });
+            }
+            output.exercises.push({
+                exerciseNumber: exercise.exerciseNumber,
+                title: exercise.title,
+                instructions: { content: exerciseInstructions },
+                finishedInstructions: { content: exerciseFinished },
+                steps,
+            });
+        }
+        const jsonOutput = JSON.stringify(output, null, 2);
+        if (outputPath) {
+            await fs.writeFile(outputPath, jsonOutput, 'utf-8');
+            if (!silent) {
+                console.error(chalk.green(`✓ Context written to ${outputPath}`));
+            }
+        }
+        else {
+            console.log(jsonOutput);
+        }
+        return { success: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (!silent) {
+            console.error(chalk.red(`❌ Failed to export context: ${message}`));
+        }
+        return {
+            success: false,
+            message,
+            error: error instanceof Error ? error : new Error(message),
+        };
+    }
+}
+function buildTranscriptsForExport(embeds, videoInfos) {
+    if (!embeds.length)
+        return [];
+    return embeds.map((embed) => {
+        const info = videoInfos[embed];
+        if (info && info.transcript) {
+            return { embed, transcript: info.transcript, status: 'success' };
+        }
+        if (info && info.status === 'error') {
+            const err = info;
+            return {
+                embed,
+                status: 'error',
+                message: err.message ?? err.type ?? 'Unknown error',
+            };
+        }
+        return {
+            embed,
+            status: 'error',
+            message: 'No transcript found',
+        };
+    });
+}
 /**
  * List all exercises with progress
  */
@@ -121,7 +261,6 @@ export async function showExercise(options = {}) {
     try {
         const { init, getExercise, getPlaygroundApp, extractNumbersAndTypeFromAppNameOrPath, } = await import('@epic-web/workshop-utils/apps.server');
         const { getProgress } = await import('@epic-web/workshop-utils/epic-api.server');
-        const path = await import('node:path');
         await init();
         const playgroundApp = await getPlaygroundApp();
         let targetExercise = exerciseNumber;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "epicshop",
-  "version": "6.82.0",
+  "version": "6.83.0",
   "publishConfig": {
     "access": "public"
   },
@@ -99,7 +99,7 @@
     "build:watch": "nx watch --projects=epicshop -- nx run \\$NX_PROJECT_NAME:build"
   },
   "dependencies": {
-    "@epic-web/workshop-utils": "6.82.0",
+    "@epic-web/workshop-utils": "6.83.0",
     "@inquirer/prompts": "^8.2.0",
     "@sentry/node": "^10.38.0",
     "chalk": "^5.6.2",