@geekyants/think-before 0.1.0 → 0.3.0

package/dist/detect.js

@@ -0,0 +1,371 @@
+import fs from "node:fs";
+import path from "node:path";
+// Dependency → human label maps. Matched against package.json deps. These cover
+// the common frameworks on the market; add more as needed — it degrades to
+// "unknown" gracefully when nothing matches.
+const FRONTEND_DEPS = {
+    react: "React",
+    "react-dom": "React",
+    vue: "Vue",
+    "@angular/core": "Angular",
+    svelte: "Svelte",
+    "solid-js": "SolidJS",
+    preact: "Preact",
+    "@stencil/core": "Stencil",
+    gatsby: "Gatsby",
+    "react-native": "React Native",
+    expo: "Expo",
+    "@ionic/react": "Ionic",
+    "@ionic/angular": "Ionic",
+};
+// Meta-frameworks that ship a server as well as a client → count as both.
+const FULLSTACK_DEPS = {
+    next: "Next.js",
+    nuxt: "Nuxt",
+    "@remix-run/react": "Remix",
+    "@remix-run/node": "Remix",
+    "@sveltejs/kit": "SvelteKit",
+    astro: "Astro",
+};
+const BACKEND_DEPS = {
+    express: "Express",
+    koa: "Koa",
+    fastify: "Fastify",
+    "@nestjs/core": "NestJS",
+    "@hapi/hapi": "hapi",
+    hapi: "hapi",
+    restify: "Restify",
+    "@apollo/server": "Apollo Server",
+    "apollo-server": "Apollo Server",
+    "@trpc/server": "tRPC",
+    "socket.io": "Socket.IO",
+};
+const DB_DEPS = new Set([
+    "prisma", "@prisma/client", "typeorm", "sequelize", "mongoose", "knex",
+    "drizzle-orm", "@mikro-orm/core", "pg", "mysql", "mysql2", "mongodb",
+    "redis", "ioredis", "better-sqlite3",
+]);
+const TEST_DEPS = new Set([
+    "jest", "vitest", "mocha", "@playwright/test", "cypress", "ava", "jasmine",
+    "supertest", "@testing-library/react", "@testing-library/vue",
+]);
+function readJson(p) {
+    try {
+        return JSON.parse(fs.readFileSync(p, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function readText(p) {
+    try {
+        return fs.readFileSync(p, "utf8");
+    }
+    catch {
+        return "";
+    }
+}
+function exists(p) {
+    try {
+        fs.accessSync(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** A friendly label for a project kind. */
+export function kindLabel(kind) {
+    switch (kind) {
+        case "fullstack":
+            return "full-stack";
+        case "frontend":
+            return "frontend";
+        case "backend":
+            return "backend";
+        default:
+            return "unknown";
+    }
+}
+/**
+ * Scan a directory for common framework/tooling signals and classify it as
+ * frontend, backend, full-stack, or unknown. Read-only and quick: it reads a
+ * handful of manifest files and checks for a few marker folders. Never throws.
+ */
+export function detectProject(root = process.cwd()) {
+    const signals = new Set();
+    const frameworks = new Set();
+    let hasFrontend = false;
+    let hasBackend = false;
+    let hasDatabase = false;
+    let hasTests = false;
+    let hasDocker = false;
+    let isMonorepo = false;
+    const collectDeps = (pkg) => {
+        if (!pkg)
+            return;
+        const deps = {
+            ...pkg["dependencies"],
+            ...pkg["devDependencies"],
+            ...pkg["peerDependencies"],
+            ...pkg["optionalDependencies"],
+        };
+        for (const name of Object.keys(deps)) {
+            const fe = FRONTEND_DEPS[name];
+            if (fe) {
+                hasFrontend = true;
+                frameworks.add(fe);
+            }
+            const fs2 = FULLSTACK_DEPS[name];
+            if (fs2) {
+                hasFrontend = true;
+                hasBackend = true;
+                frameworks.add(fs2);
+            }
+            const be = BACKEND_DEPS[name];
+            if (be) {
+                hasBackend = true;
+                frameworks.add(be);
+            }
+            if (DB_DEPS.has(name))
+                hasDatabase = true;
+            if (TEST_DEPS.has(name))
+                hasTests = true;
+        }
+        if (pkg["workspaces"])
+            isMonorepo = true;
+    };
+    // --- Node / JS ecosystem ---
+    const rootPkg = readJson(path.join(root, "package.json"));
+    if (rootPkg) {
+        signals.add("package.json");
+        collectDeps(rootPkg);
+    }
+    for (const m of ["pnpm-workspace.yaml", "lerna.json", "turbo.json", "nx.json"]) {
+        if (exists(path.join(root, m))) {
+            isMonorepo = true;
+            signals.add(m);
+        }
+    }
+    // In a monorepo, peek one level into the usual group folders.
+    if (isMonorepo || exists(path.join(root, "apps")) || exists(path.join(root, "packages"))) {
+        for (const group of ["apps", "packages", "services"]) {
+            const gp = path.join(root, group);
+            if (!exists(gp))
+                continue;
+            let entries = [];
+            try {
+                entries = fs.readdirSync(gp);
+            }
+            catch {
+                entries = [];
+            }
+            for (const entry of entries.slice(0, 30)) {
+                collectDeps(readJson(path.join(gp, entry, "package.json")));
+            }
+        }
+    }
+    // --- Python ---
+    const py = [
+        readText(path.join(root, "requirements.txt")),
+        readText(path.join(root, "pyproject.toml")),
+        readText(path.join(root, "Pipfile")),
+    ].join("\n").toLowerCase();
+    if (py.trim()) {
+        signals.add("python deps");
+        let matched = false;
+        if (py.includes("django")) {
+            hasBackend = true;
+            frameworks.add("Django");
+            matched = true;
+        }
+        if (py.includes("flask")) {
+            hasBackend = true;
+            frameworks.add("Flask");
+            matched = true;
+        }
+        if (py.includes("fastapi")) {
+            hasBackend = true;
+            frameworks.add("FastAPI");
+            matched = true;
+        }
+        if (!matched) {
+            hasBackend = true;
+            frameworks.add("Python");
+        }
+        if (py.includes("pytest"))
+            hasTests = true;
+    }
+    if (exists(path.join(root, "manage.py"))) {
+        hasBackend = true;
+        frameworks.add("Django");
+        signals.add("manage.py");
+    }
+    // --- PHP ---
+    const composer = readJson(path.join(root, "composer.json"));
+    if (composer) {
+        signals.add("composer.json");
+        hasBackend = true;
+        const req = {
+            ...composer["require"],
+            ...composer["require-dev"],
+        };
+        const keys = Object.keys(req).join(" ").toLowerCase();
+        if (keys.includes("laravel/framework"))
+            frameworks.add("Laravel");
+        else if (keys.includes("symfony/"))
+            frameworks.add("Symfony");
+        else
+            frameworks.add("PHP");
+        if (keys.includes("phpunit"))
+            hasTests = true;
+    }
+    // --- Ruby ---
+    const gemfile = readText(path.join(root, "Gemfile")).toLowerCase();
+    if (gemfile.trim()) {
+        signals.add("Gemfile");
+        hasBackend = true;
+        if (gemfile.includes("rails"))
+            frameworks.add("Rails");
+        else
+            frameworks.add("Ruby");
+        if (gemfile.includes("rspec") || gemfile.includes("minitest"))
+            hasTests = true;
+    }
+    // --- Go ---
+    const gomod = readText(path.join(root, "go.mod")).toLowerCase();
+    if (gomod.trim()) {
+        signals.add("go.mod");
+        hasBackend = true;
+        if (gomod.includes("gin-gonic"))
+            frameworks.add("Gin");
+        else if (gomod.includes("labstack/echo"))
+            frameworks.add("Echo");
+        else if (gomod.includes("gofiber/fiber"))
+            frameworks.add("Fiber");
+        else if (gomod.includes("go-chi/chi"))
+            frameworks.add("chi");
+        else
+            frameworks.add("Go");
+    }
+    // --- Java / Kotlin ---
+    const jvm = (readText(path.join(root, "pom.xml")) +
+        readText(path.join(root, "build.gradle")) +
+        readText(path.join(root, "build.gradle.kts"))).toLowerCase();
+    if (jvm.trim()) {
+        signals.add(jvm.includes("<project") ? "pom.xml" : "build.gradle");
+        hasBackend = true;
+        if (jvm.includes("spring-boot") || jvm.includes("springframework"))
+            frameworks.add("Spring Boot");
+        else if (jvm.includes("ktor"))
+            frameworks.add("Ktor");
+        else
+            frameworks.add("JVM");
+    }
+    // --- Rust ---
+    const cargo = readText(path.join(root, "Cargo.toml")).toLowerCase();
+    if (cargo.trim()) {
+        signals.add("Cargo.toml");
+        hasBackend = true;
+        if (cargo.includes("actix-web"))
+            frameworks.add("Actix");
+        else if (cargo.includes("axum"))
+            frameworks.add("Axum");
+        else if (cargo.includes("rocket"))
+            frameworks.add("Rocket");
+        else
+            frameworks.add("Rust");
+    }
+    // --- .NET ---
+    try {
+        if (fs.readdirSync(root).some((f) => f.endsWith(".csproj") || f.endsWith(".sln"))) {
+            hasBackend = true;
+            frameworks.add(".NET");
+            signals.add(".csproj");
+        }
+    }
+    catch {
+        /* ignore unreadable dir */
+    }
+    // --- Frontend file/folder heuristics ---
+    const feMarkers = [
+        ["angular.json", "Angular"],
+        ["next.config.js", "Next.js"],
+        ["next.config.mjs", "Next.js"],
+        ["next.config.ts", "Next.js"],
+        ["nuxt.config.ts", "Nuxt"],
+        ["svelte.config.js", "Svelte"],
+        ["vite.config.ts", "Vite"],
+        ["vite.config.js", "Vite"],
+        ["tailwind.config.js", "Tailwind"],
+        ["tailwind.config.ts", "Tailwind"],
+        ["astro.config.mjs", "Astro"],
+    ];
+    for (const [file, label] of feMarkers) {
+        if (exists(path.join(root, file))) {
+            hasFrontend = true;
+            frameworks.add(label);
+            signals.add(file);
+        }
+    }
+    if (exists(path.join(root, "index.html")) || exists(path.join(root, "public", "index.html"))) {
+        hasFrontend = true;
+        signals.add("index.html");
+    }
+    if (exists(path.join(root, "src", "components")) || exists(path.join(root, "src", "pages"))) {
+        hasFrontend = true;
+    }
+    // --- Backend folder heuristics ---
+    if (exists(path.join(root, "prisma")) || exists(path.join(root, "migrations"))) {
+        hasBackend = true;
+        hasDatabase = true;
+        signals.add("migrations");
+    }
+    for (const d of ["controllers", "routes", path.join("src", "controllers"), path.join("src", "routes"), "api"]) {
+        if (exists(path.join(root, d)))
+            hasBackend = true;
+    }
+    if (exists(path.join(root, "serverless.yml"))) {
+        hasBackend = true;
+        signals.add("serverless.yml");
+    }
+    // --- Cross-cutting ---
+    if (exists(path.join(root, "Dockerfile")) ||
+        exists(path.join(root, "docker-compose.yml")) ||
+        exists(path.join(root, "docker-compose.yaml"))) {
+        hasDocker = true;
+        signals.add("Docker");
+    }
+    for (const t of ["test", "tests", "__tests__", "e2e"]) {
+        if (exists(path.join(root, t)))
+            hasTests = true;
+    }
+    let kind;
+    if (hasFrontend && hasBackend)
+        kind = "fullstack";
+    else if (hasFrontend)
+        kind = "frontend";
+    else if (hasBackend)
+        kind = "backend";
+    else
+        kind = "unknown";
+    return {
+        kind,
+        frameworks: [...frameworks],
+        hasDatabase,
+        hasTests,
+        hasDocker,
+        isMonorepo,
+        signals: [...signals],
+    };
+}
+/** detectProject wrapped so detection failures never break a run. */
+export function safeDetect(root = process.cwd()) {
+    try {
+        return detectProject(root);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=detect.js.map

package/dist/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../src/detect.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,10 @@
 export * from "./types.js";
 export { quick, full, checklists } from "./checklists.js";
 export { filterSections, runSession } from "./session.js";
-export { askYesNo, closeInput } from "./prompt.js";
+export { askYesNo, askChoice, closeInput } from "./prompt.js";
 export { buildMarkdown, defaultReportName, printSummary, printList, saveReport } from "./report.js";
+export { detectProject, safeDetect, kindLabel } from "./detect.js";
+export { stackSection } from "./stack.js";
+export { runTui, tuiAvailable } from "./tui.js";
+export { loadConfig, saveConfig, configDir, configPath, getProjectRecord, setProjectRecord, } from "./config.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EACL,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -1,9 +1,13 @@
-// Public API — import `think-before` programmatically as a library.
+// Public API — import `@geekyants/think-before` programmatically as a library.
 //
-//   import { quick, full, runSession, filterSections, buildMarkdown } from "think-before";
+//   import { quick, full, runSession, detectProject, stackSection } from "@geekyants/think-before";
 export * from "./types.js";
 export { quick, full, checklists } from "./checklists.js";
 export { filterSections, runSession } from "./session.js";
-export { askYesNo, closeInput } from "./prompt.js";
+export { askYesNo, askChoice, closeInput } from "./prompt.js";
 export { buildMarkdown, defaultReportName, printSummary, printList, saveReport } from "./report.js";
+export { detectProject, safeDetect, kindLabel } from "./detect.js";
+export { stackSection } from "./stack.js";
+export { runTui, tuiAvailable } from "./tui.js";
+export { loadConfig, saveConfig, configDir, configPath, getProjectRecord, setProjectRecord, } from "./config.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,2FAA2F;AAE3F,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,EAAE;AACF,oGAAoG;AAEpG,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACpG,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EACL,UAAU,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC"}

package/dist/prompt.d.ts

@@ -11,6 +11,12 @@ export type AnswerOrQuit = AnswerValue | "quit";
  * still works in non-interactive contexts.
  */
 export declare function askYesNo(why?: string): Promise<AnswerOrQuit>;
+/**
+ * Ask the user to pick one of a set of single-character keys (e.g. ["1","2","3"]).
+ * Resolves the chosen key, or "quit" on q/Esc/Ctrl-C/EOF. Non-TTY input reads a
+ * line and matches its first relevant character.
+ */
+export declare function askChoice(keys: string[]): Promise<string | "quit">;
 /** Release the shared line reader so the process can exit (non-TTY only). */
 export declare function closeInput(): void;
 //# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyC5D;AA0CD,6EAA6E;AAC7E,wBAAgB,UAAU,IAAI,IAAI,CAKjC"}
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,MAAM,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyC5D;AA+BD;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CA2ClE;AAaD,6EAA6E;AAC7E,wBAAgB,UAAU,IAAI,IAAI,CAKjC"}

package/dist/prompt.js

@@ -83,6 +83,53 @@ function readLineOnce() {
         return Promise.resolve(queued);
     return new Promise((resolve) => waiters.push(resolve));
 }
+/**
+ * Ask the user to pick one of a set of single-character keys (e.g. ["1","2","3"]).
+ * Resolves the chosen key, or "quit" on q/Esc/Ctrl-C/EOF. Non-TTY input reads a
+ * line and matches its first relevant character.
+ */
+export function askChoice(keys) {
+    const allowed = keys.map((k) => k.toLowerCase());
+    const stdin = process.stdin;
+    if (!stdin.isTTY) {
+        return readLineOnce().then((line) => {
+            if (line === null)
+                return "quit";
+            const text = line.trim().toLowerCase();
+            if (text.startsWith("q"))
+                return "quit";
+            const hit = [...text].find((ch) => allowed.includes(ch));
+            return hit ?? "quit";
+        });
+    }
+    return new Promise((resolve) => {
+        readline.emitKeypressEvents(stdin);
+        stdin.setRawMode(true);
+        stdin.resume();
+        const cleanup = () => {
+            stdin.removeListener("keypress", onKey);
+            stdin.setRawMode(false);
+            stdin.pause();
+        };
+        const onKey = (str, key) => {
+            if (key && key.ctrl && key.name === "c") {
+                cleanup();
+                resolve("quit");
+                return;
+            }
+            const k = (str || "").toLowerCase();
+            if (k === "q" || (key && key.name === "escape")) {
+                cleanup();
+                resolve("quit");
+            }
+            else if (allowed.includes(k)) {
+                cleanup();
+                resolve(k);
+            }
+        };
+        stdin.on("keypress", onKey);
+    });
+}
 function askLine() {
     return readLineOnce().then((line) => {
         if (line === null)

package/dist/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"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"}

package/dist/stack.d.ts

@@ -0,0 +1,8 @@
+import type { Detection, Role, Section } from "./types.js";
+/**
+ * Build a stack-tailored Section from a detection result, filtered to the
+ * user's role when known. Returns null when there's nothing relevant to add
+ * (e.g. an unknown stack).
+ */
+export declare function stackSection(detection: Detection, role?: Role): Section | null;
+//# sourceMappingURL=stack.d.ts.map

package/dist/stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.ts","sourceRoot":"","sources":["../src/stack.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAY,IAAI,EAAe,OAAO,EAAE,MAAM,YAAY,CAAC;AAsIlF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,GAAG,IAAI,CAgB9E"}

package/dist/stack.js

@@ -0,0 +1,119 @@
+import { kindLabel } from "./detect.js";
+const ALL_ROLES = ["designer", "engineer", "developer"];
+const TECH_ROLES = ["engineer", "developer"];
+const isFrontend = (d) => d.kind === "frontend" || d.kind === "fullstack";
+const isBackend = (d) => d.kind === "backend" || d.kind === "fullstack";
+const hasDb = (d) => isBackend(d) && d.hasDatabase;
+const isFullstack = (d) => d.kind === "fullstack";
+function q(id, text, risky, why) {
+    return { id, text, risky, why };
+}
+const CANDIDATES = [
+    // --- Frontend ---
+    {
+        when: isFrontend,
+        roles: ALL_ROLES,
+        q: q("fe-breakpoints", "Have you checked this across the breakpoints, devices, and viewports the app supports?", "no", "Layout side-effects love to hide on the screen sizes you didn't open."),
+    },
+    {
+        when: isFrontend,
+        roles: ALL_ROLES,
+        q: q("fe-a11y", "Will keyboard navigation, focus order, and screen-reader output still work after this?", "no", "Accessibility regressions are invisible until someone who relies on them hits them."),
+    },
+    {
+        when: isFrontend,
+        roles: ALL_ROLES,
+        q: q("fe-shared-ui", "Is this a shared component, style, or design token reused across many screens?", "yes", "One tweak to a shared UI primitive re-renders everywhere it's used."),
+    },
+    {
+        when: isFrontend,
+        roles: TECH_ROLES,
+        q: q("fe-state", "Could this change shared client state, context, or a global store other views read?", "yes", "Global state is a hidden contract between unrelated screens."),
+    },
+    {
+        when: isFrontend,
+        roles: TECH_ROLES,
+        q: q("fe-bundle", "Could this noticeably grow the bundle or block the main thread (heavy dep, sync work)?", "yes", "A small import can drag a large dependency — and the user's first paint — with it."),
+    },
+    {
+        when: isFrontend,
+        roles: TECH_ROLES,
+        q: q("fe-cache", "Could cached assets, a service worker, or localStorage from the old version conflict with this?", "yes", "Returning users run a mix of old and new code until caches clear."),
+    },
+    // --- Backend ---
+    {
+        when: isBackend,
+        roles: TECH_ROLES,
+        q: q("be-api-contract", "Does this change a request/response shape, field, or status code a client depends on?", "yes", "Clients you can't see — web, mobile, integrations — break the moment the contract shifts."),
+    },
+    {
+        when: isBackend,
+        roles: TECH_ROLES,
+        q: q("be-authz", "Does this touch authentication, authorization, or tenant/data isolation?", "yes", "Authz mistakes are high-severity and rarely caught by happy-path testing."),
+    },
+    {
+        when: isBackend,
+        roles: TECH_ROLES,
+        q: q("be-idempotent", "Are retries and duplicate requests safe (idempotent), with failures handled cleanly?", "no", "Networks retry. Non-idempotent handlers double-charge, double-send, double-write."),
+    },
+    {
+        when: isBackend,
+        roles: TECH_ROLES,
+        q: q("be-external", "Does this add a call to an external service with rate limits, latency, or per-call cost?", "yes", "Their outage, throttle, or bill becomes your outage, throttle, or bill."),
+    },
+    // --- Database (backend + a data layer detected) ---
+    {
+        when: hasDb,
+        roles: TECH_ROLES,
+        q: q("db-migration", "Is the schema/migration reversible and backward-compatible with the running code?", "no", "Deploys aren't atomic — old code runs against the new schema for a window."),
+    },
+    {
+        when: hasDb,
+        roles: TECH_ROLES,
+        q: q("db-transaction", "Do multi-step writes run in a transaction so a partial failure can't corrupt data?", "no", "A crash between two writes is the bug you only find in production."),
+    },
+    {
+        when: hasDb,
+        roles: TECH_ROLES,
+        q: q("db-nplus1", "Could this introduce an N+1 query or an unindexed scan on a hot path?", "yes", "Fine on your seed data; a table scan at production scale."),
+    },
+    // --- Full-stack boundary ---
+    {
+        when: isFullstack,
+        roles: TECH_ROLES,
+        q: q("fs-deploy-order", "If both API and client change, can they deploy independently without breaking each other?", "no", "Front end and back end rarely deploy in the same instant — plan for the gap."),
+    },
+    // --- Detection-driven ---
+    {
+        when: (d) => !d.hasTests,
+        roles: TECH_ROLES,
+        q: q("no-tests", "No test setup was detected here — will you add a test or a written manual check for this change?", "no", "Untested changes to an unfamiliar codebase are how 'small' becomes 'incident'."),
+    },
+    {
+        when: (d) => d.hasDocker,
+        roles: TECH_ROLES,
+        q: q("docker-parity", "Will this still work in the container / deploy environment, not just your local machine?", "no", "Env vars, file paths, and timezones differ between your laptop and the container."),
+    },
+];
+/**
+ * Build a stack-tailored Section from a detection result, filtered to the
+ * user's role when known. Returns null when there's nothing relevant to add
+ * (e.g. an unknown stack).
+ */
+export function stackSection(detection, role) {
+    if (detection.kind === "unknown")
+        return null;
+    const questions = CANDIDATES.filter((c) => c.when(detection))
+        .filter((c) => !role || c.roles.includes(role))
+        .map((c) => c.q);
+    if (questions.length === 0)
+        return null;
+    const fw = detection.frameworks.length ? ` (${detection.frameworks.join(", ")})` : "";
+    return {
+        id: "stack",
+        title: `Stack-specific — ${kindLabel(detection.kind)}${fw}`,
+        roles: ["shared"],
+        questions,
+    };
+}
+//# sourceMappingURL=stack.js.map