[simulate-docs] ✨ add Simulate page set alongside Validate

[msanyam]

Targets main (#10 and #11 are merged). Commits: 839b407, d49ca8f.

Summary

Adds a /simulate/ page set next to /validate/, using the same page names:

Page	Path
Overview	simulate/index.md
Core Concepts	simulate/core-concepts/ — workspaces, simulations and runs, the four decisions, templates, audiences, asset types and sources, lifecycle (launched / draft_incomplete, summary_status), results
Using MCP	simulate/using-mcp/ — connection (same text as Validate's), the 8-tool table, the behavioral contract, UI panels, prompts, and the reference note
MCP Tools Reference	simulate/api/mcp/ — Redocly → static/simulate-openapi.json

Simulate is available only over MCP, so it has no REST reference, Authentication, Using Postman, Using curl, or Review Feedback page. Those can be added later.

Other changes

• config.md: Simulate added to the top nav, a /simulate/ sidebar, and "Simulate MCP Tools" under API Reference.
• Homepage: the overview now describes both capabilities. The Discover section has new Simulate blocks, and the existing Validate block is now headed "Validate" instead of "Get Started".

Sources

• simulate-openapi.json is filtered from the generated docs/api-spec/openapi.json in abi-simulate-mcp at 662c9f8. It keeps the 8 tools integrators call, plus only the component schemas those tools reference. The internal panel tools get_simulation_status and upload_asset_bytes are excluded, the same way validate-openapi.json excludes upload_validation_asset_bytes. The tool descriptions are copied unchanged from the server.
• The tool table, behavioral contract, and prompts come from server.py docstrings, the new-simulation skill, and prompts.py.

Testing

• runLint: 15 files, 0 issues. runLint --internal-links-only: 0 errors. I confirmed this check fails when a link is broken by adding a bad link and seeing it reported.
• Not checked: how the new top-nav entry and sidebar look on the rendered site. To check, run stage.yml on this branch.

Reviewer notes

• The create_simulation description in the OpenAPI file comes from the server unchanged, and it says "finish in the tile". "Tile" is an internal term. Fixing it would mean changing the server docstring and regenerating the spec, not editing this file.

[github-actions]

🔍 Linter Report

Click to expand full report

═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-10-06T03:50:37.436Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/abi-docs/abi-docs

───────────────────────────────────────────────────────────────

Files to process: 15


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    15
  📄 Files with issues:  0
  ❌ Total errors:       0
  ⚠️  Total warnings:     0
  📋 Total issues:       0

Result: ✅ PASSED - All files passed linting successfully!

═══════════════════════════════════════════════════════════════

---

This comment was automatically generated by the linter bot.

[github-actions]

🔍 Linter Report

Click to expand full report

═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-10-06T03:54:36.481Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/abi-docs/abi-docs

───────────────────────────────────────────────────────────────

Files to process: 15


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    15
  📄 Files with issues:  0
  ❌ Total errors:       0
  ⚠️  Total warnings:     0
  📋 Total issues:       0

Result: ✅ PASSED - All files passed linting successfully!

═══════════════════════════════════════════════════════════════

---

This comment was automatically generated by the linter bot.

[github-actions]

🔍 Linter Report

Click to expand full report

═══════════════════════════════════════════════════════════════
                     LINTER REPORT
═══════════════════════════════════════════════════════════════

Generated: 2026-10-06T03:55:22.018Z
Mode: Full Linting (all rules + dead links check)
Target Directory: /home/runner/work/abi-docs/abi-docs

───────────────────────────────────────────────────────────────

Files to process: 15


═══════════════════════════════════════════════════════════════
                        SUMMARY
═══════════════════════════════════════════════════════════════

  📁 Files processed:    15
  📄 Files with issues:  0
  ❌ Total errors:       0
  ⚠️  Total warnings:     0
  📋 Total issues:       0

Result: ✅ PASSED - All files passed linting successfully!

═══════════════════════════════════════════════════════════════

---

This comment was automatically generated by the linter bot.