@selesai/code 0.9.13 → 0.9.15

package/dist/extensions/workflow/modes.ts

@@ -1,107 +0,0 @@
-// ponytail: workflow mode registry over pi-subagents' public workflowScript seam.
-// A mode returns launch parameters; the extension owns slash-command plumbing.
-
-import type { SubagentParamsLike } from "../pi-subagents/src/runs/foreground/subagent-executor.ts";
-
-export interface WorkflowMode {
-	command: string;
-	description: string;
-	launch(goal: string): Pick<SubagentParamsLike, "workflowScript" | "chain" | "tasks" | "concurrency">;
-}
-
-function js(value: string): string {
-	return JSON.stringify(value);
-}
-
-// A loop depends on the previous review's output, so it belongs in pi-subagents'
-// scripted workflow runtime rather than a fixed native chain.
-const AUTO_LOOP = String.raw`
-const autoLoop = async (goal, context, progressFile) => {
-  emit({ phase: 'start', goal });
-  let round = 1;
-  let previousReview = '';
-  let completed = 0;
-  while (true) {
-    try {
-      const build = await runs.run('build-' + round, {
-        agent: 'builder',
-        timeoutMs: 45 * 60 * 1000,
-        task: 'Implement the next bounded step of the approved work in the workspace and run relevant checks. Work on one small, self-contained slice this round; do not attempt the whole plan.\n\nSource of truth (handoff/plan):\n' + context + '\n\nGoal:\n' + goal + (round > 1 ? '\n\nPrevious review (its findings were addressed in the fix round; use its "Remaining work" notes to pick your next slice, do not re-apply findings):\n' + previousReview : '') + '\n\nRead the progress file first for prior-round context.\n\nProgress ledger: append a "## Round ' + round + '" entry to the progress file at ' + progressFile + ' before finishing. List every file you changed and a short summary of the work.',
-      });
-      const review = await runs.run('review-' + round, {
-        agent: 'commentator',
-        timeoutMs: 15 * 60 * 1000,
-        task: 'Independently review the builder work for this round and report concrete evidence (what you inspected and what you ran). Do not modify the workspace.\n\nAcceptance criteria (source of truth):\n' + context + '\n\nProgress file (scope your review to its latest round entry; also re-check the files from the immediately preceding fix entry if one exists; fall back to the full uncommitted diff if it is missing or empty):\n' + progressFile + '\n\nBuilder completion summary:\n' + build.output + '\n\nIf the plan is not yet complete, add a "Remaining work:" section listing the next concrete step(s). End with exactly one line: WORKFLOW_REVIEW_STATUS: clean OR WORKFLOW_REVIEW_STATUS: blocking.',
-      });
-      const hasRemainingWork = /Remaining work\s*:\s*\S/i.test(review.output);
-      if (/WORKFLOW_REVIEW_STATUS\s*:\s*clean/i.test(review.output) && !hasRemainingWork) {
-        return { result: 'clean', rounds: completed + 1 };
-      }
-      previousReview = review.output;
-      await runs.run('fix-' + round, {
-        agent: 'builder',
-        timeoutMs: 45 * 60 * 1000,
-        task: 'Address ONLY the findings from the review below. The "Remaining work:" section (if present) is for the next round; do not act on it. If the review is clean but has Remaining work, make no changes and record that fact.\n\nProgress ledger: append a "## Round ' + round + ' fix" entry to the progress file at ' + progressFile + ' before finishing. List every file you changed and a short summary of the fixes.\n\nReviewer findings:\n' + review.output,
-      });
-      completed += 1;
-      round += 1;
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      if (/Run fan-out limit reached/i.test(message)) {
-        return { result: 'budget', rounds: completed, note: 'Run fan-out budget exhausted before the goal was reached. The progress file is current.' };
-      }
-      throw error;
-    }
-  }
-};`;
-
-const PROGRESS_DIR = ".pi-subagents/progress/";
-
-export function buildLoopScript(goal: string): string {
-	return String.raw`const goal = ${js(goal)};
-${AUTO_LOOP}
-return await autoLoop(goal, goal, ${js(PROGRESS_DIR + "loop.md")});`;
-}
-
-export function buildTaskScript(goal: string): string {
-	return String.raw`const goal = ${js(goal)};
-const plan = await runs.run('plan', { agent: 'architect', task: 'Produce a concrete implementation plan for: ' + goal + '. Cover what to build, how, in what order, which files and components, and the finished result. Return inline.' });
-const reuse = await runs.run('reuse', { agent: 'explorer', task: 'Explore the codebase for reusable patterns relevant to: ' + plan.output + '. Point at relevant areas and dependencies; skip cleanly if wholly new. Return inline.' });
-const handoff = await runs.run('handoff', { agent: 'recapper', task: 'Compile a self-contained handoff from the plan and reuse findings so fresh agents understand the goal, constraints, and acceptance criteria without re-planning.\n\nPlan:\n' + plan.output + '\n\nReuse findings:\n' + reuse.output + '\n\nReturn inline.' });
-${AUTO_LOOP}
-return await autoLoop(goal, handoff.output, ${js(PROGRESS_DIR + "task.md")});`;
-}
-
-export function buildPrototypeScript(goal: string): string {
-	return String.raw`const goal = ${js(goal)};
-const discovery = await runs.all([
-  { key: 'research', agent: 'researcher', task: 'Research the external, fast-changing knowledge this task depends on (libraries, SDKs, APIs, unfamiliar alternatives). Task: ' + goal + '. Synthesize actionable findings with sources. Return inline.' },
-  { key: 'explore', agent: 'explorer', task: 'Map existing code, dependencies, and reusable patterns relevant to: ' + goal + '. Return inline.' },
-]);
-const research = discovery.find(result => result.key === 'research');
-const reuse = discovery.find(result => result.key === 'explore');
-const plan = await runs.run('plan', { agent: 'architect', task: 'Produce a concrete build plan from the research and codebase findings.\n\nResearch:\n' + research.output + '\n\nCodebase findings:\n' + reuse.output + '\n\nRequest:\n' + goal + '\n\nReturn inline.' });
-const handoff = await runs.run('handoff', { agent: 'recapper', task: 'Compile a self-contained handoff from the plan and reuse findings.\n\nPlan:\n' + plan.output + '\n\nReuse:\n' + reuse.output + '\n\nReturn inline.' });
-${AUTO_LOOP}
-const loop = await autoLoop(goal, handoff.output, ${js(PROGRESS_DIR + "prototype.md")});
-const audit = await runs.run('audit', { agent: 'commentator', task: 'Final audit of the uncommitted changes for correctness, plan adherence, and over-engineering (cut bloat, dead flexibility, reinvented stdlib). Plan:\n' + plan.output + '\n\nReport concrete evidence. Do not modify the workspace.' });
-return { ...loop, audited: true };`;
-}
-
-export function buildQuicktypeScript(goal: string): string {
-	return String.raw`const goal = ${js(goal)};
-const plan = await runs.run('plan', { agent: 'architect', task: 'Produce a concrete build plan for: ' + goal + '. Cover what to build, how, in what order, which components, and the finished result. Return inline.' });
-const reuse = await runs.run('reuse', { agent: 'explorer', task: 'Explore the codebase for reusable patterns relevant to: ' + plan.output + '. Return inline.' });
-const handoff = await runs.run('handoff', { agent: 'recapper', task: 'Compile a self-contained handoff from the plan and reuse findings.\n\nPlan:\n' + plan.output + '\n\nReuse:\n' + reuse.output + '\n\nReturn inline.' });
-${AUTO_LOOP}
-const loop = await autoLoop(goal, handoff.output, ${js(PROGRESS_DIR + "quicktype.md")});
-const audit = await runs.run('audit', { agent: 'commentator', task: 'Final audit of the uncommitted changes for correctness, plan adherence, and over-engineering (cut bloat, dead flexibility, reinvented stdlib). Plan:\n' + plan.output + '\n\nReport concrete evidence. Do not modify the workspace.' });
-return { ...loop, audited: true };`;
-}
-
-export const WORKFLOW_MODES: readonly WorkflowMode[] = [
-	{ command: "workflow-task", description: "Run the task workflow (plan → reuse → handoff → build/review/fix loop).", launch: (goal) => ({ workflowScript: buildTaskScript(goal) }) },
-	{ command: "workflow-prototype", description: "Run the prototype workflow (parallel research/reuse → plan → handoff → loop → audit).", launch: (goal) => ({ workflowScript: buildPrototypeScript(goal) }) },
-	{ command: "workflow-quicktype", description: "Run the quicker prototype workflow (plan → reuse → handoff → loop → audit).", launch: (goal) => ({ workflowScript: buildQuicktypeScript(goal) }) },
-	{ command: "workflow-loop", description: "Run a direct build/review/fix loop for an already-agreed plan.", launch: (goal) => ({ workflowScript: buildLoopScript(goal) }) },
-];

package/dist/extensions/workflow/package.json

@@ -1,17 +0,0 @@
-{
-	"name": "@selesai/workflow",
-	"version": "0.0.1",
-	"private": true,
-	"description": "Selesai workflow engine + modes (prototype, quick). Loaded as a bundled pi extension package.",
-	"type": "module",
-	"pi": {
-		"extensions": [
-			"./extension.ts"
-		]
-	},
-	"peerDependencies": {
-		"@selesai/code": "*",
-		"@earendil-works/pi-tui": "*",
-		"typebox": "*"
-	}
-}

package/dist/skills/workflow-creation/SKILL.md

@@ -1,73 +0,0 @@
----
-name: workflow-creation
-description: Creates durable Selesai workflow modes. Use when a user asks to create or change a workflow mode, phased agent flow, or slash-command workflow.
-disable-model-invocation: true
----
-
-# Durable Workflows
-
-**Durable** means `workflow.json`, not session history, is the run authority. Build on the shared engine in `src/extensions/workflow/`; a mode is configuration, not a second orchestrator.
-
-## 1. Choose the smallest fit
-
-Read `docs/workflows.md`, every file in `src/extensions/workflow/modes/`, and the relevant workflow tests.
-
-- Reuse `prototype`, `quick`, or `task` when its phase graph and terminal gate fit; change only its prompts/configuration.
-- Add a mode only for a materially different graph, artifact contract, or close gate.
-
-Done when the request is mapped to one existing mode or a named new mode with its phase list and terminal artifact.
-
-## 2. Trace the durable seam
-
-Before changing engine-facing behavior, read completely:
-
-- `state-machine.ts` — graph, artifact gates, terminal-ready, completion;
-- `adapter.ts` — tools, event handlers, persistence, reload guards;
-- `run-state.ts` — canonical record and resume validation;
-- `extension.ts` — single extension mounting all modes.
-
-Done when every proposed behavior has one owner: state machine, shared adapter, or mode configuration.
-
-## 3. Implement the mode
-
-For a new mode, add `src/extensions/workflow/modes/<name>.ts`, modeled on `quick.ts`, with only `WorkflowConfig` and `WorkflowModeRegistration`:
-
-- ordered phases, phase artifacts, prompts, validators, close artifacts/validators;
-- unique mode/status/entry identities and slash-command name; users start/resume through that command, while the shared end tool selects the mode;
-- prompts that name exact artifact paths and use `write_workflow_artifact` only for workflow artifacts.
-
-Register the mode once in `MODES` in `extension.ts`; document its lifecycle and commands in `docs/workflows.md`.
-
-Done when the mode file has no filesystem, persistence, event-registration, or controller code.
-
-## 4. Preserve the durable contract
-
-The shared adapter owns UUID artifact directories, atomic saves, resume, loop review state, and reload safety. Do not reimplement them per mode.
-
-- Persisted state changes after start, artifact/loop transition, resume reconciliation, and explicit end.
-- Never auto-resume on `session_start`; only a user-invoked mode command with an explicit selector attaches a run.
-- Artifact completion advances durable state then stops the parent turn; the user deliberately continues the attached mode.
-- Terminal-ready stays active. Only `end_workflow({ mode })` marks the record completed and terminates.
-- One `ExtensionAPI` hosts all modes: shared writer once, stale reload handlers inert, one attached run total.
-- Builder/reviewer loops use adapter-owned rounds, review files, markers, and max-iteration pause.
-
-Done when the new behavior preserves every applicable invariant above.
-
-## 5. Lock the mode with real seams
-
-Extend the existing fake-Pi tests; do not add another framework. Cover the real mode, not only state-machine units:
-
-- start writes valid `workflow.json`; artifact transition updates it; explicit end completes it;
-- explicit resume reconciles an artifact written before a phase save;
-- loop round/review path resumes when the mode has a loop;
-- terminal-ready does not complete early;
-- extension reload ignores stale handlers; inactive sibling modes do not react.
-
-Run the narrow mode test, then:
-
-```bash
-npx vitest run src/__tests__/state-machine.test.ts src/__tests__/adapter.test.ts src/__tests__/workflow-race.test.ts src/__tests__/workflow-run-state.test.ts src/__tests__/<mode>-workflow.test.ts
-npm run build
-```
-
-Done when those checks pass and the diff contains only the selected mode, shared-engine changes proven necessary by a failing regression, documentation, and tests.