Skip to content

Retire the classic Python CLI and launch a new docs site - #165

Merged
dmdhrumilmistry merged 3 commits into
devfrom
feat/drop-classic-cli-new-docs
Oct 20, 2026
Merged

dmdhrumilmistry merged 3 commits into
devfrom
feat/drop-classic-cli-new-docs

Conversation

@dmdhrumilmistry

Copy link
Copy Markdown
Collaborator

Summary

Two commits, on top of the merged #164.

1. Retire the classic Python CLI (feat!)

  • Deletes src/ (the spec-only offat CLI, offat-api, its Dockerfiles and compose file) and pypi-publish.yml, which built it. The last offat release stays on PyPI.
  • dev-push.yml and release-push.yml now build one platform image from docker/Dockerfile instead of the four classic images.
  • action.yml runs the platform:
    • source-only by default;
    • a live run needs both url and authorized: 'true', mirroring the CLI's --yes gate;
    • optionally uploads SARIF to code scanning.
  • The Dockerfile and Makefile install the whitebox[graph] extra. The README and the OWASP project page now lead with the platform.

Breaking: pip install offat, the offat CLI and offat-api are no longer built from this repo.

2. New docs site

Jekyll/just-the-docs is replaced by docs/build.py (Python-Markdown + Pygments) and a custom theme:

  • Home: hero, pipeline card with a running signal, highlights and feature cards.
  • Docs pages: three columns (sidebar, content, "on this page" with scroll spy); the sidebar becomes an off-canvas drawer on mobile.
  • Reading aids:
    • light and dark themes;
    • ⌘K / / search over a generated index;
    • code blocks with language labels and copy buttons;
    • callouts, a prev/next pager and edit-on-GitHub links;
    • a 404 page and a sitemap.
  • Content:
    • classic-CLI sections are gone;
    • there's a new Code graph page;
    • the design docs are promoted to Deep dives, with outdated graft/semgrep-era text corrected;
    • fixed: the gray-box doc named OFFAT_GB_* environment variables that don't exist in the code.
  • The Pages workflow builds with Python, and CI builds the site on every PR.

Test plan

  • All Python suites pass (bundle, triager, whitebox, graybox, platform, reporter)
  • python docs/build.py builds 12 pages; static checks found no broken internal links or anchors, well-formed HTML, app.js parses, and no Jekyll or kramdown syntax leaks into the output
  • Visual check in a browser: no headless browser was available in the authoring environment. Preview with python docs/build.py && python -m http.server -d docs/_site

🤖 Generated with Claude Code

dmdhrumilmistry and others added 2 commits October 20, 2026 03:48
Remove the spec-only classic CLI and REST API (src/) in favour of the OFFAT
platform (map -> code graph -> test-gen -> Rust engine -> triage -> report).

- delete src/ and the PyPI workflow that built it (its last release stays on PyPI)
- dev/release image workflows build one platform image from docker/Dockerfile
  instead of the four classic images
- action.yml runs the platform: source-only by default; a live run needs both
  `url` and `authorized: 'true'` (mirrors the CLI's --yes gate); optional SARIF
  upload to code scanning
- Dockerfile/Makefile install the whitebox [graph] extra
- README and OWASP project page lead with the platform

BREAKING CHANGE: `pip install offat`, the `offat` CLI and `offat-api` are no
longer built from this repository.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Replace Jekyll/just-the-docs with docs/build.py (Python-Markdown + Pygments)
and a custom "signal trace" theme:

- home page with hero, pipeline card, highlights and feature cards
- three-column docs layout, sticky sidebar and on-this-page TOC with scroll spy,
  off-canvas navigation on mobile
- light/dark themes (system default, persisted toggle), Cmd/Ctrl-K search over
  a generated index, code blocks with language labels and copy buttons,
  callouts, prev/next pager, edit-on-GitHub links, 404 page, sitemap
- content rewritten for the platform: no classic-CLI sections; new Code graph
  page; design docs promoted to "Deep dives" and corrected (graft/semgrep era
  text, non-existent OFFAT_GB_* env vars)
- Pages workflow builds with Python; CI builds the site on every PR

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Copilot AI balanced review requested due to automatic review settings October 20, 2026 03:49

Copilot AI 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.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Comment thread docs/_theme/app.js Fixed
Comment thread docs/build.py Fixed
Comment thread docs/build.py Fixed
Comment thread docs/build.py Fixed
…ld.py

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@dmdhrumilmistry
dmdhrumilmistry merged commit a6d8432 into dev Oct 20, 2026
14 checks passed
@dmdhrumilmistry
dmdhrumilmistry deleted the feat/drop-classic-cli-new-docs branch October 21, 2026 10:17
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.

3 participants