@phnx-labs/agents-cli 1.22.10 → 1.22.12

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/commands/repo.d.ts

@@ -17,7 +17,7 @@ import type { Command } from 'commander';
  * unit a user reasons about: one skill, one command, one plugin — even if it
  * spans several files on disk.
  */
-type RepoResourceKind = 'skill' | 'command' | 'plugin' | 'hook' | 'mcp' | 'subagent' | 'rule' | 'workflow' | 'routine' | 'profile' | 'permission' | 'cli' | 'config' | 'other';
+type RepoResourceKind = 'skill' | 'command' | 'plugin' | 'hook' | 'mcp' | 'subagent' | 'rule' | 'workflow' | 'routine' | 'profile' | 'permission' | 'clis' | 'config' | 'other';
 export type ChangeAction = 'new' | 'changed' | 'removed';
 /**
  * Map a repo-relative path to the resource unit it belongs to. Directory-based

package/dist/commands/repo.js

@@ -78,7 +78,7 @@ const RESOURCE_DIRS = {
     skills: 'skill', commands: 'command', prompts: 'command', plugins: 'plugin',
     hooks: 'hook', mcp: 'mcp', subagents: 'subagent', rules: 'rule',
     workflows: 'workflow', routines: 'routine', profiles: 'profile',
-    permissions: 'permission', cli: 'cli',
+    permissions: 'permission', clis: 'clis',
 };
 /** [singular, plural] display labels per kind. */
 const RESOURCE_LABELS = {
@@ -87,13 +87,13 @@ const RESOURCE_LABELS = {
     subagent: ['subagent', 'subagents'], rule: ['rule', 'rules'],
     workflow: ['workflow', 'workflows'], routine: ['routine', 'routines'],
     profile: ['profile', 'profiles'], permission: ['permission', 'permissions'],
-    cli: ['CLI', 'CLIs'], config: ['config file', 'config files'],
+    clis: ['CLI', 'CLIs'], config: ['config file', 'config files'],
     other: ['other file', 'other files'],
 };
 /** Display order — the resources a user cares about most come first. */
 const RESOURCE_ORDER = [
     'skill', 'command', 'plugin', 'hook', 'mcp', 'subagent', 'rule',
-    'workflow', 'routine', 'profile', 'permission', 'cli', 'config', 'other',
+    'workflow', 'routine', 'profile', 'permission', 'clis', 'config', 'other',
 ];
 /**
  * Map a repo-relative path to the resource unit it belongs to. Directory-based

package/dist/commands/view.d.ts

@@ -32,7 +32,7 @@ export interface ViewSectionFilter {
     rules?: boolean;
     hooks?: boolean;
     promptcuts?: boolean;
-    cli?: boolean;
+    clis?: boolean;
 }
 /** Trim a description to a column-friendly snippet. Strips newlines, collapses whitespace. */
 export declare function summarizeDescription(desc: string | undefined, maxLen?: number): string;

package/dist/commands/view.js

@@ -154,7 +154,7 @@ function getProjectVersionFromCwd(agent) {
         return null;
     }
 }
-const SECTION_KEYS = ['commands', 'skills', 'mcp', 'workflows', 'plugins', 'rules', 'hooks', 'promptcuts', 'cli'];
+const SECTION_KEYS = ['commands', 'skills', 'mcp', 'workflows', 'plugins', 'rules', 'hooks', 'promptcuts', 'clis'];
 /**
  * Decide whether a section should render given the filter. If no flags are set,
  * everything renders (current behavior). If any flag is set, only those sections
@@ -231,7 +231,7 @@ function hostCliSourceTag(source) {
 }
 /**
  * Render the host-CLI section. Host CLIs are host-global: declared in any
- * DotAgents repo's `cli/` (project > user > system > extras), installed to PATH
+ * DotAgents repo's `clis/` (project > user > system > extras), installed to PATH
  * rather than copied into a version home. They render identically in the overview
  * and in a per-agent detail view because every agent on the host shares them.
  * The source tag shows which repo layer declared each — so user-level and
@@ -241,7 +241,7 @@ function renderHostClisSection(cwd) {
     const { statuses, errors } = listCliStatus(cwd);
     console.log(chalk.bold('\nHost CLIs\n'));
     if (statuses.length === 0) {
-        console.log(`  ${chalk.gray('none declared')} ${chalk.gray('— add one with `agents cli add <name>`')}`);
+        console.log(`  ${chalk.gray('none declared')} ${chalk.gray('— add one with `agents clis add <name>`')}`);
     }
     else {
         const nameWidth = Math.max(...statuses.map((s) => s.manifest.name.length));
@@ -258,7 +258,7 @@ function renderHostClisSection(cwd) {
             console.log(prefix + desc);
         }
         if (anyMissing) {
-            console.log(chalk.gray('  Install missing with `agents cli install`'));
+            console.log(chalk.gray('  Install missing with `agents clis install`'));
         }
     }
     for (const err of errors) {
@@ -1100,7 +1100,7 @@ async function showAgentResources(agentId, requestedVersion, filter) {
     if (shouldRenderSection('promptcuts', filter)) {
         renderPromptcuts();
     }
-    if (shouldRenderSection('cli', filter)) {
+    if (shouldRenderSection('clis', filter)) {
         renderHostClisSection(cwd);
     }
     // Show legend at the end if git repo exists and we showed all sections.
@@ -1565,7 +1565,7 @@ export async function viewAction(agentArg, options) {
         rules: options?.rules,
         hooks: options?.hooks,
         promptcuts: options?.promptcuts,
-        cli: options?.cli,
+        clis: options?.clis,
     };
     const filterIsSet = SECTION_KEYS.some((k) => filter[k]);
     // RUSH-1320: fold any stale literal `latest` version-home into its concrete
@@ -1684,7 +1684,7 @@ export function registerViewCommand(program) {
         .option('--rules', 'Show only rules in the detail view.')
         .option('--hooks', 'Show only hooks in the detail view.')
         .option('--promptcuts', 'Show only promptcuts in the detail view.')
-        .option('--cli', 'Show only host CLIs (declared in cli/, installed to PATH).')
+        .option('--clis', 'Show only host CLIs (declared in clis/, installed to PATH).')
         .option('--merged', 'Show the merged, first-wins resource surface across all layers (project, user, extras, system) in one table with the winning layer per row.')
         .addHelpText('after', `
 Examples:

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/cli-resources.js

@@ -217,7 +217,7 @@ export function parseCliManifest(contents, opts) {
  * manifests and any parse errors separately so the CLI can show both.
  */
 export function listCliManifests(cwd) {
-    const resolved = listResources('cli', cwd);
+    const resolved = listResources('clis', cwd);
     const manifests = [];
     const errors = [];
     for (const entry of resolved) {
@@ -240,7 +240,7 @@ export function listCliManifests(cwd) {
 }
 /** Resolve a single CLI manifest by name. Returns null when not declared. */
 export function resolveCliManifest(name, cwd) {
-    const resolved = resolveResource('cli', name, cwd);
+    const resolved = resolveResource('clis', name, cwd);
     if (!resolved)
         return null;
     if (!resolved.path.endsWith('.yaml') && !resolved.path.endsWith('.yml'))

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/YYYY-MM-DD/` 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/YYYY-MM-DD/` 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,8 +1,8 @@
 /**
  * Centralized event logging for agents-cli.
  *
- * Structured JSONL audit log at ~/.agents/events.jsonl with lossless numbered
- * gzip rotation at 10 MB and rich metadata for debugging/auditing.
+ * Structured JSONL audit logs at ~/.agents/.history/events/YYYY-MM-DD/events.jsonl with
+ * lossless numbered gzip rotation at 10 MiB and bounded retention.
  *
  * Features:
  * - Rich metadata: hostname, platform, arch, pid, timezone
@@ -75,6 +75,17 @@ export interface EventPayload {
     [key: string]: unknown;
 }
 export type EventRecord = EventMeta & EventPayload;
+/**
+ * Move root-level and interim flat-history event families into dated directories.
+ *
+ * The common case is a whole-family rename into an empty destination. A
+ * Each segment is assigned to the local calendar day of its filesystem mtime;
+ * new writes are split by day at source. A partially completed migration keeps
+ * the destination active file authoritative and assigns a fresh archive number,
+ * so no record is overwritten or silently discarded. The legacy active-file
+ * lock serializes this with older installed processes that still append there.
+ */
+export declare function migrateLegacyEventLogs(userDir?: string): number;
 /**
  * Replace a prompt string with length + short SHA so we can correlate runs
  * without persisting the raw text. Returns the fields to spread into a payload.
@@ -187,15 +198,13 @@ export declare function emitError(err: Error | string, payload?: EventPayload):
  * the same failure across sessions (e.g. 'remote-cwd-on-add', 'not-installed').
  */
 export declare function emitFriction(surface: string, failureId: string, payload?: EventPayload): void;
-/**
- * Remove log files older than the retention period.
- * Removes numbered gzip archives whose filesystem mtime exceeds retention.
- *
- * @param retentionDays - Number of days to keep (default 7, from DEFAULT_RETENTION_DAYS)
- * @returns Number of files removed
- */
-export declare function rotate(retentionDays?: number): number;
-export declare function maybeRotate(): void;
+export interface RotationResult {
+    removedByAge: number;
+    removedBySize: number;
+    bytesReclaimed: number;
+}
+/** Apply age retention and the total-size ceiling immediately. */
+export declare function rotate(retentionDays?: number, maxStorageBytes?: number): RotationResult;
 /**
  * Read events from log files within a date range.
  *
@@ -245,4 +254,4 @@ export declare function stats(options?: {
     days?: number;
 }): EventStats;
 export declare function getLogsPath(): string;
-export declare function _resetForTest(overrideEventsPath?: string): void;
+export declare function _resetForTest(overrideEventsPath?: string, overrideUserAgentsDir?: string): void;