Skip to content

Repo hardening: fix install instructions, dead imports, hygiene#1

Open
cognis-digital wants to merge 5 commits into
mainfrom
cognis-audit/repo-hardening
Open

Repo hardening: fix install instructions, dead imports, hygiene#1
cognis-digital wants to merge 5 commits into
mainfrom
cognis-audit/repo-hardening

Conversation

@cognis-digital

@cognis-digital cognis-digital commented Jun 12, 2026

Copy link
Copy Markdown
Owner

This PR applies a few small, mechanically-verified hardening fixes found by an automated audit of the Cognis suite:

  • fix 2 broken pip install line(s) in README (package is not on PyPI; use the working git+https install)
  • remove 3 unused import(s) (ruff F401/F811)

Each change is deterministic; all touched Python files were confirmed to still compile (py_compile) before this PR was opened.

- fix 2 broken `pip install` line(s) in README (package is not on PyPI; use the working git+https install)
- remove 3 unused import(s) (ruff F401/F811)

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for your first PR! 🚀 A maintainer will review under the collaboration-pull model (see CONTRIBUTING.md).

@cognis-digital cognis-digital force-pushed the cognis-audit/repo-hardening branch from 91cfc04 to c37f12c Compare June 12, 2026 21:56
cognis-digital and others added 4 commits June 13, 2026 02:52
…-06-13)

- README install instructions point at the working git+https path
- ran the actual audit: 10 tests passed, 0 parse errors, CLI C:\Python314\python.exe: No module named https
- embedded results in README ## Verification and AUDIT.md
Insert What is this layman section in README explaining MEV sandwich
detection in non-technical terms, insert Install section with all
install methods (pipx/uv/pip/source), add install.sh and install.ps1
install scripts, add layman.md with plain-language description.
- core.py: validate swap fields (negative amounts/block/index, empty tx/token
  strings, negative reserves) with clear per-field error messages; guard
  _amount_out_cpmm against zero new_reserve_in to prevent ZeroDivisionError
- cli.py: add PermissionError and catch-all Exception guards so any unexpected
  I/O or analysis failure prints a clean message to stderr and exits 2
- mcp_server.py: fix broken import (scan/to_json do not exist in core); replace
  with load_swaps_from_obj/build_report; guard JSON parse and swap validation
  errors so the MCP tool returns a JSON error object instead of raising
- pyproject.toml: add ruff config (line-length=120, ignore E501) so ruff F,E
  checks are clean without reformatting existing code
- tests/test_smoke.py: add 8 new tests covering missing file (exit 2), malformed
  JSON (exit 2), empty swap array, missing required field, negative amount_in,
  non-list input, CPMM zero-reserve guard, and mcp_server importability
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant