@newly/cli 0.2.201 → 0.2.203

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

@@ -7,7 +7,7 @@ export function releaseControlRequest(file) {
     const value = JSON.parse(readFileSync(file, 'utf8'));
     if (!value || typeof value !== 'object' || Array.isArray(value) || typeof value.reason !== 'string' || !value.reason.trim()
         || !Number.isSafeInteger(value.expectedRevision) || Number(value.expectedRevision) < 0
-        || !['bootstrap', 'enroll', 'announce', 'override', 'pause', 'resume', 'rollback', 'defer'].includes(String(value.action))) {
+        || !['bootstrap', 'enroll', 'announce', 'override', 'record-activation', 'pause', 'resume', 'rollback', 'defer'].includes(String(value.action))) {
         throw new Error('Request needs action, reason and expectedRevision from the current release-control status');
     }
     return value;

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

@@ -21,6 +21,6 @@ export function releaseText(channels) {
         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');
+            : `${name.padEnd(13)} unset`;
+    }).join('\n') + '\nRetired channels: expectations and targets come only from `runcloud fleet release-control status`.';
 }

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

@@ -334,13 +334,13 @@ 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)')
+    fleet.command('releases').description('Show the retired serve-sim release channels as history; targets live in `fleet release-control status` (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')
+    fleet.command('promote <channel> <version>').description('Retired: the API refuses channel promotions. Announce a rollout or record an activation with `fleet release-control apply`')
         .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 () => {

package/dist/commands/support.js

@@ -1,9 +1,10 @@
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { dirname, join } from 'node:path';
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
 import { ApiClient, friendlyApiError } from '../api.js';
 import { requireCredentials, resolveProject } from '../config.js';
 import { SUPPORT_CHAT_TSX } from './supportChat.generated.js';
 export const SUPPORT_CONFIG = 'src/lib/newly-support.json';
+export const SUPPORT_ARTICLES_DIR = 'support/articles';
 export const SUPPORT_CHAT = 'src/components/SupportChat.tsx';
 export function writeSupportChat(dir, force = false) {
     const path = join(dir, SUPPORT_CHAT);
@@ -104,6 +105,64 @@ export async function runArticlesList(client, projectId, log) {
     for (const a of articles)
         log(`${a.id}  ${a.title}  (updated ${a.updated_at})`);
 }
+const slugOf = (title) => title.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '').slice(0, 60).replace(/-+$/, '') || 'article';
+const INDEX = 'articles.json';
+function exportedFiles(dir) {
+    try {
+        const { articles } = JSON.parse(readFileSync(join(dir, INDEX), 'utf8'));
+        return (articles ?? []).map((a) => a.file).filter((f) => typeof f === 'string' && /^[a-z0-9-]+\.md$/.test(f));
+    }
+    catch {
+        return [];
+    }
+}
+export const WEBSITE_ARTICLES = 'support-articles.json';
+export async function runArticlesExport(client, projectId, dir, log, websiteDir) {
+    const { settings } = (await client.get(`${base(projectId)}/settings`));
+    const websiteCopy = websiteDir ? join(websiteDir, WEBSITE_ARTICLES) : null;
+    if (!settings?.enabled) {
+        if (websiteCopy && existsSync(websiteCopy))
+            unlinkSync(websiteCopy);
+        log('Nothing exported: the help chat is off for this app. Turn it on with newly support enable first.');
+        return;
+    }
+    const { articles } = (await client.get(`${base(projectId)}/articles`));
+    const sorted = [...articles].sort((a, b) => a.title.localeCompare(b.title) || a.id.localeCompare(b.id));
+    const owned = new Set(exportedFiles(dir));
+    const taken = new Set();
+    const free = (file) => !taken.has(file) && (owned.has(file) || !existsSync(join(dir, file)));
+    const entries = sorted.map((a) => {
+        const slug = slugOf(a.title);
+        let file = `${slug}.md`;
+        for (let n = 2; !free(file); n++)
+            file = `${slug}-${n}.md`;
+        taken.add(file);
+        return {
+            id: a.id, file, title: a.title, body: a.body, source: a.source ?? 'manual',
+            source_name: a.source_name ?? null, source_url: a.source_url ?? null, updated_at: a.updated_at,
+        };
+    });
+    mkdirSync(dir, { recursive: true });
+    for (const stale of owned) {
+        if (!taken.has(stale) && existsSync(join(dir, stale)))
+            unlinkSync(join(dir, stale));
+    }
+    for (const e of entries) {
+        const header = [`id: ${e.id}`, `title: ${JSON.stringify(e.title)}`, `source: ${e.source}`];
+        if (e.source_name)
+            header.push(`source_name: ${JSON.stringify(e.source_name)}`);
+        if (e.source_url)
+            header.push(`source_url: ${JSON.stringify(e.source_url)}`);
+        header.push(`updated_at: ${e.updated_at}`);
+        writeFileSync(join(dir, e.file), `---\n${header.join('\n')}\n---\n\n${e.body.trimEnd()}\n`);
+    }
+    const note = 'Exported from Newly customer support. Edit articles in Newly; newly support articles export overwrites this folder.';
+    const index = `${JSON.stringify({ note, articles: entries }, null, 2)}\n`;
+    writeFileSync(join(dir, INDEX), index);
+    if (websiteDir && websiteCopy && existsSync(websiteDir))
+        writeFileSync(websiteCopy, index);
+    log(`Exported ${entries.length} ${entries.length === 1 ? 'article' : 'articles'} to ${dir}`);
+}
 const bodyOf = (opts) => {
     if (opts.file)
         return readFileSync(opts.file, 'utf8');
@@ -266,6 +325,12 @@ export function registerSupport(program) {
         const c = ctx(o.project);
         await runArticleImportUrl(c.client, c.projectId, url, Boolean(o.refresh), log);
     }));
+    articles.command('export').description('Write the articles into the repo (markdown plus articles.json) for the website FAQ')
+        .option('--dir <dir>', 'output folder', SUPPORT_ARTICLES_DIR).option('--project <id>')
+        .action((o) => run(async () => {
+        const c = ctx(o.project);
+        await runArticlesExport(c.client, c.projectId, resolve(o.dir), log, resolve('website'));
+    }));
     articles.command('remove <id>').option('--project <id>').action((id, o) => run(async () => {
         const c = ctx(o.project);
         await runArticleRemove(c.client, c.projectId, id, log);

package/dist/version.js

@@ -1 +1 @@
-export const CLI_VERSION = '0.2.201';
+export const CLI_VERSION = '0.2.203';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@newly/cli",
-  "version": "0.2.201",
+  "version": "0.2.203",
   "description": "Develop, provision, and deploy Newly backends from your terminal",
   "homepage": "https://newly.app",
   "repository": {