@dunnewold-labs/mr-manager 0.4.18 → 0.4.21

package/dist/index.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // cli/index.ts
-import { Command as Command28 } from "commander";
+import { Command as Command29 } from "commander";
 import { existsSync as existsSync17 } from "fs";
 import { homedir as homedir3 } from "os";
 import { join as join12 } from "path";
@@ -185,7 +185,7 @@ import { fileURLToPath } from "url";
 // cli/package.json
 var package_default = {
   name: "@dunnewold-labs/mr-manager",
-  version: "0.4.18",
+  version: "0.4.21",
   description: "Mr. Manager - Task and project management CLI",
   bin: {
     mr: "./dist/index.mjs"
@@ -1341,6 +1341,19 @@ Rules:
 - The "context" field should be a single sentence.
 - Use sequential IDs: q1, q2, q3, etc.
 - Place the JSON block at the very end of the "Open Questions" section.`;
+var SYSTEM_SECTION_MR_TESTS = `## MR Tests \u2014 Feature Testing Scenarios
+
+Before writing your test plan, run:
+  mr tests
+
+This lists all human-authored test scenarios for this project. Each scenario describes how to navigate to a specific feature, what interactions to perform, and what to verify.
+
+If a scenario name matches the feature you're testing (by name or keyword):
+1. Use its interaction steps as the basis for your test plan.
+2. Adapt specific assertions to the task's requirements.
+3. Note in your test plan summary which scenario you used.
+
+If no matching scenario exists, infer interactions from the codebase as normal.`;
 var SYSTEM_SECTIONS = {
   "status-updates": SYSTEM_SECTION_STATUS_UPDATES,
   "screenshots": SYSTEM_SECTION_SCREENSHOTS,
@@ -1348,12 +1361,13 @@ var SYSTEM_SECTIONS = {
   "no-mr": SYSTEM_SECTION_NO_MR,
   "features-workflow": SYSTEM_SECTION_FEATURES_WORKFLOW,
   "prd-format": SYSTEM_SECTION_PRD_FORMAT,
-  "prd-open-questions": SYSTEM_SECTION_PRD_OPEN_QUESTIONS
+  "prd-open-questions": SYSTEM_SECTION_PRD_OPEN_QUESTIONS,
+  "mr-tests": SYSTEM_SECTION_MR_TESTS
 };
 function composeSystemPrompt(sections) {
   return sections.map((s) => SYSTEM_SECTIONS[s]).join("\n\n");
 }
-var EXECUTION_SYSTEM_SECTIONS = ["status-updates", "screenshots", "test-plan", "no-mr", "features-workflow"];
+var EXECUTION_SYSTEM_SECTIONS = ["status-updates", "screenshots", "test-plan", "mr-tests", "no-mr", "features-workflow"];
 var PRD_SYSTEM_SECTIONS = ["prd-format", "prd-open-questions"];
 var c = {
   reset: "\x1B[0m",
@@ -2166,6 +2180,7 @@ ${initPrompt}`] : [],
   ].join("\n");
 }
 function buildPrototypePrompt(proto, repoDir) {
+  const prototypeType = proto.prototypeType ?? "web_app";
   const variantSteps = [];
   for (let i = 1; i <= proto.variantCount; i++) {
     const filename = `prototype-${i}.html`;
@@ -2178,14 +2193,87 @@ function buildPrototypePrompt(proto, repoDir) {
     );
   }
   const variantList = Array.from({ length: proto.variantCount }, (_, i) => `prototype-${i + 1}.html`);
+  const typeConfig = {
+    web_app: {
+      role: "You are a UI designer and frontend engineer. Your job is to generate high-quality, visually distinct web app prototype variants based on the user's design request.",
+      guidelines: [
+        `- **Layout**: Grid, list, card, single-page, multi-section`,
+        `- **Style**: Minimal, bold, playful, corporate, retro, futuristic`,
+        `- **Color scheme**: Light, dark, colorful, monochrome`,
+        `- **Interaction model**: Click-heavy, scroll-based, hover effects, animated`,
+        `- **Information density**: Sparse, balanced, dense`,
+        `- **Navigation**: Sidebar, top nav, bottom nav, hamburger, tabs`
+      ],
+      rules: [
+        `- Each file must be a complete, functional page \u2014 pure HTML/CSS/JS, no external libraries (Tailwind CDN is acceptable).`
+      ]
+    },
+    mobile_app: {
+      role: "You are a mobile UI designer and frontend engineer. Your job is to generate high-quality, visually distinct mobile app prototype variants based on the user's design request.",
+      guidelines: [
+        `- **Viewport**: Use a mobile viewport (375px wide max, 812px tall). Center the phone frame on a neutral background.`,
+        `- **Layout**: Bottom tabs, stack navigation, cards, lists, full-screen views`,
+        `- **Style**: iOS-inspired, Material Design, custom/brand-driven, minimal`,
+        `- **Color scheme**: Light mode, dark mode, brand-colored`,
+        `- **Touch patterns**: Large tap targets (44px+), swipe gestures indicated, thumb-friendly navigation`,
+        `- **Typography**: Mobile-scale fonts (14-18px body), clear hierarchy`,
+        `- **Navigation**: Bottom tab bar, top navigation bar, hamburger drawer, floating action button`
+      ],
+      rules: [
+        `- Render the app as a phone-sized frame (375\xD7812px) centered on a light gray page background.`,
+        `- Use a \`<meta name="viewport" content="width=375">\` tag.`,
+        `- Each file must be a complete, functional HTML page \u2014 pure HTML/CSS/JS, no external libraries (Tailwind CDN is acceptable).`
+      ]
+    },
+    desktop_app: {
+      role: "You are a desktop UI designer and frontend engineer. Your job is to generate high-quality, visually distinct desktop application prototype variants based on the user's design request.",
+      guidelines: [
+        `- **Viewport**: Full-width desktop layout (1280px+). Use the full browser window.`,
+        `- **Layout**: Multi-panel, sidebar + main content, menubar, toolbar, status bar`,
+        `- **Style**: Native OS-inspired (macOS, Windows), Electron-style, productivity tool, pro/creative app`,
+        `- **Color scheme**: Light, dark, system-default`,
+        `- **Interaction**: Dense information layouts, keyboard shortcuts shown, right-click context menus, drag handles`,
+        `- **Navigation**: Left sidebar tree, top tabs, ribbon toolbar, split panes`
+      ],
+      rules: [
+        `- Design for 1280px+ wide layouts. Use the full browser viewport width.`,
+        `- Each file must be a complete, functional HTML page \u2014 pure HTML/CSS/JS, no external libraries (Tailwind CDN is acceptable).`
+      ]
+    },
+    logo: {
+      role: "You are a graphic designer specializing in logo and brand identity. Your job is to generate high-quality, visually distinct logo variants based on the user's brand brief.",
+      guidelines: [
+        `- **Style**: Wordmark, lettermark, icon + wordmark, abstract symbol, emblem/badge`,
+        `- **Visual language**: Minimal/geometric, organic/hand-drawn, bold/impactful, elegant/luxury, playful/friendly`,
+        `- **Color scheme**: Monochrome, duotone, full-color (max 3 colors), gradient`,
+        `- **Typography**: Serif, sans-serif, display/decorative, script`,
+        `- **Symbolism**: Use shapes, negative space, and iconography that reflect the brand concept`
+      ],
+      rules: [
+        `- Each file is an HTML page that displays the logo centered on a white background with a dark mode toggle.`,
+        `- The logo itself MUST be created as inline SVG \u2014 no raster images, no external assets.`,
+        `- Show the logo at three sizes: large (400px wide), medium (200px), small (80px) stacked vertically.`,
+        `- Include a dark background preview section below the logo to test contrast.`,
+        `- The SVG must be clean and production-ready \u2014 no lorem ipsum, placeholder paths, or broken shapes.`
+      ]
+    }
+  };
+  const config = typeConfig[prototypeType] ?? typeConfig.web_app;
+  const typeLabel = {
+    web_app: "Web App",
+    mobile_app: "Mobile App",
+    desktop_app: "Desktop App",
+    logo: "Logo"
+  };
   return [
-    `You are a UI designer and frontend engineer. Your job is to generate ${proto.variantCount} high-quality, visually distinct HTML prototype variants based on the user's design request.`,
+    `${config.role}`,
     ``,
     `Working directory: ${repoDir}`,
     ``,
     `## Prototype Request`,
     `Title: ${proto.title}`,
     `ID: ${proto.id}`,
+    `Type: ${typeLabel[prototypeType] ?? prototypeType}`,
     ``,
     `## Design Prompt`,
     `${proto.prompt}`,
@@ -2196,17 +2284,12 @@ function buildPrototypePrompt(proto, repoDir) {
     ``,
     `Each file must be completely self-contained (inline all CSS and JS \u2014 no external dependencies). Tailwind CDN is acceptable.`,
     ``,
-    `## Prototype Variation Guidelines`,
+    `## Variation Guidelines`,
     ``,
-    `When generating multiple prototypes, vary these aspects:`,
-    `- **Layout**: Grid, list, card, single-page, multi-section`,
-    `- **Style**: Minimal, bold, playful, corporate, retro, futuristic`,
-    `- **Color scheme**: Light, dark, colorful, monochrome`,
-    `- **Interaction model**: Click-heavy, scroll-based, hover effects, animated`,
-    `- **Information density**: Sparse, balanced, dense`,
-    `- **Navigation**: Sidebar, top nav, bottom nav, hamburger, tabs`,
+    `When generating multiple variants, vary these aspects:`,
+    ...config.guidelines,
     ``,
-    `Prototypes should demonstrate different interpretations, not just color swaps. Vary from very similar to wildly different approaches.`,
+    `Variants should demonstrate different interpretations, not just color swaps. Vary from very similar to wildly different approaches.`,
     ``,
     ...variantSteps,
     `### Final verification`,
@@ -2216,7 +2299,7 @@ function buildPrototypePrompt(proto, repoDir) {
     `- You MUST produce exactly ${proto.variantCount} files: ${variantList.join(", ")}`,
     `- Generate them ONE AT A TIME \u2014 design each variant, write the file, then move to the next.`,
     `- Each variant must look visually DISTINCT from the others.`,
-    `- Each file must be a complete, functional page \u2014 pure HTML/CSS/JS, no external libraries (Tailwind CDN is acceptable).`,
+    ...config.rules,
     `- Do NOT upload or POST the files anywhere. The watch handler will upload them automatically after you exit.`,
     `- Do NOT exit until ALL ${proto.variantCount} files have been written and verified.`
   ].join("\n");
@@ -2251,14 +2334,28 @@ function buildRefinementPrompt(proto, parentFiles, repoDir) {
     existingVariantLines.push(``);
   }
   const existingVariants = existingVariantLines.join("\n");
+  const prototypeType = proto.prototypeType ?? "web_app";
+  const typeRoleMap = {
+    web_app: "You are a UI designer and frontend engineer. Your job is to REFINE an existing web app prototype based on user feedback.",
+    mobile_app: "You are a mobile UI designer and frontend engineer. Your job is to REFINE an existing mobile app prototype based on user feedback.",
+    desktop_app: "You are a desktop UI designer and frontend engineer. Your job is to REFINE an existing desktop app prototype based on user feedback.",
+    logo: "You are a graphic designer specializing in logo and brand identity. Your job is to REFINE an existing logo prototype based on user feedback."
+  };
+  const typeLabel = {
+    web_app: "Web App",
+    mobile_app: "Mobile App",
+    desktop_app: "Desktop App",
+    logo: "Logo"
+  };
   return [
-    `You are a UI designer and frontend engineer. Your job is to REFINE an existing prototype based on user feedback.`,
+    `${typeRoleMap[prototypeType] ?? typeRoleMap.web_app}`,
     ``,
     `Working directory: ${repoDir}`,
     ``,
     `## Prototype Request`,
     `Title: ${proto.title}`,
     `ID: ${proto.id}`,
+    `Type: ${typeLabel[prototypeType] ?? prototypeType}`,
     ``,
     `## Original Design Prompt`,
     `${proto.prompt}`,
@@ -2400,7 +2497,10 @@ ${systemPrompt}` : prompt2;
   if (mode === "plan") {
     return { bin: "claude", args: [...sessionArgs, ...nameArgs, ...systemArgs, ...turnsArgs, "--permission-mode", "plan", "-p", prompt2] };
   }
-  return { bin: "claude", args: [...sessionArgs, ...nameArgs, ...systemArgs, ...turnsArgs, "-p", "--dangerously-skip-permissions", prompt2] };
+  const cfg = loadConfig();
+  const permissionMode = cfg.claudePermissionMode ?? "auto";
+  const permissionArgs = permissionMode === "dangerously-skip-permissions" ? ["--dangerously-skip-permissions"] : ["--permission-mode", "auto", "--enable-auto-mode"];
+  return { bin: "claude", args: [...sessionArgs, ...nameArgs, ...systemArgs, ...turnsArgs, ...permissionArgs, "-p", prompt2] };
 }
 function commandExists(cmd) {
   return new Promise((resolve8) => {
@@ -2729,11 +2829,12 @@ var watchCommand = new Command8("watch").description(
       return;
     }
     let attemptIndex = 0;
+    let resumeAlreadyRetried = false;
     const launchAttempt = async (attemptAgent) => {
       let spawnFailureReason = null;
       const pausedForNetwork = networkPaused.get(task.id);
-      const shouldResumeClaudeSession = attemptAgent === "claude" && !!task.claudeSessionId && (hasFeedback || pausedForNetwork?.resumeSession === true);
-      const sessionId = attemptAgent === "claude" ? task.claudeSessionId ?? randomUUID() : void 0;
+      const shouldResumeClaudeSession = attemptAgent === "claude" && !!task.claudeSessionId && !resumeAlreadyRetried && (hasFeedback || pausedForNetwork?.resumeSession === true);
+      const sessionId = attemptAgent === "claude" ? shouldResumeClaudeSession ? task.claudeSessionId : randomUUID() : void 0;
       const executionSystemPrompt = composeSystemPrompt(EXECUTION_SYSTEM_SECTIONS);
       const child = spawnAgent(
         attemptAgent,
@@ -2777,6 +2878,17 @@ var watchCommand = new Command8("watch").description(
             logWarn(prefix, `${attemptAgent} paused after network loss (${failureDetail})`);
             return;
           }
+          if (shouldResumeClaudeSession && !resumeAlreadyRetried) {
+            resumeAlreadyRetried = true;
+            logWarn(prefix, `Claude session resume failed (${failureDetail}) \u2014 retrying with fresh session`);
+            await postTaskUpdate(
+              task.id,
+              `Claude session resume failed \u2014 retrying with fresh session`,
+              "system"
+            );
+            await launchAttempt("claude");
+            return;
+          }
           const nextAgent = attemptOrder[attemptIndex + 1];
           if (nextAgent) {
             logWarn(prefix, `${attemptAgent} failed (${failureDetail}) \u2014 retrying with ${nextAgent}`);
@@ -4248,28 +4360,45 @@ var prototypeCommand = new Command13("prototype").description("Manage prototypes
       return;
     }
     console.log();
+    const typeLabels = {
+      web_app: "web",
+      mobile_app: "mobile",
+      desktop_app: "desktop",
+      logo: "logo"
+    };
     for (const p of prototypes) {
       const date = new Date(p.createdAt).toLocaleDateString();
+      const typeLabel = typeLabels[p.prototypeType] ?? p.prototypeType ?? "web";
       console.log(
-        `  ${paint4("bold", p.title)}  ${statusBadge(p.status)}  ${paint4("gray", p.id.slice(0, 8))}  ${paint4("dim", date)}`
+        `  ${paint4("bold", p.title)}  ${statusBadge(p.status)}  ${paint4("blue", `[${typeLabel}]`)}  ${paint4("gray", p.id.slice(0, 8))}  ${paint4("dim", date)}`
       );
       console.log(`  ${paint4("dim", p.prompt.slice(0, 80) + (p.prompt.length > 80 ? "\u2026" : ""))}`);
       console.log();
     }
   })
 ).addCommand(
-  new Command13("create").description("Create a new prototype").argument("<title>", "Title of the prototype").requiredOption("--prompt <prompt>", "Design description / prompt").option("--project <projectId>", "Project ID (defaults to linked project, when available)").option("--variants <count>", "Number of variants to generate (1-50)", "5").action(async (title, opts) => {
+  new Command13("create").description("Create a new prototype").argument("<title>", "Title of the prototype").requiredOption("--prompt <prompt>", "Design description / prompt").option("--project <projectId>", "Project ID (defaults to linked project, when available)").option("--variants <count>", "Number of variants to generate (1-50)", "5").option("--type <type>", "Prototype type: web_app, mobile_app, desktop_app, logo (default: web_app)", "web_app").action(async (title, opts) => {
     const projectId = opts.project ?? getLinkedProjectId();
     const variantCount = Math.max(1, Math.min(50, parseInt(opts.variants, 10) || 5));
+    const validTypes = ["web_app", "mobile_app", "desktop_app", "logo"];
+    const prototypeType = validTypes.includes(opts.type) ? opts.type : "web_app";
     const prototype = await api.post("/api/prototypes", {
       title,
       prompt: opts.prompt,
+      prototypeType,
       variantCount,
       projectId: projectId ?? null
     });
+    const typeLabels = {
+      web_app: "Web App",
+      mobile_app: "Mobile App",
+      desktop_app: "Desktop App",
+      logo: "Logo"
+    };
     console.log();
     console.log(`  ${paint4("green", "\u2713")} Created prototype: ${paint4("bold", prototype.title)}`);
     console.log(`  ${paint4("gray", "ID:")} ${prototype.id}`);
+    console.log(`  ${paint4("gray", "Type:")} ${typeLabels[prototype.prototypeType] ?? prototype.prototypeType}`);
     if (!prototype.projectId) {
       console.log(`  ${paint4("gray", "Project:")} none (will generate in the active watch directory)`);
     }
@@ -4557,7 +4686,7 @@ async function checkApiConnectivity() {
   }
 }
 function printResults(checks) {
-  const maxNameLen = Math.max(...checks.map((c11) => c11.name.length));
+  const maxNameLen = Math.max(...checks.map((c12) => c12.name.length));
   let allOk = true;
   for (const check of checks) {
     const isOptional = check.optional ?? false;
@@ -4571,10 +4700,10 @@ function printResults(checks) {
 }
 async function autoFix(checks, agent) {
   const { spawn: spawn8 } = await import("child_process");
-  const ghInstalled = checks.find((c11) => c11.name === "GitHub CLI (gh)").ok;
-  const ghAuthed = checks.find((c11) => c11.name === "GitHub CLI auth").ok;
-  const mrAuthed = checks.find((c11) => c11.name === "Mr. Manager CLI auth").ok;
-  const claudeCheck = checks.find((c11) => c11.name === "Claude Code (claude)");
+  const ghInstalled = checks.find((c12) => c12.name === "GitHub CLI (gh)").ok;
+  const ghAuthed = checks.find((c12) => c12.name === "GitHub CLI auth").ok;
+  const mrAuthed = checks.find((c12) => c12.name === "Mr. Manager CLI auth").ok;
+  const claudeCheck = checks.find((c12) => c12.name === "Claude Code (claude)");
   if (claudeCheck && !claudeCheck.ok && agent === "claude") {
     console.log(paint5("cyan", "  Installing Claude Code..."));
     console.log(paint5("dim", "  Running: curl -fsSL https://claude.ai/install.sh | bash"));
@@ -4637,7 +4766,7 @@ var setupCommand = new Command14("setup").description("Check that all dependenci
     console.log("");
     return;
   }
-  const fixes = checks.filter((c11) => !c11.ok && c11.fix && !c11.optional);
+  const fixes = checks.filter((c12) => !c12.ok && c12.fix && !c12.optional);
   if (fixes.length > 0) {
     console.log(paint5("yellow", "  To fix:"));
     for (const fix of fixes) {
@@ -4909,7 +5038,7 @@ async function ensureDevServer() {
 }
 var browseCommand = new Command18("browse").description("Control a headless browser for QA and testing").argument("[command]", "Browse command (goto, click, fill, screenshot, etc.)").argument("[args...]", "Command arguments").option(
   "--task-id <id>",
-  "Attach screenshot to a task update (only for screenshot command)"
+  "Attach output to a task update (for screenshot and recording-stop commands)"
 ).option("--dev", "Auto-start local dev server before browsing").allowUnknownOption(true).action(
   async (command, args, opts) => {
     if (!command) {
@@ -4948,6 +5077,62 @@ var browseCommand = new Command18("browse").description("Control a headless brow
     if (exitCode !== 0) {
       process.exit(exitCode);
     }
+    if (command === "recording-stop" && opts.taskId) {
+      const recordingPath = stdout.match(/Recording saved: (.+)/)?.[1]?.trim();
+      if (!recordingPath || !existsSync9(recordingPath)) {
+        console.error("[browse] Could not find recording file");
+        process.exit(1);
+      }
+      try {
+        const config = loadConfig();
+        const videoBuffer = readFileSync7(recordingPath);
+        const fileName = recordingPath.split("/").pop() || "browse-recording.webm";
+        const isMp4 = fileName.endsWith(".mp4");
+        const formData = new FormData();
+        const blob = new Blob([videoBuffer], {
+          type: isMp4 ? "video/mp4" : "video/webm"
+        });
+        formData.append("file", blob, fileName);
+        formData.append("prefix", "browse-recordings");
+        const uploadRes = await fetch(`${config.apiUrl}/api/upload`, {
+          method: "POST",
+          headers: { Authorization: `Bearer ${config.apiKey}` },
+          body: formData
+        });
+        if (!uploadRes.ok) {
+          const errText = await uploadRes.text();
+          console.error(
+            `[browse] Upload failed: ${uploadRes.status} ${errText}`
+          );
+          process.exit(1);
+        }
+        const uploadData = await uploadRes.json();
+        await api.post(`/api/tasks/${opts.taskId}/updates`, {
+          message: "Browser recording",
+          source: "agent",
+          media: [
+            {
+              kind: "recording",
+              url: uploadData.url,
+              mimeType: isMp4 ? "video/mp4" : "video/webm",
+              label: "Browse recording",
+              captureContext: "browse-recording",
+              uploadState: "uploaded",
+              isCanonical: true
+            }
+          ]
+        });
+        console.log(
+          `[browse] Recording uploaded and attached to task ${opts.taskId}`
+        );
+      } catch (err) {
+        console.error(
+          `[browse] Failed to attach recording: ${err.message}`
+        );
+        process.exit(1);
+      }
+      return;
+    }
     if (command === "screenshot" && opts.taskId) {
       const screenshotPath = stdout.match(/Screenshot saved: (.+)/)?.[1];
       if (!screenshotPath || !existsSync9(screenshotPath)) {
@@ -5719,10 +5904,10 @@ ${codebaseAnalysis.routes.map((r) => `- ${r}`).join("\n")}
 ${codebaseAnalysis.prismaModels.map((m) => `- ${m}`).join("\n")}
 
 **Components:**
-${codebaseAnalysis.components.slice(0, 15).map((c11) => `- ${c11}`).join("\n")}
+${codebaseAnalysis.components.slice(0, 15).map((c12) => `- ${c12}`).join("\n")}
 
 **Recent Git Commits:**
-${codebaseAnalysis.recentCommits.slice(0, 8).map((c11) => `- ${c11}`).join("\n")}
+${codebaseAnalysis.recentCommits.slice(0, 8).map((c12) => `- ${c12}`).join("\n")}
 
 **Completed Tasks:**
 ${context.completedTasks.slice(0, 10).map((t) => `- ${t.title}`).join("\n") || "None"}
@@ -6369,7 +6554,7 @@ var doctorCommand = new Command25("doctor").description("Diagnose Mr. Manager CL
     console.log("");
     return;
   }
-  const fixes = checks.filter((c11) => !c11.ok && c11.fix && !c11.optional);
+  const fixes = checks.filter((c12) => !c12.ok && c12.fix && !c12.optional);
   if (fixes.length > 0) {
     console.log(paint5("yellow", "  To fix:"));
     for (const fix of fixes) {
@@ -6700,6 +6885,44 @@ skillCommand.command("generate").alias("gen").description("Generate a new skill
   }
 });
 
+// cli/commands/tests.ts
+import { Command as Command28 } from "commander";
+var c11 = {
+  reset: "\x1B[0m",
+  dim: "\x1B[2m",
+  yellow: "\x1B[33m"
+};
+var testsCommand = new Command28("tests").description("List MR Test scenarios for the linked project").action(async () => {
+  const projectId = getLinkedProjectId();
+  if (!projectId) {
+    console.error(
+      `${c11.yellow}No project linked to this directory.${c11.reset} Run "mr link <project-id>" first.`
+    );
+    process.exit(1);
+  }
+  const params = new URLSearchParams({ category: "test", projectId });
+  let scenarios;
+  try {
+    scenarios = await api.get(`/api/skills?${params}`);
+  } catch (err) {
+    console.error(`Failed to fetch test scenarios: ${err.message}`);
+    process.exit(1);
+  }
+  if (scenarios.length === 0) {
+    console.log(`${c11.dim}No test scenarios found for this project.${c11.reset}`);
+    return;
+  }
+  for (const scenario of scenarios) {
+    console.log(`### ${scenario.name}`);
+    if (scenario.description) {
+      console.log(`${c11.dim}${scenario.description}${c11.reset}`);
+      console.log();
+    }
+    console.log(scenario.content);
+    console.log();
+  }
+});
+
 // cli/index.ts
 var configPath = join12(homedir3(), ".mr-manager", "config.json");
 var isFirstRun = !existsSync17(configPath);
@@ -6707,7 +6930,7 @@ var userArgs = process.argv.slice(2);
 var bypassCommands = /* @__PURE__ */ new Set(["login", "init", "auth", "help", "--help", "-h", "--version", "-V", "doctor", "setup"]);
 var shouldBypass = userArgs.length > 0 && bypassCommands.has(userArgs[0]);
 if (isFirstRun && !shouldBypass) {
-  const c11 = {
+  const c12 = {
     reset: "\x1B[0m",
     bold: "\x1B[1m",
     dim: "\x1B[2m",
@@ -6717,28 +6940,28 @@ if (isFirstRun && !shouldBypass) {
     magenta: "\x1B[35m"
   };
   console.log("");
-  console.log(`${c11.cyan}  \u2554\u2566\u2557\u2566\u2550\u2557  \u2554\u2566\u2557\u2554\u2550\u2557\u2554\u2557\u2554\u2554\u2550\u2557\u2554\u2550\u2557\u2554\u2550\u2557\u2566\u2550\u2557${c11.reset}`);
-  console.log(`${c11.magenta}  \u2551\u2551\u2551\u2560\u2566\u255D  \u2551\u2551\u2551\u2560\u2550\u2563\u2551\u2551\u2551\u2560\u2550\u2563\u2551 \u2566\u2551\u2563 \u2560\u2566\u255D${c11.reset}`);
-  console.log(`${c11.cyan}  \u2569 \u2569\u2569\u255A\u2550  \u2569 \u2569\u2569 \u2569\u255D\u255A\u255D\u2569 \u2569\u255A\u2550\u255D\u255A\u2550\u255D\u2569\u255A\u2550${c11.reset}`);
-  console.log(`${c11.dim}  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${c11.reset}`);
+  console.log(`${c12.cyan}  \u2554\u2566\u2557\u2566\u2550\u2557  \u2554\u2566\u2557\u2554\u2550\u2557\u2554\u2557\u2554\u2554\u2550\u2557\u2554\u2550\u2557\u2554\u2550\u2557\u2566\u2550\u2557${c12.reset}`);
+  console.log(`${c12.magenta}  \u2551\u2551\u2551\u2560\u2566\u255D  \u2551\u2551\u2551\u2560\u2550\u2563\u2551\u2551\u2551\u2560\u2550\u2563\u2551 \u2566\u2551\u2563 \u2560\u2566\u255D${c12.reset}`);
+  console.log(`${c12.cyan}  \u2569 \u2569\u2569\u255A\u2550  \u2569 \u2569\u2569 \u2569\u255D\u255A\u255D\u2569 \u2569\u255A\u2550\u255D\u255A\u2550\u255D\u2569\u255A\u2550${c12.reset}`);
+  console.log(`${c12.dim}  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${c12.reset}`);
   console.log("");
-  console.log(`${c11.bold}  Welcome to Mr. Manager!${c11.reset}`);
-  console.log(`${c11.dim}  Let's get you set up in a few quick steps.${c11.reset}`);
+  console.log(`${c12.bold}  Welcome to Mr. Manager!${c12.reset}`);
+  console.log(`${c12.dim}  Let's get you set up in a few quick steps.${c12.reset}`);
   console.log("");
-  console.log(`  ${c11.yellow}Step 1:${c11.reset} Authenticate via Google OAuth`);
-  console.log(`  ${c11.dim}Run:${c11.reset} ${c11.cyan}mr login${c11.reset}`);
+  console.log(`  ${c12.yellow}Step 1:${c12.reset} Authenticate via Google OAuth`);
+  console.log(`  ${c12.dim}Run:${c12.reset} ${c12.cyan}mr login${c12.reset}`);
   console.log("");
-  console.log(`  ${c11.yellow}Step 2:${c11.reset} Verify your environment`);
-  console.log(`  ${c11.dim}Run:${c11.reset} ${c11.cyan}mr setup${c11.reset}`);
+  console.log(`  ${c12.yellow}Step 2:${c12.reset} Verify your environment`);
+  console.log(`  ${c12.dim}Run:${c12.reset} ${c12.cyan}mr setup${c12.reset}`);
   console.log("");
-  console.log(`  ${c11.yellow}Step 3:${c11.reset} Link a repo and start watching`);
-  console.log(`  ${c11.dim}Run:${c11.reset} ${c11.cyan}mr link${c11.reset} ${c11.dim}&&${c11.reset} ${c11.cyan}mr watch${c11.reset}`);
+  console.log(`  ${c12.yellow}Step 3:${c12.reset} Link a repo and start watching`);
+  console.log(`  ${c12.dim}Run:${c12.reset} ${c12.cyan}mr link${c12.reset} ${c12.dim}&&${c12.reset} ${c12.cyan}mr watch${c12.reset}`);
   console.log("");
-  console.log(`${c11.dim}  Or run ${c11.reset}${c11.cyan}mr login${c11.reset}${c11.dim} to get started now.${c11.reset}`);
+  console.log(`${c12.dim}  Or run ${c12.reset}${c12.cyan}mr login${c12.reset}${c12.dim} to get started now.${c12.reset}`);
   console.log("");
   process.exit(0);
 }
-var program = new Command28();
+var program = new Command29();
 program.name("mr").description("Mr. Manager - Task and project management CLI").version(CLI_VERSION);
 program.addCommand(initCommand);
 program.addCommand(authCommand);
@@ -6770,4 +6993,5 @@ program.addCommand(ideaCommand);
 program.addCommand(doctorCommand);
 program.addCommand(promptAuditCommand);
 program.addCommand(skillCommand);
+program.addCommand(testsCommand);
 program.parse();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dunnewold-labs/mr-manager",
-  "version": "0.4.18",
+  "version": "0.4.21",
   "description": "Mr. Manager - Task and project management CLI",
   "bin": {
     "mr": "./dist/index.mjs"