feat: messages to the heavens by gewenyu99 · Pull Request #410 · PostHog/wizard

gewenyu99 · 2026-04-22T16:42:38Z

Problem

We want to send messages to the heavens (posthog cloud). See our game plan

Changes

Adds a interface to hook into event plan updates made by the agent.

Adds a destination for debugging which is just to a local file
Leaves an empty destination for hook up later to PostHog Cloud

See comments in this PR <3

Test plan

gewenyu99 · 2026-04-23T15:07:48Z

+  readonly name = 'posthog';
+
+  send(_event: StreamEvent, _payload: TaskStreamUpdate): Promise<void> {
+    // TODO: implement when the PostHog API surface is defined.


Wire this up to send to where ever in the heavens (posthog app)

gewenyu99 · 2026-04-23T15:08:39Z

+    try {
+      appendFileSync(
+        TASK_STREAM_LOG,
+        `[${event}] ${JSON.stringify(payload)}\n`,


This will print to /tmp/posthog-task-stream.log for easy debugging and for us to tweak what this looks like

gewenyu99 · 2026-04-23T15:19:11Z

+      started_at: this.startedAt,
+      run_phase: session.runPhase,
+      tasks: buildTasks(tasks),
+      event_plan: eventPlan.length > 0 ? eventPlan : undefined,


We will also send the event plan up so we can display them

equiv to this screen in wizard

[CREATE] { "session_id": "onboarding-posthog_integration-2026-04-23T15:16:21.919Z", "workflow_id": "onboarding", "skill_id": "posthog_integration", "started_at": "2026-04-23T15:16:21.919Z", "run_phase": "idle", "tasks": [], "timestamp": "2026-04-23T15:16:21.920Z" } [UPDATE] { "session_id": "onboarding-posthog_integration-2026-04-23T15:16:21.919Z", "workflow_id": "onboarding", "skill_id": "posthog_integration", "started_at": "2026-04-23T15:16:21.919Z", "run_phase": "running", "tasks": [ { "id": "0", "title": "Analyze project structure and plan event tracking", "status": "in_progress" }, { "id": "1", "title": "Set up PostHog dependencies and environment variables", "status": "pending" }, { "id": "2", "title": "Insert event tracking code", "status": "pending" }, { "id": "3", "title": "Revise and validate tracking implementation", "status": "pending" }, { "id": "4", "title": "Wrap up integration", "status": "pending" } ], "timestamp": "2026-04-23T15:17:12.484Z" } [UPDATE] { "session_id": "onboarding-posthog_integration-2026-04-23T15:16:21.919Z", "workflow_id": "onboarding", "skill_id": "posthog_integration", "started_at": "2026-04-23T15:16:21.919Z", "run_phase": "running", "tasks": [ { "id": "0", "title": "Analyze project structure and plan event tracking", "status": "in_progress" }, { "id": "1", "title": "Set up PostHog dependencies and environment variables", "status": "pending" }, { "id": "2", "title": "Insert event tracking code", "status": "pending" }, { "id": "3", "title": "Revise and validate tracking implementation", "status": "pending" }, { "id": "4", "title": "Wrap up integration", "status": "pending" } ], "event_plan": [ { "name": "start_free_trial_clicked", "description": "User clicks a 'Start Free Trial' CTA button" }, { "name": "contact_sales_clicked", "description": "User clicks the 'Contact Sales' button on the homepage hero" }, { "name": "pricing_plan_clicked", "description": "User clicks a CTA on the pricing page (Starter, Pro, or Enterprise)" }, { "name": "contact_form_submitted", "description": "User successfully submits the contact form (client-side success)" }, { "name": "contact_form_errored", "description": "Contact form submission fails with a validation or network error (client-side)" }, { "name": "contact_form_submission_received", "description": "Server successfully processes a contact form submission (server-side)" } ], "timestamp": "2026-04-23T15:18:01.764Z" } ... [UPDATE] { "session_id": "onboarding-posthog_integration-2026-04-23T15:16:21.919Z", "workflow_id": "onboarding", "skill_id": "posthog_integration", "started_at": "2026-04-23T15:16:21.919Z", "run_phase": "running", "tasks": [ { "id": "0", "title": "Analyze project structure and plan event tracking", "status": "completed" }, { "id": "1", "title": "Set up PostHog dependencies and environment variables", "status": "completed" }, { "id": "2", "title": "Insert event tracking code", "status": "completed" }, { "id": "3", "title": "Revise and validate tracking implementation", "status": "completed" }, { "id": "4", "title": "Wrap up integration", "status": "in_progress" } ], "event_plan": [ { "name": "start_free_trial_clicked", "description": "User clicks a 'Start Free Trial' CTA button" }, { "name": "contact_sales_clicked", "description": "User clicks the 'Contact Sales' button on the homepage hero" }, { "name": "pricing_plan_clicked", "description": "User clicks a CTA on the pricing page (Starter, Pro, or Enterprise)" }, { "name": "contact_form_submitted", "description": "User successfully submits the contact form (client-side success)" }, { "name": "contact_form_errored", "description": "Contact form submission fails with a validation or network error (client-side)" }, { "name": "contact_form_submission_received", "description": "Server successfully processes a contact form submission (server-side)" } ], "timestamp": "2026-04-23T15:19:58.268Z" } [UPDATE] { "session_id": "onboarding-posthog_integration-2026-04-23T15:16:21.919Z", "workflow_id": "onboarding", "skill_id": "posthog_integration", "started_at": "2026-04-23T15:16:21.919Z", "run_phase": "running", "tasks": [ { "id": "0", "title": "Analyze project structure and plan event tracking", "status": "completed" }, { "id": "1", "title": "Set up PostHog dependencies and environment variables", "status": "completed" }, { "id": "2", "title": "Insert event tracking code", "status": "completed" }, { "id": "3", "title": "Revise and validate tracking implementation", "status": "completed" }, { "id": "4", "title": "Wrap up integration", "status": "completed" } ], "event_plan": [ { "name": "start_free_trial_clicked", "description": "User clicks a 'Start Free Trial' CTA button" }, { "name": "contact_sales_clicked", "description": "User clicks the 'Contact Sales' button on the homepage hero" }, { "name": "pricing_plan_clicked", "description": "User clicks a CTA on the pricing page (Starter, Pro, or Enterprise)" }, { "name": "contact_form_submitted", "description": "User successfully submits the contact form (client-side success)" }, { "name": "contact_form_errored", "description": "Contact form submission fails with a validation or network error (client-side)" }, { "name": "contact_form_submission_received", "description": "Server successfully processes a contact form submission (server-side)" } ], "timestamp": "2026-04-23T15:21:25.405Z" }

MattBro

A few things worth looking at before this lands. The big one is that COMPLETE events don't actually fire - details inline.

MattBro · 2026-04-23T17:10:20Z

+  StreamEvent,
+} from '../types';
+
+const TASK_STREAM_LOG = '/tmp/posthog-task-stream.log';


/tmp doesn't exist on Windows, and the log grows unbounded across runs. Use os.tmpdir() and either truncate on construction or include a timestamp in the filename so concurrent/repeat runs don't collide.

This is a generally good piece of advice for all of our logging! Thanks :D

Oh this actually explains why our skills don't install properly on windows 😬 we unzip in tmp!

#417

This should fix both for windows

gewenyu99 · 2026-04-23T18:03:25Z

Oooo this is a great review @MattBro! On it

MattBro

Looks good - everything substantive got handled, tests cover the lifecycle, and dispose in bin.ts closes the COMPLETE gap cleanly. Nice work.

Two small non-blockers:

Typo in the test describe block: Coorect order of events.
onTasksChanged only fires from syncTodos, so mid-run setEventPlan / setRunPhase changes won't push until the next todo sync. Terminal phase is caught by dispose() so it's fine in practice, but worth a thought if the plan gets edited independently.

Windows /tmp is tracked in #417, good to split.

gewenyu99 · 2026-04-24T13:49:13Z

Thanks for the review @MattBro <3

I learned a lot. Looking forward to working together on this.

Init messages to the heavens

f07c26e

gewenyu99 commented Apr 23, 2026

View reviewed changes

gewenyu99 added 2 commits April 23, 2026 11:36

Tweaks for simplicity

9782f7a

error handling duh

e4f5761

MattBro reviewed Apr 23, 2026

View reviewed changes

gewenyu99 added 3 commits April 23, 2026 14:35

Matt's comments

98ecfbc

tests

31ff2f7

Clean up the super messy flow for figuring out skillid

ca6c9d2

gewenyu99 requested a review from a team April 23, 2026 20:30

gewenyu99 marked this pull request as ready for review April 23, 2026 20:30

gewenyu99 requested a review from MattBro April 23, 2026 20:30

MattBro approved these changes Apr 23, 2026

View reviewed changes

gewenyu99 added 3 commits April 25, 2026 18:40

Merge branch 'main' into messages-to-the-heavens

d16d9f8

fix: use of temp folders for windows (#417)

14ee794

Merge branch 'main' into messages-to-the-heavens

6b73213

gewenyu99 merged commit fe1114a into main Apr 27, 2026
17 checks passed

gewenyu99 deleted the messages-to-the-heavens branch April 27, 2026 23:15

releaser-wizard Bot mentioned this pull request Apr 27, 2026

chore(main): release 2.11.0 #426

Merged

Conversation

gewenyu99 commented Apr 22, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Problem

Changes

Test plan

Uh oh!

gewenyu99 Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

gewenyu99 Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

gewenyu99 Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

gewenyu99 Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

gewenyu99 Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

MattBro left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

MattBro Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

gewenyu99 Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

gewenyu99 Apr 23, 2026

Choose a reason for hiding this comment

Uh oh!

gewenyu99 Apr 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

gewenyu99 commented Apr 23, 2026

Uh oh!

MattBro left a comment

Choose a reason for hiding this comment

Uh oh!

gewenyu99 commented Apr 24, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

gewenyu99 commented Apr 22, 2026 •

edited

Loading

gewenyu99 Apr 23, 2026 •

edited

Loading

gewenyu99 Apr 23, 2026 •

edited

Loading