lastlight-workflow-engine 0.1.0

package/dist/ports/ports.d.ts

@@ -0,0 +1,233 @@
+/**
+ * The workflow engine's injected ports — the concrete couplings the app layer
+ * supplies so the engine stays domain-agnostic (no imports of `../engine`,
+ * `../state`, `../notify`, `../admin`, `../config`, GitHub, or better-sqlite3).
+ *
+ * The app's existing concrete types already satisfy these structurally, so
+ * introducing each port is a type-only change: the default adapters (built in
+ * `src/workflows/runner.ts`) are thin delegations to the real functions.
+ */
+import type { ExecutorConfig, ExecutionResult, GitSandboxAccess, CommandSpec } from "../core/types.js";
+import type { PhaseDefinition } from "../core/schema.js";
+import type { DagNode } from "../core/dag.js";
+import type { TemplateContext } from "../core/templates.js";
+import type { ParsedVerdict } from "../core/verdict.js";
+/** Lifecycle state of a single checklist step. */
+export type StepStatus = "pending" | "running" | "done" | "blocked" | "awaiting" | "failed" | "skipped";
+/** One row in the task list. `key` is stable; `label` is what humans see. */
+export interface ProgressStep {
+    key: string;
+    label: string;
+    status: StepStatus;
+    /** Optional one-line context shown after the label (e.g. a link or status). */
+    detail?: string;
+}
+export interface PhaseResult {
+    phase: string;
+    success: boolean;
+    output: string;
+    error?: string;
+}
+export interface WorkflowResult {
+    success: boolean;
+    phases: PhaseResult[];
+    prNumber?: number;
+    paused?: boolean;
+}
+/** The delta a single `execute(node, outputs)` returns to the scheduler. */
+export interface PhaseOutcome {
+    results: PhaseResult[];
+    status: "succeeded" | "failed" | "skipped";
+    /** Approval / reply gate hit — scheduler returns `{ success: true, paused: true }`. */
+    paused?: boolean;
+    /**
+     * Dedup running-skip — another instance is mid-flight on this exact phase.
+     * Scheduler stops the whole run immediately with `success: false` and does
+     * NOT cascade skips (it isn't a phase failure).
+     */
+    aborted?: boolean;
+    /** Output map additions to merge into the scheduler's accumulated outputs. */
+    outputVars?: Record<string, unknown>;
+}
+export interface AgentRunOpts {
+    taskId?: string;
+    githubAccess?: GitSandboxAccess;
+    onSessionId?: (sessionId: string) => void;
+    timeoutSeconds?: number;
+    sandboxEnv?: Record<string, string>;
+    writeSession?: boolean;
+}
+/**
+ * Replaces the direct `executeAgent` / `executeCommand` imports in the phase
+ * executor. Signatures mirror `src/engine/agent-executor.ts`.
+ */
+export interface AgentPort {
+    runAgent(prompt: string, config: ExecutorConfig, opts: AgentRunOpts): Promise<ExecutionResult>;
+    runCommand(spec: CommandSpec, config: ExecutorConfig, opts: AgentRunOpts): Promise<ExecutionResult>;
+}
+export interface PhaseHistoryEntry {
+    phase: string;
+    timestamp: string;
+    success: boolean;
+    summary?: string;
+}
+/** A non-agent phase marker folded into an atomic lifecycle op. */
+export interface PhaseMarker {
+    phase: string;
+    summary?: string;
+}
+/** The subset of a workflow run the engine reads. */
+export interface WorkflowRunView {
+    status: "running" | "paused" | "succeeded" | "failed" | "cancelled";
+    scratch?: Record<string, unknown>;
+}
+/** The approval row the engine asks the store to create when pausing. */
+export interface NewApproval {
+    id: string;
+    workflowRunId: string;
+    gate: string;
+    summary: string;
+    kind: "approve" | "reply";
+    artifact?: string;
+    requestedBy?: string;
+    createdAt: string;
+}
+/** The row the engine records when a phase starts. */
+export interface NewExecution {
+    id: string;
+    triggerType: "webhook" | "cron" | "chat" | "api";
+    triggerId: string;
+    skill: string;
+    repo?: string;
+    issueNumber?: number;
+    startedAt: string;
+    workflowRunId?: string;
+}
+/** The fields the engine records when a phase finishes. */
+export interface ExecutionFinish {
+    success: boolean;
+    error?: string;
+    turns?: number;
+    durationMs?: number;
+    sessionId?: string;
+    costUsd?: number;
+    inputTokens?: number;
+    cacheCreationInputTokens?: number;
+    cacheReadInputTokens?: number;
+    outputTokens?: number;
+    apiDurationMs?: number;
+    stopReason?: string;
+    extensionStatus?: string;
+    skillsStatus?: string;
+}
+export interface FinishOpts {
+    error?: string;
+    terminalMarker?: PhaseMarker;
+}
+export interface RunStore {
+    getRun(id: string): WorkflowRunView | null;
+    appendPhase(id: string, phase: string, entry: PhaseHistoryEntry): void;
+    finishRun(id: string, status: "succeeded" | "failed" | "cancelled", opts?: FinishOpts): void;
+    mergeScratch(id: string, patch: Record<string, unknown>): void;
+    pauseForApproval(runId: string, approval: NewApproval, marker: PhaseMarker, scratchPatch?: Record<string, unknown>): void;
+}
+export interface ExecutionLedger {
+    shouldRunPhase(dedupKey: string, triggerId: string, workflowRunId?: string): "run" | "running" | "done";
+    markStaleAsFailed(dedupKey: string, triggerId: string, workflowRunId?: string): number;
+    markLatestAsFailed(dedupKey: string, triggerId: string, reason: string, workflowRunId?: string): number;
+    recordStart(row: NewExecution): void;
+    recordFinish(id: string, result: ExecutionFinish): void;
+    recordSessionId(id: string, sessionId: string): void;
+    recordOutputText(id: string, text: string): void;
+    recordSkippedPhase(dedupKey: string, triggerId: string, workflowRunId?: string, repo?: string): void;
+    getPhaseOutput(dedupKey: string, triggerId: string, workflowRunId?: string): string | null;
+    getExecutionOutput(id: string): string | null;
+}
+export interface WorkflowStateStore {
+    runs: RunStore;
+    executions: ExecutionLedger;
+}
+export interface AssetLoader {
+    loadPromptTemplate(relativePath: string): string;
+    resolveSkillPaths(names: readonly string[]): string[];
+}
+export interface LivenessPort {
+    isPhaseContainerAlive(taskId: string): Promise<boolean>;
+}
+export interface EngineSpan {
+    addEvent(name: string, attrs?: Record<string, unknown>): void;
+    setAttributes(attrs: Record<string, unknown>): void;
+}
+export interface ObservabilityPort {
+    withSpan<T>(name: string, attrs: Record<string, unknown>, fn: (span?: EngineSpan) => Promise<T> | T): Promise<T>;
+    recordExecutionMetrics(surface: string, attrs: Record<string, unknown>): void;
+    recordError(surface: string, error: unknown, attrs: Record<string, unknown>): void;
+}
+export interface ReportStepOpts {
+    label?: string;
+    insertBefore?: string;
+    insert?: boolean;
+    alsoNote?: boolean;
+}
+/** Progress / notification surface — the reporting collaborator. */
+export interface PhaseReporter {
+    onStart(phase: string): Promise<void>;
+    onEnd(phase: string, result: PhaseResult): Promise<void>;
+    /** Transition a checklist step (and optionally render a YAML message detail). */
+    step(key: string, status: StepStatus, template?: string, extraCtx?: Partial<TemplateContext>, opts?: ReportStepOpts): Promise<void>;
+    /** Render a YAML message template and post it as a standalone note. */
+    message(template: string | undefined, extraCtx?: Partial<TemplateContext>): Promise<void>;
+    /**
+     * Render a YAML message template and post it as an *interactive approval
+     * prompt* (Approve/Reject buttons on rich surfaces, plain text elsewhere).
+     */
+    approvalNote(template: string | undefined, extraCtx: Partial<TemplateContext>, meta: {
+        workflowRunId: string;
+    }): Promise<void>;
+    /** Post a pre-rendered standalone message. */
+    postNote(text: string): Promise<void>;
+    /** Persist a phase-history entry on the workflow run. */
+    persistPhase(phase: string, summary?: string): void;
+    /** Mark the workflow run failed. */
+    failWorkflow(errorMsg?: string): void;
+    /** Set (or clear) the trailing footer of the single status surface. */
+    footer(markdown: string): Promise<void>;
+    /** Post the run's completion message (terminal-ping surfaces only). */
+    noteTerminal(markdown: string): Promise<void>;
+}
+/** Model / variant / prompt / gate resolution — the resolution collaborator. */
+export interface PhaseResolver {
+    modelFor(taskType: string): string | undefined;
+    variantFor(taskType: string): string | undefined;
+    renderPrompt(promptPath: string, extraCtx?: Partial<TemplateContext>): string;
+    gateEnabled(gateName: string | undefined): boolean;
+}
+/**
+ * Reads the reviewer's authoritative verdict from its on-disk artifact
+ * (`reviewer-verdict.md`, in the server-mode build-asset store or the committed
+ * host checkout) when the stdout `VERDICT:` marker is missing. App-coupled
+ * (filesystem + build-asset store), so it's injected. Absent ⇒ the reviewer
+ * loop's file-fallback recovery simply no-ops (the "no recoverable verdict"
+ * path), which is safe.
+ */
+export interface VerdictArtifactReader {
+    read(input: {
+        config: ExecutorConfig;
+        repo: string;
+        issueDir: string;
+        taskId: string;
+    }): ParsedVerdict | undefined;
+}
+export interface PhaseTypeHandler {
+    execute(phase: PhaseDefinition, node: DagNode, outputs: Readonly<Record<string, unknown>>): Promise<PhaseOutcome>;
+}
+export interface EnginePorts {
+    agent: AgentPort;
+    assets: AssetLoader;
+    liveness: LivenessPort;
+    observability: ObservabilityPort;
+    /** Reviewer verdict-artifact fallback reader (see {@link VerdictArtifactReader}). */
+    verdictReader?: VerdictArtifactReader;
+    /** App-registered handlers for non-generic phase types (e.g. post-review). */
+    handlers?: Map<string, PhaseTypeHandler>;
+}

package/dist/ports/ports.js

@@ -0,0 +1,11 @@
+/**
+ * The workflow engine's injected ports — the concrete couplings the app layer
+ * supplies so the engine stays domain-agnostic (no imports of `../engine`,
+ * `../state`, `../notify`, `../admin`, `../config`, GitHub, or better-sqlite3).
+ *
+ * The app's existing concrete types already satisfy these structurally, so
+ * introducing each port is a type-only change: the default adapters (built in
+ * `src/workflows/runner.ts`) are thin delegations to the real functions.
+ */
+export {};
+//# sourceMappingURL=ports.js.map

package/dist/ports/ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ports.js","sourceRoot":"","sources":["../../src/ports/ports.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/test-support/fakes.d.ts

@@ -0,0 +1,86 @@
+/**
+ * In-memory fakes for the workflow engine's injected ports — no docker, git,
+ * sqlite, or filesystem. They let a consumer (the app's unit tests, an external
+ * eval harness, or another codebase embedding the engine) drive a real workflow
+ * run with scripted agent outcomes.
+ *
+ * Engine-pure: imports only the port interfaces + core types.
+ */
+import type { AgentPort, AgentRunOpts, AssetLoader, ExecutionLedger, LivenessPort, ObservabilityPort, PhaseReporter, PhaseResult, RunStore, StepStatus, WorkflowStateStore } from "../ports/ports.js";
+import type { CommandSpec, ExecutionResult, ExecutorConfig } from "../core/types.js";
+export interface RecordedAgentCall {
+    kind: "agent" | "command";
+    prompt?: string;
+    spec?: CommandSpec;
+    config: ExecutorConfig;
+    opts: AgentRunOpts;
+}
+/**
+ * Records every `{prompt|spec, config, opts}` and returns scripted
+ * `ExecutionResult`s (a queue, or a single default). Mirrors the app's
+ * `FakeSandbox` shape.
+ */
+export declare class FakeAgentPort implements AgentPort {
+    readonly calls: RecordedAgentCall[];
+    private queue;
+    private fallback;
+    constructor(fallback?: ExecutionResult);
+    /** Script the next N results (consumed FIFO). */
+    script(...results: ExecutionResult[]): this;
+    private next;
+    runAgent(prompt: string, config: ExecutorConfig, opts: AgentRunOpts): Promise<ExecutionResult>;
+    runCommand(spec: CommandSpec, config: ExecutorConfig, opts: AgentRunOpts): Promise<ExecutionResult>;
+}
+/**
+ * Map-backed {@link WorkflowStateStore} — the resume/dedup ledger + run store,
+ * with no better-sqlite3. Reproduces the production resume caveat: a phase whose
+ * ledger row is already `success=1` returns `"done"` from
+ * {@link ExecutionLedger.shouldRunPhase}, so the engine skips it (and it
+ * contributes nothing to the in-memory `outputs` map).
+ */
+export declare class InMemoryStateStore implements WorkflowStateStore {
+    private runsById;
+    private ledger;
+    private byExecId;
+    constructor(runId?: string);
+    private ensureRun;
+    readonly runs: RunStore;
+    readonly executions: ExecutionLedger;
+}
+export interface RecordedStep {
+    key: string;
+    status: StepStatus;
+    template?: string;
+}
+/** A {@link PhaseReporter} that records everything and posts nowhere. */
+export declare class RecordingReporter implements PhaseReporter {
+    readonly steps: RecordedStep[];
+    readonly notes: string[];
+    readonly persisted: {
+        phase: string;
+        summary?: string;
+    }[];
+    readonly failures: string[];
+    readonly ends: PhaseResult[];
+    onStart(): Promise<void>;
+    onEnd(_phase: string, result: PhaseResult): Promise<void>;
+    step(key: string, status: StepStatus, template?: string): Promise<void>;
+    message(template: string | undefined): Promise<void>;
+    approvalNote(template: string | undefined): Promise<void>;
+    postNote(text: string): Promise<void>;
+    persistPhase(phase: string, summary?: string): void;
+    failWorkflow(errorMsg?: string): void;
+    footer(markdown: string): Promise<void>;
+    noteTerminal(markdown: string): Promise<void>;
+}
+/** Returns a deterministic stub template per path + no skill paths. */
+export declare class StubAssetLoader implements AssetLoader {
+    private readonly templates;
+    constructor(templates?: Record<string, string>);
+    loadPromptTemplate(relativePath: string): string;
+    resolveSkillPaths(names: readonly string[]): string[];
+}
+/** Liveness port that never sees a live container (the test default). */
+export declare const noopLiveness: LivenessPort;
+/** Observability port that runs the span body directly and drops metrics. */
+export declare const noopObservability: ObservabilityPort;

package/dist/test-support/fakes.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "lastlight-workflow-engine",
+  "version": "0.1.0",
+  "description": "Port-driven workflow engine extracted from Last Light — DAG scheduler, phase executor, DSL/schema, template + loop constructs.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./test-support": {
+      "types": "./dist/test-support/fakes.d.ts",
+      "import": "./dist/test-support/fakes.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.12"
+  },
+  "dependencies": {
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "dependency-cruiser": "^18.1.0",
+    "typescript": "^5.7.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && pnpm run lint:boundaries",
+    "lint:boundaries": "depcruise --config .dependency-cruiser.cjs src"
+  }
+}