feat(typescript-recipes): add parallel-procurement-n8n recipe#37
Draft
s-jag wants to merge 2 commits into
Draft
Conversation
Continuous vendor risk monitoring built on the Parallel Task and Monitor APIs, orchestrated by n8n, with Slack-routed alerts and a cited audit log. - One combined n8n workflow (50 nodes) covering vendor sync, daily Deep Research via Task Groups, V1 event-stream monitors, deterministic risk scoring, Slack severity routing, and an /vendor-research slash command. - 46 Vitest suites covering services, models, workflow JSON structure, full pipeline integration, vendor lifecycle, error scenarios, and scale simulation (200 / 3000 vendors). - Optional Next.js + Supabase BYOK dashboard reimplementing the same business logic for users who would rather not run n8n. - Registered in README.md (Scheduled Research & Webhooks) and website/cookbook.json per CONTRIBUTING.md. Co-authored from the n8n-procurement folder of shapleyai/parallel-integrations-and-demos.
The auth/key route returned "Parallel rejected this key" before the email lookup, so a valid Parallel key with a wrong email produced a different error than an invalid key — a credential-stuffing recon oracle. Defer reporting the Parallel-test failure until after the account lookup so both branches return the same generic "Email or Parallel API key is incorrect" 401. Add tests covering both bad-key/known-email and bad-key/unknown-email paths.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a new recipe under
typescript-recipes/parallel-procurement-n8n/— continuous vendor risk monitoring built on the Parallel Task and Monitor APIs, orchestrated by n8n, with Slack-routed alerts and a cited audit log. Slots into the Scheduled Research & Webhooks category next toparallel-daily-insights.What's in the recipe:
/vendor-researchslash command.output.basislift-through — every assessment and Slack alert carries the top citation per dimension, and the audit log writestop_citation_url/top_citation_title/confidenceper row.DEPLOY.md.Registered in both indexes per
CONTRIBUTING.md:README.mdunder Scheduled Research & Webhooks.website/cookbook.json(slugparallel-procurement-n8n).Why draft
Submitting as draft because a few items from the cookbook quality bar are still TODO:
system-architecture.excalidrawand friends); will export a PNG intodocs/for the README.creatorsfield incookbook.json— currently["sahith-3694"]; tell me if it should be a different handle.PR Checklist (
CONTRIBUTING.md)npm ci && npm test→ 629 passed).env/.dev.varscommitted —pre-commit runpasses (detect-private-key,gitleaks,forbid-env-files)\$vars.PARALLEL_API_KEYand{{ \$env.SLACK_WEBHOOK_URL }}placeholders; dashboard reads everything from envdashboard/vercel.json)package-lock.jsonat root and indashboard/)README.mdandwebsite/cookbook.jsonTest plan
README.mdtable row andcookbook.jsonentry againstcookbook.schema.jsonnpm ci && npm testinsidetypescript-recipes/parallel-procurement-n8n/