@skrr-ai/cli 0.1.110 → 0.1.111

package/dist/commands/followups/plans/list.js

@@ -0,0 +1,50 @@
+"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 lookbackPlans_1 = require("../../../lib/lookbackPlans");
+const followups_1 = require("../../../lib/followups");
+const list_output_1 = require("../../../lib/list-output");
+class LookbackPlansList extends base_command_1.BaseCommand {
+    static description = 'List lookback plans, active first, with bounded history pagination';
+    static flags = {
+        agent: core_1.Flags.string({ description: 'Agent ID (default: bound session agent)', exclusive: ['all-agents'] }),
+        'all-agents': core_1.Flags.boolean({ description: 'List all agents owned by you', exclusive: ['agent'] }),
+        state: core_1.Flags.string({ description: 'Filter plan state', options: [...data_provider_1.LOOKBACK_PLAN_STATES] }),
+        limit: core_1.Flags.integer({ description: 'Maximum plans (1..100)', min: 1, max: 100 }),
+        cursor: core_1.Flags.string({ description: 'Opaque nextCursor from a previous page; keep the same scope and filters' }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(LookbackPlansList);
+        let agentId;
+        try {
+            agentId = flags['all-agents'] ? undefined : (0, followups_1.resolveFollowUpAgent)(flags.agent).id;
+        }
+        catch (err) {
+            this.failWithCliError({ message: err instanceof Error ? err.message : String(err), code: 'AGENT_CONTEXT_AMBIGUOUS', exit: 2, retryable: false });
+            return;
+        }
+        try {
+            const result = await lookbackPlans_1.lookbackPlansApi.list({ agentId, state: flags.state, limit: flags.limit, cursor: flags.cursor });
+            if (flags.json) {
+                this.printJsonResult((0, list_output_1.listResult)(result, 'plans'));
+                return;
+            }
+            if (!result.plans.length) {
+                this.log('No lookback plans.');
+                return;
+            }
+            for (const plan of result.plans)
+                this.log((0, lookbackPlans_1.lookbackPlanSummary)(plan));
+            if (result.hasMore)
+                this.log(`More plans: repeat this command with --cursor ${result.nextCursor}`);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = LookbackPlansList;

package/dist/commands/followups/plans/observability.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../../base-command';
+export default class LookbackPlansObservability extends BaseCommand {
+    static description: string;
+    static flags: {
+        agent: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'all-agents': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        limit: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/followups/plans/observability.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const lookbackPlans_1 = require("../../../lib/lookbackPlans");
+const followups_1 = require("../../../lib/followups");
+class LookbackPlansObservability extends base_command_1.BaseCommand {
+    static description = 'Inspect bounded lookback scheduling health and evaluation outcomes';
+    static flags = {
+        agent: core_1.Flags.string({ description: 'Agent ID (default: bound session agent)', exclusive: ['all-agents'] }),
+        'all-agents': core_1.Flags.boolean({ description: 'Inspect all owned agents', exclusive: ['agent'] }),
+        limit: core_1.Flags.integer({ description: 'Maximum sampled plans (1..100)', min: 1, max: 100 }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(LookbackPlansObservability);
+        let agentId;
+        try {
+            agentId = flags['all-agents'] ? undefined : (0, followups_1.resolveFollowUpAgent)(flags.agent).id;
+        }
+        catch (err) {
+            this.failWithCliError({ message: err instanceof Error ? err.message : String(err), code: 'AGENT_CONTEXT_AMBIGUOUS', exit: 2, retryable: false });
+            return;
+        }
+        try {
+            const result = await lookbackPlans_1.lookbackPlansApi.observability({ agentId, limit: flags.limit });
+            if (flags.json) {
+                this.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            this.log(`${result.sample.plans} plans sampled${result.sample.truncated ? ' (more exist)' : ''}.`);
+            for (const group of result.groups) {
+                this.log(`${group.agentId}: ${group.evaluations.used}/${group.evaluations.ceiling} evaluations used`);
+                for (const [name, count] of Object.entries(group.health)) {
+                    if (count > 0)
+                        this.log(`  ${name}: ${count}`);
+                }
+            }
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = LookbackPlansObservability;

package/dist/commands/followups/plans/revise.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base-command';
+export default class LookbackPlansRevise extends BaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        revision: import("@oclif/core/lib/interfaces").OptionFlag<number, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'from-json': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/followups/plans/revise.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const prompt_1 = require("../../../lib/prompt");
+const lookbackPlans_1 = require("../../../lib/lookbackPlans");
+class LookbackPlansRevise extends base_command_1.BaseCommand {
+    static description = 'Revise pending lookbacks using the original source and step IDs';
+    static args = { id: lookbackPlans_1.lookbackPlanIdArg };
+    static flags = {
+        revision: core_1.Flags.integer({ description: 'Expected current revision; stale edits are refused', min: 1, required: true }),
+        'from-json': core_1.Flags.string({ description: 'Full PlanInput JSON file; - reads stdin', required: true }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(LookbackPlansRevise);
+        let plan;
+        try {
+            plan = (0, lookbackPlans_1.lookbackInput)(await (0, prompt_1.readJsonBody)(flags['from-json']), true);
+        }
+        catch (err) {
+            this.failWithCliError({ message: err instanceof Error ? err.message : String(err), code: 'LOOKBACK_INVALID_FIELD', exit: 2, retryable: false });
+            return;
+        }
+        try {
+            const result = await lookbackPlans_1.lookbackPlansApi.revise(args.id, { expectedRevision: flags.revision, plan });
+            this.log(flags.json ? JSON.stringify(result, null, 2) : (0, lookbackPlans_1.lookbackArmingLine)(result));
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = LookbackPlansRevise;

package/dist/commands/followups/plans/show.d.ts

@@ -0,0 +1,11 @@
+import { BaseCommand } from '../../../base-command';
+export default class LookbackPlansShow extends BaseCommand {
+    static description: string;
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/followups/plans/show.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../../base-command");
+const lookbackPlans_1 = require("../../../lib/lookbackPlans");
+class LookbackPlansShow extends base_command_1.BaseCommand {
+    static description = 'Show a lookback plan, step outcomes and its current revision';
+    static args = { id: lookbackPlans_1.lookbackPlanIdArg };
+    static flags = { json: core_1.Flags.boolean({ description: 'Output as JSON' }) };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(LookbackPlansShow);
+        try {
+            const result = await lookbackPlans_1.lookbackPlansApi.show(args.id);
+            if (flags.json) {
+                this.log(JSON.stringify(result, null, 2));
+                return;
+            }
+            this.log((0, lookbackPlans_1.lookbackPlanSummary)(result.plan));
+            this.log(`Objective: ${result.plan.objective}\nStop when: ${result.plan.stopCondition}`);
+            for (const step of result.plan.steps) {
+                this.log(`  ${step.id} [${step.state}${step.outcome ? `/${step.outcome}` : ''}] ${step.runAt} ${step.label || step.instruction}`);
+                if (step.summary)
+                    this.log(`    ${step.summary}`);
+            }
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+    }
+}
+exports.default = LookbackPlansShow;

package/dist/commands/goals/key-results/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -36,7 +37,7 @@ class GoalsKeyResultsList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(response));
             return;
         }
         const items = response?.data ?? [];

package/dist/commands/goals/labels/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -29,7 +30,7 @@ class GoalsLabelsList extends base_command_1.BaseCommand {
         const labelIds = goal.labelIds ?? [];
         if (labelIds.length === 0) {
             if (flags.json) {
-                this.log(JSON.stringify({ data: [] }, null, 2));
+                this.printJsonResult((0, list_output_1.listResult)({ data: [] }));
                 return;
             }
             this.log('No labels on this goal.');
@@ -47,7 +48,7 @@ class GoalsLabelsList extends base_command_1.BaseCommand {
             }
         }));
         if (flags.json) {
-            this.log(JSON.stringify({ data: hydrated }, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)({ data: hydrated }));
             return;
         }
         const rows = hydrated.map((l) => {

package/dist/commands/goals/list.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
 const web_url_1 = require("../../lib/web-url");
 const format_1 = require("../../lib/format");
-const list_output_1 = require("../../lib/list-output");
+const list_output_2 = require("../../lib/list-output");
 class GoalsList extends base_command_1.BaseCommand {
     static description = 'List goals';
     static examples = [
@@ -77,7 +78,7 @@ class GoalsList extends base_command_1.BaseCommand {
             // a script reads `.data` here exactly as it does for tasks and projects. The
             // space-scoped endpoint is not paginated and answers a bare `{data}`; filling
             // the missing fields is additive, so nothing that read `.data` changes.
-            this.log(JSON.stringify((0, web_url_1.withDataUrls)(this.cliConfig.baseURL, (0, list_output_1.toListEnvelope)(response) ?? response, web_url_1.goalUrlFrom), null, 2));
+            this.printJsonResult((0, list_output_1.listResult)((0, web_url_1.withDataUrls)(this.cliConfig.baseURL, (0, list_output_2.toListEnvelope)(response) ?? response, web_url_1.goalUrlFrom)));
             return;
         }
         // Both listGoals and listSpaceGoals return { data: Goal[] }. The general

package/dist/commands/grants/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../base-command");
 const grants_1 = require("../../lib/grants");
@@ -32,7 +33,7 @@ class GrantsList extends base_command_1.BaseCommand {
             provider: flags.provider,
         }));
         if (flags.json) {
-            this.log(JSON.stringify(response.grants, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(response.grants));
             return;
         }
         (0, grants_1.renderGrantList)(response.grants, (line) => this.log(line));

package/dist/commands/harnesses/grants/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../../base-command");
 const format_1 = require("../../../lib/format");
@@ -33,7 +34,7 @@ class HarnessesGrantsList extends base_command_1.BaseCommand {
             return;
         }
         if (flags.json) {
-            this.log(JSON.stringify(grants, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(grants));
             return;
         }
         if (grants.length === 0) {

package/dist/commands/harnesses/leases/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 /**
  * Harness leases — the hosted billing plane.
  *
@@ -53,7 +54,7 @@ class HarnessesLeasesList extends base_command_1.BaseCommand {
         }
         const leases = response?.leases ?? [];
         if (flags.json) {
-            this.log(JSON.stringify(leases, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(leases));
             return;
         }
         if (leases.length === 0) {

package/dist/commands/harnesses/list.js

@@ -11,6 +11,7 @@ exports.selectHarnessRows = selectHarnessRows;
 exports.buildHarnessesJson = buildHarnessesJson;
 exports.readinessFootnotes = readinessFootnotes;
 exports.canonicalHarnessRows = canonicalHarnessRows;
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const auth_core_1 = require("@skrr-ai/auth-core");
 const base_command_1 = require("../../base-command");
@@ -288,12 +289,15 @@ function readinessFootnotes(rows, readiness) {
     let unmanaged = 0;
     let noAnswer = 0;
     let unknown = 0;
+    let unverified = 0;
     let notReady = 0;
     for (const row of rows) {
         const verdict = readiness.lookup(row);
         if (verdict) {
             if (verdict.label === 'unknown')
                 unknown += 1;
+            else if (verdict.label === 'unverified')
+                unverified += 1;
             else if (!verdict.ok)
                 notReady += 1;
         }
@@ -316,6 +320,11 @@ function readinessFootnotes(rows, readiness) {
     if (unknown > 0) {
         lines.push(`(READINESS unknown: ${unknown} installed, but the daemon cannot read that provider's sign-in state.)`);
     }
+    if (unverified > 0) {
+        // A sign-in is there and nothing the daemon has seen says a model is behind it
+        // (OSK-16927). Not counted as not ready: the next step is a check, not a fix.
+        lines.push(`(READINESS unverified: ${unverified} with a local sign-in that no session on that machine has confirmed reaches a model — \`skrr harnesses models <id>\` checks, without sending a prompt.)`);
+    }
     if (notReady > 0) {
         lines.push(`(${notReady} not ready — \`skrr harnesses show <id>\` says what each needs.)`);
     }
@@ -473,7 +482,7 @@ class HarnessesList extends base_command_1.BaseCommand {
                 daemon: flags.daemon ?? null,
                 limit: flags.limit ?? null,
             }, res, readiness ? readiness.lookup : () => undefined);
-            this.log(JSON.stringify(payload, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(payload, 'harnesses'));
             return;
         }
         if (selection.visible.length === 0) {

package/dist/commands/ingress/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../base-command");
 const ingress_1 = require("../../lib/ingress");
@@ -23,7 +24,7 @@ class IngressList extends base_command_1.BaseCommand {
         const { flags } = await this.parse(IngressList);
         const response = await ingress_1.ingressApi.list();
         if (flags.json) {
-            this.log(JSON.stringify(response.ingresses, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(response.ingresses));
             return;
         }
         (0, ingress_1.renderIngressList)(response.ingresses, (line) => this.log(line));

package/dist/commands/initiatives/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../base-command");
 const initiatives_1 = require("../../lib/initiatives");
@@ -48,7 +49,7 @@ class InitiativesList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(response, 'initiatives'));
             return;
         }
         const rows = response.initiatives ?? [];

package/dist/commands/instruction-blocks/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
@@ -44,7 +45,7 @@ class InstructionBlocksList extends base_command_1.BaseCommand {
             ...(flags.official ? [] : catalog.library),
         ].filter((block) => !flags.category || block.category === flags.category);
         if (flags.json) {
-            this.log(JSON.stringify({ blocks: all }, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)({ blocks: all }, 'blocks'));
             return;
         }
         if (!all.length) {

package/dist/commands/instructions/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
@@ -26,7 +27,7 @@ class InstructionsList extends base_command_1.BaseCommand {
             this.handleApiError(error);
         }
         if (flags.json)
-            return this.log(JSON.stringify(response, null, 2));
+            return this.printJsonResult((0, list_output_1.listResult)(response, 'bundles'));
         if (!response.bundles.length)
             return this.log('No managed instruction prompts.');
         (0, format_1.renderTable)(response.bundles.map((bundle) => ({

package/dist/commands/integrations/connections/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -41,7 +42,7 @@ class IntegrationsConnectionsList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(resp, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(resp, 'connections'));
             return;
         }
         const connections = resp.connections;

package/dist/commands/integrations/tools/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
@@ -46,7 +47,7 @@ class IntegrationsToolsList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(resp, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(resp, 'tools'));
             return;
         }
         const tools = resp.tools;

package/dist/commands/labels/list.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.labelListRows = labelListRows;
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../base-command");
@@ -106,12 +107,12 @@ class LabelsList extends base_command_1.BaseCommand {
         }
         if (flags.json) {
             const ordered = (0, data_provider_1.orderLabelsBySpaceUsage)(items, spaceUsage);
-            this.log(JSON.stringify({
+            this.printJsonResult((0, list_output_1.listResult)({
                 data: spaceUsage
                     ? ordered.map((l) => ({ ...l, spaceUsageCount: spaceUsage?.get(String(l.id)) ?? 0 }))
                     : ordered,
                 ...(flags.space ? { spaceId: flags.space } : {}),
-            }, null, 2));
+            }));
             return;
         }
         if (items.length === 0) {

package/dist/commands/learning/adapters.d.ts

@@ -0,0 +1,16 @@
+import { Command } from '@oclif/core';
+export default class LearningAdapters extends Command {
+    static baseFlags: {
+        bare: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        token: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        workspace: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        profile: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        raw: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/learning/adapters.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const guide = {
+    scope: 'Learning evidence adapters',
+    installation: 'Reviewed server module passed to createAdapterRegistry; not an uploaded or remote plugin',
+    guideUrl: 'https://github.com/dush1023/OverSky/blob/main/api/server/services/LearningCapabilities/ADAPTERS.md',
+    repositoryGuide: 'api/server/services/LearningCapabilities/ADAPTERS.md',
+    example: 'api/server/services/LearningCapabilities/examples/qualityInspection.js',
+    conformance: {
+        module: 'api/server/services/LearningCapabilities/conformance.js',
+        requiredFixtures: ['validInput', 'changedInput (different normalized content)'],
+        command: 'cd api && npx jest --runInBand server/services/LearningCapabilities/__tests__/adapters.conformance.spec.js',
+    },
+    boundaries: [
+        'Adapters normalize already-authorized native source evidence. They do not grant source access or execute a learned capability.',
+        'Only local normalization is supported here: destination oversky, evidence:read, zero provider calls. Model processing uses the governed media service.',
+        'A conformance pass covers its fixtures. It does not certify native source authenticity, perception accuracy or provider deletion.',
+    ],
+};
+// Authoring documentation is available without a credential/daemon handoff.
+class LearningAdapters extends core_1.Command {
+    static baseFlags = base_command_1.BaseCommand.baseFlags;
+    static description = 'Find the Learning evidence-adapter authoring and conformance guide';
+    static examples = [
+        '<%= config.bin %> learning adapters',
+        '<%= config.bin %> learning adapters --json',
+    ];
+    static flags = {
+        json: core_1.Flags.boolean({
+            description: 'Output the guide coordinates and supported boundary as JSON',
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(LearningAdapters);
+        if (flags.json) {
+            this.log(JSON.stringify({ ok: true, ...guide }, null, 2));
+            return;
+        }
+        this.log(`Learning evidence adapters\n${guide.installation}\n\nGuide: ${guide.guideUrl}\nIn the repository: ${guide.repositoryGuide}\nExample: ${guide.example}\n\nConformance: ${guide.conformance.command}\nRequired fixtures: ${guide.conformance.requiredFixtures.join(', ')}\n\n${guide.boundaries.join('\n')}`);
+    }
+}
+exports.default = LearningAdapters;

package/dist/commands/machines/dedicated/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const dedicated_lease_command_1 = require("../../../lib/dedicated-lease-command");
 const format_1 = require("../../../lib/format");
@@ -25,7 +26,7 @@ class DedicatedMachinesList extends dedicated_lease_command_1.DedicatedLeaseComm
             ...this.scopeFrom(flags),
         }));
         if (flags.json) {
-            this.log(JSON.stringify(response, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(response, 'leases'));
             return;
         }
         const leases = response?.leases ?? [];

package/dist/commands/machines/hosted/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../../lib/list-output");
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../../base-command");
 const api_fetch_1 = require("../../../lib/api-fetch");
@@ -34,7 +35,7 @@ class HostedMachinesList extends base_command_1.BaseCommand {
             this.handleApiError(err);
         }
         if (flags.json) {
-            this.log(JSON.stringify(flags.details ? response : (0, hosted_machines_1.curateHostedMachineList)(response), null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(flags.details ? response : (0, hosted_machines_1.curateHostedMachineList)(response)));
             return;
         }
         const sessions = response.data ?? [];

package/dist/commands/machines/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const machine_uuid_1 = require("@skrr-ai/auth-core/machine-uuid");
 const base_command_1 = require("../../base-command");
@@ -53,7 +54,7 @@ class MachinesList extends base_command_1.BaseCommand {
         }));
         const shown = reachable;
         if (flags.json) {
-            this.log(JSON.stringify(views, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(views));
             return;
         }
         if (all.length === 0) {

package/dist/commands/machines/show.js

@@ -139,8 +139,11 @@ class MachinesShow extends base_command_1.BaseCommand {
                 provider: (0, harness_labels_1.harnessProviderLabel)(h.provider),
                 // Liveness only. Whether a newer registration replaced the row is a
                 // different fact — a superseded row can have been online — so it
-                // gets its own column rather than overwriting this one.
-                status: (0, format_1.formatCell)(h.status),
+                // gets its own column rather than overwriting this one. It is the
+                // server's statement about the row (`stale`, `reconnecting`), not the
+                // bare recorded status: the line above says `stale` for a machine whose
+                // table then read `online` for every row in it (OSK-16442).
+                status: (0, format_1.formatCell)((0, machines_1.harnessStateLabel)(h)),
                 registration: h.superseded ? 'superseded' : 'current',
                 readiness: readinessFor(h)?.label ?? '-',
                 seen: (0, format_1.localStamp)(h.lastSeenAt),

package/dist/commands/measures/list.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+const list_output_1 = require("../../lib/list-output");
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../base-command");
 const measures_1 = require("../../lib/measures");
@@ -29,7 +30,7 @@ class MeasuresList extends base_command_1.BaseCommand {
             status: flags.status,
         }));
         if (flags.json) {
-            this.log(JSON.stringify(response.measures, null, 2));
+            this.printJsonResult((0, list_output_1.listResult)(response.measures));
             return;
         }
         (0, measures_1.renderMeasureList)(response.measures, (line) => this.log(line));