chore: add pre-built dist folder for npx usage

dist/mappers/docs-mapper.d.ts

@@ -0,0 +1,7 @@
+export declare class DocsMapper {
+    private docsPath;
+    private readonly KNOWN_FIXES;
+    fetchDocumentation(nodeType: string): Promise<string | null>;
+    private enhanceLoopNodeDocumentation;
+}
+//# sourceMappingURL=docs-mapper.d.ts.map

dist/mappers/docs-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-mapper.d.ts","sourceRoot":"","sources":["../../src/mappers/docs-mapper.ts"],"names":[],"mappings":"AAGA,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAwC;IAGxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAU1B;IAEI,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAkDlE,OAAO,CAAC,4BAA4B;CAmDrC"}

dist/mappers/docs-mapper.js

@@ -0,0 +1,106 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocsMapper = void 0;
+const fs_1 = require("fs");
+const path_1 = __importDefault(require("path"));
+class DocsMapper {
+    constructor() {
+        this.docsPath = path_1.default.join(process.cwd(), 'n8n-docs');
+        this.KNOWN_FIXES = {
+            'httpRequest': 'httprequest',
+            'code': 'code',
+            'webhook': 'webhook',
+            'respondToWebhook': 'respondtowebhook',
+            'n8n-nodes-base.httpRequest': 'httprequest',
+            'n8n-nodes-base.code': 'code',
+            'n8n-nodes-base.webhook': 'webhook',
+            'n8n-nodes-base.respondToWebhook': 'respondtowebhook'
+        };
+    }
+    async fetchDocumentation(nodeType) {
+        const fixedType = this.KNOWN_FIXES[nodeType] || nodeType;
+        const nodeName = fixedType.split('.').pop()?.toLowerCase();
+        if (!nodeName) {
+            console.log(`⚠️  Could not extract node name from: ${nodeType}`);
+            return null;
+        }
+        console.log(`📄 Looking for docs for: ${nodeType} -> ${nodeName}`);
+        const possiblePaths = [
+            `docs/integrations/builtin/core-nodes/n8n-nodes-base.${nodeName}.md`,
+            `docs/integrations/builtin/app-nodes/n8n-nodes-base.${nodeName}.md`,
+            `docs/integrations/builtin/trigger-nodes/n8n-nodes-base.${nodeName}.md`,
+            `docs/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.${nodeName}.md`,
+            `docs/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.${nodeName}.md`,
+            `docs/integrations/builtin/core-nodes/n8n-nodes-base.${nodeName}/index.md`,
+            `docs/integrations/builtin/app-nodes/n8n-nodes-base.${nodeName}/index.md`,
+            `docs/integrations/builtin/trigger-nodes/n8n-nodes-base.${nodeName}/index.md`,
+            `docs/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.${nodeName}/index.md`,
+            `docs/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.${nodeName}/index.md`
+        ];
+        for (const relativePath of possiblePaths) {
+            try {
+                const fullPath = path_1.default.join(this.docsPath, relativePath);
+                let content = await fs_1.promises.readFile(fullPath, 'utf-8');
+                console.log(`  ✓ Found docs at: ${relativePath}`);
+                content = this.enhanceLoopNodeDocumentation(nodeType, content);
+                return content;
+            }
+            catch (error) {
+                continue;
+            }
+        }
+        console.log(`  ✗ No docs found for ${nodeName}`);
+        return null;
+    }
+    enhanceLoopNodeDocumentation(nodeType, content) {
+        if (nodeType.includes('splitInBatches')) {
+            const outputGuidance = `
+
+## CRITICAL OUTPUT CONNECTION INFORMATION
+
+**⚠️ OUTPUT INDICES ARE COUNTERINTUITIVE ⚠️**
+
+The SplitInBatches node has TWO outputs with specific indices:
+- **Output 0 (index 0) = "done"**: Receives final processed data when loop completes
+- **Output 1 (index 1) = "loop"**: Receives current batch data during iteration
+
+### Correct Connection Pattern:
+1. Connect nodes that PROCESS items inside the loop to **Output 1 ("loop")**
+2. Connect nodes that run AFTER the loop completes to **Output 0 ("done")**
+3. The last processing node in the loop must connect back to the SplitInBatches node
+
+### Common Mistake:
+AI assistants often connect these backwards because the logical flow (loop first, then done) doesn't match the technical indices (done=0, loop=1).
+
+`;
+            const insertPoint = content.indexOf('## When to use');
+            if (insertPoint > -1) {
+                content = content.slice(0, insertPoint) + outputGuidance + content.slice(insertPoint);
+            }
+            else {
+                content = outputGuidance + '\n' + content;
+            }
+        }
+        if (nodeType.includes('.if')) {
+            const outputGuidance = `
+
+## Output Connection Information
+
+The IF node has TWO outputs:
+- **Output 0 (index 0) = "true"**: Items that match the condition
+- **Output 1 (index 1) = "false"**: Items that do not match the condition
+
+`;
+            const insertPoint = content.indexOf('## Node parameters');
+            if (insertPoint > -1) {
+                content = content.slice(0, insertPoint) + outputGuidance + content.slice(insertPoint);
+            }
+        }
+        return content;
+    }
+}
+exports.DocsMapper = DocsMapper;
+//# sourceMappingURL=docs-mapper.js.map

dist/mappers/docs-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs-mapper.js","sourceRoot":"","sources":["../../src/mappers/docs-mapper.ts"],"names":[],"mappings":"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"}