sh3-core 0.15.0 → 0.15.1

package/dist/sh3core-shard/sh3coreShard.svelte.js

@@ -31,7 +31,29 @@ import { registeredApps } from '../apps/registry.svelte';
 import { launchApp } from '../apps/lifecycle';
 import { resetActivePresetToDefault } from '../layout/store.svelte';
 import { modalManager } from '../overlays/modal';
+import { floatManager } from '../overlays/float';
 import { registerAppActions } from './appActions';
+/**
+ * Build the palette-only float-maximize toggle action. Targets the topmost
+ * float (last entry in `floatManager.list()`); disabled when no floats are
+ * open. See spec docs/superpowers/specs/2026-05-07-float-resize-maximize-design.md.
+ */
+export function buildToggleMaximizeAction() {
+    return {
+        id: 'sh3.float.toggleMaximize',
+        label: 'Toggle Float Maximize',
+        scope: ['home', 'app'],
+        paletteItem: true,
+        contextItem: false,
+        defaultShortcut: 'Ctrl+Shift+M',
+        disabled: () => floatManager.list().length === 0,
+        run() {
+            const top = floatManager.list().at(-1);
+            if (top)
+                floatManager.toggleMaximize(top.id);
+        },
+    };
+}
 export const sh3coreShard = {
     manifest: {
         id: '__sh3core__',
@@ -61,6 +83,7 @@ export const sh3coreShard = {
                 import('../actions/listeners').then(({ openPalette }) => openPalette());
             },
         });
+        ctx.actions.register(buildToggleMaximizeAction());
         ctx.actions.register({
             id: 'sh3.app.reset-layout',
             label: 'Reset Current Layout',

package/dist/shards/activate-runtime.test.js

@@ -44,8 +44,30 @@ describe('ctx.listVerbs / ctx.runVerb (integration)', () => {
         const list = consumerCtx.listVerbs();
         const a = list.find((v) => v.name === 'host:a');
         const b = list.find((v) => v.name === 'host:b');
-        expect(a).toEqual({ shardId: 'host', name: 'host:a', summary: 'first verb', schema: undefined });
-        expect(b).toEqual({ shardId: 'host', name: 'host:b', summary: 'second verb', schema: undefined });
+        expect(a).toEqual({ shardId: 'host', name: 'host:a', summary: 'first verb', programmatic: true, schema: undefined });
+        expect(b).toEqual({ shardId: 'host', name: 'host:b', summary: 'second verb', programmatic: undefined, schema: undefined });
+    });
+    it('listVerbs({ programmaticOnly: true }) returns only verbs that opted in', async () => {
+        registerShard({
+            manifest: { id: 'host', label: 'Host', version: '0.0.0', views: [] },
+            activate(ctx) {
+                ctx.registerVerb(programmaticVerb('a', 'first verb'));
+                ctx.registerVerb(plainVerb('b', 'second verb'));
+            },
+        });
+        let consumerCtx = null;
+        registerShard({
+            manifest: { id: 'consumer', label: 'C', version: '0.0.0', views: [] },
+            activate(ctx) {
+                consumerCtx = ctx;
+            },
+        });
+        await activateShard('host');
+        await activateShard('consumer');
+        const list = consumerCtx.listVerbs({ programmaticOnly: true });
+        expect(list.find((v) => v.name === 'host:a')).toBeDefined();
+        expect(list.find((v) => v.name === 'host:b')).toBeUndefined();
+        expect(list.every((v) => v.programmatic === true)).toBe(true);
     });
     it('runVerb dispatches a programmatic verb and returns captured scrollback', async () => {
         registerShard({

package/dist/shards/activate.svelte.js

@@ -201,11 +201,16 @@ export async function activateShard(id, opts) {
             openContextMenu(opts) { shellOpenContextMenu(opts); },
             openPalette(opts) { shellOpenPalette(opts); },
         },
-        listVerbs() {
-            return listVerbsWithShard().map(({ verb, shardId }) => ({
+        listVerbs(opts) {
+            const all = listVerbsWithShard();
+            const filtered = (opts === null || opts === void 0 ? void 0 : opts.programmaticOnly)
+                ? all.filter(({ verb }) => verb.programmatic === true)
+                : all;
+            return filtered.map(({ verb, shardId }) => ({
                 shardId,
                 name: verb.name,
                 summary: verb.summary,
+                programmatic: verb.programmatic,
                 schema: verb.schema,
             }));
         },

package/dist/shards/types.d.ts

@@ -255,17 +255,25 @@ export interface ShardContext {
     /**
      * Read-only snapshot of every verb registered across every active shard.
      * Returned entries include the contributing `shardId`, the prefixed
-     * `name`, the verb's `summary`, and (when present) its `schema`.
-     * Order is undefined.
+     * `name`, the verb's `summary`, the `programmatic` flag, and (when
+     * present) its `schema`. Order is undefined.
+     *
+     * Pass `{ programmaticOnly: true }` to restrict the result to verbs that
+     * have opted in via `programmatic: true` — i.e. the verbs that are
+     * actually invocable through `ctx.runVerb(...)`. AI-class shards
+     * typically want this filter so they only surface what they can call.
      *
      * No permission gate — verb names + summaries are already visible via
      * the `help` verb. Diagnostic and AI-class shards (sh3-ai, sh3-diagnostic)
      * use this to enumerate the host's action surface.
      */
-    listVerbs(): Array<{
+    listVerbs(opts?: {
+        programmaticOnly?: boolean;
+    }): Array<{
         shardId: string;
         name: string;
         summary: string;
+        programmatic?: boolean;
         schema?: VerbSchema;
     }>;
     /**

package/dist/shell-shard/Terminal.svelte

@@ -143,6 +143,7 @@
       return true;
     },
     listModes: () => visibleModes.map((m) => ({ id: m.id, label: m.label })),
+    getMode: () => ({ id: mode.id, label: mode.label }),
   }));
 
   // wsUrl is a prop read at construction only. untrack prevents Svelte 5's

package/dist/shell-shard/shellApi.js

@@ -135,6 +135,7 @@ export function makeShellApiHeadless() {
         },
         setMode(_id) { return false; },
         listModes() { return []; },
+        getMode() { return { id: 'sh3', label: 'sh3' }; },
     };
 }
 export function makeShellApiForTest() {

package/dist/shell-shard/verbs/apps.js

@@ -3,6 +3,7 @@ import AppCard from '../rich/AppCard.svelte';
 export const appsVerb = {
     name: 'apps',
     summary: 'List installed apps. Click a row to launch.',
+    programmatic: true,
     async run(ctx) {
         const apps = ctx.shell.listApps();
         ctx.scrollback.push({
@@ -29,6 +30,7 @@ export const appsVerb = {
 export const appVerb = {
     name: 'app',
     summary: 'Show the currently active app.',
+    programmatic: true,
     async run(ctx) {
         const active = ctx.shell.getActiveApp();
         if (!active) {

package/dist/shell-shard/verbs/cat.js

@@ -1,6 +1,7 @@
 export const catVerb = {
     name: 'cat',
     summary: 'Read a file into the scrollback.',
+    programmatic: true,
     async run(ctx, args) {
         if (args.length === 0) {
             ctx.scrollback.push({

package/dist/shell-shard/verbs/help.js

@@ -4,8 +4,12 @@ export function makeHelpVerb() {
     return {
         name: 'help',
         summary: 'List verbs or show detail for one.',
+        globalVerb: true,
         async run(ctx) {
-            const rows = listVerbs().map((v) => ({ name: v.name, summary: v.summary }));
+            const inSh3 = ctx.shell.getMode().id === 'sh3';
+            const rows = listVerbs()
+                .filter((v) => inSh3 || v.globalVerb === true)
+                .map((v) => ({ name: v.name, summary: v.summary }));
             ctx.scrollback.push({
                 kind: 'rich',
                 component: HelpTable,

package/dist/shell-shard/verbs/help.svelte.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/shell-shard/verbs/help.svelte.test.js

@@ -0,0 +1,53 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { makeHelpVerb } from './help';
+import { registerVerb, __resetViewRegistryForTest } from '../../shards/registry';
+function makeCtx(modeId) {
+    const pushed = [];
+    const ctx = {
+        shell: { getMode: () => ({ id: modeId, label: modeId }) },
+        scrollback: { push: (e) => pushed.push(e) },
+        session: {},
+        cwd: '/',
+        dispatch: async () => { },
+        fs: {},
+    };
+    return { ctx, pushed };
+}
+const sh3Verb = { name: 'apps', summary: 'list apps', async run() { } };
+const globalA = { name: 'clear', summary: 'clear scrollback', globalVerb: true, async run() { } };
+const globalB = { name: 'mode', summary: 'switch mode', globalVerb: true, async run() { } };
+describe('help verb', () => {
+    beforeEach(() => {
+        __resetViewRegistryForTest();
+        registerVerb('apps', sh3Verb, 'shell');
+        registerVerb('clear', globalA, 'shell');
+        registerVerb('mode', globalB, 'shell');
+        registerVerb('help', makeHelpVerb(), 'shell');
+    });
+    it('lists every registered verb in sh3 mode', async () => {
+        const help = makeHelpVerb();
+        const { ctx, pushed } = makeCtx('sh3');
+        await help.run(ctx, []);
+        const rich = pushed.find((e) => e.kind === 'rich');
+        const names = rich.props.data.rows.map((r) => r.name);
+        expect(names).toContain('apps');
+        expect(names).toContain('clear');
+        expect(names).toContain('mode');
+        expect(names).toContain('help');
+    });
+    it('lists only globalVerb-flagged verbs in a custom mode', async () => {
+        const help = makeHelpVerb();
+        const { ctx, pushed } = makeCtx('gemini');
+        await help.run(ctx, []);
+        const rich = pushed.find((e) => e.kind === 'rich');
+        const names = rich.props.data.rows.map((r) => r.name);
+        expect(names).toContain('clear');
+        expect(names).toContain('mode');
+        expect(names).toContain('help');
+        expect(names).not.toContain('apps');
+    });
+    it('is flagged globalVerb so it resolves in custom modes', () => {
+        const help = makeHelpVerb();
+        expect(help.globalVerb).toBe(true);
+    });
+});

package/dist/shell-shard/verbs/ls.js

@@ -1,6 +1,7 @@
 export const lsVerb = {
     name: 'ls',
     summary: 'List the current directory.',
+    programmatic: true,
     async run(ctx) {
         let entries;
         try {

package/dist/shell-shard/verbs/session.js

@@ -35,6 +35,7 @@ function normalizeRel(s) {
 export const pwdVerb = {
     name: 'pwd',
     summary: 'Show the current working directory.',
+    programmatic: true,
     async run(ctx) {
         const rel = ctx.session.cwd || '';
         const display = rel.startsWith('/') ? rel : `/${rel}`;
@@ -85,6 +86,7 @@ export const cdVerb = {
 export const whoamiVerb = {
     name: 'whoami',
     summary: 'Show the current admin user and session info.',
+    programmatic: true,
     async run(ctx) {
         const me = ctx.shell.whoAmI();
         ctx.scrollback.push({

package/dist/shell-shard/verbs/shards.js

@@ -2,6 +2,7 @@ import ShardsTable from '../rich/ShardsTable.svelte';
 export const shardsVerb = {
     name: 'shards',
     summary: 'List active shards.',
+    programmatic: true,
     async run(ctx) {
         const shards = ctx.shell.listShards();
         ctx.scrollback.push({

package/dist/shell-shard/verbs/views.js

@@ -2,6 +2,7 @@ import ViewsTable from '../rich/ViewsTable.svelte';
 export const viewsVerb = {
     name: 'views',
     summary: 'List views currently mounted. Pass --standalone to list summonable views instead.',
+    programmatic: true,
     async run(ctx, args) {
         if (args.includes('--standalone')) {
             const standalones = ctx.shell.listStandaloneViews();
@@ -52,6 +53,7 @@ export const viewsVerb = {
 export const openVerb = {
     name: 'open',
     summary: 'Open a view from any active shard into the current layout.',
+    programmatic: true,
     async run(ctx, args) {
         var _a;
         const viewId = args[0];
@@ -86,6 +88,7 @@ export const openVerb = {
 export const popoutVerb = {
     name: 'popout',
     summary: 'Pop a docked view out into a float by slot id.',
+    programmatic: true,
     async run(ctx, args) {
         var _a;
         const slotId = args[0];
@@ -120,6 +123,7 @@ export const popoutVerb = {
 export const dockVerb = {
     name: 'dock',
     summary: 'Dock a float back into the current layout by float id. Run with no args to list floats.',
+    programmatic: true,
     async run(ctx, args) {
         var _a;
         const floatId = args[0];
@@ -166,6 +170,7 @@ export const dockVerb = {
 export const closeVerb = {
     name: 'close',
     summary: 'Close a view by slot id.',
+    programmatic: true,
     async run(ctx, args) {
         var _a;
         const slotId = args[0];

package/dist/shell-shard/verbs/zones.js

@@ -3,6 +3,7 @@ import ZoneTree from '../rich/ZoneTree.svelte';
 export const zonesVerb = {
     name: 'zones',
     summary: 'List zones for the current user (optionally scoped to a shard).',
+    programmatic: true,
     async run(ctx, args) {
         const rows = ctx.shell.listZones(args[0]);
         ctx.scrollback.push({
@@ -16,6 +17,7 @@ export const zonesVerb = {
 export const zoneVerb = {
     name: 'zone',
     summary: 'Dump the contents of a zone as a collapsible JSON tree.',
+    programmatic: true,
     async run(ctx, args) {
         const [shardId, zoneName] = args;
         if (!shardId || !zoneName) {

package/dist/verbs/types.d.ts

@@ -77,6 +77,15 @@ export interface ShellApi {
         id: string;
         label: string;
     }[];
+    /**
+     * Active shell mode. Returns `{ id: 'sh3', label: 'sh3' }` from headless
+     * contexts (no terminal view mounted) so callers can rely on a stable
+     * shape — Terminal.svelte overrides this with the live mode.
+     */
+    getMode(): {
+        id: string;
+        label: string;
+    };
 }
 export interface VerbContext {
     shell: ShellApi;

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** Auto-generated from package.json — do not edit manually. */
-export declare const VERSION = "0.15.0";
+export declare const VERSION = "0.15.1";

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Auto-generated from package.json — do not edit manually. */
-export const VERSION = '0.15.0';
+export const VERSION = '0.15.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh3-core",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "type": "module",
   "files": [
     "dist"