Edit with your agent: copy a prompt for a code-managed template's file #503

Activity

1. Silthus

   added

   wayfinder:implement

   on Oct 17, 2026
2. Silthus

   added a parent issue on Oct 17, 2026

   • Map: send code-managed email templates with one PostHog call #461
3. Silthus

   marked this as blocking on Oct 17, 2026

   • Copy as code: edit a code-managed template locally and copy the edits #504
4. Silthus

   changed the title [-]Copy as code: copy a code-managed template as its HTML file[/-] [+]Edit with your agent: copy a prompt for a code-managed template's file[/+] on Oct 17, 2026
5. Silthus

   marked this as blocking 2 issues on Oct 17, 2026

   • Copy as code: copy a code-managed template as its HTML file #509
   • Docs: change a code-managed template with an agent, PostHog Code or PostHog AI, and where source details come from #507
6. Silthus

   marked this as blocked on Oct 17, 2026

   • Code-managed templates: the change prompt on the template API #512
7. Silthus

   marked this as blocking 2 issues on Oct 17, 2026

   • Run with PostHog Code from the Edit with your agent popover #514
   • Ship stack A: edit a code-managed template with your agent #516
8. Silthus

   self-assigned this

   on Oct 17, 2026
9. Silthus commented on Oct 17, 2026

   

   Silthus

   on Oct 17, 2026

   OwnerAuthor

   More actions

   Runtime: T3 child task
   Task: node:delegated-task:command%3Amcp%3A1778d880-5a25-404c-80d0-25fc5ccca3b2%3Adelegate-task%3Awf-email-impl-503-1
   Cast: Opus 5.5, high.
10. Silthus commented on Oct 17, 2026

    

    Silthus

    on Oct 17, 2026

    OwnerAuthor

    More actions

    Note

    🤖 Opus 5.5 responding on behalf of Michael

    Resolution

    Landed 62c695af6cb on spec/template-agent-edit as a fast-forward from 0ba8f7972c2. The ship ticket #516 owns the PR and the review.

    • Button: a code-managed template shows "Edit with your agent" in the Save slot. The read-only preview, Duplicate and "Stop managing in code" are unchanged.
    • Notice: "This template is managed by code, so it can't be changed here. To change it, edit its file, or let your coding agent do it."
    • Popover (EditWithAgentButton.tsx), anchored to the button:
      • "Describe the change" text area, focused, prefilled with change_prompt_starter, caret at the end;
      • collapsed "Show full prompt" with the read-only prompt;
      • "Copy prompt", disabled with "Describe the change first" while the text is blank or equals the starter.
    • Prompt: the sentence as typed, a blank line, then change_prompt_context verbatim. The frontend builds nothing else.
    • State: in messageTemplateLogic only. The sentence survives closing and reopening the popover.
    • After copy: the spec's toast, and the popover closes. No request leaves the page.
    • Events: message template agent prompt opened {template_id, has_path, has_repository}, message template agent prompt copied (plus variable_count), message template duplicated {template_id, code_managed}, message template released from code {template_id}. No prompt text, path or repository in properties.

    Proof

    Red (red.log), the new tests on the base tree: 7 failed, 30 passed.

    • copies the sentence and the server context verbatim, and sends nothing: TypeError: logic.actions.setAgentPromptOpen is not a function.
    • The duplicate and release cases: Expected: "message template duplicated" … Received: "$pageview".

    Green:

    • messageTemplateLogic.test.ts: 37 passed (green.log).
    • Every suite under TemplateLibrary/ plus lib/components/Git: 7 suites, 88 passed, nothing skipped (green-library.log).

    Seam: messageTemplateLogic, API mocked at HTTP	Asserts
    starter as served, starter without its trailing space, blank	copyAgentPromptDisabledReason is "Describe the change first"
    starter from the API field, then close and reopen	the sentence is kept, copy is enabled, opened event with exact properties
    copy	navigator.clipboard.writeText gets the sentence, \n\n, the context verbatim; no PATCH or POST; popover closed; spec toast; copied event with variable_count: 2
    existing duplicate and release tests	one added assertion each for the new events

    Local gate on the landed tree:

    • tsgo --noEmit --checkers 1 in frontend/ through fleet heavy: exit 0.
    • pnpm --filter=@posthog/frontend fix: exit 0.
    • pnpm install --frozen-lockfile: consistent.
    • The pre-push hook (hogli ci:preflight --strict): "failures": 0.
    • No backend change, so no build:openapi or mypy run.

    Browser check (Storybook from this worktree, real App scene, API mocked at HTTP, log): the text area is focused with the caret at 33 of 33 characters; the clipboard holds the expected prompt; the popover closes; reopening keeps the sentence; zero non-GET /api/ requests.

    Screenshots (MockHog project, example.com repository, invented copy, no customer data). Narrow is a 560px window, about the scene of a 1280px window with the side panel open. Wide is 1440px.

    	Narrow (560px)	Wide (1440px)
    Page: button and new notice	page	page
    Popover: starter, copy disabled	starter	starter
    Popover: change described	described	described
    Full prompt shown	full prompt	full prompt
    After copy: toast, popover closed	after copy	after copy

    Committed stories, Products/Workflows/Template library/Edit with your agent: with a path, without a path, full prompt shown.

    Agent round trip, partial:

    1. A scratch git checkout (origin https://github.com/example/app.git) with emails/welcome.html committed.
    2. The real server builder template_change_prompt.change_prompt ran on that file, with its commit as source_ref. That is the function Code-managed templates: the change prompt on the template API #512 proved through the API.
    3. Its starter and context fed the page. Copied through the UI: the clipboard text.
    4. Pasted into a claude -p session (Sonnet) in the checkout, with only read and edit tools. The agent changed the button color in the file and nothing else (diff). It did not upload, and it said that a send-by-key app needs a re-upload (session).

    Gaps

    • SDK upload and send into the dev mail catcher: not run. No CDP Node service runs on this devbox, and Email templates: one send route that names the template in the body, with a content hash #488 needed three local-only workarounds to start one. This diff doesn't touch upload or send; posthog-node: emails.send from a key or an HTML file, synced by content hash, returning { data, error } #474 and Email templates: one send route that names the template in the body, with a content hash #488 proved that path. Ship stack A: edit a code-managed template with your agent #516 can run it on the PR head if the reviewer wants it.
    • The page in the screenshots is Storybook with the API mocked, not the running dev stack. The stack on this devbox serves the main checkout. The mocked starter and context are the server's text for that file.

    Calls made

    • Starter as the default. The sentence is null until the person types, and a selector falls back to the starter. So a template that loads after the popover mounts still shows its starter.
    • Disabled rule trims both sides. The starter with its trailing space deleted still counts as "not described".
    • variable_count counts the distinct {{ variables.<name> }} in the server's context, with the server's name pattern. The frontend doesn't scan the template content.
    • No pending state. The copy is a local clipboard write, with no network request. Failure uses copyToClipboard's toasts ("Could not copy prompt to clipboard", or the HTTPS warning), and the popover stays open with the sentence.
    • Cmd+Enter copies, the same as the button.
    • The button keeps Lemon's dropdown chevron, the convention for a button that opens a popover. It is disabled while the template loads.
    • Events in the logic, not in MessageTemplateMenu.tsx. The page menu and the notice both dispatch duplicateTemplate, so one event covers both. templateCopy.ts and MessageTemplateMenu.tsx are unchanged.
    • change_prompt_* joined the server-owned fields, so a released template's save never sends them.
    • Dependencies: the story's play uses @testing-library/dom, which the lint rule requires. products/workflows now declares it and user-event as devDependencies, the way products/legal_documents does. The lockfile gains 6 lines. I dropped an unrelated unlayer-types bump that pnpm install added.
    • No review ran in this ticket. Ship stack A: edit a code-managed template with your agent #516 owns review.

    Follow-ups

    • Copy as code: copy a code-managed template as its HTML file #509: "Copy HTML file" goes in a side menu on EditWithAgentButton. The button already shows the dropdown chevron, so the side action should replace it rather than add a second one.
    • Run with PostHog Code from the Edit with your agent popover #514: "Run with PostHog Code" sits next to "Copy prompt" in AgentPrompt and reads the same changeSentence.
    • Library card Duplicate (messageTemplatesLogic.duplicateTemplate) has no message template duplicated event. It was outside this ticket's write scope. The ship ticket or Copy as code: copy a code-managed template as its HTML file #509 can add it with code_managed.
    • Headless capture: the expanded prompt in the full app painted blank in headless Chromium until the area scrolled. The DOM and styles are correct, and the isolated story paints at once. Watch for it in visual review of the Full prompt shown story.
11. Silthus

    closed this as completedon Oct 17, 2026