@skrr-ai/cli 0.1.128 → 0.1.130

package/dist/commands/commitments/plan.d.ts

@@ -18,6 +18,20 @@ import { BaseCommand } from '../../base-command';
  * the command body so it can be unit-tested without the oclif harness.
  */
 export declare function formatDroppedFields(droppedFields: string[] | undefined): string[];
+/**
+ * The zone a proposal's daily times will be read in, said before the person applies it (OSK-21336).
+ * The planner is not told a timezone unless `--timezone` is passed, and the proposal is printed as raw JSON,
+ * so "every day at 9am" came back as `times: ["09:00"]` with no zone; applied as it is, a daily cadence with
+ * no zone is read in UTC, while the web wizard writes the browser's zone for the same proposal and says so.
+ * Nothing for a proposal with no daily times.
+ */
+export declare function planTimezoneLines(proposal: {
+    cadence?: {
+        mode?: unknown;
+        times?: unknown;
+        timezone?: unknown;
+    };
+} | null | undefined, requestedTimezone?: string): string[];
 export default class CommitmentsPlan extends BaseCommand {
     static description: string;
     static examples: string[];

package/dist/commands/commitments/plan.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatDroppedFields = formatDroppedFields;
+exports.planTimezoneLines = planTimezoneLines;
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../base-command");
 const commitments_1 = require("../../lib/commitments");
@@ -36,6 +37,35 @@ function formatDroppedFields(droppedFields) {
         lines.push(`  - ${field}`);
     return lines;
 }
+/**
+ * The zone a proposal's daily times will be read in, said before the person applies it (OSK-21336).
+ * The planner is not told a timezone unless `--timezone` is passed, and the proposal is printed as raw JSON,
+ * so "every day at 9am" came back as `times: ["09:00"]` with no zone; applied as it is, a daily cadence with
+ * no zone is read in UTC, while the web wizard writes the browser's zone for the same proposal and says so.
+ * Nothing for a proposal with no daily times.
+ */
+function planTimezoneLines(proposal, requestedTimezone) {
+    const cadence = proposal?.cadence;
+    if (!cadence || cadence.mode !== 'daily' || !Array.isArray(cadence.times) || !cadence.times.length) {
+        return [];
+    }
+    const times = cadence.times.filter((time) => typeof time === 'string');
+    if (!times.length)
+        return [];
+    const label = `daily time${times.length === 1 ? '' : 's'} ${times.join(', ')}`;
+    if (typeof cadence.timezone === 'string' && cadence.timezone) {
+        return ['', `The ${label} ${times.length === 1 ? 'is' : 'are'} read in ${cadence.timezone}.`];
+    }
+    return [
+        '',
+        `Note: the ${label} ${times.length === 1 ? 'carries' : 'carry'} no timezone, so applying this as it is reads ` +
+            `${times.length === 1 ? 'it' : 'them'} in UTC (the web wizard would use your browser's zone). ` +
+            (requestedTimezone
+                ? `You planned with --timezone ${requestedTimezone}, but the proposal did not keep it: add "timezone": ` +
+                    `"${requestedTimezone}" to its cadence.`
+                : 'Add "timezone": "<IANA zone>" to its cadence, or plan again with --timezone <IANA zone>.'),
+    ];
+}
 class CommitmentsPlan extends base_command_1.BaseCommand {
     static description = 'Draft a commitment contract from a sentence (read-only proposal — nothing is created)';
     static examples = [
@@ -115,6 +145,8 @@ class CommitmentsPlan extends base_command_1.BaseCommand {
             this.log('No proposal produced.');
             return;
         }
+        for (const line of planTimezoneLines(response.proposal, flags.timezone))
+            this.log(line);
         this.log('');
         this.log('Proposed contract:');
         this.log(JSON.stringify(response.proposal, null, 2));

package/dist/commands/commitments/preflight.d.ts

@@ -43,7 +43,7 @@ export declare function nextRunsLines(report: {
  * observes. The headline carries the caveat instead of contradicting the gate below it.
  */
 export declare function preflightHeadline(report: Pick<CommitmentPreflightReport, 'verdict' | 'gates'>, persisted: boolean): string;
-export declare function preflightGateLines(gate: PreflightGate, verbose?: boolean): string[];
+export declare function preflightGateLines(gate: PreflightGate, verbose?: boolean, refusesActivation?: boolean): string[];
 /**
  * The `Attention:` footer, and under it the settings behind the verdict (OSK-21120).
  *

package/dist/commands/commitments/preflight.js

@@ -63,7 +63,7 @@ function preflightHeadline(report, persisted) {
         ? `${label}: Ready to run, but its daily Run budget is 0, so no agent turn will start`
         : `${label}: Ready to run`;
 }
-function preflightGateLines(gate, verbose = false) {
+function preflightGateLines(gate, verbose = false, refusesActivation = false) {
     // "Could it contact you now?" is not a Run gate. It answers whether a message
     // would reach the owner, and a limit the owner set themselves (zero nudges a day,
     // quiet hours) is a chosen quiet, not a defect. It carried the same BLOCK tag, a
@@ -94,7 +94,13 @@ function preflightGateLines(gate, verbose = false) {
     // A `block` the report itself marks advisory stops nothing: it is not a Run-admission gate, so it
     // never feeds the verdict or `pack activate`. Printed BLOCK, `pack preflight` read "ready" above
     // two BLOCK lines (dogfooded on a goal_advance draft); the tag has to mean what the report means.
-    const advisoryBlock = gate.verdict === 'block' && gate.admission === 'advisory';
+    //
+    // An advisory gate the SERVER says refuses activation is a different case (OSK-21258): `resume`
+    // answers 409 for it, so it is tagged BLOCK and says what it stops. `info (advisory: does not stop a
+    // run)` beside an "Activation: would be refused" section naming the same gate was two answers to one
+    // question.
+    const advisoryBlock = gate.verdict === 'block' && gate.admission === 'advisory' && !refusesActivation;
+    const stopsActivationOnly = gate.verdict === 'block' && gate.admission === 'advisory' && refusesActivation;
     const mark = advisoryBlock
         ? 'info'
         : gate.verdict === 'pass'
@@ -119,7 +125,8 @@ function preflightGateLines(gate, verbose = false) {
     const showReason = verbose || (gate.verdict === 'block' && !hasNote);
     const lines = [
         `  ${mark.padEnd(5)} ${gate.label}${showReason && gate.reason ? ` — ${gate.reason}` : ''}` +
-            (advisoryBlock ? ' (advisory: does not stop a run)' : ''),
+            (advisoryBlock ? ' (advisory: does not stop a run)' : '') +
+            (stopsActivationOnly ? ' (stops activation, not a run that is already live)' : ''),
     ];
     if (hasNote) {
         lines.push(`        ${String(note).trim()}`);
@@ -280,7 +287,8 @@ class CommitmentsPreflight extends base_command_1.BaseCommand {
         }
         this.log('\nGates:');
         for (const gate of report.gates || []) {
-            for (const line of preflightGateLines(gate, flags.verbose))
+            const refusesActivation = (0, commitments_1.gateRefusesActivation)(report.activation, gate);
+            for (const line of preflightGateLines(gate, flags.verbose, refusesActivation))
                 this.log(line);
         }
         if (report.capabilities?.length) {

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

@@ -1,4 +1,13 @@
 import { BaseCommand } from '../../base-command';
+/**
+ * What `show --json` prints, said where the flag is read (OSK-21334, from OSK-21205): the server's
+ * read envelope, with the commitment UNDER `.commitment`. `create --json` and `update --json` print
+ * the commitment itself, so a script written against one raised `KeyError: 'priority'` on the other.
+ * The shape is kept (moving the commitment up a level would break every reader of `show --json`) and
+ * no top-level copy is added; `docs/cli/SKRR_COMMITMENTS.md` says why, and
+ * `__tests__/json-shapes.spec.ts` runs both commands against this sentence.
+ */
+export declare const SHOW_JSON_DESCRIPTION: string;
 /**
  * `skrr commitments show <id>` — the commitment's contract + live control-loop
  * state (health, last check, next check, unresolved-check streak), plus the most

package/dist/commands/commitments/show.js

@@ -1,10 +1,22 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SHOW_JSON_DESCRIPTION = void 0;
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../base-command");
 const commitments_1 = require("../../lib/commitments");
 const web_url_1 = require("../../lib/web-url");
 const commitment_product_1 = require("../../lib/commitment-product");
+/**
+ * What `show --json` prints, said where the flag is read (OSK-21334, from OSK-21205): the server's
+ * read envelope, with the commitment UNDER `.commitment`. `create --json` and `update --json` print
+ * the commitment itself, so a script written against one raised `KeyError: 'priority'` on the other.
+ * The shape is kept (moving the commitment up a level would break every reader of `show --json`) and
+ * no top-level copy is added; `docs/cli/SKRR_COMMITMENTS.md` says why, and
+ * `__tests__/json-shapes.spec.ts` runs both commands against this sentence.
+ */
+exports.SHOW_JSON_DESCRIPTION = 'Output the read envelope as JSON: { commitment, latestCheck, operatingState, abilities, url }. ' +
+    'The commitment itself is under .commitment (so the priority is .commitment.priority); ' +
+    'create --json and update --json print the commitment unwrapped.';
 /**
  * `skrr commitments show <id>` — the commitment's contract + live control-loop
  * state (health, last check, next check, unresolved-check streak), plus the most
@@ -18,12 +30,13 @@ class CommitmentsShow extends base_command_1.BaseCommand {
     static examples = [
         '<%= config.bin %> commitments show <commitment-id>',
         '<%= config.bin %> commitments show <commitment-id> --json',
+        "<%= config.bin %> commitments show <commitment-id> --json | jq '.commitment.priority'",
     ];
     static args = {
         id: core_1.Args.string({ description: 'Commitment ID', required: true, ignoreStdin: true }),
     };
     static flags = {
-        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        json: core_1.Flags.boolean({ description: exports.SHOW_JSON_DESCRIPTION }),
         verbose: core_1.Flags.boolean({
             description: 'Include raw compatibility policy and check diagnostics',
         }),

package/dist/commands/compass/revisions.d.ts

@@ -1,6 +1,10 @@
 import { BaseCommand } from '../../base-command';
-/** What to say under a list the ledger had more rows for. */
-export declare function revisionsFooter(shown: number): string;
+/**
+ * What to say under a list the ledger had more rows for. `total` is the API's own count of the
+ * ledger; with it the footer is exact (`Showing 20 of 25`). A server that does not send it, or one
+ * whose count is not above what was shown, still gets the lookahead's true "at least" wording.
+ */
+export declare function revisionsFooter(shown: number, total?: number): string;
 /**
  * `skrr compass revisions <compass-id> --agent <id>` — the append-only ledger.
  *

package/dist/commands/compass/revisions.js

@@ -4,11 +4,18 @@ exports.revisionsFooter = revisionsFooter;
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../base-command");
 const compasses_1 = require("../../lib/compasses");
-/** What to say under a list the ledger had more rows for. */
-function revisionsFooter(shown) {
+/**
+ * What to say under a list the ledger had more rows for. `total` is the API's own count of the
+ * ledger; with it the footer is exact (`Showing 20 of 25`). A server that does not send it, or one
+ * whose count is not above what was shown, still gets the lookahead's true "at least" wording.
+ */
+function revisionsFooter(shown, total) {
+    const of = typeof total === 'number' && Number.isInteger(total) && total > shown
+        ? `${total}`
+        : `at least ${shown + 1}`;
     return shown >= 100
-        ? `Showing ${shown} of at least ${shown + 1} revisions. --limit is capped at 100, so older ones cannot be listed yet.`
-        : `Showing ${shown} of at least ${shown + 1} revisions — use --limit (up to 100) to see more.`;
+        ? `Showing ${shown} of ${of} revisions. --limit is capped at 100, so older ones cannot be listed yet.`
+        : `Showing ${shown} of ${of} revisions — use --limit (up to 100) to see more.`;
 }
 /**
  * `skrr compass revisions <compass-id> --agent <id>` — the append-only ledger.
@@ -55,8 +62,9 @@ class CompassRevisions extends base_command_1.BaseCommand {
         (0, compasses_1.renderRevisionList)(rows, (line) => this.log(line));
         // The API reads one row past the page, so `has_more` is true only when older rows exist. A
         // 22-revision ledger used to list 20 rows and stop, with v1 (the create) silently missing.
+        // `total` (the ledger's own count) makes the footer exact when the server sends it.
         if (response.has_more)
-            this.log(revisionsFooter(rows.length));
+            this.log(revisionsFooter(rows.length, response.total));
     }
 }
 exports.default = CompassRevisions;

package/dist/commands/compass/tactic.d.ts

@@ -7,6 +7,10 @@ import { BaseCommand } from '../../base-command';
  * purpose: expressing an append as a full-object write would let two concurrent
  * learners clobber each other's entry. It says which of appended / updated /
  * unchanged happened, and names any tactic that rolled off the end.
+ *
+ * `--invariant <target-id>` chooses the invariant target the tactic is filed under. Without it
+ * the API files it under the general target (the one with no domain), else the first, and the
+ * output says which; a Compass whose targets all carry a domain used to leave no way to choose.
  */
 export default class CompassTactic extends BaseCommand {
     static description: string;
@@ -19,6 +23,7 @@ export default class CompassTactic extends BaseCommand {
         agent: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         description: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         id: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        invariant: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         reason: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
     run(): Promise<void>;

package/dist/commands/compass/tactic.js

@@ -11,11 +11,16 @@ const compasses_1 = require("../../lib/compasses");
  * purpose: expressing an append as a full-object write would let two concurrent
  * learners clobber each other's entry. It says which of appended / updated /
  * unchanged happened, and names any tactic that rolled off the end.
+ *
+ * `--invariant <target-id>` chooses the invariant target the tactic is filed under. Without it
+ * the API files it under the general target (the one with no domain), else the first, and the
+ * output says which; a Compass whose targets all carry a domain used to leave no way to choose.
  */
 class CompassTactic extends base_command_1.BaseCommand {
     static description = 'Record a learned tactic on a compass (appends, or updates the tactic with the same --id)';
     static examples = [
         '<%= config.bin %> compass tactic agch_abc --agent agent_xyz --description "Roll back before paging on a deploy regression"',
+        '<%= config.bin %> compass tactic agch_abc --agent agent_xyz --invariant invariant_2 --description "Page the owner before restarting"',
     ];
     static args = {
         compassId: core_1.Args.string({ ignoreStdin: true, description: 'Compass ID', required: true }),
@@ -27,17 +32,26 @@ class CompassTactic extends base_command_1.BaseCommand {
         id: core_1.Flags.string({
             description: 'Stable tactic ID. A known ID with a different description updates that entry; with the same description nothing is written.',
         }),
+        invariant: core_1.Flags.string({
+            description: 'Invariant target ID to file the tactic under (the `id` that `compass show` prints for each target). ' +
+                'Default: the general target (the one with no domain), else the first. An unknown ID is refused with the IDs the compass has; ' +
+                'a tactic --id that already lives on another target is refused too, so name that target to update it.',
+        }),
         reason: core_1.Flags.string({ description: 'Why — recorded on the revision ledger' }),
     };
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(CompassTactic);
+        if (flags.invariant !== undefined && !flags.invariant.trim()) {
+            this.error('--invariant needs an invariant target ID. `compass show` prints each target as `id <id>`; leave --invariant off to use the default target.');
+        }
         let compass;
         try {
             compass = await compasses_1.compassApi.appendTactic(args.compassId, {
                 agentId: flags.agent,
                 description: flags.description,
                 ...(flags.id ? { id: flags.id } : {}),
+                ...(flags.invariant ? { invariantTargetId: flags.invariant.trim() } : {}),
                 ...(flags.reason ? { reason: flags.reason } : {}),
             });
         }

package/dist/commands/followups/plans/create.js

@@ -29,7 +29,7 @@ class LookbackPlansCreate extends base_command_1.BaseCommand {
         try {
             const result = await lookbackPlans_1.lookbackPlansApi.create(body);
             if (flags.json) {
-                this.log(JSON.stringify(result, null, 2));
+                this.printJsonResult(result);
                 return;
             }
             // The four create commands say when the server recorded weaker provenance than the CLI

package/dist/commands/harnesses/list.js

@@ -96,7 +96,7 @@ function emptyListMessage(input) {
 exports.ALIAS_MARKER = '*';
 function harnessNameCell(row) {
     // The same rule the web sidebar renders (OSK-9290): a name stored under an
-    // older spelling or `oversky …` name is not a second product.
+    // older spelling or retired-brand name is not a second product.
     const name = row.name ? (0, data_provider_1.canonicalizeHarnessLabel)(row.name) : (0, format_1.formatCell)(row.name);
     return (0, harness_labels_1.isAliasCoveringSharedName)(row) ? `${exports.ALIAS_MARKER} ${name}` : name;
 }

package/dist/commands/northstars/create.js

@@ -15,10 +15,11 @@ const HOUR_MS = 60 * 60 * 1000;
  * `skrr northstars governance configure`.
  */
 class NorthstarsCreate extends base_command_1.BaseCommand {
-    static description = 'Create a northstar (the portfolio layer above commitments)';
+    static description = `Create a northstar (the portfolio layer above commitments)\n\n${northstars_1.NORTHSTAR_WORKSPACE_CREATE_HELP}`;
     static examples = [
         '<%= config.bin %> northstars create --title "Reach $10M ARR"',
         '<%= config.bin %> northstars create --title "Reliability" --tier critical --max-active 5 --review-interval-hours 24',
+        '<%= config.bin %> northstars create --title "Reliability" --workspace <workspace-id>',
     ];
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
@@ -98,6 +99,10 @@ class NorthstarsCreate extends base_command_1.BaseCommand {
         }
         this.log(`Created ${created.id} — ${created.title} (${created.status})`);
         this.log(`URL: ${created.url ?? '-'}`);
+        this.log((0, northstars_1.northstarWorkspaceLine)(created));
+        const workspaceNote = (0, northstars_1.createdNorthstarNote)(created);
+        if (workspaceNote)
+            this.log(workspaceNote);
         if (flags['max-active'] === 0)
             this.log('Attention   max active 0 (no cap)');
         this.log(flags['review-interval-hours'] !== undefined

package/dist/commands/northstars/governance/configure.js

@@ -45,7 +45,7 @@ class NorthstarsGovernanceConfigure extends base_command_1.BaseCommand {
             multiple: true,
         }),
         'require-approval-for': core_1.Flags.string({
-            description: 'Change class that always needs a human (repeatable; replaces the current list)',
+            description: `Change class that always needs a human (repeatable; replaces the current list). ${northstars_1.CRITICAL_COMMITMENT_APPROVAL_NOTE}. With critical_commitment removed, a bounded_auto review may apply a one-tier-step promotion to critical without asking`,
             options: [...northstars_1.NORTHSTAR_APPROVAL_TRIGGERS],
             multiple: true,
         }),

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

@@ -74,14 +74,13 @@ class NorthstarsIntentsDecide extends base_command_1.BaseCommand {
                         (ctx.decision === 'reject' && verdict === 'rejected'));
                 if (alreadyHolds) {
                     if (flags.json) {
-                        this.log(JSON.stringify({
-                            ok: true,
+                        this.printJsonResult({
                             verdict,
                             replayed: true,
                             ...(body.decidedAt ? { decidedAt: body.decidedAt } : {}),
                             ...(body.decidedByYou !== undefined ? { decidedByYou: body.decidedByYou } : {}),
                             reasonText: text,
-                        }, null, 2));
+                        });
                     }
                     else {
                         this.log(`${args.intentId} → ${verdict}`);

package/dist/commands/northstars/list.js

@@ -12,7 +12,7 @@ const northstars_1 = require("../../lib/northstars");
  * their health on a cadence.
  */
 class NorthstarsList extends base_command_1.BaseCommand {
-    static description = 'List northstars (the portfolio layer above commitments)';
+    static description = `List northstars (the portfolio layer above commitments)\n\nThe WORKSPACE column is a shortened workspace id (--json has the full workspaceId) or "personal". ${northstars_1.NORTHSTAR_WORKSPACE_READ_HELP}`;
     static examples = [
         '<%= config.bin %> northstars list',
         '<%= config.bin %> northstars list --status active',

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

@@ -46,6 +46,11 @@ class NorthstarsReviewNow extends base_command_1.BaseCommand {
             this.log(`Review      ${String(review.id)}  (${String(review.status)})`);
         }
         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

package/dist/commands/northstars/reviews.js

@@ -28,20 +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;

package/dist/commands/northstars/show.js

@@ -27,7 +27,7 @@ function normalizeNorthstarShowResponse(status) {
  * asking of a portfolio, which is what is actually in it.
  */
 class NorthstarsShow extends base_command_1.BaseCommand {
-    static description = 'Show a northstar, its linked commitments, and open recommendations';
+    static description = `Show a northstar, its linked commitments, and open recommendations\n\nThe Workspace line is the full workspace id, or "personal". ${northstars_1.NORTHSTAR_WORKSPACE_READ_HELP}`;
     static examples = [
         '<%= config.bin %> northstars show nst_abc123',
         '<%= config.bin %> northstars show nst_abc123 --json',

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/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/status.js

@@ -49,6 +49,16 @@ class SpacesHeartbeatsStatus extends base_command_1.BaseCommand {
         this.log(`Running:        ${s.isRunning === true ? 'yes' : 'no'}`);
         this.log(`Next Run:       ${s.nextRunAt ? (0, format_1.localTime)(s.nextRunAt) : '-'}`);
         this.log(`BullMQ Job Key: ${s.bullmqJobKey ?? '-'}`);
+        // The newest fire and what became of it. `Next Run` moves whether or not a fire does anything,
+        // so a heartbeat the agent's policy skips on every fire would otherwise read as healthy.
+        const fire = s.lastFire;
+        if (fire && typeof fire === 'object') {
+            const what = [fire.outcome, fire.reason].filter(Boolean).join(': ');
+            this.log(`Last Fire:      ${fire.firedAt ? (0, format_1.localTime)(fire.firedAt) : '-'}  ${what || '-'}`);
+            if (fire.outcome === 'skipped') {
+                this.log('The last fire did nothing: the heartbeat was skipped, not run. `skrr triggers audit` lists every fire.');
+            }
+        }
     }
 }
 exports.default = SpacesHeartbeatsStatus;

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)',

package/dist/commands/store/artifacts/releases.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * Your own publication history for one skill, newest first, with the admission
+ * state a curator left on each release. `store artifacts receipt` reads one
+ * release in full.
+ */
+export default class StoreArtifactsReleases extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        entityType: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        entityId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        before: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}