From c427c88dd80ab05f1dd6e6ab4704def3a57a0aab Mon Sep 17 00:00:00 2001 From: "Vincent (Wen Yu) Ge" Date: Fri, 18 Sep 2026 14:21:07 -0400 Subject: [PATCH] docs: correct the default audit leaf, document --task-stream-log The published skill menu marks `audit all` as the default, and the family picker shows only defaults, so AGENTS.md named the wrong leaf. The dev-flag catalog gained no row for --task-stream-log, including the part that trips people up: a line in the dump means the payload was attempted, and the debug log is where delivery shows. Generated-By: PostHog Desktop Task-Id: 6490a5fd-5ee9-4203-b9c4-0b4ff180c45b --- AGENTS.md | 4 ++-- docs/local-dev.md | 9 +++++++++ 2 files changed, 11 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 913ac35f5..bf6620e5c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -97,8 +97,8 @@ aliases. | Subcommand | What it audits | | ----------------------------- | ---------------------------------------------------- | -| `wizard audit events` | event capture quality + cost (**default** leaf) | -| `wizard audit all` | comprehensive audit across every area | +| `wizard audit events` | event capture quality + cost | +| `wizard audit all` | comprehensive audit across every area (**default**) | | `wizard audit autocapture` | autocapture setup + cost | | `wizard audit feature-flags` | feature flag usage + cost | | `wizard audit identify` | `$identify` implementation | diff --git a/docs/local-dev.md b/docs/local-dev.md index 5050b5c77..10e11ba7b 100644 --- a/docs/local-dev.md +++ b/docs/local-dev.md @@ -76,10 +76,19 @@ These flags are available in dev/test builds. Published builds reject them. | `--local-context-mill` | `POSTHOG_WIZARD_LOCAL_CONTEXT_MILL` | skills → `:8765` | | `--local-mcp` | `POSTHOG_WIZARD_LOCAL_MCP` | MCP → `:8787` | | `--local-posthog` | `POSTHOG_WIZARD_LOCAL_POSTHOG` | PostHog origins → `:8010` | +| `--task-stream-log[=path]` | `POSTHOG_WIZARD_TASK_STREAM_LOG` | dump every attempted task-stream sync as JSONL (default `/tmp/posthog-wizard-task-stream.jsonl`) | `--local-posthog` is sugar over `--base-url`. It pins the API host, app host, OAuth server, and the LLM gateway derived from them. +`--task-stream-log` records what the run published, one JSON line per push, +truncated per run. It rides beside the PostHog destination rather than +replacing it, so a logged run is the same run the backend sees. A line means +the payload was attempted, not accepted — `[task-stream] wizard/sessions push +ok: 201` in the debug log is the delivery signal. `--ci` dumps to the default +path on every run and never pushes, since a synthetic run would otherwise +create a session row in a real project. + ### Precedence Most specific wins: