poe-code 3.0.183 → 3.0.184

package/dist/sdk/pipeline.d.ts

@@ -1,5 +1,5 @@
-import { type PipelineRunOptions, type PipelineRunResult } from "@poe-code/pipeline";
-export type { AgentRunUsage, AgentRunInput, AgentRunResult, PipelineConfig, PipelineMetrics, PipelinePlan, PipelineStatus, PipelineTask, ResolvedStepDefinitions, ResolvedStepsConfig, StepDefinition, StepMode, TaskProgress, PlanSummary } from "@poe-code/pipeline";
+import { type PipelineFileSystem, type PipelineRunOptions, type PipelineRunResult } from "@poe-code/pipeline";
+export type { AgentRunUsage, AgentRunInput, AgentRunResult, PipelineConfig, PipelineMetrics, PipelinePlan, PipelineLockStatus, PipelineStatus, PipelineTask, ResolvedStepDefinitions, ResolvedStepsConfig, StepDefinition, StepMode, TaskProgress, PlanSummary } from "@poe-code/pipeline";
 export { resolvePlanDirectory } from "@poe-code/pipeline";
 export type { PipelineRunOptions, PipelineRunResult };
 export interface PipelineInitSource {
@@ -14,7 +14,7 @@ export interface PipelineInitRunOptions {
     model?: string;
     cwd: string;
     homeDir: string;
-    planDirectory?: string;
+    fs?: PipelineFileSystem;
     sources: PipelineInitSource[];
     question?: string;
     assumeYes: boolean;

package/dist/sdk/pipeline.js

@@ -1,30 +1,153 @@
 import * as fsPromises from "node:fs/promises";
-import { resolvePlanDirectory as resolveWorkspacePlanDirectory, runPipeline as runWorkspacePipeline } from "@poe-code/pipeline";
+import path from "node:path";
+import { isActivityTimeoutError } from "@poe-code/agent-spawn";
+import { parsePlan, resolveAbsolutePlanPath, resolvePlanPath, runPipeline as runWorkspacePipeline } from "@poe-code/pipeline";
 import { buildPipelineInitPrompt } from "../cli/commands/pipeline-init.js";
 import pipelineSkillPlan from "../templates/pipeline/SKILL_plan.md";
 import { spawn as sdkSpawn } from "./spawn.js";
 export { resolvePlanDirectory } from "@poe-code/pipeline";
+const PIPELINE_ACTIVITY_TIMEOUT_RETRY_COUNT = 3;
 function isAbortError(error) {
     return error instanceof Error && error.name === "AbortError";
 }
+function createDefaultFs() {
+    return {
+        readFile: fsPromises.readFile,
+        writeFile: fsPromises.writeFile,
+        readdir: fsPromises.readdir,
+        stat: async (filePath) => {
+            const stat = await fsPromises.stat(filePath);
+            return {
+                isFile: () => stat.isFile(),
+                isDirectory: () => stat.isDirectory(),
+                mtimeMs: stat.mtimeMs
+            };
+        },
+        mkdir: async (filePath, options) => {
+            await fsPromises.mkdir(filePath, options);
+        },
+        rmdir: fsPromises.rmdir,
+        rename: fsPromises.rename
+    };
+}
+function createEmptyMetrics() {
+    return {
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        totalCachedTokens: 0,
+        tasksCompleted: 0,
+        tasksFailed: 0,
+        stepsCompleted: 0
+    };
+}
+function needsPipelineInit(planContent) {
+    try {
+        return parsePlan(planContent).tasks.length === 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message === "Invalid plan YAML: expected a top-level object." ||
+            message === 'Invalid plan YAML: expected "tasks" to be an array.') {
+            return true;
+        }
+        throw error;
+    }
+}
+function withPipelineTimeoutRetries(runAgent) {
+    return async (input) => {
+        for (let attempt = 1; attempt <= PIPELINE_ACTIVITY_TIMEOUT_RETRY_COUNT; attempt += 1) {
+            try {
+                return await runAgent(input);
+            }
+            catch (error) {
+                if (!isActivityTimeoutError(error) ||
+                    attempt === PIPELINE_ACTIVITY_TIMEOUT_RETRY_COUNT) {
+                    throw error;
+                }
+            }
+        }
+        throw new Error("Unreachable");
+    };
+}
 export async function runPipeline(options) {
-    const runAgent = options.runAgent ?? (async (input) => {
+    const fs = options.fs ?? createDefaultFs();
+    const runAgent = withPipelineTimeoutRetries(options.runAgent ?? (async (input) => {
         return await sdkSpawn.autonomous(input.agent, {
             prompt: input.prompt,
             cwd: input.cwd,
             logDir: input.logDir,
             model: input.model,
             mode: input.mode,
+            maxTimeoutRetries: 1,
             ...(input.mcpServers ? { mcpServers: input.mcpServers } : {}),
             ...(input.signal ? { signal: input.signal } : {})
         });
+    }));
+    const planPath = await resolvePlanPath({
+        cwd: options.cwd,
+        homeDir: options.homeDir,
+        plan: options.plan,
+        planDirectory: options.planDirectory,
+        assumeYes: options.assumeYes,
+        fs,
+        selectPlan: options.selectPlan,
+        promptForPath: options.promptForPath
     });
+    if (!planPath) {
+        return {
+            stopReason: "cancelled",
+            planPath: "",
+            runsCompleted: 0,
+            totalDurationMs: 0,
+            metrics: createEmptyMetrics()
+        };
+    }
+    const absolutePlanPath = resolveAbsolutePlanPath(planPath, options.cwd, options.homeDir);
+    const planContent = await fs.readFile(absolutePlanPath, "utf8");
+    if (needsPipelineInit(planContent)) {
+        const initResult = await runPipelineInit({
+            agent: options.agent,
+            ...(options.model ? { model: options.model } : {}),
+            cwd: options.cwd,
+            homeDir: options.homeDir,
+            fs,
+            sources: [
+                {
+                    absolutePath: absolutePlanPath,
+                    relativePath: planPath,
+                    title: path.basename(planPath, path.extname(planPath))
+                }
+            ],
+            assumeYes: options.assumeYes ?? false,
+            runAgent,
+            ...(options.signal ? { signal: options.signal } : {})
+        });
+        if (initResult.stopReason === "cancelled") {
+            return {
+                stopReason: "cancelled",
+                planPath,
+                runsCompleted: 0,
+                totalDurationMs: 0,
+                metrics: createEmptyMetrics()
+            };
+        }
+        if (initResult.stopReason === "failed") {
+            throw new Error(`Pipeline init failed for "${planPath}".`);
+        }
+        const initializedPlanContent = await fs.readFile(absolutePlanPath, "utf8");
+        if (needsPipelineInit(initializedPlanContent)) {
+            throw new Error(`Pipeline init did not produce runnable tasks for "${planPath}".`);
+        }
+    }
     return runWorkspacePipeline({
         ...options,
+        fs,
+        plan: planPath,
         runAgent
     });
 }
 export async function runPipelineInit(options) {
+    const fs = options.fs ?? createDefaultFs();
     const runAgent = options.runAgent ?? (async (input) => {
         return await sdkSpawn.autonomous(input.agent, {
             prompt: input.prompt,
@@ -40,11 +163,6 @@ export async function runPipelineInit(options) {
             sourcesProcessed: 0
         };
     }
-    const planDirectory = resolveWorkspacePlanDirectory({
-        cwd: options.cwd,
-        homeDir: options.homeDir,
-        planDirectory: options.planDirectory ?? ".poe-code/pipeline/plans"
-    });
     let sourcesProcessed = 0;
     const totalSources = options.sources.length;
     for (const [sourceIndex, source] of options.sources.entries()) {
@@ -57,7 +175,7 @@ export async function runPipelineInit(options) {
         const displayIndex = sourceIndex + 1;
         try {
             options.onSourceStart?.(source, displayIndex, totalSources);
-            const sourceDocContent = await fsPromises.readFile(source.absolutePath, "utf8");
+            const sourceDocContent = await fs.readFile(source.absolutePath, "utf8");
             if (options.signal?.aborted) {
                 return {
                     stopReason: "cancelled",
@@ -66,7 +184,6 @@ export async function runPipelineInit(options) {
             }
             const prompt = buildPipelineInitPrompt({
                 question: options.question,
-                planDirectory,
                 sourceDocPath: source.relativePath,
                 sourceDocContent,
                 skillContent: pipelineSkillPlan

package/dist/sdk/pipeline.js.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/sdk/pipeline.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pipeline.js","sourceRoot":"","sources":["../../src/sdk/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/templates/pipeline/SKILL_plan.md

@@ -12,10 +12,10 @@ Ask the user for a one-sentence description of what they want to build.
 Write a markdown pipeline plan with YAML frontmatter. Before writing, determine where to place it:
 
 1. Write the plan to `docs/plans/plan-<name>.md` by default.
-2. Find the `steps.yaml` file. Check these locations in order and use the first one found:
-   a. `<project-root>/.poe-code/pipeline/steps.yaml` (project-level)
-   b. `~/.poe-code/pipeline/steps.yaml` (user-global)
-   If found, read it to determine available steps and note any `setup`/`teardown` hooks defined there. If not found in either location, use stepless tasks.
+2. Find named step configs in `.poe-code/pipeline/steps/`.
+   a. Check `<project-root>/.poe-code/pipeline/steps/` first.
+   b. If that directory does not exist, check `~/.poe-code/pipeline/steps/`.
+   c. Read the available `*.yaml` files there (for example `default.yaml`, `fast.yaml`). Use `default` when the user does not ask for a different config. If no directory exists, use stepless tasks.
 3. Decide what belongs in the markdown body. If the user already has a Markdown design/context doc (for example in `docs/plans/`), use that content as the plan body when it makes sense. If they want to keep the source doc separate, link it via `vars` so it is available in every prompt without repeating the path.
 
 ## Rules
@@ -24,12 +24,14 @@ Write a markdown pipeline plan with YAML frontmatter. Before writing, determine
 - Do not create tasks that depend on hidden state from previous tasks.
 - Use short kebab-case ids.
 - Keep titles concise and descriptive.
-- The available steps come from the `steps.yaml` file you found (project or global). Use the current step names instead of inventing hardcoded ones.
-- If no step configuration is present, use stepless tasks with scalar `status: open`.
+- The available steps come from the named step config you found in `.poe-code/pipeline/steps/`. Use the current step names instead of inventing hardcoded ones.
+- Always write `extends: <name>` in the frontmatter. Use `default` unless you discovered or intentionally chose another named config.
+- If no step configuration directory is present, use stepless tasks with scalar `status: open`.
 - If step configuration is present, start every configured step status at `open`.
-- `setup` and `teardown` defined in `steps.yaml` are inherited automatically.
+- `setup` and `teardown` from the extended step config are inherited automatically.
 - To disable an inherited hook for a specific plan, set `setup: false` or `teardown: false`.
-- To override an inherited hook, define the full block with an `prompt` field.
+- To override an inherited hook, define the full block with a `prompt` field.
+- Use the plan-level `steps:` block only for per-plan step overrides. Override only the fields you need; unset fields inherit from the extended config.
 - If the user keeps an existing Markdown plan document as a separate file, add a `vars` block with a `plan_doc` key pointing to the file path. The pipeline runtime reads the file and makes its contents available as a named placeholder in every prompt.
 - `vars` values are plain strings. Use the `file` include syntax inside a value to load a file at runtime (path relative to project root): write `var_name: "` followed by the file include tag and a closing `"`.
 - Each var name becomes a double-curly-brace placeholder usable in any task, step, setup, or teardown prompt.
@@ -44,6 +46,7 @@ Write a markdown pipeline plan with YAML frontmatter. Before writing, determine
 $schema: https://poe-platform.github.io/poe-code/schemas/plans/pipeline.schema.json
 kind: pipeline
 version: 1
+extends: default
 
 # vars: optional. Define named values available as double-curly-brace placeholders in every prompt.
 # Each value is a plain string. To load a file at runtime, write the value using the
@@ -52,9 +55,19 @@ version: 1
 #
 # vars:
 #   plan_doc: "(file include for docs/plans/my-feature.md)"  # loaded at runtime
-#   env: production                                           # literal string
+#   env: production                                            # literal string
 
-# setup/teardown are inherited from steps.yaml automatically.
+# Optional per-plan step overrides. Unset fields inherit from the extended config.
+# Omit this block when the base config already fits.
+#
+# steps:
+#   implement:
+#     prompt: |
+#       Focus on the risky auth paths first.
+#   test:
+#     mode: read
+
+# setup/teardown are inherited from the extended step config automatically.
 # Include them only to disable or override:
 #
 # setup: false              # disable the inherited setup hook
@@ -69,9 +82,9 @@ tasks:
     prompt: |
       Improve auth validation and session handling.
       # If vars defines plan_doc, reference it here using the double-curly-brace placeholder syntax.
-    # scalar when no steps.yaml steps are defined:
+    # scalar when no step config is available:
     status: open
-    # stepped when steps.yaml defines steps:
+    # stepped when the extended config defines steps:
     # status:
     #   implement: open
     #   test: open
@@ -91,5 +104,5 @@ Run `poe-code pipeline validate <path>` to check the plan is valid before runnin
 
 ## Notes
 
-- Match the uncommented step names and order from whichever `steps.yaml` file you find.
+- Match the uncommented step names and order from the named step config you choose.
 - If `poe-code` is not available as a global command, use `npx poe-code` instead.

package/dist/templates/pipeline/steps.yaml.mustache

@@ -1,4 +1,7 @@
-# Edit this file to define Pipeline steps.
+# Edit this file to define the default named Pipeline step config.
+# Save additional named configs alongside it in the same directory, for example:
+#   .poe-code/pipeline/steps/default.yaml
+#   .poe-code/pipeline/steps/fast.yaml
 # Leave it comment-only to keep the default no-step behavior.
 # Uncomment and change the example below when you want stepped tasks.
 # Add `mode` only when you want to override the default `yolo`.
@@ -6,7 +9,7 @@
 # Use {{file 'path'}} in any prompt to inline the contents of a Markdown file (relative to project root).
 #
 # Optional: setup runs once before any tasks, teardown runs once after all complete.
-# These can also be defined in plan.md to override the defaults below.
+# These can also be defined in the plan frontmatter to override the defaults below.
 #
 # setup:
 #   prompt: Prepare the workspace

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poe-code",
-  "version": "3.0.183",
+  "version": "3.0.184",
   "description": "CLI tool to configure Poe API for developer workflows.",
   "type": "module",
   "main": "./dist/index.js",

package/packages/design-system/dist/dashboard/components/stats-pane.js

@@ -38,9 +38,10 @@ export function statsToLines(stats, width) {
     }
     const mutedStyle = getToneStyle("muted");
     const totalTokens = stats.tokensIn + stats.tokensOut;
+    const iterationsLabel = stats.iterationsLabel ?? "Iteration";
     const lines = [
         createKeyValueLine("Status", formatStatus(stats.status), width, getStatusStyle(stats.status)),
-        createKeyValueLine("Iteration", formatNumber(stats.iterations), width),
+        createKeyValueLine(iterationsLabel, formatNumber(stats.iterations), width),
         createKeyValueLine("Elapsed", formatElapsed(stats.elapsedMs), width),
         createBlankLine(),
         createKeyValueLine("Tokens In", formatNumber(stats.tokensIn), width),

package/packages/design-system/dist/dashboard/types.d.ts

@@ -7,6 +7,7 @@ export type OutputItem = {
 export type DashboardStats = {
     status: "idle" | "running" | "paused" | "done" | "error";
     iterations: number;
+    iterationsLabel?: string;
     tokensIn: number;
     tokensOut: number;
     elapsedMs: number;