Function assertPlanShape

src/commands/test.ts:2033–2080

* Type-narrow + validate a parsed plan input. Pulled out so the same * checks run on `--plan-from` (single) and each JSONL line in * `create-batch --plans`. Throws `VALIDATION_ERROR` with a typed * `details.field` pointer so callers can fix specific issues without * re-reading the whole file.

(parsed: unknown, context: { specIndex?: number } = {})

 * re-reading the whole file.
 */
function assertPlanShape(parsed: unknown, context: { specIndex?: number } = {}): CliPlanInput {
  const prefix = context.specIndex !== undefined ? `specs[${context.specIndex}].` : '';

  // Every field below is a JSON body path inside the plan file (or
  // JSONL spec), not a CLI flag — pass `'field'` so the error message
  // says `Field \`projectId\` is invalid: ...` instead of inventing a
  // `--projectId` flag the user can't pass.
  if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
    throw localValidationError(`${prefix}plan`, 'must be a JSON object', undefined, 'field');
  }
  const obj = parsed as Record<string, unknown>;

  requireString(`${prefix}projectId`, obj.projectId);
  requireEnum(`${prefix}type`, obj.type, ['frontend', 'backend'] as const);
  requireString(`${prefix}name`, obj.name);
  if (obj.description !== undefined && typeof obj.description !== 'string') {
    throw localValidationError(
      `${prefix}description`,
      'must be a string when present',
      undefined,
      'field',
    );
  }
  if (obj.priority !== undefined) {
    requireEnum(`${prefix}priority`, obj.priority, CLI_CREATE_PRIORITIES);
  }
  requireArrayLength(`${prefix}planSteps`, obj.planSteps, {
    min: 1,
    max: MAX_PLAN_STEPS,
    itemNoun: 'step',
  });
  for (let i = 0; i < (obj.planSteps as unknown[]).length; i += 1) {
    const step = (obj.planSteps as unknown[])[i];
    if (typeof step !== 'object' || step === null || Array.isArray(step)) {
      throw localValidationError(
        `${prefix}planSteps[${i}]`,
        'must be an object',
        undefined,
        'field',
      );
    }
    const s = step as Record<string, unknown>;
    requireEnum(`${prefix}planSteps[${i}].type`, s.type, PLAN_STEP_TYPES);
    requireString(`${prefix}planSteps[${i}].description`, s.description);
  }

  return obj as unknown as CliPlanInput;
}

interface CreateBatchOptions extends CommonOptions {
  /** Path to the JSONL file containing one `CliPlanInput` per line. */