Skip to content

Clearwing 1.0.0

Latest

Choose a tag to compare

@github-actions github-actions released this 15 Apr 00:47
· 272 commits to main since this release

1.0.0 — 2026-04-14

First tagged release under the clearwing name. Covers the full
Phase 0–6 refactor that took the project from "works on my machine"
to a shippable release: rebrand from vulnexploit, shim demolition,
Finding-type unification, tools reorganization, graph hardening, full
CI gate, release-hygiene scaffolding, and MkDocs documentation site.

Added

  • Release hygiene scaffolding: SECURITY.md responsible-disclosure
    policy, CONTRIBUTING.md dev-setup and PR-checklist guide,
    CHANGELOG.md (this file), py.typed PEP 561 marker so downstream
    consumers get Clearwing's type information, dependabot.yml for
    pip + GitHub Actions (grouped weekly updates), .github/ISSUE_TEMPLATE/
    bug and feature templates with security-lane routing.
  • Docs site (MkDocs Material): docs/index.md, docs/quickstart.md,
    docs/architecture.md, docs/cli.md, docs/api.md (mkdocstrings
    autogen), docs/openglass.md (the Overwing design deep dive). Built
    with mkdocs build --strict, deployed to GitHub Pages via a paths-
    filter-gated workflow.
  • uv.lock — 4446-line lockfile pinning 154 packages against
    Python 3.12 for bit-for-bit reproducible dev environments via
    uv sync --all-extras.
  • Makefile with test / lint / type / build / clean / install-dev / gate / all / docs / docs-serve targets that mirror the CI gate
    exactly. make gate is the local mirror.
  • clearwing/capabilities.py — runtime detection of optional
    subsystems (guardrails, memory, telemetry, events, audit, knowledge)
    exposed as a capabilities.has(name) API. Replaces six
    try/except ImportError blocks in clearwing/agent/graph.py.
  • tests/test_tool_registry.py — snapshot test locking
    get_all_tools() at 63 tools with stable names and no duplicates,
    so tool reorgs can't silently drop coverage.
  • LICENSE file at the repo root (the project was MIT-declared in
    pyproject.toml but missing the file).

Changed

  • Package rebranded from vulnexploit to clearwing. The
    on-disk package, PyPI name, CLI command, logger names, DB/log
    file names, config paths, and GitHub repo URL all flipped in one
    atomic commit. Existing ~/.vulnexploit/ state on user machines
    will NOT carry over — Clearwing reads from ~/.clearwing/ and
    treats the old path as absent. Back up first if you need the old
    state. The new canonical remote is
    git@github.com:Lazarus-AI/clearwing.git.
  • Finding types unified. The sourcehunt SourceFinding TypedDict
    is gone, replaced by the clearwing.findings.Finding dataclass
    used across network and source-hunt pipelines. Two unrelated
    Finding classes renamed to eliminate the collision:
    clearwing/analysis/source_analyzer.py::Finding → AnalyzerFinding,
    clearwing/safety/scoring/dedup.py::Finding → DedupRecord. A
    transitional dict-style access shim on the Finding dataclass
    (__getitem__, __setitem__, get(), __contains__) keeps test
    fixtures that use dict literals working.
  • clearwing/agent/tools/ reorganized into seven domain
    subdirectories: scan/, exploit/, hunt/, recon/, ops/,
    data/, meta/. The top-level __init__.py is now a pure
    aggregator. get_all_tools() still returns the same 63 tools in
    the same order.
  • clearwing/agent/tools/hunt/hunter_tools.py (791-LOC god file)
    split into four focused files under hunt/: sandbox.py
    (HunterContext + variant routing, 105 LOC), discovery.py (4
    read-only FS probes, 226 LOC), analysis.py (4 sandboxed
    build/execute tools, 435 LOC), reporting.py (record_finding,
    85 LOC). Largest file in the subpackage is now 435 LOC, down from
    791. The hunt/__init__.py aggregator composes the four builders
    in the original tool order so the tool-registry snapshot stays
    green.
  • graph.py hardened: six try/except ImportError blocks that
    stored None on failure replaced with unconditional imports plus
    a capabilities.has(name) gate. Static analysis tools now see
    real symbols instead of Optional[None] fallbacks.
  • CI gate expanded: ruff check, ruff format --check, scoped
    mypy (findings + sourcehunt + capabilities + agent/tools + core),
    pytest -q --strict-markers --strict-config, python -m build,
    twine check — all six steps run on every push/PR across Python
    3.10, 3.11, 3.12.
  • Typed-core policy: disallow_untyped_defs = true +
    warn_unused_ignores = true enforced on clearwing.findings.*,
    clearwing.capabilities, clearwing.sourcehunt.*,
    clearwing.agent.tools.*, and clearwing.core.* — 68 source files
    at zero mypy errors. No # type: ignore[no-untyped-def]
    suppressions; every annotation is real.
  • README trimmed from 508 → 139 lines. Tagline, install,
    quickstart, architecture diagram, docs table, reporting lanes,
    license. Full detail moved to docs/.
  • All 22 deprecated shim packages deleted (vulnexploit.scanners,
    vulnexploit.exploiters, vulnexploit.payloads, and 19 others).
    Canonical paths under clearwing.scanning.*,
    clearwing.exploitation.*, etc. are the only way to import these
    modules. A DeprecationWarning-as-error filter in conftest.py
    locks the trunk against accidental re-introduction.

Fixed

  • ChatAnthropic(model=model) → ChatAnthropic(model_name=model)
    in clearwing/sourcehunt/runner.py::_build_llm_from_model_string.
    The model= kwarg was removed in recent langchain-anthropic; the
    old call site would have raised TypeError on first use of
    --model <name> on the sourcehunt CLI.
  • Variable-shadowing type confusion in sourcehunt/runner.py
    where for f in files (a FileTarget loop) leaked its narrowing
    into later for f in all_findings (a Finding loop). Loop variables
    renamed to disambiguate.
  • _walk_ast_for_taint signature in sourcehunt/taint.py falsely
    claimed source_text: str when the caller passed raw bytes on
    purpose (for tree-sitter byte offsets under multi-byte UTF-8 source).
    Signature now honestly declares bytes | str.
  • Evidence-ladder threshold types: adversarial_threshold,
    PATCH_GATE, and min_evidence_level across verifier.py,
    patcher.py, disclosure.py, and runner.py are now typed as
    the EvidenceLevel Literal[...] instead of plain str.
  • Implicit Optional cleanup: 23 param: X = None sites across
    core/*, agent/tools/* converted to param: X | None = None
    (mypy's no_implicit_optional default). Paired with 5 real
    arg-type mismatch fixes (ports or [], credentials or {},
    payload or "", wordlist or [], options or {}) where the
    downstream API required non-None.
  • EventBus._handlers / _lock instance attributes — the
    singleton stores them via __new__, which mypy doesn't pick up
    without explicit class-level declarations. Added them.
  • dynamic_tool_creator.py importlib.util.spec_from_file_location()
    returns ModuleSpec | None; added a guard that short-circuits to
    a structured failure response if the spec/loader are None instead
    of crashing on module_from_spec().
  • browser_tools.py _browser_state typed as dict[str, Any]
    with a local browser = binding in _ensure_browser so the
    chained .new_context(...) call type-checks.
  • Python 3.10–3.12 NameError in
    clearwing/scanning/os_scanner.py from a bare except pattern
    that 3.13 tolerated but earlier versions didn't.
  • 225 tracked __pycache__ files removed from git. A new
    .gitignore keeps them out for good.
  • Build backend in pyproject.toml fixed from the hallucinated
    setuptools.backends._legacy:_Backend to the real
    setuptools.build_meta. python -m build now produces a valid
    wheel + sdist.

Removed

  • vulnexploit package, CLI, module, and every reference. See
    the Changed section for migration notes.
  • hunter_tools.py (the 791-LOC god file) deleted in favor of
    the hunt/{sandbox,discovery,analysis,reporting}.py split.
  • .reference/ dangling gitlinks — 5 submodule pointers
    (cai, shannon, pentagi, PentestGPT, strix) that were started as
    submodules but never wired up with .gitmodules or
    .git/modules/. Dropped from the index with git rm --cached in
    a normal commit (no history rewrite was needed — the 857 MB lived
    in the operator's working tree, not in git history). Operators can
    still clone external projects into .reference/<name> locally;
    .gitignore covers the path.