@xano/developer-mcp 1.0.54 → 1.0.57

package/dist/xanoscript.test.js

@@ -1,7 +1,7 @@
 import { describe, it, expect } from "vitest";
 import { join, dirname } from "path";
 import { fileURLToPath } from "url";
-import { XANOSCRIPT_DOCS_V2, getDocsForFilePath, extractQuickReference, getXanoscriptDocsVersion, readXanoscriptDocsV2, getTopicNames, getTopicDescriptions, } from "./xanoscript.js";
+import { XANOSCRIPT_DOCS_V2, getDocsForFilePath, extractQuickReference, getXanoscriptDocsVersion, readXanoscriptDocsV2, readXanoscriptDocsStructured, getTopicNames, getTopicDescriptions, } from "./xanoscript.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 const DOCS_PATH = join(__dirname, "xanoscript_docs");
@@ -10,9 +10,11 @@ describe("xanoscript module", () => {
         it("should have all expected topics", () => {
             const expectedTopics = [
                 "readme",
-                "cheatsheet",
+                "essentials",
                 "syntax",
-                "quickstart",
+                "syntax/string-filters",
+                "syntax/array-filters",
+                "syntax/functions",
                 "types",
                 "tables",
                 "functions",
@@ -155,10 +157,10 @@ describe("xanoscript module", () => {
             const result = getDocsForFilePath("apis/test.xs");
             expect(result).not.toContain("readme");
         });
-        it("should include syntax and quickstart for .xs files", () => {
+        it("should include syntax and essentials for .xs files", () => {
             const result = getDocsForFilePath("some/random/file.xs");
             expect(result).toContain("syntax");
-            expect(result).toContain("quickstart");
+            expect(result).toContain("essentials");
         });
     });
     describe("extractQuickReference", () => {
@@ -296,24 +298,48 @@ Even more content.
         it("should support exclude_topics with file_path", () => {
             const result = readXanoscriptDocsV2(DOCS_PATH, {
                 file_path: "apis/users/create.xs",
-                exclude_topics: ["syntax", "quickstart"],
+                exclude_topics: ["syntax", "essentials"],
             });
             expect(result).toContain("Matched topics:");
             expect(result).not.toContain("Matched topics: syntax");
             // Verify excluded topics are not in the matched list
             const matchLine = result.split("\n").find((l) => l.startsWith("Matched topics:"));
             expect(matchLine).not.toContain("syntax");
-            expect(matchLine).not.toContain("quickstart");
+            expect(matchLine).not.toContain("essentials");
         });
         it("should throw when all topics are excluded via exclude_topics", () => {
             expect(() => readXanoscriptDocsV2(DOCS_PATH, {
                 file_path: "branch.xs",
-                exclude_topics: ["syntax", "cheatsheet", "quickstart", "debugging", "branch"],
+                exclude_topics: ["syntax", "essentials", "debugging", "branch"],
             })).toThrow("No documentation found");
         });
         it("should throw for invalid docs path", () => {
             expect(() => readXanoscriptDocsV2("/nonexistent/path", { topic: "syntax" })).toThrow();
         });
+        it("should return compact index with mode: index", () => {
+            const result = readXanoscriptDocsV2(DOCS_PATH, { mode: "index" });
+            expect(result).toContain("# XanoScript Documentation Index");
+            expect(result).toContain("Version:");
+            expect(result).toContain("Topics:");
+            expect(result).toContain("| Topic | Description | Size |");
+            // Should contain some known topics
+            expect(result).toContain("| syntax |");
+            expect(result).toContain("| essentials |");
+            expect(result).toContain("| database |");
+            // Should contain KB size indicators
+            expect(result).toContain("KB |");
+        });
+        it("should return index mode without requiring topic or file_path", () => {
+            const result = readXanoscriptDocsV2(DOCS_PATH, { mode: "index" });
+            // Index mode ignores topic/file_path — just returns the listing
+            expect(result).toContain("# XanoScript Documentation Index");
+        });
+        it("should return index that is significantly smaller than full docs", () => {
+            const index = readXanoscriptDocsV2(DOCS_PATH, { mode: "index" });
+            const full = readXanoscriptDocsV2(DOCS_PATH, { topic: "syntax", mode: "full" });
+            // Index should be compact — smaller than even a single full topic
+            expect(index.length).toBeLessThan(full.length);
+        });
     });
     describe("getTopicNames", () => {
         it("should return all topic names", () => {
@@ -345,4 +371,54 @@ Even more content.
             expect(descriptions).toContain("Expressions, operators");
         });
     });
+    describe("readXanoscriptDocsStructured", () => {
+        it("should return array of TopicDoc objects", () => {
+            const result = readXanoscriptDocsStructured(DOCS_PATH, {
+                file_path: "apis/users/create.xs",
+            });
+            expect(Array.isArray(result)).toBe(true);
+            expect(result.length).toBeGreaterThan(0);
+            for (const doc of result) {
+                expect(doc).toHaveProperty("topic");
+                expect(doc).toHaveProperty("content");
+                expect(typeof doc.topic).toBe("string");
+                expect(typeof doc.content).toBe("string");
+            }
+        });
+        it("should match the same topics as getDocsForFilePath", () => {
+            const filePath = "apis/users/create.xs";
+            const expected = getDocsForFilePath(filePath);
+            const result = readXanoscriptDocsStructured(DOCS_PATH, { file_path: filePath });
+            const resultTopics = result.map((d) => d.topic);
+            expect(resultTopics).toEqual(expected);
+        });
+        it("should respect exclude_topics", () => {
+            const result = readXanoscriptDocsStructured(DOCS_PATH, {
+                file_path: "apis/users/create.xs",
+                exclude_topics: ["syntax", "essentials"],
+            });
+            const topics = result.map((d) => d.topic);
+            expect(topics).not.toContain("syntax");
+            expect(topics).not.toContain("essentials");
+        });
+        it("should throw when all topics are excluded", () => {
+            expect(() => readXanoscriptDocsStructured(DOCS_PATH, {
+                file_path: "branch.xs",
+                exclude_topics: ["syntax", "essentials", "debugging", "branch"],
+            })).toThrow("No documentation found");
+        });
+        it("should use quick_reference mode by default", () => {
+            const quickResult = readXanoscriptDocsStructured(DOCS_PATH, {
+                file_path: "tables/users.xs",
+            });
+            const fullResult = readXanoscriptDocsStructured(DOCS_PATH, {
+                file_path: "tables/users.xs",
+                mode: "full",
+            });
+            // Quick reference content should be shorter than full
+            const quickTotal = quickResult.reduce((sum, d) => sum + d.content.length, 0);
+            const fullTotal = fullResult.reduce((sum, d) => sum + d.content.length, 0);
+            expect(quickTotal).toBeLessThanOrEqual(fullTotal);
+        });
+    });
 });

package/dist/xanoscript_docs/README.md

@@ -111,7 +111,7 @@ $db.table.field     // Database field reference (in queries)
 $this               // Current item in loops/maps
 ```
 
-**Reserved Variables:** The following cannot be used as variable names: `$response`, `$output`, `$input`, `$auth`, `$env`, `$db`, `$this`, `$result`, `$index`.
+**Reserved Variables:** The following cannot be used as variable names: `$response`, `$output`, `$input`, `$auth`, `$env`, `$db`, `$this`, `$result`, `$index`. See `xanoscript_docs({ topic: "essentials" })` for detailed variable access rules.
 
 ### Type Names
 
@@ -162,7 +162,7 @@ This helps AI tools apply the correct documentation based on the file being edit
 
 For common patterns and quick examples, use:
 ```
-xanoscript_docs({ topic: "quickstart" })
+xanoscript_docs({ topic: "essentials" })
 ```
 
 This includes:
@@ -182,8 +182,8 @@ Use `xanoscript_docs({ topic: "<topic>" })` to retrieve documentation.
 
 | Topic        | Description                                          | Key Sections |
 | ------------ | ---------------------------------------------------- | ------------ |
-| `quickstart` | Common patterns, quick examples, mistakes to avoid   | Patterns, Common Mistakes |
-| `syntax`     | Expressions, operators, filters, system variables    | Filters (L179-275), Error Handling (L411-477) |
+| `essentials` | Common patterns, quick examples, mistakes to avoid   | Patterns, Common Mistakes |
+| `syntax`     | Expressions, operators, filters, system variables    | Filters, Error Handling |
 | `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 |
@@ -193,7 +193,7 @@ Use `xanoscript_docs({ topic: "<topic>" })` to retrieve documentation.
 | Topic       | Description                                                | Key Sections |
 | ----------- | ---------------------------------------------------------- | ------------ |
 | `tables`    | Database schema definitions with indexes and relationships | Indexes, Foreign Keys |
-| `database`  | All db.\* operations: query, get, add, edit, patch, delete | Decision Tree (L11), Bulk Ops (L450-529) |
+| `database`  | All db.\* operations: query, get, add, edit, patch, delete | Decision Tree, Bulk Ops |
 | `addons`    | Reusable subqueries for fetching related data              | Usage Patterns |
 | `streaming` | Streaming data from files, requests, and responses         | File Streams, API Streams |
 
@@ -201,7 +201,7 @@ Use `xanoscript_docs({ topic: "<topic>" })` to retrieve documentation.
 
 | Topic      | Description                                                     | Key Sections |
 | ---------- | --------------------------------------------------------------- | ------------ |
-| `apis`     | HTTP endpoint definitions with authentication and CRUD patterns | Decision Tree (L9), CRUD Examples (L220-350) |
+| `apis`     | HTTP endpoint definitions with authentication and CRUD patterns | Decision Tree, CRUD Examples |
 | `tasks`    | Scheduled and cron jobs                                         | Cron Syntax, Input Handling |
 | `triggers` | Event-driven handlers (table, realtime, workspace, agent, MCP)  | Predefined Inputs, Event Types |
 | `realtime` | Real-time channels and events for push updates                  | Channels, Events |
@@ -287,4 +287,4 @@ function "call_external_api" {
 }
 ```
 
-For more patterns, see `xanoscript_docs({ topic: "quickstart" })` or `xanoscript_docs({ topic: "integrations" })`.
+For more patterns, see `xanoscript_docs({ topic: "essentials" })` or `xanoscript_docs({ topic: "integrations" })`.

package/dist/xanoscript_docs/cheatsheet.md

@@ -112,7 +112,10 @@ db.edit "user" {
 }
 
 // Delete record
-db.del "user" { field_name = "id", field_value = $input.user_id }
+db.del "user" {
+  field_name = "id"
+  field_value = $input.user_id
+}
 ```
 
 ### API Requests

package/dist/xanoscript_docs/database.md

@@ -613,7 +613,7 @@ try_catch {
     conditional {
       if ($error.name == "DeadlockError") {
         // Retry logic
-        util.sleep { value = 100 }
+        util.sleep { value = 1 }                // value = seconds
         function.run "retry_transaction" { input = $input }
       }
       else {
@@ -646,6 +646,6 @@ Explore more with `xanoscript_docs({ topic: "<topic>" })`:
 |-------|-------------|
 | `tables` | Database schema definitions with indexes and relationships |
 | `syntax` | Query filters, operators, and expressions |
-| `quickstart` | Common CRUD patterns and examples |
+| `essentials` | Common CRUD patterns and examples |
 | `addons` | Reusable subqueries for fetching related data |
 | `performance` | Query optimization best practices |

package/dist/xanoscript_docs/docs_index.json

@@ -3,145 +3,225 @@
   "description": "Machine-readable index for XanoScript documentation",
 
   "topics": {
-    "cheatsheet": {
-      "file": "cheatsheet.md",
-      "purpose": "Quick reference for 20 most common operations",
-      "priority": 1,
-      "aliases": ["quick", "common", "basics", "start"]
+    "readme": {
+      "file": "README.md",
+      "description": "XanoScript overview, workspace structure, and quick reference",
+      "applyTo": [],
+      "aliases": ["overview", "intro", "index"]
     },
-    "quickstart": {
-      "file": "quickstart.md",
-      "purpose": "Common patterns and mistakes to avoid",
-      "priority": 2,
-      "aliases": ["start", "getting-started", "patterns", "mistakes"]
+    "essentials": {
+      "file": "essentials.md",
+      "description": "Common patterns, quick reference, and common mistakes to avoid",
+      "applyTo": ["**/*.xs"],
+      "priority": 1,
+      "aliases": ["quick", "common", "basics", "start", "cheatsheet", "quickstart", "patterns", "mistakes"]
     },
     "syntax": {
       "file": "syntax.md",
-      "purpose": "Operators, filters, expressions, error handling",
-      "priority": 3,
+      "description": "Expressions, operators, and filters for all XanoScript code",
+      "applyTo": ["**/*.xs"],
+      "priority": 2,
       "aliases": ["filters", "operators", "expressions"]
     },
+    "syntax/string-filters": {
+      "file": "syntax/string-filters.md",
+      "description": "String filters, regex, encoding, security filters, text functions",
+      "applyTo": [],
+      "aliases": ["string", "regex", "encoding", "security-filters"]
+    },
+    "syntax/array-filters": {
+      "file": "syntax/array-filters.md",
+      "description": "Array filters, functional operations, and array functions",
+      "applyTo": [],
+      "aliases": ["array", "map", "filter", "reduce", "sort"]
+    },
+    "syntax/functions": {
+      "file": "syntax/functions.md",
+      "description": "Math filters/functions, object functions, bitwise operations",
+      "applyTo": [],
+      "aliases": ["math", "object", "bitwise"]
+    },
     "types": {
       "file": "types.md",
-      "purpose": "Data types, validation, input blocks",
+      "description": "Data types, input blocks, and validation",
+      "applyTo": ["functions/**/*.xs", "apis/**/*.xs", "tools/**/*.xs", "agents/**/*.xs"],
       "priority": 4,
       "aliases": ["validation", "input", "data-types"]
     },
-    "database": {
-      "file": "database.md",
-      "purpose": "All db.* operations",
-      "priority": 5,
-      "aliases": ["db", "crud", "query", "sql"]
-    },
     "tables": {
       "file": "tables.md",
-      "purpose": "Table schema definitions",
+      "description": "Database schema definitions with indexes and relationships",
+      "applyTo": ["tables/*.xs"],
       "aliases": ["schema", "fields", "indexes"]
     },
+    "functions": {
+      "file": "functions.md",
+      "description": "Reusable function stacks with inputs and responses",
+      "applyTo": ["functions/**/*.xs"],
+      "aliases": ["fn", "reusable", "stack"]
+    },
     "apis": {
       "file": "apis.md",
-      "purpose": "HTTP endpoint definitions",
+      "description": "HTTP endpoint definitions with authentication and CRUD patterns",
+      "applyTo": ["apis/**/*.xs"],
       "aliases": ["endpoints", "http", "rest", "query"]
     },
-    "functions": {
-      "file": "functions.md",
-      "purpose": "Reusable function stacks",
-      "aliases": ["fn", "reusable", "stack"]
+    "tasks": {
+      "file": "tasks.md",
+      "description": "Scheduled and cron jobs",
+      "applyTo": ["tasks/*.xs"],
+      "aliases": ["scheduled", "jobs", "cron"]
     },
     "triggers": {
       "file": "triggers.md",
-      "purpose": "Event-driven handlers",
+      "description": "Event-driven handlers (table, realtime, workspace, agent, MCP)",
+      "applyTo": ["triggers/**/*.xs"],
       "aliases": ["events", "hooks", "handlers"]
     },
+    "database": {
+      "file": "database.md",
+      "description": "All db.* operations: query, get, add, edit, patch, delete",
+      "applyTo": ["functions/**/*.xs", "apis/**/*.xs", "tasks/*.xs", "tools/**/*.xs"],
+      "priority": 5,
+      "aliases": ["db", "crud", "query", "sql"]
+    },
     "agents": {
       "file": "agents.md",
-      "purpose": "AI agent configuration",
+      "description": "AI agent configuration with LLM providers and tools",
+      "applyTo": ["agents/**/*.xs"],
       "aliases": ["ai", "llm", "chatbot"]
     },
     "tools": {
       "file": "tools.md",
-      "purpose": "AI tools for agents",
+      "description": "AI tools for agents and MCP servers",
+      "applyTo": ["tools/**/*.xs"],
       "aliases": ["ai-tools", "agent-tools"]
     },
+    "mcp-servers": {
+      "file": "mcp-servers.md",
+      "description": "MCP server definitions exposing tools",
+      "applyTo": ["mcp_servers/**/*.xs"],
+      "aliases": ["mcp", "model-context-protocol"]
+    },
+    "unit-testing": {
+      "file": "unit-testing.md",
+      "description": "Unit tests, mocks, and assertions within functions, APIs, and middleware",
+      "applyTo": ["functions/**/*.xs", "apis/**/*.xs", "middleware/**/*.xs"],
+      "aliases": ["tests", "unit-tests", "mocks", "assertions"]
+    },
+    "workflow-tests": {
+      "file": "workflow-tests.md",
+      "description": "End-to-end workflow tests with data source selection and tags",
+      "applyTo": ["workflow_test/**/*.xs"],
+      "aliases": ["e2e", "workflow", "integration-tests"]
+    },
     "integrations": {
       "file": "integrations.md",
-      "purpose": "External service integrations (index)",
+      "description": "External service integrations index - see sub-topics for details",
+      "applyTo": [],
       "aliases": ["external", "services", "cloud"]
     },
     "integrations/cloud-storage": {
       "file": "integrations/cloud-storage.md",
-      "purpose": "AWS S3, Azure Blob, GCP Storage",
+      "description": "AWS S3, Azure Blob, and GCP Storage operations",
+      "applyTo": [],
       "aliases": ["s3", "azure", "gcp", "files", "upload"]
     },
     "integrations/search": {
       "file": "integrations/search.md",
-      "purpose": "Elasticsearch, Algolia",
+      "description": "Elasticsearch, OpenSearch, and Algolia search operations",
+      "applyTo": [],
       "aliases": ["elasticsearch", "algolia", "full-text"]
     },
     "integrations/redis": {
       "file": "integrations/redis.md",
-      "purpose": "Caching, rate limiting, queues",
+      "description": "Redis caching, rate limiting, and queue operations",
+      "applyTo": [],
       "aliases": ["cache", "rate-limit", "queue"]
     },
     "integrations/external-apis": {
       "file": "integrations/external-apis.md",
-      "purpose": "api.request patterns",
+      "description": "HTTP requests with api.request patterns",
+      "applyTo": [],
       "aliases": ["http", "api", "request", "fetch"]
     },
     "integrations/utilities": {
       "file": "integrations/utilities.md",
-      "purpose": "Email, Zip, Lambda",
+      "description": "Local storage, email, zip, and Lambda utilities",
+      "applyTo": [],
       "aliases": ["email", "zip", "lambda", "archive"]
     },
-    "security": {
-      "file": "security.md",
-      "purpose": "Authentication, authorization, security patterns",
-      "aliases": ["auth", "authorization", "permissions"]
+    "frontend": {
+      "file": "frontend.md",
+      "description": "Static frontend development and deployment",
+      "applyTo": ["static/**/*"],
+      "aliases": ["static", "html", "css", "web"]
+    },
+    "run": {
+      "file": "run.md",
+      "description": "Run job and service configurations for the Xano Job Runner",
+      "applyTo": ["run/**/*.xs"],
+      "aliases": ["jobs", "runner", "services"]
+    },
+    "addons": {
+      "file": "addons.md",
+      "description": "Reusable subqueries for fetching related data",
+      "applyTo": ["addons/*.xs"],
+      "aliases": ["subqueries", "relations"]
+    },
+    "debugging": {
+      "file": "debugging.md",
+      "description": "Logging, inspecting, and debugging XanoScript execution",
+      "applyTo": ["**/*.xs"],
+      "aliases": ["logs", "debug", "trace"]
     },
     "performance": {
       "file": "performance.md",
-      "purpose": "Optimization best practices",
+      "description": "Performance optimization best practices",
+      "applyTo": ["functions/**/*.xs", "apis/**/*.xs"],
       "aliases": ["optimization", "speed", "caching"]
     },
-    "mcp-servers": {
-      "file": "mcp-servers.md",
-      "purpose": "MCP server configuration",
-      "aliases": ["mcp", "model-context-protocol"]
+    "realtime": {
+      "file": "realtime.md",
+      "description": "Real-time channels and events for push updates",
+      "applyTo": ["triggers/**/*.xs"],
+      "aliases": ["websocket", "channels", "pubsub"]
     },
-    "tasks": {
-      "file": "tasks.md",
-      "purpose": "Scheduled job definitions",
-      "aliases": ["scheduled", "jobs", "cron"]
+    "schema": {
+      "file": "schema.md",
+      "description": "Runtime schema parsing and validation",
+      "applyTo": [],
+      "aliases": ["runtime-schema", "parsing"]
+    },
+    "security": {
+      "file": "security.md",
+      "description": "Security best practices for authentication and authorization",
+      "applyTo": ["functions/**/*.xs", "apis/**/*.xs"],
+      "aliases": ["auth", "authorization", "permissions"]
     },
     "streaming": {
       "file": "streaming.md",
-      "purpose": "Streaming data handling",
+      "description": "Streaming data from files, requests, and responses",
+      "applyTo": [],
       "aliases": ["stream", "large-files"]
     },
-    "realtime": {
-      "file": "realtime.md",
-      "purpose": "Real-time channel configuration",
-      "aliases": ["websocket", "channels", "pubsub"]
-    },
     "middleware": {
       "file": "middleware.md",
-      "purpose": "Request interceptors",
+      "description": "Request/response interceptors for functions, queries, tasks, and tools",
+      "applyTo": ["middleware/**/*.xs"],
       "aliases": ["interceptors", "hooks"]
     },
-    "unit-testing": {
-      "file": "unit-testing.md",
-      "purpose": "Unit tests, mocks, and assertions",
-      "aliases": ["tests", "unit-tests", "mocks", "assertions"]
-    },
-    "workflow-tests": {
-      "file": "workflow-tests.md",
-      "purpose": "End-to-end workflow tests",
-      "aliases": ["e2e", "workflow", "integration-tests"]
+    "branch": {
+      "file": "branch.md",
+      "description": "Branch-level settings: middleware, history retention, visual styling",
+      "applyTo": ["branch.xs"],
+      "aliases": ["settings", "config"]
     },
-    "debugging": {
-      "file": "debugging.md",
-      "purpose": "Logging and debugging",
-      "aliases": ["logs", "debug", "trace"]
+    "workspace": {
+      "file": "workspace.md",
+      "description": "Workspace-level settings: environment variables, preferences, realtime",
+      "applyTo": ["workspace/**/*.xs"],
+      "aliases": ["env", "environment", "preferences"]
     }
   },
 
@@ -220,46 +300,44 @@
     "function.run": { "file": "functions.md" },
     "redis.get": { "file": "integrations/redis.md" },
     "redis.set": { "file": "integrations/redis.md" },
-    "storage.s3_put": { "file": "integrations/cloud-storage.md" },
-    "storage.s3_get": { "file": "integrations/cloud-storage.md" },
-    "array.push": { "file": "syntax.md" },
-    "array.pop": { "file": "syntax.md" },
-    "array.shift": { "file": "syntax.md" },
-    "array.unshift": { "file": "syntax.md" },
-    "array.merge": { "file": "syntax.md" },
-    "array.find": { "file": "syntax.md" },
-    "array.find_index": { "file": "syntax.md" },
-    "array.has": { "file": "syntax.md" },
-    "array.every": { "file": "syntax.md" },
-    "array.filter": { "file": "syntax.md" },
-    "array.filter_count": { "file": "syntax.md" },
-    "array.map": { "file": "syntax.md" },
-    "array.partition": { "file": "syntax.md" },
-    "array.group_by": { "file": "syntax.md" },
-    "array.union": { "file": "syntax.md" },
-    "array.difference": { "file": "syntax.md" },
-    "array.intersection": { "file": "syntax.md" },
-    "text.contains": { "file": "syntax.md" },
-    "text.icontains": { "file": "syntax.md" },
-    "text.starts_with": { "file": "syntax.md" },
-    "text.istarts_with": { "file": "syntax.md" },
-    "text.ends_with": { "file": "syntax.md" },
-    "text.iends_with": { "file": "syntax.md" },
-    "text.trim": { "file": "syntax.md" },
-    "text.ltrim": { "file": "syntax.md" },
-    "text.rtrim": { "file": "syntax.md" },
-    "text.append": { "file": "syntax.md" },
-    "text.prepend": { "file": "syntax.md" },
-    "math.add": { "file": "syntax.md" },
-    "math.sub": { "file": "syntax.md" },
-    "math.mul": { "file": "syntax.md" },
-    "math.div": { "file": "syntax.md" },
-    "math.bitwise.and": { "file": "syntax.md" },
-    "math.bitwise.or": { "file": "syntax.md" },
-    "math.bitwise.xor": { "file": "syntax.md" },
-    "object.keys": { "file": "syntax.md" },
-    "object.values": { "file": "syntax.md" },
-    "object.entries": { "file": "syntax.md" },
+    "array.push": { "file": "syntax/array-filters.md" },
+    "array.pop": { "file": "syntax/array-filters.md" },
+    "array.shift": { "file": "syntax/array-filters.md" },
+    "array.unshift": { "file": "syntax/array-filters.md" },
+    "array.merge": { "file": "syntax/array-filters.md" },
+    "array.find": { "file": "syntax/array-filters.md" },
+    "array.find_index": { "file": "syntax/array-filters.md" },
+    "array.has": { "file": "syntax/array-filters.md" },
+    "array.every": { "file": "syntax/array-filters.md" },
+    "array.filter": { "file": "syntax/array-filters.md" },
+    "array.filter_count": { "file": "syntax/array-filters.md" },
+    "array.map": { "file": "syntax/array-filters.md" },
+    "array.partition": { "file": "syntax/array-filters.md" },
+    "array.group_by": { "file": "syntax/array-filters.md" },
+    "array.union": { "file": "syntax/array-filters.md" },
+    "array.difference": { "file": "syntax/array-filters.md" },
+    "array.intersection": { "file": "syntax/array-filters.md" },
+    "text.contains": { "file": "syntax/string-filters.md" },
+    "text.icontains": { "file": "syntax/string-filters.md" },
+    "text.starts_with": { "file": "syntax/string-filters.md" },
+    "text.istarts_with": { "file": "syntax/string-filters.md" },
+    "text.ends_with": { "file": "syntax/string-filters.md" },
+    "text.iends_with": { "file": "syntax/string-filters.md" },
+    "text.trim": { "file": "syntax/string-filters.md" },
+    "text.ltrim": { "file": "syntax/string-filters.md" },
+    "text.rtrim": { "file": "syntax/string-filters.md" },
+    "text.append": { "file": "syntax/string-filters.md" },
+    "text.prepend": { "file": "syntax/string-filters.md" },
+    "math.add": { "file": "syntax/functions.md" },
+    "math.sub": { "file": "syntax/functions.md" },
+    "math.mul": { "file": "syntax/functions.md" },
+    "math.div": { "file": "syntax/functions.md" },
+    "math.bitwise.and": { "file": "syntax/functions.md" },
+    "math.bitwise.or": { "file": "syntax/functions.md" },
+    "math.bitwise.xor": { "file": "syntax/functions.md" },
+    "object.keys": { "file": "syntax/functions.md" },
+    "object.values": { "file": "syntax/functions.md" },
+    "object.entries": { "file": "syntax/functions.md" },
     "redis.remove": { "file": "integrations/redis.md" },
     "redis.keys": { "file": "integrations/redis.md" },
     "security.jwe_encode": { "file": "security.md" },
@@ -297,7 +375,7 @@
     "authentication": ["security.md", "apis.md"],
     "authorization": ["security.md"],
     "rate_limiting": ["security.md", "integrations/redis.md"],
-    "error_handling": ["syntax.md", "quickstart.md"],
+    "error_handling": ["syntax.md", "essentials.md"],
     "pagination": ["database.md", "apis.md"],
     "file_upload": ["integrations/cloud-storage.md", "streaming.md"],
     "caching": ["performance.md", "integrations/redis.md"],