chofex-cli 0.1.114 → 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)));
@@ -62686,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;
@@ -62707,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.114",
+  "version": "0.1.115",
   "description": "Command-line client for the Chofex Hackathon",
   "type": "module",
   "bin": {