Repoint stale src/preview/launch.ts and src/preview/proxy.ts comment re…

.seeds/issues.jsonl

@@ -628,9 +628,9 @@
 {"id":"warren-e810","title":"Render terminal-failed banner in ConversationDetail","status":"closed","type":"task","priority":1,"plan_step_index":2,"description":"<!-- seeds:plan-backref:start -->\nStep 3 of plan pl-de53.\n\nParent seed: warren-203d — Leveret UI: surface anchoring-run failure on the conversation surface\nPlan template: bug\nPlan approach: UI-only fix, no wire/API changes. (1) Teach Chat to accept the already-fetched persisted transcript and render it merged with the live stream, so messages show regardless of run state. (2) In ConversationDetail, feed…\n\nRun `sd plan show pl-de53` for the full plan (context, alternatives, sibling steps, acceptance criteria).\n<!-- seeds:plan-backref:end -->","createdAt":"2026-06-07T12:04:30.130Z","updatedAt":"2026-06-07T12:25:32.861Z","labels":["bugwatch"],"plan_id":"pl-de53","blocks":["warren-0db3","warren-203d"],"extensions":{"role":"pi","lastRunId":"run_5gn4g2bcm1sz","lastRunAt":"2026-06-07T12:18:48.853Z"},"closedAt":"2026-06-07T12:25:32.861Z"}
 {"id":"warren-0732","title":"Add Chat regression test for transcript render with empty stream","status":"closed","type":"task","priority":2,"plan_step_index":3,"description":"<!-- seeds:plan-backref:start -->\nStep 4 of plan pl-de53.\n\nParent seed: warren-203d — Leveret UI: surface anchoring-run failure on the conversation surface\nPlan template: bug\nPlan approach: UI-only fix, no wire/API changes. (1) Teach Chat to accept the already-fetched persisted transcript and render it merged with the live stream, so messages show regardless of run state. (2) In ConversationDetail, feed…\n\nRun `sd plan show pl-de53` for the full plan (context, alternatives, sibling steps, acceptance criteria).\n<!-- seeds:plan-backref:end -->","createdAt":"2026-06-07T12:04:30.130Z","updatedAt":"2026-06-07T12:35:56.802Z","labels":["bugwatch"],"plan_id":"pl-de53","blocks":["warren-0db3","warren-203d"],"closedAt":"2026-06-07T12:35:56.802Z"}
 {"id":"warren-0db3","title":"Release: run /release per .claude/commands/release.md","status":"closed","type":"task","priority":2,"plan_step_index":4,"description":"<!-- seeds:plan-backref:start -->\nStep 5 of plan pl-de53.\n\nParent seed: warren-203d — Leveret UI: surface anchoring-run failure on the conversation surface\nPlan template: bug\nPlan approach: UI-only fix, no wire/API changes. (1) Teach Chat to accept the already-fetched persisted transcript and render it merged with the live stream, so messages show regardless of run state. (2) In ConversationDetail, feed…\n\nRun `sd plan show pl-de53` for the full plan (context, alternatives, sibling steps, acceptance criteria).\n<!-- seeds:plan-backref:end -->","createdAt":"2026-06-07T12:04:30.130Z","updatedAt":"2026-06-07T12:43:15.515Z","labels":["bugwatch"],"plan_id":"pl-de53","blocks":["warren-203d"],"closedAt":"2026-06-07T12:43:15.515Z"}
-{"id":"warren-a056","title":"nightwatch patrol: 2026-06-09","status":"open","type":"task","priority":3,"createdAt":"2026-06-09T09:07:21.686Z","updatedAt":"2026-06-09T09:08:52.347Z","labels":["patrol","nightwatch"],"plan_id":"pl-7580","blockedBy":["warren-43e6","warren-bfe2","warren-9358","warren-9d72","warren-f48a"]}
-{"id":"warren-43e6","title":"Repoint stale src/preview/launch.ts and src/preview/proxy.ts comment references after the launch/ + proxy/ splits","status":"open","type":"task","priority":3,"plan_step_index":0,"description":"<!-- seeds:plan-backref:start -->\nStep 1 of plan pl-7580.\n\nParent seed: warren-a056 — nightwatch patrol: 2026-06-09\nPlan template: refactor\nPlan approach: Each step is an independent, comment-only fix touching a small set of files; there are no real dependencies between the four fix steps, so they can land in any order as separate PRs. The final Release step is ordered last and blocked by…\n\nRun `sd plan show pl-7580` for the full plan (context, alternatives, sibling steps, acceptance criteria).\n<!-- seeds:plan-backref:end -->","createdAt":"2026-06-09T09:08:52.347Z","updatedAt":"2026-06-09T09:08:52.347Z","labels":["nightwatch"],"plan_id":"pl-7580","blocks":["warren-f48a","warren-a056"]}
+{"id":"warren-a056","title":"nightwatch patrol: 2026-06-09","status":"open","type":"task","priority":3,"createdAt":"2026-06-09T09:07:21.686Z","updatedAt":"2026-06-09T09:15:37.125Z","labels":["patrol","nightwatch"],"plan_id":"pl-7580","blockedBy":["warren-bfe2","warren-9358","warren-9d72","warren-f48a"]}
+{"id":"warren-43e6","title":"Repoint stale src/preview/launch.ts and src/preview/proxy.ts comment references after the launch/ + proxy/ splits","status":"closed","type":"task","priority":3,"plan_step_index":0,"description":"<!-- seeds:plan-backref:start -->\nStep 1 of plan pl-7580.\n\nParent seed: warren-a056 — nightwatch patrol: 2026-06-09\nPlan template: refactor\nPlan approach: Each step is an independent, comment-only fix touching a small set of files; there are no real dependencies between the four fix steps, so they can land in any order as separate PRs. The final Release step is ordered last and blocked by…\n\nRun `sd plan show pl-7580` for the full plan (context, alternatives, sibling steps, acceptance criteria).\n<!-- seeds:plan-backref:end -->","createdAt":"2026-06-09T09:08:52.347Z","updatedAt":"2026-06-09T09:15:37.125Z","labels":["nightwatch"],"plan_id":"pl-7580","blocks":["warren-f48a","warren-a056"],"closedAt":"2026-06-09T09:15:37.125Z"}
 {"id":"warren-bfe2","title":"Repoint stale src/runs/reap.ts comment references after the reap/ split","status":"open","type":"task","priority":3,"plan_step_index":1,"description":"<!-- seeds:plan-backref:start -->\nStep 2 of plan pl-7580.\n\nParent seed: warren-a056 — nightwatch patrol: 2026-06-09\nPlan template: refactor\nPlan approach: Each step is an independent, comment-only fix touching a small set of files; there are no real dependencies between the four fix steps, so they can land in any order as separate PRs. The final Release step is ordered last and blocked by…\n\nRun `sd plan show pl-7580` for the full plan (context, alternatives, sibling steps, acceptance criteria).\n<!-- seeds:plan-backref:end -->","createdAt":"2026-06-09T09:08:52.347Z","updatedAt":"2026-06-09T09:08:52.347Z","labels":["nightwatch"],"plan_id":"pl-7580","blocks":["warren-f48a","warren-a056"]}
 {"id":"warren-9358","title":"Fix src/runs/burrow_config.ts -> src/runs/burrow-config.ts filename in planner.ts comment","status":"open","type":"task","priority":3,"plan_step_index":2,"description":"<!-- seeds:plan-backref:start -->\nStep 3 of plan pl-7580.\n\nParent seed: warren-a056 — nightwatch patrol: 2026-06-09\nPlan template: refactor\nPlan approach: Each step is an independent, comment-only fix touching a small set of files; there are no real dependencies between the four fix steps, so they can land in any order as separate PRs. The final Release step is ordered last and blocked by…\n\nRun `sd plan show pl-7580` for the full plan (context, alternatives, sibling steps, acceptance criteria).\n<!-- seeds:plan-backref:end -->","createdAt":"2026-06-09T09:08:52.347Z","updatedAt":"2026-06-09T09:08:52.347Z","labels":["nightwatch"],"plan_id":"pl-7580","blocks":["warren-f48a","warren-a056"]}
 {"id":"warren-9d72","title":"Update comments referencing the retired brainstorm/interactive flow","status":"open","type":"task","priority":3,"plan_step_index":3,"description":"<!-- seeds:plan-backref:start -->\nStep 4 of plan pl-7580.\n\nParent seed: warren-a056 — nightwatch patrol: 2026-06-09\nPlan template: refactor\nPlan approach: Each step is an independent, comment-only fix touching a small set of files; there are no real dependencies between the four fix steps, so they can land in any order as separate PRs. The final Release step is ordered last and blocked by…\n\nRun `sd plan show pl-7580` for the full plan (context, alternatives, sibling steps, acceptance criteria).\n<!-- seeds:plan-backref:end -->","createdAt":"2026-06-09T09:08:52.347Z","updatedAt":"2026-06-09T09:08:52.347Z","labels":["nightwatch"],"plan_id":"pl-7580","blocks":["warren-f48a","warren-a056"]}
-{"id":"warren-f48a","title":"Release: run /release per .claude/commands/release.md","status":"open","type":"task","priority":3,"plan_step_index":4,"description":"<!-- seeds:plan-backref:start -->\nStep 5 of plan pl-7580.\n\nParent seed: warren-a056 — nightwatch patrol: 2026-06-09\nPlan template: refactor\nPlan approach: Each step is an independent, comment-only fix touching a small set of files; there are no real dependencies between the four fix steps, so they can land in any order as separate PRs. The final Release step is ordered last and blocked by…\n\nRun `sd plan show pl-7580` for the full plan (context, alternatives, sibling steps, acceptance criteria).\n<!-- seeds:plan-backref:end -->","createdAt":"2026-06-09T09:08:52.347Z","updatedAt":"2026-06-09T09:08:52.347Z","labels":["nightwatch"],"plan_id":"pl-7580","blockedBy":["warren-43e6","warren-bfe2","warren-9358","warren-9d72"],"blocks":["warren-a056"]}
+{"id":"warren-f48a","title":"Release: run /release per .claude/commands/release.md","status":"open","type":"task","priority":3,"plan_step_index":4,"description":"<!-- seeds:plan-backref:start -->\nStep 5 of plan pl-7580.\n\nParent seed: warren-a056 — nightwatch patrol: 2026-06-09\nPlan template: refactor\nPlan approach: Each step is an independent, comment-only fix touching a small set of files; there are no real dependencies between the four fix steps, so they can land in any order as separate PRs. The final Release step is ordered last and blocked by…\n\nRun `sd plan show pl-7580` for the full plan (context, alternatives, sibling steps, acceptance criteria).\n<!-- seeds:plan-backref:end -->","createdAt":"2026-06-09T09:08:52.347Z","updatedAt":"2026-06-09T09:15:37.125Z","labels":["nightwatch"],"plan_id":"pl-7580","blockedBy":["warren-bfe2","warren-9358","warren-9d72"],"blocks":["warren-a056"]}

src/preview/proxy/forward.ts

@@ -1,6 +1,6 @@
 /**
  * Upstream-forwarding core for the preview proxy (warren-b902 split of
- * src/preview/proxy.ts). Owns the actual `fetch` to `127.0.0.1:<port>`,
+ * src/preview/proxy/index.ts). Owns the actual `fetch` to `127.0.0.1:<port>`,
  * inbound auth-header stripping, content-encoding normalization, and
  * the debounced `preview_last_hit_at` write that drives the eviction
  * worker's idle clock.

src/preview/proxy/index.ts

@@ -71,7 +71,7 @@ import {
 import type { PreviewProxyDeps, PreviewProxyHandler } from "./types.ts";
 
 // Public surface — types, helper functions, and constants the rest of
-// the codebase and tests pull from `./proxy.ts`. Re-exported here so
+// the codebase and tests pull from `./index.ts`. Re-exported here so
 // `import ... from "../preview/proxy/index.ts"` (or just
 // `"../preview/proxy"`) keeps working after the split.
 export { DEFAULT_DEBOUNCE_MS } from "./forward.ts";

src/preview/proxy/responses.ts

@@ -1,6 +1,6 @@
 /**
  * 4xx/5xx envelope builders for the preview proxy preamble
- * (warren-b902 split of src/preview/proxy.ts). The proxy preamble runs
+ * (warren-b902 split of src/preview/proxy/index.ts). The proxy preamble runs
  * *below* warren's normal error mapper, so these helpers shape their
  * own JSON envelopes directly.
  */

src/preview/proxy/rewrite.ts

@@ -1,6 +1,6 @@
 /**
  * Path-mode HTML / URL byte-level rewrite logic for the preview proxy
- * (warren-b902 split of src/preview/proxy.ts; SPEC §11.L addendum,
+ * (warren-b902 split of src/preview/proxy/index.ts; SPEC §11.L addendum,
  * warren-ab3a + warren-63e1).
  *
  * Two byte-wise transforms run over the head of `text/html` responses

src/preview/proxy/route-match.ts

@@ -1,6 +1,6 @@
 /**
  * Route-matching parsers for the preview proxy (warren-b902 split of
- * src/preview/proxy.ts; original framing in proxy/index.ts).
+ * src/preview/proxy/index.ts; original framing in proxy/index.ts).
  *
  * Three matchers cover the proxy's two routing modes:
  *

src/preview/proxy/types.ts

@@ -1,6 +1,6 @@
 /**
  * Shared types for the preview proxy modules (warren-b902 split of
- * src/preview/proxy.ts). Lives in its own file so `responses.ts` can
+ * src/preview/proxy/index.ts). Lives in its own file so `responses.ts` can
  * reference `PreviewProxyConfig` without a cycle through `index.ts`.
  */
 

src/server/types.ts

@@ -465,7 +465,7 @@ export interface ServeOptions {
 	previewProxy?: PreviewProxyHandler;
 }
 
-/** Host-match preview proxy preamble. See `src/preview/proxy.ts`. */
+/** Host-match preview proxy preamble. See `src/preview/proxy/index.ts`. */
 export type PreviewProxyHandler = (request: Request, url: URL) => Promise<Response | null>;
 
 export interface ServeHandle {

src/ui/src/api/client.ts

@@ -360,7 +360,7 @@ export const previewApi = {
 
 /**
  * Format the canonical preview URL for a run. Mirrors server-side
- * `formatPreviewUrl` (`src/preview/launch.ts`) so the displayed URL
+ * `formatPreviewUrl` (`src/preview/launch/index.ts`) so the displayed URL
  * matches where the login handshake actually redirects:
  *
  *   - path mode      → `<origin>/p/<runId>/` (origin from `config.host`

src/warren-config/schema.ts

@@ -316,7 +316,7 @@ const ServerPreviewConfigSchema = z
 		command: PreviewCommandSchema,
 		// warren-d9e7: optional pre-step. Runs to completion before the dev
 		// server sidecar spawns; non-zero exit fails the preview before the
-		// readiness probe is attempted. See `src/preview/launch.ts`.
+		// readiness probe is attempted. See `src/preview/launch/index.ts`.
 		setup: PreviewSetupSchema.optional(),
 		setup_timeout: PreviewSetupTimeoutSchema.optional(),
 		port: PreviewPortSchema,