Skip to content

room215/limier

Repository files navigation

Limier logo

Limier

Limier is a fixture-based dependency behavior review tool. It compares a baseline package version with a candidate version, captures the behavior each one triggers in a controlled sample application, and turns the diff into one of four reviewer-facing outcomes:

  • good_to_go
  • needs_review
  • block
  • rerun

Limier is intentionally narrow. It is for suspicious or exploit-like dependency behavior such as new process execution, unexpected shelling out, changed install-time behavior, or other observable runtime drift. It is not a general application security scanner and it does not try to find SQLi, XSS, CSRF, or broad secure-coding flaws in the fixture itself.

Real host-signal capture is Linux-only and currently requires bpftrace. If capture_host_signals is enabled and Limier cannot start that backend, the run becomes inconclusive so process-coverage gaps are never hidden. On non-Linux systems, set capture_host_signals: false to use stdout/stderr-only comparison.

Documentation

The documentation in docs/ is the main entry point for setup and usage.

Quick Start

Run the repository-owned npm sample:

sh ./examples/ci/run-sample.sh

That sample uses:

  • fixture: fixtures/npm-app
  • scenario: scenarios/npm.yml
  • rules: rules/default.yml

The script writes:

  • out/limier/report.json
  • out/limier/summary.md
  • out/limier/build-summary.md
  • out/limier/evidence/

Development

Build and test with the standard Go toolchain:

go build ./...
go test ./...
go vet ./...
gofmt -w .

About

Limier is a fixture-based dependency behavior review tool. It compares a baseline package version with a candidate version, captures the behavior each one triggers in a controlled sample application, and turns the diff into one of four reviewer-facing outcomes

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages