@next-generation-collective/factory 0.3.0 → 0.3.2

package/lib/banner.js

@@ -0,0 +1,86 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { basename, join } from "node:path";
+import { colors } from "./util.js";
+
+// The Next-Gen mark in the terminal: an N whose diagonal runs into a G, in the brand gold.
+const MARK = [
+  "█▄  █ ▄▀▀▀▀",
+  "█ ▀▄█ █  ▄▄",
+  "█   █ ▀▄▄▄▀",
+];
+
+const truecolor = /truecolor|24bit/i.test(process.env.COLORTERM ?? "");
+const gold = (t) => colors.paint(truecolor ? "38;2;245;166;35" : "38;5;214", t);
+const cream = (t) => colors.paint(truecolor ? "38;2;253;251;247" : "97", t);
+
+const width = (text) => [...text.replace(/\u001b\[[0-9;]*m/g, "")].length;
+
+// The builder's first name, from their git identity or, on a Mac, their account's full
+// name. Nothing is sent anywhere.
+export function firstName() {
+  const ask = (cmd, args) => {
+    try {
+      return execFileSync(cmd, args, { encoding: "utf8", timeout: 1000, stdio: ["ignore", "pipe", "ignore"] }).trim();
+    } catch {
+      return "";
+    }
+  };
+  const full = ask("git", ["config", "user.name"]) || (process.platform === "darwin" ? ask("id", ["-F"]) : "");
+  return full.split(/\s+/)[0] || null;
+}
+
+// One small file in the builder's own settings folder, so the first welcome happens once.
+function welcomeFile() {
+  const base = process.env.XDG_CONFIG_HOME || join(homedir(), ".config");
+  return join(base, "next-gen", "welcomed");
+}
+
+export function isFirstVisit() {
+  try {
+    return !existsSync(welcomeFile());
+  } catch {
+    return false;
+  }
+}
+
+export function rememberVisit() {
+  try {
+    const file = welcomeFile();
+    mkdirSync(join(file, ".."), { recursive: true });
+    writeFileSync(file, `${new Date().toISOString().slice(0, 10)}\n`);
+  } catch {
+    // A read-only home folder only means the long welcome shows again.
+  }
+}
+
+export function welcomeLines({ name, first, version }) {
+  const you = name ? `, ${name}` : "";
+  return first
+    ? [
+        colors.bold(cream(`Welcome to Next-Gen Factory${you}.`)),
+        cream("You are one of the builders of the AI economy."),
+        `${gold("Africa builds.")} ${colors.dim(`v${version}`)}`,
+      ]
+    : [
+        colors.bold(cream(`Welcome back${you}.`)),
+        cream("Every build you prove makes every builder stronger."),
+        `${gold("Africa builds.")} ${colors.dim(`v${version}`)}`,
+      ];
+}
+
+export function banner(version, root, { name = firstName(), first = isFirstVisit() } = {}) {
+  const lines = welcomeLines({ name, first, version });
+  const rows = lines.map((line, i) => `  ${gold(MARK[i] ?? " ".repeat(width(MARK[0])))}   ${line}`);
+  const inner = Math.max(...rows.map(width)) + 2;
+  const edge = (l, r) => colors.dim(`${l}${"─".repeat(inner)}${r}`);
+  if (first) rememberVisit();
+  return [
+    edge("╭", "╮"),
+    ...rows.map((row) => `${colors.dim("│")}${row}${" ".repeat(inner - width(row))}${colors.dim("│")}`),
+    edge("╰", "╯"),
+    colors.dim(`  Reading ${basename(root) || root}...`),
+    "",
+  ].join("\n");
+}

package/lib/cli.js

@@ -1,3 +1,6 @@
+import { homedir } from "node:os";
+import { banner } from "./banner.js";
+import { parse as parse_, resolve } from "node:path";
 import { createRequire } from "node:module";
 import {
   approveCommand,
@@ -95,6 +98,20 @@ Nothing is written into your project until you start a job. Nothing is called
 done until the checks pass, and it never says "bug-free" or "compliant".`);
 }
 
+// Your home folder or the top of the disk is never one project. Reading it means reading
+// every file on the computer, which takes minutes and shows nothing.
+export function notAProjectFolder(root, home = homedir()) {
+  const here = resolve(root);
+  if (here !== resolve(home) && here !== parse_(here).root) return null;
+  return [
+    `This is ${here === resolve(home) ? "your home folder" : "the top of your disk"}, not a project.`,
+    "Go into a project folder first, then run it again. For example:",
+    "",
+    "  cd my-project",
+    "  npx @next-generation-collective/factory",
+  ].join("\n");
+}
+
 export async function main(argv) {
   const { flags, positional } = parse(argv);
   const root = process.cwd();
@@ -110,6 +127,15 @@ export async function main(argv) {
     return 0;
   }
 
+  if (!command || (!COMMANDS.has(command) && (rest.length > 0 || /\s/.test(command)))) {
+    const refusal = notAProjectFolder(root);
+    if (refusal) {
+      console.error(refusal);
+      return 1;
+    }
+    if (process.stdout.isTTY) console.log(banner(VERSION, root));
+  }
+
   if (!command) return start(root, flags);
 
   if (!COMMANDS.has(command)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@next-generation-collective/factory",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Checks the work you build with AI, proves it works, and learns from every builder. Built in the open, in Africa.",
   "type": "module",
   "bin": {