Metadata-Version: 2.4
Name: witnis
Version: 1.11.2
Summary: witnis-dev: PR-gate evidence for coding agents (blast-radius, gated verify). Not affiliated with Witnis AB.
Author: Witnis contributors
License: Apache-2.0
Project-URL: Homepage, https://github.com/L00PLeGeNd/Witnis
Project-URL: Issues, https://github.com/L00PLeGeNd/Witnis/issues
Keywords: witnis-dev,mcp,code-intelligence,verification,evidence,agents
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Intended Audience :: Developers
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.12.0
Requires-Dist: mcp<2,>=1.6
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Provides-Extra: lsp
Requires-Dist: jedi>=0.19.0; extra == "lsp"
Provides-Extra: rust
Requires-Dist: maturin>=1.7; extra == "rust"
Provides-Extra: all
Requires-Dist: pytest>=8.0; extra == "all"
Requires-Dist: jedi>=0.19.0; extra == "all"
Requires-Dist: maturin>=1.7; extra == "all"
Dynamic: license-file

<!-- mcp-name: io.github.L00PLeGeNd/witnis -->
<p align="center">
  <img src="./docs/assets/witnis-masthead.svg" alt="witnis" width="960"/>
</p>

Verify does nothing until you set `WITNIS_ALLOW_VERIFY=1` and pass `--execute`. `automation_verified` means the commands ran. It is not a human review.

<p align="center">
  <img src="./docs/assets/blast-radius.svg" alt="git grep Person finds five files; witnis impact Person reaches OwnerController, PetController, VisitController" width="960"/>
</p>

On spring-petclinic, `git grep -lw Person` stops at five files. `witnis impact Person` follows `Owner extends Person` into the controllers. Measured (grep recall 0, impact 1.0 on those controllers; not LLM A/B): [`docs/benchmarks/petclinic-person-grep-vs-impact.md`](docs/benchmarks/petclinic-person-grep-vs-impact.md).

## Action

History has to be in the checkout (`fetch-depth: 0`):

```yaml
- uses: actions/checkout@v4
  with: { fetch-depth: 0 }
- uses: L00PLeGeNd/Witnis/.github/actions/pr-gate@v1
```

`@v1` moves with 1.x. Pin with `@v1.11.2` if you do not want that. Default CI is blocked / 0 commands.

## MCP

Four tools: `index`, `look`, `impact`, `verify`. The rest is `WITNIS_MCP_EXPERIMENTAL=1`.

```bash
uvx witnis loop-init
```

That writes the Cursor / Claude snippet and a stdio policy. Harnis sits in front of the server; you do not install a second product. `WITNIS_DB` defaults to `.witnis/index.sqlite`.

```json
{
  "mcpServers": {
    "witnis": {
      "command": "npx",
      "args": [
        "-y", "harnis", "mcp", "--preset", "coding-agent", "--",
        "uvx", "witnis", "mcp"
      ]
    }
  }
}
```

<p align="center">
  <img src="./docs/assets/caught-lying.svg" alt="Agent wrote tests passed; Witnis shows executed 0 blocked; after authorize, 4 passed in 0.03s" width="960"/>
</p>

`pip install witnis` / `uvx witnis`. Pin the Action with `@v1.11.2` if you do not want `@v1` to move.

If you are searching: **witnis-dev**. Unrelated to [Witnis AB](https://www.witnis.se). PetClinic labels (18 items, not dual-human): [`docs/benchmarks/petclinic-human-v2.md`](docs/benchmarks/petclinic-human-v2.md). Isolation: [`SECURITY.md`](SECURITY.md). License: Apache-2.0.

mcp-name: io.github.L00PLeGeNd/witnis
