@skrr-ai/cli 0.1.119 → 0.1.121

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/list.d.ts

@@ -25,6 +25,7 @@ export default class SpacesList extends BaseCommand {
         status: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         label: import("@oclif/core/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'include-archived': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'archived-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         q: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         match: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         limit: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/spaces/list.js

@@ -15,7 +15,7 @@ function noSpacesMatchedMessage(q, bin = 'skrr', mode = 'fuzzy') {
         : mode === 'phrase'
             ? 'Phrase matches use a literal case-insensitive substring; word order matters.'
             : 'Fuzzy discovery can use tokenized, typo-tolerant search or a substring fallback.';
-    return (`No spaces matched ${JSON.stringify(q)}.\n` +
+    return (`No spaces matched ${JSON.stringify(q)} on this page.\n` +
         `  → ${explanation} Fields: title, description and identifier.\n` +
         `  → retry with one distinctive word, or list them all with \`${bin} spaces list\`.`);
 }
@@ -45,6 +45,7 @@ class SpacesList extends base_command_1.BaseCommand {
         '<%= config.bin %> spaces list --q "always on" --match phrase',
         '<%= config.bin %> spaces list --q "My workspace" --match exact --json',
         '<%= config.bin %> spaces list --include-archived --json',
+        '<%= config.bin %> spaces list --archived-only --json',
         '<%= config.bin %> spaces list --compact --json',
         '<%= config.bin %> spaces list --fields id,identifier,title --ndjson',
     ];
@@ -62,7 +63,8 @@ class SpacesList extends base_command_1.BaseCommand {
             description: 'Filter by label ID (repeatable). Multiple labels AND together — a space must carry all of them.',
             multiple: true,
         }),
-        'include-archived': core_1.Flags.boolean({ description: 'Include archived spaces' }),
+        'include-archived': core_1.Flags.boolean({ description: 'Include archived spaces', exclusive: ['archived-only'] }),
+        'archived-only': core_1.Flags.boolean({ description: 'List only archived spaces', exclusive: ['include-archived'] }),
         q: core_1.Flags.string({
             description: 'Search title, description, or identifier. Default fuzzy discovery may tokenize and tolerate typos; ' +
                 'use --match phrase for a literal substring or --match exact for whole-field equality. Maximum 200 characters.',
@@ -86,6 +88,7 @@ class SpacesList extends base_command_1.BaseCommand {
                 ...(flags.label?.length ? { labelIds: flags.label } : {}),
                 ...(flags.q ? { q: flags.q, ...(flags.match ? { match: flags.match } : {}) } : {}),
                 includeArchived: flags['include-archived'],
+                archivedOnly: flags['archived-only'],
                 limit: flags.limit,
                 cursor: flags.cursor,
             });
@@ -107,6 +110,8 @@ class SpacesList extends base_command_1.BaseCommand {
         }
         const r = response;
         const items = r?.data ?? [];
+        if (flags.q && (r?.degraded || r?.warnings?.length))
+            this.warn('Search may be incomplete. Inspect --json diagnostics.');
         if (r?.search) {
             this.log(`Search: ${r.search.mode}; ${r.search.semantics}; backend=${r.search.backend}.`);
             if (r.search.candidates_may_be_truncated) {
@@ -116,7 +121,11 @@ class SpacesList extends base_command_1.BaseCommand {
         if (items.length === 0) {
             this.log(flags.q
                 ? noSpacesMatchedMessage(flags.q, this.config.bin, r?.search?.mode ?? 'fuzzy')
-                : noSpacesEmptyMessage(this.config.bin));
+                : flags['archived-only'] || flags.status || flags.label?.length || r?.next_cursor
+                    ? 'No spaces on this page under the current filters.'
+                    : noSpacesEmptyMessage(this.config.bin));
+            if (r?.next_cursor)
+                this.log(`Next page: --cursor ${r.next_cursor}`);
             return;
         }
         const rows = items.map((s) => ({

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;

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

@@ -0,0 +1,17 @@
+import { SpaceProposalDecisionCommand } from '../../../lib/space-proposal-decision-command';
+/** `skrr spaces proposals keep <space> <KIND:ID>`: approve through the item's own endpoint. */
+export default class SpacesProposalsKeep 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: "keep";
+}

package/dist/commands/spaces/proposals/keep.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 keep <space> <KIND:ID>`: approve through the item's own endpoint. */
+class SpacesProposalsKeep extends space_proposal_decision_command_1.SpaceProposalDecisionCommand {
+    static description = "Keep (approve) one item in a space's proposals inbox, through the item's own decision endpoint";
+    static examples = [
+        `<%= config.bin %> spaces proposals keep <space-id> commitment_action_proposal:cap_123 --expected '{"snapshotDigest":"…","bundleVersion":2}'`,
+        '<%= config.bin %> spaces proposals keep <space-id> memory_proposal:<uuid>',
+        '<%= config.bin %> spaces proposals keep <space-id> space_lesson:<uuid>',
+    ];
+    // 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 = 'keep';
+}
+exports.default = SpacesProposalsKeep;

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

@@ -0,0 +1,24 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * `skrr spaces proposals list <space>` (OSK-17993): the pending objects that
+ * target one Space (writes the Space held for approval, its loops' bundles,
+ * its Memory proposals), each with whether YOU can decide it. VIEW on the
+ * Space. A read-time projection: nothing here is the Space's own state, and
+ * a decision goes to the item's own endpoint (`spaces proposals keep|discard`).
+ */
+export default class SpacesProposalsList extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        kind: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        disposition: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        all: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/interfaces").OptionFlag<number, 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/proposals/list.js

@@ -0,0 +1,89 @@
+"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 format_1 = require("../../../lib/format");
+const list_output_1 = require("../../../lib/list-output");
+const space_proposals_1 = require("../../../lib/space-proposals");
+/**
+ * `skrr spaces proposals list <space>` (OSK-17993): the pending objects that
+ * target one Space (writes the Space held for approval, its loops' bundles,
+ * its Memory proposals), each with whether YOU can decide it. VIEW on the
+ * Space. A read-time projection: nothing here is the Space's own state, and
+ * a decision goes to the item's own endpoint (`spaces proposals keep|discard`).
+ */
+class SpacesProposalsList extends base_command_1.BaseCommand {
+    static description = "List a space's proposals inbox: held writes, its loops' bundles and its Memory proposals, with who can decide each";
+    static examples = [
+        '<%= config.bin %> spaces proposals list <space-id>',
+        '<%= config.bin %> spaces proposals list "Growth lab" --disposition proposed',
+        '<%= config.bin %> spaces proposals list <space-id> --kind memory_proposal --json',
+    ];
+    static args = {
+        id: core_1.Args.string({
+            description: 'Space ID, or a title to resolve',
+            required: true,
+            ignoreStdin: true,
+        }),
+    };
+    static flags = {
+        kind: core_1.Flags.string({ options: [...data_provider_1.SPACE_PROPOSAL_KINDS] }),
+        disposition: core_1.Flags.string({
+            options: [...data_provider_1.PROPOSAL_DISPOSITIONS],
+            default: 'proposed',
+            description: 'proposed (waiting for a decision) by default',
+        }),
+        all: core_1.Flags.boolean({ description: 'Every disposition, not only the ones waiting' }),
+        limit: core_1.Flags.integer({ min: 1, max: 100, default: 50 }),
+        cursor: core_1.Flags.string(),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(SpacesProposalsList);
+        const spaceId = await this.resolveSpaceReference(args.id);
+        let result;
+        try {
+            result = await space_proposals_1.spaceProposalsApi.list(spaceId, {
+                kind: flags.kind,
+                disposition: flags.all ? undefined : flags.disposition,
+                limit: flags.limit,
+                cursor: flags.cursor,
+            });
+        }
+        catch (error) {
+            this.handleApiError(error, { subject: `space ${args.id}` });
+        }
+        if (flags.json) {
+            this.printJsonResult((0, list_output_1.listResult)(result));
+            return;
+        }
+        if (!result.data.length) {
+            for (const line of (0, space_proposals_1.emptySpaceInboxLines)(result.nextCursor))
+                this.log(line);
+        }
+        (0, format_1.renderTable)(result.data.map(space_proposals_1.spaceProposalRow), [
+            { key: 'id', header: 'PROPOSAL', verbatim: true },
+            { key: 'title', header: 'TITLE' },
+            { key: 'scope', header: 'WHY HERE' },
+            { key: 'disposition', header: 'DISPOSITION' },
+            { key: 'deadline', header: 'DEADLINE' },
+            { key: 'note', header: 'NOTE' },
+        ], (line) => this.log(line));
+        const bin = this.config?.bin || 'skrr';
+        for (const item of result.data) {
+            for (const line of (0, space_proposals_1.spaceProposalDetailLines)(item, bin))
+                this.log(line);
+        }
+        if (!result.coverage.complete) {
+            this.log(`Partial coverage: ${result.coverage.sources
+                .filter((source) => source.status !== 'available')
+                .map((source) => `${source.kind}:${source.status}${source.code ? ` (${source.code})` : ''}`)
+                .join(', ')}`);
+        }
+        if (result.nextCursor)
+            this.log(`Next cursor: ${result.nextCursor}`);
+    }
+}
+exports.default = SpacesProposalsList;

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

@@ -0,0 +1 @@
+export { default } from '../search/spaces';

package/dist/commands/spaces/search.js

@@ -0,0 +1,9 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = void 0;
+// Both spellings share one implementation and result contract.
+var spaces_1 = require("../search/spaces");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(spaces_1).default; } });