n8n-nodes-dng

Official n8n community node pack for the DraftNGoal exam. Install it in your own n8n, build a workflow with native n8n nodes on the canvas, and submit it to the official scoring webhook hosted on the DraftNGoal n8n cloud — your score and detailed feedback come back as the node's output.

The pack ships:

• DNG Submit Level — submits your workflow graph (node type, parameters, connections) to the scorer.
• DNG Scoring Webhook credential — URL, cohort shared secret, personal exam token.
• A sanitized challenge catalogue (challenges/): description, suggested node types (available_node_types), time limit, sanitized step blueprint. The reference solutions and grading rubrics are never shipped with this package.

v3.x expects native n8n node types in submissions. Upgrade to n8n-nodes-dng ≥ 3.0.0 so the cloud accepts your runs.

Quick start (Docker)

git clone https://github.com/voltek62/n8n-nodes-dng.git
cd n8n-nodes-dng

# 1. Build the community node pack (DNG Submit Level + credential)
(cd nodes-dng && npm install && npm run build)

# 2. Boot a local n8n that auto-loads the pack
docker compose up -d

# 3. Open n8n and finish the owner setup
open http://localhost:5678

Wire your candidate workflow

1. In n8n → Credentials → + New → search DNG Scoring Webhook, then fill:

   • Webhook URL: keep the default https://draftngoal.app.n8n.cloud/webhook/dng-score.
   • Shared secret: cohort secret — sent to you by email after you sign up at https://dng.ai.
   • Exam token (per candidate): personal token — also sent by email.

2. Create a workflow using standard n8n nodes:

   Manual Trigger (or Webhook)
       └── Your native n8n nodes …
              └── DNG Submit Level

3. In DNG Submit Level, pick a challenge from the dropdown, fill your name and email, then Execute workflow.

4. The node returns the JSON response from the cloud:

   {
     "ok": true,
     "audit_id": "…",
     "challenge_id": "quick-summarize",
     "overall_score": 92.5,
     "passed": true,
     "criteria_scores": [ … ],
     "step_results": [ … ],
     "grading_decisions": [ … ]
   }

   The same payload is also emailed to DraftNGoal admins for audit.

Available challenges

The candidate-facing catalogue is in challenges/index.json. Browse the per-challenge description and step blueprint in challenges/<id>.json — the reference solution is not in those files. It lives only on the DraftNGoal cloud.

| id | difficulty | duration | |----|------------|---------:| | quick-summarize | Easy | 10 min | | lead-routing | Intermediate | 20 min | | research-agent | Expert | 45 min |

Install via the n8n Community Nodes UI (alternative)

If you run n8n cloud or a self-hosted n8n that allows community nodes:

1. Settings → Community nodes → Install → enter n8n-nodes-dng.
2. Confirm the install. DNG Submit Level appears after reload.
3. Configure the DNG Scoring Webhook credential (same fields as above).

Repository layout

.
├── nodes-dng/             # the published npm package (n8n-nodes-dng)
│   ├── nodes/             # DNG Submit Level only
│   ├── credentials/       # DNG Scoring Webhook credential type
│   ├── challenges/        # sanitized public catalogue (no answers)
│   └── scripts/           # challenge sanitizer
├── docker-compose.yml     # local n8n for candidates
├── .github/               # CI, release, dependabot, issue templates
├── LICENSE                # MIT
├── SECURITY.md
└── CODE_OF_CONDUCT.md

The server/ directory used by the maintainer (full challenges + scoring workflow + auth wrapper) is gitignored and never published. Only DraftNGoal operates that side, on n8n cloud at https://draftngoal.app.n8n.cloud.

Build & test the pack locally (contributors)

cd nodes-dng
npm install
npm run build      # sanitize challenges + tsc
npm run lint       # type-check
npm pack --dry-run # see what gets shipped to npm

Support

• General questions / billing / score appeals: [email protected].
• Public bugs and feature requests: GitHub issues here.
• Security: see SECURITY.md.

License

MIT © Vincent Terrasi / DraftNGoal.