@xano/cli 1.0.4-beta.12 → 1.0.4-beta.15

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

@@ -5,7 +5,7 @@ import open from 'open';
 import BaseCommand from '../../../base-command.js';
 import { executePush } from '../../../utils/multidoc-push.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. Large pushes against a sandbox loaded with a different workspace will prompt for confirmation; run `xano sandbox reset` first to start clean.';
+    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 = [
         `$ xano sandbox push
 Push from current directory (default partial mode)
@@ -109,6 +109,7 @@ Push and open sandbox review in the browser
             cliVersion: this.config.version,
             instanceOrigin: profile.instance_origin,
             label: 'sandbox environment',
+            sourceWorkspaceId: profile.workspace,
             supportsBranches: false,
             supportsPartial: true,
             warnOnWorkspaceMismatch: true,

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

@@ -1,5 +1,6 @@
 import { Flags } from '@oclif/core';
 import BaseCommand from '../../../base-command.js';
+import { pushKnowledge } from '../../../utils/knowledge-sync.js';
 export default class SandboxReset extends BaseCommand {
     static description = '[CRITICAL] NEVER run without explicit user confirmation; this clears all workspace data and drafts. Resets your sandbox environment.';
     static examples = [
@@ -42,6 +43,17 @@ Sandbox environment has been reset.
                 const message = await this.parseApiError(response, 'API request failed');
                 this.error(message);
             }
+            try {
+                const knowledgeUrl = `${profile.instance_origin}/api:meta/sandbox/knowledge/sync`;
+                await pushKnowledge(knowledgeUrl, profile.access_token, this.verboseFetch.bind(this), flags.verbose, {
+                    delete: true,
+                    force: true,
+                    items: [],
+                });
+            }
+            catch (error) {
+                this.warn(`Sandbox environment was reset, but clearing knowledge files failed: ${error instanceof Error ? error.message : String(error)}`);
+            }
             this.log('Sandbox environment has been reset.');
         }
         catch (error) {

package/dist/utils/multidoc-push.d.ts

@@ -25,14 +25,19 @@ export interface PushTarget {
     instanceOrigin: string;
     /** Human-readable label for log messages (e.g., "sandbox environment", "workspace 40") */
     label: string;
+    /**
+     * The id of the source workspace being pushed (from the active profile). Sent to the sandbox
+     * so the backend can flag a mismatch when it differs from the workspace the sandbox last held.
+     */
+    sourceWorkspaceId?: string;
     /** Does this target support branches? */
     supportsBranches: boolean;
     /** Does this target support the partial query param? */
     supportsPartial: boolean;
     /**
-     * Warn when the workspace embedded in the local push differs from the workspace currently
-     * loaded on the target (per dry-run). Used by sandbox push because the sandbox is shared
-     * across workspaces and pushing onto a different workspace can leave stale state behind.
+     * Warn when the sandbox currently holds a different source workspace than the one being pushed
+     * (per the dry-run's `source_workspace_mismatch` flag). Used by sandbox push because the sandbox
+     * is shared across workspaces and pushing onto a different one can leave stale state behind.
      */
     warnOnWorkspaceMismatch?: boolean;
 }
@@ -51,17 +56,6 @@ export interface PushContext {
     knowledge?: KnowledgeConfig;
     verboseFetch: (url: string, options: RequestInit, verbose: boolean, authToken?: string) => Promise<Response>;
 }
-export declare const WORKSPACE_MISMATCH_THRESHOLD = 10;
-/**
- * Sum all impactful operations in a dry-run summary. `deleted` is only counted when the
- * caller actually intends to apply deletions (sync mode), matching what the user will see.
- */
-export declare function countSummaryChanges(summary: Record<string, {
-    created: number;
-    deleted: number;
-    truncated: number;
-    updated: number;
-}>, shouldDelete: boolean): number;
 /**
  * Filter document entries down to the ones the dry-run preview reports as changed,
  * used to send only the changed documents during a partial (non-`--sync`) push.
@@ -105,10 +99,6 @@ export declare function readDocuments(files: string[]): Array<{
 }>;
 export declare function renderBadReferences(badRefs: BadReference[], log: (msg: string) => void): void;
 export declare function renderBadIndexes(badIndexes: BadIndex[], log: (msg: string) => void): void;
-export declare function findLocalWorkspaceName(entries: Array<{
-    content: string;
-    filePath: string;
-}>): null | string;
 export declare function confirm(message: string): Promise<boolean>;
 /**
  * Execute a multidoc push with preview, validation, partial mode, and GUID sync.

package/dist/utils/multidoc-push.js

@@ -5,16 +5,6 @@ import { join, relative } from 'node:path';
 import { buildDocumentKey, findFilesWithGuid, parseDocument } from './document-parser.js';
 import { collectKnowledgeObjects, fetchKnowledge, knowledgePreview, pushKnowledge, syncGuidToFrontmatter, toPushItems, } from './knowledge-sync.js';
 import { checkReferences, checkTableIndexes } from './reference-checker.js';
-// Minimum total operations before a workspace mismatch is treated as worth interrupting for.
-// Small change sets (e.g., editing a single function) aren't worth a reset prompt.
-export const WORKSPACE_MISMATCH_THRESHOLD = 10;
-/**
- * Sum all impactful operations in a dry-run summary. `deleted` is only counted when the
- * caller actually intends to apply deletions (sync mode), matching what the user will see.
- */
-export function countSummaryChanges(summary, shouldDelete) {
-    return Object.values(summary).reduce((sum, c) => sum + c.created + c.updated + (shouldDelete ? c.deleted : 0) + c.truncated, 0);
-}
 /**
  * Filter document entries down to the ones the dry-run preview reports as changed,
  * used to send only the changed documents during a partial (non-`--sync`) push.
@@ -263,14 +253,6 @@ function renderPreview(result, willDelete, target, verbose, partial, log) {
     }
     log('');
 }
-export function findLocalWorkspaceName(entries) {
-    for (const entry of entries) {
-        const parsed = parseDocument(entry.content);
-        if (parsed?.type === 'workspace')
-            return parsed.name;
-    }
-    return null;
-}
 // ── Confirmation ────────────────────────────────────────────────────────────
 export async function confirm(message) {
     const readline = await import('node:readline');
@@ -435,6 +417,9 @@ export async function executePush(ctx, target, flags) {
     if (target.supportsPartial) {
         queryParams.set('partial', isPartial.toString());
     }
+    if (target.sourceWorkspaceId) {
+        queryParams.set('source_workspace_id', target.sourceWorkspaceId);
+    }
     // ── Request headers ───────────────────────────────────────────────────
     const requestHeaders = {
         accept: 'application/json',
@@ -530,32 +515,28 @@ export async function executePush(ctx, target, flags) {
                     if (flags['dry-run']) {
                         return;
                     }
-                    // Warn when the sandbox currently holds a different workspace than the one being
-                    // pushed and the change set is large enough that stale state is a real risk.
+                    // Warn when the sandbox currently holds a different source workspace than the one being
+                    // pushed. The backend compares the source workspace id we sent against the id stored on
+                    // the sandbox from its last push, so this is reliable regardless of whether the push
+                    // includes a workspace-settings document (unlike the old name comparison).
                     let mismatchConfirmed = false;
-                    if (target.warnOnWorkspaceMismatch && preview.workspace_name) {
-                        const localWorkspaceName = findLocalWorkspaceName(documentEntries);
-                        const totalChanges = countSummaryChanges(preview.summary, shouldDelete);
-                        if (localWorkspaceName &&
-                            localWorkspaceName !== preview.workspace_name &&
-                            totalChanges >= WORKSPACE_MISMATCH_THRESHOLD) {
-                            log('');
-                            log(ux.colorize('yellow', ux.colorize('bold', '=== Workspace Mismatch ===')));
-                            log('');
-                            log(ux.colorize('yellow', `Sandbox currently holds workspace "${preview.workspace_name}", but you're pushing "${localWorkspaceName}" with ${totalChanges} changes.`));
-                            log(ux.colorize('yellow', 'Pushing on top of a different workspace can leave stale data behind. Run `xano sandbox reset` first to start clean.'));
-                            log('');
-                            if (process.stdin.isTTY) {
-                                const proceed = await confirm('Continue with push anyway?');
-                                if (!proceed) {
-                                    log('Push cancelled. Run `xano sandbox reset` then retry.');
-                                    return;
-                                }
-                                mismatchConfirmed = true;
-                            }
-                            else {
-                                command.error('Workspace mismatch detected in non-interactive mode. Run `xano sandbox reset` first to start clean.');
+                    if (target.warnOnWorkspaceMismatch && preview.source_workspace_mismatch) {
+                        log('');
+                        log(ux.colorize('yellow', ux.colorize('bold', '=== Workspace Mismatch ===')));
+                        log('');
+                        log(ux.colorize('yellow', "This sandbox currently holds a different workspace than the one you're pushing."));
+                        log(ux.colorize('yellow', 'Pushing on top of it can leave stale data behind. Run `xano sandbox reset` first to start clean.'));
+                        log('');
+                        if (process.stdin.isTTY) {
+                            const proceed = await confirm('Continue with push anyway?');
+                            if (!proceed) {
+                                log('Push cancelled. Run `xano sandbox reset` then retry.');
+                                return;
                             }
+                            mismatchConfirmed = true;
+                        }
+                        else {
+                            command.error('Workspace mismatch detected in non-interactive mode. Run `xano sandbox reset` first to start clean.');
                         }
                     }
                     // Confirm with user (skip if workspace mismatch prompt already obtained confirmation)