meto-cli 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,24 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [0.1.0] - 2026-03-04
+
+### Added
+
+- CLI scaffold command (`meto-cli init`) that bootstraps a structured project with methodology built in
+- 10 interactive prompts collecting project brief (name, description, target users, tech stack, problem statement, success criteria, value proposition, out of scope, code conventions, output directory)
+- 3 stack presets: Next.js + Supabase, React Native, Node.js CLI
+- Custom stack option with free-text input
+- Stack-aware Definition of Done generated per project
+- Dry-run mode (`meto-cli init --dry-run`) to preview scaffold output without writing files
+- Pre-flight checks: Node.js version validation (>= 18), git availability detection, write permission verification
+- Git repository initialization with initial commit after scaffold
+- SIGINT cleanup handler that removes partial scaffold on interruption
+- Post-scaffold next steps guidance with conditional git init reminder
+- Template rendering engine with token replacement (`{{TOKEN}}` format)
+- File tree visualization for dry-run output
+- `--help` and `--version` flags

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 iLomer
+
+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,106 @@
+# Meto
+
+> Lovable gives you an app. Meto gives you a project -- built the right way, your way.
+
+Meto scaffolds structured software projects with built-in methodology. You describe what you want to build, and Meto bootstraps a project with a kanban board, agent definitions, product context, and coding conventions -- ready for your first Claude Code session.
+
+<!-- TODO: Record demo GIF and replace this -->
+![demo](assets/demo.gif)
+
+---
+
+## Quick Start
+
+```bash
+npx meto-cli init
+```
+
+Answer a few questions about your project, and Meto generates a fully structured repository in seconds.
+
+---
+
+## What Just Happened?
+
+After running `meto-cli init`, your new project comes pre-loaded with everything you need to start building with discipline:
+
+- **CLAUDE.md** -- a project instruction file that Claude Code reads every session, pre-filled with your vision, stack, and conventions
+- **Kanban board** -- a task pipeline (backlog, todo, in-progress, testing, done) ready for your first sprint
+- **Agent definitions** -- PM, developer, and tester agents configured to follow your methodology from day one
+- **Product context** -- your vision, tech stack, and decisions captured in structured files so every session starts with shared context
+- **Epics and workflows** -- definition of done, commit conventions, and an epic backlog to plan against
+- **Token optimized** -- generated files are optimized for token consumption with Claude Code, so every session gets more productive output per dollar spent
+
+No more hours of manual setup. No more "I forgot to write the CLAUDE.md." It is all there from the start.
+
+---
+
+## What You Get
+
+```
+your-project/
+├── .claude/
+│   ├── agents/
+│   │   ├── developer-agent.md
+│   │   ├── pm-agent.md
+│   │   └── tester-agent.md
+│   └── agent-memory/
+│       ├── meto-developer/MEMORY.md
+│       ├── meto-pm/MEMORY.md
+│       └── meto-tester/MEMORY.md
+├── ai/
+│   ├── backlog/
+│   │   └── epics.md
+│   ├── context/
+│   │   ├── decisions.md
+│   │   ├── product-vision.md
+│   │   ├── tech-stack.md
+│   │   └── test-log.md
+│   ├── tasks/
+│   │   ├── tasks-backlog.md
+│   │   ├── tasks-done.md
+│   │   ├── tasks-in-progress.md
+│   │   ├── tasks-in-testing.md
+│   │   └── tasks-todo.md
+│   └── workflows/
+│       ├── commit-conventions.md
+│       └── definition-of-done.md
+├── src/
+├── .gitignore
+└── CLAUDE.md
+```
+
+---
+
+## Next Steps
+
+1. `cd your-project`
+2. Open the project in your editor
+3. Start a Claude Code session and call `@meto-pm` to populate your backlog
+4. Pick your first task and start building
+
+---
+
+## Prerequisites
+
+| Requirement | Version | Notes |
+|---|---|---|
+| Node.js | >= 18 | Required to run the CLI |
+| git | any | Recommended -- Meto will initialize a repository if git is available |
+| Claude Code | latest | For the generated project to work with agents |
+
+---
+
+## CLI Reference
+
+| Command | Description |
+|---|---|
+| `meto-cli init` | Scaffold a new structured project |
+| `meto-cli init --dry-run` | Preview the generated file tree without writing to disk |
+| `meto-cli --help` | Show available commands and options |
+| `meto-cli --version` | Show the installed version |
+
+---
+
+## License
+
+MIT

package/dist/cli/git.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Initializes a git repository in the output directory and creates
+ * an initial commit with all scaffolded files.
+ *
+ * Assumes the .gitignore has already been written as part of the
+ * template rendering step.
+ *
+ * @param outputDir - The scaffolded project directory
+ */
+export declare function initGitRepo(outputDir: string): Promise<void>;
+//# sourceMappingURL=git.d.ts.map

package/dist/cli/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/cli/git.ts"],"names":[],"mappings":"AAoBA;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASlE"}

package/dist/cli/git.js

@@ -0,0 +1,34 @@
+import { execFile } from "node:child_process";
+import { resolve } from "node:path";
+/**
+ * Executes a git command in the specified directory.
+ * Returns a promise that resolves with stdout or rejects with an error.
+ */
+function runGit(args, cwd) {
+    return new Promise((promiseResolve, promiseReject) => {
+        execFile("git", args, { cwd }, (error, stdout, stderr) => {
+            if (error) {
+                const message = stderr.trim() || error.message;
+                promiseReject(new Error(`git ${args[0]}: ${message}`));
+                return;
+            }
+            promiseResolve(stdout.trim());
+        });
+    });
+}
+/**
+ * Initializes a git repository in the output directory and creates
+ * an initial commit with all scaffolded files.
+ *
+ * Assumes the .gitignore has already been written as part of the
+ * template rendering step.
+ *
+ * @param outputDir - The scaffolded project directory
+ */
+export async function initGitRepo(outputDir) {
+    const absoluteDir = resolve(outputDir);
+    await runGit(["init"], absoluteDir);
+    await runGit(["add", "-A"], absoluteDir);
+    await runGit(["commit", "-m", "chore(scaffold): initialize project [bootstrap]"], absoluteDir);
+}
+//# sourceMappingURL=git.js.map

package/dist/cli/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/cli/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,SAAS,MAAM,CAAC,IAAc,EAAE,GAAW;IACzC,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE;QACnD,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACvD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,OAAO,CAAC;gBAC/C,aAAa,CAAC,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC;gBACvD,OAAO;YACT,CAAC;YACD,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAiB;IACjD,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEvC,MAAM,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC;IACpC,MAAM,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,WAAW,CAAC,CAAC;IACzC,MAAM,MAAM,CACV,CAAC,QAAQ,EAAE,IAAI,EAAE,iDAAiD,CAAC,EACnE,WAAW,CACZ,CAAC;AACJ,CAAC"}

package/dist/cli/github.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Result of the GitHub post-scaffold flow.
+ * Contains information about whether a repo was created and its URL.
+ */
+export interface GitHubResult {
+    /** Whether a GitHub repository was successfully created. */
+    repoCreated: boolean;
+    /** The URL of the created repository, if any. */
+    repoUrl: string | undefined;
+}
+/**
+ * Checks whether the GitHub CLI (`gh`) is installed by running `gh --version`.
+ * Resolves to true if `gh` is found, false otherwise.
+ */
+export declare function checkGhInstalled(): Promise<boolean>;
+/**
+ * Checks whether the GitHub CLI is authenticated by running `gh auth status`.
+ * Resolves to true if the user is logged in, false otherwise.
+ */
+export declare function checkGhAuthenticated(): Promise<boolean>;
+/**
+ * Runs the post-scaffold GitHub repository creation flow.
+ *
+ * Checks for `gh` CLI installation and authentication, then optionally
+ * creates a new GitHub repository. Returns a result indicating whether
+ * a repo was created and its URL.
+ *
+ * This function is a no-op if `gitAvailable` is false (git was skipped).
+ *
+ * @param projectName - The project name (used as the repo name)
+ * @param outputDir - The scaffolded project directory
+ * @param gitAvailable - Whether git is available on the system
+ */
+export declare function runGitHubFlow(projectName: string, outputDir: string, gitAvailable: boolean): Promise<GitHubResult>;
+//# sourceMappingURL=github.d.ts.map

package/dist/cli/github.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"github.d.ts","sourceRoot":"","sources":["../../src/cli/github.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,WAAW,EAAE,OAAO,CAAC;IACrB,iDAAiD;IACjD,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAMnD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC,CAMvD;AA6CD;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,YAAY,CAAC,CA2DvB"}

package/dist/cli/github.js

@@ -0,0 +1,117 @@
+import { execFile } from "node:child_process";
+import { resolve } from "node:path";
+import * as p from "@clack/prompts";
+/**
+ * Checks whether the GitHub CLI (`gh`) is installed by running `gh --version`.
+ * Resolves to true if `gh` is found, false otherwise.
+ */
+export function checkGhInstalled() {
+    return new Promise((promiseResolve) => {
+        execFile("gh", ["--version"], (error) => {
+            promiseResolve(error === null);
+        });
+    });
+}
+/**
+ * Checks whether the GitHub CLI is authenticated by running `gh auth status`.
+ * Resolves to true if the user is logged in, false otherwise.
+ */
+export function checkGhAuthenticated() {
+    return new Promise((promiseResolve) => {
+        execFile("gh", ["auth", "status"], (error) => {
+            promiseResolve(error === null);
+        });
+    });
+}
+/**
+ * Creates a GitHub repository using the `gh` CLI.
+ * Returns the repository URL on success.
+ *
+ * @param projectName - The name for the new repository
+ * @param visibility - Whether the repo should be "public" or "private"
+ * @param cwd - The local directory containing the git repo
+ */
+function createGhRepo(projectName, visibility, cwd) {
+    const absoluteCwd = resolve(cwd);
+    const visibilityFlag = visibility === "public" ? "--public" : "--private";
+    return new Promise((promiseResolve, promiseReject) => {
+        execFile("gh", [
+            "repo",
+            "create",
+            projectName,
+            visibilityFlag,
+            "--source",
+            ".",
+            "--remote",
+            "origin",
+            "--push",
+        ], { cwd: absoluteCwd }, (error, stdout, stderr) => {
+            if (error) {
+                const message = stderr.trim() || error.message;
+                promiseReject(new Error(message));
+                return;
+            }
+            promiseResolve(stdout.trim());
+        });
+    });
+}
+/**
+ * Runs the post-scaffold GitHub repository creation flow.
+ *
+ * Checks for `gh` CLI installation and authentication, then optionally
+ * creates a new GitHub repository. Returns a result indicating whether
+ * a repo was created and its URL.
+ *
+ * This function is a no-op if `gitAvailable` is false (git was skipped).
+ *
+ * @param projectName - The project name (used as the repo name)
+ * @param outputDir - The scaffolded project directory
+ * @param gitAvailable - Whether git is available on the system
+ */
+export async function runGitHubFlow(projectName, outputDir, gitAvailable) {
+    const noResult = { repoCreated: false, repoUrl: undefined };
+    if (!gitAvailable) {
+        return noResult;
+    }
+    const ghInstalled = await checkGhInstalled();
+    if (!ghInstalled) {
+        p.log.info("GitHub CLI not found. Install it to create repos from the terminal: https://cli.github.com");
+        return noResult;
+    }
+    const ghAuthenticated = await checkGhAuthenticated();
+    if (!ghAuthenticated) {
+        p.log.info("GitHub CLI found but not logged in. Run `gh auth login` to connect your account.");
+        return noResult;
+    }
+    const shouldCreate = await p.confirm({
+        message: "Create a GitHub repository for this project?",
+        initialValue: true,
+    });
+    if (p.isCancel(shouldCreate) || !shouldCreate) {
+        return noResult;
+    }
+    const visibility = await p.select({
+        message: "Repository visibility?",
+        options: [
+            { value: "private", label: "Private", hint: "only you can see it" },
+            { value: "public", label: "Public", hint: "anyone can see it" },
+        ],
+    });
+    if (p.isCancel(visibility)) {
+        return noResult;
+    }
+    const ghSpinner = p.spinner();
+    ghSpinner.start("Creating GitHub repository...");
+    try {
+        const repoUrl = await createGhRepo(projectName, visibility, outputDir);
+        ghSpinner.stop(`Repository created: ${repoUrl}`);
+        return { repoCreated: true, repoUrl };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        ghSpinner.stop(`GitHub repo creation failed: ${message}`);
+        p.log.warning("The project was scaffolded successfully. You can create a GitHub repo manually later.");
+        return noResult;
+    }
+}
+//# sourceMappingURL=github.js.map

package/dist/cli/github.js.map

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

package/dist/cli/index.d.ts

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

package/dist/cli/index.d.ts.map

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

package/dist/cli/index.js

@@ -0,0 +1,192 @@
+#!/usr/bin/env node
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import * as p from "@clack/prompts";
+import { collectProjectBrief } from "./prompts.js";
+import { InterruptionHandler } from "./interruption.js";
+import { buildTokenMap, renderTemplates, resolveTemplatesDir, } from "./renderer.js";
+import { runGitHubFlow } from "./github.js";
+import { initGitRepo } from "./git.js";
+import { runSupabaseFlow } from "./supabase.js";
+import { checkWritePermission, PreflightError, runPreflightChecks, } from "./preflight.js";
+import { DirectoryNotEmptyError, writeScaffold } from "./scaffold.js";
+import { formatFileTree } from "./tree.js";
+/**
+ * Resolves the absolute path to the package root directory.
+ * At runtime: dist/cli/index.js -> package root is ../../
+ */
+function resolvePackageRoot() {
+    const currentFileUrl = new URL(import.meta.url);
+    const packageRoot = new URL("../../", currentFileUrl);
+    return decodeURIComponent(packageRoot.pathname);
+}
+/**
+ * Reads the version string from package.json at the package root.
+ */
+async function readVersion() {
+    const packageJsonPath = join(resolvePackageRoot(), "package.json");
+    const raw = await readFile(packageJsonPath, "utf-8");
+    const parsed = JSON.parse(raw);
+    if (typeof parsed === "object" &&
+        parsed !== null &&
+        "version" in parsed &&
+        typeof parsed.version === "string") {
+        return parsed.version;
+    }
+    return "unknown";
+}
+/**
+ * Prints usage information for the CLI.
+ */
+function printHelp() {
+    p.intro("meto-cli -- methodology-first project scaffolding");
+    p.note([
+        "Usage: meto-cli <command> [options]",
+        "",
+        "Commands:",
+        "  init              Scaffold a new structured project",
+        "  init --dry-run    Preview files without writing to disk",
+        "",
+        "Options:",
+        "  --help, -h        Show this help message",
+        "  --version, -v     Show the installed version",
+    ].join("\n"), "Help");
+    p.outro("Run 'meto-cli init' to get started.");
+}
+async function main() {
+    const arg = process.argv[2];
+    if (arg === "--help" || arg === "-h" || arg === undefined) {
+        printHelp();
+        return;
+    }
+    if (arg === "--version" || arg === "-v") {
+        const version = await readVersion();
+        p.intro(`meto-cli v${version}`);
+        p.outro("");
+        return;
+    }
+    if (arg === "init") {
+        const dryRun = process.argv.includes("--dry-run");
+        const interruption = new InterruptionHandler();
+        interruption.install();
+        p.intro("meto-cli -- methodology-first project scaffolding");
+        let preflight;
+        try {
+            preflight = await runPreflightChecks();
+        }
+        catch (error) {
+            if (error instanceof PreflightError) {
+                p.log.error(error.message);
+            }
+            else if (error instanceof Error) {
+                p.log.error(`Pre-flight check failed: ${error.message}`);
+            }
+            else {
+                p.log.error("An unexpected error occurred during pre-flight checks.");
+            }
+            interruption.uninstall();
+            process.exit(1);
+        }
+        if (!preflight.gitAvailable) {
+            p.log.warning("git not found -- the scaffolded project will not be initialized as a git repository.");
+        }
+        const brief = await collectProjectBrief();
+        const writeError = await checkWritePermission(brief.outputDirectory);
+        if (writeError !== undefined) {
+            p.log.error(writeError);
+            interruption.uninstall();
+            process.exit(1);
+        }
+        const stackLabel = brief.techStack === "custom"
+            ? brief.customStack
+            : brief.techStack;
+        p.note([
+            `Project:    ${brief.projectName}`,
+            `Desc:       ${brief.description}`,
+            `Users:      ${brief.targetUsers}`,
+            `Stack:      ${stackLabel}`,
+            `Output:     ${brief.outputDirectory}`,
+        ].join("\n"), "Project Brief");
+        const s = p.spinner();
+        s.start("Rendering templates...");
+        try {
+            const templatesDir = resolveTemplatesDir();
+            const tokens = buildTokenMap(brief);
+            const renderedFiles = await renderTemplates(templatesDir, tokens);
+            if (dryRun) {
+                s.stop("Templates rendered (dry run).");
+                const filePaths = renderedFiles.map((f) => f.relativePath);
+                const tree = formatFileTree(filePaths);
+                p.note(tree, "Files that would be created");
+                p.log.info(`Total files: ${renderedFiles.length}`);
+                p.outro("Dry run complete. No files were written.");
+                interruption.uninstall();
+                return;
+            }
+            interruption.arm(brief.outputDirectory);
+            await writeScaffold(brief.outputDirectory, renderedFiles);
+            interruption.disarm();
+            s.stop("Scaffold generated.");
+            let gitInitSucceeded = false;
+            if (preflight.gitAvailable) {
+                const gitSpinner = p.spinner();
+                gitSpinner.start("Initializing git repository...");
+                try {
+                    await initGitRepo(brief.outputDirectory);
+                    gitSpinner.stop("Git repository initialized.");
+                    gitInitSucceeded = true;
+                }
+                catch {
+                    gitSpinner.stop("Git initialization failed -- skipping.");
+                }
+            }
+            const githubResult = await runGitHubFlow(brief.projectName, brief.outputDirectory, gitInitSucceeded);
+            const supabaseResult = await runSupabaseFlow(brief.techStack, brief.outputDirectory);
+            const nextSteps = [
+                `cd ${brief.outputDirectory}`,
+                "Open in your editor",
+                "Type `claude` to start a session (if Claude Code is already installed)",
+                "Install Claude Code if you haven't: https://docs.anthropic.com/en/docs/claude-code",
+                "Call @meto-pm to populate your backlog",
+            ];
+            if (githubResult.repoCreated && githubResult.repoUrl) {
+                nextSteps.push(`GitHub repo: ${githubResult.repoUrl}`);
+            }
+            if (brief.techStack === "nextjs-supabase") {
+                if (supabaseResult.initialized) {
+                    nextSteps.push("Run `supabase start` to launch the local development stack");
+                }
+                nextSteps.push("Copy the local credentials from `supabase status` into `.env.local`");
+            }
+            if (!preflight.gitAvailable) {
+                nextSteps.push("Run `git init` when git is available");
+            }
+            p.note(nextSteps.join("\n"), "Next Steps");
+            p.outro("Done. Happy building!");
+        }
+        catch (error) {
+            s.stop("Failed.");
+            interruption.disarm();
+            if (error instanceof DirectoryNotEmptyError) {
+                p.log.error(error.message);
+            }
+            else if (error instanceof Error) {
+                p.log.error(`Scaffold generation failed: ${error.message}`);
+            }
+            else {
+                p.log.error("An unexpected error occurred during scaffold generation.");
+            }
+            interruption.uninstall();
+            process.exit(1);
+        }
+        interruption.uninstall();
+        return;
+    }
+    p.intro("meto-cli -- methodology-first project scaffolding");
+    p.log.error(`Unknown command: ${arg}`);
+    p.log.info("Run 'meto-cli --help' to see available commands.");
+    p.outro("");
+    process.exit(1);
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/interruption.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Manages SIGINT cleanup during scaffold writing.
+ *
+ * When armed with an output directory, a SIGINT will remove that directory
+ * and print a cleanup message. When not armed, SIGINT exits cleanly
+ * (the default behavior from clack's prompt cancellation).
+ */
+export declare class InterruptionHandler {
+    private outputDir;
+    private readonly boundHandler;
+    constructor();
+    /**
+     * Registers the SIGINT handler.
+     */
+    install(): void;
+    /**
+     * Removes the SIGINT handler.
+     */
+    uninstall(): void;
+    /**
+     * Arms the handler with the output directory that should be cleaned up
+     * if SIGINT is received. Call this just before scaffold writing begins.
+     */
+    arm(outputDirectory: string): void;
+    /**
+     * Disarms the handler. Call this after scaffold writing completes
+     * successfully so that a late SIGINT does not remove the user's project.
+     */
+    disarm(): void;
+    private handleInterrupt;
+}
+//# sourceMappingURL=interruption.d.ts.map

package/dist/cli/interruption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interruption.d.ts","sourceRoot":"","sources":["../../src/cli/interruption.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;;IAS1C;;OAEG;IACH,OAAO,IAAI,IAAI;IAIf;;OAEG;IACH,SAAS,IAAI,IAAI;IAIjB;;;OAGG;IACH,GAAG,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI;IAIlC;;;OAGG;IACH,MAAM,IAAI,IAAI;IAId,OAAO,CAAC,eAAe;CAmBxB"}