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 4 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 4 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 a6c0d19 to e58cec6 Compare June 12, 2026 21:50
cognis-digital and others added 4 commits June 13, 2026 03:07
…-06-13)

- README install instructions point at the working git+https path
- ran the actual audit: 12 tests passed, 0 parse errors, CLI C:\Python314\python.exe: No module named https
- embedded results in README ## Verification and AUDIT.md
- Insert layman section in README.md for non-technical readers
- Add comprehensive Install section covering pipx/uv/pip/source methods
- Write install.sh (POSIX) and install.ps1 (Windows) one-liner scripts
- core.py: remove unused `body` variable (ruff F841); explicit isdir()
  guard in load_sequence raises IsADirectoryError on Windows; guard
  loads_sequence against empty/whitespace-only input with clear ValueError;
  _coerce_emails validates emails/sequence key is a list and each item is
  a dict, with index-aware error messages; lint_email guards non-dict input
- cli.py: catch IsADirectoryError, PermissionError, and generic OSError
  in _read_input, each printing a clear message to stderr with exit code 2
- mcp_server.py: fix broken import of non-existent scan/to_json; re-wire
  serve() to use lint_sequence/loads_sequence/SequenceReport.to_dict and
  return a JSON error object on bad input rather than raising
- tests/test_hardening.py: 18 new tests covering empty input, whitespace
  input, invalid JSON, non-list emails key, non-dict array items, null
  items, bare integer, missing file, directory path, malformed file,
  empty sequence, CLI missing-file/malformed/directory/empty-stdin/no-
  subcommand exits, 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