@shahmarasy/prodo 0.1.4 → 0.1.6

package/src/{agents.ts → cli/agent-ids.ts}

@@ -1,58 +1,58 @@
-import { UserError } from "./errors";
-
-export const AGENT_IDS = ["codex", "gemini-cli", "claude-cli"] as const;
-export type AgentId = (typeof AGENT_IDS)[number];
-
-export function isSupportedAgent(agent?: string): agent is AgentId {
-  if (!agent) return false;
-  return AGENT_IDS.includes(agent as AgentId);
-}
-
-export function resolveAgent(agent?: string): AgentId | undefined {
-  if (!agent) return undefined;
-  if (!isSupportedAgent(agent)) {
-    throw new UserError(`Unsupported agent: ${agent}. Supported: ${AGENT_IDS.join(", ")}`);
-  }
-  return agent;
-}
-
-export type CommandSetItem = {
-  command: string;
-  purpose: string;
-};
-
-export type AgentCommandSet = {
-  agent: string;
-  description?: string;
-  recommended_sequence?: CommandSetItem[];
-  artifact_shortcuts?: Record<string, string>;
-};
-
-export async function loadAgentCommandSet(_cwd: string, agent: AgentId): Promise<AgentCommandSet> {
-  const prefix = "/prodo";
-  return {
-    agent,
-    description: "Agent-specific command set for Prodo artifact pipeline.",
-    recommended_sequence: [
-      { command: "prodo init . --ai <agent> --lang <en|tr>", purpose: "Initialize Prodo scaffold and agent commands." },
-      { command: `${prefix}-normalize`, purpose: "Normalize start brief into normalized brief JSON." },
-      { command: `${prefix}-prd`, purpose: "Generate PRD artifact." },
-      { command: `${prefix}-workflow`, purpose: "Generate workflow artifact." },
-      { command: `${prefix}-wireframe`, purpose: "Generate wireframe artifact." },
-      { command: `${prefix}-stories`, purpose: "Generate stories artifact." },
-      { command: `${prefix}-techspec`, purpose: "Generate techspec artifact." },
-      { command: `${prefix}-validate`, purpose: "Run validation report." },
-      { command: `${prefix}-fix`, purpose: "Fix artifacts when validation fails." }
-    ],
-    artifact_shortcuts: {
-      normalize: `${prefix}-normalize`,
-      prd: `${prefix}-prd`,
-      workflow: `${prefix}-workflow`,
-      wireframe: `${prefix}-wireframe`,
-      stories: `${prefix}-stories`,
-      techspec: `${prefix}-techspec`,
-      validate: `${prefix}-validate`,
-      fix: `${prefix}-fix`
-    }
-  };
-}
+import { UserError } from "../core/errors";
+
+export const AGENT_IDS = ["codex", "gemini-cli", "claude-cli"] as const;
+export type AgentId = (typeof AGENT_IDS)[number];
+
+export function isSupportedAgent(agent?: string): agent is AgentId {
+  if (!agent) return false;
+  return AGENT_IDS.includes(agent as AgentId);
+}
+
+export function resolveAgent(agent?: string): AgentId | undefined {
+  if (!agent) return undefined;
+  if (!isSupportedAgent(agent)) {
+    throw new UserError(`Unsupported agent: ${agent}. Supported: ${AGENT_IDS.join(", ")}`);
+  }
+  return agent;
+}
+
+export type CommandSetItem = {
+  command: string;
+  purpose: string;
+};
+
+export type AgentCommandSet = {
+  agent: string;
+  description?: string;
+  recommended_sequence?: CommandSetItem[];
+  artifact_shortcuts?: Record<string, string>;
+};
+
+export async function loadAgentCommandSet(_cwd: string, agent: AgentId): Promise<AgentCommandSet> {
+  const prefix = "/prodo";
+  return {
+    agent,
+    description: "Agent-specific command set for Prodo artifact pipeline.",
+    recommended_sequence: [
+      { command: "prodo init . --ai <agent> --lang <en|tr>", purpose: "Initialize Prodo scaffold and agent commands." },
+      { command: `${prefix}-normalize`, purpose: "Normalize start brief into normalized brief JSON." },
+      { command: `${prefix}-prd`, purpose: "Generate PRD artifact." },
+      { command: `${prefix}-workflow`, purpose: "Generate workflow artifact." },
+      { command: `${prefix}-wireframe`, purpose: "Generate wireframe artifact." },
+      { command: `${prefix}-stories`, purpose: "Generate stories artifact." },
+      { command: `${prefix}-techspec`, purpose: "Generate techspec artifact." },
+      { command: `${prefix}-validate`, purpose: "Run validation report." },
+      { command: `${prefix}-fix`, purpose: "Fix artifacts when validation fails." }
+    ],
+    artifact_shortcuts: {
+      normalize: `${prefix}-normalize`,
+      prd: `${prefix}-prd`,
+      workflow: `${prefix}-workflow`,
+      wireframe: `${prefix}-wireframe`,
+      stories: `${prefix}-stories`,
+      techspec: `${prefix}-techspec`,
+      validate: `${prefix}-validate`,
+      fix: `${prefix}-fix`
+    }
+  };
+}

package/src/{doctor.ts → cli/doctor.ts}

@@ -1,137 +1,157 @@
-import path from "node:path";
-import { spawn } from "node:child_process";
-import { prodoPath } from "./paths";
-import { fileExists } from "./utils";
-import { readCliVersion } from "./version";
-
-type RowStatus = "available" | "not_found" | "ide";
-
-type DoctorRow = {
-  name: string;
-  status: RowStatus;
-  detail: string;
-};
-
-function termWidth(): number {
-  return Math.max(80, process.stdout.columns ?? 100);
-}
-
-function stripAnsi(input: string): string {
-  return input.replace(/\u001B\[[0-9;]*m/g, "");
-}
-
-function color(input: string, code: string): string {
-  if (!process.stdout.isTTY) return input;
-  return `${code}${input}\u001B[0m`;
-}
-
-function center(input: string, width: number): string {
-  const visible = stripAnsi(input).length;
-  const left = Math.max(0, Math.floor((width - visible) / 2));
-  return `${" ".repeat(left)}${input}`;
-}
-
-function iconFor(status: RowStatus): string {
-  if (status === "available") return color("✔", "\u001B[32m");
-  if (status === "not_found") return color("✖", "\u001B[31m");
-  return color("•", "\u001B[33m");
-}
-
-function labelFor(status: RowStatus): string {
-  if (status === "available") return color("available", "\u001B[32m");
-  if (status === "not_found") return color("not found", "\u001B[31m");
-  return color("IDE-based", "\u001B[2;33m");
-}
-
-function renderRows(rows: DoctorRow[]): string[] {
-  const leftWidth = Math.max(...rows.map((row) => row.name.length), 10);
-  return rows.map((row) => {
-    const left = row.name.padEnd(leftWidth, " ");
-    const status = `${labelFor(row.status)}${row.detail ? ` (${row.detail})` : ""}`;
-    return ` ${iconFor(row.status)}  ${left}  ${status}`;
-  });
-}
-
-async function commandExists(command: string): Promise<boolean> {
-  return new Promise((resolve) => {
-    const lookup = process.platform === "win32" ? "where" : "which";
-    const child = spawn(lookup, [command], { stdio: "ignore" });
-    child.on("error", () => resolve(false));
-    child.on("close", (code) => resolve(code === 0));
-  });
-}
-
-async function firstAvailable(commands: string[]): Promise<boolean> {
-  for (const command of commands) {
-    if (await commandExists(command)) return true;
-  }
-  return false;
-}
-
-function renderLogo(width: number): string {
-  const cyan = "\u001B[38;5;45m";
-  const blue = "\u001B[38;5;39m";
-  const logo = [
-    "██████╗ ██████╗  ██████╗ ██████╗  ██████╗ ",
-    "██╔══██╗██╔══██╗██╔═══██╗██╔══██╗██╔═══██╗",
-    "██████╔╝██████╔╝██║   ██║██║  ██║██║   ██║",
-    "██╔═══╝ ██╔══██╗██║   ██║██║  ██║██║   ██║",
-    "██║     ██║  ██║╚██████╔╝██████╔╝╚██████╔╝"
-  ];
-  const painted = logo.map((line, idx) => color(line, idx % 2 === 0 ? cyan : blue));
-  return painted.map((line) => center(line, width)).join("\n");
-}
-
-export async function runDoctor(cwd: string, out: (line: string) => void): Promise<void> {
-  const width = termWidth();
-  const version = await readCliVersion(cwd);
-  const isInitialized = await fileExists(prodoPath(cwd));
-
-  const codex = await firstAvailable(["codex"]);
-  const gemini = await firstAvailable(["gemini", "gemini-cli"]);
-  const claude = await firstAvailable(["claude", "claude-cli"]);
-
-  const git = await firstAvailable(["git"]);
-  const node = await firstAvailable(["node"]);
-  const vscode = await firstAvailable(["code"]);
-
-  const coreRows: DoctorRow[] = [
-    { name: "Prodo CLI", status: "available", detail: `v${version}` },
-    {
-      name: "Project initialized",
-      status: isInitialized ? "available" : "not_found",
-      detail: isInitialized ? ".prodo found" : ".prodo missing"
-    }
-  ];
-
-  const aiRows: DoctorRow[] = [
-    { name: "Codex CLI", status: codex ? "available" : "not_found", detail: codex ? "available" : "not found" },
-    { name: "Gemini CLI", status: gemini ? "available" : "not_found", detail: gemini ? "available" : "not found" },
-    { name: "Claude CLI", status: claude ? "available" : "not_found", detail: claude ? "available" : "not found" }
-  ];
-
-  const devRows: DoctorRow[] = [
-    { name: "Git", status: git ? "available" : "not_found", detail: git ? "available" : "not found" },
-    { name: "Node.js", status: node ? "available" : "not_found", detail: node ? "available" : "not found" },
-    { name: "Visual Studio Code", status: vscode ? "available" : "not_found", detail: vscode ? "available" : "not found" },
-    { name: "Cursor", status: "ide", detail: "IDE-based, no CLI check" }
-  ];
-
-  out("");
-  out(renderLogo(width));
-  out("");
-  out(center(color("Prodo — Product Artifact Toolkit", "\u001B[1;37m"), width));
-  out(center(color("Crafted by Codex, guided by Shahmarasy intelligence", "\u001B[2;37m"), width));
-  out("");
-  out("Checking environment...");
-  out("");
-  out(color("Core", "\u001B[1m"));
-  for (const line of renderRows(coreRows)) out(line);
-  out("");
-  out(color("AI / Agents", "\u001B[1m"));
-  for (const line of renderRows(aiRows)) out(line);
-  out("");
-  out(color("Dev Tools", "\u001B[1m"));
-  for (const line of renderRows(devRows)) out(line);
-  out("");
-}
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { getGlobalRegistry } from "../agents/agent-registry";
+import { prodoPath } from "../core/paths";
+import { fileExists } from "../core/utils";
+import { readCliVersion } from "../core/version";
+
+type RowStatus = "available" | "not_found" | "ide";
+
+type DoctorRow = {
+  name: string;
+  status: RowStatus;
+  detail: string;
+};
+
+function termWidth(): number {
+  return Math.max(80, process.stdout.columns ?? 100);
+}
+
+function stripAnsi(input: string): string {
+  return input.replace(/\u001B\[[0-9;]*m/g, "");
+}
+
+function color(input: string, code: string): string {
+  if (!process.stdout.isTTY) return input;
+  return `${code}${input}\u001B[0m`;
+}
+
+function center(input: string, width: number): string {
+  const visible = stripAnsi(input).length;
+  const left = Math.max(0, Math.floor((width - visible) / 2));
+  return `${" ".repeat(left)}${input}`;
+}
+
+function iconFor(status: RowStatus): string {
+  if (status === "available") return color("✔", "\u001B[32m");
+  if (status === "not_found") return color("✖", "\u001B[31m");
+  return color("•", "\u001B[33m");
+}
+
+function labelFor(status: RowStatus): string {
+  if (status === "available") return color("available", "\u001B[32m");
+  if (status === "not_found") return color("not found", "\u001B[31m");
+  return color("IDE-based", "\u001B[2;33m");
+}
+
+function renderRows(rows: DoctorRow[]): string[] {
+  const leftWidth = Math.max(...rows.map((row) => row.name.length), 10);
+  return rows.map((row) => {
+    const left = row.name.padEnd(leftWidth, " ");
+    const status = `${labelFor(row.status)}${row.detail ? ` (${row.detail})` : ""}`;
+    return ` ${iconFor(row.status)}  ${left}  ${status}`;
+  });
+}
+
+async function commandExists(command: string): Promise<boolean> {
+  return new Promise((resolve) => {
+    const lookup = process.platform === "win32" ? "where" : "which";
+    const child = spawn(lookup, [command], { stdio: "ignore" });
+    child.on("error", () => resolve(false));
+    child.on("close", (code) => resolve(code === 0));
+  });
+}
+
+async function firstAvailable(commands: string[]): Promise<boolean> {
+  for (const command of commands) {
+    if (await commandExists(command)) return true;
+  }
+  return false;
+}
+
+function renderLogo(width: number): string {
+  const cyan = "\u001B[38;5;45m";
+  const blue = "\u001B[38;5;39m";
+  const logo = [
+    "██████╗ ██████╗  ██████╗ ██████╗  ██████╗ ",
+    "██╔══██╗██╔══██╗██╔═══██╗██╔══██╗██╔═══██╗",
+    "██████╔╝██████╔╝██║   ██║██║  ██║██║   ██║",
+    "██╔═══╝ ██╔══██╗██║   ██║██║  ██║██║   ██║",
+    "██║     ██║  ██║╚██████╔╝██████╔╝╚██████╔╝"
+  ];
+  const painted = logo.map((line, idx) => color(line, idx % 2 === 0 ? cyan : blue));
+  return painted.map((line) => center(line, width)).join("\n");
+}
+
+export async function runDoctor(cwd: string, out: (line: string) => void): Promise<void> {
+  const width = termWidth();
+  const version = await readCliVersion(cwd);
+  const isInitialized = await fileExists(prodoPath(cwd));
+
+  const codex = await firstAvailable(["codex"]);
+  const gemini = await firstAvailable(["gemini", "gemini-cli"]);
+  const claude = await firstAvailable(["claude", "claude-cli"]);
+
+  const git = await firstAvailable(["git"]);
+  const node = await firstAvailable(["node"]);
+  const vscode = await firstAvailable(["code"]);
+
+  const coreRows: DoctorRow[] = [
+    { name: "Prodo CLI", status: "available", detail: `v${version}` },
+    {
+      name: "Project initialized",
+      status: isInitialized ? "available" : "not_found",
+      detail: isInitialized ? ".prodo found" : ".prodo missing"
+    }
+  ];
+
+  const aiCliRows: DoctorRow[] = [
+    { name: "Codex CLI", status: codex ? "available" : "not_found", detail: codex ? "available" : "not found" },
+    { name: "Gemini CLI", status: gemini ? "available" : "not_found", detail: gemini ? "available" : "not found" },
+    { name: "Claude CLI", status: claude ? "available" : "not_found", detail: claude ? "available" : "not found" }
+  ];
+
+  const registry = getGlobalRegistry();
+  const agentRows: DoctorRow[] = [];
+  for (const agent of registry.list()) {
+    if (agent.name === "mock") continue;
+    const available = await agent.isAvailable();
+    const config = agent.getConfig();
+    const sdkLabel = config.sdkRequired ? `SDK: ${config.sdkRequired}` : "";
+    const envLabel = config.envVars.filter((v) => !process.env[v]).map((v) => `${v} missing`).join(", ");
+    const detail = available ? "ready" : [sdkLabel, envLabel].filter(Boolean).join(", ") || "not configured";
+    agentRows.push({
+      name: config.displayName,
+      status: available ? "available" : "not_found",
+      detail
+    });
+  }
+
+  const devRows: DoctorRow[] = [
+    { name: "Git", status: git ? "available" : "not_found", detail: git ? "available" : "not found" },
+    { name: "Node.js", status: node ? "available" : "not_found", detail: node ? "available" : "not found" },
+    { name: "Visual Studio Code", status: vscode ? "available" : "not_found", detail: vscode ? "available" : "not found" },
+    { name: "Cursor", status: "ide", detail: "IDE-based, no CLI check" }
+  ];
+
+  out("");
+  out(renderLogo(width));
+  out("");
+  out(center(color("Prodo — AI-Powered Product Owner", "\u001B[1;37m"), width));
+  out(center(color("Built by Shahmarasy · Works with Claude, Codex, and Gemini", "\u001B[2;37m"), width));
+  out("");
+  out("Checking environment...");
+  out("");
+  out(color("Core", "\u001B[1m"));
+  for (const line of renderRows(coreRows)) out(line);
+  out("");
+  out(color("AI CLI Tools", "\u001B[1m"));
+  for (const line of renderRows(aiCliRows)) out(line);
+  out("");
+  out(color("LLM Agents (SDK)", "\u001B[1m"));
+  for (const line of renderRows(agentRows)) out(line);
+  out("");
+  out(color("Dev Tools", "\u001B[1m"));
+  for (const line of renderRows(devRows)) out(line);
+  out("");
+}

package/src/cli/fix-tui.ts

@@ -0,0 +1,111 @@
+import type { FixProposal, FixResult } from "../core/fix";
+
+const dynamicImport = new Function("specifier", "return import(specifier)") as (
+  specifier: string
+) => Promise<unknown>;
+
+type ClackModule = {
+  intro: (title: string) => void;
+  outro: (message: string) => void;
+  cancel: (message: string) => void;
+  confirm: (opts: { message: string }) => Promise<boolean | symbol>;
+  isCancel: (value: unknown) => boolean;
+  log: {
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+    step: (message: string) => void;
+  };
+};
+
+async function loadClack(): Promise<ClackModule | null> {
+  try {
+    return (await dynamicImport("@clack/prompts")) as ClackModule;
+  } catch {
+    return null;
+  }
+}
+
+export async function displayFixProposal(
+  proposal: FixProposal,
+  log: (message: string) => void
+): Promise<void> {
+  const errorCount = proposal.issues.filter((i) => i.level === "error").length;
+  const warningCount = proposal.issues.filter((i) => i.level === "warning").length;
+
+  log("");
+  log(`Fix Proposal`);
+  log(`${"─".repeat(50)}`);
+  log(`Issues found: ${errorCount} error(s), ${warningCount} warning(s)`);
+  log(`Artifacts to regenerate: ${proposal.targets.join(", ")}`);
+  log("");
+
+  for (const [type, issues] of proposal.issuesByArtifact) {
+    log(`  ${type.toUpperCase()} (${issues.length} issue${issues.length > 1 ? "s" : ""}):`);
+    for (const issue of issues) {
+      const prefix = issue.level === "error" ? "  ✖" : "  ⚠";
+      log(`    ${prefix} [${issue.code}] ${issue.message}`);
+      if (issue.suggestion) {
+        log(`      → ${issue.suggestion}`);
+      }
+    }
+    log("");
+  }
+
+  const orphanIssues = proposal.issues.filter((i) => !i.artifactType);
+  if (orphanIssues.length > 0) {
+    log(`  General (${orphanIssues.length} issue${orphanIssues.length > 1 ? "s" : ""}):`);
+    for (const issue of orphanIssues) {
+      const prefix = issue.level === "error" ? "  ✖" : "  ⚠";
+      log(`    ${prefix} [${issue.code}] ${issue.message}`);
+    }
+    log("");
+  }
+}
+
+export async function confirmFixExecution(
+  proposal: FixProposal
+): Promise<boolean> {
+  if (process.stdout.isTTY !== true) {
+    return true;
+  }
+
+  const clack = await loadClack();
+  if (!clack) {
+    return true;
+  }
+
+  clack.intro("Prodo Fix");
+
+  const proceed = await clack.confirm({
+    message: `Regenerate ${proposal.targets.length} artifact(s): ${proposal.targets.join(", ")}?`
+  });
+
+  if (clack.isCancel(proceed)) {
+    clack.cancel("Fix cancelled.");
+    return false;
+  }
+
+  return proceed === true;
+}
+
+export async function displayFixResult(
+  result: FixResult,
+  log: (message: string) => void
+): Promise<void> {
+  log("");
+  if (result.finalPass) {
+    log("Fix complete — validation passed.");
+  } else {
+    log("Fix applied but validation still failing.");
+    log(`Review report: ${result.reportPath}`);
+    if (result.backupDir) {
+      log(`Backup saved: ${result.backupDir}`);
+    }
+  }
+
+  const clack = await loadClack();
+  if (clack && process.stdout.isTTY) {
+    clack.outro(result.finalPass ? "All gates passed!" : "Review report and retry.");
+  }
+}