meto-cli 0.7.6 → 0.9.0

package/dist/cli/status.js

@@ -0,0 +1,129 @@
+import { access, readFile } from "node:fs/promises";
+import { join } from "node:path";
+import * as p from "@clack/prompts";
+import { findProjectRoot } from "./doctor.js";
+import { parseSwarmAwareness } from "./swarm-parser.js";
+/**
+ * Checks whether the SWARM_AWARENESS.md file exists at the given project root.
+ */
+export async function swarmFileExists(projectRoot) {
+    try {
+        await access(join(projectRoot, "ai", "swarm", "SWARM_AWARENESS.md"));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Calculates the number of days between a start date string and now.
+ * Returns the string "unknown" if the date cannot be parsed.
+ */
+function formatDuration(started) {
+    const startDate = new Date(started);
+    if (isNaN(startDate.getTime())) {
+        return "unknown duration";
+    }
+    const now = new Date();
+    const diffMs = now.getTime() - startDate.getTime();
+    const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+    if (diffDays === 0) {
+        return "started today";
+    }
+    if (diffDays === 1) {
+        return "1 day";
+    }
+    return `${diffDays} days`;
+}
+/**
+ * Renders the epic list, one line per epic with the appropriate clack log level.
+ */
+function displayEpics(epics) {
+    if (epics.length === 0) {
+        p.log.warning("No epics found in swarm state.");
+        return;
+    }
+    for (const epic of epics) {
+        const line = `${epic.id} -- ${epic.name}   [${epic.status}]  ${epic.tasksDone} tasks done`;
+        switch (epic.status) {
+            case "complete":
+                p.log.success(line);
+                break;
+            case "on-track":
+                p.log.info(line);
+                break;
+            case "blocked":
+                p.log.error(line);
+                break;
+            case "not-started":
+                p.log.warning(line);
+                break;
+        }
+    }
+}
+/**
+ * Renders the blockers section.
+ */
+function displayBlockers(epics) {
+    const blocked = epics.filter((e) => e.status === "blocked");
+    if (blocked.length === 0) {
+        p.log.success("No blockers");
+        return;
+    }
+    for (const epic of blocked) {
+        p.log.error(`${epic.id} blocker: ${epic.blocker}`);
+    }
+}
+/**
+ * Renders the conflicts section (only if there are pending conflicts).
+ */
+function displayConflicts(state) {
+    const pending = state.conflicts.filter((c) => c.resolution === "pending");
+    if (pending.length === 0) {
+        return;
+    }
+    for (const conflict of pending) {
+        p.log.warning(`Conflict: ${conflict.file} -- ${conflict.agents} [${conflict.resolution}]`);
+    }
+}
+/**
+ * Formats and displays the full swarm status dashboard.
+ */
+export function displayDashboard(state) {
+    const duration = formatDuration(state.meta.started);
+    p.note([
+        `Project: ${state.meta.projectName}`,
+        `Mode: ${state.meta.mode}`,
+        `Duration: ${duration}`,
+    ].join("\n"), "Swarm Dashboard");
+    displayEpics(state.epics);
+    p.note(`${state.meta.acPassed} of ${state.meta.acTotal} passed`, "Acceptance Criteria");
+    displayBlockers(state.epics);
+    displayConflicts(state);
+}
+/**
+ * Entry point for the `meto-cli status` command.
+ * Detects the project root, verifies swarm mode, parses SWARM_AWARENESS.md,
+ * and displays the dashboard.
+ */
+export async function runStatus() {
+    p.intro("meto-cli status");
+    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);
+    }
+    const hasSwarmFile = await swarmFileExists(projectRoot);
+    if (!hasSwarmFile) {
+        p.log.error("This project is not using swarm mode. Run 'meto-cli init' with Swarm workflow to enable.");
+        p.outro("");
+        process.exit(1);
+    }
+    const swarmPath = join(projectRoot, "ai", "swarm", "SWARM_AWARENESS.md");
+    const content = await readFile(swarmPath, "utf-8");
+    const state = parseSwarmAwareness(content);
+    displayDashboard(state);
+    p.outro("Status complete.");
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/status.js.map

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

package/dist/cli/swarm-parser.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Parsed swarm metadata from the [swarm:meta] section.
+ */
+export interface SwarmMeta {
+    projectName: string;
+    mode: string;
+    started: string;
+    totalEpics: number;
+    totalTasks: number;
+    acPassed: number;
+    acTotal: number;
+}
+/**
+ * A single epic row from the [swarm:epics] table.
+ */
+export interface SwarmEpic {
+    id: string;
+    name: string;
+    agent: string;
+    status: "not-started" | "on-track" | "blocked" | "complete";
+    tasksDone: number;
+    blocker: string;
+}
+/**
+ * A single checkpoint entry from the [swarm:checkpoints] section.
+ */
+export interface SwarmCheckpoint {
+    date: string;
+    epicId: string;
+    done: number;
+    status: string;
+    blocker: string;
+}
+/**
+ * A single conflict entry from the [swarm:conflicts] section.
+ */
+export interface SwarmConflict {
+    date: string;
+    file: string;
+    agents: string;
+    resolution: "pending" | "resolved";
+}
+/**
+ * Full parsed state from SWARM_AWARENESS.md.
+ */
+export interface SwarmState {
+    meta: SwarmMeta;
+    epics: SwarmEpic[];
+    checkpoints: SwarmCheckpoint[];
+    conflicts: SwarmConflict[];
+}
+/**
+ * Parses the full SWARM_AWARENESS.md content into a typed SwarmState.
+ *
+ * Uses section header markers (`[swarm:meta]`, `[swarm:epics]`, etc.) to locate
+ * each section. Missing or empty sections return sensible defaults (empty arrays,
+ * zero counts) rather than throwing.
+ */
+export declare function parseSwarmAwareness(content: string): SwarmState;
+//# sourceMappingURL=swarm-parser.d.ts.map

package/dist/cli/swarm-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm-parser.d.ts","sourceRoot":"","sources":["../../src/cli/swarm-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,WAAW,EAAE,eAAe,EAAE,CAAC;IAC/B,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B;AAyQD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAY/D"}

package/dist/cli/swarm-parser.js

@@ -0,0 +1,237 @@
+/**
+ * Valid epic status values.
+ */
+const VALID_EPIC_STATUSES = new Set([
+    "not-started",
+    "on-track",
+    "blocked",
+    "complete",
+]);
+/**
+ * Valid conflict resolution values.
+ */
+const VALID_RESOLUTIONS = new Set(["pending", "resolved"]);
+/**
+ * Extracts content between a section header marker and the next section or end of file.
+ * Section markers are markdown headings like `## [swarm:meta]`.
+ */
+function extractSection(content, sectionName) {
+    const marker = `## [swarm:${sectionName}]`;
+    const startIndex = content.indexOf(marker);
+    if (startIndex === -1) {
+        return "";
+    }
+    const contentStart = startIndex + marker.length;
+    // Find the next ## [swarm: section or end of content
+    const nextSectionPattern = /\n## \[swarm:/;
+    const remaining = content.slice(contentStart);
+    const nextMatch = nextSectionPattern.exec(remaining);
+    if (nextMatch !== null) {
+        return remaining.slice(0, nextMatch.index).trim();
+    }
+    return remaining.trim();
+}
+/**
+ * Parses the [swarm:meta] section as key-value pairs.
+ * Lines matching `- **Key:** value` are extracted.
+ */
+function parseMeta(section) {
+    const defaults = {
+        projectName: "",
+        mode: "",
+        started: "",
+        totalEpics: 0,
+        totalTasks: 0,
+        acPassed: 0,
+        acTotal: 0,
+    };
+    if (section.length === 0) {
+        return defaults;
+    }
+    const kvPattern = /^- \*\*(.+?):\*\*\s*(.*)$/;
+    const lines = section.split("\n");
+    for (const line of lines) {
+        const match = kvPattern.exec(line.trim());
+        if (match === null) {
+            continue;
+        }
+        const key = match[1].toLowerCase();
+        const value = match[2].trim();
+        switch (key) {
+            case "project":
+                defaults.projectName = value;
+                break;
+            case "mode":
+                defaults.mode = value;
+                break;
+            case "started":
+                defaults.started = value;
+                break;
+            case "total epics":
+                defaults.totalEpics = parseInt(value, 10) || 0;
+                break;
+            case "total tasks":
+                defaults.totalTasks = parseInt(value, 10) || 0;
+                break;
+            case "acceptance criteria": {
+                // Format: "N / M passed"
+                const acMatch = /(\d+)\s*\/\s*(\d+)\s*passed/.exec(value);
+                if (acMatch !== null) {
+                    defaults.acPassed = parseInt(acMatch[1], 10) || 0;
+                    defaults.acTotal = parseInt(acMatch[2], 10) || 0;
+                }
+                break;
+            }
+        }
+    }
+    return defaults;
+}
+/**
+ * Parses the [swarm:epics] section as a markdown table.
+ * Skips the header row and separator row.
+ */
+function parseEpics(section) {
+    if (section.length === 0) {
+        return [];
+    }
+    const lines = section.split("\n").filter((line) => line.trim().startsWith("|"));
+    // Need at least header + separator + 1 data row
+    if (lines.length < 3) {
+        return [];
+    }
+    // Skip header (index 0) and separator (index 1)
+    const dataRows = lines.slice(2);
+    const epics = [];
+    for (const row of dataRows) {
+        const cells = row
+            .split("|")
+            .map((cell) => cell.trim())
+            .filter((cell) => cell.length > 0);
+        // Expect 6 columns: Epic ID, Name, Agent, Status, Tasks Done, Blocker
+        if (cells.length < 6) {
+            continue;
+        }
+        const statusRaw = cells[3].toLowerCase();
+        const status = VALID_EPIC_STATUSES.has(statusRaw)
+            ? statusRaw
+            : "not-started";
+        const tasksDone = parseInt(cells[4], 10) || 0;
+        epics.push({
+            id: cells[0],
+            name: cells[1],
+            agent: cells[2],
+            status,
+            tasksDone,
+            blocker: cells[5],
+        });
+    }
+    return epics;
+}
+/**
+ * Parses the [swarm:checkpoints] section.
+ * Entries are pipe-delimited lines inside a code block.
+ */
+function parseCheckpoints(section) {
+    if (section.length === 0) {
+        return [];
+    }
+    // Extract content inside code blocks
+    const codeBlockMatch = /```\n?([\s\S]*?)```/.exec(section);
+    if (codeBlockMatch === null) {
+        return [];
+    }
+    const blockContent = codeBlockMatch[1].trim();
+    if (blockContent.length === 0) {
+        return [];
+    }
+    const lines = blockContent.split("\n");
+    const checkpoints = [];
+    for (const line of lines) {
+        const parts = line.split("|").map((p) => p.trim());
+        // Expect: date | EPIC_ID | done:N | status:X | blocker:X
+        if (parts.length < 5) {
+            continue;
+        }
+        // Skip template/example lines
+        if (parts[0].startsWith("[")) {
+            continue;
+        }
+        const doneMatch = /done:(\d+)/.exec(parts[2]);
+        const statusMatch = /status:(.+)/.exec(parts[3]);
+        const blockerMatch = /blocker:(.+)/.exec(parts[4]);
+        checkpoints.push({
+            date: parts[0],
+            epicId: parts[1],
+            done: doneMatch !== null ? parseInt(doneMatch[1], 10) || 0 : 0,
+            status: statusMatch !== null ? statusMatch[1].trim() : "",
+            blocker: blockerMatch !== null ? blockerMatch[1].trim() : "none",
+        });
+    }
+    return checkpoints;
+}
+/**
+ * Parses the [swarm:conflicts] section.
+ * Entries are pipe-delimited lines inside a code block.
+ */
+function parseConflicts(section) {
+    if (section.length === 0) {
+        return [];
+    }
+    const codeBlockMatch = /```\n?([\s\S]*?)```/.exec(section);
+    if (codeBlockMatch === null) {
+        return [];
+    }
+    const blockContent = codeBlockMatch[1].trim();
+    if (blockContent.length === 0) {
+        return [];
+    }
+    const lines = blockContent.split("\n");
+    const conflicts = [];
+    for (const line of lines) {
+        const parts = line.split("|").map((p) => p.trim());
+        // Expect: date | CONFLICT | file:path | agents:X vs Y | resolution:X
+        if (parts.length < 5) {
+            continue;
+        }
+        // Skip template/example lines
+        if (parts[0].startsWith("[")) {
+            continue;
+        }
+        const fileMatch = /file:(.+)/.exec(parts[2]);
+        const agentsMatch = /agents:(.+)/.exec(parts[3]);
+        const resolutionMatch = /resolution:(.+)/.exec(parts[4]);
+        const resolutionRaw = resolutionMatch !== null
+            ? resolutionMatch[1].trim().toLowerCase()
+            : "pending";
+        const resolution = VALID_RESOLUTIONS.has(resolutionRaw)
+            ? resolutionRaw
+            : "pending";
+        conflicts.push({
+            date: parts[0],
+            file: fileMatch !== null ? fileMatch[1].trim() : "",
+            agents: agentsMatch !== null ? agentsMatch[1].trim() : "",
+            resolution,
+        });
+    }
+    return conflicts;
+}
+/**
+ * Parses the full SWARM_AWARENESS.md content into a typed SwarmState.
+ *
+ * Uses section header markers (`[swarm:meta]`, `[swarm:epics]`, etc.) to locate
+ * each section. Missing or empty sections return sensible defaults (empty arrays,
+ * zero counts) rather than throwing.
+ */
+export function parseSwarmAwareness(content) {
+    const metaSection = extractSection(content, "meta");
+    const epicsSection = extractSection(content, "epics");
+    const checkpointsSection = extractSection(content, "checkpoints");
+    const conflictsSection = extractSection(content, "conflicts");
+    return {
+        meta: parseMeta(metaSection),
+        epics: parseEpics(epicsSection),
+        checkpoints: parseCheckpoints(checkpointsSection),
+        conflicts: parseConflicts(conflictsSection),
+    };
+}
+//# sourceMappingURL=swarm-parser.js.map

package/dist/cli/swarm-parser.js.map

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

package/dist/cli/swarm.d.ts

@@ -0,0 +1,48 @@
+import type { RenderedFile } from "./renderer.js";
+/**
+ * Parsed epic extracted from epics markdown content.
+ */
+interface ParsedEpic {
+    /** Epic ID, e.g. "E1" */
+    id: string;
+    /** Epic name, e.g. "Project Setup" */
+    name: string;
+}
+/**
+ * Parses epic IDs and names from markdown-formatted epics content.
+ * Expects headings in the format: `## E1 -- Epic Name`
+ *
+ * @param epicsContent - Markdown string containing epic definitions
+ * @returns Array of parsed epics with id and name
+ */
+export declare function parseEpics(epicsContent: string): ParsedEpic[];
+/**
+ * Generates rendered epic-agent files from the epic-agent template.
+ * One `.claude/agents/epic-agent-E[N].md` file is created per epic,
+ * with {{EPIC_ID}}, {{EPIC_NAME}}, and {{EPIC_DOMAIN}} tokens replaced.
+ *
+ * Also generates a corresponding memory file per epic:
+ * `.claude/agent-memory/meto-epic-E[N]/MEMORY.md`
+ *
+ * @param epicsContent - Markdown string containing epic definitions
+ * @param templateContent - Raw content of the epic-agent.md template
+ * @returns Array of rendered files (agent definitions + memory files)
+ */
+export declare function generateEpicAgents(epicsContent: string, templateContent: string): RenderedFile[];
+/**
+ * Reads the epic-agent template from the templates directory.
+ *
+ * @param templatesDir - Absolute path to the templates directory
+ * @returns Raw template content
+ */
+export declare function readEpicAgentTemplate(templatesDir: string): Promise<string>;
+/**
+ * Generates a settings.json content with epic agent entries.
+ * Merges the base settings with agent file references for swarm mode.
+ *
+ * @param epicIds - Array of epic IDs (e.g. ["E1", "E2", "E3"])
+ * @returns Formatted JSON string for .claude/settings.json
+ */
+export declare function generateSwarmSettings(epicIds: string[]): string;
+export {};
+//# sourceMappingURL=swarm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.d.ts","sourceRoot":"","sources":["../../src/cli/swarm.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AACH,UAAU,UAAU;IAClB,yBAAyB;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,EAAE,CAa7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,YAAY,EAAE,CAyChB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAW/D"}

package/dist/cli/swarm.js

@@ -0,0 +1,101 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { replaceTokens } from "./renderer.js";
+/**
+ * Parses epic IDs and names from markdown-formatted epics content.
+ * Expects headings in the format: `## E1 -- Epic Name`
+ *
+ * @param epicsContent - Markdown string containing epic definitions
+ * @returns Array of parsed epics with id and name
+ */
+export function parseEpics(epicsContent) {
+    const epicPattern = /^## (E\d+) -- (.+)$/gm;
+    const epics = [];
+    let match;
+    while ((match = epicPattern.exec(epicsContent)) !== null) {
+        epics.push({
+            id: match[1],
+            name: match[2].trim(),
+        });
+    }
+    return epics;
+}
+/**
+ * Generates rendered epic-agent files from the epic-agent template.
+ * One `.claude/agents/epic-agent-E[N].md` file is created per epic,
+ * with {{EPIC_ID}}, {{EPIC_NAME}}, and {{EPIC_DOMAIN}} tokens replaced.
+ *
+ * Also generates a corresponding memory file per epic:
+ * `.claude/agent-memory/meto-epic-E[N]/MEMORY.md`
+ *
+ * @param epicsContent - Markdown string containing epic definitions
+ * @param templateContent - Raw content of the epic-agent.md template
+ * @returns Array of rendered files (agent definitions + memory files)
+ */
+export function generateEpicAgents(epicsContent, templateContent) {
+    const epics = parseEpics(epicsContent);
+    const rendered = [];
+    for (const epic of epics) {
+        const tokens = {
+            EPIC_ID: epic.id,
+            EPIC_NAME: epic.name,
+            EPIC_DOMAIN: "to be assigned by @meto-pm",
+        };
+        const agentContent = replaceTokens(templateContent, tokens);
+        rendered.push({
+            relativePath: `.claude/agents/epic-agent-${epic.id}.md`,
+            content: agentContent,
+        });
+        const memoryContent = [
+            `# Epic Agent Memory -- ${epic.name} (${epic.id})`,
+            "",
+            "*Read at session start. Update at session end. Keep it concise.*",
+            "",
+            "---",
+            "",
+            "## Current State",
+            "- **Status:** not-started",
+            "- **Tasks completed:** 0",
+            "- **Checkpoint count:** 0",
+            "",
+            "## Session Log",
+            "*(no sessions yet)*",
+            "",
+        ].join("\n");
+        rendered.push({
+            relativePath: `.claude/agent-memory/meto-epic-${epic.id}/MEMORY.md`,
+            content: memoryContent,
+        });
+    }
+    return rendered;
+}
+/**
+ * Reads the epic-agent template from the templates directory.
+ *
+ * @param templatesDir - Absolute path to the templates directory
+ * @returns Raw template content
+ */
+export async function readEpicAgentTemplate(templatesDir) {
+    const templatePath = join(templatesDir, ".claude", "agents", "epic-agent.md");
+    return readFile(templatePath, "utf-8");
+}
+/**
+ * Generates a settings.json content with epic agent entries.
+ * Merges the base settings with agent file references for swarm mode.
+ *
+ * @param epicIds - Array of epic IDs (e.g. ["E1", "E2", "E3"])
+ * @returns Formatted JSON string for .claude/settings.json
+ */
+export function generateSwarmSettings(epicIds) {
+    const settings = {
+        env: {
+            CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS: "1",
+        },
+        agents: epicIds.map((id) => ({
+            slug: `meto-epic-${id.toLowerCase()}`,
+            file: `.claude/agents/epic-agent-${id}.md`,
+        })),
+    };
+    return JSON.stringify(settings, null, 2) + "\n";
+}
+//# sourceMappingURL=swarm.js.map

package/dist/cli/swarm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"swarm.js","sourceRoot":"","sources":["../../src/cli/swarm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAa9C;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,YAAoB;IAC7C,MAAM,WAAW,GAAG,uBAAuB,CAAC;IAC5C,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,IAAI,KAA6B,CAAC;IAElC,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC;YACT,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;YACZ,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,kBAAkB,CAChC,YAAoB,EACpB,eAAuB;IAEvB,MAAM,KAAK,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAmB,EAAE,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,WAAW,EAAE,4BAA4B;SAC1C,CAAC;QAEF,MAAM,YAAY,GAAG,aAAa,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QAC5D,QAAQ,CAAC,IAAI,CAAC;YACZ,YAAY,EAAE,6BAA6B,IAAI,CAAC,EAAE,KAAK;YACvD,OAAO,EAAE,YAAY;SACtB,CAAC,CAAC;QAEH,MAAM,aAAa,GAAG;YACpB,0BAA0B,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,GAAG;YAClD,EAAE;YACF,kEAAkE;YAClE,EAAE;YACF,KAAK;YACL,EAAE;YACF,kBAAkB;YAClB,2BAA2B;YAC3B,0BAA0B;YAC1B,2BAA2B;YAC3B,EAAE;YACF,gBAAgB;YAChB,qBAAqB;YACrB,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,QAAQ,CAAC,IAAI,CAAC;YACZ,YAAY,EAAE,kCAAkC,IAAI,CAAC,EAAE,YAAY;YACnE,OAAO,EAAE,aAAa;SACvB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,YAAoB;IAEpB,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC;IAC9E,OAAO,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAiB;IACrD,MAAM,QAAQ,GAA4B;QACxC,GAAG,EAAE;YACH,oCAAoC,EAAE,GAAG;SAC1C;QACD,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3B,IAAI,EAAE,aAAa,EAAE,CAAC,WAAW,EAAE,EAAE;YACrC,IAAI,EAAE,6BAA6B,EAAE,KAAK;SAC3C,CAAC,CAAC;KACJ,CAAC;IACF,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAClD,CAAC"}

package/dist/cli/types.d.ts

@@ -2,6 +2,10 @@
  * Tech stack presets available during project scaffolding.
  */
 export type TechStack = "nextjs-supabase" | "react-native" | "nodejs-cli" | "python-fastapi" | "go" | "vite-react" | "flutter" | "custom";
+/**
+ * Workflow mode: sprint (sequential) or swarm (parallel epic agents).
+ */
+export type WorkflowMode = "sprint" | "swarm";
 /**
  * The brief collected from the user during `meto-cli init`.
  * Contains everything needed to render templates and scaffold a project.
@@ -29,5 +33,7 @@ export interface ProjectBrief {
     codeConventions: string;
     /** Absolute or relative path where the scaffold will be written */
     outputDirectory: string;
+    /** Workflow mode: sprint (sequential) or swarm (parallel epic agents) */
+    workflowMode: WorkflowMode;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +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,gBAAgB,GAChB,IAAI,GACJ,YAAY,GACZ,SAAS,GACT,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"}
+{"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,gBAAgB,GAChB,IAAI,GACJ,YAAY,GACZ,SAAS,GACT,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE9C;;;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;IACxB,yEAAyE;IACzE,YAAY,EAAE,YAAY,CAAC;CAC5B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meto-cli",
-  "version": "0.7.6",
+  "version": "0.9.0",
   "description": "Scaffold structured software projects with built-in methodology",
   "type": "module",
   "bin": {