@skrr-ai/cli 0.1.120 → 0.1.121

package/dist/base-command.js

@@ -33,6 +33,7 @@ const json_mode_1 = require("./lib/json-mode");
 const failed_lookup_1 = require("./lib/failed-lookup");
 const internal_id_1 = require("./lib/internal-id");
 const http_error_1 = require("./lib/http-error");
+const api_error_reason_1 = require("./lib/api-error-reason");
 const guide_pointer_1 = require("./lib/guide-pointer");
 // Re-exported from its home in `lib/keychain`, beside the other profile
 // functions. It lived here while `init()` was its only caller; a lib module
@@ -1722,7 +1723,7 @@ class BaseCommand extends core_1.Command {
                     code: bodyCode || 'FORBIDDEN',
                     status: e.status,
                     exit: 3,
-                    retryable: edgeRefusal,
+                    retryable: typeof body?.retryable === 'boolean' ? body.retryable : edgeRefusal,
                 });
             }
             else if (e.status === 404) {
@@ -2229,6 +2230,12 @@ function refusalCodeOf(body) {
     const direct = stringProp(body ?? null, 'code') || stringProp(body ?? null, 'errorType');
     if (direct)
         return direct;
+    // Session-scoped Task routes return `{ok:false, reason}`. This is an
+    // application refusal, not a bodyless edge error. Preserve its spelling so
+    // an Agent can distinguish a stale session from a Task authorization stop.
+    const reason = (0, api_error_reason_1.reasonOnlyCode)(body);
+    if (reason)
+        return reason;
     const legacy = stringProp(body ?? null, 'error');
     return legacy && LEGACY_ERROR_FIELD_CODE.test(legacy) ? legacy.toUpperCase() : undefined;
 }
@@ -2696,7 +2703,9 @@ function errorBodyMessage(body) {
     const nested = record.error && typeof record.error === 'object' && !Array.isArray(record.error)
         ? record.error.message
         : undefined;
-    return text(record.message) ?? text(record.error) ?? text(nested);
+    const reason = (0, api_error_reason_1.reasonOnlyCode)(record);
+    return text(record.message) ?? text(record.error) ?? text(nested) ??
+        (reason ? `Request refused: ${reason}` : undefined);
 }
 /**
  * The `details` of a CLI error envelope, in ONE shape. The server's refusal body becomes the

package/dist/commands/agent/message/context.d.ts

@@ -14,6 +14,7 @@ export default class AgentMessageContext extends BaseCommand {
         agent: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         task: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         run: 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/agent/message/context.js

@@ -26,8 +26,9 @@ class AgentMessageContext extends base_command_1.BaseCommand {
         run: core_1.Flags.string({
             description: 'Optional run context to narrow recent updates (refused inside a daemon session — the session path is already bound to its own run)',
         }),
-        // No `--json` flag: these observations exist to be parsed, so JSON is the
-        // only output. A flag that cannot be turned off is a lie in `--help`.
+        json: core_1.Flags.boolean({
+            description: 'Accepted for consistency; this command always outputs JSON',
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(AgentMessageContext);

package/dist/commands/search/agents.js

@@ -83,8 +83,12 @@ class SearchAgents 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('Agent store search may be incomplete. Try again or narrow your query.');
         if (items.length === 0) {
-            this.log('No agents found.');
+            this.log(partial ? 'No agents confirmed in the available search results.' : 'No agents found.');
             return;
         }
         const rows = items.map((item) => ({

package/dist/commands/search/all.js

@@ -7,6 +7,8 @@ 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 skill_store_pagination_1 = require("../../lib/skill-store-pagination");
+const search_display_1 = require("../../lib/search-display");
 /**
  * One store document → one row of the merged agent/skill/team table.
  *
@@ -47,9 +49,9 @@ function storeSearchRow(type, doc) {
         // `OSK-S-12`) — that is what a person types back into `tasks show` /
         // `spaces show`, and the UUID is still one `--json` away. Spaces created
         // before refs existed fall through to the UUID until backfilled.
-        id: (0, format_1.formatCell)(doc.identifier ?? doc.id ?? doc._id ?? doc.slug),
-        name: (0, format_1.formatCell)(doc.name ?? doc.title),
-        description: plainDescription(doc.description),
+        id: (0, search_display_1.searchDisplayText)((0, format_1.formatCell)(doc.identifier ?? doc.id ?? doc._id ?? doc.slug)),
+        name: (0, search_display_1.searchDisplayText)((0, format_1.formatCell)(doc.name ?? doc.title)),
+        description: (0, search_display_1.searchDisplayText)(plainDescription(doc.description)),
     };
 }
 // No single `getStoreAll` exists in data-service — compose by fanning out to
@@ -73,24 +75,44 @@ class SearchAll extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { flags } = await this.parse(SearchAll);
+        const validBucket = (value) => {
+            const rows = Array.isArray(value) ? value
+                : value && typeof value === 'object' ? value.data : undefined;
+            return Array.isArray(rows) && rows.every((row) => row && typeof row === 'object' && !Array.isArray(row));
+        };
         const items = (b) => Array.isArray(b) ? b : (b?.data ?? []);
-        let agents;
-        let skills;
-        let teams;
-        let tasks;
-        let spaces;
-        try {
-            [agents, skills, teams, tasks, spaces] = await Promise.all([
-                data_provider_1.dataService.getStoreAgents({ q: flags.query, limit: flags.limit }),
-                data_provider_1.dataService.getStoreSkills({ q: flags.query, limit: flags.limit }),
-                data_provider_1.dataService.getStoreTeams({ q: flags.query, limit: flags.limit }),
-                data_provider_1.dataService.listTasks({ q: flags.query, limit: flags.limit }),
-                data_provider_1.dataService.listSpaces({ q: flags.query, limit: flags.limit }),
-            ]);
-        }
-        catch (err) {
-            this.handleApiError(err);
-        }
+        const names = ['agents', 'skills', 'teams', 'tasks', 'spaces'];
+        const outcomes = await Promise.allSettled([
+            data_provider_1.dataService.getStoreAgents({ q: flags.query, limit: flags.limit }),
+            data_provider_1.dataService.getStoreSkills({ q: flags.query, limit: flags.limit }),
+            data_provider_1.dataService.getStoreTeams({ q: flags.query, limit: flags.limit }),
+            data_provider_1.dataService.listTasks({ q: flags.query, limit: flags.limit }),
+            data_provider_1.dataService.listSpaces({ q: flags.query, limit: flags.limit }),
+        ]);
+        const [agents, skills, teams, tasks, spaces] = outcomes.map((outcome) => outcome.status === 'fulfilled' && validBucket(outcome.value) ? outcome.value : undefined);
+        const failed = names.filter((_, index) => outcomes[index].status === 'rejected' ||
+            (outcomes[index].status === 'fulfilled' && !validBucket(outcomes[index].value)));
+        const pageInfo = Object.fromEntries(names.map((name, index) => {
+            const outcome = outcomes[index];
+            const page = outcome.status === 'fulfilled' && !Array.isArray(outcome.value)
+                ? outcome.value
+                : undefined;
+            const skillPage = name === 'skills' && outcome.status === 'fulfilled'
+                ? (0, skill_store_pagination_1.skillStorePageState)(outcome.value)
+                : undefined;
+            return [name, failed.includes(name) ? { status: 'failed', ...(outcome.status === 'fulfilled' ? { reason: 'invalid_response' } : {}) } : {
+                    status: 'ok', ...(page?.has_more !== undefined ? { has_more: page.has_more } : {}),
+                    ...(skillPage?.nextCursor ? { next_cursor: skillPage.nextCursor } : page?.next_cursor ? { next_cursor: page.next_cursor } : {}),
+                    ...(skillPage?.invalidCursor ? { incomplete: true } : {}),
+                    ...(page?.warnings ? { warnings: page.warnings } : {}),
+                    ...(page?.degraded ? { degraded: true } : {}),
+                    ...(page?.incomplete ? { incomplete: true } : {}),
+                    ...(page?.truncated ? { truncated: true } : {}),
+                    ...(page?.partial ? { partial: true } : {}),
+                    ...(page?.semanticUnavailable ? { semanticUnavailable: true } : {}),
+                    ...(page?.search ? { search: page.search } : {}),
+                }];
+        }));
         if (flags.json) {
             this.log(JSON.stringify({
                 agents: items(agents).map((agent) => ({
@@ -107,9 +129,30 @@ class SearchAll extends base_command_1.BaseCommand {
                     ...space,
                     url: (0, web_url_1.spaceUrlFrom)(this.cliConfig.baseURL, space),
                 })),
+                sources: pageInfo,
             }, null, 2));
+            if (failed.length)
+                this.exit(1);
             return;
         }
+        if (failed.length)
+            this.warn(`Some sources failed: ${failed.join(', ')}. Results are incomplete; retry those searches.`);
+        for (const [name, info] of Object.entries(pageInfo)) {
+            if (('degraded' in info && info.degraded) || ('incomplete' in info && info.incomplete) ||
+                ('truncated' in info && info.truncated) || ('partial' in info && info.partial) ||
+                ('semanticUnavailable' in info && info.semanticUnavailable) || ('warnings' in info && info.warnings?.length) ||
+                ('search' in info && (info.search?.candidates_may_be_truncated || info.search?.candidate_window_unknown || info.search?.comment_search_incomplete))) {
+                this.warn(`${name} search may be incomplete; inspect --json diagnostics.`);
+            }
+            if ('has_more' in info && info.has_more) {
+                if (name === 'skills' && 'next_cursor' in info && info.next_cursor) {
+                    this.warn(`skills has more candidates. Repeat the query with search skills --cursor ${info.next_cursor}.`);
+                }
+                else {
+                    this.warn(`${name} has more results. Use its dedicated search command to page through them.`);
+                }
+            }
+        }
         // Your own work first — when both a task and a store agent mention the
         // query, the task is almost always what you were looking for.
         const rows = [
@@ -129,7 +172,14 @@ class SearchAll extends base_command_1.BaseCommand {
             ...items(teams).map((t) => storeSearchRow('team', t)),
         ];
         if (rows.length === 0) {
-            this.log('No results.');
+            const hasMore = Object.values(pageInfo).some((info) => 'has_more' in info && info.has_more);
+            const incomplete = Object.values(pageInfo).some((info) => ('degraded' in info && info.degraded) || ('incomplete' in info && info.incomplete) ||
+                ('truncated' in info && info.truncated) || ('partial' in info && info.partial) ||
+                ('semanticUnavailable' in info && info.semanticUnavailable) || ('warnings' in info && info.warnings?.length) ||
+                ('search' in info && (info.search?.candidates_may_be_truncated || info.search?.candidate_window_unknown || info.search?.comment_search_incomplete)));
+            this.log(failed.length ? 'No results from the sources that answered.' : hasMore ? 'No results on these pages. More candidates remain.' : incomplete ? 'No confirmed results. Some sources may be incomplete.' : 'No results.');
+            if (failed.length)
+                this.exit(1);
             return;
         }
         (0, format_1.renderTable)(rows, [
@@ -137,8 +187,10 @@ class SearchAll extends base_command_1.BaseCommand {
             { key: 'id', header: 'ID', verbatim: true },
             { key: 'name', header: 'NAME', maxWidth: 30 },
             { key: 'description', header: 'DESCRIPTION', maxWidth: 60 },
-            { key: 'url', header: 'URL', maxWidth: 72 },
+            { key: 'url', header: 'URL', verbatim: true },
         ], (line) => this.log(line));
+        if (failed.length)
+            this.exit(1);
     }
 }
 exports.default = SearchAll;

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

@@ -17,6 +17,7 @@ export default class SearchSkills 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/search/skills.js

@@ -5,6 +5,7 @@ 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 skill_store_pagination_1 = require("../../lib/skill-store-pagination");
 class SearchSkills extends base_command_1.BaseCommand {
     static description = 'Search skills in the skrr store by keyword (same as `skills search`)';
     static examples = [
@@ -43,6 +44,7 @@ class SearchSkills extends base_command_1.BaseCommand {
             description: 'Maximum number of results',
             default: 20,
         }),
+        cursor: core_1.Flags.string({ description: 'Continue from a previous page' }),
     };
     async run() {
         this.requireAuth();
@@ -54,6 +56,7 @@ class SearchSkills extends base_command_1.BaseCommand {
                 q: query,
                 category: flags.category,
                 limit: flags.limit,
+                cursor: flags.cursor,
             });
         }
         catch (err) {
@@ -65,8 +68,15 @@ class SearchSkills 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) => ({
@@ -85,6 +95,7 @@ class SearchSkills 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 = SearchSkills;

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

@@ -16,12 +16,19 @@ export declare function spaceSearchRow(s: Record<string, unknown>): {
 export default class SearchSpaces extends BaseCommand {
     static description: string;
     static examples: string[];
+    static args: {
+        query: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
     static flags: {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        query: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        query: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         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>;
         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>;
+        match: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
 }

package/dist/commands/search/spaces.js

@@ -2,10 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.spaceSearchRow = spaceSearchRow;
 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 search_display_1 = require("../../lib/search-display");
 /**
  * One space document → one search-result row.
  *
@@ -15,12 +17,12 @@ const web_url_1 = require("../../lib/web-url");
  */
 function spaceSearchRow(s) {
     return {
-        id: (0, format_1.formatCell)(s.id ?? s._id),
+        id: (0, search_display_1.searchDisplayText)((0, format_1.formatCell)(s.id ?? s._id)),
         // Absent on spaces created before identifiers existed and not yet
         // backfilled, so this renders "-" rather than "undefined".
-        ref: (0, format_1.formatCell)(s.identifier),
-        title: (0, format_1.formatCell)(s.title),
-        status: (0, format_1.formatCell)(s.status),
+        ref: (0, search_display_1.searchDisplayText)((0, format_1.formatCell)(s.identifier)),
+        title: (0, search_display_1.searchDisplayText)((0, format_1.formatCell)(s.title)),
+        status: (0, search_display_1.searchDisplayText)((0, format_1.formatCell)(s.status)),
         archived: s.archivedAt ? 'yes' : 'no',
     };
 }
@@ -29,42 +31,74 @@ class SearchSpaces extends base_command_1.BaseCommand {
     // `--space` here would be resolved as a space reference by the BaseCommand
     // parse hook, so this command deliberately uses `--query` like its siblings.
     static examples = [
+        '<%= config.bin %> spaces search "always on" --match phrase',
         '<%= config.bin %> search spaces --query dogfood',
         '<%= config.bin %> search spaces --query "always on" --json',
         '<%= config.bin %> search spaces --query retired --include-archived',
+        '<%= config.bin %> spaces search retired --archived-only',
     ];
+    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 }),
-        status: core_1.Flags.string({ description: 'Filter by space status' }),
-        'include-archived': core_1.Flags.boolean({ description: 'Include archived spaces' }),
+        query: core_1.Flags.string({ char: 'q', description: 'Search query' }),
+        status: core_1.Flags.string({ description: 'Filter by space status', options: [...data_provider_1.SPACE_STATUSES] }),
+        label: core_1.Flags.string({ description: 'Filter by label ID; repeat to require all labels', multiple: true }),
+        'include-archived': core_1.Flags.boolean({ description: 'Include archived spaces', exclusive: ['archived-only'] }),
+        'archived-only': core_1.Flags.boolean({ description: 'Search only archived spaces', exclusive: ['include-archived'] }),
         limit: core_1.Flags.integer({ description: 'Max results', default: 20 }),
+        cursor: core_1.Flags.string({ description: 'Continue from a previous page' }),
+        match: core_1.Flags.string({ description: 'Matching policy', options: ['fuzzy', 'phrase', 'exact'] }),
     };
     async run() {
         this.requireAuth();
-        const { flags } = await this.parse(SearchSpaces);
+        const { args, flags } = await this.parse(SearchSpaces);
+        const query = (0, search_query_1.resolveSearchQuery)(this, args.query, flags.query, 'search spaces');
         let response;
         try {
             response = await data_provider_1.dataService.listSpaces({
-                q: flags.query,
+                q: query,
                 ...(flags.status ? { status: flags.status } : {}),
+                ...(flags.label?.length ? { labelIds: flags.label } : {}),
                 includeArchived: flags['include-archived'],
+                archivedOnly: flags['archived-only'],
                 limit: flags.limit,
+                cursor: flags.cursor,
+                ...(flags.match ? { match: flags.match } : {}),
             });
         }
         catch (err) {
             this.handleApiError(err);
         }
+        if (!(0, search_display_1.isSearchListPage)(response)) {
+            this.failWithCliError({ message: 'The server returned an invalid Space search response. Retry or check server compatibility.',
+                code: 'SEARCH_INVALID_RESPONSE', exit: 1, retryable: true });
+        }
+        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) {
             this.log(JSON.stringify((0, web_url_1.withDataUrls)(this.cliConfig.baseURL, response, web_url_1.spaceUrlFrom), null, 2));
             return;
         }
         const items = (response?.data ?? []);
+        const meta = response;
+        if (meta.degraded || 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?.backend === 'database' && (!flags.match || flags.match === 'fuzzy'))
+            this.warn('Search is using literal database matching; typo tolerance may be unavailable.');
         if (items.length === 0) {
-            const hint = flags['include-archived']
+            const hint = flags['include-archived'] || flags['archived-only']
                 ? ''
                 : ' (archived spaces are excluded — add --include-archived)';
-            this.log(`No spaces matching ${JSON.stringify(flags.query)}${hint}.`);
+            this.log(`No spaces matching ${JSON.stringify(query)} on this page${hint}. Try a distinctive word or broaden the filters.`);
+            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((s) => ({
@@ -77,8 +111,12 @@ class SearchSpaces extends base_command_1.BaseCommand {
             { key: 'status', header: 'STATUS' },
             { key: 'archived', header: 'ARCHIVED' },
             { 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 = SearchSpaces;

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

@@ -21,13 +21,24 @@ export declare function taskSearchRow(t: Record<string, unknown>): {
 export default class SearchTasks extends BaseCommand {
     static description: string;
     static examples: string[];
+    static args: {
+        query: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
     static flags: {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        query: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        query: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         space: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        goal: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        status: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'status-type': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        open: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        priority: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        tag: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'label-id': import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'include-archived': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         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/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) => ({