n8n-nodes-workflow-ops 0.1.0

package/README.md

@@ -0,0 +1,37 @@
+# n8n-nodes-workflow-ops
+
+Workflow Ops proof node for n8n.
+
+This package is a small community-node proof asset for Workflow Ops Desk. It demonstrates that we can structure, test, package, and publish an n8n community node without claiming paid client history.
+
+## What It Does
+
+The `Workflow Ops` node has three operations:
+
+- `Normalize Lead`: turns common lead fields into a consistent object.
+- `Score Lead`: produces a simple automation-lead score from payment, scope, and urgency signals.
+- `Build Reply Draft`: drafts a short, truthful first response for a small workflow-support lead.
+
+## Why This Exists
+
+Some buyers ask for proof that a contractor has shipped or packaged n8n community-node work. This repository is a transparent proof package, not a client case study. It is useful as a starting point for small n8n node work, workflow triage, and proposal demonstrations.
+
+## Local Checks
+
+```bash
+npm install
+npm test
+npm run build
+npm pack --dry-run
+```
+
+## Publishing Notes
+
+n8n community nodes are npm packages. The package follows the visible community-node requirements:
+
+- package name starts with `n8n-nodes-`,
+- package keywords include `n8n-community-node-package`,
+- package `n8n.nodes` points to the compiled node,
+- a GitHub Actions publish workflow is included for provenance-ready publishing.
+
+Publishing to npm requires an npm account and package publishing permissions. No paid plan is required.

package/dist/nodes/WorkflowOps/WorkflowOps.node.d.ts

@@ -0,0 +1,5 @@
+import type { IExecuteFunctions, INodeExecutionData, INodeType, INodeTypeDescription } from "n8n-workflow";
+export declare class WorkflowOps implements INodeType {
+    description: INodeTypeDescription;
+    execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]>;
+}

package/dist/nodes/WorkflowOps/WorkflowOps.node.js

@@ -0,0 +1,220 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowOps = void 0;
+class WorkflowOps {
+    description = {
+        displayName: "Workflow Ops",
+        name: "workflowOps",
+        icon: "file:workflowOps.svg",
+        group: ["transform"],
+        version: 1,
+        description: "Normalize automation leads, score intent, and draft concise replies.",
+        defaults: {
+            name: "Workflow Ops",
+        },
+        inputs: ["main"],
+        outputs: ["main"],
+        properties: [
+            {
+                displayName: "Operation",
+                name: "operation",
+                type: "options",
+                noDataExpression: true,
+                options: [
+                    {
+                        name: "Normalize Lead",
+                        value: "normalizeLead",
+                        description: "Create a normalized lead object from common fields",
+                        action: "Normalize a lead",
+                    },
+                    {
+                        name: "Score Lead",
+                        value: "scoreLead",
+                        description: "Score a lead from payment, scope, and urgency signals",
+                        action: "Score a lead",
+                    },
+                    {
+                        name: "Build Reply Draft",
+                        value: "buildReplyDraft",
+                        description: "Create a short, truthful proposal reply draft",
+                        action: "Build a reply draft",
+                    },
+                ],
+                default: "normalizeLead",
+            },
+            {
+                displayName: "Title",
+                name: "title",
+                type: "string",
+                default: "",
+                displayOptions: {
+                    show: {
+                        operation: ["normalizeLead"],
+                    },
+                },
+            },
+            {
+                displayName: "Source",
+                name: "source",
+                type: "string",
+                default: "",
+                displayOptions: {
+                    show: {
+                        operation: ["normalizeLead"],
+                    },
+                },
+            },
+            {
+                displayName: "URL",
+                name: "url",
+                type: "string",
+                default: "",
+                displayOptions: {
+                    show: {
+                        operation: ["normalizeLead"],
+                    },
+                },
+            },
+            {
+                displayName: "Notes",
+                name: "notes",
+                type: "string",
+                typeOptions: {
+                    rows: 4,
+                },
+                default: "",
+                displayOptions: {
+                    show: {
+                        operation: ["normalizeLead"],
+                    },
+                },
+            },
+            {
+                displayName: "Payment Fit",
+                name: "paymentFit",
+                type: "number",
+                default: 0,
+                typeOptions: {
+                    minValue: 0,
+                    maxValue: 10,
+                },
+                displayOptions: {
+                    show: {
+                        operation: ["scoreLead"],
+                    },
+                },
+            },
+            {
+                displayName: "Scope Fit",
+                name: "scopeFit",
+                type: "number",
+                default: 0,
+                typeOptions: {
+                    minValue: 0,
+                    maxValue: 10,
+                },
+                displayOptions: {
+                    show: {
+                        operation: ["scoreLead"],
+                    },
+                },
+            },
+            {
+                displayName: "Urgency Fit",
+                name: "urgencyFit",
+                type: "number",
+                default: 0,
+                typeOptions: {
+                    minValue: 0,
+                    maxValue: 10,
+                },
+                displayOptions: {
+                    show: {
+                        operation: ["scoreLead"],
+                    },
+                },
+            },
+            {
+                displayName: "Lead",
+                name: "lead",
+                type: "string",
+                default: "",
+                displayOptions: {
+                    show: {
+                        operation: ["buildReplyDraft"],
+                    },
+                },
+            },
+            {
+                displayName: "Problem",
+                name: "problem",
+                type: "string",
+                typeOptions: {
+                    rows: 4,
+                },
+                default: "",
+                displayOptions: {
+                    show: {
+                        operation: ["buildReplyDraft"],
+                    },
+                },
+            },
+            {
+                displayName: "Proof Link",
+                name: "proofLink",
+                type: "string",
+                default: "https://github.com/ErenYeagerr/workflow-ops-desk",
+                displayOptions: {
+                    show: {
+                        operation: ["buildReplyDraft"],
+                    },
+                },
+            },
+        ],
+    };
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        for (let itemIndex = 0; itemIndex < items.length; itemIndex += 1) {
+            const operation = this.getNodeParameter("operation", itemIndex);
+            if (operation === "normalizeLead") {
+                returnData.push({
+                    json: {
+                        title: this.getNodeParameter("title", itemIndex),
+                        source: this.getNodeParameter("source", itemIndex),
+                        url: this.getNodeParameter("url", itemIndex),
+                        notes: this.getNodeParameter("notes", itemIndex),
+                        status: "new",
+                    },
+                    pairedItem: { item: itemIndex },
+                });
+                continue;
+            }
+            if (operation === "scoreLead") {
+                const paymentFit = Number(this.getNodeParameter("paymentFit", itemIndex));
+                const scopeFit = Number(this.getNodeParameter("scopeFit", itemIndex));
+                const urgencyFit = Number(this.getNodeParameter("urgencyFit", itemIndex));
+                const score = Math.min(100, Math.round(paymentFit * 4 + scopeFit * 4 + urgencyFit * 2));
+                returnData.push({
+                    json: {
+                        score,
+                        recommendation: score >= 82 ? "ready" : score >= 68 ? "diagnostic_reply" : "watch",
+                    },
+                    pairedItem: { item: itemIndex },
+                });
+                continue;
+            }
+            const lead = this.getNodeParameter("lead", itemIndex);
+            const problem = this.getNodeParameter("problem", itemIndex);
+            const proofLink = this.getNodeParameter("proofLink", itemIndex);
+            returnData.push({
+                json: {
+                    reply: `Hi - I can help with ${lead}. I would start by checking ${problem}, then send a small fixed-scope plan before touching production. Proof/workbench: ${proofLink}`,
+                },
+                pairedItem: { item: itemIndex },
+            });
+        }
+        return [returnData];
+    }
+}
+exports.WorkflowOps = WorkflowOps;

package/dist/nodes/WorkflowOps/workflowOps.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Workflow Ops">
+  <rect width="64" height="64" rx="10" fill="#1f6feb"/>
+  <path fill="#ffffff" d="M18 20h18v8H18zm0 16h28v8H18zm27-18 7 6-7 6v-4h-6v-4h6zm-8 16 7 6-7 6v-4h-6v-4h6z"/>
+</svg>

package/nodes/WorkflowOps/WorkflowOps.node.ts

@@ -0,0 +1,231 @@
+import type {
+  IExecuteFunctions,
+  INodeExecutionData,
+  INodeType,
+  INodeTypeDescription,
+} from "n8n-workflow"
+
+export class WorkflowOps implements INodeType {
+  description: INodeTypeDescription = {
+    displayName: "Workflow Ops",
+    name: "workflowOps",
+    icon: "file:workflowOps.svg",
+    group: ["transform"],
+    version: 1,
+    description: "Normalize automation leads, score intent, and draft concise replies.",
+    defaults: {
+      name: "Workflow Ops",
+    },
+    inputs: ["main"],
+    outputs: ["main"],
+    properties: [
+      {
+        displayName: "Operation",
+        name: "operation",
+        type: "options",
+        noDataExpression: true,
+        options: [
+          {
+            name: "Normalize Lead",
+            value: "normalizeLead",
+            description: "Create a normalized lead object from common fields",
+            action: "Normalize a lead",
+          },
+          {
+            name: "Score Lead",
+            value: "scoreLead",
+            description: "Score a lead from payment, scope, and urgency signals",
+            action: "Score a lead",
+          },
+          {
+            name: "Build Reply Draft",
+            value: "buildReplyDraft",
+            description: "Create a short, truthful proposal reply draft",
+            action: "Build a reply draft",
+          },
+        ],
+        default: "normalizeLead",
+      },
+      {
+        displayName: "Title",
+        name: "title",
+        type: "string",
+        default: "",
+        displayOptions: {
+          show: {
+            operation: ["normalizeLead"],
+          },
+        },
+      },
+      {
+        displayName: "Source",
+        name: "source",
+        type: "string",
+        default: "",
+        displayOptions: {
+          show: {
+            operation: ["normalizeLead"],
+          },
+        },
+      },
+      {
+        displayName: "URL",
+        name: "url",
+        type: "string",
+        default: "",
+        displayOptions: {
+          show: {
+            operation: ["normalizeLead"],
+          },
+        },
+      },
+      {
+        displayName: "Notes",
+        name: "notes",
+        type: "string",
+        typeOptions: {
+          rows: 4,
+        },
+        default: "",
+        displayOptions: {
+          show: {
+            operation: ["normalizeLead"],
+          },
+        },
+      },
+      {
+        displayName: "Payment Fit",
+        name: "paymentFit",
+        type: "number",
+        default: 0,
+        typeOptions: {
+          minValue: 0,
+          maxValue: 10,
+        },
+        displayOptions: {
+          show: {
+            operation: ["scoreLead"],
+          },
+        },
+      },
+      {
+        displayName: "Scope Fit",
+        name: "scopeFit",
+        type: "number",
+        default: 0,
+        typeOptions: {
+          minValue: 0,
+          maxValue: 10,
+        },
+        displayOptions: {
+          show: {
+            operation: ["scoreLead"],
+          },
+        },
+      },
+      {
+        displayName: "Urgency Fit",
+        name: "urgencyFit",
+        type: "number",
+        default: 0,
+        typeOptions: {
+          minValue: 0,
+          maxValue: 10,
+        },
+        displayOptions: {
+          show: {
+            operation: ["scoreLead"],
+          },
+        },
+      },
+      {
+        displayName: "Lead",
+        name: "lead",
+        type: "string",
+        default: "",
+        displayOptions: {
+          show: {
+            operation: ["buildReplyDraft"],
+          },
+        },
+      },
+      {
+        displayName: "Problem",
+        name: "problem",
+        type: "string",
+        typeOptions: {
+          rows: 4,
+        },
+        default: "",
+        displayOptions: {
+          show: {
+            operation: ["buildReplyDraft"],
+          },
+        },
+      },
+      {
+        displayName: "Proof Link",
+        name: "proofLink",
+        type: "string",
+        default: "https://github.com/ErenYeagerr/workflow-ops-desk",
+        displayOptions: {
+          show: {
+            operation: ["buildReplyDraft"],
+          },
+        },
+      },
+    ],
+  }
+
+  async execute(this: IExecuteFunctions): Promise<INodeExecutionData[][]> {
+    const items = this.getInputData()
+    const returnData: INodeExecutionData[] = []
+
+    for (let itemIndex = 0; itemIndex < items.length; itemIndex += 1) {
+      const operation = this.getNodeParameter("operation", itemIndex) as string
+
+      if (operation === "normalizeLead") {
+        returnData.push({
+          json: {
+            title: this.getNodeParameter("title", itemIndex) as string,
+            source: this.getNodeParameter("source", itemIndex) as string,
+            url: this.getNodeParameter("url", itemIndex) as string,
+            notes: this.getNodeParameter("notes", itemIndex) as string,
+            status: "new",
+          },
+          pairedItem: { item: itemIndex },
+        })
+        continue
+      }
+
+      if (operation === "scoreLead") {
+        const paymentFit = Number(this.getNodeParameter("paymentFit", itemIndex))
+        const scopeFit = Number(this.getNodeParameter("scopeFit", itemIndex))
+        const urgencyFit = Number(this.getNodeParameter("urgencyFit", itemIndex))
+        const score = Math.min(100, Math.round(paymentFit * 4 + scopeFit * 4 + urgencyFit * 2))
+
+        returnData.push({
+          json: {
+            score,
+            recommendation: score >= 82 ? "ready" : score >= 68 ? "diagnostic_reply" : "watch",
+          },
+          pairedItem: { item: itemIndex },
+        })
+        continue
+      }
+
+      const lead = this.getNodeParameter("lead", itemIndex) as string
+      const problem = this.getNodeParameter("problem", itemIndex) as string
+      const proofLink = this.getNodeParameter("proofLink", itemIndex) as string
+
+      returnData.push({
+        json: {
+          reply: `Hi - I can help with ${lead}. I would start by checking ${problem}, then send a small fixed-scope plan before touching production. Proof/workbench: ${proofLink}`,
+        },
+        pairedItem: { item: itemIndex },
+      })
+    }
+
+    return [returnData]
+  }
+}

package/nodes/WorkflowOps/workflowOps.svg

@@ -0,0 +1,4 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="Workflow Ops">
+  <rect width="64" height="64" rx="10" fill="#1f6feb"/>
+  <path fill="#ffffff" d="M18 20h18v8H18zm0 16h28v8H18zm27-18 7 6-7 6v-4h-6v-4h6zm-8 16 7 6-7 6v-4h-6v-4h6z"/>
+</svg>

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "n8n-nodes-workflow-ops",
+  "version": "0.1.0",
+  "description": "Workflow Ops proof node for normalizing automation leads and drafting replies in n8n.",
+  "license": "MIT",
+  "author": "Christian",
+  "homepage": "https://github.com/ErenYeagerr/workflow-ops-desk",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ErenYeagerr/workflow-ops-desk.git",
+    "directory": "proof/n8n-nodes-workflow-ops"
+  },
+  "bugs": {
+    "url": "https://github.com/ErenYeagerr/workflow-ops-desk/issues"
+  },
+  "main": "dist/nodes/WorkflowOps/WorkflowOps.node.js",
+  "types": "dist/nodes/WorkflowOps/WorkflowOps.node.d.ts",
+  "files": [
+    "dist",
+    "nodes",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-assets.mjs",
+    "lint": "node --check scripts/copy-assets.mjs",
+    "test": "node --test test/*.test.mjs",
+    "pack:check": "npm pack --dry-run"
+  },
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "automation",
+    "workflow-ops"
+  ],
+  "n8n": {
+    "nodes": [
+      "dist/nodes/WorkflowOps/WorkflowOps.node.js"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.30",
+    "n8n-workflow": "^1.96.0",
+    "typescript": "^5.8.3"
+  }
+}