Function checkSchemaCommand

ts/workflow-cli/cli/check-schema.ts:74–109

(filePath?: string)

 * checks the file as written against the current contract.
 */
export async function checkSchemaCommand(filePath?: string): Promise<void> {
  if (!filePath) {
    process.stderr.write("Usage: fh-workflow check-schema <file.json>\n");
    process.exit(1);
  }

  const abs = path.resolve(process.cwd(), filePath);
  let raw: string;
  try {
    raw = await fs.readFile(abs, "utf-8");
  } catch (err: unknown) {
    const code = (err as NodeJS.ErrnoException).code;
    if (code === "ENOENT") {
      process.stderr.write(`File not found: ${abs}\n`);
      process.exit(1);
    }
    throw err;
  }

  let parsed: unknown;
  try {
    parsed = JSON.parse(raw);
  } catch (err) {
    process.stderr.write(`Invalid JSON: ${err instanceof Error ? err.message : String(err)}\n`);
    process.exit(1);
  }

  const { ok, errors } = validateAgainstContract(parsed);
  if (ok) {
    process.stdout.write(`✓ ${abs}: schema valid\n`);
    return;
  }

  printSchemaReport(abs, errors);
  process.exit(1);
}

function printSchemaReport(file: string, errors: ErrorObject[]): void {
  const out = process.stdout;