sh3-core 0.22.5 → 0.23.2

package/dist/shell-shard/dispatch.d.ts

@@ -4,7 +4,6 @@ import type { TenantFsClient } from './tenant-fs-client';
 import type { ModeBuffer } from './mode-buffer.svelte';
 import type { ShellMode, ShellRole } from './modes/types';
 import type { ShellModeDescriptor } from './contract';
-import type { BrowseCapability } from '../documents/browse';
 export interface DispatchDeps {
     mode: () => ShellMode;
     /** Current shell role — used by invoke() role-gating. */
@@ -19,7 +18,6 @@ export interface DispatchDeps {
     session: SessionClient;
     sh3: Sh3Api;
     fs: TenantFsClient;
-    docs?: BrowseCapability;
     cwd: () => string;
     /**
      * Acquire a busy indicator. Returns a clear handle. Calling clear()

package/dist/shell-shard/dispatch.js

@@ -39,7 +39,6 @@ export function makeDispatch(deps) {
                 cwd: deps.cwd(),
                 dispatch,
                 fs: deps.fs,
-                docs: deps.docs,
             }, resolution.args);
             return;
         }
@@ -108,7 +107,6 @@ export function makeDispatch(deps) {
                     cwd: deps.cwd(),
                     dispatch,
                     fs: deps.fs,
-                    docs: deps.docs,
                 }, resolution.args);
             }
             catch (err) {

package/dist/shell-shard/display-cwd.test.js

@@ -2,19 +2,19 @@ import { describe, it, expect } from 'vitest';
 import { shortenCwd } from './display-cwd';
 describe('shortenCwd', () => {
     it('returns ~ when cwd equals tenant root', () => {
-        expect(shortenCwd('/home/u/data/users/x/documents/shell', '/home/u/data/users/x/documents/shell')).toBe('~');
+        expect(shortenCwd('/home/u/data/docs/x', '/home/u/data/docs/x')).toBe('~');
     });
     it('substitutes ~ for tenant-root prefix (POSIX)', () => {
-        expect(shortenCwd('/home/u/data/users/x/documents/shell/notes', '/home/u/data/users/x/documents/shell')).toBe('~/notes');
+        expect(shortenCwd('/home/u/data/docs/x/notes', '/home/u/data/docs/x')).toBe('~/notes');
     });
     it('substitutes ~ for tenant-root prefix (Windows)', () => {
-        expect(shortenCwd('C:\\a\\b\\users\\x\\documents\\shell\\notes', 'C:\\a\\b\\users\\x\\documents\\shell')).toBe('~/notes');
+        expect(shortenCwd('C:\\a\\b\\docs\\x\\notes', 'C:\\a\\b\\docs\\x')).toBe('~/notes');
     });
     it('normalizes Windows backslashes to forward slashes after the tilde', () => {
         expect(shortenCwd('C:\\root\\a\\b\\c', 'C:\\root')).toBe('~/a/b/c');
     });
     it('returns the absolute cwd when outside the tenant root', () => {
-        expect(shortenCwd('/tmp', '/home/u/data/users/x/documents/shell')).toBe('/tmp');
+        expect(shortenCwd('/tmp', '/home/u/data/docs/x')).toBe('/tmp');
     });
     it('does not match when cwd matches the tenant root prefix without a separator boundary', () => {
         // tenant=/foo, cwd=/foobar → must NOT shorten to ~bar

package/dist/shell-shard/manifest.js

@@ -5,6 +5,7 @@ export const manifest = {
     id: 'shell',
     label: 'Sh3',
     version: VERSION,
+    kind: 'system',
     views: [{ id: 'shell:terminal', label: 'Sh3', standalone: true }],
     // serverBundle intentionally omitted — this shard is a framework built-in
     // and is statically mounted at sh3-server boot. The existing contract in

package/dist/shell-shard/shellShard.svelte.d.ts

@@ -1,3 +1,3 @@
 import type { Shard } from '../api';
-export { makeSh3ApiHeadless, makeSh3ApiForTest } from '../sh3Api/headless';
+export { makeSh3ApiForTest } from '../sh3Api/headless';
 export declare const shellShard: Shard;

package/dist/shell-shard/shellShard.svelte.js

@@ -20,18 +20,23 @@ import { mount, unmount } from 'svelte';
 import { manifest } from './manifest';
 import Terminal from './Terminal.svelte';
 import { registerV1Verbs } from './verbs';
-import { makeSh3ApiHeadless } from '../sh3Api/headless';
+import { makeSh3Api } from '../sh3Api/headless';
 import { focusView } from '../layout/inspection';
 import { floatManager } from '../overlays/float';
 import { getUser, isAdmin } from '../auth/index';
 import { __bindZone, __unbindZone } from './buffer-zone-state.svelte';
 import { getAuthToken } from '../transport/authToken';
-export { makeSh3ApiHeadless, makeSh3ApiForTest } from '../sh3Api/headless';
+export { makeSh3ApiForTest } from '../sh3Api/headless';
 export const shellShard = {
     manifest,
     register(ctx) {
         registerV1Verbs(ctx);
-        const shell = makeSh3ApiHeadless(ctx.zones);
+        const shell = makeSh3Api({
+            callerKind: 'shard',
+            callerShardId: 'shell',
+            zones: ctx.zones,
+            docs: ctx.browse,
+        });
         // Bind the shell-shard's workspace zone — backs scrollback persistence
         // (SH8). BufferStore reads/writes through this proxy.
         const zone = ctx.state({
@@ -73,7 +78,7 @@ export const shellShard = {
                 const role = isAdmin() ? 'admin' : 'user';
                 const instance = mount(Terminal, {
                     target: container,
-                    props: { shell, wsUrl, userId, role, contributions: ctx.contributions, docs: ctx.browse },
+                    props: { shell, wsUrl, userId, role, contributions: ctx.contributions },
                 });
                 return {
                     unmount() {

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

@@ -5,7 +5,7 @@ export const catVerb = {
     programmatic: true,
     async run(ctx, args) {
         const ts = Date.now();
-        if (!ctx.docs) {
+        if (!ctx.sh3.docs) {
             ctx.scrollback.push({ kind: 'status', text: 'cat: document capability not available', level: 'error', ts });
             return;
         }
@@ -18,11 +18,11 @@ export const catVerb = {
             ctx.scrollback.push({ kind: 'status', text: `cat: invalid path '${args[0]}'`, level: 'error', ts });
             return;
         }
-        if (!ctx.docs.readFrom) {
+        if (!ctx.sh3.docs.readFrom) {
             ctx.scrollback.push({ kind: 'status', text: 'cat: read permission not granted', level: 'error', ts });
             return;
         }
-        const content = await ctx.docs.readFrom(parsed.shardId, parsed.path);
+        const content = await ctx.sh3.docs.readFrom(parsed.shardId, parsed.path);
         if (content === null) {
             ctx.scrollback.push({ kind: 'status', text: `cat: not found: ${args[0]}`, level: 'error', ts });
             return;

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

@@ -6,12 +6,11 @@ function makeDocs(overrides = {}) {
 function makeCtx(docs) {
     const pushed = [];
     const ctx = {
-        sh3: {},
+        sh3: { docs },
         scrollback: { push: (e) => pushed.push(e) },
         session: {},
         cwd: '/',
         fs: {},
-        docs,
         dispatch: async () => { },
     };
     return { ctx, pushed };

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

@@ -6,11 +6,11 @@ export const lsVerb = {
     async run(ctx, args) {
         var _a, _b, _c;
         const ts = Date.now();
-        if (!ctx.docs) {
+        if (!ctx.sh3.docs) {
             ctx.scrollback.push({ kind: 'status', text: 'ls: document capability not available', level: 'error', ts });
             return;
         }
-        const all = await ctx.docs.listDocuments();
+        const all = await ctx.sh3.docs.listDocuments();
         const arg = args[0];
         if (!arg) {
             // Group by shard, emit counts

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

@@ -6,12 +6,11 @@ function makeDocs(overrides = {}) {
 function makeCtx(docs) {
     const pushed = [];
     const ctx = {
-        sh3: {},
+        sh3: { docs },
         scrollback: { push: (e) => pushed.push(e) },
         session: {},
         cwd: '/',
         fs: {},
-        docs,
         dispatch: async () => { },
     };
     return { ctx, pushed };

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

@@ -5,7 +5,7 @@ export const mkdirVerb = {
     programmatic: true,
     async run(ctx, args) {
         const ts = Date.now();
-        if (!ctx.docs) {
+        if (!ctx.sh3.docs) {
             ctx.scrollback.push({ kind: 'status', text: 'mkdir: document capability not available', level: 'error', ts });
             return;
         }
@@ -13,7 +13,7 @@ export const mkdirVerb = {
             ctx.scrollback.push({ kind: 'status', text: 'usage: mkdir <shardId>/<folder>', level: 'error', ts });
             return;
         }
-        if (!ctx.docs.writeTo) {
+        if (!ctx.sh3.docs.writeTo) {
             ctx.scrollback.push({ kind: 'status', text: 'mkdir: write permission not granted', level: 'error', ts });
             return;
         }
@@ -24,7 +24,7 @@ export const mkdirVerb = {
         }
         // Materialise the folder with a sentinel file; backends treat paths as flat.
         const keepPath = parsed.path.replace(/\/$/, '') + '/.keep';
-        await ctx.docs.writeTo(parsed.shardId, keepPath, '');
+        await ctx.sh3.docs.writeTo(parsed.shardId, keepPath, '');
         ctx.scrollback.push({ kind: 'status', text: `mkdir: created ${args[0]}`, level: 'info', ts });
     },
 };

package/dist/shell-shard/verbs/mkdir.test.js

@@ -6,12 +6,11 @@ function makeDocs(overrides = {}) {
 function makeCtx(docs) {
     const pushed = [];
     const ctx = {
-        sh3: {},
+        sh3: { docs },
         scrollback: { push: (e) => pushed.push(e) },
         session: {},
         cwd: '/',
         fs: {},
-        docs,
         dispatch: async () => { },
     };
     return { ctx, pushed };

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

@@ -5,7 +5,7 @@ export const mvVerb = {
     programmatic: true,
     async run(ctx, args) {
         const ts = Date.now();
-        if (!ctx.docs) {
+        if (!ctx.sh3.docs) {
             ctx.scrollback.push({ kind: 'status', text: 'mv: document capability not available', level: 'error', ts });
             return;
         }
@@ -13,7 +13,7 @@ export const mvVerb = {
             ctx.scrollback.push({ kind: 'status', text: 'usage: mv <shardId>/<old> <shardId>/<new>', level: 'error', ts });
             return;
         }
-        if (!ctx.docs.renameFrom) {
+        if (!ctx.sh3.docs.renameFrom) {
             ctx.scrollback.push({ kind: 'status', text: 'mv: write permission not granted', level: 'error', ts });
             return;
         }
@@ -27,7 +27,7 @@ export const mvVerb = {
             ctx.scrollback.push({ kind: 'status', text: 'mv: src and dst must be in the same shard (use xfer for cross-scope moves)', level: 'error', ts });
             return;
         }
-        await ctx.docs.renameFrom(src.shardId, src.path, dst.path);
+        await ctx.sh3.docs.renameFrom(src.shardId, src.path, dst.path);
         ctx.scrollback.push({ kind: 'status', text: `mv: renamed ${args[0]} → ${args[1]}`, level: 'info', ts });
     },
 };

package/dist/shell-shard/verbs/mv.test.js

@@ -6,12 +6,11 @@ function makeDocs(overrides = {}) {
 function makeCtx(docs) {
     const pushed = [];
     const ctx = {
-        sh3: {},
+        sh3: { docs },
         scrollback: { push: (e) => pushed.push(e) },
         session: {},
         cwd: '/',
         fs: {},
-        docs,
         dispatch: async () => { },
     };
     return { ctx, pushed };

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

@@ -5,7 +5,7 @@ export const rmVerb = {
     programmatic: true,
     async run(ctx, args) {
         const ts = Date.now();
-        if (!ctx.docs) {
+        if (!ctx.sh3.docs) {
             ctx.scrollback.push({ kind: 'status', text: 'rm: document capability not available', level: 'error', ts });
             return;
         }
@@ -13,7 +13,7 @@ export const rmVerb = {
             ctx.scrollback.push({ kind: 'status', text: 'usage: rm <shardId>/<path>', level: 'error', ts });
             return;
         }
-        if (!ctx.docs.deleteFrom) {
+        if (!ctx.sh3.docs.deleteFrom) {
             ctx.scrollback.push({ kind: 'status', text: 'rm: write permission not granted', level: 'error', ts });
             return;
         }
@@ -22,7 +22,7 @@ export const rmVerb = {
             ctx.scrollback.push({ kind: 'status', text: `rm: invalid path '${args[0]}'`, level: 'error', ts });
             return;
         }
-        await ctx.docs.deleteFrom(parsed.shardId, parsed.path);
+        await ctx.sh3.docs.deleteFrom(parsed.shardId, parsed.path);
         ctx.scrollback.push({ kind: 'status', text: `rm: deleted ${args[0]}`, level: 'info', ts });
     },
 };

package/dist/shell-shard/verbs/rm.test.js

@@ -6,12 +6,11 @@ function makeDocs(overrides = {}) {
 function makeCtx(docs) {
     const pushed = [];
     const ctx = {
-        sh3: {},
+        sh3: { docs },
         scrollback: { push: (e) => pushed.push(e) },
         session: {},
         cwd: '/',
         fs: {},
-        docs,
         dispatch: async () => { },
     };
     return { ctx, pushed };

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

@@ -11,11 +11,11 @@ export const xferVerb = {
     programmatic: true,
     async run(ctx, args) {
         const ts = Date.now();
-        if (!ctx.docs) {
+        if (!ctx.sh3.docs) {
             ctx.scrollback.push({ kind: 'status', text: 'xfer: document capability not available', level: 'error', ts });
             return;
         }
-        if (!ctx.docs.transferBetweenScopes) {
+        if (!ctx.sh3.docs.transferBetweenScopes) {
             ctx.scrollback.push({ kind: 'status', text: 'xfer: write permission not granted', level: 'error', ts });
             return;
         }
@@ -64,13 +64,13 @@ export const xferVerb = {
                 ctx.scrollback.push({ kind: 'status', text: 'xfer: source and destination are the same', level: 'error', ts });
                 return;
             }
-            await ctx.docs.transferBetweenScopes(srcTenant, srcParsed.shardId, srcParsed.path, dstTenant, dstParsed.shardId, dstParsed.path, moveOpts);
+            await ctx.sh3.docs.transferBetweenScopes(srcTenant, srcParsed.shardId, srcParsed.path, dstTenant, dstParsed.shardId, dstParsed.path, moveOpts);
             const verb = copy ? 'copied' : 'moved';
             ctx.scrollback.push({ kind: 'status', text: `xfer: ${verb} ${positional[0]} → ${positional[1]}`, level: 'info', ts });
             return;
         }
         const prefix = srcParsed.path;
-        const allDocs = await ctx.docs.listDocumentsIn(srcTenant);
+        const allDocs = await ctx.sh3.docs.listDocumentsIn(srcTenant);
         const matching = allDocs.filter((d) => d.shardId === srcParsed.shardId && (!prefix || d.path.startsWith(prefix)));
         if (matching.length === 0) {
             ctx.scrollback.push({ kind: 'status', text: `xfer: no documents found under ${positional[0]}`, level: 'info', ts });
@@ -78,7 +78,7 @@ export const xferVerb = {
         }
         let count = 0;
         for (const doc of matching) {
-            await ctx.docs.transferBetweenScopes(srcTenant, doc.shardId, doc.path, dstTenant, dstParsed.shardId, doc.path, moveOpts);
+            await ctx.sh3.docs.transferBetweenScopes(srcTenant, doc.shardId, doc.path, dstTenant, dstParsed.shardId, doc.path, moveOpts);
             count++;
         }
         const verb = copy ? 'copied' : 'moved';

package/dist/shell-shard/verbs/xfer.test.js

@@ -11,13 +11,13 @@ function makeSh3(scope) {
 }
 function makeCtx(docs, sh3) {
     const pushed = [];
+    const composedSh3 = Object.assign(Object.assign({}, (sh3 !== null && sh3 !== void 0 ? sh3 : {})), { docs });
     const ctx = {
-        sh3: sh3 !== null && sh3 !== void 0 ? sh3 : {},
+        sh3: composedSh3,
         scrollback: { push: (e) => pushed.push(e) },
         session: {},
         cwd: '/',
         fs: {},
-        docs,
         dispatch: async () => { },
     };
     return { ctx, pushed };

package/dist/verbs/types.d.ts

@@ -174,6 +174,16 @@ export interface Sh3Api {
         id: string;
         name: string;
     }>;
+    /**
+     * Tenant-wide document observation surface for the caller. Present iff
+     * the caller's manifest declares `documents:browse`. Read methods
+     * (`readFrom`, …) require `documents:read`; write methods (`writeTo`,
+     * `transferBetweenScopes`, …) require `documents:write`. Verbs that need
+     * documents — `xfer`, `cat`, `ls`, `mv`, `mkdir`, `rm` — read it from
+     * here so programmatic dispatch (runVerb / pipelines) inherits the
+     * caller's gating.
+     */
+    docs?: BrowseCapability;
 }
 export type { DispatchToTerminalResult } from '../shell-shard/dispatch-to-terminal';
 export interface VerbContext {
@@ -182,8 +192,6 @@ export interface VerbContext {
     session: SessionClient;
     cwd: string;
     fs: TenantFsClient;
-    /** Document zone browse capability. Present when shell-shard has documents:browse permission. */
-    docs?: BrowseCapability;
     /** Invoke another registered verb programmatically (used by rich-entry clicks). */
     dispatch(line: string): Promise<void>;
     /**

package/dist/version.d.ts

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

package/dist/version.js

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

package/package.json

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