bfiles 2025-11-18
Open-source preparation with SPDX headers, MkDocs site, and release workflow
79 files · 3,093+ · 2,163-

Open-source preparation

4 files changed
  • CHANGELOG.md Added Keep a Changelog format with v0.3.0 initial public release entry
  • CONTRIBUTING.md 334-line guide with development setup, workflow, code style, testing, and project structure
  • add_spdx_headers.py 212-line script for automated SPDX license header management
  • validate_spdx_headers.py 104-line script for validating SPDX headers across all files
  • Added CHANGELOG.md following Keep a Changelog format with v0.3.0 initial public release entry specify internal
    1 file
    • CHANGELOG.md
  • Added comprehensive CONTRIBUTING.md (334 lines) with development setup, workflow, code style, testing, and project structure documentation specify internal
    1 file
    • CONTRIBUTING.md
  • Added SPDX license headers (SPDX-FileCopyrightText, SPDX-License-Identifier Apache-2.0) to all Python source files and test files specify internal
    10 files
    • bundler.py
    • cli.py
    • config.py
    • core.py
    • exclusions.py
    • collection.py
    • chunking.py
    • metadata.py
    • output.py
    • utils.py
  • Added scripts for automated SPDX license header management and validation instantiate internal
    2 files
    • add_spdx_headers.py
    • validate_spdx_headers.py

MkDocs documentation site

7 files changed
  • mkdocs.yml MkDocs configuration for documentation site
  • index.md Landing page (62 lines)
  • provide-theme.css Documentation theme CSS (427 lines)
  • termynal.css Terminal animation CSS (127 lines)
  • custom.js Custom documentation JS (121 lines)
  • mermaid-init.js Mermaid diagram initialization (16 lines)
  • termynal.js Interactive terminal demo JS (264 lines)
  • Added MkDocs configuration for documentation site instantiate internal
    1 file
    • mkdocs.yml
  • Added landing page and theme CSS for documentation instantiate internal
    3 files
    • index.md
    • provide-theme.css
    • termynal.css
  • Added interactive terminal demo JavaScript for documentation instantiate internal
    3 files
    • custom.js
    • mermaid-init.js
    • termynal.js

CI/CD updates

2 files changed
  • ci.yml Revised CI configuration
  • release.yml 30-line PyPI release automation workflow
  • Updated CI configuration with revised workflow baseline internal
    1 file
    • ci.yml
  • Added release workflow for PyPI release automation (30 lines) instantiate internal
    1 file
    • release.yml

Code quality improvements

2 files changed
  • cli.py Removed TODO placeholder, pass statements from empty Click commands, replaced sys.exit with raise SystemExit
  • bundler.py Simplified multi-line function calls to single lines
  • Removed TODO placeholder and pass statements from empty Click command bodies decouple errata
    1 file
    • cli.py
  • Replaced sys.exit() calls with raise SystemExit() for better exception handling decouple internal
    1 file
    • cli.py
  • Changed pip install references to uv add in error messages baseline internal
    1 file
    • cli.py
  • Simplified multi-line function calls in bundler.py to single lines where appropriate decouple internal
    1 file
    • bundler.py

Removed legacy content

4 files changed
  • PLAN.md Removed development planning file
  • TODO.md Removed development TODO file
  • MATURITY_REPORT.md Removed maturity report
  • AGENTS.md Removed archived agents doc
  • Removed .dev/PLAN.md and .dev/TODO.md development planning files baseline internal
    2 files
    • PLAN.md
    • TODO.md
  • Removed docs/MATURITY_REPORT.md, docs/archive/AGENTS.md, LLM code assist guides, and dev session logs baseline internal
    2 files
    • MATURITY_REPORT.md
    • AGENTS.md

License update

1 file changed
  • LICENSE Updated with expanded Apache 2.0 content (222-line change)
  • Updated LICENSE file with expanded Apache 2.0 content (222-line change) baseline internal
    1 file
    • LICENSE