@phnx-labs/agents-cli 1.22.120 → 1.22.121

package/dist/commands/status.d.ts

@@ -1,14 +1,2 @@
-/**
- * `agents sync status` — the unified sync-status surface.
- *
- * Nested under `sync` because this is sync drift, not a separate noun (RUSH-2864).
- * One command that answers "is my fleet in sync?" the same way every other
- * surface does, because it reads the same engine (computeSyncStatus). Human mode
- * renders the summary and, when a TTY finds drift, offers the interactive
- * "sync now?" flow (promptDriftSync). `--json` emits the stable UnifiedSyncStatus
- * contract the menu-bar and Agency consume. `--yes` reconciles everything with no
- * prompts (the "kick it" path, safe in scripts).
- */
 import { Command } from 'commander';
-/** Attach `status` under the `sync` group. The former top-level `agents status` is retired. */
 export declare function registerStatusCommand(syncCmd: Command): void;

package/dist/commands/status.js

@@ -1,14 +1,3 @@
-/**
- * `agents sync status` — the unified sync-status surface.
- *
- * Nested under `sync` because this is sync drift, not a separate noun (RUSH-2864).
- * One command that answers "is my fleet in sync?" the same way every other
- * surface does, because it reads the same engine (computeSyncStatus). Human mode
- * renders the summary and, when a TTY finds drift, offers the interactive
- * "sync now?" flow (promptDriftSync). `--json` emits the stable UnifiedSyncStatus
- * contract the menu-bar and Agency consume. `--yes` reconciles everything with no
- * prompts (the "kick it" path, safe in scripts).
- */
 import chalk from 'chalk';
 import { AGENTS } from '../lib/agents.js';
 import { setHelpSections } from '../lib/help.js';
@@ -31,7 +20,6 @@ function versionSummary(v) {
     }
     return chalk.green('in sync');
 }
-/** Attach `status` under the `sync` group. The former top-level `agents status` is retired. */
 export function registerStatusCommand(syncCmd) {
     const cmd = addHostOption(syncCmd
         .command('status')
@@ -52,10 +40,6 @@ export function registerStatusCommand(syncCmd) {
     `,
     });
     cmd.action(async (opts, command) => {
-        // Centralized surface read (the human/agent split in one place). Note we still
-        // pass the *raw* `opts.yes` to promptDriftSync below — it distinguishes an
-        // explicit `--yes` (act) from a non-TTY shell (report only), so `surface.assumeYes`
-        // (which conflates the two) would wrongly auto-reconcile in a plain pipe.
         const surface = resolveSurface(command);
         const cwd = opts.cwd ?? process.cwd();
         if (surface.json) {
@@ -64,7 +48,6 @@ export function registerStatusCommand(syncCmd) {
             return;
         }
         const status = await computeSyncStatus({ cwd });
-        // Human summary header (always) — the per-version readout.
         console.log(chalk.bold('Fleet sync status'));
         if (status.system.unknown) {
             console.log(`  ${'.system repo'.padEnd(28)} ${chalk.gray('freshness unknown (no upstream)')}`);
@@ -75,8 +58,6 @@ export function registerStatusCommand(syncCmd) {
         else {
             console.log(`  ${'.system repo'.padEnd(28)} ${chalk.green('up to date')}`);
         }
-        // A non-git / partial ~/.agents is its own drift state, not a per-agent
-        // "N missing" — surface it distinctly so the real problem isn't buried (PHNX-3301).
         if (status.user.notGitRepo) {
             console.log(`  ${'~/.agents (user repo)'.padEnd(28)} ${chalk.yellow('not a git repo — will adopt on next `agents sync` (or `agents repo sync user`)')}`);
         }
@@ -84,7 +65,6 @@ export function registerStatusCommand(syncCmd) {
             console.log(chalk.gray('  (no installed agent versions)'));
         }
         for (const v of status.agents) {
-            // Model sits right beside the version, same priority (no label).
             const model = resolveConfiguredModel(v.agent, v.version)?.model;
             const defaultTag = v.isDefault ? ' (default)' : '';
             const plain = `${agentName(v.agent)}@${v.version}${model ? ` · ${model}` : ''}${defaultTag}`;
@@ -99,11 +79,6 @@ export function registerStatusCommand(syncCmd) {
         if (status.totals.orphan > 0) {
             console.log(chalk.gray(`  (${status.totals.orphan} orphan${status.totals.orphan === 1 ? '' : 's'} — run \`agents prune cleanup\`)`));
         }
-        // Config drift is its OWN class, not a per-agent "N missing": a box that has
-        // not folded its device-scoped state still carries a stale top-level header or
-        // a lingering central fleet/hosts/accounts/browser block. Surface it distinctly
-        // so an un-drained box is SEEN here instead of via a mystery pull conflict
-        // (PHNX-3315).
         if (status.config.staleHeader || status.config.centralLeaks.length > 0) {
             console.log(`  ${'config (device-scoped)'.padEnd(28)} ${chalk.yellow('not drained — folds automatically on normal `agents` use here (idempotent)')}`);
             if (status.config.staleHeader) {
@@ -113,7 +88,6 @@ export function registerStatusCommand(syncCmd) {
                 console.log(chalk.gray(`    · central ${leak} should be device-scoped`));
             }
         }
-        // Hand off to the shared interactive/apply flow (summary already printed above).
         await promptDriftSync({ cwd, yes: opts.yes, status, quiet: true });
     });
 }

package/dist/commands/subagents.d.ts

@@ -1,10 +1,2 @@
-/**
- * Subagent management commands.
- *
- * Registers the `agents subagents` command tree for listing, viewing,
- * installing, and removing lightweight agent definitions (AGENT.md files)
- * that parent agents can spawn for focused subtasks.
- */
 import type { Command } from 'commander';
-/** Register the `agents subagents` command tree. */
 export declare function registerSubagentsCommands(program: Command): void;

package/dist/commands/subagents.js

@@ -1,10 +1,3 @@
-/**
- * Subagent management commands.
- *
- * Registers the `agents subagents` command tree for listing, viewing,
- * installing, and removing lightweight agent definitions (AGENT.md files)
- * that parent agents can spawn for focused subtasks.
- */
 import { withAliases } from '../lib/verbs.js';
 import chalk from 'chalk';
 import ora from 'ora';
@@ -19,7 +12,6 @@ import { listInstalledVersions, syncResourcesToVersion, getGlobalDefault, getVer
 import { getSubagentsDir, recordVersionResources } from '../lib/state.js';
 import { requireDestructiveArg, promptRemovalTargets, parseCommaSeparatedList, resolveAgentTargetsAutoInstalling, } from './utils.js';
 import { showResourceList, buildTargetsSection, } from './resource-view.js';
-/** Replace the home directory prefix with ~ for display. */
 function formatPath(p) {
     const home = homeDir();
     if (home && p.startsWith(home)) {
@@ -27,7 +19,6 @@ function formatPath(p) {
     }
     return p;
 }
-/** Register the `agents subagents` command tree. */
 export function registerSubagentsCommands(program) {
     const subagentsCmd = program
         .command('subagents')
@@ -53,7 +44,6 @@ When to use:
   - Version isolation: sync different subagent sets to different agent versions
   - Team sharing: distribute subagent definitions via GitHub repos
 `);
-    // Shared list implementation, registered as `list` and hidden `view` alias.
     const runList = async (opts) => {
         const rows = buildSubagentRows();
         await showResourceList({
@@ -66,7 +56,6 @@ When to use:
             json: opts?.json,
         });
     };
-    // agents subagents list
     withAliases(subagentsCmd
         .command('list'), 'list')
         .description('Show subagents in a table with sync status across agent versions')
@@ -77,7 +66,6 @@ Examples:
   agents subagents list
 `)
         .action(runList);
-    // agents subagents view <name>
     withAliases(subagentsCmd
         .command('view [name]'), 'view')
         .description('Show details for a specific subagent (use "list" to see all)')
@@ -102,7 +90,6 @@ Examples:
         }
         console.log(formatSubagentDetail(subagent, buildSubagentTargets(subagent.name)));
     });
-    // agents subagents add <source>
     subagentsCmd
         .command('add <source>')
         .description('Install subagents from a source (GitHub, local path) and sync to agent versions')
@@ -128,8 +115,6 @@ Examples:
 `)
         .action(async (source, options) => {
         const spinner = ora({ text: 'Fetching source...', isSilent: !process.stdout.isTTY }).start();
-        // Clone or use local source. Accept any git-like scheme to match the
-        // other <resource> add commands (skills, workflows, commands, hooks).
         let sourcePath;
         const isGitRepo = source.startsWith('gh:') || source.startsWith('git:') ||
             source.startsWith('ssh:') || source.startsWith('https://') ||
@@ -151,7 +136,6 @@ Examples:
             spinner.fail(`Source not found: ${source}`);
             process.exit(1);
         }
-        // Discover subagents
         spinner.text = 'Discovering subagents...';
         let discovered = discoverSubagentsFromRepo(sourcePath);
         if (discovered.length === 0) {
@@ -159,7 +143,6 @@ Examples:
             console.log(chalk.gray(`Expected: subagents/*/AGENT.md`));
             process.exit(1);
         }
-        // --names filter: pluck specific subagents from a multi-subagent source.
         const requestedNames = parseCommaSeparatedList(options.names);
         if (requestedNames.length > 0) {
             const discoveredNames = new Set(discovered.map((s) => s.name));
@@ -172,15 +155,11 @@ Examples:
             discovered = discovered.filter((s) => requestedNames.includes(s.name));
         }
         spinner.succeed(`Found ${discovered.length} subagent(s)`);
-        // Show what we found
         console.log();
         for (const sub of discovered) {
             console.log(`  ${chalk.cyan(sub.name)}: ${chalk.gray(sub.frontmatter.description)}`);
         }
         console.log();
-        // Determine target agent versions, using the same path skills/workflows use.
-        // Back-compat: commander's old `--agents <agents...>` shape arrives as an array;
-        // join it with commas so resolveAgentVersionTargets can parse it.
         const agentsArg = Array.isArray(options.agents)
             ? options.agents.join(',')
             : options.agents;
@@ -202,7 +181,6 @@ Examples:
             selectedAgents = result.selectedAgents;
             versionSelections = result.versionSelections;
         }
-        // Install centrally
         const installSpinner = ora({ text: 'Installing subagents...', isSilent: !process.stdout.isTTY }).start();
         for (const sub of discovered) {
             const result = installSubagentCentrally(sub.path, sub.name);
@@ -212,7 +190,6 @@ Examples:
             }
         }
         installSpinner.succeed(`Installed ${discovered.length} subagent(s) to ${formatPath(getSubagentsDir())}`);
-        // Sync to selected versions
         if (versionSelections.size > 0) {
             const syncSpinner = ora({ text: 'Syncing to agents...', isSilent: !process.stdout.isTTY }).start();
             const subagentNames = discovered.map((s) => s.name);
@@ -236,7 +213,6 @@ Examples:
         }
         console.log();
     });
-    // agents subagents remove [name]
     withAliases(subagentsCmd
         .command('remove [name]'), 'remove')
         .description('Delete a subagent from central storage and unsync from all agent versions')
@@ -265,7 +241,6 @@ Examples:
             console.log(chalk.red(`Subagent '${name}' not found`));
             process.exit(1);
         }
-        // Build list of targets that have this subagent synced
         const availableTargets = [];
         for (const { agent, version } of iterSubagentsCapableVersions()) {
             const home = getVersionHomePath(agent, version);
@@ -278,7 +253,6 @@ Examples:
             console.log(chalk.yellow(`Subagent '${name}' not synced to any version.`));
             return;
         }
-        // Show multi-select picker for targets
         const removalTargets = availableTargets.map((t) => ({
             agent: t.agent,
             version: t.version,
@@ -309,7 +283,6 @@ Examples:
         }
     });
 }
-/** Every (agent, version) that supports subagents and is installed. */
 function iterSubagentCapableVersions() {
     const out = [];
     for (const agent of capableAgents('subagents')) {
@@ -319,7 +292,6 @@ function iterSubagentCapableVersions() {
     }
     return out;
 }
-/** Compute sync targets for a single subagent by name across all capable versions. */
 function buildSubagentTargets(name) {
     const targets = [];
     for (const { agent, version, home } of iterSubagentCapableVersions()) {
@@ -333,13 +305,11 @@ function buildSubagentTargets(name) {
     }
     return targets;
 }
-/** Build resource rows for all centrally-installed subagents with sync status. */
 function buildSubagentRows() {
     const central = listInstalledSubagents();
     if (central.length === 0)
         return [];
     const pairs = iterSubagentCapableVersions();
-    // Read each target's installed subagents once; lookup by name per row.
     const installedByTarget = new Map();
     for (const { agent, version, home } of pairs) {
         const names = new Set(listSubagentsForAgent(agent, home).map((s) => s.name));
@@ -374,7 +344,6 @@ function buildSubagentRows() {
     });
     return rows;
 }
-/** Build the multi-line detail pane shown when a subagent is selected in the picker. */
 function formatSubagentDetail(sub, targets) {
     const lines = [];
     lines.push(chalk.bold.cyan(sub.name));

package/dist/commands/sync.d.ts

@@ -1,40 +1,3 @@
-/**
- * `agents sync` — synchronize central resources into an installed agent version.
- *
- * Forms:
- *   agents sync                                         # umbrella: fetch config repos -> reconcile all (secrets opt-in)
- *   agents sync status                                  # report fleet drift (former top-level `agents status`)
- *   agents sync --repos|--secrets                       # umbrella: fetch only those, then reconcile
- *   agents sync --cloud                                 # umbrella: fetch all, skip reconcile
- *   agents sync --local                                 # umbrella: reconcile all, no fetch
- *   agents sync system                                  # one repo: git pull --rebase (pull-only mirror)
- *   agents sync user                                    # one repo: git pull --rebase + push
- *   agents sync claude                                  # one agent: uses default/sole installed version
- *   agents sync claude@2.1.142                          # one agent: explicit version
- *   agents sync claude@latest                           # one agent: newest installed
- *   agents sync claude@oldest                           # one agent: oldest installed
- *   agents sync claude@pinned   (= claude@default)      # one agent: the pinned default version
- *   agents sync --agent claude --agent-version 2.1.142  # legacy form, still supported
- *
- * The umbrella stages live in lib/sync-umbrella.ts; this file dispatches to them
- * when no agent is given.
- *
- * In a TTY the command previews available/new resources and lets the user
- * select what to sync (same prompts shown after `agents add`). Pass
- * --yes for non-interactive auto-sync, --force to re-sync when nothing
- * has changed, --quiet for total silence.
- *
- * Hot path:
- *   --launch is the shim entry point. It skips version-home reconciliation
- *   and runs only the cheap project-scoped work (rules compile, workspace
- *   resource mirror, per-scope plugin marketplaces). Filesystem-only,
- *   sub-50ms steady state. Keep changes here surgical.
- */
 import { Command } from 'commander';
-/**
- * Attach the resource-selector flag family to the sync command.
- * Exported for testing flag registration in sync.test.ts.
- */
 export declare function addSelectorOptions(cmd: Command): Command;
-/** Register the `agents sync` command. */
 export declare function registerSyncCommand(program: Command): void;