@xano/cli 1.0.4-beta.3 → 1.0.4

package/README.md

@@ -47,13 +47,6 @@ xano auth
 xano auth --origin https://custom.xano.com
 xano auth --insecure                         # Skip TLS verification (self-signed certs)
 xano auth --no-browser                       # Headless login (no local callback server)
-
-# Pre-select instance/workspace/branch and profile name (skips the pickers)
-xano auth -i my-instance -w 5 -b dev -p staging
-xano auth --instance my-instance --workspace "My Workspace" --branch dev --profile staging
-
-# Pass "" to take a picker's default: skip workspace, use live branch, default profile name
-xano auth -i my-instance -w 5 -b "" -p ""
 ```
 
 The default flow starts a temporary callback server on `127.0.0.1` and waits
@@ -62,20 +55,12 @@ containers, or locked-down networks where the browser can't reach the CLI's
 loopback address, use `--no-browser`: the CLI prints a login URL, you open it
 in any browser, and paste back the code it displays. No local server required.
 
-Each picker can be pre-answered with a flag: `-i/--instance` (instance name, or numeric instance ID),
-`-w/--workspace` (workspace ID or name), `-b/--branch` (branch label), and
-`-p/--profile` (profile name to save). An empty value (`""`) takes the
-picker's default answer: `-w ""` skips workspace selection, `-b ""` skips and
-uses the live branch, and `-p ""` uses the default profile name. With all four
-set alongside `--no-browser`, the only input is pasting the code from the
-browser — useful for scripted or remote setups.
-
 When stdin is piped (not a TTY), `--no-browser` reads the code directly from
 stdin instead of prompting, so scripts and AI agents can complete the flow
 without an interactive terminal:
 
 ```bash
-echo "$CODE" | xano auth --no-browser -i my-instance -w 5 -b dev -p staging
+echo "$CODE" | xano auth --no-browser
 ```
 
 If you can't run `xano auth` at all, you can always create a profile manually
@@ -556,46 +541,14 @@ xano sandbox reset --force
 # List static hosts
 xano static_host list
 
-# Create / get / edit a static host
-xano static_host create marketing --description "Marketing site"
-xano static_host get marketing
-xano static_host edit marketing --name marketing-v2 --description "Updated"
+# Create a build
+xano static_host build create default -f ./build.zip -n "v1.0.0"
 
 # List builds
 xano static_host build list default
 
 # Get build details
-xano static_host build get default --build_id 52
-
-# Pull a build to disk. Defaults to the original uploaded source
-# (including package.json). Use --source built for the compiled/served output.
-xano static_host build pull default --build_id 52    # By build ID (original source)
-xano static_host build pull default --build_id 52 --source built   # Compiled output
-xano static_host build pull default --latest         # Latest build
-xano static_host build pull default --env dev        # Build currently deployed to dev
-xano static_host build pull default --env prod -d ./prod-release
-
-# Push a build (name optional — auto-generated from the timestamp if omitted).
-# Accepts a directory (-d) or a zip file (-f). Defaults to the current directory.
-# For package.json builds, the CLI waits for the build to finish (--no-wait to skip).
-xano static_host build push default -d ./dist -n "v1.0.0"
-xano static_host build push default                          # current dir, auto-name
-xano static_host build push default -f ./build.zip -n "v1.0.0"  # from zip file
-xano static_host build push default -n "release" --description "Production build"
-
-# Delete a build (prompts for confirmation; --force to skip)
-xano static_host build delete default --build_id 52
-xano static_host build delete default --build_id 52 --force
-
-# Deploy a build to an environment
-xano static_host deploy default --build_id 52 --env dev
-xano static_host deploy default --build_id 52 --env prod
-
-# Migrate a host to instance-managed (v2) hosting
-xano static_host migrate newsite                 # one host (both envs)
-xano static_host migrate newsite --env dev        # one env
-xano static_host migrate --all                    # every v1 host in the workspace
-xano static_host migrate --all --dry-run          # preview without changing anything
+xano static_host build get default 52
 ```
 
 ## Global Options

package/dist/base-command.d.ts

@@ -103,31 +103,4 @@ export default abstract class BaseCommand extends Command {
      * Use this for all Metadata API calls to support the --verbose flag.
      */
     protected verboseFetch(url: string, options: RequestInit, verbose: boolean, authToken?: string): Promise<Response>;
-    /**
-     * Poll a static-host build until it reaches a terminal status (ok | error),
-     * showing a live, ticking spinner with the current stage and elapsed time —
-     * mirroring the UI's build progress for async (package.json) builds, which
-     * keep running after the upload returns.
-     *
-     * On a TTY it renders an animated spinner via ux.action; when quiet (JSON
-     * output) or non-interactive it falls back to plain one-line status updates.
-     *
-     * Returns the final status. Resolves to the last-seen status on timeout.
-     */
-    protected logStaticHostUrls(opts: {
-        profile: ProfileConfig;
-        staticHost: string;
-        verbose: boolean;
-        workspaceId: string;
-    }): Promise<void>;
-    protected waitForBuild(opts: {
-        buildId: number | string;
-        intervalMs?: number;
-        profile: ProfileConfig;
-        quiet?: boolean;
-        staticHost: string;
-        timeoutMs?: number;
-        verbose: boolean;
-        workspaceId: string;
-    }): Promise<string>;
 }

package/dist/base-command.js

@@ -1,4 +1,4 @@
-import { Command, Flags, ux } from '@oclif/core';
+import { Command, Flags } from '@oclif/core';
 import * as yaml from 'js-yaml';
 import * as fs from 'node:fs';
 import * as os from 'node:os';
@@ -358,127 +358,4 @@ export default class BaseCommand extends Command {
         }
         return response;
     }
-    /**
-     * Poll a static-host build until it reaches a terminal status (ok | error),
-     * showing a live, ticking spinner with the current stage and elapsed time —
-     * mirroring the UI's build progress for async (package.json) builds, which
-     * keep running after the upload returns.
-     *
-     * On a TTY it renders an animated spinner via ux.action; when quiet (JSON
-     * output) or non-interactive it falls back to plain one-line status updates.
-     *
-     * Returns the final status. Resolves to the last-seen status on timeout.
-     */
-    async logStaticHostUrls(opts) {
-        const { profile, staticHost, verbose, workspaceId } = opts;
-        const url = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/static_host/${staticHost}`;
-        try {
-            const response = await this.verboseFetch(url, {
-                headers: { accept: 'application/json', Authorization: `Bearer ${profile.access_token}` },
-                method: 'GET',
-            }, verbose, profile.access_token);
-            if (!response.ok)
-                return;
-            const host = (await response.json());
-            if (host.dev?.default_url)
-                this.log(`Dev URL: ${host.dev.default_url}`);
-            if (host.dev?.custom_url)
-                this.log(`Dev Custom URL: ${host.dev.custom_url}`);
-            if (host.prod?.default_url)
-                this.log(`Prod URL: ${host.prod.default_url}`);
-            if (host.prod?.custom_url)
-                this.log(`Prod Custom URL: ${host.prod.custom_url}`);
-        }
-        catch {
-            // Non-fatal — the build succeeded, we just can't show the URL.
-        }
-    }
-    async waitForBuild(opts) {
-        const { buildId, profile, quiet, staticHost, verbose, workspaceId } = opts;
-        const intervalMs = opts.intervalMs ?? 2000;
-        const timeoutMs = opts.timeoutMs ?? 600_000; // 10 min
-        const terminal = new Set(['error', 'ok']);
-        const url = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/static_host/${staticHost}/build/${buildId}`;
-        // Spinner only on an interactive TTY and when not emitting JSON. Verbose mode
-        // also disables it (the spinner would interleave with request/response logs).
-        const animate = Boolean(process.stdout.isTTY) && !quiet && !verbose;
-        const start = Date.now();
-        const elapsed = () => Math.round((Date.now() - start) / 1000);
-        let stage = 'pending';
-        let ticker;
-        // Reflect the current stage: live spinner status on a TTY, else a plain line.
-        const render = () => {
-            if (animate) {
-                ux.action.status = `${stageLabel(stage)} (${elapsed()}s)`;
-            }
-            else if (!quiet && !terminal.has(stage)) {
-                this.log(`Build status: ${stage}`);
-            }
-        };
-        // Stop the spinner/ticker and emit a final line.
-        const conclude = (message) => {
-            if (ticker)
-                clearInterval(ticker);
-            if (animate) {
-                ux.action.stop(message);
-            }
-            else if (!quiet) {
-                this.log(message);
-            }
-        };
-        if (animate) {
-            ux.action.start('Building', stageLabel(stage));
-            // Re-render every 120ms so the elapsed counter ticks even between polls.
-            ticker = setInterval(render, 120);
-        }
-        else if (!quiet) {
-            this.log(`Build status: ${stage}`);
-        }
-        /* eslint-disable no-await-in-loop */
-        while (Date.now() - start < timeoutMs) {
-            const response = await this.verboseFetch(url, {
-                headers: { accept: 'application/json', Authorization: `Bearer ${profile.access_token}` },
-                method: 'GET',
-            }, verbose, profile.access_token);
-            if (response.ok) {
-                const build = (await response.json());
-                const status = build.status ?? 'pending';
-                if (status !== stage) {
-                    stage = status;
-                    render();
-                }
-                if (terminal.has(status)) {
-                    const took = `${elapsed()}s`;
-                    conclude(status === 'ok' ? `done in ${took}` : `failed after ${took}`);
-                    return status;
-                }
-            }
-            await new Promise((resolve) => {
-                setTimeout(resolve, intervalMs);
-            });
-        }
-        /* eslint-enable no-await-in-loop */
-        conclude(`stopped waiting after ${Math.round(timeoutMs / 1000)}s (last status: ${stage || 'unknown'})`);
-        return stage;
-    }
-}
-/** Human-friendly label for a build status stage. */
-function stageLabel(status) {
-    switch (status) {
-        case 'building': {
-            return 'Installing & building (npm)';
-        }
-        case 'ok': {
-            return 'Finishing';
-        }
-        case 'pending': {
-            return 'Queued';
-        }
-        case 'publishing': {
-            return 'Publishing files';
-        }
-        default: {
-            return status;
-        }
-    }
 }

package/dist/commands/auth/index.d.ts

@@ -1,53 +1,14 @@
 import { Command } from '@oclif/core';
-export interface Instance {
-    display: string;
-    id: string;
-    name: string;
-    origin: string;
-}
-export interface AuthResult {
-    branch: null | string;
-    credentialsPath: string;
-    instance: {
-        id: string;
-        name: string;
-        origin: string;
-    };
-    profile: string;
-    user: {
-        email: string;
-        id: string;
-        name: string;
-    };
-    workspace: null | {
-        id: string;
-        name: string;
-    };
-}
-/**
- * Match a user-supplied --instance value against the instance list:
- * numeric values match by ID, URL/hostname values match by the instance
- * origin's hostname, anything else matches by name. Exported for tests.
- */
-export declare function matchInstance(instances: Instance[], query: string): Instance | undefined;
 export default class Auth extends Command {
     static description: string;
-    static enableJsonFlag: boolean;
     static examples: string[];
     static flags: {
-        branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        code: 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>;
         insecure: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        instance: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'no-browser': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         origin: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
     };
-    run(): Promise<AuthResult>;
-    protected toErrorJson(err: unknown): unknown;
-    private acquireToken;
+    run(): Promise<void>;
     private getHeaders;
     private fetchBranches;
     private fetchInstances;
@@ -55,11 +16,6 @@ export default class Auth extends Command {
     private promptForToken;
     private promptProfileName;
     private readTokenFromStdin;
-    private resolveBranch;
-    private resolveInstance;
-    private resolveProfileName;
-    private resolveWorkspace;
-    private resolveWorkspaceAndBranch;
     private saveProfile;
     private selectBranch;
     private selectInstance;

package/dist/commands/auth/index.js

@@ -6,37 +6,9 @@ import * as http from 'node:http';
 import { dirname } from 'node:path';
 import open from 'open';
 import { buildUserAgent, resolveCredentialsPath } from '../../base-command.js';
-function originHostname(value) {
-    try {
-        return new URL(value.includes('://') ? value : `https://${value}`).hostname.toLowerCase();
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Match a user-supplied --instance value against the instance list:
- * numeric values match by ID, URL/hostname values match by the instance
- * origin's hostname, anything else matches by name. Exported for tests.
- */
-export function matchInstance(instances, query) {
-    const q = query.trim();
-    if (/^\d+$/.test(q)) {
-        return instances.find((inst) => inst.id === q);
-    }
-    if (q.includes('://') || q.includes('.')) {
-        const queryHost = originHostname(q);
-        const match = queryHost ? instances.find((inst) => originHostname(inst.origin) === queryHost) : undefined;
-        if (match) {
-            return match;
-        }
-    }
-    return instances.find((inst) => inst.name === q);
-}
 const AUTH_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes
 export default class Auth extends Command {
     static description = 'Authenticate with Xano via browser login';
-    static enableJsonFlag = true;
     static examples = [
         `$ xano auth
 Opening browser for Xano login...
@@ -51,24 +23,10 @@ Opening browser for Xano login at https://custom.xano.com...`,
 To authenticate, open the following URL in any browser:
   https://app.xano.com/login?dest=cli&display=code
 ? Paste the code shown in your browser: ****`,
-        `$ xano auth --code "$CODE" --instance https://my-instance.xano.io --workspace 5
-(fully non-interactive: no browser, no prompts; missing --branch/--profile fall back to defaults)`,
-        `$ echo "$CODE" | xano auth --no-browser --instance my-instance --workspace 5 --branch dev --profile staging
-(fully scripted: the code is read from piped stdin, no prompt at all)`,
-        `$ xano auth --code "$CODE" --instance 42 --workspace 5 --json
-(machine-readable: prints the created profile as JSON)`,
+        `$ echo "$CODE" | xano auth --no-browser
+(the code is read from piped stdin, no prompt at all)`,
     ];
     static flags = {
-        branch: Flags.string({
-            char: 'b',
-            description: 'Pre-select a branch by label (skips the branch picker); pass "" to skip and use the live branch',
-            required: false,
-        }),
-        code: Flags.string({
-            description: 'Login code copied from the browser (implies --no-browser and runs fully non-interactively). Get the code at <origin>/login?dest=cli&display=code',
-            env: 'XANO_AUTH_CODE',
-            required: false,
-        }),
         config: Flags.string({
             char: 'c',
             description: 'Path to credentials file (default: ~/.xano/credentials.yaml)',
@@ -80,11 +38,6 @@ To authenticate, open the following URL in any browser:
             default: false,
             description: 'Skip TLS certificate verification (for self-signed certificates)',
         }),
-        instance: Flags.string({
-            char: 'i',
-            description: 'Pre-select an instance by name, numeric ID, or instance URL/hostname (skips the instance picker)',
-            required: false,
-        }),
         'no-browser': Flags.boolean({
             default: false,
             description: 'Headless login: print a URL and paste back the code shown in the browser, instead of starting a local callback server (use on remote/SSH/Docker hosts where 127.0.0.1 is not reachable from the browser)',
@@ -94,16 +47,6 @@ To authenticate, open the following URL in any browser:
             default: 'https://app.xano.com',
             description: 'Xano account origin URL',
         }),
-        profile: Flags.string({
-            char: 'p',
-            description: 'Profile name to save (skips the profile name prompt); pass "" to use the default name',
-            required: false,
-        }),
-        workspace: Flags.string({
-            char: 'w',
-            description: 'Pre-select a workspace by ID or name (skips the workspace picker); pass "" to skip workspace',
-            required: false,
-        }),
     };
     async run() {
         const { flags } = await this.parse(Auth);
@@ -111,13 +54,12 @@ To authenticate, open the following URL in any browser:
             process.env.NODE_TLS_REJECT_UNAUTHORIZED = '0';
             this.warn('TLS certificate verification is disabled (insecure mode)');
         }
-        // A supplied code (flag or env), piped stdin, or --json output means no
-        // prompt can ever open: every unanswered picker falls back to its default.
-        const nonInteractive = flags.code !== undefined || (flags['no-browser'] && !process.stdin.isTTY) || this.jsonEnabled();
         try {
-            // Step 1: Get token via supplied code or browser auth
+            // Step 1: Get token via browser auth
             this.log('Starting authentication flow...');
-            const token = await this.acquireToken(flags.code, flags['no-browser'], flags.origin);
+            const token = flags['no-browser']
+                ? await this.promptForToken(flags.origin)
+                : await this.startAuthServer(flags.origin);
             // Step 2: Validate token and get user info
             this.log('');
             this.log('Validating authentication...');
@@ -129,9 +71,6 @@ To authenticate, open the following URL in any browser:
             const isSelfHosted = !/^https:\/\/app\.(.*\.)?xano\.com$/.test(flags.origin);
             let instance;
             if (isSelfHosted) {
-                if (flags.instance) {
-                    this.warn('Ignoring --instance: the origin itself is the instance for self-hosted Xano.');
-                }
                 instance = {
                     display: flags.origin,
                     id: 'self-hosted',
@@ -146,15 +85,31 @@ To authenticate, open the following URL in any browser:
                 if (instances.length === 0) {
                     this.error('No instances found. Please check your account.');
                 }
-                instance = await this.resolveInstance(instances, flags.instance, nonInteractive);
+                instance = await this.selectInstance(instances);
+            }
+            // Step 4: Workspace selection
+            let workspace;
+            let branch;
+            this.log('');
+            this.log('Fetching available workspaces...');
+            const workspaces = await this.fetchWorkspaces(token, instance.origin);
+            if (workspaces.length > 0) {
+                workspace = await this.selectWorkspace(workspaces);
+                if (workspace) {
+                    // Step 5: Branch selection
+                    this.log('');
+                    this.log('Fetching available branches...');
+                    const branches = await this.fetchBranches(token, instance.origin, workspace.id);
+                    if (branches.length > 1) {
+                        branch = await this.selectBranch(branches);
+                    }
+                }
             }
-            // Steps 4 + 5: Workspace and branch selection
-            const { branch, workspace } = await this.resolveWorkspaceAndBranch(token, instance.origin, flags, nonInteractive);
             // Step 6: Profile name
             this.log('');
-            const profileName = await this.resolveProfileName(flags.profile, nonInteractive);
+            const profileName = await this.promptProfileName();
             // Step 7: Save profile
-            const credentialsPath = await this.saveProfile({
+            await this.saveProfile({
                 access_token: token,
                 account_origin: flags.origin,
                 branch,
@@ -165,17 +120,6 @@ To authenticate, open the following URL in any browser:
             }, flags.config);
             this.log('');
             this.log(`Profile '${profileName}' created successfully!`);
-            const result = {
-                branch: branch ?? null,
-                credentialsPath,
-                instance: { id: instance.id, name: instance.name, origin: instance.origin },
-                profile: profileName,
-                user: { email: user.email, id: user.id, name: user.name },
-                workspace: workspace ? { id: workspace.id, name: workspace.name } : null,
-            };
-            if (this.jsonEnabled()) {
-                this.logJson(result);
-            }
             // Ensure clean exit (the open() call can keep the event loop alive)
             process.exit(0);
         }
@@ -185,33 +129,11 @@ To authenticate, open the following URL in any browser:
             // @inquirer/core, so the thrown class won't match an imported one.
             if (error?.name === 'ExitPromptError') {
                 this.log('Authentication cancelled.');
-                this.exit(0);
+                return;
             }
             throw error;
         }
     }
-    // oclif's default toErrorJson serializes Error objects to {} (message is a
-    // non-enumerable property), leaving --json consumers with no error detail.
-    toErrorJson(err) {
-        const error = err;
-        return {
-            error: {
-                ...(error.code ? { code: error.code } : {}),
-                message: error.message ?? String(err),
-                ...(error.suggestions?.length ? { suggestions: error.suggestions } : {}),
-            },
-        };
-    }
-    async acquireToken(code, noBrowser, origin) {
-        if (code !== undefined) {
-            const token = code.trim();
-            if (token === '') {
-                this.error(`No code provided. Copy it from ${origin}/login?dest=cli&display=code and pass it via --code or XANO_AUTH_CODE.`);
-            }
-            return token;
-        }
-        return noBrowser ? this.promptForToken(origin) : this.startAuthServer(origin);
-    }
     getHeaders(accessToken) {
         return {
             'User-Agent': buildUserAgent(this.config.version),
@@ -259,7 +181,7 @@ To authenticate, open the following URL in any browser:
         if (Array.isArray(data)) {
             return data.map((inst) => ({
                 display: inst.display,
-                id: String(inst.id ?? inst.name),
+                id: inst.id || inst.name,
                 name: inst.name,
                 origin: new URL(inst.meta_api).origin,
             }));
@@ -356,95 +278,6 @@ To authenticate, open the following URL in any browser:
             process.stdin.on('error', () => resolve(data.trim()));
         });
     }
-    async resolveBranch(branches, flagValue, nonInteractive) {
-        if (flagValue !== undefined) {
-            // An empty value means "skip and use live branch" (same as the picker's skip option)
-            if (flagValue.trim() === '') {
-                this.log('Using live branch');
-                return undefined;
-            }
-            const match = branches.find((br) => br.label === flagValue || br.id === flagValue);
-            if (!match) {
-                this.error(`Branch '${flagValue}' not found. Available branches: ${branches.map((br) => br.label).join(', ')}`);
-            }
-            this.log(`Using branch: ${match.label}`);
-            return match.id;
-        }
-        if (nonInteractive) {
-            this.log('Using live branch (non-interactive; pass --branch to select one)');
-            return undefined;
-        }
-        return branches.length > 1 ? this.selectBranch(branches) : undefined;
-    }
-    async resolveInstance(instances, flagValue, nonInteractive) {
-        if (flagValue) {
-            const match = matchInstance(instances, flagValue);
-            if (!match) {
-                this.error(`Instance '${flagValue}' not found (match by name, numeric ID, or instance URL). Available instances: ${instances.map((inst) => `${inst.name} (${inst.id})`).join(', ')}`);
-            }
-            this.log(`Using instance: ${match.name} (${match.display})`);
-            return match;
-        }
-        if (nonInteractive) {
-            if (instances.length === 1) {
-                this.log(`Using instance: ${instances[0].name} (${instances[0].display})`);
-                return instances[0];
-            }
-            this.error(`Multiple instances available; pass --instance to select one. Available instances: ${instances.map((inst) => `${inst.name} (${inst.id})`).join(', ')}`);
-        }
-        return this.selectInstance(instances);
-    }
-    async resolveProfileName(flagValue, nonInteractive) {
-        // An empty --profile value means "use the default name" (same as accepting the prompt's default);
-        // non-interactive runs with no --profile fall back to the default name too.
-        if (flagValue !== undefined) {
-            return flagValue.trim() || 'default';
-        }
-        return nonInteractive ? 'default' : this.promptProfileName();
-    }
-    async resolveWorkspace(workspaces, flagValue, nonInteractive) {
-        if (flagValue !== undefined) {
-            // An empty value means "skip workspace" (same as the picker's skip option)
-            if (flagValue.trim() === '') {
-                this.log('Skipping workspace selection');
-                return undefined;
-            }
-            const match = workspaces.find((ws) => String(ws.id) === flagValue || ws.name === flagValue);
-            if (!match) {
-                this.error(`Workspace '${flagValue}' not found. Available workspaces: ${workspaces.map((ws) => `${ws.name} (${ws.id})`).join(', ')}`);
-            }
-            this.log(`Using workspace: ${match.name} (${match.id})`);
-            return match;
-        }
-        if (nonInteractive) {
-            this.log('Skipping workspace selection (non-interactive; pass --workspace to select one)');
-            return undefined;
-        }
-        return this.selectWorkspace(workspaces);
-    }
-    async resolveWorkspaceAndBranch(token, instanceOrigin, flags, nonInteractive) {
-        let workspace;
-        let branch;
-        this.log('');
-        this.log('Fetching available workspaces...');
-        const workspaces = await this.fetchWorkspaces(token, instanceOrigin);
-        if (workspaces.length > 0) {
-            workspace = await this.resolveWorkspace(workspaces, flags.workspace, nonInteractive);
-            if (workspace) {
-                this.log('');
-                this.log('Fetching available branches...');
-                const branches = await this.fetchBranches(token, instanceOrigin, workspace.id);
-                branch = await this.resolveBranch(branches, flags.branch, nonInteractive);
-            }
-        }
-        else if (flags.workspace) {
-            this.error(`Workspace '${flags.workspace}' not found: no workspaces are available on this instance.`);
-        }
-        if (flags.branch && !workspace) {
-            this.warn('Ignoring --branch: no workspace selected.');
-        }
-        return { branch, workspace };
-    }
     async saveProfile(profile, configPath) {
         const credentialsPath = resolveCredentialsPath(configPath);
         const credDir = dirname(credentialsPath);
@@ -484,7 +317,6 @@ To authenticate, open the following URL in any browser:
             noRefs: true,
         });
         fs.writeFileSync(credentialsPath, yamlContent, 'utf8');
-        return credentialsPath;
     }
     async selectBranch(branches) {
         const { selectedBranch } = await inquirer.prompt([

package/dist/commands/{tenant/snapshot/list → knowledge/pull}/index.d.ts

@@ -1,12 +1,10 @@
-import BaseCommand from '../../../../base-command.js';
-export default class TenantSnapshotList extends BaseCommand {
-    static args: {
-        tenant_name: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
+import BaseCommand from '../../../base-command.js';
+export default class KnowledgePull extends BaseCommand {
     static description: string;
     static examples: string[];
     static flags: {
-        output: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        directory: 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>;