Skip to content

fix(discovery): read JSON-with-comments config files - #206

Open
rudycelekli wants to merge 1 commit into
uber:mainfrom
rudycelekli:fix/discovery-jsonc-comments
Open

rudycelekli wants to merge 1 commit into
uber:mainfrom
rudycelekli:fix/discovery-jsonc-comments

Conversation

@rudycelekli

Copy link
Copy Markdown

What type of PR is this? (check all applicable)

  • Refactor
  • Feature
  • Bug Fix
  • Optimization
  • Documentation Update

Related issue: N/A (found by reading the code; reproduced on main at 6b33dff)

What changed?
Try strict JSON first; on JSONDecodeError strip ////* */ comments and trailing commas outside string literals and parse again.

Why?
Extractor/formats/init.py:21-23 parses "json" (incl. .jsonc, which format_for maps to json) with strict json.loads. A VS Code user mcp.json with a // ... comment or trailing comma (VS Code treats mcp.json as JSONC; its docs' examples carry comments), or Zed's settings.json (default file opens with // comment lines), raises JSONDecodeError -> whole file becomes an ExtractError, all its MCP servers are dropped.

How did you test it?

  • Reproduction: uv run --python 3.11 pytest -q adr_discovery/tests_unit/test_jsonc_configs.py -> main: 2 failed, 1 passed (declarations [] + JSONDecodeError); branch: 3 passed.
  • Test suite: Discovery pytest -q 563 passed; ruff check . clean.
  • Not tested: Zed's context_servers key is not read by _server_block at all (separate gap); this fix only removes the parse error there.

Potential risks
The change only affects the input described above; other paths go through the same code as before, and the component's existing tests pass.

AI assistance: Claude Code (model Claude Opus 5.5) found this bug, wrote the fix and test, and drafted this description; submitted by @rudycelekli.

🤖 Generated with Claude Code

VS Code's mcp.json and Zed's settings.json are JSONC, and format_for
already routes `.jsonc` to the JSON parser, but parse() used strict
json.loads. A single `//` comment or trailing comma turned the whole
file into an ExtractError, so every MCP server it declared was dropped.

Strict JSON is still tried first; only on a decode error are comments
and trailing commas outside strings removed and the text parsed again.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@CLAassistant

Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants