@xano/developer-mcp 1.0.58 → 1.0.59

package/dist/xanoscript_docs/debugging.md

@@ -25,38 +25,10 @@ debug.log { value = "Starting process" }
 
 debug.log { value = $user }
 
-debug.log { value = { step: "validation", data: $input } }
-```
-
-### With Labels
-
-```xs
 debug.log {
   label = "User Data"
   value = $user
 }
-
-debug.log {
-  label = "Query Result"
-  value = $products
-}
-```
-
-### Conditional Logging
-
-```xs
-conditional {
-  if ($env.DEBUG == "true") {
-    debug.log {
-      label = "Debug Info"
-      value = {
-        input: $input,
-        auth: $auth,
-        timestamp: now
-      }
-    }
-  }
-}
 ```
 
 ---
@@ -78,194 +50,6 @@ debug.stop                              // Execution pauses here
 db.edit "user" { ... }
 ```
 
-### Conditional Stop
-
-```xs
-conditional {
-  if ($user == null) {
-    debug.log { value = "User not found, stopping" }
-    debug.stop
-  }
-}
-```
-
-### With Data Inspection
-
-```xs
-debug.log {
-  label = "State at stop point"
-  value = {
-    input: $input,
-    user: $user,
-    calculated: $total
-  }
-}
-debug.stop
-```
-
----
-
-## Logging Patterns
-
-### Request Tracing
-
-```xs
-function "process_order" {
-  input { int order_id }
-  stack {
-    security.create_uuid as $trace_id
-
-    debug.log {
-      label = "TRACE_START"
-      value = { trace_id: $trace_id, order_id: $input.order_id }
-    }
-
-    // ... processing ...
-
-    debug.log {
-      label = "TRACE_END"
-      value = { trace_id: $trace_id, status: "success" }
-    }
-  }
-}
-```
-
-### Error Context
-
-```xs
-try_catch {
-  try {
-    function.run "risky_operation" { input = $data }
-  }
-  catch {
-    debug.log {
-      label = "ERROR"
-      value = {
-        operation: "risky_operation",
-        input: $data,
-        error: $error.message,
-        stack: $error.stack
-      }
-    }
-    throw { name = $error.name, value = $error.message }
-  }
-}
-```
-
-### Performance Timing
-
-```xs
-var $start { value = now|to_ms }
-
-db.query "product" { ... } as $products
-
-var $query_time { value = (now|to_ms) - $start }
-
-debug.log {
-  label = "PERF"
-  value = {
-    operation: "product_query",
-    duration_ms: $query_time,
-    record_count: $products|count
-  }
-}
-```
-
-### Step-by-Step
-
-```xs
-debug.log { value = "Step 1: Validating input" }
-// validation code
-
-debug.log { value = "Step 2: Fetching user" }
-db.get "user" { ... } as $user
-
-debug.log { value = "Step 3: Processing order" }
-// order processing
-
-debug.log { value = "Step 4: Sending notification" }
-// notification code
-
-debug.log { value = "Complete" }
-```
-
----
-
-## Inspecting Variables
-
-### Object Inspection
-
-```xs
-debug.log {
-  label = "User object"
-  value = $user
-}
-
-// Logs full object structure:
-// {
-//   id: 123,
-//   name: "John",
-//   email: "john@example.com",
-//   ...
-// }
-```
-
-### Array Inspection
-
-```xs
-debug.log {
-  label = "Products"
-  value = {
-    count: $products|count,
-    first: $products|first,
-    last: $products|last,
-    sample: $products|slice:0:3
-  }
-}
-```
-
-### Expression Evaluation
-
-```xs
-debug.log {
-  label = "Calculated values"
-  value = {
-    total: $items|map:$$.price * $$.quantity|sum,
-    tax: ($items|map:$$.price * $$.quantity|sum) * 0.08,
-    item_count: $items|count
-  }
-}
-```
-
----
-
-## Environment-Based Debugging
-
-### Development Only
-
-```xs
-conditional {
-  if ($env.ENVIRONMENT == "development") {
-    debug.log { value = "Development mode: verbose logging enabled" }
-    debug.log { value = $input }
-  }
-}
-```
-
-### Debug Flag
-
-```xs
-// Enable with environment variable DEBUG=true
-conditional {
-  if ($env.DEBUG|to_bool == true) {
-    debug.log {
-      label = "Debug"
-      value = { step: "after_query", data: $result }
-    }
-  }
-}
-```
-
 ---
 
 ## Request History
@@ -289,54 +73,7 @@ View past request executions in the Xano dashboard:
 
 ---
 
-## Debugging Strategies
-
-### Isolate the Problem
-
-```xs
-// Comment out sections to isolate issues
-debug.log { value = "Checkpoint 1" }
-// potentially problematic code
-debug.log { value = "Checkpoint 2" }
-```
-
-### Validate Assumptions
-
-```xs
-debug.log {
-  label = "Assumption check"
-  value = {
-    user_exists: $user != null,
-    has_permission: $user.role == "admin",
-    input_valid: $input.amount > 0
-  }
-}
-```
-
-### Compare Expected vs Actual
-
-```xs
-var $expected { value = 100 }
-var $actual { value = $items|count }
-
-debug.log {
-  label = "Comparison"
-  value = {
-    expected: $expected,
-    actual: $actual,
-    match: $expected == $actual
-  }
-}
-```
-
----
-
 ## Best Practices
 
 1. **Remove debug.stop in production** - Causes execution to halt
-2. **Use labels consistently** - Makes log searching easier
-3. **Log at boundaries** - Function entry/exit, external calls
-4. **Include context** - IDs, timestamps, relevant state
-5. **Don't log sensitive data** - Passwords, tokens, PII
-6. **Use environment flags** - Enable verbose logging conditionally
-7. **Check request history** - Built-in debugging in dashboard
+2. **Don't log sensitive data** - Passwords, tokens, PII

package/dist/xanoscript_docs/docs_index.json

@@ -3,6 +3,20 @@
   "description": "Machine-readable index for XanoScript documentation",
 
   "topics": {
+    "survival": {
+      "file": "survival.md",
+      "description": "Minimal syntax survival kit for writing valid XanoScript (~3KB)",
+      "applyTo": ["**/*.xs"],
+      "priority": 0,
+      "aliases": ["minimal", "tiny", "nano", "small"]
+    },
+    "working": {
+      "file": "working.md",
+      "description": "Complete working reference for common XanoScript tasks (~12KB)",
+      "applyTo": ["**/*.xs"],
+      "priority": 0,
+      "aliases": ["compact", "reference", "medium"]
+    },
     "readme": {
       "file": "README.md",
       "description": "XanoScript overview, workspace structure, and quick reference",
@@ -52,30 +66,35 @@
       "file": "tables.md",
       "description": "Database schema definitions with indexes and relationships",
       "applyTo": ["tables/*.xs"],
+      "priority": 8,
       "aliases": ["schema", "fields", "indexes"]
     },
     "functions": {
       "file": "functions.md",
       "description": "Reusable function stacks with inputs and responses",
       "applyTo": ["functions/**/*.xs"],
+      "priority": 6,
       "aliases": ["fn", "reusable", "stack"]
     },
     "apis": {
       "file": "apis.md",
       "description": "HTTP endpoint definitions with authentication and CRUD patterns",
       "applyTo": ["apis/**/*.xs"],
+      "priority": 7,
       "aliases": ["endpoints", "http", "rest", "query"]
     },
     "tasks": {
       "file": "tasks.md",
       "description": "Scheduled and cron jobs",
       "applyTo": ["tasks/*.xs"],
+      "priority": 10,
       "aliases": ["scheduled", "jobs", "cron"]
     },
     "triggers": {
       "file": "triggers.md",
       "description": "Event-driven handlers (table, realtime, workspace, agent, MCP)",
       "applyTo": ["triggers/**/*.xs"],
+      "priority": 10,
       "aliases": ["events", "hooks", "handlers"]
     },
     "database": {
@@ -89,18 +108,21 @@
       "file": "agents.md",
       "description": "AI agent configuration with LLM providers and tools",
       "applyTo": ["agents/**/*.xs"],
+      "priority": 12,
       "aliases": ["ai", "llm", "chatbot"]
     },
     "tools": {
       "file": "tools.md",
       "description": "AI tools for agents and MCP servers",
       "applyTo": ["tools/**/*.xs"],
+      "priority": 12,
       "aliases": ["ai-tools", "agent-tools"]
     },
     "mcp-servers": {
       "file": "mcp-servers.md",
       "description": "MCP server definitions exposing tools",
       "applyTo": ["mcp_servers/**/*.xs"],
+      "priority": 15,
       "aliases": ["mcp", "model-context-protocol"]
     },
     "unit-testing": {

package/dist/xanoscript_docs/essentials.md

@@ -52,15 +52,7 @@ var $api_response { value = "test" }
 
 XanoScript uses specific type names. Common aliases from other languages won't work.
 
-> **Full reference:** See `xanoscript_docs({ topic: "types" })` for complete type details and validation.
-
-| Wrong | Correct | Description |
-|-------|---------|-------------|
-| `boolean` | `bool` | Boolean true/false |
-| `integer` | `int` | 32-bit integer |
-| `string` | `text` | UTF-8 string |
-| `number` / `float` | `decimal` | Floating-point number |
-| `array` / `list` | `type[]` | Array (e.g., `text[]`, `int[]`) |
+> **Type names:** Use `text` (not string), `int` (not integer), `bool` (not boolean), `decimal` (not float). Full list: `xanoscript_docs({ topic: "types" })`
 
 ### Variable Declaration
 

package/dist/xanoscript_docs/frontend.md

@@ -4,7 +4,7 @@ applyTo: "static/**/*"
 
 # Frontend
 
-Static frontend development and Lovable/Supabase migration.
+Static frontend development with Xano APIs.
 
 ## Quick Reference
 
@@ -129,142 +129,6 @@ async function getCurrentUser() {
 
 ---
 
-## Lovable Migration
-
-Migrate from Supabase to Xano using the compatibility SDK.
-
-### 1. Install SDK
-```bash
-npm install @xano/supabase-compat
-```
-
-### 2. Create Xano Client
-```typescript
-// src/integrations/xano/client.ts
-import { createClient } from '@xano/supabase-compat';
-
-export const xano = createClient(
-  import.meta.env.VITE_XANO_URL,
-  import.meta.env.VITE_XANO_AUTH_ENDPOINT,
-  {
-    auth: {
-      storage: localStorage,
-      persistSession: true,
-      autoRefreshToken: true
-    }
-  }
-);
-```
-
-### 3. Update Environment
-```env
-VITE_XANO_URL=https://your-instance.xano.io
-VITE_XANO_AUTH_ENDPOINT=/api:groupId/auth
-```
-
-### 4. Update Auth Hooks
-
-Before (Supabase):
-```typescript
-import { supabase } from '@/integrations/supabase/client';
-
-supabase.auth.signInWithPassword({ email, password });
-supabase.auth.signUp({ email, password });
-supabase.auth.signOut();
-```
-
-After (Xano):
-```typescript
-import { xano } from '@/integrations/xano/client';
-
-xano.auth.signInWithPassword({ email, password });
-xano.auth.signUp({ email, password });
-xano.auth.signOut();
-```
-
-### 5. Update Data Hooks
-
-Before (Supabase):
-```typescript
-const { data, error } = await supabase
-  .from('products')
-  .select('*')
-  .eq('category', 'electronics')
-  .order('created_at', { ascending: false });
-```
-
-After (Xano):
-```typescript
-const { data, error } = await xano
-  .endpoint('/api:group/products')
-  .get({
-    category: 'electronics',
-    sort: 'created_at',
-    order: 'desc'
-  });
-```
-
----
-
-## Common Patterns
-
-### Pagination
-```javascript
-async function getProducts(page = 1, perPage = 20) {
-  return api.get(`/products?page=${page}&per_page=${perPage}`);
-}
-```
-
-### Filtering
-```javascript
-async function searchProducts(query, category) {
-  const params = new URLSearchParams();
-  if (query) params.append('query', query);
-  if (category) params.append('category', category);
-  return api.get(`/products?${params}`);
-}
-```
-
-### File Upload
-```javascript
-async function uploadImage(file) {
-  const formData = new FormData();
-  formData.append('image', file);
-
-  const response = await fetch(`${API_BASE}/upload`, {
-    method: 'POST',
-    headers: {
-      'Authorization': `Bearer ${localStorage.getItem('auth_token')}`
-    },
-    body: formData
-  });
-
-  return response.json();
-}
-```
-
----
-
-## Migration Checklist
-
-### Backend (Xano)
-- [ ] Create tables matching Supabase schema
-- [ ] Create CRUD endpoints for each resource
-- [ ] Set up authentication endpoints
-- [ ] Push changes: `push_all_changes_to_xano`
-- [ ] Get API specs: `get_xano_api_specifications`
-
-### Frontend
-- [ ] Install `@xano/supabase-compat`
-- [ ] Create Xano client
-- [ ] Update environment variables
-- [ ] Update auth hooks (minimal changes)
-- [ ] Update data fetching (table → endpoint)
-- [ ] Test all operations
-- [ ] Remove Supabase dependencies
-
----
-
 ## Deployment
 
 Deploy static files to Xano CDN:
@@ -285,7 +149,6 @@ The tool will:
 1. **Get API specs first** - Use `get_xano_api_specifications` before coding
 2. **Centralize API calls** - Single `api.js` file
 3. **Store tokens securely** - localStorage for web, secure storage for mobile
-4. **Test incrementally** - Migrate one feature at a time
 
 ---
 

package/dist/xanoscript_docs/functions.md

@@ -456,13 +456,9 @@ foreach ($items) {
 
 ## Best Practices
 
-1. **Single responsibility** - Each function does one thing well
-2. **Descriptive names** - Use verb_noun format: `calculate_total`, `validate_user`
-3. **Organize in folders** - Group related functions: `utils/`, `auth/`, `orders/`
-4. **Return early** - Use return for guard clauses
-5. **Keep stacks shallow** - Avoid deeply nested conditionals
-6. **Use group for organization** - Visually group related statements for readability
-7. **Use remove sparingly** - Consider filtering arrays instead
+1. **Organize in folders** - Group related functions in subfolders (`utils/`, `auth/`); call with `function.run "utils/format" { ... }`
+2. **Return early** - Use `return { value = ... }` for guard clauses to avoid deep nesting
+3. **Use `remove` sparingly** - Prefer `$items|filter:$$.condition` over in-loop `remove` for cleaner array filtering
 
 ---
 

package/dist/xanoscript_docs/mcp-servers.md

@@ -183,8 +183,7 @@ The MCP protocol handles:
 
 1. **Clear naming** - Server name should indicate its purpose
 2. **Comprehensive instructions** - Guide AI on server's overall purpose
-3. **Logical tool grouping** - Group related tools in one server
-4. **Keep focused** - One domain per server (support, analytics, etc.)
+3. **Logical tool grouping** - Group related tools in one server; one domain per server
 
 ---
 

package/dist/xanoscript_docs/middleware.md

@@ -303,6 +303,4 @@ 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
-4. **Log failures** - Even silent failures should be logged for debugging
-5. **Test independently** - Middleware should be testable in isolation
+3. **Consider performance** - Middleware runs on every request; log even silent failures