@plannotator/pi-extension 0.27.5 → 0.27.6

package/README.md

@@ -270,6 +270,8 @@ Plannotator does not send `Continue with the approved plan`, enter its executing
 
 Run `/plannotator-annotate <file.md>` to open any markdown file in the annotation UI. Useful for reviewing documentation or design specs with the agent.
 
+URL targets work too. A loopback `http` URL that answers with an HTML page (a running dev app, e.g. `http://localhost:5173`) opens **live**: the app is served through a local reverse proxy and annotated in place, with HMR and WebSockets passed through. `--static` forces the classic markdown conversion; `--app` requires a live session and errors instead of falling back. Live sessions are unavailable in remote mode (`PLANNOTATOR_REMOTE`).
+
 ### Annotate last message
 
 Run `/plannotator-last` to annotate the agent's most recent response. The message opens in the annotation UI where you can highlight text, add comments, and send structured feedback back to the agent.

package/generated/annotate-args.ts

@@ -47,6 +47,10 @@ export interface ParsedAnnotateArgs {
   renderHtml: boolean;
   renderMarkdown: boolean;
   noJina: boolean;
+  /** --app: force a live app session (recognized only with `liveFlags`). */
+  app: boolean;
+  /** --static: force the classic conversion pipeline (only with `liveFlags`). */
+  static: boolean;
 }
 
 type Segment = { type: "ws" | "tok"; text: string };
@@ -60,9 +64,27 @@ const FLAG_MAP = {
   "--no-jina": "noJina",
 } as const satisfies Record<string, keyof Omit<ParsedAnnotateArgs, "filePath" | "rawFilePath">>;
 
-export function parseAnnotateArgs(raw: string): ParsedAnnotateArgs {
+/** Live-mode flags, recognized only where the host actually supports live
+ * app sessions (`liveFlags: true` — Pi today). A host that cannot act on
+ * --app must NOT silently strip it: leaving the token in the path keeps the
+ * legacy "File not found: --app ..." error, which is honest about the flag
+ * being unsupported there. */
+const LIVE_FLAG_MAP = {
+  "--app": "app",
+  "--static": "static",
+} as const satisfies Record<string, keyof Omit<ParsedAnnotateArgs, "filePath" | "rawFilePath">>;
+
+export interface ParseAnnotateArgsOptions {
+  /** Recognize --app / --static (hosts with live app annotation support). */
+  liveFlags?: boolean;
+}
+
+export function parseAnnotateArgs(raw: string, opts?: ParseAnnotateArgsOptions): ParsedAnnotateArgs {
   const s = (raw ?? "").trim();
-  const flags = { gate: false, json: false, hook: false, renderHtml: false, renderMarkdown: false, noJina: false };
+  const flags = { gate: false, json: false, hook: false, renderHtml: false, renderMarkdown: false, noJina: false, app: false, static: false };
+  const flagMap: Record<string, keyof typeof flags> = opts?.liveFlags
+    ? { ...FLAG_MAP, ...LIVE_FLAG_MAP }
+    : { ...FLAG_MAP };
 
   const segments: Segment[] = [];
   for (let i = 0; i < s.length;) {
@@ -76,7 +98,7 @@ export function parseAnnotateArgs(raw: string): ParsedAnnotateArgs {
   for (let j = 0; j < segments.length; j++) {
     const seg = segments[j];
     if (seg.type !== "tok") continue;
-    const key = FLAG_MAP[seg.text as keyof typeof FLAG_MAP];
+    const key = flagMap[seg.text];
     if (!key) continue;
 
     flags[key] = true;