@xano/developer-mcp 1.0.59 → 1.0.61

package/dist/cli_docs/topics/update.d.ts

@@ -0,0 +1,2 @@
+import type { TopicDoc } from "../types.js";
+export declare const updateDoc: TopicDoc;

package/dist/cli_docs/topics/update.js

@@ -0,0 +1,29 @@
+export const updateDoc = {
+    topic: "update",
+    title: "Xano CLI - Update",
+    description: `The update command lets you check for and install CLI updates.`,
+    ai_hints: `**When to suggest updating:**
+- User encounters unexpected behavior that might be fixed in a newer version
+- User asks about new features
+- Before troubleshooting CLI issues
+
+**Update uses npm** - runs \`npm install -g @xano/cli\` under the hood.
+**Beta channel** - use \`--beta\` to get pre-release versions for testing new features.`,
+    related_topics: ["start"],
+    commands: [
+        {
+            name: "update",
+            description: "Update the Xano CLI to the latest version",
+            usage: "xano update [options]",
+            flags: [
+                { name: "check", type: "boolean", required: false, description: "Check for updates without installing" },
+                { name: "beta", type: "boolean", required: false, description: "Update to the latest beta version" }
+            ],
+            examples: [
+                "xano update",
+                "xano update --check",
+                "xano update --beta"
+            ]
+        }
+    ]
+};

package/dist/cli_docs/topics/workflow_test.d.ts

@@ -0,0 +1,2 @@
+import type { TopicDoc } from "../types.js";
+export declare const workflowTestDoc: TopicDoc;

package/dist/cli_docs/topics/workflow_test.js

@@ -0,0 +1,119 @@
+export const workflowTestDoc = {
+    topic: "workflow_test",
+    title: "Xano CLI - Workflow Test Management",
+    description: `Workflow test commands let you run end-to-end tests that exercise multi-step workflows. Unlike unit tests which test individual functions, workflow tests validate complete request flows.
+
+## Key Concepts
+
+- **Workflow tests** are more comprehensive than unit tests, testing full request flows.
+- Tests are created and configured in the Xano dashboard; the CLI is for listing, viewing, and running them.
+- The \`get\` command supports \`xs\` output format for viewing test XanoScript.
+- Use \`run_all\` in CI/CD pipelines for automated end-to-end validation.`,
+    ai_hints: `**Key concepts:**
+- Workflow tests are more comprehensive than unit tests, testing full request flows
+- Tests are created in the Xano dashboard; the CLI is for running them
+- \`workflow_test:get\` supports \`xs\` output format for viewing test XanoScript
+- Use \`workflow_test:run_all\` in CI/CD pipelines for automated testing
+
+**CI/CD integration:**
+- Use \`workflow_test:run_all -o json\` for machine-readable output
+- Combine with \`unit_test:run_all\` for full test coverage
+- Filter by branch with \`--branch\` to test specific branches
+
+**Viewing test details:**
+- Use \`workflow_test:get <id> -o xs\` to view the test XanoScript
+- Use \`--include-draft\` to view draft versions of tests`,
+    related_topics: ["unit_test", "workspace", "branch"],
+    commands: [
+        {
+            name: "workflow_test:list",
+            description: "List workflow tests in the workspace",
+            usage: "xano workflow_test:list [options]",
+            flags: [
+                { name: "branch", short: "b", type: "string", required: false, description: "Branch to list tests from" },
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID" },
+                { name: "output", short: "o", type: "string", required: false, default: "summary", description: "Output format: summary or json" }
+            ],
+            examples: [
+                "xano workflow_test:list",
+                "xano workflow_test:list --branch dev",
+                "xano workflow_test:list -o json"
+            ]
+        },
+        {
+            name: "workflow_test:get",
+            description: "Get details for a specific workflow test",
+            usage: "xano workflow_test:get <workflow_test_id> [options]",
+            args: [
+                { name: "workflow_test_id", required: true, description: "ID of the workflow test to retrieve" }
+            ],
+            flags: [
+                { name: "include-draft", type: "boolean", required: false, description: "Include draft version if available" },
+                { name: "output", short: "o", type: "string", required: false, default: "summary", description: "Output format: xs or json" },
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID" }
+            ],
+            examples: [
+                "xano workflow_test:get 456",
+                "xano workflow_test:get 456 -o xs",
+                "xano workflow_test:get 456 --include-draft -o json"
+            ]
+        },
+        {
+            name: "workflow_test:run",
+            description: "Run a single workflow test by ID",
+            usage: "xano workflow_test:run <workflow_test_id> [options]",
+            args: [
+                { name: "workflow_test_id", required: true, description: "ID of the workflow test to run" }
+            ],
+            flags: [
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID" },
+                { name: "output", short: "o", type: "string", required: false, default: "summary", description: "Output format: summary or json" }
+            ],
+            examples: [
+                "xano workflow_test:run 456",
+                "xano workflow_test:run 456 -o json"
+            ]
+        },
+        {
+            name: "workflow_test:run_all",
+            description: "Run all workflow tests in the workspace",
+            usage: "xano workflow_test:run_all [options]",
+            flags: [
+                { name: "branch", short: "b", type: "string", required: false, description: "Branch to run tests against" },
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID" },
+                { name: "output", short: "o", type: "string", required: false, default: "summary", description: "Output format: summary or json" }
+            ],
+            examples: [
+                "xano workflow_test:run_all",
+                "xano workflow_test:run_all --branch dev -o json"
+            ]
+        },
+        {
+            name: "workflow_test:delete",
+            description: "Delete a workflow test by ID",
+            usage: "xano workflow_test:delete <workflow_test_id> [options]",
+            args: [
+                { name: "workflow_test_id", required: true, description: "ID of the workflow test to delete" }
+            ],
+            flags: [
+                { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID" }
+            ],
+            examples: [
+                "xano workflow_test:delete 456"
+            ]
+        }
+    ],
+    workflows: [
+        {
+            name: "Validate Workflows Before Deploy",
+            description: "Run all workflow tests to validate before deployment",
+            steps: [
+                "List available tests: `xano workflow_test:list`",
+                "Run all tests: `xano workflow_test:run_all`",
+                "Check results for PASS/FAIL status"
+            ],
+            example: `xano workflow_test:list
+xano workflow_test:run_all -o json`
+        }
+    ]
+};

package/dist/cli_docs/topics/workspace.js

@@ -78,8 +78,20 @@ After \`workspace:pull\`, files are organized using snake_case naming:
 
 **Branch handling:**
 - Use \`-b\` flag or set branch in profile
-- Pull from one branch, push to another is supported`,
-    related_topics: ["start", "function", "integration"],
+- Pull from one branch, push to another is supported
+
+**Push modes:**
+- Default (partial): Only pushes changed files
+- \`--sync\`: Full push of all files
+- \`--sync --delete\`: Full push AND removes remote objects not in local
+- \`--dry-run\`: Preview what would change without applying
+- \`--include/-i\` and \`--exclude/-e\`: Glob patterns for selective push
+
+**Git integration:**
+- \`workspace:git:pull\` pulls XanoScript directly from GitHub/GitLab repos
+- Supports private repos with \`--token\` flag
+- Can pull from a specific subdirectory with \`--path\``,
+    related_topics: ["start", "branch", "function", "release", "integration"],
     commands: [
         {
             name: "workspace:list",
@@ -162,37 +174,72 @@ After \`workspace:pull\`, files are organized using snake_case naming:
         },
         {
             name: "workspace:pull",
-            description: "Download workspace code to local directory",
+            description: "Download workspace code to local directory. Splits multidoc into individual .xs files organized by type.",
             usage: "xano workspace:pull <directory> [options]",
             args: [
                 { name: "directory", required: true, description: "Local directory to save files" }
             ],
             flags: [
                 { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID (uses profile default if not set)" },
-                { name: "branch", short: "b", type: "string", required: false, description: "Branch ID to pull from" },
+                { name: "branch", short: "b", type: "string", required: false, description: "Branch label to pull from" },
                 { name: "env", type: "boolean", required: false, description: "Include environment variables" },
+                { name: "draft", type: "boolean", required: false, description: "Include draft versions of functions" },
                 { name: "records", type: "boolean", required: false, description: "Include table records" }
             ],
             examples: [
                 "xano workspace:pull ./my-app",
-                "xano workspace:pull ./staging-code -b 2",
-                "xano workspace:pull ./backup --env --records"
+                "xano workspace:pull ./staging-code -b dev",
+                "xano workspace:pull ./backup --env --records --draft"
             ]
         },
         {
             name: "workspace:push",
-            description: "Upload local XanoScript files to workspace",
+            description: "Upload local XanoScript files to workspace. By default only pushes changed files (partial push). Use --sync for a full push.",
             usage: "xano workspace:push <directory> [options]",
             args: [
                 { name: "directory", required: true, description: "Local directory containing .xs files" }
             ],
             flags: [
                 { name: "workspace", short: "w", type: "string", required: false, description: "Workspace ID (uses profile default if not set)" },
-                { name: "branch", short: "b", type: "string", required: false, description: "Branch ID to push to" }
+                { name: "branch", short: "b", type: "string", required: false, description: "Branch label to push to" },
+                { name: "sync", type: "boolean", required: false, description: "Full push (default is partial/changed-only)" },
+                { name: "delete", type: "boolean", required: false, description: "Delete remote objects not in local files (requires --sync)" },
+                { name: "dry-run", type: "boolean", required: false, description: "Preview changes without applying" },
+                { name: "force", type: "boolean", required: false, description: "Skip confirmation prompt" },
+                { name: "env", type: "boolean", required: false, description: "Include environment variables" },
+                { name: "records", type: "boolean", required: false, description: "Include table records" },
+                { name: "truncate", type: "boolean", required: false, description: "Truncate tables before importing records" },
+                { name: "transaction", type: "boolean", required: false, default: "true", description: "Wrap push in database transaction (--no-transaction to disable)" },
+                { name: "guids", type: "boolean", required: false, default: "true", description: "Write GUIDs back to local files after push (--no-guids to disable)" },
+                { name: "include", short: "i", type: "string", required: false, description: "Glob pattern to include specific files (repeatable)" },
+                { name: "exclude", short: "e", type: "string", required: false, description: "Glob pattern to exclude specific files (repeatable)" }
             ],
             examples: [
                 "xano workspace:push ./my-app",
-                "xano workspace:push ./my-app -b 2"
+                "xano workspace:push ./my-app -b dev",
+                "xano workspace:push ./my-app --dry-run",
+                "xano workspace:push ./my-app --sync --delete --force",
+                "xano workspace:push ./my-app -i 'api/**' -i 'function/**'",
+                "xano workspace:push ./my-app -e 'table/**' --records --truncate"
+            ]
+        },
+        {
+            name: "workspace:git:pull",
+            description: "Pull XanoScript files directly from a git repository (GitHub, GitLab, etc.)",
+            usage: "xano workspace:git:pull <directory> --repo <url> [options]",
+            args: [
+                { name: "directory", required: true, description: "Local directory to save files" }
+            ],
+            flags: [
+                { name: "repo", short: "r", type: "string", required: true, description: "Git repository URL (HTTPS or SSH)" },
+                { name: "branch", short: "b", type: "string", required: false, description: "Git branch, tag, or ref to pull from" },
+                { name: "path", type: "string", required: false, description: "Subdirectory within the repo to pull from" },
+                { name: "token", short: "t", type: "string", required: false, description: "Personal access token for private repos" }
+            ],
+            examples: [
+                "xano workspace:git:pull ./code -r https://github.com/org/repo.git",
+                "xano workspace:git:pull ./code -r https://github.com/org/repo.git -b main --path src/xano",
+                "xano workspace:git:pull ./code -r https://github.com/org/private-repo.git -t ghp_token123"
             ]
         }
     ],

package/dist/xanoscript_docs/README.md

@@ -193,6 +193,9 @@ Use `xanoscript_docs({ tier: "survival" })` or `xanoscript_docs({ tier: "working
 | ------------ | ---------------------------------------------------- | ------------ |
 | `essentials` | Common patterns, quick examples, mistakes to avoid   | Patterns, Common Mistakes |
 | `syntax`     | Expressions, operators, filters, system variables    | Filters, Error Handling |
+| `syntax/string-filters` | String manipulation filters                 | Case, Trim, Split, Replace |
+| `syntax/array-filters`  | Array manipulation filters                  | Map, Filter, Sort, Group |
+| `syntax/functions`      | Built-in functions                          | Math, Date, Crypto, JSON |
 | `types`      | Data types, validation, input blocks                 | Validation Filters, Input Blocks |
 | `functions`  | Reusable function stacks, async, loops               | Loops, Async Patterns |
 | `schema`     | Runtime schema parsing and validation                | parse.object, parse.array |
@@ -227,7 +230,7 @@ Use `xanoscript_docs({ tier: "survival" })` or `xanoscript_docs({ tier: "working
 
 | Topic          | Description                                       | Sub-topics |
 | -------------- | ------------------------------------------------- | ---------- |
-| `integrations` | Cloud storage, Redis, security, and external APIs | cloud-storage, search, redis, external-apis, utilities |
+| `integrations` | Cloud storage, Redis, security, and external APIs | integrations/cloud-storage, integrations/search, integrations/redis, integrations/external-apis, integrations/utilities |
 
 ### Configuration
 

package/dist/xanoscript_docs/branch.md

@@ -236,3 +236,13 @@ project/
 1. **Use descriptive colors** - Green for production, blue for development, yellow for staging
 2. **Limit production history** - Excessive history impacts performance and storage
 3. **Apply security middleware in production** - Rate limiting, auth checks, audit logging
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `workspace` | Workspace-level configuration |
+| `middleware` | Request/response interceptors |
+| `security` | Authentication and rate limiting |

package/dist/xanoscript_docs/debugging.md

@@ -77,3 +77,13 @@ View past request executions in the Xano dashboard:
 
 1. **Remove debug.stop in production** - Causes execution to halt
 2. **Don't log sensitive data** - Passwords, tokens, PII
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `performance` | Performance profiling and optimization |
+| `unit-testing` | Unit testing functions |
+| `workflow-tests` | End-to-end workflow testing |

package/dist/xanoscript_docs/functions.md

@@ -472,4 +472,4 @@ Explore more with `xanoscript_docs({ topic: "<topic>" })`:
 | `syntax` | Expressions, operators, and control flow |
 | `essentials` | Common patterns and examples |
 | `database` | Database operations in function stacks |
-| `testing` | Unit testing functions |
+| `unit-testing` | Unit testing functions |

package/dist/xanoscript_docs/middleware.md

@@ -304,3 +304,14 @@ branch "production" {
 1. **Keep middleware focused** - Each middleware should do one thing well
 2. **Use appropriate exception policies** - Critical for security, silent for optional enrichment
 3. **Consider performance** - Middleware runs on every request; log even silent failures
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `branch` | Branch-level middleware configuration |
+| `security` | Authentication and authorization patterns |
+| `apis` | API endpoint request/response lifecycle |
+| `performance` | Performance optimization strategies |

package/dist/xanoscript_docs/realtime.md

@@ -295,3 +295,13 @@ Clients subscribe to channels client-side. Server controls what events to send.
 1. **Use channel namespacing** - `type:id` format for clarity
 2. **Keep payloads small** - Send IDs, let client fetch details
 3. **Validate before broadcast** - Don't trust client event data
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `workspace` | Realtime configuration settings |
+| `security` | Authorization patterns for channels |
+| `frontend` | Client-side realtime integration |

package/dist/xanoscript_docs/schema.md

@@ -288,3 +288,13 @@ try_catch {
 1. **Define schemas upfront** - Use input blocks when structure is known
 2. **Use schema.parse for dynamic data** - External APIs, user-generated content
 3. **Validate at boundaries** - Parse external input, trust internal data; provide clear error messages
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `types` | Data types and input validation |
+| `integrations/external-apis` | Parsing external API responses |
+| `syntax` | Expressions and filters |

package/dist/xanoscript_docs/survival.md

@@ -158,4 +158,4 @@ input {
 
 ### Available Topics
 
-essentials, syntax, types, database, functions, apis, tables, tasks, triggers, agents, tools, mcp-servers, security, performance, debugging, unit-testing, workflow-tests, middleware, addons, realtime, streaming, schema, integrations, workspace, branch, run, frontend
+survival, working, readme, essentials, syntax, syntax/string-filters, syntax/array-filters, syntax/functions, types, database, functions, apis, tables, tasks, triggers, agents, tools, mcp-servers, security, performance, debugging, unit-testing, workflow-tests, middleware, addons, realtime, streaming, schema, integrations, integrations/cloud-storage, integrations/search, integrations/redis, integrations/external-apis, integrations/utilities, workspace, branch, run, frontend

package/dist/xanoscript_docs/workspace.md

@@ -207,3 +207,13 @@ These variables are automatically available without configuration:
 1. **Never commit secrets** - Use environment variables for API keys and credentials
 2. **Use descriptive names** - Environment variable names should be self-documenting
 3. **Enable performance tracking** - Helps identify bottlenecks in production
+
+---
+
+## Related Topics
+
+| Topic | Description |
+|-------|-------------|
+| `branch` | Branch-level configuration |
+| `realtime` | Realtime channel configuration |
+| `security` | Environment variable security practices |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/developer-mcp",
-  "version": "1.0.59",
+  "version": "1.0.61",
   "description": "MCP server and library for Xano development - XanoScript validation, Meta API, Run API, and CLI documentation",
   "type": "module",
   "main": "dist/lib.js",