@phnx-labs/agents-cli 1.22.43 → 1.22.45

package/dist/commands/apply.js

@@ -1,10 +1,11 @@
 /**
- * `agents apply` (alias `ag apply`) — reconcile the whole fleet to a declared
- * profile in one command: install agents-cli + agents and sync config. Native
+ * `agents fleet apply` / `agents devices apply` — reconcile the whole fleet
+ * to a declared profile: install agents-cli + agents and sync config. Native
  * harness logins remain device-local; portable provider credentials move only
  * through explicit `agents accounts sync`.
  *
  * The manifest is the `fleet:` block of any `-f` file (default `agents.yaml`).
+ * Top-level `agents apply` is retired (RUSH-2981).
  */
 import * as fs from 'fs';
 import * as path from 'path';
@@ -12,7 +13,7 @@ import { fileURLToPath } from 'url';
 import chalk from 'chalk';
 import { setHelpSections } from '../lib/help.js';
 import { machineId } from '../lib/session/sync/config.js';
-import { loadDevices, isControlDevice } from '../lib/devices/registry.js';
+import { loadDevices } from '../lib/devices/registry.js';
 import { isHostPinned, managedKnownHostsPath } from '../lib/devices/known-hosts.js';
 import { ensureDevicesRegistered } from '../lib/devices/sync.js';
 import { readFleetFile, resolveDesired } from '../lib/fleet/manifest.js';
@@ -163,10 +164,7 @@ async function runApply(opts) {
         }
     }
     const registry = await loadDevices();
-    // Control devices (a cockpit) never run agents — exclude them from the
-    // reconcile set entirely so `agents apply` doesn't try to install/sync/login
-    // onto a paired phone.
-    const all = Object.values(registry).filter((d) => !isControlDevice(d));
+    const all = Object.values(registry);
     const online = all.filter((d) => d.tailscale?.online === true).map((d) => d.name);
     const registered = all.map((d) => d.name);
     // Unresolved names are skipped (surfaced above), never fatal — a manifest
@@ -290,9 +288,7 @@ function reportResults(results) {
     console.log(chalk.green('Fleet reconciled.'));
 }
 /**
- * Attach the reconcile options + action to a command node. Shared by the
- * top-level `agents apply` and its `agents fleet apply` alias so the two can
- * never drift — identical flags, identical engine.
+ * Attach the reconcile options + action to a command node.
  */
 export function configureApplyCommand(cmd) {
     return cmd
@@ -317,32 +313,10 @@ export function configureApplyCommand(cmd) {
         }
     });
 }
-export function registerApplyCommand(program) {
-    const applyCmd = configureApplyCommand(program.command('apply'));
-    setHelpSections(applyCmd, {
-        examples: `
-      # Preview what would change across the fleet
-      agents apply --plan -f agents.yaml
-
-      # Bring every device to the profile (installs + config sync; native login stays local)
-      ag apply -f agents.yaml
-
-      # One device only
-      agents apply --device yosemite-s1 -y
-
-      # Replicate every claude version on this machine onto a fresh box
-      agents apply --agent claude@all --device yosemite-s0 -y
-
-      # Install a specific pinned version on one device
-      agents apply --agent claude@2.1.207 --device yosemite-s0
-    `,
-    });
-}
 /**
- * Surface `agents apply` under the fleet command tree as `agents fleet apply`
- * (and `agents devices apply`). Same reconcile engine as the top-level command —
- * a discoverability alias for users who reach for `fleet` as the verb. Kept in
- * lockstep via {@link configureApplyCommand}.
+ * Canonical surface: `agents fleet apply` / `agents devices apply`.
+ * Top-level `agents apply` is retired (RUSH-2981) — not a noun, already nested
+ * here. Same reconcile engine, kept in lockstep via {@link configureApplyCommand}.
  */
 export function registerFleetApplyAlias(devicesCmd) {
     const sub = configureApplyCommand(devicesCmd.command('apply'));
@@ -353,6 +327,12 @@ export function registerFleetApplyAlias(devicesCmd) {
 
       # Reconcile every device to the profile
       agents fleet apply -y
+
+      # One device only
+      agents fleet apply --device yosemite-s1 -y
+
+      # Replicate every claude version on this machine onto a fresh box
+      agents fleet apply --agent claude@all --device yosemite-s0 -y
     `,
     });
 }

package/dist/commands/artifacts.js

@@ -34,7 +34,7 @@ export function registerArtifactsCommands(program) {
 
       # What's live in your namespace, and taking one down
       agents artifacts share list
-      agents unshare my-plan-a1b2
+      agents artifacts unshare my-plan-a1b2
 
       # Endpoint health, and pushing a new Worker template to it
       agents artifacts share status
@@ -47,12 +47,11 @@ export function registerArtifactsCommands(program) {
   --account/--token/--domain/--analytics-token, or run non-interactively, and it
   provisions directly with what you named.
 
-  agents unshare <targets...> stays a top-level alias of
-  agents artifacts share delete.
+  agents artifacts unshare <targets...> is the nested alias of
+  agents artifacts share delete. Top-level \`agents unshare\` is gone.
 
   Full reference: apps/cli/docs/share.md.
     `,
     });
-    // Top-level, deliberately: see registerUnshareCommand in commands/share.ts.
-    registerUnshareCommand(program);
+    registerUnshareCommand(artifactsCmd);
 }

package/dist/commands/audit.d.ts

@@ -1,14 +1,14 @@
 /**
- * `agents audit` — thin alias of `agents events --include runs`.
+ * `agents events audit` — thin alias of `agents events --include runs`.
  *
  * New run-dispatch outcomes land in the unified event stream as `run.dispatched`
  * (see lib/audit/log.ts::recordDispatchedRun). This command does not own a
  * separate store or query path — it only sets the default family filter.
  *
- *   agents audit              ≡ agents events --include runs
- *   agents audit list         ≡ same
- *   agents audit verify       walks the legacy hash-chain file if present
- *                             (pre-unification history only)
+ *   agents events audit              ≡ agents events --include runs
+ *   agents events audit list         ≡ same
+ *   agents events audit verify       walks the legacy hash-chain file if present
+ *                                    (pre-unification history only)
  */
 import type { Command } from 'commander';
-export declare function registerAuditCommands(program: Command): void;
+export declare function registerAuditCommands(events: Command): void;

package/dist/commands/audit.js

@@ -1,28 +1,28 @@
 /**
- * `agents audit` — thin alias of `agents events --include runs`.
+ * `agents events audit` — thin alias of `agents events --include runs`.
  *
  * New run-dispatch outcomes land in the unified event stream as `run.dispatched`
  * (see lib/audit/log.ts::recordDispatchedRun). This command does not own a
  * separate store or query path — it only sets the default family filter.
  *
- *   agents audit              ≡ agents events --include runs
- *   agents audit list         ≡ same
- *   agents audit verify       walks the legacy hash-chain file if present
- *                             (pre-unification history only)
+ *   agents events audit              ≡ agents events --include runs
+ *   agents events audit list         ≡ same
+ *   agents events audit verify       walks the legacy hash-chain file if present
+ *                                    (pre-unification history only)
  */
 import chalk from 'chalk';
 import { verifyAuditChain, readAuditLog, getAuditLogPath, } from '../lib/audit/log.js';
 import { addEventsReadOptions, runEventsCommand } from './events.js';
-export function registerAuditCommands(program) {
-    const audit = addEventsReadOptions(program
+export function registerAuditCommands(events) {
+    const audit = addEventsReadOptions(events
         .command('audit')
         .description('Alias of `agents events --include runs` — dispatched-run outcomes'), false)
         .addHelpText('after', `
 Examples:
-  agents audit                         Same as: agents events --include runs
-  agents audit --since 7d --json
-  agents audit list                    Muscle-memory alias of bare audit
-  agents audit verify                  Legacy hash-chain file only (if present)
+  agents events audit                  Same as: agents events --include runs
+  agents events audit --since 7d --json
+  agents events audit list             Muscle-memory alias of bare audit
+  agents events audit verify           Legacy hash-chain file only (if present)
 `)
         .action((_options, command) => {
         const opts = command.optsWithGlobals();
@@ -33,7 +33,7 @@ Examples:
     });
     audit
         .command('list')
-        .description('Alias of `agents audit` / `agents events --include runs`')
+        .description('Alias of `agents events audit` / `agents events --include runs`')
         .action((_options, command) => {
         const parent = command.parent;
         const opts = {

package/dist/commands/beta.d.ts

@@ -1,2 +1,8 @@
+/**
+ * `agents setup beta` — enable or disable preview features like factory.
+ * Nested under setup because opting into a preview is machine configuration,
+ * not its own noun (RUSH-2981).
+ */
 import type { Command } from 'commander';
-export declare function registerBetaCommands(program: Command): void;
+/** Register `agents setup beta` under the parent `setup` command. */
+export declare function registerBetaCommands(setupCmd: Command): void;

package/dist/commands/beta.js

@@ -1,5 +1,6 @@
 import chalk from 'chalk';
 import { ALL_BETA_FEATURES, getBetaConfigLocation, getEnabledBetaFeatures, setBetaEnabled, } from '../lib/beta.js';
+import { setHelpSections } from '../lib/help.js';
 const BETA_DESCRIPTIONS = {
     factory: 'Cloud-based agent dispatch via Rush Factory',
 };
@@ -20,16 +21,22 @@ function parseFeatures(values) {
     }
     return values.filter((v) => valid.has(v));
 }
-export function registerBetaCommands(program) {
-    const beta = program
+/** Register `agents setup beta` under the parent `setup` command. */
+export function registerBetaCommands(setupCmd) {
+    const beta = setupCmd
         .command('beta')
-        .description('Enable or disable preview features like factory.')
-        .addHelpText('after', `
-Examples:
-  agents beta list
-  agents beta enable factory
-  agents beta disable factory
-`);
+        .description('Enable or disable preview features like factory.');
+    setHelpSections(beta, {
+        examples: `
+      agents setup beta list
+      agents setup beta enable factory
+      agents setup beta disable factory
+    `,
+        notes: `
+      Writes the enabled set to ~/.agents/agents.yaml (beta.enabled). Top-level
+      \`agents beta\` is gone — use this group.
+    `,
+    });
     beta
         .command('list')
         .description('Show available beta features and whether they are enabled.')

package/dist/commands/commands.js

@@ -392,7 +392,7 @@ Examples:
         }
         else {
             console.log(chalk.green(`\nRemoved ${removed} command(s) from version homes.`));
-            console.log(chalk.gray('Central source unchanged. Commands will re-sync on next agent launch.'));
+            console.log(chalk.gray("Central source unchanged. Restore any target with 'agents sync <agent>@<version> --yes'."));
         }
     });
     // `commands prune` moved to the top-level `agents prune cleanup` command.

package/dist/commands/doctor.js

@@ -2,7 +2,7 @@ import { IsolationBoundaryError } from '../lib/installations/shims.js';
 import { explainIsolationBoundary } from '../lib/isolation-boundary-report.js';
 import { addHostOption } from '../lib/hosts/option.js';
 import { buildRemoteAgentsInvocation } from '../lib/hosts/remote-cmd.js';
-import { loadDevices, isControlDevice } from '../lib/devices/registry.js';
+import { loadDevices } from '../lib/devices/registry.js';
 import { fanOutDevices, planFleetTargets, remoteFleetTargets } from '../lib/devices/fleet.js';
 import { enterDoctorOverviewGate, invalidateDoctorOverviewCache, writeDoctorOverviewCache } from '../lib/devices/doctor-overview-cache.js';
 import { fleetDialTarget } from '../lib/devices/connect.js';
@@ -183,9 +183,6 @@ async function resolveFleetTargets(opts) {
         // Normalize names so zion/ZION/zion.local all match machineId() and we never
         // self-SSH the local box during fleet probes (RUSH-2114).
         .filter((d) => normalizeHost(d.name) !== localName)
-        // Control devices (a cockpit) never run agents — skip them in the fleet
-        // fan-out (an explicit --device <name> still resolves above).
-        .filter((d) => !isControlDevice(d))
         .map((d) => ({
         name: d.name,
         sshTarget: d.name,

package/dist/commands/events.d.ts

@@ -7,7 +7,7 @@
  * (per-session activity: plans, PRs, worktrees, sub-agents, artifacts). Run-dispatch
  * outcomes land here as `run.dispatched` (readable via `--include runs`).
  *
- * `agents audit` and `agents logs` are thin aliases of this command.
+ * `agents events audit` and `agents logs` are thin aliases of this command.
  *
  * Filter with sessions-style `--include` / `--exclude` families (ops, activity,
  * commands, runs, security) plus field filters (`--module`, `--event`, …).
@@ -49,7 +49,7 @@ export interface EventsOptions {
 }
 /** Add the one canonical event-reader option surface to a command or alias. */
 export declare function addEventsReadOptions(command: Command, includeAuditFlag?: boolean): Command;
-/** Canonical reader used by `agents events`, `agents audit`, and `agents logs`. */
+/** Canonical reader used by `agents events`, `agents events audit`, and `agents logs`. */
 export declare function runEventsCommand(options: EventsOptions, forceAudit?: boolean): Promise<void>;
 /** Shared by `events stats` and the `logs stats` alias. */
 export declare function runEventsStats(opts: {

package/dist/commands/events.js

@@ -7,7 +7,7 @@
  * (per-session activity: plans, PRs, worktrees, sub-agents, artifacts). Run-dispatch
  * outcomes land here as `run.dispatched` (readable via `--include runs`).
  *
- * `agents audit` and `agents logs` are thin aliases of this command.
+ * `agents events audit` and `agents logs` are thin aliases of this command.
  *
  * Filter with sessions-style `--include` / `--exclude` families (ops, activity,
  * commands, runs, security) plus field filters (`--module`, `--event`, …).
@@ -19,6 +19,7 @@ import { readUnifiedEvents } from '../lib/event-stream.js';
 import { parseFamilyList, EVENT_FAMILIES } from '../lib/event-families.js';
 import { ingestBatch } from '../lib/events-ingest.js';
 import { setHelpSections } from '../lib/help.js';
+import { registerAuditCommands } from './audit.js';
 /**
  * Resolve `--limit` into a record cap. `0` means "no cap" — without it there is
  * no way to read the whole stream, and any aggregation (group-by failure, count
@@ -215,7 +216,7 @@ export function addEventsReadOptions(command, includeAuditFlag = true) {
     }
     return command;
 }
-/** Canonical reader used by `agents events`, `agents audit`, and `agents logs`. */
+/** Canonical reader used by `agents events`, `agents events audit`, and `agents logs`. */
 export async function runEventsCommand(options, forceAudit = false) {
     if (options.follow) {
         await followLog();
@@ -356,9 +357,8 @@ Examples:
   agents events -f                       Live tail (operational)
   agents events stats
   agents events rotate --days 7
-
-  agents audit                           Alias of: events --include runs
-  agents logs                            Alias of: events`)
+  agents events audit                    Alias of: events --include runs
+  agents logs                            Run log viewer (also aliases events audit/stats/rotate)`)
         .action((_options, command) => runEventsCommand(command.optsWithGlobals()));
     // `events` both reads (its own action, above) and writes (this subcommand) —
     // the same shape as `feed` / `feed post`.
@@ -375,6 +375,7 @@ Examples:
         .option('--days <n>', 'Retention period in days (default 7)', '7')
         .option('--max-mb <n>', 'Total event storage ceiling in MiB (default 50)', '50')
         .action((opts) => runEventsRotate(opts));
+    registerAuditCommands(events);
 }
 /** Shared by `events rotate` and the `logs rotate` alias. */
 export function runEventsRotate(opts) {

package/dist/commands/exec.d.ts

@@ -15,7 +15,6 @@ export interface RunAccountPickerRequest {
 }
 /** Distinguish a terminal account-picker marker from an explicit @version pin. */
 export declare function parseRunAccountPickerRequest(agentSpec: string): RunAccountPickerRequest;
-/** Return every option whose routing semantics conflict with a local account choice. */
 /**
  * The `--device` alias family — the flags that mean "dispatch this run to another
  * machine over SSH". `--device` is canonical; `--on`/`--computer` are hidden
@@ -30,6 +29,7 @@ export declare function hostTargetGiven(options: {
     on?: string;
     computer?: string;
 }): string[];
+/** Return every option whose selection semantics conflict with an account choice. */
 export declare function runAccountPickerConflicts(options: {
     resume?: string | boolean;
     strategy?: string;

package/dist/commands/exec.js

@@ -36,7 +36,6 @@ export function parseRunAccountPickerRequest(agentSpec) {
         valid: !requested || (!!normalizedAgentSpec && !normalizedAgentSpec.includes('@')),
     };
 }
-/** Return every option whose routing semantics conflict with a local account choice. */
 /**
  * The `--device` alias family — the flags that mean "dispatch this run to another
  * machine over SSH". `--device` is canonical; `--on`/`--computer` are hidden
@@ -48,6 +47,7 @@ export function parseRunAccountPickerRequest(agentSpec) {
 export function hostTargetGiven(options) {
     return [options.host, options.device, options.on, options.computer].filter((v) => !!v);
 }
+/** Return every option whose selection semantics conflict with an account choice. */
 export function runAccountPickerConflicts(options) {
     const conflicts = [];
     if (options.resume !== undefined)
@@ -60,8 +60,6 @@ export function runAccountPickerConflicts(options) {
         conflicts.push('--lease');
     if (options.box)
         conflicts.push('--box');
-    if (hostTargetGiven(options).length)
-        conflicts.push('--device');
     return conflicts;
 }
 /** Type guard that narrows a string to a known AgentId. */
@@ -845,7 +843,7 @@ agents run auto --device yosemite-s0 "fix the flaky test"   # pin the device
             const conflicts = runAccountPickerConflicts(options);
             if (conflicts.length > 0) {
                 console.error(chalk.red(`Account selection with ${agentSpec} cannot be combined with ${conflicts.join(', ')}. ` +
-                    'Pick the account locally, or use an explicit agent@version target.'));
+                    'Remove the conflicting selector, or use an explicit agent@version target.'));
                 process.exit(1);
             }
         }
@@ -1450,6 +1448,11 @@ agents run auto --device yosemite-s0 "fix the flaky test"   # pin the device
                     process.exit(1);
                 }
                 const interactiveHost = options.interactive === true || (prompt === undefined && options.headless !== true);
+                if (accountPickerRequested && !interactiveHost) {
+                    console.error(chalk.red(`Account selection with ${agentSpec} requires an interactive host run. ` +
+                        `Use agents run ${runAgent}@ --device ${host.name} --interactive.`));
+                    process.exit(1);
+                }
                 if (interactiveHost) {
                     // Interactive host run: forward the local TTY over SSH and let the
                     // remote agent start its normal interactive UI (tmux on the host).
@@ -1496,6 +1499,7 @@ agents run auto --device yosemite-s0 "fix the flaky test"   # pin the device
                     const exitCode = await runInteractiveOnHost(host, {
                         agent: runAgent,
                         version: resumeId ? undefined : runVersion,
+                        accountPicker: accountPickerRequested,
                         strategy: resumeId ? undefined : runStrategy,
                         account: resumeId ? undefined : options.account,
                         fallback: options.fallback,

package/dist/commands/factory.d.ts

@@ -2,7 +2,7 @@
  * Software Factory CLI — submits Linear issues to a remote orchestrator.
  *
  * Requires FACTORY_FLOOR_URL pointing at a Factory-compatible endpoint.
- * Beta-gated; enable with `agents beta enable factory`.
+ * Beta-gated; enable with `agents setup beta enable factory`.
  */
 import type { Command } from 'commander';
 export declare function registerFactoryCommands(program: Command): void;

package/dist/commands/fleet-capture.d.ts

@@ -1,7 +1,7 @@
 /**
  * `agents fleet capture` (alias surface of `agents devices capture`) — snapshot
  * the live environment into the `fleet:` block of `agents.yaml` so a fresh
- * machine can reconstruct it with `agents apply`.
+ * machine can reconstruct it with `agents fleet apply`.
  *
  * Local-read + local-write, zero SSH. Records device NAMES only (never IPs or
  * usernames — those are re-resolved live from Tailscale at apply-time), plus the

package/dist/commands/fleet-capture.js

@@ -1,7 +1,7 @@
 /**
  * `agents fleet capture` (alias surface of `agents devices capture`) — snapshot
  * the live environment into the `fleet:` block of `agents.yaml` so a fresh
- * machine can reconstruct it with `agents apply`.
+ * machine can reconstruct it with `agents fleet apply`.
  *
  * Local-read + local-write, zero SSH. Records device NAMES only (never IPs or
  * usernames — those are re-resolved live from Tailscale at apply-time), plus the
@@ -12,7 +12,7 @@
 import * as fs from 'fs';
 import chalk from 'chalk';
 import * as yaml from 'yaml';
-import { loadDevices, isControlDevice } from '../lib/devices/registry.js';
+import { loadDevices } from '../lib/devices/registry.js';
 import { readMeta, updateMeta, getDevicePinsPath } from '../lib/state.js';
 import { machineId } from '../lib/machine-id.js';
 import { listBundles } from '../lib/secrets/bundles.js';
@@ -39,10 +39,9 @@ function agentsFromPins(names) {
 }
 async function runCapture(opts) {
     const meta = readMeta();
-    // Roster: registered, non-control device names only.
+    // Roster: every registered device name.
     const registry = await loadDevices();
     let names = Object.values(registry)
-        .filter((d) => !isControlDevice(d))
         .map((d) => d.name)
         .sort();
     if (opts.device) {
@@ -83,7 +82,7 @@ async function runCapture(opts) {
     console.log(chalk.green('Captured fleet profile') +
         chalk.gray(` — ${deviceCount} device(s), ${defaults.agents?.length ?? 0} agent(s), ` +
             `${inputs.secretsBundles?.length ?? 0} secret bundle(s), ${inputs.routines?.length ?? 0} routine(s).`));
-    console.log(chalk.gray('  Wrote agents.yaml → fleet:. Push it (`agents repo push`) and run `agents apply` on any machine.'));
+    console.log(chalk.gray('  Wrote agents.yaml → fleet:. Push it (`agents repo push`) and run `agents fleet apply` on any machine.'));
 }
 /** Attach `capture` to the `devices`/`fleet` command tree. */
 export function registerFleetCaptureCommand(devicesCmd) {

package/dist/commands/harness.js

@@ -17,8 +17,6 @@ import { listProfiles, readProfile, writeProfile, deleteProfile, profileExists,
 import { listPresets, getPreset } from '../lib/profiles-presets.js';
 import { AGENTS, ALL_AGENT_IDS, resolveAgentName } from '../lib/agents.js';
 import { findAccount } from '../lib/account-registry.js';
-import { keychainItemName, setKeychainToken, deleteKeychainToken } from '../lib/secrets/profiles.js';
-import { readStdinSync } from '../lib/format.js';
 import { runWizardSteps, createSteps, editSteps, defaultWizardIO, } from './harness-wizard.js';
 /** Short capability summary for a native harness — its supported run modes. */
 function nativeModes(id) {
@@ -567,7 +565,7 @@ Examples:
     cmd
         .command('remove <name>')
         .alias('rm')
-        .description('Delete a custom harness (keychain token is kept — use `harness logout <provider>` to remove).')
+        .description('Delete a custom harness (credentials stay on `agents accounts`; this only drops the named pin).')
         .action((name) => {
         const existed = deleteProfile(name);
         if (!existed) {
@@ -576,50 +574,4 @@ Examples:
         }
         console.log(chalk.green(`Harness '${name}' removed.`));
     });
-    cmd
-        .command('login <provider>')
-        .description('Store or rotate the API key for a provider (e.g., openrouter). Shared across harnesses using that provider.')
-        .option('--key-stdin', 'Read API key from stdin')
-        .action(async (provider, opts) => {
-        try {
-            const item = keychainItemName(provider);
-            let token;
-            if (opts.keyStdin) {
-                token = readStdinSync();
-                if (!token)
-                    throw new Error('No key received on stdin.');
-            }
-            else {
-                if (!isInteractiveTerminal()) {
-                    throw new Error('A secret is required but the shell is not interactive. Pipe the key via stdin (--key-stdin).');
-                }
-                const { password } = await import('@inquirer/prompts');
-                token = await password({ message: `Enter API key for ${provider}`, mask: true });
-            }
-            setKeychainToken(item, token);
-            console.log(chalk.green(`Stored in keychain: ${item}`));
-        }
-        catch (err) {
-            console.error(chalk.red(err.message));
-            process.exit(1);
-        }
-    });
-    cmd
-        .command('logout <provider>')
-        .description('Remove a stored provider key from keychain')
-        .action((provider) => {
-        try {
-            const item = keychainItemName(provider);
-            const existed = deleteKeychainToken(item);
-            if (!existed) {
-                console.error(chalk.yellow(`No keychain item '${item}' to remove.`));
-                process.exit(1);
-            }
-            console.log(chalk.green(`Removed keychain item: ${item}`));
-        }
-        catch (err) {
-            console.error(chalk.red(err.message));
-            process.exit(1);
-        }
-    });
 }

package/dist/commands/hooks.js

@@ -514,7 +514,7 @@ Examples:
         }
         else {
             console.log(chalk.green(`\nRemoved ${removed} hook(s) from version homes.`));
-            console.log(chalk.gray('Central source unchanged. Hooks will re-sync on next agent launch.'));
+            console.log(chalk.gray("Central source unchanged. Restore any target with 'agents sync <agent>@<version> --yes'."));
         }
     });
     // `hooks prune` moved to the top-level `agents prune cleanup` command.

package/dist/commands/insights.d.ts

@@ -31,7 +31,7 @@
  * the coaching prose by piping the AGGREGATE (never raw transcripts) through a headless
  * `claude -p`.
  *
- * `agents trends` is a thin deprecated alias of the mix tree only (see commands/trends.ts).
+ * Former top-level `agents trends` is `agents insights mix` / `agents insights trends`.
  */
 import type { Command } from 'commander';
 export declare function registerInsightsCommand(program: Command): void;