chofex-cli 0.1.113 → 0.1.115

package/README.md

@@ -11,6 +11,7 @@ npm install --global chofex-cli@latest
 The installed command is `chofex`:
 
 ```sh
+chofex
 chofex whoami
 chofex register
 chofex status
@@ -32,6 +33,13 @@ never decide admission or block an application submission.
 
 The public ranking is read-only at `https://andes.crafter.run/challenges`.
 
+Run `chofex` for a compact retro welcome screen with a pixel Sacred Valley and
+the main commands. Run `chofex --help` for the full command reference. The
+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
+command results omit the welcome screen.
+
 For agent or script input, `chofex schema --stage application` and
 `chofex schema --stage acceptance` print complete templates containing every
 accepted JSON key. Validate a completed input file locally before submitting it:

package/dist/index.js

@@ -51213,35 +51213,17 @@ var withTime = /* @__PURE__ */ dual((args2) => isEffect(args2[0]), (self, label)
 }), () => self, () => sync(() => {
   console2.timeEnd(label);
 }))));
-// ../../node_modules/effect/dist/unstable/cli/Command.js
-var exports_Command = {};
-__export(exports_Command, {
-  wizard: () => wizard,
-  withSubcommands: () => withSubcommands,
-  withShortDescription: () => withShortDescription,
-  withSharedFlags: () => withSharedFlags,
-  withHandler: () => withHandler,
-  withGlobalFlags: () => withGlobalFlags,
-  withExamples: () => withExamples,
-  withDescription: () => withDescription3,
-  withAlias: () => withAlias3,
-  unlisted: () => unlisted,
-  runWith: () => runWith2,
-  run: () => run5,
-  provideSync: () => provideSync,
-  provideEffectDiscard: () => provideEffectDiscard,
-  provideEffect: () => provideEffect,
-  provide: () => provide6,
-  make: () => make37,
-  isCommand: () => isCommand,
-  annotateMerge: () => annotateMerge,
-  annotate: () => annotate4
-});
-
 // ../../node_modules/effect/dist/unstable/cli/CliOutput.js
+var exports_CliOutput = {};
+__export(exports_CliOutput, {
+  layer: () => layer13,
+  defaultFormatter: () => defaultFormatter2,
+  Formatter: () => Formatter2
+});
 var Formatter2 = /* @__PURE__ */ Reference("effect/cli/CliOutput", {
   defaultValue: () => defaultFormatter2()
 });
+var layer13 = (formatter) => succeed5(Formatter2)(formatter);
 var escapeControlCharacters = (text) => text.replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/g, (character) => `\\x${character.charCodeAt(0).toString(16).padStart(2, "0")}`);
 var defaultFormatter2 = (options) => {
   const globalProcess = globalThis.process;
@@ -51436,6 +51418,30 @@ var formatHelpDocImpl = (doc, colors2) => {
   return sections.join(`
 `);
 };
+// ../../node_modules/effect/dist/unstable/cli/Command.js
+var exports_Command = {};
+__export(exports_Command, {
+  wizard: () => wizard,
+  withSubcommands: () => withSubcommands,
+  withShortDescription: () => withShortDescription,
+  withSharedFlags: () => withSharedFlags,
+  withHandler: () => withHandler,
+  withGlobalFlags: () => withGlobalFlags,
+  withExamples: () => withExamples,
+  withDescription: () => withDescription3,
+  withAlias: () => withAlias3,
+  unlisted: () => unlisted,
+  runWith: () => runWith2,
+  run: () => run5,
+  provideSync: () => provideSync,
+  provideEffectDiscard: () => provideEffectDiscard,
+  provideEffect: () => provideEffect,
+  provide: () => provide6,
+  make: () => make37,
+  isCommand: () => isCommand,
+  annotateMerge: () => annotateMerge,
+  annotate: () => annotate4
+});
 
 // ../../node_modules/effect/dist/unstable/cli/internal/completions/bash.js
 var escapeForBash = (s) => s.replace(/'/g, "'\\''");
@@ -58383,7 +58389,7 @@ var mapHandler = (self, f) => {
     handle: (input, path4) => f(impl.handle(input, path4), input)
   });
 };
-var provide6 = /* @__PURE__ */ dual((args2) => isCommand(args2[0]), (self, layer13, options) => mapHandler(self, (handler, input) => provide4(handler, typeof layer13 === "function" ? layer13(input) : layer13, options)));
+var provide6 = /* @__PURE__ */ dual((args2) => isCommand(args2[0]), (self, layer14, options) => mapHandler(self, (handler, input) => provide4(handler, typeof layer14 === "function" ? layer14(input) : layer14, options)));
 var provideSync = /* @__PURE__ */ dual(3, (self, service3, implementation) => mapHandler(self, (handler, input) => provideService2(handler, service3, typeof implementation === "function" ? implementation(input) : implementation)));
 var provideEffect = /* @__PURE__ */ dual(3, (self, service3, effect2) => mapHandler(self, (handler, input) => provideServiceEffect2(handler, service3, typeof effect2 === "function" ? effect2(input) : effect2)));
 var provideEffectDiscard = /* @__PURE__ */ dual(2, (self, effect2) => mapHandler(self, (handler, input) => andThen4(typeof effect2 === "function" ? effect2(input) : effect2, handler)));
@@ -58557,7 +58563,7 @@ var challengeCatalog = [
     coreSkill: "Reverse engineering & experimentation",
     format: "accuracy",
     formatLabel: "Accuracy score",
-    opensAt: "2026-09-18T05:00:00.000Z",
+    opensAt: "2026-09-17T05:00:00.000Z",
     queryLimit: 25,
     evaluationLimit: 3,
     hiddenSampleSize: 1000,
@@ -58634,6 +58640,35 @@ var challengeCatalog = [
   }
 ];
 var playableChallenges = challengeCatalog.filter((challenge) => challenge.playable);
+var challengeBySlug = (slug) => challengeCatalog.find((challenge) => challenge.slug === slug);
+var challengeTimeZoneOffsetMs = 5 * 60 * 60 * 1000;
+var monthNames = [
+  "January",
+  "February",
+  "March",
+  "April",
+  "May",
+  "June",
+  "July",
+  "August",
+  "September",
+  "October",
+  "November",
+  "December"
+];
+var formatChallengeOpeningInPeru = (opensAt) => {
+  const localTime = new Date(Date.parse(opensAt) - challengeTimeZoneOffsetMs);
+  const month = monthNames[localTime.getUTCMonth()];
+  if (!month || Number.isNaN(localTime.getTime())) {
+    throw new Error("Challenge opening time is invalid");
+  }
+  const day = localTime.getUTCDate();
+  const year = localTime.getUTCFullYear();
+  const hour = String(localTime.getUTCHours()).padStart(2, "0");
+  const minute = String(localTime.getUTCMinutes()).padStart(2, "0");
+  return `${month} ${day}, ${year} at ${hour}:${minute} (UTC-5)`;
+};
+var challengeOpeningNotice = (title, opensAt) => `${title} opens ${formatChallengeOpeningInPeru(opensAt)}. Queries and evaluations are disabled until then; no attempts will be consumed.`;
 var ChallengeSlugSchema = exports_Schema.Literals([
   "black-box",
   "last-mile",
@@ -59649,12 +59684,18 @@ var remainingBar = (used, limit) => {
   return `${"█".repeat(filled)}${"░".repeat(width - filled)}`;
 };
 var percent = (value3) => `${(value3 * 100).toFixed(2)}%`;
+var challengeLaunchNotice = (title, opensAt, now3 = new Date) => {
+  if (now3.getTime() >= Date.parse(opensAt))
+    return;
+  return challengeOpeningNotice(title, opensAt);
+};
 var challengeListText = (catalog) => {
   const lines2 = ["Hack the Andes challenges", ""];
   for (const challenge of catalog.challenges) {
     let state = "open";
-    if (!challenge.open)
-      state = `opens ${challenge.opensAt.slice(0, 10)}`;
+    if (!challenge.open) {
+      state = `opens ${formatChallengeOpeningInPeru(challenge.opensAt)}`;
+    }
     const playable = challenge.playable ? "" : " (coming later)";
     lines2.push(`${challenge.code}  ${challenge.theme} — ${challenge.title}${playable}`);
     lines2.push(`    ${challenge.coreSkill} · ${challenge.formatLabel} · ${state}`);
@@ -60134,21 +60175,17 @@ var challengeQuickstart = {
   ],
   helpCommand: "chofex challenge query --help"
 };
-var challengeQuickstartText = () => {
-  const lines2 = [
-    challengeQuickstart.title,
-    "",
-    ...challengeQuickstart.story,
-    "",
-    "YOUR MISSION",
-    challengeQuickstart.mission,
-    "",
-    "RULES OF THE GAME",
-    ...challengeQuickstart.rules.map((rule) => `• ${rule}`),
-    "",
-    "FIELD GUIDE",
-    ""
-  ];
+var launchNoticeFor = (slug) => {
+  const challenge = challengeBySlug(slug);
+  if (!challenge)
+    return;
+  return challengeLaunchNotice(challenge.theme, challenge.opensAt);
+};
+var challengeQuickstartText = (launchNotice) => {
+  const lines2 = [challengeQuickstart.title];
+  if (launchNotice)
+    lines2.push("", "LAUNCH NOTICE", launchNotice);
+  lines2.push("", ...challengeQuickstart.story, "", "YOUR MISSION", challengeQuickstart.mission, "", "RULES OF THE GAME", ...challengeQuickstart.rules.map((rule) => `• ${rule}`), "", "FIELD GUIDE", "");
   for (const item of challengeQuickstart.workflow) {
     lines2.push(`${item.step}. ${item.action}`);
     lines2.push(`   ${item.command}`);
@@ -60334,16 +60371,22 @@ var rankingCommand = exports_Command.make("ranking", { challenge: challengeFlag
 ]));
 var challengeCommand = exports_Command.make("challenge", {}, exports_Effect.fn("challengeQuickstartCommand")(function* () {
   const options = yield* root;
+  const launchNotice = launchNoticeFor(defaultChallengeSlug);
   if (options.output === "json") {
+    const data = {
+      ...challengeQuickstart
+    };
+    if (launchNotice)
+      data.notice = launchNotice;
     yield* printJson({
       version: 1,
       ok: true,
       requestId: crypto.randomUUID(),
-      data: challengeQuickstart
+      data
     });
     return;
   }
-  yield* exports_Console.log(challengeQuickstartText());
+  yield* exports_Console.log(challengeQuickstartText(launchNotice));
 })).pipe(exports_Command.withDescription("Play mini technical challenges. Start here: learn the Black Box workflow from first query to leaderboard. Run without a subcommand for the guided quickstart."), exports_Command.withExamples([
   {
     command: "chofex challenge",
@@ -62649,6 +62692,161 @@ 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 [
+      "The Andes Hackathon",
+      "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 = "The Andes Hackathon";
+    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 = [
+        "chofex login     Sign in",
+        "chofex register  Apply",
+        "chofex status    Check your application",
+        "chofex --help    All commands"
+      ];
+      return `${welcome}
+${shortcuts.flatMap((line) => wrap(line, width)).join(`
+`)}
+`;
+    }
+  };
+};
+
 // src/index.ts
 var packageMetadata = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
 var cliVersion = packageMetadata.version;
@@ -62670,7 +62868,11 @@ var quietConsole = Object.assign(Object.create(console), {
     return;
   }
 });
-var commandProgram = command.pipe(exports_Command.run({ version: cliVersion, renderErrors: !jsonMode }), exports_Effect.catch((error2) => {
+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) => {
   if (!jsonMode)
     return exports_Effect.fail(error2);
   if (error2._tag === "ShowHelp" && error2.errors.length === 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chofex-cli",
-  "version": "0.1.113",
+  "version": "0.1.115",
   "description": "Command-line client for the Chofex Hackathon",
   "type": "module",
   "bin": {