@oisincoveney/pipeline 1.0.0

package/dist/mastra/steps/green.d.ts

@@ -0,0 +1,17 @@
+import { type AgentAdapter, type Harness } from "../runner.js";
+interface GreenOptions {
+    agentAdapter?: AgentAdapter;
+    contextFile: string | null;
+    harness: Harness;
+    maxRetries?: number;
+    prompt: string;
+    worktreePath: string;
+}
+interface GreenResult {
+    failingTests: string[];
+    greenGatePassed: boolean;
+    testOutput: string;
+    typecheckOutput: string;
+}
+export declare function runGreen(opts: GreenOptions): Promise<GreenResult>;
+export {};

package/dist/mastra/steps/knowledge-inject.d.ts

@@ -0,0 +1,12 @@
+export declare const KNOWLEDGE_CONTEXT_FILE = "knowledge-context.md";
+export declare const MAX_KNOWLEDGE_CONTEXT_CHARS = 64000;
+interface KnowledgeContextOptions {
+    maxChars?: number;
+}
+interface KnowledgeContextFile {
+    context: string;
+    contextFile: string;
+}
+export declare function buildKnowledgeContext(worktreePath: string, options?: KnowledgeContextOptions): string;
+export declare function writeKnowledgeContextFile(worktreePath: string, options?: KnowledgeContextOptions): Promise<KnowledgeContextFile>;
+export {};

package/dist/mastra/steps/learn.d.ts

@@ -0,0 +1,10 @@
+import type { GateViolation } from "../gates.js";
+interface LearnOptions {
+    outcome: "PASS" | "FAIL";
+    taskDescription: string;
+    testOutput: string;
+    violations: GateViolation[];
+    worktreePath: string;
+}
+export declare function runLearn(opts: LearnOptions): Promise<void>;
+export {};

package/dist/mastra/steps/red.d.ts

@@ -0,0 +1,17 @@
+import { type AgentAdapter, type Harness } from "../runner.js";
+interface RedOptions {
+    agentAdapter?: AgentAdapter;
+    contextFile: string | null;
+    harness: Harness;
+    maxRetries?: number;
+    prompt: string;
+    worktreePath: string;
+}
+interface RedResult {
+    failingTests: string[];
+    output: string;
+    reason: string;
+    redGatePassed: boolean;
+}
+export declare function runRed(opts: RedOptions): Promise<RedResult>;
+export {};

package/dist/mastra/steps/research.d.ts

@@ -0,0 +1,15 @@
+import { type AgentAdapter, type Harness } from "../runner.js";
+interface ResearchOptions {
+    agentAdapter?: AgentAdapter;
+    contextFile: string | null;
+    harness: Harness;
+    maxRetries?: number;
+    prompt: string;
+    worktreePath: string;
+}
+interface ResearchResult {
+    exitCode: number;
+    output: string;
+}
+export declare function runResearch(opts: ResearchOptions): Promise<ResearchResult>;
+export {};

package/dist/mastra/steps/verify.d.ts

@@ -0,0 +1,17 @@
+import type { GateViolation } from "../gates.js";
+import { type AgentAdapter, type Harness } from "../runner.js";
+interface VerifyOptions {
+    agentAdapter?: AgentAdapter;
+    contextFile: string | null;
+    harness: Harness;
+    prompt: string;
+    worktreePath: string;
+}
+interface VerifyResult {
+    llmEvidence: string[];
+    llmVerdict: "PASS" | "FAIL";
+    passed: boolean;
+    violations: GateViolation[];
+}
+export declare function runVerify(opts: VerifyOptions): Promise<VerifyResult>;
+export {};

package/dist/mastra/workflows/pipeline.d.ts

@@ -0,0 +1,70 @@
+import { z } from "zod";
+declare const withVerify: z.ZodObject<{
+    task: z.ZodString;
+    harness: z.ZodEnum<{
+        claude: "claude";
+        opencode: "opencode";
+        codex: "codex";
+        pi: "pi";
+    }>;
+    worktreePath: z.ZodString;
+    context: z.ZodString;
+    contextFile: z.ZodString;
+    researchOutput: z.ZodString;
+    redGatePassed: z.ZodBoolean;
+    redGateReason: z.ZodString;
+    redTestOutput: z.ZodString;
+    failingTests: z.ZodArray<z.ZodString>;
+    greenGatePassed: z.ZodBoolean;
+    testOutput: z.ZodString;
+    typecheckOutput: z.ZodString;
+    verifyPassed: z.ZodBoolean;
+    llmVerdict: z.ZodEnum<{
+        PASS: "PASS";
+        FAIL: "FAIL";
+    }>;
+    llmEvidence: z.ZodArray<z.ZodString>;
+    violations: z.ZodArray<z.ZodObject<{
+        file: z.ZodString;
+        message: z.ZodString;
+        line: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+declare const pipelineOutput: z.ZodObject<{
+    outcome: z.ZodEnum<{
+        PASS: "PASS";
+        FAIL: "FAIL";
+    }>;
+    failureDetails: z.ZodArray<z.ZodObject<{
+        gate: z.ZodEnum<{
+            RED: "RED";
+            GREEN: "GREEN";
+            VERIFY: "VERIFY";
+        }>;
+        reason: z.ZodString;
+        evidence: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type PipelineOutput = z.infer<typeof pipelineOutput>;
+type PipelineEvaluationInput = z.infer<typeof withVerify>;
+export declare function evaluatePipelineOutcome(inputData: PipelineEvaluationInput): PipelineOutput;
+export declare const pipelineWorkflow: import("@mastra/core/workflows").Workflow<import("@mastra/core/workflows").DefaultEngineType, import("@mastra/core/workflows").Step<string, unknown, unknown, unknown, unknown, unknown, any, unknown>[], "ralph-loop", unknown, {
+    task: string;
+    harness: "claude" | "opencode" | "codex" | "pi";
+    worktreePath: string;
+}, {
+    outcome: "PASS" | "FAIL";
+    failureDetails: {
+        gate: "RED" | "GREEN" | "VERIFY";
+        reason: string;
+        evidence: string[];
+    }[];
+}, {
+    outcome: "PASS" | "FAIL";
+    failureDetails: {
+        gate: "RED" | "GREEN" | "VERIFY";
+        reason: string;
+        evidence: string[];
+    }[];
+}, unknown>;
+export {};

package/docs/slash-command-adapter-contract.md

@@ -0,0 +1,74 @@
+# Slash Command Adapter Contract
+
+The reusable primitive is `runPipelinePrimitive(input, adapters)` from
+`src/mastra/pipeline-primitive.ts`. Slash-command hosts call that primitive with
+an in-process `AgentAdapter`; the shell CLI calls the same primitive with the
+subprocess adapter from `src/mastra/runner.ts`.
+
+For normal project installation, run:
+
+```sh
+bunx @oisincoveney/pipeline install-commands --host all
+```
+
+The installer writes generated command files into the current repository. Re-run
+it after package updates. It is idempotent, supports `--dry-run`, supports
+`--check`, and refuses to overwrite manually edited files unless `--force` is
+passed.
+
+## Primitive Input
+
+Slash commands must supply:
+
+- `task`: the command arguments or selected ticket text.
+- `worktreePath`: the repository root or task worktree the host is currently
+  editing.
+- `harness`: the host name, one of `claude`, `codex`, `opencode`, or `pi`.
+
+## Agent Adapter
+
+The host adapter implements:
+
+```ts
+interface AgentAdapter {
+  run(request: {
+    contextFile: string | null;
+    harness: "claude" | "codex" | "opencode" | "pi";
+    prompt: string;
+    role: "researcher" | "test-writer" | "code-writer" | "verifier";
+    worktreePath: string;
+  }): Promise<{ exitCode: number; stdout: string }>;
+}
+```
+
+The primitive owns the phase order and gates. The adapter only maps each role to
+the host's native execution mechanism.
+
+## Host Mappings
+
+| Host | Task input | Target path | Agent execution | Phase reporting |
+| --- | --- | --- | --- | --- |
+| Host | Generated file | Invocation |
+| --- | --- | --- |
+| Claude Code | `.claude/commands/work-next.md` | `/work-next <ticket id or task description>` |
+| OpenCode | `.opencode/commands/work-next.md` | `/work-next <ticket id or task description>` |
+| Pi | `.pi/prompts/work-next.md` | `/work-next <ticket id or task description>` |
+| Codex | `.agents/skills/work-next/SKILL.md` | `/use work-next <ticket id or task description>` |
+
+Codex currently does not support project-defined custom slash commands in the
+same way as Claude Code and OpenCode, so the installer generates a project skill
+instead of pretending that `/work-next` is available.
+
+## Phase Reporter
+
+Slash hosts may pass:
+
+```ts
+interface PipelinePhaseReporter {
+  started?(phase: "research" | "red" | "green" | "verify" | "learn"): void | Promise<void>;
+  completed?(phase: "research" | "red" | "green" | "verify" | "learn"): void | Promise<void>;
+}
+```
+
+Use this for native UI updates. The primitive returns the same
+`{ outcome, failureDetails }` shape used by the CLI.

package/package.json

@@ -0,0 +1,70 @@
+{
+  "dependencies": {
+    "@mastra/core": "^1.35.0",
+    "@mastra/libsql": "^1.11.0",
+    "@mastra/memory": "^1.18.2",
+    "commander": "^14.0.3",
+    "execa": "^9.5.2",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.15",
+    "@types/node": "^25.9.1",
+    "jscpd": "^4.0.5",
+    "mastra": "^1.9.3",
+    "typescript": "^6.0.3",
+    "ultracite": "7.7.0",
+    "vitest": "^3.2.0"
+  },
+  "name": "@oisincoveney/pipeline",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "oisin-pipeline": "dist/index.js",
+    "work-next": "dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./pipeline-primitive": {
+      "types": "./dist/mastra/pipeline-primitive.d.ts",
+      "import": "./dist/mastra/pipeline-primitive.js"
+    },
+    "./runner": {
+      "types": "./dist/mastra/runner.d.ts",
+      "import": "./dist/mastra/runner.js"
+    }
+  },
+  "files": [
+    ".claude/commands",
+    "dist",
+    "docs",
+    "README.md"
+  ],
+  "scripts": {
+    "build:cli": "rm -rf dist && bun build src/index.ts --outfile dist/index.js --target node && bun build src/mastra/pipeline-primitive.ts --outfile dist/mastra/pipeline-primitive.js --target node && bun build src/mastra/runner.ts --outfile dist/mastra/runner.js --target node && tsc -p tsconfig.types.json",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "work-next": "bun src/index.ts work-next",
+    "dev": "mastra dev",
+    "build": "bun run build:cli && mastra build",
+    "start": "mastra start",
+    "check": "ultracite check",
+    "fix": "ultracite fix",
+    "prepack": "bun run build:cli"
+  },
+  "type": "module",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "engines": {
+    "node": ">=22.13.0",
+    "bun": ">=1.1.0"
+  }
+}