@phnx-labs/agents-cli 1.22.25 → 1.22.26

package/dist/commands/sessions.js

@@ -57,6 +57,7 @@ import { registerSessionsFavoriteCommand } from './sessions-favorite.js';
 import { isFavorite, listFavorites } from '../lib/session/favorites.js';
 import { registerGoCommand } from './go.js';
 import { registerFocusCommand } from './focus.js';
+import { registerReconnectCommand } from './reconnect.js';
 import { registerDetachCommand } from './detach.js';
 import { registerAttachCommand } from './attach.js';
 import { registerSessionsInjectCommand } from './sessions-inject.js';
@@ -66,6 +67,7 @@ import { registerSessionsImportCommand } from './sessions-import.js';
 import { registerSessionsMigrateCommand, registerSessionsMigrationsCommand } from './sessions-migrate.js';
 import { registerSessionsBackfillCommand } from './sessions-backfill.js';
 import { registerSessionsStatsCommand } from './sessions-stats.js';
+import { registerSessionsInsightsCommand } from './insights.js';
 import { registerSessionsOptimizeCommand } from './sessions-optimize.js';
 import { runBrowserSessions } from '../lib/browser/sessions-list.js';
 import { countToolProgramOccurrences, parseToolProgramCountClause, readToolIndexCoverage, searchToolCalls, TOOL_QUERY_MAX_CLAUSE_BYTES, TOOL_QUERY_MAX_CLAUSES, TOOL_QUERY_MAX_RESULT_SESSIONS, serializeToolSearchEnvelope, toolSearchRemoteReceiveBudget, } from '../lib/session/tool-index.js';
@@ -4082,6 +4084,7 @@ export function registerSessionsCommands(program) {
     registerSessionsFavoriteCommand(sessionsCmd);
     registerGoCommand(sessionsCmd);
     registerFocusCommand(sessionsCmd);
+    registerReconnectCommand(sessionsCmd);
     registerDetachCommand(sessionsCmd);
     registerAttachCommand(sessionsCmd);
     registerSessionsInjectCommand(sessionsCmd);
@@ -4092,6 +4095,7 @@ export function registerSessionsCommands(program) {
     registerSessionsMigrationsCommand(sessionsCmd);
     registerSessionsBackfillCommand(sessionsCmd);
     registerSessionsStatsCommand(sessionsCmd);
+    registerSessionsInsightsCommand(sessionsCmd);
     registerSessionsOptimizeCommand(sessionsCmd);
     // Observe-umbrella alias (Phase 3): roster → sessions --active.
     registerSessionsObserveAliases(program);

package/dist/commands/setup-secrets.d.ts

@@ -15,6 +15,7 @@ interface SetupSecretsOptions {
     iUnderstand?: boolean;
     force?: boolean;
 }
+export declare function setupSecretsPrefsPath(): string;
 /** The wizard's `--policy` shares the canonical parser with `agents secrets
  * policy`, so it accepts `hold` (and the `daily`/`session` aliases) rather than
  * carrying its own copy that knows only the retired vocabulary. `parsePolicyOpt`

package/dist/commands/setup-secrets.js

@@ -15,7 +15,7 @@ import { parsePolicyOpt } from './secrets.js';
 function defaultBackendForPlatform(platform = process.platform) {
     return platform === 'darwin' ? 'keychain' : 'file';
 }
-function setupSecretsPrefsPath() {
+export function setupSecretsPrefsPath() {
     return path.join(getHistoryDir(), 'setup', 'secrets.json');
 }
 function parseBackend(raw) {

package/dist/commands/setup.d.ts

@@ -5,12 +5,14 @@
  * ~/.agents/.system/ and installs agent CLIs with resource syncing.
  */
 import type { Command } from 'commander';
-/** First-run setup. Clones ~/.agents/.system/ from the system repo if needed. */
-export declare function runSetup(program: Command, options?: {
+interface RunSetupOptions {
     force?: boolean;
     suppressFooter?: boolean;
     systemRepo?: boolean;
-}): Promise<void>;
+    runHub?: () => Promise<void>;
+}
+/** First-run setup. Clones ~/.agents/.system/ from the system repo if needed. */
+export declare function runSetup(program: Command, options?: RunSetupOptions): Promise<void>;
 /**
  * Ensure the system repo exists before running a command that needs it.
  * If ~/.agents/.system/ is not a git repo AND we're in an interactive TTY,
@@ -18,5 +20,26 @@ export declare function runSetup(program: Command, options?: {
  * error and exit.
  */
 export declare function ensureInitialized(program: Command): Promise<void>;
+/**
+ * Interactive "what else do you want to set up?" menu shown after the bare
+ * `agents setup` finishes on a TTY. Each pick runs that capability's guided
+ * wizard. Never throws — a cancel or an optional wizard's error just skips the
+ * rest and lets core setup complete.
+ */
+export type SetupPhase = 'browser' | 'computer' | 'share' | 'secrets' | 'fleet' | 'watchdog' | 'preferences';
+export type SetupStatusState = 'ready' | 'missing' | 'n/a';
+export interface SetupStatusRow {
+    phase: 'core' | SetupPhase;
+    state: SetupStatusState;
+    detail: string;
+}
+export declare function getSetupStatus(): Promise<SetupStatusRow[]>;
+export declare function renderSetupStatus(rows: SetupStatusRow[]): void;
+export declare function runSetupHub(deps?: {
+    interactive?: boolean;
+    selectPhase?: (rows: SetupStatusRow[]) => Promise<SetupPhase | 'exit'>;
+    runPhase?: (phase: SetupPhase) => Promise<void>;
+}): Promise<void>;
 /** Register the `agents setup` command and its capability subcommands. */
 export declare function registerSetupCommand(program: Command): void;
+export {};

package/dist/commands/setup.js

@@ -26,6 +26,13 @@ import { registerSetupSecretsCommand } from './setup-secrets.js';
 import { registerSetupFleetCommand } from './setup-fleet.js';
 import { registerSetupWatchdogCommand, runWatchdogSetupWizard } from './setup-watchdog.js';
 import { runPreferencesStep } from './setup-preferences.js';
+import { getConfiguredDefaultProfileName, getProfile, isProfileLaunchableHere, DEFAULT_BROWSER_PROFILE_NAME } from '../lib/browser/profiles.js';
+import { listInstalledBrowsers } from '../lib/browser/chrome.js';
+import { probeComputerTrust } from './computer.js';
+import { readShareConfig } from '../lib/share/config.js';
+import { loadDevices } from '../lib/devices/registry.js';
+import { getConfigValue } from '../lib/device-config.js';
+import { setupSecretsPrefsPath } from './setup-secrets.js';
 const HOME = os.homedir();
 /**
  * Import an existing unmanaged agent installation into agents-cli.
@@ -70,9 +77,9 @@ export async function runSetup(program, options = {}) {
     const agentsDir = getAgentsDir();
     const alreadyConfigured = isGitRepo(agentsDir);
     if (alreadyConfigured && !options.force) {
-        console.log(chalk.gray('~/.agents/.system/ is already set up.'));
-        console.log(chalk.gray('\nTo sync updates:      agents repo pull system'));
-        console.log(chalk.gray('To re-run setup:      agents setup --force'));
+        if (options.suppressFooter)
+            return;
+        await (options.runHub ?? runSetupHub)();
         return;
     }
     // Detect existing installations BEFORE cloning (they won't exist after if we import)
@@ -193,11 +200,7 @@ export async function runSetup(program, options = {}) {
     // Fresh-machine hub: offer to set up the optional capabilities that need their
     // own guided flow. TTY-only and fully opt-in — a non-interactive `agents setup`
     // stops at the system-repo bootstrap above, unchanged.
-    await runSetupHub();
-    // Preferences step: the two questions that keep agents off the wrong machine —
-    // which box you sit at (interactive host) and which browser agents drive here.
-    // TTY-only, skippable, and writes the same keys as `agents devices …`.
-    await runPreferencesStep();
+    await (options.runHub ?? runSetupHub)();
     console.log(chalk.bold('\nSetup complete. Try:'));
     console.log(chalk.cyan('  agents view                 ') + chalk.gray(' # see what\'s installed'));
     console.log(chalk.cyan('  agents run <agent> "hello"  ') + chalk.gray(' # run an agent'));
@@ -229,42 +232,88 @@ export async function ensureInitialized(program) {
     }
     await runSetup(program, { suppressFooter: true });
 }
-/**
- * Interactive "what else do you want to set up?" menu shown after the bare
- * `agents setup` finishes on a TTY. Each pick runs that capability's guided
- * wizard. Never throws — a cancel or an optional wizard's error just skips the
- * rest and lets core setup complete.
- */
-async function runSetupHub() {
-    if (!isInteractiveTerminal())
+export async function getSetupStatus() {
+    const configuredBrowserProfile = getConfiguredDefaultProfileName();
+    const browserProfile = await getProfile(configuredBrowserProfile ?? DEFAULT_BROWSER_PROFILE_NAME);
+    const browserReady = browserProfile !== null && isProfileLaunchableHere(browserProfile);
+    const installedBrowsers = listInstalledBrowsers();
+    const computerState = process.platform === 'darwin' ? (await probeComputerTrust() ? 'ready' : 'missing') : 'n/a';
+    const devices = await loadDevices();
+    const coreReady = isGitRepo(getAgentsDir());
+    const secretsReady = fs.existsSync(setupSecretsPrefsPath());
+    const shareConfig = readShareConfig();
+    const watchdogEnabled = getConfigValue('watchdog.enabled').value === true;
+    const interactiveHost = getConfigValue('interactive.host').value;
+    const defaultBrowser = getConfigValue('browser.profile').value;
+    return [
+        { phase: 'core', state: coreReady ? 'ready' : 'missing', detail: coreReady ? 'system repo ready' : 'system repo missing' },
+        { phase: 'browser', state: browserReady ? 'ready' : 'missing', detail: browserReady ? `profile ${browserProfile.name}` : browserProfile ? `profile ${browserProfile.name} cannot launch here` : installedBrowsers.length ? 'no default profile' : 'no supported browser found' },
+        { phase: 'computer', state: computerState, detail: computerState === 'ready' ? 'helper trusted' : computerState === 'n/a' ? 'macOS local setup only' : 'helper not running or not trusted' },
+        { phase: 'secrets', state: secretsReady ? 'ready' : 'missing', detail: secretsReady ? 'defaults chosen' : 'defaults not chosen' },
+        { phase: 'fleet', state: Object.keys(devices).length ? 'ready' : 'missing', detail: Object.keys(devices).length ? `${Object.keys(devices).length} device${Object.keys(devices).length === 1 ? '' : 's'} registered` : 'no devices registered' },
+        { phase: 'share', state: shareConfig ? 'ready' : 'missing', detail: shareConfig?.baseUrl ?? 'endpoint not configured' },
+        { phase: 'watchdog', state: watchdogEnabled ? 'ready' : 'missing', detail: watchdogEnabled ? 'enabled on this device' : 'disabled on this device' },
+        { phase: 'preferences', state: interactiveHost || defaultBrowser ? 'ready' : 'missing', detail: [interactiveHost && `host ${interactiveHost}`, defaultBrowser && `browser ${defaultBrowser}`].filter(Boolean).join(' · ') || 'interactive host and browser unset' },
+    ];
+}
+export function renderSetupStatus(rows) {
+    console.log(chalk.bold('\nagents setup — onboarding\n'));
+    for (const row of rows) {
+        const marker = row.state === 'ready' ? chalk.green('[x]') : row.state === 'n/a' ? chalk.gray('[-]') : chalk.yellow('[ ]');
+        const label = row.phase[0].toUpperCase() + row.phase.slice(1);
+        console.log(`  ${marker} ${label.padEnd(12)} ${chalk.gray(row.detail)}`);
+    }
+}
+async function runSetupPhase(phase) {
+    if (phase === 'browser')
+        await runBrowserWizard();
+    else if (phase === 'computer')
+        await runComputerWizard();
+    else if (phase === 'share')
+        await runShareWizard();
+    else if (phase === 'secrets')
+        await import('./setup-secrets.js').then((m) => m.runSecretsSetupWizard());
+    else if (phase === 'fleet')
+        await import('./setup-fleet.js').then((m) => m.runFleetSetupWizard());
+    else if (phase === 'watchdog')
+        await runWatchdogSetupWizard();
+    else
+        await runPreferencesStep();
+}
+export async function runSetupHub(deps = {}) {
+    const interactive = deps.interactive ?? isInteractiveTerminal();
+    if (!interactive) {
+        const rows = await getSetupStatus();
+        renderSetupStatus(rows);
+        if (rows.some((row) => row.state === 'missing'))
+            process.exitCode = 1;
         return;
+    }
     try {
-        const { checkbox } = await import('@inquirer/prompts');
-        const picks = await checkbox({
-            message: 'Set up optional capabilities now? (space to select, enter to confirm)',
-            choices: [
-                { name: 'browser  — drive a real Chrome/Brave/Edge for web automation', value: 'browser' },
-                { name: 'computer — control native macOS apps (screenshot, click, type)', value: 'computer' },
-                { name: 'share    — publish shareable links (Cloudflare R2 + Worker)', value: 'share' },
-                { name: 'secrets  — choose storage defaults and import existing credentials', value: 'secrets' },
-                { name: 'fleet    — discover Tailscale devices and configure SSH access', value: 'fleet' },
-                { name: 'watchdog — resume stalled agent sessions on selected devices', value: 'watchdog' },
-            ],
-        });
-        for (const pick of picks) {
+        while (true) {
+            const rows = await getSetupStatus();
+            renderSetupStatus(rows);
+            let pick;
+            if (deps.selectPhase) {
+                pick = await deps.selectPhase(rows);
+            }
+            else {
+                const { select } = await import('@inquirer/prompts');
+                pick = await select({
+                    message: 'Choose a phase to configure',
+                    choices: [
+                        ...rows.filter((row) => row.phase !== 'core' && row.state !== 'n/a').map((row) => ({
+                            name: `${row.state === 'ready' ? '[x]' : '[ ]'} ${row.phase.padEnd(12)} ${row.detail}`,
+                            value: row.phase,
+                        })),
+                        { name: 'Exit setup', value: 'exit' },
+                    ],
+                });
+            }
+            if (pick === 'exit')
+                return;
             console.log();
-            if (pick === 'browser')
-                await runBrowserWizard();
-            else if (pick === 'computer')
-                await runComputerWizard();
-            else if (pick === 'share')
-                await runShareWizard();
-            else if (pick === 'secrets')
-                await import('./setup-secrets.js').then((m) => m.runSecretsSetupWizard());
-            else if (pick === 'fleet')
-                await import('./setup-fleet.js').then((m) => m.runFleetSetupWizard());
-            else if (pick === 'watchdog')
-                await runWatchdogSetupWizard();
+            await (deps.runPhase ?? runSetupPhase)(pick);
         }
     }
     catch (err) {
@@ -277,7 +326,7 @@ async function runSetupHub() {
 export function registerSetupCommand(program) {
     const setupCmd = program
         .command('setup')
-        .description('First-time setup. Clones a config repo and installs agent CLIs.')
+        .description('Set up agents-cli, or re-open the capability onboarding hub.')
         .option('-f, --force', 'Re-run setup even if ~/.agents/.system/ already exists (use with caution)')
         .option('--no-system-repo', 'Skip cloning the system repo (you must populate ~/.agents/.system/ yourself)');
     // Capability subcommands: `agents setup browser|computer|share|mine|secrets|fleet`.
@@ -288,6 +337,18 @@ export function registerSetupCommand(program) {
     registerSetupSecretsCommand(setupCmd);
     registerSetupFleetCommand(setupCmd);
     registerSetupWatchdogCommand(setupCmd);
+    setupCmd.command('status')
+        .description('Show setup readiness for core, browser, computer, secrets, fleet, share, watchdog, and preferences.')
+        .option('--json', 'print machine-readable JSON')
+        .action(async (options) => {
+        const rows = await getSetupStatus();
+        if (options.json)
+            console.log(JSON.stringify(rows, null, 2));
+        else
+            renderSetupStatus(rows);
+        if (rows.some((row) => row.state === 'missing'))
+            process.exitCode = 1;
+    });
     setHelpSections(setupCmd, {
         examples: `
       # First-time setup (clones the system repo into ~/.agents/.system/)
@@ -308,10 +369,8 @@ export function registerSetupCommand(program) {
       What it does:
         1. Clones the system repo into ~/.agents/.system/
         2. Imports any unmanaged agent installations it finds
-        3. On a TTY, offers to set up optional capabilities (browser/computer/share/secrets/fleet/watchdog)
-        4. On a TTY, asks preferences: which machine you sit at (interactive host)
-           and which browser agents drive here — both skippable, both the same
-           keys 'agents devices set-interactive' / 'browser profiles set-default' write
+        3. Opens a re-runnable capability menu with live ready/missing status
+        4. Delegates each selection to its existing setup wizard
 
       Capability setup can also be run any time on its own:
         agents setup browser    # detect a browser + create the default profile

package/dist/commands/teams.d.ts

@@ -34,6 +34,12 @@ export interface TeamListAgentSnapshot {
     cloud_provider: string | null;
     pr_url: string | null;
 }
+/**
+ * One-line operator nudge after `teams start`: teammates are briefed to post
+ * IMPORTANT milestones to the feed (RUSH-2250), and this is how to watch them.
+ * Print-only — no engine behavior.
+ */
+export declare function printFeedHint(team: string): void;
 /** Where `teams message`/`teams resume` routes a follow-up, by teammate status. */
 export type TeamMessageRoute = {
     kind: 'steer';

package/dist/commands/teams.js

@@ -153,6 +153,18 @@ function fullName(type, version) {
     const name = AGENT_NAMES[type];
     return version ? `${name} ${version}` : name;
 }
+/**
+ * One-line operator nudge after `teams start`: teammates are briefed to post
+ * IMPORTANT milestones to the feed (RUSH-2250), and this is how to watch them.
+ * Print-only — no engine behavior.
+ */
+export function printFeedHint(team) {
+    console.log(chalk.gray('Tip: teammates post IMPORTANT milestones to the feed (') +
+        chalk.cyan('agents feed timeline') +
+        chalk.gray('); watch team progress with ') +
+        chalk.cyan(`agents teams status ${team}`) +
+        chalk.gray('.'));
+}
 /**
  * Resolve a teammate spec to its execution target.
  *
@@ -365,6 +377,8 @@ async function runOneWave(mgr, team, json) {
             console.log(`  ${chalk.blue(h)}  ${chalk.gray('after')} ${a.after.join(', ')}`);
         }
     }
+    if (launched.length > 0)
+        printFeedHint(team);
 }
 /**
  * Path to the pr-watch dedupe-state file for a team. Persists the set of
@@ -1766,11 +1780,40 @@ export function registerTeamsCommands(program) {
             await warnUnsignedTeammates(mgr, team);
             await warnThrottledTeammates(mgr, team);
         }
+        // Health-/harness-aware pre-flight (RUSH-2002): if the team declares a
+        // device pool and no device in it can run a pending teammate's agent, fail
+        // loud here rather than launching a wave that strands teammates pending.
+        // --force downgrades it to a warning so the user can still try.
+        const placementError = await mgr.preflightPlacement(team);
+        if (placementError) {
+            if (isJsonMode(opts)) {
+                console.log(JSON.stringify({
+                    team,
+                    error: 'no-viable-device',
+                    message: placementError.message,
+                    excluded: placementError.excluded,
+                }));
+                if (!opts.force) {
+                    process.exitCode = 1;
+                    return;
+                }
+            }
+            else if (opts.force) {
+                console.error(chalk.yellow(`⚠ ${placementError.message}\n  Continuing anyway (--force).`));
+            }
+            else {
+                console.error(chalk.red(placementError.message));
+                process.exitCode = 1;
+                return;
+            }
+        }
         emit('teams.start', { module: 'teams', team, watch: Boolean(opts.watch) });
         if (!opts.watch) {
             await runOneWave(mgr, team, Boolean(opts.json));
             return;
         }
+        if (!isJsonMode(opts))
+            printFeedHint(team);
         const intervalMs = Math.max(1000, Number.parseInt(opts.interval, 10) * 1000 || 8000);
         const maxWaves = Math.max(1, Number.parseInt(opts.maxWaves, 10) || 1000);
         const json = isJsonMode(opts);

package/dist/commands/trends.d.ts

@@ -1,2 +1,10 @@
+/**
+ * Deprecated top-level spelling of the counter-mix tree.
+ *
+ * Implementation lives under `agents insights mix` (see
+ * `lib/analytics/mix-commands.ts`). This file only registers the thin alias so
+ * old scripts and agent briefs keep working while printing one deprecation line
+ * — no second recipe implementation.
+ */
 import type { Command } from 'commander';
 export declare function registerTrendsCommand(program: Command): void;

package/dist/commands/trends.js

@@ -1,158 +1,12 @@
-import chalk from 'chalk';
-import { setHelpSections } from '../lib/help.js';
-import { buildTrendsDashboard, trendsWindow, runRecipe, RECIPE_IDS } from '../lib/analytics/dashboard.js';
-import { listRecipes } from '../lib/analytics/recipes.js';
-import { queryUsage, usageDbPath, USAGE_KINDS } from '../lib/analytics/usage-db.js';
-function parseDays(raw) {
-    const n = parseInt(raw ?? '7', 10);
-    return Number.isFinite(n) && n > 0 ? n : 7;
-}
-function parseLimit(raw, fallback) {
-    const n = parseInt(raw ?? String(fallback), 10);
-    return Number.isFinite(n) && n > 0 ? n : fallback;
-}
-function printSection(section) {
-    console.log(chalk.bold(section.title));
-    if (section.rows.length === 0) {
-        console.log(chalk.gray('  (no data)'));
-        console.log();
-        return;
-    }
-    const keys = Object.keys(section.rows[0]);
-    const widths = keys.map((k) => Math.max(k.length, ...section.rows.map((r) => String(r[k] ?? '').length), 4));
-    const pad = (s, w) => (s.length >= w ? s.slice(0, w) : s + ' '.repeat(w - s.length));
-    console.log(chalk.gray(keys.map((k, i) => pad(k.toUpperCase(), widths[i])).join('  ')));
-    for (const row of section.rows) {
-        console.log(keys.map((k, i) => pad(String(row[k] ?? ''), widths[i])).join('  '));
-    }
-    console.log();
-}
-function renderDashboard(days, asJson) {
-    const dash = buildTrendsDashboard({ days });
-    if (asJson) {
-        console.log(JSON.stringify(dash, null, 2));
-        return;
-    }
-    console.log(chalk.bold(`agents trends — last ${dash.window.days} days`));
-    console.log(chalk.gray(`compute ${dash.durationMs}ms · usage ${usageDbPath()}`));
-    console.log();
-    if (dash.sections.length === 0) {
-        console.log(chalk.gray('No session or usage data in this window yet.'));
-        return;
-    }
-    for (const section of dash.sections)
-        printSection(section);
-}
+/**
+ * Deprecated top-level spelling of the counter-mix tree.
+ *
+ * Implementation lives under `agents insights mix` (see
+ * `lib/analytics/mix-commands.ts`). This file only registers the thin alias so
+ * old scripts and agent briefs keep working while printing one deprecation line
+ * — no second recipe implementation.
+ */
+import { registerDeprecatedTrendsAlias } from '../lib/analytics/mix-commands.js';
 export function registerTrendsCommand(program) {
-    const trends = program
-        .command('trends')
-        .description('Usage analytics — harness/model mix, token ratios, resource frequency')
-        .option('--days <n>', 'Days of history to include', '7')
-        .option('--json', 'Emit JSON instead of tables')
-        .action(function summary() {
-        const opts = this.opts();
-        renderDashboard(parseDays(opts.days), Boolean(opts.json));
-    });
-    setHelpSections(trends, {
-        examples: `
-      # Auto recipe dashboard (7d)
-      agents trends
-
-      # Last 30 days
-      agents trends --days 30
-
-      # One recipe as JSON
-      agents trends harness-mix --json
-
-      # Raw usage events
-      agents trends query --kind secret --days 7
-
-      # List baked recipe ids
-      agents trends recipes
-    `,
-        notes: `
-      Session recipes read sessions.db; resource recipes read ~/.agents/.history/analytics/usage.db.
-      Empty recipes are skipped on the default dashboard.
-      Quota / rate-limits remain on \`agents usage\`; latency on \`agents perf\`.
-    `,
-    });
-    trends.command('recipes')
-        .description('List baked recipe ids')
-        .option('--json', 'Emit JSON')
-        .action((opts) => {
-        const list = listRecipes();
-        if (opts.json) {
-            console.log(JSON.stringify(list, null, 2));
-            return;
-        }
-        for (const r of list) {
-            console.log(`${r.id.padEnd(22)} ${r.store.padEnd(10)} ${r.title}`);
-        }
-    });
-    trends.command('query')
-        .description('Raw usage-event query')
-        .option('--kind <kind>', `One of: ${USAGE_KINDS.join(', ')}`)
-        .option('--name <name>', 'Resource name filter')
-        .option('--event <event>', 'Event name filter')
-        .option('--days <n>', 'Days of history', '7')
-        .option('--limit <n>', 'Max rows', '40')
-        .option('--json', 'Emit JSON')
-        .action((opts) => {
-        const win = trendsWindow(parseDays(opts.days));
-        const kind = opts.kind && USAGE_KINDS.includes(opts.kind)
-            ? opts.kind
-            : undefined;
-        if (opts.kind && !kind) {
-            console.error(`Unknown kind '${opts.kind}'. Expected: ${USAGE_KINDS.join(', ')}`);
-            process.exitCode = 1;
-            return;
-        }
-        const rows = queryUsage({
-            kind,
-            name: opts.name,
-            event: opts.event,
-            sinceIso: win.sinceIso,
-            limit: parseLimit(opts.limit, 40),
-        });
-        if (opts.json) {
-            console.log(JSON.stringify({ window: win, rows }, null, 2));
-            return;
-        }
-        if (rows.length === 0) {
-            console.log(chalk.gray('No usage events.'));
-            return;
-        }
-        printSection({
-            id: 'query',
-            title: 'Usage events',
-            rows: rows.map((r) => ({
-                ts: r.ts,
-                kind: r.kind,
-                name: r.name,
-                event: r.event,
-                agent: r.agent,
-            })),
-        });
-    });
-    for (const id of RECIPE_IDS) {
-        trends.command(id)
-            .description(`Recipe: ${id}`)
-            .option('--days <n>', 'Days of history', '7')
-            .option('--json', 'Emit JSON')
-            .action(function recipeAction() {
-            const parent = this.parent?.opts?.();
-            const opts = { ...parent, ...this.opts() };
-            const win = trendsWindow(parseDays(opts.days));
-            const section = runRecipe(id, win);
-            if (opts.json) {
-                console.log(JSON.stringify({ window: win, section }, null, 2));
-                return;
-            }
-            if (section.empty) {
-                console.log(chalk.gray(`No data for recipe '${id}' in the last ${win.days} days.`));
-                return;
-            }
-            printSection(section);
-        });
-    }
+    registerDeprecatedTrendsAlias(program);
 }

package/dist/index.js

@@ -327,7 +327,7 @@ Credentials and profiles:
 Diagnostics:
   doctor [agent[@version]]        Diagnose CLI availability, sync status, and resource divergence; --check for the CI drift gate
   usage [agent]                   Show rate-limit and quota usage per agent
-  insights                        How you work — tools, friction, rhythm, split by Claude account
+  insights                        How work looks — behaviour (default) or counter mix (insights mix)
   perf                            Latency rollups (hooks, commands, runs) from the disposable perf warehouse
 
 Config sync:

package/dist/lib/agents.d.ts

@@ -34,6 +34,17 @@ export declare function findInPath(command: string): string | null;
 export declare const AGENTS: Record<AgentId, AgentConfig>;
 /** All current and legacy agent IDs derived from the AGENTS registry. */
 export declare const ALL_AGENT_IDS: AgentId[];
+/**
+ * CLI command templates per agent for daemon-fired routine jobs, with
+ * {prompt} as a placeholder. Lives here (not runner.ts) so routines.ts can
+ * import ROUTINE_AGENT_IDS for schedule-time validation without a circular
+ * import (runner.ts already imports from routines.ts).
+ */
+export declare const ROUTINE_AGENT_COMMANDS: Record<string, string[]>;
+/** Agents the routine daemon can actually run when firing locally, derived
+ * from the command table above so the `--agent` help and validateJob's
+ * schedule-time check can never drift from it. */
+export declare const ROUTINE_AGENT_IDS: readonly string[];
 /** Agents retained only for legacy reads, not install/import/sync targets. */
 export declare const HARD_DEPRECATED_AGENT_IDS: AgentId[];
 /** Agents that can receive managed installs, imports, and resource sync writes. */

package/dist/lib/agents.js

@@ -384,14 +384,22 @@ export const AGENTS = {
         instructionsFile: 'workspace/AGENTS.md', // Primary memory file (also has SOUL.md, IDENTITY.md, etc.)
         format: 'markdown',
         variableSyntax: '{{ARGUMENTS}}',
-        supportsHooks: true,
+        // hooks: NOT supported. OpenClaw only exposes a fixed set of internal,
+        // named hooks (e.g. `boot-md`, which runs BOOT.md on gateway restart) —
+        // there is no general event->shell-command registration surface (no
+        // PreToolUse/PostToolUse/UserPromptSubmit equivalent an agents-cli
+        // hooks.yaml manifest could target). registerHooksToSettings has no
+        // `openclaw` case and silently no-ops (RUSH-2122: capability claimed
+        // hooks:true with zero hooks ever installed). Flip back to `true` only
+        // alongside a real registerHooksForOpenClaw implementation.
+        supportsHooks: false,
         // allowlist: maps blanket (whole-tool) rules to ~/.openclaw/openclaw.json
         // tools.alsoAllow (allow) / tools.deny (deny). OpenClaw gates at tool
         // granularity only, so sub-command/path/domain patterns are skipped.
         // OpenClaw is self-updating (no pinned since), so `true` is correct.
         // Workflows sync as Lobster `.lobster` files under `.openclaw/workflows/`;
         // the Lobster tool runs them by receiving the file path as `pipeline`.
-        capabilities: { hooks: true, mcp: true, mcpHttp: false, mcpHeaders: false, allowlist: true, skills: true, commands: false, plugins: true, subagents: true, rules: { file: 'workspace/AGENTS.md' }, workflows: true, memory: true, modes: ['plan', 'edit', 'skip'], interactiveRepl: true },
+        capabilities: { hooks: false, mcp: true, mcpHttp: false, mcpHeaders: false, allowlist: true, skills: true, commands: false, plugins: true, subagents: true, rules: { file: 'workspace/AGENTS.md' }, workflows: true, memory: true, modes: ['plan', 'edit', 'skip'], interactiveRepl: true },
     },
     copilot: {
         id: 'copilot',
@@ -884,6 +892,25 @@ export const AGENTS = {
 };
 /** All current and legacy agent IDs derived from the AGENTS registry. */
 export const ALL_AGENT_IDS = Object.keys(AGENTS);
+/**
+ * CLI command templates per agent for daemon-fired routine jobs, with
+ * {prompt} as a placeholder. Lives here (not runner.ts) so routines.ts can
+ * import ROUTINE_AGENT_IDS for schedule-time validation without a circular
+ * import (runner.ts already imports from routines.ts).
+ */
+export const ROUTINE_AGENT_COMMANDS = {
+    claude: ['claude', '-p', '--verbose', '{prompt}', '--output-format', 'stream-json', '--permission-mode', 'plan'],
+    codex: ['codex', 'exec', '{prompt}', '--json'],
+    gemini: ['gemini', '{prompt}', '--output-format', 'stream-json'],
+    cursor: ['cursor-agent', '-p', '{prompt}', '--output-format', 'stream-json'],
+    kimi: ['kimi', '--prompt', '{prompt}', '--output-format', 'stream-json'],
+    droid: ['droid', 'exec', '{prompt}', '-o', 'stream-json'],
+    muse: ['muse', 'exec', '{prompt}', '--json'],
+};
+/** Agents the routine daemon can actually run when firing locally, derived
+ * from the command table above so the `--agent` help and validateJob's
+ * schedule-time check can never drift from it. */
+export const ROUTINE_AGENT_IDS = Object.freeze(Object.keys(ROUTINE_AGENT_COMMANDS));
 /** Agents retained only for legacy reads, not install/import/sync targets. */
 export const HARD_DEPRECATED_AGENT_IDS = ALL_AGENT_IDS.filter((id) => AGENTS[id].deprecated?.hard);
 /** Agents that can receive managed installs, imports, and resource sync writes. */