Merge pull request #35 from backnotprop/feature/plan-saving

Add plan saving to ~/.plannotator/plans/

Author: backnotprop

apps/opencode-plugin/index.ts

@@ -101,6 +101,7 @@ Do NOT proceed with implementation until your plan is approved.
               return `Plan approved with notes!
 
 Plan Summary: ${args.summary}
+${result.savedPath ? `Saved to: ${result.savedPath}` : ""}
 
 ## Implementation Notes
 
@@ -113,9 +114,11 @@ Proceed with implementation, incorporating these notes where applicable.`;
 
             return `Plan approved!
 
-Plan Summary: ${args.summary}`;
+Plan Summary: ${args.summary}
+${result.savedPath ? `Saved to: ${result.savedPath}` : ""}`;
           } else {
             return `Plan needs revision.
+${result.savedPath ? `\nSaved to: ${result.savedPath}` : ""}
 
 The user has requested changes to your plan. Please review their feedback below and revise your plan accordingly.
 

packages/server/index.ts

@@ -19,11 +19,18 @@ import {
   type ObsidianConfig,
   type BearConfig,
 } from "./integrations";
+import {
+  generateSlug,
+  savePlan,
+  saveAnnotations,
+  saveFinalSnapshot,
+} from "./storage";
 
 // Re-export utilities
 export { isRemoteSession, getServerPort } from "./remote";
 export { openBrowser } from "./browser";
 export * from "./integrations";
+export * from "./storage";
 
 // --- Types ---
 
@@ -46,7 +53,11 @@ export interface ServerResult {
   /** Whether running in remote mode */
   isRemote: boolean;
   /** Wait for user decision (approve/deny) */
-  waitForDecision: () => Promise<{ approved: boolean; feedback?: string }>;
+  waitForDecision: () => Promise<{
+    approved: boolean;
+    feedback?: string;
+    savedPath?: string;
+  }>;
   /** Stop the server */
   stop: () => void;
 }
@@ -73,13 +84,23 @@ export async function startPlannotatorServer(
   const isRemote = isRemoteSession();
   const configuredPort = getServerPort();
 
+  // Generate slug and save plan immediately
+  const slug = generateSlug(plan);
+  const planPath = savePlan(slug, plan);
+
   // Decision promise
-  let resolveDecision: (result: { approved: boolean; feedback?: string }) => void;
-  const decisionPromise = new Promise<{ approved: boolean; feedback?: string }>(
-    (resolve) => {
-      resolveDecision = resolve;
-    }
-  );
+  let resolveDecision: (result: {
+    approved: boolean;
+    feedback?: string;
+    savedPath?: string;
+  }) => void;
+  const decisionPromise = new Promise<{
+    approved: boolean;
+    feedback?: string;
+    savedPath?: string;
+  }>((resolve) => {
+    resolveDecision = resolve;
+  });
 
   // Start server with retry logic
   let server: ReturnType<typeof Bun.serve> | null = null;
@@ -183,25 +204,33 @@ export async function startPlannotatorServer(
               console.error(`[Integration] Error:`, err);
             }
 
-            resolveDecision({ approved: true, feedback });
-            return Response.json({ ok: true });
+            // Save annotations and final snapshot
+            const diff = feedback || "";
+            if (diff) {
+              saveAnnotations(slug, diff);
+            }
+            const savedPath = saveFinalSnapshot(slug, "approved", plan, diff);
+
+            resolveDecision({ approved: true, feedback, savedPath });
+            return Response.json({ ok: true, savedPath });
           }
 
           // API: Deny with feedback
           if (url.pathname === "/api/deny" && req.method === "POST") {
+            let feedback = "Plan rejected by user";
             try {
               const body = (await req.json()) as { feedback?: string };
-              resolveDecision({
-                approved: false,
-                feedback: body.feedback || "Plan rejected by user",
-              });
+              feedback = body.feedback || feedback;
             } catch {
-              resolveDecision({
-                approved: false,
-                feedback: "Plan rejected by user",
-              });
+              // Use default feedback
             }
-            return Response.json({ ok: true });
+
+            // Save annotations and final snapshot
+            saveAnnotations(slug, feedback);
+            const savedPath = saveFinalSnapshot(slug, "denied", plan, feedback);
+
+            resolveDecision({ approved: false, feedback, savedPath });
+            return Response.json({ ok: true, savedPath });
           }
 
           // Serve embedded HTML for all other routes (SPA)

packages/server/storage.ts

@@ -0,0 +1,90 @@
+/**
+ * Plan Storage Utility
+ *
+ * Saves plans and annotations to ~/.plannotator/plans/
+ * Cross-platform: works on Windows, macOS, and Linux.
+ */
+
+import { homedir } from "os";
+import { join } from "path";
+import { mkdirSync, writeFileSync } from "fs";
+import { sanitizeTag } from "./project";
+
+/**
+ * Get the plan storage directory, creating it if needed.
+ * Cross-platform: uses os.homedir() for Windows/macOS/Linux compatibility.
+ */
+export function getPlanDir(): string {
+  const home = homedir();
+  const planDir = join(home, ".plannotator", "plans");
+  mkdirSync(planDir, { recursive: true });
+  return planDir;
+}
+
+/**
+ * Extract the first heading from markdown content.
+ */
+function extractFirstHeading(markdown: string): string | null {
+  const match = markdown.match(/^#\s+(.+)$/m);
+  if (!match) return null;
+  return match[1].trim();
+}
+
+/**
+ * Generate a slug from plan content.
+ * Format: YYYY-MM-DD-{sanitized-heading}
+ */
+export function generateSlug(plan: string): string {
+  const date = new Date().toISOString().split("T")[0]; // YYYY-MM-DD
+
+  const heading = extractFirstHeading(plan);
+  const slug = heading ? sanitizeTag(heading) : null;
+
+  return slug ? `${date}-${slug}` : `${date}-plan`;
+}
+
+/**
+ * Save the plan markdown to disk.
+ * Returns the full path to the saved file.
+ */
+export function savePlan(slug: string, content: string): string {
+  const planDir = getPlanDir();
+  const filePath = join(planDir, `${slug}.md`);
+  writeFileSync(filePath, content, "utf-8");
+  return filePath;
+}
+
+/**
+ * Save annotations (diff) to disk.
+ * Returns the full path to the saved file.
+ */
+export function saveAnnotations(slug: string, diffContent: string): string {
+  const planDir = getPlanDir();
+  const filePath = join(planDir, `${slug}.diff.md`);
+  writeFileSync(filePath, diffContent, "utf-8");
+  return filePath;
+}
+
+/**
+ * Save the final snapshot on approve/deny.
+ * Combines plan and diff into a single file with status suffix.
+ * Returns the full path to the saved file.
+ */
+export function saveFinalSnapshot(
+  slug: string,
+  status: "approved" | "denied",
+  plan: string,
+  diff: string
+): string {
+  const planDir = getPlanDir();
+  const filePath = join(planDir, `${slug}-${status}.md`);
+
+  // Combine plan with diff appended
+  let content = plan;
+  if (diff && diff !== "No changes detected.") {
+    content += "\n\n---\n\n" + diff;
+  }
+
+  writeFileSync(filePath, content, "utf-8");
+  return filePath;
+}