@skrr-ai/cli 0.1.120 → 0.1.122

package/dist/commands/search/tasks.js

@@ -2,10 +2,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.taskSearchRow = taskSearchRow;
 const core_1 = require("@oclif/core");
+const search_query_1 = require("../../lib/search-query");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const format_1 = require("../../lib/format");
 const web_url_1 = require("../../lib/web-url");
+const tasks_1 = require("../../lib/tasks");
+const search_display_1 = require("../../lib/search-display");
 /**
  * One task document → one search-result row.
  *
@@ -19,57 +22,114 @@ const web_url_1 = require("../../lib/web-url");
  */
 function taskSearchRow(t) {
     return {
-        ref: (0, format_1.formatCell)(t.identifier ?? (t.taskNumber ? `#${t.taskNumber}` : undefined)),
-        title: (0, format_1.formatCell)(t.title),
-        status: (0, format_1.formatCell)(t.status),
-        priority: (0, format_1.formatCell)(t.priority),
+        ref: (0, search_display_1.searchDisplayText)((0, format_1.formatCell)(t.identifier ?? (t.taskNumber ? `#${t.taskNumber}` : undefined))),
+        title: (0, search_display_1.searchDisplayText)((0, format_1.formatCell)(t.title)),
+        status: (0, search_display_1.searchDisplayText)((0, format_1.formatCell)(t.status)),
+        priority: (0, search_display_1.searchDisplayText)((0, format_1.formatCell)(t.priority)),
         // Why this row matched — ref / title / description / comment. The search
         // covers descriptions and comment bodies, so without it a hit whose title
         // has nothing to do with the query reads like a broken search.
-        match: (0, format_1.formatCell)(t._matchField),
-        id: (0, format_1.formatCell)(t.id ?? t._id),
+        match: (0, search_display_1.searchDisplayText)((0, format_1.formatCell)(t._matchField)),
+        id: (0, search_display_1.searchDisplayText)((0, format_1.formatCell)(t.id ?? t._id)),
     };
 }
 class SearchTasks extends base_command_1.BaseCommand {
-    static description = 'Search your tasks by title, ref, description, or comment text';
+    static description = 'Search visible tasks by title, ref, or description';
     static examples = [
+        '<%= config.bin %> tasks search "login bug"',
+        '<%= config.bin %> tasks search login --status backlog --status review --priority high',
         '<%= config.bin %> search tasks --query "login bug"',
         '<%= config.bin %> search tasks --query watcher --status backlog',
         '<%= config.bin %> search tasks --query "cloud coding" --space "Dogfood Lab" --json',
     ];
+    static args = { query: core_1.Args.string({ description: 'Search term', ignoreStdin: true }) };
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
-        query: core_1.Flags.string({ char: 'q', description: 'Search query', required: true }),
+        query: core_1.Flags.string({ char: 'q', description: 'Search query' }),
         // Resolved by name via the BaseCommand parse hook, so `--space "Dogfood
         // Lab"` works here exactly as it does on `tasks list`.
         space: core_1.Flags.string({ description: 'Restrict to one space (id or title)' }),
-        status: core_1.Flags.string({ description: 'Filter by task status' }),
+        goal: core_1.Flags.string({ description: 'Filter by goal ID' }),
+        project: core_1.Flags.string({ description: 'Filter by project ID' }),
+        status: core_1.Flags.string({ description: 'Filter by task status (repeatable, OR)', multiple: true }),
+        'status-type': core_1.Flags.string({
+            description: 'Filter by workflow type (repeatable, OR)',
+            options: ['backlog', 'unstarted', 'started', 'review', 'completed', 'cancelled', 'triage', 'failed', 'blocked', 'hidden'],
+            multiple: true,
+        }),
+        open: core_1.Flags.boolean({ description: 'Only open workflow types', exclusive: ['status-type', 'status'] }),
+        priority: core_1.Flags.string({ description: 'Filter by task priority', options: [...tasks_1.TASK_PRIORITIES] }),
+        tag: core_1.Flags.string({ description: 'Filter by tag (repeatable, AND)', multiple: true }),
+        'label-id': core_1.Flags.string({ description: 'Filter by label ID (repeatable, AND)', multiple: true }),
         'include-archived': core_1.Flags.boolean({ description: 'Include archived tasks' }),
         limit: core_1.Flags.integer({ description: 'Max results', default: 20 }),
+        cursor: core_1.Flags.string({ description: 'Continue from a previous page' }),
     };
     async run() {
         this.requireAuth();
-        const { flags } = await this.parse(SearchTasks);
+        const { args, flags } = await this.parse(SearchTasks);
+        const query = (0, search_query_1.resolveSearchQuery)(this, args.query, flags.query, 'search tasks');
         let response;
         try {
             response = await data_provider_1.dataService.listTasks({
-                q: flags.query,
+                q: query,
                 ...(flags.space ? { spaceId: flags.space } : {}),
-                ...(flags.status ? { status: flags.status } : {}),
+                ...(flags.goal ? { goalId: flags.goal } : {}),
+                ...(flags.project ? { projectId: flags.project } : {}),
+                ...(flags.status?.length ? { status: flags.status.length === 1 ? flags.status[0] : flags.status } : {}),
+                ...(flags.open
+                    ? { statusType: [...data_provider_1.TASK_WORKFLOW_TYPE_BANDS.open] }
+                    : flags['status-type']?.length
+                        ? { statusType: (flags['status-type'].length === 1 ? flags['status-type'][0] : flags['status-type']) }
+                        : {}),
+                ...(flags.priority ? { priority: flags.priority } : {}),
+                ...(flags.tag?.length ? { tags: flags.tag } : {}),
+                ...(flags['label-id']?.length ? { labelIds: flags['label-id'] } : {}),
                 ...(flags['include-archived'] ? { includeArchived: true } : {}),
                 limit: flags.limit,
+                cursor: flags.cursor,
             });
         }
         catch (err) {
             this.handleApiError(err);
         }
+        if (!(0, search_display_1.isSearchListPage)(response)) {
+            this.failWithCliError({ message: 'The server returned an invalid Task search response. Retry or check server compatibility.',
+                code: 'SEARCH_INVALID_RESPONSE', exit: 1, retryable: true });
+        }
         if (flags.json) {
             this.log(JSON.stringify((0, web_url_1.withDataUrls)(this.cliConfig.baseURL, response, web_url_1.taskUrlFrom), null, 2));
             return;
         }
         const items = (response?.data ?? []);
+        const meta = response;
+        if (meta.degraded || meta.incomplete || meta.truncated || meta.warnings?.length)
+            this.warn('Search may be incomplete. Inspect --json diagnostics.');
+        if (meta.search?.candidates_may_be_truncated)
+            this.warn('Search index candidates may be truncated; results may be incomplete.');
+        if (meta.search?.candidate_window_unknown)
+            this.warn('The search index result window could not be checked; results may be incomplete.');
+        if (meta.search?.comment_search_incomplete)
+            this.warn('Comment search was limited or unavailable; results may be incomplete.');
+        if (meta.search?.semantics === 'case_insensitive_substring')
+            this.warn('Search is using literal database matching; typo tolerance may be unavailable.');
         if (items.length === 0) {
-            this.log(`No tasks matching ${JSON.stringify(flags.query)}.`);
+            if (meta.search?.backend === 'not_run' && meta.search.semantics === 'filters_exclude_all') {
+                this.log('No tasks are eligible under the current access and filters. Broaden the filters to search more tasks.');
+            }
+            else {
+                this.log(`No tasks matching ${JSON.stringify(query)} on this page. Try a distinctive word or broaden the filters.`);
+            }
+            if (meta.search?.semantics === 'exact_identifier') {
+                this.log('This query was treated as an exact Task reference. Search a phrase to find text mentioning it.');
+            }
+            if (meta.search?.backend === 'meilisearch' && meta.search.semantics !== 'exact_identifier') {
+                this.log('This index does not search Task comments. A comment-only match may not appear.');
+            }
+            if (meta.next_cursor)
+                this.log(`Next page: --cursor ${(0, search_display_1.shellSearchCursor)(meta.next_cursor)}`);
+            else if (meta.has_more)
+                this.warn('More results exist, but the server did not provide a cursor.');
             return;
         }
         const rows = items.map((t) => ({
@@ -83,8 +143,12 @@ class SearchTasks extends base_command_1.BaseCommand {
             { key: 'priority', header: 'PRIORITY' },
             { key: 'match', header: 'MATCH' },
             { key: 'id', header: 'ID' },
-            { key: 'url', header: 'URL', maxWidth: 72 },
+            { key: 'url', header: 'URL', verbatim: true },
         ], (line) => this.log(line));
+        if (meta.next_cursor)
+            this.log(`Next page: --cursor ${(0, search_display_1.shellSearchCursor)(meta.next_cursor)}`);
+        else if (meta.has_more)
+            this.warn('More results exist, but the server did not provide a cursor.');
     }
 }
 exports.default = SearchTasks;

package/dist/commands/search/teams.js

@@ -44,8 +44,12 @@ class SearchTeams extends base_command_1.BaseCommand {
         const items = Array.isArray(r)
             ? r
             : (r?.data ?? []);
+        const meta = response;
+        const partial = Boolean(meta?.partial || meta?.semanticUnavailable);
+        if (partial)
+            this.warn('Team store search may be incomplete. Try again or narrow your query.');
         if (items.length === 0) {
-            this.log('No teams found.');
+            this.log(partial ? 'No teams confirmed in the available search results.' : 'No teams found.');
             return;
         }
         const rows = items.map((t) => ({

package/dist/commands/search/workspace.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../base-command';
+export { searchDisplayText } from '../../lib/search-display';
+export declare function searchDiagnosticMessage(code: string): string;
+/** Workspace search uses the same ACL-filtered index and result order as web. */
+export default class SearchWorkspace extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        query: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        query: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        type: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        cursor: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/search/workspace.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchDisplayText = void 0;
+exports.searchDiagnosticMessage = searchDiagnosticMessage;
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../base-command");
+const format_1 = require("../../lib/format");
+const search_query_1 = require("../../lib/search-query");
+const web_url_1 = require("../../lib/web-url");
+const search_display_1 = require("../../lib/search-display");
+var search_display_2 = require("../../lib/search-display");
+Object.defineProperty(exports, "searchDisplayText", { enumerable: true, get: function () { return search_display_2.searchDisplayText; } });
+function isSearchResponse(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const response = value;
+    if (!Array.isArray(response.results) || (response.nextCursor !== null && (typeof response.nextCursor !== 'string' || !(0, search_display_1.isPrintableSearchCursor)(response.nextCursor))) ||
+        (response.diagnostics !== undefined && (!Array.isArray(response.diagnostics) || !response.diagnostics.every((item) => typeof item === 'string'))))
+        return false;
+    return response.results.every((item) => item && typeof item === 'object' && !Array.isArray(item) &&
+        ['id', 'type', 'entityId', 'title', 'href'].every((field) => typeof item[field] === 'string') &&
+        item.href.startsWith('/') && !item.href.startsWith('//') && !item.href.includes('\\') &&
+        !/[\u0000-\u001f\u007f]/.test(item.href) &&
+        ['identifier', 'excerpt'].every((field) => item[field] === undefined || typeof item[field] === 'string'));
+}
+function searchDiagnosticMessage(code) {
+    switch (code) {
+        case 'global_search_index_stale':
+            return 'The search index is catching up. Recent changes may be missing; retry shortly.';
+        case 'global_search_acl_unavailable':
+            return 'Access checks were unavailable. Results may be incomplete; retry shortly.';
+        case 'global_search_source_unavailable':
+            return 'Some current resources could not be checked. Results may be incomplete; retry shortly.';
+        case 'global_search_candidate_window_may_be_limited':
+            return 'This broad search may exceed the index result window. Narrow the query or select resource types.';
+        case 'global_search_candidate_window_unknown':
+            return 'The index result window could not be checked. Results may be incomplete; retry shortly.';
+        case 'global_search_invalid_candidate':
+            return 'The search index returned invalid candidates. Results may be incomplete; retry shortly.';
+        default:
+            return `Search may be incomplete (${(0, search_display_1.searchDisplayText)(code)}). Retry or inspect --json diagnostics.`;
+    }
+}
+/** Workspace search uses the same ACL-filtered index and result order as web. */
+class SearchWorkspace extends base_command_1.BaseCommand {
+    static description = 'Search supported resources in your workspace';
+    static examples = [
+        '<%= config.bin %> search workspace "deployment incident"',
+        '<%= config.bin %> search workspace pricing --type task --type wiki --json',
+    ];
+    static args = { query: core_1.Args.string({ description: 'Search term', ignoreStdin: true }) };
+    static flags = {
+        query: core_1.Flags.string({ char: 'q', description: 'Search term' }),
+        type: core_1.Flags.string({ multiple: true, description: 'Limit to resource types (repeatable; for example task, space, wiki, message)' }),
+        limit: core_1.Flags.integer({ default: 25, min: 1, max: 50, description: 'Results per page' }),
+        cursor: core_1.Flags.string({ description: 'Continue from a previous page' }),
+        json: core_1.Flags.boolean({ description: 'Output structured results and diagnostics' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(SearchWorkspace);
+        const query = (0, search_query_1.resolveSearchQuery)(this, args.query, flags.query, 'search workspace');
+        // Session-only tokens cannot authenticate to the JWT route. Never adopt an
+        // ambient human credential to turn this into broader authority.
+        if (this.resolvedCredential.token?.startsWith('agst_')) {
+            this.failWithCliError({
+                message: 'Workspace search is not available with a session-scoped credential. Ask the workspace owner to enable the delegated CLI surface for a new Agent session, or search in a signed-in human session. Do not substitute a personal login inside the Agent.',
+                code: 'GLOBAL_SEARCH_SESSION_UNSUPPORTED', exit: 2, retryable: false,
+            });
+        }
+        let response;
+        try {
+            response = await data_provider_1.dataService.searchGlobal({ query, types: flags.type, limit: flags.limit, cursor: flags.cursor });
+        }
+        catch (err) {
+            const code = (0, base_command_1.apiRefusal)(err).code;
+            if (code === 'SEARCH_WORKSPACE_REQUIRED' || code === 'SEARCH_WORKSPACE_FORBIDDEN') {
+                this.failWithCliError({
+                    message: `Choose a workspace you belong to: run \`${this.config.bin} workspaces list\`, then \`${this.config.bin} workspaces use <workspace>\`, or pass --workspace <workspace-id>.`,
+                    code, status: 403, exit: 3, retryable: false,
+                });
+            }
+            if (code === 'INVALID_SEARCH_TYPE') {
+                const allowed = (0, base_command_1.apiRefusal)(err).body?.supportedTypes;
+                const types = Array.isArray(allowed)
+                    ? allowed.filter((type) => typeof type === 'string').map(search_display_1.searchDisplayText).filter(Boolean)
+                    : [];
+                this.failWithCliError({
+                    message: types.length
+                        ? `Unknown search type. Choose from: ${types.join(', ')}.`
+                        : 'Unknown search type. Run the command without --type to search all supported types.',
+                    code, status: 400, exit: 2, retryable: false,
+                });
+            }
+            this.handleApiError(err);
+        }
+        if (!isSearchResponse(response) || (flags.cursor && response.nextCursor === flags.cursor)) {
+            this.failWithCliError({ message: 'The server returned an invalid workspace search response. Retry or check server compatibility.',
+                code: 'GLOBAL_SEARCH_INVALID_RESPONSE', exit: 1, retryable: true });
+        }
+        const results = response.results.map((item) => ({
+            ...item,
+            url: `${(0, web_url_1.webOrigin)(this.cliConfig.baseURL)}${item.href}`,
+        }));
+        if (flags.json) {
+            this.log(JSON.stringify({ ...response, results }, null, 2));
+            return;
+        }
+        for (const diagnostic of new Set(response.diagnostics || []))
+            this.warn(searchDiagnosticMessage(diagnostic));
+        if (results.length) {
+            (0, format_1.renderTable)(results.map((item) => ({ type: (0, search_display_1.searchDisplayText)(item.type), id: (0, search_display_1.searchDisplayText)(item.identifier || item.entityId), title: (0, search_display_1.searchDisplayText)(item.title), excerpt: (0, search_display_1.searchDisplayText)(item.excerpt || ''), url: (0, search_display_1.searchDisplayText)(item.url || '-') })), [
+                { key: 'type', header: 'TYPE' }, { key: 'id', header: 'ID' },
+                { key: 'title', header: 'TITLE', maxWidth: 45 }, { key: 'excerpt', header: 'EXCERPT', maxWidth: 60 },
+                { key: 'url', header: 'URL', verbatim: true },
+            ], (line) => this.log(line));
+        }
+        else {
+            this.log('No results in this page of supported workspace resources.');
+        }
+        if (response.nextCursor)
+            this.log(`Next page: --cursor ${(0, search_display_1.shellSearchCursor)(response.nextCursor)}`);
+    }
+}
+exports.default = SearchWorkspace;

package/dist/commands/skills/browse.d.ts

@@ -16,6 +16,7 @@ export default class SkillsBrowse extends BaseCommand {
         category: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         sort: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        cursor: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/skills/browse.js

@@ -7,6 +7,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const format_1 = require("../../lib/format");
 const usd_micros_1 = require("../../lib/usd-micros");
+const skill_store_pagination_1 = require("../../lib/skill-store-pagination");
 function skillBrowseDescription(skill) {
     const description = String(skill.description ?? '').trim();
     if (description && description !== '>' && description !== '|')
@@ -43,6 +44,7 @@ class SkillsBrowse extends base_command_1.BaseCommand {
             options: ['newest', 'popular', 'rating'],
         }),
         limit: core_1.Flags.integer({ description: 'Maximum number of results', default: 20 }),
+        cursor: core_1.Flags.string({ description: 'Continue from a previous page' }),
     };
     async run() {
         this.requireAuth();
@@ -59,6 +61,7 @@ class SkillsBrowse extends base_command_1.BaseCommand {
                 category: flags.category,
                 sort: flags.sort ? sortMap[flags.sort] : undefined,
                 limit: flags.limit,
+                cursor: flags.cursor,
             });
         }
         catch (err) {
@@ -71,7 +74,10 @@ class SkillsBrowse extends base_command_1.BaseCommand {
         const r = response;
         const items = Array.isArray(r) ? r : (r?.data ?? []);
         if (items.length === 0) {
-            this.log('No skills found.');
+            this.log((0, skill_store_pagination_1.skillStorePageState)(response, flags.cursor).hasMore
+                ? 'No skills on this page. More candidates remain.'
+                : 'No skills found.');
+            (0, skill_store_pagination_1.reportSkillStorePage)(response, flags.cursor, (message) => this.log(message), (message) => this.warn(message));
             return;
         }
         const rows = items.map(skillBrowseRow);
@@ -83,6 +89,7 @@ class SkillsBrowse extends base_command_1.BaseCommand {
             { key: 'installs', header: 'INSTALLS' },
             { key: 'description', header: 'DESCRIPTION', maxWidth: 60 },
         ], (line) => this.log(line));
+        (0, skill_store_pagination_1.reportSkillStorePage)(response, flags.cursor, (message) => this.log(message), (message) => this.warn(message));
     }
 }
 exports.default = SkillsBrowse;

package/dist/commands/skills/search.d.ts

@@ -17,6 +17,7 @@ export default class SkillsSearch extends BaseCommand {
         query: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         category: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        cursor: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/skills/search.js

@@ -6,6 +6,7 @@ const base_command_1 = require("../../base-command");
 const format_1 = require("../../lib/format");
 const search_query_1 = require("../../lib/search-query");
 const usd_micros_1 = require("../../lib/usd-micros");
+const skill_store_pagination_1 = require("../../lib/skill-store-pagination");
 class SkillsSearch extends base_command_1.BaseCommand {
     static description = 'Search skills in the skrr store by keyword (same as `search skills`)';
     static examples = [
@@ -37,6 +38,7 @@ class SkillsSearch extends base_command_1.BaseCommand {
         query: core_1.Flags.string({ char: 'q', description: 'Search query' }),
         category: core_1.Flags.string({ description: 'Filter by category' }),
         limit: core_1.Flags.integer({ description: 'Maximum number of results', default: 20 }),
+        cursor: core_1.Flags.string({ description: 'Continue from a previous page' }),
     };
     async run() {
         this.requireAuth();
@@ -48,6 +50,7 @@ class SkillsSearch extends base_command_1.BaseCommand {
                 q: query,
                 category: flags.category,
                 limit: flags.limit,
+                cursor: flags.cursor,
             });
         }
         catch (err) {
@@ -59,8 +62,15 @@ class SkillsSearch extends base_command_1.BaseCommand {
         }
         const r = response;
         const items = Array.isArray(r) ? r : (r?.data ?? []);
+        const incomplete = (0, skill_store_pagination_1.skillStoreSearchIncomplete)(response);
+        if (incomplete)
+            this.warn('Skill store search may be incomplete. Try again or narrow your query.');
         if (items.length === 0) {
-            this.log(`No skills found matching '${query}'.`);
+            this.log((0, skill_store_pagination_1.skillStorePageState)(response, flags.cursor).hasMore
+                ? 'No skills matched on this page. More candidates remain.'
+                : incomplete ? 'No skills confirmed in the available search results.'
+                    : `No skills found matching '${query}'.`);
+            (0, skill_store_pagination_1.reportSkillStorePage)(response, flags.cursor, (message) => this.log(message), (message) => this.warn(message));
             return;
         }
         const rows = items.map((s) => ({
@@ -79,6 +89,7 @@ class SkillsSearch extends base_command_1.BaseCommand {
             { key: 'installs', header: 'INSTALLS' },
             { key: 'description', header: 'DESCRIPTION', maxWidth: 60 },
         ], (line) => this.log(line));
+        (0, skill_store_pagination_1.reportSkillStorePage)(response, flags.cursor, (message) => this.log(message), (message) => this.warn(message));
     }
 }
 exports.default = SkillsSearch;

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

@@ -25,6 +25,7 @@ export default class SpacesList extends BaseCommand {
         status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         label: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'include-archived': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'archived-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         q: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         match: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/spaces/list.js

@@ -15,7 +15,7 @@ function noSpacesMatchedMessage(q, bin = 'skrr', mode = 'fuzzy') {
         : 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` +
+    return (`No spaces matched ${JSON.stringify(q)} on this page.\n` +
         `  → ${explanation} Fields: title, description and identifier.\n` +
         `  → retry with one distinctive word, or list them all with \`${bin} spaces list\`.`);
 }
@@ -45,6 +45,7 @@ class SpacesList extends base_command_1.BaseCommand {
         '<%= 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 --archived-only --json',
         '<%= config.bin %> spaces list --compact --json',
         '<%= config.bin %> spaces list --fields id,identifier,title --ndjson',
     ];
@@ -62,7 +63,8 @@ class SpacesList extends base_command_1.BaseCommand {
             description: 'Filter by label ID (repeatable). Multiple labels AND together — a space must carry all of them.',
             multiple: true,
         }),
-        'include-archived': core_1.Flags.boolean({ description: 'Include archived spaces' }),
+        'include-archived': core_1.Flags.boolean({ description: 'Include archived spaces', exclusive: ['archived-only'] }),
+        'archived-only': core_1.Flags.boolean({ description: 'List only archived spaces', exclusive: ['include-archived'] }),
         q: core_1.Flags.string({
             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.',
@@ -86,6 +88,7 @@ class SpacesList extends base_command_1.BaseCommand {
                 ...(flags.label?.length ? { labelIds: flags.label } : {}),
                 ...(flags.q ? { q: flags.q, ...(flags.match ? { match: flags.match } : {}) } : {}),
                 includeArchived: flags['include-archived'],
+                archivedOnly: flags['archived-only'],
                 limit: flags.limit,
                 cursor: flags.cursor,
             });
@@ -107,6 +110,8 @@ class SpacesList extends base_command_1.BaseCommand {
         }
         const r = response;
         const items = r?.data ?? [];
+        if (flags.q && (r?.degraded || r?.warnings?.length))
+            this.warn('Search may be incomplete. Inspect --json diagnostics.');
         if (r?.search) {
             this.log(`Search: ${r.search.mode}; ${r.search.semantics}; backend=${r.search.backend}.`);
             if (r.search.candidates_may_be_truncated) {
@@ -116,7 +121,11 @@ class SpacesList extends base_command_1.BaseCommand {
         if (items.length === 0) {
             this.log(flags.q
                 ? noSpacesMatchedMessage(flags.q, this.config.bin, r?.search?.mode ?? 'fuzzy')
-                : noSpacesEmptyMessage(this.config.bin));
+                : flags['archived-only'] || flags.status || flags.label?.length || r?.next_cursor
+                    ? 'No spaces on this page under the current filters.'
+                    : noSpacesEmptyMessage(this.config.bin));
+            if (r?.next_cursor)
+                this.log(`Next page: --cursor ${r.next_cursor}`);
             return;
         }
         const rows = items.map((s) => ({

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

@@ -0,0 +1 @@
+export { default } from '../search/spaces';

package/dist/commands/spaces/search.js

@@ -0,0 +1,9 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+// Both spellings share one implementation and result contract.
+var spaces_1 = require("../search/spaces");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(spaces_1).default; } });

package/dist/commands/store/gallery-admissions/approve.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../../base-command';
+export default class StoreGalleryAdmissionsApprove extends BaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        kind: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        revision: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
+        digest: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'images-reviewed': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        note: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/store/gallery-admissions/approve.js

@@ -0,0 +1,36 @@
+"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");
+class StoreGalleryAdmissionsApprove extends base_command_1.BaseCommand {
+    static description = 'Approve the exact frozen gallery revision inspected by a curator';
+    static args = { id: core_1.Args.string({ description: 'Gallery review request ID', required: true, ignoreStdin: true }) };
+    static flags = {
+        kind: core_1.Flags.string({ options: ['action', 'service'], required: true }),
+        revision: core_1.Flags.integer({ required: true, min: 0, description: 'Revision from the review details' }),
+        digest: core_1.Flags.string({ required: true, description: 'Digest from the review details' }),
+        'images-reviewed': core_1.Flags.boolean({ description: 'Confirm you inspected every image in this frozen revision' }),
+        note: core_1.Flags.string({ description: 'Decision note' }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(StoreGalleryAdmissionsApprove);
+        try {
+            if (!flags['images-reviewed'])
+                throw new Error('Inspect every image, then pass --images-reviewed to confirm.');
+            const result = await data_provider_1.dataService.approveStoreGalleryAdmission(flags.kind, args.id, {
+                revision: flags.revision, digest: flags.digest, imagesReviewed: true, ...(flags.note ? { note: flags.note } : {}),
+            });
+            if (flags.json)
+                this.log(JSON.stringify(result, null, 2));
+            else
+                this.log(`Approved gallery revision ${flags.revision}.`);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = StoreGalleryAdmissionsApprove;

package/dist/commands/store/gallery-admissions/list.d.ts

@@ -0,0 +1,9 @@
+import { BaseCommand } from '../../../base-command';
+export default class StoreGalleryAdmissionsList extends BaseCommand {
+    static description: string;
+    static flags: {
+        state: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/store/gallery-admissions/list.js

@@ -0,0 +1,49 @@
+"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 list_output_1 = require("../../../lib/list-output");
+class StoreGalleryAdmissionsList extends base_command_1.BaseCommand {
+    static description = 'List frozen Store gallery revisions awaiting curator review';
+    static flags = {
+        state: core_1.Flags.string({ options: ['pending_review', 'refused'], default: 'pending_review', description: 'Review state to list' }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(StoreGalleryAdmissionsList);
+        try {
+            const reviews = [];
+            const seen = new Set();
+            let cursor;
+            do {
+                const page = await data_provider_1.dataService.getStoreGalleryAdmissions({
+                    state: flags.state,
+                    ...(cursor ? { cursor } : {}),
+                });
+                reviews.push(...page.reviews);
+                cursor = page.nextCursor || undefined;
+                if (cursor && seen.has(cursor))
+                    throw new Error('Gallery admission queue returned a repeated cursor');
+                if (cursor)
+                    seen.add(cursor);
+            } while (cursor);
+            if (flags.json) {
+                this.printJsonResult((0, list_output_1.listResult)({ data: reviews, reviews, nextCursor: null }));
+            }
+            else if (!reviews.length) {
+                this.log(flags.state === 'refused' ? 'No refused gallery reviews.' : 'Nothing waiting for gallery review.');
+            }
+            else {
+                for (const review of reviews) {
+                    this.log(`${review.entityType}\t${review.id}\t${review.entityId}\trevision ${review.revision}\t${review.digest}`);
+                }
+            }
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = StoreGalleryAdmissionsList;