scale-stack 0.0.1-alpha.0 → 0.0.1-alpha.2

package/README.md

@@ -1,8 +1,6 @@
 # Scale Stack
 
-An opinionated scaffolding engine for Next.js 16.2+ projects. Scale Stack automates the setup of a colocation-first architecture, type-safe data layers, and an AI-native development environment.
-
-See [PRD.md](PRD.md) for the full product requirements document.
+An opinionated scaffolding engine for Next.js projects. Scale Stack automates the setup of a colocation-first architecture, type-safe data layers, and an AI-native development environment.
 
 ## Repository layout
 

package/dist/index.js

@@ -5,6 +5,469 @@ import { Command } from "commander";
 import { readFileSync } from "fs";
 import { fileURLToPath } from "url";
 import { dirname, resolve } from "path";
+
+// src/cli/commands/init.ts
+import pc4 from "picocolors";
+
+// src/cli/config.ts
+var DEFAULT_CI_PROVIDER = "github";
+var DEFAULT_ANALYTICS_PROVIDER = "posthog";
+function deriveAuthStrategy(orm) {
+  return orm === "prisma" ? "stateful" : "stateless";
+}
+function resolveConfig(flags, answers) {
+  const projectName = flags.name ?? answers.projectName ?? "my-app";
+  const orm = flags.orm ? "prisma" : answers.orm ?? "none";
+  const authEnabled = flags.auth ?? answers.auth ?? false;
+  const optMods = new Set(answers.optionalModules ?? []);
+  const resolveCi = () => {
+    if (flags.ci !== void 0) {
+      return flags.ci === true ? DEFAULT_CI_PROVIDER : flags.ci;
+    }
+    return answers.ci ?? "none";
+  };
+  const resolveAnalytics = () => {
+    if (flags.analytics !== void 0) {
+      return flags.analytics === true ? DEFAULT_ANALYTICS_PROVIDER : flags.analytics;
+    }
+    return answers.analytics ?? "none";
+  };
+  return {
+    projectName,
+    orm,
+    authStrategy: authEnabled ? deriveAuthStrategy(orm) : "none",
+    aiChat: flags.chat ?? answers.aiChat ?? false,
+    i18n: flags.i18n ?? optMods.has("i18n"),
+    ci: resolveCi(),
+    analytics: resolveAnalytics(),
+    security: flags.security ?? optMods.has("security"),
+    jobs: flags.jobs ?? answers.jobs ?? false,
+    a11y: flags.a11y ?? optMods.has("a11y"),
+    apiClient: flags.apiClient ?? optMods.has("apiClient")
+  };
+}
+
+// src/cli/prompts/techPicker.ts
+import * as p from "@clack/prompts";
+import pc2 from "picocolors";
+
+// src/cli/ui/theme.ts
+import gradient from "gradient-string";
+import pc from "picocolors";
+var ikeaGradient = gradient(["#FFDB00", "#0058A3"]);
+var ikea = {
+  heading: (s) => pc.bold(pc.yellow(s)),
+  accent: pc.yellow,
+  muted: pc.dim,
+  success: pc.green,
+  bullet: pc.yellow("\u25B8"),
+  dimBullet: pc.dim("\u25B8")
+};
+function sectionDivider(title) {
+  const line = "\u2500".repeat(Math.max(1, 40 - title.length));
+  return pc.dim(`  \u2500\u2500 ${pc.yellow(title)} ${line}`);
+}
+
+// src/cli/prompts/techPicker.ts
+function cancelled() {
+  p.cancel(pc2.yellow("Assembly cancelled \u2014 no parts were harmed."));
+  process.exit(0);
+}
+async function runTechPicker(flags) {
+  const answers = {};
+  p.intro(ikeaGradient(" S K A L S T \xC5 K K "));
+  console.log(sectionDivider("Core Stack"));
+  console.log();
+  if (!flags.name) {
+    const name = await p.text({
+      message: "Project name",
+      placeholder: "my-app",
+      validate: (v = "") => {
+        if (!v.trim()) return "Project name is required";
+        if (!/^[a-z0-9@][a-z0-9._-]*$/i.test(v.trim()))
+          return "Invalid package name";
+      }
+    });
+    if (p.isCancel(name)) cancelled();
+    answers.projectName = name;
+  }
+  if (flags.orm === void 0) {
+    const orm = await p.confirm({
+      message: "Add Prisma ORM? " + ikea.muted(
+        "\u2014 schema, migrations, seed script, singleton client \u2014 v7 + Driver Adapters"
+      ),
+      initialValue: false
+    });
+    if (p.isCancel(orm)) cancelled();
+    answers.orm = orm ? "prisma" : "none";
+  }
+  if (flags.auth === void 0) {
+    const resolvedOrm = flags.orm ? "prisma" : answers.orm ?? "none";
+    const hint = resolvedOrm === "prisma" ? "DB-backed sessions, login/signup pages, Prisma adapter" : "stateless JWT sessions, login/signup pages, no DB required";
+    const auth = await p.confirm({
+      message: "Add authentication? " + ikea.muted(`\u2014 Better Auth \xB7 ${hint}`),
+      initialValue: false
+    });
+    if (p.isCancel(auth)) cancelled();
+    answers.auth = auth;
+  }
+  if (flags.jobs === void 0) {
+    const jobs = await p.confirm({
+      message: "Enable background jobs? " + ikea.muted("\u2014 Inngest client, route handler, retry config"),
+      initialValue: false
+    });
+    if (p.isCancel(jobs)) cancelled();
+    answers.jobs = jobs;
+  }
+  if (flags.chat === void 0) {
+    const chat = await p.confirm({
+      message: "Enable AI chat? " + ikea.muted("\u2014 Vercel AI SDK, streaming /api/chat, AI Elements UI"),
+      initialValue: false
+    });
+    if (p.isCancel(chat)) cancelled();
+    answers.aiChat = chat;
+  }
+  console.log();
+  console.log(sectionDivider("Features"));
+  console.log();
+  if (flags.ci === void 0) {
+    const ci = await p.select({
+      message: "CI pipeline",
+      options: [
+        {
+          value: "github",
+          label: pc2.bold("GitHub Actions"),
+          hint: ikea.muted("lint, typecheck, test, and deploy jobs")
+        },
+        {
+          value: "none",
+          label: "None",
+          hint: ikea.muted("no CI pipeline \u2014 add your own later")
+        }
+      ]
+    });
+    if (p.isCancel(ci)) cancelled();
+    answers.ci = ci;
+  }
+  if (flags.analytics === void 0) {
+    const analytics = await p.select({
+      message: "Analytics",
+      options: [
+        {
+          value: "posthog",
+          label: pc2.bold("PostHog"),
+          hint: ikea.muted("event tracking, session replay, feature flags")
+        },
+        {
+          value: "none",
+          label: "None",
+          hint: ikea.muted("no analytics \u2014 add your own later")
+        }
+      ]
+    });
+    if (p.isCancel(analytics)) cancelled();
+    answers.analytics = analytics;
+  }
+  const alreadySelected = /* @__PURE__ */ new Set();
+  if (flags.security) alreadySelected.add("security");
+  if (flags.a11y) alreadySelected.add("a11y");
+  if (flags.apiClient) alreadySelected.add("apiClient");
+  if (flags.i18n) alreadySelected.add("i18n");
+  const availableModules = [
+    {
+      value: "security",
+      label: "Security hardening",
+      hint: ikea.muted("CSP, HSTS, X-Frame-Options, CORS config")
+    },
+    {
+      value: "a11y",
+      label: "Accessibility",
+      hint: ikea.muted("jsx-a11y lint rules, @axe-core/react, WCAG 2.1 AA")
+    },
+    {
+      value: "apiClient",
+      label: "API client",
+      hint: ikea.muted("TanStack Query hooks + typed SDK via hey-api")
+    },
+    {
+      value: "i18n",
+      label: "Internationalization",
+      hint: ikea.muted("next-intl, locale routing, <LocaleSwitcher>")
+    }
+  ].filter((m) => !alreadySelected.has(m.value));
+  if (availableModules.length > 0) {
+    console.log();
+    console.log(sectionDivider("Smart-Fittings"));
+    console.log();
+    const selected = await p.multiselect({
+      message: "Optional modules " + ikea.muted("\u2014 pick only what you need"),
+      options: availableModules,
+      required: false
+    });
+    if (p.isCancel(selected)) cancelled();
+    answers.optionalModules = selected;
+  }
+  p.outro(
+    pc2.green("\u2713") + " All parts selected. " + ikea.heading("Ready for assembly.")
+  );
+  return answers;
+}
+
+// src/cli/ui/configDisplay.ts
+import pc3 from "picocolors";
+
+// src/cli/ui/animate.ts
+function sleep(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+function cursorUp(n) {
+  process.stdout.write(`\x1B[${n}A`);
+}
+async function cascade(lines, delayMs) {
+  for (const line of lines) {
+    console.log(line);
+    await sleep(delayMs);
+  }
+}
+async function typewriter(text2, charDelayMs) {
+  for (const char of text2) {
+    process.stdout.write(char);
+    if (char !== " " && char !== "\n") {
+      await sleep(charDelayMs);
+    }
+  }
+}
+
+// src/cli/ui/configDisplay.ts
+function row(content) {
+  return `  \u2502  ${content}`;
+}
+function labelRow(key, value, maxKey) {
+  const dots = "\xB7".repeat(Math.max(1, maxKey - key.length + 2));
+  return row(`${ikea.bullet} ${key} ${pc3.dim(dots)} ${value}`);
+}
+function formatValue(val) {
+  if (val === true || val === "yes") return pc3.green("yes");
+  if (val === false || val === "no" || val === "none") return ikea.muted("no");
+  return pc3.green(val);
+}
+function buildLines(config) {
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const header = "S K A L S T \xC5 K K";
+  const artNo = `Art.${today.replace(/-/g, ".")}`;
+  const coreEntries = [
+    ["Project", config.projectName],
+    ["ORM", config.orm === "none" ? false : config.orm],
+    ["Auth", config.authStrategy === "none" ? false : config.authStrategy],
+    ["Jobs", config.jobs],
+    ["AI Chat", config.aiChat]
+  ];
+  const featureEntries = [
+    ["CI", config.ci === "none" ? false : config.ci],
+    ["Analytics", config.analytics === "none" ? false : config.analytics]
+  ];
+  const moduleEntries = [
+    ["Security", config.security],
+    ["a11y", config.a11y],
+    ["API Client", config.apiClient],
+    ["i18n", config.i18n]
+  ];
+  const allEntries = [...coreEntries, ...featureEntries, ...moduleEntries];
+  const maxKey = Math.max(...allEntries.map(([k]) => k.length));
+  const lines = [];
+  lines.push(pc3.dim("  \u250C\u2500\u2500"));
+  lines.push(row(ikeaGradient(header) + "     " + ikea.muted(artNo)));
+  lines.push(row(ikea.muted("Assembly summary")));
+  lines.push(pc3.dim("  \u2502"));
+  for (const [key, val] of coreEntries) {
+    lines.push(labelRow(key, formatValue(val), maxKey));
+  }
+  lines.push(pc3.dim("  \u2502"));
+  lines.push(row(pc3.yellow("Features:")));
+  lines.push(pc3.dim("  \u2502"));
+  for (const [key, val] of featureEntries) {
+    lines.push(labelRow(key, formatValue(val), maxKey));
+  }
+  lines.push(pc3.dim("  \u2502"));
+  lines.push(row(pc3.yellow("Smart-Fittings (modules):")));
+  lines.push(pc3.dim("  \u2502"));
+  for (const [key, val] of moduleEntries) {
+    lines.push(labelRow(key, formatValue(val), maxKey));
+  }
+  lines.push(pc3.dim("  \u2502"));
+  lines.push(row(ikea.muted(artNo)));
+  lines.push(pc3.dim("  \u2514\u2500\u2500"));
+  return lines;
+}
+async function animateConfigLabel(config) {
+  const lines = buildLines(config);
+  console.log();
+  await cascade(lines, 25);
+  console.log();
+}
+function printConfigLabel(config) {
+  const lines = buildLines(config);
+  console.log();
+  for (const line of lines) console.log(line);
+  console.log();
+}
+
+// src/cli/commands/init.ts
+function registerInitCommand(program2) {
+  program2.command("init").description("Assemble a new SKALST\xC5KK project").argument("[name]", "Project name").option("--name <name>", "Project name (overrides positional argument)").option("--orm", "Use Prisma ORM").option("--auth", "Enable authentication (Better Auth)").option("--chat", "Enable AI chat").option("--i18n", "Enable internationalization").option("--security", "Enable security hardening").option("--ci [provider]", "CI pipeline (default: github)").option("--analytics [provider]", "Analytics provider (default: posthog)").option("--jobs", "Enable background jobs (Inngest)").option("--a11y", "Enable accessibility tooling").option("--api-client", "Enable API client generation").option("-y, --yes", "Skip prompts, accept defaults").action(async (positionalName, opts) => {
+    const flags = {
+      ...opts,
+      name: opts.name ?? positionalName
+    };
+    const answers = flags.yes ? {} : await runTechPicker(flags);
+    const config = resolveConfig(flags, answers);
+    if (process.stdout.isTTY) {
+      await animateConfigLabel(config);
+    } else {
+      printConfigLabel(config);
+    }
+    console.log(
+      ikea.muted(
+        "  " + pc4.yellow("\u25B8") + " Generation is not yet implemented \u2014 config collected only."
+      )
+    );
+    console.log();
+  });
+}
+
+// src/cli/commands/sync.ts
+import pc5 from "picocolors";
+function registerSyncCommand(program2) {
+  program2.command("sync").description("Update an existing SKALST\xC5KK project to the latest fittings").action(() => {
+    console.log(
+      ikea.muted(
+        "  " + pc5.yellow("\u25B8") + " sync is not yet implemented \u2014 check back after assembly."
+      )
+    );
+  });
+}
+
+// src/cli/ui/banner.ts
+import gradient2 from "gradient-string";
+import pc6 from "picocolors";
+var LOGO = [
+  "                         \xB0         ",
+  "\u2554\u2550\u2557 \u2566\u2554\u2550 \u2554\u2550\u2557 \u2566   \u2554\u2550\u2557 \u2554\u2566\u2557 \u2554\u2550\u2557 \u2566\u2554\u2550 \u2566\u2554\u2550",
+  "\u255A\u2550\u2557 \u2560\u2569\u2557 \u2560\u2550\u2563 \u2551   \u255A\u2550\u2557  \u2551  \u2560\u2550\u2563 \u2560\u2569\u2557 \u2560\u2569\u2557",
+  "\u255A\u2550\u255D \u2569 \u2569 \u2569 \u2569 \u2569\u2550\u255D \u255A\u2550\u255D  \u2569  \u2569 \u2569 \u2569 \u2569 \u2569 \u2569"
+];
+var TAGLINE = "Project foundation w/ smart-fittings";
+var INNER = 43;
+var CONTENT_W = INNER - 6;
+var BORDER_TOP = `  \u256D${"\u2500".repeat(INNER)}\u256E`;
+var BORDER_BOT = `  \u2570${"\u2500".repeat(INNER)}\u256F`;
+var EMPTY_ROW = `  \u2502${" ".repeat(INNER)}\u2502`;
+function boxRow(content, rawLen) {
+  const pad = CONTENT_W - rawLen;
+  return `  \u2502   ${content}${" ".repeat(Math.max(0, pad))}   \u2502`;
+}
+function logoBoxLine(colored, rawLen) {
+  return pc6.dim("  \u2502") + "   " + colored + " ".repeat(Math.max(0, CONTENT_W - rawLen)) + pc6.dim("   \u2502");
+}
+var SWEEP_GRADIENTS = [
+  gradient2(["#6B6B2E", "#2E4A6B"]),
+  gradient2(["#B8A31A", "#1A6B9E"]),
+  ikeaGradient
+];
+var PARTS = "\u2550\u2554\u2557\u2566\u2560\u2569\u2551\u255A\u255D\u2563\u256C\u2500\u2502\u250C\u2510\u2514\u2518\u252C\u2534\u251C\u2524\u253C";
+function scrambleLine(line, resolvedUpTo) {
+  return Array.from(line).map((ch, i) => {
+    if (i < resolvedUpTo) return ch;
+    if (ch === " ") return " ";
+    return PARTS[Math.floor(Math.random() * PARTS.length)];
+  }).join("");
+}
+function progressBar(filled, total, width = 8) {
+  const n = Math.round(filled / total * width);
+  return "\u2588".repeat(n) + "\u2591".repeat(width - n);
+}
+var BOX_CONTENT_LINES = 8;
+async function animateBanner() {
+  const logoText = LOGO.join("\n");
+  const charCount = LOGO[0].length;
+  const FRAMES = 10;
+  const RATTLE = 2;
+  console.log();
+  console.log(pc6.dim(BORDER_TOP));
+  console.log(pc6.dim(EMPTY_ROW));
+  for (let f = 0; f <= FRAMES; f++) {
+    if (f > 0) cursorUp(BOX_CONTENT_LINES);
+    const progress = f <= RATTLE ? 0 : (f - RATTLE) / (FRAMES - RATTLE);
+    const resolved = Math.floor(progress * charCount);
+    const done = resolved >= charCount;
+    for (const line of LOGO) {
+      const text2 = done ? line : scrambleLine(line, resolved);
+      console.log(logoBoxLine(pc6.dim(text2), line.length));
+    }
+    console.log(pc6.dim(EMPTY_ROW));
+    if (done) {
+      console.log(boxRow(ikea.heading(TAGLINE), TAGLINE.length));
+    } else {
+      const bar = progressBar(Math.max(0, f - RATTLE), FRAMES - RATTLE);
+      const plain = `\u25B8 assembling  ${bar}`;
+      console.log(
+        boxRow(`${ikea.bullet} assembling  ${pc6.dim(bar)}`, plain.length)
+      );
+    }
+    console.log(pc6.dim(EMPTY_ROW));
+    console.log(pc6.dim(BORDER_BOT));
+    await sleep(f <= RATTLE ? 120 : done ? 200 : 60);
+  }
+  for (const grad of SWEEP_GRADIENTS) {
+    cursorUp(BOX_CONTENT_LINES);
+    const colored = grad.multiline(logoText).split("\n");
+    for (let i = 0; i < colored.length; i++) {
+      console.log(logoBoxLine(colored[i], LOGO[i].length));
+    }
+    console.log(pc6.dim(EMPTY_ROW));
+    console.log(boxRow(ikea.heading(TAGLINE), TAGLINE.length));
+    console.log(pc6.dim(EMPTY_ROW));
+    console.log(pc6.dim(BORDER_BOT));
+    await sleep(70);
+  }
+  console.log();
+}
+async function animateDescription() {
+  const lines = [
+    "Stop the digital clutter. Flat-packed code efficiency",
+    "delivered straight to your terminal."
+  ];
+  for (const line of lines) {
+    process.stdout.write("  ");
+    await typewriter(pc6.dim(line), 6);
+    console.log();
+  }
+  console.log();
+}
+function printBanner() {
+  const coloredLines = ikeaGradient.multiline(LOGO.join("\n")).split("\n");
+  console.log();
+  console.log(pc6.dim(BORDER_TOP));
+  console.log(pc6.dim(EMPTY_ROW));
+  for (let i = 0; i < coloredLines.length; i++) {
+    console.log(logoBoxLine(coloredLines[i], LOGO[i].length));
+  }
+  console.log(pc6.dim(EMPTY_ROW));
+  console.log(boxRow(ikea.heading(TAGLINE), TAGLINE.length));
+  console.log(pc6.dim(EMPTY_ROW));
+  console.log(pc6.dim(BORDER_BOT));
+  console.log();
+}
+function printDescription() {
+  console.log(
+    ikea.muted(
+      "  Stop the digital clutter. Flat-packed code efficiency\n  delivered straight to your terminal."
+    )
+  );
+  console.log();
+}
+
+// src/cli/index.ts
 var __dirname = dirname(fileURLToPath(import.meta.url));
 var pkgVersion = "0.0.0";
 try {
@@ -14,11 +477,16 @@ try {
   pkgVersion = pkg.version ?? pkgVersion;
 } catch {
 }
-var program = new Command().name("scale-stack").description("Opinionated scaffolding engine for Next.js projects").version(pkgVersion);
-program.command("init").description("Scaffold a new Scale Stack project").argument("[name]", "Project name").action((_name) => {
-  console.log("init is not yet implemented");
-});
-program.command("sync").description("Update an existing Scale Stack project").action(() => {
-  console.log("sync is not yet implemented");
-});
+var argv = process.argv.slice(2);
+var wantsHelp = argv.includes("--help") || argv.includes("-h") || argv.includes("--version") || argv.includes("-V");
+if (process.stdout.isTTY && !wantsHelp) {
+  await animateBanner();
+  await animateDescription();
+} else if (process.stdout.isTTY) {
+  printBanner();
+  printDescription();
+}
+var program = new Command().name("scale-stack").version(pkgVersion);
+registerInitCommand(program);
+registerSyncCommand(program);
 program.parse();

package/package.json

@@ -1,25 +1,23 @@
 {
   "name": "scale-stack",
-  "version": "0.0.1-alpha.0",
-  "description": "Opinionated scaffolding engine for Next.js projects",
+  "version": "0.0.1-alpha.2",
+  "description": "SKALSTÅKK — flat-packed code efficiency delivered straight to your terminal",
   "type": "module",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js"
-    }
-  },
+  "packageManager": "pnpm@10.33.0",
   "bin": {
     "scale-stack": "dist/index.js"
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
     "build": "tsup",
-    "dev": "tsup --watch",
+    "run": "node dist/index.js",
+    "cli": "tsx src/cli/index.ts",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint . && prettier --check .",
@@ -28,7 +26,14 @@
     "release": "pnpm build && npm publish",
     "release:alpha": "pnpm build && npm publish --tag alpha"
   },
-  "keywords": [],
+  "keywords": [
+    "scale",
+    "stack",
+    "scaffolding",
+    "boilerplate",
+    "generator",
+    "cli"
+  ],
   "author": "balazs.farago@scale.com",
   "license": "ISC",
   "devDependencies": {
@@ -42,6 +47,7 @@
     "jiti": "^2.6.1",
     "prettier": "^3.8.2",
     "tsup": "^8.5.1",
+    "tsx": "^4.21.0",
     "typescript": "^6.0.2",
     "typescript-eslint": "^8.58.2",
     "vitest": "^4.1.4"
@@ -50,6 +56,7 @@
     "@clack/prompts": "^1.2.0",
     "commander": "^14.0.3",
     "ejs": "^5.0.2",
+    "gradient-string": "^3.0.0",
     "picocolors": "^1.1.1",
     "semver": "^7.7.4"
   }