import type { UlwLoopCodexGoalMode, UlwLoopItem, UlwLoopPlan } from "./types.js";
import { UlwLoopError } from "./types.js";

export const ULW_LOOP_HELP = `Usage:
  omo ulw-loop create-goals --brief "..." [--brief-file <path>] [--from-stdin] [--codex-goal-mode aggregate|per_story] [--force] [--json]
  omo ulw-loop status [--json]
  omo ulw-loop complete-goals [--retry-failed] [--json]
  omo ulw-loop criteria --goal-id <id> [--json]
  omo ulw-loop record-evidence --goal-id <id> --criterion-id <id> --status pass|fail|blocked --evidence "..." [--notes "..."] [--json]
  omo ulw-loop checkpoint --goal-id <id> --status complete|failed|blocked --evidence "..." --codex-goal-json <...> [--quality-gate-json <...>] [--json]
  omo ulw-loop steer --kind <kind> ... --evidence "..." --rationale "..." [--json]
  omo ulw-loop add-goal --title "..." --objective "..." [--json]
  omo ulw-loop record-review-blockers --goal-id <id> --title "..." --objective "..." --evidence "..." --codex-goal-json <...> [--json]

All subcommands accept [--session-id <id>] to isolate state under .omo/ulw-loop/<id>/; without it, Codex session env is used when present.`;

type CriteriaCounts = { readonly pass: number; readonly total: number };

export function printJson(value: unknown): void {
	process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
}

function criteriaCounts(goal: UlwLoopItem): CriteriaCounts {
	let pass = 0;
	for (const criterion of goal.successCriteria) if (criterion.status === "pass") pass += 1;
	return { pass, total: goal.successCriteria.length };
}

export function printStatus(plan: UlwLoopPlan): void {
	let totalCriteria = 0;
	let passCriteria = 0;
	const lines = ["ulw-loop status", "", "goals:"];
	for (const goal of plan.goals) {
		const counts = criteriaCounts(goal);
		totalCriteria += counts.total;
		passCriteria += counts.pass;
		const marker = goal.id === plan.activeGoalId ? "*" : "-";
		lines.push(`${marker} ${goal.id} [${goal.status}] ${goal.title} (criteria: ${counts.pass}/${counts.total})`);
	}
	lines.push("", "summary:", `total goals: ${plan.goals.length}`, `criteria: ${passCriteria}/${totalCriteria} pass`);
	process.stdout.write(`${lines.join("\n")}\n`);
}

export function blockedDecisionHandoff(plan: UlwLoopPlan): string {
	const blocked = plan.goals.find((goal) => goal.status === "needs_user_decision" && goal.nonRetriable);
	if (blocked === undefined) return "";
	return [
		"ulw-loop: blocked on repeated external authorization; no retryable failed goals remain.",
		`Goal: ${blocked.id} - ${blocked.title}`,
		`Required external decision: ${blocked.requiredExternalDecision ?? "provide the missing authorization or choose a different unblock path"}.`,
		"Do not run complete-goals --retry-failed again until external state changes or the user authorizes an unblock path.",
	].join("\n");
}

export function normalizeCodexGoalMode(value: string | undefined): UlwLoopCodexGoalMode {
	if (value === undefined) return "aggregate";
	if (value === "aggregate" || value === "per_story") return value;
	throw new UlwLoopError(
		"Invalid --codex-goal-mode; expected aggregate or per_story.",
		"ULW_LOOP_CODEX_GOAL_MODE_INVALID",
		{ details: { value } },
	);
}