Skip to content

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.9.1] - 2026-03-19

Fixed

  • File size limit warnings now appear in browse_catalog response (previously only logged to stderr)
  • Fixed documentation inaccuracies: example log output, troubleshooting wording, unused error code

[0.9.0] - 2026-03-19

Changed

  • BREAKING: browse_catalog now returns {"documents": [...], "warnings": [...]} instead of a plain list. The warnings key is only present when documents were skipped.

Added

  • Warnings surfaced in browse_catalog response when documents are skipped (missing title, malformed frontmatter, file too large, permission errors)
  • Log warnings with specific reasons for each skipped document during scanning and resource registration

Fixed

  • Removed incorrect "port already in use" troubleshooting entry (Folios is stdio-based)

[0.8.1] - 2026-03-19

Fixed

  • Prevent symlink traversal in document path resolution and directory scanning
  • Add configurable file size limit (--max-file-size / MAX_DOCUMENT_SIZE) to prevent memory exhaustion from oversized documents (default: 10 MB)

[0.8.0] - 2026-03-19

Added

  • Claude Code plugin marketplace support — installable via /plugin marketplace add alex-pradas/folios
  • Plugin package with MCP server configuration for seamless Claude Code integration

[0.7.2] - 2025-12-10

Added

  • New example documents: Steel Material Properties Handbook (200001) and Component Acceptance Testing Procedure (200002)
  • Updated API reference with examples using the new document types

[0.7.1] - 2025-12-10

Changed

  • Clarified documentation

[0.7.0] - 2025-12-10

Changed

  • BREAKING: Renamed list_documents tool to browse_catalog
  • BREAKING: Renamed list_document_versions tool to list_revisions

Added

  • MCP Resources documentation in API reference
  • Limitations section in README
  • Features list now includes chapter extraction, version diffing, and MCP resources

[0.6.0] - 2025-12-10

Added

  • New get_chapter_content tool to retrieve specific H2 sections from documents
  • Chapter-grouped diffs in diff_document_versions - changes now organized by chapter name
  • CHAPTER_NOT_FOUND error code for invalid chapter requests

Changed

  • diff_document_versions response format now returns {"changes": [{"chapter": "...", "diff": "..."}]} instead of a single unified diff

Fixed

  • Documentation accuracy improvements across README and docs

[0.5.0] - 2025-12-09

Changed

  • BREAKING: Renamed CLI flag --folios-path to --path (environment variable FOLIOS_PATH unchanged)

Added

  • Logo and example screenshot in README and documentation

[0.4.1] - 2025-12-06

Fixed

  • Use explicit AnyUrl type for resource URIs to satisfy type checker

[0.4.0] - 2025-12-06

Added

  • MCP resources for document access via folios://documents/{id}/v{version} URIs
  • Resource listing includes document metadata (title, author, status, type)
  • Lazy content loading - documents read on access, not at startup

[0.3.0] - 2025-12-06

Added

  • Server logging with timing information for debugging and monitoring
  • Log tool invocations with parameters at INFO level
  • Log response times and sizes at DEBUG level
  • Log schema discovery and per-file parsing performance
  • Documentation for logging configuration in docs/configuration.md

Changed

  • Uses FastMCP's get_logger for consistent log formatting

[0.2.0] - 2025-12-06

Added

  • Automatic schema discovery from documents at startup
  • Smart field classification (enumerable ≤15 values vs free-text >15 values)
  • Filter hints in list_documents tool description showing available values

Changed

  • Server now uses factory pattern (create_server()) for better testability
  • Documents path passed explicitly instead of global state

Removed

  • BREAKING: folios.toml configuration file support removed
  • Manual field value configuration no longer needed

Performance

  • Schema discovery: ~15ms for 1000 documents (~70K docs/sec)

[0.1.0] - 2025-12-06

Added

  • Initial release (renamed from alexandria-mcp to folios)
  • Document storage with versioning support ({id}_v{version}.md naming)
  • YAML frontmatter parsing for metadata (author, reviewer, approver, status, type)
  • Auto-parsed chapters from H1/H2 headings
  • MCP tools:
  • get_document - Retrieve document content
  • get_document_metadata - Get metadata including chapters
  • compare_versions - Generate diffs between versions
  • list_documents - List documents with filters
  • list_versions - List all versions of a document
  • FastMCP-based server implementation
  • Comprehensive test suite