sh3-core 0.20.1 → 0.20.2

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

@@ -0,0 +1,96 @@
+import { describe, it, expect, vi } from 'vitest';
+import { xferVerb } from './xfer';
+function makeDocs(overrides = {}) {
+    return Object.assign({ listDocuments: vi.fn(async () => []), listShards: vi.fn(async () => []), watchDocuments: vi.fn(() => () => { }), transferToScope: vi.fn(async () => { }) }, overrides);
+}
+function makeSh3(scope) {
+    return {
+        getActiveScope: () => scope,
+        listProjects: () => [],
+    };
+}
+function makeCtx(docs, sh3) {
+    const pushed = [];
+    const ctx = {
+        sh3: sh3 !== null && sh3 !== void 0 ? sh3 : {},
+        scrollback: { push: (e) => pushed.push(e) },
+        session: {},
+        cwd: '/',
+        fs: {},
+        docs,
+        dispatch: async () => { },
+    };
+    return { ctx, pushed };
+}
+const projectScope = { id: 'proj-abc', isProject: true, personalId: 'user-me' };
+const personalScope = { id: 'user-me', isProject: false, personalId: 'user-me' };
+describe('xfer verb', () => {
+    it('emits error when docs capability missing', async () => {
+        const sh3 = makeSh3(projectScope);
+        const { ctx, pushed } = makeCtx(undefined, sh3);
+        await xferVerb.run(ctx, ['@project-proj-abc:notes/draft.md', '@me:notes/draft.md']);
+        const err = pushed.find((e) => e.kind === 'status' && e.level === 'error');
+        expect(err).toBeDefined();
+    });
+    it('emits error when active scope is not a project', async () => {
+        const sh3 = makeSh3(personalScope);
+        const { ctx, pushed } = makeCtx(makeDocs(), sh3);
+        await xferVerb.run(ctx, ['notes/draft.md', '@me:notes/draft.md']);
+        const err = pushed.find((e) => e.kind === 'status' && e.level === 'error');
+        expect(err).toBeDefined();
+        expect(err.text).toMatch(/project/i);
+    });
+    it('emits usage error when fewer than two args', async () => {
+        const sh3 = makeSh3(projectScope);
+        const { ctx, pushed } = makeCtx(makeDocs(), sh3);
+        await xferVerb.run(ctx, ['notes/draft.md']);
+        const err = pushed.find((e) => e.kind === 'status' && e.level === 'error');
+        expect(err.text).toMatch(/usage/i);
+    });
+    it('moves (default) a doc from project to personal scope', async () => {
+        const transferToScope = vi.fn(async () => { });
+        const docs = makeDocs({ transferToScope });
+        const sh3 = makeSh3(projectScope);
+        const { ctx, pushed } = makeCtx(docs, sh3);
+        await xferVerb.run(ctx, ['@project-proj-abc:notes/draft.md', '@me:notes/draft.md']);
+        expect(transferToScope).toHaveBeenCalledWith('notes', 'draft.md', 'user-me', expect.objectContaining({ delete: true }));
+        const ok = pushed.find((e) => e.kind === 'status' && e.level === 'info');
+        expect(ok).toBeDefined();
+    });
+    it('-C flag copies without deleting source', async () => {
+        const transferToScope = vi.fn(async () => { });
+        const docs = makeDocs({ transferToScope });
+        const sh3 = makeSh3(projectScope);
+        const { ctx } = makeCtx(docs, sh3);
+        await xferVerb.run(ctx, ['-C', '@project-proj-abc:notes/draft.md', '@me:notes/draft.md']);
+        expect(transferToScope).toHaveBeenCalledWith('notes', 'draft.md', 'user-me', expect.objectContaining({ delete: false }));
+    });
+    it('rejects when src scope is not the active project (v1 limitation)', async () => {
+        const transferToScope = vi.fn(async () => { });
+        const docs = makeDocs({ transferToScope });
+        const sh3 = makeSh3(projectScope);
+        const { ctx, pushed } = makeCtx(docs, sh3);
+        // @me src while project is active → src tenant differs from active
+        await xferVerb.run(ctx, ['@me:notes/draft.md', '@project-proj-abc:notes/draft.md']);
+        expect(transferToScope).not.toHaveBeenCalled();
+        const err = pushed.find((e) => e.kind === 'status' && e.level === 'error');
+        expect(err).toBeDefined();
+    });
+    it('-R flag recurses over all docs matching src prefix', async () => {
+        const transferToScope = vi.fn(async () => { });
+        const allDocs = [
+            { shardId: 'notes', path: 'ideas/a.md', size: 1, lastModified: 0 },
+            { shardId: 'notes', path: 'ideas/b.md', size: 1, lastModified: 0 },
+            { shardId: 'notes', path: 'other.md', size: 1, lastModified: 0 },
+        ];
+        const docs = makeDocs({
+            transferToScope,
+            listDocuments: vi.fn(async () => allDocs),
+        });
+        const sh3 = makeSh3(projectScope);
+        const { ctx } = makeCtx(docs, sh3);
+        await xferVerb.run(ctx, ['-R', '@project-proj-abc:notes/ideas', '@me:notes/ideas']);
+        // Only the two docs under ideas/ should be transferred
+        expect(transferToScope).toHaveBeenCalledTimes(2);
+    });
+});

package/dist/verbs/types.d.ts

@@ -5,6 +5,7 @@ import type { TreeRootRef } from '../layout/types';
 import type { DispatchToTerminalResult } from '../shell-shard/dispatch-to-terminal';
 import type { ActionDescriptor } from '../actions/types';
 import type { FieldsApi } from '../fields/types';
+import type { BrowseCapability } from '../documents/browse';
 export interface Sh3Api {
     listApps(): Array<{
         id: string;
@@ -158,6 +159,21 @@ export interface Sh3Api {
      * Controllable-field surface — see fields/types.ts:FieldsApi for shape.
      */
     fields: FieldsApi;
+    /**
+     * Active scope identity. `id` is the current tenant (project or personal).
+     * `personalId` is always the user's base tenant regardless of active project.
+     * `isProject` is true when a project scope is currently active.
+     */
+    getActiveScope(): {
+        id: string;
+        isProject: boolean;
+        personalId: string;
+    };
+    /** List projects visible to the current user. */
+    listProjects(): Array<{
+        id: string;
+        name: string;
+    }>;
 }
 export type { DispatchToTerminalResult } from '../shell-shard/dispatch-to-terminal';
 export interface VerbContext {
@@ -166,6 +182,8 @@ 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.20.1";
+export declare const VERSION = "0.20.2";

package/dist/version.js

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

package/package.json

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