@xano/developer-mcp 1.0.60 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xano/developer-mcp",
-  "version": "1.0.60",
+  "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",