Skip to content

cdf v1.0.2 — Fix bootstrap config crash

Choose a tag to compare

@NeoGolightly NeoGolightly released this 26 Apr 19:12
· 11 commits to main since this release

Patch release fixing the MCP server crash that occurred when .cdf.config.yaml referenced a not-yet-existing profile_path: — i.e. the default bootstrap state for any new plugin user following the Quickstart. The MCP server reported MCP error -32000: Connection closed and the plugin was unusable until the profile YAML existed (chicken-and-egg, since the profile is what the scaffold produces).

Root cause

@formtrieb/cdf-core@1.0.2's parseConfigFile eagerly loaded the profile YAML as soon as profile_path: was set in .cdf.config.yaml, throwing ENOENT if the file didn't exist. The MCP server crashed during initialization, before any tools could register.

Fix (three coordinated patch releases)

  • @formtrieb/cdf-core@1.0.3 — parseConfigFile now existsSync-checks the profile path and, if missing, leaves ds_profile undefined while emitting one stderr warning line: [cdf-core] profile_path '...' set in ... but file does not exist (...); ds_profile not loaded. Diagnostic signal preserved for misconfigurations; bootstrap states now proceed cleanly. 4 new tests covering happy path, missing-file skip-and-warn, no-profile_path quiet path, relative-path resolution.
  • @formtrieb/cdf-mcp@1.7.2 — pins ^1.0.3 (caret range that resolves to the fixed cdf-core); no behavioural changes in the MCP server itself.
  • cdf plugin v1.0.2 — .mcp.json bumped to ^1.7.2 so npx re-resolves past stale ^1.7.1 cache entries; README Quickstart .cdf.config.yaml example now leaves profile_path: commented out on first run (uncomment after the scaffold writes the profile).

Upgrade for existing installs

claude plugin marketplace update cdf
claude plugin update cdf@cdf
# Fully quit Claude Code (Cmd+Q) and relaunch — closing the window is not enough.

If the MCP still doesn't connect after that, clear the npx cache so any stale ^1.7.1 resolution is dropped:

rm -rf ~/.npm/_cacache/_npx ~/.npm/_cacache/index-v5/_npx

…then restart Claude Code again.

Fresh install

Same two-step as v1.0.0:

claude plugin marketplace add formtrieb/cdf-plugin
claude plugin install cdf@cdf

Verify

claude mcp list | grep cdf-mcp
# Expect: plugin:cdf:cdf-mcp: npx -y @formtrieb/cdf-mcp@^1.7.2 - ✓ Connected