meto-cli 0.4.0 → 0.7.0

package/CHANGELOG.md

@@ -5,6 +5,37 @@ 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.7.0] - 2026-03-05
+
+### Added
+
+- Doctor command (`meto-cli doctor`) that checks methodology health of a Meto-scaffolded project
+- 7 health checks: required files, context content, board format, epics content, agent definitions, WIP limit, orphan tasks
+- Project root detection by walking up from current directory looking for `ai/tasks/`
+- Scannable report with pass/warn/fail per check and summary line
+- Exit code 1 when any check fails (0 for pass or warnings only)
+
+## [0.6.0] - 2026-03-05
+
+### Added
+
+- 4 new stack presets: Python (FastAPI), Go, Vite + React, Flutter
+- Each preset includes tailored tech-stack description, definition of done, and starter epics
+
+## [0.4.0] - 2026-03-05
+
+### Added
+
+- AI-powered init: when Claude Code is detected, generates product vision, epics, and sliced backlog automatically
+- User answers 5 questions instead of 10 when AI is available
+- `--no-ai` flag to force static prompts even when Claude Code is installed
+- AI generation with 90-second timeout and progress spinner
+- Fallback to static prompts when AI generation fails (timeout, parse error, subprocess crash)
+- Section-delimited AI output parsing with validation
+- AI generation summary note showing what was generated
+- Agent memory files scaffolded for PM, developer, and tester agents
+- Agent Teams support with `.claude/settings.json` and file ownership boundaries
+
 ## [0.1.0] - 2026-03-04
 
 ### Added

package/README.md

@@ -2,7 +2,7 @@
 
 > 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.
+Meto scaffolds structured software projects with built-in methodology. You describe what you want to build, and Meto bootstraps a project with AI-generated epics, a sliced backlog, agent definitions, product context, and coding conventions -- ready for your first Claude Code session.
 
 ![demo](https://raw.githubusercontent.com/iLomer/Metho_agentic/main/assets/demo.gif)
 
@@ -14,23 +14,45 @@ Meto scaffolds structured software projects with built-in methodology. You descr
 npx meto-cli init
 ```
 
-Answer a few questions about your project, and Meto generates a fully structured repository in seconds.
+Answer a few questions, and Meto generates a fully structured repository in seconds -- with AI-powered content if Claude Code is installed.
 
 ---
 
-## What Just Happened?
+## How It Works
 
-After running `meto-cli init`, your new project comes pre-loaded with everything you need to start building with discipline:
+Meto detects whether Claude Code is installed on your machine and offers two paths:
 
-- **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
-- **Agent Teams ready** -- three agents configured to work in parallel with file ownership boundaries
-- **Token optimized** -- generated files are optimized for token consumption with Claude Code, so every session gets more productive output per dollar spent
+**With Claude Code (AI-powered):**
+1. You answer 5 questions -- project name, description, target users, tech stack, output directory
+2. Claude Code generates your product vision, problem statement, epics, and a sliced backlog with acceptance criteria
+3. Meto renders everything into a structured project ready for your first sprint
+
+**Without Claude Code (static):**
+1. You answer 10 questions -- the 5 above plus problem statement, success criteria, value proposition, out of scope, and code conventions
+2. Meto renders your answers into the same structured project with sensible defaults
+
+Both paths produce the same project structure. The AI path just fills in more content so you spend less time on setup and more time building.
+
+Use `--no-ai` to force the static path even when Claude Code is available.
+
+---
+
+## Stack Presets
 
-No more hours of manual setup. No more "I forgot to write the CLAUDE.md." It is all there from the start.
+Choose from 7 built-in tech stacks, each with a tailored description, definition of done, and starter epics:
+
+| Stack | What you get |
+|---|---|
+| **Next.js + Supabase** | Full-stack web app with auth, database, and edge functions |
+| **React Native** | Cross-platform mobile app |
+| **Node.js CLI** | Command-line tool distributed via npm |
+| **Python (FastAPI)** | REST API with async support, auto-generated docs |
+| **Go** | Compiled backend service or CLI tool |
+| **Vite + React** | Client-side SPA with fast dev server |
+| **Flutter** | Cross-platform mobile and web app with Dart |
+| **Custom** | Describe your own stack |
+
+Each preset populates your tech-stack description, definition of done (with stack-specific checks), and starter epics so your backlog has real structure from day one.
 
 ---
 
@@ -70,6 +92,15 @@ your-project/
 └── CLAUDE.md
 ```
 
+**What's inside:**
+- **CLAUDE.md** -- project instructions that Claude Code reads every session, pre-filled with your vision, stack, and conventions
+- **Kanban board** -- 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
+- **Agent memory** -- persistent memory files so agents retain context across sessions
+- **Product context** -- vision, tech stack, and decisions captured in structured files
+- **Epics and workflows** -- definition of done, commit conventions, and an epic backlog to plan against
+- **Agent Teams ready** -- three agents configured to work in parallel with file ownership boundaries
+
 ---
 
 ## Agent Teams
@@ -86,10 +117,6 @@ Meto scaffolds projects ready for Agent Teams out of the box:
 
 > "Create an agent team with @meto-pm for planning, @meto-developer for building, @meto-tester for validation"
 
-**Display modes:** use Shift+Down to cycle between agents in-process, or run each agent in its own split pane (tmux/iTerm2).
-
-This feature is experimental and enabled via `.claude/settings.json` in the scaffold.
-
 ---
 
 ## Next Steps
@@ -107,8 +134,8 @@ This feature is experimental and enabled via `.claude/settings.json` in the scaf
 | 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 |
+| git | any | Recommended -- Meto initializes a repository if git is available |
+| Claude Code | latest | Optional -- enables AI-powered generation. Without it, Meto uses static prompts |
 
 ---
 
@@ -116,7 +143,8 @@ This feature is experimental and enabled via `.claude/settings.json` in the scaf
 
 | Command | Description |
 |---|---|
-| `meto-cli init` | Scaffold a new structured project |
+| `meto-cli init` | Scaffold a new structured project (AI-powered if Claude Code is detected) |
+| `meto-cli init --no-ai` | Scaffold using static prompts only, skip AI generation |
 | `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 |

package/dist/cli/doctor-checks.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Result of a single health check performed by the doctor command.
+ */
+export interface HealthCheckResult {
+    /** Human-readable name of the check */
+    name: string;
+    /** Whether the check passed, produced a warning, or failed */
+    status: "pass" | "warn" | "fail";
+    /** Descriptive message explaining the result */
+    message: string;
+}
+/**
+ * Extracts all task slice identifiers (e.g. "slice-001") from a markdown file's
+ * ## [slice-NNN] headings.
+ */
+export declare function extractSliceIds(content: string): string[];
+/**
+ * Check 1: Required files exist.
+ * Each required file that is missing produces a "fail" result.
+ */
+export declare function checkRequiredFiles(projectRoot: string): Promise<HealthCheckResult[]>;
+/**
+ * Check 2: Context files are not empty.
+ * Files with 2 or fewer lines of content produce a "warn" result.
+ */
+export declare function checkContextFilesNotEmpty(projectRoot: string): Promise<HealthCheckResult[]>;
+/**
+ * Check 3: Board files start with a # heading.
+ */
+export declare function checkBoardFileFormat(projectRoot: string): Promise<HealthCheckResult[]>;
+/**
+ * Check 4: Epics file has content (at least one ## E heading).
+ */
+export declare function checkEpicsFileHasContent(projectRoot: string): Promise<HealthCheckResult[]>;
+/**
+ * Check 5: Agent definitions exist in .claude/agents/.
+ */
+export declare function checkAgentDefinitions(projectRoot: string): Promise<HealthCheckResult[]>;
+/**
+ * Check 6: In-progress limit (max 1 task in tasks-in-progress.md).
+ */
+export declare function checkInProgressLimit(projectRoot: string): Promise<HealthCheckResult[]>;
+/**
+ * Check 7: No orphan tasks (tasks in in-progress or in-testing must exist in backlog).
+ */
+export declare function checkNoOrphanTasks(projectRoot: string): Promise<HealthCheckResult[]>;
+/**
+ * Runs all methodology health checks against the given project root.
+ * Returns an array of check results -- one per individual check.
+ */
+export declare function runHealthChecks(projectRoot: string): Promise<HealthCheckResult[]>;
+//# sourceMappingURL=doctor-checks.d.ts.map

package/dist/cli/doctor-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor-checks.d.ts","sourceRoot":"","sources":["../../src/cli/doctor-checks.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACjC,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;CACjB;AAsED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CASzD;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAqB9B;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA2B9B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA2B9B;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAyB9B;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAoC9B;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA4B9B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CA+D9B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAmB9B"}

package/dist/cli/doctor-checks.js

@@ -0,0 +1,331 @@
+import { readFile, readdir, access } from "node:fs/promises";
+import { join } from "node:path";
+/**
+ * Files that must exist in every Meto-scaffolded project.
+ */
+const REQUIRED_FILES = [
+    "CLAUDE.md",
+    "ai/context/product-vision.md",
+    "ai/context/tech-stack.md",
+    "ai/context/decisions.md",
+    "ai/backlog/epics.md",
+    "ai/tasks/tasks-backlog.md",
+    "ai/tasks/tasks-todo.md",
+    "ai/tasks/tasks-in-progress.md",
+    "ai/tasks/tasks-in-testing.md",
+    "ai/tasks/tasks-done.md",
+    "ai/workflows/definition-of-done.md",
+];
+/**
+ * Context files that should have meaningful content (more than 2 lines).
+ */
+const CONTEXT_FILES = [
+    "ai/context/product-vision.md",
+    "ai/context/tech-stack.md",
+];
+/**
+ * Board files that should start with a # heading.
+ */
+const BOARD_FILES = [
+    "ai/tasks/tasks-backlog.md",
+    "ai/tasks/tasks-todo.md",
+    "ai/tasks/tasks-in-progress.md",
+    "ai/tasks/tasks-in-testing.md",
+    "ai/tasks/tasks-done.md",
+];
+/**
+ * Agent definition files that must exist in .claude/agents/.
+ */
+const REQUIRED_AGENTS = [
+    "pm-agent.md",
+    "developer-agent.md",
+    "tester-agent.md",
+];
+/**
+ * Checks whether a file exists at the given path.
+ */
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Safely reads a file, returning undefined if the file does not exist.
+ */
+async function safeReadFile(filePath) {
+    try {
+        return await readFile(filePath, "utf-8");
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Extracts all task slice identifiers (e.g. "slice-001") from a markdown file's
+ * ## [slice-NNN] headings.
+ */
+export function extractSliceIds(content) {
+    const matches = content.match(/## \[slice-\d+\]/g);
+    if (matches === null) {
+        return [];
+    }
+    return matches.map((m) => {
+        const idMatch = /\[slice-\d+\]/.exec(m);
+        return idMatch ? idMatch[0] : "";
+    }).filter((id) => id.length > 0);
+}
+/**
+ * Check 1: Required files exist.
+ * Each required file that is missing produces a "fail" result.
+ */
+export async function checkRequiredFiles(projectRoot) {
+    const results = [];
+    for (const file of REQUIRED_FILES) {
+        const exists = await fileExists(join(projectRoot, file));
+        if (exists) {
+            results.push({
+                name: `Required file: ${file}`,
+                status: "pass",
+                message: "File exists",
+            });
+        }
+        else {
+            results.push({
+                name: `Required file: ${file}`,
+                status: "fail",
+                message: `Missing required file: ${file}`,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Check 2: Context files are not empty.
+ * Files with 2 or fewer lines of content produce a "warn" result.
+ */
+export async function checkContextFilesNotEmpty(projectRoot) {
+    const results = [];
+    for (const file of CONTEXT_FILES) {
+        const content = await safeReadFile(join(projectRoot, file));
+        if (content === undefined) {
+            // File missing is caught by checkRequiredFiles; skip here
+            continue;
+        }
+        const lines = content.split("\n").filter((line) => line.trim().length > 0);
+        if (lines.length > 2) {
+            results.push({
+                name: `Content check: ${file}`,
+                status: "pass",
+                message: "File has meaningful content",
+            });
+        }
+        else {
+            results.push({
+                name: `Content check: ${file}`,
+                status: "warn",
+                message: `${file} has ${lines.length} non-empty lines -- expected more than 2`,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Check 3: Board files start with a # heading.
+ */
+export async function checkBoardFileFormat(projectRoot) {
+    const results = [];
+    for (const file of BOARD_FILES) {
+        const content = await safeReadFile(join(projectRoot, file));
+        if (content === undefined) {
+            // File missing is caught by checkRequiredFiles; skip here
+            continue;
+        }
+        const firstLine = content.trimStart().split("\n")[0];
+        if (firstLine.startsWith("# ")) {
+            results.push({
+                name: `Board format: ${file}`,
+                status: "pass",
+                message: "File starts with a heading",
+            });
+        }
+        else {
+            results.push({
+                name: `Board format: ${file}`,
+                status: "warn",
+                message: `${file} does not start with a # heading`,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Check 4: Epics file has content (at least one ## E heading).
+ */
+export async function checkEpicsFileHasContent(projectRoot) {
+    const content = await safeReadFile(join(projectRoot, "ai/backlog/epics.md"));
+    if (content === undefined) {
+        // File missing is caught by checkRequiredFiles; skip here
+        return [];
+    }
+    const hasEpicHeading = /## E/.test(content);
+    if (hasEpicHeading) {
+        return [
+            {
+                name: "Epics file content",
+                status: "pass",
+                message: "Epics file contains at least one epic",
+            },
+        ];
+    }
+    return [
+        {
+            name: "Epics file content",
+            status: "warn",
+            message: "epics.md does not contain any ## E headings",
+        },
+    ];
+}
+/**
+ * Check 5: Agent definitions exist in .claude/agents/.
+ */
+export async function checkAgentDefinitions(projectRoot) {
+    const results = [];
+    const agentsDir = join(projectRoot, ".claude", "agents");
+    let agentFiles;
+    try {
+        agentFiles = await readdir(agentsDir);
+    }
+    catch {
+        // Directory doesn't exist -- all agents are missing
+        for (const agent of REQUIRED_AGENTS) {
+            results.push({
+                name: `Agent definition: ${agent}`,
+                status: "fail",
+                message: `Missing agent definition: .claude/agents/${agent}`,
+            });
+        }
+        return results;
+    }
+    for (const agent of REQUIRED_AGENTS) {
+        if (agentFiles.includes(agent)) {
+            results.push({
+                name: `Agent definition: ${agent}`,
+                status: "pass",
+                message: "Agent definition exists",
+            });
+        }
+        else {
+            results.push({
+                name: `Agent definition: ${agent}`,
+                status: "fail",
+                message: `Missing agent definition: .claude/agents/${agent}`,
+            });
+        }
+    }
+    return results;
+}
+/**
+ * Check 6: In-progress limit (max 1 task in tasks-in-progress.md).
+ */
+export async function checkInProgressLimit(projectRoot) {
+    const content = await safeReadFile(join(projectRoot, "ai/tasks/tasks-in-progress.md"));
+    if (content === undefined) {
+        return [];
+    }
+    const sliceIds = extractSliceIds(content);
+    const count = sliceIds.length;
+    if (count <= 1) {
+        return [
+            {
+                name: "WIP limit",
+                status: "pass",
+                message: `${count} task(s) in progress`,
+            },
+        ];
+    }
+    return [
+        {
+            name: "WIP limit",
+            status: "warn",
+            message: `WIP limit exceeded: ${count} tasks in progress, expected max 1.`,
+        },
+    ];
+}
+/**
+ * Check 7: No orphan tasks (tasks in in-progress or in-testing must exist in backlog).
+ */
+export async function checkNoOrphanTasks(projectRoot) {
+    const backlogContent = await safeReadFile(join(projectRoot, "ai/tasks/tasks-backlog.md"));
+    const inProgressContent = await safeReadFile(join(projectRoot, "ai/tasks/tasks-in-progress.md"));
+    const inTestingContent = await safeReadFile(join(projectRoot, "ai/tasks/tasks-in-testing.md"));
+    if (backlogContent === undefined) {
+        return [];
+    }
+    const backlogIds = extractSliceIds(backlogContent);
+    const activeTasks = [];
+    if (inProgressContent !== undefined) {
+        for (const id of extractSliceIds(inProgressContent)) {
+            activeTasks.push({ id, source: "tasks-in-progress.md" });
+        }
+    }
+    if (inTestingContent !== undefined) {
+        for (const id of extractSliceIds(inTestingContent)) {
+            activeTasks.push({ id, source: "tasks-in-testing.md" });
+        }
+    }
+    if (activeTasks.length === 0) {
+        return [
+            {
+                name: "Orphan tasks",
+                status: "pass",
+                message: "No active tasks to check",
+            },
+        ];
+    }
+    const results = [];
+    let hasOrphan = false;
+    for (const task of activeTasks) {
+        if (!backlogIds.includes(task.id)) {
+            hasOrphan = true;
+            results.push({
+                name: `Orphan task: ${task.id}`,
+                status: "warn",
+                message: `${task.id} in ${task.source} has no matching entry in tasks-backlog.md`,
+            });
+        }
+    }
+    if (!hasOrphan) {
+        results.push({
+            name: "Orphan tasks",
+            status: "pass",
+            message: "All active tasks have backlog entries",
+        });
+    }
+    return results;
+}
+/**
+ * Runs all methodology health checks against the given project root.
+ * Returns an array of check results -- one per individual check.
+ */
+export async function runHealthChecks(projectRoot) {
+    const allResults = [];
+    const checkFunctions = [
+        checkRequiredFiles,
+        checkContextFilesNotEmpty,
+        checkBoardFileFormat,
+        checkEpicsFileHasContent,
+        checkAgentDefinitions,
+        checkInProgressLimit,
+        checkNoOrphanTasks,
+    ];
+    for (const checkFn of checkFunctions) {
+        const results = await checkFn(projectRoot);
+        allResults.push(...results);
+    }
+    return allResults;
+}
+//# sourceMappingURL=doctor-checks.js.map

package/dist/cli/doctor-checks.js.map

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

package/dist/cli/doctor.d.ts

@@ -0,0 +1,19 @@
+import type { HealthCheckResult } from "./doctor-checks.js";
+/**
+ * Searches upward from the given starting directory for a Meto project root.
+ * A Meto project root is identified by the presence of an `ai/tasks/` directory.
+ *
+ * Returns the absolute path to the project root, or undefined if not found.
+ */
+export declare function findProjectRoot(startDir: string): Promise<string | undefined>;
+/**
+ * Determines the exit code based on health check results.
+ * Returns 0 if no failures (warnings are OK), 1 if any check failed.
+ */
+export declare function determineExitCode(results: HealthCheckResult[]): number;
+/**
+ * Entry point for the `meto-cli doctor` command.
+ * Detects the project root, runs health checks, and displays a report.
+ */
+export declare function runDoctor(): Promise<void>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAoB7B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAGtE;AA2BD;;;GAGG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA6B/C"}

package/dist/cli/doctor.js

@@ -0,0 +1,87 @@
+import { access } from "node:fs/promises";
+import { join, dirname, resolve } from "node:path";
+import * as p from "@clack/prompts";
+import { runHealthChecks } from "./doctor-checks.js";
+/**
+ * Searches upward from the given starting directory for a Meto project root.
+ * A Meto project root is identified by the presence of an `ai/tasks/` directory.
+ *
+ * Returns the absolute path to the project root, or undefined if not found.
+ */
+export async function findProjectRoot(startDir) {
+    let current = resolve(startDir);
+    // eslint-disable-next-line no-constant-condition
+    while (true) {
+        const candidate = join(current, "ai", "tasks");
+        try {
+            await access(candidate);
+            return current;
+        }
+        catch {
+            // ai/tasks/ not found at this level, move up
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            // Reached filesystem root without finding a project
+            return undefined;
+        }
+        current = parent;
+    }
+}
+/**
+ * Determines the exit code based on health check results.
+ * Returns 0 if no failures (warnings are OK), 1 if any check failed.
+ */
+export function determineExitCode(results) {
+    const hasFail = results.some((r) => r.status === "fail");
+    return hasFail ? 1 : 0;
+}
+/**
+ * Formats and displays health check results using clack output functions.
+ */
+function displayResults(results) {
+    for (const result of results) {
+        switch (result.status) {
+            case "pass":
+                p.log.success(result.name);
+                break;
+            case "warn":
+                p.log.warning(`${result.name}: ${result.message}`);
+                break;
+            case "fail":
+                p.log.error(`${result.name}: ${result.message}`);
+                break;
+        }
+    }
+    const passed = results.filter((r) => r.status === "pass").length;
+    const warnings = results.filter((r) => r.status === "warn").length;
+    const failed = results.filter((r) => r.status === "fail").length;
+    p.note(`${passed} passed, ${warnings} warnings, ${failed} failed`, "Summary");
+}
+/**
+ * Entry point for the `meto-cli doctor` command.
+ * Detects the project root, runs health checks, and displays a report.
+ */
+export async function runDoctor() {
+    p.intro("meto-cli doctor");
+    const projectRoot = await findProjectRoot(process.cwd());
+    if (projectRoot === undefined) {
+        p.log.error("No Meto project found. Run this command from within a Meto-scaffolded project.");
+        p.outro("");
+        process.exit(1);
+    }
+    p.log.info(`Meto project detected at ${projectRoot}`);
+    const results = await runHealthChecks(projectRoot);
+    displayResults(results);
+    const exitCode = determineExitCode(results);
+    if (exitCode === 0) {
+        p.outro("All checks passed.");
+    }
+    else {
+        p.outro("Some checks failed. Review the issues above.");
+    }
+    if (exitCode !== 0) {
+        process.exit(exitCode);
+    }
+}
+//# sourceMappingURL=doctor.js.map