@skrr-ai/cli 0.1.119 → 0.1.121

package/dist/commands/search/workspace.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchDisplayText = void 0;
+exports.searchDiagnosticMessage = searchDiagnosticMessage;
+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 search_query_1 = require("../../lib/search-query");
+const web_url_1 = require("../../lib/web-url");
+const search_display_1 = require("../../lib/search-display");
+var search_display_2 = require("../../lib/search-display");
+Object.defineProperty(exports, "searchDisplayText", { enumerable: true, get: function () { return search_display_2.searchDisplayText; } });
+function isSearchResponse(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return false;
+    const response = value;
+    if (!Array.isArray(response.results) || (response.nextCursor !== null && (typeof response.nextCursor !== 'string' || !(0, search_display_1.isPrintableSearchCursor)(response.nextCursor))) ||
+        (response.diagnostics !== undefined && (!Array.isArray(response.diagnostics) || !response.diagnostics.every((item) => typeof item === 'string'))))
+        return false;
+    return response.results.every((item) => item && typeof item === 'object' && !Array.isArray(item) &&
+        ['id', 'type', 'entityId', 'title', 'href'].every((field) => typeof item[field] === 'string') &&
+        item.href.startsWith('/') && !item.href.startsWith('//') && !item.href.includes('\\') &&
+        !/[\u0000-\u001f\u007f]/.test(item.href) &&
+        ['identifier', 'excerpt'].every((field) => item[field] === undefined || typeof item[field] === 'string'));
+}
+function searchDiagnosticMessage(code) {
+    switch (code) {
+        case 'global_search_index_stale':
+            return 'The search index is catching up. Recent changes may be missing; retry shortly.';
+        case 'global_search_acl_unavailable':
+            return 'Access checks were unavailable. Results may be incomplete; retry shortly.';
+        case 'global_search_source_unavailable':
+            return 'Some current resources could not be checked. Results may be incomplete; retry shortly.';
+        case 'global_search_candidate_window_may_be_limited':
+            return 'This broad search may exceed the index result window. Narrow the query or select resource types.';
+        case 'global_search_candidate_window_unknown':
+            return 'The index result window could not be checked. Results may be incomplete; retry shortly.';
+        case 'global_search_invalid_candidate':
+            return 'The search index returned invalid candidates. Results may be incomplete; retry shortly.';
+        default:
+            return `Search may be incomplete (${(0, search_display_1.searchDisplayText)(code)}). Retry or inspect --json diagnostics.`;
+    }
+}
+/** Workspace search uses the same ACL-filtered index and result order as web. */
+class SearchWorkspace extends base_command_1.BaseCommand {
+    static description = 'Search supported resources in your workspace';
+    static examples = [
+        '<%= config.bin %> search workspace "deployment incident"',
+        '<%= config.bin %> search workspace pricing --type task --type wiki --json',
+    ];
+    static args = { query: core_1.Args.string({ description: 'Search term', ignoreStdin: true }) };
+    static flags = {
+        query: core_1.Flags.string({ char: 'q', description: 'Search term' }),
+        type: core_1.Flags.string({ multiple: true, description: 'Limit to resource types (repeatable; for example task, space, wiki, message)' }),
+        limit: core_1.Flags.integer({ default: 25, min: 1, max: 50, description: 'Results per page' }),
+        cursor: core_1.Flags.string({ description: 'Continue from a previous page' }),
+        json: core_1.Flags.boolean({ description: 'Output structured results and diagnostics' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(SearchWorkspace);
+        const query = (0, search_query_1.resolveSearchQuery)(this, args.query, flags.query, 'search workspace');
+        // Session-only tokens cannot authenticate to the JWT route. Never adopt an
+        // ambient human credential to turn this into broader authority.
+        if (this.resolvedCredential.token?.startsWith('agst_')) {
+            this.failWithCliError({
+                message: 'Workspace search is not available with a session-scoped credential. Ask the workspace owner to enable the delegated CLI surface for a new Agent session, or search in a signed-in human session. Do not substitute a personal login inside the Agent.',
+                code: 'GLOBAL_SEARCH_SESSION_UNSUPPORTED', exit: 2, retryable: false,
+            });
+        }
+        let response;
+        try {
+            response = await data_provider_1.dataService.searchGlobal({ query, types: flags.type, limit: flags.limit, cursor: flags.cursor });
+        }
+        catch (err) {
+            const code = (0, base_command_1.apiRefusal)(err).code;
+            if (code === 'SEARCH_WORKSPACE_REQUIRED' || code === 'SEARCH_WORKSPACE_FORBIDDEN') {
+                this.failWithCliError({
+                    message: `Choose a workspace you belong to: run \`${this.config.bin} workspaces list\`, then \`${this.config.bin} workspaces use <workspace>\`, or pass --workspace <workspace-id>.`,
+                    code, status: 403, exit: 3, retryable: false,
+                });
+            }
+            if (code === 'INVALID_SEARCH_TYPE') {
+                const allowed = (0, base_command_1.apiRefusal)(err).body?.supportedTypes;
+                const types = Array.isArray(allowed)
+                    ? allowed.filter((type) => typeof type === 'string').map(search_display_1.searchDisplayText).filter(Boolean)
+                    : [];
+                this.failWithCliError({
+                    message: types.length
+                        ? `Unknown search type. Choose from: ${types.join(', ')}.`
+                        : 'Unknown search type. Run the command without --type to search all supported types.',
+                    code, status: 400, exit: 2, retryable: false,
+                });
+            }
+            this.handleApiError(err);
+        }
+        if (!isSearchResponse(response) || (flags.cursor && response.nextCursor === flags.cursor)) {
+            this.failWithCliError({ message: 'The server returned an invalid workspace search response. Retry or check server compatibility.',
+                code: 'GLOBAL_SEARCH_INVALID_RESPONSE', exit: 1, retryable: true });
+        }
+        const results = response.results.map((item) => ({
+            ...item,
+            url: `${(0, web_url_1.webOrigin)(this.cliConfig.baseURL)}${item.href}`,
+        }));
+        if (flags.json) {
+            this.log(JSON.stringify({ ...response, results }, null, 2));
+            return;
+        }
+        for (const diagnostic of new Set(response.diagnostics || []))
+            this.warn(searchDiagnosticMessage(diagnostic));
+        if (results.length) {
+            (0, format_1.renderTable)(results.map((item) => ({ type: (0, search_display_1.searchDisplayText)(item.type), id: (0, search_display_1.searchDisplayText)(item.identifier || item.entityId), title: (0, search_display_1.searchDisplayText)(item.title), excerpt: (0, search_display_1.searchDisplayText)(item.excerpt || ''), url: (0, search_display_1.searchDisplayText)(item.url || '-') })), [
+                { key: 'type', header: 'TYPE' }, { key: 'id', header: 'ID' },
+                { key: 'title', header: 'TITLE', maxWidth: 45 }, { key: 'excerpt', header: 'EXCERPT', maxWidth: 60 },
+                { key: 'url', header: 'URL', verbatim: true },
+            ], (line) => this.log(line));
+        }
+        else {
+            this.log('No results in this page of supported workspace resources.');
+        }
+        if (response.nextCursor)
+            this.log(`Next page: --cursor ${(0, search_display_1.shellSearchCursor)(response.nextCursor)}`);
+    }
+}
+exports.default = SearchWorkspace;

package/dist/commands/skills/browse.d.ts

@@ -16,6 +16,7 @@ export default class SkillsBrowse extends BaseCommand {
         category: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         sort: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         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>;
     };
     run(): Promise<void>;
 }

package/dist/commands/skills/browse.js

@@ -7,6 +7,7 @@ const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const format_1 = require("../../lib/format");
 const usd_micros_1 = require("../../lib/usd-micros");
+const skill_store_pagination_1 = require("../../lib/skill-store-pagination");
 function skillBrowseDescription(skill) {
     const description = String(skill.description ?? '').trim();
     if (description && description !== '>' && description !== '|')
@@ -43,6 +44,7 @@ class SkillsBrowse extends base_command_1.BaseCommand {
             options: ['newest', 'popular', 'rating'],
         }),
         limit: core_1.Flags.integer({ description: 'Maximum number of results', default: 20 }),
+        cursor: core_1.Flags.string({ description: 'Continue from a previous page' }),
     };
     async run() {
         this.requireAuth();
@@ -59,6 +61,7 @@ class SkillsBrowse extends base_command_1.BaseCommand {
                 category: flags.category,
                 sort: flags.sort ? sortMap[flags.sort] : undefined,
                 limit: flags.limit,
+                cursor: flags.cursor,
             });
         }
         catch (err) {
@@ -71,7 +74,10 @@ class SkillsBrowse extends base_command_1.BaseCommand {
         const r = response;
         const items = Array.isArray(r) ? r : (r?.data ?? []);
         if (items.length === 0) {
-            this.log('No skills found.');
+            this.log((0, skill_store_pagination_1.skillStorePageState)(response, flags.cursor).hasMore
+                ? 'No skills on this page. More candidates remain.'
+                : 'No skills found.');
+            (0, skill_store_pagination_1.reportSkillStorePage)(response, flags.cursor, (message) => this.log(message), (message) => this.warn(message));
             return;
         }
         const rows = items.map(skillBrowseRow);
@@ -83,6 +89,7 @@ class SkillsBrowse extends base_command_1.BaseCommand {
             { key: 'installs', header: 'INSTALLS' },
             { key: 'description', header: 'DESCRIPTION', maxWidth: 60 },
         ], (line) => this.log(line));
+        (0, skill_store_pagination_1.reportSkillStorePage)(response, flags.cursor, (message) => this.log(message), (message) => this.warn(message));
     }
 }
 exports.default = SkillsBrowse;

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

@@ -17,6 +17,7 @@ export default class SkillsSearch extends BaseCommand {
         query: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         category: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         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>;
     };
     run(): Promise<void>;
 }

package/dist/commands/skills/search.js

@@ -6,6 +6,7 @@ const base_command_1 = require("../../base-command");
 const format_1 = require("../../lib/format");
 const search_query_1 = require("../../lib/search-query");
 const usd_micros_1 = require("../../lib/usd-micros");
+const skill_store_pagination_1 = require("../../lib/skill-store-pagination");
 class SkillsSearch extends base_command_1.BaseCommand {
     static description = 'Search skills in the skrr store by keyword (same as `search skills`)';
     static examples = [
@@ -37,6 +38,7 @@ class SkillsSearch extends base_command_1.BaseCommand {
         query: core_1.Flags.string({ char: 'q', description: 'Search query' }),
         category: core_1.Flags.string({ description: 'Filter by category' }),
         limit: core_1.Flags.integer({ description: 'Maximum number of results', default: 20 }),
+        cursor: core_1.Flags.string({ description: 'Continue from a previous page' }),
     };
     async run() {
         this.requireAuth();
@@ -48,6 +50,7 @@ class SkillsSearch extends base_command_1.BaseCommand {
                 q: query,
                 category: flags.category,
                 limit: flags.limit,
+                cursor: flags.cursor,
             });
         }
         catch (err) {
@@ -59,8 +62,15 @@ class SkillsSearch extends base_command_1.BaseCommand {
         }
         const r = response;
         const items = Array.isArray(r) ? r : (r?.data ?? []);
+        const incomplete = (0, skill_store_pagination_1.skillStoreSearchIncomplete)(response);
+        if (incomplete)
+            this.warn('Skill store search may be incomplete. Try again or narrow your query.');
         if (items.length === 0) {
-            this.log(`No skills found matching '${query}'.`);
+            this.log((0, skill_store_pagination_1.skillStorePageState)(response, flags.cursor).hasMore
+                ? 'No skills matched on this page. More candidates remain.'
+                : incomplete ? 'No skills confirmed in the available search results.'
+                    : `No skills found matching '${query}'.`);
+            (0, skill_store_pagination_1.reportSkillStorePage)(response, flags.cursor, (message) => this.log(message), (message) => this.warn(message));
             return;
         }
         const rows = items.map((s) => ({
@@ -79,6 +89,7 @@ class SkillsSearch extends base_command_1.BaseCommand {
             { key: 'installs', header: 'INSTALLS' },
             { key: 'description', header: 'DESCRIPTION', maxWidth: 60 },
         ], (line) => this.log(line));
+        (0, skill_store_pagination_1.reportSkillStorePage)(response, flags.cursor, (message) => this.log(message), (message) => this.warn(message));
     }
 }
 exports.default = SkillsSearch;

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

@@ -0,0 +1,18 @@
+import { type SpaceOrchestrationComparison } from '@skrr-ai/data-provider';
+import { BaseCommand } from '../../../base-command';
+/** The comparison as the lines the command prints. Pure, so it is tested as such. */
+export declare function comparisonLines(result: SpaceOrchestrationComparison): string[];
+export default class SpacesAutoExecutorCompare 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>;
+        days: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        since: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        until: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,139 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.comparisonLines = comparisonLines;
+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");
+/** The board fields in the order the server records them. */
+const BOARD_ROWS = [
+    ['unassigned', 'unassigned (assignments)'],
+    ['ready', 'ready, not running (starts)'],
+    ['failed', 'failed (failure handling)'],
+    ['running', 'running'],
+    ['blocked', 'blocked by dependencies'],
+    ['scheduled', 'scheduled'],
+];
+const DAY_MS = 24 * 60 * 60 * 1000;
+function turnsLine(turns) {
+    const parts = Object.entries(turns.byStatus)
+        .sort(([a], [b]) => a.localeCompare(b))
+        .map(([status, count]) => `${status} ${count}`);
+    return parts.length ? `${turns.total} (${parts.join(', ')})` : String(turns.total);
+}
+function holderNowLabel(current) {
+    if (current.holder === 'leader')
+        return 'the Leader';
+    if (current.holder === 'space_loop') {
+        return `the space_orchestration loop ${current.commitmentId ?? ''}`.trim();
+    }
+    return 'unknown (could not be read)';
+}
+/** The comparison as the lines the command prints. Pure, so it is tested as such. */
+function comparisonLines(result) {
+    const lines = [];
+    lines.push(`Judgment turn now: ${holderNowLabel(result.current)}`);
+    lines.push(`Window:            ${result.since} to ${result.until}`);
+    if (result.spaceLoop.loops.length) {
+        lines.push(`Loops:             ${result.spaceLoop.loops.join(', ')}`);
+    }
+    lines.push('');
+    const width = 30;
+    const column = 22;
+    const pad = (value) => value.padEnd(width);
+    lines.push(`${pad('')}${'Leader'.padEnd(column)}Loop`);
+    lines.push(`${pad('Ticks held')}${String(result.leader.ticks).padEnd(column)}${result.spaceLoop.ticks}`);
+    lines.push(`${pad('Turns')}${turnsLine(result.leader.turns).padEnd(column)}${turnsLine(result.spaceLoop.turns)}`);
+    lines.push(`${pad('Starts by its turns')}${String(result.leader.starts).padEnd(column)}not counted`);
+    lines.push('Backlog per tick (mean / peak):');
+    for (const [field, label] of BOARD_ROWS) {
+        const leader = result.leader.board[field];
+        const loop = result.spaceLoop.board[field];
+        lines.push(`  ${label.padEnd(width - 2)}${`${leader.mean} / ${leader.peak}`.padEnd(column)}${loop.mean} / ${loop.peak}`);
+    }
+    lines.push('');
+    lines.push(result.concurrentTurns === 0
+        ? 'Concurrent turns:  0'
+        : `Concurrent turns:  ${result.concurrentTurns} (a Leader turn and a loop turn overlapped; see the runs and the loop Cycles)`);
+    if (result.unreadableTicks > 0) {
+        lines.push(`Unreadable ticks:  ${result.unreadableTicks} (the holder could not be read, so the Leader stood down)`);
+    }
+    if (result.truncated) {
+        lines.push('This window holds more records than one comparison reads; narrow it.');
+    }
+    if (result.overlapUnknownEndTurns) {
+        lines.push(`Unknown turn endpoints: ${result.overlapUnknownEndTurns} (overlap count is incomplete)`);
+    }
+    for (const [label, stats] of [['Leader', result.leader], ['Loop', result.spaceLoop]]) {
+        if (stats.boardSamples) {
+            for (const [field] of BOARD_ROWS) {
+                if (stats.boardSamples[field] < stats.ticks) {
+                    lines.push(`${label} ${field}: ${stats.boardSamples[field]} of ${stats.ticks} ticks measured (missing values are not zero backlog)`);
+                }
+            }
+        }
+    }
+    if (result.leader.ticks + result.spaceLoop.ticks === 0) {
+        lines.push('No tick in this window recorded who held the turn. A tick records it only when the auto-executor is on and reaches its judgment turn.');
+    }
+    for (const [label, stats] of [['Leader', result.leader], ['Loop', result.spaceLoop]]) {
+        if (stats.sampling) {
+            const sampling = stats.sampling;
+            lines.push(`${label} samples: ${sampling.sampledUtcDays} UTC days, ${sampling.spanHours.toFixed(1)} hours first to last; largest gap ${sampling.maxGapHours.toFixed(1)} hours`);
+        }
+    }
+    if (result.spaceLoop.evidence) {
+        const evidence = result.spaceLoop.evidence;
+        lines.push(`Loop terminal reasons: ${evidence.terminalRunsWithReason} recorded, ${evidence.terminalRunsMissingReason} missing (review still required)`);
+        lines.push(`Loop reported cost: ${(evidence.reportedCostUsdMicros / 1_000_000).toFixed(6)} USD across ${evidence.costStatusCounts.reported} runs; ${evidence.costStatusCounts.unknown + evidence.costStatusCounts.partial + evidence.costStatusCounts.unavailable} runs without complete reported cost`);
+    }
+    for (const gap of result.evidenceGaps ?? [])
+        lines.push(`Evidence gap: ${gap}`);
+    return lines;
+}
+class SpacesAutoExecutorCompare extends base_command_1.BaseCommand {
+    static description = "Compare the Space Leader with the Space's space_orchestration loop: who held the judgment turn, the board each held it over, and whether their turns overlapped";
+    static examples = [
+        '<%= config.bin %> spaces auto-executor compare <space-id>',
+        '<%= config.bin %> spaces auto-executor compare <space-id> --days 14',
+        '<%= config.bin %> spaces auto-executor compare <space-id> --since 2026-10-01T00:00:00Z --until 2026-10-15T00:00:00Z --json',
+    ];
+    static args = {
+        id: core_1.Args.string({ description: 'Space ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+        days: core_1.Flags.integer({
+            description: 'Window ending now, in days (default 7, at most 90)',
+            min: 1,
+            max: 90,
+            exclusive: ['since'],
+        }),
+        since: core_1.Flags.string({ description: 'Window start (ISO 8601)' }),
+        until: core_1.Flags.string({ description: 'Window end (ISO 8601; default now)' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(SpacesAutoExecutorCompare);
+        const spaceRef = await this.resolveEntityRef('space', args.id);
+        const until = flags.until;
+        const since = flags.since ??
+            (flags.days
+                ? new Date((until ? Date.parse(until) : Date.now()) - flags.days * DAY_MS).toISOString()
+                : undefined);
+        let result;
+        try {
+            result = await data_provider_1.dataService.getSpaceOrchestrationComparison(spaceRef, { since, until });
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.printJsonResult((0, space_output_1.withSpacePerspectiveUrl)(this.cliConfig.baseURL, spaceRef, 'execution', { result }));
+            return;
+        }
+        for (const line of comparisonLines(result))
+            this.log(line);
+    }
+}
+exports.default = SpacesAutoExecutorCompare;

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 {