flowcollab 0.3.21 → 0.3.22

package/bin/_commands.mjs

@@ -44,6 +44,8 @@ export const CLI_COMMANDS = [
     usage: 'flow-handoff --task=<id> --to=<actor> --context="..." [--branch=] [--questions="q1|q2"] [--next-step="..."]' },
   { name: 'review',       file: 'review.mjs',        summary: 'Request code review; moves task to in-review',
     usage: 'flow-review <id> [--pr=<num>] [--reviewer=<actor>] [--context="..."]' },
+  { name: 'verify',       file: 'verify.mjs',        summary: 'Run the project test command + record a pass/fail on the task',
+    usage: 'flow-verify <id> [--cmd="npm test"] [--close]   — run tests, post a verification event; --close closes on pass' },
   { name: 'search',       file: 'search.mjs',        summary: 'Search tasks by text, status, area, or assignee',
     usage: 'flow-search "query" [--status=] [--area=] [--assignee=]' },
   { name: 'status',       file: 'status.mjs',        summary: 'Quick board summary',

package/bin/verify.mjs

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+/* flow:verify — run the project's test command, record a pass/fail verification on the task
+   timeline, and exit with the command's status so an agent's harness can branch on the result.
+   Usage: flow-verify <task_id> [--cmd="npm test"] [--close]
+     command resolution:  --cmd  >  ./flow.config.json "verify_command"  >  "npm test"
+     --close  closes the task (flow-close) on a PASSING run.
+*/
+
+import { spawnSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { flowFetch, resolveTaskId, positional, arg, die, sanitizeText } from './_client.mjs';
+
+function resolveCommand() {
+  const c = arg('cmd');
+  if (c) return c;
+  try {
+    const cfg = JSON.parse(readFileSync('flow.config.json', 'utf8'));
+    if (typeof cfg.verify_command === 'string' && cfg.verify_command.trim()) return cfg.verify_command;
+  } catch { /* no local config — fall through to the default */ }
+  return 'npm test';
+}
+
+async function main() {
+  const rawId = positional(0);
+  if (!rawId) die('Usage: flow-verify <task_id> [--cmd="npm test"] [--close]');
+  const id = await resolveTaskId(rawId);
+  const command = resolveCommand();
+  const doClose = process.argv.slice(2).includes('--close');
+  const shortRef = '#' + rawId.replace(/^#/, '').slice(0, 6);
+
+  process.stdout.write(`Running: ${command}\n`);
+  // spawnSync is blocking, so output is buffered then printed; the snippet below is what we record.
+  const r = spawnSync(command, { shell: true, stdio: ['ignore', 'pipe', 'pipe'], encoding: 'utf8' });
+  const out = (r.stdout || '') + (r.stderr || '');
+  if (out) process.stdout.write(out.endsWith('\n') ? out : out + '\n');
+  const passed = r.status === 0;
+
+  // record the trailing ~20 non-empty lines as the audit snippet
+  const snippet = out.split('\n').filter(l => l.trim()).slice(-20).join('\n').slice(0, 4000);
+  await flowFetch('/api/flow/verify', { method: 'POST', body: { task_id: id, passed, command, summary: snippet } });
+  process.stdout.write(`${passed ? '✓ PASS' : '✗ FAIL'} — recorded on ${shortRef}\n`);
+
+  if (passed && doClose) {
+    await flowFetch('/api/flow/close', { method: 'POST', body: { task_id: id, summary: `Verified: ${sanitizeText(command, 100)}` } });
+    process.stdout.write(`Closed ${shortRef}.\n`);
+  }
+  process.exitCode = r.status ?? 1;
+}
+
+main().catch(e => die(e.message || e));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flowcollab",
-  "version": "0.3.21",
+  "version": "0.3.22",
   "description": "Multi-Claude coordination layer — shared task board + CLI for teams running Claude Code",
   "type": "module",
   "files": [
@@ -30,6 +30,7 @@
     "flow-project": "bin/project.mjs",
     "flow-close-sprint": "bin/close-sprint.mjs",
     "flow-review": "bin/review.mjs",
+    "flow-verify": "bin/verify.mjs",
     "flow-login": "bin/login.mjs",
     "flow-edit": "bin/edit.mjs",
     "flow-unblock": "bin/unblock.mjs",