Skip to content

v0.10.0

Choose a tag to compare

@hasipfaruk hasipfaruk released this 23 Oct 04:59
· 150 commits to main since this release
5063564

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
      is nephilex (plugins import nephilex.plugin_api and register under the
      nephilex.commands entry-point group);
    • repository config is .nephilex.yml and .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_files and 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 rerun nephilex init --editor for editor integrations.

Added

  • SARIF import. nephilex import <file.sarif> and nephilex 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.yml declares 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.log is an append-only, hash-chained record of
    scans, suppressions (including findings hidden by --baseline) and fixes.
    Set audit_log: false to 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 the deep profile.
  • nephilex check. A fast, file-level check for editors and AI assistant
    hooks, with --hook output for Claude Code and Cursor and
    --no-inline-ignores for strict mode.
  • MCP tools. The MCP server adds nephilex_check_files, nephilex_check_snippet,
    nephilex_check_package and nephilex_fix next to nephilex_scan.
  • nephilex init --editor claude|cursor|vscode writes 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; see docs/benchmarks.md.
  • Flow-sensitive Python taint engine. Branches, loops, match and try
    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 .env files).
  • Inline nephilex-ignore comments 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.system and pickle.loads on 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 --help lists every MCP tool.
  • A fresh import nephilex.inventory no longer fails on a circular import.