@phnx-labs/agents-cli 1.12.0 → 1.14.2

package/dist/commands/routines.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Scheduled routines management.
+ *
+ * Registers the `agents routines` command tree for creating, editing,
+ * running, pausing, and removing cron-scheduled agent invocations.
+ * Also exposes scheduler lifecycle controls (start/stop/status/logs).
+ */
 import type { Command } from 'commander';
+/** Register the `agents routines` command tree. */
 export declare function registerRoutinesCommands(program: Command): void;
-//# sourceMappingURL=routines.d.ts.map

package/dist/commands/routines.js

@@ -1,3 +1,10 @@
+/**
+ * Scheduled routines management.
+ *
+ * Registers the `agents routines` command tree for creating, editing,
+ * running, pausing, and removing cron-scheduled agent invocations.
+ * Also exposes scheduler lifecycle controls (start/stop/status/logs).
+ */
 import chalk from 'chalk';
 import ora from 'ora';
 import * as fs from 'fs';
@@ -6,9 +13,11 @@ import * as yaml from 'yaml';
 import { isDaemonRunning, signalDaemonReload, startDaemon, stopDaemon, readDaemonPid, readDaemonLog, } from '../lib/daemon.js';
 import { listJobs as listAllJobs, deleteJob, readJob, validateJob, writeJob, setJobEnabled, listRuns, getLatestRun, getRunDir, getJobPath, parseAtTime, } from '../lib/routines.js';
 import { getRoutinesDir } from '../lib/state.js';
+import { safeJoin } from '../lib/paths.js';
 import { executeJob } from '../lib/runner.js';
 import { JobScheduler } from '../lib/scheduler.js';
 import { isInteractiveTerminal, requireInteractiveSelection } from './utils.js';
+/** Start or reload the background scheduler so newly-added jobs fire on time. */
 function ensureSchedulerRunning() {
     if (isDaemonRunning()) {
         signalDaemonReload();
@@ -24,12 +33,14 @@ function ensureSchedulerRunning() {
         console.log(chalk.yellow('Could not start the scheduler. Start it manually with: agents routines start'));
     }
 }
+/** Detect Ctrl+C or premature stream close during an interactive prompt. */
 function isPromptCancelled(err) {
     return (err instanceof Error &&
         (err.message.includes('User force closed') ||
             err.name === 'ExitPromptError' ||
             err.code === 'ERR_USE_AFTER_CLOSE'));
 }
+/** Interactive job picker. Returns the selected job name or null on cancel/empty. */
 async function pickJob(message, filter, alternatives = []) {
     let jobs = listAllJobs();
     if (filter) {
@@ -60,6 +71,7 @@ async function pickJob(message, filter, alternatives = []) {
         throw err;
     }
 }
+/** Register the `agents routines` command tree. */
 export function registerRoutinesCommands(program) {
     const routinesCmd = program
         .command('routines')
@@ -291,7 +303,7 @@ Examples:
         if (!jobPath) {
             // Job doesn't exist - create a new one
             const cronDir = getRoutinesDir();
-            const newPath = path.join(cronDir, `${name}.yml`);
+            const newPath = safeJoin(cronDir, `${name}.yml`);
             // Create template
             const template = yaml.stringify({
                 name,
@@ -304,10 +316,12 @@ Examples:
         }
         const targetPath = jobPath || path.join(getRoutinesDir(), `${name}.yml`);
         const editor = process.env.EDITOR || process.env.VISUAL || 'vi';
+        const editorParts = editor.split(/\s+/).filter(Boolean);
+        const editorBin = editorParts[0];
+        const editorArgs = [...editorParts.slice(1), targetPath];
         const { spawn: spawnSync } = await import('child_process');
-        const child = spawnSync(editor, [targetPath], {
+        const child = spawnSync(editorBin, editorArgs, {
             stdio: 'inherit',
-            shell: true,
         });
         child.on('close', (code) => {
             if (code === 0) {
@@ -576,4 +590,3 @@ Examples:
         }
     });
 }
-//# sourceMappingURL=routines.js.map

package/dist/commands/rules.d.ts

@@ -1,3 +1,11 @@
+/**
+ * Rules management commands for controlling agent behavior via persistent instructions.
+ *
+ * Implements `agents rules` -- list, add, view, and remove markdown rule files
+ * (AGENTS.md, CLAUDE.md, .cursorrules, etc.) that guide agent behavior across
+ * sessions. Central storage lives in ~/.agents/rules/ and rules are synced
+ * to individual version homes.
+ */
 import type { Command } from 'commander';
+/** Register the `agents rules` command tree (list, add, view, remove). */
 export declare function registerRulesCommands(program: Command): void;
-//# sourceMappingURL=rules.d.ts.map

package/dist/commands/rules.js

@@ -7,9 +7,10 @@ import { select, checkbox } from '@inquirer/prompts';
 import { AGENTS, ALL_AGENT_IDS, resolveAgentName, formatAgentError, agentLabel, } from '../lib/agents.js';
 import { cloneRepo } from '../lib/git.js';
 import { discoverInstructionsFromRepo, discoverMemoryFilesFromRepo, installInstructionsCentrally, uninstallInstructions, listInstalledInstructionsWithScope, instructionsExists, getInstructionsContent, listCentralMemory, } from '../lib/memory.js';
-import { listInstalledVersions, getGlobalDefault, syncResourcesToVersion, promptAgentVersionSelection, getVersionHomePath, resolveAgentVersionTargets, } from '../lib/versions.js';
+import { listInstalledVersions, getGlobalDefault, resolveVersionAlias, syncResourcesToVersion, promptAgentVersionSelection, getVersionHomePath, resolveAgentVersionTargets, } from '../lib/versions.js';
 import { recordVersionResources } from '../lib/state.js';
 import { isPromptCancelled, formatPath, isInteractiveTerminal, parseCommaSeparatedList, printWithPager, requireInteractiveSelection, requireDestructiveArg, } from './utils.js';
+/** Register the `agents rules` command tree (list, add, view, remove). */
 export function registerRulesCommands(program) {
     const rulesCmd = program
         .command('rules')
@@ -51,12 +52,12 @@ When to use:
         if (agentInput) {
             const parts = agentInput.split('@');
             const agentName = parts[0];
-            requestedVersion = parts[1] || null;
             agentId = resolveAgentName(agentName);
             if (!agentId) {
                 console.log(chalk.red(formatAgentError(agentName)));
                 process.exit(1);
             }
+            requestedVersion = resolveVersionAlias(agentId, parts[1]) ?? null;
         }
         const renderVersionRules = (agentId, version, isDefault, home) => {
             const agent = AGENTS[agentId];
@@ -158,6 +159,9 @@ When to use:
                 const projectInstr = installed.find((i) => i.scope === 'project');
                 const hasUser = userInstr?.exists;
                 const hasProject = projectInstr?.exists;
+                // Skip agents with nothing to show
+                if (!hasUser && !hasProject)
+                    continue;
                 console.log(`  ${chalk.bold(agentLabel(aid))}:`);
                 if (hasUser) {
                     console.log(`    ${chalk.gray('User:')}`);
@@ -181,11 +185,11 @@ When to use:
         .command('add [source]')
         .description('Install rule files from a source (GitHub, local path) or pick from central storage')
         .option('-a, --agents <list>', 'Targets: claude, codex@0.116.0, or gemini@default')
-        .option('--names <list>', 'Rule file names from ~/.agents/memory/ (comma-separated)')
+        .option('--names <list>', 'Rule file names from ~/.agents/rules/ (comma-separated)')
         .option('-y, --yes', 'Skip all prompts and use defaults')
         .addHelpText('after', `
 Examples:
-  # Interactive: pick from ~/.agents/memory/ and select agents
+  # Interactive: pick from ~/.agents/rules/ and select agents
   agents rules add
 
   # Install AGENTS.md to codex version 0.116.0
@@ -203,7 +207,7 @@ Examples:
             if (!source) {
                 const centralRules = listCentralMemory();
                 if (centralRules.length === 0) {
-                    console.log(chalk.yellow('No rule files in ~/.agents/memory/'));
+                    console.log(chalk.yellow('No rule files in ~/.agents/rules/'));
                     console.log(chalk.gray('\nTo add rule files from a repo:'));
                     console.log(chalk.cyan('  agents rules add gh:user/repo'));
                     return;
@@ -220,7 +224,7 @@ Examples:
                 }
                 else {
                     if (!isInteractiveTerminal()) {
-                        requireInteractiveSelection('Selecting rule files from ~/.agents/memory/', [
+                        requireInteractiveSelection('Selecting rule files from ~/.agents/rules/', [
                             'agents rules add --names AGENTS.md --agents codex',
                             'agents rules add gh:team/rules --agents codex',
                         ]);
@@ -289,8 +293,10 @@ Examples:
                     }
                     installSpinner.start();
                 }
-                installSpinner.succeed(`Installed ${centralResult.installed.length} rule files to ~/.agents/memory/`);
-                ruleNames = centralResult.installed.map((p) => path.basename(p));
+                installSpinner.succeed(`Installed ${centralResult.installed.length} rule file(s) to ~/.agents/rules/`);
+                ruleNames = centralResult.installed
+                    .filter((p) => path.dirname(p) === '.')
+                    .map((p) => path.basename(p));
             }
             let selectedAgents;
             let versionSelections;
@@ -359,12 +365,12 @@ Examples:
         if (agentArg) {
             const parts = agentArg.split('@');
             const agentName = parts[0];
-            requestedVersion = parts[1] || null;
             agentId = resolveAgentName(agentName) || undefined;
             if (!agentId) {
                 console.log(chalk.red(formatAgentError(agentName)));
                 process.exit(1);
             }
+            requestedVersion = resolveVersionAlias(agentId, parts[1]) ?? null;
         }
         else {
             const choices = ALL_AGENT_IDS.filter((id) => instructionsExists(id, 'user', cwd) || instructionsExists(id, 'project', cwd));
@@ -445,12 +451,12 @@ Examples:
         }
         const parts = agentArg.split('@');
         const agentName = parts[0];
-        const requestedVersion = parts[1] || null;
         const agentId = resolveAgentName(agentName);
         if (!agentId) {
             console.log(chalk.red(formatAgentError(agentName)));
             process.exit(1);
         }
+        const requestedVersion = resolveVersionAlias(agentId, parts[1]) ?? null;
         if (requestedVersion) {
             const installedVersions = listInstalledVersions(agentId);
             if (!installedVersions.includes(requestedVersion)) {
@@ -485,4 +491,3 @@ Examples:
         await rulesCmd.commands.find((c) => c.name() === 'view')?.parseAsync(['view', ...(agentArg ? [agentArg] : [])], { from: 'user' });
     });
 }
-//# sourceMappingURL=rules.js.map

package/dist/commands/secrets.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Secrets bundle management commands.
+ *
+ * Registers the `agents secrets` command tree for creating, viewing,
+ * and managing named bundles of environment variables backed by macOS
+ * Keychain. Bundles are injected at run time via `agents run --secrets`.
+ */
+import type { Command } from 'commander';
+/** Register the `agents secrets` command tree. */
+export declare function registerSecretsCommands(program: Command): void;