hacktheandes-cli 0.1.203 → 0.1.206

package/README.md

@@ -74,8 +74,12 @@ version; legacy attempts do not count toward admission.
 
 The public ranking is read-only at `https://hacktheandes.com/challenges`.
 
-Run `andes` for a compact retro welcome screen with a pixel Sacred Valley and
-the main commands. Run `andes --help` for the full command reference. The
+Run `andes` to see your current progress and the next command to run.
+`andes challenge` also checks your application before showing the challenge guide.
+Repeating `andes register` after submission shows your next step without submitting again.
+After acceptance, run `andes confirm`; after confirmation, run `andes badge`.
+Confirmation generates the badge automatically. Repeat `andes badge` if it is still processing.
+Run `andes --help` for the full command reference. The welcome screen's
 landscape uses colored terminal cells, with readable text that works with your
 terminal's line spacing. It adapts to the terminal width and has a plain ASCII
 fallback when color is disabled with `NO_COLOR`. JSON output and individual
@@ -93,6 +97,8 @@ Validation does not contact the API, and a successful result does not echo input
 values. Local validation errors include `acceptedFields` in JSON mode. The
 `status` response already includes both the registration and its requirements;
 use `requirements` only when requirements-only human output is preferred.
+The CLI adds `data.nextStep` with `kind`, `message`, and `command` to registration
+results and to home and challenge guidance. JSON output remains one versioned envelope.
 
 Run `andes login` to authenticate. For automation, provide an OAuth access
 token with `CHOFEX_TOKEN`.

package/dist/index.js

@@ -59988,7 +59988,7 @@ var challengeListText = (catalog) => {
   if (hasOpenChallenge) {
     lines2.push("Empieza el challenge abierto: andes challenge");
   } else {
-    lines2.push("No hay un challenge abierto. Los rankings finales siguen visibles.");
+    lines2.push("No hay un challenge abierto. Los rankings finales siguen visibles.", "Siguiente comando para consultar tu postulación: andes status");
   }
   return lines2.join(`
 `);
@@ -60023,7 +60023,11 @@ var challengeShowText = (attempt) => {
       if (progress.shareCode)
         lines3.push(`Código         #${progress.shareCode}`);
     }
-    lines3.push("", "SIGUIENTE PASO", "Lee el contrato. Antes de editar, discute tres trazas de falla y elige cuál investigar primero.", "  cd broken-agent && npm test", "  andes challenge test --challenge broken-agent --source ./scheduler.js");
+    if (attempt.latestEvaluation || challenge.closed || evaluationsRemaining <= 0) {
+      lines3.push("", "Consulta el estado de tu postulación y tu siguiente paso:", "  andes status");
+    } else {
+      lines3.push("", "SIGUIENTE PASO", "Desde la carpeta broken-agent, lee el contrato, repara scheduler.js y ejecuta los tests públicos:", "  andes challenge test --challenge broken-agent --source ./scheduler.js", "Después prepara review.json con tu revisión y envía una evaluación oficial:", "  andes challenge evaluate --challenge broken-agent --source ./scheduler.js --review ./review.json", "Abre personalmente el enlace de aprobación y repite el mismo comando. Los tests públicos por sí solos no completan el challenge.");
+    }
     return lines3.join(`
 `);
   }
@@ -60209,7 +60213,7 @@ var challengeTestText = (result3) => {
         lines3.push(`  ${String(mismatch.actual)}`);
       }
     }
-    lines3.push("", "Corrige las regresiones públicas antes de usar una evaluación oficial.");
+    lines3.push("", "Corrige las regresiones públicas antes de usar una evaluación oficial.", "Siguiente comando: andes challenge test --challenge broken-agent --source ./scheduler.js");
     return lines3.join(`
 `);
   }
@@ -60274,13 +60278,13 @@ var challengeRankingText = (ranking, now3 = new Date) => {
   const lines2 = [`${ranking.challenge.theme} — ${ranking.challenge.title}`];
   const { rankingVisibleAt } = ranking.challenge;
   if (rankingVisibleAt && !isChallengeRankingVisibleAt(ranking.challenge, now3)) {
-    lines2.push("", `Ranking disponible ${formatChallengeOpeningInPeru(rankingVisibleAt)}.`);
+    lines2.push("", `Ranking disponible ${formatChallengeOpeningInPeru(rankingVisibleAt)}.`, "Siguiente comando para consultar tu postulación: andes status");
     return lines2.join(`
 `);
   }
   lines2.push("");
   if (ranking.entries.length === 0) {
-    lines2.push("Todavía no hay evaluaciones oficiales.");
+    lines2.push("Todavía no hay evaluaciones oficiales.", "Siguiente comando: andes");
     return lines2.join(`
 `);
   }
@@ -60294,6 +60298,7 @@ var challengeRankingText = (ranking, now3 = new Date) => {
       const participant = [entry.displayName, ...profileLinks].join(" ");
       lines2.push(`${rank}  ${accuracy}  ${points}  ${participant}`);
     }
+    lines2.push("", "El ranking no confirma tu aceptación. Consulta tu siguiente paso:", "  andes status");
     return lines2.join(`
 `);
   }
@@ -60307,6 +60312,7 @@ var challengeRankingText = (ranking, now3 = new Date) => {
     const participant = [entry.displayName, ...profileLinks].join(" ");
     lines2.push(`${rank}  ${accuracy}  ${exact}  ${queries}  ${participant}`);
   }
+  lines2.push("", "El ranking no confirma tu aceptación. Consulta tu siguiente paso:", "  andes status");
   return lines2.join(`
 `);
 };
@@ -60865,6 +60871,108 @@ var root = exports_Command.make(cliCommandName).pipe(exports_Command.withSharedF
   token: exports_Flag.string(rootValueFlagNames.token).pipe(exports_Flag.optional, exports_Flag.withDescription("Clerk OAuth token (prefer CHOFEX_TOKEN to avoid shell history)"))
 }), exports_Command.withDescription(`Apply to ${eventName} and compete for a seat through the mandatory technical challenges`));
 
+// src/participant-guidance.ts
+var nextStepFor = (result3) => {
+  if (!result3) {
+    return {
+      kind: "register",
+      message: "Completa y envía tu postulación. Después deberás completar un challenge con una evaluación oficial.",
+      command: "andes register"
+    };
+  }
+  const { registration, requirements } = result3;
+  if (registration.status === "rejected" || registration.status === "withdrawn") {
+    return {
+      kind: "register",
+      message: "Puedes enviar una nueva postulación.",
+      command: "andes register"
+    };
+  }
+  if (registration.status === "accepted") {
+    if (requirements.stage === "complete") {
+      return {
+        kind: "badge",
+        message: "Tu asistencia está confirmada. Generaremos tu carnet automáticamente. Consulta el resultado y comparte tu carnet.",
+        command: "andes badge"
+      };
+    }
+    return {
+      kind: "confirm",
+      message: "Tu postulación fue aceptada. Falta confirmar tu asistencia y completar tus datos de ingreso. Al terminar generaremos tu carnet automáticamente.",
+      command: "andes confirm"
+    };
+  }
+  if (requirements.stage === "draft") {
+    return {
+      kind: "register",
+      message: "Tu postulación todavía es un borrador. Completa los datos y envíala.",
+      command: "andes register"
+    };
+  }
+  const evaluated = registration.challenges.find((challenge2) => challenge2.playable && challenge2.status === "evaluated");
+  if (evaluated) {
+    let message = "Tu evaluación oficial está registrada. Todavía falta la decisión sobre tu postulación. Te avisaremos por correo; también puedes consultar tu estado aquí.";
+    if (registration.status === "waitlisted") {
+      message = "Tu evaluación oficial está registrada y estás en lista de espera. Te avisaremos por correo si se libera un cupo.";
+    }
+    return { kind: "decision", message, command: "andes status" };
+  }
+  const available = registration.challenges.filter((challenge2) => challenge2.playable && challenge2.open && !challenge2.closed && challenge2.evaluationsUsed < challenge2.evaluationsLimit);
+  const challenge = available.find((item) => item.status === "in_progress") ?? available[0];
+  if (challenge) {
+    if (challenge.status === "in_progress") {
+      return {
+        kind: "challenge_continue",
+        challengeSlug: challenge.slug,
+        message: `Tu postulación está enviada, pero falta completar ${challenge.theme} con una evaluación oficial. Revisa tu progreso y prepara el envío. Los tests públicos no completan este paso.`,
+        command: `andes challenge show --challenge ${challenge.slug}`
+      };
+    }
+    return {
+      kind: "challenge_start",
+      challengeSlug: challenge.slug,
+      message: `Tu postulación está enviada, pero falta el challenge obligatorio. Empieza ${challenge.theme}, resuélvelo y envía una evaluación oficial para competir por un cupo.`,
+      command: `andes challenge init --challenge ${challenge.slug}`
+    };
+  }
+  return {
+    kind: "challenge_unavailable",
+    message: "Todavía necesitas una evaluación oficial para competir por un cupo, pero no hay un challenge abierto con evaluaciones disponibles. Consulta las fechas y los challenges disponibles.",
+    command: "andes challenge list"
+  };
+};
+var nextStepText = (step) => ["SIGUIENTE PASO", step.message, `Siguiente comando: ${step.command}`].join(`
+`);
+var withRegistrationNextStep = (operation) => operation.pipe(exports_Effect.map((response) => ({
+  ...response,
+  data: { ...response.data, nextStep: nextStepFor(response.data) }
+})));
+var loadParticipantGuidance = (client) => getRegistration(client).pipe(exports_Effect.map((response) => ({
+  ...response,
+  data: {
+    registration: response.data,
+    nextStep: nextStepFor(response.data)
+  }
+})), exports_Effect.catch((error2) => {
+  if (error2.code !== "REGISTRATION_NOT_FOUND" && error2.code !== "AUTHENTICATION_REQUIRED") {
+    return exports_Effect.fail(error2);
+  }
+  let nextStep = nextStepFor();
+  if (error2.code === "AUTHENTICATION_REQUIRED") {
+    nextStep = {
+      kind: "login",
+      message: "Inicia sesión para consultar tu avance y continuar tu postulación.",
+      command: "andes login"
+    };
+  }
+  return exports_Effect.succeed({
+    version: 1,
+    ok: true,
+    requestId: error2.requestId,
+    data: { nextStep }
+  });
+}));
+
 // src/output.ts
 var printJson = (value3) => exports_Effect.sync(() => {
   process.stdout.write(`${JSON.stringify(value3)}
@@ -60929,74 +61037,69 @@ Request ID: ${error2.requestId}`);
 var registrationLookupErrorText = (error2) => {
   if (error2.code !== "REGISTRATION_NOT_FOUND")
     return;
-  return `No registration found.
-Next command: andes register`;
+  return `Todavía no tienes una postulación.
+${nextStepText(nextStepFor())}`;
 };
 var requirementsText = (result3) => {
   const { registration, requirements } = result3;
-  if (registration.status === "withdrawn") {
-    return "Application withdrawn. You may submit a new application.";
-  }
-  if (requirements.stage === "complete")
-    return "Attendance details: complete";
-  if (requirements.stage === "draft") {
-    return `Application draft in progress.${registrationPartsText(result3)}`;
-  }
-  if (requirements.stage === "review") {
-    return [
-      "Application received. A seat has not been assigned.",
-      result3.admission?.notice ?? challengeAdmissionNotice,
-      "Next command: andes challenge"
-    ].join(`
-`);
-  }
-  let feedback = "";
+  const lines2 = [];
+  if (requirements.stage === "draft")
+    lines2.push(registrationPartsText(result3));
   const rejectionReason = requirements.rejectionReason ?? registration.rejectionReason;
-  if (rejectionReason) {
-    feedback = `
-Review feedback: ${rejectionReason}`;
-  }
-  let nextCommand = "";
-  if (requirements.stage === "accepted") {
-    nextCommand = `
-Next command: andes confirm`;
-  }
-  let missing2 = "";
+  if (rejectionReason)
+    lines2.push(`Comentario del equipo: ${rejectionReason}`);
   if (requirements.missing.length > 0) {
     const items = requirements.missing.map((item) => `  - ${item.field}: ${item.reason}`).join(`
 `);
-    missing2 = `
-Still required:
-${items}`;
+    lines2.push(`Datos pendientes:
+${items}`);
   }
-  return `Next stage: ${requirements.stage}${feedback}${missing2}${nextCommand}`;
+  lines2.push(nextStepText(nextStepFor(result3)));
+  return lines2.join(`
+
+`);
+};
+var statusLabels = {
+  draft: "Borrador",
+  submitted: "Postulación enviada",
+  under_review: "En revisión",
+  waitlisted: "En lista de espera",
+  accepted: "Aceptada",
+  rejected: "No aceptada",
+  withdrawn: "Retirada"
 };
 var registrationText = (result3) => [
-  `Registration: ${result3.registration.id}`,
-  `Participant: ${result3.registration.firstName} ${result3.registration.lastName}`,
-  `Status: ${result3.registration.status}`,
+  `Postulación: ${result3.registration.id}`,
+  `Participante: ${result3.registration.firstName} ${result3.registration.lastName}`,
+  `Estado: ${statusLabels[result3.registration.status]}`,
   requirementsText(result3)
 ].join(`
 `);
 var createdText = (result3) => {
-  if (result3.registration.status !== "submitted") {
-    return ["Application draft saved.", registrationText(result3)].join(`
+  if (result3.registration.status === "draft") {
+    return ["Borrador guardado.", registrationText(result3)].join(`
 `);
   }
-  return ["Application submitted successfully.", registrationText(result3)].join(`
+  return ["Postulación enviada.", registrationText(result3)].join(`
 `);
 };
 var requirementsOnlyText = (result3) => requirementsText(result3);
 var badgeText = (result3) => {
-  if (result3.url)
-    return result3.url;
+  if (result3.status === "completed" && result3.url)
+    return `Tu carnet está listo:
+${result3.url}
+
+Compártelo en LinkedIn o Instagram.
+Para personalizarlo: andes badge regenerate`;
   if (result3.status === "pending" || result3.status === "running") {
-    return "Tu carnet se está generando.";
+    return `Tu carnet se está generando. Espera unos minutos y consulta de nuevo.
+Siguiente comando: andes badge`;
   }
   if (result3.status === "failed") {
     return "No se pudo generar tu carnet. Ejecuta `andes badge regenerate` para intentarlo de nuevo.";
   }
-  return "Todavía no tienes un carnet.";
+  return `Todavía no tienes un carnet. Consulta qué paso te falta completar.
+Siguiente comando: andes status`;
 };
 
 // src/challenge-commands.ts
@@ -61369,9 +61472,18 @@ var evaluateCommand = exports_Command.make("evaluate", { challenge: challengeFla
   const token = exports_Option.getOrUndefined(options.token);
   const operation = exports_Effect.gen(function* () {
     const solution = yield* challengeEvaluationInput(exports_Option.getOrUndefined(source), exports_Option.getOrUndefined(review), challenge);
-    return yield* evaluateChallenge({ apiUrl: options.apiUrl, token }, challenge, solution);
+    const client = { apiUrl: options.apiUrl, token };
+    const evaluated = yield* evaluateChallenge(client, challenge, solution);
+    const nextStep = yield* loadParticipantGuidance(client).pipe(exports_Effect.map((response) => response.data.nextStep), exports_Effect.catch(() => exports_Effect.succeed({
+      kind: "decision",
+      message: "Tu evaluación oficial se guardó. Consulta el estado de tu postulación para continuar.",
+      command: "andes status"
+    })));
+    return { ...evaluated, data: { ...evaluated.data, nextStep } };
   });
-  yield* execute(options.output, operation, challengeEvaluateText, evaluationErrorText);
+  yield* execute(options.output, operation, (result3) => `${challengeEvaluateText(result3)}
+
+${nextStepText(result3.nextStep)}`, evaluationErrorText);
 })).pipe(exports_Command.withDescription("Score a solution on hidden cases. Broken Agent requires participant browser approval before a limited evaluation is consumed."), exports_Command.withExamples([
   {
     command: "andes challenge evaluate --challenge broken-agent --source ./scheduler.js --review ./review.json",
@@ -61389,50 +61501,25 @@ var rankingCommand = exports_Command.make("ranking", { challenge: challengeFlag
 ]));
 var challengeCommand = exports_Command.make("challenge", {}, exports_Effect.fn("challengeQuickstartCommand")(function* () {
   const options = yield* root;
-  const participationState = participationStateFor(defaultChallengeSlug);
-  const participationOpen = participationState === "open";
-  const launchNotice = launchNoticeFor(defaultChallengeSlug);
-  if (options.output === "json") {
-    let workflow = challengeQuickstart.workflow;
-    let helpCommand = challengeQuickstart.helpCommand;
-    let story = challengeQuickstart.story;
-    let mission = challengeQuickstart.mission;
-    let rules = challengeQuickstart.rules;
-    if (participationState === "closed") {
-      const rankingStep = challengeQuickstart.workflow.at(-1);
-      workflow = rankingStep ? [rankingStep] : [];
-      helpCommand = "andes challenge ranking --help";
-      story = [];
-      mission = "El Challenge 2 terminó. El ranking final sigue disponible.";
-      rules = [];
-    } else if (participationState === "scheduled") {
-      workflow = [];
-      helpCommand = "andes challenge list --help";
-      story = [];
-      mission = "El challenge todavía no está disponible.";
-      rules = [];
-    }
-    const data = {
-      ...challengeQuickstart,
-      story,
-      mission,
-      rules,
-      workflow,
-      helpCommand,
-      open: participationOpen,
-      state: participationState
-    };
-    if (launchNotice)
-      data.notice = launchNotice;
-    yield* printJson({
-      version: 1,
-      ok: true,
-      requestId: crypto.randomUUID(),
-      data
-    });
-    return;
-  }
-  yield* exports_Console.log(challengeQuickstartText(participationState, launchNotice));
+  const client = {
+    apiUrl: options.apiUrl,
+    token: exports_Option.getOrUndefined(options.token)
+  };
+  const operation = loadParticipantGuidance(client).pipe(exports_Effect.map((response) => {
+    const { nextStep } = response.data;
+    let guide;
+    if ((nextStep.kind === "challenge_start" || nextStep.kind === "challenge_continue") && nextStep.challengeSlug === "broken-agent") {
+      guide = challengeQuickstart;
+    }
+    return { ...response, data: { ...response.data, guide } };
+  }));
+  yield* execute(options.output, operation, (result3) => {
+    if (!result3.guide)
+      return nextStepText(result3.nextStep);
+    return `${challengeQuickstartText("open")}
+
+${nextStepText(result3.nextStep)}`;
+  });
 })).pipe(exports_Command.withDescription("Compite en challenges técnicos obligatorios por un cupo. Ejecuta el comando sin subcomandos para abrir la guía del challenge actual."), exports_Command.withExamples([
   {
     command: "andes challenge",
@@ -63785,6 +63872,149 @@ var runUpdatedCli = () => new Promise((resolve4, reject) => {
   child.on("close", (exitCode) => resolve4(exitCode ?? 1));
 });
 
+// src/welcome.ts
+var valley = [
+  "          11              55        ",
+  "    11   1111            5555 11     ",
+  "   1111 111111      11    55 1111    ",
+  " 11112222111111   111111    111111   ",
+  "111222222211111111111111111122221111",
+  "112223333222111111111111112223332222",
+  "222333333322211114411111222333333333",
+  "333333333332222144442222233333333333",
+  "333333333333322244422223333333333333"
+];
+var palette = {
+  sky: "12;24;24",
+  distant: "28;62;61",
+  ridge: "44;101;85",
+  terrace: "84;143;111",
+  river: "141;200;190",
+  sun: "234;183;108",
+  border: "66;101;85",
+  text: "243;241;217",
+  muted: "183;201;181",
+  accent: "214;255;0"
+};
+var pixels = {
+  " ": { color: palette.sky, character: " " },
+  "1": { color: palette.distant, character: "." },
+  "2": { color: palette.ridge, character: ":" },
+  "3": { color: palette.terrace, character: "#" },
+  "4": { color: palette.river, character: "~" },
+  "5": { color: palette.sun, character: "o" }
+};
+var wrap = (text2, width) => {
+  const lines2 = [];
+  let line = "";
+  for (const word of text2.split(" ")) {
+    if (line && line.length + word.length + 1 > width) {
+      lines2.push(line);
+      line = "";
+    }
+    line = line ? `${line} ${word}` : word;
+    while (line.length > width) {
+      lines2.push(line.slice(0, width));
+      line = line.slice(width);
+    }
+  }
+  if (line)
+    lines2.push(line);
+  return lines2;
+};
+var center = (text2, width) => (" ".repeat(Math.max(0, Math.floor((width - text2.length) / 2))) + text2).padEnd(width);
+var renderWelcome = ({
+  columns = 80,
+  colors: colors2 = false
+} = {}) => {
+  const width = Math.max(1, Math.min(Math.floor(columns), 72));
+  if (width < 24) {
+    return [
+      eventName,
+      "by Chofex",
+      "S/8,000 in prizes",
+      "Only for the best engineers from Peru."
+    ].flatMap((line) => wrap(line, width)).join(`
+`);
+  }
+  const innerWidth = width - 4;
+  const paint = (text2, foreground = palette.text, background = palette.sky, bold2 = false) => {
+    if (!colors2)
+      return text2;
+    const weight = bold2 ? "1;" : "";
+    return `\x1B[${weight}38;2;${foreground};48;2;${background}m${text2}\x1B[0m`;
+  };
+  let horizontal = "-";
+  let vertical = "|";
+  let corners = ["+", "+", "+", "+"];
+  if (colors2) {
+    horizontal = "─";
+    vertical = "│";
+    corners = ["╭", "╮", "╰", "╯"];
+  }
+  const frame = (content) => ` ${paint(vertical, palette.border)}${content}${paint(vertical, palette.border)}`;
+  const rule = (left, right) => ` ${paint(left + horizontal.repeat(innerWidth) + right, palette.border)}`;
+  const label = (text2, foreground, bold2 = false) => frame(paint(center(text2, innerWidth), foreground, palette.sky, bold2));
+  const sourceWidth = Math.max(...valley.map((row) => row.length));
+  const scene = valley.map((row, y) => {
+    const cells = Array.from({ length: innerWidth }, (_, x) => {
+      const sourceX = Math.floor(x / innerWidth * sourceWidth);
+      return row[sourceX] ?? " ";
+    });
+    let heading = "";
+    let foreground = palette.text;
+    if (y === 3)
+      heading = eventName;
+    if (y === 4) {
+      heading = "by Chofex";
+      foreground = palette.sun;
+    }
+    const headingStart = Math.floor((innerWidth - heading.length) / 2);
+    let rendered = "";
+    for (let x = 0;x < cells.length; x += 1) {
+      if (heading && x >= headingStart - 1 && x <= headingStart + heading.length) {
+        const character = heading[x - headingStart] ?? " ";
+        rendered += paint(character, foreground, palette.sky, y === 3);
+        continue;
+      }
+      const pixel = pixels[cells[x] ?? " "] ?? pixels[" "];
+      if (!pixel)
+        continue;
+      if (colors2) {
+        rendered += paint(" ", pixel.color, pixel.color);
+      } else {
+        rendered += pixel.character;
+      }
+    }
+    return frame(rendered);
+  });
+  return [
+    "",
+    rule(corners[0] ?? "+", corners[1] ?? "+"),
+    ...scene,
+    label("", palette.text),
+    label("S/8,000 in prizes", palette.accent, true),
+    ...wrap("Only for the best engineers from Peru.", innerWidth - 2).map((line) => label(line, palette.muted)),
+    rule(corners[2] ?? "+", corners[3] ?? "+"),
+    ""
+  ].join(`
+`);
+};
+var welcomeFormatter = (options) => {
+  const formatter = exports_CliOutput.defaultFormatter({ colors: options.colors });
+  return {
+    ...formatter,
+    formatHelpDoc: (doc) => {
+      const help = formatter.formatHelpDoc(doc);
+      if (!doc.subcommands?.length)
+        return help;
+      const welcome = renderWelcome(options);
+      return `${welcome}
+${help}`;
+    }
+  };
+};
+
 // src/commands.ts
 var inputFlag2 = exports_Flag.string("input").pipe(exports_Flag.optional, exports_Flag.withDescription("Read JSON from a file, or use - for stdin"));
 var stageFlag = exports_Flag.choice("stage", ["application", "acceptance"]).pipe(exports_Flag.withDefault("application"));
@@ -63794,42 +64024,32 @@ var currentRegistration = (client) => getRegistration(client).pipe(exports_Effec
   }
   return exports_Effect.fail(error2);
 }));
-var rejectIfApplicationLocked = exports_Effect.fn("rejectIfApplicationLocked")(function* (current) {
-  if (exports_Option.isNone(current))
-    return;
-  const { registration, requirements } = current.value.data;
-  const { status } = registration;
-  const registrationAlreadyExists = status === "submitted" || status === "under_review" || status === "waitlisted" || status === "accepted";
-  if (!registrationAlreadyExists)
-    return;
-  let message = "Already registered. Wait for approval.";
-  if (status === "accepted") {
-    message = "Already accepted. Your registration is complete.";
-    if (requirements.stage === "accepted") {
-      message = "Already accepted. Run `andes confirm` to complete your registration.";
-    }
-  }
-  return yield* cliError("ACTIVE_APPLICATION_EXISTS", message, false, {
-    currentStatus: status
-  });
-});
 var registerCommand = exports_Command.make("register", { input: inputFlag2 }, exports_Effect.fn("registerCommand")(function* ({ input }) {
   const options = yield* root;
+  let existing = false;
   const operation = exports_Effect.gen(function* () {
     const token = exports_Option.getOrUndefined(options.token);
     const client = { apiUrl: options.apiUrl, token };
     const current = yield* currentRegistration(client);
-    yield* rejectIfApplicationLocked(current);
+    if (exports_Option.isSome(current) && !current.value.data.requirements.canSubmitNewApplication && !current.value.data.requirements.canSaveDraft) {
+      existing = true;
+      return current.value;
+    }
     if (exports_Option.isSome(input)) {
       const body = yield* applicationInput(input.value, config.publicSiteUrl);
       return yield* register(client, body);
     }
-    if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    if (options.output === "json" || !process.stdin.isTTY || !process.stdout.isTTY) {
       return yield* cliError("INPUT_REQUIRED", "Non-interactive use requires --input <file>, or --input - for stdin");
     }
     return yield* interactiveRegister(client, current);
   });
-  yield* execute(options.output, operation, createdText);
+  yield* execute(options.output, withRegistrationNextStep(operation), (result3) => {
+    if (existing)
+      return `Tu postulación ya estaba enviada.
+${registrationText(result3)}`;
+    return createdText(result3);
+  }, registrationLookupErrorText);
 })).pipe(exports_Command.withDescription("Complete and submit an application for review"), exports_Command.withExamples([
   {
     command: "andes register",
@@ -63860,7 +64080,7 @@ var statusCommand = exports_Command.make("status", {}, exports_Effect.fn("status
     const token = exports_Option.getOrUndefined(options.token);
     return yield* getRegistration({ apiUrl: options.apiUrl, token });
   });
-  yield* execute(options.output, operation, registrationText, registrationLookupErrorText);
+  yield* execute(options.output, withRegistrationNextStep(operation), registrationText, registrationLookupErrorText);
 })).pipe(exports_Command.withDescription("Show your latest application and next steps"));
 var requirementsCommand = exports_Command.make("requirements", {}, exports_Effect.fn("requirementsCommand")(function* () {
   const options = yield* root;
@@ -63868,7 +64088,7 @@ var requirementsCommand = exports_Command.make("requirements", {}, exports_Effec
     const token = exports_Option.getOrUndefined(options.token);
     return yield* getRegistration({ apiUrl: options.apiUrl, token });
   });
-  yield* execute(options.output, operation, requirementsOnlyText, registrationLookupErrorText);
+  yield* execute(options.output, withRegistrationNextStep(operation), requirementsOnlyText, registrationLookupErrorText);
 })).pipe(exports_Command.withDescription("Show information you still need to provide"));
 var badgeRegenerateCommand = exports_Command.make("regenerate", {
   input: inputFlag2,
@@ -63882,14 +64102,15 @@ var badgeRegenerateCommand = exports_Command.make("regenerate", {
     }
     const token = exports_Option.getOrUndefined(options.token);
     const client = { apiUrl: options.apiUrl, token };
+    const current = yield* getRegistration(client);
+    if (current.data.requirements.stage !== "complete") {
+      return yield* cliError("INVALID_APPLICATION_STATE", nextStepText(nextStepFor(current.data)));
+    }
     const badge = yield* getBadge(client);
     if (!badge.data.profile) {
       return yield* exports_Effect.fail(cliError("INVALID_APPLICATION_STATE", "Confirma tu asistencia antes de regenerar tu carnet"));
     }
-    const [current, currentUser] = yield* exports_Effect.all([
-      getRegistration(client),
-      getCurrentUser(client)
-    ]);
+    const currentUser = yield* getCurrentUser(client);
     const body = yield* badgeProfileInput(inputPath, badge.data.profile, {
       clerkPictureUrl: currentUser.data.clerkPictureUrl,
       githubUrl: current.data.registration.githubUrl
@@ -63911,8 +64132,26 @@ var badgeRegenerateCommand = exports_Command.make("regenerate", {
 var badgeCommand = exports_Command.make("badge", {}, exports_Effect.fn("badgeCommand")(function* () {
   const options = yield* root;
   const token = exports_Option.getOrUndefined(options.token);
-  const operation = getBadge({ apiUrl: options.apiUrl, token });
-  yield* execute(options.output, operation, badgeText);
+  const client = { apiUrl: options.apiUrl, token };
+  const operation = exports_Effect.gen(function* () {
+    const current = yield* getRegistration(client);
+    if (current.data.registration.status !== "accepted") {
+      return yield* cliError("INVALID_APPLICATION_STATE", nextStepText(nextStepFor(current.data)));
+    }
+    const badge = yield* getBadge(client);
+    return {
+      ...badge,
+      data: { ...badge.data, nextStep: nextStepFor(current.data) }
+    };
+  });
+  yield* execute(options.output, operation, (result3) => {
+    if (result3.nextStep.kind === "confirm")
+      return `Tu carnet predeterminado no confirma tu asistencia.
+${result3.url ?? "El carnet todavía se está preparando."}
+
+${nextStepText(result3.nextStep)}`;
+    return badgeText(result3);
+  }, registrationLookupErrorText);
 })).pipe(exports_Command.withDescription("Muestra o regenera tu carnet de participante"), exports_Command.withSubcommands([badgeRegenerateCommand]));
 var confirmCommand = exports_Command.make("confirm", {
   input: inputFlag2,
@@ -63923,8 +64162,13 @@ var confirmCommand = exports_Command.make("confirm", {
     const token = exports_Option.getOrUndefined(options.token);
     const client = { apiUrl: options.apiUrl, token };
     const current = yield* getRegistration(client);
+    if (current.data.requirements.stage === "complete" && exports_Option.isNone(input) && exports_Option.isNone(picture))
+      return current;
     if (!current.data.requirements.canSubmitAcceptedDetails) {
-      return yield* exports_Effect.fail(cliError("INVALID_APPLICATION_STATE", "Acceptance details can only be submitted after acceptance"));
+      return yield* exports_Effect.fail(cliError("INVALID_APPLICATION_STATE", nextStepText(nextStepFor(current.data))));
+    }
+    if (options.output === "json" && exports_Option.isNone(input)) {
+      return yield* cliError("INPUT_REQUIRED", "El modo JSON requiere --input <archivo> o --input -");
     }
     const currentUser = yield* getCurrentUser(client);
     const currentBadge = yield* getBadge(client);
@@ -63938,6 +64182,9 @@ var confirmCommand = exports_Command.make("confirm", {
     });
     const picturePath = exports_Option.getOrUndefined(picture);
     if (body.pictureSource === "upload") {
+      if (options.output === "json" && picturePath === undefined) {
+        return yield* cliError("PICTURE_PATH_REQUIRED", "Usa --picture <ruta> cuando pictureSource es upload");
+      }
       const path4 = yield* picturePathInput(picturePath);
       yield* uploadPicture(client, path4);
     } else if (picturePath) {
@@ -63945,7 +64192,7 @@ var confirmCommand = exports_Command.make("confirm", {
     }
     return yield* confirmAttendance(client, body);
   });
-  yield* execute(options.output, operation, registrationText);
+  yield* execute(options.output, withRegistrationNextStep(operation), registrationText, registrationLookupErrorText);
 })).pipe(exports_Command.withDescription("Provide private attendance details after acceptance"), exports_Command.withExamples([
   {
     command: "andes confirm",
@@ -63968,21 +64215,33 @@ var loginCommand = exports_Command.make("login", {}, exports_Effect.fn("loginCom
       token
     });
     const environmentTokenActive = Boolean(process.env.CHOFEX_TOKEN);
+    const nextStep = yield* loadParticipantGuidance({
+      apiUrl: options.apiUrl,
+      token
+    }).pipe(exports_Effect.map((response) => response.data.nextStep), exports_Effect.catch(() => exports_Effect.succeed({
+      kind: "status",
+      message: "Consulta tu avance para continuar con tu siguiente paso.",
+      command: "andes"
+    })));
     return {
       version: 1,
       ok: true,
       requestId: currentUser.requestId,
       data: {
         authenticated: true,
-        environmentTokenActive
+        environmentTokenActive,
+        nextStep
       }
     };
   });
   yield* execute(options.output, operation, (result3) => {
     if (result3.environmentTokenActive) {
-      return "Signed in successfully. CHOFEX_TOKEN is set and will override the stored session; unset it before running other commands.";
+      return `Sesión iniciada. CHOFEX_TOKEN está configurado y tiene prioridad sobre la sesión guardada; elimínalo del entorno para usar esta sesión.
+Siguiente comando: andes`;
     }
-    return "Signed in successfully.";
+    return `Sesión iniciada.
+${result3.nextStep.message}
+Siguiente comando: ${result3.nextStep.command}`;
   });
 })).pipe(exports_Command.withDescription("Sign in through Clerk OAuth in your browser"));
 var logoutCommand = exports_Command.make("logout", {}, exports_Effect.fn("logoutCommand")(function* () {
@@ -64007,14 +64266,16 @@ var logoutCommand = exports_Command.make("logout", {}, exports_Effect.fn("logout
     if (result3.environmentTokenActive) {
       return "Stored credentials removed. CHOFEX_TOKEN remains active; unset it to stop using that token.";
     }
-    return "Signed out successfully.";
+    return `Sesión cerrada. Para volver a continuar tu postulación:
+Siguiente comando: andes login`;
   });
 })).pipe(exports_Command.withDescription("Revoke and remove locally stored credentials"));
 var whoamiCommand = exports_Command.make("whoami", {}, exports_Effect.fn("whoamiCommand")(function* () {
   const options = yield* root;
   const token = exports_Option.getOrUndefined(options.token);
   const operation = getCurrentUser({ apiUrl: options.apiUrl, token });
-  yield* execute(options.output, operation, (result3) => `Authenticated as ${result3.email} (${result3.userId}, ${result3.tokenType}).`);
+  yield* execute(options.output, operation, (result3) => `Sesión iniciada como ${result3.email} (${result3.userId}, ${result3.tokenType}).
+Consulta tu siguiente paso: andes`);
 })).pipe(exports_Command.withDescription("Verify the current Clerk authentication"));
 var makeUpgradeCommand = (name) => exports_Command.make(name, {}, exports_Effect.fn("upgradeCommand")(function* () {
   const options = yield* root;
@@ -64034,7 +64295,8 @@ var makeUpgradeCommand = (name) => exports_Command.make(name, {}, exports_Effect
     },
     catch: (error2) => cliError("UPGRADE_FAILED", `No se pudieron actualizar ${cliPackageName} y ${skillName}`, false, String(error2))
   });
-  yield* execute(options.output, operation, () => `Se actualizó ${cliPackageName} a la versión ${upgradeVersion} y se refrescó ${skillName}.`);
+  yield* execute(options.output, operation, () => `Se actualizó ${cliPackageName} a la versión ${upgradeVersion} y se refrescó ${skillName}.
+Siguiente comando: andes`);
 })).pipe(exports_Command.withDescription(`Actualiza ${cliPackageName} y su skill de agente a la última versión`));
 var updateCommand = makeUpgradeCommand("update");
 var upgradeCommand = makeUpgradeCommand("upgrade");
@@ -64046,13 +64308,24 @@ var inputValidation = (stage, path4) => {
 };
 var validateCommand = exports_Command.make("validate", { input: inputFlag2, stage: stageFlag }, exports_Effect.fn("validateCommand")(function* ({ input, stage }) {
   const options = yield* root;
+  if (options.output === "json" && exports_Option.isNone(input)) {
+    yield* execute(options.output, exports_Effect.fail(cliError("INPUT_REQUIRED", "El modo JSON requiere --input <archivo> o --input -")), () => "");
+    return;
+  }
   const operation = inputValidation(stage, exports_Option.getOrUndefined(input)).pipe(exports_Effect.map(() => ({
     version: 1,
     ok: true,
     requestId: crypto.randomUUID(),
     data: { valid: true, stage }
   })));
-  yield* execute(options.output, operation, (result3) => `${result3.stage} input is valid.`);
+  yield* execute(options.output, operation, (result3) => {
+    const command = result3.stage === "application" ? "andes register" : "andes confirm";
+    let nextCommand = command;
+    if (exports_Option.isSome(input))
+      nextCommand += ` --input ${JSON.stringify(input.value)}`;
+    return `Datos válidos. Todavía no se enviaron.
+Siguiente comando: ${nextCommand}`;
+  });
 })).pipe(exports_Command.withDescription("Validate input without submitting it"), exports_Command.withExamples([
   {
     command: "andes --output json validate --stage application --input application.json",
@@ -64098,7 +64371,23 @@ var schemaCommand = exports_Command.make("schema", { stage: stageFlag }, exports
     description: "Print the post-acceptance input template"
   }
 ]));
-var command = root.pipe(exports_Command.withSubcommands([
+var command = root.pipe(exports_Command.withHandler((options) => exports_Effect.gen(function* () {
+  const client = {
+    apiUrl: options.apiUrl,
+    token: exports_Option.getOrUndefined(options.token)
+  };
+  yield* execute(options.output, loadParticipantGuidance(client), (result3) => {
+    const welcome = renderWelcome({
+      columns: process.stdout.columns ?? 80,
+      colors: process.stdout.isTTY === true && process.env.NO_COLOR === undefined
+    });
+    const guidance = result3.registration ? registrationText(result3.registration) : nextStepText(result3.nextStep);
+    return `${welcome}
+${guidance}
+
+Todos los comandos: andes --help`;
+  });
+})), exports_Command.withSubcommands([
   loginCommand,
   logoutCommand,
   whoamiCommand,
@@ -64114,161 +64403,6 @@ var command = root.pipe(exports_Command.withSubcommands([
   challengeCommand
 ]));
 
-// src/welcome.ts
-var valley = [
-  "          11              55        ",
-  "    11   1111            5555 11     ",
-  "   1111 111111      11    55 1111    ",
-  " 11112222111111   111111    111111   ",
-  "111222222211111111111111111122221111",
-  "112223333222111111111111112223332222",
-  "222333333322211114411111222333333333",
-  "333333333332222144442222233333333333",
-  "333333333333322244422223333333333333"
-];
-var palette = {
-  sky: "12;24;24",
-  distant: "28;62;61",
-  ridge: "44;101;85",
-  terrace: "84;143;111",
-  river: "141;200;190",
-  sun: "234;183;108",
-  border: "66;101;85",
-  text: "243;241;217",
-  muted: "183;201;181",
-  accent: "214;255;0"
-};
-var pixels = {
-  " ": { color: palette.sky, character: " " },
-  "1": { color: palette.distant, character: "." },
-  "2": { color: palette.ridge, character: ":" },
-  "3": { color: palette.terrace, character: "#" },
-  "4": { color: palette.river, character: "~" },
-  "5": { color: palette.sun, character: "o" }
-};
-var wrap = (text2, width) => {
-  const lines2 = [];
-  let line = "";
-  for (const word of text2.split(" ")) {
-    if (line && line.length + word.length + 1 > width) {
-      lines2.push(line);
-      line = "";
-    }
-    line = line ? `${line} ${word}` : word;
-    while (line.length > width) {
-      lines2.push(line.slice(0, width));
-      line = line.slice(width);
-    }
-  }
-  if (line)
-    lines2.push(line);
-  return lines2;
-};
-var center = (text2, width) => (" ".repeat(Math.max(0, Math.floor((width - text2.length) / 2))) + text2).padEnd(width);
-var renderWelcome = ({
-  columns = 80,
-  colors: colors2 = false
-} = {}) => {
-  const width = Math.max(1, Math.min(Math.floor(columns), 72));
-  if (width < 24) {
-    return [
-      eventName,
-      "by Chofex",
-      "S/8,000 in prizes",
-      "Only for the best engineers from Peru."
-    ].flatMap((line) => wrap(line, width)).join(`
-`);
-  }
-  const innerWidth = width - 4;
-  const paint = (text2, foreground = palette.text, background = palette.sky, bold2 = false) => {
-    if (!colors2)
-      return text2;
-    const weight = bold2 ? "1;" : "";
-    return `\x1B[${weight}38;2;${foreground};48;2;${background}m${text2}\x1B[0m`;
-  };
-  let horizontal = "-";
-  let vertical = "|";
-  let corners = ["+", "+", "+", "+"];
-  if (colors2) {
-    horizontal = "─";
-    vertical = "│";
-    corners = ["╭", "╮", "╰", "╯"];
-  }
-  const frame = (content) => ` ${paint(vertical, palette.border)}${content}${paint(vertical, palette.border)}`;
-  const rule = (left, right) => ` ${paint(left + horizontal.repeat(innerWidth) + right, palette.border)}`;
-  const label = (text2, foreground, bold2 = false) => frame(paint(center(text2, innerWidth), foreground, palette.sky, bold2));
-  const sourceWidth = Math.max(...valley.map((row) => row.length));
-  const scene = valley.map((row, y) => {
-    const cells = Array.from({ length: innerWidth }, (_, x) => {
-      const sourceX = Math.floor(x / innerWidth * sourceWidth);
-      return row[sourceX] ?? " ";
-    });
-    let heading = "";
-    let foreground = palette.text;
-    if (y === 3)
-      heading = eventName;
-    if (y === 4) {
-      heading = "by Chofex";
-      foreground = palette.sun;
-    }
-    const headingStart = Math.floor((innerWidth - heading.length) / 2);
-    let rendered = "";
-    for (let x = 0;x < cells.length; x += 1) {
-      if (heading && x >= headingStart - 1 && x <= headingStart + heading.length) {
-        const character = heading[x - headingStart] ?? " ";
-        rendered += paint(character, foreground, palette.sky, y === 3);
-        continue;
-      }
-      const pixel = pixels[cells[x] ?? " "] ?? pixels[" "];
-      if (!pixel)
-        continue;
-      if (colors2) {
-        rendered += paint(" ", pixel.color, pixel.color);
-      } else {
-        rendered += pixel.character;
-      }
-    }
-    return frame(rendered);
-  });
-  return [
-    "",
-    rule(corners[0] ?? "+", corners[1] ?? "+"),
-    ...scene,
-    label("", palette.text),
-    label("S/8,000 in prizes", palette.accent, true),
-    ...wrap("Only for the best engineers from Peru.", innerWidth - 2).map((line) => label(line, palette.muted)),
-    rule(corners[2] ?? "+", corners[3] ?? "+"),
-    ""
-  ].join(`
-`);
-};
-var welcomeFormatter = (options) => {
-  const formatter = exports_CliOutput.defaultFormatter({ colors: options.colors });
-  return {
-    ...formatter,
-    formatHelpDoc: (doc) => {
-      const help = formatter.formatHelpDoc(doc);
-      if (!doc.subcommands?.length)
-        return help;
-      const welcome = renderWelcome(options);
-      if (!options.home)
-        return `${welcome}
-${help}`;
-      const width = Math.max(1, Math.min(options.columns ?? 80, 72));
-      const shortcuts = [
-        "andes login     Sign in",
-        "andes register  Apply",
-        "andes status    Check your application",
-        "andes --help    All commands"
-      ];
-      return `${welcome}
-${shortcuts.flatMap((line) => wrap(line, width)).join(`
-`)}
-`;
-    }
-  };
-};
-
 // src/index.ts
 var arguments_ = process.argv.slice(2);
 var jsonOutputRequested = (arguments_2) => {
@@ -64289,7 +64423,6 @@ var quietConsole = Object.assign(Object.create(console), {
   }
 });
 var commandProgram = command.pipe(exports_Command.run({ version: cliVersion, renderErrors: !jsonMode }), exports_Effect.provide(exports_CliOutput.layer(welcomeFormatter({
-  home: arguments_.length === 0,
   columns: process.stdout.columns ?? 80,
   colors: process.stdout.isTTY === true && process.env.NO_COLOR === undefined && process.env.TERM !== "dumb"
 }))), exports_Effect.catch((error2) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hacktheandes-cli",
-  "version": "0.1.203",
+  "version": "0.1.206",
   "description": "Command-line client for Hack the Andes",
   "type": "module",
   "bin": {