@codexa/cli 8.5.0 → 8.6.0

package/commands/plan.ts

@@ -1,376 +1,376 @@
-import { getDb } from "../db/connection";
-import { initSchema, getArchitecturalAnalysisForSpec } from "../db/schema";
-
-function generateSpecId(name: string): string {
-    const date = new Date().toISOString().split("T")[0];
-    const slug = name
-        .toLowerCase()
-        .replace(/[^a-z0-9]+/g, "-")
-        .substring(0, 30);
-    return `${date}-${slug}`;
-}
-
-// v8.4: Suporte a --from-analysis para import automatico de baby steps
-export function planStart(description: string, options: { fromAnalysis?: string; json?: boolean } = {}): void {
-    initSchema();
-    const db = getDb();
-
-    // Verificar se ja existe spec ativo (ignorar completed e cancelled)
-    const existing = db
-        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
-        .get() as any;
-
-    if (existing) {
-        if (options.json) {
-            console.log(JSON.stringify({
-                error: "FEATURE_ACTIVE",
-                name: existing.name,
-                id: existing.id,
-                phase: existing.phase,
-            }));
-        } else {
-            console.error(`\nJa existe uma feature ativa: ${existing.name} (${existing.id})`);
-            console.error(`Fase atual: ${existing.phase}`);
-            console.error(`\nPara continuar, use: status`);
-            console.error(`Para cancelar a atual, use: plan cancel\n`);
-        }
-        process.exit(1);
-    }
-
-    // v8.4: Buscar analise arquitetural se --from-analysis fornecido
-    let analysis: any = null;
-    if (options.fromAnalysis) {
-        analysis = db.query(
-            "SELECT * FROM architectural_analyses WHERE id = ?"
-        ).get(options.fromAnalysis) as any;
-
-        if (!analysis) {
-            if (options.json) {
-                console.log(JSON.stringify({ error: "ANALYSIS_NOT_FOUND", id: options.fromAnalysis }));
-            } else {
-                console.error(`\n[ERRO] Analise arquitetural '${options.fromAnalysis}' nao encontrada.\n`);
-            }
-            process.exit(1);
-        }
-
-        if (analysis.status !== "approved") {
-            if (options.json) {
-                console.log(JSON.stringify({ error: "ANALYSIS_NOT_APPROVED", id: analysis.id, status: analysis.status }));
-            } else {
-                console.error(`\n[ERRO] Analise '${analysis.id}' nao esta aprovada (status: ${analysis.status}).`);
-                console.error("Use 'architect approve' primeiro.\n");
-            }
-            process.exit(1);
-        }
-    } else {
-        // v8.4: Auto-deteccao por nome
-        const match = getArchitecturalAnalysisForSpec(description);
-        if (match) {
-            analysis = match;
-            if (!options.json) {
-                console.log(`\n[INFO] Analise arquitetural encontrada: ${match.id} (${match.name})`);
-                console.log("Importando baby steps automaticamente...\n");
-            }
-        }
-    }
-
-    const specId = generateSpecId(description);
-    const now = new Date().toISOString();
-
-    // Criar spec (com analysis_id se disponivel)
-    if (analysis) {
-        db.run(
-            "INSERT INTO specs (id, name, phase, analysis_id, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)",
-            [specId, description, "planning", analysis.id, now, now]
-        );
-    } else {
-        db.run(
-            "INSERT INTO specs (id, name, phase, created_at, updated_at) VALUES (?, ?, ?, ?, ?)",
-            [specId, description, "planning", now, now]
-        );
-    }
-
-    // Criar contexto inicial
-    db.run(
-        "INSERT INTO context (spec_id, objective, updated_at) VALUES (?, ?, ?)",
-        [specId, description, now]
-    );
-
-    // v8.4: Import automatico de baby steps da analise
-    let tasksCreated = 0;
-    if (analysis && analysis.baby_steps) {
-        try {
-            const babySteps = JSON.parse(analysis.baby_steps);
-            for (const step of babySteps) {
-                const files = step.files && step.files.length > 0 ? JSON.stringify(step.files) : null;
-                const dependsOn = step.dependsOn && step.dependsOn.length > 0 ? JSON.stringify(step.dependsOn) : null;
-
-                db.run(
-                    `INSERT INTO tasks (spec_id, number, name, agent, depends_on, can_parallel, files)
-                     VALUES (?, ?, ?, ?, ?, ?, ?)`,
-                    [specId, step.number, step.name, step.agent || null, dependsOn, 1, files]
-                );
-                tasksCreated++;
-            }
-
-            // Atualizar total de tasks no contexto
-            db.run("UPDATE context SET total_tasks = ?, updated_at = ? WHERE spec_id = ?", [
-                tasksCreated, now, specId
-            ]);
-
-            // Marcar analise como implemented
-            db.run(
-                "UPDATE architectural_analyses SET status = 'implemented', updated_at = ? WHERE id = ?",
-                [now, analysis.id]
-            );
-        } catch {
-            if (!options.json) {
-                console.error("[AVISO] Falha ao parsear baby steps da analise. Adicione tasks manualmente.\n");
-            }
-        }
-    }
-
-    if (options.json) {
-        console.log(JSON.stringify({
-            success: true,
-            specId,
-            name: description,
-            phase: "planning",
-            analysisId: analysis?.id || null,
-            tasksImported: tasksCreated,
-        }));
-    } else {
-        console.log(`\nFeature iniciada: ${description}`);
-        console.log(`Spec ID: ${specId}`);
-        console.log(`Fase: planning`);
-
-        if (tasksCreated > 0) {
-            console.log(`Analise: ${analysis.id}`);
-            console.log(`Tasks importadas: ${tasksCreated}`);
-            console.log(`\nProximos passos:`);
-            console.log(`1. Visualize o plano: plan show`);
-            console.log(`2. Solicite aprovacao: check request\n`);
-        } else {
-            console.log(`\nProximos passos:`);
-            console.log(`1. Adicione tasks com: plan task-add --name "..." --agent "..."`);
-            console.log(`2. Visualize o plano com: plan show`);
-            console.log(`3. Solicite aprovacao com: check request\n`);
-        }
-    }
-}
-
-export function planShow(json: boolean = false): void {
-    initSchema();
-    const db = getDb();
-
-    const spec = db
-        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
-        .get() as any;
-
-    if (!spec) {
-        console.error("\nNenhuma feature ativa.");
-        console.error("Inicie com: /codexa:feature'\n");
-        process.exit(1);
-    }
-
-    const tasks = db
-        .query("SELECT * FROM tasks WHERE spec_id = ? ORDER BY number")
-        .all(spec.id) as any[];
-
-    const context = db
-        .query("SELECT * FROM context WHERE spec_id = ?")
-        .get(spec.id) as any;
-
-    if (json) {
-        console.log(JSON.stringify({ spec, context, tasks }, null, 2));
-        return;
-    }
-
-    console.log(`\n${"=".repeat(60)}`);
-    console.log(`PLANO: ${spec.name}`);
-    console.log(`${"=".repeat(60)}`);
-    console.log(`Spec ID: ${spec.id}`);
-    console.log(`Fase: ${spec.phase}`);
-    console.log(`Aprovado: ${spec.approved_at ? "Sim" : "Nao"}`);
-    console.log(`\nObjetivo: ${context?.objective || "-"}`);
-
-    if (tasks.length === 0) {
-        console.log(`\nNenhuma task definida.`);
-        console.log(`Adicione com: plan task-add --name "..." --agent "..."\n`);
-        return;
-    }
-
-    console.log(`\nTasks (${tasks.length}):`);
-    console.log(`${"─".repeat(60)}`);
-
-    for (const task of tasks) {
-        const deps = task.depends_on ? JSON.parse(task.depends_on) : [];
-        const depsStr = deps.length > 0 ? ` [deps: ${deps.join(",")}]` : "";
-        const parallelStr = task.can_parallel ? " ||" : "";
-        const statusIcon =
-            task.status === "done" ? "[x]" :
-                task.status === "running" ? "[>]" :
-                    task.status === "failed" ? "[!]" : "[ ]";
-
-        console.log(`${statusIcon} #${task.number}: ${task.name} (${task.agent || "geral"})${depsStr}${parallelStr}`);
-    }
-
-    console.log(`${"─".repeat(60)}`);
-    console.log(`Legenda: [ ] pendente  [>] executando  [x] concluido  || paralelizavel\n`);
-}
-
-export function planTaskAdd(options: {
-    name: string;
-    agent?: string;
-    depends?: string;
-    files?: string;
-    sequential?: boolean;
-}): void {
-    initSchema();
-    const db = getDb();
-
-    const spec = db
-        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
-        .get() as any;
-
-    if (!spec) {
-        console.error("\nNenhuma feature ativa.");
-        console.error("Inicie com: /codexa:feature\n");
-        process.exit(1);
-    }
-
-    if (spec.phase !== "planning") {
-        console.error(`\nNao e possivel adicionar tasks na fase '${spec.phase}'.`);
-        console.error("Tasks so podem ser adicionadas na fase 'planning'.\n");
-        process.exit(1);
-    }
-
-    // Pegar proximo numero
-    const lastTask = db
-        .query("SELECT MAX(number) as max FROM tasks WHERE spec_id = ?")
-        .get(spec.id) as any;
-    const nextNumber = (lastTask?.max || 0) + 1;
-
-    // Validar dependencias
-    let dependsOn: number[] = [];
-    if (options.depends) {
-        dependsOn = options.depends.split(",").map((s) => parseInt(s.trim()));
-        for (const depId of dependsOn) {
-            const exists = db
-                .query("SELECT id FROM tasks WHERE spec_id = ? AND number = ?")
-                .get(spec.id, depId);
-            if (!exists) {
-                console.error(`\nDependencia invalida: task #${depId} nao existe.\n`);
-                process.exit(2);
-            }
-        }
-
-        // v8.1: Detectar dependencias circulares
-        // Construir grafo de dependencias e verificar se adicionar esta task cria ciclo
-        const allTasks = db
-            .query("SELECT number, depends_on FROM tasks WHERE spec_id = ?")
-            .all(spec.id) as any[];
-
-        // Grafo: taskNumber -> [dependencias]
-        const graph = new Map<number, number[]>();
-        for (const t of allTasks) {
-            graph.set(t.number, t.depends_on ? JSON.parse(t.depends_on) : []);
-        }
-        // Adicionar a nova task ao grafo temporariamente
-        graph.set(nextNumber, dependsOn);
-
-        // DFS para detectar ciclos
-        const visited = new Set<number>();
-        const inStack = new Set<number>();
-
-        function hasCycle(node: number): boolean {
-            if (inStack.has(node)) return true;
-            if (visited.has(node)) return false;
-
-            visited.add(node);
-            inStack.add(node);
-
-            const deps = graph.get(node) || [];
-            for (const dep of deps) {
-                if (hasCycle(dep)) return true;
-            }
-
-            inStack.delete(node);
-            return false;
-        }
-
-        if (hasCycle(nextNumber)) {
-            console.error(`\nERRO: Dependencia circular detectada!`);
-            console.error(`Task #${nextNumber} -> [${dependsOn.join(", ")}] cria um ciclo.`);
-            console.error(`Corrija as dependencias para evitar deadlocks.\n`);
-            process.exit(2);
-        }
-    }
-
-    // Parsear arquivos
-    let files: string[] = [];
-    if (options.files) {
-        files = options.files.split(",").map((s) => s.trim());
-    }
-
-    db.run(
-        `INSERT INTO tasks (spec_id, number, name, agent, depends_on, can_parallel, files)
-     VALUES (?, ?, ?, ?, ?, ?, ?)`,
-        [
-            spec.id,
-            nextNumber,
-            options.name,
-            options.agent || null,
-            dependsOn.length > 0 ? JSON.stringify(dependsOn) : null,
-            options.sequential ? 0 : 1,
-            files.length > 0 ? JSON.stringify(files) : null,
-        ]
-    );
-
-    // Atualizar total de tasks no contexto
-    const count = db.query("SELECT COUNT(*) as c FROM tasks WHERE spec_id = ?").get(spec.id) as any;
-    db.run("UPDATE context SET total_tasks = ?, updated_at = ? WHERE spec_id = ?", [
-        count.c,
-        new Date().toISOString(),
-        spec.id,
-    ]);
-
-    console.log(`\nTask #${nextNumber} adicionada: ${options.name}`);
-    if (options.agent) console.log(`  Agente: ${options.agent}`);
-    if (dependsOn.length > 0) console.log(`  Depende de: ${dependsOn.join(", ")}`);
-    if (files.length > 0) console.log(`  Arquivos: ${files.join(", ")}`);
-    console.log(`  Paralelizavel: ${options.sequential ? "Nao" : "Sim"}\n`);
-}
-
-export function planCancel(): void {
-    initSchema();
-    const db = getDb();
-
-    const spec = db
-        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
-        .get() as any;
-
-    if (!spec) {
-        console.error("\nNenhuma feature ativa para cancelar.\n");
-        process.exit(1);
-    }
-
-    const now = new Date().toISOString();
-
-    // Marcar spec como cancelled
-    db.run(
-        "UPDATE specs SET phase = 'cancelled', updated_at = ? WHERE id = ?",
-        [now, spec.id]
-    );
-
-    // Marcar tasks pendentes/running como cancelled
-    const updatedTasks = db.run(
-        "UPDATE tasks SET status = 'cancelled' WHERE spec_id = ? AND status IN ('pending', 'running')",
-        [spec.id]
-    );
-
-    console.log(`\nFeature cancelada: ${spec.name}`);
-    console.log(`Spec ID: ${spec.id}`);
-    console.log(`Tasks canceladas: ${updatedTasks.changes}`);
-    console.log(`\nVoce pode iniciar uma nova feature com: plan start "..."\n`);
-}
+import { getDb } from "../db/connection";
+import { initSchema, getArchitecturalAnalysisForSpec } from "../db/schema";
+
+function generateSpecId(name: string): string {
+    const date = new Date().toISOString().split("T")[0];
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .substring(0, 30);
+    return `${date}-${slug}`;
+}
+
+// v8.4: Suporte a --from-analysis para import automatico de baby steps
+export function planStart(description: string, options: { fromAnalysis?: string; json?: boolean } = {}): void {
+    initSchema();
+    const db = getDb();
+
+    // Verificar se ja existe spec ativo (ignorar completed e cancelled)
+    const existing = db
+        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
+        .get() as any;
+
+    if (existing) {
+        if (options.json) {
+            console.log(JSON.stringify({
+                error: "FEATURE_ACTIVE",
+                name: existing.name,
+                id: existing.id,
+                phase: existing.phase,
+            }));
+        } else {
+            console.error(`\nJa existe uma feature ativa: ${existing.name} (${existing.id})`);
+            console.error(`Fase atual: ${existing.phase}`);
+            console.error(`\nPara continuar, use: status`);
+            console.error(`Para cancelar a atual, use: plan cancel\n`);
+        }
+        process.exit(1);
+    }
+
+    // v8.4: Buscar analise arquitetural se --from-analysis fornecido
+    let analysis: any = null;
+    if (options.fromAnalysis) {
+        analysis = db.query(
+            "SELECT * FROM architectural_analyses WHERE id = ?"
+        ).get(options.fromAnalysis) as any;
+
+        if (!analysis) {
+            if (options.json) {
+                console.log(JSON.stringify({ error: "ANALYSIS_NOT_FOUND", id: options.fromAnalysis }));
+            } else {
+                console.error(`\n[ERRO] Analise arquitetural '${options.fromAnalysis}' nao encontrada.\n`);
+            }
+            process.exit(1);
+        }
+
+        if (analysis.status !== "approved") {
+            if (options.json) {
+                console.log(JSON.stringify({ error: "ANALYSIS_NOT_APPROVED", id: analysis.id, status: analysis.status }));
+            } else {
+                console.error(`\n[ERRO] Analise '${analysis.id}' nao esta aprovada (status: ${analysis.status}).`);
+                console.error("Use 'architect approve' primeiro.\n");
+            }
+            process.exit(1);
+        }
+    } else {
+        // v8.4: Auto-deteccao por nome
+        const match = getArchitecturalAnalysisForSpec(description);
+        if (match) {
+            analysis = match;
+            if (!options.json) {
+                console.log(`\n[INFO] Analise arquitetural encontrada: ${match.id} (${match.name})`);
+                console.log("Importando baby steps automaticamente...\n");
+            }
+        }
+    }
+
+    const specId = generateSpecId(description);
+    const now = new Date().toISOString();
+
+    // Criar spec (com analysis_id se disponivel)
+    if (analysis) {
+        db.run(
+            "INSERT INTO specs (id, name, phase, analysis_id, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?)",
+            [specId, description, "planning", analysis.id, now, now]
+        );
+    } else {
+        db.run(
+            "INSERT INTO specs (id, name, phase, created_at, updated_at) VALUES (?, ?, ?, ?, ?)",
+            [specId, description, "planning", now, now]
+        );
+    }
+
+    // Criar contexto inicial
+    db.run(
+        "INSERT INTO context (spec_id, objective, updated_at) VALUES (?, ?, ?)",
+        [specId, description, now]
+    );
+
+    // v8.4: Import automatico de baby steps da analise
+    let tasksCreated = 0;
+    if (analysis && analysis.baby_steps) {
+        try {
+            const babySteps = JSON.parse(analysis.baby_steps);
+            for (const step of babySteps) {
+                const files = step.files && step.files.length > 0 ? JSON.stringify(step.files) : null;
+                const dependsOn = step.dependsOn && step.dependsOn.length > 0 ? JSON.stringify(step.dependsOn) : null;
+
+                db.run(
+                    `INSERT INTO tasks (spec_id, number, name, agent, depends_on, can_parallel, files)
+                     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+                    [specId, step.number, step.name, step.agent || null, dependsOn, 1, files]
+                );
+                tasksCreated++;
+            }
+
+            // Atualizar total de tasks no contexto
+            db.run("UPDATE context SET total_tasks = ?, updated_at = ? WHERE spec_id = ?", [
+                tasksCreated, now, specId
+            ]);
+
+            // Marcar analise como implemented
+            db.run(
+                "UPDATE architectural_analyses SET status = 'implemented', updated_at = ? WHERE id = ?",
+                [now, analysis.id]
+            );
+        } catch {
+            if (!options.json) {
+                console.error("[AVISO] Falha ao parsear baby steps da analise. Adicione tasks manualmente.\n");
+            }
+        }
+    }
+
+    if (options.json) {
+        console.log(JSON.stringify({
+            success: true,
+            specId,
+            name: description,
+            phase: "planning",
+            analysisId: analysis?.id || null,
+            tasksImported: tasksCreated,
+        }));
+    } else {
+        console.log(`\nFeature iniciada: ${description}`);
+        console.log(`Spec ID: ${specId}`);
+        console.log(`Fase: planning`);
+
+        if (tasksCreated > 0) {
+            console.log(`Analise: ${analysis.id}`);
+            console.log(`Tasks importadas: ${tasksCreated}`);
+            console.log(`\nProximos passos:`);
+            console.log(`1. Visualize o plano: plan show`);
+            console.log(`2. Solicite aprovacao: check request\n`);
+        } else {
+            console.log(`\nProximos passos:`);
+            console.log(`1. Adicione tasks com: plan task-add --name "..." --agent "..."`);
+            console.log(`2. Visualize o plano com: plan show`);
+            console.log(`3. Solicite aprovacao com: check request\n`);
+        }
+    }
+}
+
+export function planShow(json: boolean = false): void {
+    initSchema();
+    const db = getDb();
+
+    const spec = db
+        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
+        .get() as any;
+
+    if (!spec) {
+        console.error("\nNenhuma feature ativa.");
+        console.error("Inicie com: /codexa:feature'\n");
+        process.exit(1);
+    }
+
+    const tasks = db
+        .query("SELECT * FROM tasks WHERE spec_id = ? ORDER BY number")
+        .all(spec.id) as any[];
+
+    const context = db
+        .query("SELECT * FROM context WHERE spec_id = ?")
+        .get(spec.id) as any;
+
+    if (json) {
+        console.log(JSON.stringify({ spec, context, tasks }, null, 2));
+        return;
+    }
+
+    console.log(`\n${"=".repeat(60)}`);
+    console.log(`PLANO: ${spec.name}`);
+    console.log(`${"=".repeat(60)}`);
+    console.log(`Spec ID: ${spec.id}`);
+    console.log(`Fase: ${spec.phase}`);
+    console.log(`Aprovado: ${spec.approved_at ? "Sim" : "Nao"}`);
+    console.log(`\nObjetivo: ${context?.objective || "-"}`);
+
+    if (tasks.length === 0) {
+        console.log(`\nNenhuma task definida.`);
+        console.log(`Adicione com: plan task-add --name "..." --agent "..."\n`);
+        return;
+    }
+
+    console.log(`\nTasks (${tasks.length}):`);
+    console.log(`${"─".repeat(60)}`);
+
+    for (const task of tasks) {
+        const deps = task.depends_on ? JSON.parse(task.depends_on) : [];
+        const depsStr = deps.length > 0 ? ` [deps: ${deps.join(",")}]` : "";
+        const parallelStr = task.can_parallel ? " ||" : "";
+        const statusIcon =
+            task.status === "done" ? "[x]" :
+                task.status === "running" ? "[>]" :
+                    task.status === "failed" ? "[!]" : "[ ]";
+
+        console.log(`${statusIcon} #${task.number}: ${task.name} (${task.agent || "geral"})${depsStr}${parallelStr}`);
+    }
+
+    console.log(`${"─".repeat(60)}`);
+    console.log(`Legenda: [ ] pendente  [>] executando  [x] concluido  || paralelizavel\n`);
+}
+
+export function planTaskAdd(options: {
+    name: string;
+    agent?: string;
+    depends?: string;
+    files?: string;
+    sequential?: boolean;
+}): void {
+    initSchema();
+    const db = getDb();
+
+    const spec = db
+        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
+        .get() as any;
+
+    if (!spec) {
+        console.error("\nNenhuma feature ativa.");
+        console.error("Inicie com: /codexa:feature\n");
+        process.exit(1);
+    }
+
+    if (spec.phase !== "planning") {
+        console.error(`\nNao e possivel adicionar tasks na fase '${spec.phase}'.`);
+        console.error("Tasks so podem ser adicionadas na fase 'planning'.\n");
+        process.exit(1);
+    }
+
+    // Pegar proximo numero
+    const lastTask = db
+        .query("SELECT MAX(number) as max FROM tasks WHERE spec_id = ?")
+        .get(spec.id) as any;
+    const nextNumber = (lastTask?.max || 0) + 1;
+
+    // Validar dependencias
+    let dependsOn: number[] = [];
+    if (options.depends) {
+        dependsOn = options.depends.split(",").map((s) => parseInt(s.trim()));
+        for (const depId of dependsOn) {
+            const exists = db
+                .query("SELECT id FROM tasks WHERE spec_id = ? AND number = ?")
+                .get(spec.id, depId);
+            if (!exists) {
+                console.error(`\nDependencia invalida: task #${depId} nao existe.\n`);
+                process.exit(2);
+            }
+        }
+
+        // v8.1: Detectar dependencias circulares
+        // Construir grafo de dependencias e verificar se adicionar esta task cria ciclo
+        const allTasks = db
+            .query("SELECT number, depends_on FROM tasks WHERE spec_id = ?")
+            .all(spec.id) as any[];
+
+        // Grafo: taskNumber -> [dependencias]
+        const graph = new Map<number, number[]>();
+        for (const t of allTasks) {
+            graph.set(t.number, t.depends_on ? JSON.parse(t.depends_on) : []);
+        }
+        // Adicionar a nova task ao grafo temporariamente
+        graph.set(nextNumber, dependsOn);
+
+        // DFS para detectar ciclos
+        const visited = new Set<number>();
+        const inStack = new Set<number>();
+
+        function hasCycle(node: number): boolean {
+            if (inStack.has(node)) return true;
+            if (visited.has(node)) return false;
+
+            visited.add(node);
+            inStack.add(node);
+
+            const deps = graph.get(node) || [];
+            for (const dep of deps) {
+                if (hasCycle(dep)) return true;
+            }
+
+            inStack.delete(node);
+            return false;
+        }
+
+        if (hasCycle(nextNumber)) {
+            console.error(`\nERRO: Dependencia circular detectada!`);
+            console.error(`Task #${nextNumber} -> [${dependsOn.join(", ")}] cria um ciclo.`);
+            console.error(`Corrija as dependencias para evitar deadlocks.\n`);
+            process.exit(2);
+        }
+    }
+
+    // Parsear arquivos
+    let files: string[] = [];
+    if (options.files) {
+        files = options.files.split(",").map((s) => s.trim());
+    }
+
+    db.run(
+        `INSERT INTO tasks (spec_id, number, name, agent, depends_on, can_parallel, files)
+     VALUES (?, ?, ?, ?, ?, ?, ?)`,
+        [
+            spec.id,
+            nextNumber,
+            options.name,
+            options.agent || null,
+            dependsOn.length > 0 ? JSON.stringify(dependsOn) : null,
+            options.sequential ? 0 : 1,
+            files.length > 0 ? JSON.stringify(files) : null,
+        ]
+    );
+
+    // Atualizar total de tasks no contexto
+    const count = db.query("SELECT COUNT(*) as c FROM tasks WHERE spec_id = ?").get(spec.id) as any;
+    db.run("UPDATE context SET total_tasks = ?, updated_at = ? WHERE spec_id = ?", [
+        count.c,
+        new Date().toISOString(),
+        spec.id,
+    ]);
+
+    console.log(`\nTask #${nextNumber} adicionada: ${options.name}`);
+    if (options.agent) console.log(`  Agente: ${options.agent}`);
+    if (dependsOn.length > 0) console.log(`  Depende de: ${dependsOn.join(", ")}`);
+    if (files.length > 0) console.log(`  Arquivos: ${files.join(", ")}`);
+    console.log(`  Paralelizavel: ${options.sequential ? "Nao" : "Sim"}\n`);
+}
+
+export function planCancel(): void {
+    initSchema();
+    const db = getDb();
+
+    const spec = db
+        .query("SELECT * FROM specs WHERE phase NOT IN ('completed', 'cancelled') ORDER BY created_at DESC LIMIT 1")
+        .get() as any;
+
+    if (!spec) {
+        console.error("\nNenhuma feature ativa para cancelar.\n");
+        process.exit(1);
+    }
+
+    const now = new Date().toISOString();
+
+    // Marcar spec como cancelled
+    db.run(
+        "UPDATE specs SET phase = 'cancelled', updated_at = ? WHERE id = ?",
+        [now, spec.id]
+    );
+
+    // Marcar tasks pendentes/running como cancelled
+    const updatedTasks = db.run(
+        "UPDATE tasks SET status = 'cancelled' WHERE spec_id = ? AND status IN ('pending', 'running')",
+        [spec.id]
+    );
+
+    console.log(`\nFeature cancelada: ${spec.name}`);
+    console.log(`Spec ID: ${spec.id}`);
+    console.log(`Tasks canceladas: ${updatedTasks.changes}`);
+    console.log(`\nVoce pode iniciar uma nova feature com: plan start "..."\n`);
+}