MCP Troubleshooting 100-Item Review
All TS-001..100 items from the submitted dsdx_mcp_troubleshooting_100.md report (SHA-256 555449d90bb25e49f79c538bb859639329983f9cd2a17d499fa8d6d91e22b847) were cross-checked against the codebase and isolated execution results. Because not all 100 entries represent reproducible implementation defects, each item is categorized explicitly as an actual defect fix, existing capability, mismatched premise, feature enhancement request, or specification conflict.
Baseline specifications are DS2-SPEC-V1.1 / ds2/v1 (with new ST extensions governed by DS2-SPEC-V2.0 / ds2/v2). Commit SHAs, runtime buildCommit values, UI hashes, test commands, failure history, and screenshots are tracked under Deployment Handover Work Item #27. Automated regression checks remain distinct from external model runs, physical PLC hardware tests, and end-user acceptance; unexecuted physical or external steps are recorded as NOT_RUN.
Key Remediation & Verification Scope
- Blocked silent fallbacks to the currently active model or first Work when inputs contain unclosed blocks, trailing tokens, static diagnostics, empty
source, or nonexistent Work IDs. - Hardened percent-decoding and Unicode NFC normalization for document IDs, CAS revision conflict recovery hints, assembly build metadata reporting, and audit chain integrity verification.
- Kept loopback SILS strictly limited to
virtualBitsround-trips without simulating physical PLC deployment, and separated Python DSD sidecar timeouts,stderrdraining, and built-in sample fallbacks. - Enforced HTTP
Originvalidation, CORSOPTIONSpreflight handling, per-request trace IDs, proxy anti-buffering/no-cache headers, and socket-peer rate/concurrency budgets. - Clarified official example loading, non-destructive documentation panels, 8-mutation (
M1..M8) summary tables, and the boundary between zero-key deterministic demos and general AI authoring requests. - Provided canonical bundle routes (
/ai-start,/ai-start.txt) and PLAY source review (/play#source) for URL-only web AI environments while noting that reading documentation is not a compiler receipt or physical acceptance proof.
Item-by-Item Disposition
Item · Status · Verification & Handling Scope
TS-001 · Fixed · Explicit single-work duration, relation add/remove, and optimization requests without an API key are deterministically transformed, compiled, and trace-verified. General open-ended natural-language requests display supported scope and AI connection guidance.
TS-002 · Fixed · Documented the exact zero-key scope (built-in DEMOs plus explicit duration/relation/optimization commands) in both the composer and settings modal without claiming arbitrary natural-language generation without a key.
TS-003 · Fixed · Supports quick execution for durations, mutual exclusion, optimization, verification, PLC codegen, and official examples; unknown targets or ambiguous compound requests are rejected while preserving the active canonical source.
TS-004 · Fixed & Verified · Added zero-key DEMO selection right after prompt copy while preserving unsent editor drafts and active server projects.
TS-005 · Partial Improvement · Loads and compiles official examples from includeExamples responses without claiming a 1:1 UI button mapping for every G-01..06 document.
TS-006 · Feature Backlog · Real-time editor linting, formatting, and QuickFix actions in the direct code editor are tracked as separate feature enhancements.
TS-007 · Premise Mismatch · The assumption that all 17 DEMO equipment assets must bind simultaneously to every active SCAN Work with automatic camera tracking differs from the current Studio baseline contract.
TS-008 · Partial Improvement · Jumps to exact declaration lines and generated ST lines within the same scope while highlighting causal edges; 3D selection binds only to explicit normalized Work links within the same project/workspace without guessing arrays or ambiguous targets.
TS-009 · Existing Capability · Zero-key deterministic optimization and candidate review operate as designed and remain distinct from physical promotion or open-ended AI generation.
TS-010 · Feature Backlog · A dedicated DSD sample selector displaying fixed compression ratios belongs to the feature backlog.
TS-011 · Fixed · Provides source-SHA-bound ST, PLCopen(PLCOPEN_TC6_NUMERIC/1)/XG5000 XML(LS_XG5000_XGI_COMPACT/1, ls-xg5000-profile.json), 64-pt 3-part slot stride (EXPORT-E422_ADDRESS_COLLISION checks), symbol CSV, AAS(SequenceControlData system-level Edges · CommandWork/StatusWork), showcase-html (digital_twin_showcase.html 7-Tab V3 bridge, CSP sandbox/nosniff) preview/copy/download, and manifest ZIP exports without mutating source if concurrent export requests arrive.
TS-012 · Boundary Clarified · PLAY candidates/DEMOs stay isolated from the active canonical model; arbitrary MCP demo-session headers do not isolate server mutations, so mutating/physical tools remain disabled in the web runner.
TS-013 · Fixed · Dynamically renders exposed tool schemas and executes read-only queries with request/response/cURL/elapsed/cancel/recovery controls while keeping mutating and physical tools disabled.
TS-014 · Existing Capability · Displays stable/experimental text badges alongside explicit response channel fields rather than relying on color alone.
TS-015 · Partial Improvement · Provides play/pause/+1/+10/restart/speed controls across recorded verification scans using server elapsed_ms for Going duration without fabricating physical PLC charts or unverified 3D motion.
TS-016 · Existing Capability · Connects explicitly to loopback SILS / Virtual Kit (PLC_SILS, VIRTUAL_MEMORY) only, verifies virtualBits read/write round-trips, and seals INCONCLUSIVE when DsSilsBaseline comparison is skipped; physical PLC communication remains NOT_RUN.
TS-017 · Fixed & Verified · Displays per-mutation KILLED/SURVIVED/NOT_RUN verdicts, detection scan tables, and raw JSON from the server.
TS-018 · Verified · Confirmed panel switching, official docs modal, and draft preservation at 390px mobile width via live browser interaction and screenshots.
TS-019 · Feature Backlog · A single global header reset button for all demo states is tracked as an optional UI enhancement.
TS-020 · Fixed & Verified · Added a non-destructive official documentation panel with error recovery, retry, 15-second timeout, and stale-response cancellation.
TS-021 · Premise Mismatch · The canonical tool name is dsdx.optimize.propose (zero-key deterministic); bare optimize.propose is not registered, and deterministic proposals do not imply arbitrary natural-language synthesis.
TS-022 · Partial Improvement · dsdx.propose operates without an API key and returns engineMode/requiresAiKey/editKind for explicit duration/relation/optimization edits without faking open-ended natural-language edits.
TS-023 · Premise Mismatch · dsdx.agent.plan returns deterministic proposals and Critical Path data without requiring an external AI key.
TS-024 · Premise Mismatch · dsdx.agent.apply evaluates explicit source in an isolated sandbox without mutating the active project fingerprint (uses source, not dslText).
TS-025 · Premise Mismatch · dsdx.aas.promote shares candidate sandbox evaluation and accepts source (dslText/proposalId are outside the contract).
TS-026 · Feature Backlog · MCP client sampling (sampling/createMessage) is an optional negotiated capability not required by deterministic MCP analysis.
TS-027 · Premise Mismatch · Zero-key deterministic MCP calls never raise LLM key errors; unsupported open-ended natural-language goals are explicitly rejected rather than faking completion.
TS-028 · Premise Mismatch · Unknown arguments such as dslText or projectId return HOST-E422_UNKNOWN_ARGUMENT listing valid fields rather than prompting for an LLM key.
TS-029 · Partial Improvement · Implemented relation and mutual-exclusion add/remove between two explicit scalar Works while rejecting ambiguous targets, arrays, or cross-scope edits.
TS-030 · Premise Mismatch · External MCP analysis tools run without server-side LLM inference; only Studio's direct AI assistant uses user-configured providers.
TS-031 · Fixed & Verified · Explicitly distinguishes live Python DSD sidecar execution from built-in sample fallbacks and surfaces timeouts, nonzero exits, or invalid JSON without disguising them as user-log analysis.
TS-032 · Verified · dsdx.project.migrate performs rule-based migration without an API key and returns migratedSource, canonicalText, and source hashes.
TS-033 · Deferred (NOT_RUN) · Report generation bundles templates, runtime, and codegen without LLM calls; skipped in read-only audit mode (NOT_RUN) because it runs fixed RT measurements (10,000 / 2,000 scans).
TS-034 · Feature Backlog · MCP tool annotations are present on all exposed tools, and optional 3D engine or hardware tools report actual configuration status rather than blanket Zero-Key Ready labels.
TS-035 · Premise Mismatch · Silently compiling the active workspace when source is omitted would violate source-bound receipts; dsdx.compile requires explicit source, while dsdx.start {} serves read-only onboarding.
TS-036 · Verified · dsdx.work.inspect {} returns the first Work when omitted, whereas nonexistent explicit Work IDs are rejected (TS-090).
TS-037 · Premise Mismatch · dsdx.catalog.lookup {} returns minted project identifiers, distinct from 3D equipment catalogs (dsdx.scene.catalog / dsdx.library.search).
TS-038 · Feature Backlog · dsdx.scene.catalog returns SCENE-E503_ENGINE_NOT_CONFIGURED when the optional 3D engine is absent rather than raising an AI key error.
TS-039 · Verified · dsdx.telemetry.subscribe immediately returns a finite snapshot {projectName, scan, time_ms, topics} without blocking streams and is not presented as physical hardware proof.
TS-040 · Feature Backlog · Querying or cancelling an unknown job ID returns HOST-E404_JOB_NOT_FOUND rather than a fake success.
TS-041 · Feature Backlog · Registered tool names use canonical dotted identifiers plus docs_search/docs_read; bare propose/validate names are not registered.
TS-042 · Fixed & Verified · Distinguishes the 28 canonical Host operations from the dynamically generated MCP tools/list registry.
TS-043 · Improved & Preserved · Prioritizes docs_search/docs_read in guidance while retaining dsdx.docs.search/dsdx.docs.read aliases; unregistered docs.search is never advertised.
TS-044 · Feature Backlog · Documented in schema descriptions that lint, validate, and model.validate are compatibility aliases for the same static analyzer.
TS-045 · Feature Backlog · Clarified that plan, optimize, and apply share the deterministic proposal pipeline and apply is a sandbox evaluation rather than active workspace mutation.
TS-046 · Verified · dsdx.project.get and dsdx.project.inspect support summary, delta, and full views.
TS-047 · Verified · dsdx.artifact.export returns the artifact manifest, and dsdx.artifact.get retrieves individual files by exact filename.
TS-048 · Fixed & Verified · Echoes the exact JSON-RPC id while assigning a separate UUID-based Host request_id per execution.
TS-049 · Verified · initialize negotiates 2024-11-05, 2025-03-26, 2025-06-18, and 2025-11-25 protocol versions and rejects invalid parameter types with -32602.
TS-050 · Verified · POST /mcp accepts application/json, */*, and application/json, text/event-stream Accept headers and responds with HTTP 200 JSON.
TS-051 · Verified · Valid notifications/initialized messages without id produce no stdout frame on stdio and HTTP 202 Accepted with empty body over HTTP.
TS-052 · Premise Mismatch · MCP 2025-06-18+ removed JSON-RPC batch arrays, so array payloads return -32600.
TS-053 · Verified · GET /mcp with Accept: text/event-stream alone returns 405 Allow: POST, whereas browser/documentation GET requests receive the inline onboarding guide.
TS-054 · Fixed & Verified · Validates Origin against configured DSDX_PUBLIC_ORIGIN, listener bindings, and DSDX_MCP_ALLOWED_ORIGINS, handles OPTIONS preflight, and rejects spoofed Origin/Host headers.
TS-055 · Verified · Invalid DSL syntax or sealed SDF mutation attempts return HTTP 200 tool responses (isError: true) with domain diagnostic codes rather than HTTP 500.
TS-056 · Feature Backlog · All exposed tool schemas define property descriptions and required fields.
TS-057 · Verified · Exposed tool specs include readOnlyHint/destructiveHint/idempotentHint annotations (advisory hints that do not replace physical safety certification).
TS-058 · Feature Backlog · resources/list returns canonical resources; prompts/list returns an empty list ({ "prompts": [] }, no server prompts exposed) and prompts/get returns -32602.
TS-059 · Verified · scene.render supports summary/delta/full views and scan ranges; artifact.export supports inlineContent: false manifest mode.
TS-060 · Fixed & Verified · Added Cache-Control: no-cache and X-Accel-Buffering: no headers to MCP responses.
TS-061 · Layer Separation · contracts/host.schema.json defines the Host exchange schema, distinct from the JSON-RPC transport envelope and tools/list input schemas.
TS-062 · Fixed & Verified · Every Host operation response includes runtime buildCommit, specVersion, and languageVersion from the executing assembly.
TS-063 · Fixed & Verified · Fixed 404s on percent-encoded or Unicode NFD document IDs by applying single percent-decoding and NFC normalization before catalog lookup while preserving path-traversal guards.
TS-064 · Verified · Section reads support exact, prefix, substring, and line-range queries and return SECTION_NOT_FOUND with valid headings on mismatch.
TS-065 · Verified · Direct SDF edit attempts are rejected with HOST-E403_SDF_READONLY_SEALED and directed to .ds2 source authoring.
TS-066 · Fixed & Verified · CAS revision conflicts report expectedRevision, actualRevision, and recovery guidance (dsdx.project.get) without silent overwrites.
TS-067 · Fixed & Verified · Removed references to a nonexistent audit.append filing API and never report automatic issue filing without an actual issue ID/URL.
TS-068 · Premise Corrected · Prioritizes the public /issue-guide endpoint and notes that internal GitLab tracker access requires network/account permissions.
TS-069 · Fixed & Verified · Static diagnostics return code, specCode, severity, source span, fixHint, and documentation URLs while keeping quickFix = null when no safe mechanical edit exists.
TS-070 · Verified · Compiled SDF includes L0..L5 layers and platformSeal.sealDigest, passing schema validation with zero errors.
TS-071 · Not Reproduced · Confirmed tokenized document search matches both Korean and English corpus terms.
TS-072 · Verified · All 4 milestone overview documents resolve cleanly via docs_read.
TS-073 · Spec Change Required · Static diagnostic codes (DS2-E001..E029) and specCode/fixHint are canonical and are not arbitrarily remapped onto the 6 runtime invariant numbers.
TS-074 · Premise Mismatch · Valid ds2 identifiers are not rejected or warned against undefined hypothetical future keywords.
TS-075 · Scope Clarified · /healthz reports live assembly, commit, and channel metadata, while DSD sidecar calls distinguish live execution, timeouts, and sample fallbacks.
TS-076 · Verified · Core/IR golden tests and Host self-tests verify the distinction between separate-statement OR-join and single-statement AND-join.
TS-077 · Spec Conflict · Reverse arrow syntax is rejected by grammar with a forward-operator fixHint rather than silently flipping operands.
TS-078 · Premise Corrected · Canonical formatting (sdfToDs2Text) normalizes semantics while user-authored comments and whitespace remain preserved separately in source.
TS-079 · Existing Capability · firstDivergence returns measured scan, timeMs, workId, irPhase, stPhase, irOutput, and stOutput.
TS-080 · Spec Conflict · None of the 8 mutations (M1..M8) are skipped while claiming PASS; unexecuted mutations are recorded as NOT_RUN.
TS-081 · Verified · IEC-SYM-2 <=60-char TypedPlcIr symbol table (ls_xg5000_symbols.csv, compact ST/TSV) and .xgwx readable stems (LsXgiHumanReadable), XGI_IDENTIFIER_LENGTH advisory INFO notices, and separate electrical I/O CSV normalization are implemented (vendorIdeImport = NOT_RUN).
TS-082 · Premise Corrected · flow.layout assigns coordinates in declared Work order without infinite recursion on cyclic loops.
TS-083 · Verified · Stateless dsdx.compile queries never mutate the active project, and 3D equipment layouts persist under separate CAS-guarded scene revisions.
TS-084 · Scope Clarified · The built-in AAS repository uses immutable in-process maps and does not claim distributed external 2PC transactions.
TS-085 · Verified · Work IDs derive deterministically from canonical path SHAs across repeated compilations of identical source.
TS-086 · Premise Mismatch · Pairwise `<\ · >` mutex triangles are evaluated via actual initial tokens and scan traces rather than blanket static deadlock rejection.
TS-087 · Premise Mismatch · sim.step queries recorded trace scans and rejects nonexistent bulk steps arguments.
TS-088 · Verified · Workspace state restores by re-parsing canonical .ds2 source from ledger.json without depending on stale binary IR snapshots.
TS-089 · Feature Backlog · Large-flow cluster folding/pagination without hiding nodes is tracked as a separate UI enhancement.
TS-090 · Fixed & Verified · Fixed nonexistent Work ID lookups so they return explicit errors instead of falling back to the first Work, and blocked invalid/empty source fallback to the active model.
TS-091 · Fixed & Verified · Added concurrent stdout/stderr draining, a 3-second timeout, and process-tree cleanup for the Python DSD sidecar while separating sample fallback from live user-data analysis.
TS-092 · Premise Corrected · dsd.preselect analyzes inline JSON request payloads (tags, tagsJson, coilRungs, traceJson) via the sidecar and sets userDataAnalyzed = true with dataScope = REQUEST_COMPONENTS_WITH_REFERENCE_BENCHMARKS when request data is analyzed, while rejecting arbitrary file-path or CSV upload arguments.
TS-093 · Fixed & Verified · Fixed arbitrary endpoint connected reporting so only loopback SILS connects and preserves virtualBits read/write state.
TS-094 · Fixed & Verified · Verifies sealDigest, printable ASCII idempotency_key (HOST-E428_PRECONDITION_REQUIRED) across all 7 command ops, and server checks before setting bundlePrepared = true, keeping deployed = false and physicalAcceptance = NOT_RUN.
TS-095 · Fixed & Verified · Recomputes entry digests and previous-entry links across the 250-entry audit retention window (chainIntegrityVerified) with monotonic indices beyond eviction.
TS-096 · Fixed & Verified · Enforces socket-peer HTTP rate and concurrency limits immune to X-Forwarded-For or query spoofing, returning HTTP 429 with Retry-After.
TS-097 · Premise Corrected · Clarified operational issue-filing documentation so manual workflow steps are not misread as an automated assignment API.
TS-098 · Scope Clarified · Release gate receipts bind to explicit source SHAs, builds, and test runs; /healthz never embeds hardcoded unexecuted gate PASS constants.
TS-099 · Verified · Regression tests cover the 28 canonical Host operations, legacy tool aliases, and 10 public (73 unauth HTTP / keyless DS Studio Desktop --local-agent compat) / 89 owner-auth & --stdio MCP tool registries across initialize, tools/list, and /llms.txt.
TS-100 · Spec Conflict · /healthz never mutates workspaces or runs full verification suites under a 1-second probe budget; full verification runs via isolated E2E and Gate 1~4.
Operational Configuration & Rate Limits
Browser Origin validation for MCP relies strictly on DSDX_PUBLIC_ORIGIN, actual listener bindings, and DSDX_MCP_ALLOWED_ORIGINS. Request Host, X-Forwarded-*, or arbitrary session headers are never trusted as allowlist authorities, while non-browser desktop/CLI MCP clients without an Origin header remain supported.
Default HTTP limits per socket peer are 6,000 requests/min, 8 concurrent requests/peer, and 32 global concurrent requests across up to 1,024 peer slots, configurable via DSDX_MCP_REQUESTS_PER_MINUTE, DSDX_MCP_MAX_CONCURRENT_PER_PEER, and DSDX_MCP_MAX_CONCURRENT. Behind a reverse proxy, per-user authenticated quotas should be enforced at the proxy tier.
Follow-Up Feature Queue
Open-ended zero-key natural-language generation, 50-pattern template generators, live editor linting/QuickFix, array/duplicate/kinematic 3D auto-highlighting, large-flow cluster folding, optional MCP sampling/prompts, and physical PLC or external distributed AAS transactions are managed in the feature backlog. Introducing non-spec keywords/operators or marking unexecuted checks as PASS is strictly prohibited.
Reproducible Regression Suites
tests/host_troubleshooting.py: Verifies input/source/sealDigest guards, document normalization, loopback SILS, audit chain integrity, and DSD sidecar timeout/fallback boundariestests/mcp_http_guards.py: Verifies spoofedOriginrejection, CORS preflight, HTTP429rate limits, concurrency release, and DSD ordering across stdio and isolated HTTPtests/mcp_entry_bootstrap.py: Verifies legacy tool schema compatibility anddsdx.startonboarding responsestests/studio_official_docs.py: Verifies zero-key official example selection, documentation modal, mutation verdict tables, and editor draft preservationtests/studio_playback_browser.py,tests/studio_source_map.cjs: Verifies scan playback/stepping and scoped DSL/ST source navigationtests/mcp_playground_browser.py: Verifies dynamic tool schema rendering, live read-only HTTP queries, explicit source binding, error recovery, and active project preservation