@geekyants/think-before 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 think-before contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# think-before
+
+**A fast yes/no reflection before you change something.**
+
+A small change in a big app is rarely small. `think-before` is a tiny, zero-dependency CLI that walks you through a sharp set of yes/no questions so the side-effects you'd otherwise discover *in production* surface *on the whiteboard* instead.
+
+It's the pause between "this is a one-line fix" and `git push`.
+
+```
+$ npx @geekyants/think-before
+
+Quick — Blast-radius check
+A small change in a big app is rarely small. 60 seconds of honesty before you start.
+Answer fast — y yes · n no · s skip · ? why · q quit
+
+  Blast radius
+   3/16 Is this in shared/global code used in many places? [y/n] ✓ yes  ⚠ worth a second look
+         ↳ Shared code multiplies the blast radius — one edit ripples everywhere it's imported.
+```
+
+## Quick start
+
+No install needed:
+
+```bash
+npx @geekyants/think-before            # quick blast-radius check (default)
+npx @geekyants/think-before full       # the full pre-development discovery checklist
+```
+
+Or install it:
+
+```bash
+npm install -g @geekyants/think-before
+think-before                           # the installed command is just `think-before`
+```
+
+## Modes
+
+| Mode | What it's for |
+| --- | --- |
+| `quick` *(default)* | The "I'm about to touch the big app" moment. ~16 sharp questions about blast radius, data, contracts, your safety net, and timing. |
+| `full` | A team-level pre-development discovery sweep: problem, users, scope, risks, plus role sections for designers, engineers, and developers. |
+
+In `full` mode you can focus on one role (shared sections are always included):
+
+```bash
+think-before full --role designer
+think-before full --role engineer
+think-before full --role developer
+```
+
+## How to answer
+
+Single keypress, no Enter needed:
+
+| Key | Meaning |
+| --- | --- |
+| `y` | yes |
+| `n` | no |
+| `s` or `Enter` | skip (logs it as an open question) |
+| `?` | show *why this question matters* |
+| `q` or `Esc` | quit |
+
+Answers that point at risk get **flagged** with a one-line reason. At the end you get a summary of everything worth a second look — and the option to save it.
+
+> **A skipped question is an open question, not a free pass.** A short list of "we don't know yet" is more valuable than a confident plan built on untested assumptions.
+
+## Options
+
+```
+--role <r>       In full mode, show shared + one role: designer | engineer | developer
+--save [file]    Save a Markdown report (optionally to <file>) without asking
+--no-save        Don't save and don't ask
+--list           Print the checklist and exit (no prompts)
+--no-color       Disable colored output
+-v, --version    Print version
+-h, --help       Show this help
+```
+
+The report is plain Markdown — drop it into a PR description, a ticket, or your design doc.
+
+## Use as a library
+
+```ts
+import { quick, full, filterSections, runSession, buildMarkdown } from "@geekyants/think-before";
+
+const sections = filterSections(full, "engineer");
+const result = await runSession(full, sections);
+const markdown = buildMarkdown(full, result, new Date());
+```
+
+## Develop
+
+```bash
+npm install
+npm run dev        # run the CLI straight from TypeScript source
+npm run build      # compile to dist/
+npm start          # run the built CLI
+```
+
+Want to add or tweak questions? They live in [`src/checklists.ts`](src/checklists.ts) — each question declares which answer (`yes`/`no`) is the risky one, plus an optional `why`. PRs welcome.
+
+## License
+
+MIT

package/dist/checklists.d.ts

@@ -0,0 +1,21 @@
+import type { Checklist } from "./types.js";
+/**
+ * QUICK — the blast-radius check.
+ *
+ * For the "I'm about to make a small change to a big app" moment. Fast,
+ * sharp, and focused on the side-effects people overlook. Most questions
+ * are phrased so that the *risky* answer surfaces something to double-check
+ * before you touch the code.
+ */
+export declare const quick: Checklist;
+/**
+ * FULL — the pre-development discovery checklist.
+ *
+ * The team-level questions to ask *before* starting any workflow, reframed
+ * as yes/no so you can sweep them quickly. A "no" here usually means a gap
+ * worth closing, not a blocker — log it as an open question.
+ */
+export declare const full: Checklist;
+/** All built-in checklists, keyed by id. */
+export declare const checklists: Record<string, Checklist>;
+//# sourceMappingURL=checklists.d.ts.map

package/dist/checklists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checklists.d.ts","sourceRoot":"","sources":["../src/checklists.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;;;;;;GAOG;AACH,eAAO,MAAM,KAAK,EAAE,SA0InB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,EAAE,SAiJlB,CAAC;AAEF,4CAA4C;AAC5C,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAGhD,CAAC"}

package/dist/checklists.js

@@ -0,0 +1,306 @@
+/**
+ * QUICK — the blast-radius check.
+ *
+ * For the "I'm about to make a small change to a big app" moment. Fast,
+ * sharp, and focused on the side-effects people overlook. Most questions
+ * are phrased so that the *risky* answer surfaces something to double-check
+ * before you touch the code.
+ */
+export const quick = {
+    id: "quick",
+    title: "Quick — Blast-radius check",
+    intro: "A small change in a big app is rarely small. 60 seconds of honesty before you start.",
+    sections: [
+        {
+            id: "understand",
+            title: "Understand the change",
+            roles: ["shared"],
+            questions: [
+                {
+                    id: "understand-current",
+                    text: "Do you understand what this code does today — not just the line you're editing?",
+                    risky: "no",
+                    why: "Editing code you don't fully understand is the #1 source of surprise side-effects.",
+                },
+                {
+                    id: "one-sentence",
+                    text: "Can you describe the change and its intended effect in one sentence?",
+                    risky: "no",
+                    why: "If you can't state it simply, the scope isn't clear yet — and unclear scope hides risk.",
+                },
+            ],
+        },
+        {
+            id: "blast-radius",
+            title: "Blast radius",
+            roles: ["shared"],
+            questions: [
+                {
+                    id: "shared-code",
+                    text: "Is this in shared/global code (a util, base component, hook, config, middleware) used in many places?",
+                    risky: "yes",
+                    why: "Shared code multiplies the blast radius — one edit ripples everywhere it's imported.",
+                },
+                {
+                    id: "found-callers",
+                    text: "Have you searched for every caller / usage of what you're changing?",
+                    risky: "no",
+                    why: "Unknown callers are unknown breakage. Grep for usages before you edit, not after.",
+                },
+                {
+                    id: "untested-flows",
+                    text: "Could this change behavior in flows you are NOT going to manually test?",
+                    risky: "yes",
+                    why: "The side-effects you don't test for are exactly the ones that reach production.",
+                },
+            ],
+        },
+        {
+            id: "data-contracts",
+            title: "Data & contracts",
+            roles: ["shared"],
+            questions: [
+                {
+                    id: "data-touch",
+                    text: "Does it touch persisted data — schema, migrations, stored formats, or cached values?",
+                    risky: "yes",
+                    why: "Data changes are the hardest to roll back; old data outlives your deploy.",
+                },
+                {
+                    id: "public-contract",
+                    text: "Does it change a public API, response shape, event, or contract others depend on?",
+                    risky: "yes",
+                    why: "Consumers you can't see — other teams, mobile apps, integrations — may break silently.",
+                },
+                {
+                    id: "backward-compat",
+                    text: "Have you accounted for backward compatibility and in-flight / old-shaped data?",
+                    risky: "no",
+                    why: "Queues, caches, and old clients may still hold the previous shape after you deploy.",
+                },
+            ],
+        },
+        {
+            id: "safety-net",
+            title: "Safety net",
+            roles: ["shared"],
+            questions: [
+                {
+                    id: "tests-cover",
+                    text: "Do existing automated tests cover this path, and do they still pass?",
+                    risky: "no",
+                    why: "No test means no safety net. Add or run one before the change, not after the incident.",
+                },
+                {
+                    id: "rollback",
+                    text: "Is there a fast way to undo this (revert, feature flag, kill switch)?",
+                    risky: "no",
+                    why: "If you can't roll back quickly, the cost of being wrong is much higher.",
+                },
+                {
+                    id: "observability",
+                    text: "If this breaks in production, will you find out (logs, metrics, alerts)?",
+                    risky: "no",
+                    why: "Silent failures are the worst kind — you learn about them from angry users.",
+                },
+            ],
+        },
+        {
+            id: "risk-surfaces",
+            title: "High-risk surfaces",
+            roles: ["shared"],
+            questions: [
+                {
+                    id: "security",
+                    text: "Does it touch auth, permissions, security, or anything handling PII / secrets?",
+                    risky: "yes",
+                    why: "These failures are high-severity and often invisible until they're exploited.",
+                },
+                {
+                    id: "performance",
+                    text: "Could it affect performance at scale (N+1, large lists, hot path, extra network calls)?",
+                    risky: "yes",
+                    why: "What's fine with 10 rows can melt down at 10 million. Side-effects scale too.",
+                },
+            ],
+        },
+        {
+            id: "timing-gut",
+            title: "Timing & gut check",
+            roles: ["shared"],
+            questions: [
+                {
+                    id: "timing",
+                    text: "Are you shipping at a risky time (Friday, right before a release, peak traffic, on-call gap)?",
+                    risky: "yes",
+                    why: "Bad timing turns a small bug into a long incident with nobody around to fix it.",
+                },
+                {
+                    id: "gut",
+                    text: "Be honest — do you actually understand the side-effects of this change?",
+                    risky: "no",
+                    why: "Your gut is data. If it says 'not sure', pause and dig before you commit.",
+                },
+            ],
+        },
+    ],
+};
+/**
+ * FULL — the pre-development discovery checklist.
+ *
+ * The team-level questions to ask *before* starting any workflow, reframed
+ * as yes/no so you can sweep them quickly. A "no" here usually means a gap
+ * worth closing, not a blocker — log it as an open question.
+ */
+export const full = {
+    id: "full",
+    title: "Full — Pre-development discovery",
+    intro: "Surface assumptions, scope, and risk while changes are still cheap — on a whiteboard, not in prod.",
+    sections: [
+        {
+            id: "problem-goals",
+            title: "1. Problem & Goals",
+            roles: ["shared"],
+            questions: [
+                { id: "problem-statement", text: "Can you state the problem you're solving in one sentence?", risky: "no" },
+                { id: "why-now", text: "Do you know why now — and what happens if you don't build it?", risky: "no" },
+                { id: "success-metric", text: "Is success defined with a metric, a target, and a timeframe?", risky: "no" },
+                { id: "change-type", text: "Are you clear whether this is a new capability, an improvement, or a fix?", risky: "no", why: "It changes the risk profile and how much process it needs." },
+                { id: "decision-maker", text: "Is the final decision-maker on scope identified?", risky: "no" },
+                { id: "attempted-before", text: "Do you know whether this was attempted before, and what happened?", risky: "no" },
+            ],
+        },
+        {
+            id: "users-stakeholders",
+            title: "2. Users & Stakeholders",
+            roles: ["shared"],
+            questions: [
+                { id: "primary-users", text: "Do you know who the primary (and secondary) users are?", risky: "no" },
+                { id: "job-to-be-done", text: "Is the user's job-to-be-done clearly understood?", risky: "no" },
+                { id: "current-workflow", text: "Do you understand the current workflow without this feature?", risky: "no" },
+                { id: "signoff-stages", text: "Are the stakeholders who must review or sign off identified, with stages?", risky: "no" },
+                { id: "internal-users", text: "Have you considered internal users (support, ops, admins) and their needs?", risky: "no" },
+                { id: "discovery", text: "Is there a plan for how users will find out this exists?", risky: "no" },
+            ],
+        },
+        {
+            id: "scope-requirements",
+            title: "3. Scope & Requirements",
+            roles: ["shared"],
+            questions: [
+                { id: "in-scope", text: "Is what's IN scope for this iteration written down?", risky: "no" },
+                { id: "out-of-scope", text: "Is what's OUT of scope written down?", risky: "no", why: "Explicit non-goals are what actually prevent scope creep." },
+                { id: "mvp-cut", text: "Is the MVP cut — the minimum that delivers value — defined?", risky: "no" },
+                { id: "acceptance-criteria", text: "Are the acceptance criteria for 'done' defined?", risky: "no" },
+                { id: "requirements-stability", text: "Do you know whether requirements are fixed or expected to evolve?", risky: "no" },
+                { id: "unvalidated-assumptions", text: "Have you listed the assumptions you're making but haven't validated?", risky: "no" },
+            ],
+        },
+        {
+            id: "constraints-logistics",
+            title: "4. Constraints & Logistics",
+            roles: ["shared"],
+            questions: [
+                { id: "deadline", text: "Is the deadline known, and whether it's hard or soft (and why)?", risky: "no" },
+                { id: "capacity", text: "Is the available budget / capacity (people, hours) known?", risky: "no" },
+                { id: "ownership", text: "Is long-term ownership after launch assigned?", risky: "no" },
+                { id: "dependencies", text: "Are dependencies on other teams, vendors, or releases mapped?", risky: "no" },
+                { id: "legal-deadlines", text: "Are any legal / contractual / regulatory deadlines identified?", risky: "no" },
+                { id: "fallback-plan", text: "Is there a rollback / fallback plan if it goes wrong?", risky: "no" },
+            ],
+        },
+        {
+            id: "risks-unknowns",
+            title: "5. Risks & Unknowns",
+            roles: ["shared"],
+            questions: [
+                { id: "biggest-risk", text: "Do you know the single biggest risk to this project?", risky: "no" },
+                { id: "riskiest-assumption", text: "Have you identified the riskiest assumption — and can you test it cheaply first?", risky: "no" },
+                { id: "known-unknowns", text: "Are the known unknowns to research before committing listed?", risky: "no" },
+                { id: "three-x", text: "Do you know what could make this take 3x longer than estimated?", risky: "no" },
+                { id: "spof", text: "Have you checked for single points of failure (one person, one system, one vendor)?", risky: "no" },
+            ],
+        },
+        {
+            id: "designers",
+            title: "6. For Designers",
+            roles: ["designer"],
+            questions: [
+                { id: "real-research", text: "Do you have real user research (not guesses) for who you're designing for?", risky: "no" },
+                { id: "existing-patterns", text: "Have you identified the existing patterns, components, or design-system rules that apply?", risky: "no" },
+                { id: "key-flows", text: "Are the key user flows mapped, including error and empty states?", risky: "no" },
+                { id: "a11y", text: "Do you know the accessibility standards to meet (e.g. WCAG AA: contrast, keyboard, screen readers, touch targets)?", risky: "no" },
+                { id: "viewports", text: "Are the supported devices, breakpoints, and viewports defined?", risky: "no" },
+                { id: "copy", text: "Is it clear what copy is needed, who writes it, and any localization?", risky: "no" },
+                { id: "design-edge-cases", text: "Have you considered edge cases: long text, missing data, slow connections, large lists?", risky: "no" },
+                { id: "validation", text: "Is there a plan to validate the design (usability test, prototype, A/B)?", risky: "no" },
+                { id: "handoff", text: "Is the engineering handoff defined (tokens, specs, states, motion)?", risky: "no" },
+                { id: "brand-legal", text: "Have you checked brand, legal, or compliance constraints on the UI?", risky: "no" },
+            ],
+        },
+        {
+            id: "engineers",
+            title: "7. For Engineers / Architects",
+            roles: ["engineer"],
+            questions: [
+                { id: "nfrs", text: "Are the non-functional requirements (performance, scale, latency, uptime) defined?", risky: "no" },
+                { id: "load", text: "Do you know the expected load at launch and at projected growth?", risky: "no" },
+                { id: "data-ownership", text: "Is it clear what data you read/write, where it lives, and who owns it?", risky: "no" },
+                { id: "external-apis", text: "Are external APIs/services, their rate limits, and SLAs identified?", risky: "no" },
+                { id: "fits-architecture", text: "Do you know whether this fits the current architecture or needs a new pattern?", risky: "no" },
+                { id: "security-reqs", text: "Are the security requirements (authn/authz, encryption, secrets, PII) defined?", risky: "no" },
+                { id: "compliance", text: "Are the applicable privacy/compliance rules known (GDPR, CCPA, HIPAA, SOC 2, residency)?", risky: "no" },
+                { id: "failure-handling", text: "Is there a plan for failures, retries, idempotency, and degraded states?", risky: "no" },
+                { id: "observability-plan", text: "Is the observability plan (logging, metrics, tracing, alerts) defined?", risky: "no" },
+                { id: "deploy-plan", text: "Is the deployment approach clear (CI/CD, feature flags, migrations, zero-downtime)?", risky: "no" },
+            ],
+        },
+        {
+            id: "developers",
+            title: "8. For Developers (Implementation)",
+            roles: ["developer"],
+            questions: [
+                { id: "first-test", text: "Do you understand the acceptance criteria well enough to write the first test?", risky: "no" },
+                { id: "small-pieces", text: "Can you break this into small, independently shippable pieces?", risky: "no" },
+                { id: "code-location", text: "Do you know where the code lives and what conventions/standards apply?", risky: "no" },
+                { id: "reuse", text: "Have you checked what already exists that you can reuse instead of rewriting?", risky: "no" },
+                { id: "testing-strategy", text: "Is the testing strategy (unit, integration, e2e) and coverage target clear?", risky: "no" },
+                { id: "run-locally", text: "Can you run this locally — is the dev environment / test data ready?", risky: "no" },
+                { id: "edge-inputs", text: "Do you know the edge cases and invalid inputs you must handle?", risky: "no" },
+                { id: "migration", text: "Have you considered backward-compatibility and migration concerns?", risky: "no" },
+                { id: "review-bar", text: "Is it clear how this will be reviewed and what 'ready to merge' means?", risky: "no" },
+                { id: "docs", text: "Do you know what documentation you need to write (README, API docs, runbook)?", risky: "no" },
+            ],
+        },
+        {
+            id: "launch-readiness",
+            title: "9. Quality & Launch Readiness",
+            roles: ["shared"],
+            questions: [
+                { id: "release-checklist", text: "Is the release checklist — what must be true before shipping — defined?", risky: "no" },
+                { id: "prod-like-test", text: "Is there a plan to test in a production-like environment?", risky: "no" },
+                { id: "monitoring-oncall", text: "Is the monitoring plan and the on-call owner after launch defined?", risky: "no" },
+                { id: "fast-rollback", text: "Is there a fast rollback if something breaks?", risky: "no" },
+                { id: "comms-plan", text: "Is the launch communication plan (internal + users) ready?", risky: "no" },
+                { id: "goal-review", text: "Is there a plan and date to review whether this actually hit its goals?", risky: "no" },
+            ],
+        },
+        {
+            id: "gut-check",
+            title: "10. Final Gut Check",
+            roles: ["shared"],
+            questions: [
+                { id: "half-value", text: "If you shipped only half of this, do you know which half delivers the most value?", risky: "no" },
+                { id: "alignment", text: "Is everyone aligned on scope, owner, and definition of done?", risky: "no" },
+                { id: "regret", text: "Do you know the one thing you're most likely to regret skipping?", risky: "no" },
+                { id: "real-problem", text: "Are you solving the real problem, not just the requested solution?", risky: "no" },
+            ],
+        },
+    ],
+};
+/** All built-in checklists, keyed by id. */
+export const checklists = {
+    quick,
+    full,
+};
+//# sourceMappingURL=checklists.js.map

package/dist/checklists.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,162 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import { checklists } from "./checklists.js";
+import { filterSections, runSession } from "./session.js";
+import { buildMarkdown, defaultReportName, printList, printSummary, saveReport } from "./report.js";
+import { askYesNo, closeInput } from "./prompt.js";
+import { bold, cyan, dim, green, setColor, yellow } from "./colors.js";
+const VALID_ROLES = ["designer", "engineer", "developer", "shared"];
+function readVersion() {
+    try {
+        const pkg = JSON.parse(fs.readFileSync(new URL("../package.json", import.meta.url), "utf8"));
+        return typeof pkg.version === "string" ? pkg.version : "0.0.0";
+    }
+    catch {
+        return "0.0.0";
+    }
+}
+function printHelp() {
+    const b = bold;
+    console.log(`
+${b("think-before")} — a fast yes/no reflection before you change something.
+
+${b("Usage")}
+  think-before [mode] [options]
+
+${b("Modes")}
+  quick            Blast-radius check for a small change ${dim("(default)")}
+  full             Full pre-development discovery checklist
+
+${b("Options")}
+  --role <r>       In full mode, show shared + one role: designer | engineer | developer
+  --save [file]    Save a Markdown report (optionally to <file>) without asking
+  --no-save        Don't save and don't ask
+  --list           Print the checklist and exit (no prompts)
+  --no-color       Disable colored output
+  -v, --version    Print version
+  -h, --help       Show this help
+
+${b("Keys during a session")}
+  ${cyan("y")} yes · ${cyan("n")} no · ${cyan("s")} skip · ${cyan("?")} why this matters · ${cyan("q")} quit
+
+${b("Examples")}
+  npx @geekyants/think-before
+  npx @geekyants/think-before full
+  npx @geekyants/think-before full --role engineer
+  npx @geekyants/think-before quick --save
+`);
+}
+function parseArgs(argv) {
+    const opts = { mode: "quick", saveMode: "prompt", list: false, color: true };
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        switch (arg) {
+            case "-h":
+            case "--help":
+                printHelp();
+                process.exit(0);
+                break;
+            case "-v":
+            case "--version":
+                console.log(readVersion());
+                process.exit(0);
+                break;
+            case "--list":
+                opts.list = true;
+                break;
+            case "--no-color":
+                opts.color = false;
+                break;
+            case "--no-save":
+                opts.saveMode = "off";
+                break;
+            case "--save": {
+                opts.saveMode = "auto";
+                const next = argv[i + 1];
+                if (next && !next.startsWith("-")) {
+                    opts.savePath = next;
+                    i++;
+                }
+                break;
+            }
+            case "--role": {
+                const next = argv[i + 1];
+                if (!next || !VALID_ROLES.includes(next)) {
+                    fail(`--role must be one of: ${VALID_ROLES.filter((r) => r !== "shared").join(", ")}`);
+                }
+                opts.role = next;
+                i++;
+                break;
+            }
+            default:
+                if (arg && arg.startsWith("-")) {
+                    fail(`Unknown option: ${arg}`);
+                }
+                else if (arg) {
+                    opts.mode = arg;
+                }
+        }
+    }
+    return opts;
+}
+function fail(message) {
+    console.error(yellow("think-before: ") + message);
+    console.error(dim("Run `think-before --help` for usage."));
+    process.exit(1);
+}
+async function main() {
+    const opts = parseArgs(process.argv.slice(2));
+    if (!opts.color)
+        setColor(false);
+    const checklist = checklists[opts.mode];
+    if (!checklist) {
+        fail(`Unknown mode: ${opts.mode}. Try "quick" or "full".`);
+    }
+    if (opts.role && opts.mode !== "full") {
+        console.error(dim("note: --role only affects full mode; ignoring it for quick mode.\n"));
+        opts.role = undefined;
+    }
+    const sections = filterSections(checklist, opts.role);
+    if (opts.list) {
+        printList(checklist, sections);
+        return;
+    }
+    const result = await runSession(checklist, sections);
+    printSummary(result);
+    // Nothing to save if the user quit before answering anything.
+    if (result.answers.length === 0)
+        return;
+    await maybeSave(opts, checklist, result);
+    console.log();
+}
+async function maybeSave(opts, checklist, result) {
+    if (opts.saveMode === "off")
+        return;
+    let shouldSave = opts.saveMode === "auto";
+    if (opts.saveMode === "prompt") {
+        console.log();
+        process.stdout.write(dim("Save a Markdown report? ") + dim("[y/N] "));
+        const ans = await askYesNo();
+        process.stdout.write("\n");
+        shouldSave = ans === "yes";
+    }
+    if (!shouldSave)
+        return;
+    const now = new Date();
+    const fileName = opts.savePath ?? defaultReportName(checklist, now);
+    const md = buildMarkdown(checklist, result, now);
+    try {
+        const saved = saveReport(fileName, md);
+        console.log(green("✓ saved ") + saved);
+    }
+    catch (err) {
+        console.error(yellow("Could not save report: ") + err.message);
+    }
+}
+main()
+    .then(() => closeInput())
+    .catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/colors.d.ts

@@ -0,0 +1,12 @@
+/** Force colors on or off (e.g. from a `--no-color` flag). */
+export declare function setColor(on: boolean): void;
+export declare const bold: (s: string) => string;
+export declare const dim: (s: string) => string;
+export declare const red: (s: string) => string;
+export declare const green: (s: string) => string;
+export declare const yellow: (s: string) => string;
+export declare const blue: (s: string) => string;
+export declare const magenta: (s: string) => string;
+export declare const cyan: (s: string) => string;
+export declare const gray: (s: string) => string;
+//# sourceMappingURL=colors.d.ts.map

package/dist/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAKA,8DAA8D;AAC9D,wBAAgB,QAAQ,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAE1C;AAMD,eAAO,MAAM,IAAI,MAJ+B,MAAM,KAAK,MAI5B,CAAC;AAChC,eAAO,MAAM,GAAG,MALgC,MAAM,KAAK,MAK7B,CAAC;AAC/B,eAAO,MAAM,GAAG,MANgC,MAAM,KAAK,MAM5B,CAAC;AAChC,eAAO,MAAM,KAAK,MAP8B,MAAM,KAAK,MAO1B,CAAC;AAClC,eAAO,MAAM,MAAM,MAR6B,MAAM,KAAK,MAQzB,CAAC;AACnC,eAAO,MAAM,IAAI,MAT+B,MAAM,KAAK,MAS3B,CAAC;AACjC,eAAO,MAAM,OAAO,MAV4B,MAAM,KAAK,MAUxB,CAAC;AACpC,eAAO,MAAM,IAAI,MAX+B,MAAM,KAAK,MAW3B,CAAC;AACjC,eAAO,MAAM,IAAI,MAZ+B,MAAM,KAAK,MAY3B,CAAC"}

package/dist/colors.js

@@ -0,0 +1,20 @@
+// Tiny zero-dependency ANSI color helpers. Honors NO_COLOR, non-TTY output,
+// and an explicit `--no-color` flag (via setColor).
+let useColor = Boolean(process.stdout.isTTY) && !process.env["NO_COLOR"];
+/** Force colors on or off (e.g. from a `--no-color` flag). */
+export function setColor(on) {
+    useColor = on;
+}
+function wrap(open, close) {
+    return (s) => (useColor ? `\x1b[${open}m${s}\x1b[${close}m` : s);
+}
+export const bold = wrap(1, 22);
+export const dim = wrap(2, 22);
+export const red = wrap(31, 39);
+export const green = wrap(32, 39);
+export const yellow = wrap(33, 39);
+export const blue = wrap(34, 39);
+export const magenta = wrap(35, 39);
+export const cyan = wrap(36, 39);
+export const gray = wrap(90, 39);
+//# sourceMappingURL=colors.js.map

package/dist/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,oDAAoD;AAEpD,IAAI,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAEzE,8DAA8D;AAC9D,MAAM,UAAU,QAAQ,CAAC,EAAW;IAClC,QAAQ,GAAG,EAAE,CAAC;AAChB,CAAC;AAED,SAAS,IAAI,CAAC,IAAY,EAAE,KAAa;IACvC,OAAO,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/B,MAAM,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AAClC,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AACjC,MAAM,CAAC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./types.js";
+export { quick, full, checklists } from "./checklists.js";
+export { filterSections, runSession } from "./session.js";
+export { askYesNo, closeInput } from "./prompt.js";
+export { buildMarkdown, defaultReportName, printSummary, printList, saveReport } from "./report.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// Public API — import `think-before` programmatically as a library.
+//
+//   import { quick, full, runSession, filterSections, buildMarkdown } from "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 { buildMarkdown, defaultReportName, printSummary, printList, saveReport } from "./report.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +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"}

package/dist/prompt.d.ts

@@ -0,0 +1,16 @@
+import type { AnswerValue } from "./types.js";
+export type AnswerOrQuit = AnswerValue | "quit";
+/**
+ * Ask a single yes/no/skip question and resolve on the first keypress.
+ *
+ *   y → yes      n → no      s / Enter → skip
+ *   ? → print "why this matters" and keep waiting
+ *   q / Esc / Ctrl-C → quit
+ *
+ * Falls back to line input when stdin is not a TTY (piped/CI), so the tool
+ * still works in non-interactive contexts.
+ */
+export declare function askYesNo(why?: string): Promise<AnswerOrQuit>;
+/** 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

@@ -0,0 +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"}

package/dist/prompt.js

@@ -0,0 +1,107 @@
+import readline from "node:readline";
+import { dim } from "./colors.js";
+/**
+ * Ask a single yes/no/skip question and resolve on the first keypress.
+ *
+ *   y → yes      n → no      s / Enter → skip
+ *   ? → print "why this matters" and keep waiting
+ *   q / Esc / Ctrl-C → quit
+ *
+ * Falls back to line input when stdin is not a TTY (piped/CI), so the tool
+ * still works in non-interactive contexts.
+ */
+export function askYesNo(why) {
+    const stdin = process.stdin;
+    if (!stdin.isTTY)
+        return askLine();
+    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 === "y") {
+                cleanup();
+                resolve("yes");
+            }
+            else if (k === "n") {
+                cleanup();
+                resolve("no");
+            }
+            else if (k === "s" || (key && key.name === "return")) {
+                cleanup();
+                resolve("skip");
+            }
+            else if (k === "q" || (key && key.name === "escape")) {
+                cleanup();
+                resolve("quit");
+            }
+            else if (k === "?" && why) {
+                process.stdout.write("\n     " + dim("↳ " + why) + "\n     ");
+            }
+        };
+        stdin.on("keypress", onKey);
+    });
+}
+// --- Non-TTY line reader -------------------------------------------------
+// A single shared readline interface, reused across all questions. Creating
+// one per question drops buffered lines from piped input, so we keep one and
+// hand out lines to waiters in order.
+let lineRl = null;
+const lineQueue = [];
+const waiters = [];
+function ensureLineReader() {
+    if (lineRl)
+        return;
+    lineRl = readline.createInterface({ input: process.stdin });
+    lineRl.on("line", (line) => {
+        const waiter = waiters.shift();
+        if (waiter)
+            waiter(line);
+        else
+            lineQueue.push(line);
+    });
+    lineRl.on("close", () => {
+        while (waiters.length)
+            waiters.shift()?.(null);
+    });
+}
+function readLineOnce() {
+    ensureLineReader();
+    const queued = lineQueue.shift();
+    if (queued !== undefined)
+        return Promise.resolve(queued);
+    return new Promise((resolve) => waiters.push(resolve));
+}
+function askLine() {
+    return readLineOnce().then((line) => {
+        if (line === null)
+            return "quit"; // EOF
+        const k = line.trim().toLowerCase();
+        if (k.startsWith("y"))
+            return "yes";
+        if (k.startsWith("n"))
+            return "no";
+        if (k.startsWith("q"))
+            return "quit";
+        return "skip";
+    });
+}
+/** Release the shared line reader so the process can exit (non-TTY only). */
+export function closeInput() {
+    if (lineRl) {
+        lineRl.close();
+        lineRl = null;
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

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

package/dist/report.d.ts

@@ -0,0 +1,18 @@
+import type { Checklist, RecordedAnswer, Section, SessionResult } from "./types.js";
+export interface SummaryParts {
+    flagged: RecordedAnswer[];
+    skipped: RecordedAnswer[];
+    yes: number;
+    no: number;
+}
+/** Print the end-of-session summary to the terminal. Returns the tallied parts. */
+export declare function printSummary(result: SessionResult): SummaryParts;
+/** A default, sortable report filename for the current moment. */
+export declare function defaultReportName(checklist: Checklist, now: Date): string;
+/** Render a Markdown report of the answers, grouped by section. */
+export declare function buildMarkdown(checklist: Checklist, result: SessionResult, now: Date): string;
+/** Write the report to disk, returning the resolved path. */
+export declare function saveReport(filePath: string, content: string): string;
+/** Print a checklist as plain text (for `--list`) without running a session. */
+export declare function printList(checklist: Checklist, sections: Section[]): void;
+//# sourceMappingURL=report.d.ts.map

package/dist/report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../src/report.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,GAAG,YAAY,CAoChE;AAED,kEAAkE;AAClE,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAIzE;AAQD,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,IAAI,GAAG,MAAM,CAwD5F;AAED,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAazE"}

package/dist/report.js

@@ -0,0 +1,125 @@
+import fs from "node:fs";
+import path from "node:path";
+import { bold, dim, gray, green, red, yellow } from "./colors.js";
+/** Print the end-of-session summary to the terminal. Returns the tallied parts. */
+export function printSummary(result) {
+    const { answers, aborted } = result;
+    const flagged = answers.filter((a) => a.flagged);
+    const skipped = answers.filter((a) => a.value === "skip");
+    const yes = answers.filter((a) => a.value === "yes").length;
+    const no = answers.filter((a) => a.value === "no").length;
+    console.log();
+    console.log(bold("Summary"));
+    if (aborted)
+        console.log(dim("(session ended early — these are the answers you gave)"));
+    console.log("  " +
+        green(`${yes} yes`) + dim(" · ") +
+        red(`${no} no`) + dim(" · ") +
+        gray(`${skipped.length} skipped`) + dim(" · ") +
+        yellow(`${flagged.length} flagged`));
+    if (flagged.length) {
+        console.log();
+        console.log(yellow(bold("⚠ Worth a second look before you start:")));
+        for (const a of flagged) {
+            console.log("  " + yellow("•") + " " + a.question.text);
+            if (a.question.why)
+                console.log("    " + dim(a.question.why));
+        }
+    }
+    else if (!aborted) {
+        console.log();
+        console.log(green("No flags raised — you've thought it through. Go build. ✨"));
+    }
+    if (skipped.length) {
+        console.log();
+        console.log(dim(`${skipped.length} skipped — treat those as open questions, not free passes.`));
+    }
+    return { flagged, skipped, yes, no };
+}
+/** A default, sortable report filename for the current moment. */
+export function defaultReportName(checklist, now) {
+    const p = (n) => String(n).padStart(2, "0");
+    const stamp = `${now.getFullYear()}${p(now.getMonth() + 1)}${p(now.getDate())}-${p(now.getHours())}${p(now.getMinutes())}`;
+    return `think-before-${checklist.id}-${stamp}.md`;
+}
+const MARK = {
+    yes: "[x]",
+    no: "[ ]",
+    skip: "[ ]",
+};
+/** Render a Markdown report of the answers, grouped by section. */
+export function buildMarkdown(checklist, result, now) {
+    const { answers, aborted } = result;
+    const flagged = answers.filter((a) => a.flagged);
+    const skipped = answers.filter((a) => a.value === "skip");
+    const yes = answers.filter((a) => a.value === "yes").length;
+    const no = answers.filter((a) => a.value === "no").length;
+    const lines = [];
+    lines.push(`# think-before — ${checklist.title}`);
+    lines.push("");
+    lines.push(`> Generated ${now.toISOString()}${aborted ? " (session ended early)" : ""}`);
+    lines.push("");
+    lines.push(`**${yes} yes · ${no} no · ${skipped.length} skipped · ${flagged.length} flagged**`);
+    lines.push("");
+    if (flagged.length) {
+        lines.push("## ⚠ Worth a second look");
+        lines.push("");
+        for (const a of flagged) {
+            lines.push(`- **${a.question.text}** — answered _${a.value}_`);
+            if (a.question.why)
+                lines.push(`  - ${a.question.why}`);
+        }
+        lines.push("");
+    }
+    if (skipped.length) {
+        lines.push("## ❓ Open questions (skipped)");
+        lines.push("");
+        for (const a of skipped)
+            lines.push(`- ${a.question.text}`);
+        lines.push("");
+    }
+    lines.push("## All answers");
+    lines.push("");
+    // Group answers back under their section, preserving order.
+    const bySection = new Map();
+    for (const a of answers) {
+        const entry = bySection.get(a.section.id) ?? { section: a.section, items: [] };
+        entry.items.push(a);
+        bySection.set(a.section.id, entry);
+    }
+    for (const { section, items } of bySection.values()) {
+        lines.push(`### ${section.title}`);
+        lines.push("");
+        for (const a of items) {
+            const flag = a.flagged ? " ⚠" : "";
+            const note = a.value === "skip" ? " _(skipped)_" : ` _(${a.value})_`;
+            lines.push(`- ${MARK[a.value]} ${a.question.text}${note}${flag}`);
+        }
+        lines.push("");
+    }
+    return lines.join("\n");
+}
+/** Write the report to disk, returning the resolved path. */
+export function saveReport(filePath, content) {
+    const resolved = path.resolve(process.cwd(), filePath);
+    fs.writeFileSync(resolved, content, "utf8");
+    return resolved;
+}
+/** Print a checklist as plain text (for `--list`) without running a session. */
+export function printList(checklist, sections) {
+    console.log();
+    console.log(bold(checklist.title));
+    if (checklist.intro)
+        console.log(dim(checklist.intro));
+    for (const section of sections) {
+        console.log();
+        console.log("  " + bold(section.title));
+        for (const q of section.questions) {
+            console.log("    - [ ] " + q.text);
+            if (q.why)
+                console.log("          " + dim(q.why));
+        }
+    }
+    console.log();
+}
+//# sourceMappingURL=report.js.map

package/dist/report.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,6 @@
+import type { Checklist, Role, Section, SessionResult } from "./types.js";
+/** Pick the sections relevant to a role. With no role, every section is shown. */
+export declare function filterSections(checklist: Checklist, role?: Role): Section[];
+/** Run a checklist interactively over the given sections, collecting answers. */
+export declare function runSession(checklist: Checklist, sections: Section[]): Promise<SessionResult>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAe,SAAS,EAAkB,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEvG,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,OAAO,EAAE,CAG3E;AAaD,iFAAiF;AACjF,wBAAsB,UAAU,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAiClG"}

package/dist/session.js

@@ -0,0 +1,63 @@
+import { askYesNo } from "./prompt.js";
+import { bold, cyan, dim, gray, green, red, yellow } from "./colors.js";
+/** Pick the sections relevant to a role. With no role, every section is shown. */
+export function filterSections(checklist, role) {
+    if (!role)
+        return checklist.sections;
+    return checklist.sections.filter((s) => s.roles.includes("shared") || s.roles.includes(role));
+}
+function keyHint() {
+    return (dim("Answer fast — ") +
+        cyan("y") + dim(" yes · ") +
+        cyan("n") + dim(" no · ") +
+        cyan("s") + dim(" skip · ") +
+        cyan("?") + dim(" why · ") +
+        cyan("q") + dim(" quit"));
+}
+/** Run a checklist interactively over the given sections, collecting answers. */
+export async function runSession(checklist, sections) {
+    const answers = [];
+    const total = sections.reduce((n, s) => n + s.questions.length, 0);
+    let i = 0;
+    let aborted = false;
+    console.log();
+    console.log(bold(checklist.title));
+    if (checklist.intro)
+        console.log(dim(checklist.intro));
+    console.log(keyHint());
+    outer: for (const section of sections) {
+        console.log();
+        console.log("  " + bold(section.title));
+        for (const q of section.questions) {
+            i++;
+            const counter = gray(`  ${String(i).padStart(2, " ")}/${total}`);
+            process.stdout.write(`${counter} ${q.text} ${dim("[y/n/s] ")}`);
+            const ans = await askYesNo(q.why);
+            if (ans === "quit") {
+                aborted = true;
+                process.stdout.write("\n");
+                break outer;
+            }
+            const flagged = ans === q.risky;
+            answers.push({ question: q, section, value: ans, flagged });
+            printResult(ans, flagged, q.why);
+        }
+    }
+    return { answers, aborted };
+}
+function printResult(ans, flagged, why) {
+    let label;
+    if (ans === "yes")
+        label = green("✓ yes");
+    else if (ans === "no")
+        label = red("✗ no");
+    else
+        label = gray("– skip");
+    let line = label;
+    if (flagged)
+        line += "  " + yellow("⚠ worth a second look");
+    console.log(" " + line);
+    if (flagged && why)
+        console.log("     " + dim("↳ " + why));
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,47 @@
+/** Which answer to a question should raise a flag / warrant a second thought. */
+export type RiskyAnswer = "yes" | "no";
+/** A single yes/no reflection prompt. */
+export interface Question {
+    /** Stable, kebab-case identifier (used in reports). */
+    id: string;
+    /** The question, phrased so that "yes" / "no" is a meaningful answer. */
+    text: string;
+    /** The answer that should be flagged as "worth a second look". */
+    risky: RiskyAnswer;
+    /** Why this matters — shown on `?` during a session and next to flags in the report. */
+    why?: string;
+}
+/** Roles a section applies to. `shared` sections are always shown. */
+export type Role = "shared" | "designer" | "engineer" | "developer";
+/** A titled group of related questions. */
+export interface Section {
+    id: string;
+    title: string;
+    /** Roles this section is relevant to. Include `"shared"` to always show it. */
+    roles: Role[];
+    questions: Question[];
+}
+/** A named, runnable set of sections. */
+export interface Checklist {
+    id: string;
+    title: string;
+    intro?: string;
+    sections: Section[];
+}
+/** A user's answer to one question. */
+export type AnswerValue = "yes" | "no" | "skip";
+/** A recorded answer plus the context needed to report on it. */
+export interface RecordedAnswer {
+    question: Question;
+    section: Section;
+    value: AnswerValue;
+    /** True when `value` matches the question's `risky` answer. */
+    flagged: boolean;
+}
+/** The outcome of running a session. */
+export interface SessionResult {
+    answers: RecordedAnswer[];
+    /** True if the user quit before answering every question. */
+    aborted: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,IAAI,CAAC;AAEvC,yCAAyC;AACzC,MAAM,WAAW,QAAQ;IACvB,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,yEAAyE;IACzE,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,EAAE,WAAW,CAAC;IACnB,wFAAwF;IACxF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,sEAAsE;AACtE,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpE,2CAA2C;AAC3C,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,EAAE,QAAQ,EAAE,CAAC;CACvB;AAED,yCAAyC;AACzC,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,EAAE,CAAC;CACrB;AAED,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;AAEhD,iEAAiE;AACjE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,+DAA+D;IAC/D,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,6DAA6D;IAC7D,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@geekyants/think-before",
+  "version": "0.1.0",
+  "description": "A fast yes/no reflection CLI to surface the side-effects of a change before you make it. Think before you touch the big app.",
+  "type": "module",
+  "bin": {
+    "think-before": "dist/cli.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "npm run build && node dist/cli.js",
+    "start": "node dist/cli.js",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "checklist",
+    "cli",
+    "reflection",
+    "premortem",
+    "code-review",
+    "side-effects",
+    "blast-radius",
+    "developer-tools",
+    "discovery",
+    "yes-no"
+  ],
+  "author": "GeekyAnts",
+  "license": "MIT",
+  "homepage": "https://geekyants.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GeekyAnts/think-before.git"
+  },
+  "bugs": {
+    "url": "https://github.com/GeekyAnts/think-before/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0"
+  }
+}