@skrr-ai/cli 0.1.119 → 0.1.120

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

@@ -1,4 +1,7 @@
+import { type SpaceJudgmentTurnRecord } 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;
 export default class SpacesAutoExecutorRuns extends BaseCommand {
     static description: string;
     static examples: string[];

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

@@ -1,9 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.judgmentTurnLabel = judgmentTurnLabel;
 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");
+/** Who held the Space's judgment turn at this tick (OSK-18003). */
+function judgmentTurnLabel(turn) {
+    if (!turn)
+        return '';
+    if (turn.holder === 'leader')
+        return '  turn: Leader';
+    if (turn.holder === 'space_loop') {
+        return `  turn: loop ${turn.commitmentId ?? ''}${turn.inFlightRunId ? ' (waiting for its turn to end)' : ''}`;
+    }
+    return '  turn: unreadable, Leader stood down';
+}
 class SpacesAutoExecutorRuns extends base_command_1.BaseCommand {
     static description = "List a space's recent auto-orchestration runs and its Lead health";
     static examples = [
@@ -50,7 +62,7 @@ class SpacesAutoExecutorRuns extends base_command_1.BaseCommand {
         for (const run of result.runs) {
             const when = run.triggeredAt ?? 'unknown-time';
             const failure = run.failureReason ? ` — ${run.failureReason}` : '';
-            this.log(`${when}  ${run.status}${failure}`);
+            this.log(`${when}  ${run.status}${failure}${judgmentTurnLabel(run.judgmentTurn)}`);
         }
     }
 }

package/dist/commands/spaces/charter/create-from-description.d.ts

@@ -0,0 +1,21 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * `skrr spaces charter create-from-description <space>` — seed the Space's
+ * charter page from its description, once.
+ *
+ * An explicit action: nothing turns descriptions into charters on its own, and
+ * the description itself is left as it is (the Space card's one-line summary).
+ * The page lands at the Space root as `charter`; a Space that already has a
+ * charter is refused, and so is one with no description to seed from.
+ */
+export default class SpacesCharterCreateFromDescription extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/spaces/charter/create-from-description.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+const http_error_1 = require("../../../lib/http-error");
+const space_charter_1 = require("../../../lib/space-charter");
+const web_url_1 = require("../../../lib/web-url");
+/**
+ * `skrr spaces charter create-from-description <space>` — seed the Space's
+ * charter page from its description, once.
+ *
+ * An explicit action: nothing turns descriptions into charters on its own, and
+ * the description itself is left as it is (the Space card's one-line summary).
+ * The page lands at the Space root as `charter`; a Space that already has a
+ * charter is refused, and so is one with no description to seed from.
+ */
+class SpacesCharterCreateFromDescription extends base_command_1.BaseCommand {
+    static description = "Create a space's charter page from the space description (one time; the description is left as it is)";
+    static examples = [
+        '<%= config.bin %> spaces charter create-from-description <space-id>',
+        '<%= config.bin %> spaces charter create-from-description "Growth lab" --json',
+    ];
+    static args = {
+        id: core_1.Args.string({
+            description: 'Space ID, or a title to resolve',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(SpacesCharterCreateFromDescription);
+        const spaceId = await this.resolveSpaceReference(args.id);
+        let response;
+        try {
+            response = await data_provider_1.dataService.createSpaceWikiCharterFromDescription(spaceId);
+        }
+        catch (err) {
+            const conflict = (0, space_charter_1.charterConflictHint)(err, { binName: this.config.bin, spaceId });
+            if (conflict) {
+                this.failWithCliError({
+                    message: conflict.message,
+                    code: 'WIKI_CHARTER_EXISTS',
+                    status: 409,
+                    exit: 1,
+                    retryable: false,
+                    details: conflict.details,
+                });
+            }
+            if ((0, http_error_1.hasHttpStatus)(err, 422) && (0, http_error_1.httpBodyOf)(err)?.code === 'SPACE_DESCRIPTION_EMPTY') {
+                this.failWithCliError({
+                    message: 'This Space has no description to create a charter from. Write the charter directly: ' +
+                        `\`${this.config.bin} wiki write ${spaceId} charter --kind charter --file charter.md\`.`,
+                    code: 'SPACE_DESCRIPTION_EMPTY',
+                    status: 422,
+                    exit: 1,
+                    retryable: false,
+                });
+            }
+            this.handleApiError(err, { subject: `space ${args.id}` });
+        }
+        const charter = (0, web_url_1.withWikiPageUrl)(this.cliConfig.baseURL, response.charter);
+        if (flags.json) {
+            this.printJsonResult({ ...response, charter });
+            return;
+        }
+        this.log('Created the charter page from the Space description.');
+        for (const line of (0, space_charter_1.charterLines)(charter, { binName: this.config.bin, spaceId })) {
+            this.log(line);
+        }
+    }
+}
+exports.default = SpacesCharterCreateFromDescription;

package/dist/commands/spaces/charter/show.d.ts

@@ -0,0 +1,22 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * `skrr spaces charter show <space>` — the Space's charter page.
+ *
+ * The charter is the Space's one live `kind: 'charter'` wiki page. What this
+ * prints first is its LEAD SECTION (everything before the first `##`), because
+ * that is the part every agent turn in the Space receives; the rest of the page
+ * is read on demand. No charter is an ordinary state, not an error: it prints
+ * how to create one and exits 0 (`--json` carries `charter: null`).
+ */
+export default class SpacesCharterShow extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        full: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/spaces/charter/show.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+const space_charter_1 = require("../../../lib/space-charter");
+const web_url_1 = require("../../../lib/web-url");
+/**
+ * `skrr spaces charter show <space>` — the Space's charter page.
+ *
+ * The charter is the Space's one live `kind: 'charter'` wiki page. What this
+ * prints first is its LEAD SECTION (everything before the first `##`), because
+ * that is the part every agent turn in the Space receives; the rest of the page
+ * is read on demand. No charter is an ordinary state, not an error: it prints
+ * how to create one and exits 0 (`--json` carries `charter: null`).
+ */
+class SpacesCharterShow extends base_command_1.BaseCommand {
+    static description = "Show a space's charter page: the lead section every agent in the space reads, " +
+        'and how to read the rest';
+    static examples = [
+        '<%= config.bin %> spaces charter show <space-id>',
+        '<%= config.bin %> spaces charter show "Growth lab" --full',
+        '<%= config.bin %> spaces charter show <space-id> --json',
+    ];
+    static args = {
+        id: core_1.Args.string({
+            description: 'Space ID, or a title to resolve',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        full: core_1.Flags.boolean({ description: 'Print the whole page, not only its lead section' }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(SpacesCharterShow);
+        const spaceId = await this.resolveSpaceReference(args.id);
+        let response;
+        try {
+            response = await data_provider_1.dataService.getSpaceWikiCharter(spaceId);
+        }
+        catch (err) {
+            this.handleApiError(err, { subject: `space ${args.id}` });
+        }
+        const charter = response.charter
+            ? (0, web_url_1.withWikiPageUrl)(this.cliConfig.baseURL, response.charter)
+            : null;
+        if (flags.json) {
+            this.printJsonResult({ ...response, charter });
+            return;
+        }
+        const lines = charter
+            ? (0, space_charter_1.charterLines)(charter, { binName: this.config.bin, spaceId, full: flags.full })
+            : (0, space_charter_1.noCharterLines)({ binName: this.config.bin, spaceId });
+        for (const line of lines)
+            this.log(line);
+    }
+}
+exports.default = SpacesCharterShow;

package/dist/commands/spaces/heartbeats/list.d.ts

@@ -1,25 +1,10 @@
 import { BaseCommand } from '../../../base-command';
-/**
- * One heartbeat document → one table row.
- *
- * Schema reference (packages/data-provider/src/types/spaces.ts:110-132):
- *   frequency?: Record<string, unknown>                // object, NOT string
- *   schedule: { pattern: string; timezone: string }    // nested
- *
- * An earlier version read `h.frequency` / `h.timezone` directly, which
- * rendered `[object Object]` and `-` for every row. The casts below are
- * assertions, not guarantees — the payload is untyped at runtime — so the
- * final render goes through `formatCell`: if `schedule.pattern` ever arrives
- * structured (a `{ cron, tz }` object, say) the cell degrades to readable
- * `key=value` pairs instead of regressing to `[object Object]`.
- *
- * Exported for the unit test.
- */
 export declare function heartbeatRow(h: Record<string, unknown>): {
     agentId: string;
     pattern: string;
     timezone: string;
     enabled: string;
+    loop: string;
     updated: string;
 };
 export default class SpacesHeartbeatsList extends BaseCommand {

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

@@ -23,6 +23,17 @@ const space_output_1 = require("../../../lib/space-output");
  *
  * Exported for the unit test.
  */
+/**
+ * The Space loop a heartbeat was converted into (`skrr spaces loops migrate`,
+ * OSK-18009): `pending` while the loop is not active (the heartbeat still runs
+ * and is read-only), `retired` once the loop replaced it.
+ */
+function loopCell(loop) {
+    const pointer = loop;
+    if (!pointer?.commitmentId)
+        return '-';
+    return `${(0, format_1.formatCell)(pointer.state)} -> ${(0, format_1.formatCell)(pointer.commitmentId)}`;
+}
 function heartbeatRow(h) {
     const schedule = h.schedule;
     const freqObj = h.frequency;
@@ -34,6 +45,7 @@ function heartbeatRow(h) {
         pattern: (0, format_1.formatCell)(pattern),
         timezone: (0, format_1.formatCell)(schedule?.timezone),
         enabled: h.enabled === true ? 'yes' : 'no',
+        loop: loopCell(h.loop),
         updated: h.updatedAt ? (0, format_1.localTime)(h.updatedAt) : '-',
     };
 }
@@ -85,6 +97,7 @@ class SpacesHeartbeatsList extends base_command_1.BaseCommand {
             { key: 'pattern', header: 'PATTERN' },
             { key: 'timezone', header: 'TIMEZONE' },
             { key: 'enabled', header: 'ENABLED' },
+            { key: 'loop', header: 'LOOP' },
             { key: 'updated', header: 'UPDATED' },
         ], (line) => this.log(line));
         this.log('');

package/dist/commands/spaces/install-template.js

@@ -140,6 +140,9 @@ class SpacesInstallTemplate extends base_command_1.BaseCommand {
         }
         const verb = installed.attachedToExistingSpace ? 'Installed into' : 'Created';
         this.log(`${verb} space ${spaceId} — ${installed.taskCount ?? 0} task(s), ${installed.goalCount ?? 0} goal(s).`);
+        for (const notice of (0, space_templates_1.wikiPageInstallNotices)(installed.outcomes)) {
+            this.log(notice);
+        }
     }
 }
 exports.default = SpacesInstallTemplate;

package/dist/commands/spaces/loops/migrate.d.ts

@@ -0,0 +1,32 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * `skrr spaces loops migrate <space> --from heartbeats|oracle_triggers|assistants`
+ * (OSK-18009, OSK-18011, OSK-18010; design §5.11): converts a Space's older
+ * periodic agent turns into Space loops. The sources are the server's (its
+ * adapter registry), so `--from` is passed through and an unknown one is
+ * answered with the list. A Space assistant is private to its member, so its
+ * plan lists only the caller's own.
+ *
+ * Without `--apply` it prints the plan, a pure read: every entry, what it
+ * becomes (the Space's loop when its owner is the Space's execution principal,
+ * otherwise its owner's own Commitment), its cadence before and after (never
+ * rounded silently), what the loop does differently, the entries it cannot
+ * convert and why, and who may apply each. With `--apply --plan-digest <digest>`
+ * it converts the entries the caller may, acting only on the plan that digest
+ * names. Each entry keeps firing until its loop is active, and is retired then.
+ */
+export default class SpacesLoopsMigrate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        from: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        apply: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'plan-digest': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        entry: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/spaces/loops/migrate.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+const space_loop_migration_1 = require("../../../lib/space-loop-migration");
+/**
+ * `skrr spaces loops migrate <space> --from heartbeats|oracle_triggers|assistants`
+ * (OSK-18009, OSK-18011, OSK-18010; design §5.11): converts a Space's older
+ * periodic agent turns into Space loops. The sources are the server's (its
+ * adapter registry), so `--from` is passed through and an unknown one is
+ * answered with the list. A Space assistant is private to its member, so its
+ * plan lists only the caller's own.
+ *
+ * Without `--apply` it prints the plan, a pure read: every entry, what it
+ * becomes (the Space's loop when its owner is the Space's execution principal,
+ * otherwise its owner's own Commitment), its cadence before and after (never
+ * rounded silently), what the loop does differently, the entries it cannot
+ * convert and why, and who may apply each. With `--apply --plan-digest <digest>`
+ * it converts the entries the caller may, acting only on the plan that digest
+ * names. Each entry keeps firing until its loop is active, and is retired then.
+ */
+class SpacesLoopsMigrate extends base_command_1.BaseCommand {
+    static description = "Convert a space's heartbeats, custom oracle triggers or your Space assistant (or another older periodic agent turn) into Space loops: print the plan, then apply it";
+    static examples = [
+        '<%= config.bin %> spaces loops migrate <space-id> --from heartbeats',
+        '<%= config.bin %> spaces loops migrate <space-id> --from assistants',
+        '<%= config.bin %> spaces loops migrate "Growth lab" --from heartbeats --json',
+        '<%= config.bin %> spaces loops migrate <space-id> --from oracle_triggers',
+        '<%= config.bin %> spaces loops migrate <space-id> --from heartbeats --apply --plan-digest <digest>',
+        '<%= config.bin %> spaces loops migrate <space-id> --from heartbeats --apply --plan-digest <digest> --entry <entry-id>',
+    ];
+    static args = {
+        id: core_1.Args.string({
+            description: 'Space ID, or a title to resolve',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        from: core_1.Flags.string({
+            description: 'What to convert: heartbeats, oracle_triggers (custom space_oracle triggers), or assistants (your own Space assistant)',
+            required: true,
+        }),
+        apply: core_1.Flags.boolean({
+            description: 'Apply the plan (needs --plan-digest from a plan you reviewed)',
+            default: false,
+        }),
+        'plan-digest': core_1.Flags.string({
+            description: 'The digest the plan printed; apply refuses a plan that changed since',
+        }),
+        entry: core_1.Flags.string({
+            description: 'Apply only this entry of the plan (repeatable)',
+            multiple: true,
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(SpacesLoopsMigrate);
+        const source = String(flags.from).trim();
+        if (flags.apply && !flags['plan-digest']) {
+            this.error('Apply acts on the plan you reviewed: run without --apply first, then pass the digest it prints as --plan-digest.', { exit: 2 });
+        }
+        if (!flags.apply && (flags['plan-digest'] || flags.entry?.length)) {
+            this.error('--plan-digest and --entry apply a plan: add --apply.', { exit: 2 });
+        }
+        const spaceId = await this.resolveSpaceReference(args.id);
+        if (!flags.apply) {
+            let plan;
+            try {
+                plan = await data_provider_1.dataService.planSpaceLoopMigration(spaceId, source);
+            }
+            catch (err) {
+                this.handleApiError(err, { subject: `space ${args.id}` });
+            }
+            if (flags.json) {
+                this.printJsonResult(plan);
+                return;
+            }
+            for (const line of (0, space_loop_migration_1.planLines)(plan, { binName: this.config.bin }))
+                this.log(line);
+            return;
+        }
+        let applied;
+        try {
+            applied = await data_provider_1.dataService.applySpaceLoopMigration(spaceId, source, {
+                planDigest: String(flags['plan-digest']),
+                ...(flags.entry?.length ? { entryIds: flags.entry } : {}),
+            });
+        }
+        catch (err) {
+            this.handleApiError(err, { subject: `space ${args.id}` });
+        }
+        if (flags.json) {
+            this.printJsonResult(applied);
+            return;
+        }
+        for (const line of (0, space_loop_migration_1.applyLines)(applied))
+            this.log(line);
+    }
+}
+exports.default = SpacesLoopsMigrate;

package/dist/commands/spaces/loops/release.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../../base-command';
+export default class SpacesLoopsRelease extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        commitment: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        link: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/spaces/loops/release.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+class SpacesLoopsRelease extends base_command_1.BaseCommand {
+    static description = 'Pause a loop and release its Space and Goals to built-in planners (requires Space SHARE permission)';
+    static examples = [
+        '<%= config.bin %> spaces loops release <space-id> --commitment <commitment-id>',
+        '<%= config.bin %> spaces loops release "Growth lab" --commitment <commitment-id> --json',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Space ID, or a title to resolve', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        commitment: core_1.Flags.string({ description: 'The loop Commitment to pause and release', required: true }),
+        link: core_1.Flags.string({ description: 'Pin the reviewed home link ID; otherwise resolve the current active home link once' }),
+        json: core_1.Flags.boolean({ description: 'Output the release receipt as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(SpacesLoopsRelease);
+        const spaceId = await this.resolveSpaceReference(args.id);
+        let receipt;
+        try {
+            let linkId = flags.link;
+            if (!linkId) {
+                const links = await data_provider_1.dataService.listCommitmentWorkLinksForTarget({ targetType: 'space', targetId: spaceId });
+                const homes = links.data.filter((link) => link.commitmentId === flags.commitment && link.status === 'active' && link.roles.includes('home'));
+                if (homes.length !== 1) {
+                    this.error('No unique active home link found. Supply --link <home-link-id> to release a reviewed link or retry its receipt.', { exit: 2 });
+                }
+                linkId = homes[0].id;
+            }
+            receipt = await data_provider_1.dataService.releaseSpaceLoop(spaceId, flags.commitment, { linkId });
+        }
+        catch (err) {
+            this.handleApiError(err, { subject: `loop ${flags.commitment} in space ${args.id}` });
+        }
+        if (flags.json) {
+            this.printJsonResult(receipt);
+            return;
+        }
+        this.log(receipt.outcome === 'already_released'
+            ? `Loop ${receipt.commitmentId} was already released from this Space.`
+            : `Loop ${receipt.commitmentId} is paused and released from this Space.`);
+        this.log(`Home link: ${receipt.linkId}`);
+        this.log(receipt.outcome === 'released'
+            ? 'Its Space and Goal planning turns are released after current turns finish. The owner may explicitly resume the Commitment personally.'
+            : 'This receipt refers to the previously released home link. Current planning may have changed.');
+        if (receipt.teardown?.status === 'degraded') {
+            this.log('Some running work could not be stopped. Review the teardown receipt before assuming all work has ended.');
+            for (const failure of receipt.teardown.failures ?? []) {
+                this.log(`  ${failure.step}: ${failure.reason}`);
+            }
+        }
+    }
+}
+exports.default = SpacesLoopsRelease;

package/dist/commands/spaces/notebook.d.ts

@@ -0,0 +1,25 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * `skrr spaces notebook <space>` — the Space's notebook (OSK-17996): one page
+ * of its Task Results, loop Cycles, hypothesis verdicts and journal / report
+ * pages, newest first. A view over records that already exist: each row is a
+ * summary and a link, and the body is read from the record itself. VIEW on
+ * the Space. A loop's Cycles are shared with the Space's members while its
+ * rules hold; a Commitment that only watches the Space, and every hypothesis
+ * verdict, show only to people who can open the Commitment. Each loop row says
+ * which.
+ */
+export default class SpacesNotebook extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        kinds: 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>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/spaces/notebook.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../base-command");
+const space_notebook_1 = require("../../lib/space-notebook");
+const web_url_1 = require("../../lib/web-url");
+/**
+ * `skrr spaces notebook <space>` — the Space's notebook (OSK-17996): one page
+ * of its Task Results, loop Cycles, hypothesis verdicts and journal / report
+ * pages, newest first. A view over records that already exist: each row is a
+ * summary and a link, and the body is read from the record itself. VIEW on
+ * the Space. A loop's Cycles are shared with the Space's members while its
+ * rules hold; a Commitment that only watches the Space, and every hypothesis
+ * verdict, show only to people who can open the Commitment. Each loop row says
+ * which.
+ */
+class SpacesNotebook extends base_command_1.BaseCommand {
+    static description = "Show a space's notebook: its task results, loop cycles, hypothesis verdicts and journal and report pages, newest first";
+    static examples = [
+        '<%= config.bin %> spaces notebook <space-id>',
+        '<%= config.bin %> spaces notebook "Growth lab" --kinds task_result,hypothesis',
+        '<%= config.bin %> spaces notebook <space-id> --limit 50 --json',
+        '<%= config.bin %> spaces notebook <space-id> --cursor <next-cursor>',
+    ];
+    static args = {
+        id: core_1.Args.string({
+            description: 'Space ID, or a title to resolve',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        kinds: core_1.Flags.string({
+            description: `Only these kinds, comma-separated: ${data_provider_1.SPACE_NOTEBOOK_KINDS.join(', ')} (default: all)`,
+        }),
+        limit: core_1.Flags.integer({ description: 'Rows per page (1-100, default 30)', min: 1, max: 100 }),
+        cursor: core_1.Flags.string({
+            description: 'The cursor the previous page printed; pass the same --kinds with it',
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(SpacesNotebook);
+        const kinds = (0, data_provider_1.readSpaceNotebookKinds)(flags.kinds);
+        if (!kinds.ok) {
+            this.error(`Unknown notebook kind: ${kinds.unknown.join(', ')}. Use: ${data_provider_1.SPACE_NOTEBOOK_KINDS.join(', ')}`, { exit: 2 });
+        }
+        const spaceId = await this.resolveSpaceReference(args.id);
+        let page;
+        try {
+            page = await data_provider_1.dataService.getSpaceNotebook(spaceId, {
+                // Every kind is the default; sending none keeps the URL short.
+                ...(kinds.kinds.length < data_provider_1.SPACE_NOTEBOOK_KINDS.length ? { kinds: kinds.kinds } : {}),
+                ...(typeof flags.limit === 'number' ? { limit: flags.limit } : {}),
+                ...(flags.cursor ? { cursor: flags.cursor } : {}),
+            });
+        }
+        catch (err) {
+            this.handleApiError(err, { subject: `space ${args.id}` });
+        }
+        if (flags.json) {
+            this.printJsonResult(page);
+            return;
+        }
+        for (const line of (0, space_notebook_1.notebookLines)(page, {
+            webOrigin: (0, web_url_1.webOrigin)(this.cliConfig.baseURL),
+            binName: this.config.bin,
+        })) {
+            this.log(line);
+        }
+    }
+}
+exports.default = SpacesNotebook;

package/dist/commands/spaces/proposals/discard.d.ts

@@ -0,0 +1,17 @@
+import { SpaceProposalDecisionCommand } from '../../../lib/space-proposal-decision-command';
+/** `skrr spaces proposals discard <space> <KIND:ID>`: reject through the item's own endpoint. */
+export default class SpacesProposalsDiscard extends SpaceProposalDecisionCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        space: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        item: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        expected: 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>;
+        'reason-code': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    static decision: "discard";
+}

package/dist/commands/spaces/proposals/discard.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const space_proposal_decision_command_1 = require("../../../lib/space-proposal-decision-command");
+/** `skrr spaces proposals discard <space> <KIND:ID>`: reject through the item's own endpoint. */
+class SpacesProposalsDiscard extends space_proposal_decision_command_1.SpaceProposalDecisionCommand {
+    static description = "Discard (reject) one item in a space's proposals inbox, through the item's own decision endpoint";
+    static examples = [
+        `<%= config.bin %> spaces proposals discard <space-id> commitment_action_proposal:cap_123 --expected '{"snapshotDigest":"…","bundleVersion":2}' --reason-code not_worth_it`,
+        '<%= config.bin %> spaces proposals discard <space-id> memory_proposal:<uuid> --reason "Not true any more"',
+        '<%= config.bin %> spaces proposals discard <space-id> space_lesson:<uuid> --reason-code incorrect --reason "Step 2 is the old flow"',
+    ];
+    // Own, not inherited: oclif drops a static a subclass only inherits (OSK-15346).
+    static args = space_proposal_decision_command_1.SpaceProposalDecisionCommand.args;
+    static flags = { ...space_proposal_decision_command_1.spaceProposalDecisionFlags };
+    static decision = 'discard';
+}
+exports.default = SpacesProposalsDiscard;