@plannotator/pi-extension 0.19.23 → 0.19.24

package/generated/codex-review.ts

@@ -7,22 +7,24 @@
  */
 
 import { join } from "node:path";
-import { homedir, tmpdir } from "node:os";
+import { tmpdir } from "node:os";
 import { appendFile, mkdir, unlink, writeFile, readFile } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { toRelativePath } from "./path-utils.js";
+import { getPlannotatorDataDir } from "./data-dir";
 
 // ---------------------------------------------------------------------------
 // Debug log — only active when PLANNOTATOR_DEBUG is set
 // ---------------------------------------------------------------------------
 
+const DATA_DIR = getPlannotatorDataDir();
 const DEBUG_ENABLED = !!process.env.PLANNOTATOR_DEBUG;
-const DEBUG_LOG_PATH = join(homedir(), ".plannotator", "codex-review-debug.log");
+const DEBUG_LOG_PATH = join(DATA_DIR, "codex-review-debug.log");
 
 async function debugLog(label: string, data?: unknown): Promise<void> {
   if (!DEBUG_ENABLED) return;
   try {
-    await mkdir(join(homedir(), ".plannotator"), { recursive: true });
+    await mkdir(DATA_DIR, { recursive: true });
     const timestamp = new Date().toISOString();
     const line = data !== undefined
       ? `[${timestamp}] ${label}: ${typeof data === "string" ? data : JSON.stringify(data, null, 2)}\n`
@@ -79,7 +81,7 @@ const CODEX_REVIEW_SCHEMA = JSON.stringify({
   additionalProperties: false,
 });
 
-const SCHEMA_DIR = join(homedir(), ".plannotator");
+const SCHEMA_DIR = DATA_DIR;
 const SCHEMA_FILE = join(SCHEMA_DIR, "codex-review-schema.json");
 let schemaMaterialized = false;
 

package/generated/config.ts

@@ -6,8 +6,8 @@
  * Runtime-agnostic: uses only node:fs, node:os, node:child_process.
  */
 
-import { homedir } from "os";
 import { join } from "path";
+import { getPlannotatorDataDir } from "./data-dir";
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
 import { execSync } from "child_process";
 
@@ -40,6 +40,7 @@ export type PromptSectionOverrides = Record<string, string | undefined>;
 
 export type PromptRuntime =
   | "claude-code"
+  | "amp"
   | "droid"
   | "opencode"
   | "copilot-cli"
@@ -128,7 +129,7 @@ export interface PlannotatorConfig {
   pfmReminder?: boolean;
 }
 
-const CONFIG_DIR = join(homedir(), ".plannotator");
+const CONFIG_DIR = getPlannotatorDataDir();
 const CONFIG_PATH = join(CONFIG_DIR, "config.json");
 
 /**

package/generated/data-dir.ts

@@ -0,0 +1,43 @@
+// @generated — DO NOT EDIT. Source: packages/shared/data-dir.ts
+/**
+ * Plannotator Data Directory
+ *
+ * Returns the base directory for all Plannotator data files.
+ *
+ * Priority:
+ *   1.  PLANNOTATOR_DATA_DIR environment variable (with ~ expansion)
+ *   2.  Default: ~/.plannotator
+ *
+ * This mirrors PASTE_DATA_DIR for the paste service and allows users
+ * to relocate all data (plans, history, drafts, config, hooks, sessions,
+ * debug logs, IPC registry, etc.) via a single variable — useful for
+ * XDG-style home directory cleanliness on Unix systems.
+ */
+
+import { homedir } from "os";
+import { join, resolve } from "path";
+
+/**
+ * Resolve the Plannotator data directory.
+ *
+ * If PLANNOTATOR_DATA_DIR is set and non-empty, the value is used
+ * as the base directory. Leading ~ is expanded to the user's home
+ * directory.
+ *
+ * Falls back to ~/.plannotator when the env var is absent or empty.
+ */
+export function getPlannotatorDataDir(): string {
+  const envDir = process.env.PLANNOTATOR_DATA_DIR?.trim();
+  if (!envDir) {
+    return join(homedir(), ".plannotator");
+  }
+
+  // Expand ~ to home directory
+  const home = homedir();
+  if (envDir === "~") return home;
+  if (envDir.startsWith("~/") || envDir.startsWith("~\\")) {
+    return join(home, envDir.slice(2));
+  }
+
+  return resolve(envDir);
+}

package/generated/draft.ts

@@ -9,16 +9,16 @@
  * Runtime-agnostic: uses only node:fs, node:path, node:os, node:crypto.
  */
 
-import { homedir } from "os";
 import { join } from "path";
 import { mkdirSync, writeFileSync, readFileSync, unlinkSync, existsSync } from "fs";
 import { createHash } from "crypto";
+import { getPlannotatorDataDir } from "./data-dir";
 
 /**
  * Get the drafts directory, creating it if needed.
  */
 export function getDraftDir(): string {
-  const dir = join(homedir(), ".plannotator", "drafts");
+  const dir = join(getPlannotatorDataDir(), "drafts");
   mkdirSync(dir, { recursive: true });
   return dir;
 }

package/generated/improvement-hooks.ts

@@ -18,15 +18,17 @@
  * - Same trust model as ~/.plannotator/config.json
  */
 
-import { homedir } from "os";
 import { join } from "path";
 import { readFileSync, statSync } from "fs";
+import { getPlannotatorDataDir } from "./data-dir";
 
-/** Base directory for hook-injectable files (new path) */
-const HOOKS_BASE_DIR = join(homedir(), ".plannotator", "hooks");
+const DATA_DIR = getPlannotatorDataDir();
 
-/** Legacy base directory (pre-migration path) */
-const LEGACY_BASE_DIR = join(homedir(), ".plannotator");
+/** Hooks subdirectory (preferred location) */
+const HOOKS_BASE_DIR = join(DATA_DIR, "hooks");
+
+/** Fallback: hooks placed directly in the data dir (pre-hooks-subdir layout) */
+const LEGACY_BASE_DIR = DATA_DIR;
 
 /** Maximum file size to read (50 KB) */
 const MAX_FILE_SIZE = 50 * 1024;

package/generated/pr-gitlab.ts

@@ -6,11 +6,11 @@
  * Self-hosted instances are supported via the --hostname flag.
  */
 
-import { homedir } from "os";
 import { join } from "path";
 import { mkdirSync, writeFileSync } from "fs";
 import type { PRRuntime, PRMetadata, PRContext, PRReviewFileComment, CommandResult } from "./pr-types";
 import { encodeApiFilePath } from "./pr-types";
+import { getPlannotatorDataDir } from "./data-dir";
 
 // GitLab-specific MRRef shape (used internally)
 interface GlMRRef {
@@ -563,7 +563,7 @@ export async function submitGlMRReview(
         .filter((c): c is PRReviewFileComment => c !== null);
       let savedTo: string | null = null;
       try {
-        const dir = join(homedir(), ".plannotator", "failed-comments");
+        const dir = join(getPlannotatorDataDir(), "failed-comments");
         mkdirSync(dir, { recursive: true });
         const slug = `${ref.host}-${ref.projectPath.replace(/\//g, "_")}-mr${ref.iid}-${Date.now()}`;
         savedTo = join(dir, `${slug}.json`);

package/generated/prompts.ts

@@ -17,6 +17,7 @@ export function resolveTemplate(
 
 export const PLAN_TOOL_NAMES: Record<PromptRuntime, string> = {
   "claude-code": "ExitPlanMode",
+  amp: "ExitPlanMode",
   droid: "ExitPlanMode",
   opencode: "submit_plan",
   "copilot-cli": "exit_plan_mode",

package/generated/storage.ts

@@ -8,11 +8,13 @@
  * Runtime-agnostic: uses only node:fs, node:path, node:os.
  */
 
-import { homedir } from "os";
 import { join, resolve, sep } from "path";
 import { mkdirSync, writeFileSync, readFileSync, readdirSync, statSync, existsSync } from "fs";
 import { sanitizeTag } from "./project";
 import { resolveUserPath } from "./resolve-file";
+import { getPlannotatorDataDir } from "./data-dir";
+
+const DATA_DIR = getPlannotatorDataDir();
 
 /**
  * Get the plan storage directory, creating it if needed.
@@ -25,7 +27,7 @@ export function getPlanDir(customPath?: string | null): string {
   if (customPath?.trim()) {
     planDir = resolveUserPath(customPath);
   } else {
-    planDir = join(homedir(), ".plannotator", "plans");
+    planDir = join(DATA_DIR, "plans");
   }
 
   mkdirSync(planDir, { recursive: true });
@@ -200,7 +202,7 @@ export function readArchivedPlan(filename: string, customPath?: string | null):
  * Not affected by the customPath setting (that only affects decision saves).
  */
 export function getHistoryDir(project: string, slug: string): string {
-  const historyDir = join(homedir(), ".plannotator", "history", project, slug);
+  const historyDir = join(DATA_DIR, "history", project, slug);
   mkdirSync(historyDir, { recursive: true });
   return historyDir;
 }
@@ -267,7 +269,7 @@ export function getPlanVersion(
   slug: string,
   version: number
 ): string | null {
-  const historyDir = join(homedir(), ".plannotator", "history", project, slug);
+  const historyDir = join(DATA_DIR, "history", project, slug);
   const fileName = `${String(version).padStart(3, "0")}.md`;
   const filePath = join(historyDir, fileName);
 
@@ -287,7 +289,7 @@ export function getPlanVersionPath(
   slug: string,
   version: number
 ): string | null {
-  const historyDir = join(homedir(), ".plannotator", "history", project, slug);
+  const historyDir = join(DATA_DIR, "history", project, slug);
   const fileName = `${String(version).padStart(3, "0")}.md`;
   const filePath = join(historyDir, fileName);
   return existsSync(filePath) ? filePath : null;
@@ -298,7 +300,7 @@ export function getPlanVersionPath(
  * Returns 0 if the directory doesn't exist.
  */
 export function getVersionCount(project: string, slug: string): number {
-  const historyDir = join(homedir(), ".plannotator", "history", project, slug);
+  const historyDir = join(DATA_DIR, "history", project, slug);
   try {
     const entries = readdirSync(historyDir);
     return entries.filter((e) => /^\d+\.md$/.test(e)).length;
@@ -315,7 +317,7 @@ export function listVersions(
   project: string,
   slug: string
 ): Array<{ version: number; timestamp: string }> {
-  const historyDir = join(homedir(), ".plannotator", "history", project, slug);
+  const historyDir = join(DATA_DIR, "history", project, slug);
   try {
     const entries = readdirSync(historyDir);
     const versions: Array<{ version: number; timestamp: string }> = [];
@@ -345,7 +347,7 @@ export function listVersions(
 export function listProjectPlans(
   project: string
 ): Array<{ slug: string; versions: number; lastModified: string }> {
-  const projectDir = join(homedir(), ".plannotator", "history", project);
+  const projectDir = join(DATA_DIR, "history", project);
   try {
     const entries = readdirSync(projectDir, { withFileTypes: true });
     const plans: Array<{ slug: string; versions: number; lastModified: string }> = [];

package/generated/tour-review.ts

@@ -1,7 +1,8 @@
 // @generated — DO NOT EDIT. Source: packages/server/tour/tour-review.ts
 import { join } from "node:path";
-import { homedir, tmpdir } from "node:os";
+import { tmpdir } from "node:os";
 import { mkdir, writeFile, readFile, unlink } from "node:fs/promises";
+import { getPlannotatorDataDir } from "./data-dir";
 import type { DiffType } from "./review-core.js";
 import type { PRMetadata } from "./pr-provider.js";
 import { getLocalDiffInstruction } from "./agent-review-message.js";
@@ -384,7 +385,7 @@ export function buildTourClaudeCommand(prompt: string, model: string = "sonnet",
   };
 }
 
-const TOUR_SCHEMA_DIR = join(homedir(), ".plannotator");
+const TOUR_SCHEMA_DIR = getPlannotatorDataDir();
 const TOUR_SCHEMA_FILE = join(TOUR_SCHEMA_DIR, "tour-schema.json");
 let tourSchemaMaterialized = false;
 

package/index.ts

@@ -1165,9 +1165,9 @@ Execute each step in order. After completing a step, include [DONE:n] in your re
 	pi.on("agent_end", async (_event, ctx) => {
 		if (phase === "executing" && justApprovedPlan) {
 			justApprovedPlan = false;
-			setTimeout(() => {
-				pi.sendUserMessage("Continue with the approved plan.");
-			}, 0);
+			pi.sendUserMessage("Continue with the approved plan.", {
+				deliverAs: "followUp",
+			});
 			return;
 		}
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plannotator/pi-extension",
-  "version": "0.19.23",
+  "version": "0.19.24",
   "type": "module",
   "description": "Plannotator Pi extension - interactive plan review with annotations, annotate agent messages, and review code/PRs",
   "author": "backnotprop",