@phnx-labs/agents-cli 1.22.24 → 1.22.26

package/dist/commands/setup-watchdog.js

@@ -3,17 +3,12 @@ import { spawnSync } from 'node:child_process';
 import { getCliLaunch } from '../lib/cli-entry.js';
 import { loadDevices } from '../lib/devices/registry.js';
 import { machineId, normalizeHost } from '../lib/machine-id.js';
-import { devicesWithRoutineEnabled } from '../lib/routine-activation.js';
-import { readJob, setJobEnabled } from '../lib/routines.js';
+import { getConfigValue, setConfigValue } from '../lib/device-config.js';
 import { isPromptCancelled, requireInteractiveSelection } from './utils.js';
-const ROUTINE = 'watchdog';
 export async function runWatchdogSetupWizard() {
-    if (!readJob(ROUTINE)) {
-        throw new Error("Built-in routine 'watchdog' is missing. Run: agents repo pull system");
-    }
     const registry = await loadDevices();
     const devices = [...new Set([...Object.keys(registry), machineId()].map(normalizeHost))].sort();
-    const enabled = new Set(devicesWithRoutineEnabled(ROUTINE).map(normalizeHost));
+    const enabled = new Set(devices.filter((device) => getConfigValue('watchdog.enabled', { device }).value === true));
     if (!process.stdin.isTTY || !process.stdout.isTTY) {
         requireInteractiveSelection('watchdog devices', ['agents watchdog on', 'agents watchdog on --host <device>']);
     }
@@ -27,10 +22,10 @@ export async function runWatchdogSetupWizard() {
         for (const device of devices) {
             const on = selectedSet.has(device);
             if (device === normalizeHost(machineId())) {
-                setJobEnabled(ROUTINE, on);
+                setConfigValue('watchdog.enabled', on);
                 continue;
             }
-            const launch = getCliLaunch(['routines', on ? 'resume' : 'pause', ROUTINE, '--host', device]);
+            const launch = getCliLaunch(['watchdog', on ? 'on' : 'off', '--host', device]);
             const result = spawnSync(launch.command, launch.args, { stdio: 'inherit', env: process.env });
             if ((result.status ?? 1) !== 0)
                 throw new Error(`Could not configure watchdog on ${device}`);
@@ -49,6 +44,6 @@ export async function runWatchdogSetupWizard() {
 }
 export function registerSetupWatchdogCommand(setup) {
     setup.command('watchdog')
-        .description('Choose the devices where the built-in watchdog routine runs.')
+        .description('Choose the devices where the daemon watchdog pass runs.')
         .action(runWatchdogSetupWizard);
 }

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
@@ -319,7 +378,7 @@ export function registerSetupCommand(program) {
         agents setup share       # provision or join a Cloudflare share endpoint
         agents setup secrets     # choose secrets backend/policy defaults + import
         agents setup fleet       # discover Tailscale devices + configure SSH access
-        agents setup watchdog    # choose which devices run the watchdog routine
+        agents setup watchdog    # choose which devices run the daemon watchdog pass
 
       To install CLIs from agents.yaml and sync resources into version homes:
         agents sync --local -y

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

@@ -47,8 +47,9 @@ const AGENT_NAMES = {
     antigravity: 'Antigravity',
     kimi: 'Kimi',
     droid: 'Droid',
+    warp: 'Warp',
 };
-const VALID_AGENTS = ['claude', 'codex', 'cursor', 'opencode', 'grok', 'antigravity', 'kimi', 'droid'];
+const VALID_AGENTS = ['claude', 'codex', 'cursor', 'opencode', 'grok', 'antigravity', 'kimi', 'droid', 'warp'];
 // 'full' kept as historical alias for 'skip'; normalized to 'skip' downstream.
 const VALID_MODES = ['plan', 'edit', 'auto', 'skip', 'full'];
 const VALID_EFFORTS = ['low', 'medium', 'high', 'xhigh', 'max', 'auto'];
@@ -152,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.
  *
@@ -364,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
@@ -1279,7 +1294,7 @@ export function registerTeamsCommands(program) {
         .alias('a')
         .description("Add a teammate to work on a task. Runs in background; returns immediately. Use 'status' to check in.")
         .option('-n, --name <name>', 'Friendly name for this teammate (e.g. alice). Required if using --after. Unique within team.')
-        .option('-m, --mode <mode>', `Permissions: plan (read-only) | edit (can write files) | auto (smart classifier auto-approves safe ops) | skip (bypass all permission prompts). 'full' accepted as alias for skip. Teammates run headless: plan works headless on claude/codex/droid/opencode; kimi/grok/cursor/antigravity have no headless plan mode and auto-downgrade a plan request to auto.`, 'edit')
+        .option('-m, --mode <mode>', `Permissions: plan (read-only) | edit (can write files) | auto (smart classifier auto-approves safe ops) | skip (bypass all permission prompts). 'full' accepted as alias for skip. Teammates run headless: plan works headless on claude/codex/cursor/droid/opencode; kimi/grok/antigravity have no headless plan mode and auto-downgrade a plan request to auto.`, 'edit')
         .option('-e, --effort <effort>', `Reasoning intensity: ${VALID_EFFORTS.join('|')}`, 'medium')
         .option('--model <model>', 'Cost tier (cheap|default|best|ultra) or a concrete id (e.g. claude-opus-4-8); tiers resolve per harness+version to a supported model')
         .option('--env <key=value>', 'Set an environment variable for this teammate (repeatable for multiple vars)', (val, prev) => [...prev, val], [])
@@ -1765,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/commands/watchdog.d.ts

@@ -10,12 +10,11 @@
  *   agents watchdog --nudge            one tick, actually injects (explicit opt-in)
  *   agents watchdog --watch            manual poll loop (dry unless --nudge)
  *   agents watchdog --json             machine-readable tick output (for the menu-bar)
- *   agents watchdog on|off             turn the always-on watchdog routine on/off
+ *   agents watchdog on|off             turn the device-local daemon pass on/off
  *   agents watchdog policy <id> <p>    per-session policy: off | keep | handsoff
  *
- * The always-on watchdog is a daemon-fired ROUTINE, not a private sentinel + a
- * hand-rolled loop. Its immutable definition comes from the system DotAgents
- * repo; on/off only changes this device's routine membership.
+ * The agents daemon is the sole automatic watchdog scheduler. The menu bar reads
+ * persisted state; it never runs a tick.
  */
 import type { Command } from 'commander';
 /** Register the `agents watchdog` command tree. */