David/WFDASH-WEBAPP
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
WFDASH-WEBAPP/docs
History
SJCoetz 0013ff5267 docs(bugs): add post-mortem for MCP initialize handshake bug 
Captures the full timeline of the 2026-08-04 incident where WFDASH
/api/mcp silently failed every spec-compliant MCP client's handshake
because the route didn't handle the mandatory 'initialize' method.

Includes:
  - Symptom (Hermes log lines + WebUI '0 tools' display)
  - Root cause (HTTP 404 on initialize → client terminates session)
  - Fix summary (the three new handlers, with the critical 'don't use
    the content envelope for initialize' gotcha)
  - Verification recipe (curl against the live endpoint)
  - Lessons to apply to other JSON-RPC endpoints we might add later
    (initialize is mandatory; don't reuse the tools/call envelope;
    HTTP 404 is a signal the endpoint isn't MCP at all)

Co-authored-by: Orca <help@stably.ai>
2026-08-05 01:53:02 +02:00
..
audit feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
bugs docs(bugs): add post-mortem for MCP initialize handshake bug 2026-08-05 01:53:02 +02:00
example-quotes feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
pocketbase feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
superpowers docs(stock-orders): wrap + PDF implementation plan 2026-08-03 15:57:55 +02:00
theme-preview feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
0136daf3-3ebd-4bca-876e-316271a40303.jsonl feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
AGENT_INSTRUCTIONS.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
api-mcp-layer.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
core-recheck-matrix.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
deliveries-n8n-workflow.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
dev-guide.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
django-nextjs-parity-backlog.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
driver-app-data-source.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
migration-audit.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
n8n-ai-insights-prompt.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
n8n-mcp-setup.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
order-items-schema-standard.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
order-workflow-rules.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
orders-first-rollout.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
pricelist-extraction.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
qa-review.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
qa-review.verify.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
quotes-email-monitor.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
SHIPPED.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00
wfdash-v5-deployment.md feat(item-history): add getItemHistory service with 5 PB queries 2026-07-29 14:51:58 +02:00