vibeman 0.0.11 → 0.0.13

package/dist/commit.txt

@@ -1 +1 @@
-07b258d
+cf5eb36

package/dist/index.js

@@ -1965,6 +1965,100 @@ function isNodeVersionCompatible(currentNodeVersion, requiredRange) {
   }
 }
 
+// ../shared/runtime/port-utils.ts
+import { createServer as createNetServer } from "node:net";
+var MIN_PORT = 1;
+var MAX_PORT = 65535;
+async function findAvailablePort(startPort) {
+  assertValidPort(startPort);
+  for (let port = startPort;port <= MAX_PORT; port += 1) {
+    const available = await isPortAvailable(port);
+    if (available) {
+      return port;
+    }
+  }
+  throw new Error(`No available port found from ${startPort} to ${MAX_PORT}.`);
+}
+function assertValidPort(port) {
+  if (!Number.isInteger(port) || port < MIN_PORT || port > MAX_PORT) {
+    throw new RangeError(`Port must be an integer in ${MIN_PORT}..${MAX_PORT}. Received: ${port}`);
+  }
+}
+function isPortAvailable(port) {
+  return new Promise((resolve2, reject) => {
+    const probe = createNetServer();
+    probe.unref();
+    const onError = (error) => {
+      cleanup();
+      if (isAddressInUseError(error)) {
+        resolve2(false);
+        return;
+      }
+      reject(error);
+    };
+    const onListening = () => {
+      cleanup();
+      probe.close((closeError) => {
+        if (closeError) {
+          reject(closeError);
+          return;
+        }
+        resolve2(true);
+      });
+    };
+    const cleanup = () => {
+      probe.off("error", onError);
+      probe.off("listening", onListening);
+    };
+    probe.once("error", onError);
+    probe.once("listening", onListening);
+    probe.listen(port);
+  });
+}
+function isAddressInUseError(error) {
+  return typeof error === "object" && error !== null && "code" in error && error.code === "EADDRINUSE";
+}
+
+// ../shared/runtime/vibeman-env.ts
+var VIBEMAN_ENV_KEYS = {
+  ROOT: "VIBEMAN_ROOT",
+  PORT: "VIBEMAN_PORT",
+  DATABASE_URL: "VIBEMAN_DATABASE_URL",
+  VERBOSE: "VIBEMAN_VERBOSE",
+  LOG_FORMAT: "VIBEMAN_LOG_FORMAT",
+  UI_DIST: "VIBEMAN_UI_DIST",
+  CODEX_PATH: "VIBEMAN_CODEX_PATH",
+  GEMINI_PATH: "VIBEMAN_GEMINI_PATH",
+  CLAUDE_CODE_PATH: "VIBEMAN_CLAUDE_CODE_PATH",
+  TRACE: "VIBEMAN_TRACE",
+  DIST_ROOT: "VIBEMAN_DIST_ROOT",
+  DB_AUTORECOVER: "VIBEMAN_DB_AUTORECOVER"
+};
+function readVibemanEnv(env, key) {
+  const value = env[key];
+  if (typeof value === "string" && value.trim().length > 0) {
+    return value.trim();
+  }
+  return;
+}
+
+// src/dist-layout.ts
+var DIST_LAYOUT = {
+  cliEntry: "index.js",
+  apiEntry: "api.js",
+  commitFile: "commit.txt",
+  prismaConfig: "prisma.config.ts",
+  uiRoot: "ui",
+  uiIndexHtml: "ui/index.html",
+  prismaRoot: "prisma",
+  prismaSchema: "prisma/schema.prisma",
+  resourcesRoot: "resources",
+  scriptsRoot: "scripts",
+  fixtureInitScript: "scripts/init-test-repo.mjs",
+  fixtureSeedScript: "scripts/seed-test-fixtures.mjs",
+  fixtureLibraryScript: "scripts/lib/test-fixtures.mjs"
+};
+
 // src/index.ts
 enforceNodeRuntimeCompatibility(import.meta.url);
 var args = process.argv.slice(2);
@@ -1990,11 +2084,12 @@ console.error(`Unknown command: ${command}`);
 printHelp();
 process.exit(1);
 function parseStartArgs(argv) {
-  const envPort = Number(process.env.PORT);
+  const envPort = Number(readVibemanEnv(process.env, VIBEMAN_ENV_KEYS.PORT));
   const output = {
     path: ".",
     port: Number.isFinite(envPort) ? envPort : 6969,
-    open: true
+    open: true,
+    trace: false
   };
   for (let i = 0;i < argv.length; i += 1) {
     const arg = argv[i];
@@ -2010,6 +2105,10 @@ function parseStartArgs(argv) {
       output.open = false;
       continue;
     }
+    if (arg === "--trace") {
+      output.trace = true;
+      continue;
+    }
     if (!arg.startsWith("-") && output.path === ".") {
       output.path = arg;
     }
@@ -2018,12 +2117,16 @@ function parseStartArgs(argv) {
 }
 async function startApps(options) {
   const moduleDir = dirname2(fileURLToPath2(import.meta.url));
-  const distRoot = resolveDistRoot(moduleDir);
-  const distApi = distRoot ? resolve2(distRoot, "api.js") : "";
-  const distUiRoot = distRoot ? resolve2(distRoot, "ui") : "";
+  const distRoot = resolvePackagedDistRoot(moduleDir);
+  const distApi = resolve2(distRoot, DIST_LAYOUT.apiEntry);
+  const distUiRoot = resolve2(distRoot, DIST_LAYOUT.uiRoot);
   const nodePath = resolveNodePath();
   const targetRoot = resolve2(process.cwd(), options.path);
-  if (!distRoot || !existsSync2(distApi) || !existsSync2(resolve2(distUiRoot, "index.html"))) {
+  const resolvedPort = await findAvailablePort(options.port);
+  if (resolvedPort !== options.port) {
+    console.warn(`[WARN] [startup] Requested port ${options.port} is in use. Using ${resolvedPort} instead.`);
+  }
+  if (!existsSync2(distApi) || !existsSync2(resolve2(distRoot, DIST_LAYOUT.uiIndexHtml))) {
     console.error("Missing dist runtime files. Run the build first.");
     process.exit(1);
   }
@@ -2031,22 +2134,28 @@ async function startApps(options) {
     cwd: process.cwd(),
     env: {
       ...process.env,
-      PORT: String(options.port),
-      VIBEMAN_ROOT: targetRoot,
-      UI_DIST: distUiRoot
+      [VIBEMAN_ENV_KEYS.PORT]: String(resolvedPort),
+      [VIBEMAN_ENV_KEYS.ROOT]: targetRoot,
+      [VIBEMAN_ENV_KEYS.DIST_ROOT]: distRoot,
+      [VIBEMAN_ENV_KEYS.UI_DIST]: distUiRoot,
+      ...options.trace ? { [VIBEMAN_ENV_KEYS.VERBOSE]: "trace", [VIBEMAN_ENV_KEYS.TRACE]: "true" } : {}
     },
     stdio: "inherit"
   });
-  const url = new URL(`http://localhost:${options.port}/`);
+  const url = new URL(`http://localhost:${resolvedPort}/`);
   if (options.open) {
-    const ready = await waitForApiReady(options.port);
+    const startupSpinner = createStartupSpinner(url.toString(), resolvedPort);
+    const ready = await waitForApiReady(resolvedPort);
+    startupSpinner.stop(ready ? "ready" : "timeout");
     if (!ready) {
       console.warn("API not ready yet; opening the browser anyway.");
     }
     await openBrowser(url.toString());
   }
-  console.log(`
-Vibeman running  at ${url.toString()}. Press Ctrl+C to stop.`);
+  const readyLine = process.stdout.isTTY ? `
+\x1B[32mReady\x1B[0m \x1B[96m${url.toString()}\x1B[0m (Ctrl+C to stop)` : `
+Ready ${url.toString()} (Ctrl+C to stop)`;
+  console.log(readyLine);
   const stop = () => {
     apiProcess.kill();
   };
@@ -2080,16 +2189,12 @@ async function runFixtureScript(scriptName, forwardedArgs) {
 function resolveFixtureScriptPath(moduleDir, currentDir, scriptName) {
   const workspaceRoot = findFixtureWorkspaceRoot(moduleDir, currentDir);
   if (workspaceRoot) {
-    const scriptPath = resolve2(workspaceRoot, "scripts", scriptName);
+    const scriptPath = resolve2(workspaceRoot, DIST_LAYOUT.scriptsRoot, scriptName);
     if (existsSync2(scriptPath)) {
       return scriptPath;
     }
   }
-  const packagedRoot = findPackagedFixtureRoot(moduleDir);
-  if (!packagedRoot) {
-    return "";
-  }
-  const packagedScript = resolve2(packagedRoot, "scripts", scriptName);
+  const packagedScript = resolve2(resolvePackagedDistRoot(moduleDir), DIST_LAYOUT.scriptsRoot, scriptName);
   return existsSync2(packagedScript) ? packagedScript : "";
 }
 function findFixtureWorkspaceRoot(moduleDir, currentDir) {
@@ -2104,7 +2209,7 @@ function findFixtureWorkspaceRoot(moduleDir, currentDir) {
 function ascendForFixtureWorkspace(seed) {
   let dir = resolve2(seed);
   while (true) {
-    const fixtureScript = resolve2(dir, "scripts", "init-test-repo.mjs");
+    const fixtureScript = resolve2(dir, DIST_LAYOUT.fixtureInitScript);
     const packageJson = resolve2(dir, "package.json");
     if (existsSync2(fixtureScript) && existsSync2(packageJson)) {
       return dir;
@@ -2115,21 +2220,6 @@ function ascendForFixtureWorkspace(seed) {
     dir = parent;
   }
 }
-function findPackagedFixtureRoot(moduleDir) {
-  const candidates = [
-    moduleDir,
-    resolve2(moduleDir, ".."),
-    resolve2(moduleDir, "../dist"),
-    resolve2(moduleDir, "../../dist")
-  ];
-  for (const dir of candidates) {
-    const fixtureScript = resolve2(dir, "scripts", "init-test-repo.mjs");
-    if (existsSync2(fixtureScript)) {
-      return dir;
-    }
-  }
-  return "";
-}
 async function openBrowser(target) {
   const platform = process.platform;
   if (platform === "darwin") {
@@ -2146,13 +2236,13 @@ function printHelp() {
   console.log(`vibeman CLI
 
 Usage:
-  vibeman start [path] [--port <port>] [--no-open]
+  vibeman start [path] [--port <port>] [--no-open] [--trace]
   vibeman init-test-repo [path] [--force] [--skip-db-seed]
   vibeman --version
 
 Examples:
   vibeman start .
-  vibeman start ./notes --port 7010
+  vibeman start ./notes --port 7010 --trace
   vibeman init-test-repo ./tmp/test-repo
 `);
 }
@@ -2185,7 +2275,7 @@ function readGitCommit() {
 function readPackagedCommit() {
   try {
     const moduleDir = dirname2(fileURLToPath2(import.meta.url));
-    const commitPath = resolve2(moduleDir, "commit.txt");
+    const commitPath = resolve2(moduleDir, DIST_LAYOUT.commitFile);
     if (!existsSync2(commitPath))
       return "";
     return readFileSync2(commitPath, "utf-8").trim();
@@ -2198,6 +2288,42 @@ function waitForExit(child) {
     child.once("exit", (code) => resolvePromise(code));
   });
 }
+function createStartupSpinner(url, port) {
+  if (!process.stdout.isTTY) {
+    console.log(`[startup] Loading Vibeman... waiting for API on port ${port}`);
+    return {
+      stop: (result) => {
+        if (result === "ready") {
+          console.log(`[startup] Vibeman API is ready: ${url}`);
+          return;
+        }
+        console.log(`[startup] Still loading after timeout; opening browser: ${url}`);
+      }
+    };
+  }
+  const frames = ["|", "/", "-", "\\"];
+  let frameIndex = 0;
+  const startMs = Date.now();
+  process.stdout.write(`\r${frames[frameIndex]} Loading Vibeman... waiting for API on port ${port} `);
+  const timer = setInterval(() => {
+    frameIndex = (frameIndex + 1) % frames.length;
+    const elapsed = ((Date.now() - startMs) / 1000).toFixed(1);
+    process.stdout.write(`\r${frames[frameIndex]} Loading Vibeman... waiting for API on port ${port} (${elapsed}s) `);
+  }, 120);
+  return {
+    stop: (result) => {
+      clearInterval(timer);
+      const elapsed = ((Date.now() - startMs) / 1000).toFixed(1);
+      if (result === "ready") {
+        process.stdout.write(`\r✓ Vibeman API ready in ${elapsed}s. Opening ${url}
+`);
+        return;
+      }
+      process.stdout.write(`\r! Vibeman startup is taking longer than expected (${elapsed}s). Opening ${url}
+`);
+    }
+  };
+}
 async function waitForApiReady(port, timeoutMs = 30000, intervalMs = 250) {
   const startedAt = Date.now();
   while (Date.now() - startedAt < timeoutMs) {
@@ -2233,21 +2359,8 @@ function delay(ms) {
     setTimeout(resolvePromise, ms);
   });
 }
-function resolveDistRoot(selfDir) {
-  const execDir = dirname2(process.execPath);
-  const candidates = [
-    selfDir,
-    resolve2(execDir, ".."),
-    resolve2(execDir, "../.."),
-    resolve2(selfDir, ".."),
-    resolve2(selfDir, "../..")
-  ];
-  for (const candidate of candidates) {
-    if (existsSync2(resolve2(candidate, "api.js")) && existsSync2(resolve2(candidate, "ui", "index.html"))) {
-      return candidate;
-    }
-  }
-  return "";
+function resolvePackagedDistRoot(moduleDir) {
+  return moduleDir.endsWith("/dist") || moduleDir.endsWith("\\dist") ? moduleDir : resolve2(moduleDir, "..", "dist");
 }
 function resolveNodePath() {
   const execBase = basename(process.execPath);

package/dist/prisma/migrations/20260221100333_add_health_metrics/migration.sql

@@ -0,0 +1,9 @@
+-- AlterTable
+ALTER TABLE "WorkflowRun" ADD COLUMN "completedAt" DATETIME;
+ALTER TABLE "WorkflowRun" ADD COLUMN "durationMs" INTEGER;
+ALTER TABLE "WorkflowRun" ADD COLUMN "startedAt" DATETIME;
+
+-- AlterTable
+ALTER TABLE "WorkflowRunStepResult" ADD COLUMN "completedAt" DATETIME;
+ALTER TABLE "WorkflowRunStepResult" ADD COLUMN "durationMs" INTEGER;
+ALTER TABLE "WorkflowRunStepResult" ADD COLUMN "startedAt" DATETIME;

package/dist/prisma/schema.prisma

@@ -67,6 +67,9 @@ model WorkflowRun {
   runPayload       Json?
   initialRunPayload Json?
   lastError     String?
+  startedAt     DateTime?
+  completedAt   DateTime?
+  durationMs    Int?
   deletedAt     DateTime?
   createdAt     DateTime          @default(now())
   updatedAt     DateTime          @updatedAt
@@ -95,6 +98,9 @@ model WorkflowRunStepResult {
   messages     Json?
   graphState   Json?
   tokenUsage   Json?
+  startedAt    DateTime?
+  completedAt  DateTime?
+  durationMs   Int?
   createdAt    DateTime @default(now())
   updatedAt    DateTime @updatedAt
 

package/dist/prisma.config.ts

@@ -1,8 +1,12 @@
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { defineConfig } from 'prisma/config';
 
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
 export default defineConfig({
   schema: 'prisma/schema.prisma',
   datasource: {
-    url: process.env.DATABASE_URL ?? 'file:./prisma/dev.db',
+    url: process.env.DATABASE_URL ?? `file:${resolve(__dirname, 'prisma/dev.db')}`,
   },
 });

package/dist/scripts/init-test-repo.mjs

@@ -11,7 +11,6 @@ import {
   TEST_FIXTURE_WORKFLOWS,
   buildTaskMarkdown,
   getRepoRoot,
-  readTaskTemplate,
   taskFilename,
   taskRelativePath,
 } from './lib/test-fixtures.mjs';
@@ -104,12 +103,6 @@ async function ensureDirectoryIsEmpty(targetRoot, force) {
   }
 }
 
-async function writeTaskTemplate(targetRoot) {
-  const templatePath = resolve(targetRoot, '.vibeman/templates/task.md');
-  await mkdir(resolve(targetRoot, '.vibeman/templates'), { recursive: true });
-  await writeFile(templatePath, readTaskTemplate(), 'utf8');
-}
-
 async function writeFixtureTaskFiles(targetRoot) {
   const tasksDir = resolve(targetRoot, '.vibeman/tasks');
   await mkdir(tasksDir, { recursive: true });
@@ -206,7 +199,6 @@ async function main() {
   const targetRoot = resolve(process.cwd(), args.path || '.');
 
   await ensureDirectoryIsEmpty(targetRoot, args.force);
-  await writeTaskTemplate(targetRoot);
   await writeFixtureTaskFiles(targetRoot);
   await upsertGitignore(targetRoot);
   await ensureGitRepo(targetRoot);

package/dist/scripts/lib/test-fixtures.mjs

@@ -1,9 +1,66 @@
-import { readFileSync } from 'node:fs';
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const moduleDir = dirname(fileURLToPath(import.meta.url));
 const repoRoot = resolve(moduleDir, '..', '..');
+const TASK_TEMPLATE = `---
+# For human readability + AI parsing.
+# For type/status/priority: values must match the options exactly and be lowercase.
+id: [type]-[short-id]
+title: [Short, descriptive title]
+type: feature # feature, bug, chore, refactor, test, doc, other
+status: backlog # backlog, in-progress, review, done
+tags: [tag1, tag2]
+priority: medium # low, medium, high
+---
+
+## Goal
+
+[1-2 sentences: why this task exists and the end-user outcome. Do NOT list features here — save those for Requirements.]
+
+## Context
+
+[Current state: how things work today, relevant code locations, links. State facts only — no actions or constraints.]
+
+## Requirements
+
+[Each item = a verifiable condition that must be true when the task is done. Write as testable outcomes, not implementation actions. This is the single source of "what success looks like" — do not restate these in other sections.]
+
+- [ ] Outcome #1
+- [ ] Outcome #2
+
+## Implementation Notes
+
+[Reference-only info for the implementer. No action verbs — use Recommended Steps for that.
+
+- target files or directories
+- patterns or conventions to follow
+- commands to run for validation
+- out-of-scope items or things not to change]
+
+## Recommended Steps
+
+[The only place that describes HOW to do the work. Organize by implementation phase, not by requirement. Each step should advance multiple requirements at once when possible.]
+
+- Step 1: [Phase name]
+  - [ ] Action item
+  - [ ] Action item
+- Step 2: [Phase name]
+  - [ ] Action item
+
+## Open Questions
+
+[Unresolved decisions or ambiguities. Use the structure below so responses are explicit and easy to fill in.]
+
+- Question: [Open question #1?]
+  - Answer: [Pending]
+- Question: [Open question #2?]
+  - Answer: [Pending]
+
+## Implementation Summary
+
+[Auto-generated after completion: what changed + tests run.]
+`;
 
 const DEFAULT_CODEX_MODEL = 'gpt-5.3-codex';
 const LOW_COST_GEMINI_MODEL = 'gemini-3-flash-preview';
@@ -812,7 +869,7 @@ export function taskRelativePath(taskId) {
 }
 
 export function readTaskTemplate() {
-  return readFileSync(resolve(repoRoot, 'apps/api/resources/templates/task.md'), 'utf8');
+  return TASK_TEMPLATE;
 }
 
 function replaceOnce(input, from, to) {
@@ -867,31 +924,25 @@ export function buildTaskMarkdown(taskDef, nowIso = new Date().toISOString()) {
     `created_at: '${nowIso}'\nupdated_at: '${nowIso}'\n---\n\n## Goal`,
   );
 
+  task = replaceOnce(task, /\[1-2 sentences:[^\]]+\]/, taskDef.goal);
   task = replaceOnce(
     task,
-    '[What outcome should exist when this is done? Keep it concrete and short.]',
-    taskDef.goal,
-  );
-  task = replaceOnce(
-    task,
-    '[Key background, links, or constraints that matter to implementation.]',
+    /\[Current state:[^\]]+\]/,
     `${taskDef.context}\n\nTarget workflow: \`${taskDef.workflowId}\`.`,
   );
 
-  task = replaceOnce(task, '- [ ] Primary requirement #1', `- [ ] ${requirementA}`);
-  task = replaceOnce(task, '- [ ] Primary requirement #2', `- [ ] ${requirementB}`);
+  task = replaceOnce(task, '- [ ] Outcome #1', `- [ ] ${requirementA}`);
+  task = replaceOnce(task, '- [ ] Outcome #2', `- [ ] ${requirementB}`);
 
   task = replaceOnce(
     task,
-    `[Notes for AI or human. Include only what matters:\n\n- target files or directories\n- desired approach or patterns to follow\n- tests/commands to run\n- any do-not-change or out-of-scope items]`,
+    /\[Reference-only info for the implementer\.[\s\S]+?not to change\]/,
     notes,
   );
 
-  task = replaceOnce(task, '- [ ] Actionable TODO', `- [ ] ${stepA}`);
-  task = replaceOnce(task, '- [ ] Actionable TODO', `- [ ] ${stepB}`);
-
-  task = replaceOnce(task, '- [ ] Verifiable outcome #1', `- [ ] ${acceptanceA}`);
-  task = replaceOnce(task, '- [ ] Verifiable outcome #2', `- [ ] ${acceptanceB}`);
+  task = replaceOnce(task, '- [ ] Action item', `- [ ] ${stepA}`);
+  task = replaceOnce(task, '- [ ] Action item', `- [ ] ${stepB}`);
+  task = `${task.trim()}\n\n## Acceptance Criteria\n\n- [ ] ${acceptanceA}\n- [ ] ${acceptanceB}\n`;
 
   return task;
 }

package/dist/scripts/seed-test-fixtures.mjs

@@ -3,7 +3,7 @@ import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { mkdir } from 'node:fs/promises';
 import { dirname, resolve } from 'node:path';
-import { PrismaBetterSqlite3 } from '@prisma/adapter-better-sqlite3';
+import { PrismaLibSql } from '@prisma/adapter-libsql';
 
 import {
   PRIMARY_TEST_WORKFLOW_ID,
@@ -214,7 +214,7 @@ async function main() {
   }
 
   const PrismaClient = await resolvePrismaClient();
-  const adapter = new PrismaBetterSqlite3({ url: databaseUrl });
+  const adapter = new PrismaLibSql({ url: databaseUrl });
   const prisma = new PrismaClient({ adapter });
 
   try {