Skip to content

Slice 1: Python package scaffolding (prefactor) #2

Description

@qwerkilo

Parent

#1 — context2html Framework

What to build

Create the context2html/ Python package directory structure with empty modules ready for the three framework seams. This is a pure structural change — no behavior, no new tests yet.

  • Create context2html/__init__.py with package metadata
  • No runtime dependencies; pyproject.toml already exists
  • Existing 376 tests in scripts/test_*.py still load via importlib and pass unmodified
  • All existing entry points (validate-report.py, generate-theme-css.py, etc.) continue to work

The goal is to "make the change easy" — lay the package foundation so subsequent slices can import from context2html.registry etc. without needing to restructure the codebase again.

Acceptance criteria

  • python -c "import context2html; print(context2html.__version__)" works
  • All 376 tests pass: python -m pytest scripts/test_validate_report.py scripts/test_validate_lesson.py scripts/test_generate_theme_css.py -v --tb=short
  • Existing entry points (validate-report.py, generate-theme-css.py) still work
  • uv pip install -e . succeeds

Blocked by

None — can start immediately

Metadata

Metadata

Assignees

No one assigned

    Labels

    ready-for-agentFully specified, ready for an AFK agent

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions