@skrr-ai/cli 0.1.127 → 0.1.128

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 {};

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

@@ -46,6 +46,29 @@ const PERSPECTIVES = [
         ],
         url: '/spaces/<space-id>/schedule',
     },
+    {
+        perspective: 'loops',
+        purpose: "The Space's standing loops (weekly review, curator, goal advance). No command lists them: read their cycles from the notebook",
+        commands: [
+            'spaces notebook <space-id> --kinds loop_cycle',
+            'commitments pack plan --pack space_review --space <space-id>',
+            'spaces loops migrate <space-id> --from heartbeats',
+            'spaces loops release <space-id> --commitment <id>',
+        ],
+        url: '/spaces/<space-id>/loops',
+    },
+    {
+        perspective: 'notebook',
+        purpose: 'Task results, loop cycles, hypothesis verdicts, journal entries and reports, newest first',
+        commands: ['spaces notebook <space-id>'],
+        url: '/spaces/<space-id>/notebook',
+    },
+    {
+        perspective: 'proposals',
+        purpose: 'Writes held for approval, loop action bundles and Memory proposals; how unattended writes are governed',
+        commands: ['spaces proposals list <space-id>', 'spaces write-policy show <space-id>'],
+        url: '/spaces/<space-id>/proposals',
+    },
     {
         perspective: 'actions',
         purpose: 'Agent actions and space custom actions',