Align launcher terminology docs

documentation/TODO_AGENTS.md

@@ -7,6 +7,20 @@
 - We now know the API side was not the root cause. The bootstrap request shape in `src/main/api_client.ts` was wrong and has been corrected.
 - The packaging blocker has been diagnosed and fixed (see below).
 
+## Launcher Terminology Cleanup
+- Align the native docs/comments with the Svelte-side terminology: **Launch Profile** = the
+   Svelte config object keyed by extension; **Native Template** = the AppleScript or shell
+   string Electron actually executes after the file lands in temp.
+- Update `src/main/file_handlers.ts` comments and any bridge-facing wording so they describe the
+   resolved template string accurately. The current IPC arg name in source is `launch_profiles`,
+   but it carries a single native template string. Do not reintroduce `launch_scripts` as the
+   public term.
+- Keep the source of truth in Svelte. Electron should remain a thin executor/copy layer.
+- After source/docs updates, rebuild/regenerate `dist/main/file_handlers.js` from source; do not
+   hand-edit the generated file.
+- If any parameter names remain awkward in source, preserve runtime behavior first and rename
+   only when the signature ripple is understood.
+
 ## What Was Fixed
 - Updated the native bootstrap flow to use the direct `site_domain/search` request body expected by API V3.
 - Standardized the account-bypass header to `x-no-account-id: bypass` where that narrow bypass is intended.