@phnx-labs/agents-cli 1.22.10 → 1.22.11

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 1.22.11
+
+- **`--blocked` iMessage notifications are now phone-actionable.** The forwarded message dropped the block's `--option`s, `--default`, and timeout and instead showed `agents focus <id>` — a CLI command that is useless on a phone. It now shows the choices (`Options: publish / wait`) and the safe-default fallback (`Default in 15 min: wait`) and omits the `agents focus` line, so a `--blocked` post that carries a `--default` self-resolves when the owner can't reply. Source: `apps/cli/src/lib/feed-broadcast.ts`.
+
+- Move operational event logs from the git-backed `~/.agents/` root into `~/.agents/.history/events/`, including existing numbered gzip archives.
+
+- **`agents projects` is out of beta — no `agents beta enable projects` needed.**
+  The command tree (list / add / import / status / link / …) is always registered
+  now; `projects` is dropped from the beta registry (`ALL_BETA_FEATURES`,
+  `BetaFeatureName`) and the `preAction` beta gate is removed. Any lingering
+  `beta.enabled: [projects]` entry is harmlessly ignored, and `agents beta
+  enable/disable projects` prints a friendly "graduated out of beta" note and
+  no-ops instead of erroring (so old scripts survive). Source:
+  `apps/cli/src/lib/beta.ts`, `apps/cli/src/lib/types.ts`,
+  `apps/cli/src/commands/beta.ts`, `apps/cli/src/commands/projects.ts`.
+
+- **`agents projects status` shows every project across the whole fleet by default;
+  scope it with `--device`/`--devices`.** The old `--fleet` flag is gone — status
+  now dials every registered device's workspace (presence, branch, drift) in one
+  parallel SSH round without being asked. `--device <name...>` (repeatable) or
+  `--devices a,b,c` narrows the fan-out to a subset; with no filter the whole fleet
+  is dialled. Reuses the shared `--host`/`--device` target resolution. Source:
+  `apps/cli/src/commands/projects.ts`.
+
+- **`scripts/release.sh` home-base hop: pass a single remote argv to `agents ssh`.** Multi-arg forms (`bash -lc '…'`) are joined without re-quoting by `wrapRemoteCommand`, so the remote `cd` never ran and publish failed with `fatal: not a git repository`. One shell string keeps the command intact. Source: `apps/cli/scripts/release.sh`.
+
 ## 1.22.10
 
 - **Plugins package workflows (Phase 5 packaging slice).** A plugin’s `workflows/<name>/WORKFLOW.md` is discovered and resolved by `agents run <name>` with precedence project > user > plugin > extra > system — no separate install into `~/.agents/workflows/` required. Plugin inventory / resource groups list `workflows`. Source: `apps/cli/src/lib/workflows.ts`, `apps/cli/src/lib/plugins.ts`, `apps/cli/src/lib/resources/workflows.ts`.

package/dist/commands/beta.js

@@ -2,17 +2,23 @@ import chalk from 'chalk';
 import { ALL_BETA_FEATURES, getBetaConfigLocation, getEnabledBetaFeatures, setBetaEnabled, } from '../lib/beta.js';
 const BETA_DESCRIPTIONS = {
     factory: 'Cloud-based agent dispatch via Rush Factory',
-    projects: 'Named multi-repo projects with a progress rollup (agents projects)',
 };
+// Features that used to be beta and are now always-on. `beta enable/disable` on
+// one of these is a friendly no-op, not an "Unknown beta feature" error — so
+// muscle memory and old bootstrap scripts survive the graduation.
+const GRADUATED_FEATURES = new Set(['projects']);
 function parseFeatures(values) {
     const valid = new Set(ALL_BETA_FEATURES);
-    const invalid = values.filter((value) => !valid.has(value));
-    if (invalid.length > 0) {
-        console.error(chalk.red(`Unknown beta feature: ${invalid.join(', ')}`));
+    for (const g of values.filter((v) => GRADUATED_FEATURES.has(v))) {
+        console.error(chalk.gray(`'${g}' has graduated out of beta — it is on by default; no action needed.`));
+    }
+    const unknown = values.filter((v) => !valid.has(v) && !GRADUATED_FEATURES.has(v));
+    if (unknown.length > 0) {
+        console.error(chalk.red(`Unknown beta feature: ${unknown.join(', ')}`));
         console.error(chalk.gray(`Valid features: ${ALL_BETA_FEATURES.join(', ')}`));
         process.exit(1);
     }
-    return values;
+    return values.filter((v) => valid.has(v));
 }
 export function registerBetaCommands(program) {
     const beta = program
@@ -43,16 +49,22 @@ Examples:
         .command('enable <features...>')
         .description('Enable one or more beta features.')
         .action((features) => {
-        const result = setBetaEnabled(parseFeatures(features), true);
-        console.log(chalk.green(`Enabled: ${features.join(', ')}`));
+        const parsed = parseFeatures(features);
+        if (parsed.length === 0)
+            return; // only graduated/no-op names
+        const result = setBetaEnabled(parsed, true);
+        console.log(chalk.green(`Enabled: ${parsed.join(', ')}`));
         console.log(chalk.gray(`Saved to ${result.path}`));
     });
     beta
         .command('disable <features...>')
         .description('Disable one or more beta features.')
         .action((features) => {
-        const result = setBetaEnabled(parseFeatures(features), false);
-        console.log(chalk.green(`Disabled: ${features.join(', ')}`));
+        const parsed = parseFeatures(features);
+        if (parsed.length === 0)
+            return; // only graduated/no-op names
+        const result = setBetaEnabled(parsed, false);
+        console.log(chalk.green(`Disabled: ${parsed.join(', ')}`));
         console.log(chalk.gray(`Saved to ${result.path}`));
     });
 }

package/dist/commands/events.d.ts

@@ -1,7 +1,7 @@
 /**
  * `agents events` — read the unified event stream.
  *
- * One stream over BOTH operational events (`~/.agents/events.jsonl`: every
+ * One stream over BOTH operational events (`~/.agents/.history/events/events.jsonl`: every
  * `agents <module> <cmd>` invocation plus typed events like secrets access,
  * version installs) AND agent-semantic events (the per-session activity logs:
  * plans, PRs, worktrees, sub-agents, artifacts). Each is stamped with who ran

package/dist/commands/events.js

@@ -1,7 +1,7 @@
 /**
  * `agents events` — read the unified event stream.
  *
- * One stream over BOTH operational events (`~/.agents/events.jsonl`: every
+ * One stream over BOTH operational events (`~/.agents/.history/events/events.jsonl`: every
  * `agents <module> <cmd>` invocation plus typed events like secrets access,
  * version installs) AND agent-semantic events (the per-session activity logs:
  * plans, PRs, worktrees, sub-agents, artifacts). Each is stamped with who ran

package/dist/commands/projects.d.ts

@@ -1,8 +1,7 @@
 /**
  * `agents projects` — named, multi-repo projects and the progress
  * rollup. Definitions live in `~/.agents/projects/<name>.yaml` (see
- * `lib/projects.ts`); this registers the command tree over them. Beta-gated on
- * `isBetaEnabled('projects')`, mirroring `agents factory`.
+ * `lib/projects.ts`); this registers the command tree over them.
  *
  * The headline is `status`: instead of the vague per-agent activity line, it
  * rolls every session up by project (matched on cwd) into one card — agents by

package/dist/commands/projects.js

@@ -1,8 +1,7 @@
 /**
  * `agents projects` — named, multi-repo projects and the progress
  * rollup. Definitions live in `~/.agents/projects/<name>.yaml` (see
- * `lib/projects.ts`); this registers the command tree over them. Beta-gated on
- * `isBetaEnabled('projects')`, mirroring `agents factory`.
+ * `lib/projects.ts`); this registers the command tree over them.
  *
  * The headline is `status`: instead of the vague per-agent activity line, it
  * rolls every session up by project (matched on cwd) into one card — agents by
@@ -12,7 +11,6 @@ import chalk from 'chalk';
 import * as fs from 'fs';
 import * as path from 'path';
 import { execFileSync, spawnSync } from 'child_process';
-import { betaEnableHint, isBetaEnabled } from '../lib/beta.js';
 import { setHelpSections } from '../lib/help.js';
 import { getMainRepoRoot } from '../lib/git.js';
 import { parseOwnerRepoFromRemote } from '../lib/registry.js';
@@ -437,25 +435,24 @@ warnWorkspaces = []) {
         console.log('');
 }
 export function registerProjectsCommands(program) {
-    const enabled = isBetaEnabled('projects');
     const projects = program
-        .command('projects', { hidden: !enabled })
+        .command('projects')
         .description('Named multi-repo projects with a progress rollup.');
     setHelpSections(projects, {
         examples: `
       agents projects import --from-linear  # the projects you actually track
       agents projects add rush --repo phnx-labs/rush --path apps/web
       agents projects list
-      agents projects status              # progress card for every project
+      agents projects status              # every project, across the whole fleet
       agents projects status rush         # one project (same body as view/show)
       agents projects view rush           # alias of status <name>
-      agents projects status --fleet      # + per-device workspace drift over SSH
+      agents projects status --device s0  # scope to one device (or --devices a,b,c)
       agents projects link rush --linear  # bind the Linear project (auto-suggest)
       agents run --project rush           # land an agent in the project
     `,
         notes: `
       Definitions are hand-editable YAML in ~/.agents/projects/ and sync across
-      machines with 'agents push/pull'. Enable with: agents beta enable projects.
+      machines with 'agents push/pull'.
 
       'import --from-factory' reads Factory's auto-detected registry, which
       guesses from checkouts on disk — it imports only 'high' confidence rows by
@@ -463,18 +460,6 @@ export function registerProjectsCommands(program) {
       with 'agents projects rm <name>'.
     `,
     });
-    projects.hook('preAction', (_thisCommand, actionCommand) => {
-        if (enabled)
-            return;
-        // `probe` is the peer half of `status --fleet`: it must answer whenever the
-        // binary carries it, even where the beta flag is off — a gated peer would
-        // look unreachable to every fleet member on a newer CLI.
-        if (actionCommand.name() === 'probe')
-            return;
-        console.error(chalk.red('agents projects is in beta.'));
-        console.error(chalk.gray(betaEnableHint('projects')));
-        process.exit(1);
-    });
     // ---- list ----
     projects
         .command('list')
@@ -553,6 +538,15 @@ export function registerProjectsCommands(program) {
         console.log(chalk.gray(`  ${target}`));
         console.log(chalk.gray(`  root ${def.root}${def.repo ? `  ·  repo ${def.repo}` : ''}`));
     });
+    /** Merge `--device a b` (variadic) and `--devices a,b,c` (comma list) into one
+     *  deduped device filter; undefined when neither was given (= whole fleet). */
+    function resolveDeviceFilter(device, devices) {
+        const merged = [
+            ...(device ?? []),
+            ...(devices ? devices.split(',').map((s) => s.trim()).filter(Boolean) : []),
+        ];
+        return merged.length ? [...new Set(merged)] : undefined;
+    }
     /** Print the YAML-side fields that sit under the shared card in `view` mode. */
     function printProjectDefinition(def, name) {
         console.log();
@@ -598,16 +592,16 @@ export function registerProjectsCommands(program) {
         }
         const windowDays = Math.max(1, Number.parseInt(opts.window ?? '7', 10) || 7);
         const nowMs = Date.now();
-        // --fleet: probe each shown def's workspace paths (root + repos[].path)
-        // locally and on every peer in one parallel SSH round, and widen the
-        // live-session rollup to the whole fleet via the existing sessions
-        // fan-out. Both are opt-in — they dial the fleet. `view` accepts the flag
-        // too so the two verbs stay interchangeable once a name is given.
-        const fleetTargets = opts.fleet ? [...new Set(defs.flatMap(workspaceTargetsForDef))] : [];
+        // Fleet is the default: probe each shown def's workspace paths (root +
+        // repos[].path) locally AND on every peer in one parallel SSH round, and
+        // widen the live-session rollup to the fleet via the sessions fan-out.
+        // `--device`/`--devices` scopes the remote fan-out to a subset; with no
+        // filter every registered device is dialled.
+        const fleetTargets = [...new Set(defs.flatMap(workspaceTargetsForDef))];
         let fleetWs = [];
         let fleetSkipped = [];
         let fleetSessions = [];
-        if (opts.fleet) {
+        {
             const self = machineId();
             fleetWs.push(...probeProjectWorkspaces(fleetTargets).map((s) => ({ ...s, host: self })));
             const [probeRes, activeRes] = await Promise.all([
@@ -615,11 +609,12 @@ export function registerProjectsCommands(program) {
                     ? gatherRemoteAgentsJson({
                         args: ['projects', 'probe', '--json', ...fleetTargets],
                         noFanoutEnv: PROJECTS_NO_FANOUT_ENV,
+                        hosts: opts.deviceFilter,
                         parse: parseRemoteProbe,
                         quiet: true,
                     })
                     : Promise.resolve({ items: [], deviceCount: 0, skipped: [] }),
-                gatherRemoteActive(undefined, { quiet: true }),
+                gatherRemoteActive(opts.deviceFilter, { quiet: true }),
             ]);
             fleetWs.push(...probeRes.items);
             fleetSkipped = probeRes.skipped;
@@ -636,17 +631,6 @@ export function registerProjectsCommands(program) {
             const targets = new Set(workspaceTargetsForDef(d));
             return fleetWs.filter((s) => targets.has(s.path));
         };
-        /** Local-only workspace probe for the warnings footer when --fleet is off. */
-        const localWsCache = new Map();
-        const localWsFor = (d) => {
-            const cached = localWsCache.get(d.name);
-            if (cached)
-                return cached;
-            const self = machineId();
-            const rows = probeProjectWorkspaces(workspaceTargetsForDef(d)).map((s) => ({ ...s, host: self }));
-            localWsCache.set(d.name, rows);
-            return rows;
-        };
         if (opts.json) {
             if (fleetSkipped.length > 0)
                 process.stderr.write(formatFleetSkippedNote(fleetSkipped));
@@ -677,7 +661,7 @@ export function registerProjectsCommands(program) {
                     lastArtifact: rem?.lastArtifact ?? null,
                     windowDays,
                     repos: [d.repo, ...(d.repos ?? []).map((r2) => r2.slug)].filter(Boolean),
-                    ...(opts.fleet ? { workspaces: fleetFor(d) } : {}),
+                    workspaces: fleetFor(d),
                 };
             }), null, 2));
             return;
@@ -685,10 +669,10 @@ export function registerProjectsCommands(program) {
         // Compact rollup shows the next milestone; `view` shows every declared one.
         const milestoneLimit = detail ? Number.POSITIVE_INFINITY : 1;
         for (const d of defs) {
-            renderCard(d, roll.get(d.name), remote.get(d.name), opts.fleet ? fleetFor(d) : undefined, linear.get(d.name), nowMs, milestoneLimit, focus.get(d.name) ?? [], detail, 
-            // Always feed workspace rows into the warnings footer — full fleet when
-            // --fleet, otherwise a local-only probe so behind/dirty is never silent.
-            opts.fleet ? fleetFor(d) : localWsFor(d));
+            renderCard(d, roll.get(d.name), remote.get(d.name), fleetFor(d), linear.get(d.name), nowMs, milestoneLimit, focus.get(d.name) ?? [], detail, 
+            // Always feed workspace rows into the warnings footer so behind/dirty
+            // is never silent.
+            fleetFor(d));
             if (detail)
                 printProjectDefinition(d, d.name);
         }
@@ -699,15 +683,23 @@ export function registerProjectsCommands(program) {
         .command('status [name]')
         .alias('view')
         .alias('show')
-        .description('Progress card for every project, or one named project (aliases: view, show). Named form also prints every milestone and the stored definition.')
+        .description('Progress card for every project across the whole fleet, or one named project (aliases: view, show). Named form also prints every milestone and the stored definition.')
         .option('--json', 'Machine-readable output')
         .option('--window <days>', 'Window for merged PRs, artifacts, and focus areas', '7')
         .option('--no-remote', 'Skip the GitHub and Linear lookups; faster, offline')
-        .option('--fleet', 'Also dial every fleet device for workspace presence, branch, and drift (one SSH per peer)')
-        .action(async (name, opts) => {
+        .option('--device <name...>', 'Scope fleet status to one or more devices (repeatable)')
+        .option('--devices <names>', 'Scope fleet status to a comma-separated list of devices')
+        .action(async (name, rawOpts) => {
         // Named invocation = `view` depth (all milestones + definition). Unnamed
         // stays the scannable multi-project rollup. `view`/`show` are commander
         // aliases of this same command, so there is only one implementation.
+        // Fleet is dialled by default; --device/--devices narrows it to a subset.
+        const opts = {
+            json: rawOpts.json,
+            window: rawOpts.window,
+            remote: rawOpts.remote,
+            deviceFilter: resolveDeviceFilter(rawOpts.device, rawOpts.devices),
+        };
         const mode = name ? 'view' : 'status';
         await runProjectCard(name, opts, mode);
     });

package/dist/index.js

@@ -1177,7 +1177,7 @@ if (process.env.AGENTS_SKIP_MIGRATION !== '1') {
         // Bumping the suffix re-runs migrations for every user; binary releases that
         // don't change the schema must NOT re-run (they would destroy user content
         // when migration steps overlap with user-authored paths). See issue #20.
-        const sentinelValue = 'v13';
+        const sentinelValue = 'v14';
         let needRun = true;
         try {
             if (fs.existsSync(sentinel) && fs.readFileSync(sentinel, 'utf-8').trim() === sentinelValue) {

package/dist/lib/beta.d.ts

@@ -8,7 +8,7 @@
  * checks.
  */
 import type { BetaFeatureName } from './types.js';
-export declare const ALL_BETA_FEATURES: readonly ["factory", "projects"];
+export declare const ALL_BETA_FEATURES: readonly ["factory"];
 export declare function getEnabledBetaFeatures(): BetaFeatureName[];
 export declare function isBetaEnabled(feature: BetaFeatureName): boolean;
 export declare function getBetaConfigLocation(): {

package/dist/lib/beta.js

@@ -10,7 +10,7 @@
 import * as path from 'path';
 import { getAgentsDir, getOptionalUserAgentsDir, readMeta, writeMeta } from './state.js';
 import { readManifest, writeManifest } from './manifest.js';
-export const ALL_BETA_FEATURES = ['factory', 'projects'];
+export const ALL_BETA_FEATURES = ['factory'];
 function isBetaFeatureName(value) {
     return typeof value === 'string' && ALL_BETA_FEATURES.includes(value);
 }

package/dist/lib/event-stream.d.ts

@@ -1,6 +1,6 @@
 /**
  * The unified event reader -- one stream over BOTH operational events
- * (`~/.agents/events.jsonl` via events.ts: secrets, commands, teams, ...) and
+ * (`~/.agents/.history/events/events.jsonl` via events.ts: secrets, commands, teams, ...) and
  * agent-semantic events (the per-session activity logs via activity.ts: plans,
  * PRs, worktrees, sub-agents, artifacts). They share one {@link EventType}
  * vocabulary and one {@link EventRecord} shape, so `agents events` and any

package/dist/lib/event-stream.js

@@ -1,6 +1,6 @@
 /**
  * The unified event reader -- one stream over BOTH operational events
- * (`~/.agents/events.jsonl` via events.ts: secrets, commands, teams, ...) and
+ * (`~/.agents/.history/events/events.jsonl` via events.ts: secrets, commands, teams, ...) and
  * agent-semantic events (the per-session activity logs via activity.ts: plans,
  * PRs, worktrees, sub-agents, artifacts). They share one {@link EventType}
  * vocabulary and one {@link EventRecord} shape, so `agents events` and any

package/dist/lib/events.d.ts

@@ -1,7 +1,7 @@
 /**
  * Centralized event logging for agents-cli.
  *
- * Structured JSONL audit log at ~/.agents/events.jsonl with lossless numbered
+ * Structured JSONL audit log at ~/.agents/.history/events/events.jsonl with lossless numbered
  * gzip rotation at 10 MB and rich metadata for debugging/auditing.
  *
  * Features:

package/dist/lib/events.js

@@ -1,7 +1,7 @@
 /**
  * Centralized event logging for agents-cli.
  *
- * Structured JSONL audit log at ~/.agents/events.jsonl with lossless numbered
+ * Structured JSONL audit log at ~/.agents/.history/events/events.jsonl with lossless numbered
  * gzip rotation at 10 MB and rich metadata for debugging/auditing.
  *
  * Features:
@@ -17,7 +17,7 @@ import * as os from 'os';
 import { createHash } from 'node:crypto';
 import { gzipSync, gunzipSync } from 'node:zlib';
 import { ensureLockTarget, withFileLock } from './fs-atomic.js';
-import { getUserAgentsDir } from './state.js';
+import { getHistoryDir } from './state.js';
 import { stampProvenance, resetEventProvenanceForTest } from './event-provenance.js';
 /** Lazy perf warehouse write — avoids a hard cycle at module load. */
 function recordPerfTiming(payload) {
@@ -48,7 +48,7 @@ function recordPerfTiming(payload) {
 // a test spawns, so fixture events can never land in the user's real log (#910).
 let _eventsPath;
 function eventsPath() {
-    return (_eventsPath ??= process.env.AGENTS_EVENTS_PATH || path.join(getUserAgentsDir(), 'events.jsonl'));
+    return (_eventsPath ??= process.env.AGENTS_EVENTS_PATH || path.join(getHistoryDir(), 'events', 'events.jsonl'));
 }
 function eventsDir() {
     return path.dirname(eventsPath());

package/dist/lib/feed-broadcast.d.ts

@@ -48,8 +48,14 @@ export interface FeedBroadcastContext {
     class?: string;
     /** Block-only: cost-of-delay tag used by the urgency filter. */
     cost?: string;
-    /** Block-only: the literal `agents focus <id>` command that unblocks it. */
+    /** Block-only: the literal `agents focus <id>` command (for a `{focus}` sink). */
     focus?: string;
+    /** Block-only: the answer choices the operator can pick, in order. */
+    options?: string[];
+    /** Block-only: the fallback applied if nobody answers in time. */
+    safeDefault?: string;
+    /** Block-only: minutes before `safeDefault` applies. */
+    timeoutMinutes?: number;
 }
 /**
  * Map an open block onto the broadcast context, so a block reaches the same sinks
@@ -69,9 +75,14 @@ export declare function blockBroadcastContext(block: {
     host?: string;
     questions?: Array<{
         text?: string;
+        options?: Array<{
+            label?: string;
+        }>;
     }>;
     blockClass?: string;
     costOfDelay?: string;
+    safeDefault?: string;
+    timeoutMinutes?: number;
     ticket?: string;
     pr?: string;
 }, extras?: {
@@ -137,14 +148,17 @@ export declare function composeBroadcastFooter(ctx: FeedBroadcastContext): strin
  * Title in a few words
  *
  * Body of what happened or the ask.
+ * Options: publish / wait          (blocks with choices)
+ * Default in 15 min: wait          (blocks with a safe default)
  *
  * Sent from grok/a02da0e2 on mac-mini
- * agents focus a02da0e2          (blocks only)
- * https://…                      (optional attach URL)
+ * https://…                        (optional attach URL)
  * ```
  *
- * Title first (scannable subject). Blank line. Body. Footer provenance so a
- * fleet of agents is attributable without crowding the ask. Prefer `{message}`
+ * Title first (scannable subject). Blank line. Body. Then the phone-actionable
+ * choices + default (a block that has stopped for the human), then footer
+ * provenance. No `agents focus <id>` line: a CLI command is unusable from a phone,
+ * so the safe default is the fallback and the message carries it. Prefer `{message}`
  * over bare `{text}` in messaging sinks.
  */
 export declare function composeBroadcastMessage(ctx: FeedBroadcastContext): string;

package/dist/lib/feed-broadcast.js

@@ -62,6 +62,12 @@ export function parseFeedPostLevel(raw) {
 export function blockBroadcastContext(block, extras = {}) {
     const ask = block.questions?.[0]?.text?.trim() || 'agent is blocked';
     const links = [block.pr].filter((l) => !!l && /^https?:\/\//i.test(l));
+    // The answer choices + the safe default are what make the phone message
+    // actionable: the operator sees the options and what happens if they do not
+    // reply, instead of a `agents focus <id>` CLI command they cannot run from a phone.
+    const options = (block.questions?.[0]?.options ?? [])
+        .map((o) => o?.label?.trim())
+        .filter((l) => !!l);
     // Prefer explicit title/body from the feed post; fall back to the ask as body.
     const title = extras.title?.trim() || undefined;
     const text = extras.body?.trim() || ask;
@@ -78,8 +84,12 @@ export function blockBroadcastContext(block, extras = {}) {
         class: block.blockClass,
         cost: block.costOfDelay,
         // Short id: `agents focus` matches on a prefix, and a full uuid in a phone
-        // message is noise the operator has to skip past to reach the verb.
+        // message is noise. Kept for a `{focus}` sink; the human message no longer
+        // shows it (a CLI command is unusable from a phone).
         focus: `agents focus ${block.sessionId.slice(0, 8)}`,
+        ...(options.length ? { options } : {}),
+        ...(block.safeDefault ? { safeDefault: block.safeDefault } : {}),
+        ...(block.timeoutMinutes ? { timeoutMinutes: block.timeoutMinutes } : {}),
         ...(links.length ? { links } : {}),
     };
 }
@@ -179,14 +189,17 @@ export function composeBroadcastFooter(ctx) {
  * Title in a few words
  *
  * Body of what happened or the ask.
+ * Options: publish / wait          (blocks with choices)
+ * Default in 15 min: wait          (blocks with a safe default)
  *
  * Sent from grok/a02da0e2 on mac-mini
- * agents focus a02da0e2          (blocks only)
- * https://…                      (optional attach URL)
+ * https://…                        (optional attach URL)
  * ```
  *
- * Title first (scannable subject). Blank line. Body. Footer provenance so a
- * fleet of agents is attributable without crowding the ask. Prefer `{message}`
+ * Title first (scannable subject). Blank line. Body. Then the phone-actionable
+ * choices + default (a block that has stopped for the human), then footer
+ * provenance. No `agents focus <id>` line: a CLI command is unusable from a phone,
+ * so the safe default is the fallback and the message carries it. Prefer `{message}`
  * over bare `{text}` in messaging sinks.
  */
 export function composeBroadcastMessage(ctx) {
@@ -197,9 +210,21 @@ export function composeBroadcastMessage(ctx) {
     const mid = title && body && title !== body ? body : undefined;
     const footer = composeBroadcastFooter(ctx);
     const link = ctx.links?.find((l) => /^https?:\/\//i.test(l));
-    // Block focus and link trail after the "Sent from" footer so the human
-    // sentence stays at the top and the action/link are still one glance away.
-    const trail = [footer, ctx.focus, link].filter(Boolean);
+    // The action block: the one thing the operator can act on from a phone. Show the
+    // choices, then what happens if they do not answer. Deliberately NOT a CLI command
+    // (`agents focus <id>` is unusable from a phone) -- the safe default is the real
+    // fallback, so a block meant for a phone should always carry one.
+    const choices = ctx.options?.length
+        ? `Options: ${ctx.options.map((o) => scrubOutboundDashes(o)).join(' / ')}`
+        : undefined;
+    const fallback = ctx.safeDefault
+        ? (ctx.timeoutMinutes && ctx.timeoutMinutes > 0
+            ? `Default in ${ctx.timeoutMinutes} min: ${scrubOutboundDashes(ctx.safeDefault)}`
+            : `Default: ${scrubOutboundDashes(ctx.safeDefault)}`)
+        : undefined;
+    const action = [choices, fallback].filter(Boolean).join('\n') || undefined;
+    // Link trail after the "Sent from" footer so the human sentence stays at the top.
+    const trail = [footer, link].filter(Boolean);
     const parts = [];
     if (head)
         parts.push(head);
@@ -208,6 +233,12 @@ export function composeBroadcastMessage(ctx) {
         parts.push('');
         parts.push(mid);
     }
+    if (action) {
+        // The choices/default hug the ask under a blank line so they read as the reply.
+        if (parts.length)
+            parts.push('');
+        parts.push(action);
+    }
     if (trail.length) {
         // Blank line before the footer block (iPhone "Sent from my iPhone" spacing).
         if (parts.length)
@@ -233,6 +264,8 @@ function templateVars(ctx) {
         class: ctx.class,
         cost: ctx.cost,
         focus: ctx.focus,
+        options: ctx.options?.length ? ctx.options.join(' / ') : undefined,
+        default: ctx.safeDefault,
     };
 }
 /**

package/dist/lib/migrate.js

@@ -998,6 +998,7 @@ function migrateRuntimeToHistory() {
     moveDirOnce(path.join(USER_DIR, '.backups'), path.join(HISTORY_DIR, 'backups'));
     moveDirOnce(path.join(USER_DIR, 'routines', 'runs'), path.join(HISTORY_DIR, 'runs'));
     moveDirOnce(path.join(USER_DIR, 'teams', 'agents'), path.join(HISTORY_DIR, 'teams', 'agents'));
+    migrateEventLogsToHistory();
     // Drop any empty leftover skeletons created mid-rename (e.g. `versions/<agent>/<v>/home/`
     // recreated by a concurrent process). The real data is already under .history/.
     rmEmptyDirTree(path.join(USER_DIR, 'versions'));
@@ -1013,6 +1014,66 @@ function migrateRuntimeToHistory() {
         catch { /* best-effort */ }
     }
 }
+/** Move the operational event stream out of the git-backed user-repo root. */
+function migrateEventLogsToHistory() {
+    const destination = path.join(HISTORY_DIR, 'events');
+    let files = [];
+    try {
+        files = fs.readdirSync(USER_DIR).filter((file) => file === 'events.jsonl' || /^events\.\d+\.jsonl\.gz$/.test(file));
+    }
+    catch {
+        return;
+    }
+    try {
+        fs.mkdirSync(destination, { recursive: true, mode: 0o700 });
+    }
+    catch {
+        return;
+    }
+    const active = files.find((file) => file === 'events.jsonl');
+    if (active) {
+        const src = path.join(USER_DIR, active);
+        const dest = path.join(destination, active);
+        if (!fs.existsSync(dest)) {
+            moveFileOnce(src, dest);
+        }
+        else {
+            try {
+                const lines = [fs.readFileSync(src, 'utf-8'), fs.readFileSync(dest, 'utf-8')]
+                    .flatMap((content) => content.split('\n').filter(Boolean))
+                    .map((line, index) => {
+                    try {
+                        const timestamp = Date.parse(JSON.parse(line).ts ?? '');
+                        return { line, index, timestamp: Number.isNaN(timestamp) ? Number.MAX_SAFE_INTEGER : timestamp };
+                    }
+                    catch {
+                        return { line, index, timestamp: Number.MAX_SAFE_INTEGER };
+                    }
+                })
+                    .sort((a, b) => a.timestamp - b.timestamp || a.index - b.index)
+                    .map(({ line }) => line);
+                atomicWriteFileSync(dest, `${lines.join('\n')}\n`, { mode: 0o600 });
+                fs.unlinkSync(src);
+            }
+            catch { /* preserve the source for a later retry */ }
+        }
+    }
+    const archives = files
+        .map((file) => ({ file, match: file.match(/^events\.(\d+)\.jsonl\.gz$/) }))
+        .filter((entry) => entry.match !== null)
+        .sort((a, b) => Number(a.match[1]) - Number(b.match[1]));
+    let nextArchive = fs.readdirSync(destination).reduce((max, file) => {
+        const match = file.match(/^events\.(\d+)\.jsonl\.gz$/);
+        return match ? Math.max(max, Number(match[1])) : max;
+    }, 0) + 1;
+    for (const archive of archives) {
+        const preferred = path.join(destination, archive.file);
+        const dest = fs.existsSync(preferred)
+            ? path.join(destination, `events.${nextArchive++}.jsonl.gz`)
+            : preferred;
+        moveFileOnce(path.join(USER_DIR, archive.file), dest);
+    }
+}
 /**
  * Restore plugins from the cache bucket back to the user-root.
  *

package/dist/lib/project-probe.d.ts

@@ -1,5 +1,5 @@
 /**
- * Project workspace probing — the drift signal behind `projects status --fleet`.
+ * Project workspace probing — the drift signal behind `projects status`.
  *
  * Projects are natively multi-device: the same definition (home-relative paths)
  * re-roots on every fleet machine, and the question is whether the project's

package/dist/lib/project-probe.js

@@ -1,5 +1,5 @@
 /**
- * Project workspace probing — the drift signal behind `projects status --fleet`.
+ * Project workspace probing — the drift signal behind `projects status`.
  *
  * Projects are natively multi-device: the same definition (home-relative paths)
  * re-roots on every fleet machine, and the question is whether the project's

package/dist/lib/projects.d.ts

@@ -36,7 +36,7 @@ export interface ProjectRepo {
     /**
      * Optional home-relative local checkout of this repo. The def's `root` only
      * knows the primary repo on disk; `path` opts an additional repo into
-     * workspace probing (`projects status --fleet`).
+     * workspace probing (`projects status`).
      */
     path?: string;
 }

package/dist/lib/secrets/audit.js

@@ -4,7 +4,7 @@
  * This is the ONE write path for secret events. Every path that creates,
  * imports, exports, views, reads a VALUE from, or unlocks a bundle funnels its
  * audit through here, so the operational event stream — `agents events`, backed
- * by the append-only `~/.agents/events.jsonl` audit log — carries a uniform,
+ * by the append-only `~/.agents/.history/events/events.jsonl` audit log — carries a uniform,
  * value-free provenance record: bundle, key NAMES, the resolving agent/harness
  * identity, operation, source, status. The ts / host / session / caller fields
  * are filled in by `emit()` itself. The secret VALUE is never part of the

package/dist/lib/state.d.ts

@@ -113,7 +113,7 @@ export declare function getUserSecretsDir(): string;
  * value-free usage telemetry (which bundle was created/imported/exported/viewed/
  * accessed/unlocked, when, by whom), never a secret value. It is a derived index
  * fed FROM the emitSecretAudit chokepoint alongside the append-only
- * ~/.agents/events.jsonl audit log — the same way sessions.db indexes session
+ * ~/.agents/.history/events/events.jsonl audit log — the same way sessions.db indexes session
  * metadata off the real session flow — not a second write path.
  */
 export declare function getSecretsDbPath(): string;

package/dist/lib/state.js

@@ -372,7 +372,7 @@ export function getUserSecretsDir() { return USER_SECRETS_DIR; }
  * value-free usage telemetry (which bundle was created/imported/exported/viewed/
  * accessed/unlocked, when, by whom), never a secret value. It is a derived index
  * fed FROM the emitSecretAudit chokepoint alongside the append-only
- * ~/.agents/events.jsonl audit log — the same way sessions.db indexes session
+ * ~/.agents/.history/events/events.jsonl audit log — the same way sessions.db indexes session
  * metadata off the real session flow — not a second write path.
  */
 export function getSecretsDbPath() {

package/dist/lib/types.d.ts

@@ -79,7 +79,7 @@ export interface BudgetConfig {
     require_confirm_over?: number;
 }
 /** Preview features that users can opt into via `agents beta`. */
-export type BetaFeatureName = 'factory' | 'projects';
+export type BetaFeatureName = 'factory';
 /** Subset of chalk color names used for agent-specific terminal output. */
 export type ChalkColor = 'magenta' | 'green' | 'blue' | 'cyan' | 'yellowBright' | 'redBright' | 'whiteBright' | 'blueBright' | 'greenBright' | 'magentaBright' | 'cyanBright';
 /** Static configuration for a single agent -- paths, capabilities, and format conventions. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phnx-labs/agents-cli",
-  "version": "1.22.10",
+  "version": "1.22.11",
   "description": "One CLI for all your AI coding agents - versions, config, cloud dispatch, sessions, and teams (now with first-class Grok Build CLI support)",
   "type": "module",
   "main": "dist/index.js",