meto-cli 0.1.0

package/dist/cli/stacks.d.ts

@@ -0,0 +1,40 @@
+import type { TechStack } from "./types.js";
+/**
+ * Returns a structured markdown description for the selected tech stack.
+ *
+ * For preset stacks, returns a detailed table-formatted description with
+ * layers, choices, and reasons. For custom stacks, returns the user's
+ * free-text input under a "Custom Stack" heading.
+ *
+ * @param stack - The selected tech stack preset
+ * @param customStack - The user's free-text stack description (when stack is "custom")
+ * @returns Formatted markdown string describing the stack
+ */
+export declare function getStackDescription(stack: TechStack, customStack?: string): string;
+/**
+ * Returns the Definition of Done criteria for the selected tech stack.
+ *
+ * For preset stacks, returns stack-specific criteria including universal
+ * checks and technology-specific quality gates. For custom stacks,
+ * returns universal checks with a placeholder for stack-specific items.
+ *
+ * @param stack - The selected tech stack preset
+ * @param customStack - The user's free-text stack description (when stack is "custom")
+ * @returns Formatted markdown string with Definition of Done checklist
+ */
+export declare function getDefinitionOfDone(stack: TechStack, customStack?: string): string;
+/**
+ * Returns starter epics for the selected tech stack.
+ *
+ * For preset stacks, returns stack-specific epics with realistic goals.
+ * For custom stacks, returns generic but useful epics. Each epic includes
+ * a goal, status (not started), and a note that tasks should be sliced
+ * by the PM agent.
+ *
+ * @param stack - The selected tech stack preset
+ * @param projectName - The project name (used in the heading)
+ * @param customStack - The user's free-text stack description (when stack is "custom")
+ * @returns Formatted markdown string with starter epics
+ */
+export declare function getStarterEpics(stack: TechStack, projectName: string, customStack?: string): string;
+//# sourceMappingURL=stacks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stacks.d.ts","sourceRoot":"","sources":["../../src/cli/stacks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAyP5C;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAOR;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,EAChB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAQR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,EAChB,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAYR"}

package/dist/cli/stacks.js

@@ -0,0 +1,294 @@
+/**
+ * Structured description for the Next.js + Supabase stack.
+ */
+const NEXTJS_SUPABASE_DESCRIPTION = `## Stack Overview
+
+| Layer | Choice | Reason |
+|---|---|---|
+| UI | Next.js (React) | Server-side rendering, file-based routing, API routes built-in |
+| API | Next.js API Routes | Co-located with frontend, serverless-ready |
+| Database | Supabase (PostgreSQL) | Managed Postgres with real-time subscriptions and auto-generated APIs |
+| Auth | Supabase Auth | Built-in email/password, OAuth providers, row-level security |
+| Hosting | Vercel | Zero-config Next.js deploys, edge functions, preview deployments |
+
+## Key Libraries
+- **Tailwind CSS** -- utility-first styling
+- **TypeScript** -- strict mode throughout`;
+/**
+ * Structured description for the React Native stack.
+ */
+const REACT_NATIVE_DESCRIPTION = `## Stack Overview
+
+| Layer | Choice | Reason |
+|---|---|---|
+| UI | React Native | Cross-platform iOS and Android from a single codebase |
+| Navigation | React Navigation | Industry-standard navigation library with native feel |
+| State | Zustand or Redux Toolkit | Lightweight state management with TypeScript support |
+| Backend | Supabase or custom API | Flexible backend choice depending on project needs |
+
+## Key Libraries
+- **Expo** -- managed workflow for faster development
+- **TypeScript** -- strict mode throughout`;
+/**
+ * Structured description for the Node.js CLI stack.
+ */
+const NODEJS_CLI_DESCRIPTION = `## Stack Overview
+
+| Layer | Choice | Reason |
+|---|---|---|
+| Runtime | Node.js | Ubiquitous JavaScript runtime with rich ecosystem |
+| Language | TypeScript | Type safety and better developer experience |
+| Distribution | npm | Standard package distribution, supports npx for zero-install usage |
+| Prompts | @clack/prompts | Beautiful terminal UI with spinners, selects, and validation |
+
+## Key Libraries
+- **commander or yargs** -- argument parsing (if needed)
+- **vitest** -- fast TypeScript-native testing`;
+const STACK_DESCRIPTIONS = {
+    "nextjs-supabase": NEXTJS_SUPABASE_DESCRIPTION,
+    "react-native": REACT_NATIVE_DESCRIPTION,
+    "nodejs-cli": NODEJS_CLI_DESCRIPTION,
+};
+/**
+ * Definition of Done criteria for the Next.js + Supabase stack.
+ */
+const NEXTJS_SUPABASE_DOD = `## Universal Checks
+- [ ] TypeScript compiles with no errors (\`npx tsc --noEmit\`)
+- [ ] No \`any\` types in changed files
+- [ ] No \`console.log\` in committed code
+- [ ] No commented-out code in committed files
+- [ ] Error states handled (loading, empty, error UI)
+
+## Stack-Specific Checks
+- [ ] Supabase migrations applied and tested locally
+- [ ] Environment variables documented in \`.env.example\`
+- [ ] Responsive on mobile (tested at 375px width minimum)
+- [ ] API routes return proper HTTP status codes
+- [ ] Row-level security policies reviewed for new tables`;
+/**
+ * Definition of Done criteria for the React Native stack.
+ */
+const REACT_NATIVE_DOD = `## Universal Checks
+- [ ] TypeScript compiles with no errors (\`npx tsc --noEmit\`)
+- [ ] No \`any\` types in changed files
+- [ ] No \`console.log\` in committed code
+- [ ] No commented-out code in committed files
+- [ ] Error states handled (loading, empty, error UI)
+
+## Stack-Specific Checks
+- [ ] Runs on iOS simulator without crash
+- [ ] Runs on Android emulator without crash
+- [ ] Navigation works (forward, back, deep links if applicable)
+- [ ] No hardcoded dimensions (use responsive units)
+- [ ] Keyboard does not obscure input fields`;
+/**
+ * Definition of Done criteria for the Node.js CLI stack.
+ */
+const NODEJS_CLI_DOD = `## Universal Checks
+- [ ] TypeScript compiles with no errors (\`npx tsc --noEmit\`)
+- [ ] No \`any\` types in changed files
+- [ ] No \`console.log\` in committed code
+- [ ] No commented-out code in committed files
+- [ ] Error states handled (graceful error messages, no stack traces for users)
+
+## Stack-Specific Checks
+- [ ] Help text present and accurate (\`--help\`)
+- [ ] Exit codes correct (0 for success, 1 for errors)
+- [ ] Unit tests pass (\`npm test\`)
+- [ ] CLI runs without crash on a clean install (\`npx\`)
+- [ ] No hardcoded file paths (use platform-agnostic path resolution)`;
+/**
+ * Definition of Done criteria for a custom stack.
+ */
+const CUSTOM_STACK_DOD = `## Universal Checks
+- [ ] TypeScript compiles with no errors (\`npx tsc --noEmit\`)
+- [ ] No \`any\` types in changed files
+- [ ] No \`console.log\` in committed code
+- [ ] No commented-out code in committed files
+- [ ] Error states handled
+
+## Stack-Specific Checks
+*Add stack-specific checks here based on your chosen technology.*`;
+const STACK_DODS = {
+    "nextjs-supabase": NEXTJS_SUPABASE_DOD,
+    "react-native": REACT_NATIVE_DOD,
+    "nodejs-cli": NODEJS_CLI_DOD,
+};
+/**
+ * Starter epics for the Next.js + Supabase stack.
+ */
+const NEXTJS_SUPABASE_EPICS = `## E1 -- Project Setup
+**Goal:** Initialize the Next.js app with Tailwind CSS, configure Supabase client, and establish the development environment.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm
+
+---
+
+## E2 -- Auth
+**Goal:** Implement sign up, sign in, and sign out using Supabase Auth with row-level security.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm
+
+---
+
+## E3 -- Core Feature
+**Goal:** Build the primary feature of the application. To be defined by @meto-pm based on the product vision.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm
+
+---
+
+## E4 -- Deploy
+**Goal:** Deploy to Vercel, configure custom domain, and set up environment variables for production.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm`;
+/**
+ * Starter epics for the React Native stack.
+ */
+const REACT_NATIVE_EPICS = `## E1 -- Project Setup
+**Goal:** Initialize the Expo project with React Navigation and configure the development environment.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm
+
+---
+
+## E2 -- Auth
+**Goal:** Implement authentication (sign up, sign in, sign out) with secure token storage.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm
+
+---
+
+## E3 -- Core Feature
+**Goal:** Build the primary feature of the application. To be defined by @meto-pm based on the product vision.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm
+
+---
+
+## E4 -- App Store Prep
+**Goal:** Prepare the app for App Store and Play Store submission including icons, splash screen, and metadata.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm`;
+/**
+ * Starter epics for the Node.js CLI stack.
+ */
+const NODEJS_CLI_EPICS = `## E1 -- CLI Scaffold
+**Goal:** Set up the CLI entry point with help text, version flag, and argument parsing.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm
+
+---
+
+## E2 -- Core Command
+**Goal:** Implement the primary command that delivers the core value of the CLI tool.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm
+
+---
+
+## E3 -- Testing + CI
+**Goal:** Add unit tests, integration tests, and configure continuous integration.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm
+
+---
+
+## E4 -- npm Publish
+**Goal:** Prepare for npm publication including package.json metadata, README, and publish workflow.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm`;
+/**
+ * Starter epics for a custom stack.
+ */
+const CUSTOM_STACK_EPICS = `## E1 -- Project Setup
+**Goal:** Initialize the project structure, install dependencies, and configure the development environment.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm
+
+---
+
+## E2 -- Core Feature
+**Goal:** Build the primary feature of the application. To be defined by @meto-pm based on the product vision.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm
+
+---
+
+## E3 -- Testing
+**Goal:** Add unit tests and integration tests to ensure quality and enable confident refactoring.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm
+
+---
+
+## E4 -- Deploy
+**Goal:** Set up deployment pipeline and ship the first version to production.
+**Status:** Not started
+**Tasks:** To be sliced by @meto-pm`;
+const STACK_EPICS = {
+    "nextjs-supabase": NEXTJS_SUPABASE_EPICS,
+    "react-native": REACT_NATIVE_EPICS,
+    "nodejs-cli": NODEJS_CLI_EPICS,
+};
+/**
+ * Returns a structured markdown description for the selected tech stack.
+ *
+ * For preset stacks, returns a detailed table-formatted description with
+ * layers, choices, and reasons. For custom stacks, returns the user's
+ * free-text input under a "Custom Stack" heading.
+ *
+ * @param stack - The selected tech stack preset
+ * @param customStack - The user's free-text stack description (when stack is "custom")
+ * @returns Formatted markdown string describing the stack
+ */
+export function getStackDescription(stack, customStack) {
+    if (stack === "custom") {
+        const description = customStack ?? "Custom stack -- details to be defined";
+        return `## Custom Stack\n\n${description}`;
+    }
+    return STACK_DESCRIPTIONS[stack];
+}
+/**
+ * Returns the Definition of Done criteria for the selected tech stack.
+ *
+ * For preset stacks, returns stack-specific criteria including universal
+ * checks and technology-specific quality gates. For custom stacks,
+ * returns universal checks with a placeholder for stack-specific items.
+ *
+ * @param stack - The selected tech stack preset
+ * @param customStack - The user's free-text stack description (when stack is "custom")
+ * @returns Formatted markdown string with Definition of Done checklist
+ */
+export function getDefinitionOfDone(stack, customStack) {
+    if (stack === "custom") {
+        return customStack !== undefined
+            ? `${CUSTOM_STACK_DOD}\n\n> Custom stack: ${customStack}`
+            : CUSTOM_STACK_DOD;
+    }
+    return STACK_DODS[stack];
+}
+/**
+ * Returns starter epics for the selected tech stack.
+ *
+ * For preset stacks, returns stack-specific epics with realistic goals.
+ * For custom stacks, returns generic but useful epics. Each epic includes
+ * a goal, status (not started), and a note that tasks should be sliced
+ * by the PM agent.
+ *
+ * @param stack - The selected tech stack preset
+ * @param projectName - The project name (used in the heading)
+ * @param customStack - The user's free-text stack description (when stack is "custom")
+ * @returns Formatted markdown string with starter epics
+ */
+export function getStarterEpics(stack, projectName, customStack) {
+    const heading = `# Epics -- ${projectName}\n\nHigh-level orientation. Full task definitions live in \`tasks-backlog.md\`.\nGenerated by Meto based on stack selection. Refine with @meto-pm.\n\n---\n\n`;
+    if (stack === "custom") {
+        const note = customStack !== undefined
+            ? `\n\n---\n\n> Custom stack: ${customStack}. Adjust epics to match your technology choices.`
+            : "";
+        return heading + CUSTOM_STACK_EPICS + note;
+    }
+    return heading + STACK_EPICS[stack];
+}
+//# sourceMappingURL=stacks.js.map

package/dist/cli/stacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacks.js","sourceRoot":"","sources":["../../src/cli/stacks.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,2BAA2B,GAAG;;;;;;;;;;;;2CAYO,CAAC;AAE5C;;GAEG;AACH,MAAM,wBAAwB,GAAG;;;;;;;;;;;2CAWU,CAAC;AAE5C;;GAEG;AACH,MAAM,sBAAsB,GAAG;;;;;;;;;;;+CAWgB,CAAC;AAEhD,MAAM,kBAAkB,GAAiD;IACvE,iBAAiB,EAAE,2BAA2B;IAC9C,cAAc,EAAE,wBAAwB;IACxC,YAAY,EAAE,sBAAsB;CACrC,CAAC;AAEF;;GAEG;AACH,MAAM,mBAAmB,GAAG;;;;;;;;;;;;0DAY8B,CAAC;AAE3D;;GAEG;AACH,MAAM,gBAAgB,GAAG;;;;;;;;;;;;6CAYoB,CAAC;AAE9C;;GAEG;AACH,MAAM,cAAc,GAAG;;;;;;;;;;;;sEAY+C,CAAC;AAEvE;;GAEG;AACH,MAAM,gBAAgB,GAAG;;;;;;;;kEAQyC,CAAC;AAEnE,MAAM,UAAU,GAAiD;IAC/D,iBAAiB,EAAE,mBAAmB;IACtC,cAAc,EAAE,gBAAgB;IAChC,YAAY,EAAE,cAAc;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;oCAwBM,CAAC;AAErC;;GAEG;AACH,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;oCAwBS,CAAC;AAErC;;GAEG;AACH,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;oCAwBW,CAAC;AAErC;;GAEG;AACH,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;oCAwBS,CAAC;AAErC,MAAM,WAAW,GAAiD;IAChE,iBAAiB,EAAE,qBAAqB;IACxC,cAAc,EAAE,kBAAkB;IAClC,YAAY,EAAE,gBAAgB;CAC/B,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAgB,EAChB,WAAoB;IAEpB,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,MAAM,WAAW,GAAG,WAAW,IAAI,uCAAuC,CAAC;QAC3E,OAAO,sBAAsB,WAAW,EAAE,CAAC;IAC7C,CAAC;IAED,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,KAAgB,EAChB,WAAoB;IAEpB,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,OAAO,WAAW,KAAK,SAAS;YAC9B,CAAC,CAAC,GAAG,gBAAgB,uBAAuB,WAAW,EAAE;YACzD,CAAC,CAAC,gBAAgB,CAAC;IACvB,CAAC;IAED,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAgB,EAChB,WAAmB,EACnB,WAAoB;IAEpB,MAAM,OAAO,GAAG,cAAc,WAAW,+JAA+J,CAAC;IAEzM,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,GACR,WAAW,KAAK,SAAS;YACvB,CAAC,CAAC,8BAA8B,WAAW,kDAAkD;YAC7F,CAAC,CAAC,EAAE,CAAC;QACT,OAAO,OAAO,GAAG,kBAAkB,GAAG,IAAI,CAAC;IAC7C,CAAC;IAED,OAAO,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC"}

package/dist/cli/supabase.d.ts

@@ -0,0 +1,24 @@
+import type { TechStack } from "./types.js";
+/**
+ * Result of the Supabase post-scaffold flow.
+ */
+export interface SupabaseResult {
+    /** Whether Supabase was initialized in the project. */
+    initialized: boolean;
+}
+/**
+ * Checks whether the Supabase CLI is installed by running `supabase --version`.
+ * Resolves to true if `supabase` is found, false otherwise.
+ */
+export declare function checkSupabaseInstalled(): Promise<boolean>;
+/**
+ * Runs the post-scaffold Supabase setup flow.
+ *
+ * Only runs when the selected stack is "nextjs-supabase". Checks for the
+ * Supabase CLI, and if found, offers to run `supabase init` in the project.
+ *
+ * @param techStack - The user's selected tech stack
+ * @param outputDir - The scaffolded project directory
+ */
+export declare function runSupabaseFlow(techStack: TechStack, outputDir: string): Promise<SupabaseResult>;
+//# sourceMappingURL=supabase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../../src/cli/supabase.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAAC,OAAO,CAAC,CAMzD;AA0BD;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACnC,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,CAAC,CAyCzB"}

package/dist/cli/supabase.js

@@ -0,0 +1,72 @@
+import { execFile } from "node:child_process";
+import { resolve } from "node:path";
+import * as p from "@clack/prompts";
+/**
+ * Checks whether the Supabase CLI is installed by running `supabase --version`.
+ * Resolves to true if `supabase` is found, false otherwise.
+ */
+export function checkSupabaseInstalled() {
+    return new Promise((promiseResolve) => {
+        execFile("supabase", ["--version"], (error) => {
+            promiseResolve(error === null);
+        });
+    });
+}
+/**
+ * Runs `supabase init` in the specified directory.
+ * Returns a promise that resolves on success or rejects with an error.
+ */
+function runSupabaseInit(cwd) {
+    const absoluteCwd = resolve(cwd);
+    return new Promise((promiseResolve, promiseReject) => {
+        execFile("supabase", ["init"], { 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 Supabase setup flow.
+ *
+ * Only runs when the selected stack is "nextjs-supabase". Checks for the
+ * Supabase CLI, and if found, offers to run `supabase init` in the project.
+ *
+ * @param techStack - The user's selected tech stack
+ * @param outputDir - The scaffolded project directory
+ */
+export async function runSupabaseFlow(techStack, outputDir) {
+    const noResult = { initialized: false };
+    if (techStack !== "nextjs-supabase") {
+        return noResult;
+    }
+    const installed = await checkSupabaseInstalled();
+    if (!installed) {
+        p.log.info("Supabase CLI not found. Install it to manage your database locally: https://supabase.com/docs/guides/cli/getting-started");
+        return noResult;
+    }
+    const shouldInit = await p.confirm({
+        message: "Initialize Supabase in this project?",
+        initialValue: true,
+    });
+    if (p.isCancel(shouldInit) || !shouldInit) {
+        return noResult;
+    }
+    const supabaseSpinner = p.spinner();
+    supabaseSpinner.start("Initializing Supabase...");
+    try {
+        await runSupabaseInit(outputDir);
+        supabaseSpinner.stop("Supabase initialized. Run `supabase start` to launch the local development stack.");
+        return { initialized: true };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Unknown error";
+        supabaseSpinner.stop(`Supabase initialization failed: ${message}`);
+        p.log.warning("The project was scaffolded successfully. You can run `supabase init` manually later.");
+        return noResult;
+    }
+}
+//# sourceMappingURL=supabase.js.map

package/dist/cli/supabase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase.js","sourceRoot":"","sources":["../../src/cli/supabase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAWpC;;;GAGG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,EAAE;QACpC,QAAQ,CAAC,UAAU,EAAE,CAAC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5C,cAAc,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEjC,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,aAAa,EAAE,EAAE;QACnD,QAAQ,CACN,UAAU,EACV,CAAC,MAAM,CAAC,EACR,EAAE,GAAG,EAAE,WAAW,EAAE,EACpB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACxB,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,CAAC,CAAC,CAAC;gBAClC,OAAO;YACT,CAAC;YACD,cAAc,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAChC,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAoB,EACpB,SAAiB;IAEjB,MAAM,QAAQ,GAAmB,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAExD,IAAI,SAAS,KAAK,iBAAiB,EAAE,CAAC;QACpC,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,sBAAsB,EAAE,CAAC;IACjD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,CAAC,CAAC,GAAG,CAAC,IAAI,CACR,0HAA0H,CAC3H,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,OAAO,CAAC;QACjC,OAAO,EAAE,sCAAsC;QAC/C,YAAY,EAAE,IAAI;KACnB,CAAC,CAAC;IAEH,IAAI,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;QAC1C,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,eAAe,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IACpC,eAAe,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAElD,IAAI,CAAC;QACH,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;QACjC,eAAe,CAAC,IAAI,CAClB,mFAAmF,CACpF,CAAC;QACF,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,eAAe,CAAC,IAAI,CAAC,mCAAmC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC,CAAC,GAAG,CAAC,OAAO,CACX,sFAAsF,CACvF,CAAC;QACF,OAAO,QAAQ,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/cli/tree.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Formats a list of relative file paths into a tree-view string.
+ * The output uses box-drawing characters to show hierarchy.
+ *
+ * @param paths - Array of relative file paths (using "/" as separator)
+ * @returns Formatted tree string
+ */
+export declare function formatFileTree(paths: string[]): string;
+//# sourceMappingURL=tree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/cli/tree.ts"],"names":[],"mappings":"AAgEA;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAmBtD"}

package/dist/cli/tree.js

@@ -0,0 +1,70 @@
+/**
+ * Builds a tree structure from a list of file paths.
+ * Paths are split on "/" to create nested directory nodes.
+ */
+function buildTree(paths) {
+    const root = { name: "", children: new Map() };
+    for (const filePath of paths) {
+        const parts = filePath.split("/");
+        let current = root;
+        for (const part of parts) {
+            if (!current.children.has(part)) {
+                current.children.set(part, { name: part, children: new Map() });
+            }
+            current = current.children.get(part);
+        }
+    }
+    return root;
+}
+/**
+ * Recursively formats a tree node into indented text lines.
+ * Uses box-drawing characters for visual structure.
+ */
+function formatNode(node, prefix, isLast, lines) {
+    const connector = isLast ? "└── " : "├── ";
+    const extension = isLast ? "    " : "│   ";
+    if (node.name !== "") {
+        lines.push(`${prefix}${connector}${node.name}`);
+    }
+    const children = Array.from(node.children.values()).sort((a, b) => {
+        const aIsDir = a.children.size > 0;
+        const bIsDir = b.children.size > 0;
+        if (aIsDir && !bIsDir)
+            return -1;
+        if (!aIsDir && bIsDir)
+            return 1;
+        return a.name.localeCompare(b.name);
+    });
+    const childPrefix = node.name === "" ? "" : prefix + extension;
+    for (let i = 0; i < children.length; i++) {
+        const isChildLast = i === children.length - 1;
+        formatNode(children[i], childPrefix, isChildLast, lines);
+    }
+}
+/**
+ * Formats a list of relative file paths into a tree-view string.
+ * The output uses box-drawing characters to show hierarchy.
+ *
+ * @param paths - Array of relative file paths (using "/" as separator)
+ * @returns Formatted tree string
+ */
+export function formatFileTree(paths) {
+    const normalizedPaths = paths.map((p) => p.replace(/\\/g, "/"));
+    const root = buildTree(normalizedPaths);
+    const lines = [];
+    const children = Array.from(root.children.values()).sort((a, b) => {
+        const aIsDir = a.children.size > 0;
+        const bIsDir = b.children.size > 0;
+        if (aIsDir && !bIsDir)
+            return -1;
+        if (!aIsDir && bIsDir)
+            return 1;
+        return a.name.localeCompare(b.name);
+    });
+    for (let i = 0; i < children.length; i++) {
+        const isLast = i === children.length - 1;
+        formatNode(children[i], "", isLast, lines);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=tree.js.map

package/dist/cli/tree.js.map

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

package/dist/cli/types.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Tech stack presets available during project scaffolding.
+ */
+export type TechStack = "nextjs-supabase" | "react-native" | "nodejs-cli" | "custom";
+/**
+ * The brief collected from the user during `meto-cli init`.
+ * Contains everything needed to render templates and scaffold a project.
+ */
+export interface ProjectBrief {
+    /** Kebab-case project name, used as directory name and package name */
+    projectName: string;
+    /** One-line description of what the project does */
+    description: string;
+    /** Who the project is for */
+    targetUsers: string;
+    /** Selected tech stack preset or "custom" */
+    techStack: TechStack;
+    /** Free-text stack description when techStack is "custom" */
+    customStack: string | undefined;
+    /** What problem this project solves */
+    problemStatement: string;
+    /** How success is measured */
+    successCriteria: string;
+    /** Core value proposition in one line */
+    valueProposition: string;
+    /** What is explicitly out of scope for v1 */
+    outOfScope: string;
+    /** Project-specific code conventions and standards */
+    codeConventions: string;
+    /** Absolute or relative path where the scaffold will be written */
+    outputDirectory: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,iBAAiB,GACjB,cAAc,GACd,YAAY,GACZ,QAAQ,CAAC;AAEb;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,uEAAuE;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,6CAA6C;IAC7C,SAAS,EAAE,SAAS,CAAC;IACrB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,8BAA8B;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,yCAAyC;IACzC,gBAAgB,EAAE,MAAM,CAAC;IACzB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,mEAAmE;IACnE,eAAe,EAAE,MAAM,CAAC;CACzB"}

package/dist/cli/types.js

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

package/dist/cli/types.js.map

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

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "meto-cli",
+  "version": "0.1.0",
+  "description": "Scaffold structured software projects with built-in methodology",
+  "type": "module",
+  "bin": {
+    "meto-cli": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist/",
+    "templates/",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "scaffold",
+    "cli",
+    "methodology",
+    "agile",
+    "project-generator"
+  ],
+  "author": "iLomer",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/iLomer/Metho_agentic.git"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.0.18"
+  }
+}

package/templates/.claude/agent-memory/lom-developer/MEMORY.md

@@ -0,0 +1,20 @@
+# Developer Agent Memory — {{PROJECT_NAME}}
+
+*Read at session start. Update at session end. Keep it concise.*
+
+---
+
+## Codebase Map
+[Key files, components, and where things live — built up over time]
+
+## Patterns Established
+[Naming conventions, component patterns, API patterns in this codebase]
+
+## Known Issues
+[Bugs or tech debt flagged but not yet sliced — don't fix inline, note here]
+
+## Watch Out For
+[Things that caused bugs, gotchas in this codebase]
+
+## Last Session
+[What was built, what state was left in, anything in-flight]