poe-code 4.0.14 → 4.0.16

package/dist/index.js

@@ -76143,19 +76143,6 @@ function buildPlanExplorerConfig(options) {
       }
     }
   ];
-  if (options.onCreatePlan !== void 0) {
-    actions.push({
-      id: "new",
-      key: "n",
-      primary: true,
-      label: "New plan",
-      predicate: () => options.onCreatePlan != null,
-      handler: async (ctx) => {
-        await ctx.suspendAnd(() => options.onCreatePlan());
-        await ctx.refresh();
-      }
-    });
-  }
   return {
     title: "Plans",
     rows: async () => rows,
@@ -76288,8 +76275,7 @@ async function runPlanBrowser(options) {
     plans,
     fs: options.fs,
     variables: options.variables ?? process.env,
-    onRefresh: discover,
-    onCreatePlan: options.onCreatePlan
+    onRefresh: discover
   });
   await (options.runExplorerImpl ?? runExplorer)(config2);
 }
@@ -76993,20 +76979,6 @@ var init_SKILL_plan = __esm({
 // src/cli/commands/plan.ts
 import path93 from "node:path";
 import { stringify as stringifyYaml2 } from "yaml";
-function buildPlanPrompt(options) {
-  const trimmedQuestion = options.question.trim();
-  const userSection = trimmedQuestion.length > 0 ? `User request: ${trimmedQuestion}` : `The user has not yet stated what they want to plan. Follow the skill's "If The Request Is Empty" instruction and ask: What do you want to plan?`;
-  return [
-    "Follow the skill below to draft a feature plan.",
-    "",
-    options.skillContent,
-    "",
-    "---",
-    "",
-    `Plan directory: ${options.planDirectory}`,
-    userSection
-  ].join("\n");
-}
 function resolvePlanCommandOptions(command) {
   const localOptions = command.opts();
   const parentOptions = command.parent?.opts() ?? {};
@@ -77042,16 +77014,15 @@ function resolveKind(value) {
   }
   throw new ValidationError(`Invalid --kind value "${value}". Expected ${VALID_KINDS.join(", ")}.`);
 }
-function createPlanBrowserOptions(container, options) {
+function createPlanBrowserOptions(container, kind) {
   return {
     cwd: container.env.cwd,
     homeDir: container.env.homeDir,
     configPath: container.env.configPath,
     projectConfigPath: container.env.projectConfigPath,
     fs: container.fs,
-    kind: options.kind,
-    variables: container.env.variables,
-    ...options.onCreatePlan ? { onCreatePlan: options.onCreatePlan } : {}
+    kind,
+    variables: container.env.variables
   };
 }
 function formatDate(timestamp) {
@@ -77258,11 +77229,7 @@ async function renderPlanList(container, options) {
   }
   if (plans.length === 0) {
     const scope = kind === void 0 ? "" : `${kind} `;
-    const kindFlag = kind === void 0 ? "" : ` --kind ${kind}`;
-    writeOutput(
-      format,
-      `No ${scope}plans found. Create one with poe-code plan${kindFlag} "<description>".`
-    );
+    writeOutput(format, `No ${scope}plans found.`);
     return;
   }
   const table = withOutputFormat(
@@ -77371,71 +77338,30 @@ async function executePlanAction(options) {
   );
 }
 function registerPlanCommand(program, container) {
-  const plan = program.command("plan").description(
-    "Browse plans in an interactive explorer, or draft a new plan when given a question."
-  ).argument("[question]", "What you want to plan").option("--agent <name>", "Agent to run the plan session with").option(
+  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(questionArg) {
-    const opts = this.opts();
-    const flags = resolveCommandFlags(program);
-    const kind = resolveKind(opts.kind);
-    const question = questionArg?.trim() ?? "";
-    if (question.length > 0) {
+  ).action(async function() {
+    if (this.args.length > 0) {
       const candidates = plan.commands.flatMap((command) => [
         command.name(),
         ...command.aliases()
       ]);
-      const suggestions = suggest2(question, candidates);
-      if (suggestions.length > 0) {
-        throwCommandNotFound({
-          container,
-          scope: "cli",
-          unknownCommand: question,
-          helpArgs: ["plan", "--help"],
-          candidates,
-          moduleUrl: import.meta.url
-        });
-      }
-      const agent3 = await resolvePlanSessionAgent(
-        container,
-        opts.agent,
-        flags,
-        container.loggerFactory.create({ dryRun: flags.dryRun, verbose: flags.verbose, scope: "plan" })
-      );
-      if (agent3 === null) {
-        return;
-      }
-      await runPlanSession({
+      throwCommandNotFound({
         container,
-        agent: agent3,
-        question,
-        dryRun: flags.dryRun
+        scope: "cli",
+        unknownCommand: this.args.at(0) ?? "",
+        helpArgs: ["plan", "--help"],
+        candidates,
+        moduleUrl: import.meta.url
       });
-      return;
-    }
-    if (flags.assumeYes) {
-      throw new ValidationError(
-        "A question is required for `poe-code plan`. Pass it as the first argument."
-      );
     }
+    const opts = this.opts();
+    const flags = resolveCommandFlags(program);
+    const kind = resolveKind(opts.kind);
     await requirePlanBrowsingPrompt({ container, kind, assumeYes: flags.assumeYes });
     intro("plan");
-    await runPlanBrowser(
-      createPlanBrowserOptions(container, {
-        kind,
-        onCreatePlan: () => runPlanSessionWithPrompt(
-          container,
-          opts.agent,
-          flags,
-          container.loggerFactory.create({
-            dryRun: flags.dryRun,
-            verbose: flags.verbose,
-            scope: "plan"
-          })
-        )
-      })
-    );
+    await runPlanBrowser(createPlanBrowserOptions(container, kind));
   });
   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>",
@@ -77459,7 +77385,7 @@ function registerPlanCommand(program, container) {
     }
     await requirePlanBrowsingPrompt({ container, kind, assumeYes: flags.assumeYes });
     intro("plan browser");
-    await runPlanBrowser(createPlanBrowserOptions(container, { kind }));
+    await runPlanBrowser(createPlanBrowserOptions(container, kind));
   });
   plan.command("list").description("List plans across all plan systems.").option(
     "--kind <kind>",
@@ -77597,13 +77523,7 @@ function registerPlanCommand(program, container) {
   });
   plan.command("install").description("Install the /plan five-levels skill.").option("--agent <name>", "Agent to install the plan skill for").option("--local", "Install project-local skill").option("--global", "Install user-global skill").action(async function() {
     const flags = resolveCommandFlags(program);
-    const localOptions = this.opts();
-    const parentOptions = this.parent?.opts() ?? {};
-    const options = {
-      agent: localOptions.agent ?? parentOptions.agent,
-      local: localOptions.local,
-      global: localOptions.global
-    };
+    const options = this.opts();
     if (options.local && options.global) {
       throw new ValidationError("Use either --local or --global, not both.");
     }
@@ -77652,78 +77572,13 @@ function registerPlanCommand(program, container) {
   setHelpGuidance(plan, {
     examples: [
       "poe-code plan",
-      'poe-code plan "add retries to the spawn runtime"',
+      "poe-code plans",
       "poe-code plan --kind pipeline",
       "poe-code plan list --kind experiment",
       "poe-code plan view docs/plans/my-plan.md",
       "poe-code plan install --local"
     ],
-    notes: [
-      "Interactive explorer keys: e edit, a archive, d delete, n new."
-    ]
-  });
-}
-async function resolvePlanQuestion(value, assumeYes) {
-  const trimmed = value?.trim() ?? "";
-  if (trimmed.length > 0) {
-    return trimmed;
-  }
-  if (assumeYes) {
-    throw new ValidationError(
-      "A question is required for `poe-code plan`. Pass it as the first argument."
-    );
-  }
-  requireInteractiveStdin(
-    "Plan question prompt requires a question when running without an interactive TTY."
-  );
-  const entered = await text2({
-    message: "What do you want to plan?"
-  });
-  if (isCancel(entered)) {
-    cancel("Plan session cancelled.");
-    return null;
-  }
-  const question = typeof entered === "string" ? entered.trim() : "";
-  if (question.length === 0) {
-    throw new ValidationError("A question is required for `poe-code plan`.");
-  }
-  return question;
-}
-async function resolvePlanSessionAgent(container, value, flags, logger2) {
-  const trimmed = value?.trim() ?? "";
-  if (trimmed.length > 0) {
-    return trimmed;
-  }
-  if (flags.assumeYes) {
-    return await resolveAssumedDefaultAgent({ container, logger: logger2, readOnly: flags.dryRun });
-  }
-  requireInteractiveStdin(
-    "Plan session agent selection requires --agent or --yes when running without an interactive TTY."
-  );
-  const selected = await select({
-    message: "Select agent to draft the plan with:",
-    options: supportedAgents2.map((name) => ({ value: name, label: name }))
-  });
-  if (isCancel(selected)) {
-    cancel("Plan session cancelled.");
-    return null;
-  }
-  return selected;
-}
-async function runPlanSessionWithPrompt(container, agentValue, flags, logger2) {
-  const question = await resolvePlanQuestion(void 0, flags.assumeYes);
-  if (question === null) {
-    return;
-  }
-  const agent3 = await resolvePlanSessionAgent(container, agentValue, flags, logger2);
-  if (agent3 === null) {
-    return;
-  }
-  await runPlanSession({
-    container,
-    agent: agent3,
-    question,
-    dryRun: flags.dryRun
+    notes: ["Interactive explorer keys: e edit, a archive, d delete."]
   });
 }
 async function resolvePlanDirectory4(container, options = {}) {
@@ -77740,36 +77595,6 @@ async function resolvePlanDirectory4(container, options = {}) {
   );
   return config2.plan_directory;
 }
-async function runPlanSession(options) {
-  const planDirectory = await resolvePlanDirectory4(options.container, { readOnly: options.dryRun });
-  const prompt = buildPlanPrompt({
-    question: options.question,
-    planDirectory,
-    skillContent: SKILL_plan_default
-  });
-  if (options.dryRun) {
-    const resources = createExecutionResources(
-      options.container,
-      { assumeYes: true, dryRun: true, verbose: false },
-      "plan"
-    );
-    resources.logger.dryRun(
-      `Dry run: would run plan session with ${options.agent} for ${options.question}.`
-    );
-    return;
-  }
-  requireInteractiveStdin(
-    "A plan session runs the agent interactively and requires an interactive TTY. Use `poe-code spawn` to draft a plan non-interactively."
-  );
-  const { result } = spawn9(options.agent, prompt, {
-    interactive: true,
-    cwd: options.container.env.cwd
-  });
-  const final = await result;
-  if (final.exitCode !== 0) {
-    process.exitCode = final.exitCode;
-  }
-}
 async function resolvePlanAgent(container, value, flags, logger2) {
   const trimmed = value?.trim() ?? "";
   if (trimmed.length > 0) {
@@ -77820,7 +77645,7 @@ async function resolvePlanScope(options, assumeYes, logger2) {
 }
 var DEFAULT_PLAN_SCOPE, VALID_KINDS;
 var init_plan = __esm({
-  async "src/cli/commands/plan.ts"() {
+  "src/cli/commands/plan.ts"() {
     "use strict";
     init_src2();
     init_src34();
@@ -77834,7 +77659,6 @@ var init_plan = __esm({
     init_errors2();
     init_config5();
     init_shared();
-    await init_spawn4();
     init_SKILL_plan();
     DEFAULT_PLAN_SCOPE = "local";
     VALID_KINDS = [
@@ -78001,10 +77825,10 @@ function isMissingDirectory(error3) {
   return hasOwnErrorCode21(error3, "ENOENT") || hasOwnErrorCode21(error3, "ENOTDIR");
 }
 var init_pipeline_init = __esm({
-  async "src/cli/commands/pipeline-init.ts"() {
+  "src/cli/commands/pipeline-init.ts"() {
     "use strict";
     init_src12();
-    await init_plan();
+    init_plan();
     init_error_codes18();
   }
 });
@@ -78222,7 +78046,7 @@ var init_pipeline3 = __esm({
   async "src/sdk/pipeline.ts"() {
     "use strict";
     init_src31();
-    await init_pipeline_init();
+    init_pipeline_init();
     init_SKILL_plan2();
     await init_spawn4();
     init_worktree();
@@ -107493,7 +107317,7 @@ var init_pipeline5 = __esm({
     init_errors2();
     init_subcommand_required();
     init_error_codes18();
-    await init_pipeline_init();
+    init_pipeline_init();
     init_shared();
     init_help_guidance();
     init_pipeline_loop_agent();
@@ -110181,7 +110005,7 @@ function parseLimit2(value) {
   return limit;
 }
 function registerTracesCommand(program, container) {
-  program.command("traces").description(
+  program.command("traces").alias("trace").description(
     "Browse claude, codex, pi and poe-code agent traces with context usage and breakdown."
   ).argument("[path]", "Path to a trace file").option("--source <sources...>", "Trace sources: claude, codex, pi, poe-code").option("--all-workspaces", "Read traces from every workspace, not just cwd").option("--since <duration>", "Only include recently updated traces").option("--limit <n>", "Maximum traces listed").option("--json", jsonOptionDescription).option("--full-titles", "Print untruncated trace titles, which may contain prompt content").option("--open", "Generate HTML for a trace path and open it in the browser").option("--html-out <file>", "Write HTML for a trace path without opening").action(async function(pathArg) {
     const options = this.opts();
@@ -151235,7 +151059,7 @@ var init_gaslight2 = __esm({
     init_src2();
     init_gaslight();
     await init_spawn4();
-    await init_plan();
+    init_plan();
     init_shared();
     init_configure();
     init_errors2();
@@ -151341,7 +151165,7 @@ var init_package2 = __esm({
   "package.json"() {
     package_default2 = {
       name: "poe-code",
-      version: "4.0.14",
+      version: "4.0.16",
       description: "CLI tool to configure Poe API for developer workflows.",
       license: "MIT",
       type: "module",
@@ -151717,8 +151541,12 @@ function formatCanonicalCommandPath(cmd) {
   return parts.reverse().join(" ");
 }
 function formatCanonicalCommandUsage(cmd) {
+  const hasExplicitUsage = typeof Reflect.get(cmd, "_usage") === "string";
   const usageParts = splitUsageParts(cmd.usage()).flatMap((part) => {
     if (part === "[command]") {
+      if (hasExplicitUsage) {
+        return [part];
+      }
       return cmd.registeredArguments.length === 0 ? ["<command>"] : [];
     }
     if (part === "[options]" && cmd.options.length === 0) {
@@ -152422,7 +152250,7 @@ var init_program = __esm({
     init_usage();
     init_models2();
     await init_pipeline5();
-    await init_plan();
+    init_plan();
     init_traces();
     await init_ralph4();
     await init_experiment3();