YeonGyu-Kim
64 lines
3.1 KiB
TypeScript
64 lines
3.1 KiB
TypeScript
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 } },
|
|
);
|
|
}
|