ENGINEERING

License-Compliance Gate on New PR Dependencies

When a pull request changes a lockfile, this scans every newly added dependency for its license and posts a pass/fail compliance check back on the PR.

CategoryEngineering
Enginesim
Difficultyintermediate
Triggerevent
Steps5
Setup~15 min

How it runs

The automated pipeline, trigger to output.

  • TriggerPR opened or synchronizedGitHubGitHub
  • LogicDiff lockfile for newly added dependencies
  • ActionResolve each package's SPDX license from registryGitHubGitHub
  • LogicClassify licenses against allowlist
  • OutputPost commit status + summary comment on PRGitHubGitHub

What it does

Watches pull requests that touch a dependency manifest or lockfile, identifies the packages that are newly introduced, looks up each one's license, and decides whether the PR is safe to merge. The verdict is written back to GitHub as a status check so the merge button reflects compliance.

When to use it

Use it on any repo where you must keep GPL/AGPL or unlicensed code out of a proprietary product, and you want the check to run automatically on every dependency change instead of relying on a reviewer to eyeball `package.json`.

How it works

  1. 1A GitHub PR event fires when the PR is opened or its commits change.
  2. 2A logic step diffs the lockfile to extract only the dependencies that did not exist on the base branch.
  3. 3For each new package, an action queries the registry metadata to resolve its declared SPDX license.
  4. 4A logic step classifies each license against an allowlist (permissive = pass, copyleft/unknown = fail).
  5. 5The final step posts a GitHub commit status and a summary comment listing each package and its verdict, blocking merge on any failure.

Set it up

What you configure once, before turning it on.

  1. 1
    Connect GitHubRepos, issues, pull requests, actions.
  2. 2
    Set each agent's modelWe leave models unset so you pick the tier — fast + cheap, or top-quality.
  3. 3
    Tune it to your dataEdit the prompts, filters, and field mappings so it matches how your team works.
  4. 4
    Test, then turn it onRun once against a sample, confirm the output, then enable the trigger.

Run this workflow in your colony.

14-day trial. No DevOps. No Sales call. Provisioned in under a minute.