sub-ipc

name	sub-ipc
description	Regenerate the IPC channel reference documentation from ipcChannels.ts type maps.
disable-model-invocation	false
allowed-tools	Bash, Read, Write, Grep

SubFrame IPC Reference Regeneration

Regenerate .subframe/docs-internal/refs/ipc-channels.md from the source of truth: src/shared/ipcChannels.ts.

Dynamic Context

Current channel count: !node -e "const src=require('fs').readFileSync('src/shared/ipcChannels.ts','utf8'); const m=src.match(/^\s+\w+:\s*'/gm); console.log(m ? m.length + ' channels in IPC constant' : 'Could not count')"

Instructions

Step 1: Read Source

Read src/shared/ipcChannels.ts completely. Extract:

1. IPC constant — all channel name constants, grouped by their comment headers (e.g., // Terminal, // Workspace)
2. IPCHandleMap — channels using the handle pattern (request/response)
3. IPCSendMap — channels using the send pattern (fire-and-forget)
4. IPCEventMap — channels using the event pattern (main→renderer push)

Step 2: Classify Each Channel

For every channel in the IPC constant, determine its pattern:

• If it appears in IPCHandleMap → handle
• If it appears in IPCSendMap → send
• If it appears in IPCEventMap → event
• If it appears in both IPCSendMap and IPCEventMap → send + event (bidirectional)
• If it appears in NONE of the maps → ⚠ (untyped/legacy)

Step 3: Write Reference Doc

Write .subframe/docs-internal/refs/ipc-channels.md with this structure:

# IPC Channel Reference

**Source of truth:** `src/shared/ipcChannels.ts`

All channels are typed. Three communication patterns are used:

| Pattern | Direction | Usage |
|---------|-----------|-------|
| `ipcMain.handle` / `ipcRenderer.invoke` | Renderer → Main (request/response) | Data fetching, mutations |
| `ipcRenderer.send` / `ipcMain.on` | Renderer → Main (fire-and-forget) | Commands, notifications |
| `webContents.send` / `ipcRenderer.on` | Main → Renderer (push events) | Data updates, state changes |

Channels marked ⚠ are defined in the `IPC` constant but not yet in `IPCHandleMap`, `IPCSendMap`, or `IPCEventMap` type maps.

---

## Channels by Domain

### {Domain} ({N} channels)
| Channel | Pattern | Purpose |
|---------|---------|---------|
| `CHANNEL_NAME` | pattern | Brief purpose |

...

---

**Total: {N} channels** ({H} handle, {S} send, {E} event, {U} untyped/legacy)

*Regenerated from `ipcChannels.ts` — keep this reference in sync when adding/removing channels.*

Rules

• Group channels by the // comment headers in the IPC constant
• Purpose descriptions should be concise (3-8 words)
• Count channels that appear in multiple maps only once for the total
• Flag channels not in any type map with ⚠
• Include a note for legacy channels that have been superseded by handle patterns

Step 4: Verify

Count the total channels and verify it matches the number of entries in the IPC constant.