@skrr-ai/cli 0.1.92 → 0.1.94

package/dist/commands/open.d.ts

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../base-command';
+/**
+ * Open a Skrr web page in the browser: a URL someone sent you, a site path, or
+ * a typed reference such as `space:<id>` or `listing:<agentId>`.
+ *
+ * Not signed-in on purpose: a link is an address, not a permission — the page
+ * itself decides what the viewer sees. The one API read it can make is the
+ * anonymous share-code resolve, for an app-scheme link that names nothing but
+ * a code.
+ * Like every `<entity> open`, a non-interactive shell (a pipe, a script, an
+ * agent) gets the URL printed instead of a browser it cannot see.
+ */
+export default class Open extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        target: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        print: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/open.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../base-command");
+const entity_open_1 = require("../lib/entity-open");
+const open_target_1 = require("../lib/open-target");
+/**
+ * Open a Skrr web page in the browser: a URL someone sent you, a site path, or
+ * a typed reference such as `space:<id>` or `listing:<agentId>`.
+ *
+ * Not signed-in on purpose: a link is an address, not a permission — the page
+ * itself decides what the viewer sees. The one API read it can make is the
+ * anonymous share-code resolve, for an app-scheme link that names nothing but
+ * a code.
+ * Like every `<entity> open`, a non-interactive shell (a pipe, a script, an
+ * agent) gets the URL printed instead of a browser it cannot see.
+ */
+class Open extends base_command_1.BaseCommand {
+    static description = `Open a ${data_provider_1.BRAND.displayName} URL, site path or <kind>:<id> reference in the browser (--print to only print the URL)`;
+    static examples = [
+        '<%= config.bin %> open https://skrr.ai/a/agent_abc123',
+        '<%= config.bin %> open listing:agent_abc123',
+        '<%= config.bin %> open skrr://agent/agent_abc123',
+        '<%= config.bin %> open space:sp_123 --print',
+        '<%= config.bin %> open /spaces/sp_123/tasks --json',
+    ];
+    static args = {
+        target: core_1.Args.string({
+            required: true,
+            ignoreStdin: true,
+            description: `A ${data_provider_1.BRAND.displayName} URL, a site path (/…), <kind>:<id> (${open_target_1.OPEN_REF_KINDS.join(', ')}), or an agent id or skrr:// link (opens its listing)`,
+        }),
+    };
+    static flags = {
+        print: core_1.Flags.boolean({ char: 'p', description: 'Print the URL without opening a browser' }),
+        json: core_1.Flags.boolean({ description: 'Print {url, form, opened} as JSON without opening' }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(Open);
+        let resolved;
+        try {
+            resolved = await (0, open_target_1.resolveOpenTarget)(args.target, this.cliConfig.baseURL);
+        }
+        catch (err) {
+            if (err instanceof open_target_1.OpenTargetError) {
+                this.failWithCliError({ message: err.message, code: err.code, exit: 1, retryable: false });
+            }
+            throw err;
+        }
+        const launch = !flags.print && !flags.json && Boolean(process.stdout.isTTY);
+        if (launch) {
+            try {
+                await (0, entity_open_1.launchEntityUrl)(resolved.url, 'web');
+            }
+            catch (err) {
+                // Say what failed and still hand over the URL — the person can open it.
+                this.failWithCliError({
+                    message: `Could not open a browser (${err.message}). The URL: ${resolved.url}`,
+                    code: 'OPEN_BROWSER_FAILED',
+                    exit: 1,
+                    retryable: true,
+                    details: { url: resolved.url },
+                });
+            }
+        }
+        if (flags.json) {
+            this.log(JSON.stringify({ ...resolved, opened: launch }, null, 2));
+            return;
+        }
+        this.log(launch ? `Opened browser: ${resolved.url}` : resolved.url);
+    }
+}
+exports.default = Open;

package/dist/commands/projects/archive.d.ts

@@ -14,6 +14,7 @@ export default class ProjectsArchive extends BaseCommand {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         unarchive: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/projects/archive.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
+const dry_run_plans_1 = require("../../lib/dry-run-plans");
 /**
  * Same verb shape as `goals archive` — one command, `--unarchive` to restore.
  * Archive rides the DELETE route (which archives by default); unarchive is a
@@ -13,6 +14,7 @@ class ProjectsArchive extends base_command_1.BaseCommand {
     static examples = [
         '<%= config.bin %> projects archive <project-id> --space <space>',
         '<%= config.bin %> projects archive <project-id> --space <space> --unarchive',
+        '<%= config.bin %> projects archive <project-id> --space <space> --dry-run --json',
     ];
     static args = {
         id: core_1.Args.string({
@@ -27,11 +29,32 @@ class ProjectsArchive extends base_command_1.BaseCommand {
             description: 'Owning space — id, ref, or name. Needed only for a bare ref (OSK-P-12); an id or a qualified ref `<space>/<project>` resolves on its own.',
         }),
         unarchive: core_1.Flags.boolean({ description: 'Unarchive the project instead of archiving it' }),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Read the project and print what would change without changing it',
+        }),
     };
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(ProjectsArchive);
         const { projectRef, spaceId } = await this.resolveProjectReference(args.id, flags.space);
+        if (flags['dry-run']) {
+            let project;
+            try {
+                project = (await data_provider_1.dataService.getSpaceProject(spaceId, projectRef));
+            }
+            catch (err) {
+                this.handleApiError(err, { subject: `project ${projectRef}` });
+            }
+            const plan = (0, dry_run_plans_1.planProjectChange)(flags.unarchive ? 'unarchive' : 'archive', project, projectRef);
+            if (flags.json)
+                this.log(JSON.stringify(plan, null, 2));
+            else {
+                this.log(`Dry run: would ${plan.action} project ${projectRef}. Nothing was changed.`);
+                for (const note of plan.notes)
+                    this.log(`Note: ${note}`);
+            }
+            return;
+        }
         let result;
         try {
             result = flags.unarchive

package/dist/commands/projects/delete.d.ts

@@ -13,6 +13,7 @@ export default class ProjectsDelete extends BaseCommand {
     static flags: {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'dry-run': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;

package/dist/commands/projects/delete.js

@@ -4,6 +4,7 @@ const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const prompt_1 = require("../../lib/prompt");
+const dry_run_plans_1 = require("../../lib/dry-run-plans");
 /**
  * Hard delete (`?mode=delete`): removes the project and detaches member
  * tasks/goals (invariant P3 — never cascades into the work itself). The
@@ -14,6 +15,7 @@ class ProjectsDelete extends base_command_1.BaseCommand {
     static examples = [
         '<%= config.bin %> projects delete <project-id> --space <space>',
         '<%= config.bin %> projects delete <project-id> --space <space> --yes',
+        '<%= config.bin %> projects delete <project-id> --space <space> --dry-run --json',
     ];
     static args = {
         id: core_1.Args.string({
@@ -27,6 +29,9 @@ class ProjectsDelete extends base_command_1.BaseCommand {
         space: core_1.Flags.string({
             description: 'Owning space — id, ref, or name. Needed only for a bare ref (OSK-P-12); an id or a qualified ref `<space>/<project>` resolves on its own.',
         }),
+        'dry-run': core_1.Flags.boolean({
+            description: 'Read the project and print what a delete would remove and detach, without deleting or prompting',
+        }),
         yes: core_1.Flags.boolean({
             char: 'y',
             aliases: ['force'],
@@ -37,6 +42,24 @@ class ProjectsDelete extends base_command_1.BaseCommand {
         this.requireAuth();
         const { args, flags } = await this.parse(ProjectsDelete);
         const { projectRef, spaceId } = await this.resolveProjectReference(args.id, flags.space);
+        if (flags['dry-run']) {
+            let project;
+            try {
+                project = (await data_provider_1.dataService.getSpaceProject(spaceId, projectRef));
+            }
+            catch (err) {
+                this.handleApiError(err, { subject: `project ${projectRef}` });
+            }
+            const plan = (0, dry_run_plans_1.planProjectChange)('delete', project, projectRef);
+            if (flags.json)
+                this.log(JSON.stringify(plan, null, 2));
+            else {
+                const detached = plan.changes
+                    .detachedTasksEstimate;
+                this.log(`Dry run: would permanently delete project ${projectRef} and detach ${detached ?? 'its'} task(s). Nothing was changed.`);
+            }
+            return;
+        }
         let confirmed;
         try {
             confirmed = await (0, prompt_1.confirmDestructive)(`Delete project ${projectRef}? Member tasks and goals are detached, not deleted. This cannot be undone.`, flags.yes);

package/dist/commands/projects/list.d.ts

@@ -16,6 +16,9 @@ export default class ProjectsList extends BaseCommand {
         space: import("@oclif/core/lib/interfaces").Arg<string | undefined, Record<string, unknown>>;
     };
     static flags: {
+        fields: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        compact: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        ndjson: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         space: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'include-archived': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;

package/dist/commands/projects/list.js

@@ -5,6 +5,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const space_argument_1 = require("../../lib/space-argument");
 const format_1 = require("../../lib/format");
+const list_output_1 = require("../../lib/list-output");
 const projects_1 = require("../../lib/projects");
 /**
  * `skrr projects list [space]` — the projects in a space, or across every space
@@ -23,6 +24,7 @@ class ProjectsList extends base_command_1.BaseCommand {
         '<%= config.bin %> projects list --q "billing"',
         '<%= config.bin %> projects list <space> --include-archived',
         '<%= config.bin %> projects list --q billing --json',
+        '<%= config.bin %> projects list <space> --compact --json',
     ];
     static args = {
         space: core_1.Args.string({
@@ -41,6 +43,7 @@ class ProjectsList extends base_command_1.BaseCommand {
             description: 'Case-insensitive match on title, description, or ref. Searches every visible space unless one is named.',
         }),
         limit: core_1.Flags.integer({ description: 'Max results when searching (1-200)', default: 50 }),
+        ...list_output_1.listOutputFlags,
     };
     async run() {
         this.requireAuth();
@@ -73,8 +76,15 @@ class ProjectsList extends base_command_1.BaseCommand {
         catch (err) {
             this.handleApiError(err, { subject: spaceId ? `space ${spaceId}` : 'projects' });
         }
-        if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+        if (flags.json || flags.ndjson) {
+            // P3: the in-space list answered a bare `{data}` while the cross-space
+            // search answered a full envelope. One shape for both; `data` stays.
+            this.printList((0, list_output_1.shapeListResponse)(response, {
+                resource: 'project',
+                fields: flags.fields,
+                compact: flags.compact,
+                requestedLimit: crossSpace ? flags.limit : undefined,
+            }), Boolean(flags.ndjson));
             return;
         }
         // Qualify the ref only when rows can come from more than one space —

package/dist/commands/spaces/actions/add.js

@@ -25,6 +25,7 @@ class SpacesActionsAdd extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesActionsAdd);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let body = {};
         try {
             body = await (0, prompt_1.readJsonBody)(flags['from-json']);
@@ -52,7 +53,7 @@ class SpacesActionsAdd extends base_command_1.BaseCommand {
         let result;
         try {
             result = await data_provider_1.dataService.addSpaceCustomAction({
-                spaceId: args.id,
+                spaceId: spaceRef,
                 action: payload,
             });
         }
@@ -65,12 +66,12 @@ class SpacesActionsAdd extends base_command_1.BaseCommand {
         // returns just the action. A create returns the thing it created.
         const stored = (result?.customActions ?? []).find((action) => action.id === payload.id) ?? payload;
         if (flags.json)
-            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, args.id, 'actions', stored, ['id']), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'actions', stored, ['id']), null, 2));
         else
             this.log(`Added custom action ${String(payload.id)}.`);
         // On stderr, so `--json` stays parseable: the action was saved, and still
         // cannot run until the space has a Leader (OSK-9641).
-        const unrunnable = (0, space_custom_actions_1.spaceActionsNotRunnableReason)({ id: args.id, leadAgentId: result?.leadAgentId }, this.config.bin);
+        const unrunnable = (0, space_custom_actions_1.spaceActionsNotRunnableReason)({ id: spaceRef, leadAgentId: result?.leadAgentId }, this.config.bin);
         if (unrunnable)
             this.warn(unrunnable);
     }

package/dist/commands/spaces/actions/available.js

@@ -25,9 +25,10 @@ class SpacesActionsAvailable extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesActionsAvailable);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let response;
         try {
-            response = await data_provider_1.dataService.listSpaceAvailableActions(args.id);
+            response = await data_provider_1.dataService.listSpaceAvailableActions(spaceRef);
         }
         catch (err) {
             this.handleApiError(err);
@@ -54,7 +55,7 @@ class SpacesActionsAvailable extends base_command_1.BaseCommand {
         // The REF is for two commands, and they need different rights: attaching
         // works for any space member, running needs VIEW on the agent (OSK-9663).
         this.log('Attach to a task: skrr tasks actions attach <task-id> <agentId>:<actionId>');
-        this.log(`Run one in this space: skrr spaces actions run ${args.id} <agentId>:<actionId> (needs access to the agent; see what you can run with: skrr spaces actions list ${args.id} --all)`);
+        this.log(`Run one in this space: skrr spaces actions run ${spaceRef} <agentId>:<actionId> (needs access to the agent; see what you can run with: skrr spaces actions list ${spaceRef} --all)`);
     }
 }
 exports.default = SpacesActionsAvailable;

package/dist/commands/spaces/actions/list.js

@@ -24,9 +24,10 @@ class SpacesActionsList extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesActionsList);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let space;
         try {
-            space = await data_provider_1.dataService.getSpace(args.id);
+            space = await data_provider_1.dataService.getSpace(spaceRef);
         }
         catch (err) {
             this.handleApiError(err);
@@ -35,12 +36,12 @@ class SpacesActionsList extends base_command_1.BaseCommand {
         if (flags.all)
             return this.listAll(space, flags.json);
         if (flags.json)
-            return void this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, args.id, 'actions', { data: actions }, [
+            return void this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'actions', { data: actions }, [
                 'id',
             ]), null, 2));
         if (!actions.length) {
             this.log('No custom actions.');
-            this.log(`Agent actions offered here: ${this.config.bin} spaces actions list ${args.id} --all`);
+            this.log(`Agent actions offered here: ${this.config.bin} spaces actions list ${spaceRef} --all`);
             return;
         }
         (0, format_1.renderTable)(actions.map((a) => ({
@@ -57,7 +58,7 @@ class SpacesActionsList extends base_command_1.BaseCommand {
             { key: 'id', header: 'ID' },
         ], (line) => this.log(line));
         this.noteUnrunnable(space);
-        this.log(`Agent actions offered here too: ${this.config.bin} spaces actions list ${args.id} --all`);
+        this.log(`Agent actions offered here too: ${this.config.bin} spaces actions list ${spaceRef} --all`);
     }
     /** Say, on stderr, when none of the listed space actions can run. */
     noteUnrunnable(space) {

package/dist/commands/spaces/actions/replace.js

@@ -24,6 +24,7 @@ class SpacesActionsReplace extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesActionsReplace);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let raw;
         try {
             raw = await (0, prompt_1.readJsonValue)(flags['from-json']);
@@ -37,19 +38,19 @@ class SpacesActionsReplace extends base_command_1.BaseCommand {
         if (flags['dry-run']) {
             const output = {
                 dryRun: true,
-                spaceId: args.id,
+                spaceId: spaceRef,
                 actions,
                 expectedActionIds: flags['expected-id'] ?? [],
             };
             this.log(flags.json
                 ? JSON.stringify(output, null, 2)
-                : `Dry run: would replace custom actions for space ${args.id}.`);
+                : `Dry run: would replace custom actions for space ${spaceRef}.`);
             return;
         }
         let result;
         try {
             result = await data_provider_1.dataService.replaceSpaceCustomActions({
-                spaceId: args.id,
+                spaceId: spaceRef,
                 actions: actions,
                 expectedActionIds: flags['expected-id'],
             });
@@ -58,9 +59,9 @@ class SpacesActionsReplace extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json)
-            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, args.id, 'actions', result, ['id']), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'actions', result, ['id']), null, 2));
         else
-            this.log(`Replaced custom actions for space ${args.id}.`);
+            this.log(`Replaced custom actions for space ${spaceRef}.`);
     }
 }
 exports.default = SpacesActionsReplace;

package/dist/commands/spaces/archive.js

@@ -16,9 +16,10 @@ class SpacesArchive extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesArchive);
+        const spaceId = await this.resolveEntityRef('space', args.id);
         let updated;
         try {
-            updated = await data_provider_1.dataService.archiveSpace(args.id);
+            updated = await data_provider_1.dataService.archiveSpace(spaceId);
         }
         catch (err) {
             this.handleApiError(err);
@@ -28,7 +29,7 @@ class SpacesArchive extends base_command_1.BaseCommand {
             return;
         }
         const s = updated;
-        this.log(`Archived space ${s.id ?? s._id ?? args.id} - ${s.title ?? '(no title)'}`);
+        this.log(`Archived space ${s.id ?? s._id ?? spaceId} - ${s.title ?? '(no title)'}`);
     }
 }
 exports.default = SpacesArchive;

package/dist/commands/spaces/auto-executor/preview.js

@@ -21,15 +21,16 @@ class SpacesAutoExecutorPreview extends base_command_1.BaseCommand {
         // ignored, and raw JSON printed unconditionally. There was no readable
         // rendering of a preview anywhere in the CLI.
         const { args, flags } = await this.parse(SpacesAutoExecutorPreview);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let result;
         try {
-            result = (await data_provider_1.dataService.previewSpaceAutoExecutor(args.id));
+            result = (await data_provider_1.dataService.previewSpaceAutoExecutor(spaceRef));
         }
         catch (err) {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'execution', { result }), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'execution', { result }), null, 2));
             return;
         }
         const { space, plan } = result;
@@ -37,7 +38,7 @@ class SpacesAutoExecutorPreview extends base_command_1.BaseCommand {
             this.log('No plan was returned for this space.');
             return;
         }
-        this.log(`Space:      ${space.title ?? args.id}`);
+        this.log(`Space:      ${space.title ?? spaceRef}`);
         this.log(`Autopilot:  ${space.autoExecuteEnabled ? 'enabled' : 'disabled'}` +
             (space.autoExecuteLifecycleState === 'sleeping'
                 ? ` (sleeping${space.autoExecuteSuspensionReason ? `: ${String(space.autoExecuteSuspensionReason).replace(/_/g, ' ')}` : ''})`

package/dist/commands/spaces/auto-executor/run.js

@@ -13,17 +13,18 @@ class SpacesAutoExecutorRun extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesAutoExecutorRun);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let result;
         try {
-            result = await data_provider_1.dataService.triggerSpaceAutoExecutor(args.id);
+            result = await data_provider_1.dataService.triggerSpaceAutoExecutor(spaceRef);
         }
         catch (err) {
             this.handleApiError(err);
         }
         if (flags.json)
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'execution', { result }), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'execution', { result }), null, 2));
         else
-            this.log(`Triggered auto-executor for space ${args.id}.`);
+            this.log(`Triggered auto-executor for space ${spaceRef}.`);
     }
 }
 exports.default = SpacesAutoExecutorRun;

package/dist/commands/spaces/auto-executor/runs.js

@@ -22,15 +22,16 @@ class SpacesAutoExecutorRuns extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesAutoExecutorRuns);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let result;
         try {
-            result = await data_provider_1.dataService.getSpaceOrchestrationRuns(args.id, flags.limit);
+            result = await data_provider_1.dataService.getSpaceOrchestrationRuns(spaceRef, flags.limit);
         }
         catch (err) {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'execution', { result }), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'execution', { result }), null, 2));
             return;
         }
         this.log(`Orchestration: ${result.enabled ? 'enabled' : 'disabled'}`);

package/dist/commands/spaces/auto-executor/update.js

@@ -57,6 +57,7 @@ class SpacesAutoExecutorUpdate extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesAutoExecutorUpdate);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let body = {};
         try {
             body = await (0, prompt_1.readJsonBody)(flags['from-json']);
@@ -104,7 +105,7 @@ class SpacesAutoExecutorUpdate extends base_command_1.BaseCommand {
         let response;
         try {
             response = await data_provider_1.dataService.updateSpaceAutoExecutor({
-                spaceId: args.id,
+                spaceId: spaceRef,
                 data: payload,
             });
         }
@@ -112,14 +113,14 @@ class SpacesAutoExecutorUpdate extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'execution', response), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'execution', response), null, 2));
             return;
         }
         const space = response?.space ?? {};
         // A stored `0` means unlimited. Printing the raw number told the user the
         // opposite of what the setting does.
         const limit = (value) => typeof value === 'number' ? (0, data_provider_1.formatLimit)(value === 0 ? null : value) : '-';
-        this.log(`Updated auto-executor for ${space.id ?? args.id}`);
+        this.log(`Updated auto-executor for ${space.id ?? spaceRef}`);
         this.log(`Enabled:          ${space.autoExecuteEnabled ? 'yes' : 'no'}`);
         this.log(`Mode:             ${space.autoExecuteMode ?? '-'}`);
         this.log(`Interval:         ${formatIntervalMs(space.autoExecuteIntervalMs)}`);

package/dist/commands/spaces/bootstrap.js

@@ -78,15 +78,16 @@ class SpacesBootstrap extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesBootstrap);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let result;
         try {
-            result = await data_provider_1.dataService.getSpaceBootstrap(args.id);
+            result = await data_provider_1.dataService.getSpaceBootstrap(spaceRef);
         }
         catch (err) {
             this.handleApiError(err);
         }
         const output = result && typeof result === 'object'
-            ? (0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'dashboard', result)
+            ? (0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'dashboard', result)
             : result;
         // `--json` was previously accepted and ignored — every invocation printed
         // JSON. It now selects between the raw payload and the human summary,

package/dist/commands/spaces/briefs/delete.js

@@ -25,9 +25,10 @@ class SpacesBriefsDelete extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesBriefsDelete);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let confirmed;
         try {
-            confirmed = await (0, prompt_1.confirmDestructive)(`Delete brief for ${flags.principal} ${flags.id} in space ${args.id}? This cannot be undone.`, flags.yes);
+            confirmed = await (0, prompt_1.confirmDestructive)(`Delete brief for ${flags.principal} ${flags.id} in space ${spaceRef}? This cannot be undone.`, flags.yes);
         }
         catch (err) {
             this.error(err.message, {
@@ -39,7 +40,7 @@ class SpacesBriefsDelete extends base_command_1.BaseCommand {
             return;
         }
         try {
-            await data_provider_1.dataService.deleteSpaceBrief(args.id, flags.principal, flags.id);
+            await data_provider_1.dataService.deleteSpaceBrief(spaceRef, flags.principal, flags.id);
         }
         catch (err) {
             this.handleApiError(err);

package/dist/commands/spaces/briefs/get.js

@@ -26,15 +26,16 @@ class SpacesBriefsGet extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesBriefsGet);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let result;
         try {
-            result = await data_provider_1.dataService.getSpaceBrief(args.id, flags.principal, flags.id);
+            result = await data_provider_1.dataService.getSpaceBrief(spaceRef, flags.principal, flags.id);
         }
         catch (err) {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'members', result), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'members', result), null, 2));
             return;
         }
         const b = result;

package/dist/commands/spaces/briefs/list.js

@@ -20,15 +20,16 @@ class SpacesBriefsList extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesBriefsList);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let response;
         try {
-            response = await data_provider_1.dataService.listSpaceBriefs(args.id);
+            response = await data_provider_1.dataService.listSpaceBriefs(spaceRef);
         }
         catch (err) {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'members', { data: response }), null, 2));
+            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'members', { data: response }), null, 2));
             return;
         }
         const items = Array.isArray(response) ? response : [];