@xano/cli 0.0.85 → 0.0.87

package/README.md

@@ -114,17 +114,17 @@ xano workspace pull ./my-workspace -b dev              # Specific branch
 xano workspace pull ./my-workspace --env --records      # Include env vars and table records
 xano workspace pull ./my-workspace --draft              # Include draft changes
 
-# Push local files to workspace
+# Push local files to workspace (only changed files by default)
 xano workspace push ./my-workspace
 xano workspace push ./my-workspace -b dev
+xano workspace push ./my-workspace --sync                # Full push — send all files, not just changed ones
+xano workspace push ./my-workspace --sync --delete       # Full push + delete remote objects not included
 xano workspace push ./my-workspace --dry-run             # Preview changes without pushing
-xano workspace push ./my-workspace --partial             # Push only changed files, workspace block not required
-xano workspace push ./my-workspace --delete              # Delete objects not in the push
 xano workspace push ./my-workspace --records             # Include table records
 xano workspace push ./my-workspace --env                 # Include environment variables
 xano workspace push ./my-workspace --truncate            # Truncate tables before import
 xano workspace push ./my-workspace --no-transaction      # Disable database transaction wrapping
-xano workspace push ./my-workspace --no-sync-guids       # Skip writing GUIDs back to local files
+xano workspace push ./my-workspace --no-guids             # Skip writing GUIDs back to local files
 xano workspace push ./my-workspace --force               # Skip preview and confirmation (for CI/CD)
 
 # Pull from a git repository to local files

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

@@ -10,9 +10,9 @@ export default class Push extends BaseCommand {
         delete: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         env: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        partial: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        sync: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         records: import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'sync-guids': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        guids: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         transaction: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         truncate: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         workspace: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

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

@@ -12,19 +12,22 @@ export default class Push extends BaseCommand {
             required: true,
         }),
     };
-    static description = 'Push local documents to a workspace. Shows a preview of changes before pushing unless --force is specified. Use --dry-run to preview only.';
+    static description = 'Push local documents to a workspace. 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.';
     static examples = [
         `$ xano workspace push ./my-workspace
-Shows preview of changes, requires confirmation
+Push only changed files (default partial mode)
+`,
+        `$ xano workspace push ./my-workspace --sync
+Push all files to the workspace
+`,
+        `$ xano workspace push ./my-workspace --sync --delete
+Push all files and delete remote objects not included
 `,
         `$ xano workspace push ./my-workspace --dry-run
 Preview changes without pushing
 `,
         `$ xano workspace push ./my-workspace --force
 Skip preview and push immediately (for CI/CD)
-`,
-        `$ xano workspace push ./my-workspace --delete
-Shows preview including deletions, requires confirmation
 `,
         `$ xano workspace push ./output -w 40
 Pushed 15 documents from ./output
@@ -34,9 +37,6 @@ Pushed 58 documents from ./backup
 `,
         `$ xano workspace push ./my-workspace -b dev
 Pushed 42 documents from ./my-workspace
-`,
-        `$ xano workspace push ./my-functions --partial
-Push some files without a workspace block (implies --no-delete)
 `,
         `$ xano workspace push ./my-workspace --no-records
 Push schema only, skip importing table records
@@ -57,7 +57,7 @@ Truncate all table records before importing
         }),
         delete: Flags.boolean({
             default: false,
-            description: 'Delete workspace objects not included in the push',
+            description: 'Delete workspace objects not included in the push (requires --sync)',
             required: false,
         }),
         'dry-run': Flags.boolean({
@@ -70,9 +70,9 @@ Truncate all table records before importing
             description: 'Include environment variables in import',
             required: false,
         }),
-        partial: Flags.boolean({
+        sync: Flags.boolean({
             default: false,
-            description: 'Partial push — workspace block is not required, existing objects are kept (implies --no-delete)',
+            description: 'Full push — send all files, not just changed ones. Required for --delete.',
             required: false,
         }),
         records: Flags.boolean({
@@ -80,10 +80,10 @@ Truncate all table records before importing
             description: 'Include records in import',
             required: false,
         }),
-        'sync-guids': Flags.boolean({
+        guids: Flags.boolean({
             allowNo: true,
             default: true,
-            description: 'Write server-assigned GUIDs back to local files (use --no-sync-guids to skip)',
+            description: 'Write server-assigned GUIDs back to local files (use --no-guids to skip)',
             required: false,
         }),
         transaction: Flags.boolean({
@@ -176,16 +176,17 @@ Truncate all table records before importing
         }
         // Determine branch from flag or profile
         const branch = flags.branch || profile.branch || '';
-        if (flags.partial && flags.delete) {
-            this.error('Cannot use --delete with --partial');
+        const isPartial = !flags.sync;
+        if (flags.delete && isPartial) {
+            this.error('Cannot use --delete without --sync');
         }
-        const shouldDelete = flags.partial ? false : flags.delete;
+        const shouldDelete = isPartial ? false : flags.delete;
         // Construct the API URL
         const queryParams = new URLSearchParams({
             branch,
             delete: shouldDelete.toString(),
             env: flags.env.toString(),
-            partial: flags.partial.toString(),
+            partial: isPartial.toString(),
             records: flags.records.toString(),
             transaction: flags.transaction.toString(),
             truncate: flags.truncate.toString(),
@@ -201,7 +202,7 @@ Truncate all table records before importing
         if (flags['dry-run'] || !flags.force) {
             const dryRunParams = new URLSearchParams(queryParams);
             // Request delete info in dry-run so we can show remote-only items (skip for partial)
-            if (!flags.partial) {
+            if (!isPartial) {
                 dryRunParams.set('delete', 'true');
             }
             const dryRunUrl = `${profile.instance_origin}/api:meta/workspace/${workspaceId}/multidoc/dry-run?${dryRunParams.toString()}`;
@@ -255,7 +256,7 @@ Truncate all table records before importing
                     dryRunPreview = preview;
                     // Check if the server returned a valid dry-run response
                     if (preview && preview.summary) {
-                        this.renderPreview(preview, shouldDelete, workspaceId, flags.verbose, flags.partial);
+                        this.renderPreview(preview, shouldDelete, workspaceId, flags.verbose, isPartial);
                         // Check for critical errors that must block the push
                         const criticalOps = preview.operations.filter((op) => op.details?.includes('exception:') || op.details?.includes('mvp:placeholder'));
                         if (criticalOps.length > 0) {
@@ -374,7 +375,7 @@ Truncate all table records before importing
             }
         }
         // For partial pushes, filter to only changed documents
-        if (flags.partial && dryRunPreview) {
+        if (isPartial && dryRunPreview) {
             const changedKeys = new Set(dryRunPreview.operations
                 .filter((op) => op.action !== 'unchanged' && op.action !== 'delete' && op.action !== 'cascade_delete')
                 .map((op) => `${op.type}:${op.name}`));
@@ -442,7 +443,7 @@ Truncate all table records before importing
                 }
             }
             // Write GUIDs back to local files
-            if (flags['sync-guids'] && guidMap.length > 0) {
+            if (flags.guids && guidMap.length > 0) {
                 // Build a secondary lookup by type:name only (without verb/api_group)
                 // for cases where the server omits those fields
                 const baseKeyMap = new Map();
@@ -542,6 +543,9 @@ Truncate all table records before importing
         this.log('');
         const wsLabel = result.workspace_name ? `${result.workspace_name} (${workspaceId})` : `Workspace ${workspaceId}`;
         this.log(ux.colorize('bold', `=== Push Preview: ${wsLabel} ===`));
+        if (!partial) {
+            this.log(ux.colorize('red', '  --sync: all documents will be sent, including unchanged'));
+        }
         this.log('');
         for (const [type, counts] of Object.entries(result.summary)) {
             const label = typeLabels[type] || type;