Changelog
Track the continuous evolution, features, and fixes across Runmark releases.
JSON Schema Bundling & Packaging Optimization
LatestReleased on Aug 29, 2026
Bundles JSON schemas directly into Python package distribution data and refines contract validation packaging.
Features
- Bundled official JSON schemas into package distribution for zero-network validation
- Added strict fallback mechanisms for localized schema validation
Improvements
- Optimized package distribution size and wheels
- Improved mypy strict type definitions across detector context models
Bug Fixes
- Fixed path resolution bug when validating schemas in isolated virtual environments
- Corrected edge case with Windows executable extensions during runtime scanning
Contract Bootstrap & Developer Experience
Released on Aug 15, 2026
Introduces complete Environment Contracts (`runmark.json`), evidence-driven contract synthesis (`runmark contract init`), semantic contract diffing, and `runmark check` evaluation.
Features
- Added `runmark contract init` with `--dry-run` and `--yes` flags to bootstrap `runmark.json` from project evidence
- Added `runmark contract diff` to compare working tree contract against Git baseline `HEAD:runmark.json`
- Added `runmark check` and `runmark check --explain` with detailed diagnostic cards
- Added `runmark contract validate` and `runmark contract show` subcommands
- Implemented formal JSON schema specification (`schemas/contract-v1.json`)
Security
- Added `ContractSanitizer` with fail-safe abort (Exit code 4) to ensure no credentials enter contract files
- Added URI credential stripping for postgres, redis, and mysql connection strings
Improvements
- Improved Rich console output with modern table layouts and status glyphs
- Enhanced Windows terminal UTF-8 rendering compatibility
- Numeric version constraint evaluation (>=3.11, 3.12.x, <4.0)
Bug Fixes
- Fixed false positives in dependency detector when comments exist in requirements.txt
- Resolved path masking for nested home directory subfolders
Environment Intelligence & Doctor Mode
Released on Jul 18, 2026
Introduced deep diagnostic engine (`runmark doctor`), service health checks for PostgreSQL/Redis, and semantic drift triage.
Features
- Added `runmark doctor` command providing observed evidence, inferred reasoning, and remediation instructions
- Added PostgreSQL and Redis port and process detectors
- Added container detection for Docker and Docker Compose definitions
- Introduced multi-severity diff categorization
Improvements
- Faster parallel detector execution with individual timeout guards
- Atomic snapshot writes with fsync protection against corruption
Share & Portable Diagnostics
Released on May 28, 2026
Introduced `runmark share` to generate portable, sanitized diagnostic markdown and JSON reports for bug reports and team chat.
Features
- Added `runmark share --output report.md` and `--json` export options
- Added portable diagnostic report schema
Security
- Enforced export canary scan with automatic abort if unmasked tokens are detected
Stability & Windows Support
Released on May 05, 2026
Refined cross-platform detector accuracy, improved subprocess timeout management, and enhanced Windows path handling.
Bug Fixes
- Fixed subprocess execution hanging on interactive prompts by passing DEVNULL stdin
- Resolved environment variable casing on Windows systems
- Addressed mypy strict compliance across all core modules
Initial Open-Source Release
Released on Apr 10, 2026
The initial public release of Runmark — bringing environment observability, fingerprinting, snapshots, and verification to modern developers.
Features
- Added `runmark init`, `runmark scan`, `runmark snapshot`, `runmark diff`, `runmark verify`, and `runmark history`
- Implemented detectors for Python, Node, Git, Docker, and system architecture
- Introduced deterministic SHA-256 environment digest
- Created `.runmark/` repository local storage specification