Skip to content

Releases: HaipingShi/coderail

v0.7.3 - TDD Gate

Choose a tag to compare

@github-actions github-actions released this 08 Jul 07:25

TDD Gate.

  • Added references/TDD_GATE.md, skills/tdd-gate, and scripts/tdd_check.py.
  • Added TDD mode, Red check, Green check, Refactor check, Regression check, CI check, and Waiver reason fields to task and contract templates.
  • Integrated TDD Gate into Doctor and CI Gate so correctness-sensitive tasks surface missing Red-Green-Refactor evidence.
  • Documented default TDD policy for bugs, regressions, parsers, validators, domain logic, APIs, shared utilities, and risky refactors.
  • Verified with npm run ci.

v0.7.2 - Auto Commit and CI Gate

Choose a tag to compare

@github-actions github-actions released this 08 Jul 05:50

Auto-commit and CI Gate hardening.

  • Changed closeout from commit recommendation to automatic task-scoped commit action when safe.
  • Added --auto-commit support to scripts/closeout_check.py, staging only safe files derived from the task scope and never relying on broad staging.
  • Added scripts/ci_gate.py and npm run ci to run non-decision checks without asking the user first.
  • Hardened GitHub Actions with workflow_dispatch, read-only permissions, concurrency, timeout, and the shared CI Gate.
  • Updated runtime entries, templates, skills, and docs to stop only for decision-grade blockers while executing CI, validation, inspect, trace, and safe auto-commit directly.
  • Verified with npm test and npm run ci.

v0.6.1 - GitHub polish, install docs, and done gate hardening

Choose a tag to compare

@HaipingShi HaipingShi released this 08 Jul 03:18

v0.6.1 - GitHub polish, install docs, and done gate hardening

This release tightens CodeRail's verification behavior and makes the GitHub repository easier to install, evaluate, contribute to, and release from.

Highlights

  • Hardened scripts/done_gate.py: skipped harness results now require explicit manual acceptance, and scope matching is path-segment aware.
  • Added scripts/run_python.js so npm scripts find a real Python interpreter instead of accepting broken python3 shims.
  • Fixed Windows UTF-8 test reads and added regression coverage for done gate scope matching and skipped verification.
  • Reworked README.md with bilingual English/Chinese docs, richer icons, 5W2H, user/agent guidance, clone-first install prompts, and npm Git URL clarification.
  • Added GitHub project hygiene: CI workflow, issue templates, PR template, release notes config, and release checklist.
  • Expanded CONTRIBUTING.md and SECURITY.md; completed the MIT license text for better GitHub license detection.

Install

git clone https://github.com/HaipingShi/coderail.git
cd coderail
python scripts/init_project.py --target /path/to/your/repo --mode standard
python scripts/doctor.py --target /path/to/your/repo

Verification

  • npm test - 10 tests passed
  • python scripts/doctor.py --target project-template - healthy
  • python scripts/contract_check.py --target project-template - healthy
  • python scripts/coordinate_check.py --target project-template - healthy

v0.2.0 — North-Star Kernel and governance skills

Choose a tag to compare

@HaipingShi HaipingShi released this 03 Jul 07:22

[0.2.0] - 2026-07-03

The governance-first release. CodeRail now leads with the North-Star Kernel and
ships as installable plugins for Claude Code and Codex.

Added

  • K0 North-Star Kernel — every coding action must map to the current Outcome,
    Current Bet, Invariants, or Current Slice in docs/NORTH_STAR.md.
  • docs/NORTH_STAR.md as the first-class, persistent direction anchor
    (target ≤ 100 lines).
  • /align skill — intent-level check (L0–L5) before coding; produces a
    North-Star Check and a task-contract candidate.
  • /drift-check skill — detects goal drift, orphan tasks, and documentation
    rot across NORTH_STAR, TASKS, HANDOFF, and DECISIONS.
  • Plugin manifests for Claude Code (.claude-plugin/) and Codex
    (.codex-plugin/), with skills under skills/.
  • Project template (project-template/) — AGENTS.md, CLAUDE.md, and the
    docs/ set, plus TASK_GRAPH.md and METRICS.md for Standard mode.
  • Installer script scripts/init_project.py with --mode lite|standard,
    copies templates without overwriting non-empty files.
  • scripts/doctor.py — read-only governance health report.
  • scripts/drift_check.py — static drift detection across docs.
  • Adoption Gate (references/ADOPTION_GATE.md) — five criteria any new skill
    or workflow must pass to enter the default set.
  • Four adoption tiers: Lite, Standard, Team, Enterprise (references/MODES.md).
  • Validation hierarchy reference: executable harness > static acceptance >
    tool-native enforcement > human review > agent self-check (soft gate only).
  • SECURITY.md, CONTRIBUTING.md, and CODE_OF_CONDUCT.md.

Changed

  • Converted the previous standalone document bundle into a plugin-compatible
    package with a clear skills/ + project-template/ + references/ layout.
  • Renamed the project to CodeRail (previously an internal codename).

Removed

  • All research-origin terminology from runtime files. The structure test
    (tests/test_structure.py) now enforces engineering-only language.

Project metadata

  • Rewritten README.md with explicit positioning, audience, and a comparison
    section covering Superpowers, spec-kit/Kiro, and BMAD.
  • Public repository metadata (package.json, plugin manifests) point to
    github.com/HaipingShi/coderail.

Notes

  • Self-checks remain soft gates only. Harness, CI, permissions, hooks, and
    review remain the stronger validation layers (K3, K4).
  • No active hooks by default. examples/ contains sample hooks and
    permission configs that are default-off until you review and enable them.