Skip to content

Foundation: CI baseline for lint, tests, and the README catalog check #62

Closed

Description

@CompleteDotTech

Goal

Put checks on every pull request as early as possible, so the rest of the foundation lands behind a gate.

Scope

  • A GitHub Actions workflow on pull requests and pushes to main: ruff check, ruff format --check, pytest, and python tools/render_catalog.py --check.
  • Tests for tools/render_catalog.py: region replacement, published detection when recipes/<slug>/notebook.ipynb exists, and --check exit codes.
  • Pinned action versions, minimal permissions (contents: read), dependency caching.

Acceptance criteria

  • The workflow runs and passes on its own pull request
  • A deliberately stale README makes the catalog check fail (shown in the pull request description, not left in the branch)
  • Job names are stable so they can be made required checks later
  • Lint and tests pass in CI, or locally with the output pasted in the pull request if CI does not exist yet

Dependencies

References

Activity

  1. added
    type: foundationShared code, tooling, CI, or docs that recipes depend on
    priority: p0Blocks everything else; do first
    size: SAbout half a day for one agent or person
    status: blockedWaiting on the issues listed under Dependencies
    on Oct 6, 2026
  2. added
    status: in progressClaimed; a branch or pull request exists
    and removed
    status: blockedWaiting on the issues listed under Dependencies
    on Oct 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    priority: p0Blocks everything else; do firstsize: SAbout half a day for one agent or persontype: foundationShared code, tooling, CI, or docs that recipes depend on

    Type

    No type

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions