Releases: HaipingShi/coderail
Releases · HaipingShi/coderail
Release list
v0.7.3 - TDD Gate
TDD Gate.
- Added
references/TDD_GATE.md,skills/tdd-gate, andscripts/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
Auto-commit and CI Gate hardening.
- Changed closeout from commit recommendation to automatic task-scoped commit action when safe.
- Added
--auto-commitsupport toscripts/closeout_check.py, staging only safe files derived from the task scope and never relying on broad staging. - Added
scripts/ci_gate.pyandnpm run cito 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 testandnpm run ci.
v0.6.1 - GitHub polish, install docs, and done gate hardening
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.jsso npm scripts find a real Python interpreter instead of accepting brokenpython3shims. - Fixed Windows UTF-8 test reads and added regression coverage for done gate scope matching and skipped verification.
- Reworked
README.mdwith 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.mdandSECURITY.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/repoVerification
npm test- 10 tests passedpython scripts/doctor.py --target project-template- healthypython scripts/contract_check.py --target project-template- healthypython scripts/coordinate_check.py --target project-template- healthy
v0.2.0 — North-Star Kernel and governance skills
[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 indocs/NORTH_STAR.md. docs/NORTH_STAR.mdas the first-class, persistent direction anchor
(target ≤ 100 lines)./alignskill — intent-level check (L0–L5) before coding; produces a
North-Star Check and a task-contract candidate./drift-checkskill — detects goal drift, orphan tasks, and documentation
rot acrossNORTH_STAR,TASKS,HANDOFF, andDECISIONS.- Plugin manifests for Claude Code (
.claude-plugin/) and Codex
(.codex-plugin/), with skills underskills/. - Project template (
project-template/) —AGENTS.md,CLAUDE.md, and the
docs/set, plusTASK_GRAPH.mdandMETRICS.mdfor Standard mode. - Installer script
scripts/init_project.pywith--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, andCODE_OF_CONDUCT.md.
Changed
- Converted the previous standalone document bundle into a plugin-compatible
package with a clearskills/+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.mdwith 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.