Skip to content

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

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

Repo hardening: fix install instructions, dead imports, hygiene#2
cognis-digital wants to merge 4 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)
@cognis-digital cognis-digital force-pushed the cognis-audit/repo-hardening branch from ac50132 to cb01025 Compare June 12, 2026 21:48
Cognis Digital added 3 commits June 13, 2026 03:52
- Insert "What is this?" section in README for non-technical readers
- Add comprehensive Install section covering pipx/uv/pip/source installs
- Generate cross-platform install.sh (Linux/macOS) and install.ps1 (Windows)
- Add layman.md with plain-language description of the tool
- crack_hash: reject empty/non-hex digests; guard max_candidates < 1
- CrackQ.submit: validate owner (non-empty), priority (int), algorithm
- CrackQ.load_wordlist: raise FileNotFoundError for missing path
- AuditLog._last_hash / entries: raise AuditError on malformed JSON lines
  instead of letting json.JSONDecodeError propagate uncaught
- cli._load_words / _gather_hashes: check file exists before open,
  emit clear FileNotFoundError with path
- cli.main: catch PermissionError, OSError/IOError, json.JSONDecodeError,
  and AuditError — all map to exit 2 with a readable stderr message
- cli.build_parser: fix pre-existing E501 line-length violations
- mcp_server: fix pre-existing E501 line-length violation
- tests: add 18 new edge-case tests covering the above paths (30 total,
  all green; existing 12 unchanged)
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