Skip to content
This repository was archived by the owner on Apr 8, 2026. It is now read-only.

Releases: paiml/renacer

Nightly Build

06 Apr 05:04
168ae71

Choose a tag to compare

Nightly Build Pre-release
Pre-release

Automated nightly build from main.

Date: 2026-04-05T14:23:24Z
Commit: 168ae71

This is a prerelease. For stable releases, see the latest tagged version.

v0.6.6

29 Nov 11:42

Choose a tag to compare

What's New

CITL Integration (Sprint 49)

  • Decision trace export to entrenar via OTLP
  • Depyler ingestion for transpiler decision traces
  • Cross-project pattern transfer support

Documentation

  • New book chapter: Decision Trace Export
  • New book chapter: CITL Integration
  • Updated SUMMARY.md

Dependencies

  • aprender: 0.11 → 0.13
  • trueno: 0.7 → 0.7.3
  • trueno-db: 0.3 → 0.3.3
  • trueno-graph: 0.1 → 0.1.1

Fixes

  • Corrected TOML test formats for decision export config
  • Deferred CLI subcommand tests to Sprint 50

Full Changelog: v0.6.5...v0.6.6

v0.6.5 - aprender 0.11.0 & CI Improvements

27 Nov 16:10

Choose a tag to compare

What's Changed

Dependencies

  • aprender: Updated to v0.11.0 (latest crates.io release)

CI/CD

  • Added comprehensive GitHub Actions CI workflow
    • Check, Format, Clippy, Test, Documentation, Security Audit
  • Added Cargo.toml lint configuration
  • Added .clippy.toml with complexity thresholds

Documentation

  • Fixed rustdoc broken-intra-doc-links warnings
  • Added ML Pipeline chapter with EXTREME TDD
  • Added Model Persistence chapter

Code Quality

  • Reduced anti-patterns complexity via Severity helper methods
  • PMAT score improved: 102.9/134 (76.8%)
  • TDG score: 91.7/100 (A)

Tests

  • 817+ tests passing
  • All quality gates green

Installation

cargo install renacer

Links

Release v0.6.3 - Zero Production Unwraps

24 Nov 16:59

Choose a tag to compare

🎯 Highlights

This release completes Sprint 46 (UNWRAP-CRITICAL-001): Elimination of all production unwraps for zero-panic production code.

✨ What's New

  • Zero Production Unwraps: Eliminated all 8 production unwraps (2.4% of total)
    • NaN-safe sorting in ML/DL anomaly detection modules
    • Graceful matrix operation error handling
    • Clean Option pattern matching in trace correlation
    • Robust state management in tracer

🔧 Technical Improvements

  • Benchmark Compatibility: Fixed ring buffer benchmark compatibility after API changes
  • Code Quality: Zero clippy warnings from changes
  • Test Coverage: All 727 tests passing (100% success rate)
  • Rust Project Score: 97.5/134 maintained

📊 Quality Metrics

  • Production unwraps: 8 → 0 (-100%)
  • Test unwraps: 397 (acceptable in test code)
  • Effort reduction: -95% via test filtering (52-73h → 2-3.5h)

🛠️ Fixed Issues

  • NaN handling in sorting operations (.unwrap_or(Ordering::Equal))
  • Matrix creation error propagation
  • Timestamp Option handling with combined match patterns
  • State management unwraps replaced with if let patterns

📦 Installation

cargo install renacer@0.6.3

🔗 Links

👥 Contributors


Generated with Claude Code

v0.6.1 - Documentation and Security Enhancements

21 Nov 22:24

Choose a tag to compare

Release v0.6.1 - Documentation and Security Enhancements

This patch release focuses on comprehensive documentation and security hardening based on red team assessment recommendations.

📚 Documentation

Comprehensive Book Chapters

Section 5.2: Adaptive Backend Selection (docs/book/section52-adaptive-backend.md)

  • Complete documentation for AdaptiveBackend system
  • Backend selection algorithm (GPU/SIMD/Scalar)
  • Performance profiling and hot-path detection (>10k calls/sec)
  • Trueno integration patterns
  • 19 tests documented with coverage metrics
  • OTLP export capabilities

Renacer Complete Guide (docs/book/renacer-complete-guide.md)

  • Consolidated guide for entire unified tracing system
  • System architecture with unified trace model
  • Feature matrix covering Sprint 37-40
  • Quick start guide for all 8 major components
  • 3 real-world use cases (ML training debug, transpilation validation, SIMD optimization)
  • API reference with code examples
  • Performance tuning guide
  • Deployment guide (Jaeger, Grafana Cloud, Docker)
  • Troubleshooting section

Red Team Quality Assessment (docs/qa/red-team-report.md)

  • Comprehensive security and architecture assessment
  • Architectural analysis with strengths/weaknesses
  • Code quality analysis (testing strategy, unsafe code usage)
  • Security analysis with threat model
  • 10 peer-reviewed references

🔒 Security

Comprehensive Security Documentation (docs/SECURITY.md, 587 lines)

Red Team Recommendations - All Implemented

  1. ✅ Dependency Auditing

    • cargo-audit integrated in pre-commit hooks
    • Zero critical vulnerabilities
    • Documented vulnerability scanning workflow
  2. ✅ Fuzzing Infrastructure

    • cargo-fuzz setup with filter_parser.rs target
    • LLVM libFuzzer integration
    • Documented fuzzing best practices
    • Corpus management guidelines
  3. ✅ Unsafe Code Audit

    • All 4 unsafe blocks documented with safety invariants
    • Block 1: Memory-mapped decision trace (writable) - src/decision_trace.rs (Risk: Low)
    • Block 2: Memory-mapped DWARF data (read-only) - src/dwarf.rs (Risk: Low)
    • Block 3: Process forking (ptrace setup) - src/tracer.rs (Risk: Medium)
    • Block 4: CString FFI (CUDA CUPTI) - src/cuda_tracer.rs (Risk: Low)
  4. ✅ CI Security Scanning

    • Pre-commit hooks with security checks
    • cargo clippy -D warnings
    • Dependabot integration
    • Documented CI/CD security workflow

Additional Security Documentation

  • Threat model with 4 attack vectors analyzed
  • Input validation security (ELF, DWARF, MessagePack parsers)
  • Ptrace privilege requirements and mitigation strategies
  • Resource exhaustion defenses (adaptive sampling, timeouts)
  • Security considerations for all major features
  • Security contact and responsible disclosure policy

📊 Quality Metrics

  • Tests: 524 tests passing
  • Coverage: 94.71%
  • Quality Gates: All passing

🔗 Links

📦 Installation

cargo install renacer

Full Changelog: v0.6.0...v0.6.1

Renacer v0.5.0 - Transpiler Decision Tracing & Source Mapping

19 Nov 17:38

Choose a tag to compare

Renacer v0.5.0 - Transpiler Decision Tracing & Source Mapping

🎉 Sprint 24-28 Complete: Full Transpiler Tracing Infrastructure

This major release adds comprehensive transpiler source mapping and decision trace capture for Depyler (Python→Rust), TypeScript→Rust, and Decy (C→Rust) transpilers.

🚀 Major Features

Sprint 24: Transpiler Source Map Parsing ✅

  • Parse JSON source maps from transpilers
  • Support for 3 transpiler types: Python, TypeScript, C
  • Two-way lookups: lookup_line() and lookup_function()
  • CLI flag: --transpiler-map FILE

Sprint 25: Function Name Correlation ✅

  • CLI flag: --show-transpiler-context
  • Integration with --function-time for profiling original source

Sprint 26: Stack Trace & Decision Tracing ✅

  • 2003-line decision tracing engine
  • Parse [DECISION] and [RESULT] from stderr
  • Capture via write(2) syscall interception
  • CLI flags: --rewrite-stacktrace, --trace-transpiler-decisions

Sprint 27: Advanced Decision Tracing ✅

  • MessagePack binary format for efficient storage
  • Hash-based decision IDs (FNV-1a algorithm, 3-5 CPU cycles)
  • Memory-mapped file writer (zero-blocking writes to .ruchy/decisions.msgpack)
  • 16 pre-defined decision categories
  • Error correlation: --rewrite-errors flag

Sprint 28: Sampling & Decy Integration ✅

  • Xorshift64 RNG (thread-local, 3-5 CPU cycles)
  • Rate limiting (10,000 traces/second DoS protection)
  • Full C→Rust (Decy) support
  • Generic field aliases work across all transpilers

📊 Implementation Statistics

  • New Modules: 2
    • src/transpiler_map.rs - Source map parsing (373 lines)
    • src/decision_trace.rs - Decision tracing engine (2003 lines)
  • Tests: 340+ total (100+ new for Sprint 24-28)
    • 8 integration tests (sprint24)
    • 15+ integration tests (sprint26)
    • 10+ integration tests (sprint27)
    • 10 integration tests (sprint28)
    • Extensive unit tests, property-based tests
  • Coverage: 91.21% overall, 100% on new modules
  • Dependencies: +2 (rmp-serde for MessagePack, fnv for hashing)

🎯 Quality Metrics

  • TDG Score: 95.1/100 (A+)
  • Complexity: All functions ≤10 ✅
  • Clippy: Zero warnings ✅
  • Documentation: 415 valid links ✅

🔧 CLI Flags

--transpiler-map FILE           # Load transpiler source map
--show-transpiler-context       # Show verbose context
--rewrite-stacktrace            # Map Rust→Original stack traces
--rewrite-errors                # Map Rust→Original errors
--trace-transpiler-decisions    # Capture decision traces

💡 Usage Examples

# Load Python→Rust source map
renacer --transpiler-map app.sourcemap.json -- ./app_rs

# Function profiling with Python source
renacer --transpiler-map calc.sourcemap.json --function-time -- ./calc_rs

# Stack trace correlation
renacer --transpiler-map api.sourcemap.json --rewrite-stacktrace -- ./api_rs

# Decision trace capture
renacer --trace-transpiler-decisions -- ./depyler-compiled-app

# Complete transpiler tracing
renacer --transpiler-map app.sourcemap.json \
        --function-time \
        --rewrite-stacktrace \
        --rewrite-errors \
        --trace-transpiler-decisions \
        -- ./app_rs

# C→Rust (Decy) source mapping
renacer --transpiler-map algorithm.sourcemap.json --function-time -- ./algorithm_rs

📁 Output Files

  • .ruchy/decisions.msgpack - Binary decision traces (MessagePack format)
  • .ruchy/decision_manifest.json - Decision metadata and ID mappings

🏗️ Architecture

Complete implementation of Ruchy Tracing Support v2.0 specification:

  • Memory-mapped file output for zero-blocking writes
  • Hash-based decision IDs (FNV-1a) for unique identification
  • Decision manifest JSON sidecar for metadata
  • Sampling infrastructure with rate limiting
  • 16 pre-defined decision categories with subcategories

🎖️ Production Ready

85-90% feature complete for Renacer's scope. Production ready for local transpiler decision tracing with:

  • ✅ 100+ passing tests with comprehensive coverage
  • ✅ Zero defects - all quality gates passed
  • ✅ Specification compliant (Ruchy Tracing Support v2.0.0)
  • ✅ Full documentation with zero broken links

📦 Installation

cargo install renacer

Or from source:

git clone https://github.com/paiml/renacer
cd renacer
cargo install --path .

🔗 Links


Built with EXTREME TDD following Toyota Way principles. Zero tolerance for defects.

v0.3.2 - Production Release

18 Nov 15:05

Choose a tag to compare

Renacer v0.2.0 - Production Release

17 Nov 12:02

Choose a tag to compare

Renacer v0.2.0 - Production Release 🚀

Pure Rust system call tracer with source-aware correlation and function profiling

🎯 Highlights

  • Function-Level Profiling: Complete implementation with I/O detection, call graphs, hot paths, and flamegraph export
  • Property-Based Testing: 670+ test cases ensuring correctness
  • Production Quality: TDG Score 94.2/100, zero defects, 142 tests passing
  • Pre-commit Hooks: 5 quality gates running in <10s
  • Comprehensive Documentation: Full README, CHANGELOG, and specification

✨ New Features

Function Profiling (GitHub Issue #1 - Complete!)

  1. I/O Bottleneck Detection

    • Automatic detection of slow I/O operations (>1ms threshold)
    • Tracks 16 I/O syscall types
    • Visual warnings (⚠️) in output
  2. Call Graph Tracking

    • Parent→child function relationships via stack unwinding
    • Visual tree display of call graphs
    • Aggregates call frequencies
  3. Hot Path Analysis

    • Top 10 most time-consuming functions
    • Percentage breakdown of execution time
    • Integrated call graph view
  4. Flamegraph Export

    • Compatible with flamegraph.pl, inferno, speedscope
    • Folded stack format for visualization

Quality Infrastructure

  • Property-based test suite: 18 tests covering all core features
  • Pre-commit hooks: Format, clippy, tests, audit, bash quality (5 gates)
  • Dependency policy: cargo-deny configuration for security
  • Zero warnings: Clippy strict mode enforced

📊 Quality Metrics

  • TDG Score: 94.2/100 (A grade)
  • Tests: 142 (124 unit + 18 property-based)
  • Coverage: 91.21% overall, 100% on critical modules
  • Dependencies: Trueno 0.1.0 from crates.io (SIMD statistics)

🚀 Installation

cargo install renacer

📖 Quick Start

# Basic tracing
renacer -- ls -la

# Function profiling with flamegraph
renacer --function-time --source -- ./my-binary > profile.txt
cat profile.txt | flamegraph.pl > flamegraph.svg

# JSON output
renacer --format json -- echo "test" > trace.json

# Statistics mode
renacer -c -T -- cargo build

🔗 Links

🙏 Credits

Built with Toyota Way quality principles and EXTREME TDD methodology.
Powered by Trueno SIMD library.

Developed by Pragmatic AI Labs