@skrr-ai/cli 0.1.109 → 0.1.111

package/dist/commands/messages/list.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveConvoId = resolveConvoId;
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
@@ -106,7 +107,7 @@ class MessagesList extends base_command_1.BaseCommand {
         if (flags.json) {
             // Bare array, unchanged: `messages list --json | jq '.[0]'` is an
             // established contract. Truncation only happens when the caller asked for it.
-            this.log(JSON.stringify(selected, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(selected));
             return;
         }
         if (selected.length === 0) {

package/dist/commands/northstars/intents/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../../base-command");
 const northstars_1 = require("../../../lib/northstars");
@@ -43,7 +44,7 @@ class NorthstarsIntentsList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(response));
             return;
         }
         (0, northstars_1.renderIntentList)(response.data ?? [], (line) => this.log(line));

package/dist/commands/northstars/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../base-command");
 const northstars_1 = require("../../lib/northstars");
@@ -33,7 +34,7 @@ class NorthstarsList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(response));
             return;
         }
         (0, northstars_1.renderNorthstarList)(response.data ?? [], (line) => this.log(line));

package/dist/commands/northstars/recommendations/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../../base-command");
 const northstars_1 = require("../../../lib/northstars");
@@ -41,7 +42,7 @@ class NorthstarsRecommendationsList extends base_command_1.BaseCommand {
         const all = status.northstar.recommendations ?? [];
         const rows = flags.status ? all.filter((rec) => (rec.status ?? 'open') === flags.status) : all;
         if (flags.json) {
-            this.log(JSON.stringify({ object: 'list', data: rows }, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)({ object: 'list', data: rows }));
             return;
         }
         (0, northstars_1.renderRecommendationList)(rows, (line) => this.log(line));

package/dist/commands/outbox/list.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.queuedBecause = queuedBecause;
 exports.outboxListSnapshot = outboxListSnapshot;
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../base-command");
 const keychain_1 = require("../../lib/keychain");
@@ -55,7 +56,7 @@ class OutboxList extends base_command_1.BaseCommand {
         const profile = (0, keychain_1.getActiveProfile)();
         const { queued: entries, incident, incidentActive } = outboxListSnapshot(profile);
         if (flags.json) {
-            this.log(JSON.stringify({ queued: entries, incident, incidentActive }, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)({ queued: entries, incident, incidentActive }, 'queued'));
             return;
         }
         if (incident && incidentActive) {

package/dist/commands/profiles/list.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
 const core_1 = require("@oclif/core");
@@ -78,7 +79,7 @@ class ProfilesList extends base_command_1.BaseCommand {
             // No `profiles/` directory means no named profiles — not an error.
         }
         if (flags.json) {
-            this.log(JSON.stringify({ root, active, profiles: rows }, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)({ root, active, profiles: rows }, 'profiles'));
             return;
         }
         // Width from the DATA, so a long profile name cannot run into the next

package/dist/commands/projects/docs/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -45,7 +46,13 @@ class ProjectsDocsList extends base_command_1.BaseCommand {
             this.handleApiError(err, { subject: `project ${projectRef}` });
         }
         if (flags.json) {
-            this.log(JSON.stringify(result, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)({
+                ...result,
+                data: [
+                    ...result.pages.map((page) => ({ ...page, kind: 'page' })),
+                    ...result.files.map((file) => ({ ...file, kind: 'file' })),
+                ],
+            }));
             return;
         }
         const rows = (0, projects_1.toProjectDocRows)(result);

package/dist/commands/projects/updates/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -32,7 +33,7 @@ class ProjectsUpdatesList extends base_command_1.BaseCommand {
             this.handleApiError(error, { subject: `project ${projectRef}` });
         }
         if (flags.json)
-            return this.log(JSON.stringify(updates, null, 2));
+            return this.printJsonResult((0, list_output_1.listResult)(updates));
         if (!updates.data.length)
             return this.log('No project updates.');
         (0, format_1.renderTable)(updates.data.map((update) => ({

package/dist/commands/proposals/list.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.emptyPageLines = emptyPageLines;
 exports.aboutFor = aboutFor;
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
@@ -75,7 +76,7 @@ class ProposalsList extends base_command_1.BaseCommand {
             this.handleApiError(error);
         }
         if (flags.json) {
-            this.log(JSON.stringify(result, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(result));
             return;
         }
         if (!result.data.length) {

package/dist/commands/requests/comments/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -30,7 +31,7 @@ class RequestsCommentsList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(response));
             return;
         }
         const r = response;

package/dist/commands/requests/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
@@ -32,7 +33,7 @@ class RequestsList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(response));
             return;
         }
         const r = response;

package/dist/commands/shares/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
@@ -45,7 +46,7 @@ class SharesList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(response, 'links'));
             return;
         }
         const links = response.links ?? [];

package/dist/commands/shortcuts/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
@@ -25,7 +26,7 @@ class ShortcutsList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(response));
             return;
         }
         const items = response?.data ?? [];

package/dist/commands/signals/monitors/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const signal_command_1 = require("../../../signal-command");
 const signals_1 = require("../../../lib/signals");
@@ -10,7 +11,7 @@ class MonitorsList extends signal_command_1.SignalCommand {
         this.requireAuth();
         await this.parse(MonitorsList);
         const result = await signals_1.signalsApi.listMonitors();
-        this.log(JSON.stringify(result, null, 2));
+        this.printJsonResult((0, list_output_1.listResult)(result, 'monitors'));
     }
 }
 exports.default = MonitorsList;

package/dist/commands/signals/schemas/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const signal_command_1 = require("../../../signal-command");
 const signals_1 = require("../../../lib/signals");
@@ -10,7 +11,7 @@ class SchemasList extends signal_command_1.SignalCommand {
         this.requireAuth();
         await this.parse(SchemasList);
         const result = await signals_1.signalsApi.listSchemas();
-        this.log(JSON.stringify(result, null, 2));
+        this.printJsonResult((0, list_output_1.listResult)(result, 'schemas'));
     }
 }
 exports.default = SchemasList;

package/dist/commands/signals/sources/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const signal_command_1 = require("../../../signal-command");
 const signals_1 = require("../../../lib/signals");
@@ -10,7 +11,7 @@ class SourcesList extends signal_command_1.SignalCommand {
         this.requireAuth();
         await this.parse(SourcesList);
         const result = await signals_1.signalsApi.listSources();
-        this.log(JSON.stringify(result, null, 2));
+        this.printJsonResult((0, list_output_1.listResult)(result, 'sources'));
     }
 }
 exports.default = SourcesList;

package/dist/commands/space-directory-views/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
@@ -19,7 +20,7 @@ class SpaceDirectoryViewsList extends base_command_1.BaseCommand {
             this.handleApiError(error);
         }
         if (flags.json)
-            return void this.log(JSON.stringify(result, null, 2));
+            return void this.printJsonResult((0, list_output_1.listResult)(result));
         for (const view of result.data)
             this.log(`${view.id}\t${view.scope}\t${view.name}\tv${view.version}`);
     }

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

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -36,9 +37,9 @@ 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, spaceRef, 'actions', { data: actions }, [
+            return void this.printJsonResult((0, list_output_1.listResult)((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 ${spaceRef} --all`);
@@ -76,7 +77,7 @@ class SpacesActionsList extends base_command_1.BaseCommand {
         }
         const rows = (0, space_custom_actions_1.spaceQuickActionRows)(space, members.agents, this.config.bin);
         if (json)
-            return void this.log(JSON.stringify({ spaceId: space.id, data: rows }, null, 2));
+            return void this.printJsonResult((0, list_output_1.listResult)({ spaceId: space.id, data: rows }));
         if (!rows.length)
             return void this.log('This space offers no quick actions.');
         (0, format_1.renderTable)(rows, [

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

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -29,7 +30,7 @@ class SpacesBriefsList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'members', { data: response }), null, 2));
+            this.printJsonResult((0, list_output_1.listResult)((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'members', { data: response })));
             return;
         }
         const items = Array.isArray(response) ? response : [];

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

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -31,7 +32,7 @@ class SpacesCyclesList extends base_command_1.BaseCommand {
             return;
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, web_url_1.withSpaceUrl)(this.cliConfig.baseURL, { id: spaceRef, ...result }), null, 2));
+            this.printJsonResult((0, list_output_1.listResult)((0, web_url_1.withSpaceUrl)(this.cliConfig.baseURL, { id: spaceRef, ...result })));
             return;
         }
         if (result.data.length === 0) {

package/dist/commands/spaces/files/folders/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../../base-command");
@@ -23,7 +24,7 @@ class SpacesFilesFoldersList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json)
-            return void this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'files', response, ['folder_id']), null, 2));
+            return void this.printJsonResult((0, list_output_1.listResult)((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'files', response, ['folder_id'])));
         if (!response.data.length)
             return void this.log('No folders.');
         (0, format_1.renderTable)(response.data.map((f) => ({

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

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -29,10 +30,10 @@ class SpacesFilesList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'files', response, [
+            this.printJsonResult((0, list_output_1.listResult)((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'files', response, [
                 'file_id',
                 'folder_id',
-            ]), null, 2));
+            ])));
             return;
         }
         const items = response.data ?? [];

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.heartbeatRow = heartbeatRow;
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -60,11 +61,11 @@ class SpacesHeartbeatsList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'schedule', response, [
+            this.printJsonResult((0, list_output_1.listResult)((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'schedule', response, [
                 'agentId',
                 'id',
                 '_id',
-            ]), null, 2));
+            ])));
             return;
         }
         // Response may be a bare array or wrapped in { data: [...] }.

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

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -30,7 +31,7 @@ class SpacesLabelsList extends base_command_1.BaseCommand {
         const labelIds = space.labelIds ?? [];
         if (labelIds.length === 0) {
             if (flags.json) {
-                this.log(JSON.stringify({ data: [] }, null, 2));
+                this.printJsonResult((0, list_output_1.listResult)({ data: [] }));
                 return;
             }
             this.log('No labels on this space.');
@@ -48,7 +49,7 @@ class SpacesLabelsList extends base_command_1.BaseCommand {
             }
         }));
         if (flags.json) {
-            this.log(JSON.stringify({ data: hydrated }, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)({ data: hydrated }));
             return;
         }
         const rows = hydrated.map((l) => {

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

@@ -1,22 +1,6 @@
 import { BaseCommand } from '../../base-command';
-/**
- * What an empty `--q` result is allowed to claim.
- *
- * `No spaces matching "space scratch".` is a confident assertion that nothing
- * matched, and for the sense a person means it is FALSE: both words are in the
- * title of a space they own and created a minute earlier. The server ORs one
- * escaped regex built from the whole query across title/description/identifier,
- * so the query is a substring and word order is load-bearing — a fact the
- * message hid, leaving "it does not exist" as the only available reading.
- *
- * So the message reports what was actually run and hands back the two moves
- * that recover: shorten to one distinctive word, or list everything. It says
- * "matched" (what this query did) rather than "matching" (what exists).
- *
- * Pure and exported so the wording is testable without an oclif runtime — the
- * convention `describeResourceNotFound` follows in `base-command`.
- */
-export declare function noSpacesMatchedMessage(q: string, bin?: string): string;
+/** Empty search results describe the predicate, without asserting absence. */
+export declare function noSpacesMatchedMessage(q: string, bin?: string, mode?: string): string;
 /**
  * What the unfiltered zero-row case is allowed to say.
  *
@@ -42,6 +26,7 @@ export default class SpacesList extends BaseCommand {
         label: import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         'include-archived': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         q: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        match: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         limit: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
         cursor: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };

package/dist/commands/spaces/list.js

@@ -8,27 +8,15 @@ const base_command_1 = require("../../base-command");
 const web_url_1 = require("../../lib/web-url");
 const format_1 = require("../../lib/format");
 const list_output_1 = require("../../lib/list-output");
-/**
- * What an empty `--q` result is allowed to claim.
- *
- * `No spaces matching "space scratch".` is a confident assertion that nothing
- * matched, and for the sense a person means it is FALSE: both words are in the
- * title of a space they own and created a minute earlier. The server ORs one
- * escaped regex built from the whole query across title/description/identifier,
- * so the query is a substring and word order is load-bearing — a fact the
- * message hid, leaving "it does not exist" as the only available reading.
- *
- * So the message reports what was actually run and hands back the two moves
- * that recover: shorten to one distinctive word, or list everything. It says
- * "matched" (what this query did) rather than "matching" (what exists).
- *
- * Pure and exported so the wording is testable without an oclif runtime — the
- * convention `describeResourceNotFound` follows in `base-command`.
- */
-function noSpacesMatchedMessage(q, bin = 'skrr') {
+/** Empty search results describe the predicate, without asserting absence. */
+function noSpacesMatchedMessage(q, bin = 'skrr', mode = 'fuzzy') {
+    const explanation = mode === 'exact'
+        ? 'Exact matches require whole-field equality (case-insensitive).'
+        : mode === 'phrase'
+            ? 'Phrase matches use a literal case-insensitive substring; word order matters.'
+            : 'Fuzzy discovery can use tokenized, typo-tolerant search or a substring fallback.';
     return (`No spaces matched ${JSON.stringify(q)}.\n` +
-        '  → `--q` is a case-insensitive SUBSTRING match over title, description and identifier, ' +
-        'not a tokenized search, so word order matters.\n' +
+        `  → ${explanation} Fields: title, description and identifier.\n` +
         `  → retry with one distinctive word, or list them all with \`${bin} spaces list\`.`);
 }
 /**
@@ -54,7 +42,8 @@ class SpacesList extends base_command_1.BaseCommand {
         '<%= config.bin %> spaces list --status in_progress',
         '<%= config.bin %> spaces list --label <label-id>',
         '<%= config.bin %> spaces list --label <label-a> --label <label-b>',
-        '<%= config.bin %> spaces list --q "always on"',
+        '<%= config.bin %> spaces list --q "always on" --match phrase',
+        '<%= config.bin %> spaces list --q "My workspace" --match exact --json',
         '<%= config.bin %> spaces list --include-archived --json',
         '<%= config.bin %> spaces list --compact --json',
         '<%= config.bin %> spaces list --fields id,identifier,title --ndjson',
@@ -75,18 +64,13 @@ class SpacesList extends base_command_1.BaseCommand {
         }),
         'include-archived': core_1.Flags.boolean({ description: 'Include archived spaces' }),
         q: core_1.Flags.string({
-            // NOT "free-text search". The server ORs ONE escaped regex built from the
-            // whole string across title/description/identifier
-            // (`api/models/Space.js` → `listSpaces`), so `--q` is a `LIKE %q%`.
-            // "Free-text search" made a promise the floor does not keep: it reads as
-            // "type the words you remember, in any order", and `--q "space scratch"`
-            // then answers "no spaces" for a space titled "… scratch space".
-            //
-            // A Meilisearch-backed deployment narrows through the index instead and
-            // IS tokenized and typo-tolerant — but the CLI cannot tell which path ran,
-            // so the help describes the guaranteed floor rather than the better case.
-            description: 'Match title, description, or identifier (case-insensitive). Substring, not tokenized — ' +
-                'word order matters, so prefer one distinctive word.',
+            description: 'Search title, description, or identifier. Default fuzzy discovery may tokenize and tolerate typos; ' +
+                'use --match phrase for a literal substring or --match exact for whole-field equality. Maximum 200 characters.',
+        }),
+        match: core_1.Flags.string({
+            description: 'Matching policy: fuzzy discovery, literal phrase substring, or exact whole-field equality (case-insensitive).',
+            options: ['fuzzy', 'phrase', 'exact'],
+            dependsOn: ['q'],
         }),
         limit: core_1.Flags.integer({ description: 'Max results', default: 50 }),
         cursor: core_1.Flags.string({ description: 'Pagination cursor from a previous page' }),
@@ -100,7 +84,7 @@ class SpacesList extends base_command_1.BaseCommand {
             response = await data_provider_1.dataService.listSpaces({
                 ...(flags.status ? { status: flags.status } : {}),
                 ...(flags.label?.length ? { labelIds: flags.label } : {}),
-                ...(flags.q ? { q: flags.q } : {}),
+                ...(flags.q ? { q: flags.q, ...(flags.match ? { match: flags.match } : {}) } : {}),
                 includeArchived: flags['include-archived'],
                 limit: flags.limit,
                 cursor: flags.cursor,
@@ -109,6 +93,9 @@ class SpacesList extends base_command_1.BaseCommand {
         catch (err) {
             this.handleApiError(err);
         }
+        if (flags.match && response?.search?.mode !== flags.match) {
+            this.error('The server did not confirm the requested matching policy. Upgrade the server before relying on this result.');
+        }
         if (flags.json || flags.ndjson) {
             this.printList((0, list_output_1.shapeListResponse)((0, web_url_1.withDataUrls)(this.cliConfig.baseURL, response, web_url_1.spaceUrlFrom), {
                 resource: 'space',
@@ -120,9 +107,15 @@ class SpacesList extends base_command_1.BaseCommand {
         }
         const r = response;
         const items = r?.data ?? [];
+        if (r?.search) {
+            this.log(`Search: ${r.search.mode}; ${r.search.semantics}; backend=${r.search.backend}.`);
+            if (r.search.candidates_may_be_truncated) {
+                this.log('Fuzzy index candidates may be truncated. Use --match phrase or --match exact for reliable absence checks.');
+            }
+        }
         if (items.length === 0) {
             this.log(flags.q
-                ? noSpacesMatchedMessage(flags.q, this.config.bin)
+                ? noSpacesMatchedMessage(flags.q, this.config.bin, r?.search?.mode ?? 'fuzzy')
                 : noSpacesEmptyMessage(this.config.bin));
             return;
         }

package/dist/commands/spaces/live/cards/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../../base-command");
@@ -23,7 +24,7 @@ class SpacesLiveCardsList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json)
-            return void this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'live', response, ['id']), null, 2));
+            return void this.printJsonResult((0, list_output_1.listResult)((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'live', response, ['id'])));
         (0, format_1.renderTable)(response.data.map((c) => ({
             id: c.id,
             title: c.title,

package/dist/commands/spaces/members/list.d.ts

@@ -6,6 +6,7 @@ export default class SpacesMembersList extends BaseCommand {
         id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
+        'include-images': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;