sh3-core 0.19.0 → 0.19.3

package/dist/shell-shard/registry.js

@@ -21,19 +21,29 @@ export class VerbRegistry {
      * @param opts.globalOnly When true, only verbs declared with `globalVerb:
      *   true` resolve locally; everything else forwards. Used by the dispatch
      *   path to gate sh3-domain verbs to sh3 mode while keeping framework
-     *   controls (clear, mode) reachable from every mode.
+     *   controls (clear, mode) reachable from every mode. The leading-`/`
+     *   escape ignores this flag — slash means "resolve as if in sh3 mode."
      */
     resolve(line, opts = {}) {
         const trimmed = line.trim();
         if (!trimmed)
             return { kind: 'forward', line };
-        // Escape hatch: '$ <rest>' always forwards
+        // Escape hatch: '$ <rest>' always forwards (used to call into bash from sh3)
         if (trimmed.startsWith('$ ')) {
             return { kind: 'forward', line: trimmed.slice(2) };
         }
         if (trimmed === '$') {
             return { kind: 'forward', line: '' };
         }
+        // Inverse escape: '/' makes the line resolve against sh3 verbs regardless
+        // of the active mode. `/foo args` ≡ `foo args` typed in sh3 mode.
+        // Whitespace after the slash is tolerated. `/` alone is a no-op forward.
+        if (trimmed.startsWith('/')) {
+            const body = trimmed.slice(1).trimStart();
+            if (!body)
+                return { kind: 'forward', line: '' };
+            return this.resolve(body, { globalOnly: false });
+        }
         // First whitespace-separated token
         const space = trimmed.indexOf(' ');
         const head = space === -1 ? trimmed : trimmed.slice(0, space);

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

@@ -9,10 +9,11 @@ export function makeHelpVerb() {
         summary: 'List verbs or show detail for one.',
         globalVerb: true,
         async run(ctx) {
-            const inSh3 = ctx.sh3.getMode().id === 'sh3';
-            const rows = listVerbs()
-                .filter((v) => inSh3 || v.globalVerb === true)
-                .map((v) => ({ name: v.name, summary: v.summary }));
+            // Lists every registered verb regardless of the active mode — the
+            // `/<verb>` escape (see registry.resolve) makes any sh3 verb reachable
+            // from any mode, so filtering the listing down to globalVerb-flagged
+            // entries would understate what the user can actually run.
+            const rows = listVerbs().map((v) => ({ name: v.name, summary: v.summary }));
             ctx.scrollback.push({
                 kind: 'rich',
                 componentKey: HELP_TABLE_KEY,

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

@@ -35,7 +35,7 @@ describe('help verb', () => {
         expect(names).toContain('mode');
         expect(names).toContain('help');
     });
-    it('lists only globalVerb-flagged verbs in a custom mode', async () => {
+    it('lists every registered verb in a custom mode (slash escape makes all sh3 verbs reachable)', async () => {
         const help = makeHelpVerb();
         const { ctx, pushed } = makeCtx('gemini');
         await help.run(ctx, []);
@@ -44,7 +44,10 @@ describe('help verb', () => {
         expect(names).toContain('clear');
         expect(names).toContain('mode');
         expect(names).toContain('help');
-        expect(names).not.toContain('apps');
+        // sh3-domain verbs now appear in the listing too — users invoke them
+        // via /apps from non-sh3 modes; hiding them would understate the
+        // surface that's actually callable.
+        expect(names).toContain('apps');
     });
     it('is flagged globalVerb so it resolves in custom modes', () => {
         const help = makeHelpVerb();

package/dist/verbs/types.d.ts

@@ -216,11 +216,16 @@ export interface Verb {
     name: string;
     summary: string;
     /**
-     * When true, this verb resolves in every sh3 mode — including bash and
-     * external shards' custom modes. Defaults to false: sh3-domain verbs only
-     * resolve when `mode.id === 'sh3'`. Reserve this flag for verbs whose
-     * action is mode-agnostic (e.g. `clear` clears the local scrollback,
-     * `mode` switches modes — both make sense everywhere).
+     * @deprecated Prefer the `/<verb>` user escape (resolver.ts `/` branch),
+     * which lets any sh3 verb be invoked from bash or custom modes without
+     * the author opting in. The flag still works for one minor cycle so
+     * existing shards keep resolving their flagged verbs without the slash.
+     *
+     * When true (legacy behavior), this verb resolves in every sh3 mode —
+     * including bash and external shards' custom modes. Defaults to false:
+     * sh3-domain verbs only resolve when `mode.id === 'sh3'`. Reserve this
+     * flag for verbs whose action is mode-agnostic (e.g. `clear` clears the
+     * local scrollback, `mode` switches modes — both make sense everywhere).
      */
     globalVerb?: boolean;
     /**

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

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