@skrr-ai/cli 0.1.126 → 0.1.128

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

@@ -11,6 +11,12 @@ const northstars_1 = require("../../../lib/northstars");
  * hours later against a portfolio that has since changed is invalidated rather
  * than forced through. That is the point of approving an INTENT rather than
  * queueing a command.
+ *
+ * ONE exit rule: the command exits 0 only when the thing asked for now holds
+ * (an approval left the intent `applied`, a rejection left it `rejected`).
+ * Retrying a decision that already took effect is a replay and also exits 0;
+ * everything else exits 1 with a sentence, and `--json` keeps the raw code plus
+ * `reasonText`.
  */
 class NorthstarsIntentsDecide extends base_command_1.BaseCommand {
     static description = 'Approve or reject a pending northstar management intent';
@@ -40,32 +46,80 @@ class NorthstarsIntentsDecide extends base_command_1.BaseCommand {
         if (!flags.approve && !flags.reject) {
             this.error('Pass --approve or --reject.');
         }
+        const ctx = {
+            northstarId: args.northstarId,
+            intentId: args.intentId,
+            decision: flags.approve ? 'approve' : 'reject',
+            bin: this.config.bin,
+        };
         let result;
         try {
             result = await northstars_1.northstarApi.decideIntent(args.northstarId, args.intentId, {
-                decision: flags.approve ? 'approve' : 'reject',
+                decision: ctx.decision,
                 ...(flags.review ? { reviewId: flags.review } : {}),
             });
         }
         catch (err) {
+            // The server refuses a decision with a bare code (`northstar_version_drift`,
+            // `intent_not_pending`). Say what it means, and keep the code.
+            const status = err?.status;
+            const { body } = (0, base_command_1.apiRefusal)(err);
+            if ((status === 404 || status === 409) && body && typeof body.reason === 'string') {
+                const { code, text } = (0, northstars_1.describeDecisionRefusal)(body, ctx);
+                // A retry of a decision that already took effect (the first response was
+                // lost, or a hedge raced itself) leaves the state that was asked for.
+                const verdict = typeof body.verdict === 'string' ? body.verdict : undefined;
+                const alreadyHolds = code === 'intent_not_pending' &&
+                    ((ctx.decision === 'approve' && verdict === 'applied') ||
+                        (ctx.decision === 'reject' && verdict === 'rejected'));
+                if (alreadyHolds) {
+                    if (flags.json) {
+                        this.log(JSON.stringify({
+                            ok: true,
+                            verdict,
+                            replayed: true,
+                            ...(body.decidedAt ? { decidedAt: body.decidedAt } : {}),
+                            ...(body.decidedByYou !== undefined ? { decidedByYou: body.decidedByYou } : {}),
+                            reasonText: text,
+                        }, null, 2));
+                    }
+                    else {
+                        this.log(`${args.intentId} → ${verdict}`);
+                        this.log(text);
+                    }
+                    return;
+                }
+                this.failWithCliError({
+                    message: text,
+                    code,
+                    status,
+                    exit: 1,
+                    retryable: false,
+                    details: { ...body, reasonText: text },
+                });
+            }
             this.handleApiError(err);
         }
-        if (flags.json) {
-            this.log(JSON.stringify(result, null, 2));
-            return;
-        }
-        const verdict = String(result.verdict ?? 'unknown');
-        if (result.proposalOnly) {
-            // A proposal is a decision to act BY HAND. Saying so avoids the reasonable
-            // assumption that approving it made something happen.
-            this.log(`Recorded: ${args.intentId} approved as a proposal — no mutation was performed.`);
+        const outcome = (0, northstars_1.describeDecisionOutcome)(result, ctx);
+        if (outcome.exitCode === 0) {
+            if (flags.json) {
+                this.log(JSON.stringify({ ...result, ...(outcome.text ? { reasonText: outcome.text } : {}) }, null, 2));
+                return;
+            }
+            this.log(outcome.headline);
+            if (outcome.text)
+                this.log(outcome.text);
             return;
         }
-        this.log(`${args.intentId} → ${verdict}`);
-        const applyResult = result.applyResult;
-        if (applyResult && applyResult.applied !== true && applyResult.reason) {
-            this.log(`Not applied: ${String(applyResult.reason)}`);
-        }
+        if (!flags.json)
+            this.log(outcome.headline);
+        this.failWithCliError({
+            message: outcome.text ?? outcome.headline,
+            code: outcome.code ?? 'intent_not_applied',
+            exit: 1,
+            retryable: false,
+            details: { ...result, reasonText: outcome.text },
+        });
     }
 }
 exports.default = NorthstarsIntentsDecide;

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

@@ -1,6 +1,6 @@
 import { BaseCommand } from '../../../base-command';
 /**
- * `skrr northstars intents <northstar-id>` — management intents across recent
+ * `skrr northstars intents list <northstar-id>` — management intents across recent
  * reviews, newest first.
  *
  * Flattened across reviews on purpose: the question a person asks is "what is
@@ -17,6 +17,7 @@ export default class NorthstarsIntentsList extends BaseCommand {
         json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        wide: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/northstars/intents/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 intents <northstar-id>` — management intents across recent
+ * `skrr northstars intents list <northstar-id>` — management intents across recent
  * reviews, newest first.
  *
  * Flattened across reviews on purpose: the question a person asks is "what is
@@ -15,9 +15,9 @@ const northstars_1 = require("../../../lib/northstars");
 class NorthstarsIntentsList extends base_command_1.BaseCommand {
     static description = 'List northstar management intents (default: everything recent)';
     static examples = [
-        '<%= config.bin %> northstars intents nst_abc123',
-        '<%= config.bin %> northstars intents nst_abc123 --status awaiting_approval',
-        '<%= config.bin %> northstars intents nst_abc123 --status applied --json',
+        '<%= config.bin %> northstars intents list nst_abc123',
+        '<%= config.bin %> northstars intents list nst_abc123 --status awaiting_approval',
+        '<%= config.bin %> northstars intents list nst_abc123 --status applied --json',
     ];
     static args = {
         northstarId: core_1.Args.string({ ignoreStdin: true, description: 'Northstar ID', required: true }),
@@ -29,6 +29,7 @@ class NorthstarsIntentsList extends base_command_1.BaseCommand {
             options: [...northstars_1.NORTHSTAR_INTENT_VERDICTS],
         }),
         limit: core_1.Flags.integer({ description: 'Max intents (1..500)', min: 1, max: 500 }),
+        wide: northstars_1.northstarWideFlag,
     };
     async run() {
         this.requireAuth();
@@ -47,7 +48,16 @@ class NorthstarsIntentsList extends base_command_1.BaseCommand {
             this.printJsonResult((0, list_output_1.listResult)(response));
             return;
         }
-        (0, northstars_1.renderIntentList)(response.data ?? [], (line) => this.log(line));
+        const rows = response.data ?? [];
+        (0, northstars_1.renderIntentList)(rows, (line) => this.log(line), { wide: flags.wide });
+        const footer = (0, northstars_1.listFooter)({
+            shown: rows.length,
+            hasMore: response.has_more === true,
+            limit: flags.limit ?? 100,
+            max: 500,
+        });
+        if (footer)
+            this.log(footer);
     }
 }
 exports.default = NorthstarsIntentsList;

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

@@ -0,0 +1,26 @@
+import NorthstarsIntentsList from './intents/list';
+/**
+ * `skrr northstars intents <northstar-id>` — the topic's default: list the intents.
+ *
+ * `intents` is a topic (`list`, `decide`), and every sibling read command
+ * (`show`, `reviews`) works with just a northstar id. Without this command
+ * `northstars intents nst_abc123` was answered with "is not a command" and a
+ * did-you-mean that listed `create` and `delete` first, while the help examples
+ * printed exactly that form. Listing is read-only, so it is the safe default; the
+ * subcommands are untouched (oclif resolves the longest command id first, so
+ * `intents decide …` and `intents list …` still reach their own commands).
+ *
+ * With no northstar id it prints the topic help instead of a bare missing-argument error.
+ */
+export default class NorthstarsIntents extends NorthstarsIntentsList {
+    static description: string;
+    static examples: string[];
+    static args: typeof NorthstarsIntentsList.args;
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        wide: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/northstars/intents.js

@@ -0,0 +1,49 @@
+"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("./intents/list"));
+/**
+ * `skrr northstars intents <northstar-id>` — the topic's default: list the intents.
+ *
+ * `intents` is a topic (`list`, `decide`), and every sibling read command
+ * (`show`, `reviews`) works with just a northstar id. Without this command
+ * `northstars intents nst_abc123` was answered with "is not a command" and a
+ * did-you-mean that listed `create` and `delete` first, while the help examples
+ * printed exactly that form. Listing is read-only, so it is the safe default; the
+ * subcommands are untouched (oclif resolves the longest command id first, so
+ * `intents decide …` and `intents list …` still reach their own commands).
+ *
+ * With no northstar id it prints the topic help instead of a bare missing-argument error.
+ */
+class NorthstarsIntents extends list_1.default {
+    static description = 'List northstar management intents; subcommands: list, decide (`intents <id>` is `intents list <id>`)';
+    static examples = [
+        '<%= config.bin %> northstars intents nst_abc123',
+        '<%= config.bin %> northstars intents nst_abc123 --status awaiting_approval',
+        '<%= config.bin %> northstars intents list nst_abc123',
+        '<%= config.bin %> northstars intents decide nst_abc123 nsi_xyz --approve',
+    ];
+    // Own, not inherited: oclif spreads the command class into the parser input, and a static a
+    // subclass only inherits is dropped (OSK-15346). The argument is optional so a bare
+    // `skrr northstars intents` can show the subcommands rather than fail on a missing id.
+    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(NorthstarsIntents);
+        if (!args.northstarId) {
+            await this.config.runCommand('help', ['northstars', 'intents']);
+            return;
+        }
+        await super.run();
+    }
+}
+exports.default = NorthstarsIntents;

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

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

package/dist/commands/northstars/list.js

@@ -21,14 +21,24 @@ class NorthstarsList extends base_command_1.BaseCommand {
     static flags = {
         json: core_1.Flags.boolean({ description: 'Output as JSON' }),
         status: core_1.Flags.string({ description: 'Filter by status', options: [...northstars_1.NORTHSTAR_STATUSES] }),
-        limit: core_1.Flags.integer({ description: 'Max results (1..100)', min: 1, max: 100 }),
+        limit: core_1.Flags.integer({ description: 'Max results (1..100, default 50)', min: 1, max: 100 }),
+        cursor: core_1.Flags.string({
+            description: 'Continue from the next_cursor a previous page returned',
+        }),
     };
     async run() {
         this.requireAuth();
         const { flags } = await this.parse(NorthstarsList);
         let response;
         try {
-            response = await northstars_1.northstarApi.list({ status: flags.status, limit: flags.limit });
+            // Cursor paging is always on: it is the only list path that returns a cursor, and the
+            // default page is sent explicitly so it stays the 50 this command always listed.
+            response = await northstars_1.northstarApi.list({
+                status: flags.status,
+                limit: flags.limit ?? northstars_1.NORTHSTAR_LIST_DEFAULT_LIMIT,
+                pagination: 'cursor',
+                cursor: flags.cursor,
+            });
         }
         catch (err) {
             this.handleApiError(err);
@@ -37,7 +47,18 @@ class NorthstarsList extends base_command_1.BaseCommand {
             this.printJsonResult((0, list_output_1.listResult)(response));
             return;
         }
-        (0, northstars_1.renderNorthstarList)(response.data ?? [], (line) => this.log(line));
+        const rows = response.data ?? [];
+        (0, northstars_1.renderNorthstarList)(rows, (line) => this.log(line));
+        const footer = (0, northstars_1.listFooter)({
+            shown: rows.length,
+            hasMore: response.has_more === true,
+            limit: flags.limit ?? northstars_1.NORTHSTAR_LIST_DEFAULT_LIMIT,
+            max: 100,
+            nextCursor: response.next_cursor,
+            cursor: true,
+        });
+        if (footer)
+            this.log(footer);
     }
 }
 exports.default = NorthstarsList;

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,23 @@ 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));
         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

@@ -29,6 +29,7 @@ class NorthstarsReviews extends base_command_1.BaseCommand {
             options: [...northstars_1.NORTHSTAR_REVIEW_STATUSES],
         }),
         review: core_1.Flags.string({ description: 'Show ONE review in full, including its intents' }),
+        wide: northstars_1.northstarWideFlag,
     };
     async run() {
         this.requireAuth();
@@ -53,14 +54,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 +84,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 {};