@exercode/problem-utils 4.3.4 → 4.3.6

package/dist/helpers/spawnWithLimits.js.map

@@ -1 +1 @@
-{"version":3,"file":"spawnWithLimits.js","names":["path","fs","os","childProcess","killGracePeriodMilliseconds","timeCommand","resolveTimeCommand","isTimeCommandAvailable","liveSubprocesses","subprocess","killSubprocessGroup","spawnWithLimits","timeOutput","openUnlinkedFile","detached","boundedCommand","context","command","spawnedCommand","timeLimitMilliseconds","startTimeMilliseconds","stdoutChunks","stderrChunks","outputBytes","timedOut","outputLimitExceeded","wallTimeSeconds","spawnErrorMessage","appendOutputChunk","chunk","remainingBytes","appendedChunk","chunks","timeout","killTimeout","settled","pendingError","closeTimeout","settle","reject","resolve","code","exitSignal","failAfterClose","error","timeResult","parseTimeOutput","readTail","endedByTimeout","status","timeLimitSeconds","signal","hasErrorCode","directory","prefix","file","length","size","maxBytes","buffer","match","content","parseSeconds","text","result"],"sources":["../../src/helpers/spawnWithLimits.ts"],"sourcesContent":["import childProcess from 'node:child_process';\nimport fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\nimport { hasErrorCode } from '@willbooster/shared-lib';\n\nexport interface SpawnWithLimitsResult {\n  stdout: string;\n  stderr: string;\n  status: number | undefined;\n  signal: NodeJS.Signals | undefined;\n  /** Wall time measured by GNU time, or measured here until the command exited when it produced none. */\n  timeSeconds: number;\n  /**\n   * User plus system CPU time of the command and the descendants it waited for, measured by GNU\n   * time, or 0 when it produced no measurement. A run `timeout` ended is measured too, so a caller\n   * can tell a program that used up its time limit from one that waited for the CPU.\n   */\n  cpuTimeSeconds: number;\n  /**\n   * Peak resident set size measured by GNU time, or 0 when it produced no measurement. GNU time\n   * measures its child `timeout` and the descendants it waited for, so the value is at least\n   * `timeout`'s own footprint (about 1 MiB), which only shows for the smallest native programs.\n   */\n  memoryBytes: number;\n  /** The note GNU time adds when the command exits abnormally, e.g. `Command terminated by signal 11`. */\n  timeCommandMessage: string | undefined;\n  timedOut: boolean;\n  outputLimitExceeded: boolean;\n}\n\nconst killGracePeriodMilliseconds = 1000;\nconst MIN_TIMEOUT_SECONDS = 0.001;\n// GNU `timeout` exits with 124 after ending a run at its limit, or with 128 + SIGKILL when the run\n// ignored its SIGTERM and it had to be killed after the grace period.\nconst TIMEOUT_EXIT_STATUS = 124;\nconst KILLED_AFTER_TIMEOUT_EXIT_STATUS = 137;\n// GNU time writes its record to a file this process opened and unlinked at once, handed down as fd 3\n// of the command and reopened by GNU time through `/dev/fd`: the command runs as the same OS user,\n// so a record reachable by path could be swapped for a fake or for a FIFO that blocks the read.\nconst TIME_OUTPUT_FD = 3;\n// The command inherits that descriptor too, so only the tail that can hold GNU time's record is read.\nconst TIME_OUTPUT_TAIL_BYTES = 4096;\nconst timeCommand = resolveTimeCommand();\n\n/** Whether GNU time is available, i.e. whether `timeSeconds`, `cpuTimeSeconds`, and `memoryBytes` are measured at all. */\nexport const isTimeCommandAvailable = timeCommand !== undefined;\n\n// The commands run in their own sessions, so they outlive this process unless it ends them itself\n// on the way out (e.g. a preset's SIGINT handler calling `process.exit`).\nconst liveSubprocesses = new Set<childProcess.ChildProcess>();\nprocess.once('exit', () => {\n  for (const subprocess of liveSubprocesses) killSubprocessGroup(subprocess, 'SIGKILL');\n});\n\n/**\n * Runs a command in its own process group with `stdin` piped in, killing the whole group once it\n * exceeds the time or output limit, and reports the wall time, CPU time, and peak memory measured\n * by GNU time.\n */\nexport async function spawnWithLimits(\n  command: readonly [string, ...string[]],\n  context: {\n    cwd: string;\n    env: NodeJS.ProcessEnv;\n    outputLimitBytes: number;\n    stdin: string;\n    timeLimitSeconds: number;\n  }\n): Promise<SpawnWithLimitsResult> {\n  const timeOutput = timeCommand === undefined ? undefined : await openUnlinkedFile('exercode-time-');\n  try {\n    const detached = process.platform !== 'win32';\n    // The command runs in its own session so the group kill below cannot hit this process, but that\n    // also puts it out of reach of whoever kills this process. GNU `timeout` keeps the run bounded\n    // in that case, and it is what normally ends a run at its limit: GNU time wraps it, so a run\n    // that hit the limit still gets its CPU time recorded (a group kill from here would take GNU\n    // time down with the command), and `--foreground` keeps the command in this group so the kill\n    // below still reaches every descendant. The timers below only back `timeout` up. Should this\n    // process die first, `timeout` ends the command alone (`--foreground` signals no descendant),\n    // an accepted gap: the judge server sweeps every process of the request's sandbox user anyway.\n    const boundedCommand: readonly [string, ...string[]] = detached\n      ? [\n          'timeout',\n          '--foreground',\n          '-k',\n          String(killGracePeriodMilliseconds / 1000),\n          // A zero duration would disable `timeout`; the front matter allows a zero time limit.\n          String(Math.max(context.timeLimitSeconds, MIN_TIMEOUT_SECONDS)),\n          ...command,\n        ]\n      : command;\n    const spawnedCommand: readonly [string, ...string[]] =\n      timeCommand === undefined\n        ? boundedCommand\n        : [...timeCommand, `--output=/dev/fd/${TIME_OUTPUT_FD}`, ...boundedCommand];\n    // `timeout` sends SIGKILL a grace period after its SIGTERM; the timers here fire once even that\n    // should have ended the run.\n    const timeLimitMilliseconds = detached\n      ? context.timeLimitSeconds * 1000 + 2 * killGracePeriodMilliseconds\n      : context.timeLimitSeconds * 1000;\n    // Monotonic: a wall-clock step must not turn a run `timeout` ended into one that finished in time.\n    const startTimeMilliseconds = performance.now();\n    // The standard streams are always pipes; the type cannot express that with the extra entry.\n    const subprocess = childProcess.spawn(spawnedCommand[0], spawnedCommand.slice(1), {\n      cwd: context.cwd,\n      detached,\n      env: context.env,\n      stdio: timeOutput === undefined ? ['pipe', 'pipe', 'pipe'] : ['pipe', 'pipe', 'pipe', timeOutput.fd],\n    }) as childProcess.ChildProcessWithoutNullStreams;\n    liveSubprocesses.add(subprocess);\n\n    const stdoutChunks: Buffer[] = [];\n    const stderrChunks: Buffer[] = [];\n    let outputBytes = 0;\n    let timedOut = false;\n    let outputLimitExceeded = false;\n    let wallTimeSeconds = 0;\n    let spawnErrorMessage: string | undefined;\n\n    const appendOutputChunk = (chunks: Buffer[], chunk: Buffer): void => {\n      if (outputBytes >= context.outputLimitBytes) {\n        if (chunk.byteLength > 0) {\n          outputLimitExceeded = true;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n        }\n        return;\n      }\n\n      const remainingBytes = context.outputLimitBytes - outputBytes;\n      const appendedChunk = chunk.byteLength > remainingBytes ? chunk.subarray(0, remainingBytes) : chunk;\n      chunks.push(appendedChunk);\n      outputBytes += appendedChunk.byteLength;\n\n      if (chunk.byteLength > remainingBytes) {\n        outputLimitExceeded = true;\n        killSubprocessGroup(subprocess, 'SIGKILL');\n      }\n    };\n\n    subprocess.stdout.on('data', (chunk: Buffer) => appendOutputChunk(stdoutChunks, chunk));\n    subprocess.stderr.on('data', (chunk: Buffer) => appendOutputChunk(stderrChunks, chunk));\n\n    const timeout = setTimeout(() => {\n      timedOut = true;\n      killSubprocessGroup(subprocess, 'SIGTERM');\n    }, timeLimitMilliseconds);\n    const killTimeout = setTimeout(() => {\n      if (timedOut) killSubprocessGroup(subprocess, 'SIGKILL');\n    }, timeLimitMilliseconds + killGracePeriodMilliseconds);\n    killTimeout.unref();\n\n    const { status, signal } = await new Promise<{ status: number | undefined; signal: NodeJS.Signals | undefined }>(\n      (resolve, reject) => {\n        let settled = false;\n        let pendingError: Error | undefined;\n        let closeTimeout: NodeJS.Timeout | undefined;\n        const settle = (code: number | null | undefined, exitSignal: NodeJS.Signals | null | undefined): void => {\n          if (settled) return;\n          settled = true;\n          clearTimeout(closeTimeout);\n          if (pendingError) {\n            reject(pendingError);\n            return;\n          }\n          resolve({ status: code ?? undefined, signal: exitSignal ?? undefined });\n        };\n        const failAfterClose = (error: Error): void => {\n          if (settled) return;\n          if (subprocess.pid === undefined) {\n            // The spawn itself failed, i.e. the head of the chain (GNU time, or `timeout` without\n            // it, or the command itself on Windows) or the cwd is missing. A missing judged command\n            // is reported as status 127 by the wrapper instead. Report this like a run that produced\n            // only this message.\n            spawnErrorMessage = error.message;\n            settle(undefined, undefined);\n            return;\n          }\n          pendingError = error;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n        };\n        subprocess.on('error', failAfterClose);\n        subprocess.stdin.on('error', (error: NodeJS.ErrnoException) => {\n          if (error.code !== 'EPIPE') failAfterClose(error);\n        });\n        subprocess.on('exit', (code, exitSignal) => {\n          // The command is gone, so the limit timers must not fire during the grace period below. A\n          // descendant that inherited the pipes (e.g. `sleep 1000 &`) would keep them open and hold\n          // back 'close' until it ends: kill what is left of the group. A descendant that moved to\n          // its own session survives that, so stop waiting for the pipes after the grace period and\n          // keep the output read so far.\n          clearTimeout(timeout);\n          clearTimeout(killTimeout);\n          wallTimeSeconds = (performance.now() - startTimeMilliseconds) / 1000;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n          closeTimeout = setTimeout(() => {\n            subprocess.stdout.destroy();\n            subprocess.stderr.destroy();\n            settle(code, exitSignal);\n          }, killGracePeriodMilliseconds);\n        });\n        subprocess.on('close', settle);\n        subprocess.stdin.end(context.stdin);\n      }\n    ).finally(() => {\n      clearTimeout(timeout);\n      clearTimeout(killTimeout);\n      liveSubprocesses.delete(subprocess);\n    });\n\n    const timeResult =\n      timeOutput === undefined ? undefined : parseTimeOutput(await readTail(timeOutput, TIME_OUTPUT_TAIL_BYTES));\n\n    return {\n      stdout: Buffer.concat(stdoutChunks).toString(),\n      stderr: spawnErrorMessage ?? Buffer.concat(stderrChunks).toString(),\n      status,\n      signal,\n      // GNU time rounds a fast run to 0.00; the wall time until 'exit' stands in for it (never the\n      // grace period spent on the pipes afterwards).\n      timeSeconds: timeResult?.timeSeconds || wallTimeSeconds,\n      cpuTimeSeconds: timeResult?.cpuTimeSeconds ?? 0,\n      memoryBytes: timeResult?.memoryBytes ?? 0,\n      timeCommandMessage: timeResult?.message,\n      timedOut: timedOut || endedByTimeout(status, wallTimeSeconds, context.timeLimitSeconds),\n      outputLimitExceeded,\n    };\n  } finally {\n    await timeOutput?.close();\n  }\n}\n\n/**\n * Whether `timeout` ended the run: 124 says it did so at the limit, and 137 that the run ignored its\n * SIGTERM and had to be killed after the grace period. A program can exit with either status on its\n * own, so each is trusted only once the wall time reached the moment `timeout` would have produced it.\n */\nfunction endedByTimeout(status: number | undefined, wallTimeSeconds: number, timeLimitSeconds: number): boolean {\n  if (status === TIMEOUT_EXIT_STATUS) return wallTimeSeconds >= timeLimitSeconds;\n  if (status === KILLED_AFTER_TIMEOUT_EXIT_STATUS) {\n    return wallTimeSeconds >= timeLimitSeconds + killGracePeriodMilliseconds / 1000;\n  }\n  return false;\n}\n\nfunction killSubprocessGroup(subprocess: childProcess.ChildProcess, signal: NodeJS.Signals): void {\n  if (subprocess.pid === undefined) return;\n\n  try {\n    if (process.platform === 'win32') {\n      subprocess.kill(signal);\n      return;\n    }\n    process.kill(-subprocess.pid, signal);\n  } catch (error) {\n    if (!hasErrorCode(error, 'ESRCH') && !hasErrorCode(error, 'EPERM')) throw error;\n  }\n}\n\n// The file is unlinked before it is returned, so nothing can reach it by path anymore.\nasync function openUnlinkedFile(prefix: string): Promise<fs.FileHandle> {\n  const directory = await fs.mkdtemp(path.join(os.tmpdir(), prefix));\n  try {\n    return await fs.open(path.join(directory, 'record'), 'wx+', 0o600);\n  } finally {\n    await fs.rm(directory, { recursive: true, force: true });\n  }\n}\n\nasync function readTail(file: fs.FileHandle, maxBytes: number): Promise<string> {\n  const { size } = await file.stat();\n  const length = Math.min(size, maxBytes);\n  const { buffer } = await file.read(Buffer.alloc(length), 0, length, size - length);\n  return buffer.toString();\n}\n\n// Empty when the command was killed before GNU time wrote its record.\nfunction parseTimeOutput(\n  content: string\n): { timeSeconds: number; cpuTimeSeconds: number; memoryBytes: number; message: string | undefined } | undefined {\n  const match = /(?:^|\\n)(\\d+(?:[.,]\\d+)?) (\\d+(?:[.,]\\d+)?) (\\d+(?:[.,]\\d+)?) (\\d+)\\s*$/.exec(content);\n  if (!match) return undefined;\n\n  return {\n    timeSeconds: parseSeconds(match[1]!),\n    cpuTimeSeconds: parseSeconds(match[2]!) + parseSeconds(match[3]!),\n    memoryBytes: Number(match[4]) * 1024,\n    message: content.slice(0, match.index).trim() || undefined,\n  };\n}\n\n// GNU time formats its seconds with the locale's decimal separator.\nfunction parseSeconds(text: string): number {\n  return Number(text.replace(',', '.'));\n}\n\nfunction resolveTimeCommand(): readonly [string, ...string[]] | undefined {\n  const command = os.platform() === 'darwin' ? 'gtime' : '/usr/bin/time';\n  const result = childProcess.spawnSync(command, ['--version'], { stdio: 'ignore' });\n  if (result.error || result.status !== 0) return undefined;\n\n  // Wall seconds, user CPU seconds, system CPU seconds, peak resident set size in KiB.\n  return [command, '--format', '%e %U %S %M'];\n}\n"],"mappings":"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"}
+{"version":3,"file":"spawnWithLimits.js","names":["path","fs","os","childProcess","killGracePeriodMilliseconds","timeCommand","resolveTimeCommand","isTimeCommandAvailable","liveSubprocesses","subprocess","killSubprocessGroup","spawnWithLimits","timeOutput","openUnlinkedFile","detached","boundedCommand","context","command","spawnedCommand","timeLimitMilliseconds","startTimeMilliseconds","stdoutChunks","stderrChunks","outputBytes","timedOut","outputLimitExceeded","wallTimeSeconds","spawnErrorMessage","appendOutputChunk","chunk","remainingBytes","appendedChunk","chunks","timeout","killTimeout","settled","pendingError","closeTimeout","settle","reject","resolve","code","exitSignal","failAfterClose","error","timeResult","parseTimeOutput","readTail","endedByTimeout","status","timeLimitSeconds","signal","hasErrorCode","directory","prefix","file","length","size","maxBytes","buffer","match","content","parseSeconds","text","result"],"sources":["../../src/helpers/spawnWithLimits.ts"],"sourcesContent":["import childProcess from 'node:child_process';\nimport fs from 'node:fs/promises';\nimport os from 'node:os';\nimport path from 'node:path';\n\nimport { hasErrorCode } from '@willbooster/shared-lib';\n\nexport interface SpawnWithLimitsResult {\n  stdout: string;\n  stderr: string;\n  status: number | undefined;\n  signal: NodeJS.Signals | undefined;\n  /** Wall time measured by GNU time, or measured here until the command exited when it produced none. */\n  timeSeconds: number;\n  /**\n   * User plus system CPU time of the command and the descendants it waited for, measured by GNU\n   * time, or 0 when it produced no measurement. A run `timeout` ended is measured too, so a caller\n   * can tell a program that used up its time limit from one that waited for the CPU.\n   */\n  cpuTimeSeconds: number;\n  /**\n   * Peak resident set size measured by GNU time, or 0 when it produced no measurement. GNU time\n   * measures its child `timeout` and the descendants it waited for, so the value is at least\n   * `timeout`'s own footprint (about 1 MiB), which only shows for the smallest native programs.\n   */\n  memoryBytes: number;\n  /** The note GNU time adds when the command exits abnormally, e.g. `Command terminated by signal 11`. */\n  timeCommandMessage: string | undefined;\n  timedOut: boolean;\n  outputLimitExceeded: boolean;\n}\n\nconst killGracePeriodMilliseconds = 1000;\nconst MIN_TIMEOUT_SECONDS = 0.001;\n// GNU `timeout` exits with 124 after ending a run at its limit, or with 128 + SIGKILL when the run\n// ignored its SIGTERM and it had to be killed after the grace period.\nconst TIMEOUT_EXIT_STATUS = 124;\nconst KILLED_AFTER_TIMEOUT_EXIT_STATUS = 137;\n// GNU time writes its record to a file this process opened and unlinked at once, handed down as fd 3\n// of the command and reopened by GNU time through `/dev/fd`: the command runs as the same OS user,\n// so a record reachable by path could be swapped for a fake or for a FIFO that blocks the read.\nconst TIME_OUTPUT_FD = 3;\n// The command inherits that descriptor too, so only the tail that can hold GNU time's record is read.\nconst TIME_OUTPUT_TAIL_BYTES = 4096;\nconst timeCommand = resolveTimeCommand();\n\n/** Whether GNU time is available, i.e. whether `timeSeconds`, `cpuTimeSeconds`, and `memoryBytes` are measured at all. */\nexport const isTimeCommandAvailable = timeCommand !== undefined;\n\n// The commands run in their own sessions, so they outlive this process unless it ends them itself\n// on the way out (e.g. a preset's SIGINT handler calling `process.exit`).\nconst liveSubprocesses = new Set<childProcess.ChildProcess>();\nprocess.once('exit', () => {\n  for (const subprocess of liveSubprocesses) killSubprocessGroup(subprocess, 'SIGKILL');\n});\n\n/**\n * Runs a command in its own process group with `stdin` piped in, killing the whole group once it\n * exceeds the time or output limit, and reports the wall time, CPU time, and peak memory measured\n * by GNU time.\n */\nexport async function spawnWithLimits(\n  command: readonly [string, ...string[]],\n  context: {\n    cwd: string;\n    env: NodeJS.ProcessEnv;\n    outputLimitBytes: number;\n    stdin: string;\n    timeLimitSeconds: number;\n  }\n): Promise<SpawnWithLimitsResult> {\n  const timeOutput = timeCommand === undefined ? undefined : await openUnlinkedFile('exercode-time-');\n  try {\n    const detached = process.platform !== 'win32';\n    // The command runs in its own session so the group kill below cannot hit this process, but that\n    // also puts it out of reach of whoever kills this process. GNU `timeout` keeps the run bounded\n    // in that case, and it is what normally ends a run at its limit: GNU time wraps it, so a run\n    // that hit the limit still gets its CPU time recorded (a group kill from here would take GNU\n    // time down with the command), and `--foreground` keeps the command in this group so the kill\n    // below still reaches every descendant. The timers below only back `timeout` up. Should this\n    // process die first, `timeout` ends the command alone (`--foreground` signals no descendant),\n    // an accepted gap: the judge server sweeps every process of the request's sandbox user anyway.\n    const boundedCommand: readonly [string, ...string[]] = detached\n      ? [\n          'timeout',\n          '--foreground',\n          '-k',\n          String(killGracePeriodMilliseconds / 1000),\n          // A zero duration would disable `timeout`; the front matter allows a zero time limit.\n          String(Math.max(context.timeLimitSeconds, MIN_TIMEOUT_SECONDS)),\n          ...command,\n        ]\n      : command;\n    const spawnedCommand: readonly [string, ...string[]] =\n      timeCommand === undefined\n        ? boundedCommand\n        : [...timeCommand, `--output=/dev/fd/${TIME_OUTPUT_FD}`, ...boundedCommand];\n    // `timeout` sends SIGKILL a grace period after its SIGTERM; the timers here fire once even that\n    // should have ended the run.\n    const timeLimitMilliseconds = detached\n      ? context.timeLimitSeconds * 1000 + 2 * killGracePeriodMilliseconds\n      : context.timeLimitSeconds * 1000;\n    // Monotonic: a wall-clock step must not turn a run `timeout` ended into one that finished in time.\n    const startTimeMilliseconds = performance.now();\n    // The standard streams are always pipes; the type cannot express that with the extra entry.\n    const subprocess = childProcess.spawn(spawnedCommand[0], spawnedCommand.slice(1), {\n      cwd: context.cwd,\n      detached,\n      env: context.env,\n      stdio: timeOutput === undefined ? ['pipe', 'pipe', 'pipe'] : ['pipe', 'pipe', 'pipe', timeOutput.fd],\n    }) as childProcess.ChildProcessWithoutNullStreams;\n    liveSubprocesses.add(subprocess);\n\n    const stdoutChunks: Buffer[] = [];\n    const stderrChunks: Buffer[] = [];\n    let outputBytes = 0;\n    let timedOut = false;\n    let outputLimitExceeded = false;\n    let wallTimeSeconds = 0;\n    let spawnErrorMessage: string | undefined;\n\n    const appendOutputChunk = (chunks: Buffer[], chunk: Buffer): void => {\n      if (outputBytes >= context.outputLimitBytes) {\n        if (chunk.byteLength > 0) {\n          outputLimitExceeded = true;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n        }\n        return;\n      }\n\n      const remainingBytes = context.outputLimitBytes - outputBytes;\n      const appendedChunk = chunk.byteLength > remainingBytes ? chunk.subarray(0, remainingBytes) : chunk;\n      chunks.push(appendedChunk);\n      outputBytes += appendedChunk.byteLength;\n\n      if (chunk.byteLength > remainingBytes) {\n        outputLimitExceeded = true;\n        killSubprocessGroup(subprocess, 'SIGKILL');\n      }\n    };\n\n    subprocess.stdout.on('data', (chunk: Buffer) => appendOutputChunk(stdoutChunks, chunk));\n    subprocess.stderr.on('data', (chunk: Buffer) => appendOutputChunk(stderrChunks, chunk));\n\n    const timeout = setTimeout(() => {\n      timedOut = true;\n      killSubprocessGroup(subprocess, 'SIGTERM');\n    }, timeLimitMilliseconds);\n    const killTimeout = setTimeout(() => {\n      if (timedOut) killSubprocessGroup(subprocess, 'SIGKILL');\n    }, timeLimitMilliseconds + killGracePeriodMilliseconds);\n    killTimeout.unref();\n\n    const { status, signal } = await new Promise<{ status: number | undefined; signal: NodeJS.Signals | undefined }>(\n      (resolve, reject) => {\n        let settled = false;\n        let pendingError: Error | undefined;\n        let closeTimeout: NodeJS.Timeout | undefined;\n        const settle = (code: number | null | undefined, exitSignal: NodeJS.Signals | null | undefined): void => {\n          if (settled) return;\n          settled = true;\n          clearTimeout(closeTimeout);\n          if (pendingError) {\n            reject(pendingError);\n            return;\n          }\n          resolve({ status: code ?? undefined, signal: exitSignal ?? undefined });\n        };\n        const failAfterClose = (error: Error): void => {\n          if (settled) return;\n          if (subprocess.pid === undefined) {\n            // The spawn itself failed, i.e. the head of the chain (GNU time, or `timeout` without\n            // it, or the command itself on Windows) or the cwd is missing. A missing judged command\n            // is reported as status 127 by the wrapper instead. Report this like a run that produced\n            // only this message.\n            spawnErrorMessage = error.message;\n            settle(undefined, undefined);\n            return;\n          }\n          pendingError = error;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n        };\n        subprocess.on('error', failAfterClose);\n        subprocess.stdin.on('error', (error: NodeJS.ErrnoException) => {\n          if (error.code !== 'EPIPE') failAfterClose(error);\n        });\n        subprocess.on('exit', (code, exitSignal) => {\n          // The command is gone, so the limit timers must not fire during the grace period below. A\n          // descendant that inherited the pipes (e.g. `sleep 1000 &`) would keep them open and hold\n          // back 'close' until it ends: kill what is left of the group. A descendant that moved to\n          // its own session survives that, so stop waiting for the pipes after the grace period and\n          // keep the output read so far.\n          clearTimeout(timeout);\n          clearTimeout(killTimeout);\n          wallTimeSeconds = (performance.now() - startTimeMilliseconds) / 1000;\n          killSubprocessGroup(subprocess, 'SIGKILL');\n          closeTimeout = setTimeout(() => {\n            subprocess.stdout.destroy();\n            subprocess.stderr.destroy();\n            settle(code, exitSignal);\n          }, killGracePeriodMilliseconds);\n        });\n        subprocess.on('close', settle);\n        subprocess.stdin.end(context.stdin);\n      }\n    ).finally(() => {\n      clearTimeout(timeout);\n      clearTimeout(killTimeout);\n      liveSubprocesses.delete(subprocess);\n    });\n\n    const timeResult =\n      timeOutput === undefined ? undefined : parseTimeOutput(await readTail(timeOutput, TIME_OUTPUT_TAIL_BYTES));\n\n    return {\n      stdout: Buffer.concat(stdoutChunks).toString(),\n      stderr: spawnErrorMessage ?? Buffer.concat(stderrChunks).toString(),\n      status,\n      signal,\n      // GNU time rounds a fast run to 0.00; the wall time until 'exit' stands in for it (never the\n      // grace period spent on the pipes afterwards).\n      timeSeconds: timeResult?.timeSeconds || wallTimeSeconds,\n      cpuTimeSeconds: timeResult?.cpuTimeSeconds ?? 0,\n      memoryBytes: timeResult?.memoryBytes ?? 0,\n      timeCommandMessage: timeResult?.message,\n      timedOut: timedOut || endedByTimeout(status, wallTimeSeconds, context.timeLimitSeconds),\n      outputLimitExceeded,\n    };\n  } finally {\n    await timeOutput?.close();\n  }\n}\n\n/**\n * Whether `timeout` ended the run: 124 says it did so at the limit, and 137 that the run ignored its\n * SIGTERM and had to be killed after the grace period. A program can exit with either status on its\n * own, so each is trusted only once the wall time reached the moment `timeout` would have produced it.\n */\nfunction endedByTimeout(status: number | undefined, wallTimeSeconds: number, timeLimitSeconds: number): boolean {\n  if (status === TIMEOUT_EXIT_STATUS) return wallTimeSeconds >= timeLimitSeconds;\n  if (status === KILLED_AFTER_TIMEOUT_EXIT_STATUS) {\n    return wallTimeSeconds >= timeLimitSeconds + killGracePeriodMilliseconds / 1000;\n  }\n  return false;\n}\n\nfunction killSubprocessGroup(subprocess: childProcess.ChildProcess, signal: NodeJS.Signals): void {\n  if (subprocess.pid === undefined) return;\n\n  try {\n    if (process.platform === 'win32') {\n      subprocess.kill(signal);\n      return;\n    }\n    process.kill(-subprocess.pid, signal);\n  } catch (error) {\n    if (!hasErrorCode(error, 'ESRCH') && !hasErrorCode(error, 'EPERM')) throw error;\n  }\n}\n\n// The file is unlinked before it is returned, so nothing can reach it by path anymore.\nasync function openUnlinkedFile(prefix: string): Promise<fs.FileHandle> {\n  const directory = await fs.mkdtemp(path.join(os.tmpdir(), prefix));\n  try {\n    return await fs.open(path.join(directory, 'record'), 'wx+', 0o600);\n  } finally {\n    await fs.rm(directory, { recursive: true, force: true });\n  }\n}\n\nasync function readTail(file: fs.FileHandle, maxBytes: number): Promise<string> {\n  const { size } = await file.stat();\n  const length = Math.min(size, maxBytes);\n  const { buffer } = await file.read(Buffer.alloc(length), 0, length, size - length);\n  return buffer.toString();\n}\n\n// Empty when the command was killed before GNU time wrote its record.\nfunction parseTimeOutput(\n  content: string\n): { timeSeconds: number; cpuTimeSeconds: number; memoryBytes: number; message: string | undefined } | undefined {\n  const match = /(?:^|\\n)(\\d+(?:[.,]\\d+)?) (\\d+(?:[.,]\\d+)?) (\\d+(?:[.,]\\d+)?) (\\d+)\\s*$/.exec(content);\n  if (!match) return undefined;\n\n  return {\n    timeSeconds: parseSeconds(match[1]!),\n    cpuTimeSeconds: parseSeconds(match[2]!) + parseSeconds(match[3]!),\n    memoryBytes: Number(match[4]) * 1024,\n    message: content.slice(0, match.index).trim() || undefined,\n  };\n}\n\n// GNU time formats its seconds with the locale's decimal separator.\nfunction parseSeconds(text: string): number {\n  return Number(text.replace(',', '.'));\n}\n\nfunction resolveTimeCommand(): readonly [string, ...string[]] | undefined {\n  const command = os.platform() === 'darwin' ? 'gtime' : '/usr/bin/time';\n  const result = childProcess.spawnSync(command, ['--version'], { stdio: 'ignore' });\n  if (result.error || result.status !== 0) return undefined;\n\n  // Wall seconds, user CPU seconds, system CPU seconds, peak resident set size in KiB.\n  return [command, '--format', '%e %U %S %M'];\n}\n"],"mappings":"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"}

package/dist/learningMaterial/validateContest.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validateContest.cjs","names":["isRegularFile","isFile","basename","CONTEST_MATERIAL_FILE_SUFFIX","LEARNING_MATERIAL_ID_REGEX","parseYaml","readFile","getErrorMessage","contestFileSchema","formatZodIssues","mergeSubmissionPeriods","collectProblemIdsFromDirectory","require_schemas","require_fsHelpers","require_validationResult","require_validateMaterial","node_path","node_fs_promises","_willbooster_shared_lib","yaml","validateContestFile","errors","warnings","result","contestFilePath","fileName","contestId","rawContent","error","parsed","options","division","problem","availableProblemIds"],"sources":["../../src/learningMaterial/validateContest.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { basename } from 'node:path';\nimport { getErrorMessage } from '@willbooster/shared-lib';\nimport { parse as parseYaml } from 'yaml';\nimport { collectProblemIdsFromDirectory, isFile, isRegularFile, reportDanglingProblemReferences } from './fsHelpers.js';\nimport { CONTEST_MATERIAL_FILE_SUFFIX, contestFileSchema, LEARNING_MATERIAL_ID_REGEX } from './schemas.js';\nimport {\n  mergeSubmissionPeriods,\n  reportForeignProblemCourseIds,\n  validateSubmissionPeriods,\n  type SubmissionPeriods,\n} from './validateMaterial.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\nexport interface ContestValidationOptions {\n  /** When set, every contest problem ID must be a problem discovered under this path. */\n  problemsDirectoryPath?: string;\n  /** Problem IDs already collected for the enclosing course; collected from `problemsDirectoryPath` otherwise. */\n  availableProblemIds?: ReadonlySet<string>;\n  /** Enclosing course ID; the judge rejects problem references whose `courseId` differs from it. */\n  courseId?: string;\n  /** Course-level submission periods; the judge merges them as `material[field] ?? course[field]`. */\n  courseSubmissionPeriods?: SubmissionPeriods;\n  /** Set by course validation, which already warns once about a missing problems directory. */\n  isNestedInCourse?: boolean;\n}\n\n/** Validates a judge contest material (`*.contest.yaml`) file. */\nexport async function validateContestFile(\n  contestFilePath: string,\n  options: ContestValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  // The judge lists lecture entries as regular files, so a symbolic link is skipped at import time.\n  if (!(await isRegularFile(contestFilePath))) {\n    errors.push(\n      (await isFile(contestFilePath))\n        ? `contest file is a symbolic link, which the judge ignores; commit a regular file: ${contestFilePath}`\n        : `contest file not found: ${contestFilePath}`\n    );\n    return result;\n  }\n  const fileName = basename(contestFilePath);\n  if (!fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX)) {\n    errors.push(`contest file name must end with ${CONTEST_MATERIAL_FILE_SUFFIX}: ${fileName}`);\n    return result;\n  }\n  const contestId = fileName.slice(0, -CONTEST_MATERIAL_FILE_SUFFIX.length);\n  if (!LEARNING_MATERIAL_ID_REGEX.test(contestId)) {\n    errors.push(\n      `contest ID \"${contestId}\" (file name without ${CONTEST_MATERIAL_FILE_SUFFIX}) must match ${LEARNING_MATERIAL_ID_REGEX}`\n    );\n  }\n\n  let rawContent: unknown;\n  try {\n    rawContent = parseYaml(await readFile(contestFilePath, 'utf8'));\n  } catch (error) {\n    errors.push(`invalid YAML: ${getErrorMessage(error)}`);\n    return result;\n  }\n  const parsed = contestFileSchema.safeParse(rawContent);\n  if (!parsed.success) {\n    errors.push(...formatZodIssues(parsed.error, 'contest'));\n    return result;\n  }\n\n  validateSubmissionPeriods(mergeSubmissionPeriods(parsed.data, options.courseSubmissionPeriods), errors, parsed.data);\n  reportForeignProblemCourseIds(parsed.data.problems, options.courseId, errors);\n  reportDuplicateIds(\n    parsed.data.divisions.map((division) => division.id),\n    'division',\n    errors\n  );\n  reportDuplicateIds(\n    parsed.data.problems.map((problem) => problem.id),\n    'problem',\n    errors\n  );\n\n  let availableProblemIds = options.availableProblemIds;\n  if (availableProblemIds === undefined) {\n    if (options.problemsDirectoryPath === undefined) {\n      if (!options.isNestedInCourse) {\n        warnings.push('no problems directory given (pass --problems-dir); problem references are not checked');\n      }\n    } else {\n      availableProblemIds = await collectProblemIdsFromDirectory(options.problemsDirectoryPath, errors);\n    }\n  }\n  if (availableProblemIds !== undefined) {\n    reportDanglingProblemReferences(\n      parsed.data.problems.map((problem) => problem.id),\n      availableProblemIds,\n      options.problemsDirectoryPath,\n      errors\n    );\n  }\n  return result;\n}\n"],"mappings":"mQA4BA,eAAsBoB,EACpB,EACA,EAAoC,CAAC,EACV,CAC3B,IAAMC,EAAmB,CAAC,EACpBC,EAAqB,CAAC,EACtBC,EAAS,CAAE,SAAQ,UAAS,EAGlC,GAAI,CAAE,MAAMvB,EAAAA,cAAcwB,CAAe,EAMvC,OALAH,EAAO,KACJ,MAAMpB,EAAAA,OAAOuB,CAAe,EACzB,oFAAoFA,IACpF,2BAA2BA,GACjC,EACOD,EAET,IAAME,GAAA,EAAWvB,EAAAA,SAAAA,CAASsB,CAAe,EACzC,GAAI,CAACC,EAAS,SAAA,eAAqC,EAEjD,OADAJ,EAAO,KAAK,mCAAmClB,EAAAA,6BAA6B,IAAIsB,GAAU,EACnFF,EAET,IAAMG,EAAYD,EAAS,MAAM,EAAG,CAACtB,EAAAA,6BAA6B,MAAM,EACnEC,EAAAA,2BAA2B,KAAKsB,CAAS,GAC5CL,EAAO,KACL,eAAeK,EAAU,uBAAuBvB,EAAAA,6BAA6B,eAAeC,EAAAA,4BAC9F,EAGF,IAAIuB,EACJ,GAAI,CACF,GAAA,EAAatB,EAAAA,MAAAA,CAAU,MAAA,EAAMC,EAAAA,SAAAA,CAASkB,EAAiB,MAAM,CAAC,CAChE,OAASI,EAAO,CAEd,OADAP,EAAO,KAAK,kBAAA,EAAiBd,EAAAA,gBAAAA,CAAgBqB,CAAK,GAAG,EAC9CL,CACT,CACA,IAAMM,EAASrB,EAAAA,kBAAkB,UAAUmB,CAAU,EACrD,GAAI,CAACE,EAAO,QAEV,OADAR,EAAO,KAAK,GAAGZ,EAAAA,gBAAgBoB,EAAO,MAAO,SAAS,CAAC,EAChDN,EAGTR,EAAA,0BAA0BL,EAAAA,uBAAuBmB,EAAO,KAAMC,EAAQ,uBAAuB,EAAGT,EAAQQ,EAAO,IAAI,EACnHd,EAAA,8BAA8Bc,EAAO,KAAK,SAAUC,EAAQ,SAAUT,CAAM,EAC5EP,EAAA,mBACEe,EAAO,KAAK,UAAU,IAAK,GAAaE,EAAS,EAAE,EACnD,WACAV,CACF,EACAP,EAAA,mBACEe,EAAO,KAAK,SAAS,IAAK,GAAYG,EAAQ,EAAE,EAChD,UACAX,CACF,EAEA,IAAIY,EAAsBH,EAAQ,oBAkBlC,OAjBIG,IAAwB,IAAA,KACtBH,EAAQ,wBAA0B,IAAA,GAC/BA,EAAQ,kBACXR,EAAS,KAAK,uFAAuF,EAGvG,EAAsB,MAAMX,EAAAA,+BAA+BmB,EAAQ,sBAAuBT,CAAM,GAGhGY,IAAwB,IAAA,IAC1BpB,EAAA,gCACEgB,EAAO,KAAK,SAAS,IAAK,GAAYG,EAAQ,EAAE,EAChDC,EACAH,EAAQ,sBACRT,CACF,EAEKE,CACT"}
+{"version":3,"file":"validateContest.cjs","names":["isRegularFile","isFile","basename","CONTEST_MATERIAL_FILE_SUFFIX","LEARNING_MATERIAL_ID_REGEX","parseYaml","readFile","getErrorMessage","contestFileSchema","formatZodIssues","mergeSubmissionPeriods","collectProblemIdsFromDirectory","require_schemas","require_fsHelpers","require_validationResult","require_validateMaterial","node_path","node_fs_promises","_willbooster_shared_lib","yaml","validateContestFile","errors","warnings","result","contestFilePath","fileName","contestId","rawContent","error","parsed","options","division","problem","availableProblemIds"],"sources":["../../src/learningMaterial/validateContest.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { basename } from 'node:path';\n\nimport { getErrorMessage } from '@willbooster/shared-lib';\nimport { parse as parseYaml } from 'yaml';\n\nimport { collectProblemIdsFromDirectory, isFile, isRegularFile, reportDanglingProblemReferences } from './fsHelpers.js';\nimport { CONTEST_MATERIAL_FILE_SUFFIX, contestFileSchema, LEARNING_MATERIAL_ID_REGEX } from './schemas.js';\nimport {\n  mergeSubmissionPeriods,\n  reportForeignProblemCourseIds,\n  type SubmissionPeriods,\n  validateSubmissionPeriods,\n} from './validateMaterial.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\nexport interface ContestValidationOptions {\n  /** When set, every contest problem ID must be a problem discovered under this path. */\n  problemsDirectoryPath?: string;\n  /** Problem IDs already collected for the enclosing course; collected from `problemsDirectoryPath` otherwise. */\n  availableProblemIds?: ReadonlySet<string>;\n  /** Enclosing course ID; the judge rejects problem references whose `courseId` differs from it. */\n  courseId?: string;\n  /** Course-level submission periods; the judge merges them as `material[field] ?? course[field]`. */\n  courseSubmissionPeriods?: SubmissionPeriods;\n  /** Set by course validation, which already warns once about a missing problems directory. */\n  isNestedInCourse?: boolean;\n}\n\n/** Validates a judge contest material (`*.contest.yaml`) file. */\nexport async function validateContestFile(\n  contestFilePath: string,\n  options: ContestValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  // The judge lists lecture entries as regular files, so a symbolic link is skipped at import time.\n  if (!(await isRegularFile(contestFilePath))) {\n    errors.push(\n      (await isFile(contestFilePath))\n        ? `contest file is a symbolic link, which the judge ignores; commit a regular file: ${contestFilePath}`\n        : `contest file not found: ${contestFilePath}`\n    );\n    return result;\n  }\n  const fileName = basename(contestFilePath);\n  if (!fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX)) {\n    errors.push(`contest file name must end with ${CONTEST_MATERIAL_FILE_SUFFIX}: ${fileName}`);\n    return result;\n  }\n  const contestId = fileName.slice(0, -CONTEST_MATERIAL_FILE_SUFFIX.length);\n  if (!LEARNING_MATERIAL_ID_REGEX.test(contestId)) {\n    errors.push(\n      `contest ID \"${contestId}\" (file name without ${CONTEST_MATERIAL_FILE_SUFFIX}) must match ${LEARNING_MATERIAL_ID_REGEX}`\n    );\n  }\n\n  let rawContent: unknown;\n  try {\n    rawContent = parseYaml(await readFile(contestFilePath, 'utf8'));\n  } catch (error) {\n    errors.push(`invalid YAML: ${getErrorMessage(error)}`);\n    return result;\n  }\n  const parsed = contestFileSchema.safeParse(rawContent);\n  if (!parsed.success) {\n    errors.push(...formatZodIssues(parsed.error, 'contest'));\n    return result;\n  }\n\n  validateSubmissionPeriods(mergeSubmissionPeriods(parsed.data, options.courseSubmissionPeriods), errors, parsed.data);\n  reportForeignProblemCourseIds(parsed.data.problems, options.courseId, errors);\n  reportDuplicateIds(\n    parsed.data.divisions.map((division) => division.id),\n    'division',\n    errors\n  );\n  reportDuplicateIds(\n    parsed.data.problems.map((problem) => problem.id),\n    'problem',\n    errors\n  );\n\n  let availableProblemIds = options.availableProblemIds;\n  if (availableProblemIds === undefined) {\n    if (options.problemsDirectoryPath === undefined) {\n      if (!options.isNestedInCourse) {\n        warnings.push('no problems directory given (pass --problems-dir); problem references are not checked');\n      }\n    } else {\n      availableProblemIds = await collectProblemIdsFromDirectory(options.problemsDirectoryPath, errors);\n    }\n  }\n  if (availableProblemIds !== undefined) {\n    reportDanglingProblemReferences(\n      parsed.data.problems.map((problem) => problem.id),\n      availableProblemIds,\n      options.problemsDirectoryPath,\n      errors\n    );\n  }\n  return result;\n}\n"],"mappings":"mQA8BA,eAAsBoB,EACpB,EACA,EAAoC,CAAC,EACV,CAC3B,IAAMC,EAAmB,CAAC,EACpBC,EAAqB,CAAC,EACtBC,EAAS,CAAE,SAAQ,UAAS,EAGlC,GAAI,CAAE,MAAMvB,EAAAA,cAAcwB,CAAe,EAMvC,OALAH,EAAO,KACJ,MAAMpB,EAAAA,OAAOuB,CAAe,EACzB,oFAAoFA,IACpF,2BAA2BA,GACjC,EACOD,EAET,IAAME,GAAA,EAAWvB,EAAAA,SAAAA,CAASsB,CAAe,EACzC,GAAI,CAACC,EAAS,SAAA,eAAqC,EAEjD,OADAJ,EAAO,KAAK,mCAAmClB,EAAAA,6BAA6B,IAAIsB,GAAU,EACnFF,EAET,IAAMG,EAAYD,EAAS,MAAM,EAAG,CAACtB,EAAAA,6BAA6B,MAAM,EACnEC,EAAAA,2BAA2B,KAAKsB,CAAS,GAC5CL,EAAO,KACL,eAAeK,EAAU,uBAAuBvB,EAAAA,6BAA6B,eAAeC,EAAAA,4BAC9F,EAGF,IAAIuB,EACJ,GAAI,CACF,GAAA,EAAatB,EAAAA,MAAAA,CAAU,MAAA,EAAMC,EAAAA,SAAAA,CAASkB,EAAiB,MAAM,CAAC,CAChE,OAASI,EAAO,CAEd,OADAP,EAAO,KAAK,kBAAA,EAAiBd,EAAAA,gBAAAA,CAAgBqB,CAAK,GAAG,EAC9CL,CACT,CACA,IAAMM,EAASrB,EAAAA,kBAAkB,UAAUmB,CAAU,EACrD,GAAI,CAACE,EAAO,QAEV,OADAR,EAAO,KAAK,GAAGZ,EAAAA,gBAAgBoB,EAAO,MAAO,SAAS,CAAC,EAChDN,EAGTR,EAAA,0BAA0BL,EAAAA,uBAAuBmB,EAAO,KAAMC,EAAQ,uBAAuB,EAAGT,EAAQQ,EAAO,IAAI,EACnHd,EAAA,8BAA8Bc,EAAO,KAAK,SAAUC,EAAQ,SAAUT,CAAM,EAC5EP,EAAA,mBACEe,EAAO,KAAK,UAAU,IAAK,GAAaE,EAAS,EAAE,EACnD,WACAV,CACF,EACAP,EAAA,mBACEe,EAAO,KAAK,SAAS,IAAK,GAAYG,EAAQ,EAAE,EAChD,UACAX,CACF,EAEA,IAAIY,EAAsBH,EAAQ,oBAkBlC,OAjBIG,IAAwB,IAAA,KACtBH,EAAQ,wBAA0B,IAAA,GAC/BA,EAAQ,kBACXR,EAAS,KAAK,uFAAuF,EAGvG,EAAsB,MAAMX,EAAAA,+BAA+BmB,EAAQ,sBAAuBT,CAAM,GAGhGY,IAAwB,IAAA,IAC1BpB,EAAA,gCACEgB,EAAO,KAAK,SAAS,IAAK,GAAYG,EAAQ,EAAE,EAChDC,EACAH,EAAQ,sBACRT,CACF,EAEKE,CACT"}

package/dist/learningMaterial/validateContest.js.map

@@ -1 +1 @@
-{"version":3,"file":"validateContest.js","names":["parseYaml","validateContestFile","errors","warnings","result","isRegularFile","contestFilePath","isFile","fileName","basename","CONTEST_MATERIAL_FILE_SUFFIX","contestId","LEARNING_MATERIAL_ID_REGEX","rawContent","parse","readFile","error","getErrorMessage","parsed","contestFileSchema","formatZodIssues","validateSubmissionPeriods","mergeSubmissionPeriods","options","reportForeignProblemCourseIds","reportDuplicateIds","division","problem","availableProblemIds","collectProblemIdsFromDirectory","reportDanglingProblemReferences"],"sources":["../../src/learningMaterial/validateContest.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { basename } from 'node:path';\nimport { getErrorMessage } from '@willbooster/shared-lib';\nimport { parse as parseYaml } from 'yaml';\nimport { collectProblemIdsFromDirectory, isFile, isRegularFile, reportDanglingProblemReferences } from './fsHelpers.js';\nimport { CONTEST_MATERIAL_FILE_SUFFIX, contestFileSchema, LEARNING_MATERIAL_ID_REGEX } from './schemas.js';\nimport {\n  mergeSubmissionPeriods,\n  reportForeignProblemCourseIds,\n  validateSubmissionPeriods,\n  type SubmissionPeriods,\n} from './validateMaterial.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\nexport interface ContestValidationOptions {\n  /** When set, every contest problem ID must be a problem discovered under this path. */\n  problemsDirectoryPath?: string;\n  /** Problem IDs already collected for the enclosing course; collected from `problemsDirectoryPath` otherwise. */\n  availableProblemIds?: ReadonlySet<string>;\n  /** Enclosing course ID; the judge rejects problem references whose `courseId` differs from it. */\n  courseId?: string;\n  /** Course-level submission periods; the judge merges them as `material[field] ?? course[field]`. */\n  courseSubmissionPeriods?: SubmissionPeriods;\n  /** Set by course validation, which already warns once about a missing problems directory. */\n  isNestedInCourse?: boolean;\n}\n\n/** Validates a judge contest material (`*.contest.yaml`) file. */\nexport async function validateContestFile(\n  contestFilePath: string,\n  options: ContestValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  // The judge lists lecture entries as regular files, so a symbolic link is skipped at import time.\n  if (!(await isRegularFile(contestFilePath))) {\n    errors.push(\n      (await isFile(contestFilePath))\n        ? `contest file is a symbolic link, which the judge ignores; commit a regular file: ${contestFilePath}`\n        : `contest file not found: ${contestFilePath}`\n    );\n    return result;\n  }\n  const fileName = basename(contestFilePath);\n  if (!fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX)) {\n    errors.push(`contest file name must end with ${CONTEST_MATERIAL_FILE_SUFFIX}: ${fileName}`);\n    return result;\n  }\n  const contestId = fileName.slice(0, -CONTEST_MATERIAL_FILE_SUFFIX.length);\n  if (!LEARNING_MATERIAL_ID_REGEX.test(contestId)) {\n    errors.push(\n      `contest ID \"${contestId}\" (file name without ${CONTEST_MATERIAL_FILE_SUFFIX}) must match ${LEARNING_MATERIAL_ID_REGEX}`\n    );\n  }\n\n  let rawContent: unknown;\n  try {\n    rawContent = parseYaml(await readFile(contestFilePath, 'utf8'));\n  } catch (error) {\n    errors.push(`invalid YAML: ${getErrorMessage(error)}`);\n    return result;\n  }\n  const parsed = contestFileSchema.safeParse(rawContent);\n  if (!parsed.success) {\n    errors.push(...formatZodIssues(parsed.error, 'contest'));\n    return result;\n  }\n\n  validateSubmissionPeriods(mergeSubmissionPeriods(parsed.data, options.courseSubmissionPeriods), errors, parsed.data);\n  reportForeignProblemCourseIds(parsed.data.problems, options.courseId, errors);\n  reportDuplicateIds(\n    parsed.data.divisions.map((division) => division.id),\n    'division',\n    errors\n  );\n  reportDuplicateIds(\n    parsed.data.problems.map((problem) => problem.id),\n    'problem',\n    errors\n  );\n\n  let availableProblemIds = options.availableProblemIds;\n  if (availableProblemIds === undefined) {\n    if (options.problemsDirectoryPath === undefined) {\n      if (!options.isNestedInCourse) {\n        warnings.push('no problems directory given (pass --problems-dir); problem references are not checked');\n      }\n    } else {\n      availableProblemIds = await collectProblemIdsFromDirectory(options.problemsDirectoryPath, errors);\n    }\n  }\n  if (availableProblemIds !== undefined) {\n    reportDanglingProblemReferences(\n      parsed.data.problems.map((problem) => problem.id),\n      availableProblemIds,\n      options.problemsDirectoryPath,\n      errors\n    );\n  }\n  return result;\n}\n"],"mappings":"gnBA4BA,eAAsBC,EACpB,EACA,EAAoC,CAAC,EACV,CAC3B,IAAMC,EAAmB,CAAC,EACpBC,EAAqB,CAAC,EACtBC,EAAS,CAAE,SAAQ,UAAS,EAGlC,GAAI,CAAE,MAAMC,EAAcC,CAAe,EAMvC,OALAJ,EAAO,KACJ,MAAMK,EAAOD,CAAe,EACzB,oFAAoFA,IACpF,2BAA2BA,GACjC,EACOF,EAET,IAAMI,EAAWC,EAASH,CAAe,EACzC,GAAI,CAACE,EAAS,SAAA,eAAqC,EAEjD,OADAN,EAAO,KAAK,mCAAmCQ,EAA6B,IAAIF,GAAU,EACnFJ,EAET,IAAMO,EAAYH,EAAS,MAAM,EAAG,CAACE,EAA6B,MAAM,EACnEE,EAA2B,KAAKD,CAAS,GAC5CT,EAAO,KACL,eAAeS,EAAU,uBAAuBD,EAA6B,eAAeE,GAC9F,EAGF,IAAIC,EACJ,GAAI,CACF,EAAab,EAAU,MAAMe,EAAST,EAAiB,MAAM,CAAC,CAChE,OAASU,EAAO,CAEd,OADAd,EAAO,KAAK,iBAAiBe,EAAgBD,CAAK,GAAG,EAC9CZ,CACT,CACA,IAAMc,EAASC,EAAkB,UAAUN,CAAU,EACrD,GAAI,CAACK,EAAO,QAEV,OADAhB,EAAO,KAAK,GAAGkB,EAAgBF,EAAO,MAAO,SAAS,CAAC,EAChDd,EAGTiB,EAA0BC,EAAuBJ,EAAO,KAAMK,EAAQ,uBAAuB,EAAGrB,EAAQgB,EAAO,IAAI,EACnHM,EAA8BN,EAAO,KAAK,SAAUK,EAAQ,SAAUrB,CAAM,EAC5EuB,EACEP,EAAO,KAAK,UAAU,IAAK,GAAaQ,EAAS,EAAE,EACnD,WACAxB,CACF,EACAuB,EACEP,EAAO,KAAK,SAAS,IAAK,GAAYS,EAAQ,EAAE,EAChD,UACAzB,CACF,EAEA,IAAI0B,EAAsBL,EAAQ,oBAkBlC,OAjBIK,IAAwB,IAAA,KACtBL,EAAQ,wBAA0B,IAAA,GAC/BA,EAAQ,kBACXpB,EAAS,KAAK,uFAAuF,EAGvG,EAAsB,MAAM0B,EAA+BN,EAAQ,sBAAuBrB,CAAM,GAGhG0B,IAAwB,IAAA,IAC1BE,EACEZ,EAAO,KAAK,SAAS,IAAK,GAAYS,EAAQ,EAAE,EAChDC,EACAL,EAAQ,sBACRrB,CACF,EAEKE,CACT"}
+{"version":3,"file":"validateContest.js","names":["parseYaml","validateContestFile","errors","warnings","result","isRegularFile","contestFilePath","isFile","fileName","basename","CONTEST_MATERIAL_FILE_SUFFIX","contestId","LEARNING_MATERIAL_ID_REGEX","rawContent","parse","readFile","error","getErrorMessage","parsed","contestFileSchema","formatZodIssues","validateSubmissionPeriods","mergeSubmissionPeriods","options","reportForeignProblemCourseIds","reportDuplicateIds","division","problem","availableProblemIds","collectProblemIdsFromDirectory","reportDanglingProblemReferences"],"sources":["../../src/learningMaterial/validateContest.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { basename } from 'node:path';\n\nimport { getErrorMessage } from '@willbooster/shared-lib';\nimport { parse as parseYaml } from 'yaml';\n\nimport { collectProblemIdsFromDirectory, isFile, isRegularFile, reportDanglingProblemReferences } from './fsHelpers.js';\nimport { CONTEST_MATERIAL_FILE_SUFFIX, contestFileSchema, LEARNING_MATERIAL_ID_REGEX } from './schemas.js';\nimport {\n  mergeSubmissionPeriods,\n  reportForeignProblemCourseIds,\n  type SubmissionPeriods,\n  validateSubmissionPeriods,\n} from './validateMaterial.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\nexport interface ContestValidationOptions {\n  /** When set, every contest problem ID must be a problem discovered under this path. */\n  problemsDirectoryPath?: string;\n  /** Problem IDs already collected for the enclosing course; collected from `problemsDirectoryPath` otherwise. */\n  availableProblemIds?: ReadonlySet<string>;\n  /** Enclosing course ID; the judge rejects problem references whose `courseId` differs from it. */\n  courseId?: string;\n  /** Course-level submission periods; the judge merges them as `material[field] ?? course[field]`. */\n  courseSubmissionPeriods?: SubmissionPeriods;\n  /** Set by course validation, which already warns once about a missing problems directory. */\n  isNestedInCourse?: boolean;\n}\n\n/** Validates a judge contest material (`*.contest.yaml`) file. */\nexport async function validateContestFile(\n  contestFilePath: string,\n  options: ContestValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  // The judge lists lecture entries as regular files, so a symbolic link is skipped at import time.\n  if (!(await isRegularFile(contestFilePath))) {\n    errors.push(\n      (await isFile(contestFilePath))\n        ? `contest file is a symbolic link, which the judge ignores; commit a regular file: ${contestFilePath}`\n        : `contest file not found: ${contestFilePath}`\n    );\n    return result;\n  }\n  const fileName = basename(contestFilePath);\n  if (!fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX)) {\n    errors.push(`contest file name must end with ${CONTEST_MATERIAL_FILE_SUFFIX}: ${fileName}`);\n    return result;\n  }\n  const contestId = fileName.slice(0, -CONTEST_MATERIAL_FILE_SUFFIX.length);\n  if (!LEARNING_MATERIAL_ID_REGEX.test(contestId)) {\n    errors.push(\n      `contest ID \"${contestId}\" (file name without ${CONTEST_MATERIAL_FILE_SUFFIX}) must match ${LEARNING_MATERIAL_ID_REGEX}`\n    );\n  }\n\n  let rawContent: unknown;\n  try {\n    rawContent = parseYaml(await readFile(contestFilePath, 'utf8'));\n  } catch (error) {\n    errors.push(`invalid YAML: ${getErrorMessage(error)}`);\n    return result;\n  }\n  const parsed = contestFileSchema.safeParse(rawContent);\n  if (!parsed.success) {\n    errors.push(...formatZodIssues(parsed.error, 'contest'));\n    return result;\n  }\n\n  validateSubmissionPeriods(mergeSubmissionPeriods(parsed.data, options.courseSubmissionPeriods), errors, parsed.data);\n  reportForeignProblemCourseIds(parsed.data.problems, options.courseId, errors);\n  reportDuplicateIds(\n    parsed.data.divisions.map((division) => division.id),\n    'division',\n    errors\n  );\n  reportDuplicateIds(\n    parsed.data.problems.map((problem) => problem.id),\n    'problem',\n    errors\n  );\n\n  let availableProblemIds = options.availableProblemIds;\n  if (availableProblemIds === undefined) {\n    if (options.problemsDirectoryPath === undefined) {\n      if (!options.isNestedInCourse) {\n        warnings.push('no problems directory given (pass --problems-dir); problem references are not checked');\n      }\n    } else {\n      availableProblemIds = await collectProblemIdsFromDirectory(options.problemsDirectoryPath, errors);\n    }\n  }\n  if (availableProblemIds !== undefined) {\n    reportDanglingProblemReferences(\n      parsed.data.problems.map((problem) => problem.id),\n      availableProblemIds,\n      options.problemsDirectoryPath,\n      errors\n    );\n  }\n  return result;\n}\n"],"mappings":"gnBA8BA,eAAsBC,EACpB,EACA,EAAoC,CAAC,EACV,CAC3B,IAAMC,EAAmB,CAAC,EACpBC,EAAqB,CAAC,EACtBC,EAAS,CAAE,SAAQ,UAAS,EAGlC,GAAI,CAAE,MAAMC,EAAcC,CAAe,EAMvC,OALAJ,EAAO,KACJ,MAAMK,EAAOD,CAAe,EACzB,oFAAoFA,IACpF,2BAA2BA,GACjC,EACOF,EAET,IAAMI,EAAWC,EAASH,CAAe,EACzC,GAAI,CAACE,EAAS,SAAA,eAAqC,EAEjD,OADAN,EAAO,KAAK,mCAAmCQ,EAA6B,IAAIF,GAAU,EACnFJ,EAET,IAAMO,EAAYH,EAAS,MAAM,EAAG,CAACE,EAA6B,MAAM,EACnEE,EAA2B,KAAKD,CAAS,GAC5CT,EAAO,KACL,eAAeS,EAAU,uBAAuBD,EAA6B,eAAeE,GAC9F,EAGF,IAAIC,EACJ,GAAI,CACF,EAAab,EAAU,MAAMe,EAAST,EAAiB,MAAM,CAAC,CAChE,OAASU,EAAO,CAEd,OADAd,EAAO,KAAK,iBAAiBe,EAAgBD,CAAK,GAAG,EAC9CZ,CACT,CACA,IAAMc,EAASC,EAAkB,UAAUN,CAAU,EACrD,GAAI,CAACK,EAAO,QAEV,OADAhB,EAAO,KAAK,GAAGkB,EAAgBF,EAAO,MAAO,SAAS,CAAC,EAChDd,EAGTiB,EAA0BC,EAAuBJ,EAAO,KAAMK,EAAQ,uBAAuB,EAAGrB,EAAQgB,EAAO,IAAI,EACnHM,EAA8BN,EAAO,KAAK,SAAUK,EAAQ,SAAUrB,CAAM,EAC5EuB,EACEP,EAAO,KAAK,UAAU,IAAK,GAAaQ,EAAS,EAAE,EACnD,WACAxB,CACF,EACAuB,EACEP,EAAO,KAAK,SAAS,IAAK,GAAYS,EAAQ,EAAE,EAChD,UACAzB,CACF,EAEA,IAAI0B,EAAsBL,EAAQ,oBAkBlC,OAjBIK,IAAwB,IAAA,KACtBL,EAAQ,wBAA0B,IAAA,GAC/BA,EAAQ,kBACXpB,EAAS,KAAK,uFAAuF,EAGvG,EAAsB,MAAM0B,EAA+BN,EAAQ,sBAAuBrB,CAAM,GAGhG0B,IAAwB,IAAA,IAC1BE,EACEZ,EAAO,KAAK,SAAS,IAAK,GAAYS,EAAQ,EAAE,EAChDC,EACAL,EAAQ,sBACRrB,CACF,EAEKE,CACT"}

package/dist/learningMaterial/validateCourse.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validateCourse.cjs","names":["isRegularDirectory","resolve","isDirectory","realpath","basename","LEARNING_MATERIAL_ID_REGEX","join","dirname","readdir","isRegularFile","isFile","parseYaml","readFile","getErrorMessage","courseFileSchema","formatZodIssues","collectProblemDefinitions","isUsableProblemsDirectory","lstat","relative","sep","CONTEST_MATERIAL_FILE_SUFFIX","validateContestFile","validateMaterialFile","require_schemas","require_fsHelpers","require_validationResult","require_validateMaterial","require_validateContest","node_path","node_fs_promises","_willbooster_shared_lib","yaml","validateCourseDirectory","errors","warnings","result","courseDirectoryPath","absoluteDirectoryPath","explicitProblemsDirectoryPath","options","canonicalize","courseId","parsedCourseFile","parseCourseFile","problemsDirectoryPath","availableProblemIds","collectAvailableProblemIds","coursePeriodErrors","courseFile","courseFileName","error","lectures","lecture","validateLectureDirectory","reportOrphanLectureDirectories","absolutePath","path","lectureIds","dirents","dirent","entry","isMaterialFileName","courseFileNames","presentFileNames","fileName","symlinkFileName","findFirst","courseFilePath","rawContent","parsed","item","items","predicate","definitionPathsById","courseProblemsDirectoryPath","namesConventionalDirectory","isSameEntry","isOutsideDirectory","problemsDirectoryOption","path1","path2","stats1","stats2","relativePath","parentPath","lectureDirectoryPath","lectureId","materialIds","fileNames","f1","f2","materialFilePath","materialResult","materialOptions","warning","duplicateMaterialErrors"],"sources":["../../src/learningMaterial/validateCourse.ts"],"sourcesContent":["import { lstat, readdir, readFile, realpath } from 'node:fs/promises';\nimport { basename, dirname, join, relative, resolve, sep } from 'node:path';\nimport { getErrorMessage } from '@willbooster/shared-lib';\nimport { parse as parseYaml } from 'yaml';\nimport {\n  collectProblemDefinitions,\n  isDirectory,\n  isFile,\n  isRegularDirectory,\n  isRegularFile,\n  isUsableProblemsDirectory,\n  reportProblemDefinitionIssues,\n} from './fsHelpers.js';\nimport {\n  CONTEST_MATERIAL_FILE_SUFFIX,\n  courseFileSchema,\n  LEARNING_MATERIAL_ID_REGEX,\n  type CourseFile,\n} from './schemas.js';\nimport { validateContestFile } from './validateContest.js';\nimport { validateMaterialFile, validateSubmissionPeriods, type MaterialValidationOptions } from './validateMaterial.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\nexport interface CourseValidationOptions {\n  /**\n   * Optional extra check only: problem references always resolve against the problems discovered\n   * inside the course directory, so a given directory must lie inside it (an outside or missing one\n   * is an error).\n   */\n  problemsDirectoryPath?: string;\n}\n\n/** Validates an exercode course directory (course.yaml plus one directory per lecture with material files). */\nexport async function validateCourseDirectory(\n  courseDirectoryPath: string,\n  options: CourseValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  // Course discovery does not traverse a symbolic link, so a linked course directory is never imported.\n  if (!(await isRegularDirectory(resolve(courseDirectoryPath)))) {\n    errors.push(\n      (await isDirectory(resolve(courseDirectoryPath)))\n        ? `course directory is a symbolic link, which the judge does not traverse: ${courseDirectoryPath}`\n        : `course directory not found: ${courseDirectoryPath}`\n    );\n    return result;\n  }\n  // Canonical paths make the \"inside the course\" comparisons below independent of how the caller\n  // spelled either path (e.g. `/var` vs `/private/var` on macOS).\n  const absoluteDirectoryPath = await realpath(courseDirectoryPath);\n  const explicitProblemsDirectoryPath =\n    options.problemsDirectoryPath === undefined ? undefined : await canonicalize(options.problemsDirectoryPath);\n  const courseId = basename(absoluteDirectoryPath);\n  if (!LEARNING_MATERIAL_ID_REGEX.test(courseId)) {\n    errors.push(`course ID \"${courseId}\" (directory name) must match ${LEARNING_MATERIAL_ID_REGEX}`);\n  }\n\n  const parsedCourseFile = await parseCourseFile(absoluteDirectoryPath, errors);\n  // Messages name the course directory because that is what discovery searches (see collectAvailableProblemIds).\n  const problemsDirectoryPath = absoluteDirectoryPath;\n  const availableProblemIds = await collectAvailableProblemIds(\n    absoluteDirectoryPath,\n    options.problemsDirectoryPath,\n    explicitProblemsDirectoryPath,\n    errors\n  );\n\n  if (!parsedCourseFile) return result;\n  const { courseFile, courseFileName } = parsedCourseFile;\n  const coursePeriodErrors: string[] = [];\n  validateSubmissionPeriods(courseFile, coursePeriodErrors);\n  errors.push(...coursePeriodErrors.map((error) => `${courseFileName}: ${error}`));\n  // The importer treats a missing `lectures` as an empty list, so a course without lectures imports\n  // nothing but is valid.\n  const lectures = courseFile.lectures ?? [];\n  if (lectures.length === 0) {\n    warnings.push(`${courseFileName} declares no lectures, so no materials are imported`);\n  }\n  reportDuplicateIds(\n    lectures.map((lecture) => lecture.id),\n    'lecture',\n    errors\n  );\n  for (const lecture of lectures) {\n    await validateLectureDirectory(\n      absoluteDirectoryPath,\n      { courseId, courseSubmissionPeriods: courseFile, problemsDirectoryPath, availableProblemIds },\n      lecture.id,\n      errors,\n      warnings\n    );\n  }\n  await reportOrphanLectureDirectories(absoluteDirectoryPath, courseFile, courseFileName, warnings);\n  return result;\n}\n\n/**\n * Resolves symbolic links (and, on a case-insensitive file system, the casing) of a regular\n * directory; a linked or missing final entry keeps its own name so it can be reported as such,\n * with only its ancestors resolved.\n */\nasync function canonicalize(path: string): Promise<string> {\n  const absolutePath = resolve(path);\n  if (await isRegularDirectory(absolutePath)) return realpath(absolutePath);\n  try {\n    return join(await realpath(dirname(absolutePath)), basename(absolutePath));\n  } catch {\n    return absolutePath;\n  }\n}\n\n/** Directories not listed as lectures are never imported, so their materials silently disappear. */\nasync function reportOrphanLectureDirectories(\n  courseDirectoryPath: string,\n  courseFile: CourseFile,\n  courseFileName: string,\n  warnings: string[]\n): Promise<void> {\n  const lectureIds = new Set((courseFile.lectures ?? []).map((lecture) => lecture.id));\n  const dirents = await readdir(courseDirectoryPath, { withFileTypes: true });\n  for (const dirent of dirents) {\n    if (\n      !dirent.isDirectory() ||\n      dirent.name.startsWith('.') ||\n      lectureIds.has(dirent.name) ||\n      dirent.name === 'problems'\n    )\n      continue;\n    // A lecture imports only its direct files, so only a directory that directly holds material files\n    // would gain anything from being listed (problems are found at any depth regardless).\n    const entries = await readdir(join(courseDirectoryPath, dirent.name), { withFileTypes: true });\n    if (!entries.some((entry) => entry.isFile() && isMaterialFileName(entry.name))) continue;\n    warnings.push(\n      `directory \"${dirent.name}\" is not listed as a lecture in ${courseFileName}, so its materials are not imported`\n    );\n  }\n}\n\nasync function parseCourseFile(\n  courseDirectoryPath: string,\n  errors: string[]\n): Promise<{ courseFile: CourseFile; courseFileName: string } | undefined> {\n  // The judge discovers courses by `course.yaml` or `course.yml` (rejecting a directory with both)\n  // and skips symbolic links.\n  const courseFileNames = ['course.yaml', 'course.yml'];\n  const presentFileNames: string[] = [];\n  for (const fileName of courseFileNames) {\n    if (await isRegularFile(join(courseDirectoryPath, fileName))) presentFileNames.push(fileName);\n  }\n  if (presentFileNames.length > 1) {\n    errors.push('both course.yaml and course.yml exist; the judge rejects the conflicting course files');\n    return undefined;\n  }\n  const courseFileName = presentFileNames[0];\n  if (courseFileName === undefined) {\n    const symlinkFileName = await findFirst(courseFileNames, (fileName) => isFile(join(courseDirectoryPath, fileName)));\n    errors.push(\n      symlinkFileName === undefined\n        ? 'course.yaml not found'\n        : `${symlinkFileName} is a symbolic link, which the judge ignores; commit a regular file`\n    );\n    return undefined;\n  }\n  const courseFilePath = join(courseDirectoryPath, courseFileName);\n  let rawContent: unknown;\n  try {\n    rawContent = parseYaml(await readFile(courseFilePath, 'utf8'));\n  } catch (error) {\n    errors.push(`${courseFileName}: invalid YAML: ${getErrorMessage(error)}`);\n    return undefined;\n  }\n  const parsed = courseFileSchema.safeParse(rawContent);\n  if (!parsed.success) {\n    errors.push(...formatZodIssues(parsed.error, courseFileName));\n    return undefined;\n  }\n  return { courseFile: parsed.data, courseFileName };\n}\n\nasync function findFirst<T>(items: readonly T[], predicate: (item: T) => Promise<boolean>): Promise<T | undefined> {\n  for (const item of items) {\n    if (await predicate(item)) return item;\n  }\n  return undefined;\n}\n\nfunction isMaterialFileName(fileName: string): boolean {\n  return (\n    fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX) ||\n    (fileName.endsWith('.md') && fileName !== 'problem.md' && !fileName.endsWith('.problem.md'))\n  );\n}\n\n/**\n * The judge scopes every problem inside the course directory (at any depth) to the course, so the\n * course is always searched; an explicit directory must lie inside it.\n */\nasync function collectAvailableProblemIds(\n  courseDirectoryPath: string,\n  problemsDirectoryOption: string | undefined,\n  explicitProblemsDirectoryPath: string | undefined,\n  errors: string[]\n): Promise<Set<string>> {\n  const definitionPathsById = await collectProblemDefinitions(courseDirectoryPath);\n  reportProblemDefinitionIssues(definitionPathsById, errors);\n  const availableProblemIds = new Set(definitionPathsById.keys());\n  // Discovery does not traverse a symbolic link, so a linked problems directory imports nothing.\n  const courseProblemsDirectoryPath = join(courseDirectoryPath, 'problems');\n  const namesConventionalDirectory =\n    explicitProblemsDirectoryPath !== undefined &&\n    (await isSameEntry(explicitProblemsDirectoryPath, courseProblemsDirectoryPath));\n  if (namesConventionalDirectory || (await isDirectory(courseProblemsDirectoryPath))) {\n    await isUsableProblemsDirectory(courseProblemsDirectoryPath, errors);\n  }\n  if (explicitProblemsDirectoryPath === undefined || namesConventionalDirectory) return availableProblemIds;\n  if (\n    (await isUsableProblemsDirectory(explicitProblemsDirectoryPath, errors)) &&\n    isOutsideDirectory(courseDirectoryPath, explicitProblemsDirectoryPath)\n  ) {\n    // Exercode links a material only to problems inside its course, so outside problems never count.\n    errors.push(\n      `problems directory ${problemsDirectoryOption} is outside the course directory; Exercode links a material only to problems inside the course, so move them under the course`\n    );\n  }\n  return availableProblemIds;\n}\n\n/** Whether two paths name the same directory entry (e.g. differently cased on a case-insensitive file system). */\nasync function isSameEntry(path1: string, path2: string): Promise<boolean> {\n  if (path1 === path2) return true;\n  try {\n    const [stats1, stats2] = await Promise.all([lstat(path1), lstat(path2)]);\n    return stats1.dev === stats2.dev && stats1.ino === stats2.ino;\n  } catch {\n    return false;\n  }\n}\n\nfunction isOutsideDirectory(parentPath: string, path: string): boolean {\n  const relativePath = relative(parentPath, path);\n  return relativePath === '..' || relativePath.startsWith(`..${sep}`);\n}\n\nasync function validateLectureDirectory(\n  courseDirectoryPath: string,\n  materialOptions: MaterialValidationOptions,\n  lectureId: string,\n  errors: string[],\n  warnings: string[]\n): Promise<void> {\n  const lectureDirectoryPath = join(courseDirectoryPath, lectureId);\n  // The judge lists lecture entries as regular files and directories, so symbolic links vanish.\n  if (!(await isRegularDirectory(lectureDirectoryPath))) {\n    errors.push(\n      (await isDirectory(lectureDirectoryPath))\n        ? `lecture \"${lectureId}\": directory is a symbolic link, which the judge does not traverse`\n        : `lecture \"${lectureId}\": directory not found`\n    );\n    return;\n  }\n\n  const materialIds: string[] = [];\n  const dirents = await readdir(lectureDirectoryPath, { withFileTypes: true });\n  for (const dirent of dirents) {\n    if (dirent.isSymbolicLink()) {\n      errors.push(`${lectureId}/${dirent.name} is a symbolic link, which the judge ignores; commit a regular file`);\n    }\n  }\n  const fileNames = dirents\n    .filter((dirent) => dirent.isFile())\n    .map((dirent) => dirent.name)\n    .toSorted((f1, f2) => f1.localeCompare(f2));\n  for (const fileName of fileNames) {\n    const materialFilePath = join(lectureDirectoryPath, fileName);\n    let materialResult: ValidationResult;\n    if (fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX)) {\n      materialIds.push(fileName.slice(0, -CONTEST_MATERIAL_FILE_SUFFIX.length));\n      materialResult = await validateContestFile(materialFilePath, { ...materialOptions, isNestedInCourse: true });\n    } else if (fileName.endsWith('.md')) {\n      materialIds.push(fileName.replace(/\\.[^/.]+$/, ''));\n      materialResult = await validateMaterialFile(materialFilePath, materialOptions);\n    } else {\n      continue;\n    }\n    errors.push(...materialResult.errors.map((error) => `${lectureId}/${fileName}: ${error}`));\n    warnings.push(...materialResult.warnings.map((warning) => `${lectureId}/${fileName}: ${warning}`));\n  }\n\n  if (materialIds.length === 0) {\n    warnings.push(`lecture \"${lectureId}\": no material files (*.md or *${CONTEST_MATERIAL_FILE_SUFFIX}) found`);\n  }\n  // Material IDs only need to be unique per lecture: exercode's import key is\n  // `${courseId}.${lectureId}.${materialId}`, so a course-wide check would reject courses\n  // that import fine. Scope the report to the lecture so multi-lecture courses point at the\n  // right files.\n  const duplicateMaterialErrors: string[] = [];\n  reportDuplicateIds(materialIds, 'material', duplicateMaterialErrors);\n  errors.push(...duplicateMaterialErrors.map((error) => `lecture \"${lectureId}\": ${error}`));\n}\n"],"mappings":"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"}
+{"version":3,"file":"validateCourse.cjs","names":["isRegularDirectory","resolve","isDirectory","realpath","basename","LEARNING_MATERIAL_ID_REGEX","join","dirname","readdir","isRegularFile","isFile","parseYaml","readFile","getErrorMessage","courseFileSchema","formatZodIssues","collectProblemDefinitions","isUsableProblemsDirectory","lstat","relative","sep","CONTEST_MATERIAL_FILE_SUFFIX","validateContestFile","validateMaterialFile","require_schemas","require_fsHelpers","require_validationResult","require_validateMaterial","require_validateContest","node_path","node_fs_promises","_willbooster_shared_lib","yaml","validateCourseDirectory","errors","warnings","result","courseDirectoryPath","absoluteDirectoryPath","explicitProblemsDirectoryPath","options","canonicalize","courseId","parsedCourseFile","parseCourseFile","problemsDirectoryPath","availableProblemIds","collectAvailableProblemIds","coursePeriodErrors","courseFile","courseFileName","error","lectures","lecture","validateLectureDirectory","reportOrphanLectureDirectories","absolutePath","path","lectureIds","dirents","dirent","entry","isMaterialFileName","courseFileNames","presentFileNames","fileName","symlinkFileName","findFirst","courseFilePath","rawContent","parsed","item","items","predicate","definitionPathsById","courseProblemsDirectoryPath","namesConventionalDirectory","isSameEntry","isOutsideDirectory","problemsDirectoryOption","path1","path2","stats1","stats2","relativePath","parentPath","lectureDirectoryPath","lectureId","materialIds","fileNames","f1","f2","materialFilePath","materialResult","materialOptions","warning","duplicateMaterialErrors"],"sources":["../../src/learningMaterial/validateCourse.ts"],"sourcesContent":["import { lstat, readdir, readFile, realpath } from 'node:fs/promises';\nimport { basename, dirname, join, relative, resolve, sep } from 'node:path';\n\nimport { getErrorMessage } from '@willbooster/shared-lib';\nimport { parse as parseYaml } from 'yaml';\n\nimport {\n  collectProblemDefinitions,\n  isDirectory,\n  isFile,\n  isRegularDirectory,\n  isRegularFile,\n  isUsableProblemsDirectory,\n  reportProblemDefinitionIssues,\n} from './fsHelpers.js';\nimport {\n  CONTEST_MATERIAL_FILE_SUFFIX,\n  type CourseFile,\n  courseFileSchema,\n  LEARNING_MATERIAL_ID_REGEX,\n} from './schemas.js';\nimport { validateContestFile } from './validateContest.js';\nimport { type MaterialValidationOptions, validateMaterialFile, validateSubmissionPeriods } from './validateMaterial.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\nexport interface CourseValidationOptions {\n  /**\n   * Optional extra check only: problem references always resolve against the problems discovered\n   * inside the course directory, so a given directory must lie inside it (an outside or missing one\n   * is an error).\n   */\n  problemsDirectoryPath?: string;\n}\n\n/** Validates an exercode course directory (course.yaml plus one directory per lecture with material files). */\nexport async function validateCourseDirectory(\n  courseDirectoryPath: string,\n  options: CourseValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  // Course discovery does not traverse a symbolic link, so a linked course directory is never imported.\n  if (!(await isRegularDirectory(resolve(courseDirectoryPath)))) {\n    errors.push(\n      (await isDirectory(resolve(courseDirectoryPath)))\n        ? `course directory is a symbolic link, which the judge does not traverse: ${courseDirectoryPath}`\n        : `course directory not found: ${courseDirectoryPath}`\n    );\n    return result;\n  }\n  // Canonical paths make the \"inside the course\" comparisons below independent of how the caller\n  // spelled either path (e.g. `/var` vs `/private/var` on macOS).\n  const absoluteDirectoryPath = await realpath(courseDirectoryPath);\n  const explicitProblemsDirectoryPath =\n    options.problemsDirectoryPath === undefined ? undefined : await canonicalize(options.problemsDirectoryPath);\n  const courseId = basename(absoluteDirectoryPath);\n  if (!LEARNING_MATERIAL_ID_REGEX.test(courseId)) {\n    errors.push(`course ID \"${courseId}\" (directory name) must match ${LEARNING_MATERIAL_ID_REGEX}`);\n  }\n\n  const parsedCourseFile = await parseCourseFile(absoluteDirectoryPath, errors);\n  // Messages name the course directory because that is what discovery searches (see collectAvailableProblemIds).\n  const problemsDirectoryPath = absoluteDirectoryPath;\n  const availableProblemIds = await collectAvailableProblemIds(\n    absoluteDirectoryPath,\n    options.problemsDirectoryPath,\n    explicitProblemsDirectoryPath,\n    errors\n  );\n\n  if (!parsedCourseFile) return result;\n  const { courseFile, courseFileName } = parsedCourseFile;\n  const coursePeriodErrors: string[] = [];\n  validateSubmissionPeriods(courseFile, coursePeriodErrors);\n  errors.push(...coursePeriodErrors.map((error) => `${courseFileName}: ${error}`));\n  // The importer treats a missing `lectures` as an empty list, so a course without lectures imports\n  // nothing but is valid.\n  const lectures = courseFile.lectures ?? [];\n  if (lectures.length === 0) {\n    warnings.push(`${courseFileName} declares no lectures, so no materials are imported`);\n  }\n  reportDuplicateIds(\n    lectures.map((lecture) => lecture.id),\n    'lecture',\n    errors\n  );\n  for (const lecture of lectures) {\n    await validateLectureDirectory(\n      absoluteDirectoryPath,\n      { courseId, courseSubmissionPeriods: courseFile, problemsDirectoryPath, availableProblemIds },\n      lecture.id,\n      errors,\n      warnings\n    );\n  }\n  await reportOrphanLectureDirectories(absoluteDirectoryPath, courseFile, courseFileName, warnings);\n  return result;\n}\n\n/**\n * Resolves symbolic links (and, on a case-insensitive file system, the casing) of a regular\n * directory; a linked or missing final entry keeps its own name so it can be reported as such,\n * with only its ancestors resolved.\n */\nasync function canonicalize(path: string): Promise<string> {\n  const absolutePath = resolve(path);\n  if (await isRegularDirectory(absolutePath)) return realpath(absolutePath);\n  try {\n    return join(await realpath(dirname(absolutePath)), basename(absolutePath));\n  } catch {\n    return absolutePath;\n  }\n}\n\n/** Directories not listed as lectures are never imported, so their materials silently disappear. */\nasync function reportOrphanLectureDirectories(\n  courseDirectoryPath: string,\n  courseFile: CourseFile,\n  courseFileName: string,\n  warnings: string[]\n): Promise<void> {\n  const lectureIds = new Set((courseFile.lectures ?? []).map((lecture) => lecture.id));\n  const dirents = await readdir(courseDirectoryPath, { withFileTypes: true });\n  for (const dirent of dirents) {\n    if (\n      !dirent.isDirectory() ||\n      dirent.name.startsWith('.') ||\n      lectureIds.has(dirent.name) ||\n      dirent.name === 'problems'\n    )\n      continue;\n    // A lecture imports only its direct files, so only a directory that directly holds material files\n    // would gain anything from being listed (problems are found at any depth regardless).\n    const entries = await readdir(join(courseDirectoryPath, dirent.name), { withFileTypes: true });\n    if (!entries.some((entry) => entry.isFile() && isMaterialFileName(entry.name))) continue;\n    warnings.push(\n      `directory \"${dirent.name}\" is not listed as a lecture in ${courseFileName}, so its materials are not imported`\n    );\n  }\n}\n\nasync function parseCourseFile(\n  courseDirectoryPath: string,\n  errors: string[]\n): Promise<{ courseFile: CourseFile; courseFileName: string } | undefined> {\n  // The judge discovers courses by `course.yaml` or `course.yml` (rejecting a directory with both)\n  // and skips symbolic links.\n  const courseFileNames = ['course.yaml', 'course.yml'];\n  const presentFileNames: string[] = [];\n  for (const fileName of courseFileNames) {\n    if (await isRegularFile(join(courseDirectoryPath, fileName))) presentFileNames.push(fileName);\n  }\n  if (presentFileNames.length > 1) {\n    errors.push('both course.yaml and course.yml exist; the judge rejects the conflicting course files');\n    return undefined;\n  }\n  const courseFileName = presentFileNames[0];\n  if (courseFileName === undefined) {\n    const symlinkFileName = await findFirst(courseFileNames, (fileName) => isFile(join(courseDirectoryPath, fileName)));\n    errors.push(\n      symlinkFileName === undefined\n        ? 'course.yaml not found'\n        : `${symlinkFileName} is a symbolic link, which the judge ignores; commit a regular file`\n    );\n    return undefined;\n  }\n  const courseFilePath = join(courseDirectoryPath, courseFileName);\n  let rawContent: unknown;\n  try {\n    rawContent = parseYaml(await readFile(courseFilePath, 'utf8'));\n  } catch (error) {\n    errors.push(`${courseFileName}: invalid YAML: ${getErrorMessage(error)}`);\n    return undefined;\n  }\n  const parsed = courseFileSchema.safeParse(rawContent);\n  if (!parsed.success) {\n    errors.push(...formatZodIssues(parsed.error, courseFileName));\n    return undefined;\n  }\n  return { courseFile: parsed.data, courseFileName };\n}\n\nasync function findFirst<T>(items: readonly T[], predicate: (item: T) => Promise<boolean>): Promise<T | undefined> {\n  for (const item of items) {\n    if (await predicate(item)) return item;\n  }\n  return undefined;\n}\n\nfunction isMaterialFileName(fileName: string): boolean {\n  return (\n    fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX) ||\n    (fileName.endsWith('.md') && fileName !== 'problem.md' && !fileName.endsWith('.problem.md'))\n  );\n}\n\n/**\n * The judge scopes every problem inside the course directory (at any depth) to the course, so the\n * course is always searched; an explicit directory must lie inside it.\n */\nasync function collectAvailableProblemIds(\n  courseDirectoryPath: string,\n  problemsDirectoryOption: string | undefined,\n  explicitProblemsDirectoryPath: string | undefined,\n  errors: string[]\n): Promise<Set<string>> {\n  const definitionPathsById = await collectProblemDefinitions(courseDirectoryPath);\n  reportProblemDefinitionIssues(definitionPathsById, errors);\n  const availableProblemIds = new Set(definitionPathsById.keys());\n  // Discovery does not traverse a symbolic link, so a linked problems directory imports nothing.\n  const courseProblemsDirectoryPath = join(courseDirectoryPath, 'problems');\n  const namesConventionalDirectory =\n    explicitProblemsDirectoryPath !== undefined &&\n    (await isSameEntry(explicitProblemsDirectoryPath, courseProblemsDirectoryPath));\n  if (namesConventionalDirectory || (await isDirectory(courseProblemsDirectoryPath))) {\n    await isUsableProblemsDirectory(courseProblemsDirectoryPath, errors);\n  }\n  if (explicitProblemsDirectoryPath === undefined || namesConventionalDirectory) return availableProblemIds;\n  if (\n    (await isUsableProblemsDirectory(explicitProblemsDirectoryPath, errors)) &&\n    isOutsideDirectory(courseDirectoryPath, explicitProblemsDirectoryPath)\n  ) {\n    // Exercode links a material only to problems inside its course, so outside problems never count.\n    errors.push(\n      `problems directory ${problemsDirectoryOption} is outside the course directory; Exercode links a material only to problems inside the course, so move them under the course`\n    );\n  }\n  return availableProblemIds;\n}\n\n/** Whether two paths name the same directory entry (e.g. differently cased on a case-insensitive file system). */\nasync function isSameEntry(path1: string, path2: string): Promise<boolean> {\n  if (path1 === path2) return true;\n  try {\n    const [stats1, stats2] = await Promise.all([lstat(path1), lstat(path2)]);\n    return stats1.dev === stats2.dev && stats1.ino === stats2.ino;\n  } catch {\n    return false;\n  }\n}\n\nfunction isOutsideDirectory(parentPath: string, path: string): boolean {\n  const relativePath = relative(parentPath, path);\n  return relativePath === '..' || relativePath.startsWith(`..${sep}`);\n}\n\nasync function validateLectureDirectory(\n  courseDirectoryPath: string,\n  materialOptions: MaterialValidationOptions,\n  lectureId: string,\n  errors: string[],\n  warnings: string[]\n): Promise<void> {\n  const lectureDirectoryPath = join(courseDirectoryPath, lectureId);\n  // The judge lists lecture entries as regular files and directories, so symbolic links vanish.\n  if (!(await isRegularDirectory(lectureDirectoryPath))) {\n    errors.push(\n      (await isDirectory(lectureDirectoryPath))\n        ? `lecture \"${lectureId}\": directory is a symbolic link, which the judge does not traverse`\n        : `lecture \"${lectureId}\": directory not found`\n    );\n    return;\n  }\n\n  const materialIds: string[] = [];\n  const dirents = await readdir(lectureDirectoryPath, { withFileTypes: true });\n  for (const dirent of dirents) {\n    if (dirent.isSymbolicLink()) {\n      errors.push(`${lectureId}/${dirent.name} is a symbolic link, which the judge ignores; commit a regular file`);\n    }\n  }\n  const fileNames = dirents\n    .filter((dirent) => dirent.isFile())\n    .map((dirent) => dirent.name)\n    .toSorted((f1, f2) => f1.localeCompare(f2));\n  for (const fileName of fileNames) {\n    const materialFilePath = join(lectureDirectoryPath, fileName);\n    let materialResult: ValidationResult;\n    if (fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX)) {\n      materialIds.push(fileName.slice(0, -CONTEST_MATERIAL_FILE_SUFFIX.length));\n      materialResult = await validateContestFile(materialFilePath, { ...materialOptions, isNestedInCourse: true });\n    } else if (fileName.endsWith('.md')) {\n      materialIds.push(fileName.replace(/\\.[^/.]+$/, ''));\n      materialResult = await validateMaterialFile(materialFilePath, materialOptions);\n    } else {\n      continue;\n    }\n    errors.push(...materialResult.errors.map((error) => `${lectureId}/${fileName}: ${error}`));\n    warnings.push(...materialResult.warnings.map((warning) => `${lectureId}/${fileName}: ${warning}`));\n  }\n\n  if (materialIds.length === 0) {\n    warnings.push(`lecture \"${lectureId}\": no material files (*.md or *${CONTEST_MATERIAL_FILE_SUFFIX}) found`);\n  }\n  // Material IDs only need to be unique per lecture: exercode's import key is\n  // `${courseId}.${lectureId}.${materialId}`, so a course-wide check would reject courses\n  // that import fine. Scope the report to the lecture so multi-lecture courses point at the\n  // right files.\n  const duplicateMaterialErrors: string[] = [];\n  reportDuplicateIds(materialIds, 'material', duplicateMaterialErrors);\n  errors.push(...duplicateMaterialErrors.map((error) => `lecture \"${lectureId}\": ${error}`));\n}\n"],"mappings":"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"}

package/dist/learningMaterial/validateCourse.js.map

@@ -1 +1 @@
-{"version":3,"file":"validateCourse.js","names":["parseYaml","validateCourseDirectory","errors","warnings","result","isRegularDirectory","resolve","courseDirectoryPath","isDirectory","absoluteDirectoryPath","realpath","explicitProblemsDirectoryPath","options","canonicalize","courseId","basename","LEARNING_MATERIAL_ID_REGEX","parsedCourseFile","parseCourseFile","problemsDirectoryPath","availableProblemIds","collectAvailableProblemIds","coursePeriodErrors","validateSubmissionPeriods","courseFile","courseFileName","error","lectures","reportDuplicateIds","lecture","validateLectureDirectory","reportOrphanLectureDirectories","absolutePath","path","join","dirname","lectureIds","dirents","readdir","dirent","entry","isMaterialFileName","courseFileNames","presentFileNames","fileName","isRegularFile","symlinkFileName","findFirst","isFile","courseFilePath","rawContent","parse","readFile","getErrorMessage","parsed","courseFileSchema","formatZodIssues","item","items","predicate","definitionPathsById","collectProblemDefinitions","reportProblemDefinitionIssues","courseProblemsDirectoryPath","namesConventionalDirectory","isSameEntry","isUsableProblemsDirectory","isOutsideDirectory","problemsDirectoryOption","path1","path2","stats1","stats2","lstat","relativePath","relative","parentPath","sep","lectureDirectoryPath","lectureId","materialIds","fileNames","f1","f2","materialFilePath","materialResult","CONTEST_MATERIAL_FILE_SUFFIX","validateContestFile","materialOptions","validateMaterialFile","warning","duplicateMaterialErrors"],"sources":["../../src/learningMaterial/validateCourse.ts"],"sourcesContent":["import { lstat, readdir, readFile, realpath } from 'node:fs/promises';\nimport { basename, dirname, join, relative, resolve, sep } from 'node:path';\nimport { getErrorMessage } from '@willbooster/shared-lib';\nimport { parse as parseYaml } from 'yaml';\nimport {\n  collectProblemDefinitions,\n  isDirectory,\n  isFile,\n  isRegularDirectory,\n  isRegularFile,\n  isUsableProblemsDirectory,\n  reportProblemDefinitionIssues,\n} from './fsHelpers.js';\nimport {\n  CONTEST_MATERIAL_FILE_SUFFIX,\n  courseFileSchema,\n  LEARNING_MATERIAL_ID_REGEX,\n  type CourseFile,\n} from './schemas.js';\nimport { validateContestFile } from './validateContest.js';\nimport { validateMaterialFile, validateSubmissionPeriods, type MaterialValidationOptions } from './validateMaterial.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\nexport interface CourseValidationOptions {\n  /**\n   * Optional extra check only: problem references always resolve against the problems discovered\n   * inside the course directory, so a given directory must lie inside it (an outside or missing one\n   * is an error).\n   */\n  problemsDirectoryPath?: string;\n}\n\n/** Validates an exercode course directory (course.yaml plus one directory per lecture with material files). */\nexport async function validateCourseDirectory(\n  courseDirectoryPath: string,\n  options: CourseValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  // Course discovery does not traverse a symbolic link, so a linked course directory is never imported.\n  if (!(await isRegularDirectory(resolve(courseDirectoryPath)))) {\n    errors.push(\n      (await isDirectory(resolve(courseDirectoryPath)))\n        ? `course directory is a symbolic link, which the judge does not traverse: ${courseDirectoryPath}`\n        : `course directory not found: ${courseDirectoryPath}`\n    );\n    return result;\n  }\n  // Canonical paths make the \"inside the course\" comparisons below independent of how the caller\n  // spelled either path (e.g. `/var` vs `/private/var` on macOS).\n  const absoluteDirectoryPath = await realpath(courseDirectoryPath);\n  const explicitProblemsDirectoryPath =\n    options.problemsDirectoryPath === undefined ? undefined : await canonicalize(options.problemsDirectoryPath);\n  const courseId = basename(absoluteDirectoryPath);\n  if (!LEARNING_MATERIAL_ID_REGEX.test(courseId)) {\n    errors.push(`course ID \"${courseId}\" (directory name) must match ${LEARNING_MATERIAL_ID_REGEX}`);\n  }\n\n  const parsedCourseFile = await parseCourseFile(absoluteDirectoryPath, errors);\n  // Messages name the course directory because that is what discovery searches (see collectAvailableProblemIds).\n  const problemsDirectoryPath = absoluteDirectoryPath;\n  const availableProblemIds = await collectAvailableProblemIds(\n    absoluteDirectoryPath,\n    options.problemsDirectoryPath,\n    explicitProblemsDirectoryPath,\n    errors\n  );\n\n  if (!parsedCourseFile) return result;\n  const { courseFile, courseFileName } = parsedCourseFile;\n  const coursePeriodErrors: string[] = [];\n  validateSubmissionPeriods(courseFile, coursePeriodErrors);\n  errors.push(...coursePeriodErrors.map((error) => `${courseFileName}: ${error}`));\n  // The importer treats a missing `lectures` as an empty list, so a course without lectures imports\n  // nothing but is valid.\n  const lectures = courseFile.lectures ?? [];\n  if (lectures.length === 0) {\n    warnings.push(`${courseFileName} declares no lectures, so no materials are imported`);\n  }\n  reportDuplicateIds(\n    lectures.map((lecture) => lecture.id),\n    'lecture',\n    errors\n  );\n  for (const lecture of lectures) {\n    await validateLectureDirectory(\n      absoluteDirectoryPath,\n      { courseId, courseSubmissionPeriods: courseFile, problemsDirectoryPath, availableProblemIds },\n      lecture.id,\n      errors,\n      warnings\n    );\n  }\n  await reportOrphanLectureDirectories(absoluteDirectoryPath, courseFile, courseFileName, warnings);\n  return result;\n}\n\n/**\n * Resolves symbolic links (and, on a case-insensitive file system, the casing) of a regular\n * directory; a linked or missing final entry keeps its own name so it can be reported as such,\n * with only its ancestors resolved.\n */\nasync function canonicalize(path: string): Promise<string> {\n  const absolutePath = resolve(path);\n  if (await isRegularDirectory(absolutePath)) return realpath(absolutePath);\n  try {\n    return join(await realpath(dirname(absolutePath)), basename(absolutePath));\n  } catch {\n    return absolutePath;\n  }\n}\n\n/** Directories not listed as lectures are never imported, so their materials silently disappear. */\nasync function reportOrphanLectureDirectories(\n  courseDirectoryPath: string,\n  courseFile: CourseFile,\n  courseFileName: string,\n  warnings: string[]\n): Promise<void> {\n  const lectureIds = new Set((courseFile.lectures ?? []).map((lecture) => lecture.id));\n  const dirents = await readdir(courseDirectoryPath, { withFileTypes: true });\n  for (const dirent of dirents) {\n    if (\n      !dirent.isDirectory() ||\n      dirent.name.startsWith('.') ||\n      lectureIds.has(dirent.name) ||\n      dirent.name === 'problems'\n    )\n      continue;\n    // A lecture imports only its direct files, so only a directory that directly holds material files\n    // would gain anything from being listed (problems are found at any depth regardless).\n    const entries = await readdir(join(courseDirectoryPath, dirent.name), { withFileTypes: true });\n    if (!entries.some((entry) => entry.isFile() && isMaterialFileName(entry.name))) continue;\n    warnings.push(\n      `directory \"${dirent.name}\" is not listed as a lecture in ${courseFileName}, so its materials are not imported`\n    );\n  }\n}\n\nasync function parseCourseFile(\n  courseDirectoryPath: string,\n  errors: string[]\n): Promise<{ courseFile: CourseFile; courseFileName: string } | undefined> {\n  // The judge discovers courses by `course.yaml` or `course.yml` (rejecting a directory with both)\n  // and skips symbolic links.\n  const courseFileNames = ['course.yaml', 'course.yml'];\n  const presentFileNames: string[] = [];\n  for (const fileName of courseFileNames) {\n    if (await isRegularFile(join(courseDirectoryPath, fileName))) presentFileNames.push(fileName);\n  }\n  if (presentFileNames.length > 1) {\n    errors.push('both course.yaml and course.yml exist; the judge rejects the conflicting course files');\n    return undefined;\n  }\n  const courseFileName = presentFileNames[0];\n  if (courseFileName === undefined) {\n    const symlinkFileName = await findFirst(courseFileNames, (fileName) => isFile(join(courseDirectoryPath, fileName)));\n    errors.push(\n      symlinkFileName === undefined\n        ? 'course.yaml not found'\n        : `${symlinkFileName} is a symbolic link, which the judge ignores; commit a regular file`\n    );\n    return undefined;\n  }\n  const courseFilePath = join(courseDirectoryPath, courseFileName);\n  let rawContent: unknown;\n  try {\n    rawContent = parseYaml(await readFile(courseFilePath, 'utf8'));\n  } catch (error) {\n    errors.push(`${courseFileName}: invalid YAML: ${getErrorMessage(error)}`);\n    return undefined;\n  }\n  const parsed = courseFileSchema.safeParse(rawContent);\n  if (!parsed.success) {\n    errors.push(...formatZodIssues(parsed.error, courseFileName));\n    return undefined;\n  }\n  return { courseFile: parsed.data, courseFileName };\n}\n\nasync function findFirst<T>(items: readonly T[], predicate: (item: T) => Promise<boolean>): Promise<T | undefined> {\n  for (const item of items) {\n    if (await predicate(item)) return item;\n  }\n  return undefined;\n}\n\nfunction isMaterialFileName(fileName: string): boolean {\n  return (\n    fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX) ||\n    (fileName.endsWith('.md') && fileName !== 'problem.md' && !fileName.endsWith('.problem.md'))\n  );\n}\n\n/**\n * The judge scopes every problem inside the course directory (at any depth) to the course, so the\n * course is always searched; an explicit directory must lie inside it.\n */\nasync function collectAvailableProblemIds(\n  courseDirectoryPath: string,\n  problemsDirectoryOption: string | undefined,\n  explicitProblemsDirectoryPath: string | undefined,\n  errors: string[]\n): Promise<Set<string>> {\n  const definitionPathsById = await collectProblemDefinitions(courseDirectoryPath);\n  reportProblemDefinitionIssues(definitionPathsById, errors);\n  const availableProblemIds = new Set(definitionPathsById.keys());\n  // Discovery does not traverse a symbolic link, so a linked problems directory imports nothing.\n  const courseProblemsDirectoryPath = join(courseDirectoryPath, 'problems');\n  const namesConventionalDirectory =\n    explicitProblemsDirectoryPath !== undefined &&\n    (await isSameEntry(explicitProblemsDirectoryPath, courseProblemsDirectoryPath));\n  if (namesConventionalDirectory || (await isDirectory(courseProblemsDirectoryPath))) {\n    await isUsableProblemsDirectory(courseProblemsDirectoryPath, errors);\n  }\n  if (explicitProblemsDirectoryPath === undefined || namesConventionalDirectory) return availableProblemIds;\n  if (\n    (await isUsableProblemsDirectory(explicitProblemsDirectoryPath, errors)) &&\n    isOutsideDirectory(courseDirectoryPath, explicitProblemsDirectoryPath)\n  ) {\n    // Exercode links a material only to problems inside its course, so outside problems never count.\n    errors.push(\n      `problems directory ${problemsDirectoryOption} is outside the course directory; Exercode links a material only to problems inside the course, so move them under the course`\n    );\n  }\n  return availableProblemIds;\n}\n\n/** Whether two paths name the same directory entry (e.g. differently cased on a case-insensitive file system). */\nasync function isSameEntry(path1: string, path2: string): Promise<boolean> {\n  if (path1 === path2) return true;\n  try {\n    const [stats1, stats2] = await Promise.all([lstat(path1), lstat(path2)]);\n    return stats1.dev === stats2.dev && stats1.ino === stats2.ino;\n  } catch {\n    return false;\n  }\n}\n\nfunction isOutsideDirectory(parentPath: string, path: string): boolean {\n  const relativePath = relative(parentPath, path);\n  return relativePath === '..' || relativePath.startsWith(`..${sep}`);\n}\n\nasync function validateLectureDirectory(\n  courseDirectoryPath: string,\n  materialOptions: MaterialValidationOptions,\n  lectureId: string,\n  errors: string[],\n  warnings: string[]\n): Promise<void> {\n  const lectureDirectoryPath = join(courseDirectoryPath, lectureId);\n  // The judge lists lecture entries as regular files and directories, so symbolic links vanish.\n  if (!(await isRegularDirectory(lectureDirectoryPath))) {\n    errors.push(\n      (await isDirectory(lectureDirectoryPath))\n        ? `lecture \"${lectureId}\": directory is a symbolic link, which the judge does not traverse`\n        : `lecture \"${lectureId}\": directory not found`\n    );\n    return;\n  }\n\n  const materialIds: string[] = [];\n  const dirents = await readdir(lectureDirectoryPath, { withFileTypes: true });\n  for (const dirent of dirents) {\n    if (dirent.isSymbolicLink()) {\n      errors.push(`${lectureId}/${dirent.name} is a symbolic link, which the judge ignores; commit a regular file`);\n    }\n  }\n  const fileNames = dirents\n    .filter((dirent) => dirent.isFile())\n    .map((dirent) => dirent.name)\n    .toSorted((f1, f2) => f1.localeCompare(f2));\n  for (const fileName of fileNames) {\n    const materialFilePath = join(lectureDirectoryPath, fileName);\n    let materialResult: ValidationResult;\n    if (fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX)) {\n      materialIds.push(fileName.slice(0, -CONTEST_MATERIAL_FILE_SUFFIX.length));\n      materialResult = await validateContestFile(materialFilePath, { ...materialOptions, isNestedInCourse: true });\n    } else if (fileName.endsWith('.md')) {\n      materialIds.push(fileName.replace(/\\.[^/.]+$/, ''));\n      materialResult = await validateMaterialFile(materialFilePath, materialOptions);\n    } else {\n      continue;\n    }\n    errors.push(...materialResult.errors.map((error) => `${lectureId}/${fileName}: ${error}`));\n    warnings.push(...materialResult.warnings.map((warning) => `${lectureId}/${fileName}: ${warning}`));\n  }\n\n  if (materialIds.length === 0) {\n    warnings.push(`lecture \"${lectureId}\": no material files (*.md or *${CONTEST_MATERIAL_FILE_SUFFIX}) found`);\n  }\n  // Material IDs only need to be unique per lecture: exercode's import key is\n  // `${courseId}.${lectureId}.${materialId}`, so a course-wide check would reject courses\n  // that import fine. Scope the report to the lecture so multi-lecture courses point at the\n  // right files.\n  const duplicateMaterialErrors: string[] = [];\n  reportDuplicateIds(materialIds, 'material', duplicateMaterialErrors);\n  errors.push(...duplicateMaterialErrors.map((error) => `lecture \"${lectureId}\": ${error}`));\n}\n"],"mappings":"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"}
+{"version":3,"file":"validateCourse.js","names":["parseYaml","validateCourseDirectory","errors","warnings","result","isRegularDirectory","resolve","courseDirectoryPath","isDirectory","absoluteDirectoryPath","realpath","explicitProblemsDirectoryPath","options","canonicalize","courseId","basename","LEARNING_MATERIAL_ID_REGEX","parsedCourseFile","parseCourseFile","problemsDirectoryPath","availableProblemIds","collectAvailableProblemIds","coursePeriodErrors","validateSubmissionPeriods","courseFile","courseFileName","error","lectures","reportDuplicateIds","lecture","validateLectureDirectory","reportOrphanLectureDirectories","absolutePath","path","join","dirname","lectureIds","dirents","readdir","dirent","entry","isMaterialFileName","courseFileNames","presentFileNames","fileName","isRegularFile","symlinkFileName","findFirst","isFile","courseFilePath","rawContent","parse","readFile","getErrorMessage","parsed","courseFileSchema","formatZodIssues","item","items","predicate","definitionPathsById","collectProblemDefinitions","reportProblemDefinitionIssues","courseProblemsDirectoryPath","namesConventionalDirectory","isSameEntry","isUsableProblemsDirectory","isOutsideDirectory","problemsDirectoryOption","path1","path2","stats1","stats2","lstat","relativePath","relative","parentPath","sep","lectureDirectoryPath","lectureId","materialIds","fileNames","f1","f2","materialFilePath","materialResult","CONTEST_MATERIAL_FILE_SUFFIX","validateContestFile","materialOptions","validateMaterialFile","warning","duplicateMaterialErrors"],"sources":["../../src/learningMaterial/validateCourse.ts"],"sourcesContent":["import { lstat, readdir, readFile, realpath } from 'node:fs/promises';\nimport { basename, dirname, join, relative, resolve, sep } from 'node:path';\n\nimport { getErrorMessage } from '@willbooster/shared-lib';\nimport { parse as parseYaml } from 'yaml';\n\nimport {\n  collectProblemDefinitions,\n  isDirectory,\n  isFile,\n  isRegularDirectory,\n  isRegularFile,\n  isUsableProblemsDirectory,\n  reportProblemDefinitionIssues,\n} from './fsHelpers.js';\nimport {\n  CONTEST_MATERIAL_FILE_SUFFIX,\n  type CourseFile,\n  courseFileSchema,\n  LEARNING_MATERIAL_ID_REGEX,\n} from './schemas.js';\nimport { validateContestFile } from './validateContest.js';\nimport { type MaterialValidationOptions, validateMaterialFile, validateSubmissionPeriods } from './validateMaterial.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\nexport interface CourseValidationOptions {\n  /**\n   * Optional extra check only: problem references always resolve against the problems discovered\n   * inside the course directory, so a given directory must lie inside it (an outside or missing one\n   * is an error).\n   */\n  problemsDirectoryPath?: string;\n}\n\n/** Validates an exercode course directory (course.yaml plus one directory per lecture with material files). */\nexport async function validateCourseDirectory(\n  courseDirectoryPath: string,\n  options: CourseValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  // Course discovery does not traverse a symbolic link, so a linked course directory is never imported.\n  if (!(await isRegularDirectory(resolve(courseDirectoryPath)))) {\n    errors.push(\n      (await isDirectory(resolve(courseDirectoryPath)))\n        ? `course directory is a symbolic link, which the judge does not traverse: ${courseDirectoryPath}`\n        : `course directory not found: ${courseDirectoryPath}`\n    );\n    return result;\n  }\n  // Canonical paths make the \"inside the course\" comparisons below independent of how the caller\n  // spelled either path (e.g. `/var` vs `/private/var` on macOS).\n  const absoluteDirectoryPath = await realpath(courseDirectoryPath);\n  const explicitProblemsDirectoryPath =\n    options.problemsDirectoryPath === undefined ? undefined : await canonicalize(options.problemsDirectoryPath);\n  const courseId = basename(absoluteDirectoryPath);\n  if (!LEARNING_MATERIAL_ID_REGEX.test(courseId)) {\n    errors.push(`course ID \"${courseId}\" (directory name) must match ${LEARNING_MATERIAL_ID_REGEX}`);\n  }\n\n  const parsedCourseFile = await parseCourseFile(absoluteDirectoryPath, errors);\n  // Messages name the course directory because that is what discovery searches (see collectAvailableProblemIds).\n  const problemsDirectoryPath = absoluteDirectoryPath;\n  const availableProblemIds = await collectAvailableProblemIds(\n    absoluteDirectoryPath,\n    options.problemsDirectoryPath,\n    explicitProblemsDirectoryPath,\n    errors\n  );\n\n  if (!parsedCourseFile) return result;\n  const { courseFile, courseFileName } = parsedCourseFile;\n  const coursePeriodErrors: string[] = [];\n  validateSubmissionPeriods(courseFile, coursePeriodErrors);\n  errors.push(...coursePeriodErrors.map((error) => `${courseFileName}: ${error}`));\n  // The importer treats a missing `lectures` as an empty list, so a course without lectures imports\n  // nothing but is valid.\n  const lectures = courseFile.lectures ?? [];\n  if (lectures.length === 0) {\n    warnings.push(`${courseFileName} declares no lectures, so no materials are imported`);\n  }\n  reportDuplicateIds(\n    lectures.map((lecture) => lecture.id),\n    'lecture',\n    errors\n  );\n  for (const lecture of lectures) {\n    await validateLectureDirectory(\n      absoluteDirectoryPath,\n      { courseId, courseSubmissionPeriods: courseFile, problemsDirectoryPath, availableProblemIds },\n      lecture.id,\n      errors,\n      warnings\n    );\n  }\n  await reportOrphanLectureDirectories(absoluteDirectoryPath, courseFile, courseFileName, warnings);\n  return result;\n}\n\n/**\n * Resolves symbolic links (and, on a case-insensitive file system, the casing) of a regular\n * directory; a linked or missing final entry keeps its own name so it can be reported as such,\n * with only its ancestors resolved.\n */\nasync function canonicalize(path: string): Promise<string> {\n  const absolutePath = resolve(path);\n  if (await isRegularDirectory(absolutePath)) return realpath(absolutePath);\n  try {\n    return join(await realpath(dirname(absolutePath)), basename(absolutePath));\n  } catch {\n    return absolutePath;\n  }\n}\n\n/** Directories not listed as lectures are never imported, so their materials silently disappear. */\nasync function reportOrphanLectureDirectories(\n  courseDirectoryPath: string,\n  courseFile: CourseFile,\n  courseFileName: string,\n  warnings: string[]\n): Promise<void> {\n  const lectureIds = new Set((courseFile.lectures ?? []).map((lecture) => lecture.id));\n  const dirents = await readdir(courseDirectoryPath, { withFileTypes: true });\n  for (const dirent of dirents) {\n    if (\n      !dirent.isDirectory() ||\n      dirent.name.startsWith('.') ||\n      lectureIds.has(dirent.name) ||\n      dirent.name === 'problems'\n    )\n      continue;\n    // A lecture imports only its direct files, so only a directory that directly holds material files\n    // would gain anything from being listed (problems are found at any depth regardless).\n    const entries = await readdir(join(courseDirectoryPath, dirent.name), { withFileTypes: true });\n    if (!entries.some((entry) => entry.isFile() && isMaterialFileName(entry.name))) continue;\n    warnings.push(\n      `directory \"${dirent.name}\" is not listed as a lecture in ${courseFileName}, so its materials are not imported`\n    );\n  }\n}\n\nasync function parseCourseFile(\n  courseDirectoryPath: string,\n  errors: string[]\n): Promise<{ courseFile: CourseFile; courseFileName: string } | undefined> {\n  // The judge discovers courses by `course.yaml` or `course.yml` (rejecting a directory with both)\n  // and skips symbolic links.\n  const courseFileNames = ['course.yaml', 'course.yml'];\n  const presentFileNames: string[] = [];\n  for (const fileName of courseFileNames) {\n    if (await isRegularFile(join(courseDirectoryPath, fileName))) presentFileNames.push(fileName);\n  }\n  if (presentFileNames.length > 1) {\n    errors.push('both course.yaml and course.yml exist; the judge rejects the conflicting course files');\n    return undefined;\n  }\n  const courseFileName = presentFileNames[0];\n  if (courseFileName === undefined) {\n    const symlinkFileName = await findFirst(courseFileNames, (fileName) => isFile(join(courseDirectoryPath, fileName)));\n    errors.push(\n      symlinkFileName === undefined\n        ? 'course.yaml not found'\n        : `${symlinkFileName} is a symbolic link, which the judge ignores; commit a regular file`\n    );\n    return undefined;\n  }\n  const courseFilePath = join(courseDirectoryPath, courseFileName);\n  let rawContent: unknown;\n  try {\n    rawContent = parseYaml(await readFile(courseFilePath, 'utf8'));\n  } catch (error) {\n    errors.push(`${courseFileName}: invalid YAML: ${getErrorMessage(error)}`);\n    return undefined;\n  }\n  const parsed = courseFileSchema.safeParse(rawContent);\n  if (!parsed.success) {\n    errors.push(...formatZodIssues(parsed.error, courseFileName));\n    return undefined;\n  }\n  return { courseFile: parsed.data, courseFileName };\n}\n\nasync function findFirst<T>(items: readonly T[], predicate: (item: T) => Promise<boolean>): Promise<T | undefined> {\n  for (const item of items) {\n    if (await predicate(item)) return item;\n  }\n  return undefined;\n}\n\nfunction isMaterialFileName(fileName: string): boolean {\n  return (\n    fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX) ||\n    (fileName.endsWith('.md') && fileName !== 'problem.md' && !fileName.endsWith('.problem.md'))\n  );\n}\n\n/**\n * The judge scopes every problem inside the course directory (at any depth) to the course, so the\n * course is always searched; an explicit directory must lie inside it.\n */\nasync function collectAvailableProblemIds(\n  courseDirectoryPath: string,\n  problemsDirectoryOption: string | undefined,\n  explicitProblemsDirectoryPath: string | undefined,\n  errors: string[]\n): Promise<Set<string>> {\n  const definitionPathsById = await collectProblemDefinitions(courseDirectoryPath);\n  reportProblemDefinitionIssues(definitionPathsById, errors);\n  const availableProblemIds = new Set(definitionPathsById.keys());\n  // Discovery does not traverse a symbolic link, so a linked problems directory imports nothing.\n  const courseProblemsDirectoryPath = join(courseDirectoryPath, 'problems');\n  const namesConventionalDirectory =\n    explicitProblemsDirectoryPath !== undefined &&\n    (await isSameEntry(explicitProblemsDirectoryPath, courseProblemsDirectoryPath));\n  if (namesConventionalDirectory || (await isDirectory(courseProblemsDirectoryPath))) {\n    await isUsableProblemsDirectory(courseProblemsDirectoryPath, errors);\n  }\n  if (explicitProblemsDirectoryPath === undefined || namesConventionalDirectory) return availableProblemIds;\n  if (\n    (await isUsableProblemsDirectory(explicitProblemsDirectoryPath, errors)) &&\n    isOutsideDirectory(courseDirectoryPath, explicitProblemsDirectoryPath)\n  ) {\n    // Exercode links a material only to problems inside its course, so outside problems never count.\n    errors.push(\n      `problems directory ${problemsDirectoryOption} is outside the course directory; Exercode links a material only to problems inside the course, so move them under the course`\n    );\n  }\n  return availableProblemIds;\n}\n\n/** Whether two paths name the same directory entry (e.g. differently cased on a case-insensitive file system). */\nasync function isSameEntry(path1: string, path2: string): Promise<boolean> {\n  if (path1 === path2) return true;\n  try {\n    const [stats1, stats2] = await Promise.all([lstat(path1), lstat(path2)]);\n    return stats1.dev === stats2.dev && stats1.ino === stats2.ino;\n  } catch {\n    return false;\n  }\n}\n\nfunction isOutsideDirectory(parentPath: string, path: string): boolean {\n  const relativePath = relative(parentPath, path);\n  return relativePath === '..' || relativePath.startsWith(`..${sep}`);\n}\n\nasync function validateLectureDirectory(\n  courseDirectoryPath: string,\n  materialOptions: MaterialValidationOptions,\n  lectureId: string,\n  errors: string[],\n  warnings: string[]\n): Promise<void> {\n  const lectureDirectoryPath = join(courseDirectoryPath, lectureId);\n  // The judge lists lecture entries as regular files and directories, so symbolic links vanish.\n  if (!(await isRegularDirectory(lectureDirectoryPath))) {\n    errors.push(\n      (await isDirectory(lectureDirectoryPath))\n        ? `lecture \"${lectureId}\": directory is a symbolic link, which the judge does not traverse`\n        : `lecture \"${lectureId}\": directory not found`\n    );\n    return;\n  }\n\n  const materialIds: string[] = [];\n  const dirents = await readdir(lectureDirectoryPath, { withFileTypes: true });\n  for (const dirent of dirents) {\n    if (dirent.isSymbolicLink()) {\n      errors.push(`${lectureId}/${dirent.name} is a symbolic link, which the judge ignores; commit a regular file`);\n    }\n  }\n  const fileNames = dirents\n    .filter((dirent) => dirent.isFile())\n    .map((dirent) => dirent.name)\n    .toSorted((f1, f2) => f1.localeCompare(f2));\n  for (const fileName of fileNames) {\n    const materialFilePath = join(lectureDirectoryPath, fileName);\n    let materialResult: ValidationResult;\n    if (fileName.endsWith(CONTEST_MATERIAL_FILE_SUFFIX)) {\n      materialIds.push(fileName.slice(0, -CONTEST_MATERIAL_FILE_SUFFIX.length));\n      materialResult = await validateContestFile(materialFilePath, { ...materialOptions, isNestedInCourse: true });\n    } else if (fileName.endsWith('.md')) {\n      materialIds.push(fileName.replace(/\\.[^/.]+$/, ''));\n      materialResult = await validateMaterialFile(materialFilePath, materialOptions);\n    } else {\n      continue;\n    }\n    errors.push(...materialResult.errors.map((error) => `${lectureId}/${fileName}: ${error}`));\n    warnings.push(...materialResult.warnings.map((warning) => `${lectureId}/${fileName}: ${warning}`));\n  }\n\n  if (materialIds.length === 0) {\n    warnings.push(`lecture \"${lectureId}\": no material files (*.md or *${CONTEST_MATERIAL_FILE_SUFFIX}) found`);\n  }\n  // Material IDs only need to be unique per lecture: exercode's import key is\n  // `${courseId}.${lectureId}.${materialId}`, so a course-wide check would reject courses\n  // that import fine. Scope the report to the lecture so multi-lecture courses point at the\n  // right files.\n  const duplicateMaterialErrors: string[] = [];\n  reportDuplicateIds(materialIds, 'material', duplicateMaterialErrors);\n  errors.push(...duplicateMaterialErrors.map((error) => `lecture \"${lectureId}\": ${error}`));\n}\n"],"mappings":"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"}

package/dist/learningMaterial/validateMaterial.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"validateMaterial.cjs","names":["basename","LEARNING_MATERIAL_ID_REGEX","readFile","parseFrontmatter","getErrorMessage","materialFrontmatterSchema","formatZodIssues","collectProblemIdsFromDirectory","parseYaml","questionInCodeBlockSchema","require_schemas","require_fsHelpers","require_frontmatter","require_validationResult","node_path","node_fs_promises","_willbooster_shared_lib","yaml","QUESTION_CODE_BLOCK_REGEX","QUESTION_CODE_BLOCK_OPENER_REGEX","PROBLEM_LINK_REGEX","TURTLE_GRAPHICS_QUESTION_LINK_REGEX","PROBLEM_ASSIGNMENT_REGEX","QUESTION_LINK_REGEX","TURTLE_GRAPHICS_ASSIGNMENT_REGEX","STANDALONE_CHAT_MARKER_REGEX","validateMaterialFile","errors","result","materialId","materialFilePath","markdown","attributes","body","error","parsedFrontmatter","frontmatter","questionsInCodeBlocks","parseQuestionCodeBlocks","questionBlockIds","question","questions","validateQuestion","bodyWithoutQuestionBlocks","collectLinkedIds","linkedTurtleGraphicsQuestionIds","problemIds","problem","reportForeignProblemCourseIds","options","availableProblemIds","reportExcessChatMarkers","validateSubmissionPeriods","mergeSubmissionPeriods","linkRegex","match","id","own","courseDefaults","chatMarkerCount","courseId","problems","matches","leftoverOpenerCount","blockIndex","yamlText","\"yaml\"","rawQuestion","parsed","isSurvey","answerFieldName","isAnswerDefined","answerIndices","answerIndex","answerPattern","answerRegExp","rawAnswerRegExp","periods","earlierName","laterName","earlierValue","laterValue","ownPeriods"],"sources":["../../src/learningMaterial/validateMaterial.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { basename } from 'node:path';\nimport { getErrorMessage } from '@willbooster/shared-lib';\nimport { parse as parseYaml } from 'yaml';\nimport { collectProblemIdsFromDirectory, reportDanglingProblemReferences } from './fsHelpers.js';\nimport { parseFrontmatter } from './frontmatter.js';\nimport {\n  LEARNING_MATERIAL_ID_REGEX,\n  materialFrontmatterSchema,\n  questionInCodeBlockSchema,\n  type MaterialQuestion,\n} from './schemas.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\n// Same patterns the judge uses to extract embedded questions and problem links from material bodies.\n// The block regex intentionally requires LF line endings and a trailing newline after the closing\n// fence, exactly like the judge parser; blocks it misses are reported by detecting leftover openers.\nconst QUESTION_CODE_BLOCK_REGEX = /(?:^|\\n)(?<fence>`{3,}|~{3,})ya?ml +question\\n(?<yaml>[\\s\\S]+?)\\n\\k<fence>\\n/g;\n// Strictly laxer than the parser regex (tolerates CRLF, indentation, and stray whitespace) so\n// question-looking blocks the judge parser would silently skip surface as leftover openers.\nconst QUESTION_CODE_BLOCK_OPENER_REGEX = /^[ \\t]*(?:`{3,}|~{3,})[ \\t]*ya?ml[ \\t]+question[ \\t]*\\r?$/gm;\nconst PROBLEM_LINK_REGEX = /\\[.*?]\\(problems\\/([0-9_a-z-]+?)\\)/g;\nconst TURTLE_GRAPHICS_QUESTION_LINK_REGEX = /\\[.*?]\\(turtle-graphics-questions\\/([0-9_a-z-]+?)\\)/g;\n// Exercode's duplicate-assignment check scans the body with these patterns, whose link text may\n// span lines (unlike the judge's reference collection above).\nconst PROBLEM_ASSIGNMENT_REGEX = /\\[[^\\]]*]\\(problems\\/([0-9_a-z-]+)\\)/g;\nconst QUESTION_LINK_REGEX = /@\\[question]\\(([0-9_a-z-]+)\\)/g;\nconst TURTLE_GRAPHICS_ASSIGNMENT_REGEX = /\\[[^\\]]*]\\(turtle-graphics-questions\\/([0-9_a-z-]+)\\)/g;\nconst CHAT_MARKER = '<!-- chat -->';\n// exercode only counts the marker when it stands alone on a line, so fenced or inline mentions don't count.\nconst STANDALONE_CHAT_MARKER_REGEX = /(^|\\r?\\n)<!-- chat -->[ \\t]*(?=\\r?\\n|$)/g;\n\nexport interface SubmissionPeriods {\n  submissionOpenedAt?: string;\n  submissionSoftClosedAt?: string;\n  submissionHardClosedAt?: string;\n}\n\nexport interface MaterialValidationOptions {\n  /** Problem IDs already collected for the enclosing course; collected from `problemsDirectoryPath` otherwise. */\n  availableProblemIds?: ReadonlySet<string>;\n  /** When set, every referenced problem ID must be a problem discovered under this path. */\n  problemsDirectoryPath?: string;\n  /** Enclosing course ID; the judge rejects problem references whose `courseId` differs from it. */\n  courseId?: string;\n  /** Course-level submission periods; the judge merges them as `material[field] ?? course[field]`. */\n  courseSubmissionPeriods?: SubmissionPeriods;\n}\n\n/** Validates an exercode markdown material file (frontmatter, embedded questions, problem references). */\nexport async function validateMaterialFile(\n  materialFilePath: string,\n  options: MaterialValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  const materialId = basename(materialFilePath).replace(/\\.[^/.]+$/, '');\n  if (!LEARNING_MATERIAL_ID_REGEX.test(materialId)) {\n    errors.push(`material ID \"${materialId}\" (file name without extension) must match ${LEARNING_MATERIAL_ID_REGEX}`);\n  }\n\n  let markdown: string;\n  try {\n    markdown = await readFile(materialFilePath, 'utf8');\n  } catch {\n    errors.push(`material file not found: ${materialFilePath}`);\n    return result;\n  }\n\n  let attributes: unknown;\n  let body: string;\n  try {\n    ({ attributes, body } = parseFrontmatter(markdown));\n  } catch (error) {\n    errors.push(`invalid YAML frontmatter: ${getErrorMessage(error)}`);\n    return result;\n  }\n\n  const parsedFrontmatter = materialFrontmatterSchema.safeParse(attributes);\n  if (!parsedFrontmatter.success) {\n    errors.push(...formatZodIssues(parsedFrontmatter.error, 'frontmatter'));\n  }\n  const frontmatter = parsedFrontmatter.success ? parsedFrontmatter.data : undefined;\n\n  const questionsInCodeBlocks = parseQuestionCodeBlocks(body, errors);\n  const questionBlockIds = questionsInCodeBlocks.map((question) => question.id);\n  const questions = [...(frontmatter?.questions ?? []), ...questionsInCodeBlocks];\n  for (const question of questions) {\n    validateQuestion(question, errors);\n  }\n  reportDuplicateIds(\n    questions.map((question) => question.id),\n    'question',\n    errors\n  );\n  // Turtle-graphics links in the body merge into the frontmatter list like problem links do,\n  // and exercode rejects duplicates in the merged list; deferred until after the question blocks\n  // are removed below so links inside question text don't count.\n\n  // Exercode's import validation runs two checks: the body must not link the same problem,\n  // question or turtle-graphics question twice (every occurrence of the lax link pattern counts),\n  // and the generated reference list (frontmatter entries plus the judge's deduplicated body links)\n  // must not repeat an ID. The judge replaces recognized question blocks with @[question](id) links\n  // before collecting links, so links that appear only inside question text must not count, while\n  // each block counts as one question link next to explicit @[question](id) links.\n  const bodyWithoutQuestionBlocks = body.replaceAll(QUESTION_CODE_BLOCK_REGEX, '\\n');\n  reportDuplicateIds(\n    [...questionBlockIds, ...collectLinkedIds(bodyWithoutQuestionBlocks, QUESTION_LINK_REGEX)],\n    'question link',\n    errors\n  );\n  reportDuplicateIds(collectLinkedIds(bodyWithoutQuestionBlocks, PROBLEM_ASSIGNMENT_REGEX), 'problem link', errors);\n  reportDuplicateIds(\n    collectLinkedIds(bodyWithoutQuestionBlocks, TURTLE_GRAPHICS_ASSIGNMENT_REGEX),\n    'turtle-graphics question link',\n    errors\n  );\n  const linkedTurtleGraphicsQuestionIds = new Set(\n    collectLinkedIds(bodyWithoutQuestionBlocks, TURTLE_GRAPHICS_QUESTION_LINK_REGEX)\n  );\n  reportDuplicateIds(\n    [\n      ...(frontmatter?.turtleGraphicsQuestions ?? []).map((question) => question.id),\n      ...linkedTurtleGraphicsQuestionIds,\n    ],\n    'turtleGraphicsQuestion',\n    errors\n  );\n  // Only the links the judge collects become references, and it deduplicates them before merging.\n  const problemIds = [\n    ...(frontmatter?.problems ?? []).map((problem) => problem.id),\n    ...new Set(collectLinkedIds(bodyWithoutQuestionBlocks, PROBLEM_LINK_REGEX)),\n  ];\n  reportDuplicateIds(problemIds, 'problem', errors);\n  reportForeignProblemCourseIds(frontmatter?.problems ?? [], options.courseId, errors);\n  const availableProblemIds =\n    options.availableProblemIds ??\n    (options.problemsDirectoryPath === undefined\n      ? undefined\n      : await collectProblemIdsFromDirectory(options.problemsDirectoryPath, errors));\n  if (availableProblemIds !== undefined) {\n    reportDanglingProblemReferences(problemIds, availableProblemIds, options.problemsDirectoryPath, errors);\n  }\n\n  reportExcessChatMarkers(body, errors);\n\n  if (frontmatter) {\n    validateSubmissionPeriods(\n      mergeSubmissionPeriods(frontmatter, options.courseSubmissionPeriods),\n      errors,\n      frontmatter\n    );\n  }\n  return result;\n}\n\nfunction collectLinkedIds(body: string, linkRegex: RegExp): string[] {\n  return [...body.matchAll(linkRegex)].map((match) => match[1]).filter((id) => id !== undefined);\n}\n\n/** Applies the judge's course→material config merge (`material[field] ?? course[field]`). */\nexport function mergeSubmissionPeriods(\n  own: SubmissionPeriods,\n  courseDefaults: SubmissionPeriods | undefined\n): SubmissionPeriods {\n  return {\n    submissionOpenedAt: own.submissionOpenedAt ?? courseDefaults?.submissionOpenedAt,\n    submissionSoftClosedAt: own.submissionSoftClosedAt ?? courseDefaults?.submissionSoftClosedAt,\n    submissionHardClosedAt: own.submissionHardClosedAt ?? courseDefaults?.submissionHardClosedAt,\n  };\n}\n\n/** exercode rejects more than one standalone chat delimiter line in material and problem bodies. */\nexport function reportExcessChatMarkers(body: string, errors: string[]): void {\n  const chatMarkerCount = [...body.matchAll(STANDALONE_CHAT_MARKER_REGEX)].length;\n  if (chatMarkerCount > 1) {\n    errors.push(`at most one \\`${CHAT_MARKER}\\` marker is allowed, but found ${chatMarkerCount}`);\n  }\n}\n\n/** The judge's resolveProblemCourseId throws when a problem reference names a different course. */\nexport function reportForeignProblemCourseIds(\n  problems: readonly { id: string; courseId?: string }[],\n  courseId: string | undefined,\n  errors: string[]\n): void {\n  if (courseId === undefined) return;\n  for (const problem of problems) {\n    if (problem.courseId !== undefined && problem.courseId !== courseId) {\n      errors.push(`problem \"${problem.id}\": courseId must be \"${courseId}\" but is \"${problem.courseId}\"`);\n    }\n  }\n}\n\nfunction parseQuestionCodeBlocks(body: string, errors: string[]): MaterialQuestion[] {\n  const questions: MaterialQuestion[] = [];\n  const matches = [...body.matchAll(QUESTION_CODE_BLOCK_REGEX)];\n  // The judge silently renders unparsed question blocks as plain code blocks, so a block the\n  // strict regex misses (CRLF line endings, or no newline after the closing fence) would break\n  // in production while looking fine here; flag it instead of validating a lie. Openers inside a\n  // recognized block (e.g. an example fence in a question's text) are consumed with that block.\n  const leftoverOpenerCount = [\n    ...body.replaceAll(QUESTION_CODE_BLOCK_REGEX, '\\n').matchAll(QUESTION_CODE_BLOCK_OPENER_REGEX),\n  ].length;\n  if (leftoverOpenerCount > 0) {\n    errors.push(\n      `${leftoverOpenerCount} question code block(s) will not be recognized by the judge parser; separate consecutive question blocks with a blank line, use LF line endings, no indentation or trailing whitespace on the fence line, and end the closing fence with a newline`\n    );\n  }\n  for (const [blockIndex, match] of matches.entries()) {\n    const yamlText = match.groups?.['yaml'] ?? '';\n    let rawQuestion: unknown;\n    try {\n      rawQuestion = parseYaml(yamlText);\n    } catch (error) {\n      errors.push(`question block ${blockIndex + 1}: invalid YAML: ${getErrorMessage(error)}`);\n      continue;\n    }\n    const parsed = questionInCodeBlockSchema.safeParse(rawQuestion);\n    if (parsed.success) {\n      questions.push(parsed.data);\n    } else {\n      errors.push(...formatZodIssues(parsed.error, `question block ${blockIndex + 1}`));\n    }\n  }\n  return questions;\n}\n\nfunction validateQuestion(question: MaterialQuestion, errors: string[]): void {\n  const isSurvey = question.isSurvey === true;\n  const [answerFieldName, isAnswerDefined] =\n    question.type === 'select'\n      ? (['answerIndex', question.answerIndex !== undefined] as const)\n      : question.type === 'select_multiple'\n        ? (['answerIndices', question.answerIndices !== undefined] as const)\n        : (['answerPattern', question.answerPattern !== undefined] as const);\n  if (isSurvey && isAnswerDefined) {\n    errors.push(`question ${question.id}: \\`${answerFieldName}\\` must not be set when \\`isSurvey\\` is true`);\n  }\n  if (!isSurvey && !isAnswerDefined) {\n    errors.push(`question ${question.id}: \\`${answerFieldName}\\` is required when \\`isSurvey\\` is not true`);\n  }\n\n  if (question.type === 'select' || question.type === 'select_multiple') {\n    const answerIndices =\n      question.type === 'select'\n        ? Array.isArray(question.answerIndex)\n          ? question.answerIndex\n          : question.answerIndex === undefined\n            ? []\n            : [question.answerIndex]\n        : (question.answerIndices ?? []);\n    // An empty answer set is broken at runtime (select: never correct; select_multiple: an empty\n    // submission grades as correct), and exercode's material editor rejects it as well.\n    if (!isSurvey && isAnswerDefined && answerIndices.length === 0) {\n      errors.push(`question ${question.id}: \\`${answerFieldName}\\` must contain at least one correct answer`);\n    }\n    for (const answerIndex of answerIndices) {\n      if (!Number.isInteger(answerIndex) || answerIndex < 0 || answerIndex >= question.options.length) {\n        errors.push(\n          `question ${question.id}: ${answerFieldName} out of bounds: ${answerIndex}; expected 0 <= index < options length ${question.options.length}`\n        );\n      }\n    }\n    return;\n  }\n\n  if (isSurvey || question.answerPattern === undefined) return;\n  const answerPattern = question.answerPattern.trim();\n  let answerRegExp: RegExp;\n  let rawAnswerRegExp: RegExp;\n  try {\n    answerRegExp = new RegExp(`^(?:${answerPattern})$`);\n    // Compiled inside the same guard: a pattern like `a)(b` is valid only once wrapped above,\n    // so an unguarded raw compile would crash the CLI instead of reporting an error.\n    rawAnswerRegExp = new RegExp(question.answerPattern);\n  } catch {\n    errors.push(\n      `question ${question.id}: \\`answerPattern\\` is not a valid regular expression: ${question.answerPattern}`\n    );\n    return;\n  }\n  // Mirrors the judge heuristic: a pattern that doesn't match itself likely uses RegExp syntax,\n  // so a modelAnswer is required to prove that some concrete answer is accepted.\n  // Like the judge, an empty modelAnswer counts as missing.\n  // The judge runs this heuristic on the untrimmed pattern and trims only for the anchored match.\n  if (!question.modelAnswer && !rawAnswerRegExp.test(question.answerPattern)) {\n    errors.push(`question ${question.id}: \\`answerPattern\\` seems a RegExp but \\`modelAnswer\\` is missing`);\n  }\n  if (question.modelAnswer && !answerRegExp.test(question.modelAnswer.trim())) {\n    errors.push(`question ${question.id}: \\`modelAnswer\\` doesn't match \\`answerPattern\\``);\n  }\n}\n\n/**\n * Reports inverted submission periods; shared by material, course.yaml, and contest validation.\n * When `ownPeriods` is given (the merged-values case), pairs whose both values are inherited from\n * the course are skipped: they are the course's mistake and are already reported against\n * course.yaml, so repeating them per material would send agents to files with nothing to fix.\n */\nexport function validateSubmissionPeriods(\n  periods: SubmissionPeriods,\n  errors: string[],\n  ownPeriods: SubmissionPeriods = periods\n): void {\n  const pairs = [\n    ['submissionOpenedAt', 'submissionSoftClosedAt'],\n    ['submissionSoftClosedAt', 'submissionHardClosedAt'],\n    ['submissionOpenedAt', 'submissionHardClosedAt'],\n  ] as const satisfies readonly (readonly [keyof SubmissionPeriods, keyof SubmissionPeriods])[];\n  for (const [earlierName, laterName] of pairs) {\n    const earlierValue = periods[earlierName];\n    const laterValue = periods[laterName];\n    if (earlierValue === undefined || laterValue === undefined) continue;\n    if (ownPeriods[earlierName] === undefined && ownPeriods[laterName] === undefined) continue;\n    if (new Date(laterValue).getTime() < new Date(earlierValue).getTime()) {\n      errors.push(`${earlierName} (${earlierValue}) must be <= ${laterName} (${laterValue})`);\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"validateMaterial.cjs","names":["basename","LEARNING_MATERIAL_ID_REGEX","readFile","parseFrontmatter","getErrorMessage","materialFrontmatterSchema","formatZodIssues","collectProblemIdsFromDirectory","parseYaml","questionInCodeBlockSchema","require_schemas","require_fsHelpers","require_frontmatter","require_validationResult","node_path","node_fs_promises","_willbooster_shared_lib","yaml","QUESTION_CODE_BLOCK_REGEX","QUESTION_CODE_BLOCK_OPENER_REGEX","PROBLEM_LINK_REGEX","TURTLE_GRAPHICS_QUESTION_LINK_REGEX","PROBLEM_ASSIGNMENT_REGEX","QUESTION_LINK_REGEX","TURTLE_GRAPHICS_ASSIGNMENT_REGEX","STANDALONE_CHAT_MARKER_REGEX","validateMaterialFile","errors","result","materialId","materialFilePath","markdown","attributes","body","error","parsedFrontmatter","frontmatter","questionsInCodeBlocks","parseQuestionCodeBlocks","questionBlockIds","question","questions","validateQuestion","bodyWithoutQuestionBlocks","collectLinkedIds","linkedTurtleGraphicsQuestionIds","problemIds","problem","reportForeignProblemCourseIds","options","availableProblemIds","reportExcessChatMarkers","validateSubmissionPeriods","mergeSubmissionPeriods","linkRegex","match","id","own","courseDefaults","chatMarkerCount","courseId","problems","matches","leftoverOpenerCount","blockIndex","yamlText","\"yaml\"","rawQuestion","parsed","isSurvey","answerFieldName","isAnswerDefined","answerIndices","answerIndex","answerPattern","answerRegExp","rawAnswerRegExp","periods","earlierName","laterName","earlierValue","laterValue","ownPeriods"],"sources":["../../src/learningMaterial/validateMaterial.ts"],"sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { basename } from 'node:path';\n\nimport { getErrorMessage } from '@willbooster/shared-lib';\nimport { parse as parseYaml } from 'yaml';\n\nimport { parseFrontmatter } from './frontmatter.js';\nimport { collectProblemIdsFromDirectory, reportDanglingProblemReferences } from './fsHelpers.js';\nimport {\n  LEARNING_MATERIAL_ID_REGEX,\n  materialFrontmatterSchema,\n  type MaterialQuestion,\n  questionInCodeBlockSchema,\n} from './schemas.js';\nimport { formatZodIssues, reportDuplicateIds, type ValidationResult } from './validationResult.js';\n\n// Same patterns the judge uses to extract embedded questions and problem links from material bodies.\n// The block regex intentionally requires LF line endings and a trailing newline after the closing\n// fence, exactly like the judge parser; blocks it misses are reported by detecting leftover openers.\nconst QUESTION_CODE_BLOCK_REGEX = /(?:^|\\n)(?<fence>`{3,}|~{3,})ya?ml +question\\n(?<yaml>[\\s\\S]+?)\\n\\k<fence>\\n/g;\n// Strictly laxer than the parser regex (tolerates CRLF, indentation, and stray whitespace) so\n// question-looking blocks the judge parser would silently skip surface as leftover openers.\nconst QUESTION_CODE_BLOCK_OPENER_REGEX = /^[ \\t]*(?:`{3,}|~{3,})[ \\t]*ya?ml[ \\t]+question[ \\t]*\\r?$/gm;\nconst PROBLEM_LINK_REGEX = /\\[.*?]\\(problems\\/([0-9_a-z-]+?)\\)/g;\nconst TURTLE_GRAPHICS_QUESTION_LINK_REGEX = /\\[.*?]\\(turtle-graphics-questions\\/([0-9_a-z-]+?)\\)/g;\n// Exercode's duplicate-assignment check scans the body with these patterns, whose link text may\n// span lines (unlike the judge's reference collection above).\nconst PROBLEM_ASSIGNMENT_REGEX = /\\[[^\\]]*]\\(problems\\/([0-9_a-z-]+)\\)/g;\nconst QUESTION_LINK_REGEX = /@\\[question]\\(([0-9_a-z-]+)\\)/g;\nconst TURTLE_GRAPHICS_ASSIGNMENT_REGEX = /\\[[^\\]]*]\\(turtle-graphics-questions\\/([0-9_a-z-]+)\\)/g;\nconst CHAT_MARKER = '<!-- chat -->';\n// exercode only counts the marker when it stands alone on a line, so fenced or inline mentions don't count.\nconst STANDALONE_CHAT_MARKER_REGEX = /(^|\\r?\\n)<!-- chat -->[ \\t]*(?=\\r?\\n|$)/g;\n\nexport interface SubmissionPeriods {\n  submissionOpenedAt?: string;\n  submissionSoftClosedAt?: string;\n  submissionHardClosedAt?: string;\n}\n\nexport interface MaterialValidationOptions {\n  /** Problem IDs already collected for the enclosing course; collected from `problemsDirectoryPath` otherwise. */\n  availableProblemIds?: ReadonlySet<string>;\n  /** When set, every referenced problem ID must be a problem discovered under this path. */\n  problemsDirectoryPath?: string;\n  /** Enclosing course ID; the judge rejects problem references whose `courseId` differs from it. */\n  courseId?: string;\n  /** Course-level submission periods; the judge merges them as `material[field] ?? course[field]`. */\n  courseSubmissionPeriods?: SubmissionPeriods;\n}\n\n/** Validates an exercode markdown material file (frontmatter, embedded questions, problem references). */\nexport async function validateMaterialFile(\n  materialFilePath: string,\n  options: MaterialValidationOptions = {}\n): Promise<ValidationResult> {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n  const result = { errors, warnings };\n\n  const materialId = basename(materialFilePath).replace(/\\.[^/.]+$/, '');\n  if (!LEARNING_MATERIAL_ID_REGEX.test(materialId)) {\n    errors.push(`material ID \"${materialId}\" (file name without extension) must match ${LEARNING_MATERIAL_ID_REGEX}`);\n  }\n\n  let markdown: string;\n  try {\n    markdown = await readFile(materialFilePath, 'utf8');\n  } catch {\n    errors.push(`material file not found: ${materialFilePath}`);\n    return result;\n  }\n\n  let attributes: unknown;\n  let body: string;\n  try {\n    ({ attributes, body } = parseFrontmatter(markdown));\n  } catch (error) {\n    errors.push(`invalid YAML frontmatter: ${getErrorMessage(error)}`);\n    return result;\n  }\n\n  const parsedFrontmatter = materialFrontmatterSchema.safeParse(attributes);\n  if (!parsedFrontmatter.success) {\n    errors.push(...formatZodIssues(parsedFrontmatter.error, 'frontmatter'));\n  }\n  const frontmatter = parsedFrontmatter.success ? parsedFrontmatter.data : undefined;\n\n  const questionsInCodeBlocks = parseQuestionCodeBlocks(body, errors);\n  const questionBlockIds = questionsInCodeBlocks.map((question) => question.id);\n  const questions = [...(frontmatter?.questions ?? []), ...questionsInCodeBlocks];\n  for (const question of questions) {\n    validateQuestion(question, errors);\n  }\n  reportDuplicateIds(\n    questions.map((question) => question.id),\n    'question',\n    errors\n  );\n  // Turtle-graphics links in the body merge into the frontmatter list like problem links do,\n  // and exercode rejects duplicates in the merged list; deferred until after the question blocks\n  // are removed below so links inside question text don't count.\n\n  // Exercode's import validation runs two checks: the body must not link the same problem,\n  // question or turtle-graphics question twice (every occurrence of the lax link pattern counts),\n  // and the generated reference list (frontmatter entries plus the judge's deduplicated body links)\n  // must not repeat an ID. The judge replaces recognized question blocks with @[question](id) links\n  // before collecting links, so links that appear only inside question text must not count, while\n  // each block counts as one question link next to explicit @[question](id) links.\n  const bodyWithoutQuestionBlocks = body.replaceAll(QUESTION_CODE_BLOCK_REGEX, '\\n');\n  reportDuplicateIds(\n    [...questionBlockIds, ...collectLinkedIds(bodyWithoutQuestionBlocks, QUESTION_LINK_REGEX)],\n    'question link',\n    errors\n  );\n  reportDuplicateIds(collectLinkedIds(bodyWithoutQuestionBlocks, PROBLEM_ASSIGNMENT_REGEX), 'problem link', errors);\n  reportDuplicateIds(\n    collectLinkedIds(bodyWithoutQuestionBlocks, TURTLE_GRAPHICS_ASSIGNMENT_REGEX),\n    'turtle-graphics question link',\n    errors\n  );\n  const linkedTurtleGraphicsQuestionIds = new Set(\n    collectLinkedIds(bodyWithoutQuestionBlocks, TURTLE_GRAPHICS_QUESTION_LINK_REGEX)\n  );\n  reportDuplicateIds(\n    [\n      ...(frontmatter?.turtleGraphicsQuestions ?? []).map((question) => question.id),\n      ...linkedTurtleGraphicsQuestionIds,\n    ],\n    'turtleGraphicsQuestion',\n    errors\n  );\n  // Only the links the judge collects become references, and it deduplicates them before merging.\n  const problemIds = [\n    ...(frontmatter?.problems ?? []).map((problem) => problem.id),\n    ...new Set(collectLinkedIds(bodyWithoutQuestionBlocks, PROBLEM_LINK_REGEX)),\n  ];\n  reportDuplicateIds(problemIds, 'problem', errors);\n  reportForeignProblemCourseIds(frontmatter?.problems ?? [], options.courseId, errors);\n  const availableProblemIds =\n    options.availableProblemIds ??\n    (options.problemsDirectoryPath === undefined\n      ? undefined\n      : await collectProblemIdsFromDirectory(options.problemsDirectoryPath, errors));\n  if (availableProblemIds !== undefined) {\n    reportDanglingProblemReferences(problemIds, availableProblemIds, options.problemsDirectoryPath, errors);\n  }\n\n  reportExcessChatMarkers(body, errors);\n\n  if (frontmatter) {\n    validateSubmissionPeriods(\n      mergeSubmissionPeriods(frontmatter, options.courseSubmissionPeriods),\n      errors,\n      frontmatter\n    );\n  }\n  return result;\n}\n\nfunction collectLinkedIds(body: string, linkRegex: RegExp): string[] {\n  return [...body.matchAll(linkRegex)].map((match) => match[1]).filter((id) => id !== undefined);\n}\n\n/** Applies the judge's course→material config merge (`material[field] ?? course[field]`). */\nexport function mergeSubmissionPeriods(\n  own: SubmissionPeriods,\n  courseDefaults: SubmissionPeriods | undefined\n): SubmissionPeriods {\n  return {\n    submissionOpenedAt: own.submissionOpenedAt ?? courseDefaults?.submissionOpenedAt,\n    submissionSoftClosedAt: own.submissionSoftClosedAt ?? courseDefaults?.submissionSoftClosedAt,\n    submissionHardClosedAt: own.submissionHardClosedAt ?? courseDefaults?.submissionHardClosedAt,\n  };\n}\n\n/** exercode rejects more than one standalone chat delimiter line in material and problem bodies. */\nexport function reportExcessChatMarkers(body: string, errors: string[]): void {\n  const chatMarkerCount = [...body.matchAll(STANDALONE_CHAT_MARKER_REGEX)].length;\n  if (chatMarkerCount > 1) {\n    errors.push(`at most one \\`${CHAT_MARKER}\\` marker is allowed, but found ${chatMarkerCount}`);\n  }\n}\n\n/** The judge's resolveProblemCourseId throws when a problem reference names a different course. */\nexport function reportForeignProblemCourseIds(\n  problems: readonly { id: string; courseId?: string }[],\n  courseId: string | undefined,\n  errors: string[]\n): void {\n  if (courseId === undefined) return;\n  for (const problem of problems) {\n    if (problem.courseId !== undefined && problem.courseId !== courseId) {\n      errors.push(`problem \"${problem.id}\": courseId must be \"${courseId}\" but is \"${problem.courseId}\"`);\n    }\n  }\n}\n\nfunction parseQuestionCodeBlocks(body: string, errors: string[]): MaterialQuestion[] {\n  const questions: MaterialQuestion[] = [];\n  const matches = [...body.matchAll(QUESTION_CODE_BLOCK_REGEX)];\n  // The judge silently renders unparsed question blocks as plain code blocks, so a block the\n  // strict regex misses (CRLF line endings, or no newline after the closing fence) would break\n  // in production while looking fine here; flag it instead of validating a lie. Openers inside a\n  // recognized block (e.g. an example fence in a question's text) are consumed with that block.\n  const leftoverOpenerCount = [\n    ...body.replaceAll(QUESTION_CODE_BLOCK_REGEX, '\\n').matchAll(QUESTION_CODE_BLOCK_OPENER_REGEX),\n  ].length;\n  if (leftoverOpenerCount > 0) {\n    errors.push(\n      `${leftoverOpenerCount} question code block(s) will not be recognized by the judge parser; separate consecutive question blocks with a blank line, use LF line endings, no indentation or trailing whitespace on the fence line, and end the closing fence with a newline`\n    );\n  }\n  for (const [blockIndex, match] of matches.entries()) {\n    const yamlText = match.groups?.['yaml'] ?? '';\n    let rawQuestion: unknown;\n    try {\n      rawQuestion = parseYaml(yamlText);\n    } catch (error) {\n      errors.push(`question block ${blockIndex + 1}: invalid YAML: ${getErrorMessage(error)}`);\n      continue;\n    }\n    const parsed = questionInCodeBlockSchema.safeParse(rawQuestion);\n    if (parsed.success) {\n      questions.push(parsed.data);\n    } else {\n      errors.push(...formatZodIssues(parsed.error, `question block ${blockIndex + 1}`));\n    }\n  }\n  return questions;\n}\n\nfunction validateQuestion(question: MaterialQuestion, errors: string[]): void {\n  const isSurvey = question.isSurvey === true;\n  const [answerFieldName, isAnswerDefined] =\n    question.type === 'select'\n      ? (['answerIndex', question.answerIndex !== undefined] as const)\n      : question.type === 'select_multiple'\n        ? (['answerIndices', question.answerIndices !== undefined] as const)\n        : (['answerPattern', question.answerPattern !== undefined] as const);\n  if (isSurvey && isAnswerDefined) {\n    errors.push(`question ${question.id}: \\`${answerFieldName}\\` must not be set when \\`isSurvey\\` is true`);\n  }\n  if (!isSurvey && !isAnswerDefined) {\n    errors.push(`question ${question.id}: \\`${answerFieldName}\\` is required when \\`isSurvey\\` is not true`);\n  }\n\n  if (question.type === 'select' || question.type === 'select_multiple') {\n    const answerIndices =\n      question.type === 'select'\n        ? Array.isArray(question.answerIndex)\n          ? question.answerIndex\n          : question.answerIndex === undefined\n            ? []\n            : [question.answerIndex]\n        : (question.answerIndices ?? []);\n    // An empty answer set is broken at runtime (select: never correct; select_multiple: an empty\n    // submission grades as correct), and exercode's material editor rejects it as well.\n    if (!isSurvey && isAnswerDefined && answerIndices.length === 0) {\n      errors.push(`question ${question.id}: \\`${answerFieldName}\\` must contain at least one correct answer`);\n    }\n    for (const answerIndex of answerIndices) {\n      if (!Number.isInteger(answerIndex) || answerIndex < 0 || answerIndex >= question.options.length) {\n        errors.push(\n          `question ${question.id}: ${answerFieldName} out of bounds: ${answerIndex}; expected 0 <= index < options length ${question.options.length}`\n        );\n      }\n    }\n    return;\n  }\n\n  if (isSurvey || question.answerPattern === undefined) return;\n  const answerPattern = question.answerPattern.trim();\n  let answerRegExp: RegExp;\n  let rawAnswerRegExp: RegExp;\n  try {\n    answerRegExp = new RegExp(`^(?:${answerPattern})$`);\n    // Compiled inside the same guard: a pattern like `a)(b` is valid only once wrapped above,\n    // so an unguarded raw compile would crash the CLI instead of reporting an error.\n    rawAnswerRegExp = new RegExp(question.answerPattern);\n  } catch {\n    errors.push(\n      `question ${question.id}: \\`answerPattern\\` is not a valid regular expression: ${question.answerPattern}`\n    );\n    return;\n  }\n  // Mirrors the judge heuristic: a pattern that doesn't match itself likely uses RegExp syntax,\n  // so a modelAnswer is required to prove that some concrete answer is accepted.\n  // Like the judge, an empty modelAnswer counts as missing.\n  // The judge runs this heuristic on the untrimmed pattern and trims only for the anchored match.\n  if (!question.modelAnswer && !rawAnswerRegExp.test(question.answerPattern)) {\n    errors.push(`question ${question.id}: \\`answerPattern\\` seems a RegExp but \\`modelAnswer\\` is missing`);\n  }\n  if (question.modelAnswer && !answerRegExp.test(question.modelAnswer.trim())) {\n    errors.push(`question ${question.id}: \\`modelAnswer\\` doesn't match \\`answerPattern\\``);\n  }\n}\n\n/**\n * Reports inverted submission periods; shared by material, course.yaml, and contest validation.\n * When `ownPeriods` is given (the merged-values case), pairs whose both values are inherited from\n * the course are skipped: they are the course's mistake and are already reported against\n * course.yaml, so repeating them per material would send agents to files with nothing to fix.\n */\nexport function validateSubmissionPeriods(\n  periods: SubmissionPeriods,\n  errors: string[],\n  ownPeriods: SubmissionPeriods = periods\n): void {\n  const pairs = [\n    ['submissionOpenedAt', 'submissionSoftClosedAt'],\n    ['submissionSoftClosedAt', 'submissionHardClosedAt'],\n    ['submissionOpenedAt', 'submissionHardClosedAt'],\n  ] as const satisfies readonly (readonly [keyof SubmissionPeriods, keyof SubmissionPeriods])[];\n  for (const [earlierName, laterName] of pairs) {\n    const earlierValue = periods[earlierName];\n    const laterValue = periods[laterName];\n    if (earlierValue === undefined || laterValue === undefined) continue;\n    if (ownPeriods[earlierName] === undefined && ownPeriods[laterName] === undefined) continue;\n    if (new Date(laterValue).getTime() < new Date(earlierValue).getTime()) {\n      errors.push(`${earlierName} (${earlierValue}) must be <= ${laterName} (${laterValue})`);\n    }\n  }\n}\n"],"mappings":"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"}