Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Changelog

All notable changes to ReasonKit are documented here.

[Unreleased]

Added

  • Processing Module - New text normalization and processing utilities
    • normalize_text() with configurable options
    • estimate_tokens() for token count estimation
    • extract_sentences() and split_paragraphs() utilities
    • ProcessingPipeline for document workflow
  • ProofLedger Anchoring - Cryptographic binding for verified claims
    • rk verify --anchor now creates immutable citation anchors
    • SQLite-backed ledger with SHA-256 content hashing
  • ARC-Challenge Benchmark - 10 science reasoning problems for evaluation
  • Custom Benchmark Loading - Load problems from JSON via REASONKIT_CUSTOM_BENCHMARK
  • Debate Concession Tracking - Track concessions in adversarial debates
  • Category/Difficulty Accuracy - Benchmark results now include per-category metrics
  • HighReflect meta-cognition tool (Pro)
  • RiskRadar risk assessment tool (Pro)
  • Streaming output support
  • Custom profile creation

Changed

  • Improved BrutalHonesty severity levels
  • Better error messages for provider failures
  • Enhanced LLM query expansion with documented integration points
  • Upgraded BM25 index with section metadata support

Fixed

  • All 8 internal TODOs resolved (production-ready codebase)
  • Section propagation through RAG pipeline
  • BM25 document deletion in HybridRetriever
  • Chunk metadata enrichment with get_chunk_by_id()
  • Timeout handling in parallel execution
  • Cache invalidation on config change
  • Clippy warnings resolved (0 warnings)

[0.1.0] - 2025-01-15

Added

Core ThinkTools

  • GigaThink - Multi-perspective exploration (5-25 perspectives)
  • LaserLogic - Logical analysis and fallacy detection
  • BedRock - First principles decomposition
  • ProofGuard - Source verification and triangulation
  • BrutalHonesty - Adversarial self-critique
  • PowerCombo - All tools in sequence

Profiles

  • Quick (~10s) - Fast sanity check
  • Balanced (~20s) - Standard analysis
  • Deep (~1min) - Thorough examination
  • Paranoid (~2-3min) - Maximum scrutiny

Providers

  • Anthropic Claude (Claude Opus 4 / Sonnet 4 / Haiku 3.5)
  • OpenAI (GPT-4o, o1)
  • Google Gemini (Gemini 2.0)
  • Groq (fast inference)
  • OpenRouter (300+ models)
  • Ollama (local models)

Output Formats

  • Pretty (terminal with colors)
  • JSON (machine-readable)
  • Markdown (documentation-friendly)

CLI

  • rk think - Full analysis
  • rk gigathink - Single tool
  • rk config - Configuration management
  • rk providers - Provider management

Configuration

  • TOML config file support
  • Environment variable overrides
  • CLI flag overrides
  • Custom profiles

Technical

  • Async/await throughout
  • Parallel tool execution option
  • Structured error handling
  • Comprehensive logging

Version History

VersionDateHighlights
0.1.02025-01-15Initial release

Upgrade Guide

From 0.0.x to 0.1.0

This is the first stable release. No migration needed.

Future Upgrades

We follow semantic versioning:

  • Major (1.0.0) - Breaking changes
  • Minor (0.2.0) - New features, backward compatible
  • Patch (0.1.1) - Bug fixes

Roadmap

0.2.0 (Planned)

  • AtomicBreak tool (Pro)
  • DeciDomatic decision matrix (Pro)
  • Webhook integrations
  • VS Code extension

0.3.0 (Planned)

  • Team collaboration features
  • Analysis history and search
  • Custom tool marketplace
  • Mobile companion app

1.0.0 (Planned)

  • Stable API guarantee
  • Enterprise features
  • Self-hosted option
  • SOC 2 compliance

Contributing

See Contributing Guidelines for how to help.

Report bugs at GitHub Issues.