Changelog and Roadmap

This page tracks the evolution of the simap-mcp server, detailing past releases and the current project status. The project follows Semantic Versioning and maintains a Keep a Changelog format. Future development intent is managed through GitHub Issues and Pull Requests rather than a static roadmap file.

Sources: CHANGELOG.md1-3 server.json9

Release History

v1.3.0 (Current)

This release updates the project's runtime requirements to align with Node.js Long Term Support (LTS) cycles.

Key Changes

• Node.js Minimum Bump: The engines.node requirement in package.json was bumped from >=20 to >=22 CHANGELOG.md7 Node.js 20 reached end-of-life on 2026-04-30 and no longer receives security updates.
• CI Matrix Update: The .github/workflows/ci.yml matrix was updated to test against Node versions [22, 24], representing the current Active and Current LTS releases CHANGELOG.md8
• Documentation Alignment: All prerequisites in README.md and CONTRIBUTING.md now reflect the Node.js >=22 requirement CHANGELOG.md8

Sources: CHANGELOG.md3-9 server.json9-14

v1.2.4

A maintenance release focusing on dependency stability and Zod correctness.

Key Changes

• Zod Update: Bumped zod to ^4.4.3 CHANGELOG.md16 Version 4.4.2 tightened z.discriminatedUnion option typing and made z.preprocess defer optionality to the inner schema CHANGELOG.md16 Version 4.4.3 restored .catch() and preprocess handling for absent object keys CHANGELOG.md16 While these specific APIs aren't heavily utilized in the current codebase, the bump ensures alignment with the latest validation standards.

Sources: CHANGELOG.md10-17

v1.2.3

This release focused on Markdown rendering robustness, security hardening of CI workflows, and preventing test drift.

Key Changes and Fixes

• CommonMark-Safe Code Spans: Added formatInlineCode() in src/utils/formatting.ts CHANGELOG.md28 It wraps user input in a backtick fence one longer than the longest backtick run in the input, padding with spaces where necessary to comply with CommonMark §6.1 CHANGELOG.md28
• Backslash Sanitization: Fixed escapeInlineCode() to escape backslashes before backticks CHANGELOG.md22 This prevents CodeQL-flagged incomplete sanitization (js/incomplete-sanitization) where a doubled backslash could be interpreted as a literal \ followed by an un-escaped backtick CHANGELOG.md22
• CI Permissions: Hardened .github/workflows/ci.yml by adding an explicit permissions: contents: read block at the workflow level to ensure the GITHUB_TOKEN follows least privilege CHANGELOG.md24
• Test Integrity: Refactored tests/tools/search-cpv-codes.test.ts to import the production escapeInlineCode instead of a local copy, and added direct unit coverage in tests/utils/formatting.test.ts CHANGELOG.md26

Sources: CHANGELOG.md18-33

v1.2.2

This release overhauled the project's release engineering and contributor workflow.

Key Additions and Changes

• Changesets Migration: Migrated to changesets for automated versioning and changelog generation CHANGELOG.md40 package.json and server.json are now bumped in unison CHANGELOG.md40
• Opt-in Workflow: Changesets are now opt-in; contributors only add them for user-visible changes CHANGELOG.md42 The changeset-bot provides status comments on every PR CHANGELOG.md42
• Badge Fix: Corrected the "GitHub Actions Workflow Status" badge in README.md to point to ci.yml on main CHANGELOG.md38

Sources: CHANGELOG.md34-43

v1.2.1

Focus on brand consistency and fixing edge-case API response validation.

Key Changes and Fixes

• Lowercase Branding: Standardized "simap" to lowercase in all user-facing strings, including error messages and tool descriptions, to match brand guidelines CHANGELOG.md48-49
• Nullish lotTitle: Updated ProjectHeaderSchema and LotEntrySchema to allow lotTitle to be .nullish(), fixing validation errors for projects where the API omits this field CHANGELOG.md58
• Cleanup: Removed simap.yaml, an 809 KB orphan copy of the OpenAPI spec that was not referenced by the codebase CHANGELOG.md53

Sources: CHANGELOG.md44-60

v1.2.0

A significant update to the data extraction layer and response formatting.

Key Additions and Changes

• fullRaw Parameter: Introduced in get_tender_details to allow users to opt-in to the complete, unmodified JSON response from the API CHANGELOG.md57
• Schema Rewrite: PublicationDetailsSchema was rewritten to match the nested structure of the SIMAP API (base, dates, terms, etc.) CHANGELOG.md61
• Truncation Removal: Removed formatJsonPreview, eliminating the 3000-character truncation limit for tender details to provide full visibility into large procurement documents CHANGELOG.md61

Sources: CHANGELOG.md53-61

v1.1.0

Architectural refinement and improved developer experience.

Key Additions and Changes

• SlidingWindowRateLimiter: Implemented a more efficient rate limiter using a FIFO queue and timer-based window management to handle API concurrency CHANGELOG.md70
• toToolErrorResult: Added a utility in src/utils/errors.ts to provide consistent, typed error results for MCP tools CHANGELOG.md71
• Exported Zod Schemas: Exported Zod schemas for better reusability across the project CHANGELOG.md72
• SIMAP_MCP_DEBUG: Introduced an environment variable to enable verbose logging of API URLs and metadata to stderr CHANGELOG.md67
• Search Refactor: Moved search parameter mapping logic to src/tools/search-tenders-params.ts CHANGELOG.md76

Data Flow: Error Handling and Rate Limiting (v1.1.0+)

Sources: CHANGELOG.md62-88

Roadmap and Future Intent

The project favors dynamic tracking through active project management tools.

Active Tracking

Future features, performance improvements, and bug fixes are tracked via:

1. GitHub Issues: For feature requests and bug reports.
2. GitHub Pull Requests: For ongoing implementation work and peer review.

System Component Interaction (Code Entity Space)

Sources: CHANGELOG.md13-17 CHANGELOG.md76 src/utils/formatting.ts1-32

Infrastructure and Quality Standards

• Node.js Support: Compatible with versions >= 22 (LTS) CHANGELOG.md7
• CI/CD: Automated testing via Vitest across Node 22 and 24 CHANGELOG.md8
• Release Process: Driven by changesets with automated publication to npm and the MCP Registry CHANGELOG.md40

Sources: CHANGELOG.md1-50 server.json1-20