chofex-cli 0.1.190 → 0.1.192

package/README.md

@@ -51,9 +51,12 @@ Acceptance creates a default badge from the Clerk profile visible to reviewers.
 while separately collecting the legal full name and venue details required for attendance. After confirmation,
 `chofex badge regenerate` can also update those public fields and the QR
 destination without changing the submitted application.
-The technical challenges do not block submission, but every challenge winner must submit
-an application before being accepted. Top results receive a direct pass; other
-scores give organizers another review metric.
+The technical challenges do not block application submission, but they are
+mandatory for admission. An application does not reserve a seat; organizers
+select the strongest engineers from challenge rankings. Broken Agent requires a
+participant-only browser handoff with passkey user verification before each
+official evaluation. Every challenge slug resolves to the current server
+version; legacy attempts do not count toward admission.
 
 The public ranking is read-only at `https://hacktheandes.com/challenges`.
 

package/dist/index.js

@@ -58554,6 +58554,7 @@ var runWith2 = (command, config) => {
 // ../../packages/challenges-contract/src/index.ts
 var blackBoxChallengeSlug = "black-box";
 var brokenAgentChallengeSlug = "broken-agent";
+var challengeAdmissionNotice = "Los challenges técnicos son obligatorios para competir por un cupo. Enviar la postulación solo crea tu candidatura: no reserva una plaza. Siempre compites en la versión vigente; los intentos legacy no cuentan. Los mejores resultados de los rankings serán seleccionados para el evento.";
 var challengeCatalog = [
   {
     slug: blackBoxChallengeSlug,
@@ -58836,6 +58837,7 @@ var ChallengeCatalogItemSchema = exports_Schema.Struct({
   playable: exports_Schema.Boolean,
   open: exports_Schema.Boolean,
   closed: exports_Schema.optional(exports_Schema.Boolean),
+  challengeVersion: exports_Schema.optional(exports_Schema.String),
   rankingPath: exports_Schema.String
 });
 var ChallengeEvaluationSummarySchema = exports_Schema.Struct({
@@ -58853,6 +58855,11 @@ var ChallengeEvaluationSummarySchema = exports_Schema.Struct({
   breakdown: exports_Schema.optional(ChallengeScoreSchema.fields.breakdown)
 });
 var ChallengeAttemptViewSchema = exports_Schema.Struct({
+  admission: exports_Schema.optional(exports_Schema.Struct({
+    challengesMandatory: exports_Schema.Literal(true),
+    selectionBasis: exports_Schema.Literal("challenge_rankings"),
+    notice: exports_Schema.String
+  })),
   challenge: ChallengeCatalogItemSchema,
   progress: ParticipantChallengeProgressSchema,
   observations: exports_Schema.Array(ChallengeObservationSchema),
@@ -58918,6 +58925,11 @@ var ChallengeRankingSchema = exports_Schema.Struct({
   competitorCount: exports_Schema.Number
 });
 var ChallengeCatalogSchema = exports_Schema.Struct({
+  admission: exports_Schema.optional(exports_Schema.Struct({
+    challengesMandatory: exports_Schema.Literal(true),
+    selectionBasis: exports_Schema.Literal("challenge_rankings"),
+    notice: exports_Schema.String
+  })),
   challenges: exports_Schema.Array(ChallengeCatalogItemSchema)
 });
 
@@ -59267,7 +59279,12 @@ var PictureUploadCompletionSchema = exports_Schema.Struct({
 });
 var RegistrationResultSchema = exports_Schema.Struct({
   registration: RegistrationViewSchema,
-  requirements: RegistrationRequirementsSchema
+  requirements: RegistrationRequirementsSchema,
+  admission: exports_Schema.optional(exports_Schema.Struct({
+    challengesMandatory: exports_Schema.Literal(true),
+    selectionBasis: exports_Schema.Literal("challenge_rankings"),
+    notice: exports_Schema.String
+  }))
 });
 var CreatedRegistrationSchema = RegistrationResultSchema;
 var ApiSuccessSchema = (data) => exports_Schema.Struct({
@@ -59942,7 +59959,12 @@ var challengeParticipationNotice = (title, opensAt, closesAt, now3 = new Date) =
   return challengeLaunchNotice(title, opensAt, now3);
 };
 var challengeListText = (catalog) => {
-  const lines2 = [`${eventName} challenges`, ""];
+  const lines2 = [
+    `${eventName} challenges`,
+    "",
+    catalog.admission?.notice ?? challengeAdmissionNotice,
+    ""
+  ];
   for (const challenge of catalog.challenges) {
     let state = `abre ${formatChallengeOpeningInPeru(challenge.opensAt)}`;
     if (challenge.closed) {
@@ -59955,6 +59977,9 @@ var challengeListText = (catalog) => {
     const playable = challenge.playable ? "" : " (próximamente)";
     lines2.push(`${challenge.code}  ${challenge.theme} — ${challenge.title}${playable}`);
     lines2.push(`    ${challenge.coreSkill} · ${challenge.formatLabel} · ${state}`);
+    if (challenge.challengeVersion) {
+      lines2.push(`    Versión vigente: ${challenge.challengeVersion}`);
+    }
     lines2.push(`    Ranking: ${challenge.rankingPath}`);
     lines2.push("");
   }
@@ -59979,6 +60004,10 @@ var challengeShowText = (attempt) => {
       `${challenge.title.toUpperCase()} — CASO #${challenge.code}`,
       challenge.summary,
       "",
+      attempt.admission?.notice ?? challengeAdmissionNotice,
+      "",
+      `VERSIÓN VIGENTE: ${challenge.challengeVersion ?? "administrada por el servidor"}`,
+      "",
       `ESTADO DEL CASO: ${caseStatus2}`,
       "",
       "Los tests públicos están verdes. Tu trabajo es hacer que el scheduler sea confiable bajo condiciones de producción.",
@@ -60011,6 +60040,10 @@ var challengeShowText = (attempt) => {
     `${challenge.title.toUpperCase()} — CASE #${challenge.code}`,
     challenge.summary,
     "",
+    attempt.admission?.notice ?? challengeAdmissionNotice,
+    "",
+    `CURRENT VERSION: ${challenge.challengeVersion ?? "server-managed"}`,
+    "",
     `CASE STATUS: ${caseStatus}`,
     "",
     "Your job is to replace the machine, not merely guess its next answer.",
@@ -60205,31 +60238,17 @@ var challengeTestText = (result3) => {
 `);
 };
 var challengeEvaluateText = (result3) => {
-  if (result3.breakdown) {
-    const executionCost = result3.executionCost ?? result3.runtimeMs;
-    const capabilityLines = [
-      ["Comportamiento base", result3.breakdown.coreBehavior],
-      ["Persistencia", result3.breakdown.persistence],
-      ["Concurrencia", result3.breakdown.concurrency],
-      ["Recuperación", result3.breakdown.failureRecovery],
-      ["Idempotencia", result3.breakdown.idempotency],
-      ["Sin regresiones", result3.breakdown.regressionSafety],
-      ["Rendimiento", result3.breakdown.performance]
-    ];
+  if (result3.rankingPath === "/challenges/broken-agent") {
     const lines3 = [
       "VEREDICTO OFICIAL — BROKEN AGENT — PREPARACIÓN PARA PRODUCCIÓN",
-      `Puntaje             ${(result3.accuracy * 100).toFixed(2)} / ${result3.sampleSize}`,
-      `Costo determinístico ${executionCost} ops`,
-      "",
-      "Puntajes por capacidad",
-      ...capabilityLines.map(([label, score]) => `${label.padEnd(20)}${score.earned.toFixed(2)} / ${score.available}`)
+      `Puntaje             ${(result3.accuracy * 100).toFixed(2)} / ${result3.sampleSize}`
     ];
     if (result3.rank !== undefined) {
       lines3.push(`Puesto               #${result3.rank}`);
     }
     lines3.push(`Evaluaciones oficiales restantes ${result3.evaluationsRemaining} / ${result3.evaluationsLimit}`, "", result3.shareText, "", "Siguiente: consulta el ranking", "  chofex challenge ranking --challenge broken-agent");
     if (result3.evaluationsRemaining > 0) {
-      lines3.push("", "El evaluador reporta capacidades, no casos ocultos individuales. Razona antes de volver a enviar.", "  chofex challenge test --challenge broken-agent --source ./scheduler.js");
+      lines3.push("", "El veredicto es un solo puntaje. No dice qué caso falló. Razona antes de volver a enviar.", "  chofex challenge test --challenge broken-agent --source ./scheduler.js");
     }
     return lines3.join(`
 `);
@@ -60265,16 +60284,14 @@ var challengeRankingText = (ranking, now3 = new Date) => {
 `);
   }
   if (ranking.challenge.slug === "broken-agent") {
-    lines2.push("Psto  Puntaje     Puntos         Costo  Nombre");
+    lines2.push("Psto  Puntaje     Puntos   Nombre");
     for (const entry of ranking.entries.slice(0, 20)) {
       const rank = String(entry.rank).padStart(4, " ");
       const accuracy = percent(entry.accuracy).padStart(8, " ");
       const points = `${entry.exactCount}/${entry.sampleSize}`.padStart(11, " ");
-      const executionCost = entry.executionCost ?? entry.runtimeMs;
-      const runtime = `${executionCost}ops`.padStart(8, " ");
       const profileLinks = [entry.githubUrl, entry.linkedInUrl].filter(Boolean);
       const participant = [entry.displayName, ...profileLinks].join(" ");
-      lines2.push(`${rank}  ${accuracy}  ${points}  ${runtime}  ${participant}`);
+      lines2.push(`${rank}  ${accuracy}  ${points}  ${participant}`);
     }
     return lines2.join(`
 `);
@@ -60500,6 +60517,10 @@ contra escenarios ocultos. Las herramientas de AI están permitidas, pero este e
 un challenge de colaboración: el agente implementa y el participante toma las
 decisiones de ingeniería.
 
+Los challenges técnicos son obligatorios para competir por un cupo. Enviar la
+postulación solo crea tu candidatura: no reserva una plaza. Los mejores
+resultados de los rankings serán seleccionados para el evento.
+
 ## Protocolo humano–agente
 
 No le pidas al agente que resuelva todo en silencio. Antes de modificar el
@@ -60541,6 +60562,13 @@ explicar, debatir y guardar tus respuestas, pero no puede elegir el foco, invent
 tu razonamiento ni tomar la decisión de release por ti. Si cambias
 \`scheduler.js\`, vuelve a revisar la evidencia antes de reemplazar el review.
 
+La primera ejecución de \`challenge evaluate\` crea un enlace corto de
+aprobación y **no consume** una evaluación. Abre ese enlace personalmente,
+revisa el review vinculado al SHA-256 exacto y confirma con Face ID, Touch ID,
+Windows Hello, PIN del dispositivo o una llave de seguridad. Después repite el
+mismo comando para ejecutar la evaluación oficial. Cada evaluación requiere una
+aprobación nueva; la sesión OAuth del CLI no puede aprobarla.
+
 ## Contrato normativo
 
 \`createScheduler({ store, clock, execute, workerId })\` devuelve:
@@ -60575,13 +60603,13 @@ tu razonamiento ni tomar la decisión de release por ti. Si cambias
 - El store sobrevive nuevas instancias del scheduler y reinicios del proceso.
 - Varios workers, incluso instancias que reutilizan un \`workerId\` después de
   reiniciar, pueden llamar \`runDue()\` contra el mismo store.
-- \`runDue()\` intenta una vez cada job vencido al inicio de esa llamada. Un job
-  que falla queda pendiente para una llamada posterior y no bloquea otros jobs.
-- Cada ejecución debe reclamarse atómicamente antes de llamar al executor. El
-  claim dura 30 segundos y necesita una identidad única distinta de
-  \`workerId\`. Cuando \`clock.now()\` alcanza el deadline, otro worker puede
-  reclamarlo. Un worker obsoleto nunca puede completar ni reabrir un claim más
-  nuevo.
+- \`runDue()\` reclama un job antes de llamar al executor. Un job que falla
+  queda pendiente para una llamada posterior y no bloquea otros jobs.
+- Cada ejecución debe reclamarse atómicamente. El claim dura 30 segundos.
+  Cuando \`clock.now()\` alcanza ese deadline, otro worker puede reclamar el
+  job. Un worker que ya no es dueño del claim, incluido un proceso que vuelve
+  con el mismo \`workerId\`, no puede completarlo, marcarlo como fallido ni
+  reabrirlo.
 - Un intento se cuenta al reclamar el job. Después de 3 ejecuciones fallidas el
   job queda failed.
 - \`execute(job)\` puede fallar antes o después de aplicar el efecto. El adapter
@@ -60598,24 +60626,13 @@ ofrece operaciones síncronas \`get(id)\`, \`put(job)\`, \`delete(id)\` y
 
 ## Evaluación
 
-El evaluador usa variantes determinísticas por participante para probar el
-contrato bajo concurrencia, reinicios, fallas, idempotencia, compatibilidad y
-carga. Reporta puntajes por capacidad, no casos ocultos individuales.
-
-- Comportamiento base: 10 puntos
-- Persistencia: 15 puntos
-- Concurrencia: 20 puntos
-- Recuperación ante fallas: 20 puntos
-- Idempotencia: 15 puntos
-- Seguridad contra regresiones: 15 puntos
-- Rendimiento: 5 puntos, solo si la carga termina correctamente y sin perder
-  seguridad de concurrencia
+El evaluador usa variantes determinísticas por participante. El veredicto
+oficial es un solo puntaje sobre 100. No incluye casos ocultos, un desglose por
+capacidad ni un costo de ejecución.
 
 El ranking exige una postulación enviada o revisada. Ordena por puntaje total,
-menos evaluaciones oficiales, costo determinístico de ejecución y hora del mejor
-envío. El costo es \`transacciones + ceil(jobs recorridos por tx.list / 10)\` en
-una carga equivalente para todos; no usa tiempo de servidor. Todos los puntajes
-válidos aparecen en el ranking.
+luego por menos evaluaciones oficiales y, al final, por la hora del mejor
+envío. Todos los puntajes válidos aparecen en el ranking.
 `;
 var brokenAgentPublicTestSource = `const test = require("node:test");
 const assert = require("node:assert/strict");
@@ -60821,7 +60838,7 @@ var root = exports_Command.make("chofex").pipe(exports_Command.withSharedFlags({
   apiUrl: exports_Flag.string(rootValueFlagNames.apiUrl).pipe(exports_Flag.withDefault(config.apiUrl), exports_Flag.withDescription("Chofex API base URL")),
   output: exports_Flag.choice(rootValueFlagNames.output, ["human", "json"]).pipe(exports_Flag.withDefault("human"), exports_Flag.withDescription("Output format")),
   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(`Register for and manage your ${eventName} application`));
+}), exports_Command.withDescription(`Apply to ${eventName} and compete for a seat through the mandatory technical challenges`));
 
 // src/output.ts
 var printJson = (value3) => exports_Effect.sync(() => {
@@ -60900,8 +60917,14 @@ var requirementsText = (result3) => {
   if (requirements.stage === "draft") {
     return `Application draft in progress.${registrationPartsText(result3)}`;
   }
-  if (requirements.stage === "review")
-    return "No action needed while your application is reviewed.";
+  if (requirements.stage === "review") {
+    return [
+      "Application received. A seat has not been assigned.",
+      result3.admission?.notice ?? challengeAdmissionNotice,
+      "Next command: chofex challenge"
+    ].join(`
+`);
+  }
   let feedback = "";
   const rejectionReason = requirements.rejectionReason ?? registration.rejectionReason;
   if (rejectionReason) {
@@ -60960,9 +60983,11 @@ var challengeQuickstart = {
   ],
   mission: "Audita scheduler.js, conserva createScheduler(dependencies) y haz que el sistema cumpla el contrato de producción.",
   rules: [
+    "Los challenges son obligatorios: enviar la postulación no reserva un cupo.",
+    "Los mejores resultados de los rankings serán seleccionados para el evento.",
     "Tienes 5 evaluaciones oficiales contra variantes ocultas y determinísticas por participante.",
     "Los tests locales y públicos son ilimitados.",
-    "Gana el puntaje total; los empates usan menos evaluaciones, costo determinístico y hora del mejor envío.",
+    "Gana el puntaje total; los empates usan menos evaluaciones y la hora del mejor envío.",
     "Las herramientas de AI están permitidas, pero el participante toma las decisiones de ingeniería."
   ],
   workflow: [
@@ -61016,12 +61041,24 @@ var challengeQuickstart = {
     },
     {
       step: 9,
-      action: "Solicita un veredicto oculto",
+      action: "Crea el handoff de evaluación",
       command: "chofex challenge evaluate --challenge broken-agent --source ./scheduler.js --review ./review.json",
-      note: "Úsalo solo cuando enviarías la implementación a producción."
+      note: "Devuelve un enlace de aprobación sin consumir una evaluación oficial."
     },
     {
       step: 10,
+      action: "El participante aprueba en el navegador",
+      command: "Abre approvalUrl personalmente",
+      note: "Revisa el razonamiento y confirma con Face ID, Touch ID, Windows Hello, PIN o llave de seguridad. El agente no puede completar este paso."
+    },
+    {
+      step: 11,
+      action: "Solicita el veredicto oculto",
+      command: "chofex challenge evaluate --challenge broken-agent --source ./scheduler.js --review ./review.json",
+      note: "Repite el mismo comando antes de que venza la aprobación; recién entonces consume una evaluación."
+    },
+    {
+      step: 12,
       action: "Consulta el ranking",
       command: "chofex challenge ranking --challenge broken-agent",
       note: "Se revela el 1 de octubre a las 15:00, hora de Perú."
@@ -61074,6 +61111,34 @@ var optionalString = (name, description) => exports_Flag.string(name).pipe(expor
 var challengeFlag = exports_Flag.string("challenge").pipe(exports_Flag.withDefault(defaultChallengeSlug), exports_Flag.withDescription("Challenge slug (default: broken-agent)"));
 var sourceFlag = optionalString("source", "JavaScript challenge solution file");
 var reviewFlag = optionalString("review", "Participant-authored Broken Agent engineering review JSON");
+var evaluationErrorText = (error2) => {
+  if (error2.code !== "HUMAN_APPROVAL_REQUIRED")
+    return;
+  if (!error2.details || typeof error2.details !== "object")
+    return;
+  const details = error2.details;
+  if (typeof details.approvalUrl !== "string")
+    return;
+  let retryCommand = "chofex challenge evaluate --challenge broken-agent --source ./scheduler.js --review ./review.json";
+  if (typeof details.retryCommand === "string") {
+    retryCommand = details.retryCommand;
+  }
+  const lines2 = [
+    "INTERVENCIÓN DEL PARTICIPANTE REQUERIDA",
+    "La evaluación todavía no consumió un intento.",
+    "",
+    "El participante debe abrir personalmente este enlace, revisar sus respuestas y aprobar con Face ID, Touch ID, Windows Hello, PIN o llave de seguridad:",
+    `  ${details.approvalUrl}`,
+    "",
+    "Después de aprobar, repite:",
+    `  ${retryCommand}`
+  ];
+  if (typeof details.expiresAt === "string") {
+    lines2.push("", `La aprobación vence: ${details.expiresAt}`);
+  }
+  return lines2.join(`
+`);
+};
 var inputFlag = optionalString("input", "JSON file, or - for stdin");
 var formatFlag = exports_Flag.choice("format", ["table", "json", "csv"]).pipe(exports_Flag.withDefault("table"), exports_Flag.withDescription("Notebook format"));
 var numberFromOption = (value3) => {
@@ -61270,8 +61335,8 @@ var evaluateCommand = exports_Command.make("evaluate", { challenge: challengeFla
     const solution = yield* challengeEvaluationInput(exports_Option.getOrUndefined(source), exports_Option.getOrUndefined(review), challenge);
     return yield* evaluateChallenge({ apiUrl: options.apiUrl, token }, challenge, solution);
   });
-  yield* execute(options.output, operation, challengeEvaluateText);
-})).pipe(exports_Command.withDescription("Score a solution on hidden cases. This consumes one limited official evaluation. Requires sign-in."), exports_Command.withExamples([
+  yield* execute(options.output, operation, challengeEvaluateText, 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: "chofex challenge evaluate --challenge broken-agent --source ./scheduler.js --review ./review.json",
     description: "Consume una evaluación oficial cuando tu solución esté lista"
@@ -61332,7 +61397,7 @@ var challengeCommand = exports_Command.make("challenge", {}, exports_Effect.fn("
     return;
   }
   yield* exports_Console.log(challengeQuickstartText(participationState, launchNotice));
-})).pipe(exports_Command.withDescription("Compite en challenges técnicos. Ejecuta el comando sin subcomandos para abrir la guía del challenge actual."), exports_Command.withExamples([
+})).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: "chofex challenge",
     description: "Abre la guía de Broken Agent"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chofex-cli",
-  "version": "0.1.190",
+  "version": "0.1.192",
   "description": "Command-line client for Hack the Andes",
   "type": "module",
   "bin": {