@claude-flow/cli 3.32.4 → 3.32.5

package/.claude/helpers/helpers.manifest.json

@@ -1,6 +1,6 @@
 {
   "manifest": {
-    "version": "3.32.4",
+    "version": "3.32.5",
     "files": {
       "auto-memory-hook.mjs": "e3e1033b24704992ddef6b31c7fa9dd7fcd9e1af7935dd77ef73402b916b31e6",
       "hook-handler.cjs": "f87ec28684bfc5fd0a54c46bd2a53a3fb037defe71d0ea4b8a5cb88a2cd87a3f",
@@ -8,6 +8,6 @@
       "statusline.cjs": "af2703bdd710fb52af3221669266771ba1684157f34d77de21373890b5c2a126"
     }
   },
-  "signature": "sexJgMxhPXdN6hdOAUxiBupen/PSnwe93zxnEiqok8TkWlA9ltiajTkC2ImizGlSUhuYBP6yfLoNCvH+nNlXCw==",
+  "signature": "5OD1HOgN6EGws9zwZPLOwHKEvI0Xq7paKis9hcyOuolduBTzVf7ng4+YQoHkMDr+aoFA0WtFHW1ZBOZ/pYuBBQ==",
   "algorithm": "ed25519"
 }

package/catalog-manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 1,
   "generation": 1,
-  "generatedAt": "2026-07-17T19:12:15.849Z",
-  "gitSha": "5122b0e7",
+  "generatedAt": "2026-07-17T20:16:41.277Z",
+  "gitSha": "b592160f",
   "catalog": {
     "agents": 164,
     "tools": 387,

package/dist/src/commands/proxy-lifecycle.d.ts

@@ -6,7 +6,15 @@
  * `proxyCommand` in proxy.ts.
  */
 import type { Command } from '../types.js';
+import { type ProxyStatus } from '../proxy/lifecycle.js';
 /** Pinned and reviewed; later upgrades remain explicit commands. */
 export declare const DEFAULT_PROXY_RELEASE = "0.4.0";
+/**
+ * Human-oriented next steps for `ruflo proxy` and `ruflo proxy status`.
+ * Keep this independent of the command framework so the state-specific
+ * guidance has a small, direct regression-test surface.
+ */
+export declare function proxyConsoleGuidance(status: ProxyStatus): string[];
+export declare function printProxyConsoleGuidance(status: ProxyStatus): void;
 export declare const proxyLifecycleSubcommands: Command[];
 //# sourceMappingURL=proxy-lifecycle.d.ts.map

package/dist/src/commands/proxy-lifecycle.js

@@ -13,6 +13,53 @@ import { proxyTokenPath } from '../proxy/paths.js';
 import { removeInjectedToken, startTokenRefreshPump } from '../proxy/token-bridge.js';
 /** Pinned and reviewed; later upgrades remain explicit commands. */
 export const DEFAULT_PROXY_RELEASE = '0.4.0';
+const PROXY_COMMAND = 'npx ruflo@latest proxy';
+const AUTH_COMMAND = 'npx ruflo@latest auth';
+/**
+ * Human-oriented next steps for `ruflo proxy` and `ruflo proxy status`.
+ * Keep this independent of the command framework so the state-specific
+ * guidance has a small, direct regression-test surface.
+ */
+export function proxyConsoleGuidance(status) {
+    if (!status.installed) {
+        return [
+            '',
+            'Next step',
+            `  ${PROXY_COMMAND} install --yes    Install signed Meta-Proxy v${DEFAULT_PROXY_RELEASE}`,
+            '',
+            'After installation, start it in the background:',
+            `  ${PROXY_COMMAND} start --service`,
+        ];
+    }
+    if (!status.running) {
+        return [
+            '',
+            'Next step',
+            `  ${PROXY_COMMAND} start --service    Start the proxy in the background`,
+            '',
+            'Foreground mode (shows live logs; Ctrl+C stops it):',
+            `  ${PROXY_COMMAND} start`,
+            '',
+            'Optional: enable Cognitum cloud routing (local-only is the default):',
+            `  ${AUTH_COMMAND} login`,
+            `  ${PROXY_COMMAND} config --cloud --yes`,
+        ];
+    }
+    return [
+        '',
+        'Meta Proxy is ready.',
+        `  Logs:    ${PROXY_COMMAND} logs`,
+        `  Stop:    ${PROXY_COMMAND} stop`,
+        '',
+        'Optional: enable Cognitum cloud routing (local-only is the default):',
+        `  ${AUTH_COMMAND} login`,
+        `  ${PROXY_COMMAND} config --cloud --yes`,
+    ];
+}
+export function printProxyConsoleGuidance(status) {
+    for (const line of proxyConsoleGuidance(status))
+        output.writeln(line);
+}
 const INSTALL_DISCLOSURE = [
     'Installing the Meta LLM Proxy (ADR-304/307).',
     '',
@@ -163,14 +210,12 @@ const statusSub = {
             output.printJson(status);
             return { success: true, data: status };
         }
-        output.writeln(`Installed: ${status.installed ? 'yes' : 'no'}`);
-        output.writeln(`Running: ${status.running ? `yes (pid ${status.pid})` : 'no'}`);
+        output.writeln('Meta Proxy');
+        output.writeln(`  Installation: ${status.installed ? 'ready' : 'not installed'}`);
+        output.writeln(`  Process: ${status.running ? `running (pid ${status.pid})` : 'not running'}`);
         if (status.stalePidFile)
             output.writeln('  (a stale PID file was found and will be cleared on next start)');
-        if (!status.installed)
-            output.writeln(`Run: ruflo proxy install --yes (installs ${DEFAULT_PROXY_RELEASE})`);
-        else if (!status.running)
-            output.writeln('Run: ruflo proxy start');
+        printProxyConsoleGuidance(status);
         return { success: true, data: status };
     },
 };

package/dist/src/commands/proxy.js

@@ -23,7 +23,8 @@ import { clearRateLimitStatus, readRateLimitStatus } from '../funnel/rate-limit-
 import { clearQuotaLowStatus, readQuotaLowStatus } from '../funnel/power-saver-notifier.js';
 import { getInstalledCliVersion } from '../init/helper-refresh.js';
 import * as path from 'path';
-import { proxyLifecycleSubcommands } from './proxy-lifecycle.js';
+import { proxyLifecycleSubcommands, printProxyConsoleGuidance } from './proxy-lifecycle.js';
+import { getProxyStatus } from '../proxy/lifecycle.js';
 const PROXY_CONFIG_FILE = 'proxy-config.toml';
 /**
  * Minimal hand-rolled TOML writer — this config has exactly one boolean
@@ -387,11 +388,15 @@ export const proxyCommand = {
         { command: 'ruflo proxy power-saver-enable --yes', description: 'Opt into power saver mode' },
         { command: 'ruflo proxy training-share-enable --yes', description: 'Opt into training-data sharing (ADR-315)' },
     ],
-    action: async (ctx) => {
-        const { getProxyStatus } = await import('../proxy/lifecycle.js');
+    action: async () => {
         const status = getProxyStatus();
-        output.writeln(`Installed: ${status.installed ? 'yes' : 'no'}; Running: ${status.running ? `yes (pid ${status.pid})` : 'no'}`);
-        return sponsorStatusSub.action(ctx);
+        output.writeln('Meta Proxy');
+        output.writeln(`  Installation: ${status.installed ? 'ready' : 'not installed'}`);
+        output.writeln(`  Process: ${status.running ? `running (pid ${status.pid})` : 'not running'}`);
+        if (status.stalePidFile)
+            output.writeln('  (a stale PID file was found and will be cleared on next start)');
+        printProxyConsoleGuidance(status);
+        return { success: true, data: status };
     },
 };
 export default proxyCommand;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@claude-flow/cli",
-  "version": "3.32.4",
+  "version": "3.32.5",
   "type": "module",
   "description": "Ruflo CLI - Enterprise AI agent orchestration with 60+ specialized agents, swarm coordination, MCP server, self-learning hooks, and vector memory for Claude Code",
   "main": "dist/src/index.js",