# Changelog

## [Unreleased]

## [1.11.6] - 2026-11-09

### Fixed
- **Windows 11 Default Handler & File Launching (`fc_open_path`):**
  - Do not detach the Windows launcher (`detached: false`): attached PowerShell ensures default handlers that are packaged apps (MSIX / Windows Store) and default-associated files (such as `.md`) start and open visibly in foreground.

### Changed
- **Client Configuration Reference & Paths:**
  - Updated Gemini CLI and Antigravity configuration paths: Separated `settings.json` instructions from `mcp_config.json` instructions, linking each client's official configuration reference.

### Security
- **Dependency & Supply-Chain Hardening / SBOM Updates:**
  - Supply-chain hardening, Level 1 SBOM sync, and dependency range updates (`@modelcontextprotocol/sdk` ^1.32.2, `zod` ^4.6.7, `vitest` ^4.1.12), ensuring zero-vulnerability posture and strict supply-chain security.

### Docs
- **Documentation & Discoverability Updates:**
  - Pfad B discoverability, bounded preview sequence flow (`fc_preview_file`), multi-client agent configuration architecture, 11-language documentation alignment, and removal of internal marketing logs from the published package surface.

### Client configuration corrections and current-master integration (2026-11-02)
- Separate Gemini CLI settings.json instructions from Antigravity mcp_config.json instructions, linking each client's official configuration reference.
- Integrate current master while preserving the Windows default-handler fix and removal of internal marketing logs from the published surface.
- Documentation correction only relative to master; no runtime, dependency, workflow or product-version change.

### Discoverability, Bounded Preview Sequence Flow & Multi-Client Configuration (Pfad B - 2026-11-01)
- **End-to-End Execution Lifecycle Sequence Flow Expansion:**
  - Expanded Mermaid sequence diagram in both `README.md` and `README_de.md` (Section 03) to include Phase 3: Bounded Preview & Remote Safety (`fc_preview_file`), illustrating metadata-first inspection (1 MiB ceiling) and explicit content retrieval blocks.
  - Verified syntactical validity via `_tools/lint_mermaid.py` with 0 warnings across all Markdown files.
- **Multi-Client Agent Configuration Architecture:**
  - Expanded Section 07 (Configuration / Konfiguration) across bilingual documentation with configuration snippets for Claude Code CLI (`claude mcp add`), Gemini CLI (`settings.json`), Antigravity (`mcp_config.json`), Cursor IDE (`.cursor/mcp.json`), and general stdio MCP runtimes.
- **Strict Version Freeze Discipline (`T-20260920-167562623`):**
  - Package and registry version preserved at `1.11.5` across all manifests and source code.

### Fix `fc_open_path` on Windows: default handlers that are packaged apps now start (2026-11-01)
- The Windows launcher was spawned `detached`. A detached PowerShell accepted the request (`launcher_accepted: true`) but never started a packaged (MSIX) default handler, so no window appeared. Measured on Windows 11 with a `.md` file whose handler is a Store-packaged app: the same ShellExecute script started the handler when attached and did not when detached. The launcher is no longer detached on Windows; macOS and Linux are unchanged.
- `user_visible` stays `"unknown"`: the tool still does not claim to have seen a window.

### Remove internal MARKETING-LOG.txt from the published surface (2026-11-01)
- `MARKETING-LOG.txt` is an internal automation record, not part of the product. It is no longer tracked, packed (`files`), linked from the READMEs or `llms.txt`, and the metadata tests no longer require it.
- Add a forbidden-file test: the tracked tree and the npm pack list must contain none of the internal agent file patterns (marketing/status logs, findings logs, staging directories, lock and private marker files).
- Older history and already published npm versions still contain the file; no history rewrite.

### World-Set documentation (2026-10-25)
- Add full Spanish, Simplified Chinese, Japanese, Russian, French, Hindi, Arabic, Bengali and Portuguese READMEs alongside English and German.
- Synchronize eleven-language documentation navigation and describe actual runtime selection/defaults separately.
- Include all linked README editions in the npm files allowlist. Runtime locales and package version remain unchanged.

### Dependency security refresh (2026-10-24)
- Integrate the Hono/Vite lockfile fixes from #18 on current master and refresh the remaining audited body-parser, fast-uri, ip-address and Vitest resolutions.
- Require Zod 4.6.6 or newer within major version 4 for the published constrained-collection memory advisory. MCP SDK 1.32.1 supports Zod 4; its own version remains unchanged.
- Zod 4 exposes safe-integer bounds in tool schemas; the SDK omits some implicit additionalProperties=false flags while retaining unknown-key stripping at runtime. Real stdio regression coverage checks invalid argument types, enum values and unsafe integers.
- Update declared security floors and dependency inventory ranges; a static metadata test is not an npm audit guarantee.
- Anwendungsversion 1.11.5 bleibt eingefroren. Die Abhängigkeiten und Lizenzinventare sind aktualisiert; Veröffentlichung und unabhängige Abnahme erfolgen separat.

### Reproducible development and workflow maintenance (2026-10-18)
- Use `npm ci` in the English and German source/development instructions so local installs use the same lockfile as CI.
- Add weekly GitHub Actions dependency checks with at most three open maintenance PRs; npm updates remain security-only.
- Correct the bilingual README and LLM context test totals to 306 (235 Vitest + 71 i18n), measured locally; align the existing documentation checks.
- Keep package and registry versions at `1.11.5`; no release or publication.

### Repository Hygiene, Bilingual CONTRIBUTING & Quality Gates, Level 1 SBOM Re-Audit Stand 2026-10-03 (Pfad A)
- **Bilingual Contributing Guidelines (`CONTRIBUTING.md`):**
  - Restructured `CONTRIBUTING.md` with complete bilingual (English / Deutsch) parity, 10 architectural and governance invariants (`INV-LOCAL-01` through `INV-SLA-10`), Plan D local development workflow (`C:\_Local_DEV\repos\ellmos-filecommander-mcp` as authoritative Source of Truth), strict version freeze discipline (`T-20260920-167562623`), local quality gates (`npm test`, `npm run build`, whitespace/EOF validation), and statutory liability limitation (§ 521 BGB Gefälligkeitsrecht).
  - Added `CONTRIBUTING.md` to `files` whitelist in `package.json` and linked across `README.md`, `README_de.md`, and `llms.txt`.
- **Repository Hygiene & Multi-Host Sync Defense in `.gitignore`:**
  - Hardened `.gitignore` against Windows shell artifacts (`Desktop.ini`), cross-host task plans (`TASKPLAN_*.md`, `*-TASKPLAN*`), and explicit agent-framework locks (`LOCK.dev.*`, `LOCK.antigravity.*`, `LOCK.bugsearch.*`).
- **Level 1 SBOM Stand 2026-10-03 Re-Audit & Badges Synchronization:**
  - Re-audited Level 1 SBOM in `THIRD_PARTY_LICENSES.md` (Stand: 2026-10-03) and plain-text companion `THIRD_PARTY_LICENSES.txt` (Audited: 2026-10-03) with 100% permissive open-source stack, Zero-Copyleft isolation, and unprivileged user-mode `RunAsInvoker` certification.
  - Synchronized `Last-Checked` and `Verified` badges to `2026-10-03` across English and German documentation and updated `llms.txt` header.
- **Strict Version Freeze Discipline (`T-20260920-167562623`):**
  - Semantic version `1.11.5` maintained strictly unchanged across `package.json`, `package-lock.json`, `server.json`, `glama.json`, and `src/index.ts`.
- **Contract Test Suite Expansion (`test/metadata-parity.test.ts`):**
  - Expanded automated contract test suite asserting `CONTRIBUTING.md` presence, bilingual anchors, 10 invariants, Plan D workflow, § 521 BGB notice, extended `.gitignore` patterns, Stand 2026-10-03 audit timestamps, and Section 14 marketing log recency.

### AI Security & Dependency Audit, Supply-Chain Hardening & Fleet Token Defense (2026-10-02)
- **Supply-Chain Hardening & Dependency Overrides:**
  - Updated dependency overrides for `fast-uri` (`^3.1.8`), `ip-address` (`^10.7.2`), and `qs` (`^6.16.0`) resolving 2 moderate security advisories (GHSA-hrr3-gc8f-f4qj, GHSA-rpw4-54j3-4h4q, GHSA-2vr4-cq9g-pvrc, GHSA-j6r3-76f7-8jcv, GHSA-h3mg-xc3c-68pw).
  - Validated **0 vulnerabilities** across 215 audited packages via `npm audit`.
- **Repository Hygiene & Fleet Token Defense in `.gitignore`:**
  - Hardened `.gitignore` against fleet host tokens (`*-IDEAPAD-GEI*`, `*-IDEAPAD-GEI.*`, `*-ASUS-GEI.*`).
  - Added multi-host conflict review log exclusion (`CONFLICT_REVIEW_LOG*`).
  - Hardened against local secret/token credential files (`*secret*.json`, `*token*.json`, `token.json`, `tokens.json`).
- **Contract Test Suite Expansion (`test/metadata-parity.test.ts`):**
  - Expanded assertions validating zero-vulnerability dependency overrides, fleet token ignore patterns, and zero hardcoded secrets/personal developer paths in tracked repository files (305 passed tests baseline).
- **Strict Version Freeze Discipline (T-20260920-167562623):**
  - Semantic version `1.11.5` maintained strictly unchanged across `package.json`, `package-lock.json`, `server.json`, `glama.json`, and `src/index.ts`.

### Discoverability, ASCII Four-View Architectural Topology & Level 1 SBOM Stand 2026-10-01 (Pfad B)
- **ASCII Four-View Architectural Topology:**
  - Integrated comprehensive ASCII Four-View Architectural Topology into Section 02 (`System Architecture` / `Systemarchitektur`) across English (`README.md`) and German (`README_de.md`) documentation.
  - Formatted 4 architectural layers: `[VIEW 1: CALLER RUNTIMES & AGENT CLIENTS]`, `[VIEW 2: FILECOMMANDER MCP CORE ENGINE & DISPATCH ORCHESTRATOR]`, `[VIEW 3: FILESYSTEM RUNTIME, FORMAT REPAIR & PROCESS ISOLATION]`, and `[VIEW 4: AIR-GAP DEFENSE PERIMETER, RUNASINVOKER & CONTROLLED EGRESS]` with German equivalent (`[SICHT 1]`..`[SICHT 4]`).
- **Synchronized Badges & Level 1 SBOM Stand 2026-10-01:**
  - Synchronized `Last-Checked` and `Verified` badges to `2026-10-01` across `README.md` and `README_de.md`.
  - Re-audited Level 1 SBOM in `THIRD_PARTY_LICENSES.md` (Stand: 2026-10-01) and plain-text companion `THIRD_PARTY_LICENSES.txt` (Audited: 2026-10-01).
  - Synchronized `llms.txt` header to `Last-checked: 2026-10-01`.
- **Strict Version Freeze Discipline (T-20260920-167562623):**
  - Semantic version `1.11.5` maintained strictly unchanged across `package.json`, `package-lock.json`, `server.json`, `glama.json`, and `src/index.ts`.
- **Marketing Log & Contract Test Suite Extension:**
  - Recorded Section 13 in `MARKETING-LOG.txt`.
  - Expanded `test/metadata-parity.test.ts` with assertions validating ASCII 4-View Architectural Topology, Stand 2026-10-01 audit timestamps, and Section 13 in marketing log.

### Repository Hygiene, Level 1 SBOM Text Companion & Contract Tests (Pfad A)
- **CI/CD Lifecycle Workflows & Multi-OS Matrix Verification:**
  - Verified and asserted GitHub Actions CI matrix coverage across Node 20, 22, and 24 on `ubuntu-latest`, `windows-latest`, and `macos-latest` with build, test, and dry-run packaging checks.
  - Verified automated PR assignment (`auto-assign.yml` with `actions/github-script@v7`) and governance label synchronization (`label-sync.yml` with `EndBug/label-sync@v2`).
- **Canonical Lock System & Multi-Host Cloud-Sync Defense in `.gitignore`:**
  - Extended multi-host conflict patterns (`*-IDEAPAD*`, `*_WORKSTATION*`, `*_WORKSTATION-LG*`, `*-WORKSTATION.*`, `*-WORKSTATION-LG.*`).
  - Added OS and editor temporary artifact patterns (`ehthumbs.db`, `*.swo`) and test caches (`.pytest_temp/`, `.pytest_tmp*/`).
- **Level 1 SBOM Plain-Text Companion (`THIRD_PARTY_LICENSES.txt`):**
  - Generated and verified canonical plain-text Level 1 SBOM companion file for air-gapped deployments, RAG ingestion, and terminal audits.
  - Linked `THIRD_PARTY_LICENSES.txt` in `NOTICE`, `package.json` (`files` whitelist), `THIRD_PARTY_LICENSES.md`, `README.md`, `README_de.md`, and `llms.txt`.
- **Strict Version Freeze Discipline (T-20260920-167562623):**
  - Preserved semantic version `1.11.5` strictly unchanged across `package.json`, `package-lock.json`, `server.json`, `glama.json`, and `src/index.ts`.
- **Automated Contract Test Suite Expansion (`test/metadata-parity.test.ts`):**
  - Expanded contract test suite with assertions validating plain-text SBOM presence and completeness, extended `.gitignore` patterns, and bilingual documentation badges, bringing the test baseline to 303 passed tests (232 Vitest + 71 standalone i18n checks) | 100% green.

### Discoverability, Visual Architecture & 18-Point Bilingual Navigation Parity (Pfad B)
- **18-Point Bilingual Navigation Parity & Dual Reciprocal Anchors:**
  - Synchronized comprehensive 18-point navigation structure across English (`README.md`) and German (`README_de.md`) documentation with reciprocal `<a id="sec-01">` .. `<a id="sec-18">` HTML anchor aliases and semantic fallbacks.
- **Persona Profiles & High-Intent SEO Queries:**
  - Codified explicit operational profiles, pain points, and tool solutions for `[PERSONA-01]` Autonomous AI Coding Agents & LLM Swarms, `[PERSONA-02]` DevOps & Multi-Host Automation Engineers, `[PERSONA-03]` SecOps & Compliance Officers, and `[PERSONA-04]` Enterprise Platform Architects alongside targeted discovery queries.
- **5-Way Comparative Matrix & Invariant Cross-References:**
  - Explicitly mapped the 10 comparative dimensions to system runtime invariants (`INV-LOCAL-01` through `INV-SLA-10`) contrasting FileCommander (50 tools) against Official Filesystem MCP, Desktop Commander, Direct Host Shell, and Ad-Hoc Scripts.
- **Level 1 SBOM Transparency & Invariant Matrix (`THIRD_PARTY_LICENSES.md`):**
  - Updated inventory audit stamp to `Stand: 2026-09-23`, added the Level 1 SBOM Invariant Cross-Reference Matrix table, and re-certified unprivileged user-mode `RunAsInvoker` execution and Zero-Copyleft isolation (100% permissive licenses).
- **Machine-Readable Documentation (`llms.txt`):**
  - Updated context manifest audit date to `Last-checked: 2026-09-23` asserting 299 passed tests baseline across Node 20-24.
- **Statutory Notice (§ 521 BGB) & 48h Security Response SLA:**
  - Codified German statutory notice under § 521 BGB Gefälligkeitsrecht and binding 48h initial security response commitment across Section 18 of both READMEs.
- **Automated Contract Test Suite Expansion (`test/metadata-parity.test.ts`):**
  - Expanded contract assertions to strictly validate the 18-point bilingual navigation parity, dual HTML anchor aliases, persona tags, § 521 BGB disclaimers, and Stand 2026-09-23 audit timestamps.

## [1.11.5] - 2026-09-20

### Repository Hygiene, CI Timeout Hardening & Multi-Host Defense (Pfad A)
- **CI Workflow Timeout & Concurrency Hardening:**
  - Hardened all 5 GitHub Actions workflows (`tests.yml`, `stale.yml`, `welcome.yml`, `auto-assign.yml`, `label-sync.yml`) with explicit job `timeout-minutes` (15m for tests, 10m for stale, 5m for welcome/auto-assign/label-sync).
  - Added workflow-level `concurrency` controls with `cancel-in-progress: true` across `welcome.yml`, `auto-assign.yml`, and `label-sync.yml` to prevent stale queued runs from wasting GitHub Actions runner minutes.
- **Canonical Lock System & Multi-Host Cloud-Sync Defense in `.gitignore`:**
  - Integrated canonical multi-agent lock patterns (`LOCK`, `LOCK.*`, `LOCK*.txt`, `LOCK.user.*`, `LOCK.until.*`, `LOCK.condition.*`, `LOCK.permissions.json`, `.automation-lock`) and multi-host conflict patterns (`*conflicted copy*`, `* (Kopie)*`, `* (Copy)*`, `*-WORKSTATION*`, `*-WORKSTATION-LG*`, `*-LAPTOP*`, `*-ASUS*`, `*-ASUS-GEI*`, `*-Mac Studio*`, `*-MacBook*`).
  - Added build/cache ignore patterns (`.hypothesis/`, `.turbo/`, `.nyc_output/`).
- **Open-Source Legal Attribution (`NOTICE`):**
  - Added canonical `NOTICE` attribution file anchored under the `open-bricks` open-source umbrella with Level 1 SBOM reference and included it in the `package.json` `files` whitelist for npm distribution.
- **Synchronized Version Bump (v1.11.5):**
  - Synchronized semantic version `1.11.5` across `package.json`, `package-lock.json`, `server.json`, `glama.json`, and `src/index.ts`.
- **Third-Party Licensing Inventory (`THIRD_PARTY_LICENSES.md`):**
  - Updated inventory audit stamp to `2026-09-20` and re-audited Level 1 SBOM transparency and unprivileged RunAsInvoker non-elevation guarantees.
- **Contract Test Suite Expansion (`test/metadata-parity.test.ts`):**
  - Added automated contract tests asserting all 5 CI workflows enforce timeout limits and concurrency guards, verifying `NOTICE` presence and attribution, testing canonical lock system and conflict ignore patterns in `.gitignore`, and asserting version `1.11.5` parity across all manifests. Total test suite verified at 299 tests (228 Vitest + 71 standalone i18n checks) | 100% green.

## [1.11.4] - 2026-09-19

### Bugfix: fc_str_replace Literal String Replacement (T-20260919-384678872)
- **Literal String Replacement in `fc_str_replace`:**
  - Fixed an issue where `String.prototype.replace(old_str, new_str)` interpreted special JavaScript replacement patterns in `new_str` (e.g., `$\`` inserting the prefix before match, `$'` inserting suffix, `$&` inserting matched string, `$1..$n` inserting captures).
  - When replacing with Windows administrative share paths (such as `C$`) or expressions containing dollar-backtick, entire file contents preceding the match were unintentionally duplicated into the replacement line.
  - Replaced naive string replacement with exact substring slicing (`content.substring(0, changeIndex) + params.new_str + content.substring(...)`), guaranteeing 100% literal replacement for all dollar signs, special characters, and code snippets.
  - Added regression test suite asserting literal preservation of `$\``, `$'`, `$&`, `$$`, and `$1` without regex or pattern expansion.

## [1.11.3] - 2026-09-19

### AI Security & Dependency Audit, Supply-Chain Hardening & 30-Day SLA
- **Supply-Chain Security & Vulnerability Remediation (npm audit: 0 vulnerabilities):**
  - **`adm-zip` (High Severity GHSA-vwc7-r8mq-g2x9 & GHSA-7q85-xj36-vmfc):** Upgraded `adm-zip` from `^0.6.0` to `^0.6.1` to eliminate arbitrary file overwrite via destination symlinks during archive extraction and prevent memory exhaustion (DoS).
  - **`js-yaml` (High Severity GHSA-2883-xcg3-v3hh):** Upgraded `js-yaml` from `^4.3.1` to `^4.3.2` fixing unconstrained CPU utilization on empty merge sources (DoS).
  - **`smol-toml` (High Severity GHSA-7w5x-hrqm-74c2):** Upgraded `smol-toml` from `^1.6.0` to `^1.8.0` preventing DoS via malformed TOML structures.
  - **`hono` (Moderate Severity GHSA-gqvv-2mrq-wpjv, GHSA-g6gw-c38x-mqfc, GHSA-crvj-82cr-hjcx):** Updated dependency override to `^4.13.8` resolving SSG directory traversal and unbounded body nesting DoS.
  - **`vitest` / `@vitest/mocker` (Moderate Severity GHSA-82fw-gwwq-j7x9):** Upgraded devDependency from `^4.1.9` to `^4.1.11` to patch path traversal and arbitrary file read via mock redirects.
  - Verified `npm audit` exits with code 0 and confirms **0 vulnerabilities** across all 215 audited packages.
- **Gitignore Security & Multi-Host Protection:**
  - Removed `TODO.md` from `.gitignore` to restore version-controlled roadmap and task tracking.
  - Added explicit exclusions for SSL/TLS certificates and key exchanges (`*.crt`, `*.cert`, `*.csr`), packaging credentials (`.pypirc`), authentication tokens and secrets (`*.token`, `*.secret`, `credentials.json`), wildcard SSH keys (`id_rsa*`, `id_ed25519*`, `id_ecdsa*`, `id_dsa*`), and patch residue artifacts (`*.orig`, `*.rej`).
- **30-Day Remediation SLA in Security Policy (`SECURITY.md`):**
  - Formally codified binding 30-calendar-day remediation SLA commitment in English and German for critical and high-severity security vulnerabilities.
- **Third-Party Licensing Inventory (`THIRD_PARTY_LICENSES.md`):**
  - Updated inventory audit stamp to `2026-09-19` and synchronized version ranges for `adm-zip` (`^0.6.1`), `js-yaml` (`^4.3.2`), `smol-toml` (`^1.8.0`), and `vitest` (`^4.1.11`).
- **Parity & Security Contract Tests:**
  - Expanded `test/metadata-parity.test.ts` to assert 0 vulnerabilities, version `1.11.3` parity, 30-day remediation SLA presence, and comprehensive `.gitignore` credential and certificate patterns.

## [1.11.2] - 2026-09-13

### Discoverability, Target Personas & 5-Way Comparative Matrix (Pfad B)
- **16-Point Quick Navigation Parity:** Synchronized complete 16-point navigation bars across `README.md` and `README_de.md` with 1:1 mutual anchor integrity (`#target-personas--discoverability`, `#zielgruppen--auffindbarkeit`, `#comparative-matrix--alternatives`, `#vergleichsmatrix--alternativen`).
- **4 Dedicated Target Personas:** Codified explicit persona profiles, operational pain points, and tool solutions in English and German for Autonomous AI Coding Agents & LLM Swarms, DevOps & Multi-Host Automation Engineers, SecOps & Compliance Officers, and Enterprise Platform Architects.
- **5-Way Comparative Matrix Across 10 Operational Dimensions:** Upgraded the comparison section across both READMEs to contrast FileCommander (50 tools) against the Official Filesystem MCP, Desktop Commander, direct host shells (`bash`/PowerShell), and ad-hoc scripts across tool scope, safe deletion/trash, cloud-lock resilience, bounded search with secret masking, async scans, interactive REPLs, self-healing repairs, multi-format transformation, document utilities, and local-first governance SLAs.
- **Discoverability Register & LLM Context:** Expanded `MARKETING-LOG.txt` with high-intent keyword search matrices (EN/DE), 5-way comparative matrix, and audit records; synchronized `llms.txt` `Last-checked` timestamp to `2026-09-13`.
- **Contract Test Suite Expansion:** Extended `test/metadata-parity.test.ts` to assert 16-point navigation, target personas, 5-way comparative matrix dimensions, and discoverability log integrity across 291 automated checks (220 Vitest + 71 standalone i18n checks).

### Repository Hygiene & Multi-Host Sync Hardening (Pfad A)
- **Version Bump (v1.11.2):** Synchronized semantic patch version across `package.json`, `package-lock.json`, `server.json`, `glama.json`, and `src/index.ts` (@version & server metadata).
- **.gitignore Hardening:** Added explicit multi-host sync conflict protection patterns (`*-ASUS-GEI.*`, `*-WORKSTATION-LG.*`, `*-WORKSTATION.*`, `* (kopie)*`, `* (copy)*`), Python/multi-agent lock hygiene (`uv.lock`, `LOCK`, `LOCK.permissions.json`), and coverage wildcard artifacts (`.coverage.*`, `coverage/`).
- **Automated Contract & Parity Test Expansion:** Added automated Vitest contract tests to `test/metadata-parity.test.ts` asserting multi-host gitignore patterns, release changelog integrity, and active marketing governance verification, bringing total verified tests to 289 passed (218 Vitest + 71 standalone i18n checks).
- **Documentation & Context Synchronization:** Updated `llms.txt` `Last-checked` timestamp to `2026-09-11`, updated test count references to 289 across `README.md`, `README_de.md`, `llms.txt`, and `MARKETING-LOG.txt`.

## [1.11.1] - 2026-09-10

### Discoverability, Visual Architecture & Governance Invariants (Pfad B)
- **10 Governance & Runtime Invariants (`INV-LOCAL-01` to `INV-SLA-10`):** Codified formal invariant IDs across `README.md`, `README_de.md`, `llms.txt`, and `MARKETING-LOG.txt` covering local stdio isolation, trash protection, cloud-lock resilient move/diagnostics, bounded multi-file search, secret redaction, bounded inline previews, REPL circular ring buffers, unprivileged execution, and 48h SLA.
- **Third-Party Dependency & Licensing Review (`THIRD_PARTY_LICENSES.md`):** Complete inventory and license compatibility audit for all runtime (`@modelcontextprotocol/sdk`, `@types/node`, `tesseract.js`) and dev dependencies, ensuring 100% MIT-permissive alignment.
- **Marketing & Discoverability Log (`MARKETING-LOG.txt`):** Structured register detailing product identity (50 tools), 4 target personas (Autonomous Agent Developers, DevOps & Sysadmins, Cross-Platform Desktop Power Users, Enterprise MCP Integrators), 10 architectural invariants, sibling ecosystem matrix (12 desktop apps, 9 MCP servers, 8 AI infrastructure projects), and automated verification status.
- **Bilingual Documentation Parity & Quick Navigation:** Synchronized 16-point navigation bars across `README.md` and `README_de.md`, updated test assertions metric to 286 passed checks, and embedded explicit links to `MARKETING-LOG.txt` and `THIRD_PARTY_LICENSES.md`.
- **Packaging & Parity Contract Expansion:** Included new documentation manifests in `package.json` `"files"` whitelist, updated `llms.txt` `Last-checked: 2026-09-10`, and expanded `test/metadata-parity.test.ts` to assert invariant IDs and new documentation files.

## [1.11.1] - 2026-09-09

### Repository Hygiene, Security Hardening & Parity Tests (Pfad A)
- **.gitignore Hardening:** Shielded repository against multi-host conflict copies (`*.sync-conflict-*`, `*.conflict`, `*-CONFLIT-*`, `*-conflict-*`), multi-agent locks (`LOCK.*`, `*.lock`, `LOCK*.txt` while preserving `!package-lock.json`), temporary backup files (`*.tmp`, `*.bak`, `*.swp`, `*~`), and test/linter caches.
- **Bilingual Security Policy SLAs:** Hardened `SECURITY.md` in English and German with umbrella organization contact (`security@open-bricks.org`), direct developer contacts, 48-hour initial response SLA, 5 business days triage commitment, and supported versions table (`1.11.x`).
- **Automated Contract & Parity Test Suite:** Expanded `test/metadata-parity.test.ts` to 10 Vitest contract tests (286 passed checks: 215 Vitest + 71 i18n) covering version parity across `package.json`, `server.json`, `glama.json`, `package-lock.json`, and `src/index.ts`, `.gitignore` patterns, CI packaging dry-run gates, security SLAs, and discoverability.
- **Cloud Lock Context Distinction:** `fc_check_cloud_lock` now distinguishes static cloud-path context from an active rename lock. It reports target existence/type and explicitly marks Cloud Files hydration and process-handle checks as not checked when unavailable, rather than treating `cldflt.sys` plus a OneDrive path as a confirmed `HIGH` lock.
- **Documentation & Badges:** Synchronized Shields.io test badges to 286 passed tests and updated `llms.txt` `Last-checked` timestamp to `2026-09-09`.

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

## [1.11.0] - 2026-08-30

### Remote/headless open-path contract
- Return a validated `fc_open_path` `outputSchema` and `structuredContent` with `launcher_accepted`, the invariant `user_visible: "unknown"`, and a machine-readable fallback tool plus arguments on both accepted and rejected launcher requests.
- Add read-only `fc_preview_file`: metadata and MIME type first, content only after explicit `include_content=true`, and a fixed 1 MiB inline limit checked before any file read or Base64 encoding.
- Use standard MCP text and image content blocks plus bounded embedded resources for PDFs; unsupported media types remain metadata-only.
- Synchronize the 50-tool surface, six runtime languages, EN/DE documentation, security policy, manifests, and tests.

## [1.10.4] - 2026-08-26

### Native default-handler path opening
- Add `fc_open_path` for existing local files and directories on Windows, macOS, and Linux, with fixed native launchers and no shell interpolation of the target path.
- Report only that the native launch request was accepted; do not claim that a graphical application became visible.
- Add native output for all six runtime languages and document the trust boundary relative to `fc_start_process` and `fc_execute_command`.
- Expand the real-path, injection-boundary, MCP annotation, registry, and localization contracts to 202 Vitest checks plus 69 standalone i18n checks (271 total); publish a synchronized 49-tool surface.

## [1.10.3] - 2026-08-26

### Runtime language introspection
- Add the read-only `fc_get_language` MCP tool to report the active language and the stable list of six supported runtime languages.
- Classify the new tool explicitly as read-only, non-destructive, idempotent, and local-only through standard MCP annotations.
- Add native result text for German, English, Spanish, Chinese, Japanese, and Russian.
- Add a real stdio integration contract for the 48-tool surface and every supported language switch; synchronize manifests, bilingual documentation, and 261 automated checks.

## [1.10.2] - 2026-08-26

### Security metadata and explicit trust boundaries
- Add all four standard MCP security annotations to every one of the 47 tools and move `fc_set_language` to the annotated `registerTool` API.
- Classify arbitrary command, background-process, and interactive-session entry points conservatively as potentially destructive; classify OCR output and archive writes explicitly.
- Replace runtime-generated OCR import code with `createRequire` for the optional `tesseract.js` dependency.
- Correct the bilingual security documentation: stdio transport has no telemetry or automatic egress, while an explicit `fc_web_fetch` call performs outbound HTTP(S) access.
- Document that safe mode redirects only the two delete tools and does not sandbox command or interactive-session tools.
- Add four regression tests for annotation completeness, high-risk classifications, OCR loading, and bilingual security-boundary parity (257 total checks).

## [1.10.1] - 2026-08-25

### Discoverability, README Navigation & CI Matrix Concurrency (Pfad B)
- **Bilingual README Quick Navigation:** Enriched quick navigation bars in `README.md` and `README_de.md` with comprehensive section anchor jump targets covering architecture, capabilities, configuration, comparisons, discoverability, security, and ecosystem.
- **Core Capabilities & Safety Invariants Matrix:** Integrated bilingual capability and invariant matrices detailing 100% Local-First & Zero-Egress guarantees, Safe Deletion & Trash routing, Cloud-Lock resilience (`fc_move` & `fc_check_cloud_lock`), bounded content search, secret redaction, unprivileged non-elevation execution, and multi-format conversions.
- **CI Workflow Concurrency Hardening:** Enhanced GitHub Actions CI (`.github/workflows/tests.yml`) with concurrency groups and `cancel-in-progress: true` to prevent redundant runner execution on rapid pushes.
- **Test Badges & Contract Parity Suite:** Synchronized README test badges to 253 passed tests (184 Vitest + 69 i18n assertions); expanded `test/metadata-parity.test.ts` to 9 automated contract tests verifying CI concurrency, bilingual capabilities parity, navigation anchors, and `llms.txt` freshness (`2026-08-25`).

## [1.10.1] - 2026-08-21

### Technical Hygiene, CI Multi-OS Matrix & Bilingual Security Policy (Pfad A)
- **GitHub Actions CI Modernization:** Upgraded `.github/workflows/tests.yml` to official modern actions (`actions/checkout@v4`, `actions/setup-node@v4` with npm cache), multi-OS matrix (`ubuntu-latest`, `windows-latest`, `macos-latest`), and Node.js matrix (`[20, 22, 24]`).
- **Bilingual Security Policy (`SECURITY.md`):** Comprehensive English and German security documentation covering Local-First & Zero-Egress guarantees, unprivileged User-Mode execution (Non-Elevation), Safe Mode routing (`fc_set_safe_mode`), Cloud-Lock resilience (`fc_check_cloud_lock`), tool risk classifications, direct contact endpoints (`security@ellmos.ai`, `support@lukasgeiger.com`, `lukas@open-bricks.org`), and supported versions table.
- **Automated Contract & Parity Test Suite:** Expanded `test/metadata-parity.test.ts` (8 contract tests, 100% green) validating version parity, 47-tool manifest consistency, package release files, bilingual security policy, multi-OS CI workflow, and LLM documentation freshness.
- **Documentation & Badges:** Added CI status badge, Zero-Egress security badge, quick navigation bar in `README.md` and `README_de.md`, updated sibling server tool counts (`Blender Use: 5`, `Open Compute: 16`), and synchronized `llms.txt` Last-checked timestamp to `2026-08-21`.
- **Integrated Test Runner:** Updated `npm test` script to seamlessly run Vitest (181 tests) and i18n test runner (69 tests) in unified automated execution (250 tests total, 100% green).

## [1.10.1] - 2026-08-16

### Discoverability, README-Design & Metadata Parity (Pfad B)
- **Badges & Visual Discovery:** Synchronized README badges across `README.md` & `README_de.md` including full test suite (179 vitest + 69 i18n passed, 100% green), Node.js (>=20), Safe Delete (Recycle Bin / Trash), `ellmos-ai` organization, `open-bricks` umbrella, and `llms.txt` discovery badges.
- **Interactive Sequence Diagrams:** Integrated bilingual Mermaid execution sequence diagrams illustrating the 2-step Safe Deletion fallback and resilient Cloud-Lock (OneDrive/Dropbox) recovery flow.
- **Ecosystem & Sibling Matrix:** Extended cross-linking to sibling MCP servers (`Blender Use`, `Open Compute`) and companion desktop applications across `open-bricks` and `file-bricks` (`ProFiler`, `ExplorerPro`, `WinStorePackager`, `SoftwareCenter`, `SQLiteViewer`, `MediaBrain`, `DevCenter`, `CodeBox`).
- **Metadata Parity Test Suite:** Added automated Vitest parity test suite in `test/metadata-parity.test.ts` (6/6 passed) validating version parity (`package.json`, `server.json`, `glama.json`), 47-tool manifest consistency, package release files, and LLM documentation freshness.
- **LLM Indexing:** Synchronized `llms.txt` Last-checked timestamp to `2026-08-16` and refreshed tool family overview.

## [1.10.0] - 2026-07-29

### Maintenance & Discoverability (2026-08-14)
- Update `llms.txt` Last-checked timestamp to `2026-08-14`.
- Complete all 47 tool entries in `README.md` and `README_de.md` by documenting `fc_set_language` in the System tools tables.
- Add MCP Tools (47), Vitest suite (175 passed), and organization badges to `README.md` and `README_de.md`.
- Synchronize system architecture Mermaid diagrams with exact 47-tool category mapping.
- Re-verify TypeScript build (`npm run build`), full Vitest suite (175/175 tests passed), and i18n test suite (69/69 passed).

### Security (2026-08-05)
- Close both open Dependabot advisories via lockfile update: `fast-uri`
  (high, GHSA-7p8r-x3mc-p8w7 — host confusion via backslash authority
  introducer) and `hono` (moderate, GHSA-8j4g-w8fx-2239 — ReDoS in the CORS
  middleware). `npm audit` reports 0 vulnerabilities; build and 175/175
  Vitest tests stay green.

### Maintenance & Technical Hygiene (2026-08-04)
- Update `llms.txt` Last-checked timestamp to `2026-08-04`.
- Fix canonical repository branch reference (`master`) in `llms.txt` documentation links.
- Re-verify TypeScript build (`npm run build`) & Vitest unit test suite (`175/175 passed`).

### Documentation & Discoverability (2026-08-03)
- Replace the legacy opaque Glama URL with the canonical owner-based listing URL in both READMEs and `llms.txt`.

### Maintenance & Discoverability (2026-07-30)
- Update `llms.txt` Last-checked timestamp to `2026-07-30`.
- Add open-bricks ecosystem cross-reference badge to README & German README documentation.
- Verify full test suite (175/175 passed across 4 test files).

### Added
- Add the read-only `fc_search_content` tool for deterministic literal or
  regular-expression search across an explicit ordered list of files.
- Add case sensitivity, bounded context, global and per-file match limits,
  binary/UTF-8/size guards, per-file partial errors, and common-secret
  redaction.
- Localize the complete tool surface in all six runtime language packs.

### Safety
- Do not expand globs, traverse directories, or recurse from
  `fc_search_content`; callers must supply every file path explicitly.
- Bound input paths, query length, file size, excerpts, context, matches, and
  serialized output.
- Redact complete private-key blocks, quoted credentials, bearer tokens, and
  common token formats from both matching lines and returned context.

### Verification
- Add unit coverage for ordering, literal/regex behavior, Unicode case,
  context, limits, non-recursion, binary/encoding/size handling, partial
  errors, output bounds, and secret redaction.

## [1.9.6] - 2026-07-28

### Added
- Add SHA-384 support to `fc_checksum` and cover the digest length in the test suite.

### Security
- Upgrade `@modelcontextprotocol/sdk` to 1.30.x and require
  `@hono/node-server` 2.0.12 or newer to resolve the Windows encoded-backslash
  path-traversal advisory GHSA-frvp-7c67-39w9.

### Changed
- Raise the minimum supported Node.js version from 18 to 20, matching the
  secure Hono Node adapter and the existing Node.js 20/22/24 CI matrix.

### Verification
- Verify the TypeScript build, 162 Vitest tests, 66 standalone i18n checks,
  production dependency audit, and npm package dry-run.
- Align the runtime startup banner with the current `ellmos FileCommander` name.

### Migration
- Move the canonical Git worktree out of OneDrive under Plan D. OneDrive keeps a
  `.git`-less tracked-file mirror plus a cloud-readable repository pointer.

## [1.9.5] - 2026-07-26

### Documentation & Discoverability
- Synchronize tool counts (46 tools) across `README.md`, `README_de.md`, and `llms.txt`.
- Add GFM LLM Integration Note (`> [!NOTE]`) for AI agent discoverability.
- Add Mermaid System Architecture flowcharts to both `README.md` and `README_de.md`.
- Update `llms.txt` verification timestamp to 2026-07-26.

## [1.9.4] - 2026-07-25

### Maintenance
- Update `llms.txt` Last-checked header to 2026-07-25.
- Align version annotations (1.9.4) across `src/index.ts`, `package.json`, `server.json`, and `glama.json`.
- Verify Vitest test suite (161 unit tests), i18n test suite (66 tests, 227 total passing), and TypeScript build.

## [1.9.3] - 2026-07-24

### Fixed
- Correct FileCommander (46) and CodeCommander (22) tool counts in the ecosystem family table; counts now verified against the live MCP `tools/list` surface.
- Align the McpServer runtime version in `src/index.ts` with package.json (was stuck at 1.9.1).

## [1.9.2] - 2026-07-24

### Changed
- Unified the ellmos-ai ecosystem section in README.md and README_de.md: full 9-server MCP family table with refreshed tool counts, AI infrastructure, and desktop software links.
- Refreshed `glama.json` for the Glama MCP directory listing.
- Synced `server.json` version metadata.

## [1.9.1] - 2026-07-06

### Security
- Harden `fc_web_fetch` link/text sanitization, resolving 5 CodeQL `high` code-scanning alerts:
  - `js/double-escaping`: unescape `&amp;` last in the HTML→text pass so a produced `&` cannot be re-read as the start of another entity (`&amp;lt;` now yields literal `&lt;` instead of `<`).
  - `js/incomplete-multi-character-sanitization`: strip tags in the parsed link text in a loop until stable, so removing one tag cannot re-form a new one.
  - `js/incomplete-url-scheme-check`: filter parsed link URLs with an http/https allowlist (also drops `data:`, `vbscript:`, `blob:`) instead of a scheme blocklist; `javascript:`, `mailto:`, `tel:` and fragment-only links stay dropped.
- Defense-in-depth only: parsed link output is reported to the caller, not auto-fetched; the fetch path remains guarded by the existing SSRF allowlist (`fcWebGuardTarget`, unchanged).

## [1.9.0] - 2026-07-05

### Added
- Add `fc_web_fetch`: read-only network tool that fetches a web page and returns content by `mode` (extract=clean main text, raw=HTTP body, links, forms, headers). First online tool in FileCommander; uses Node native `fetch` (no new dependency). SSRF guard blocks internal/private/loopback targets by default (`allow_private` to override); 5 MB size cap and configurable timeout. Description localized in all 6 languages. The full, portable version (incl. screenshot) lives in the `web-scraper` module.
- Replace the Spanish, Chinese, Japanese, and Russian i18n fallback stubs with full FileCommander runtime translations.
- Add an i18n regression test covering localized core messages, interpolation, and stub removal for all four language packs.

### Fixed
- Use `-EncodedCommand` (Base64/UTF-16LE) for PowerShell execution instead of string interpolation, preventing injection via metacharacters (`$`, backtick, `&`). Fixes CodeQL `js/incomplete-string-escaping` alert.

### Documentation
- Update README test counts to 154 after adding the i18n regression coverage.
- Refresh discoverability metadata for the current 44-tool FileCommander release, including jsDelivr and LobeHub visibility, cached third-party directory caveats, and additional Cloud-Lock/OCR/ZIP search phrases.

## [1.8.2] - 2026-06-17

### Fixed
- Correct version mismatch in banner/description display (1.7.10 → 1.8.0) and improve OCR `fc_ocr` error handling for edge cases.
- Align `package.json`, lockfile, MCP runtime version, source header, and `server.json` metadata after the update-notifier release.
- Refresh npm dependency locks so production audit findings for `hono` and `js-yaml` are resolved.

### Changed
- Bump `@modelcontextprotocol/sdk` from 1.27.1 to 1.29.0.
- Add a TTY-guarded `update-notifier` check for interactive CLI starts while keeping MCP stdio output unchanged.

### CI
- Add a dedicated GitHub Actions test workflow for Node.js 20, 22, and 24. The workflow runs `npm ci`, TypeScript build, Vitest, and an npm package dry-run on pushes and pull requests.
- Lock `@emnapi/core` and `@emnapi/runtime` as dev dependencies so Linux `npm ci` resolves Vitest/Rolldown optional WASM peer dependencies deterministically.

### Documentation
- Move the `llms.txt` last-checked marker to the top of the file and normalize search phrases into a crawler-friendly fenced code block.
- Ignore local automation protocol files via `*-protocoll.txt`.
- Normalize `package.json` repository metadata to npm's `git+https` form.

## [1.8.0] - 2026-05-31

### Added
- **Cloud-lock-safe file operations**: `fc_move`, `fc_batch_rename`, and `fc_safe_delete` now automatically fall back to copy+delete when the Windows Cloud Files filter (`cldflt.sys`) or other file locks block `rename()`. Triggered on EPERM, EACCES, EXDEV, and EBUSY errors.
- **`fc_check_cloud_lock`** — New read-only diagnostic tool that checks whether a path is at risk of cloud-sync lock conflicts. Reports driver status, sync folder detection, and risk level. Windows-only (graceful no-op on macOS/Linux).
- Empirical cloud-lock test (`test/empirical_cloud_lock.mjs`) using real Windows file locks to verify the fallback path.
- 7 new unit tests for `cloudSafeRename` helper (143 total tests).
- Full i18n (DE/EN) for all new features.
- Total tools: 44

### Changed
- Include `server.json` in the npm package so official MCP Registry metadata ships with the published artifact.
- Rename the official registry title from legacy "BACH FileCommander" to "ellmos FileCommander".
- Update community workflows to `actions/stale@v10` and `actions/first-interaction@v3` with current input names.
- Refresh README/README_de and `llms.txt` discovery notes for Glama, npm, and the ellmos MCP family.

## [1.7.10] - 2026-05-23

### Fixed
- Refresh npm lockfile and overrides to resolve Dependabot alerts for `fast-xml-builder`, `fast-uri`, `hono`, and `ip-address`.
- Update dev dependency lockfile path away from vulnerable Vite/esbuild ranges.

## [1.7.9] - 2026-05-17

### Added
- Comprehensive test suite with 136 tests covering all 43 tools (vitest)
- Cross-platform compatibility verified on Windows, macOS, and Linux
- Development/Testing section in README.md and README_de.md

## [1.7.2] - 2026-02-20

### Fixed
- Update CHANGELOG with 5 missing version entries (v1.5.0-v1.7.1)
- Fix server.json version mismatch
- Update SECURITY.md supported versions (1.3.x -> 1.7.x)
- Add missing runtime dependencies to THIRD_PARTY_NOTICES.md
- Remove stale "NEW in v1.4.0" label from README

## [1.7.1] - 2026-02-17

### Changed
- Replace custom TOON parser/serializer with official `@toon-format/toon` package
- Proper TOON format: `key: value` syntax instead of custom `key = value`

## [1.7.0] - 2026-02-17

### Added
- `fc_ocr` - Extract text from images via optional tesseract.js dependency
- `fc_archive` - Create, extract, and list ZIP archives (via adm-zip)
- `fc_checksum` - File hashing (MD5, SHA-1, SHA-256, SHA-512) with optional compare
- `fc_set_safe_mode` - Toggle safety mode: route all deletes through Recycle Bin / Trash
- Expand `fc_convert_format`: add YAML, TOML, XML, and TOON support (was JSON/CSV/INI only)
- Full i18n (DE/EN) for all new tools
- Total tools: 43

## [1.6.1] - 2026-02-17

### Added
- `mcpName` field in package.json for MCP Registry verification
- `server.json` for official MCP Registry publishing

## [1.6.0] - 2026-02-17

### Added
- `fc_md_to_pdf` - Real PDF generation via headless Edge/Chrome browser
- Cross-platform browser detection (Windows, macOS, Linux)
- Fallback to HTML output if no browser is available
- Total tools: 39

## [1.5.0] - 2026-02-15

### Added
- Complete internationalization (i18n) infrastructure with German (default) and English support
- New `fc_set_language` tool for runtime language switching
- `FC_LANGUAGE` environment variable for startup configuration
- ~270 translated strings (tool titles, descriptions, error messages, weekdays)
- i18n test suite (66 tests)
- Language priority: `fc_set_language` > `FC_LANGUAGE` env > `"de"` default

## [1.4.1] - 2026-02-14

### Fixed
- `fc_md_to_html` completely rewritten: line-by-line parser instead of regex chain
- Added: nested lists, ordered lists, blockquotes, checkboxes, badge images, standalone images
- Added: bold+italic combo (`***text***`), proper `<thead>/<tbody>` tables
- Professional CSS: dark code blocks, colored headers, print-ready layout

## [1.4.0] - 2026-02-14

### Added
- `fc_fix_json` - Repair common JSON errors (BOM, trailing commas, single quotes, comments, NUL bytes)
- `fc_validate_json` - Validate JSON with detailed error position and context
- `fc_cleanup_file` - Clean files: remove BOM, NUL bytes, trailing whitespace, normalize line endings
- `fc_fix_encoding` - Fix Mojibake and double-encoded UTF-8 (27+ patterns for German, French, Spanish)
- `fc_folder_diff` - Track directory changes (new/modified/deleted files) with snapshots
- `fc_batch_rename` - Pattern-based batch renaming (prefix/suffix removal, replace, auto-detect)
- `fc_convert_format` - Convert between JSON, CSV, and INI formats
- `fc_detect_duplicates` - Find duplicate files using SHA-256 hashing with size pre-filter
- `fc_md_to_html` - Convert Markdown to styled HTML (printable as PDF via browser)
- Total tools: 38

## [1.3.0] - 2026-02-14

### Changed
- Project prepared for public open-source release
- README rewritten in English for international audience
- Added LICENSE (MIT), SECURITY.md, CONTRIBUTING.md
- Package metadata updated for NPM publishing

## [1.2.1] - 2025-01-05

### Added
- `fc_str_replace` - String replacement tool with unique-match validation
- Total tools: 29

### Fixed
- `fc_safe_delete` PowerShell escaping for paths with special characters
- `&` character handling in Windows paths (PowerShell fallback)

## [1.2.0] - 2025-01-05

### Added
- Async Search system (5 tools): `fc_start_search`, `fc_get_search_results`, `fc_stop_search`, `fc_list_searches`, `fc_clear_search`
- `fc_safe_delete` - Moves files to Recycle Bin (Windows) or Trash (macOS/Linux) instead of permanent deletion

## [1.1.0] - 2025-01-05

### Added
- `fc_read_multiple_files` - Read multiple files in one call
- `fc_edit_file` - Line-based file editing (replace/insert/delete)
- `fc_list_processes` - List running system processes
- `fc_kill_process` - Terminate processes by PID or name
- Interactive Sessions (4 tools): `fc_start_session`, `fc_read_output`, `fc_send_input`, `fc_close_session`

## [1.0.0] - 2025-01-05

### Added
- Initial release with 13 filesystem tools
- File operations: read, write, list, create directory, delete, move, copy, file info, search
- Process execution: `fc_execute_command`, `fc_start_process`
- System: `fc_get_time`
