godot-opencode/docs/API.md

# API — godot-opencode 1.0.0

## Bridge tools (`godot_*`)

| Tool | Bridge method | Purpose |
|---|---|---|
| `godot_editor_state` | `editor_state` | Editor state snapshot |
| `godot_scene_get_hierarchy` | `scene_get_hierarchy` | Scene hierarchy |
| `godot_node_get_properties` | `node_get_properties` | Node properties |
| `godot_session_activate` | `session_activate` | Session switch |
| `godot_capture_viewport` | `capture_viewport` | Viewport PNG (base64), stale fallback past 1000 ms |
| `godot_shader_generate` | `generate_shader` | spatial/canvas-item shader + uniforms |
| `godot_theme_apply_style` | `apply_stylebox` | StyleBoxFlat / font / color overrides |

Companion dispatch adds: `frame_aabb`, `capture_status`,
`inject_uniform`, `list_uniforms`, `inspect_theme`,
`apply_font_override`, plus the Phase ≤4 node/signal/resource set.

## TypeScript modules

- `src/vision/viewport.ts` — `frameAABB`, `isStaleFrame`,
  `buildCaptureParams`, `parseCaptureResult`, `executeCaptureViewport`,
  `MAIN_LOOP_STALL_MSEC = 1000`.
- `src/studio/shaders.ts` — `generateShader`, `injectUniform`,
  `listUniforms`, `buildStyleBoxFlat`, `applyStyleOverride`,
  `buildFontOverride`.
- `src/indexer/project.ts` — `parseTscn`, `parseProjectGodot`,
  `indexProject(fs)`, `renderArchitectureMap`.
- `src/verify/production.ts` — `runProductionPipeline` (mock-friendly
  E2E orchestrator; stages: `devStory, scene, script, signal, hudStyle,
  gut, headless, viewport`).
- `src/studio/commands.ts` — `/setup-godot /adr /dev-story /story-done
  /gate-check`.

## Status model

`ok | error | unavailable | timeout`, plus pipeline-tolerated
`unavailable-tolerated` (no binary) and `stale-tolerated` (stalled main
loop). Tolerated statuses keep CI green without an engine.