poe-code 4.0.49 → 4.0.51

package/dist/index.js

@@ -76430,7 +76430,7 @@ function toPlanKind(value, filePath) {
   }
   throw new Error(`${filePath}: unsupported frontmatter kind ${JSON.stringify(value)}`);
 }
-function classifyPlanKind(content, filePath) {
+function classifyPlanKind(content, filePath, archived = false) {
   if (isYamlPlanFile(filePath)) {
     parsePlan(content);
     return "pipeline";
@@ -76439,13 +76439,24 @@ function classifyPlanKind(content, filePath) {
   if (data === void 0) {
     return "plan";
   }
-  return data.kind === void 0 ? "plan" : toPlanKind(data.kind, filePath);
+  if (data.kind === void 0) return "plan";
+  if (archived && data.kind === "archived-pipeline-plan") return "plan";
+  if (archived) {
+    try {
+      return toPlanKind(data.kind, filePath);
+    } catch {
+      return "plan";
+    }
+  }
+  return toPlanKind(data.kind, filePath);
 }
 function readPlanReadiness(content, filePath) {
   const value = splitFrontmatter2(content, filePath).data?.readiness;
   if (value === void 0 || value === "draft") return "draft";
   if (value === "ready") return value;
-  throw new Error(`${filePath}: invalid readiness ${JSON.stringify(value)}; expected "draft" or "ready"`);
+  throw new Error(
+    `${filePath}: invalid readiness ${JSON.stringify(value)}; expected "draft" or "ready"`
+  );
 }
 async function discoverSharedPlans(options) {
   const displayDir = await resolveSharedPlanDirectory(options);
@@ -76462,6 +76473,14 @@ async function discoverSharedPlans(options) {
   if (canonicalDir !== path89.resolve(absoluteDir)) {
     throw new Error(`Plan directory must not be a symbolic link: ${displayDir}`);
   }
+  if (options.archived === true) {
+    return discoverPlanDirectoryEntries({
+      ...options,
+      absoluteDir: path89.join(absoluteDir, "archive"),
+      displayDir: path89.join(displayDir, "archive"),
+      savedForLaterDirectory: false
+    });
+  }
   const activePlans = await discoverPlanDirectoryEntries({
     ...options,
     absoluteDir,
@@ -76502,7 +76521,9 @@ async function discoverPlanDirectoryEntries(options) {
       continue;
     }
     if (canonicalPath !== path89.resolve(absolutePath)) {
-      throw new Error(`Plan file must not be a symbolic link: ${path89.join(options.displayDir, name)}`);
+      throw new Error(
+        `Plan file must not be a symbolic link: ${path89.join(options.displayDir, name)}`
+      );
     }
     const stat36 = await options.fs.stat(absolutePath).catch((error3) => {
       if (isNotFound4(error3)) {
@@ -76518,18 +76539,31 @@ async function discoverPlanDirectoryEntries(options) {
     }
     const displayPath = path89.join(options.displayDir, name);
     const content = await options.fs.readFile(absolutePath, "utf8");
-    const kind = classifyPlanKind(content, displayPath);
+    let kind = classifyPlanKind(content, displayPath, options.archived);
+    const savedForLater = options.savedForLaterDirectory ? readSavedForLaterMetadata(content, displayPath) ?? {} : readSavedForLaterMetadata(content, displayPath);
+    let metadata;
+    try {
+      metadata = await readPlanMetadata({
+        kind,
+        absolutePath,
+        path: displayPath,
+        fs: options.fs,
+        content
+      });
+    } catch (error3) {
+      if (!options.archived || kind === "plan") throw error3;
+      kind = "plan";
+      metadata = await readPlanMetadata({
+        kind,
+        absolutePath,
+        path: displayPath,
+        fs: options.fs,
+        content
+      });
+    }
     if (options.kind && kind !== options.kind) {
       continue;
     }
-    const savedForLater = options.savedForLaterDirectory ? readSavedForLaterMetadata(content, displayPath) ?? {} : readSavedForLaterMetadata(content, displayPath);
-    const metadata = await readPlanMetadata({
-      kind,
-      absolutePath,
-      path: displayPath,
-      fs: options.fs,
-      content
-    });
     plans.push({
       path: displayPath,
       absolutePath,
@@ -76668,6 +76702,25 @@ async function archiveSelectedPlan(entry, fs31) {
   }
   return archivedPath;
 }
+async function unarchivePlan(entry, fs31) {
+  rejectPlanMetaDocument(entry.absolutePath, "unarchive");
+  const archiveDir = path90.dirname(entry.absolutePath);
+  if (path90.basename(archiveDir) !== "archive") {
+    throw new Error(`Plan is not archived: ${entry.absolutePath}`);
+  }
+  await rejectSymbolicLink2(archiveDir, fs31, "unarchive plan through");
+  const destinationPath = path90.join(path90.dirname(archiveDir), path90.basename(entry.absolutePath));
+  try {
+    await fs31.readFile(destinationPath, "utf8");
+    throw new Error(`Unarchive destination already exists: ${destinationPath}`);
+  } catch (error3) {
+    if (!hasErrorCode3(error3, "ENOENT")) {
+      throw error3;
+    }
+  }
+  await fs31.rename(entry.absolutePath, destinationPath);
+  return destinationPath;
+}
 async function savePlanForLater(entry, fs31, options = {}) {
   const reason = entry.savedForLater?.reason?.trim() || options.reason?.trim();
   if (!reason) {
@@ -76813,14 +76866,14 @@ function buildPlanExplorerConfig(options) {
   const loadDetailMarkdown = options.loadDetailMarkdown ?? loadPlanPreviewMarkdown;
   const promptSaveReason = options.promptSaveReason;
   let plans = options.plans;
-  let rows = toRows(plans);
+  let rows = toRows(plans, options.archived);
   let entryByRowId = toEntryMap(plans);
   let preserveOrderOnNextRefresh = false;
   async function refresh() {
     const refreshedPlans = await options.onRefresh();
     plans = preserveOrderOnNextRefresh ? preservePlanOrder(plans, refreshedPlans) : refreshedPlans;
     preserveOrderOnNextRefresh = false;
-    rows = toRows(plans);
+    rows = toRows(plans, options.archived);
     entryByRowId = toEntryMap(plans);
   }
   const actions = [
@@ -76908,6 +76961,21 @@ function buildPlanExplorerConfig(options) {
         }
       }
     },
+    {
+      id: "unarchive",
+      accelerator: "a",
+      label: "Unarchive",
+      handler: async (ctx) => {
+        const entry = getEntry(entryByRowId, ctx.row.id);
+        await unarchivePlan(entry, options.fs);
+        try {
+          await ctx.refresh();
+          ctx.toast(`Unarchived ${path91.basename(entry.path)}`, "info");
+        } catch {
+          ctx.toast(`Unarchived ${path91.basename(entry.path)}; refresh failed`, "info");
+        }
+      }
+    },
     {
       id: "delete",
       accelerator: "x",
@@ -76953,43 +77021,47 @@ function buildPlanExplorerConfig(options) {
       }
     ],
     refresh,
-    actions,
-    reorder: {
-      onReorder: async (orderedIds, ctx) => {
-        if (ctx === void 0) {
-          throw new Error("Plan reorder context is required");
-        }
-        const orderedEntries = orderedIds.map((id) => getEntry(entryByRowId, id));
-        const movedIndex = orderedIds.indexOf(ctx.movedId);
-        const originalIndex = createRowIds(plans).indexOf(ctx.movedId);
-        if (movedIndex < 0 || originalIndex < 0) {
-          throw new Error(`Plan row is no longer available: ${ctx.movedId}`);
-        }
-        const moved = orderedEntries[movedIndex];
-        const swapTarget = orderedEntries[originalIndex];
-        if (swapTarget === void 0 || swapTarget.readiness !== moved.readiness) {
-          throw new Error("Plans can only be reordered within the same readiness group");
-        }
-        if (isSavedForLaterEntry(swapTarget) !== isSavedForLaterEntry(moved)) {
-          throw new Error("Active and saved-for-later plans cannot be reordered together");
-        }
-        const previousCandidate = orderedEntries[movedIndex - 1];
-        const nextCandidate = orderedEntries[movedIndex + 1];
-        const previous = sameOrderingGroup(previousCandidate, moved) ? previousCandidate : void 0;
-        const next = sameOrderingGroup(nextCandidate, moved) ? nextCandidate : void 0;
-        const [movedStat, previousStat, nextStat] = await Promise.all([
-          options.fs.stat(moved.absolutePath),
-          previous === void 0 ? void 0 : options.fs.stat(previous.absolutePath),
-          next === void 0 ? void 0 : options.fs.stat(next.absolutePath)
-        ]);
-        const updatedAt = resolveMovedTimestamp(previousStat?.mtimeMs, nextStat?.mtimeMs);
-        await options.fs.utimes(
-          moved.absolutePath,
-          new Date(movedStat.atimeMs ?? movedStat.mtimeMs),
-          new Date(updatedAt)
-        );
-        await ctx.refresh();
-        ctx.toast(`Reordered ${path91.basename(moved.path)}`, "info");
+    actions: options.archived ? actions.filter(
+      (action) => action.id === "edit" || action.id === "unarchive" || action.id === "delete"
+    ) : actions.filter((action) => action.id !== "unarchive"),
+    ...options.archived ? {} : {
+      reorder: {
+        onReorder: async (orderedIds, ctx) => {
+          if (ctx === void 0) {
+            throw new Error("Plan reorder context is required");
+          }
+          const orderedEntries = orderedIds.map((id) => getEntry(entryByRowId, id));
+          const movedIndex = orderedIds.indexOf(ctx.movedId);
+          const originalIndex = createRowIds(plans).indexOf(ctx.movedId);
+          if (movedIndex < 0 || originalIndex < 0) {
+            throw new Error(`Plan row is no longer available: ${ctx.movedId}`);
+          }
+          const moved = orderedEntries[movedIndex];
+          const swapTarget = orderedEntries[originalIndex];
+          if (swapTarget === void 0 || swapTarget.readiness !== moved.readiness) {
+            throw new Error("Plans can only be reordered within the same readiness group");
+          }
+          if (isSavedForLaterEntry(swapTarget) !== isSavedForLaterEntry(moved)) {
+            throw new Error("Active and saved-for-later plans cannot be reordered together");
+          }
+          const previousCandidate = orderedEntries[movedIndex - 1];
+          const nextCandidate = orderedEntries[movedIndex + 1];
+          const previous = sameOrderingGroup(previousCandidate, moved) ? previousCandidate : void 0;
+          const next = sameOrderingGroup(nextCandidate, moved) ? nextCandidate : void 0;
+          const [movedStat, previousStat, nextStat] = await Promise.all([
+            options.fs.stat(moved.absolutePath),
+            previous === void 0 ? void 0 : options.fs.stat(previous.absolutePath),
+            next === void 0 ? void 0 : options.fs.stat(next.absolutePath)
+          ]);
+          const updatedAt = resolveMovedTimestamp(previousStat?.mtimeMs, nextStat?.mtimeMs);
+          await options.fs.utimes(
+            moved.absolutePath,
+            new Date(movedStat.atimeMs ?? movedStat.mtimeMs),
+            new Date(updatedAt)
+          );
+          await ctx.refresh();
+          ctx.toast(`Reordered ${path91.basename(moved.path)}`, "info");
+        }
       }
     },
     multiSelect: false,
@@ -77034,14 +77106,14 @@ function abbreviateHome(filePath, homeDir) {
   }
   return `~${path91.sep}${relative8}`;
 }
-function toRows(plans) {
+function toRows(plans, archived = false) {
   const rowIds = createRowIds(plans);
   return plans.map((entry, index) => ({
     id: rowIds[index],
     title: formatPlanReadinessLabel(path91.basename(entry.path), entry.readiness),
     subtitle: formatSubtitle(entry),
     badge: { text: entry.typeLabel },
-    group: isSavedForLaterEntry(entry) ? "Saved for later" : "Active"
+    group: archived ? "Archived" : isSavedForLaterEntry(entry) ? "Saved for later" : "Active"
   }));
 }
 function formatSubtitle(entry) {
@@ -77109,6 +77181,7 @@ async function runPlanBrowser(options) {
     projectConfigPath: options.projectConfigPath,
     fs: options.fs,
     kind: options.kind,
+    archived: options.archived,
     variables: options.variables
   });
   const plans = await discover();
@@ -77128,6 +77201,7 @@ async function runPlanBrowser(options) {
   }
   const config2 = buildPlanExplorerConfig({
     plans,
+    archived: options.archived,
     fs: options.fs,
     variables: options.variables ?? process.env,
     homeDir: options.homeDir,
@@ -77840,7 +77914,8 @@ function resolvePlanCommandOptions(command) {
   const parentOptions = command.parent?.opts() ?? {};
   return {
     kind: localOptions.kind ?? parentOptions.kind,
-    output: localOptions.output ?? parentOptions.output
+    output: localOptions.output ?? parentOptions.output,
+    archived: localOptions.archived ?? parentOptions.archived
   };
 }
 function resolveOutputOption(value) {
@@ -77870,7 +77945,7 @@ function resolveKind(value) {
   }
   throw new ValidationError(`Invalid --kind value "${value}". Expected ${VALID_KINDS.join(", ")}.`);
 }
-function createPlanBrowserOptions(container, kind) {
+function createPlanBrowserOptions(container, kind, archived = false) {
   return {
     cwd: container.env.cwd,
     homeDir: container.env.homeDir,
@@ -77878,6 +77953,7 @@ function createPlanBrowserOptions(container, kind) {
     projectConfigPath: container.env.projectConfigPath,
     fs: container.fs,
     kind,
+    archived,
     variables: container.env.variables
   };
 }
@@ -77972,7 +78048,7 @@ function formatMarkdownReadSectionOutput(result, format) {
   }
   return result.markdown.trimEnd();
 }
-async function discoverPlans2(container, kind) {
+async function discoverPlans2(container, kind, archived = false) {
   return discoverAllPlans({
     cwd: container.env.cwd,
     homeDir: container.env.homeDir,
@@ -77980,6 +78056,7 @@ async function discoverPlans2(container, kind) {
     projectConfigPath: container.env.projectConfigPath,
     fs: container.fs,
     kind,
+    archived,
     variables: container.env.variables
   });
 }
@@ -77987,7 +78064,7 @@ async function requirePlanBrowsingPrompt(options) {
   if (!options.assumeYes && process.stdin.isTTY === true) {
     return;
   }
-  const plans = await discoverPlans2(options.container, options.kind);
+  const plans = await discoverPlans2(options.container, options.kind, options.archived);
   if (plans.length === 0) {
     return;
   }
@@ -78116,7 +78193,11 @@ async function executePlanAction(options) {
   if (format === "terminal") {
     intro(`plan ${options.action}`);
   }
-  const plans = await discoverPlans2(options.container, resolveKind(options.kind));
+  const plans = await discoverPlans2(
+    options.container,
+    resolveKind(options.kind),
+    options.action === "unarchive"
+  );
   const plan = await resolveSelectedPlan({
     container: options.container,
     plans,
@@ -78169,7 +78250,7 @@ async function executePlanAction(options) {
       `plan ${options.action} requires --yes when running without an interactive TTY.`
     );
     const confirmed = await confirmOrCancel({
-      message: options.action === "archive" ? `Archive ${path93.basename(plan.path)}?` : `Permanently delete ${path93.basename(plan.path)}?`,
+      message: options.action === "archive" ? `Archive ${path93.basename(plan.path)}?` : options.action === "unarchive" ? `Unarchive ${path93.basename(plan.path)}?` : `Permanently delete ${path93.basename(plan.path)}?`,
       initialValue: false
     });
     if (!confirmed) {
@@ -78187,6 +78268,17 @@ async function executePlanAction(options) {
     );
     return;
   }
+  if (options.action === "unarchive") {
+    const restoredPath = await unarchivePlan(
+      plan,
+      options.container.fs
+    );
+    writeOutput(
+      format,
+      format === "json" ? JSON.stringify({ action: "unarchive", path: plan.path, restoredPath }, null, 2) : `Unarchived ${plan.path}`
+    );
+    return;
+  }
   await deletePlan(plan, options.container.fs);
   writeOutput(
     format,
@@ -78197,7 +78289,7 @@ function registerPlanCommand(program, container) {
   const plan = program.command("plan").alias("plans").description("Browse and manage plans.").usage("[options] [command]").allowExcessArguments().option(
     "--kind <kind>",
     "Filter by plan kind: plan, pipeline, experiment, ralph, superintendent, or superintendent-base"
-  ).action(async function() {
+  ).option("--archived", "Browse archived plans instead of active plans").action(async function() {
     if (this.args.length > 0) {
       const candidates = plan.commands.flatMap((command) => [
         command.name(),
@@ -78215,19 +78307,24 @@ function registerPlanCommand(program, container) {
     const opts = this.opts();
     const flags = resolveCommandFlags(program);
     const kind = resolveKind(opts.kind);
-    await requirePlanBrowsingPrompt({ container, kind, assumeYes: flags.assumeYes });
+    await requirePlanBrowsingPrompt({
+      container,
+      kind,
+      assumeYes: flags.assumeYes,
+      archived: opts.archived
+    });
     intro("plan");
-    await runPlanBrowser(createPlanBrowserOptions(container, kind));
+    await runPlanBrowser(createPlanBrowserOptions(container, kind, opts.archived));
   });
   plan.command("browse").description("Browse plans in the interactive explorer, or render one plan when given a path.").argument("[path]", "Plan path to render instead of opening the explorer").option(
     "--kind <kind>",
     "Filter by plan kind: plan, pipeline, experiment, ralph, superintendent, or superintendent-base"
-  ).action(async function(pathArg) {
+  ).option("--archived", "Browse archived plans instead of active plans").action(async function(pathArg) {
     const opts = resolvePlanCommandOptions(this);
     const flags = resolveCommandFlags(program);
     const kind = resolveKind(opts.kind);
     if ((pathArg?.trim() ?? "").length > 0) {
-      const plans = await discoverPlans2(container, kind);
+      const plans = await discoverPlans2(container, kind, opts.archived);
       const selected = await resolveSelectedPlan({
         container,
         plans,
@@ -78239,9 +78336,14 @@ function registerPlanCommand(program, container) {
       writeOutput("terminal", renderMarkdown(markdown).trimEnd());
       return;
     }
-    await requirePlanBrowsingPrompt({ container, kind, assumeYes: flags.assumeYes });
+    await requirePlanBrowsingPrompt({
+      container,
+      kind,
+      assumeYes: flags.assumeYes,
+      archived: opts.archived
+    });
     intro("plan browser");
-    await runPlanBrowser(createPlanBrowserOptions(container, kind));
+    await runPlanBrowser(createPlanBrowserOptions(container, kind, opts.archived));
   });
   plan.command("list").description("List plans across all plan systems.").option(
     "--kind <kind>",
@@ -78365,6 +78467,18 @@ function registerPlanCommand(program, container) {
       ...resolvePlanCommandOptions(this)
     });
   });
+  plan.command("unarchive").description("Move an archived plan back into the active plan directory.").argument("[path]", "Archived plan path").option(
+    "--kind <kind>",
+    "Filter by plan kind: plan, pipeline, experiment, ralph, superintendent, or superintendent-base"
+  ).option("--output <format>", "Output format: terminal, md, or json").action(async function(pathArg) {
+    await executePlanAction({
+      program,
+      container,
+      action: "unarchive",
+      pathArg,
+      ...resolvePlanCommandOptions(this)
+    });
+  });
   plan.command("delete").description("Delete a plan file.").argument("[path]", "Plan path").option(
     "--kind <kind>",
     "Filter by plan kind: plan, pipeline, experiment, ralph, superintendent, or superintendent-base"
@@ -152722,7 +152836,7 @@ var init_package2 = __esm({
   "package.json"() {
     package_default2 = {
       name: "poe-code",
-      version: "4.0.49",
+      version: "4.0.51",
       description: "CLI tool to configure Poe API for developer workflows.",
       license: "MIT",
       type: "module",