feat(ipc): ipcRenderer.invoke / ipcMain.handle facade with Electron error text (Zettlr) #547

Generated by an AI agent (Claude Code) on behalf of @0monish during Wayfinder charting of the Electron compatibility program; rewritten 2026-10-07 by the doctrine-audit repair pass (change log at the end). Planning only — no implementation is authorized by this issue.

Parent

Epic #463 · Map #391 · Unit F04 · Kind: feature · Tier: Tier 1 · Maturity target: L2 · Size: M · Milestone: next

What to build

Invoke handler registry separate from the listener registry; handle/handleOnce/removeHandler; IpcMainInvokeEvent; Electron's error renderings for duplicate handler, non-function handler, missing handler and handler throw. Needs a KEL-142 §7 amendment because the live bridge collapses handler failures to KELD-API-001 without app text.

Spec gate: the first deliverable is a spec from docs/agents/spec-template.md, opened as a PR and stopped for human approval; implementation starts only at Status: approved.

Acceptance criteria

• A conformance entry citing the pinned Electron v44.4.5 sentence lands first for invoke round trip, handler-throw text, no-handler text, duplicate-handle throw and invoke rejection on non-cloneable args
• Zettlr mounts with its invoke/handle sites and no KELD-WV floor errors

Negative controls (each names the one mutation that must fail)

• Collapsing handler errors to a generic message makes the handler-throw entry fail

Ownership and gates

• Tracker of record: this GitHub issue (no live Linear issue covers it; owner decision Linear owner for repo-writing Electron-compat slices (owner decision: align to nearest Linear issue, else GitHub is the tracker of record) #517). Claims, status and handoffs happen here under docs/agents/workflow.md § Tracker issue (rule lands with docs(agents): record the #517 tracker-of-record rule in root AGENTS.md and the workflow claim protocol #520). Linear reference: KEL-80 (Backlog) carries a link to this issue.
• Blocking edges: native GitHub blocked-by links on this issue (open blockers only: feat(bridge): N pending renderer invokes per WebView under a host credit window (Zettlr prerequisite) #546, feat(ipc): ipcMain listener facade + webContents.send routing + IpcMainEvent sender/senderFrame/reply over the el control channel (draw.io first-proof slice) #466, feat(ipc): contextBridge.exposeInMainWorld value table + ipcRenderer send/on facade + IpcRendererEvent in the app content world (draw.io first-proof slice) #467)
• Linear owners and predecessors (repair-time analysis; statuses as fetched 2026-10-07): Tracker of record: this ticket's GitHub issue under the Linear owner for repo-writing Electron-compat slices (owner decision: align to nearest Linear issue, else GitHub is the tracker of record) #517 owner decision (Linear owner for repo-writing Electron-compat slices (owner decision: align to nearest Linear issue, else GitHub is the tracker of record) #517 comment IC_kwDOSwkPJ88AAAABZxzzGA, 2026-10-06T20:32Z: align to the nearest live Linear issue whose scope covers the work, otherwise the GitHub issue is the tracker of record and no Linear issue is created). Linear reference link on KEL-127 (Todo, unassigned; Linear, fetched 2026-10-07; the rule's fallback). INFERENCE: KEL-80 is not the claim tracker because of its 2026-08-20 owner comment 'do not pick up'; if the owner aligns this slice to KEL-80 instead, KEL-80 becomes the tracker of record. KEL-142 (Done) owns the §7 text being amended.
• Review gates: public API, wire protocol
• Platforms: macOS first
• Electron members covered: ipcRenderer.invoke, ipcMain.handle, ipcMain.handleOnce, ipcMain.removeHandler, IpcMainInvokeEvent.type, IpcMainInvokeEvent.processId, IpcMainInvokeEvent.frameId, IpcMainInvokeEvent.sender, IpcMainInvokeEvent.senderFrame

The authoritative agent contract is the latest Agent Brief comment on this issue (triage skill); this body is the planning record.

Out of scope

none stated

Change log (doctrine-audit repair, 2026-10-07)

• New next-milestone ticket holding the invoke/handle members, entries and the Zettlr mount criterion moved out of F04-T1 and F04-T3 (critic yagni F04-T1/F04-T3; critic quality Zettlr ACs; X06-D2)
• Records the error-text disclosure amendment (refuter invariants extra finding KEL-142 §7) and registration semantics (refuter semantics handle finding)
• Owner restated as GitHub tracker of record under Linear owner for repo-writing Electron-compat slices (owner decision: align to nearest Linear issue, else GitHub is the tracker of record) #517 (cross-checker finding X06-D7 tracker-of-record contradiction)