@shardflux/cli 0.13.1 → 0.13.2

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.13.2
+
+- On macOS, `shard` starts the menu bar by itself (with launch at login) the first time it runs; `shard menubar stop` turns that off and `shard menubar start` turns it back on.
+
 ## 0.13.1
 
 - `npx @shardflux/cli` runs `shard` again: the package exposes one command. The Git remote helper that `shard` uses for agent branches runs from a private shim on the PATH of the git commands `shard` starts.

package/dist/args.d.ts

@@ -1,4 +1,4 @@
-export declare const CLI_VERSION = "0.13.1";
+export declare const CLI_VERSION = "0.13.2";
 export interface OptionSpec {
     type: 'string' | 'boolean';
     short?: string;

package/dist/args.js

@@ -12,7 +12,7 @@
 import { parseArgs } from 'node:util';
 import { ACCOUNT_COMMANDS } from "./account-args.js";
 import { UsageError } from "./errors.js";
-export const CLI_VERSION = '0.13.1';
+export const CLI_VERSION = '0.13.2';
 export const GLOBAL_OPTIONS = {
     'api-url': { type: 'string', value: '<url>', description: 'API base URL (default $SHARDFLUX_API_URL, else https://api.shardflux.dev).' },
     json: { type: 'boolean', description: 'Print machine-readable JSON on stdout (errors as JSON on stderr).' },

package/dist/command-center.js

@@ -6,7 +6,7 @@ import { agentAction, availableTargets } from "./command-center-actions.js";
 import { centerRows, loadCenter } from "./command-center-model.js";
 import { AnsiRenderer, renderCenter } from "./command-center-renderer.js";
 import { CenterKeys } from "./command-center-keys.js";
-import { menubarHint } from "./menubar.js";
+import { ensureMenubar } from "./menubar.js";
 import { MenubarManager } from "./menubar.js";
 import { homedir } from 'node:os';
 import { retrySetupStep } from "./assisted-setup.js";
@@ -17,7 +17,7 @@ export async function showCenter(ctx, scope, options = {}) {
     const { HANDLERS } = await import("./handlers.js");
     const extra = [['m', 'merge'], ['k', 'keep'], ['d', 'discard']].filter(([, command]) => HANDLERS[`agents ${command}`]);
     const view = { rows: [], selected: undefined, filter: '', message: 'Loading agents…', extraKeys: extra.map(([key, command]) => `${key} ${command}`) };
-    const hint = await menubarHint(ctx.store.dir, new MenubarManager({ home: ctx.io.env.HOME || homedir(), signal: ctx.signal }));
+    const hint = await ensureMenubar(ctx.store.dir, ctx.apiUrl, new MenubarManager({ home: ctx.io.env.HOME || homedir(), signal: ctx.signal }));
     if (hint)
         view.menubarHint = hint;
     const renderer = new AnsiRenderer(), keys = new CenterKeys();

package/dist/menubar.d.ts

@@ -26,7 +26,8 @@ export declare class MenubarManager {
     login(value: 'on' | 'off'): Promise<MenubarStatus>;
     start(configDir: string, apiUrl: string): Promise<MenubarStatus>;
 }
-/** Only the command center consumes this hint. It reads status, never resolves or installs the optional package. */
-export declare function menubarHint(dir: string, manager?: MenubarManager): Promise<string | undefined>;
+/** On macOS, `shard` brings the menu bar up by itself (with launch at login) unless the user ran `shard menubar stop`.
+ *  It never fails the command center: a missing optional package or a refused start just leaves it off. */
+export declare function ensureMenubar(dir: string, apiUrl: string, manager?: MenubarManager, platform?: NodeJS.Platform): Promise<string | undefined>;
 export declare const MENUBAR_HANDLERS: Record<string, Handler>;
 export {};

package/dist/menubar.js

@@ -148,22 +148,28 @@ export class MenubarManager {
         throw new UsageError(`Shardflux did not start. Check ${join(configDir, 'menubar.log')}.`);
     }
 }
-/** Only the command center consumes this hint. It reads status, never resolves or installs the optional package. */
-export async function menubarHint(dir, manager = new MenubarManager()) {
-    if (process.platform !== 'darwin')
+/** On macOS, `shard` brings the menu bar up by itself (with launch at login) unless the user ran `shard menubar stop`.
+ *  It never fails the command center: a missing optional package or a refused start just leaves it off. */
+export async function ensureMenubar(dir, apiUrl, manager = new MenubarManager(), platform = process.platform) {
+    if (platform !== 'darwin')
         return undefined;
     const store = new AgentStateStore(dir);
-    if (store.read().menubar_hint_shown === true)
+    if (store.read().menubar_stopped === true)
         return undefined;
     try {
-        if ((await manager.status()).running)
+        const status = await manager.status();
+        if (status.running)
             return undefined;
+        const started = await manager.start(dir, apiUrl);
+        if (!started.running)
+            return undefined;
+        if (started.login !== 'on')
+            await manager.login('on').catch(() => undefined);
+        return 'Menu bar started · shard menubar stop to turn it off';
     }
     catch {
         return undefined;
     }
-    store.update(doc => { doc.menubar_hint_shown = true; });
-    return 'Menu bar: shard menubar start';
 }
 export const MENUBAR_HANDLERS = Object.fromEntries(['start', 'stop', 'status'].map(action => {
     const handler = async (ctx, values) => {
@@ -171,6 +177,12 @@ export const MENUBAR_HANDLERS = Object.fromEntries(['start', 'stop', 'status'].m
             throw new UsageError('--login must be on or off.');
         const manager = new MenubarManager({ home: ctx.io.env.HOME || homedir(), signal: ctx.signal });
         let status = action === 'start' ? await manager.start(ctx.store.dir, ctx.apiUrl) : action === 'stop' ? await manager.stop() : await manager.status();
+        // An explicit stop keeps `shard` from starting the menu bar again; an explicit start re-enables it.
+        if (action !== 'status')
+            new AgentStateStore(ctx.store.dir).update(doc => { if (action === 'stop')
+                doc.menubar_stopped = true;
+            else
+                delete doc.menubar_stopped; });
         if (values.login === 'on' || values.login === 'off')
             status = await manager.login(values.login);
         ctx.io.stdout.write(ctx.json ? json(status) : `Menu bar: ${status.running ? 'running' : 'stopped'}${status.installed ? ` · app ${status.version}` : ' · not installed'} · login ${status.login}\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shardflux/cli",
-  "version": "0.13.1",
+  "version": "0.13.2",
   "type": "module",
   "description": "shard: the Shardflux command line. Create an account, sign in, set up keys and billing, then open, run commands in, move files to, suspend, resume and fork serverless agent workspaces.",
   "license": "Apache-2.0",