@bradygaster/squad-cli 0.9.2-insider.5 → 0.9.3-insider.1

package/dist/cli/commands/watch/config.js

@@ -11,6 +11,7 @@ const DEFAULTS = {
     execute: false,
     maxConcurrent: 1,
     timeout: 30,
+    dispatchMode: undefined,
     capabilities: {},
 };
 /**
@@ -42,11 +43,19 @@ export function loadWatchConfig(teamRoot, cliOverrides) {
         timeout: cliOverrides.timeout ?? fileConfig.timeout ?? DEFAULTS.timeout,
         copilotFlags: cliOverrides.copilotFlags ?? fileConfig.copilotFlags ?? DEFAULTS.copilotFlags,
         agentCmd: cliOverrides.agentCmd ?? fileConfig.agentCmd ?? DEFAULTS.agentCmd,
+        dispatchMode: cliOverrides.dispatchMode ?? fileConfig.dispatchMode ?? DEFAULTS.dispatchMode,
+        logFile: cliOverrides.logFile ?? fileConfig.logFile ?? DEFAULTS.logFile,
         capabilities: {
             ...DEFAULTS.capabilities,
             ...(fileConfig.capabilities ?? {}),
             ...(cliOverrides.capabilities ?? {}),
         },
+        verbose: cliOverrides.verbose ?? fileConfig.verbose ?? false,
+        authUser: cliOverrides.authUser ?? fileConfig.authUser,
+        webhookUrl: cliOverrides.webhookUrl ?? fileConfig.webhookUrl,
+        alertThreshold: cliOverrides.alertThreshold ?? fileConfig.alertThreshold,
+        maxBudget: cliOverrides.maxBudget ?? fileConfig.maxBudget,
+        machineCapabilities: cliOverrides.machineCapabilities ?? fileConfig.machineCapabilities,
     };
     return merged;
 }
@@ -65,9 +74,19 @@ function normalizeFileConfig(raw) {
         result.copilotFlags = raw['copilotFlags'];
     if (typeof raw['agentCmd'] === 'string')
         result.agentCmd = raw['agentCmd'];
+    if (typeof raw['verbose'] === 'boolean')
+        result.verbose = raw['verbose'];
+    if (typeof raw['dispatchMode'] === 'string') {
+        const mode = raw['dispatchMode'];
+        if (mode === 'fleet' || mode === 'task' || mode === 'hybrid') {
+            result.dispatchMode = mode;
+        }
+    }
+    if (typeof raw['logFile'] === 'string')
+        result.logFile = raw['logFile'];
     // Everything else is a capability key
     const caps = {};
-    const reserved = new Set(['interval', 'execute', 'maxConcurrent', 'timeout', 'copilotFlags', 'agentCmd']);
+    const reserved = new Set(['interval', 'execute', 'maxConcurrent', 'timeout', 'copilotFlags', 'agentCmd', 'verbose', 'dispatchMode', 'logFile']);
     for (const [key, value] of Object.entries(raw)) {
         if (reserved.has(key))
             continue;

package/dist/cli/commands/watch/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/cli/commands/watch/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/cli/commands/watch/config.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/watch/health.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Watch health check — reports status of a running watch instance.
+ *
+ * Reads the PID file (stored in OS temp dir) written at watch startup to
+ * determine whether a watch process is alive, its uptime, auth account, and
+ * whether auth has drifted since launch.
+ */
+/** Shape of the PID file written by runWatch at startup. */
+export interface WatchPidInfo {
+    pid: number;
+    startedAt: string;
+    user: string;
+    interval: number;
+    capabilities: string[];
+    repo: string;
+}
+/**
+ * Path to the PID file in the OS temp directory.
+ * Uses an MD5 hash of the repo path so different clones/worktrees get
+ * unique PID files without polluting the repo (avoids accidental commits).
+ */
+export declare function getPidPath(teamRoot: string): string;
+/**
+ * Write the PID file at watch startup.
+ * The caller is responsible for registering exit handlers to clean up.
+ */
+export declare function writePidFile(teamRoot: string, info: WatchPidInfo): void;
+/** Remove the PID file (best-effort, swallows errors). */
+export declare function removePidFile(teamRoot: string): void;
+/**
+ * Check if a process with the given PID is still alive.
+ * Uses `process.kill(pid, 0)` — signal 0 tests existence without killing.
+ */
+export declare function isProcessAlive(pid: number): boolean;
+/**
+ * Run the watch health check and return a formatted status string.
+ *
+ * @param teamRoot - The repository root (directory containing `.squad/`).
+ */
+export declare function getWatchHealth(teamRoot: string): string;
+//# sourceMappingURL=health.d.ts.map

package/dist/cli/commands/watch/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/watch/health.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,4DAA4D;AAC5D,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAGvE;AAED,0DAA0D;AAC1D,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEpD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAWnD;AAgCD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAwDvD"}

package/dist/cli/commands/watch/health.js

@@ -0,0 +1,141 @@
+/**
+ * Watch health check — reports status of a running watch instance.
+ *
+ * Reads the PID file (stored in OS temp dir) written at watch startup to
+ * determine whether a watch process is alive, its uptime, auth account, and
+ * whether auth has drifted since launch.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import crypto from 'node:crypto';
+import { execFileSync } from 'node:child_process';
+/**
+ * Path to the PID file in the OS temp directory.
+ * Uses an MD5 hash of the repo path so different clones/worktrees get
+ * unique PID files without polluting the repo (avoids accidental commits).
+ */
+export function getPidPath(teamRoot) {
+    const hash = crypto.createHash('md5').update(teamRoot).digest('hex').slice(0, 12);
+    return path.join(os.tmpdir(), `squad-watch-${hash}.json`);
+}
+/**
+ * Write the PID file at watch startup.
+ * The caller is responsible for registering exit handlers to clean up.
+ */
+export function writePidFile(teamRoot, info) {
+    const pidPath = getPidPath(teamRoot);
+    fs.writeFileSync(pidPath, JSON.stringify(info, null, 2));
+}
+/** Remove the PID file (best-effort, swallows errors). */
+export function removePidFile(teamRoot) {
+    try {
+        fs.unlinkSync(getPidPath(teamRoot));
+    }
+    catch { /* already gone */ }
+}
+/**
+ * Check if a process with the given PID is still alive.
+ * Uses `process.kill(pid, 0)` — signal 0 tests existence without killing.
+ */
+export function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (e) {
+        // EPERM means the process exists but we lack permission to signal it
+        if (e && typeof e === 'object' && 'code' in e && e.code === 'EPERM') {
+            return true;
+        }
+        return false;
+    }
+}
+/** Format a duration in milliseconds to a human-readable string. */
+function formatUptime(ms) {
+    const totalMinutes = Math.floor(ms / 60_000);
+    const hours = Math.floor(totalMinutes / 60);
+    const minutes = totalMinutes % 60;
+    if (hours > 0)
+        return `${hours}h ${minutes}m`;
+    return `${minutes}m`;
+}
+/**
+ * Returns the currently active `gh` account, or undefined.
+ * Duplicated from index.ts to avoid circular imports — the canonical
+ * version lives in `getActiveGhUser()` in the watch index.
+ */
+/** Probes gh auth status — captures both stdout and stderr since gh may write to either. */
+function probeCurrentGhUser() {
+    try {
+        const result = execFileSync('gh', ['auth', 'status', '--active'], {
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const match = result.match(/account\s+(\S+)/);
+        return match?.[1];
+    }
+    catch (e) {
+        const stderr = e.stderr ?? '';
+        const match = stderr.match(/account\s+(\S+)/);
+        return match?.[1];
+    }
+}
+/**
+ * Run the watch health check and return a formatted status string.
+ *
+ * @param teamRoot - The repository root (directory containing `.squad/`).
+ */
+export function getWatchHealth(teamRoot) {
+    const pidPath = getPidPath(teamRoot);
+    if (!fs.existsSync(pidPath)) {
+        return '📋 No watch instance detected.\n   Start one with: squad watch --execute --interval 5';
+    }
+    let info;
+    try {
+        info = JSON.parse(fs.readFileSync(pidPath, 'utf-8'));
+    }
+    catch {
+        return `⚠ Corrupt PID file — cannot read watch status.\n   Delete ${pidPath} and restart.`;
+    }
+    // Validate minimal fields
+    if (typeof info.pid !== 'number') {
+        return `⚠ Invalid PID file (missing pid).\n   Delete ${pidPath} and restart.`;
+    }
+    // Check if the process is actually running
+    if (!isProcessAlive(info.pid)) {
+        // Stale PID file — process died without cleanup
+        removePidFile(teamRoot);
+        return `⚠ Stale watch detected (PID ${info.pid} is dead). Cleaned up.\n   Restart with: squad watch --execute --interval 5`;
+    }
+    // Process is alive — build status report
+    // Validate startedAt before computing uptime
+    if (!info.startedAt || isNaN(new Date(info.startedAt).getTime())) {
+        return `⚠ Invalid PID file (bad startedAt).
+   Delete ${pidPath} and restart.`;
+    }
+    const uptime = formatUptime(Date.now() - new Date(info.startedAt).getTime());
+    const lines = [
+        '🔄 Watch Instance — RUNNING',
+        '━━━━━━━━━━━━━━━━━━━━━━━━━━━━',
+        `  PID:           ${info.pid}`,
+        `  Uptime:        ${uptime}`,
+        `  Auth:          ${info.user}`,
+        `  Interval:      ${info.interval}m`,
+        `  Repo:          ${info.repo}`,
+        `  Capabilities:  ${(info.capabilities ?? []).join(', ') || '(none)'}`,
+    ];
+    // Auth drift detection — compare current gh user vs recorded
+    const currentUser = probeCurrentGhUser();
+    if (currentUser && currentUser !== info.user) {
+        lines.push(`  ⚠ AUTH DRIFT:   Expected ${info.user}, current is ${currentUser}`);
+    }
+    else if (currentUser) {
+        lines.push('  Auth status:   ✓ matches expected');
+    }
+    else {
+        lines.push('  Auth status:   ? could not verify');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=health.js.map

package/dist/cli/commands/watch/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../../../src/cli/commands/watch/health.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/watch/index.d.ts

@@ -12,6 +12,8 @@ export { loadWatchConfig } from './config.js';
 export type { WatchCapability, WatchContext, WatchPhase, PreflightResult, CapabilityResult } from './types.js';
 export { CapabilityRegistry } from './registry.js';
 export { createDefaultRegistry } from './capabilities/index.js';
+export { createVerboseLogger, type VerboseLogger } from './verbose.js';
+export { getWatchHealth, writePidFile, removePidFile, getPidPath, isProcessAlive, type WatchPidInfo } from './health.js';
 /** Normalized work item for watch operations. */
 export interface WatchWorkItem {
     number: number;
@@ -53,7 +55,12 @@ export interface BoardState {
     readyToMerge: number;
     executed: number;
 }
-export declare function reportBoard(state: BoardState, round: number): void;
+export interface ReportBoardOptions {
+    notifyLevel?: 'all' | 'important' | 'none';
+    machineName?: string;
+    repoName?: string;
+}
+export declare function reportBoard(state: BoardState, round: number, options?: ReportBoardOptions): void;
 /**
  * Legacy WatchOptions type — still accepted by runWatch for backward
  * compatibility.  New code should use {@link WatchConfig} instead.
@@ -75,7 +82,7 @@ export interface WatchOptions {
     decisionHygiene?: boolean;
     channelRouting?: boolean;
 }
-export { findExecutableIssues } from './capabilities/execute.js';
+export { findExecutableIssues, classifyIssue } from './capabilities/execute.js';
 export declare function buildAgentCommand(issue: WatchWorkItem, teamRoot: string, options: WatchOptions): {
     cmd: string;
     args: string[];

package/dist/cli/commands/watch/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/watch/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/watch/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8BH,OAAO,KAAK,EAAE,eAAe,EAA2C,MAAM,iCAAiC,CAAC;AAEhH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAQ/C,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC/G,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAIzH,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChC,SAAS,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACrC;AAED,oDAAoD;AACpD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1B,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3D;AAmFD,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAyBhG;AAoUD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AA2BD,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAEhF,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,GACpB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CASjC;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9D;AAED,wBAAsB,YAAY,CAChC,KAAK,EAAE,aAAa,EACpB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAoB/C;AAID;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA4V/F"}

package/dist/cli/commands/watch/index.js

@@ -6,6 +6,7 @@
  * always runs — it is not an opt-in capability.
  */
 import path from 'node:path';
+import fs from 'node:fs';
 import { execFile, execFileSync } from 'node:child_process';
 import { promisify } from 'node:util';
 import { FSStorageProvider } from '@bradygaster/squad-sdk';
@@ -21,9 +22,12 @@ import { ghAvailable, ghAuthenticated, ghRateLimitCheck, isRateLimitError } from
 import { PredictiveCircuitBreaker, getTrafficLight, } from '@bradygaster/squad-sdk/ralph/rate-limiting';
 import { createPlatformAdapter } from '@bradygaster/squad-sdk/platform';
 import { createDefaultRegistry } from './capabilities/index.js';
+import { createVerboseLogger } from './verbose.js';
 export { loadWatchConfig } from './config.js';
 export { CapabilityRegistry } from './registry.js';
 export { createDefaultRegistry } from './capabilities/index.js';
+export { createVerboseLogger } from './verbose.js';
+export { getWatchHealth, writePidFile, removePidFile, getPidPath, isProcessAlive } from './health.js';
 // ── SDK Mapping Helpers ──────────────────────────────────────────
 function toWatchWorkItem(wi) {
     return {
@@ -96,13 +100,21 @@ async function editWorkItem(adapter, id, options) {
         }
     }
 }
-export function reportBoard(state, round) {
+export function reportBoard(state, round, options) {
+    const level = options?.notifyLevel ?? 'all';
     const total = Object.values(state).reduce((a, b) => a + b, 0);
+    if (level === 'none')
+        return;
+    if (level === 'important' && total === 0)
+        return;
     if (total === 0) {
         console.log(`${DIM}📋 Board is clear — Ralph is idling${RESET}`);
         return;
     }
-    console.log(`\n${BOLD}🔄 Ralph — Round ${round}${RESET}`);
+    const suffix = options?.machineName || options?.repoName
+        ? ` (${[options.machineName, options.repoName].filter(Boolean).join(' · ')})`
+        : '';
+    console.log(`\n${BOLD}🔄 Ralph — Round ${round}${suffix}${RESET}`);
     console.log('━'.repeat(30));
     if (state.untriaged > 0)
         console.log(`  🔴 Untriaged:         ${state.untriaged}`);
@@ -125,10 +137,14 @@ export function reportBoard(state, round) {
 function emptyBoardState() {
     return { untriaged: 0, assigned: 0, drafts: 0, needsReview: 0, changesRequested: 0, ciFailures: 0, readyToMerge: 0, executed: 0 };
 }
-async function checkPRs(roster, adapter) {
+async function checkPRs(roster, adapter, vlog) {
     const timestamp = new Date().toLocaleTimeString();
     const prs = await listWatchPullRequests(adapter, { state: 'open', limit: 20 });
     const squadPRs = prs.filter(pr => pr.labels.some(l => l.name.startsWith('squad')) || pr.headRefName.startsWith('squad/'));
+    vlog?.log(`PRs found: ${prs.length} total`);
+    for (const pr of squadPRs) {
+        vlog?.log(`  PR #${pr.number}: "${pr.title}" draft=${pr.isDraft} review=${pr.reviewDecision ?? 'none'}`);
+    }
     if (squadPRs.length === 0) {
         return { drafts: 0, needsReview: 0, changesRequested: 0, ciFailures: 0, readyToMerge: 0, totalOpen: 0 };
     }
@@ -182,10 +198,16 @@ const BLOCKED_LABELS = new Set([
     'status:scheduled', 'status:needs-action', 'status:needs-decision',
     'status:needs-review', 'pending-user', 'do-not-merge',
 ]);
-async function runCheck(rules, modules, roster, hasCopilot, autoAssign, capabilities, adapter) {
+async function runCheck(rules, modules, roster, hasCopilot, autoAssign, capabilities, adapter, vlog) {
     const timestamp = new Date().toLocaleTimeString();
     try {
         const issues = await listWatchWorkItems(adapter, { label: 'squad', state: 'open', limit: 20 });
+        vlog?.log(`Issues found: ${issues.length} total`);
+        for (const issue of issues) {
+            const labels = issue.labels?.map((l) => l.name).join(', ') ?? 'none';
+            const assignees = issue.assignees?.map((a) => a.login).join(', ') ?? 'none';
+            vlog?.log(`  #${issue.number}: "${issue.title}" [${labels}] assignees=[${assignees}]`);
+        }
         const { filterByCapabilities } = await import('@bradygaster/squad-sdk/ralph/capabilities');
         const { handled: capableIssues, skipped: incapableIssues } = filterByCapabilities(issues, capabilities);
         for (const { issue, missing } of incapableIssues) {
@@ -235,7 +257,7 @@ async function runCheck(rules, modules, roster, hasCopilot, autoAssign, capabili
                 console.error(`${RED}✗${RESET} [${timestamp}] Failed to assign @copilot to #${issue.number}: ${e.message}`);
             }
         }
-        const prState = await checkPRs(roster, adapter);
+        const prState = await checkPRs(roster, adapter, vlog);
         return { untriaged: untriaged.length, assigned: assignedIssues.length, executed: 0, ...prState };
     }
     catch (e) {
@@ -313,7 +335,7 @@ async function runPhase(phase, enabled, context, config) {
                 ...context,
                 config: typeof capConfig === 'object' && capConfig !== null
                     ? capConfig
-                    : { enabled: !!capConfig, maxConcurrent: config.maxConcurrent, timeout: config.timeout },
+                    : { enabled: !!capConfig, maxConcurrent: config.maxConcurrent, timeout: config.timeout, dispatchMode: config.dispatchMode },
             };
             const result = await cap.execute(capContext);
             results.set(cap.name, result);
@@ -398,7 +420,7 @@ function legacyToConfig(options) {
     };
 }
 // ── Exported helpers (backward compat) ───────────────────────────
-export { findExecutableIssues } from './capabilities/execute.js';
+export { findExecutableIssues, classifyIssue } from './capabilities/execute.js';
 export function buildAgentCommand(issue, teamRoot, options) {
     const prompt = `Work on issue #${issue.number}: ${issue.title}. Read the issue body for full details.`;
     if (options.agentCmd) {
@@ -484,6 +506,31 @@ export async function runWatch(dest, options) {
     catch (err) {
         return fatal(`Could not detect platform: ${err.message}`);
     }
+    // Verbose logger
+    const vlog = createVerboseLogger(config.verbose ?? false);
+    vlog.section('Startup');
+    vlog.table({
+        repo: teamRoot,
+        platform: adapter.type,
+        // This table only prints when verbose mode is active, so verbose is always true here.
+        verbose: config.verbose ?? false,
+        interval: `${config.interval}m`,
+        execute: config.execute ?? false,
+        agentCmd: config.agentCmd ?? '(default: gh copilot)',
+        dispatchMode: config.capabilities['wave-dispatch'] ? 'wave' : 'task',
+        maxConcurrent: config.maxConcurrent ?? 1,
+    });
+    // Auth check (verbose only — avoid unnecessary process spawn on every startup)
+    if (config.verbose && adapter.type === 'github') {
+        try {
+            const authOut = execFileSync('gh', ['auth', 'status'], { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+            const activeAccount = authOut.match(/Logged in to .* account (\S+)/)?.[1];
+            vlog.log(`Auth: ${activeAccount ?? 'unknown'}`);
+        }
+        catch {
+            vlog.warn('gh auth status failed — API calls may fail silently');
+        }
+    }
     // Verify platform CLI availability
     if (adapter.type === 'github') {
         if (!(await ghAvailable()))
@@ -520,6 +567,20 @@ export async function runWatch(dest, options) {
     if (roster.length === 0) {
         fatal('No squad members found in team.md');
     }
+    // Pre-create squad member labels so addTag never fails on missing labels
+    if (adapter.ensureTag) {
+        for (const member of roster) {
+            try {
+                await adapter.ensureTag(member.label, { color: 'd4c5f9', description: `Squad triage: ${member.name}` });
+            }
+            catch { /* best-effort — continue if label creation fails */ }
+        }
+        try {
+            await adapter.ensureTag('squad:copilot', { color: 'd4c5f9', description: 'Squad triage: Copilot coding agent' });
+        }
+        catch { /* best-effort */ }
+        console.log(`${DIM}Labels: ensured ${roster.length + 1} squad labels exist${RESET}`);
+    }
     const hasCopilot = content.includes('🤖 Coding Agent') || content.includes('@copilot');
     const autoAssign = content.includes('<!-- copilot-auto-assign: true -->');
     const monitorSessionId = 'ralph-watch';
@@ -545,6 +606,7 @@ export async function runWatch(dest, options) {
         config: {},
         agentCmd: config.agentCmd,
         copilotFlags: config.copilotFlags,
+        verbose: config.verbose,
     };
     const enabledCapabilities = await preflightCapabilities(registry, config, baseContext);
     // Print startup banner
@@ -558,7 +620,30 @@ export async function runWatch(dest, options) {
     if (config.execute) {
         console.log(`${DIM}Max concurrent: ${config.maxConcurrent} | Timeout: ${config.timeout}m${RESET}`);
     }
+    // Warn when fleet dispatch mode is set but the fleet-dispatch capability is not enabled
+    if ((config.dispatchMode === 'fleet' || config.dispatchMode === 'hybrid') &&
+        !enabledCapabilities.some(c => c.name === 'fleet-dispatch')) {
+        console.warn(`${YELLOW}⚠${RESET}  dispatchMode="${config.dispatchMode}" but fleet-dispatch capability is not enabled. Read-heavy issues will not be batched.`);
+    }
     console.log();
+    // Fix 2: Set up log-file tee (after banner so the banner itself is captured too)
+    let logStream;
+    if (config.logFile) {
+        const resolvedLogFile = path.resolve(config.logFile);
+        logStream = fs.createWriteStream(resolvedLogFile, { flags: 'a' });
+        const origLog = console.log.bind(console);
+        console.log = (...args) => {
+            origLog(...args);
+            const timestamp = new Date().toISOString().replace('T', ' ').slice(0, 19);
+            const line = args.map(a => (typeof a === 'string' ? a : String(a))).join(' ');
+            // Strip ANSI escape codes for the file
+            const plain = line.replace(/\x1b\[[0-9;]*m/g, '');
+            logStream.write(`[${timestamp}] ${plain}\n`);
+        };
+        console.log(`${DIM}Log file: ${resolvedLogFile}${RESET}`);
+    }
+    // Fix 3: Immediate visual feedback after banner
+    console.log(`Running first check now...`);
     // Initialize circuit breaker (#515)
     const circuitBreaker = new PredictiveCircuitBreaker();
     let cbState = loadCBState(squadDirInfo.path);
@@ -566,6 +651,7 @@ export async function runWatch(dest, options) {
     let roundInProgress = false;
     async function executeRound() {
         const ts = new Date().toLocaleTimeString();
+        const roundStart = Date.now();
         // Circuit breaker gate
         if (cbState.status === 'open') {
             const elapsed = Date.now() - new Date(cbState.openedAt).getTime();
@@ -606,6 +692,9 @@ export async function runWatch(dest, options) {
         }
         round++;
         const roundContext = { ...baseContext, round };
+        // Fix 1: Print round start marker
+        console.log(`\n${DIM}Starting round ${round}...${RESET}`);
+        vlog.section(`Round ${round}`);
         // Phase 1: pre-scan (self-pull, subsquad discovery)
         await runPhase('pre-scan', enabledCapabilities, roundContext, config);
         // SubSquad discovery (informational, not a capability)
@@ -614,7 +703,7 @@ export async function runWatch(dest, options) {
             console.log(`${DIM}📂 Discovered ${subSquads.length} subsquad(s): ${subSquads.map(s => s.name).join(', ')}${RESET}`);
         }
         // Core: triage (always runs — not a capability)
-        const roundState = await runCheck(rules, modules, roster, hasCopilot, autoAssign, capabilities, adapter);
+        const roundState = await runCheck(rules, modules, roster, hasCopilot, autoAssign, capabilities, adapter, vlog);
         // Phase 2: post-triage (two-pass hydration)
         await runPhase('post-triage', enabledCapabilities, roundContext, config);
         // Phase 3: post-execute (execute issues, wave dispatch, board updates)
@@ -633,7 +722,21 @@ export async function runWatch(dest, options) {
             timestamp: new Date(),
         });
         await monitor.healthCheck();
+        // Verbose board counters
+        vlog.table({
+            untriaged: roundState.untriaged,
+            assigned: roundState.assigned,
+            drafts: roundState.drafts,
+            needsReview: roundState.needsReview,
+            changesRequested: roundState.changesRequested,
+            ciFailures: roundState.ciFailures,
+            readyToMerge: roundState.readyToMerge,
+            executed: roundState.executed,
+        });
         reportBoard(roundState, round);
+        // Fix 1: Print next poll time
+        const nextPollTime = new Date(Date.now() + interval * 60 * 1000);
+        console.log(`${DIM}Next poll at ${nextPollTime.toLocaleTimeString()}${RESET}`);
         // Post-round: update circuit breaker on success
         if (cbState.status === 'half-open') {
             cbState.consecutiveSuccesses++;
@@ -649,6 +752,9 @@ export async function runWatch(dest, options) {
             cbState.consecutiveFailures = 0;
         }
         saveCBState(squadDirInfo.path, cbState);
+        const roundEnd = Date.now();
+        const elapsed = ((roundEnd - roundStart) / 1000).toFixed(1);
+        vlog.log(`Round ${round} complete (${elapsed}s)`);
     }
     // Run immediately, then on interval
     await executeRound();
@@ -695,6 +801,7 @@ export async function runWatch(dest, options) {
             await monitor.stop();
             saveCBState(squadDirInfo.path, cbState);
             console.log(`\n${DIM}🔄 Ralph — Watch stopped${RESET}`);
+            logStream?.end();
             resolve();
         };
         process.on('SIGINT', shutdown);