@skrr-ai/cli 0.1.127 → 0.1.129

package/dist/commands/northstars/recommendations/list.d.ts

@@ -1,6 +1,6 @@
 import { BaseCommand } from '../../../base-command';
 /**
- * `skrr northstars recommendations <id>` — the deterministic reviewer's
+ * `skrr northstars recommendations list <id>` — the deterministic reviewer's
  * user-facing suggestions.
  *
  * These are NOT the same thing as management intents. A recommendation is

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

@@ -5,7 +5,7 @@ const core_1 = require("@oclif/core");
 const base_command_1 = require("../../../base-command");
 const northstars_1 = require("../../../lib/northstars");
 /**
- * `skrr northstars recommendations <id>` — the deterministic reviewer's
+ * `skrr northstars recommendations list <id>` — the deterministic reviewer's
  * user-facing suggestions.
  *
  * These are NOT the same thing as management intents. A recommendation is
@@ -16,8 +16,8 @@ const northstars_1 = require("../../../lib/northstars");
 class NorthstarsRecommendationsList extends base_command_1.BaseCommand {
     static description = "List a northstar's deterministic portfolio recommendations";
     static examples = [
-        '<%= config.bin %> northstars recommendations nst_abc123',
-        '<%= config.bin %> northstars recommendations nst_abc123 --status open',
+        '<%= config.bin %> northstars recommendations list nst_abc123',
+        '<%= config.bin %> northstars recommendations list nst_abc123 --status open',
     ];
     static args = {
         northstarId: core_1.Args.string({ ignoreStdin: true, description: 'Northstar ID', required: true }),

package/dist/commands/northstars/recommendations.d.ts

@@ -0,0 +1,19 @@
+import NorthstarsRecommendationsList from './recommendations/list';
+/**
+ * `skrr northstars recommendations <northstar-id>` — the topic's default: list them.
+ *
+ * Same reasoning as `northstars intents`: the help examples showed this form and it was
+ * answered with "is not a command". Listing is read-only, so it is the safe default;
+ * `recommendations apply` and `recommendations dismiss` still resolve to their own
+ * commands (the longest command id wins). With no northstar id it prints the topic help.
+ */
+export default class NorthstarsRecommendations extends NorthstarsRecommendationsList {
+    static description: string;
+    static examples: string[];
+    static args: typeof NorthstarsRecommendationsList.args;
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/northstars/recommendations.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const list_1 = __importDefault(require("./recommendations/list"));
+/**
+ * `skrr northstars recommendations <northstar-id>` — the topic's default: list them.
+ *
+ * Same reasoning as `northstars intents`: the help examples showed this form and it was
+ * answered with "is not a command". Listing is read-only, so it is the safe default;
+ * `recommendations apply` and `recommendations dismiss` still resolve to their own
+ * commands (the longest command id wins). With no northstar id it prints the topic help.
+ */
+class NorthstarsRecommendations extends list_1.default {
+    static description = "List a northstar's recommendations; subcommands: list, apply, dismiss (`recommendations <id>` is `recommendations list <id>`)";
+    static examples = [
+        '<%= config.bin %> northstars recommendations nst_abc123',
+        '<%= config.bin %> northstars recommendations nst_abc123 --status open',
+        '<%= config.bin %> northstars recommendations list nst_abc123',
+        '<%= config.bin %> northstars recommendations apply nst_abc123 <rec-id>',
+    ];
+    // Own, not inherited (see `northstars intents`).
+    static args = {
+        northstarId: core_1.Args.string({
+            ignoreStdin: true,
+            description: 'Northstar ID (omit to see the subcommands)',
+            required: false,
+        }),
+    };
+    static flags = list_1.default.flags;
+    async run() {
+        const { args } = await this.parse(NorthstarsRecommendations);
+        if (!args.northstarId) {
+            await this.config.runCommand('help', ['northstars', 'recommendations']);
+            return;
+        }
+        await super.run();
+    }
+}
+exports.default = NorthstarsRecommendations;

package/dist/commands/northstars/review-now.d.ts

@@ -16,6 +16,7 @@ export default class NorthstarsReviewNow extends BaseCommand {
     };
     static flags: {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        wide: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/northstars/review-now.js

@@ -23,6 +23,7 @@ class NorthstarsReviewNow extends base_command_1.BaseCommand {
     };
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        wide: northstars_1.northstarWideFlag,
     };
     async run() {
         this.requireAuth();
@@ -44,18 +45,28 @@ class NorthstarsReviewNow extends base_command_1.BaseCommand {
         if (review) {
             this.log(`Review      ${String(review.id)}  (${String(review.status)})`);
         }
-        const allocations = Array.isArray(result.allocations) ? result.allocations.length : 0;
-        this.log(`Allocations ${allocations} commitment(s) re-budgeted`);
+        this.log((0, northstars_1.describeReviewAllocations)(result));
+        // The allocation above gives each commitment at least 1/day; when the budget is smaller than
+        // the number of active commitments that adds up to more than the budget (OSK-21334).
+        const floorNote = (0, northstars_1.runBudgetFloorNote)(result.runBudgetFloor);
+        if (floorNote)
+            this.log(`  ! ${floorNote}`);
         this.log(`Applied     ${String(result.appliedIntents ?? 0)} intent(s)`);
         if (governanceRun) {
             this.log(governanceRun.reserved
                 ? `Agent run   ${String(governanceRun.runId)} reserved — results land asynchronously`
-                : `Agent run   not started (${String(governanceRun.reason ?? 'unknown')})`);
+                : `Agent run   not started: ${(0, northstars_1.describeNorthstarReason)(typeof governanceRun.reason === 'string' ? governanceRun.reason : undefined)}`);
         }
         const intents = review?.intents ?? [];
+        // An intent budget that cut the review short must not read as "nothing to report".
+        const snapshot = review?.deterministicSnapshot;
+        const governance = result.governance;
+        const budgetNote = (0, northstars_1.intentBudgetNote)(snapshot?.truncatedIntents, governance?.maxIntentsPerReview);
+        if (budgetNote)
+            this.log(budgetNote);
         if (intents.length) {
             this.log('');
-            (0, northstars_1.renderIntentList)(intents, (line) => this.log(line));
+            (0, northstars_1.renderIntentList)(intents, (line) => this.log(line), { wide: flags.wide });
         }
     }
 }

package/dist/commands/northstars/reviews.d.ts

@@ -18,6 +18,7 @@ export default class NorthstarsReviews extends BaseCommand {
         limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         review: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        wide: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/northstars/reviews.js

@@ -28,19 +28,32 @@ class NorthstarsReviews extends base_command_1.BaseCommand {
             description: 'Filter by review status',
             options: [...northstars_1.NORTHSTAR_REVIEW_STATUSES],
         }),
-        review: core_1.Flags.string({ description: 'Show ONE review in full, including its intents' }),
+        review: core_1.Flags.string({
+            description: 'Show ONE review in full, including its intents. Takes the full id or the short form `intents list` prints in REVIEW',
+        }),
+        wide: northstars_1.northstarWideFlag,
     };
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(NorthstarsReviews);
         if (flags.review) {
-            let review;
+            let looked;
             try {
-                review = await northstars_1.northstarApi.review(args.northstarId, flags.review);
+                // The full id, or the short form `northstars intents list` prints in REVIEW.
+                looked = await (0, northstars_1.lookupReview)(args.northstarId, flags.review);
             }
             catch (err) {
                 this.handleApiError(err);
             }
+            if ('ambiguous' in looked) {
+                this.failWithCliError({
+                    message: `\`${flags.review}\` is the start of ${looked.ambiguous.length} reviews of this northstar (${looked.ambiguous.join(', ')}). Pass more of the id.`,
+                    code: 'REVIEW_REF_AMBIGUOUS',
+                    exit: 2,
+                    retryable: false,
+                });
+            }
+            const review = looked.review;
             if (flags.json) {
                 this.log(JSON.stringify(review, null, 2));
                 return;
@@ -53,14 +66,20 @@ class NorthstarsReviews extends base_command_1.BaseCommand {
             if (review.autonomousRunId)
                 this.log(`Agent run  ${review.autonomousRunId}`);
             if (review.reason)
-                this.log(`Reason     ${review.reason}`);
+                this.log(`Reason     ${(0, northstars_1.describeReviewReason)(review.reason)}`);
             const snapshot = review.deterministicSnapshot;
             if (snapshot) {
                 this.log(`Health     ${String(snapshot.health ?? '—')}`);
                 this.log(`Allocations written ${String(snapshot.allocationsWritten ?? 0)}`);
             }
+            // A review the intent budget cut short is not a review with nothing to say.
+            const budgetNote = (0, northstars_1.intentBudgetNote)(snapshot?.truncatedIntents, snapshot?.intentCounts?.total);
+            if (budgetNote)
+                this.log(budgetNote);
             this.log('');
-            (0, northstars_1.renderIntentList)(review.intents ?? [], (line) => this.log(line));
+            if (budgetNote && (review.intents ?? []).length === 0)
+                return;
+            (0, northstars_1.renderIntentList)(review.intents ?? [], (line) => this.log(line), { wide: flags.wide });
             return;
         }
         let response;
@@ -77,7 +96,16 @@ class NorthstarsReviews extends base_command_1.BaseCommand {
             this.log(JSON.stringify(response, null, 2));
             return;
         }
-        (0, northstars_1.renderReviewList)(response.data ?? [], (line) => this.log(line));
+        const rows = response.data ?? [];
+        (0, northstars_1.renderReviewList)(rows, (line) => this.log(line));
+        const footer = (0, northstars_1.listFooter)({
+            shown: rows.length,
+            hasMore: response.has_more === true,
+            limit: flags.limit ?? 20,
+            max: 100,
+        });
+        if (footer)
+            this.log(footer);
     }
 }
 exports.default = NorthstarsReviews;

package/dist/commands/northstars/update.js

@@ -32,7 +32,10 @@ class NorthstarsUpdate extends base_command_1.BaseCommand {
         tier: core_1.Flags.string({ description: 'Priority tier', options: [...northstars_1.NORTHSTAR_PRIORITY_TIERS] }),
         weight: core_1.Flags.integer({ description: 'Priority weight (0..100)', min: 0, max: 100 }),
         'total-weight': core_1.Flags.integer({ description: 'Attention budget total weight', min: 0 }),
-        'max-active': core_1.Flags.integer({ description: 'Soft cap on active commitments', min: 0 }),
+        'max-active': core_1.Flags.integer({
+            description: 'Soft cap on active commitments (0 = no cap)',
+            min: 0,
+        }),
         goal: core_1.Flags.string({ description: 'Goal ID (repeatable; replaces the list)', multiple: true }),
         agent: core_1.Flags.string({
             description: 'Agent ID (repeatable; replaces the list)',
@@ -109,6 +112,10 @@ class NorthstarsUpdate extends base_command_1.BaseCommand {
             return;
         }
         this.log(`Updated ${northstar.id} — ${northstar.title} (${northstar.status}, v${northstar.version})`);
+        // 0 is stored, and a review treats it as "no cap": say so here, not only in `show` (OSK-21252).
+        if (flags['max-active'] !== undefined) {
+            this.log(`Attention   max active ${(0, northstars_1.describeMaxActive)(northstar.attentionBudget?.maxActiveCommitments ?? flags['max-active'])}`);
+        }
     }
 }
 exports.default = NorthstarsUpdate;

package/dist/commands/proposals/list.js

@@ -31,12 +31,21 @@ function emptyPageLines(narrowed, nextCursor) {
  * server could not read for this viewer is in `--json`), never "none".
  */
 function aboutFor(row) {
-    return [row.commitmentTitle, row.agent?.name].filter(Boolean).join(' · ') || '—';
+    const named = [row.commitmentTitle, row.agent?.name].filter(Boolean).join(' · ');
+    if (named)
+        return named;
+    // A Northstar intent that targets no commitment (a proposal to start one) is about its northstar.
+    const northstarId = row.decisionContext?.northstarId;
+    return northstarId ? `northstar ${northstarId}` : '—';
 }
 /** A snoozed proposal reads `proposed` in its disposition; the wake time is what tells them apart. */
 function noteFor(row) {
     if (row.sourceStatus === 'snoozed' && row.snoozedUntil)
         return `snoozed until ${row.snoozedUntil}`;
+    // The inbox files a policy refusal under `discarded`; for a Northstar intent say what it was.
+    const intent = (0, proposals_1.northstarIntentNote)(row);
+    if (intent)
+        return intent;
     if (!row.canDecide && row.undecidableReason && row.undecidableReason !== 'settled')
         return data_provider_1.PROPOSAL_UNDECIDABLE_TEXT[row.undecidableReason];
     return '—';
@@ -86,7 +95,7 @@ class ProposalsList extends base_command_1.BaseCommand {
         }
         (0, format_1.renderTable)(result.data.map((row) => ({
             id: row.id,
-            title: row.title,
+            title: (0, proposals_1.proposalTitleFor)(row),
             about: aboutFor(row),
             disposition: row.disposition,
             // Most proposals carry no estimate; "unknown" read as a failure to determine one (OSK-15377).

package/dist/commands/proposals/show.js

@@ -22,7 +22,7 @@ class ProposalsShow extends base_command_1.BaseCommand {
     static flags = { json: core_1.Flags.boolean() };
     async run() {
         this.requireAuth();
-        const { args } = await this.parse(ProposalsShow);
+        const { args, flags } = await this.parse(ProposalsShow);
         const ref = (0, proposals_1.resolveProposalRef)(args.kind, args.id, this.config?.bin);
         if ('error' in ref) {
             this.failWithCliError({
@@ -48,6 +48,14 @@ class ProposalsShow extends base_command_1.BaseCommand {
             }
             this.handleApiError(error);
         }
+        // A Northstar intent reads as words unless --json asks for the document; every other kind still
+        // prints its full JSON, so a script that reads it does not change.
+        const lines = flags.json ? null : (0, proposals_1.renderNorthstarIntentView)(result);
+        if (lines) {
+            for (const line of lines)
+                this.log(line);
+            return;
+        }
         this.log(JSON.stringify(result, null, 2));
     }
 }

package/dist/commands/spaces/auto-executor/preview.d.ts

@@ -1,5 +1,17 @@
-import { type SpaceAutoExecutorRefillState } from '@skrr-ai/data-provider';
+import { type SpaceAutoExecutorPreviewResponse, type SpaceAutoExecutorRefillState } from '@skrr-ai/data-provider';
 import { BaseCommand } from '../../../base-command';
+type PreviewSpace = SpaceAutoExecutorPreviewResponse['space'];
+/**
+ * "Can start" is a capacity figure, not a forecast. Printed bare next to a disabled autopilot
+ * it read as "one task will start now" (dogfooded: `Autopilot: disabled` / `Can start: 1 now`).
+ */
+export declare function canStartLine(space: Pick<PreviewSpace, 'autoExecuteEnabled'>, startsAvailable: number | null): string;
+/**
+ * Whether unattended work may run in the Space at all. Turning the board off does not revoke the
+ * principal and a revoked one keeps a disabled board silent, so the two have to be told apart.
+ * Returns null for a server that predates the field, so an old API prints no claim.
+ */
+export declare function principalLine(space: Pick<PreviewSpace, 'executionPrincipal'>, spaceRef: string): string | null;
 export default class SpacesAutoExecutorPreview extends BaseCommand {
     static description: string;
     static examples: string[];
@@ -18,3 +30,4 @@ export default class SpacesAutoExecutorPreview extends BaseCommand {
  * not report it; `null` is one that could not read it, and says so.
  */
 export declare function refillLines(refill: SpaceAutoExecutorRefillState | null | undefined): string[];
+export {};

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

@@ -1,10 +1,41 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.canStartLine = canStartLine;
+exports.principalLine = principalLine;
 exports.refillLines = refillLines;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
 const space_output_1 = require("../../../lib/space-output");
+/**
+ * "Can start" is a capacity figure, not a forecast. Printed bare next to a disabled autopilot
+ * it read as "one task will start now" (dogfooded: `Autopilot: disabled` / `Can start: 1 now`).
+ */
+function canStartLine(space, startsAvailable) {
+    const capacity = (0, data_provider_1.formatLimit)(startsAvailable);
+    return space.autoExecuteEnabled
+        ? `Can start:  ${capacity} now`
+        : `Can start:  nothing — autopilot is off (capacity ${capacity})`;
+}
+/**
+ * Whether unattended work may run in the Space at all. Turning the board off does not revoke the
+ * principal and a revoked one keeps a disabled board silent, so the two have to be told apart.
+ * Returns null for a server that predates the field, so an old API prints no claim.
+ */
+function principalLine(space, spaceRef) {
+    const principal = space.executionPrincipal;
+    if (principal === undefined)
+        return null;
+    if (principal === null) {
+        return ('Principal:  none — nothing may run unattended here. A Space owner sets one with ' +
+            `\`skrr spaces auto-executor update ${spaceRef} --enabled\`.`);
+    }
+    if (principal.status === 'active')
+        return `Principal:  active (version ${principal.version})`;
+    return (`Principal:  revoked${principal.revokeReason ? ` (${principal.revokeReason.replace(/_/g, ' ')})` : ''} — ` +
+        `nothing may run unattended here until a Space owner sets it again with ` +
+        `\`skrr spaces auto-executor update ${spaceRef} --enabled\`.`);
+}
 class SpacesAutoExecutorPreview extends base_command_1.BaseCommand {
     static description = 'Preview what a space auto-executor run would do';
     static examples = [
@@ -47,7 +78,10 @@ class SpacesAutoExecutorPreview extends base_command_1.BaseCommand {
         const { capacity } = plan;
         this.log(`Running:    ${(0, data_provider_1.formatRunningCapacity)(capacity.activeCount, capacity.maxActiveTasks)}` +
             (capacity.maxActiveTasks === null ? ' (no concurrency cap)' : ''));
-        this.log(`Can start:  ${(0, data_provider_1.formatLimit)(capacity.startsAvailable)} now`);
+        this.log(canStartLine(space, capacity.startsAvailable));
+        const principal = principalLine(space, spaceRef);
+        if (principal)
+            this.log(principal);
         if (capacity.budget && !capacity.budget.unlimited) {
             this.log(`Budget:     ${capacity.budget.consumedStarts}/${capacity.budget.maxStarts} starts used this round`);
         }

package/dist/commands/spaces/auto-executor/run.d.ts

@@ -1,4 +1,20 @@
 import { BaseCommand } from '../../../base-command';
+/** What `auto-execute-now` answered: `fired: false` carries the reason nothing started. */
+type RunNowAnswer = {
+    fired?: boolean;
+    reason?: string;
+    runId?: string;
+};
+/**
+ * Why a manual run did not start, in words, and whether that is a refusal or just "already busy".
+ * The route answers 200 with `fired: false` and a `reason`; printing "Triggered" for it told an
+ * owner a run had started when nothing had (a Space with no execution principal never runs).
+ * `busy` is the normal "one is already in flight" answer, not a failure.
+ */
+export declare function describeRunNotStarted(answer: RunNowAnswer, spaceRef: string): {
+    message: string;
+    busy: boolean;
+};
 export default class SpacesAutoExecutorRun extends BaseCommand {
     static description: string;
     static args: {
@@ -9,3 +25,4 @@ export default class SpacesAutoExecutorRun extends BaseCommand {
     };
     run(): Promise<void>;
 }
+export {};

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

@@ -1,9 +1,52 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeRunNotStarted = describeRunNotStarted;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
 const space_output_1 = require("../../../lib/space-output");
+/**
+ * Why a manual run did not start, in words, and whether that is a refusal or just "already busy".
+ * The route answers 200 with `fired: false` and a `reason`; printing "Triggered" for it told an
+ * owner a run had started when nothing had (a Space with no execution principal never runs).
+ * `busy` is the normal "one is already in flight" answer, not a failure.
+ */
+function describeRunNotStarted(answer, spaceRef) {
+    switch (answer.reason) {
+        case 'principal_missing_or_revoked':
+            return {
+                busy: false,
+                message: `Nothing ran: this Space has no active execution principal, so nothing may run unattended in it. ` +
+                    `A Space owner sets one with \`skrr spaces auto-executor update ${spaceRef} --enabled\`.`,
+            };
+        case 'no_lead_agent':
+            return {
+                busy: false,
+                message: `Nothing ran: this Space has no lead agent to run its board. ` +
+                    `Set one with \`skrr spaces update ${spaceRef} --lead-agent <agent-id>\`.`,
+            };
+        case 'space_not_found':
+            return { busy: false, message: `Nothing ran: Space ${spaceRef} was not found.` };
+        case 'disabled':
+            return {
+                busy: false,
+                message: `Nothing ran: auto-execution is turned off for this Space. ` +
+                    `Turn it on with \`skrr spaces auto-executor update ${spaceRef} --enabled\`.`,
+            };
+        case 'active_orchestration':
+        case 'lock_held':
+            return {
+                busy: true,
+                message: `A run is already in flight for this Space${answer.runId ? ` (${answer.runId})` : ''}; ` +
+                    `it carries this request, so no second one was started.`,
+            };
+        default:
+            return {
+                busy: false,
+                message: `Nothing ran${answer.reason ? ` (${answer.reason})` : ''}: the server did not start a run.`,
+            };
+    }
+}
 class SpacesAutoExecutorRun extends base_command_1.BaseCommand {
     static description = 'Run a space auto-executor immediately';
     static args = {
@@ -21,10 +64,25 @@ class SpacesAutoExecutorRun extends base_command_1.BaseCommand {
         catch (err) {
             this.handleApiError(err);
         }
-        if (flags.json)
+        const answer = (result ?? {});
+        const notStarted = answer.fired === false ? describeRunNotStarted(answer, spaceRef) : undefined;
+        if (flags.json) {
             this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'execution', { result }), null, 2));
-        else
+            // The payload above already says `fired: false`; the exit status says it too, so a
+            // script that only checks `$?` is not told a refusal succeeded.
+            if (notStarted && !notStarted.busy)
+                this.exit(1);
+            return;
+        }
+        if (!notStarted) {
             this.log(`Triggered auto-executor for space ${spaceRef}.`);
+            return;
+        }
+        if (notStarted.busy) {
+            this.log(notStarted.message);
+            return;
+        }
+        this.error(notStarted.message, { exit: 1 });
     }
 }
 exports.default = SpacesAutoExecutorRun;

package/dist/commands/spaces/auto-executor/runs.d.ts

@@ -1,7 +1,15 @@
-import { type SpaceJudgmentTurnRecord } from '@skrr-ai/data-provider';
+import { type SpaceJudgmentTurnRecord, type SpaceOrchestrationRunsResponse } from '@skrr-ai/data-provider';
 import { BaseCommand } from '../../../base-command';
 /** Who held the Space's judgment turn at this tick (OSK-18003). */
 export declare function judgmentTurnLabel(turn?: SpaceJudgmentTurnRecord): string;
+/**
+ * The first line of `runs`. The server's `enabled` is "the routine is active", which is false for a
+ * board the SYSTEM put to sleep as well as for one its owner turned off, so `runs` printed
+ * "Orchestration: disabled" for a sleeping board while `preview` said "enabled (sleeping: …)".
+ * Those are different states with different remedies (a task event wakes one; only the owner
+ * re-enables the other).
+ */
+export declare function orchestrationLine(result: Pick<SpaceOrchestrationRunsResponse, 'enabled' | 'autoExecuteEnabled' | 'lifecycleState' | 'suspensionReason'>): string;
 export default class SpacesAutoExecutorRuns extends BaseCommand {
     static description: string;
     static examples: string[];

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

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.judgmentTurnLabel = judgmentTurnLabel;
+exports.orchestrationLine = orchestrationLine;
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -16,6 +17,22 @@ function judgmentTurnLabel(turn) {
     }
     return '  turn: unreadable, Leader stood down';
 }
+/**
+ * The first line of `runs`. The server's `enabled` is "the routine is active", which is false for a
+ * board the SYSTEM put to sleep as well as for one its owner turned off, so `runs` printed
+ * "Orchestration: disabled" for a sleeping board while `preview` said "enabled (sleeping: …)".
+ * Those are different states with different remedies (a task event wakes one; only the owner
+ * re-enables the other).
+ */
+function orchestrationLine(result) {
+    if (result.autoExecuteEnabled === false)
+        return 'Orchestration: disabled (turned off by the owner)';
+    if (result.autoExecuteEnabled === true && result.lifecycleState === 'sleeping') {
+        const why = result.suspensionReason ? `: ${result.suspensionReason.replace(/_/g, ' ')}` : '';
+        return `Orchestration: sleeping${why} — enabled; a task that can start, or \`run\`, wakes it`;
+    }
+    return `Orchestration: ${result.enabled ? 'enabled' : 'disabled'}`;
+}
 class SpacesAutoExecutorRuns extends base_command_1.BaseCommand {
     static description = "List a space's recent auto-orchestration runs and its Lead health";
     static examples = [
@@ -46,7 +63,7 @@ class SpacesAutoExecutorRuns extends base_command_1.BaseCommand {
             this.log(JSON.stringify((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'execution', { result }), null, 2));
             return;
         }
-        this.log(`Orchestration: ${result.enabled ? 'enabled' : 'disabled'}`);
+        this.log(orchestrationLine(result));
         this.log(`Lead health:   ${result.leadHealth}`);
         if (result.consecutiveFailures > 0) {
             this.log(`Failures:      ${result.consecutiveFailures} consecutive`);

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

@@ -35,7 +35,6 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
-const node_buffer_1 = require("node:buffer");
 const node_crypto_1 = require("node:crypto");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
@@ -86,7 +85,7 @@ class SpacesFilesUpload extends base_command_1.BaseCommand {
         formData.append('spaceId', spaceRef);
         if (flags.folder)
             formData.append('folder_id', flags.folder);
-        formData.append('file', new node_buffer_1.Blob([bytes], { type: (0, file_mime_1.mimeTypeForFilename)(filename) }), filename);
+        formData.append('file', new Blob([bytes], { type: (0, file_mime_1.mimeTypeForFilename)(filename) }), filename);
         let uploaded;
         try {
             uploaded = await data_provider_1.dataService.uploadFile(formData);

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

@@ -8,8 +8,8 @@ const space_output_1 = require("../../../lib/space-output");
 class SpacesHeartbeatsCreate extends base_command_1.BaseCommand {
     static description = 'Create a heartbeat for an agent in a space';
     static examples = [
-        '<%= config.bin %> spaces heartbeats create <space-id> --agent <agent-id> --frequency "0 9 * * *" --prompt "Good morning"',
-        '<%= config.bin %> spaces heartbeats create <space-id> --agent <agent-id> --frequency "0 9 * * *" --prompt "Brief" --timezone America/New_York',
+        '<%= config.bin %> spaces heartbeats create <space-id> --agent <agent-id> --frequency daily --prompt "Good morning"',
+        '<%= config.bin %> spaces heartbeats create <space-id> --agent <agent-id> --frequency 4h --prompt "Brief" --timezone America/New_York',
         '<%= config.bin %> spaces heartbeats create <space-id> --from-json heartbeat.json',
     ];
     static args = {
@@ -21,10 +21,12 @@ class SpacesHeartbeatsCreate extends base_command_1.BaseCommand {
             description: 'Path to a JSON file (or "-" for stdin) to use as the request body',
         }),
         agent: core_1.Flags.string({ description: 'Agent ID (required unless set via --from-json)' }),
-        frequency: core_1.Flags.string({ description: 'Cron expression for heartbeat frequency' }),
+        frequency: core_1.Flags.string({
+            description: 'How often it runs, as a ladder key: 1m, 2m, 5m, 10m, 15m, 30m, hourly, 2h, 4h, 8h, daily, 2d, 4d, weekly, 2w. Not a cron expression. The time of day is fixed by the key (daily is 09:00 in --timezone).',
+        }),
         prompt: core_1.Flags.string({ description: 'Prompt sent to the agent on each heartbeat' }),
         timezone: core_1.Flags.string({
-            description: 'Timezone for the cron schedule (e.g. America/New_York)',
+            description: 'Timezone the schedule runs in (e.g. America/New_York)',
         }),
         'max-unread-before-extend': core_1.Flags.integer({
             description: 'Max unread messages before extending the schedule (1-10)',
@@ -63,7 +65,7 @@ class SpacesHeartbeatsCreate extends base_command_1.BaseCommand {
             });
         }
         if (!payload.frequency || typeof payload.frequency !== 'string') {
-            this.error('A frequency is required. Pass --frequency <cron> or include it in --from-json.', {
+            this.error('A frequency is required. Pass --frequency <key> (for example daily, or 4h) or include it in --from-json.', {
                 exit: 1,
             });
         }

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

@@ -8,7 +8,7 @@ const space_output_1 = require("../../../lib/space-output");
 class SpacesHeartbeatsUpdate extends base_command_1.BaseCommand {
     static description = 'Update a heartbeat for an agent in a space';
     static examples = [
-        '<%= config.bin %> spaces heartbeats update <space-id> <agent-id> --frequency "0 10 * * *"',
+        '<%= config.bin %> spaces heartbeats update <space-id> <agent-id> --frequency weekly',
         '<%= config.bin %> spaces heartbeats update <space-id> <agent-id> --enabled false',
         '<%= config.bin %> spaces heartbeats update <space-id> <agent-id> --from-json patch.json',
     ];
@@ -21,9 +21,11 @@ class SpacesHeartbeatsUpdate extends base_command_1.BaseCommand {
         'from-json': core_1.Flags.string({
             description: 'Path to a JSON file (or "-" for stdin) to use as the patch body',
         }),
-        frequency: core_1.Flags.string({ description: 'Cron expression for heartbeat frequency' }),
+        frequency: core_1.Flags.string({
+            description: 'How often it runs, as a ladder key: 1m, 2m, 5m, 10m, 15m, 30m, hourly, 2h, 4h, 8h, daily, 2d, 4d, weekly, 2w. Not a cron expression. The time of day is fixed by the key (daily is 09:00 in --timezone).',
+        }),
         prompt: core_1.Flags.string({ description: 'Prompt sent to the agent on each heartbeat' }),
-        timezone: core_1.Flags.string({ description: 'Timezone for the cron schedule' }),
+        timezone: core_1.Flags.string({ description: 'Timezone the schedule runs in' }),
         enabled: core_1.Flags.boolean({ description: 'Enable or disable the heartbeat', allowNo: true }),
         'max-unread-before-extend': core_1.Flags.integer({
             description: 'Max unread messages before extending (1-10)',