agendex-cli 0.13.0 → 0.15.0

package/dist/cli.js

@@ -1059,13 +1059,13 @@ var init_cleanup = __esm(() => {
 
 // src/cli.ts
 import { spawn as spawn3 } from "node:child_process";
-import { existsSync as existsSync9, statSync as statSync2, writeSync } from "node:fs";
-import { resolve as resolve6 } from "node:path";
+import { existsSync as existsSync11, statSync as statSync2, writeSync } from "node:fs";
+import { resolve as resolve7 } from "node:path";
 import { fileURLToPath as fileURLToPath2 } from "node:url";
 
 // ../shared/src/adapters/catalog.ts
-import { homedir as homedir6 } from "node:os";
-import { join as join6 } from "node:path";
+import { homedir as homedir7 } from "node:os";
+import { join as join7 } from "node:path";
 
 // ../shared/src/adapters/claude-code.ts
 import { readFile, stat, writeFile } from "node:fs/promises";
@@ -1748,6 +1748,453 @@ var ohMyOpencodeAdapter = {
   }
 };
 
+// ../shared/src/adapters/plannotator.ts
+import { existsSync as existsSync3 } from "node:fs";
+import { readFile as readFile6, stat as stat6 } from "node:fs/promises";
+import { homedir as homedir6 } from "node:os";
+import { basename as basename5, dirname, join as join6, resolve as resolve2, sep as sep2 } from "node:path";
+var REQUEST_TIMEOUT_MS = 5000;
+var PROJECT_PLANS_DIRNAME = "@plans";
+function getPlannotatorDir() {
+  return process.env.AGENDEX_PLANNOTATOR_DIR || join6(homedir6(), ".plannotator");
+}
+function getPlansDir() {
+  return join6(getPlannotatorDir(), "plans");
+}
+function getSessionsDir() {
+  return join6(getPlannotatorDir(), "sessions");
+}
+function isRecord3(value) {
+  return typeof value === "object" && value !== null;
+}
+function normalizeStatusFromFilename(filePath) {
+  const name = basename5(filePath, ".md");
+  if (name.endsWith("-approved"))
+    return "approved";
+  if (name.endsWith("-denied"))
+    return "denied";
+  return "unknown";
+}
+function stripStatusSuffix(title) {
+  return title.replace(/-(approved|denied)$/i, "");
+}
+function cleanTitle2(title) {
+  return title.replace(/\d{4}-\d{2}-\d{2}/g, "").replace(/[-_]+/g, " ").replace(/\s+/g, " ").trim();
+}
+function extractTitle5(content, filePath) {
+  const heading = content.match(/^#\s+(.+)$/m)?.[1]?.trim();
+  if (heading)
+    return heading.replace(/^Plan:\s*/i, "").trim();
+  const name = stripStatusSuffix(basename5(filePath, ".md"));
+  return cleanTitle2(name) || "Plannotator Plan";
+}
+function isAnnotationFile(filePath) {
+  return filePath.endsWith(".annotations.md");
+}
+function isSnapshotFile(filePath) {
+  if (!filePath.endsWith(".md"))
+    return false;
+  if (isAnnotationFile(filePath))
+    return false;
+  const status = normalizeStatusFromFilename(filePath);
+  return status === "approved" || status === "denied";
+}
+function isProjectPlansPath(filePath) {
+  return resolve2(filePath).split(sep2).includes(PROJECT_PLANS_DIRNAME);
+}
+function projectPlansDirForPath(filePath) {
+  const parts = resolve2(filePath).split(sep2);
+  const index = parts.lastIndexOf(PROJECT_PLANS_DIRNAME);
+  if (index === -1)
+    return;
+  return parts.slice(0, index + 1).join(sep2) || sep2;
+}
+function isProjectPlanFile(filePath) {
+  return filePath.endsWith(".md") && !isAnnotationFile(filePath) && isProjectPlansPath(filePath);
+}
+function isSessionFile2(filePath) {
+  return filePath.endsWith(".json");
+}
+function isAlive(pid) {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function isSafePlannotatorUrl(rawUrl) {
+  try {
+    const url = new URL(rawUrl);
+    if (url.protocol !== "http:")
+      return false;
+    if (url.username || url.password)
+      return false;
+    if (url.pathname !== "/" && url.pathname !== "")
+      return false;
+    if (url.search || url.hash)
+      return false;
+    const hostname = url.hostname.toLowerCase();
+    if (hostname === "localhost")
+      return true;
+    if (hostname === "127.0.0.1")
+      return true;
+    if (hostname === "::1" || hostname === "[::1]")
+      return true;
+    return false;
+  } catch {
+    return false;
+  }
+}
+function apiUrl(baseUrl, path) {
+  const url = new URL(baseUrl);
+  url.pathname = path;
+  url.search = "";
+  url.hash = "";
+  return url.toString();
+}
+async function fetchJson(url, init) {
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+  try {
+    const res = await fetch(url, {
+      ...init,
+      redirect: "error",
+      signal: controller.signal
+    });
+    if (!res.ok)
+      return null;
+    return await res.json();
+  } catch {
+    return null;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+async function postJson(url, body) {
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+  try {
+    const res = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+      redirect: "error",
+      signal: controller.signal
+    });
+    return res.ok;
+  } catch {
+    return false;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+function normalizeMode(value) {
+  if (value === "plan" || value === "review" || value === "annotate" || value === "archive") {
+    return value;
+  }
+  return;
+}
+function parseSessionInfo(raw) {
+  if (!isRecord3(raw))
+    return null;
+  const pid = typeof raw.pid === "number" && Number.isFinite(raw.pid) ? raw.pid : undefined;
+  const port = typeof raw.port === "number" && Number.isFinite(raw.port) ? raw.port : undefined;
+  const url = typeof raw.url === "string" ? raw.url : undefined;
+  if (!pid || !url)
+    return null;
+  return {
+    pid,
+    port,
+    url,
+    mode: normalizeMode(raw.mode),
+    project: typeof raw.project === "string" ? raw.project : undefined,
+    startedAt: typeof raw.startedAt === "string" ? raw.startedAt : undefined,
+    label: typeof raw.label === "string" ? raw.label : undefined,
+    origin: typeof raw.origin === "string" ? raw.origin : undefined,
+    reviewId: typeof raw.reviewId === "string" ? raw.reviewId : undefined,
+    sourcePlanPath: typeof raw.sourcePlanPath === "string" ? raw.sourcePlanPath : undefined
+  };
+}
+function parseDate2(value) {
+  if (!value)
+    return;
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime()))
+    return;
+  return date;
+}
+function metadataRecord(metadata) {
+  return {
+    source: "plannotator",
+    sourceAdapter: "plannotator",
+    plannotator: metadata
+  };
+}
+function annotationsPathForSnapshot(filePath) {
+  const snapshotBase = basename5(filePath, ".md").replace(/-(approved|denied)$/i, "");
+  return join6(dirname(filePath), `${snapshotBase}.annotations.md`);
+}
+function snapshotPathsForAnnotation(filePath) {
+  const base = basename5(filePath, ".annotations.md");
+  return [
+    join6(dirname(filePath), `${base}-approved.md`),
+    join6(dirname(filePath), `${base}-denied.md`)
+  ];
+}
+function projectPlanPathsForAnnotation(filePath) {
+  const base = basename5(filePath, ".annotations.md");
+  return [join6(dirname(filePath), `${base}.md`), ...snapshotPathsForAnnotation(filePath)];
+}
+async function countAnnotationHeadings(filePath) {
+  if (!existsSync3(filePath))
+    return;
+  try {
+    const raw = await readFile6(filePath, "utf-8");
+    const headings = raw.match(/^#{1,6}\s+/gm);
+    return headings?.length ?? (raw.trim() ? 1 : 0);
+  } catch {
+    return;
+  }
+}
+async function parseSnapshot(filePath) {
+  try {
+    const content = await readFile6(filePath, "utf-8");
+    const stats = await stat6(filePath);
+    const status = normalizeStatusFromFilename(filePath);
+    const annotationsPath = annotationsPathForSnapshot(filePath);
+    const annotationCount = await countAnnotationHeadings(annotationsPath);
+    const metadata = {
+      kind: "snapshot",
+      mode: "plan",
+      status,
+      annotationsPath: existsSync3(annotationsPath) ? annotationsPath : undefined,
+      annotationCount,
+      writebackCapable: false
+    };
+    return [
+      {
+        id: hashPath(filePath),
+        agent: "plannotator",
+        title: extractTitle5(content, filePath),
+        content,
+        filePath,
+        format: "md",
+        createdAt: stats.birthtime,
+        updatedAt: stats.mtime,
+        metadata: metadataRecord(metadata)
+      }
+    ];
+  } catch {
+    return [];
+  }
+}
+async function parseAnnotationCompanion(filePath) {
+  const plans = [];
+  for (const snapshotPath of snapshotPathsForAnnotation(filePath)) {
+    if (!existsSync3(snapshotPath))
+      continue;
+    plans.push(...await parseSnapshot(snapshotPath));
+  }
+  return plans;
+}
+async function parseProjectPlan(filePath) {
+  try {
+    const content = await readFile6(filePath, "utf-8");
+    const stats = await stat6(filePath);
+    const projectPlansDir = projectPlansDirForPath(filePath);
+    const projectRoot = projectPlansDir ? dirname(projectPlansDir) : undefined;
+    const status = normalizeStatusFromFilename(filePath);
+    const annotationsPath = annotationsPathForSnapshot(filePath);
+    const annotationCount = await countAnnotationHeadings(annotationsPath);
+    const metadata = {
+      kind: "project-plan",
+      mode: "plan",
+      status,
+      annotationsPath: existsSync3(annotationsPath) ? annotationsPath : undefined,
+      annotationCount,
+      sourcePlanPath: filePath,
+      project: projectRoot ? basename5(projectRoot) : undefined,
+      writebackCapable: false
+    };
+    return [
+      {
+        id: hashPath(filePath),
+        agent: "plannotator",
+        title: extractTitle5(content, filePath),
+        content,
+        filePath,
+        format: "md",
+        createdAt: stats.birthtime,
+        updatedAt: stats.mtime,
+        workspace: projectRoot,
+        metadata: metadataRecord(metadata)
+      }
+    ];
+  } catch {
+    return [];
+  }
+}
+async function parseProjectAnnotationCompanion(filePath) {
+  const plans = [];
+  const seen = new Set;
+  for (const planPath of projectPlanPathsForAnnotation(filePath)) {
+    const resolved = resolve2(planPath);
+    if (seen.has(resolved))
+      continue;
+    seen.add(resolved);
+    if (!existsSync3(planPath))
+      continue;
+    plans.push(...await parseProjectPlan(planPath));
+  }
+  return plans;
+}
+async function parseLiveSession(filePath) {
+  try {
+    const raw = JSON.parse(await readFile6(filePath, "utf-8"));
+    const session = parseSessionInfo(raw);
+    if (!session?.pid || !session.url)
+      return [];
+    if (!isAlive(session.pid))
+      return [];
+    if (!isSafePlannotatorUrl(session.url))
+      return [];
+    const mode = session.mode ?? "plan";
+    if (mode === "archive")
+      return [];
+    const planResponse = await fetchJson(apiUrl(session.url, "/api/plan"));
+    if (!planResponse?.plan)
+      return [];
+    const stats = await stat6(filePath);
+    const createdAt = parseDate2(session.startedAt) ?? stats.birthtime;
+    const origin = planResponse.origin ?? session.origin;
+    const responseMode = normalizeMode(planResponse.mode) ?? mode;
+    const workspace = planResponse.projectRoot;
+    const sourcePlanPath = session.sourcePlanPath ?? planResponse.filePath;
+    const metadata = {
+      kind: "live-session",
+      mode: responseMode,
+      status: "pending",
+      origin,
+      url: session.url,
+      pid: session.pid,
+      port: session.port,
+      project: session.project ?? planResponse.versionInfo?.project,
+      label: session.label,
+      reviewId: session.reviewId,
+      sessionPath: filePath,
+      sourcePlanPath,
+      startedAt: session.startedAt,
+      writebackCapable: true
+    };
+    return [
+      {
+        id: hashPath(filePath),
+        agent: origin ?? "plannotator",
+        title: extractTitle5(planResponse.plan, session.label ?? filePath),
+        content: planResponse.plan,
+        filePath: sourcePlanPath ?? filePath,
+        format: "md",
+        createdAt,
+        updatedAt: stats.mtime,
+        workspace,
+        metadata: metadataRecord(metadata)
+      }
+    ];
+  } catch {
+    return [];
+  }
+}
+function getPlannotatorMetadata(plan) {
+  const metadata = plan.metadata.plannotator;
+  if (!isRecord3(metadata))
+    return;
+  return metadata;
+}
+function formatWritebackFeedback(_plan, payload) {
+  const sections = ["# Agendex Plan Feedback", "The user reviewed this plan in Agendex Cloud."];
+  if (payload.feedback.trim()) {
+    sections.push("## Feedback", payload.feedback.trim());
+  }
+  if (payload.revisedContent?.trim()) {
+    sections.push("## Requested revision", "Use this revised plan content as the target shape when you update and resubmit the plan:", payload.revisedContent.trim());
+  }
+  if (payload.annotations?.length) {
+    sections.push("## Typed annotations", JSON.stringify(payload.annotations, null, 2));
+  }
+  sections.push("Please revise the plan and resubmit it for Plannotator review.");
+  return sections.join(`
+
+`);
+}
+function annotationsForEndpoint(annotations) {
+  return annotations ?? [];
+}
+var plannotatorAdapter = {
+  agent: "plannotator",
+  writable: false,
+  getSearchPaths() {
+    return [getPlansDir(), getSessionsDir()];
+  },
+  getWatchPaths() {
+    return [getPlansDir(), getSessionsDir()];
+  },
+  matches(filePath) {
+    const normalized = resolve2(filePath);
+    const plansDir2 = resolve2(getPlansDir());
+    const sessionsDir2 = resolve2(getSessionsDir());
+    if (normalized.startsWith(plansDir2 + sep2))
+      return isSnapshotFile(filePath) || isAnnotationFile(filePath);
+    if (normalized.startsWith(sessionsDir2 + sep2))
+      return isSessionFile2(filePath);
+    if (isProjectPlansPath(filePath))
+      return isProjectPlanFile(filePath) || isAnnotationFile(filePath);
+    return false;
+  },
+  async parse(filePath) {
+    const normalized = resolve2(filePath);
+    const plansDir2 = resolve2(getPlansDir());
+    const sessionsDir2 = resolve2(getSessionsDir());
+    if (normalized.startsWith(plansDir2 + sep2) && isSnapshotFile(filePath)) {
+      return await parseSnapshot(filePath);
+    }
+    if (normalized.startsWith(plansDir2 + sep2) && isAnnotationFile(filePath)) {
+      return await parseAnnotationCompanion(filePath);
+    }
+    if (normalized.startsWith(sessionsDir2 + sep2) && isSessionFile2(filePath)) {
+      return await parseLiveSession(filePath);
+    }
+    if (isProjectPlanFile(filePath)) {
+      return await parseProjectPlan(filePath);
+    }
+    if (isProjectPlansPath(filePath) && isAnnotationFile(filePath)) {
+      return await parseProjectAnnotationCompanion(filePath);
+    }
+    return [];
+  },
+  async write() {
+    return false;
+  },
+  async requestChanges(plan, payload) {
+    const metadata = getPlannotatorMetadata(plan);
+    if (!metadata?.url || !metadata.writebackCapable)
+      return false;
+    if (!isSafePlannotatorUrl(metadata.url))
+      return false;
+    const feedback = formatWritebackFeedback(plan, payload);
+    if (metadata.mode === "review" || metadata.mode === "annotate") {
+      return await postJson(apiUrl(metadata.url, "/api/feedback"), {
+        feedback,
+        annotations: annotationsForEndpoint(payload.annotations)
+      });
+    }
+    return await postJson(apiUrl(metadata.url, "/api/deny"), {
+      feedback,
+      planSave: { enabled: true }
+    });
+  }
+};
+
 // ../shared/src/adapters/stub.ts
 function createStubAdapter(agent, searchPaths, matchExt) {
   return {
@@ -1762,7 +2209,7 @@ function createStubAdapter(agent, searchPaths, matchExt) {
 }
 
 // ../shared/src/adapters/catalog.ts
-var home = homedir6();
+var home = homedir7();
 var ADAPTER_AGENT_ALIASES = {
   amp: "amp",
   antigravity: "antigravity",
@@ -1792,6 +2239,7 @@ var ADAPTER_AGENT_ALIASES = {
   opencode: "oh-my-opencode",
   openhands: "openhands",
   pi: "pi",
+  plannotator: "plannotator",
   qoder: "qoder",
   "qwen-code": "qwen-code",
   replit: "replit",
@@ -1812,7 +2260,7 @@ var CATALOG = [
     group: "universal",
     implemented: false,
     defaultEnabled: true,
-    createAdapter: () => createStubAdapter("amp", [join6(home, ".amp")], ".json")
+    createAdapter: () => createStubAdapter("amp", [join7(home, ".amp")], ".json")
   },
   {
     id: "antigravity",
@@ -1820,7 +2268,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("antigravity", [join6(home, ".gemini", "antigravity")], ".json")
+    createAdapter: () => createStubAdapter("antigravity", [join7(home, ".gemini", "antigravity")], ".json")
   },
   {
     id: "augment",
@@ -1828,7 +2276,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("augment", [join6(home, ".augment")], ".json")
+    createAdapter: () => createStubAdapter("augment", [join7(home, ".augment")], ".json")
   },
   {
     id: "claude-code",
@@ -1844,7 +2292,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("openclaw", [join6(home, ".openclaw")], ".md")
+    createAdapter: () => createStubAdapter("openclaw", [join7(home, ".openclaw")], ".md")
   },
   {
     id: "cline",
@@ -1853,8 +2301,8 @@ var CATALOG = [
     implemented: false,
     defaultEnabled: true,
     createAdapter: () => createStubAdapter("cline", [
-      join6(home, "AppData", "Roaming", "Code", "User", "globalStorage", "saoudrizwan.claude-dev"),
-      join6(home, ".config", "Code", "User", "globalStorage", "saoudrizwan.claude-dev")
+      join7(home, "AppData", "Roaming", "Code", "User", "globalStorage", "saoudrizwan.claude-dev"),
+      join7(home, ".config", "Code", "User", "globalStorage", "saoudrizwan.claude-dev")
     ], ".json")
   },
   {
@@ -1863,7 +2311,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("codebuddy", [join6(home, ".codebuddy")], ".md")
+    createAdapter: () => createStubAdapter("codebuddy", [join7(home, ".codebuddy")], ".md")
   },
   {
     id: "codex",
@@ -1879,7 +2327,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("command-code", [join6(home, ".commandcode")], ".md")
+    createAdapter: () => createStubAdapter("command-code", [join7(home, ".commandcode")], ".md")
   },
   {
     id: "continue",
@@ -1895,7 +2343,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("crush", [join6(home, ".config", "crush")], ".json")
+    createAdapter: () => createStubAdapter("crush", [join7(home, ".config", "crush")], ".json")
   },
   {
     id: "cursor",
@@ -1911,7 +2359,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: true,
-    createAdapter: () => createStubAdapter("droid", [join6(home, ".factory", "droids")], ".md")
+    createAdapter: () => createStubAdapter("droid", [join7(home, ".factory", "droids")], ".md")
   },
   {
     id: "gemini-cli",
@@ -1919,7 +2367,7 @@ var CATALOG = [
     group: "universal",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("gemini-cli", [join6(home, ".gemini")], ".md")
+    createAdapter: () => createStubAdapter("gemini-cli", [join7(home, ".gemini")], ".md")
   },
   {
     id: "github-copilot",
@@ -1927,7 +2375,7 @@ var CATALOG = [
     group: "universal",
     implemented: false,
     defaultEnabled: true,
-    createAdapter: () => createStubAdapter("copilot-chat", [join6(home, ".vscode", "User", "workspaceStorage")], ".json")
+    createAdapter: () => createStubAdapter("copilot-chat", [join7(home, ".vscode", "User", "workspaceStorage")], ".json")
   },
   {
     id: "goose",
@@ -1935,7 +2383,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("goose", [join6(home, ".config", "goose")], ".json")
+    createAdapter: () => createStubAdapter("goose", [join7(home, ".config", "goose")], ".json")
   },
   {
     id: "junie",
@@ -1943,7 +2391,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("junie", [join6(home, ".junie")], ".json")
+    createAdapter: () => createStubAdapter("junie", [join7(home, ".junie")], ".json")
   },
   {
     id: "iflow-cli",
@@ -1951,7 +2399,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("iflow-cli", [join6(home, ".iflow")], ".json")
+    createAdapter: () => createStubAdapter("iflow-cli", [join7(home, ".iflow")], ".json")
   },
   {
     id: "kilo",
@@ -1959,7 +2407,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: true,
-    createAdapter: () => createStubAdapter("kilo-cli", [join6(home, ".kilo")], ".md")
+    createAdapter: () => createStubAdapter("kilo-cli", [join7(home, ".kilo")], ".md")
   },
   {
     id: "kimi-cli",
@@ -1967,7 +2415,7 @@ var CATALOG = [
     group: "universal",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("kimi-cli", [join6(home, ".kimi")], ".md")
+    createAdapter: () => createStubAdapter("kimi-cli", [join7(home, ".kimi")], ".md")
   },
   {
     id: "kiro-cli",
@@ -1975,7 +2423,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("kiro-cli", [join6(home, ".kiro")], ".json")
+    createAdapter: () => createStubAdapter("kiro-cli", [join7(home, ".kiro")], ".json")
   },
   {
     id: "kode",
@@ -1983,7 +2431,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("kode", [join6(home, ".kode")], ".json")
+    createAdapter: () => createStubAdapter("kode", [join7(home, ".kode")], ".json")
   },
   {
     id: "mcpjam",
@@ -1991,7 +2439,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("mcpjam", [join6(home, ".mcpjam")], ".json")
+    createAdapter: () => createStubAdapter("mcpjam", [join7(home, ".mcpjam")], ".json")
   },
   {
     id: "mistral-vibe",
@@ -1999,7 +2447,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("mistral-vibe", [join6(home, ".vibe")], ".json")
+    createAdapter: () => createStubAdapter("mistral-vibe", [join7(home, ".vibe")], ".json")
   },
   {
     id: "mux",
@@ -2007,7 +2455,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("mux", [join6(home, ".mux")], ".json")
+    createAdapter: () => createStubAdapter("mux", [join7(home, ".mux")], ".json")
   },
   {
     id: "opencode",
@@ -2023,7 +2471,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("openhands", [join6(home, ".openhands")], ".json")
+    createAdapter: () => createStubAdapter("openhands", [join7(home, ".openhands")], ".json")
   },
   {
     id: "pi",
@@ -2031,7 +2479,15 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("pi", [join6(home, ".pi", "agent")], ".md")
+    createAdapter: () => createStubAdapter("pi", [join7(home, ".pi", "agent")], ".md")
+  },
+  {
+    id: "plannotator",
+    displayName: "Plannotator",
+    group: "universal",
+    implemented: true,
+    defaultEnabled: false,
+    createAdapter: () => plannotatorAdapter
   },
   {
     id: "qoder",
@@ -2039,7 +2495,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("qoder", [join6(home, ".qoder")], ".json")
+    createAdapter: () => createStubAdapter("qoder", [join7(home, ".qoder")], ".json")
   },
   {
     id: "qwen-code",
@@ -2047,7 +2503,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("qwen-code", [join6(home, ".qwen")], ".json")
+    createAdapter: () => createStubAdapter("qwen-code", [join7(home, ".qwen")], ".json")
   },
   {
     id: "replit",
@@ -2055,7 +2511,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("replit", [join6(home, ".replit")], ".md")
+    createAdapter: () => createStubAdapter("replit", [join7(home, ".replit")], ".md")
   },
   {
     id: "roo",
@@ -2063,7 +2519,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("roo", [join6(home, ".roo")], ".md")
+    createAdapter: () => createStubAdapter("roo", [join7(home, ".roo")], ".md")
   },
   {
     id: "trae",
@@ -2071,7 +2527,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("trae", [join6(home, ".trae")], ".md")
+    createAdapter: () => createStubAdapter("trae", [join7(home, ".trae")], ".md")
   },
   {
     id: "trae-cn",
@@ -2079,7 +2535,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("trae-cn", [join6(home, ".trae-cn")], ".md")
+    createAdapter: () => createStubAdapter("trae-cn", [join7(home, ".trae-cn")], ".md")
   },
   {
     id: "windsurf",
@@ -2087,7 +2543,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: true,
-    createAdapter: () => createStubAdapter("windsurf", [join6(home, ".cascade_backups")], ".md")
+    createAdapter: () => createStubAdapter("windsurf", [join7(home, ".cascade_backups")], ".md")
   },
   {
     id: "zencoder",
@@ -2095,7 +2551,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("zencoder", [join6(home, ".zencoder")], ".json")
+    createAdapter: () => createStubAdapter("zencoder", [join7(home, ".zencoder")], ".json")
   },
   {
     id: "neovate",
@@ -2103,7 +2559,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("neovate", [join6(home, ".neovate")], ".json")
+    createAdapter: () => createStubAdapter("neovate", [join7(home, ".neovate")], ".json")
   },
   {
     id: "pochi",
@@ -2111,7 +2567,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("pochi", [join6(home, ".pochi")], ".json")
+    createAdapter: () => createStubAdapter("pochi", [join7(home, ".pochi")], ".json")
   },
   {
     id: "adal",
@@ -2119,7 +2575,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: false,
-    createAdapter: () => createStubAdapter("adal", [join6(home, ".adal")], ".json")
+    createAdapter: () => createStubAdapter("adal", [join7(home, ".adal")], ".json")
   },
   {
     id: "aider",
@@ -2127,7 +2583,7 @@ var CATALOG = [
     group: "other",
     implemented: false,
     defaultEnabled: true,
-    createAdapter: () => createStubAdapter("aider", [join6(home, ".aider")], ".aider.chat.history.md")
+    createAdapter: () => createStubAdapter("aider", [join7(home, ".aider")], ".aider.chat.history.md")
   }
 ];
 function getAdapterCatalog() {
@@ -2198,9 +2654,9 @@ function getActiveAdapters() {
 var activeAdapters = resolveAdapters(getDefaultAdapterIds());
 // ../shared/src/config.ts
 import { randomBytes } from "node:crypto";
-import { existsSync as existsSync3, mkdirSync, readFileSync as readFileSync3, writeFileSync } from "node:fs";
-import { homedir as homedir7 } from "node:os";
-import { join as join7, resolve as resolve2 } from "node:path";
+import { existsSync as existsSync4, mkdirSync, readFileSync as readFileSync3, writeFileSync } from "node:fs";
+import { homedir as homedir8 } from "node:os";
+import { join as join8, resolve as resolve3 } from "node:path";
 
 // ../shared/src/setup/adapter-selection.ts
 init_dist2();
@@ -2256,6 +2712,16 @@ async function promptForAdapterSelection(options = {}) {
 
 // ../shared/src/config.ts
 var devModeOverride;
+function getHomeDir() {
+  if (process.env.HOME)
+    return process.env.HOME;
+  if (process.env.USERPROFILE)
+    return process.env.USERPROFILE;
+  if (process.env.HOMEDRIVE && process.env.HOMEPATH) {
+    return `${process.env.HOMEDRIVE}${process.env.HOMEPATH}`;
+  }
+  return homedir8();
+}
 function setDevMode(dev) {
   devModeOverride = dev;
 }
@@ -2265,16 +2731,19 @@ function isDevMode() {
   return process.env.AGENDEX_DEV === "1";
 }
 function getConfigDir() {
-  return join7(homedir7(), isDevMode() ? ".agendex-dev" : ".agendex");
+  const override = process.env.AGENDEX_CONFIG_DIR?.trim();
+  if (override)
+    return resolve3(expandHomePath(override));
+  return join8(getHomeDir(), isDevMode() ? ".agendex-dev" : ".agendex");
 }
 function ensureConfigDir() {
   const dir = getConfigDir();
-  if (!existsSync3(dir))
+  if (!existsSync4(dir))
     mkdirSync(dir, { recursive: true });
 }
 function readStoredConfig() {
   const cfgPath = getConfigPath();
-  if (!existsSync3(cfgPath))
+  if (!existsSync4(cfgPath))
     return null;
   try {
     const raw = JSON.parse(readFileSync3(cfgPath, "utf-8"));
@@ -2292,7 +2761,7 @@ function normalizeAdapterIds(input) {
 }
 function expandHomePath(p) {
   if (p.startsWith("~/") || p === "~")
-    return join7(homedir7(), p.slice(1));
+    return join8(getHomeDir(), p.slice(1));
   return p;
 }
 function resolveCustomPlanDirPath(userPath) {
@@ -2300,7 +2769,7 @@ function resolveCustomPlanDirPath(userPath) {
   if (!trimmed) {
     throw new Error("Custom plan directory path must not be empty");
   }
-  return resolve2(expandHomePath(trimmed));
+  return resolve3(expandHomePath(trimmed));
 }
 function normalizeCustomPlanDirs(input) {
   if (!Array.isArray(input))
@@ -2365,6 +2834,7 @@ function loadOrCreateToken() {
     return existing.token;
   const token = generateToken();
   saveConfig({
+    ...existing ?? {},
     configVersion: 3,
     token,
     enabledAdapters: existing?.enabledAdapters ?? [],
@@ -2391,7 +2861,7 @@ function loadOrCreateDeviceId() {
   return deviceId;
 }
 function getConfigPath() {
-  return join7(getConfigDir(), "config.json");
+  return join8(getConfigDir(), "config.json");
 }
 async function loadOrInitConfig(options = {}) {
   const configureAdapters = Boolean(options.configureAdapters);
@@ -2438,17 +2908,348 @@ async function loadOrInitConfig(options = {}) {
 var CLI_DAEMON_HEARTBEAT_INTERVAL_MS = 30000;
 var CLI_DAEMON_STALE_AFTER_MS = CLI_DAEMON_HEARTBEAT_INTERVAL_MS * 5;
 // ../shared/src/services/plan-service.ts
-import { existsSync as existsSync4, readdirSync as readdirSync3, statSync } from "node:fs";
-import { lstat, mkdir, readdir as readdir2, readFile as readFile6, stat as stat6, writeFile as writeFile3 } from "node:fs/promises";
-import { homedir as homedir8 } from "node:os";
-import { join as join8, resolve as resolve3, sep as sep2 } from "node:path";
+import { existsSync as existsSync5, readdirSync as readdirSync3, realpathSync, statSync } from "node:fs";
+import { lstat, mkdir, readdir as readdir2, readFile as readFile7, stat as stat7, writeFile as writeFile3 } from "node:fs/promises";
+import { homedir as homedir9 } from "node:os";
+import { dirname as dirname2, join as join9, resolve as resolve4, sep as sep3 } from "node:path";
+
+// ../shared/src/services/plan-value.ts
+function isLowValuePlan(plan) {
+  const metadata = plan.metadata;
+  return typeof metadata === "object" && metadata !== null && !Array.isArray(metadata) && metadata.lowValue === true;
+}
+function isIndexablePlan(plan) {
+  return !isLowValuePlan(plan);
+}
+var PROPOSED_PLAN_TAG_REGEX2 = /<\s*\/?\s*proposed_plan\s*>/gi;
+var ESCAPED_PROPOSED_PLAN_TAG_REGEX2 = /&lt;\s*\/?\s*proposed_plan\s*&gt;/gi;
+var VISIBLE_TEXT_REGEX = /[\p{L}\p{N}]/u;
+var LOW_VALUE_METADATA_KEYS = ["lowValue", "lowValueReasons", "lowValueSignals"];
+function normalizeLineEndings2(text) {
+  return text.replace(/\r\n?/g, `
+`);
+}
+function stripBoundaryHtmlComments(text) {
+  let next = text;
+  let previous = "";
+  while (next !== previous) {
+    previous = next;
+    next = next.replace(/^\s*<!--[\s\S]*?-->\s*/, "").replace(/\s*<!--[\s\S]*?-->\s*$/, "");
+  }
+  return next;
+}
+function normalizePlanContent(content) {
+  return stripBoundaryHtmlComments(normalizeLineEndings2(content).replace(/^\uFEFF/, "").replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, "").replace(ESCAPED_PROPOSED_PLAN_TAG_REGEX2, "").replace(PROPOSED_PLAN_TAG_REGEX2, "")).trim();
+}
+function withoutLowValueMetadata(metadata) {
+  const next = { ...metadata ?? {} };
+  for (const key of LOW_VALUE_METADATA_KEYS)
+    delete next[key];
+  return next;
+}
+function unique(items) {
+  return Array.from(new Set(items));
+}
+function visibleText(text) {
+  return text.replace(/<!--[\s\S]*?-->/g, "").replace(/^---\s*\n[\s\S]*?\n---\s*\n?/, "").replace(ESCAPED_PROPOSED_PLAN_TAG_REGEX2, "").replace(PROPOSED_PLAN_TAG_REGEX2, "").replace(/[`*_#[\](){}<>:|~\-+=.]/g, " ").trim();
+}
+function isSeparatorLine(line) {
+  return /^(?:-{3,}|_{3,}|\*{3,})$/.test(line.trim());
+}
+function isFenceLine(line) {
+  return /^(?:`{3,}|~{3,})/.test(line.trim());
+}
+function meaningfulLines(text) {
+  return text.split(`
+`).map((line) => line.trim()).filter((line) => line && !isSeparatorLine(line) && !isFenceLine(line));
+}
+function cleanMarkdownLine(line) {
+  return line.trim().replace(/^>+\s*/, "").replace(/^#{1,6}\s+/, "").replace(/^[-*+]\s+/, "").replace(/^\d+[.)]\s+/, "").replace(/^\[[ xX]\]\s+/, "").replace(/^\*\*|\*\*$/g, "").replace(/^`|`$/g, "").trim();
+}
+function isHeadingLine(line) {
+  return /^#{1,6}\s+\S/.test(line.trim());
+}
+function isChecklistLine(line) {
+  return /^[-*+]\s+\[[ xX]\]\s+\S/.test(line.trim());
+}
+function isOrderedListLine(line) {
+  return /^\d+[.)]\s+\S/.test(line.trim());
+}
+function isHeadingOnly(lines) {
+  return lines.length > 0 && lines.some(isHeadingLine) && lines.every(isHeadingLine);
+}
+function metadataHasPlanBlocks(metadata) {
+  const planBlocks = metadata?.planBlocks;
+  return typeof planBlocks === "number" && planBlocks > 0;
+}
+function sectionName(line) {
+  return cleanMarkdownLine(line).replace(/:$/, "").toLowerCase().replace(/\s+/g, " ");
+}
+var SECTION_LABELS = new Set([
+  "context",
+  "background",
+  "problem",
+  "goal",
+  "goals",
+  "scope",
+  "approach",
+  "strategy",
+  "design",
+  "implementation plan",
+  "implementation",
+  "plan",
+  "files to modify",
+  "files changed",
+  "affected files",
+  "steps",
+  "step",
+  "tasks",
+  "task",
+  "checklist",
+  "todo",
+  "todos",
+  "verification",
+  "testing",
+  "tests",
+  "test",
+  "validation",
+  "reuse",
+  "existing utilities",
+  "existing code",
+  "acceptance criteria",
+  "success criteria"
+]);
+function hasSectionSyntax(line, section) {
+  const cleaned = cleanMarkdownLine(line);
+  return isHeadingLine(line) || /^[a-z][\w\s/&+-]{1,48}:/i.test(cleaned) || SECTION_LABELS.has(section);
+}
+function collectPositiveSignals(normalized, lines, metadata) {
+  const signals = [];
+  if (metadataHasPlanBlocks(metadata))
+    signals.push("metadata:proposed-plan-block");
+  for (const line of lines) {
+    const section = sectionName(line);
+    if (!hasSectionSyntax(line, section))
+      continue;
+    if (/^(context|background|problem|goal|goals|scope)\b/.test(section)) {
+      signals.push("section:context");
+      continue;
+    }
+    if (/^(approach|strategy|design)\b/.test(section)) {
+      signals.push("section:approach");
+      continue;
+    }
+    if (/^(implementation plan|implementation|plan)\b/.test(section)) {
+      signals.push("section:implementation-plan");
+      continue;
+    }
+    if (/^(files? to modify|files? changed|affected files?)\b/.test(section)) {
+      signals.push("section:files-to-modify");
+      continue;
+    }
+    if (/^(steps?|tasks?|checklist|todo|todos)\b/.test(section)) {
+      signals.push("section:steps");
+      continue;
+    }
+    if (/^(verification|testing|tests?|validation)\b/.test(section)) {
+      signals.push("section:verification");
+      continue;
+    }
+    if (/^(reuse|existing utilities|existing code)\b/.test(section)) {
+      signals.push("section:reuse");
+      continue;
+    }
+    if (/^(acceptance criteria|success criteria)\b/.test(section)) {
+      signals.push("section:acceptance-criteria");
+    }
+  }
+  if (lines.some(isChecklistLine))
+    signals.push("checklist");
+  const orderedStepCount = lines.filter(isOrderedListLine).length;
+  if (orderedStepCount >= 2)
+    signals.push("ordered-steps");
+  const actionBulletCount = lines.filter((line) => {
+    const trimmed = line.trim();
+    if (!/^(?:[-*+]|\d+[.)])\s+/.test(trimmed))
+      return false;
+    const cleaned = cleanMarkdownLine(trimmed);
+    return /^(?:add|implement|update|modify|create|remove|delete|refactor|test|verify|run|wire|persist|handle|ensure|document|rename|move|extract|reuse|validate)\b/i.test(cleaned);
+  }).length;
+  if (actionBulletCount >= 2)
+    signals.push("action-bullets");
+  if (lines.length >= 2 && /\b(?:will|should|need to|needs to|plan to|planned|approach is to|implementation will)\b/i.test(normalized)) {
+    signals.push("future-plan-language");
+  }
+  return unique(signals);
+}
+function isStrongPositiveSignal(signal) {
+  return signal === "metadata:proposed-plan-block" || signal === "checklist" || signal === "ordered-steps" || signal === "action-bullets" || signal === "section:approach" || signal === "section:implementation-plan" || signal === "section:files-to-modify" || signal === "section:steps" || signal === "section:acceptance-criteria";
+}
+function hasStrongPlanSignal(positiveSignals) {
+  const sectionCount = positiveSignals.filter((signal) => signal.startsWith("section:")).length;
+  return positiveSignals.some(isStrongPositiveSignal) || sectionCount >= 2;
+}
+function isPromptLikeOneLiner(line) {
+  if (isHeadingLine(line) || isChecklistLine(line) || isOrderedListLine(line))
+    return false;
+  const cleaned = cleanMarkdownLine(line).toLowerCase();
+  if (!cleaned)
+    return false;
+  return [
+    /^(?:important:\s*)?work in\b/,
+    /^(?:please|pls)\b/,
+    /^(?:can|could|would|will)\s+you\b/,
+    /^(?:i|we)\s+(?:need|want|would like|have to)\b/,
+    /^(?:help|fix|implement|create|add|update|remove|delete|refactor|write|review|investigate|debug|plan)\b/,
+    /\?$/,
+    /\b(?:repository|repo|existing branch|worktree|pull request|pr)\b/
+  ].some((pattern) => pattern.test(cleaned));
+}
+function normalizedTitle(title) {
+  return cleanMarkdownLine(title ?? "").toLowerCase();
+}
+function looksLikeWrapperTitle(title) {
+  return /^<user_(?:action|instructions|prompt)>$/i.test((title ?? "").trim());
+}
+function looksLikePromptTitle(title) {
+  const cleaned = normalizedTitle(title);
+  if (!cleaned)
+    return false;
+  return [
+    /^(?:important:\s*)?work in\b/,
+    /^review the code changes against\b/,
+    /^perform a .*review\b/,
+    /^(?:please|pls)\b/,
+    /^(?:can|could|would|will)\s+you\b/,
+    /^(?:i|we)\s+(?:need|want|would like|have to)\b/,
+    /^(?:help|fix|implement|create|add|update|remove|delete|refactor|write|review|investigate|debug|plan)\b/,
+    /\?$/,
+    /\b(?:repository|repo|existing branch|worktree|pull request|pr)\b/
+  ].some((pattern) => pattern.test(cleaned));
+}
+function looksLikeReviewOutput(normalized, title) {
+  const cleanedTitle = normalizedTitle(title);
+  const lower = normalized.toLowerCase();
+  return /^review the code changes against\b/.test(cleanedTitle) || /^perform a .*review\b/.test(cleanedTitle) || /"findings"\s*:\s*\[/.test(normalized) || /"overall_correctness"\s*:/.test(normalized) || /\bfull review comments\s*:/i.test(normalized) || /\bthe patch (?:currently )?(?:breaks|introduces|regresses)\b/i.test(normalized) || /\bshould not be considered correct\b/i.test(lower);
+}
+function looksLikeSystemContext(normalized, lines) {
+  const lower = normalized.toLowerCase();
+  if (lower.startsWith("# agents.md instructions") || lower.startsWith("<environment_context>") || lower.startsWith("<system-reminder>") || lower.startsWith("<thinking>")) {
+    return true;
+  }
+  const wrapperMatches = normalized.match(/<\/?(?:environment_context|system-reminder|thinking|analysis|reasoning|tool_call|tool_result)\b[^>]*>/gi);
+  if (wrapperMatches && wrapperMatches.length >= 2)
+    return true;
+  const wrapperLineCount = lines.filter((line) => /^(?:analysis|reasoning|thought|assistant thought|system|developer):\b/i.test(line)).length;
+  return wrapperLineCount > 0 && wrapperLineCount / Math.max(lines.length, 1) >= 0.4;
+}
+function looksLikeToolLog(normalized) {
+  return /::[a-z0-9_-]+(?:\{|\[|\s*$)/i.test(normalized) || /<\/?(?:tool_call|tool_result)\b[^>]*>/i.test(normalized) || /\b(?:function_call|tool_calls|tool_result)\b/i.test(normalized);
+}
+function looksLikeExecutionReport(normalized) {
+  const hasPastCompletion = /\b(?:fixed|pushed|committed|completed|done|implemented|updated|changed|patched|merged|deployed|passed|failed|resolved|reverted)\b/i.test(normalized);
+  const hasReportSection = /^\s*(?:summary|result|results|changes|verification|status)\s*:/im.test(normalized);
+  const hasReviewReportMarker = /\b(?:review findings?|review issues?|review comments?)\b/i.test(normalized);
+  const hasCommandMarker = /::[a-z0-9_-]+(?:\{|\[|\s*$)/im.test(normalized) || /`[^`]*(?:bun|npm|pnpm|yarn|git|tsc|biome)[^`]*`/i.test(normalized) || /\b(?:git\s+(?:stage|commit|push|status)|bunx?\s+|npm\s+|pnpm\s+|yarn\s+)\b/i.test(normalized);
+  return hasPastCompletion && (hasReportSection || hasCommandMarker || hasReviewReportMarker);
+}
+function lowValueAssessment(reasons, signals) {
+  return {
+    lowValue: reasons.length > 0,
+    reasons: unique(reasons),
+    signals: unique(signals).slice(0, 20)
+  };
+}
+function assessPlanValue(input) {
+  const metadata = withoutLowValueMetadata(input.metadata);
+  const normalized = normalizePlanContent(input.content);
+  const lines = meaningfulLines(normalized);
+  const positiveSignals = collectPositiveSignals(normalized, lines, metadata);
+  const signals = [...positiveSignals];
+  const reasons = [];
+  if (!VISIBLE_TEXT_REGEX.test(visibleText(normalized))) {
+    return lowValueAssessment(["empty-content"], ["negative:empty-content"]);
+  }
+  if (isHeadingOnly(lines)) {
+    return lowValueAssessment(["heading-only"], [...signals, "negative:heading-only"]);
+  }
+  const explicitPlanBlock = metadataHasPlanBlocks(metadata);
+  const strongPositive = hasStrongPlanSignal(positiveSignals);
+  const systemContext = looksLikeSystemContext(normalized, lines);
+  const toolLog = looksLikeToolLog(normalized);
+  const executionReport = looksLikeExecutionReport(normalized);
+  const wrapperTitle = looksLikeWrapperTitle(input.title);
+  const promptTitle = looksLikePromptTitle(input.title);
+  const reviewOutput = looksLikeReviewOutput(normalized, input.title);
+  if (systemContext)
+    signals.push("negative:system-context");
+  if (toolLog)
+    signals.push("negative:tool-log");
+  if (executionReport)
+    signals.push("negative:execution-report");
+  if (wrapperTitle)
+    signals.push("negative:wrapper-title");
+  if (promptTitle)
+    signals.push("negative:prompt-title");
+  if (reviewOutput)
+    signals.push("negative:review-output");
+  if (lines.length === 1)
+    signals.push("shape:single-line");
+  if (lines.length === 1 && positiveSignals.length === 0) {
+    reasons.push(isPromptLikeOneLiner(lines[0] ?? "") ? "prompt-like" : "no-plan-signals");
+  }
+  if (systemContext && !strongPositive)
+    reasons.push("system-context");
+  if (executionReport && !strongPositive)
+    reasons.push("execution-report");
+  if (wrapperTitle && !explicitPlanBlock)
+    reasons.push("wrapper-title");
+  if (reviewOutput && !explicitPlanBlock)
+    reasons.push("review-output");
+  if (promptTitle && !strongPositive && positiveSignals.length === 0)
+    reasons.push("prompt-like");
+  if (toolLog && !strongPositive && positiveSignals.length === 0)
+    reasons.push("no-plan-signals");
+  if (reasons.length === 0 && positiveSignals.length === 0 && lines.length <= 3) {
+    reasons.push("no-plan-signals");
+  }
+  return lowValueAssessment(reasons, signals);
+}
+function annotatePlanValueMetadata(plan) {
+  const baseMetadata = withoutLowValueMetadata(plan.metadata);
+  const assessment = assessPlanValue({
+    content: plan.content,
+    title: plan.title,
+    metadata: baseMetadata
+  });
+  if (!assessment.lowValue) {
+    return {
+      ...plan,
+      metadata: baseMetadata
+    };
+  }
+  return {
+    ...plan,
+    metadata: {
+      ...baseMetadata,
+      lowValue: true,
+      lowValueReasons: assessment.reasons,
+      lowValueSignals: assessment.signals
+    }
+  };
+}
+
+// ../shared/src/services/plan-service.ts
 function getUserPlansDir() {
-  return join8(getConfigDir(), "plans");
+  return join9(getConfigDir(), "plans");
 }
 var store = new Map;
 var MAX_DEPTH = 6;
 var DISCOVERY_MAX_DEPTH = 4;
-var PROJECT_PLAN_MARKERS = [{ marker: ".sisyphus/plans", agent: "oh-my-opencode" }];
+var PROJECT_PLAN_MARKERS = [
+  { marker: ".sisyphus/plans", agent: "oh-my-opencode" },
+  { marker: "@plans", agent: "plannotator" }
+];
 var SKIP_DIRS = new Set([
   "node_modules",
   ".git",
@@ -2481,19 +3282,58 @@ var SKIP_DIRS = new Set([
   "Google Drive",
   "iCloud Drive"
 ]);
+function getRuntimeHomeDir() {
+  const homeFromEnv = process.env.HOME || process.env.USERPROFILE || (process.env.HOMEDRIVE && process.env.HOMEPATH ? `${process.env.HOMEDRIVE}${process.env.HOMEPATH}` : undefined);
+  return resolve4(homeFromEnv || homedir9());
+}
 function discoverProjectPlanDirs() {
-  const home2 = homedir8();
+  const home2 = canonicalPath(getRuntimeHomeDir());
   const results = [];
-  function walk(dir, depth) {
-    if (depth > DISCOVERY_MAX_DEPTH)
+  const seen = new Set;
+  let nearestAncestorMarkerRoot;
+  function addResult(dir, agent) {
+    const resolved = canonicalPath(dir);
+    const key = `${agent}:${resolved}`;
+    if (seen.has(key))
       return;
+    seen.add(key);
+    results.push({ dir: resolved, agent });
+  }
+  function inspectMarkers(dir) {
+    let found = false;
     for (const { marker, agent } of PROJECT_PLAN_MARKERS) {
-      const candidate = join8(dir, marker);
-      if (existsSync4(candidate)) {
-        results.push({ dir: candidate, agent });
+      const candidate = join9(dir, marker);
+      if (existsSync5(candidate)) {
+        addResult(candidate, agent);
+        found = true;
+      }
+    }
+    return found;
+  }
+  function walkAncestorsForCurrentProject() {
+    let dir = canonicalPath(process.cwd());
+    while (true) {
+      if (inspectMarkers(dir)) {
+        nearestAncestorMarkerRoot = dir;
         return;
       }
+      if (dir === home2)
+        return;
+      const parent = dirname2(dir);
+      if (parent === dir)
+        return;
+      dir = parent;
     }
+  }
+  function isAncestorOfNearestMarker(dir) {
+    return Boolean(nearestAncestorMarkerRoot?.startsWith(dir + sep3));
+  }
+  function walk(dir, depth) {
+    if (depth > DISCOVERY_MAX_DEPTH)
+      return;
+    const resolved = canonicalPath(dir);
+    if (!isAncestorOfNearestMarker(resolved) && inspectMarkers(dir))
+      return;
     let names;
     try {
       names = readdirSync3(dir);
@@ -2505,13 +3345,14 @@ function discoverProjectPlanDirs() {
         continue;
       if (SKIP_DIRS.has(name))
         continue;
-      const full = join8(dir, name);
+      const full = join9(dir, name);
       try {
         if (statSync(full).isDirectory())
           walk(full, depth + 1);
       } catch {}
     }
   }
+  walkAncestorsForCurrentProject();
   walk(home2, 0);
   return results;
 }
@@ -2525,9 +3366,9 @@ function notifyPlansChanged() {
 async function walkDir(dir, depth = 0, seen = new Set) {
   if (depth > MAX_DEPTH)
     return [];
-  if (!existsSync4(dir))
+  if (!existsSync5(dir))
     return [];
-  const real = resolve3(dir);
+  const real = resolve4(dir);
   if (seen.has(real))
     return [];
   seen.add(real);
@@ -2535,7 +3376,7 @@ async function walkDir(dir, depth = 0, seen = new Set) {
   try {
     const entries = await readdir2(dir, { withFileTypes: true });
     for (const entry of entries) {
-      const full = join8(dir, entry.name);
+      const full = join9(dir, entry.name);
       try {
         const stats = await lstat(full);
         if (stats.isSymbolicLink())
@@ -2552,8 +3393,8 @@ async function walkDir(dir, depth = 0, seen = new Set) {
 }
 async function parseGenericMarkdownPlan(filePath, extraMetadata) {
   try {
-    const content = await readFile6(filePath, "utf-8");
-    const stats = await stat6(filePath);
+    const content = await readFile7(filePath, "utf-8");
+    const stats = await stat7(filePath);
     let agent = (typeof extraMetadata.agentHint === "string" ? extraMetadata.agentHint : "") || "unknown";
     const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
     if (fmMatch) {
@@ -2581,7 +3422,7 @@ async function parseGenericMarkdownPlan(filePath, extraMetadata) {
 }
 async function scanUserPlans(into) {
   const userPlansDir = getUserPlansDir();
-  if (!existsSync4(userPlansDir))
+  if (!existsSync5(userPlansDir))
     return;
   const files = await walkDir(userPlansDir);
   for (const file of files) {
@@ -2595,19 +3436,27 @@ async function scanUserPlans(into) {
 function getCustomPlanDirs() {
   return loadConfig()?.customPlanDirs ?? [];
 }
+function canonicalPath(path) {
+  const resolved = resolve4(path);
+  try {
+    return realpathSync(resolved);
+  } catch {
+    return resolved;
+  }
+}
 function pathsOverlapFilesystemTree(a, b) {
-  const ra = resolve3(a);
-  const rb = resolve3(b);
+  const ra = canonicalPath(a);
+  const rb = canonicalPath(b);
   if (ra === rb)
     return true;
-  if (ra.startsWith(rb + sep2))
+  if (ra.startsWith(rb + sep3))
     return true;
-  if (rb.startsWith(ra + sep2))
+  if (rb.startsWith(ra + sep3))
     return true;
   return false;
 }
 function overlapsAnyRoot(candidate, roots) {
-  const resolvedCandidate = resolve3(candidate);
+  const resolvedCandidate = canonicalPath(candidate);
   for (const root of roots) {
     if (pathsOverlapFilesystemTree(resolvedCandidate, root))
       return true;
@@ -2616,9 +3465,9 @@ function overlapsAnyRoot(candidate, roots) {
 }
 async function scanCustomPlanDirs(coveredPaths, into) {
   const dirs = getCustomPlanDirs();
-  const userPlansDir = resolve3(getUserPlansDir());
+  const userPlansDir = canonicalPath(getUserPlansDir());
   for (const dir of dirs) {
-    const resolved = resolve3(dir);
+    const resolved = canonicalPath(dir);
     if (overlapsAnyRoot(resolved, coveredPaths)) {
       console.log(`[agendex] skipping custom dir (overlaps adapter / discovered coverage): ${dir}`);
       continue;
@@ -2627,7 +3476,7 @@ async function scanCustomPlanDirs(coveredPaths, into) {
       console.log(`[agendex] skipping custom dir (overlaps user plans): ${dir}`);
       continue;
     }
-    if (!existsSync4(dir)) {
+    if (!existsSync5(dir)) {
       console.log(`[agendex] skipping custom dir (not found): ${dir}`);
       continue;
     }
@@ -2656,21 +3505,22 @@ async function scan() {
   const coveredPaths = new Set;
   for (const adapter of adapters) {
     for (const searchPath of adapter.getSearchPaths()) {
-      coveredPaths.add(resolve3(searchPath));
+      coveredPaths.add(canonicalPath(searchPath));
       const files = await walkDir(searchPath);
       for (const file of files) {
         if (!adapter.matches(file))
           continue;
         const plans = await adapter.parse(file);
         for (const plan of plans) {
-          next.set(plan.id, plan);
+          const annotated = annotatePlanValueMetadata(plan);
+          next.set(annotated.id, annotated);
         }
       }
     }
   }
   const discovered = discoverProjectPlanDirs();
   for (const { dir, agent } of discovered) {
-    const resolvedDir = resolve3(dir);
+    const resolvedDir = canonicalPath(dir);
     if (coveredPaths.has(resolvedDir))
       continue;
     const adapter = adapters.find((a) => a.agent === agent);
@@ -2682,7 +3532,8 @@ async function scan() {
         continue;
       const plans = await adapter.parse(file);
       for (const plan of plans) {
-        next.set(plan.id, plan);
+        const annotated = annotatePlanValueMetadata(plan);
+        next.set(annotated.id, annotated);
       }
     }
     coveredPaths.add(resolvedDir);
@@ -2692,34 +3543,97 @@ async function scan() {
   await scanCustomPlanDirs(coveredPaths, next);
   store = next;
   notifyPlansChanged();
-  console.log(`[agendex] indexed ${store.size} plans from ${adapters.length} adapters`);
+  const indexableCount = getIndexablePlans().length;
+  const hiddenCount = store.size - indexableCount;
+  const hiddenSuffix = hiddenCount > 0 ? ` (${hiddenCount} hidden as low-value)` : "";
+  console.log(`[agendex] indexed ${indexableCount} plans${hiddenSuffix} from ${adapters.length} adapters`);
 }
 function getAll() {
   return Array.from(store.values());
 }
+function getIndexablePlans() {
+  return getAll().filter(isIndexablePlan);
+}
+function getById(id) {
+  return store.get(id);
+}
+function getPlanSourceAdapter(plan) {
+  const sourceAdapter = plan.metadata.sourceAdapter;
+  return typeof sourceAdapter === "string" && sourceAdapter.trim() ? sourceAdapter : undefined;
+}
+function findAdapterForPlan(plan) {
+  const adapters = getActiveAdapters();
+  const sourceAdapter = getPlanSourceAdapter(plan);
+  return adapters.find((adapter) => adapter.agent === sourceAdapter) ?? adapters.find((adapter) => adapter.agent === plan.agent);
+}
+async function requestChanges(id, payload) {
+  const plan = store.get(id);
+  if (!plan)
+    return false;
+  const adapter = findAdapterForPlan(plan);
+  if (!adapter?.requestChanges)
+    return false;
+  const ok = await adapter.requestChanges(plan, payload);
+  if (ok) {
+    const plannotator = typeof plan.metadata.plannotator === "object" && plan.metadata.plannotator !== null ? { ...plan.metadata.plannotator, lastWritebackStatus: "sent", lastWritebackAt: Date.now() } : undefined;
+    if (plannotator)
+      plan.metadata = { ...plan.metadata, plannotator };
+    plan.updatedAt = new Date;
+    notifyPlansChanged();
+  }
+  return ok;
+}
+function planBelongsToAdapter(plan, adapter) {
+  if (plan.agent === adapter.agent)
+    return true;
+  return adapter.agent === "plannotator" && typeof plan.metadata.plannotator === "object" && plan.metadata.plannotator !== null;
+}
+function removePlansForPath(filePath, adapter) {
+  const normalized = resolve4(filePath);
+  const removed = [];
+  for (const [id, plan] of store.entries()) {
+    const planPath = resolve4(plan.filePath);
+    const sessionPath = typeof plan.metadata.plannotator === "object" && plan.metadata.plannotator !== null ? plan.metadata.plannotator.sessionPath : undefined;
+    if ((planPath === normalized || sessionPath === normalized) && (!adapter || planBelongsToAdapter(plan, adapter))) {
+      removed.push(plan);
+      store.delete(id);
+    }
+  }
+  if (removed.length > 0)
+    notifyPlansChanged();
+  return removed;
+}
 async function rescanFile(filePath) {
   const adapters = getActiveAdapters();
-  const normalized = resolve3(filePath);
+  const normalized = resolve4(filePath);
+  const removedPlans = [];
   for (const adapter of adapters) {
     if (!adapter.matches(filePath))
       continue;
-    const discoveredDirs = discoverProjectPlanDirs().filter((d2) => d2.agent === adapter.agent).map((d2) => resolve3(d2.dir));
+    const discoveredDirs = discoverProjectPlanDirs().filter((d2) => d2.agent === adapter.agent).map((d2) => resolve4(d2.dir));
     const allSearchPaths = [
-      ...adapter.getSearchPaths().map((sp) => resolve3(sp)),
+      ...adapter.getSearchPaths().map((sp) => resolve4(sp)),
       ...discoveredDirs
     ];
-    const isInSearchPath = allSearchPaths.some((sp) => normalized.startsWith(sp + sep2) || normalized === sp);
+    const isInSearchPath = allSearchPaths.some((sp) => normalized.startsWith(sp + sep3) || normalized === sp);
     if (!isInSearchPath)
       continue;
-    const plans = await adapter.parse(filePath);
+    const rawPlans = await adapter.parse(filePath);
+    if (rawPlans.length === 0) {
+      removedPlans.push(...removePlansForPath(filePath, adapter));
+      continue;
+    }
+    const plans = rawPlans.map(annotatePlanValueMetadata);
     for (const plan of plans) {
       store.set(plan.id, plan);
     }
     notifyPlansChanged();
     return plans;
   }
-  const userPlansDir = resolve3(getUserPlansDir());
-  if (normalized.endsWith(".md") && (normalized.startsWith(userPlansDir + sep2) || normalized === userPlansDir)) {
+  if (removedPlans.length > 0)
+    return removedPlans;
+  const userPlansDir = resolve4(getUserPlansDir());
+  if (normalized.endsWith(".md") && (normalized.startsWith(userPlansDir + sep3) || normalized === userPlansDir)) {
     const plan = await parseGenericMarkdownPlan(filePath, { userCreated: true });
     if (plan) {
       store.set(plan.id, plan);
@@ -2730,8 +3644,8 @@ async function rescanFile(filePath) {
   if (normalized.endsWith(".md")) {
     const customDirs = getCustomPlanDirs();
     for (const dir of customDirs) {
-      const resolvedDir = resolve3(dir);
-      if (normalized.startsWith(resolvedDir + sep2) || normalized === resolvedDir) {
+      const resolvedDir = resolve4(dir);
+      if (normalized.startsWith(resolvedDir + sep3) || normalized === resolvedDir) {
         const plan = await parseGenericMarkdownPlan(filePath, {
           source: "custom-dir",
           customDir: dir
@@ -2747,8 +3661,8 @@ async function rescanFile(filePath) {
   return [];
 }
 // ../shared/src/services/watcher.ts
-import { existsSync as existsSync5, watch } from "node:fs";
-import { join as join9, resolve as resolve4 } from "node:path";
+import { existsSync as existsSync6, watch } from "node:fs";
+import { join as join10, resolve as resolve5 } from "node:path";
 var debounceTimer = null;
 var pendingFiles = new Set;
 var activeWatchers = [];
@@ -2766,13 +3680,13 @@ function closeAllWatchers() {
   activeWatchers.length = 0;
 }
 function watchDir(dir, matchFn, onChange) {
-  if (!existsSync5(dir))
+  if (!existsSync6(dir))
     return;
   try {
     const watcher = watch(dir, { recursive: true }, async (_event, filename) => {
       if (!filename)
         return;
-      const fullPath = join9(dir, filename);
+      const fullPath = join10(dir, filename);
       if (!matchFn(fullPath))
         return;
       pendingFiles.add(fullPath);
@@ -2805,23 +3719,23 @@ function setupWatchers(onChange) {
   const watchedPaths = new Set;
   for (const adapter of adapters) {
     for (const watchPath of adapter.getWatchPaths()) {
-      watchedPaths.add(resolve4(watchPath));
+      watchedPaths.add(resolve5(watchPath));
       watchDir(watchPath, (f) => adapter.matches(f), onChange);
     }
   }
   const discovered = discoverProjectPlanDirs();
   for (const { dir, agent } of discovered) {
-    if (watchedPaths.has(resolve4(dir)))
+    if (watchedPaths.has(resolve5(dir)))
       continue;
     const adapter = adapters.find((a) => a.agent === agent);
     if (!adapter)
       continue;
-    watchedPaths.add(resolve4(dir));
+    watchedPaths.add(resolve5(dir));
     watchDir(dir, (f) => adapter.matches(f), onChange);
   }
   const customDirs = getCustomPlanDirs();
   for (const dir of customDirs) {
-    const resolvedCustom = resolve4(dir);
+    const resolvedCustom = resolve5(dir);
     let overlaps = false;
     for (const watched of watchedPaths) {
       if (pathsOverlapFilesystemTree(resolvedCustom, watched)) {
@@ -2841,15 +3755,15 @@ import { request as httpsRequest } from "node:https";
 import { hostname as osHostname } from "node:os";
 
 // src/pid.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync2, readFileSync as readFileSync4, unlinkSync, writeFileSync as writeFileSync2 } from "node:fs";
+import { existsSync as existsSync7, mkdirSync as mkdirSync2, readFileSync as readFileSync4, unlinkSync, writeFileSync as writeFileSync2 } from "node:fs";
 import { hostname } from "node:os";
-import { dirname, join as join10 } from "node:path";
+import { dirname as dirname3, join as join11 } from "node:path";
 function getPidPath() {
-  return join10(getConfigDir(), "daemon.pid");
+  return join11(getConfigDir(), "daemon.pid");
 }
 function writePid() {
   const path = getPidPath();
-  mkdirSync2(dirname(path), { recursive: true });
+  mkdirSync2(dirname3(path), { recursive: true });
   const info = {
     pid: process.pid,
     startedAtMs: Date.now(),
@@ -2859,7 +3773,7 @@ function writePid() {
 }
 function readPidInfo() {
   const path = getPidPath();
-  if (!existsSync6(path))
+  if (!existsSync7(path))
     return null;
   const raw = readFileSync4(path, "utf-8").trim();
   const asNumber = Number(raw);
@@ -2909,6 +3823,22 @@ function getCloudConfig() {
     convexUrl: config.convexUrl
   };
 }
+function parseSyncSuccess(body) {
+  try {
+    const parsed = JSON.parse(body);
+    if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+      return { ok: true };
+    }
+    const result = parsed;
+    return {
+      ok: true,
+      skippedLowValue: result.skippedLowValue === true,
+      deleted: result.deleted === true
+    };
+  } catch {
+    return { ok: true };
+  }
+}
 async function syncPlan(plan) {
   const { token, convexUrl } = getCloudConfig();
   const url = `${convexUrl}/api/cli/sync`;
@@ -2940,7 +3870,7 @@ async function syncPlan(plan) {
   if (res.status < 200 || res.status >= 300) {
     return { ok: false, error: `${res.status}: ${res.body}` };
   }
-  return { ok: true };
+  return parseSyncSuccess(res.body);
 }
 async function refreshStoredToken(currentToken, convexUrl) {
   const refreshed = await refreshToken(currentToken, convexUrl);
@@ -2995,7 +3925,7 @@ async function sendHeartbeat() {
 }
 async function sendShutdown() {
   try {
-    const { token, convexUrl } = getCloudConfig();
+    getCloudConfig();
     cachedDeviceId ??= loadOrCreateDeviceId();
     await deleteDaemons([cachedDeviceId]);
   } catch {}
@@ -3023,7 +3953,7 @@ function requestText(urlString, options) {
   if (options.body) {
     headers["Content-Length"] = String(Buffer.byteLength(options.body));
   }
-  return new Promise((resolve5, reject) => {
+  return new Promise((resolve6, reject) => {
     const req = request(url, {
       agent: false,
       headers,
@@ -3035,7 +3965,7 @@ function requestText(urlString, options) {
         body += chunk;
       });
       res.on("end", () => {
-        resolve5({
+        resolve6({
           status: res.statusCode ?? 0,
           body
         });
@@ -3049,6 +3979,62 @@ function requestText(urlString, options) {
     req.end();
   });
 }
+function authHeaders(token, contentType = false) {
+  return {
+    Authorization: `Bearer ${token}`,
+    Connection: "close",
+    ...contentType && { "Content-Type": "application/json" }
+  };
+}
+async function fetchPlannotatorWritebacks(limit = 10) {
+  const { token, convexUrl } = getCloudConfig();
+  cachedDeviceId ??= loadOrCreateDeviceId();
+  const url = `${convexUrl}/api/cli/plannotator/writebacks?deviceId=${encodeURIComponent(cachedDeviceId)}&limit=${limit}`;
+  let activeToken = token;
+  let res = await requestText(url, {
+    method: "GET",
+    headers: authHeaders(activeToken)
+  });
+  if (res.status === 401) {
+    const refreshed = await refreshStoredToken(activeToken, convexUrl);
+    if (refreshed) {
+      activeToken = refreshed;
+      res = await requestText(url, {
+        method: "GET",
+        headers: authHeaders(activeToken)
+      });
+    }
+  }
+  if (res.status === 401)
+    throw new AuthExpiredError;
+  if (res.status < 200 || res.status >= 300)
+    return [];
+  const body = JSON.parse(res.body);
+  return body.writebacks ?? [];
+}
+async function reportPlannotatorWriteback(writebackId, status, error) {
+  const { token, convexUrl } = getCloudConfig();
+  const url = `${convexUrl}/api/cli/plannotator/writebacks/report`;
+  let activeToken = token;
+  const body = JSON.stringify({ writebackId, status, error });
+  let res = await requestText(url, {
+    method: "POST",
+    headers: authHeaders(activeToken, true),
+    body
+  });
+  if (res.status === 401) {
+    const refreshed = await refreshStoredToken(activeToken, convexUrl);
+    if (refreshed) {
+      activeToken = refreshed;
+      res = await requestText(url, {
+        method: "POST",
+        headers: authHeaders(activeToken, true),
+        body
+      });
+    }
+  }
+  return res.status >= 200 && res.status < 300;
+}
 async function fetchDevices() {
   const { token, convexUrl } = getCloudConfig();
   const url = `${convexUrl}/api/cli/devices`;
@@ -3149,6 +4135,7 @@ async function login(siteUrlOverride) {
     token: existing?.token,
     cloudToken: callback.token,
     convexUrl: callback.convexUrl,
+    deviceId: existing?.deviceId,
     enabledAdapters: existing?.enabledAdapters ?? [],
     customPlanDirs: existing?.customPlanDirs ?? []
   };
@@ -3167,6 +4154,7 @@ function logout() {
     token: existing.token,
     cloudToken: undefined,
     convexUrl: undefined,
+    deviceId: existing.deviceId,
     enabledAdapters: existing.enabledAdapters,
     customPlanDirs: existing.customPlanDirs
   };
@@ -3179,14 +4167,14 @@ async function startCallbackServer() {
   let timeout;
   let settle;
   let fail;
-  const result = new Promise((resolve5, reject) => {
-    settle = resolve5;
+  const result = new Promise((resolve6, reject) => {
+    settle = resolve6;
     fail = reject;
   });
   const finish = (value) => {
     if (!settle || !fail)
       return;
-    const resolve5 = settle;
+    const resolve6 = settle;
     const reject = fail;
     settle = undefined;
     fail = undefined;
@@ -3203,7 +4191,7 @@ async function startCallbackServer() {
       reject(value);
       return;
     }
-    resolve5(value);
+    resolve6(value);
   };
   server.on("request", (req, res) => {
     const requestUrl = new URL(req.url ?? "/", "http://127.0.0.1");
@@ -3237,8 +4225,8 @@ async function startCallbackServer() {
       sockets.delete(socket);
     });
   });
-  await new Promise((resolve5, reject) => {
-    server.listen(0, "127.0.0.1", () => resolve5());
+  await new Promise((resolve6, reject) => {
+    server.listen(0, "127.0.0.1", () => resolve6());
     server.once("error", reject);
   });
   server.once("error", (error) => {
@@ -3318,19 +4306,77 @@ function spawnBrowser(command, args, options = {}) {
 
 // src/daemon.ts
 import { spawn as spawn2 } from "node:child_process";
-import { resolve as resolve5 } from "node:path";
+import { resolve as resolve6 } from "node:path";
 import { fileURLToPath } from "node:url";
 
+// src/adapters.ts
+var PLANNOTATOR_ADAPTER_ID = "plannotator";
+function envFlag(name) {
+  const value = process.env[name]?.trim().toLowerCase();
+  if (!value)
+    return;
+  if (value === "1" || value === "true" || value === "yes" || value === "on")
+    return true;
+  if (value === "0" || value === "false" || value === "no" || value === "off")
+    return false;
+  return;
+}
+function shouldEnablePlannotatorSync(config) {
+  const explicit = envFlag("AGENDEX_PLANNOTATOR_SYNC");
+  if (explicit !== undefined)
+    return explicit;
+  return Boolean(config.cloudToken && config.convexUrl);
+}
+function resolveCliAdapterIds(config) {
+  const ids = config.enabledAdapters.length > 0 ? [...config.enabledAdapters] : getDefaultAdapterIds();
+  if (shouldEnablePlannotatorSync(config) && !ids.includes(PLANNOTATOR_ADAPTER_ID)) {
+    ids.push(PLANNOTATOR_ADAPTER_ID);
+  }
+  return ids;
+}
+
+// src/payload.ts
+var SYNC_METADATA_KEY = "agendexSync";
+function isRecord4(value) {
+  return typeof value === "object" && value !== null;
+}
+function withSyncDeviceMetadata(metadata, deviceId) {
+  if (!deviceId)
+    return metadata;
+  const existing = isRecord4(metadata[SYNC_METADATA_KEY]) ? metadata[SYNC_METADATA_KEY] : {};
+  return {
+    ...metadata,
+    [SYNC_METADATA_KEY]: {
+      ...existing,
+      deviceId
+    }
+  };
+}
+function planToSyncPayload(plan, deviceId) {
+  return {
+    localPlanId: plan.id,
+    agent: plan.agent,
+    title: plan.title,
+    content: plan.content,
+    format: plan.format,
+    filePath: plan.filePath,
+    workspace: plan.workspace,
+    metadata: withSyncDeviceMetadata(plan.metadata, deviceId),
+    createdAt: plan.createdAt.getTime(),
+    updatedAt: plan.updatedAt.getTime()
+  };
+}
+
 // src/sync-cache.ts
 import { createHash as createHash2 } from "node:crypto";
-import { existsSync as existsSync7, mkdirSync as mkdirSync3, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
-import { join as join11 } from "node:path";
+import { existsSync as existsSync8, mkdirSync as mkdirSync3, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
+import { join as join12 } from "node:path";
 function getCachePath() {
-  return join11(getConfigDir(), "sync-cache.json");
+  return join12(getConfigDir(), "sync-cache.json");
 }
 function loadSyncCache() {
   const cachePath = getCachePath();
-  if (!existsSync7(cachePath))
+  if (!existsSync8(cachePath))
     return {};
   try {
     const raw = JSON.parse(readFileSync5(cachePath, "utf-8"));
@@ -3343,7 +4389,7 @@ function loadSyncCache() {
 }
 function saveSyncCache(cache, options) {
   const dir = getConfigDir();
-  if (!existsSync7(dir))
+  if (!existsSync8(dir))
     mkdirSync3(dir, { recursive: true });
   const cachePath = getCachePath();
   if (options?.replace) {
@@ -3369,32 +4415,71 @@ function computePayloadHash(payload) {
   return createHash2("sha256").update(canonical).digest("hex").slice(0, 20);
 }
 
+// src/writeback-delivery-cache.ts
+import { existsSync as existsSync9, mkdirSync as mkdirSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "node:fs";
+import { join as join13 } from "node:path";
+var MAX_PENDING_WRITEBACK_REPORTS = 1000;
+function getCachePath2() {
+  return join13(getConfigDir(), "plannotator-writebacks-delivered.json");
+}
+function isPendingWritebackReportStatus(value) {
+  return value === "sent" || value === "failed" || value === "expired";
+}
+function normalizeReports(input) {
+  if (!Array.isArray(input))
+    return [];
+  const reports = new Map;
+  for (const item of input) {
+    if (typeof item === "string" && item.length > 0) {
+      reports.set(item, "sent");
+      continue;
+    }
+    if (item && typeof item === "object" && "id" in item && "status" in item && typeof item.id === "string" && item.id.length > 0 && isPendingWritebackReportStatus(item.status)) {
+      reports.set(item.id, item.status);
+    }
+  }
+  return [...reports.entries()].slice(-MAX_PENDING_WRITEBACK_REPORTS);
+}
+function loadPendingWritebackReports() {
+  const cachePath = getCachePath2();
+  if (!existsSync9(cachePath))
+    return new Map;
+  try {
+    return new Map(normalizeReports(JSON.parse(readFileSync6(cachePath, "utf-8"))));
+  } catch {
+    return new Map;
+  }
+}
+function savePendingWritebackReports(reports) {
+  try {
+    const dir = getConfigDir();
+    if (!existsSync9(dir))
+      mkdirSync4(dir, { recursive: true });
+    const normalizedReports = normalizeReports([...reports].map(([id, status]) => ({ id, status })));
+    writeFileSync4(getCachePath2(), JSON.stringify(normalizedReports.map(([id, status]) => ({ id, status }))));
+    return true;
+  } catch {
+    return false;
+  }
+}
+
 // src/daemon.ts
 var MAX_RESTARTS = 5;
 var RESTART_WINDOW_MS = 60000;
 var RESTART_DELAY_MS = 5000;
-function planToPayload(plan) {
-  return {
-    localPlanId: plan.id,
-    agent: plan.agent,
-    title: plan.title,
-    content: plan.content,
-    format: plan.format,
-    filePath: plan.filePath,
-    workspace: plan.workspace,
-    metadata: plan.metadata,
-    createdAt: plan.createdAt.getTime(),
-    updatedAt: plan.updatedAt.getTime()
-  };
-}
+var PLANNOTATOR_WRITEBACK_POLL_INTERVAL_MS = 15000;
+var PLANNOTATOR_WRITEBACK_EXPIRED_ERROR = "Write-back expired before delivery.";
+var PLANNOTATOR_WRITEBACK_FAILED_ERROR = "No live Plannotator session accepted the request-changes payload.";
 async function runWorker() {
   const config = await loadOrInitConfig();
-  const adapters = resolveAdapters(config.enabledAdapters);
+  const adapterIds = resolveCliAdapterIds(config);
+  const adapters = resolveAdapters(adapterIds);
   setActiveAdapters(adapters);
-  console.log(`[agendex] daemon starting with ${config.enabledAdapters.length} adapters`);
+  console.log(`[agendex] daemon starting with ${adapterIds.length} adapters`);
   await sendHeartbeat();
   const syncCache = loadSyncCache();
   const syncQueue = [];
+  const pendingWritebackReports = loadPendingWritebackReports();
   let syncing = false;
   async function tryRefreshToken() {
     const cfg = loadConfig();
@@ -3413,6 +4498,8 @@ async function runWorker() {
     syncing = true;
     const batch = syncQueue.splice(0);
     let syncedCount = 0;
+    let lowValueSkippedCount = 0;
+    let lowValueDeletedCount = 0;
     let failedCount = 0;
     try {
       for (const payload of batch) {
@@ -3433,35 +4520,134 @@ async function runWorker() {
           failedCount++;
           console.error(`[agendex] sync failed for "${payload.title}": ${result.error}`);
         } else {
-          syncedCount++;
+          if (result.skippedLowValue) {
+            lowValueSkippedCount++;
+            if (result.deleted)
+              lowValueDeletedCount++;
+          } else {
+            syncedCount++;
+          }
           syncCache[payload.localPlanId] = computePayloadHash(payload);
         }
       }
     } catch (err) {
       console.error("[agendex] sync error:", err);
-      syncQueue.unshift(...batch.slice(syncedCount + failedCount));
+      syncQueue.unshift(...batch.slice(syncedCount + lowValueSkippedCount + failedCount));
     } finally {
       syncing = false;
     }
-    if (syncedCount > 0 || failedCount > 0) {
+    if (syncedCount > 0 || lowValueSkippedCount > 0 || failedCount > 0) {
       saveSyncCache(syncCache);
-      console.log(`[agendex] sync complete: ${syncedCount} synced, ${failedCount} failed`);
+      const lowValueSuffix2 = lowValueSkippedCount > 0 ? `, ${lowValueSkippedCount} low-value skipped/pruned${lowValueDeletedCount > 0 ? ` (${lowValueDeletedCount} deleted)` : ""}` : "";
+      console.log(`[agendex] sync complete: ${syncedCount} synced${lowValueSuffix2}, ${failedCount} failed`);
     }
     if (syncQueue.length > 0)
       processSyncQueue();
   }
+  function persistPendingWritebackReports() {
+    if (!savePendingWritebackReports(pendingWritebackReports)) {
+      console.error("[agendex] failed to persist Plannotator write-back delivery cache");
+    }
+  }
+  async function reportPendingWriteback(writebackId) {
+    const status = pendingWritebackReports.get(writebackId);
+    if (!status)
+      return;
+    const reported = await reportPlannotatorWriteback(writebackId, status, status === "expired" ? PLANNOTATOR_WRITEBACK_EXPIRED_ERROR : status === "failed" ? PLANNOTATOR_WRITEBACK_FAILED_ERROR : undefined);
+    if (reported) {
+      pendingWritebackReports.delete(writebackId);
+      persistPendingWritebackReports();
+    } else {
+      console.error("[agendex] failed to report write-back status for", writebackId, "- will retry");
+    }
+  }
+  async function handlePlannotatorWriteback(job) {
+    if (pendingWritebackReports.has(job._id)) {
+      await reportPendingWriteback(job._id);
+      return;
+    }
+    if (job.expiresAt <= Date.now()) {
+      pendingWritebackReports.set(job._id, "expired");
+      persistPendingWritebackReports();
+      await reportPendingWriteback(job._id);
+      return;
+    }
+    let localPlan = getById(job.localPlanId);
+    if (!localPlan) {
+      await scan();
+      localPlan = getById(job.localPlanId);
+    }
+    if (!localPlan) {
+      if (job.deviceId) {
+        pendingWritebackReports.set(job._id, "failed");
+        persistPendingWritebackReports();
+        await reportPendingWriteback(job._id);
+      }
+      return;
+    }
+    const ok = await requestChanges(job.localPlanId, {
+      feedback: job.feedback,
+      revisedContent: job.revisedContent,
+      annotations: job.annotations,
+      source: job.source,
+      writebackId: job._id,
+      requestedAt: Date.now()
+    });
+    if (ok) {
+      const updatedPlan = getById(job.localPlanId);
+      if (updatedPlan)
+        syncQueue.push(planToSyncPayload(updatedPlan, config.deviceId));
+      pendingWritebackReports.set(job._id, "sent");
+      persistPendingWritebackReports();
+      await reportPendingWriteback(job._id);
+      processSyncQueue();
+      return;
+    }
+    pendingWritebackReports.set(job._id, "failed");
+    persistPendingWritebackReports();
+    await reportPendingWriteback(job._id);
+  }
+  let pollingWritebacks = false;
+  async function pollPlannotatorWritebacks() {
+    if (pollingWritebacks)
+      return;
+    pollingWritebacks = true;
+    try {
+      const jobs = await fetchPlannotatorWritebacks();
+      for (const job of jobs) {
+        await handlePlannotatorWriteback(job);
+      }
+    } catch (err) {
+      if (err instanceof Error && err.name === "AuthExpiredError") {
+        console.error("[agendex] session expired. Run `agendex login` to re-authenticate.");
+      } else {
+        console.error("[agendex] Plannotator write-back polling failed:", err);
+      }
+    } finally {
+      pollingWritebacks = false;
+    }
+  }
   setOnPlansChanged(() => {});
   console.log(`[agendex] initial scan...`);
   await scan();
   const plans = getAll();
+  const syncablePlanCount = plans.filter(isIndexablePlan).length;
+  const lowValuePlanCount = plans.length - syncablePlanCount;
   let initialSkipped = 0;
+  let initialQueuedSyncable = 0;
+  let initialQueuedLowValue = 0;
   for (const plan of plans) {
-    const payload = planToPayload(plan);
+    const payload = planToSyncPayload(plan, config.deviceId);
     const hash = computePayloadHash(payload);
     if (syncCache[plan.id] === hash) {
       initialSkipped++;
       continue;
     }
+    if (isLowValuePlan(plan)) {
+      initialQueuedLowValue++;
+    } else {
+      initialQueuedSyncable++;
+    }
     syncQueue.push(payload);
   }
   const activePlanIds = new Set(plans.map((plan) => plan.id));
@@ -3470,12 +4656,17 @@ async function runWorker() {
       delete syncCache[id];
   }
   saveSyncCache(syncCache, { replace: true });
-  console.log(`[agendex] syncing ${syncQueue.length} plans (${initialSkipped} unchanged)...`);
+  const lowValueSuffix = lowValuePlanCount > 0 ? `, ${lowValuePlanCount} low-value hidden/pruned` : "";
+  console.log(`[agendex] syncing ${initialQueuedSyncable} plans${lowValueSuffix} (${initialQueuedLowValue} low-value queued, ${initialSkipped} unchanged)...`);
   await processSyncQueue();
   setInterval(() => void sendHeartbeat(), CLI_DAEMON_HEARTBEAT_INTERVAL_MS);
+  if (shouldEnablePlannotatorSync(config)) {
+    setInterval(() => void pollPlannotatorWritebacks(), PLANNOTATOR_WRITEBACK_POLL_INTERVAL_MS);
+    pollPlannotatorWritebacks();
+  }
   startWatching((changedPlans) => {
     for (const plan of changedPlans) {
-      syncQueue.push(planToPayload(plan));
+      syncQueue.push(planToSyncPayload(plan, config.deviceId));
     }
     processSyncQueue();
   });
@@ -3505,17 +4696,17 @@ async function startSupervisor() {
   };
   process.on("SIGTERM", shutdown);
   process.on("SIGINT", shutdown);
-  const scriptPath = resolve5(process.argv[1] ?? fileURLToPath(new URL("./cli.ts", import.meta.url)));
+  const scriptPath = resolve6(process.argv[1] ?? fileURLToPath(new URL("./cli.ts", import.meta.url)));
   const restartTimes = [];
   while (!stopping) {
     workerProc = spawn2(process.execPath, [scriptPath, "start", "--worker"], {
       stdio: ["ignore", "inherit", "inherit"]
     });
-    const exitCode = await new Promise((resolve6) => {
-      workerProc?.once("exit", (code) => resolve6(code));
+    const exitCode = await new Promise((resolve7) => {
+      workerProc?.once("exit", (code) => resolve7(code));
       workerProc?.once("error", (error) => {
         console.error("[agendex] failed to spawn worker:", error);
-        resolve6(1);
+        resolve7(1);
       });
     });
     workerProc = null;
@@ -3540,31 +4731,26 @@ async function startSupervisor() {
 // src/sync.ts
 async function syncAll(force = false) {
   const config = await loadOrInitConfig();
-  const adapters = resolveAdapters(config.enabledAdapters);
+  const adapterIds = resolveCliAdapterIds(config);
+  const adapters = resolveAdapters(adapterIds);
   setActiveAdapters(adapters);
   console.log(`[agendex] Scanning local plans...`);
   await scan();
-  const plans = getAll();
-  console.log(`[agendex] Found ${plans.length} plans. Syncing to cloud...`);
+  const allPlans = getAll();
+  const syncablePlans = allPlans.filter(isIndexablePlan);
+  const lowValuePlans = allPlans.filter(isLowValuePlan);
+  const hiddenSuffix = lowValuePlans.length > 0 ? ` (${lowValuePlans.length} low-value hidden/pruned)` : "";
+  console.log(`[agendex] Found ${syncablePlans.length} syncable plans${hiddenSuffix}. Syncing to cloud...`);
   const cache = force ? {} : loadSyncCache();
   const activePlanIds = new Set;
   let synced = 0;
+  let lowValueSkipped = 0;
+  let lowValueDeleted = 0;
   let skipped = 0;
   let failed = 0;
-  for (const plan of plans) {
+  for (const plan of [...syncablePlans, ...lowValuePlans]) {
     activePlanIds.add(plan.id);
-    const payload = {
-      localPlanId: plan.id,
-      agent: plan.agent,
-      title: plan.title,
-      content: plan.content,
-      format: plan.format,
-      filePath: plan.filePath,
-      workspace: plan.workspace,
-      metadata: plan.metadata,
-      createdAt: plan.createdAt.getTime(),
-      updatedAt: plan.updatedAt.getTime()
-    };
+    const payload = planToSyncPayload(plan, config.deviceId);
     const hash = computePayloadHash(payload);
     if (!force && cache[plan.id] === hash) {
       skipped++;
@@ -3572,7 +4758,13 @@ async function syncAll(force = false) {
     }
     const result = await syncPlan(payload);
     if (result.ok) {
-      synced++;
+      if (result.skippedLowValue) {
+        lowValueSkipped++;
+        if (result.deleted)
+          lowValueDeleted++;
+      } else {
+        synced++;
+      }
       cache[plan.id] = hash;
     } else {
       failed++;
@@ -3584,17 +4776,18 @@ async function syncAll(force = false) {
       delete cache[id];
   }
   saveSyncCache(cache, { replace: true });
-  console.log(`[agendex] Sync complete: ${synced} synced, ${skipped} unchanged, ${failed} failed`);
+  const lowValueSuffix = lowValueSkipped > 0 ? `, ${lowValueSkipped} low-value skipped/pruned${lowValueDeleted > 0 ? ` (${lowValueDeleted} deleted)` : ""}` : "";
+  console.log(`[agendex] Sync complete: ${synced} synced${lowValueSuffix}, ${skipped} unchanged, ${failed} failed`);
 }
 
 // src/version.ts
-import { existsSync as existsSync8, readFileSync as readFileSync6, writeFileSync as writeFileSync4 } from "node:fs";
+import { existsSync as existsSync10, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "node:fs";
 import { tmpdir } from "node:os";
-import { join as join12 } from "node:path";
+import { join as join14 } from "node:path";
 // package.json
 var package_default = {
   name: "agendex-cli",
-  version: "0.13.0",
+  version: "0.15.0",
   description: "Agendex CLI for login, sync, and daemon workflows",
   homepage: "https://github.com/Tyru5/Agendex#readme",
   repository: {
@@ -3638,14 +4831,14 @@ var package_default = {
 
 // src/version.ts
 var CLI_VERSION = package_default.version;
-var CACHE_FILE = process.env.AGENDEX_UPDATE_CACHE_FILE ?? join12(tmpdir(), ".agendex-update-cache.json");
+var CACHE_FILE = process.env.AGENDEX_UPDATE_CACHE_FILE ?? join14(tmpdir(), ".agendex-update-cache.json");
 var CACHE_TTL_MS = 24 * 60 * 60 * 1000;
 var UPDATE_URL = process.env.AGENDEX_UPDATE_URL ?? "https://registry.npmjs.org/agendex-cli/latest";
 function readCache(current) {
   try {
-    if (!existsSync8(CACHE_FILE))
+    if (!existsSync10(CACHE_FILE))
       return null;
-    const { result, ts } = JSON.parse(readFileSync6(CACHE_FILE, "utf8"));
+    const { result, ts } = JSON.parse(readFileSync7(CACHE_FILE, "utf8"));
     if (Date.now() - ts > CACHE_TTL_MS)
       return null;
     return normalizeResult(result, current);
@@ -3655,7 +4848,7 @@ function readCache(current) {
 }
 function writeCache(result) {
   try {
-    writeFileSync4(CACHE_FILE, JSON.stringify({ result, ts: Date.now() }));
+    writeFileSync5(CACHE_FILE, JSON.stringify({ result, ts: Date.now() }));
   } catch {}
 }
 async function checkForUpdate() {
@@ -3741,7 +4934,7 @@ function firstCommandToken(argv) {
   return;
 }
 var command = firstCommandToken(args) ?? "start";
-var cliEntry = resolve6(process.argv[1] ?? fileURLToPath2(import.meta.url));
+var cliEntry = resolve7(process.argv[1] ?? fileURLToPath2(import.meta.url));
 async function main() {
   const isInternal = args.includes("--daemon") || args.includes("--worker");
   if (command === "--version" || command === "-v") {
@@ -3941,7 +5134,7 @@ async function main() {
         return 1;
       }
       const resolved = resolveCustomPlanDirPath(dirPath);
-      if (!existsSync9(resolved)) {
+      if (!existsSync11(resolved)) {
         writeStderr(`[agendex] path does not exist: ${resolved}`);
         return 1;
       }
@@ -3960,7 +5153,7 @@ async function main() {
         const { request } = await import("node:http");
         const body = JSON.stringify({ path: resolved });
         try {
-          const res = await new Promise((resolve7, reject) => {
+          const res = await new Promise((resolve8, reject) => {
             const req = request(`http://localhost:${port}/api/v1/plan-sources`, {
               method: "POST",
               headers: {
@@ -3974,7 +5167,7 @@ async function main() {
               res2.on("data", (chunk) => {
                 data += chunk;
               });
-              res2.on("end", () => resolve7({ status: res2.statusCode ?? 0, body: data }));
+              res2.on("end", () => resolve8({ status: res2.statusCode ?? 0, body: data }));
               res2.on("error", reject);
             });
             req.on("error", reject);
@@ -4156,13 +5349,13 @@ function flushStream(stream) {
   if (stream.destroyed || !stream.writable) {
     return Promise.resolve();
   }
-  return new Promise((resolve7, reject) => {
+  return new Promise((resolve8, reject) => {
     stream.write("", (error) => {
       if (error) {
         reject(error);
         return;
       }
-      resolve7();
+      resolve8();
     });
   });
 }