@xano/cli 0.0.16 → 0.0.18

package/README.md

@@ -25,7 +25,7 @@ npm install -g @xano/cli
 
 3. Execute XanoScript code:
    ```bash
-   xano run exec -f script.xs
+   xano run exec script.xs
    ```
 
 ## Commands
@@ -54,8 +54,6 @@ xano profile:set-default myprofile
 # Edit a profile
 xano profile:edit myprofile -w 123              # Set default workspace
 xano profile:edit myprofile -j my-project       # Set default project
-xano profile:edit myprofile --run-project <id>  # Set run project for xano run commands
-xano profile:edit myprofile --remove-run-project # Remove run project
 
 # Delete a profile
 xano profile:delete myprofile
@@ -100,18 +98,21 @@ Execute XanoScript code and manage projects, sessions, environment variables, an
 
 ```bash
 # Execute XanoScript (job or service)
-xano run exec -f script.xs
-xano run exec -f https://example.com/script.xs   # From URL
-xano run exec -f script.xs -a args.json          # With input arguments (file)
-xano run exec -f script.xs -a https://ex.com/args.json  # With input arguments (URL)
-xano run exec -f script.xs --edit                # Edit in $EDITOR first
-xano run exec -f script.xs --env API_KEY=secret  # With env overrides
+xano run exec script.xs                          # Single file
+xano run exec ./my-workspace                     # Directory (multidoc from .xs files)
+xano run exec https://example.com/script.xs     # From URL
+xano run exec script.xs -a args.json             # With input arguments (file)
+xano run exec script.xs -a https://ex.com/args.json  # With input arguments (URL)
+xano run exec script.xs --edit                   # Edit in $EDITOR first
+xano run exec script.xs --env API_KEY=secret     # With env overrides
 cat script.xs | xano run exec --stdin            # From stdin
 
 # Get document info (type, inputs, env vars)
 xano run info -f script.xs
 ```
 
+When a directory is provided, all `.xs` files are collected recursively and combined into a multidoc (joined with `---` separators), similar to `xano workspace push`.
+
 #### Projects
 
 ```bash
@@ -225,7 +226,7 @@ profiles:
     access_token: <token>
     workspace: <workspace_id>
     branch: <branch_id>
-    run_project: <run_project_id>  # Used by xano run commands
+    project: <project_id>
 default: default
 ```
 

package/dist/commands/profile/edit/index.d.ts

@@ -10,11 +10,9 @@ export default class ProfileEdit extends BaseCommand {
         workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         branch: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        'run-project': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'remove-workspace': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'remove-branch': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'remove-project': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'remove-run-project': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         run_base_url: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'remove-run-base-url': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         profile: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

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

@@ -40,11 +40,7 @@ export default class ProfileEdit extends BaseCommand {
         }),
         project: Flags.string({
             char: 'j',
-            description: 'Update project name',
-            required: false,
-        }),
-        'run-project': Flags.string({
-            description: 'Update run project ID (for xano run commands)',
+            description: 'Update project ID',
             required: false,
         }),
         'remove-workspace': Flags.boolean({
@@ -62,11 +58,6 @@ export default class ProfileEdit extends BaseCommand {
             required: false,
             default: false,
         }),
-        'remove-run-project': Flags.boolean({
-            description: 'Remove run project from profile',
-            required: false,
-            default: false,
-        }),
         run_base_url: Flags.string({
             char: 'r',
             description: 'Update Xano Run API base URL',
@@ -133,9 +124,9 @@ Profile 'default' updated successfully at ~/.xano/credentials.yaml
         const existingProfile = credentials.profiles[profileName];
         // Check if any flags were provided
         const hasFlags = flags.account_origin || flags.instance_origin || flags.access_token ||
-            flags.workspace || flags.branch || flags.project || flags['run-project'] || flags.run_base_url ||
+            flags.workspace || flags.branch || flags.project || flags.run_base_url ||
             flags['remove-workspace'] || flags['remove-branch'] || flags['remove-project'] ||
-            flags['remove-run-project'] || flags['remove-run-base-url'];
+            flags['remove-run-base-url'];
         if (!hasFlags) {
             this.error('No fields specified to update. Use at least one flag to edit the profile.');
         }
@@ -148,7 +139,6 @@ Profile 'default' updated successfully at ~/.xano/credentials.yaml
             ...(flags.workspace !== undefined && { workspace: flags.workspace }),
             ...(flags.branch !== undefined && { branch: flags.branch }),
             ...(flags.project !== undefined && { project: flags.project }),
-            ...(flags['run-project'] !== undefined && { run_project: flags['run-project'] }),
             ...(flags.run_base_url !== undefined && { run_base_url: flags.run_base_url }),
         };
         // Handle removal flags
@@ -161,9 +151,6 @@ Profile 'default' updated successfully at ~/.xano/credentials.yaml
         if (flags['remove-project']) {
             delete updatedProfile.project;
         }
-        if (flags['remove-run-project']) {
-            delete updatedProfile.run_project;
-        }
         if (flags['remove-run-base-url']) {
             delete updatedProfile.run_base_url;
         }

package/dist/commands/profile/wizard/index.js

@@ -192,14 +192,16 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
                     }
                 }
             }
-            // Step 7: Fetch run projects and auto-select the first one
-            let runProject;
+            // Step 7: Fetch run projects and auto-select the first one if no project was selected
             this.log('');
             this.log('Fetching available run projects...');
             try {
                 const runProjects = await this.fetchRunProjects(accessToken);
                 if (runProjects.length > 0) {
-                    runProject = runProjects[0].id;
+                    // Use run project if no metadata project was selected
+                    if (!project) {
+                        project = runProjects[0].id;
+                    }
                     this.log(`✓ Found ${runProjects.length} run project(s). Using "${runProjects[0].name}" as default.`);
                 }
                 else {
@@ -207,7 +209,7 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
                 }
             }
             catch {
-                // Silently ignore - run_project will remain undefined
+                // Silently ignore - project will remain undefined
             }
             // Save profile
             await this.saveProfile({
@@ -218,7 +220,6 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
                 workspace,
                 branch,
                 project,
-                run_project: runProject,
             }, true);
             this.log('');
             this.log(`✓ Profile '${profileName}' created successfully!`);
@@ -441,7 +442,6 @@ Profile 'production' created successfully at ~/.xano/credentials.yaml
             ...(profile.workspace && { workspace: profile.workspace }),
             ...(profile.branch && { branch: profile.branch }),
             ...(profile.project && { project: profile.project }),
-            ...(profile.run_project && { run_project: profile.run_project }),
         };
         // Set as default if requested
         if (setAsDefault) {

package/dist/commands/run/exec/index.d.ts

@@ -1,6 +1,8 @@
 import BaseRunCommand from '../../../lib/base-run-command.js';
 export default class RunExec extends BaseRunCommand {
-    static args: {};
+    static args: {
+        path: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
     static flags: {
         file: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         stdin: import("@oclif/core/interfaces").BooleanFlag<boolean>;
@@ -13,6 +15,14 @@ export default class RunExec extends BaseRunCommand {
     static description: string;
     static examples: string[];
     run(): Promise<void>;
+    /**
+     * Load all .xs files from a directory and combine them into a multidoc.
+     */
+    private loadMultidocFromDirectory;
+    /**
+     * Recursively collect all .xs files from a directory, sorted for deterministic ordering.
+     */
+    private collectFiles;
     private outputSummary;
     private editFile;
     private isUrl;

package/dist/commands/run/exec/index.js

@@ -1,16 +1,21 @@
-import { Flags } from '@oclif/core';
+import { Args, Flags } from '@oclif/core';
 import { execSync } from 'node:child_process';
 import * as fs from 'node:fs';
 import * as os from 'node:os';
 import * as path from 'node:path';
 import BaseRunCommand from '../../../lib/base-run-command.js';
 export default class RunExec extends BaseRunCommand {
-    static args = {};
+    static args = {
+        path: Args.string({
+            description: 'Path to file or directory containing XanoScript code (directory creates multidoc from .xs files)',
+            required: false,
+        }),
+    };
     static flags = {
         ...BaseRunCommand.baseFlags,
         file: Flags.string({
             char: 'f',
-            description: 'Path or URL to file containing XanoScript code',
+            description: 'Path or URL to file containing XanoScript code (deprecated: use path argument instead)',
             required: false,
             exclusive: ['stdin'],
         }),
@@ -48,11 +53,16 @@ export default class RunExec extends BaseRunCommand {
     };
     static description = 'Execute XanoScript code (job or service)';
     static examples = [
-        `$ xano run exec -f script.xs
+        `$ xano run exec script.xs
 Executed successfully!
 ...
 `,
-        `$ xano run exec -f script.xs --edit
+        `$ xano run exec ./my-workspace
+# Executes all .xs files in directory as multidoc
+Executed successfully!
+...
+`,
+        `$ xano run exec script.xs --edit
 # Opens script.xs in $EDITOR, then executes
 Executed successfully!
 ...
@@ -61,45 +71,51 @@ Executed successfully!
 Executed successfully!
 ...
 `,
-        `$ xano run exec -f script.xs -o json
+        `$ xano run exec script.xs -o json
 {
   "run": { ... }
 }
 `,
-        `$ xano run exec -f script.xs -a args.json
+        `$ xano run exec script.xs -a args.json
 # Executes with input arguments from args.json
 Executed successfully!
 ...
 `,
-        `$ xano run exec -f script.xs --env API_KEY=secret --env DEBUG=true
+        `$ xano run exec script.xs --env API_KEY=secret --env DEBUG=true
 # Executes with environment variable overrides
 Executed successfully!
 ...
 `,
     ];
     async run() {
-        const { flags } = await this.parse(RunExec);
+        const { args, flags } = await this.parse(RunExec);
         // Initialize with project required
         await this.initRunCommandWithProject(flags.profile);
         // Read XanoScript content
         let xanoscript;
-        if (flags.file) {
-            if (this.isUrl(flags.file)) {
+        // Determine input source: path argument, --file flag, or --stdin
+        const inputPath = args.path || flags.file;
+        if (inputPath) {
+            if (this.isUrl(inputPath)) {
                 // Fetch URL content
                 try {
-                    const response = await fetch(flags.file);
+                    const response = await fetch(inputPath);
                     if (!response.ok) {
                         this.error(`Failed to fetch URL: ${response.status} ${response.statusText}`);
                     }
                     xanoscript = await response.text();
                 }
                 catch (error) {
-                    this.error(`Failed to fetch URL '${flags.file}': ${error}`);
+                    this.error(`Failed to fetch URL '${inputPath}': ${error}`);
                 }
             }
+            else if (fs.existsSync(inputPath) && fs.statSync(inputPath).isDirectory()) {
+                // Handle directory - collect .xs files and create multidoc
+                xanoscript = this.loadMultidocFromDirectory(inputPath);
+            }
             else if (flags.edit) {
                 // If edit flag is set, copy to temp file and open in editor
-                const fileToRead = await this.editFile(flags.file);
+                const fileToRead = await this.editFile(inputPath);
                 xanoscript = fs.readFileSync(fileToRead, 'utf8');
                 // Clean up temp file
                 try {
@@ -111,10 +127,10 @@ Executed successfully!
             }
             else {
                 try {
-                    xanoscript = fs.readFileSync(flags.file, 'utf8');
+                    xanoscript = fs.readFileSync(inputPath, 'utf8');
                 }
                 catch (error) {
-                    this.error(`Failed to read file '${flags.file}': ${error}`);
+                    this.error(`Failed to read file '${inputPath}': ${error}`);
                 }
             }
         }
@@ -127,7 +143,7 @@ Executed successfully!
             }
         }
         else {
-            this.error('Either --file or --stdin must be specified to provide XanoScript code');
+            this.error('Either a path argument, --file, or --stdin must be specified to provide XanoScript code');
         }
         // Validate xanoscript is not empty
         if (!xanoscript || xanoscript.trim().length === 0) {
@@ -202,6 +218,48 @@ Executed successfully!
             }
         }
     }
+    /**
+     * Load all .xs files from a directory and combine them into a multidoc.
+     */
+    loadMultidocFromDirectory(dir) {
+        const resolvedDir = path.resolve(dir);
+        if (!fs.existsSync(resolvedDir)) {
+            this.error(`Directory not found: ${resolvedDir}`);
+        }
+        const files = this.collectFiles(resolvedDir);
+        if (files.length === 0) {
+            this.error(`No .xs files found in ${dir}`);
+        }
+        // Read each file and join with --- separator
+        const documents = [];
+        for (const filePath of files) {
+            const content = fs.readFileSync(filePath, 'utf8').trim();
+            if (content) {
+                documents.push(content);
+            }
+        }
+        if (documents.length === 0) {
+            this.error(`All .xs files in ${dir} are empty`);
+        }
+        return documents.join('\n---\n');
+    }
+    /**
+     * Recursively collect all .xs files from a directory, sorted for deterministic ordering.
+     */
+    collectFiles(dir) {
+        const files = [];
+        const entries = fs.readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                files.push(...this.collectFiles(fullPath));
+            }
+            else if (entry.isFile() && entry.name.endsWith('.xs')) {
+                files.push(fullPath);
+            }
+        }
+        return files.sort();
+    }
     outputSummary(result) {
         this.log('Executed successfully!');
         this.log('');

package/dist/lib/base-run-command.d.ts

@@ -10,7 +10,6 @@ export interface ProfileConfig {
     workspace?: string;
     branch?: string;
     project?: string;
-    run_project?: string;
     run_base_url?: string;
 }
 export interface CredentialsFile {

package/dist/lib/base-run-command.js

@@ -26,12 +26,10 @@ export default class BaseRunCommand extends BaseCommand {
             this.error(`Profile '${this.profileName}' is missing access_token`);
         }
         const baseUrl = this.profile.run_base_url || DEFAULT_RUN_BASE_URL;
-        // Use run_project if available, fall back to project for backward compatibility
-        const projectId = this.profile.run_project || this.profile.project;
         this.httpClient = new RunHttpClient({
             baseUrl,
             authToken: this.profile.access_token,
-            projectId,
+            projectId: this.profile.project,
         });
     }
     /**
@@ -39,9 +37,9 @@ export default class BaseRunCommand extends BaseCommand {
      */
     async initRunCommandWithProject(profileFlag) {
         await this.initRunCommand(profileFlag);
-        if (!this.profile.run_project && !this.profile.project) {
-            this.error(`Profile '${this.profileName}' is missing run_project. ` +
-                `Run 'xano profile:wizard' to set up your profile or use 'xano profile:edit --run-project <project-id>'`);
+        if (!this.profile.project) {
+            this.error(`Profile '${this.profileName}' is missing project. ` +
+                `Run 'xano profile:wizard' to set up your profile or use 'xano profile:edit --project <project-id>'`);
         }
     }
     /**