@xano/cli 1.2.0 → 1.3.1-beta.0

package/dist/commands/sandbox/license/set/index.js

@@ -1,6 +1,6 @@
 import { Flags } from '@oclif/core';
 import * as fs from 'node:fs';
-import * as path from 'node:path';
+import path from 'node:path';
 import BaseCommand from '../../../../base-command.js';
 export default class SandboxLicenseSet extends BaseCommand {
     static description = 'Set/update the license for a sandbox environment';

package/dist/commands/sandbox/pull/index.d.ts

@@ -12,5 +12,4 @@ export default class SandboxPull extends BaseCommand {
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
-    private sanitizeFilename;
 }

package/dist/commands/sandbox/pull/index.js

@@ -1,10 +1,10 @@
 import { Flags } from '@oclif/core';
 import snakeCase from 'lodash.snakecase';
+import * as fs from 'node:fs';
+import path from 'node:path';
 import BaseCommand from '../../../base-command.js';
-import { buildApiGroupFolderResolver, parseDocument } from '../../../utils/document-parser.js';
+import { buildApiGroupFolderResolver, buildChannelServerResolver, parseDocument, resolveDocumentPath, } from '../../../utils/document-parser.js';
 import { fetchKnowledge, writeKnowledge } from '../../../utils/knowledge-sync.js';
-import * as fs from 'node:fs';
-import * as path from 'node:path';
 export default class SandboxPull extends BaseCommand {
     static description = 'Pull documents from your sandbox environment and split into individual files';
     static examples = [
@@ -92,82 +92,18 @@ Pulled 42 documents from sandbox environment to ./my-sandbox
         const outputDir = path.resolve(flags.directory);
         fs.mkdirSync(outputDir, { recursive: true });
         const getApiGroupFolder = buildApiGroupFolderResolver(documents, snakeCase);
+        // Resolve a realtime v2 channel path -> owning realtime_server name, so
+        // messages can nest under their channel's server (see resolver docs).
+        const getChannelServer = buildChannelServerResolver(documents);
         const filenameCounters = new Map();
         let writtenCount = 0;
         for (const doc of documents) {
-            let typeDir;
-            let baseName;
-            if (doc.type === 'workspace') {
-                typeDir = path.join(outputDir, 'workspace');
-                baseName = this.sanitizeFilename(doc.name);
-            }
-            else if (doc.type === 'workspace_trigger') {
-                typeDir = path.join(outputDir, 'workspace', 'trigger');
-                baseName = this.sanitizeFilename(doc.name);
-            }
-            else if (doc.type === 'error_trigger') {
-                // error_trigger → workspace/trigger/{name}.xs (singleton, colocated with workspace triggers)
-                typeDir = path.join(outputDir, 'workspace', 'trigger');
-                baseName = this.sanitizeFilename(doc.name);
-            }
-            else if (doc.type === 'agent') {
-                typeDir = path.join(outputDir, 'ai', 'agent');
-                baseName = this.sanitizeFilename(doc.name);
-            }
-            else if (doc.type === 'mcp_server') {
-                typeDir = path.join(outputDir, 'ai', 'mcp_server');
-                baseName = this.sanitizeFilename(doc.name);
-            }
-            else if (doc.type === 'tool') {
-                typeDir = path.join(outputDir, 'ai', 'tool');
-                baseName = this.sanitizeFilename(doc.name);
-            }
-            else if (doc.type === 'agent_trigger') {
-                typeDir = path.join(outputDir, 'ai', 'agent', 'trigger');
-                baseName = this.sanitizeFilename(doc.name);
-            }
-            else if (doc.type === 'mcp_server_trigger') {
-                typeDir = path.join(outputDir, 'ai', 'mcp_server', 'trigger');
-                baseName = this.sanitizeFilename(doc.name);
-            }
-            else if (doc.type === 'table_trigger') {
-                typeDir = path.join(outputDir, 'table', 'trigger');
-                baseName = this.sanitizeFilename(doc.name);
-            }
-            else if (doc.type === 'realtime_channel') {
-                typeDir = path.join(outputDir, 'realtime', 'channel');
-                baseName = this.sanitizeFilename(doc.name);
-            }
-            else if (doc.type === 'realtime_trigger') {
-                typeDir = path.join(outputDir, 'realtime', 'trigger');
-                baseName = this.sanitizeFilename(doc.name);
-            }
-            else if (doc.type === 'api_group') {
-                const groupFolder = getApiGroupFolder(doc.name);
-                typeDir = path.join(outputDir, 'api', groupFolder);
-                baseName = this.sanitizeFilename(doc.name);
-            }
-            else if (doc.type === 'query' && doc.apiGroup) {
-                const groupFolder = getApiGroupFolder(doc.apiGroup);
-                const nameParts = doc.name.split('/');
-                const leafName = nameParts.pop();
-                const folderParts = nameParts.map((part) => snakeCase(part));
-                typeDir = path.join(outputDir, 'api', groupFolder, ...folderParts);
-                baseName = this.sanitizeFilename(leafName);
-                if (doc.verb) {
-                    baseName = `${baseName}_${doc.verb}`;
-                }
-            }
-            else {
-                const nameParts = doc.name.split('/');
-                const leafName = nameParts.pop();
-                const folderParts = nameParts.map((part) => snakeCase(part));
-                typeDir = path.join(outputDir, doc.type, ...folderParts);
-                baseName = this.sanitizeFilename(leafName);
-                if (doc.verb) {
-                    baseName = `${baseName}_${doc.verb}`;
-                }
-            }
+            const { baseName, typeDir } = resolveDocumentPath(doc, outputDir, {
+                getApiGroupFolder,
+                getChannelServer,
+                join: path.join,
+                snakeCase,
+            });
             fs.mkdirSync(typeDir, { recursive: true });
             const dirKey = path.relative(outputDir, typeDir);
             if (!filenameCounters.has(dirKey)) {
@@ -176,8 +112,7 @@ Pulled 42 documents from sandbox environment to ./my-sandbox
             const typeCounters = filenameCounters.get(dirKey);
             const count = typeCounters.get(baseName) || 0;
             typeCounters.set(baseName, count + 1);
-            let filename;
-            filename = count === 0 ? `${baseName}.xs` : `${baseName}_${count + 1}.xs`;
+            const filename = count === 0 ? `${baseName}.xs` : `${baseName}_${count + 1}.xs`;
             const filePath = path.join(typeDir, filename);
             fs.writeFileSync(filePath, doc.content, 'utf8');
             writtenCount++;
@@ -194,7 +129,4 @@ Pulled 42 documents from sandbox environment to ./my-sandbox
             parts.push(`${knowledgeCount} knowledge file${knowledgeCount === 1 ? '' : 's'}`);
         this.log(`Pulled ${parts.join(' + ')} from sandbox environment to ${flags.directory}`);
     }
-    sanitizeFilename(name) {
-        return snakeCase(name.replaceAll('"', ''));
-    }
 }

package/dist/commands/sandbox/push/index.d.ts

@@ -3,8 +3,8 @@ export default class SandboxPush extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
-        directory: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         delete: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        directory: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         env: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         force: import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/commands/sandbox/push/index.js

@@ -4,6 +4,7 @@ import { resolve } from 'node:path';
 import open from 'open';
 import BaseCommand from '../../../base-command.js';
 import { executePush } from '../../../utils/multidoc-push.js';
+import { policiesSkippedNotice } from '../../../utils/policy/feedback.js';
 export default class SandboxPush extends BaseCommand {
     static description = '[IMPORTANT] ALWAYS run --dry-run first and show the user the output before pushing. Push local documents to your sandbox environment via multidoc import. By default, only changed files are pushed (partial mode). Use --sync to push all files. Shows a preview of changes before pushing unless --force is specified. Use --dry-run to preview only. Include/exclude glob filters are intentionally not supported on sandbox push — partial pushes can hide deletions during review and lead to data loss when promoted to the workspace. Pushing into a sandbox that currently holds a different workspace will prompt for confirmation; run `xano sandbox reset` first to start clean.';
     static examples = [
@@ -33,17 +34,17 @@ Push and open sandbox review in the browser
     ];
     static flags = {
         ...BaseCommand.baseFlags,
+        delete: Flags.boolean({
+            default: false,
+            description: 'Delete sandbox objects not included in the push (requires --sync)',
+            required: false,
+        }),
         directory: Flags.string({
             char: 'd',
             default: '.',
             description: 'Directory containing documents to push (defaults to current directory)',
             required: false,
         }),
-        delete: Flags.boolean({
-            default: false,
-            description: 'Delete sandbox objects not included in the push (requires --sync)',
-            required: false,
-        }),
         'dry-run': Flags.boolean({
             default: false,
             description: 'Show preview of changes without pushing (exit after preview)',
@@ -126,7 +127,7 @@ Push and open sandbox review in the browser
             truncate: flags.truncate,
             verbose: flags.verbose,
         };
-        await executePush({
+        const result = await executePush({
             accessToken: profile.access_token,
             branch: '',
             command: this,
@@ -137,6 +138,10 @@ Push and open sandbox review in the browser
             },
             verboseFetch: this.verboseFetch.bind(this),
         }, target, pushFlags);
+        // When the platform leaves policy files out, it says so once.
+        const skipped = policiesSkippedNotice(result.response ?? result.preview);
+        if (skipped)
+            this.warn(skipped);
         if (flags.review) {
             await this.openReview(profile.instance_origin, profile.access_token, flags.verbose);
         }

package/dist/commands/skills/pull/index.d.ts

@@ -0,0 +1,30 @@
+import PolicyCommand from '../../../policy-command.js';
+/**
+ * The SKILL.md a coding agent reads: the CLI's own frontmatter (`name` and `description`), the
+ * instance's content below it. The CLI always writes the frontmatter itself and drops any block the
+ * served content opens with: frontmatter configures the agent (`allowed-tools`, `hooks`, `model`),
+ * and a workspace knowledge record may replace the platform skill, so its text must never set it.
+ * The description is written as a double-quoted YAML scalar, so a `:` or `#` in it stays a
+ * description instead of becoming syntax.
+ */
+export declare function buildSkillDocument(description: string, content: string): string;
+export default class SkillsPull extends PolicyCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        directory: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    /** Any failure exits 1 with its own message: this is not a `policy *` command to name. */
+    protected catch(error: Error & {
+        oclif?: {
+            exit?: number;
+        };
+    }): Promise<void>;
+    run(): Promise<void>;
+}

package/dist/commands/skills/pull/index.js

@@ -0,0 +1,118 @@
+import { Flags } from '@oclif/core';
+import * as fs from 'node:fs';
+import path from 'node:path';
+import PolicyCommand from '../../../policy-command.js';
+/** The one skill this command installs. The instance generates it from its check catalogue. */
+const SKILL = 'xano-policies';
+/**
+ * The served content without a leading YAML frontmatter block, if it opens with one: the lines up
+ * to and including the closing `---`, and the blank lines after it.
+ */
+function stripFrontmatter(content) {
+    if (!/^---\r?\n/.test(content))
+        return content;
+    const lines = content.split(/\r?\n/);
+    const close = lines.indexOf('---', 1);
+    if (close === -1)
+        return content;
+    let start = close + 1;
+    while (start < lines.length && lines[start].trim() === '')
+        start++;
+    return lines.slice(start).join('\n');
+}
+/**
+ * The SKILL.md a coding agent reads: the CLI's own frontmatter (`name` and `description`), the
+ * instance's content below it. The CLI always writes the frontmatter itself and drops any block the
+ * served content opens with: frontmatter configures the agent (`allowed-tools`, `hooks`, `model`),
+ * and a workspace knowledge record may replace the platform skill, so its text must never set it.
+ * The description is written as a double-quoted YAML scalar, so a `:` or `#` in it stays a
+ * description instead of becoming syntax.
+ */
+export function buildSkillDocument(description, content) {
+    // Exactly one trailing newline, whatever the instance sent, so a re-pull is byte-identical.
+    const body = `${stripFrontmatter(content).replace(/\n+$/, '')}\n`;
+    return `---\nname: ${SKILL}\ndescription: ${JSON.stringify(description)}\n---\n\n${body}`;
+}
+/** True when the path is a symbolic link; false when it is anything else or does not exist. */
+function isSymbolicLink(filePath) {
+    try {
+        return fs.lstatSync(filePath).isSymbolicLink();
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return false;
+        throw error;
+    }
+}
+/**
+ * Whether the served skill is the workspace's own knowledge record. A stored record has a positive
+ * id; the skill the platform generates has none of its own (the platform serves it under a
+ * negative sentinel id), so an item without a positive id is the platform's.
+ */
+function isWorkspaceRecord(skill) {
+    return typeof skill.id === 'number' && Number.isInteger(skill.id) && skill.id > 0;
+}
+export default class SkillsPull extends PolicyCommand {
+    static description = `Install the ${SKILL} agent skill this instance generates
+
+Writes <directory>/.claude/skills/${SKILL}/SKILL.md, the project skill folder Claude Code reads, and replaces that file without a backup. A copy installed anywhere else, such as a global ~/.claude/skills/${SKILL} or another agent's skills folder, is not touched: remove it, so the agent does not load it instead.`;
+    static examples = [
+        `$ xano skills pull
+Wrote .claude/skills/${SKILL}/SKILL.md (${SKILL} skill for workspace 40, branch live)
+`,
+        '$ xano skills pull -d ./my-project',
+        '$ xano skills pull -b dev -o json',
+    ];
+    static flags = {
+        ...PolicyCommand.policyFlags,
+        directory: Flags.string({
+            char: 'd',
+            default: '.',
+            description: `Project directory whose .claude/skills/${SKILL}/SKILL.md is written (defaults to current directory)`,
+            required: false,
+        }),
+    };
+    /** Any failure exits 1 with its own message: this is not a `policy *` command to name. */
+    async catch(error) {
+        return this.catchAsOperational(error);
+    }
+    async run() {
+        const { flags } = await this.parse(SkillsPull);
+        // The route lives beside /policy under the workspace and is gated by the same
+        // `workspace:policy` permission, so it answers failures the way the policy commands do.
+        const { branch, request, workspace } = this.policyTarget(flags, { label: 'Agent skills', path: '/agent-skills' });
+        // `surface=cli` asks for the terminal wording of the skill, not the Studio one.
+        const payload = (await request('', 'GET', undefined, { surface: 'cli' }));
+        const items = Array.isArray(payload?.knowledge) ? payload.knowledge : [];
+        const skill = items.find((item) => typeof item?.name === 'string' && item.name.trim().toLowerCase() === SKILL);
+        if (!skill) {
+            this.error(`The instance returned no ${SKILL} skill for workspace ${workspace}, branch ${branch || 'live'}.`);
+        }
+        const document = buildSkillDocument(skill.description ?? '', skill.content ?? '');
+        const filePath = path.join(path.resolve(flags.directory), '.claude', 'skills', SKILL, 'SKILL.md');
+        // Writing through a symbolic link would overwrite whatever it points at.
+        if (isSymbolicLink(filePath)) {
+            this.error(`${filePath} is a symbolic link; remove it and run the command again. Nothing was written.`);
+        }
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        // The file is regenerated on every pull and no backup is kept.
+        fs.writeFileSync(filePath, document, 'utf8');
+        const own = isWorkspaceRecord(skill);
+        if (flags.output === 'json') {
+            this.log(JSON.stringify({
+                branch,
+                bytes: Buffer.byteLength(document, 'utf8'),
+                name: SKILL,
+                path: filePath,
+                source: own ? 'workspace' : 'platform',
+                workspace,
+            }, null, 2));
+            return;
+        }
+        const relative = path.relative(process.cwd(), filePath);
+        const shown = relative && !relative.startsWith('..') ? relative : filePath;
+        this.log(`Wrote ${shown} (${SKILL} skill for workspace ${workspace}, branch ${branch || 'live'})`);
+        if (own)
+            this.log(`This is the workspace's own ${SKILL} knowledge record, which replaces the platform skill.`);
+    }
+}

package/dist/commands/static_host/build/create/index.d.ts

@@ -6,7 +6,6 @@ import BaseCommand from '../../../../base-command.js';
  */
 export declare function generateBuildName(date?: Date): string;
 export default class StaticHostBuildCreate extends BaseCommand {
-    static hidden: boolean;
     static args: {
         static_host: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
     };
@@ -23,5 +22,6 @@ export default class StaticHostBuildCreate extends BaseCommand {
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    static hidden: boolean;
     run(): Promise<void>;
 }

package/dist/commands/static_host/build/create/index.js

@@ -1,6 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
-import * as path from 'node:path';
+import path from 'node:path';
 import BaseCommand from '../../../../base-command.js';
 const pad2 = (n) => String(n).padStart(2, '0');
 /**
@@ -18,7 +18,6 @@ export function generateBuildName(date = new Date()) {
     return `${y}${mo}${d}-${h}${mi}${s}`;
 }
 export default class StaticHostBuildCreate extends BaseCommand {
-    static hidden = true;
     static args = {
         static_host: Args.string({
             description: 'Static Host name',
@@ -88,6 +87,7 @@ Description: Production build
             required: false,
         }),
     };
+    static hidden = true;
     async run() {
         this.warn('`static_host build create` is deprecated. Use `static_host build push -f <file>` instead.');
         const { args, flags } = await this.parse(StaticHostBuildCreate);

package/dist/commands/static_host/build/pull/index.js

@@ -1,6 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
-import * as path from 'node:path';
+import path from 'node:path';
 import BaseCommand from '../../../../base-command.js';
 import { normalizeListResponse } from '../../../../utils/paging.js';
 /**

package/dist/commands/static_host/build/push/index.js

@@ -1,7 +1,7 @@
 import { Args, Flags, ux } from '@oclif/core';
 import archiver from 'archiver';
 import * as fs from 'node:fs';
-import * as path from 'node:path';
+import path from 'node:path';
 import BaseCommand from '../../../../base-command.js';
 import { collectStaticHostFiles } from '../../../../utils/static-host-files.js';
 import { generateBuildName } from '../create/index.js';

package/dist/commands/static_host/edit/index.js

@@ -1,6 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
-import * as path from 'node:path';
+import path from 'node:path';
 import BaseCommand from '../../../base-command.js';
 export default class StaticHostEdit extends BaseCommand {
     static args = {

package/dist/commands/tenant/backup/export/index.js

@@ -1,6 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
-import * as path from 'node:path';
+import path from 'node:path';
 import BaseCommand, { buildUserAgent } from '../../../../base-command.js';
 export default class TenantBackupExport extends BaseCommand {
     static args = {
@@ -82,7 +82,6 @@ Downloaded backup #10 to ./tenant-t1234-abcd-xyz1-backup-10.tar.gz
             const fileStream = fs.createWriteStream(resolvedPath);
             const reader = downloadResponse.body.getReader();
             let totalBytes = 0;
-            // eslint-disable-next-line no-constant-condition
             while (true) {
                 // eslint-disable-next-line no-await-in-loop
                 const { done, value } = await reader.read();

package/dist/commands/tenant/backup/import/index.js

@@ -1,6 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
-import * as path from 'node:path';
+import path from 'node:path';
 import BaseCommand from '../../../../base-command.js';
 export default class TenantBackupImport extends BaseCommand {
     static args = {

package/dist/commands/tenant/cluster/create/index.js

@@ -1,6 +1,6 @@
 import { Flags } from '@oclif/core';
 import * as fs from 'node:fs';
-import * as path from 'node:path';
+import path from 'node:path';
 import BaseCommand from '../../../../base-command.js';
 export default class TenantClusterCreate extends BaseCommand {
     static description = 'Create a new tenant cluster';

package/dist/commands/tenant/cluster/license/get/index.js

@@ -1,6 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
-import * as path from 'node:path';
+import path from 'node:path';
 import BaseCommand from '../../../../../base-command.js';
 export default class TenantClusterLicenseGet extends BaseCommand {
     static args = {

package/dist/commands/tenant/cluster/license/set/index.js

@@ -1,6 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
-import * as path from 'node:path';
+import path from 'node:path';
 import BaseCommand from '../../../../../base-command.js';
 export default class TenantClusterLicenseSet extends BaseCommand {
     static args = {

package/dist/commands/tenant/create/index.d.ts

@@ -6,6 +6,8 @@ export default class TenantCreate extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        allow_deploy_bypass: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        allow_quick_deploy: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         cluster_id: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
         description: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         domain: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -13,8 +15,9 @@ export default class TenantCreate extends BaseCommand {
         license: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         platform_id: import("@oclif/core/interfaces").OptionFlag<number | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        type: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        required_reviewers: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
         tasks: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        type: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/commands/tenant/create/index.js

@@ -1,7 +1,7 @@
 import { Args, Flags } from '@oclif/core';
 import * as yaml from 'js-yaml';
 import * as fs from 'node:fs';
-import * as path from 'node:path';
+import path from 'node:path';
 import BaseCommand from '../../../base-command.js';
 export default class TenantCreate extends BaseCommand {
     static args = {
@@ -17,9 +17,20 @@ Created tenant: Production (production) - ID: 42
 `,
         `$ xano tenant create "Staging" --description "Staging env" --cluster_id 1 --platform_id 1 --type tier2 -o json`,
         `$ xano tenant create "Staging" --type tier2 --cluster_id 1 --license ./license.yaml`,
+        `$ xano tenant create "Production" --required_reviewers 1 --allow_deploy_bypass`,
     ];
     static flags = {
         ...BaseCommand.baseFlags,
+        allow_deploy_bypass: Flags.boolean({
+            default: false,
+            description: 'Allow authorized users to bypass the deploy approval gate on this tenant (via tenant_deploy_request bypass). Has no effect unless --required_reviewers is also set above 0.',
+            required: false,
+        }),
+        allow_quick_deploy: Flags.boolean({
+            default: false,
+            description: 'Allow this tenant to skip the deploy approval gate entirely for quick deploys, regardless of --required_reviewers.',
+            required: false,
+        }),
         cluster_id: Flags.integer({
             description: 'Cluster ID to deploy to (required for tier2/tier3)',
             required: false,
@@ -54,10 +65,9 @@ Created tenant: Production (production) - ID: 42
             description: 'Platform ID to use',
             required: false,
         }),
-        type: Flags.string({
-            default: 'tier1',
-            description: 'Tenant type',
-            options: ['tier1', 'tier2', 'tier3'],
+        required_reviewers: Flags.integer({
+            default: 0,
+            description: 'When greater than 0, that many distinct reviewers must approve a tenant_deploy_request before a release may be deployed to this tenant. 0 (default) means not gated.',
             required: false,
         }),
         tasks: Flags.boolean({
@@ -65,6 +75,12 @@ Created tenant: Production (production) - ID: 42
             default: true,
             description: 'Enable background tasks',
         }),
+        type: Flags.string({
+            default: 'tier1',
+            description: 'Tenant type',
+            options: ['tier1', 'tier2', 'tier3'],
+            required: false,
+        }),
         workspace: Flags.string({
             char: 'w',
             description: 'Workspace ID (uses profile workspace if not provided)',
@@ -79,6 +95,11 @@ Created tenant: Production (production) - ID: 42
             this.error('No workspace ID provided. Use --workspace flag or set one in your profile.');
         }
         const body = {
+            deploy_settings: {
+                allow_deploy_bypass: flags.allow_deploy_bypass,
+                allow_quick_deploy: flags.allow_quick_deploy,
+                required_reviewers: flags.required_reviewers,
+            },
             display: args.display,
             ingress: flags.ingress,
             license: flags.type,

package/dist/commands/tenant/deploy_platform/index.js

@@ -1,6 +1,6 @@
 import { Args, Flags } from '@oclif/core';
 import * as fs from 'node:fs';
-import * as path from 'node:path';
+import path from 'node:path';
 import BaseCommand from '../../../base-command.js';
 export default class TenantDeployPlatform extends BaseCommand {
     static args = {

package/dist/commands/tenant/deploy_release/index.d.ts

@@ -6,12 +6,52 @@ export default class TenantDeployRelease extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
+        check: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        'override-reason': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         release: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         config: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         verbose: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
+    /** Set once the policy gate refuses the deploy, the one failure that exits 2. */
+    private refusedByPolicyGate;
+    /** Exit 2 is the policy gate's refusal; every other failure, flag errors included, exits 1. */
+    protected catch(error: Error & {
+        oclif?: {
+            exit?: number;
+        };
+    }): Promise<void>;
     run(): Promise<void>;
+    /**
+     * `--check`: what the policy gate would decide for this release on this tenant, without deploying.
+     * Exits 2 when the deploy would be refused; a preview the platform cannot answer exits 1.
+     */
+    private checkPolicyGate;
+    /**
+     * Does an approved tenant_deploy_request already exist for this (tenant, release)
+     * pair? The list endpoint has no release filter, so this fetches approved
+     * requests for the tenant and filters client-side by the resolved release name.
+     */
+    private hasApprovedDeployRequest;
+    /** A deploy the policy gate refused: its verdict, then the refusal and how to proceed, exiting 2. */
+    private refuseByPolicyGate;
+    /**
+     * Does this tenant have the deploy approval gate enabled?
+     *
+     * Returns false if the tenant has `allow_quick_deploy` set — that flag lets a
+     * tenant skip the approval gate entirely for quick deploys, regardless of
+     * `required_reviewers`.
+     *
+     * Deliberately uses `tenant list` rather than `tenant get`: the single-tenant
+     * GET route's output whitelist (tenant-detail.yaml) omits `deploy_settings`
+     * (which holds `required_reviewers`, `allow_deploy_bypass`, and
+     * `allow_quick_deploy`) even though the list route's output includes it
+     * — confirmed live against a running instance. Filed as a backend bug; this
+     * is the workaround until it's fixed. See TENANT_DEPLOY_REQUEST_TEST.md.
+     */
+    private tenantRequiresApproval;
+    /** A release policy the tenant's import could not land (its key is held by another policy) is never dropped silently. */
+    private warnPoliciesSkipped;
 }