runcloud 0.2.177 → 0.2.178

package/dist/commands/run-cloud-fleet-releases.js

@@ -0,0 +1,26 @@
+const PATH = '/run-cloud/admin/fleet-releases';
+export const RELEASE_CHANNELS = ['ios/dev', 'ios/prod', 'android/dev', 'android/prod'];
+export async function listReleaseChannels(client) {
+    const body = await client.get(PATH, { signal: AbortSignal.timeout(30000) });
+    if (!body?.configured)
+        throw new Error('Fleet release storage is not configured on this API');
+    return { unavailable: body.unavailable === true, channels: body.channels ?? [] };
+}
+export async function promoteReleaseChannel(client, input) {
+    if (!RELEASE_CHANNELS.includes(input.channel))
+        throw new Error(`Channel must be one of ${RELEASE_CHANNELS.join(', ')}`);
+    const { channels, unavailable } = await listReleaseChannels(client);
+    if (unavailable)
+        throw new Error('Fleet release storage is unavailable; nothing was promoted');
+    const current = channels.find(channel => channel.channel === input.channel);
+    return await client.post(PATH, { channel: input.channel, version: input.version, reason: input.reason,
+        digest: input.digest ?? null, artifact: input.artifact ?? null, expectedRevision: current?.revision ?? 0 }, { signal: AbortSignal.timeout(30000) });
+}
+export function releaseText(channels) {
+    return RELEASE_CHANNELS.map(name => {
+        const channel = channels.find(item => item.channel === name);
+        return channel
+            ? `${name.padEnd(13)} ${channel.version} r${channel.revision} by ${channel.promotedBy} at ${channel.promotedAt}${channel.digest ? ` ${channel.digest}` : ''}`
+            : `${name.padEnd(13)} unset (hosts use their inventory pin)`;
+    }).join('\n');
+}

package/dist/commands/run-cloud-fleet.js

@@ -4,6 +4,7 @@ import { readFileSync, statSync } from 'node:fs';
 import { ApiClient, ApiError } from '../api.js';
 import { requireCredentials } from '../config.js';
 import { surveyFleet, surveyText } from './run-cloud-fleet-survey.js';
+import { listReleaseChannels, promoteReleaseChannel, releaseText } from './run-cloud-fleet-releases.js';
 const ROOT = '/run-cloud/admin/simulators';
 const RANGES = ['1h', '6h', '24h', '7d', '30d', '90d', '1y', '2y'];
 export const ACCESSIBILITY_CODES = ['accessibility_device_unavailable', 'accessibility_capture_failed'];
@@ -300,7 +301,7 @@ function printReport(report, json) {
         console.log(`${failure.timestamp ?? 'time missing'} ${failure.code ?? failure.type ?? 'failure'} host=${failure.hostId ?? 'unknown'} device=${failure.deviceId ?? 'unknown'} providerSession=${failure.providerSessionId ?? 'unknown'}; ${failure.correlation.causation}`);
 }
 export function registerRunCloudFleet(program) {
-    const fleet = program.command('fleet').description('Read-only admin fleet telemetry, diagnosis, events and original failure evidence');
+    const fleet = program.command('fleet').description('Admin fleet telemetry, diagnosis, events, failure evidence and serve-sim release channels');
     fleet.command('survey [hostId]').description('Survey all fleet signals in seconds; authenticated admin reads, no local services')
         .option('--json', 'Structured metrics, diagnosis, observations and coverage')
         .option('--range <range>', 'Alert/input-lag window: 1h, 6h, 24h, 7d', '24h')
@@ -330,6 +331,19 @@ export function registerRunCloudFleet(program) {
         requireFleetReadAccess(result.coverage.reason);
         console.log(JSON.stringify({ coverage: result.coverage, items: result.items.map(eventEvidence) }, null, 2));
     }));
+    fleet.command('releases').description('Show the serve-sim release channel each pool runs (admin read)')
+        .option('--json', 'Structured channel records')
+        .action(opts => action(async () => {
+        const { channels, unavailable } = await listReleaseChannels(credentialsClient());
+        console.log(opts.json ? JSON.stringify({ unavailable, channels }, null, 2) : `${unavailable ? 'Warning: release storage was partly unavailable\n' : ''}${releaseText(channels)}`);
+    }));
+    fleet.command('promote <channel> <version>').description('Point one pool (ios|android/dev|prod) at a serve-sim build; audited admin write, no host is touched')
+        .requiredOption('--reason <text>', 'Why this build is promoted; kept in the audit history')
+        .option('--digest <sha256>', 'Artifact content digest, sha256:<64 hex>').option('--artifact <ref>', 'Where the artifact comes from, e.g. gh-run:<id>')
+        .action((channel, version, opts) => action(async () => {
+        const release = await promoteReleaseChannel(credentialsClient(), { channel, version, reason: opts.reason, digest: opts.digest, artifact: opts.artifact });
+        console.log(`${release.channel} -> ${release.version} (revision ${release.revision}; was ${release.previous?.version ?? 'unset'})`);
+    }));
     fleet.command('logs <hostId>').description('Read bounded retained host logs; no SSH or host changes')
         .option('--source <source>', 'service, warm_pool, or event_log', 'service').option('--limit <rows>', 'Maximum lines (1..500)', '100')
         .action((hostId, opts) => action(async () => {

package/dist/version.js

@@ -1 +1 @@
-export const CLI_VERSION = '0.2.177';
+export const CLI_VERSION = '0.2.178';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runcloud",
-  "version": "0.2.177",
+  "version": "0.2.178",
   "description": "Create and control run.cloud remote mobile simulators and cloud sandboxes",
   "license": "Apache-2.0",
   "keywords": [