@oisincoveney/pipeline 1.2.1 → 1.3.0

package/README.md

@@ -45,6 +45,12 @@ Run the default workflow:
 pipe run "Implement PIPE-123 user-facing behavior"
 ```
 
+Run a read-only repository inspection:
+
+```shell
+pipe run --workflow inspect "Report the app structure and available checks. Do not modify files."
+```
+
 The `pipe` binary also accepts the task directly:
 
 ```shell

package/dist/index.js

@@ -36123,6 +36123,12 @@ orchestrator:
 hooks: {}
 
 workflows:
+  inspect:
+    description: Read-only repository inspection workflow.
+    nodes:
+      - id: inspect
+        kind: agent
+        profile: pipeline-inspector
   default:
     description: Default research, red, green, verify, learn workflow.
     nodes:
@@ -36261,6 +36267,20 @@ profiles:
     output:
       format: json_schema
       schema_path: .pipeline/schemas/research.schema.json
+  pipeline-inspector:
+    runner: codex
+    description: Inspect the repository without modifying files.
+    instructions:
+      path: .pipeline/prompts/inspector.md
+    tools: [read, list, grep, glob, bash]
+    filesystem:
+      mode: read-only
+      allow: ["**/*"]
+      deny: ["node_modules/**", "dist/**", ".git/**"]
+    network:
+      mode: inherit
+    output:
+      format: text
   pipeline-test-writer:
     runner: codex
     description: Add focused failing tests for the requested behavior.
@@ -36377,6 +36397,16 @@ var SCAFFOLD_FILES = {
     "You are the research phase for the pipeline.",
     "Inspect first-party source, tests, docs, and task context before proposing changes.",
     "Write structured findings that identify relevant files, existing patterns, acceptance criteria, and risks.",
+    "Return only valid JSON matching `.pipeline/schemas/research.schema.json`: an object with `findings` and `ac` arrays, plus optional `files`, `risks`, and `target`.",
+    "Do not wrap the JSON in Markdown fences or add prose outside the JSON object.",
+    ""
+  ].join(`
+`),
+  ".pipeline/prompts/inspector.md": [
+    "You are the read-only inspection phase for the pipeline.",
+    "Inspect first-party source, tests, docs, and task context.",
+    "Report the repository structure, available checks, important files, and notable risks.",
+    "Do not modify files.",
     ""
   ].join(`
 `),
@@ -36400,6 +36430,8 @@ var SCAFFOLD_FILES = {
     "You are the VERIFY phase for the pipeline.",
     "Run configured checks, review implementation fit, and report PASS or FAIL with evidence.",
     "Do not mark the workflow passing without concrete verification evidence.",
+    "Return only valid JSON matching `.pipeline/schemas/verify.schema.json`: an object with `verdict`, `evidence`, and optional `violations`.",
+    "Do not wrap the JSON in Markdown fences or add prose outside the JSON object.",
     ""
   ].join(`
 `),
@@ -36407,6 +36439,8 @@ var SCAFFOLD_FILES = {
     "You are the LEARN phase for the pipeline.",
     "Store durable lessons from the run when useful and report qdrant-store evidence.",
     "Do not write local markdown knowledge as the durable sink.",
+    "Return only valid JSON matching `.pipeline/schemas/learn.schema.json`: an object with `qdrant` and `evidence`.",
+    "Do not wrap the JSON in Markdown fences or add prose outside the JSON object.",
     ""
   ].join(`
 `),
@@ -36882,6 +36916,7 @@ async function runJscpd(worktreePath) {
 }
 
 // src/pipeline-runtime.ts
+var LINE_RE = /\r?\n/;
 async function runPipelineFromConfig(options2) {
   const worktreePath = options2.worktreePath ?? process.cwd();
   const config2 = options2.config ?? loadPipelineConfig(worktreePath);
@@ -37037,16 +37072,74 @@ async function executeAgentNode(node, context) {
   });
   context.agentInvocations.push(plan);
   const result = await context.executor(plan);
+  const normalized = normalizeAgentOutput(plan, result.stdout);
   return {
     evidence: [
       `agent boundary node=${node.id} profile=${node.profile} runner=${plan.runnerId} strategy=${plan.strategy}`,
+      ...normalized.evidence,
       ...result.stderr ? [`stderr: ${result.stderr}`] : [],
       ...result.timedOut ? ["agent timed out"] : []
     ],
     exitCode: result.exitCode,
-    output: result.stdout
+    output: normalized.output
   };
 }
+function normalizeAgentOutput(plan, stdout) {
+  if (plan.type === "codex") {
+    const text = lastJsonLineValue(stdout, (value) => {
+      if (!isRecord(value)) {
+        return;
+      }
+      const item = value.item;
+      if (isRecord(item) && item.type === "agent_message") {
+        return typeof item.text === "string" ? item.text : undefined;
+      }
+      if (value.type === "agent_message") {
+        return typeof value.text === "string" ? value.text : undefined;
+      }
+    });
+    if (text) {
+      return {
+        evidence: ["normalized runner output from codex JSONL"],
+        output: text
+      };
+    }
+  }
+  if (plan.type === "opencode") {
+    const text = lastJsonLineValue(stdout, (value) => {
+      if (!isRecord(value)) {
+        return;
+      }
+      const part = value.part;
+      if (isRecord(part) && part.type === "text") {
+        return typeof part.text === "string" ? part.text : undefined;
+      }
+    });
+    if (text) {
+      return {
+        evidence: ["normalized runner output from opencode JSON events"],
+        output: text
+      };
+    }
+  }
+  return { evidence: [], output: stdout };
+}
+function lastJsonLineValue(text, extract) {
+  let latest;
+  for (const line of text.split(LINE_RE)) {
+    const trimmed = line.trim();
+    if (!trimmed) {
+      continue;
+    }
+    try {
+      const extracted = extract(JSON.parse(trimmed));
+      if (extracted) {
+        latest = extracted;
+      }
+    } catch {}
+  }
+  return latest;
+}
 function renderAgentPrompt(node, context) {
   const profile = node.profile ? context.config.profiles[node.profile] : undefined;
   const instructions = profile ? readInstructions(context.worktreePath, profile.instructions) : "";
@@ -37440,6 +37533,7 @@ function formatConfigError(err) {
 
 // src/index.ts
 var PATH_SEPARATOR_RE = /[\\/]/;
+var LINE_RE2 = /\r?\n/;
 function pipe2(description, options2 = {}) {
   try {
     if (!description.trim()) {
@@ -37466,11 +37560,7 @@ async function runConfiguredPipeline(inputs) {
   });
   console.log(formatRuntimeResult(result));
   if (result.outcome === "FAIL") {
-    throw new Error([
-      "Pipeline failed.",
-      ...result.failureDetails.map((failure) => failure.nodeId ? `- ${failure.nodeId}: ${failure.reason}` : `- ${failure.reason}`)
-    ].join(`
-`));
+    throw new Error(formatRuntimeFailure(result));
   }
 }
 function formatRuntimeResult(result) {
@@ -37482,6 +37572,50 @@ function formatRuntimeResult(result) {
   ].join(`
 `);
 }
+function formatRuntimeFailure(result) {
+  const lines = ["Pipeline failed."];
+  for (const failure of result.failureDetails) {
+    lines.push(failure.nodeId ? `- ${failure.nodeId}: ${failure.reason}` : `- ${failure.reason}`);
+    appendIndentedSection(lines, "Evidence", failure.evidence);
+    const node = failure.nodeId ? result.nodes.find((item) => item.nodeId === failure.nodeId) : undefined;
+    if (node) {
+      lines.push(`  Node: status=${node.status} attempts=${node.attempts} exit=${node.exitCode}`);
+      appendIndentedSection(lines, "Node evidence", node.evidence);
+      appendIndentedSection(lines, "Node output", [node.output]);
+    }
+  }
+  if (result.gates.length > 0) {
+    lines.push("Gates:");
+    for (const gate of result.gates) {
+      lines.push(`  - ${gate.nodeId}/${gate.gateId}: ${gate.passed ? "PASS" : "FAIL"}${gate.reason ? ` (${gate.reason})` : ""}`);
+      appendIndentedSection(lines, "Gate evidence", gate.evidence);
+    }
+  }
+  return lines.join(`
+`);
+}
+function appendIndentedSection(lines, label, values) {
+  const text = values.filter(Boolean).join(`
+`).trim();
+  if (!text) {
+    return;
+  }
+  lines.push(`  ${label}:`);
+  lines.push(indent(truncateMiddle(text, 4000), "    "));
+}
+function indent(text, prefix) {
+  return text.split(LINE_RE2).map((line) => `${prefix}${line}`).join(`
+`);
+}
+function truncateMiddle(text, maxLength) {
+  if (text.length <= maxLength) {
+    return text;
+  }
+  const keep = Math.floor((maxLength - 32) / 2);
+  return `${text.slice(0, keep)}
+... truncated ...
+${text.slice(-keep)}`;
+}
 function createCliProgram() {
   const program2 = new Command;
   program2.name("@oisincoveney/pipeline").description("Run and install the oisin pipeline").exitOverride();

package/docs/config-architecture.md

@@ -80,6 +80,11 @@ orchestrator:
 hooks: {}
 
 workflows:
+  inspect:
+    nodes:
+      - id: inspect
+        kind: agent
+        profile: pipeline-inspector
   default:
     nodes:
       - id: research

package/package.json

@@ -69,7 +69,7 @@
     "prepack": "bun run build:cli"
   },
   "type": "module",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "",
   "main": "index.js",
   "keywords": [],