@lhi/n8m 0.1.0

package/dist/utils/theme.js

@@ -0,0 +1,92 @@
+import chalk from 'chalk';
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+let tokens;
+const rootPath = join(__dirname, '../../');
+const tokensPath = join(rootPath, 'design-tokens.json');
+try {
+    if (existsSync(tokensPath)) {
+        tokens = JSON.parse(readFileSync(tokensPath, 'utf-8'));
+    }
+    else {
+        throw new Error('Tokens file not found');
+    }
+}
+catch {
+    // Fallback tokens matching the user's file
+    tokens = {
+        colors: {
+            primary: { value: '#10B981' },
+            secondary: { value: '#6366F1' },
+            background: { value: '#0F172A' },
+            foreground: { value: '#F1F5F9' },
+            mutedForeground: { value: '#94A3B8' },
+            card: { value: '#1E293B' },
+            semantic: {
+                success: { value: '#10B981' },
+                warning: { value: '#F59E0B' },
+                error: { value: '#EF4444' },
+                aiProcessing: { value: '#A855F7' },
+            },
+        },
+    };
+}
+const c = {
+    primary: chalk.hex(tokens.colors.primary.value),
+    secondary: chalk.hex(tokens.colors.secondary.value),
+    muted: chalk.hex(tokens.colors.mutedForeground.value),
+    foreground: chalk.hex(tokens.colors.foreground.value),
+    success: chalk.hex(tokens.colors.semantic.success.value),
+    warning: chalk.hex(tokens.colors.semantic.warning.value),
+    error: chalk.hex(tokens.colors.semantic.error.value),
+    ai: chalk.hex(tokens.colors.semantic.aiProcessing.value),
+    card: chalk.hex(tokens.colors.card.value),
+};
+export const theme = {
+    ...c,
+    // Layout helpers
+    divider: (len = 60) => c.muted('━'.repeat(len)),
+    header: (text) => {
+        return `\n${c.primary.bold('◆ ' + text)}\n${c.muted('━'.repeat(text.length + 4))}`;
+    },
+    subHeader: (text) => {
+        return `\n${c.secondary.bold(text)}`;
+    },
+    // Field styling
+    label: (text) => c.secondary(text.padEnd(15)),
+    value: (text) => c.foreground(text.toString()),
+    // Semantic status
+    info: (text) => c.primary('ℹ ') + c.foreground(text),
+    done: (text) => c.success('✔ ') + c.foreground(text),
+    warn: (text) => c.warning('⚠ ') + c.foreground(text),
+    fail: (text) => c.error('✘ ') + c.foreground(text),
+    // AI/Agentic
+    agent: (text) => c.ai('✧ ') + c.ai.italic(text),
+    // Brand/Banner
+    brand: () => {
+        const bannerPath = join(rootPath, 'banner.txt');
+        if (existsSync(bannerPath)) {
+            const banner = readFileSync(bannerPath, 'utf-8');
+            const lines = banner.split('\n');
+            // Calculate a smoother line-by-line gradient between secondary and primary
+            // Secondary: Indigo, Primary: Emerald
+            return lines.map((line, i) => {
+                if (!line.trim())
+                    return '';
+                const ratio = i / Math.max(lines.length - 1, 1);
+                // Simple interpolation between #6366F1 and #10B981
+                // We'll use 3 steps for simplicity given it's line based
+                if (ratio < 0.33)
+                    return c.secondary(line);
+                if (ratio < 0.66)
+                    return chalk.hex('#3A90B9')(line); // Midpoint between Indigo and Emerald
+                return c.primary(line);
+            }).join('\n');
+        }
+        return c.primary.bold('N8M CLI');
+    },
+    // Badge/Tag
+    tag: (text) => chalk.bgHex(tokens.colors.primary.value).hex(tokens.colors.background.value).bold(` ${text} `)
+};

package/oclif.manifest.json

@@ -0,0 +1,331 @@
+{
+  "commands": {
+    "config": {
+      "aliases": [],
+      "args": {},
+      "description": "Manage n8m configuration",
+      "flags": {
+        "n8n-url": {
+          "description": "Set n8n Instance URL",
+          "name": "n8n-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "n8n-key": {
+          "description": "Set n8n API Key",
+          "name": "n8n-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ai-key": {
+          "description": "Set AI API Key (used for all AI features)",
+          "name": "ai-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ai-provider": {
+          "description": "Set AI provider (openai, anthropic, gemini)",
+          "name": "ai-provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ai-model": {
+          "description": "Set AI model name (e.g. gpt-4o, claude-sonnet-4-6)",
+          "name": "ai-model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "ai-base-url": {
+          "description": "Set custom AI base URL (for OpenAI-compatible endpoints)",
+          "name": "ai-base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "config",
+      "pluginAlias": "@lhi/n8m",
+      "pluginName": "@lhi/n8m",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "config.js"
+      ]
+    },
+    "create": {
+      "aliases": [],
+      "args": {
+        "description": {
+          "description": "Natural language description of the workflow",
+          "name": "description",
+          "required": false
+        }
+      },
+      "description": "Generate n8n workflows from natural language using Gemini AI Agent",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> \"Send a telegram alert when I receive an email\"",
+        "echo \"Slack to Discord sync\" | <%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --output ./my-workflow.json"
+      ],
+      "flags": {
+        "deploy": {
+          "char": "d",
+          "description": "Deploy the generated workflow to n8n instance (Not yet fully integrated with agent)",
+          "hidden": true,
+          "name": "deploy",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "output": {
+          "char": "o",
+          "description": "Path to save the generated workflow JSON",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "multiline": {
+          "char": "m",
+          "description": "Open editor for multiline workflow description",
+          "name": "multiline",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "create",
+      "pluginAlias": "@lhi/n8m",
+      "pluginName": "@lhi/n8m",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "create.js"
+      ]
+    },
+    "deploy": {
+      "aliases": [],
+      "args": {
+        "workflow": {
+          "description": "Path to the workflow file or workflow ID",
+          "name": "workflow",
+          "required": true
+        }
+      },
+      "description": "Push workflows to n8n instance via API",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> ./workflows/slack-notifier.json"
+      ],
+      "flags": {
+        "instance": {
+          "char": "i",
+          "description": "n8n instance name (from config)",
+          "name": "instance",
+          "default": "production",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "activate": {
+          "char": "a",
+          "description": "Activate workflow after deployment",
+          "name": "activate",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "deploy",
+      "pluginAlias": "@lhi/n8m",
+      "pluginName": "@lhi/n8m",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "deploy.js"
+      ]
+    },
+    "modify": {
+      "aliases": [],
+      "args": {
+        "workflow": {
+          "description": "Path or Name of the workflow to modify",
+          "name": "workflow",
+          "required": false
+        },
+        "instruction": {
+          "description": "Modification instructions",
+          "name": "instruction",
+          "required": false
+        }
+      },
+      "description": "Modify existing n8n workflows using Gemini AI Agent",
+      "flags": {
+        "multiline": {
+          "char": "m",
+          "description": "Open editor for multiline modification instructions",
+          "name": "multiline",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "output": {
+          "char": "o",
+          "description": "Path to save the modified workflow JSON (defaults to overwriting if local file)",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "modify",
+      "pluginAlias": "@lhi/n8m",
+      "pluginName": "@lhi/n8m",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "modify.js"
+      ]
+    },
+    "prune": {
+      "aliases": [],
+      "args": {},
+      "description": "Deduplicate workflows on the instance",
+      "flags": {
+        "force": {
+          "char": "f",
+          "description": "Force delete without confirmation",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "dry-run": {
+          "char": "d",
+          "description": "Show what would be deleted",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "prune",
+      "pluginAlias": "@lhi/n8m",
+      "pluginName": "@lhi/n8m",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "prune.js"
+      ]
+    },
+    "resume": {
+      "aliases": [],
+      "args": {
+        "threadId": {
+          "description": "The Thread ID of the session to resume",
+          "name": "threadId",
+          "required": true
+        }
+      },
+      "description": "Resume a paused/interrupted agentic workflow",
+      "flags": {},
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "resume",
+      "pluginAlias": "@lhi/n8m",
+      "pluginName": "@lhi/n8m",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "resume.js"
+      ]
+    },
+    "test": {
+      "aliases": [],
+      "args": {
+        "workflow": {
+          "description": "Path to workflow JSON file",
+          "name": "workflow",
+          "required": false
+        }
+      },
+      "description": "Run ephemeral end-to-end tests for n8n workflows",
+      "flags": {
+        "headless": {
+          "char": "h",
+          "description": "Run tests in headless mode",
+          "name": "headless",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "keep-on-fail": {
+          "description": "Do not delete workflow if test fails",
+          "name": "keep-on-fail",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "no-brand": {
+          "description": "Suppress branding header",
+          "hidden": true,
+          "name": "no-brand",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "validate-only": {
+          "description": "Execute test but do not prompt for deploy/save actions",
+          "hidden": true,
+          "name": "validate-only",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "test",
+      "pluginAlias": "@lhi/n8m",
+      "pluginName": "@lhi/n8m",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "test.js"
+      ]
+    }
+  },
+  "version": "0.1.0"
+}

package/package.json

@@ -0,0 +1,95 @@
+{
+  "name": "@lhi/n8m",
+  "version": "0.1.0",
+  "description": "Agentic n8n CLI wrapper - A Skill Bridge for n8n workflow automation",
+  "author": "n8m",
+  "bin": {
+    "n8m": "./bin/run.js"
+  },
+  "homepage": "https://github.com/lcanady/n8m",
+  "main": "dist/index.js",
+  "type": "module",
+  "exports": "./dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "bin",
+    "dist",
+    "oclif.manifest.json"
+  ],
+  "dependencies": {
+    "openai": "^4.0.0",
+    "@langchain/core": "^1.1.18",
+    "@langchain/langgraph": "^1.1.2",
+    "@langchain/langgraph-checkpoint-sqlite": "^1.0.0",
+    "@oclif/core": "^4",
+    "@oclif/plugin-help": "^6",
+    "@oclif/plugin-plugins": "^5",
+    "@types/inquirer": "^9.0.9",
+    "chalk": "^5.3.0",
+    "cli-progress": "^3.12.0",
+    "dotenv": "^17.2.3",
+    "ink": "^6.6.0",
+    "ink-gradient": "^3.0.0",
+    "ink-link": "^5.0.0",
+    "ink-markdown": "^1.0.4",
+    "ink-multiline-input": "^0.1.0",
+    "ink-spinner": "^5.0.0",
+    "ink-text-input": "^6.0.0",
+    "inquirer": "^13.2.2",
+    "react": "^19.2.4"
+  },
+  "devDependencies": {
+    "@oclif/prettier-config": "^0.2.1",
+    "@oclif/test": "^4",
+    "@types/chai": "^5",
+    "@types/cli-progress": "^3.11.6",
+    "@types/mocha": "^10",
+    "@types/node": "^22.19.7",
+    "@types/react": "^19.2.10",
+    "chai": "^5",
+    "eslint": "^9",
+    "eslint-config-oclif": "^6",
+    "eslint-config-oclif-typescript": "^3",
+    "mocha": "^10",
+    "oclif": "^4",
+    "shx": "^0.3.4",
+    "ts-node": "^10",
+    "tsx": "^4.21.0",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "oclif": {
+    "bin": "n8m",
+    "dirname": "n8m",
+    "commands": "./dist/commands",
+    "plugins": [
+      "@oclif/plugin-help",
+      "@oclif/plugin-plugins"
+    ],
+    "topicSeparator": " ",
+    "topics": {
+      "create": {
+        "description": "Generate or modify n8n workflows"
+      },
+      "deploy": {
+        "description": "Push workflows to n8n instance"
+      },
+      "test": {
+        "description": "Run end-to-end workflow tests"
+      }
+    }
+  },
+  "scripts": {
+    "build": "shx rm -rf dist && tsc -b",
+    "lint": "eslint .",
+    "postpack": "shx rm -f oclif.manifest.json",
+    "posttest": "npm run lint",
+    "prepack": "oclif manifest && oclif readme",
+    "test": "mocha --forbid-only \"test/**/*.test.ts\"",
+    "n8m": "./bin/run.js",
+    "dev": "tsc -b -w",
+    "version": "oclif readme && git add README.md"
+  }
+}