@chalksurf/cli 0.2.2 → 0.2.4

package/dist/commands/exercise.js

@@ -1,600 +0,0 @@
-import { z } from 'zod';
-import { createApiClient } from '../lib/api-client.js';
-import { CliCommandError } from '../lib/cli-error.js';
-import { normalizeChoiceValues, normalizeLimit, normalizeOffset, normalizeOptionalInteger, normalizeOptionalText, normalizeOwnership, normalizeStringValues, toApiOwnership, } from '../lib/command-options.js';
-import { buildFileImportCommandSources, buildFileImportFormData, normalizeWaitTimeoutMs } from '../lib/import-files.js';
-import { buildCliImportSources, formatCliImportTranslationJobs, summarizeCliImportJobs, } from '../lib/import-output.js';
-import { loadExerciseImportManifest, loadExerciseSolutionImportManifest } from '../lib/manifest.js';
-import { createResolvedApiClient, mapApiErrorToCliError, requireResolvedBaseUrl, requireResolvedToken, resolveRequestedOrganizationId, } from '../lib/session.js';
-import { cleanupResolvedSources, resolveSources } from '../lib/source-resolver.js';
-import { resolveRequestedTranslateToLanguages, translationLanguages, } from '../lib/translation-languages.js';
-import { getWaitError, getWaitExitCode, throwSilentExitCode, waitForCliJobs } from '../lib/user-jobs.js';
-const exerciseStatusOptions = ['verified', 'unverified', 'invalid'];
-const getExerciseTextPreview = ({ exercise, language }) => {
-    if (language && exercise.text[language]) {
-        return exercise.text[language];
-    }
-    return Object.values(exercise.text)[0] ?? '';
-};
-const formatExerciseSearchOutput = ({ exercises, language, totalCount, }) => {
-    if (exercises.length === 0) {
-        return 'No exercises found.';
-    }
-    return [
-        `${exercises.length} of ${totalCount} exercise${totalCount === 1 ? '' : 's'} returned.`,
-        ...exercises.map((exercise) => {
-            const preview = getExerciseTextPreview({ exercise, language }).replace(/\s+/g, ' ').trim();
-            const labels = exercise.labels.length > 0 ? ` [${exercise.labels.join(', ')}]` : '';
-            return `${exercise.id}  ${exercise.status}${labels}${preview ? `  ${preview}` : ''}`;
-        }),
-    ].join('\n');
-};
-const normalizeSearchNumberRange = ({ maxDifficulty, minDifficulty, }) => {
-    if (minDifficulty !== null && maxDifficulty !== null && minDifficulty > maxDifficulty) {
-        throw new CliCommandError('--min-difficulty cannot be greater than --max-difficulty.', 2);
-    }
-};
-const resolveRequestedUuid = ({ flagValue, fallbackValue, label, required = false, }) => {
-    const resolvedValue = flagValue?.trim() || fallbackValue?.trim();
-    if (!resolvedValue) {
-        if (required) {
-            throw new CliCommandError(`${label} is required.`, 2);
-        }
-        return undefined;
-    }
-    const parsedValue = z.uuid().safeParse(resolvedValue);
-    if (!parsedValue.success) {
-        throw new CliCommandError(`${label} must be a valid UUID.`, 2);
-    }
-    return parsedValue.data;
-};
-const buildExerciseImportRequest = ({ exerciseId, exerciseSheetId, inputMode, organizationId, timeoutMs, wait, }) => {
-    return {
-        organizationId,
-        inputMode,
-        wait,
-        timeoutMs,
-        target: {
-            ...(exerciseId === undefined ? {} : { exerciseId }),
-            ...(exerciseSheetId === undefined ? {} : { exerciseSheetId }),
-        },
-    };
-};
-const buildQueuedExerciseImportJob = ({ jobId, sources, }) => {
-    return {
-        jobId,
-        sourceIndexes: sources.map((source) => source.sourceIndex),
-        sourceIds: sources.map((source) => source.sourceId).filter((sourceId) => sourceId !== null),
-        status: 'queued',
-    };
-};
-const buildWaitedExerciseImportJob = ({ jobId, sources, waitedJob, }) => {
-    return {
-        jobId,
-        sourceIndexes: sources.map((source) => source.sourceIndex),
-        sourceIds: sources.map((source) => source.sourceId).filter((sourceId) => sourceId !== null),
-        status: waitedJob?.status ?? 'pending',
-        error: waitedJob?.error,
-        exerciseId: waitedJob?.exerciseId,
-        exerciseIds: waitedJob?.exerciseIds,
-        translationJobs: waitedJob?.translationJobs,
-    };
-};
-const formatQueuedImportOutput = (job) => {
-    return [
-        'Queued exercise import.',
-        `${job.jobId}  ${job.sourceIndexes.length} source${job.sourceIndexes.length === 1 ? '' : 's'}`,
-    ].join('\n');
-};
-const formatQueuedSolutionImportOutput = (job) => {
-    return [
-        'Queued exercise solution import.',
-        `${job.jobId}  ${job.sourceIndexes.length} source${job.sourceIndexes.length === 1 ? '' : 's'}`,
-    ].join('\n');
-};
-const formatWaitedImportOutput = (job) => {
-    if (job.status === 'completed') {
-        const translationJobLines = formatCliImportTranslationJobs(job.translationJobs);
-        if (job.exerciseIds && job.exerciseIds.length > 0) {
-            return [
-                `${job.jobId} completed -> ${job.exerciseIds.length} exercise${job.exerciseIds.length === 1 ? '' : 's'}`,
-                ...translationJobLines,
-            ].join('\n');
-        }
-        if (job.exerciseId) {
-            return [`${job.jobId} completed -> ${job.exerciseId}`, ...translationJobLines].join('\n');
-        }
-        return [`${job.jobId} completed`, ...translationJobLines].join('\n');
-    }
-    if (job.status === 'failed') {
-        return `${job.jobId} failed -> ${job.error ?? 'Unknown error'}`;
-    }
-    return `${job.jobId} ${job.status ?? 'pending'}`;
-};
-export const registerExerciseCommands = (exerciseYargs, context) => {
-    return exerciseYargs
-        .command('search', 'Search exercises visible to the selected organization', (searchYargs) => searchYargs
-        .option('text', {
-        type: 'string',
-        describe: 'Search exercise text. Requires --language.',
-    })
-        .option('language', {
-        type: 'string',
-        describe: 'Language to search or preview, such as english or hungarian',
-    })
-        .option('semantic', {
-        type: 'string',
-        describe: 'Run semantic search with this query text',
-    })
-        .option('label', {
-        array: true,
-        type: 'string',
-        describe: 'Require an exercise label or label prefix',
-    })
-        .option('age', {
-        type: 'number',
-        describe: 'Filter exercises appropriate for this age',
-    })
-        .option('min-difficulty', {
-        type: 'number',
-        describe: 'Minimum difficulty',
-    })
-        .option('max-difficulty', {
-        type: 'number',
-        describe: 'Maximum difficulty',
-    })
-        .option('status', {
-        array: true,
-        type: 'string',
-        describe: `Only include exercises with these statuses (${exerciseStatusOptions.join(', ')})`,
-    })
-        .option('ownership', {
-        type: 'string',
-        default: 'own',
-        describe: 'Visibility scope: own, public, or all',
-    })
-        .option('limit', {
-        type: 'number',
-        default: 20,
-        describe: 'Maximum number of exercises to return',
-    })
-        .option('offset', {
-        type: 'number',
-        default: 0,
-        describe: 'Number of matching exercises to skip',
-    })
-        .example('chalksurf exercise search --text "binomial theorem" --language english --ownership own --json', 'Verify imported exercises in the selected organization')
-        .example('chalksurf --profile prod-codex exercise search --label geometry.triangles --status unverified --json', 'Find agent-created exercises that still need review'), async (argv) => {
-        const text = normalizeOptionalText(argv.text);
-        const language = normalizeOptionalText(argv.language);
-        const semanticSearch = normalizeOptionalText(argv.semantic);
-        const ownership = normalizeOwnership(argv.ownership);
-        const labels = normalizeStringValues(argv.label);
-        const status = normalizeChoiceValues({
-            allowedValues: exerciseStatusOptions,
-            label: '--status',
-            values: argv.status,
-        });
-        const age = normalizeOptionalInteger({ label: '--age', value: argv.age });
-        const minDifficulty = normalizeOptionalInteger({
-            label: '--min-difficulty',
-            value: argv.minDifficulty,
-        });
-        const maxDifficulty = normalizeOptionalInteger({
-            label: '--max-difficulty',
-            value: argv.maxDifficulty,
-        });
-        normalizeSearchNumberRange({ minDifficulty, maxDifficulty });
-        if (text !== null && language === null) {
-            throw new CliCommandError('--language is required when --text is provided.', 2);
-        }
-        const limit = normalizeLimit(argv.limit);
-        const offset = normalizeOffset(argv.offset);
-        const { apiClient, organizationId } = await createResolvedApiClient({
-            context,
-            baseUrlFlagValue: argv.baseUrl,
-            organizationFlagValue: argv.organization,
-            profileName: argv.profile,
-        });
-        let searchResult;
-        try {
-            searchResult = await apiClient.searchExercises({
-                age,
-                language,
-                labels,
-                minDifficulty,
-                maxDifficulty,
-                text,
-                semanticSearch,
-                status,
-                ownership: toApiOwnership(ownership),
-                limit,
-                offset,
-            });
-        }
-        catch (error) {
-            throw mapApiErrorToCliError(error);
-        }
-        context.output.print({
-            request: {
-                age,
-                language,
-                labels,
-                minDifficulty,
-                maxDifficulty,
-                text,
-                semanticSearch,
-                status: status ?? [],
-                ownership,
-                limit,
-                offset,
-                organizationId: organizationId ?? null,
-            },
-            exercises: searchResult.exercises,
-            totalCount: searchResult.totalCount,
-        }, (result) => formatExerciseSearchOutput({
-            exercises: result.exercises,
-            language: result.request.language ?? undefined,
-            totalCount: result.totalCount,
-        }), {
-            command: 'exercise search',
-        });
-    })
-        .command('import [sources..]', 'Import one or more exercises', (importYargs) => importYargs
-        .positional('sources', {
-        array: true,
-        type: 'string',
-        describe: 'Local file paths, directories, or HTTP(S) URLs',
-    })
-        .option('manifest', {
-        type: 'string',
-        describe: 'Load sources from a manifest file, or "-" for stdin',
-    })
-        .option('relative-path', {
-        type: 'string',
-        describe: 'Override the relative path for a single positional source',
-    })
-        .option('sheet-id', {
-        type: 'string',
-        describe: 'Append the imported exercises to an existing sheet',
-    })
-        .option('timeout-ms', {
-        type: 'number',
-        default: 300000,
-        describe: 'Maximum time to wait before timing out',
-    })
-        .option('translate-to', {
-        array: true,
-        type: 'string',
-        describe: `Generate translated exercise content for these languages (${translationLanguages.join(', ')})`,
-    })
-        .option('wait', {
-        type: 'boolean',
-        default: false,
-        describe: 'Wait for the queued job to finish',
-    })
-        .example('chalksurf exercise import ./fixtures/problem-set.pdf --sheet-id 00000000-0000-4000-8000-000000000001 --wait', 'Import a problem set into an existing sheet')
-        .example('cat exercise-import.json | chalksurf --profile prod-codex exercise import --manifest - --wait --json', 'Drive imports from a manifest in an agent or CI flow')
-        .epilogue([
-        'When --wait is set, the command exits after the queued import job reaches a terminal state.',
-        'For translated exercise imports, requested translations continue as separate jobs listed in the import result.',
-    ].join('\n')), async (argv) => {
-        const config = await context.configStore.loadProfile({ profileName: argv.profile });
-        const rawSources = (argv.sources ?? []).map(String);
-        const manifestPath = argv.manifest === '' ? '-' : argv.manifest;
-        const normalizedRawSources = manifestPath === '-' && rawSources[0] === '-' ? rawSources.slice(1) : rawSources;
-        const requestedTranslateTo = resolveRequestedTranslateToLanguages(argv.translateTo);
-        const resolvedBaseUrl = requireResolvedBaseUrl({
-            flagValue: argv.baseUrl,
-            env: context.env,
-            config,
-        });
-        const resolvedToken = requireResolvedToken({
-            env: context.env,
-            config,
-        });
-        const commandSources = await buildFileImportCommandSources({
-            cwd: context.cwd,
-            loadManifest: loadExerciseImportManifest,
-            manifestPath,
-            rawSources: normalizedRawSources,
-            relativePath: argv.relativePath,
-            stdin: context.stdin,
-            wait: argv.wait,
-        });
-        const organizationId = resolveRequestedOrganizationId({
-            flagValue: argv.organization,
-            fallbackValue: commandSources.organizationId,
-            env: context.env,
-            config,
-        });
-        const exerciseSheetId = resolveRequestedUuid({
-            flagValue: argv.sheetId,
-            fallbackValue: commandSources.exerciseSheetId,
-            label: '--sheet-id',
-        });
-        const translateToLanguages = requestedTranslateTo ?? commandSources.translateTo;
-        const apiClient = createApiClient({
-            baseUrl: resolvedBaseUrl.value,
-            token: resolvedToken.value,
-            organizationId,
-        });
-        let resolvedSources = [];
-        try {
-            resolvedSources = await resolveSources({
-                cwd: context.cwd,
-                sources: commandSources.sources,
-            });
-            const sources = buildCliImportSources({
-                resolvedSources,
-            });
-            const formData = await buildFileImportFormData(resolvedSources);
-            const request = buildExerciseImportRequest({
-                exerciseSheetId: exerciseSheetId ?? null,
-                inputMode: manifestPath ? 'manifest' : 'arguments',
-                organizationId: organizationId ?? null,
-                timeoutMs: commandSources.wait ? normalizeWaitTimeoutMs(argv.timeoutMs) : null,
-                wait: commandSources.wait,
-            });
-            if (exerciseSheetId) {
-                formData.set('exerciseSheetId', exerciseSheetId);
-            }
-            if (translateToLanguages && translateToLanguages.length > 0) {
-                formData.set('translateToLanguages', JSON.stringify(translateToLanguages));
-            }
-            let importResult;
-            try {
-                importResult = await apiClient.importExercise(formData);
-            }
-            catch (error) {
-                throw mapApiErrorToCliError(error);
-            }
-            if (!commandSources.wait) {
-                const jobs = [
-                    buildQueuedExerciseImportJob({
-                        jobId: importResult.jobId,
-                        sources,
-                    }),
-                ];
-                const summary = summarizeCliImportJobs({
-                    jobs,
-                    sourceCount: sources.length,
-                    sourceInputCount: commandSources.sources.length,
-                    timedOut: false,
-                });
-                context.output.print({
-                    request,
-                    sources,
-                    jobs,
-                    summary,
-                }, (result) => formatQueuedImportOutput(result.jobs[0]), {
-                    command: 'exercise import',
-                });
-                return;
-            }
-            const waitTimeoutMs = normalizeWaitTimeoutMs(argv.timeoutMs);
-            const waitResult = await waitForCliJobs({
-                getUserJob: async (jobId) => await apiClient.getUserJob(jobId),
-                jobIds: [importResult.jobId],
-                now: context.now,
-                sleep: context.sleep,
-                timeoutMs: waitTimeoutMs,
-            });
-            const waitedJob = waitResult.jobs[0];
-            const jobs = [
-                buildWaitedExerciseImportJob({
-                    jobId: importResult.jobId,
-                    sources,
-                    waitedJob: waitedJob == null
-                        ? undefined
-                        : {
-                            ...waitedJob,
-                            id: waitedJob.id,
-                            status: waitedJob.status,
-                        },
-                }),
-            ];
-            const summary = summarizeCliImportJobs({
-                jobs,
-                sourceCount: sources.length,
-                sourceInputCount: commandSources.sources.length,
-                timedOut: waitResult.timedOut,
-            });
-            const waitError = getWaitError({
-                jobs: waitResult.jobs,
-                timedOut: waitResult.timedOut,
-            });
-            context.output.print({
-                request: {
-                    ...request,
-                    timeoutMs: waitTimeoutMs,
-                },
-                sources,
-                jobs,
-                summary,
-            }, (result) => formatWaitedImportOutput(result.jobs[0]), {
-                command: 'exercise import',
-                ok: waitError == null,
-                error: waitError,
-            });
-            throwSilentExitCode(getWaitExitCode({ jobs: waitResult.jobs, timedOut: waitResult.timedOut }));
-        }
-        catch (error) {
-            throw error;
-        }
-        finally {
-            await cleanupResolvedSources(resolvedSources);
-        }
-    })
-        .command('import-solution [exerciseId] [sources..]', 'Import one or more exercise solution files', (importSolutionYargs) => importSolutionYargs
-        .positional('exerciseId', {
-        type: 'string',
-        describe: 'Exercise ID to attach the imported solution to',
-    })
-        .positional('sources', {
-        array: true,
-        type: 'string',
-        describe: 'Local file paths, directories, or HTTP(S) URLs',
-    })
-        .option('manifest', {
-        type: 'string',
-        describe: 'Load sources from a manifest file, or "-" for stdin',
-    })
-        .option('relative-path', {
-        type: 'string',
-        describe: 'Override the relative path for a single positional source',
-    })
-        .option('timeout-ms', {
-        type: 'number',
-        default: 300000,
-        describe: 'Maximum time to wait before timing out',
-    })
-        .option('wait', {
-        type: 'boolean',
-        default: false,
-        describe: 'Wait for the queued job to finish',
-    })
-        .example('chalksurf exercise import-solution 00000000-0000-4000-8000-000000000001 ./fixtures/solution.pdf --wait', 'Attach a solution file to an existing exercise')
-        .example('cat exercise-solution-import.json | chalksurf --profile prod-codex exercise import-solution --manifest - --wait --json', 'Drive solution imports from a manifest in an agent or CI flow')
-        .epilogue('When --wait is set, the command exits after the queued import job reaches a terminal state.'), async (argv) => {
-        const config = await context.configStore.loadProfile({ profileName: argv.profile });
-        const rawSources = (argv.sources ?? []).map(String);
-        const manifestPath = argv.manifest === '' ? '-' : argv.manifest;
-        const normalizedRawSources = manifestPath === '-' && rawSources[0] === '-' ? rawSources.slice(1) : rawSources;
-        const resolvedBaseUrl = requireResolvedBaseUrl({
-            flagValue: argv.baseUrl,
-            env: context.env,
-            config,
-        });
-        const resolvedToken = requireResolvedToken({
-            env: context.env,
-            config,
-        });
-        const commandSources = await buildFileImportCommandSources({
-            cwd: context.cwd,
-            loadManifest: loadExerciseSolutionImportManifest,
-            manifestPath,
-            rawSources: normalizedRawSources,
-            relativePath: argv.relativePath,
-            stdin: context.stdin,
-            wait: argv.wait,
-        });
-        const organizationId = resolveRequestedOrganizationId({
-            flagValue: argv.organization,
-            fallbackValue: commandSources.organizationId,
-            env: context.env,
-            config,
-        });
-        const exerciseId = resolveRequestedUuid({
-            flagValue: argv.exerciseId,
-            fallbackValue: commandSources.exerciseId,
-            label: 'exerciseId',
-            required: true,
-        });
-        const apiClient = createApiClient({
-            baseUrl: resolvedBaseUrl.value,
-            token: resolvedToken.value,
-            organizationId,
-        });
-        let resolvedSources = [];
-        try {
-            resolvedSources = await resolveSources({
-                cwd: context.cwd,
-                sources: commandSources.sources,
-            });
-            const sources = buildCliImportSources({
-                resolvedSources,
-            });
-            const formData = await buildFileImportFormData(resolvedSources);
-            formData.set('exerciseId', exerciseId);
-            const request = buildExerciseImportRequest({
-                exerciseId,
-                inputMode: manifestPath ? 'manifest' : 'arguments',
-                organizationId: organizationId ?? null,
-                timeoutMs: commandSources.wait ? normalizeWaitTimeoutMs(argv.timeoutMs) : null,
-                wait: commandSources.wait,
-            });
-            let importResult;
-            try {
-                importResult = await apiClient.importExerciseSolution(formData);
-            }
-            catch (error) {
-                throw mapApiErrorToCliError(error);
-            }
-            if (!commandSources.wait) {
-                const jobs = [
-                    buildQueuedExerciseImportJob({
-                        jobId: importResult.jobId,
-                        sources,
-                    }),
-                ];
-                const summary = summarizeCliImportJobs({
-                    jobs,
-                    sourceCount: sources.length,
-                    sourceInputCount: commandSources.sources.length,
-                    timedOut: false,
-                });
-                context.output.print({
-                    request,
-                    sources,
-                    jobs,
-                    summary,
-                }, (result) => formatQueuedSolutionImportOutput(result.jobs[0]), {
-                    command: 'exercise import-solution',
-                });
-                return;
-            }
-            const waitTimeoutMs = normalizeWaitTimeoutMs(argv.timeoutMs);
-            const waitResult = await waitForCliJobs({
-                getUserJob: async (jobId) => await apiClient.getUserJob(jobId),
-                jobIds: [importResult.jobId],
-                now: context.now,
-                sleep: context.sleep,
-                timeoutMs: waitTimeoutMs,
-            });
-            const waitedJob = waitResult.jobs[0];
-            const jobs = [
-                buildWaitedExerciseImportJob({
-                    jobId: importResult.jobId,
-                    sources,
-                    waitedJob: waitedJob == null
-                        ? undefined
-                        : {
-                            ...waitedJob,
-                            id: waitedJob.id,
-                            status: waitedJob.status,
-                        },
-                }),
-            ];
-            const summary = summarizeCliImportJobs({
-                jobs,
-                sourceCount: sources.length,
-                sourceInputCount: commandSources.sources.length,
-                timedOut: waitResult.timedOut,
-            });
-            const waitError = getWaitError({
-                jobs: waitResult.jobs,
-                timedOut: waitResult.timedOut,
-            });
-            context.output.print({
-                request: {
-                    ...request,
-                    timeoutMs: waitTimeoutMs,
-                },
-                sources,
-                jobs,
-                summary,
-            }, (result) => formatWaitedImportOutput(result.jobs[0]), {
-                command: 'exercise import-solution',
-                ok: waitError == null,
-                error: waitError,
-            });
-            throwSilentExitCode(getWaitExitCode({ jobs: waitResult.jobs, timedOut: waitResult.timedOut }));
-        }
-        finally {
-            await cleanupResolvedSources(resolvedSources);
-        }
-    })
-        .demandCommand(1)
-        .strict();
-};