Repository navigation
v0.10.0
The first release under the Nephilex name. It contains the 0.9.0 security
hardening, the 0.9.2 fixes, which were never published, and the changes below.
Breaking changes
-
The project is now Nephilex. Everything that carries the product name
changed with it, with no aliases for the earlier names:- the PyPI package and the command are
nephilex, and the import package
isnephilex(plugins importnephilex.plugin_apiand register under the
nephilex.commandsentry-point group); - repository config is
.nephilex.ymland.nephilex/(rules, exceptions,
context, audit log), and the inline suppression comment is
nephilex-ignore; - environment variables use the
NEPHILEX_prefix (for example
NEPHILEX_CACHE_DIR,NEPHILEX_MCP_ROOTS,NEPHILEX_DASHBOARD_TOKEN); - the MCP server is registered as
nephilex, and its tools are
nephilex_scan,nephilex_check_filesand so on; - SARIF output carries the fingerprint as
nephilexFingerprint, so baselines
and code-scanning alerts made by earlier versions need to be regenerated; - the GitHub repository is
nephilex/nephilex, the Action is
nephilex/nephilex@<tag>, and the container image is
ghcr.io/nephilex/nephilex.
To upgrade, install
nephilex, rename the config file and directory,
update inline suppression comments, CI workflows and environment variables,
and rerunnephilex init --editorfor editor integrations. - the PyPI package and the command are
Added
- SARIF import.
nephilex import <file.sarif>andnephilex scan --import-sarif
read SARIF 2.1.0 from other scanners (CodeQL, Semgrep, Bandit and others),
map their results onto Nephilex findings, and run them through the same
baseline, suppression, policy and reporting steps as native findings. The
input is treated as untrusted: file size, nesting and result count are
capped, locations outside the project root are dropped, and snippets are
redacted before anything is stored. - Project context file.
.nephilex/context.ymldeclares the project's own
sanitizers and trusted sources (used by the taint engines), internal-only
paths, exposure levels and data classification, so findings are ranked
against how the code is really deployed. Validation is strict, and like the
rest of repository config it is read only from trusted projects. - Audit log.
.nephilex/audit.logis an append-only, hash-chained record of
scans, suppressions (including findings hidden by--baseline) and fixes.
Setaudit_log: falseto turn it off. - LLM and agent data flow. The LLM scanner parses Python with tree-sitter
to trace model output into dangerous sinks (LLM05), flag agents given
excessive tools (LLM06) and review system-prompt construction. Findings cite
OWASP Top 10 for LLM Applications 2025 ids. - Agent configuration scanner (
agent-config). Reviews MCP server
definitions and coding-agent settings for hardcoded credentials, servers
launched from unpinned packages, remote servers over plain HTTP, filesystem
access to/or a home directory, and settings that run tools without
confirmation. It runs in thedeepprofile. nephilex check. A fast, file-level check for editors and AI assistant
hooks, with--hookoutput for Claude Code and Cursor and
--no-inline-ignoresfor strict mode.- MCP tools. The MCP server adds
nephilex_check_files,nephilex_check_snippet,
nephilex_check_packageandnephilex_fixnext tonephilex_scan. nephilex init --editor claude|cursor|vscodewrites that editor's MCP and
hook configuration into the project.- Public benchmarks.
benchmarks/public/runs Nephilex, Bandit and Semgrep
on OWASP BenchmarkPython and SecurityEval and publishes the raw findings and
scores; seedocs/benchmarks.md. - Flow-sensitive Python taint engine. Branches, loops,
matchandtry
are analysed separately and joined; constant conditions prune dead code;
literal containers and simple early-return guards are understood. New
CWE-mapped sinks cover XSS, open redirect, XXE, LDAP and XPath injection,
trust-boundary violations, weak randomness for tokens, unsafe
deserialization and insecure cookies. - Findings report start and end columns, and snippets keep their indentation,
so editors can highlight the exact match. - Logo set and brand assets in
docs/assets/brand/.
Changed
- A scan of a git work tree skips untracked files that git ignores (build
output, virtual environments, local.envfiles). - Inline
nephilex-ignorecomments are recognised in--,<!-- -->and;
comment styles as well as#and//. - Deterministic fix patches are attached when AI is off, including by
nephilex check, so editors can offer the verified fix in place. - Reporters, model clients and HTTP libraries are imported on first use, so
the CLI starts faster. - The regex tier asks the taint engine about its payload, so
shell=True,
os.systemandpickle.loadson literal-only data are no longer reported.
Fixed
- Imported SARIF findings keep the tool's own fingerprints, so baselines stay
stable across runs. nephilex mcp --helplists every MCP tool.- A fresh
import nephilex.inventoryno longer fails on a circular import.