@codexa/cli 8.6.0 → 8.6.9

package/commands/product.ts

@@ -1,626 +1,626 @@
-import { getDb } from "../db/connection";
-import { initSchema } from "../db/schema";
-import { existsSync, readFileSync, writeFileSync } from "fs";
-import { join } from "path";
-
-interface ProductContext {
-  name: string;
-  problem: string;
-  solution?: string;
-  targetUsers?: string;
-  valueProposition?: string;
-  successMetrics?: string[];
-  outOfScope?: string[];
-  constraints?: string[];
-}
-
-interface ProductGoal {
-  category: string;
-  goal: string;
-  priority: "high" | "medium" | "low";
-}
-
-interface ProductFeature {
-  name: string;
-  description?: string;
-  priority: "high" | "medium" | "low";
-}
-
-// ═══════════════════════════════════════════════════════════════
-// PRODUCT GUIDE - Inicia o processo guiado
-// ═══════════════════════════════════════════════════════════════
-
-export function productGuide(json: boolean = false): void {
-  initSchema();
-  const db = getDb();
-
-  // Verificar se ja existe
-  const existing = db.query("SELECT * FROM product_context WHERE id = 'default'").get();
-  if (existing) {
-    console.log("\nContexto de produto ja definido.");
-    console.log("Use: product show para ver detalhes");
-    console.log("Ou: product reset para refazer\n");
-    return;
-  }
-
-  if (json) {
-    console.log(JSON.stringify({ status: "ready_for_guide", message: "Use AskUserQuestion para guiar o usuario" }, null, 2));
-    return;
-  }
-
-  console.log("\n" + "═".repeat(60));
-  console.log("PRODUCT DISCOVERY - Modo Guiado");
-  console.log("═".repeat(60));
-  console.log(`
-Este modo vai ajudar a definir o contexto do produto atraves de perguntas.
-
-O agente vai usar AskUserQuestion para coletar:
-1. Nome do produto
-2. Problema que resolve
-3. Solucao proposta
-4. Usuarios alvo
-5. Proposta de valor
-6. Metricas de sucesso
-7. O que esta fora do escopo
-8. Restricoes conhecidas
-
-Apos coletar as respostas, use:
-  product set --name "..." --problem "..." ...
-
-Para confirmar e salvar:
-  product confirm
-`);
-  console.log("─".repeat(60) + "\n");
-}
-
-// ═══════════════════════════════════════════════════════════════
-// PRODUCT IMPORT - Importa PRD existente
-// ═══════════════════════════════════════════════════════════════
-
-export function productImport(options: { file?: string; content?: string }): void {
-  initSchema();
-  const db = getDb();
-
-  // Verificar se ja existe
-  const existing = db.query("SELECT * FROM product_context WHERE id = 'default'").get();
-  if (existing) {
-    console.log("\nContexto de produto ja definido.");
-    console.log("Use: product reset para refazer\n");
-    return;
-  }
-
-  let prdContent = "";
-
-  if (options.file) {
-    if (!existsSync(options.file)) {
-      console.error(`\nArquivo nao encontrado: ${options.file}\n`);
-      process.exit(1);
-    }
-    prdContent = readFileSync(options.file, "utf-8");
-  } else if (options.content) {
-    prdContent = options.content;
-  } else {
-    console.error("\nForneca --file ou --content\n");
-    process.exit(1);
-  }
-
-  // Salvar como pendente para o agente processar
-  const now = new Date().toISOString();
-  db.run(
-    `INSERT INTO product_context (id, name, problem, source, discovered_at, updated_at)
-     VALUES ('pending', 'Pendente - PRD Importado', ?, 'import', ?, ?)`,
-    [prdContent, now, now]
-  );
-
-  console.log("\n" + "═".repeat(60));
-  console.log("PRD IMPORTADO");
-  console.log("═".repeat(60));
-  console.log(`
-Conteudo do PRD foi salvo para processamento.
-
-O agente deve agora:
-1. Analisar o PRD importado
-2. Extrair informacoes estruturadas
-3. Usar 'product set' para definir os campos
-4. Usar 'product confirm' para finalizar
-
-Comando para ver o PRD:
-  product show --pending
-`);
-  console.log("─".repeat(60) + "\n");
-}
-
-// ═══════════════════════════════════════════════════════════════
-// PRODUCT SET - Define campos do produto
-// ═══════════════════════════════════════════════════════════════
-
-export function productSet(options: {
-  name?: string;
-  problem?: string;
-  solution?: string;
-  targetUsers?: string;
-  valueProposition?: string;
-  successMetrics?: string;
-  outOfScope?: string;
-  constraints?: string;
-}): void {
-  initSchema();
-  const db = getDb();
-
-  // Buscar pendente ou criar novo
-  let pending = db.query("SELECT * FROM product_context WHERE id = 'pending'").get() as any;
-  const now = new Date().toISOString();
-
-  if (!pending) {
-    // Criar novo registro pendente
-    db.run(
-      `INSERT INTO product_context (id, name, problem, source, discovered_at, updated_at)
-       VALUES ('pending', 'Pendente', '', 'guide', ?, ?)`,
-      [now, now]
-    );
-    pending = { name: "Pendente", problem: "" };
-  }
-
-  // Atualizar campos fornecidos
-  const updates: string[] = [];
-  const values: any[] = [];
-
-  if (options.name) {
-    updates.push("name = ?");
-    values.push(options.name);
-  }
-  if (options.problem) {
-    updates.push("problem = ?");
-    values.push(options.problem);
-  }
-  if (options.solution) {
-    updates.push("solution = ?");
-    values.push(options.solution);
-  }
-  if (options.targetUsers) {
-    updates.push("target_users = ?");
-    values.push(options.targetUsers);
-  }
-  if (options.valueProposition) {
-    updates.push("value_proposition = ?");
-    values.push(options.valueProposition);
-  }
-  if (options.successMetrics) {
-    updates.push("success_metrics = ?");
-    values.push(JSON.stringify(options.successMetrics.split(",")));
-  }
-  if (options.outOfScope) {
-    updates.push("out_of_scope = ?");
-    values.push(JSON.stringify(options.outOfScope.split(",")));
-  }
-  if (options.constraints) {
-    updates.push("constraints = ?");
-    values.push(JSON.stringify(options.constraints.split(",")));
-  }
-
-  if (updates.length > 0) {
-    updates.push("updated_at = ?");
-    values.push(now);
-    values.push("pending");
-
-    db.run(
-      `UPDATE product_context SET ${updates.join(", ")} WHERE id = ?`,
-      values
-    );
-  }
-
-  // Mostrar estado atual
-  const current = db.query("SELECT * FROM product_context WHERE id = 'pending'").get() as any;
-
-  console.log("\nContexto de produto atualizado:");
-  console.log("─".repeat(40));
-  if (current.name !== "Pendente") console.log(`  Nome: ${current.name}`);
-  if (current.problem) console.log(`  Problema: ${current.problem.substring(0, 50)}...`);
-  if (current.solution) console.log(`  Solucao: ${current.solution.substring(0, 50)}...`);
-  if (current.target_users) console.log(`  Usuarios: ${current.target_users.substring(0, 50)}...`);
-  if (current.value_proposition) console.log(`  Proposta: ${current.value_proposition.substring(0, 50)}...`);
-  console.log("\nPara confirmar: product confirm\n");
-}
-
-// ═══════════════════════════════════════════════════════════════
-// PRODUCT GOAL ADD - Adiciona objetivo
-// ═══════════════════════════════════════════════════════════════
-
-export function productGoalAdd(options: {
-  category: string;
-  goal: string;
-  priority?: string;
-}): void {
-  initSchema();
-  const db = getDb();
-
-  const now = new Date().toISOString();
-  const priority = options.priority || "medium";
-
-  db.run(
-    `INSERT INTO product_goals (product_id, category, goal, priority, created_at)
-     VALUES ('pending', ?, ?, ?, ?)`,
-    [options.category, options.goal, priority, now]
-  );
-
-  const count = db.query("SELECT COUNT(*) as c FROM product_goals WHERE product_id = 'pending'").get() as any;
-
-  console.log(`\nObjetivo adicionado (${count.c} total)`);
-  console.log(`  [${options.category}] ${options.goal} (${priority})\n`);
-}
-
-// ═══════════════════════════════════════════════════════════════
-// PRODUCT FEATURE ADD - Adiciona feature core
-// ═══════════════════════════════════════════════════════════════
-
-export function productFeatureAdd(options: {
-  name: string;
-  description?: string;
-  priority?: string;
-}): void {
-  initSchema();
-  const db = getDb();
-
-  const now = new Date().toISOString();
-  const priority = options.priority || "medium";
-
-  db.run(
-    `INSERT INTO product_features (product_id, name, description, priority, created_at)
-     VALUES ('pending', ?, ?, ?, ?)`,
-    [options.name, options.description || "", priority, now]
-  );
-
-  const count = db.query("SELECT COUNT(*) as c FROM product_features WHERE product_id = 'pending'").get() as any;
-
-  console.log(`\nFeature adicionada (${count.c} total)`);
-  console.log(`  ${options.name} (${priority})\n`);
-}
-
-// ═══════════════════════════════════════════════════════════════
-// PRODUCT CONFIRM - Confirma e salva
-// ═══════════════════════════════════════════════════════════════
-
-export function productConfirm(): void {
-  initSchema();
-  const db = getDb();
-
-  const pending = db.query("SELECT * FROM product_context WHERE id = 'pending'").get() as any;
-  if (!pending) {
-    console.error("\nNenhum contexto de produto pendente.");
-    console.error("Execute: product guide ou product import primeiro\n");
-    process.exit(1);
-  }
-
-  // Validar campos obrigatorios
-  if (!pending.name || pending.name === "Pendente") {
-    console.error("\nCampo obrigatorio ausente: name");
-    console.error("Use: product set --name \"Nome do Produto\"\n");
-    process.exit(1);
-  }
-  if (!pending.problem || pending.problem === "") {
-    console.error("\nCampo obrigatorio ausente: problem");
-    console.error("Use: product set --problem \"Problema que resolve\"\n");
-    process.exit(1);
-  }
-
-  const now = new Date().toISOString();
-
-  // Desabilitar foreign keys temporariamente para permitir a migração
-  db.run("PRAGMA foreign_keys = OFF");
-
-  // Deletar goals e features do 'default' ANTES de deletar product_context
-  db.run("DELETE FROM product_goals WHERE product_id = 'default'");
-  db.run("DELETE FROM product_features WHERE product_id = 'default'");
-  db.run("DELETE FROM product_context WHERE id = 'default'");
-
-  // Mover pending para default (primeiro os filhos, depois o pai)
-  db.run(`UPDATE product_goals SET product_id = 'default' WHERE product_id = 'pending'`);
-  db.run(`UPDATE product_features SET product_id = 'default' WHERE product_id = 'pending'`);
-  db.run(
-    `UPDATE product_context SET id = 'default', updated_at = ? WHERE id = 'pending'`,
-    [now]
-  );
-
-  // Reabilitar foreign keys
-  db.run("PRAGMA foreign_keys = ON");
-
-  // Gerar arquivo product-context.md
-  generateProductMarkdown();
-
-  const goalsCount = db.query("SELECT COUNT(*) as c FROM product_goals WHERE product_id = 'default'").get() as any;
-  const featuresCount = db.query("SELECT COUNT(*) as c FROM product_features WHERE product_id = 'default'").get() as any;
-
-  console.log("\n" + "═".repeat(60));
-  console.log("PRODUTO CONFIGURADO");
-  console.log("═".repeat(60));
-  console.log(`
-  Nome: ${pending.name}
-  Objetivos: ${goalsCount.c}
-  Features: ${featuresCount.c}
-
-Arquivo gerado: .codexa/product-context.md
-
-Proximo passo: /codexa:feature para iniciar uma feature
-`);
-  console.log("─".repeat(60) + "\n");
-}
-
-// ═══════════════════════════════════════════════════════════════
-// PRODUCT SHOW - Mostra contexto atual
-// ═══════════════════════════════════════════════════════════════
-
-export function productShow(options: { json?: boolean; pending?: boolean } = {}): void {
-  initSchema();
-  const db = getDb();
-
-  const id = options.pending ? "pending" : "default";
-  const product = db.query(`SELECT * FROM product_context WHERE id = ?`).get(id) as any;
-
-  if (!product) {
-    if (options.pending) {
-      console.error("\nNenhum contexto pendente.");
-    } else {
-      console.error("\nContexto de produto nao definido.");
-      console.error("Execute: product guide ou product import\n");
-    }
-    process.exit(1);
-  }
-
-  const goals = db.query(`SELECT * FROM product_goals WHERE product_id = ? ORDER BY priority, category`).all(id) as any[];
-  const features = db.query(`SELECT * FROM product_features WHERE product_id = ? ORDER BY priority`).all(id) as any[];
-
-  if (options.json) {
-    console.log(JSON.stringify({
-      product,
-      goals,
-      features,
-      successMetrics: product.success_metrics ? JSON.parse(product.success_metrics) : [],
-      outOfScope: product.out_of_scope ? JSON.parse(product.out_of_scope) : [],
-      constraints: product.constraints ? JSON.parse(product.constraints) : [],
-    }, null, 2));
-    return;
-  }
-
-  console.log("\n" + "═".repeat(60));
-  console.log(`CONTEXTO DO PRODUTO${options.pending ? " (PENDENTE)" : ""}`);
-  console.log("═".repeat(60));
-
-  console.log(`\nNome: ${product.name}`);
-  console.log(`Fonte: ${product.source}`);
-
-  console.log("\n" + "─".repeat(40));
-  console.log("PROBLEMA");
-  console.log("─".repeat(40));
-  console.log(product.problem);
-
-  if (product.solution) {
-    console.log("\n" + "─".repeat(40));
-    console.log("SOLUCAO");
-    console.log("─".repeat(40));
-    console.log(product.solution);
-  }
-
-  if (product.target_users) {
-    console.log("\n" + "─".repeat(40));
-    console.log("USUARIOS ALVO");
-    console.log("─".repeat(40));
-    console.log(product.target_users);
-  }
-
-  if (product.value_proposition) {
-    console.log("\n" + "─".repeat(40));
-    console.log("PROPOSTA DE VALOR");
-    console.log("─".repeat(40));
-    console.log(product.value_proposition);
-  }
-
-  if (goals.length > 0) {
-    console.log("\n" + "─".repeat(40));
-    console.log("OBJETIVOS");
-    console.log("─".repeat(40));
-    for (const goal of goals) {
-      const icon = goal.priority === "high" ? "!" : goal.priority === "low" ? "-" : "*";
-      console.log(`  ${icon} [${goal.category}] ${goal.goal}`);
-    }
-  }
-
-  if (features.length > 0) {
-    console.log("\n" + "─".repeat(40));
-    console.log("FEATURES CORE");
-    console.log("─".repeat(40));
-    for (const feature of features) {
-      const icon = feature.priority === "high" ? "!" : feature.priority === "low" ? "-" : "*";
-      console.log(`  ${icon} ${feature.name}${feature.description ? `: ${feature.description}` : ""}`);
-    }
-  }
-
-  if (product.success_metrics) {
-    const metrics = JSON.parse(product.success_metrics);
-    if (metrics.length > 0) {
-      console.log("\n" + "─".repeat(40));
-      console.log("METRICAS DE SUCESSO");
-      console.log("─".repeat(40));
-      for (const metric of metrics) {
-        console.log(`  - ${metric}`);
-      }
-    }
-  }
-
-  if (product.out_of_scope) {
-    const outOfScope = JSON.parse(product.out_of_scope);
-    if (outOfScope.length > 0) {
-      console.log("\n" + "─".repeat(40));
-      console.log("FORA DO ESCOPO");
-      console.log("─".repeat(40));
-      for (const item of outOfScope) {
-        console.log(`  x ${item}`);
-      }
-    }
-  }
-
-  if (product.constraints) {
-    const constraints = JSON.parse(product.constraints);
-    if (constraints.length > 0) {
-      console.log("\n" + "─".repeat(40));
-      console.log("RESTRICOES");
-      console.log("─".repeat(40));
-      for (const item of constraints) {
-        console.log(`  ! ${item}`);
-      }
-    }
-  }
-
-  console.log("\n" + "─".repeat(60));
-  if (!options.pending) {
-    console.log("Arquivo: .codexa/product-context.md");
-  }
-  console.log("");
-}
-
-// ═══════════════════════════════════════════════════════════════
-// PRODUCT RESET - Reseta contexto de produto
-// ═══════════════════════════════════════════════════════════════
-
-export function productReset(): void {
-  initSchema();
-  const db = getDb();
-
-  db.run("DELETE FROM product_features");
-  db.run("DELETE FROM product_goals");
-  db.run("DELETE FROM product_context");
-
-  console.log("\nContexto de produto resetado.");
-  console.log("Execute: product guide ou product import para refazer\n");
-}
-
-// ═══════════════════════════════════════════════════════════════
-// GENERATE MARKDOWN
-// ═══════════════════════════════════════════════════════════════
-
-function generateProductMarkdown(): void {
-  const db = getDb();
-  const product = db.query("SELECT * FROM product_context WHERE id = 'default'").get() as any;
-  const goals = db.query("SELECT * FROM product_goals WHERE product_id = 'default' ORDER BY priority, category").all() as any[];
-  const features = db.query("SELECT * FROM product_features WHERE product_id = 'default' ORDER BY priority").all() as any[];
-
-  if (!product) return;
-
-  let md = `# ${product.name} - Contexto de Produto
-
-> Gerado automaticamente do SQLite. Nao edite manualmente.
-> Para modificar, use os comandos CLI.
-> Gerado em: ${new Date().toISOString()}
-> Fonte: ${product.source}
-
-## Problema
-
-${product.problem}
-
-`;
-
-  if (product.solution) {
-    md += `## Solucao
-
-${product.solution}
-
-`;
-  }
-
-  if (product.target_users) {
-    md += `## Usuarios Alvo
-
-${product.target_users}
-
-`;
-  }
-
-  if (product.value_proposition) {
-    md += `## Proposta de Valor
-
-${product.value_proposition}
-
-`;
-  }
-
-  if (goals.length > 0) {
-    md += `## Objetivos
-
-`;
-    // Agrupar por categoria
-    const byCategory: Record<string, any[]> = {};
-    for (const goal of goals) {
-      if (!byCategory[goal.category]) byCategory[goal.category] = [];
-      byCategory[goal.category].push(goal);
-    }
-
-    for (const [category, categoryGoals] of Object.entries(byCategory)) {
-      md += `### ${category.charAt(0).toUpperCase() + category.slice(1)}
-
-`;
-      for (const goal of categoryGoals) {
-        const priority = goal.priority === "high" ? " **[ALTA]**" : goal.priority === "low" ? " [baixa]" : "";
-        md += `- ${goal.goal}${priority}\n`;
-      }
-      md += "\n";
-    }
-  }
-
-  if (features.length > 0) {
-    md += `## Features Core
-
-| Feature | Descricao | Prioridade |
-|---------|-----------|------------|
-`;
-    for (const feature of features) {
-      md += `| ${feature.name} | ${feature.description || "-"} | ${feature.priority} |\n`;
-    }
-    md += "\n";
-  }
-
-  if (product.success_metrics) {
-    const metrics = JSON.parse(product.success_metrics);
-    if (metrics.length > 0) {
-      md += `## Metricas de Sucesso
-
-`;
-      for (const metric of metrics) {
-        md += `- ${metric}\n`;
-      }
-      md += "\n";
-    }
-  }
-
-  if (product.out_of_scope) {
-    const outOfScope = JSON.parse(product.out_of_scope);
-    if (outOfScope.length > 0) {
-      md += `## Fora do Escopo
-
-> Estas funcionalidades NAO serao implementadas nesta versao.
-
-`;
-      for (const item of outOfScope) {
-        md += `- ~~${item}~~\n`;
-      }
-      md += "\n";
-    }
-  }
-
-  if (product.constraints) {
-    const constraints = JSON.parse(product.constraints);
-    if (constraints.length > 0) {
-      md += `## Restricoes
-
-> Limitacoes conhecidas que devem ser respeitadas.
-
-`;
-      for (const item of constraints) {
-        md += `- **${item}**\n`;
-      }
-      md += "\n";
-    }
-  }
-
-  // Garantir que diretorio existe
-  const mdPath = join(process.cwd(), ".codexa", "product-context.md");
-  writeFileSync(mdPath, md);
-}
+import { getDb } from "../db/connection";
+import { initSchema } from "../db/schema";
+import { existsSync, readFileSync, writeFileSync } from "fs";
+import { join } from "path";
+
+interface ProductContext {
+  name: string;
+  problem: string;
+  solution?: string;
+  targetUsers?: string;
+  valueProposition?: string;
+  successMetrics?: string[];
+  outOfScope?: string[];
+  constraints?: string[];
+}
+
+interface ProductGoal {
+  category: string;
+  goal: string;
+  priority: "high" | "medium" | "low";
+}
+
+interface ProductFeature {
+  name: string;
+  description?: string;
+  priority: "high" | "medium" | "low";
+}
+
+// ═══════════════════════════════════════════════════════════════
+// PRODUCT GUIDE - Inicia o processo guiado
+// ═══════════════════════════════════════════════════════════════
+
+export function productGuide(json: boolean = false): void {
+  initSchema();
+  const db = getDb();
+
+  // Verificar se ja existe
+  const existing = db.query("SELECT * FROM product_context WHERE id = 'default'").get();
+  if (existing) {
+    console.log("\nContexto de produto ja definido.");
+    console.log("Use: product show para ver detalhes");
+    console.log("Ou: product reset para refazer\n");
+    return;
+  }
+
+  if (json) {
+    console.log(JSON.stringify({ status: "ready_for_guide", message: "Use AskUserQuestion para guiar o usuario" }, null, 2));
+    return;
+  }
+
+  console.log("\n" + "═".repeat(60));
+  console.log("PRODUCT DISCOVERY - Modo Guiado");
+  console.log("═".repeat(60));
+  console.log(`
+Este modo vai ajudar a definir o contexto do produto atraves de perguntas.
+
+O agente vai usar AskUserQuestion para coletar:
+1. Nome do produto
+2. Problema que resolve
+3. Solucao proposta
+4. Usuarios alvo
+5. Proposta de valor
+6. Metricas de sucesso
+7. O que esta fora do escopo
+8. Restricoes conhecidas
+
+Apos coletar as respostas, use:
+  product set --name "..." --problem "..." ...
+
+Para confirmar e salvar:
+  product confirm
+`);
+  console.log("─".repeat(60) + "\n");
+}
+
+// ═══════════════════════════════════════════════════════════════
+// PRODUCT IMPORT - Importa PRD existente
+// ═══════════════════════════════════════════════════════════════
+
+export function productImport(options: { file?: string; content?: string }): void {
+  initSchema();
+  const db = getDb();
+
+  // Verificar se ja existe
+  const existing = db.query("SELECT * FROM product_context WHERE id = 'default'").get();
+  if (existing) {
+    console.log("\nContexto de produto ja definido.");
+    console.log("Use: product reset para refazer\n");
+    return;
+  }
+
+  let prdContent = "";
+
+  if (options.file) {
+    if (!existsSync(options.file)) {
+      console.error(`\nArquivo nao encontrado: ${options.file}\n`);
+      process.exit(1);
+    }
+    prdContent = readFileSync(options.file, "utf-8");
+  } else if (options.content) {
+    prdContent = options.content;
+  } else {
+    console.error("\nForneca --file ou --content\n");
+    process.exit(1);
+  }
+
+  // Salvar como pendente para o agente processar
+  const now = new Date().toISOString();
+  db.run(
+    `INSERT INTO product_context (id, name, problem, source, discovered_at, updated_at)
+     VALUES ('pending', 'Pendente - PRD Importado', ?, 'import', ?, ?)`,
+    [prdContent, now, now]
+  );
+
+  console.log("\n" + "═".repeat(60));
+  console.log("PRD IMPORTADO");
+  console.log("═".repeat(60));
+  console.log(`
+Conteudo do PRD foi salvo para processamento.
+
+O agente deve agora:
+1. Analisar o PRD importado
+2. Extrair informacoes estruturadas
+3. Usar 'product set' para definir os campos
+4. Usar 'product confirm' para finalizar
+
+Comando para ver o PRD:
+  product show --pending
+`);
+  console.log("─".repeat(60) + "\n");
+}
+
+// ═══════════════════════════════════════════════════════════════
+// PRODUCT SET - Define campos do produto
+// ═══════════════════════════════════════════════════════════════
+
+export function productSet(options: {
+  name?: string;
+  problem?: string;
+  solution?: string;
+  targetUsers?: string;
+  valueProposition?: string;
+  successMetrics?: string;
+  outOfScope?: string;
+  constraints?: string;
+}): void {
+  initSchema();
+  const db = getDb();
+
+  // Buscar pendente ou criar novo
+  let pending = db.query("SELECT * FROM product_context WHERE id = 'pending'").get() as any;
+  const now = new Date().toISOString();
+
+  if (!pending) {
+    // Criar novo registro pendente
+    db.run(
+      `INSERT INTO product_context (id, name, problem, source, discovered_at, updated_at)
+       VALUES ('pending', 'Pendente', '', 'guide', ?, ?)`,
+      [now, now]
+    );
+    pending = { name: "Pendente", problem: "" };
+  }
+
+  // Atualizar campos fornecidos
+  const updates: string[] = [];
+  const values: any[] = [];
+
+  if (options.name) {
+    updates.push("name = ?");
+    values.push(options.name);
+  }
+  if (options.problem) {
+    updates.push("problem = ?");
+    values.push(options.problem);
+  }
+  if (options.solution) {
+    updates.push("solution = ?");
+    values.push(options.solution);
+  }
+  if (options.targetUsers) {
+    updates.push("target_users = ?");
+    values.push(options.targetUsers);
+  }
+  if (options.valueProposition) {
+    updates.push("value_proposition = ?");
+    values.push(options.valueProposition);
+  }
+  if (options.successMetrics) {
+    updates.push("success_metrics = ?");
+    values.push(JSON.stringify(options.successMetrics.split(",")));
+  }
+  if (options.outOfScope) {
+    updates.push("out_of_scope = ?");
+    values.push(JSON.stringify(options.outOfScope.split(",")));
+  }
+  if (options.constraints) {
+    updates.push("constraints = ?");
+    values.push(JSON.stringify(options.constraints.split(",")));
+  }
+
+  if (updates.length > 0) {
+    updates.push("updated_at = ?");
+    values.push(now);
+    values.push("pending");
+
+    db.run(
+      `UPDATE product_context SET ${updates.join(", ")} WHERE id = ?`,
+      values
+    );
+  }
+
+  // Mostrar estado atual
+  const current = db.query("SELECT * FROM product_context WHERE id = 'pending'").get() as any;
+
+  console.log("\nContexto de produto atualizado:");
+  console.log("─".repeat(40));
+  if (current.name !== "Pendente") console.log(`  Nome: ${current.name}`);
+  if (current.problem) console.log(`  Problema: ${current.problem.substring(0, 50)}...`);
+  if (current.solution) console.log(`  Solucao: ${current.solution.substring(0, 50)}...`);
+  if (current.target_users) console.log(`  Usuarios: ${current.target_users.substring(0, 50)}...`);
+  if (current.value_proposition) console.log(`  Proposta: ${current.value_proposition.substring(0, 50)}...`);
+  console.log("\nPara confirmar: product confirm\n");
+}
+
+// ═══════════════════════════════════════════════════════════════
+// PRODUCT GOAL ADD - Adiciona objetivo
+// ═══════════════════════════════════════════════════════════════
+
+export function productGoalAdd(options: {
+  category: string;
+  goal: string;
+  priority?: string;
+}): void {
+  initSchema();
+  const db = getDb();
+
+  const now = new Date().toISOString();
+  const priority = options.priority || "medium";
+
+  db.run(
+    `INSERT INTO product_goals (product_id, category, goal, priority, created_at)
+     VALUES ('pending', ?, ?, ?, ?)`,
+    [options.category, options.goal, priority, now]
+  );
+
+  const count = db.query("SELECT COUNT(*) as c FROM product_goals WHERE product_id = 'pending'").get() as any;
+
+  console.log(`\nObjetivo adicionado (${count.c} total)`);
+  console.log(`  [${options.category}] ${options.goal} (${priority})\n`);
+}
+
+// ═══════════════════════════════════════════════════════════════
+// PRODUCT FEATURE ADD - Adiciona feature core
+// ═══════════════════════════════════════════════════════════════
+
+export function productFeatureAdd(options: {
+  name: string;
+  description?: string;
+  priority?: string;
+}): void {
+  initSchema();
+  const db = getDb();
+
+  const now = new Date().toISOString();
+  const priority = options.priority || "medium";
+
+  db.run(
+    `INSERT INTO product_features (product_id, name, description, priority, created_at)
+     VALUES ('pending', ?, ?, ?, ?)`,
+    [options.name, options.description || "", priority, now]
+  );
+
+  const count = db.query("SELECT COUNT(*) as c FROM product_features WHERE product_id = 'pending'").get() as any;
+
+  console.log(`\nFeature adicionada (${count.c} total)`);
+  console.log(`  ${options.name} (${priority})\n`);
+}
+
+// ═══════════════════════════════════════════════════════════════
+// PRODUCT CONFIRM - Confirma e salva
+// ═══════════════════════════════════════════════════════════════
+
+export function productConfirm(): void {
+  initSchema();
+  const db = getDb();
+
+  const pending = db.query("SELECT * FROM product_context WHERE id = 'pending'").get() as any;
+  if (!pending) {
+    console.error("\nNenhum contexto de produto pendente.");
+    console.error("Execute: product guide ou product import primeiro\n");
+    process.exit(1);
+  }
+
+  // Validar campos obrigatorios
+  if (!pending.name || pending.name === "Pendente") {
+    console.error("\nCampo obrigatorio ausente: name");
+    console.error("Use: product set --name \"Nome do Produto\"\n");
+    process.exit(1);
+  }
+  if (!pending.problem || pending.problem === "") {
+    console.error("\nCampo obrigatorio ausente: problem");
+    console.error("Use: product set --problem \"Problema que resolve\"\n");
+    process.exit(1);
+  }
+
+  const now = new Date().toISOString();
+
+  // Desabilitar foreign keys temporariamente para permitir a migração
+  db.run("PRAGMA foreign_keys = OFF");
+
+  // Deletar goals e features do 'default' ANTES de deletar product_context
+  db.run("DELETE FROM product_goals WHERE product_id = 'default'");
+  db.run("DELETE FROM product_features WHERE product_id = 'default'");
+  db.run("DELETE FROM product_context WHERE id = 'default'");
+
+  // Mover pending para default (primeiro os filhos, depois o pai)
+  db.run(`UPDATE product_goals SET product_id = 'default' WHERE product_id = 'pending'`);
+  db.run(`UPDATE product_features SET product_id = 'default' WHERE product_id = 'pending'`);
+  db.run(
+    `UPDATE product_context SET id = 'default', updated_at = ? WHERE id = 'pending'`,
+    [now]
+  );
+
+  // Reabilitar foreign keys
+  db.run("PRAGMA foreign_keys = ON");
+
+  // Gerar arquivo product-context.md
+  generateProductMarkdown();
+
+  const goalsCount = db.query("SELECT COUNT(*) as c FROM product_goals WHERE product_id = 'default'").get() as any;
+  const featuresCount = db.query("SELECT COUNT(*) as c FROM product_features WHERE product_id = 'default'").get() as any;
+
+  console.log("\n" + "═".repeat(60));
+  console.log("PRODUTO CONFIGURADO");
+  console.log("═".repeat(60));
+  console.log(`
+  Nome: ${pending.name}
+  Objetivos: ${goalsCount.c}
+  Features: ${featuresCount.c}
+
+Arquivo gerado: .codexa/product-context.md
+
+Proximo passo: /codexa:feature para iniciar uma feature
+`);
+  console.log("─".repeat(60) + "\n");
+}
+
+// ═══════════════════════════════════════════════════════════════
+// PRODUCT SHOW - Mostra contexto atual
+// ═══════════════════════════════════════════════════════════════
+
+export function productShow(options: { json?: boolean; pending?: boolean } = {}): void {
+  initSchema();
+  const db = getDb();
+
+  const id = options.pending ? "pending" : "default";
+  const product = db.query(`SELECT * FROM product_context WHERE id = ?`).get(id) as any;
+
+  if (!product) {
+    if (options.pending) {
+      console.error("\nNenhum contexto pendente.");
+    } else {
+      console.error("\nContexto de produto nao definido.");
+      console.error("Execute: product guide ou product import\n");
+    }
+    process.exit(1);
+  }
+
+  const goals = db.query(`SELECT * FROM product_goals WHERE product_id = ? ORDER BY priority, category`).all(id) as any[];
+  const features = db.query(`SELECT * FROM product_features WHERE product_id = ? ORDER BY priority`).all(id) as any[];
+
+  if (options.json) {
+    console.log(JSON.stringify({
+      product,
+      goals,
+      features,
+      successMetrics: product.success_metrics ? JSON.parse(product.success_metrics) : [],
+      outOfScope: product.out_of_scope ? JSON.parse(product.out_of_scope) : [],
+      constraints: product.constraints ? JSON.parse(product.constraints) : [],
+    }, null, 2));
+    return;
+  }
+
+  console.log("\n" + "═".repeat(60));
+  console.log(`CONTEXTO DO PRODUTO${options.pending ? " (PENDENTE)" : ""}`);
+  console.log("═".repeat(60));
+
+  console.log(`\nNome: ${product.name}`);
+  console.log(`Fonte: ${product.source}`);
+
+  console.log("\n" + "─".repeat(40));
+  console.log("PROBLEMA");
+  console.log("─".repeat(40));
+  console.log(product.problem);
+
+  if (product.solution) {
+    console.log("\n" + "─".repeat(40));
+    console.log("SOLUCAO");
+    console.log("─".repeat(40));
+    console.log(product.solution);
+  }
+
+  if (product.target_users) {
+    console.log("\n" + "─".repeat(40));
+    console.log("USUARIOS ALVO");
+    console.log("─".repeat(40));
+    console.log(product.target_users);
+  }
+
+  if (product.value_proposition) {
+    console.log("\n" + "─".repeat(40));
+    console.log("PROPOSTA DE VALOR");
+    console.log("─".repeat(40));
+    console.log(product.value_proposition);
+  }
+
+  if (goals.length > 0) {
+    console.log("\n" + "─".repeat(40));
+    console.log("OBJETIVOS");
+    console.log("─".repeat(40));
+    for (const goal of goals) {
+      const icon = goal.priority === "high" ? "!" : goal.priority === "low" ? "-" : "*";
+      console.log(`  ${icon} [${goal.category}] ${goal.goal}`);
+    }
+  }
+
+  if (features.length > 0) {
+    console.log("\n" + "─".repeat(40));
+    console.log("FEATURES CORE");
+    console.log("─".repeat(40));
+    for (const feature of features) {
+      const icon = feature.priority === "high" ? "!" : feature.priority === "low" ? "-" : "*";
+      console.log(`  ${icon} ${feature.name}${feature.description ? `: ${feature.description}` : ""}`);
+    }
+  }
+
+  if (product.success_metrics) {
+    const metrics = JSON.parse(product.success_metrics);
+    if (metrics.length > 0) {
+      console.log("\n" + "─".repeat(40));
+      console.log("METRICAS DE SUCESSO");
+      console.log("─".repeat(40));
+      for (const metric of metrics) {
+        console.log(`  - ${metric}`);
+      }
+    }
+  }
+
+  if (product.out_of_scope) {
+    const outOfScope = JSON.parse(product.out_of_scope);
+    if (outOfScope.length > 0) {
+      console.log("\n" + "─".repeat(40));
+      console.log("FORA DO ESCOPO");
+      console.log("─".repeat(40));
+      for (const item of outOfScope) {
+        console.log(`  x ${item}`);
+      }
+    }
+  }
+
+  if (product.constraints) {
+    const constraints = JSON.parse(product.constraints);
+    if (constraints.length > 0) {
+      console.log("\n" + "─".repeat(40));
+      console.log("RESTRICOES");
+      console.log("─".repeat(40));
+      for (const item of constraints) {
+        console.log(`  ! ${item}`);
+      }
+    }
+  }
+
+  console.log("\n" + "─".repeat(60));
+  if (!options.pending) {
+    console.log("Arquivo: .codexa/product-context.md");
+  }
+  console.log("");
+}
+
+// ═══════════════════════════════════════════════════════════════
+// PRODUCT RESET - Reseta contexto de produto
+// ═══════════════════════════════════════════════════════════════
+
+export function productReset(): void {
+  initSchema();
+  const db = getDb();
+
+  db.run("DELETE FROM product_features");
+  db.run("DELETE FROM product_goals");
+  db.run("DELETE FROM product_context");
+
+  console.log("\nContexto de produto resetado.");
+  console.log("Execute: product guide ou product import para refazer\n");
+}
+
+// ═══════════════════════════════════════════════════════════════
+// GENERATE MARKDOWN
+// ═══════════════════════════════════════════════════════════════
+
+function generateProductMarkdown(): void {
+  const db = getDb();
+  const product = db.query("SELECT * FROM product_context WHERE id = 'default'").get() as any;
+  const goals = db.query("SELECT * FROM product_goals WHERE product_id = 'default' ORDER BY priority, category").all() as any[];
+  const features = db.query("SELECT * FROM product_features WHERE product_id = 'default' ORDER BY priority").all() as any[];
+
+  if (!product) return;
+
+  let md = `# ${product.name} - Contexto de Produto
+
+> Gerado automaticamente do SQLite. Nao edite manualmente.
+> Para modificar, use os comandos CLI.
+> Gerado em: ${new Date().toISOString()}
+> Fonte: ${product.source}
+
+## Problema
+
+${product.problem}
+
+`;
+
+  if (product.solution) {
+    md += `## Solucao
+
+${product.solution}
+
+`;
+  }
+
+  if (product.target_users) {
+    md += `## Usuarios Alvo
+
+${product.target_users}
+
+`;
+  }
+
+  if (product.value_proposition) {
+    md += `## Proposta de Valor
+
+${product.value_proposition}
+
+`;
+  }
+
+  if (goals.length > 0) {
+    md += `## Objetivos
+
+`;
+    // Agrupar por categoria
+    const byCategory: Record<string, any[]> = {};
+    for (const goal of goals) {
+      if (!byCategory[goal.category]) byCategory[goal.category] = [];
+      byCategory[goal.category].push(goal);
+    }
+
+    for (const [category, categoryGoals] of Object.entries(byCategory)) {
+      md += `### ${category.charAt(0).toUpperCase() + category.slice(1)}
+
+`;
+      for (const goal of categoryGoals) {
+        const priority = goal.priority === "high" ? " **[ALTA]**" : goal.priority === "low" ? " [baixa]" : "";
+        md += `- ${goal.goal}${priority}\n`;
+      }
+      md += "\n";
+    }
+  }
+
+  if (features.length > 0) {
+    md += `## Features Core
+
+| Feature | Descricao | Prioridade |
+|---------|-----------|------------|
+`;
+    for (const feature of features) {
+      md += `| ${feature.name} | ${feature.description || "-"} | ${feature.priority} |\n`;
+    }
+    md += "\n";
+  }
+
+  if (product.success_metrics) {
+    const metrics = JSON.parse(product.success_metrics);
+    if (metrics.length > 0) {
+      md += `## Metricas de Sucesso
+
+`;
+      for (const metric of metrics) {
+        md += `- ${metric}\n`;
+      }
+      md += "\n";
+    }
+  }
+
+  if (product.out_of_scope) {
+    const outOfScope = JSON.parse(product.out_of_scope);
+    if (outOfScope.length > 0) {
+      md += `## Fora do Escopo
+
+> Estas funcionalidades NAO serao implementadas nesta versao.
+
+`;
+      for (const item of outOfScope) {
+        md += `- ~~${item}~~\n`;
+      }
+      md += "\n";
+    }
+  }
+
+  if (product.constraints) {
+    const constraints = JSON.parse(product.constraints);
+    if (constraints.length > 0) {
+      md += `## Restricoes
+
+> Limitacoes conhecidas que devem ser respeitadas.
+
+`;
+      for (const item of constraints) {
+        md += `- **${item}**\n`;
+      }
+      md += "\n";
+    }
+  }
+
+  // Garantir que diretorio existe
+  const mdPath = join(process.cwd(), ".codexa", "product-context.md");
+  writeFileSync(mdPath, md);
+}