@skrr-ai/cli 0.1.92 → 0.1.93

package/dist/commands/spaces/views/reorder.js

@@ -21,6 +21,7 @@ class SpacesViewsReorder extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesViewsReorder);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let raw = {};
         if (flags['from-json']) {
             try {
@@ -38,7 +39,7 @@ class SpacesViewsReorder extends base_command_1.BaseCommand {
         if (!Array.isArray(orderedIds) || !orderedIds.length)
             this.error('Provide repeated --view IDs or orderedIds JSON.', { exit: 1 });
         if (flags['dry-run']) {
-            const output = { dryRun: true, spaceId: args.id, orderedIds };
+            const output = { dryRun: true, spaceId: spaceRef, orderedIds };
             this.log(flags.json
                 ? JSON.stringify(output, null, 2)
                 : `Dry run: would reorder ${orderedIds.length} views.`);
@@ -46,7 +47,9 @@ class SpacesViewsReorder extends base_command_1.BaseCommand {
         }
         let result;
         try {
-            result = await data_provider_1.dataService.reorderSpaceViews(args.id, { orderedIds: orderedIds });
+            result = await data_provider_1.dataService.reorderSpaceViews(spaceRef, {
+                orderedIds: orderedIds,
+            });
         }
         catch (err) {
             this.handleApiError(err);
@@ -55,7 +58,7 @@ class SpacesViewsReorder extends base_command_1.BaseCommand {
             this.log(JSON.stringify({
                 result,
                 orderedIds,
-                url: (0, space_output_1.spacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'tasks'),
+                url: (0, space_output_1.spacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'tasks'),
             }, null, 2));
         else
             this.log(`Reordered ${orderedIds.length} views.`);

package/dist/commands/spaces/views/subscribe.js

@@ -25,6 +25,7 @@ class SpacesViewsSubscribe extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesViewsSubscribe);
+        const spaceRef = await this.resolveEntityRef('space', args.spaceId);
         let result;
         try {
             // Target resolution on the server verifies that the view belongs to this
@@ -42,7 +43,7 @@ class SpacesViewsSubscribe extends base_command_1.BaseCommand {
         }
         if (flags.json)
             return void this.log(JSON.stringify(result, null, 2));
-        this.log(`Subscribed to Space View ${args.viewId} in ${args.spaceId}.`);
+        this.log(`Subscribed to Space View ${args.viewId} in ${spaceRef}.`);
     }
 }
 exports.default = SpacesViewsSubscribe;

package/dist/commands/spaces/views/subscriptions.js

@@ -13,6 +13,7 @@ class SpacesViewsSubscriptions extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesViewsSubscriptions);
+        const spaceRef = await this.resolveEntityRef('space', args.spaceId);
         let items;
         try {
             items = await (0, view_subscriptions_1.subscriptionsForView)('space_view', args.viewId);

package/dist/commands/spaces/views/unsubscribe.js

@@ -13,6 +13,7 @@ class SpacesViewsUnsubscribe extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesViewsUnsubscribe);
+        const spaceRef = await this.resolveEntityRef('space', args.spaceId);
         let result;
         try {
             result = await (0, view_subscriptions_1.unsubscribeFromView)('space_view', args.viewId);
@@ -22,7 +23,7 @@ class SpacesViewsUnsubscribe extends base_command_1.BaseCommand {
         }
         if (flags.json)
             return void this.log(JSON.stringify(result, null, 2));
-        this.log(`Unsubscribed from Space View ${args.viewId} in ${args.spaceId}.`);
+        this.log(`Unsubscribed from Space View ${args.viewId} in ${spaceRef}.`);
     }
 }
 exports.default = SpacesViewsUnsubscribe;

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

@@ -21,10 +21,11 @@ class SpacesWidgetsAdd extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesWidgetsAdd);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let result;
         try {
             result = await data_provider_1.dataService.addSpaceWidget({
-                spaceId: args.id,
+                spaceId: spaceRef,
                 widgetId: flags.widget,
                 agentId: flags.agent,
             });
@@ -33,14 +34,14 @@ class SpacesWidgetsAdd extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, args.id, 'widgets', result, [
+            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'widgets', result, [
                 'widgetId',
                 'id',
                 '_id',
             ]), null, 2));
             return;
         }
-        this.log(`Added widget ${flags.widget} to space ${args.id}`);
+        this.log(`Added widget ${flags.widget} to space ${spaceRef}`);
     }
 }
 exports.default = SpacesWidgetsAdd;

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

@@ -20,15 +20,16 @@ class SpacesWidgetsList extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesWidgetsList);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let response;
         try {
-            response = await data_provider_1.dataService.listSpaceWidgets(args.id);
+            response = await data_provider_1.dataService.listSpaceWidgets(spaceRef);
         }
         catch (err) {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, args.id, 'widgets', response, [
+            this.log(JSON.stringify((0, space_output_1.withSpaceResourceUrls)(this.cliConfig.baseURL, spaceRef, 'widgets', response, [
                 'widgetId',
                 'id',
                 '_id',

package/dist/commands/spaces/widgets/remove.js

@@ -22,9 +22,10 @@ class SpacesWidgetsRemove extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesWidgetsRemove);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let confirmed;
         try {
-            confirmed = await (0, prompt_1.confirmDestructive)(`Remove widget ${args.widgetId} from space ${args.id}?`, flags.yes);
+            confirmed = await (0, prompt_1.confirmDestructive)(`Remove widget ${args.widgetId} from space ${spaceRef}?`, flags.yes);
         }
         catch (err) {
             this.error(err.message, {
@@ -37,7 +38,7 @@ class SpacesWidgetsRemove extends base_command_1.BaseCommand {
         }
         try {
             await data_provider_1.dataService.removeSpaceWidget({
-                spaceId: args.id,
+                spaceId: spaceRef,
                 widgetId: args.widgetId,
             });
         }
@@ -48,10 +49,10 @@ class SpacesWidgetsRemove extends base_command_1.BaseCommand {
             this.log(JSON.stringify({
                 success: true,
                 widgetId: args.widgetId,
-                url: (0, space_output_1.spacePerspectiveUrl)(this.cliConfig.baseURL, args.id, 'widgets'),
+                url: (0, space_output_1.spacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'widgets'),
             }, null, 2));
         else
-            this.log(`Removed widget ${args.widgetId} from space ${args.id}`);
+            this.log(`Removed widget ${args.widgetId} from space ${spaceRef}`);
     }
 }
 exports.default = SpacesWidgetsRemove;

package/dist/commands/spaces/work-graph.js

@@ -29,9 +29,10 @@ class SpacesWorkGraph extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(SpacesWorkGraph);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
         let response;
         try {
-            response = await data_provider_1.dataService.getSpaceWorkGraph(args.id);
+            response = await data_provider_1.dataService.getSpaceWorkGraph(spaceRef);
         }
         catch (err) {
             this.handleApiError(err);

package/dist/commands/store/install.d.ts

@@ -3,7 +3,7 @@ export default class StoreInstall extends BaseCommand {
     static description: string;
     static examples: string[];
     static args: {
-        agentId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+        agent: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
         json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;

package/dist/commands/store/install.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
+const agent_ref_1 = require("../../lib/agent-ref");
 const prompt_1 = require("../../lib/prompt");
 /**
  * One line per placement, said the same way the web install rail says it: the
@@ -17,14 +18,15 @@ class StoreInstall extends base_command_1.BaseCommand {
     static description = 'Install a published agent — you get your own copy of it. A paid agent shows its price and refund terms and asks you to confirm first.';
     static examples = [
         '<%= config.bin %> store install agent_abc123',
+        "<%= config.bin %> store install 'https://skrr.ai/a/agent_abc123?s=Ab12Cd34&ch=link'",
         '<%= config.bin %> store install agent_abc123 --release ar_def456',
         '<%= config.bin %> store install agent_abc123 --run-on local',
         '<%= config.bin %> store install agent_abc123 --share-outcomes',
         '<%= config.bin %> store install agent_abc123 --yes --json',
     ];
     static args = {
-        agentId: core_1.Args.string({
-            description: 'The store agent to install',
+        agent: core_1.Args.string({
+            description: 'The store agent to install: its id, or a link to it (a share link keeps its attribution)',
             required: true,
             ignoreStdin: true,
         }),
@@ -57,13 +59,26 @@ class StoreInstall extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(StoreInstall);
+        // A pasted share link credits the person who shared it, on the channel it
+        // was shared through; a bare id carries no attribution and sends none.
+        let ref;
+        try {
+            ref = await (0, agent_ref_1.resolveAgentRef)(args.agent, { baseURL: this.cliConfig?.baseURL });
+        }
+        catch (err) {
+            if (err instanceof agent_ref_1.AgentRefError) {
+                this.failWithCliError({ message: err.message, code: err.code, exit: 1, retryable: false });
+            }
+            this.handleApiError(err);
+        }
+        const { agentId } = ref;
         // The server still refuses a second install of a listing you own — this is
         // the friendly read that says so before a quote or a prompt (OSK-12287:
         // `installs` is the read model; `purchased` answers membership cheaply).
         let alreadyInstalled = false;
         try {
             const owned = await data_provider_1.dataService.getPurchasedAgents();
-            alreadyInstalled = (owned?.purchasedAgentIds ?? []).includes(args.agentId);
+            alreadyInstalled = (owned?.purchasedAgentIds ?? []).includes(agentId);
         }
         catch (err) {
             // A read failure must not block an install — the server re-checks anyway.
@@ -74,7 +89,7 @@ class StoreInstall extends base_command_1.BaseCommand {
             // an uninstalled copy is restored by the install route. Keep the server
             // as the final authority if this status read is unavailable.
             try {
-                const status = await data_provider_1.dataService.getAgentPurchaseStatus(args.agentId);
+                const status = await data_provider_1.dataService.getAgentPurchaseStatus(agentId);
                 if (status.purchased && status.stopReason === 'uninstalled') {
                     alreadyInstalled = false;
                 }
@@ -85,7 +100,7 @@ class StoreInstall extends base_command_1.BaseCommand {
             }
         }
         if (alreadyInstalled) {
-            this.error(`${args.agentId} is already installed. See it: skrr store updates, or update it: skrr store update ${args.agentId}`, { exit: 1 });
+            this.error(`${agentId} is already installed. See it: skrr store updates, or update it: skrr store update ${agentId}`, { exit: 1 });
         }
         // What installing would charge NOW, resolved by the server the way the
         // install resolves it (OSK-12240). The install then pins what was shown, so
@@ -93,7 +108,7 @@ class StoreInstall extends base_command_1.BaseCommand {
         let quote;
         try {
             quote = await data_provider_1.dataService.getStoreAgentAcquisitionQuote({
-                agentId: args.agentId,
+                agentId,
                 ...(flags.release ? { releaseId: flags.release } : {}),
             });
         }
@@ -107,7 +122,7 @@ class StoreInstall extends base_command_1.BaseCommand {
         }
         const charge = Number(quote.charge) || 0;
         if (charge > 0) {
-            const name = quote.listingName || args.agentId;
+            const name = quote.listingName || agentId;
             const version = quote.versionLabel ? ` v${quote.versionLabel}` : '';
             // Printed before any prompt and even with --yes, so a scripted purchase
             // still leaves the terms it agreed to in its own output.
@@ -129,7 +144,7 @@ class StoreInstall extends base_command_1.BaseCommand {
         let response;
         try {
             response = await data_provider_1.dataService.installStoreAgent({
-                agentId: args.agentId,
+                agentId,
                 ...(flags.release ? { releaseId: flags.release } : {}),
                 ...(flags.space ? { spaceId: flags.space } : {}),
                 ...(flags['include-bootstrap'] ? { includeBootstrap: true } : {}),
@@ -137,6 +152,7 @@ class StoreInstall extends base_command_1.BaseCommand {
                 // Pin what the person was shown: the charge always, the offer when
                 // there is one to charge under.
                 expectedPrice: charge,
+                ...(0, agent_ref_1.installAttribution)(ref.attribution),
                 ...(charge > 0 ? { expectedOfferVersionId: quote.offerVersionId } : {}),
                 ...(flags['run-on']
                     ? { executionPlacement: flags['run-on'] }

package/dist/commands/store/show.d.ts

@@ -0,0 +1,25 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * The Store listing of one published agent, in the terminal — what a buyer
+ * reads before `store install`: what it is, who published it, what it costs,
+ * how it is rated and used, what it is configured to touch, which release is
+ * current and what is known to be wrong with it.
+ *
+ * The listing itself (`GET /api/store/agents/:id`) is required. Publisher
+ * identity comes from the public read model (`/a/<id>` and `/p/@<handle>`),
+ * because the authenticated listing carries a mutable author name and no
+ * public handle; the release list is the same one `store releases` reads.
+ * Those three are side reads — when one fails the line says "unavailable",
+ * never "none", because "we could not tell" is a different fact.
+ */
+export default class StoreShow extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        agent: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/store/show.js

@@ -0,0 +1,203 @@
+"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 agent_ref_1 = require("../../lib/agent-ref");
+const format_1 = require("../../lib/format");
+const store_listing_1 = require("../../lib/store-listing");
+const web_url_1 = require("../../lib/web-url");
+/** How many releases the detail view lists; `store releases` lists them all. */
+const RECENT_RELEASES = 5;
+async function sideRead(read) {
+    try {
+        return { value: await read(), error: null };
+    }
+    catch (err) {
+        return { value: null, error: err?.message || 'unavailable' };
+    }
+}
+/**
+ * The Store listing of one published agent, in the terminal — what a buyer
+ * reads before `store install`: what it is, who published it, what it costs,
+ * how it is rated and used, what it is configured to touch, which release is
+ * current and what is known to be wrong with it.
+ *
+ * The listing itself (`GET /api/store/agents/:id`) is required. Publisher
+ * identity comes from the public read model (`/a/<id>` and `/p/@<handle>`),
+ * because the authenticated listing carries a mutable author name and no
+ * public handle; the release list is the same one `store releases` reads.
+ * Those three are side reads — when one fails the line says "unavailable",
+ * never "none", because "we could not tell" is a different fact.
+ */
+class StoreShow extends base_command_1.BaseCommand {
+    static description = 'Show a store listing: publisher, price, rating, installs, capability disclosure, releases, known issues and the install command';
+    static examples = [
+        '<%= config.bin %> store show agent_abc123',
+        '<%= config.bin %> store show agent_abc123 --json',
+    ];
+    static args = {
+        agent: core_1.Args.string({
+            description: 'The store agent: its id or a link to it (/a/<id>, a share link)',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output the listing, publisher and releases as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(StoreShow);
+        let ref;
+        try {
+            ref = await (0, agent_ref_1.resolveAgentRef)(args.agent, { baseURL: this.cliConfig.baseURL });
+        }
+        catch (err) {
+            if (err instanceof agent_ref_1.AgentRefError) {
+                this.failWithCliError({ message: err.message, code: err.code, exit: 1, retryable: false });
+            }
+            // Resolving a share code reads the server; its failure is an API failure.
+            this.handleApiError(err);
+        }
+        const { agentId } = ref;
+        let listing;
+        try {
+            listing = await data_provider_1.dataService.getStoreAgent(agentId);
+        }
+        catch (err) {
+            this.handleApiError(err, { subject: `store agent ${agentId}` });
+        }
+        const [releases, publicListing] = await Promise.all([
+            sideRead(() => data_provider_1.dataService.getStoreAgentReleases(agentId)),
+            sideRead(() => data_provider_1.dataService.getPublicAgentListing(agentId)),
+        ]);
+        const handle = publicListing.value?.publisher?.handle ?? null;
+        const publisherPage = handle
+            ? await sideRead(() => data_provider_1.dataService.getPublicPublisherPage(handle))
+            : { value: null, error: null };
+        const verifiedDomains = (publisherPage.value?.identityEvidence ?? [])
+            .filter((evidence) => evidence.kind === 'domain_control')
+            .map((evidence) => evidence.domain);
+        // A share link's attribution survives the echo: installing from the printed
+        // command credits the same share the person followed. A bare id has none.
+        const installTarget = ref.attribution.code || ref.attribution.channel
+            ? (0, agent_ref_1.shellQuote)((0, agent_ref_1.attributedListingUrl)(this.cliConfig.baseURL, ref))
+            : agentId;
+        const installCommand = `${this.config.bin} store install ${installTarget}`;
+        const listingUrl = (0, web_url_1.webUrl)(this.cliConfig.baseURL, { kind: 'storeListing', agentId });
+        const releaseRows = (releases.value?.data ?? []).slice(0, RECENT_RELEASES);
+        if (flags.json) {
+            this.log(JSON.stringify({
+                agent: listing,
+                publisher: {
+                    handle,
+                    displayName: publicListing.value?.publisher?.displayName ?? listing.authorName ?? null,
+                    path: publicListing.value?.publisher?.path ?? null,
+                    verifiedDomains: publisherPage.value ? verifiedDomains : null,
+                    ...(publicListing.error ? { listingError: publicListing.error } : {}),
+                    ...(publisherPage.error ? { profileError: publisherPage.error } : {}),
+                },
+                releases: releases.value ? releaseRows : null,
+                ...(releases.error ? { releasesError: releases.error } : {}),
+                url: listingUrl,
+                installCommand,
+            }, null, 2));
+            return;
+        }
+        const version = listing.versionLabel ? `v${listing.versionLabel}` : 'no version label';
+        this.log(`${listing.name}  (${agentId}, ${version})`);
+        if (listing.description)
+            this.log(`  ${(0, format_1.collapseWhitespace)(listing.description)}`);
+        this.log('');
+        // ── Publisher ──
+        let publisher;
+        if (publicListing.value?.publisher) {
+            publisher = `${publicListing.value.publisher.displayName} (@${publicListing.value.publisher.handle})`;
+        }
+        else if (publicListing.value) {
+            publisher = `${listing.authorName ?? 'Unknown'} (no public publisher profile)`;
+        }
+        else {
+            publisher = `${listing.authorName ?? 'Unknown'} (public profile unavailable: ${publicListing.error})`;
+        }
+        let domains;
+        if (!handle)
+            domains = publicListing.value ? 'None' : 'Unavailable';
+        else if (publisherPage.error)
+            domains = `Unavailable (${publisherPage.error})`;
+        else
+            domains = verifiedDomains.length > 0 ? verifiedDomains.join(', ') : 'None';
+        const active = typeof listing.activeInstalls30d === 'number'
+            ? `${listing.activeInstalls30d} active in the last 30 days`
+            : 'active count unavailable';
+        const summary = [
+            ['Publisher', publisher],
+            // Domain control proven by DNS — identity, never an endorsement.
+            ['Verified domain', domains],
+            ['Category', listing.category || '-'],
+            ['Price', (0, store_listing_1.formatListingPrice)(listing.price)],
+            ['Rating', (0, store_listing_1.formatListingRating)(listing.rating, listing.ratingCount)],
+            ['Installs', `${listing.installCount ?? 0} total, ${active}`],
+        ];
+        if (listing.computePayer !== undefined) {
+            summary.push(['Runs paid by', (0, data_provider_1.describeStoreComputePayer)(listing.computePayer)]);
+        }
+        if (listing.supportedLanguages?.length) {
+            summary.push(['Languages', `${listing.supportedLanguages.join(', ')} (publisher-declared)`]);
+        }
+        for (const line of (0, store_listing_1.labelledLines)(summary))
+            this.log(line);
+        // ── Capabilities and permissions ──
+        this.log('');
+        this.log('Capabilities and permissions');
+        for (const line of (0, store_listing_1.labelledLines)((0, store_listing_1.capabilityDisclosureRows)(listing.capabilityManifest))) {
+            this.log(line);
+        }
+        this.log(`  ${store_listing_1.CAPABILITY_DISCLOSURE_FOOTNOTE}`);
+        // ── Releases ──
+        this.log('');
+        this.log(`Current release: ${version}${listing.releaseNumber ? ` (release ${listing.releaseNumber})` : ''}` +
+            `${listing.latestReleaseId ? `, ${listing.latestReleaseId}` : ''}`);
+        if (listing.changelog)
+            this.log(`  ${(0, format_1.truncate)((0, format_1.collapseWhitespace)(listing.changelog), 160)}`);
+        if (releases.error) {
+            this.log(`Recent releases: unavailable (${releases.error})`);
+        }
+        else if (releaseRows.length > 0) {
+            this.log('Recent releases');
+            (0, format_1.renderTable)(releaseRows.map((r) => ({
+                version: r.versionLabel ? `v${r.versionLabel}` : '-',
+                id: String(r.id ?? '-'),
+                published: r.publishedAt ? String(r.publishedAt).slice(0, 10) : '-',
+                changelog: (0, format_1.collapseWhitespace)(String(r.changelog ?? '')),
+            })), [
+                { key: 'version', header: 'VERSION' },
+                { key: 'id', header: 'RELEASE ID' },
+                { key: 'published', header: 'PUBLISHED' },
+                { key: 'changelog', header: 'CHANGELOG', maxWidth: 48 },
+            ], (line) => this.log(`  ${line}`));
+            const total = releases.value?.data?.length ?? 0;
+            if (total > releaseRows.length || releases.value?.has_more) {
+                this.log(`  Older releases: ${this.config.bin} store releases ${agentId}`);
+            }
+        }
+        // ── Known issues ──
+        const issues = listing.knownIssues ?? [];
+        const open = issues.filter((issue) => issue.status === 'open');
+        this.log('');
+        if (issues.length === 0) {
+            this.log('Known issues: none posted for this release');
+        }
+        else {
+            this.log(`Known issues: ${open.length} open, ${issues.length - open.length} resolved`);
+            for (const issue of open)
+                this.log(`  - ${(0, format_1.collapseWhitespace)(issue.title)}`);
+        }
+        this.log('');
+        if (listingUrl)
+            this.log(`Listing: ${listingUrl}`);
+        this.log(`Install: ${installCommand}`);
+    }
+}
+exports.default = StoreShow;

package/dist/commands/store/stats.d.ts

@@ -0,0 +1,33 @@
+import { type StoreAgentInstallFunnelSummary, type StoreAgentReleaseAdoptionSummary, type StoreAgentReleaseOutcomes } from '@skrr-ai/data-provider';
+import { BaseCommand } from '../../base-command';
+/**
+ * The publisher's readouts for one of their own Store agents: how buyers move
+ * through the install funnel, which releases their copies are on, and how each
+ * release turns out in use.
+ *
+ * Every figure is k-anonymous and publisher-only (the author, or an owner/admin
+ * of the organisation the listing is published as) — the same readouts the web
+ * shows, under the same terms (I2): the seller side's own copies are excluded, a readout covering fewer buyers than its floor returns NO figures,
+ * and small rows are withheld. This command prints a withheld readout as
+ * withheld, with the floor it missed. It never prints 0 for one, because zero
+ * is a claim the server did not make.
+ *
+ * There is no `--since`. Each window is fixed by the server — a caller-chosen
+ * length would let `days=N` minus `days=N-1` isolate a single buyer — so the
+ * window a readout covers is printed with it instead.
+ */
+export default class StoreStats extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        agent: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        only: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}
+export declare function funnelLines(summary: StoreAgentInstallFunnelSummary): string[];
+export declare function adoptionLines(summary: StoreAgentReleaseAdoptionSummary): string[];
+export declare function outcomesLines(outcomes: StoreAgentReleaseOutcomes): string[];