pi-quiver 4.2.0 → 4.3.0

package/CHANGELOG.md

@@ -8,6 +8,10 @@ Published to npm as `pi-quiver` (`pi install npm:pi-quiver`). Pushing a
 via OIDC trusted publishing. The release helper at
 `.agents/skills/release/scripts/release.sh` cuts the tag; CI publishes.
 
+## v4.3.0 - 2026-08-25
+
+- fetch: GitHub Actions job URLs (`.../actions/runs/<runId>/job/<jobId>`, singular `/job/` as GitHub's UI produces) now route through `gh run view --job <jobId> --repo <slug>`; plural `/jobs/<id>` paths still fall back to plain HTTP. Both run and job fetches now make a best-effort second `gh run view ... --log-failed` call and append its output under a `## Failed step logs` heading; when nothing failed, the run is still in progress, or logs have expired, the call yields no section and behavior is unchanged (summary-only).
+
 ## v4.2.0 - 2026-08-20
 
 - fetch: data plane extracted to `lib/fetch-core.ts`; new `pi-quiver fetch` CLI (esbuild-built `dist/` bin) with full parameter parity; Claude Code skill + plugin marketplace (`quiver:fetch` via `npx -y pi-quiver@latest`). pi tool behavior unchanged.

package/README.md

@@ -62,7 +62,7 @@ A 300 KB changelog page never touches your context window - you get a preview an
 
 | Extension | Tool | What it does |
 | --- | --- | --- |
-| `extensions/fetch.ts` | `fetch` | Retrieve URLs over HTTP(S). HTML -> Markdown (Readability extraction, Turndown conversion). Binary saved untouched to a temp file. GitHub issue/PR/repo/actions-run URLs auto-route through `gh` (falls back to HTTP). Same size gate as `doc_to_md`. Behavior lives in `lib/fetch-core.ts`; also exposed as the `pi-quiver fetch` CLI (see [Claude Code support](#claude-code-support)). |
+| `extensions/fetch.ts` | `fetch` | Retrieve URLs over HTTP(S). HTML -> Markdown (Readability extraction, Turndown conversion). Binary saved untouched to a temp file. GitHub issue/PR/repo/actions-run/actions-job URLs auto-route through `gh` (falls back to HTTP); failed runs/jobs include failed-step logs (best-effort, summary-only otherwise). Same size gate as `doc_to_md`. Behavior lives in `lib/fetch-core.ts`; also exposed as the `pi-quiver fetch` CLI (see [Claude Code support](#claude-code-support)). |
 | `extensions/doc_to_md.ts` | `doc_to_md` | Convert a local PDF/DOCX/PPTX to Markdown. High-fidelity via `pymupdf4llm` (run through `uv`); degraded pure-JS fallback (`unpdf`) when `uv`/Python is unavailable or conversion times out. DOCX/PPTX convert via LibreOffice first. |
 | `extensions/session-name.ts` | `/session-name` | Manual + opt-in automatic session naming, naming rules and deny list, long-session revisits, and Ghostty tab rename. OFF by default. |
 | `extensions/sword-header.ts` | `/builtin-header` | Themed ASCII startup header replacing pi's default logo. OFF by default. |
@@ -76,7 +76,7 @@ Full routing rules, size-gate mechanics, and config: [doc/fetch.md](doc/fetch.md
 | Concept | Meaning |
 | --- | --- |
 | Size gate | Text/Markdown/JSON output over 32 KB or 1000 lines spills to a temp file with a 60-line preview instead of inlining. |
-| Content routing | HTML -> Markdown, binary -> untouched file, GitHub URLs -> `gh` CLI, everything else -> the size gate. |
+| Content routing | HTML -> Markdown, binary -> untouched file, GitHub URLs -> `gh` CLI (failed runs/jobs get failed-step logs appended), everything else -> the size gate. |
 | Graceful degradation | Optional binaries (`gh`, `uv`, LibreOffice) are never hard install-time deps; each has a defined, documented fallback or failure mode. |
 | Opt-in extensions | `session-name`, `sword-header`, `fast-mode`, and `provider-stall-watchdog` do nothing until explicitly enabled in `settings.json`. |
 | Provider stall recovery | The watchdog detects a missing first stream event and missing parsed semantic progress, not network liveness. The pre-first-event tier covers every mode and origin; the mid-stream tier is TUI-only. |
@@ -129,7 +129,7 @@ The npm package's bundled JS deps install automatically on `pi install`. A few *
 
 | Prerequisite | Needed by | If absent |
 | --- | --- | --- |
-| `gh` (GitHub CLI, installed + `gh auth login`) | `fetch` GitHub issue/PR/repo/actions-run routing | Falls back to an HTTP fetch of the rendered page (private repos hit a login wall). |
+| `gh` (GitHub CLI, installed + `gh auth login`) | `fetch` GitHub issue/PR/repo/actions-run/actions-job routing | Falls back to an HTTP fetch of the rendered page (private repos hit a login wall). |
 | `uv` (+ managed Python 3.14, fetched on first use) | `doc_to_md` high-fidelity PDF conversion | Degrades to the pure-JS `unpdf` fallback (no faithful tables/headings). |
 | LibreOffice (`soffice` on `PATH`) | `doc_to_md` DOCX/PPTX conversion | Office inputs error (no JS fallback for office->PDF); PDFs unaffected. |
 
@@ -209,7 +209,7 @@ Operational notes:
 
 `fetch`'s core (`lib/fetch-core.ts`) is also published as a CLI, so Claude Code can use the same routing, size gate, and spill behavior as pi's native tool - without pi ever seeing Claude-only files.
 
-**Exposed:** the `quiver` plugin, served from this repo's `.claude-plugin/marketplace.json`, with one skill: `fetch` (invoked as `quiver:fetch` / `/quiver:fetch`). The skill runs `npx -y pi-quiver@latest fetch <url> [flags]` via Bash - full parameter parity with the pi tool (`--method`, `--header`, `--body`, `--raw`, `--timeout-ms`), same GitHub `gh` routing, same size gate, same binary-to-temp-file handling. See [doc/fetch.md](doc/fetch.md#claude-code-cli-pi-quiver-fetch) for exit codes and flags.
+**Exposed:** the `quiver` plugin, served from this repo's `.claude-plugin/marketplace.json`, with one skill: `fetch` (invoked as `quiver:fetch` / `/quiver:fetch`). The skill runs `npx -y pi-quiver@latest fetch <url> [flags]` via Bash - full parameter parity with the pi tool (`--method`, `--header`, `--body`, `--raw`, `--timeout-ms`), same GitHub `gh` routing (including failed-step logs on failed runs/jobs), same size gate, same binary-to-temp-file handling. See [doc/fetch.md](doc/fetch.md#claude-code-cli-pi-quiver-fetch) for exit codes and flags.
 
 **Not exposed:** pi extensions, `doc_to_md`, and everything else in this package - the marketplace allowlists only `./skills/fetch`, and the npm tarball never ships `skills/` or `.claude-plugin/` (pi's own `files` allowlist excludes them, and pi's explicit `pi.extensions` manifest makes them invisible to pi's convention-directory auto-discovery either way).
 
@@ -245,6 +245,10 @@ Both run in CI on ubuntu + windows (`.github/workflows/test.yml`).
 
 pi-quiver is how ground truth gets into an agent's context - real pages, PDFs, docs, cleanly and safely. The other three then coordinate work over it ([pi-cohort](https://github.com/jjuraszek/pi-cohort)), prune it once it's stale ([pi-condense](https://github.com/jjuraszek/pi-condense)), and govern the process end to end ([pi-gauntlet](https://github.com/jjuraszek/pi-gauntlet)).
 
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) - issues follow a Context / Problem / Idea / Acceptance Criteria template; PRs run the [pi-gauntlet](https://github.com/jjuraszek/pi-gauntlet) workflow (one-liners exempt from ceremony, never from keeping docs truthful).
+
 ## Support
 
 If this saves you time, consider [buying me a coffee](https://buymeacoffee.com/jjurasszek).

package/dist/bin/pi-quiver.js

@@ -61,6 +61,9 @@ function classifyGitHubTarget(url) {
   if (segs.length === 5 && segs[2] === "actions" && segs[3] === "runs" && /^\d+$/.test(segs[4])) {
     return { kind: "run", slug: `${owner}/${repo}`, runId: segs[4], url: `https://github.com/${owner}/${repo}/actions/runs/${segs[4]}` };
   }
+  if (segs.length === 7 && segs[2] === "actions" && segs[3] === "runs" && /^\d+$/.test(segs[4]) && segs[5] === "job" && /^\d+$/.test(segs[6])) {
+    return { kind: "job", slug: `${owner}/${repo}`, jobId: segs[6], url: `https://github.com/${owner}/${repo}/actions/runs/${segs[4]}/job/${segs[6]}` };
+  }
   if (segs.length === 2) {
     return { kind: "repo", slug: `${owner}/${repo}` };
   }
@@ -70,8 +73,14 @@ function buildGhArgs(target) {
   if (target.kind === "issue") return ["issue", "view", target.url, "--comments"];
   if (target.kind === "pr") return ["pr", "view", target.url, "--comments"];
   if (target.kind === "run") return ["run", "view", target.runId, "--repo", target.slug];
+  if (target.kind === "job") return ["run", "view", "--job", target.jobId, "--repo", target.slug];
   return ["repo", "view", target.slug];
 }
+function buildGhLogArgs(target) {
+  if (target.kind === "run") return ["run", "view", target.runId, "--log-failed", "--repo", target.slug];
+  if (target.kind === "job") return ["run", "view", "--job", target.jobId, "--log-failed", "--repo", target.slug];
+  return null;
+}
 var GH_MAX_BUFFER = 1e7;
 var execFileAsync = promisify(execFile);
 var runGh = async (args, timeoutMs, signal) => {
@@ -99,16 +108,22 @@ function ghCommandLabel(target) {
   if (target.kind === "issue") return "issue view --comments";
   if (target.kind === "pr") return "pr view --comments";
   if (target.kind === "run") return "run view";
+  if (target.kind === "job") return "run view --job";
   return "repo view";
 }
 function ghSourceLine(target, ref) {
   if (target.kind === "issue") return `gh issue view ${ref} --comments`;
   if (target.kind === "pr") return `gh pr view ${ref} --comments`;
   if (target.kind === "run") return `gh run view ${target.runId} --repo ${target.slug}`;
+  if (target.kind === "job") return `gh run view --job ${target.jobId} --repo ${target.slug}`;
   return `gh repo view ${ref}`;
 }
-function renderGhResult(target, stdout) {
-  const body = stdout.trimEnd();
+function renderGhResult(target, stdout, failedLogs) {
+  const body = failedLogs !== void 0 ? `${stdout.trimEnd()}
+
+## Failed step logs
+
+${failedLogs.trimEnd()}` : stdout.trimEnd();
   const ref = target.kind === "repo" ? target.slug : target.url;
   const { spill, bytes, lines } = applyGate(body);
   const baseDetails = {
@@ -119,7 +134,8 @@ function renderGhResult(target, stdout) {
     via: "gh",
     ghCommand: ghCommandLabel(target)
   };
-  const source = `Source: ${ghSourceLine(target, ref)}`;
+  const source = failedLogs !== void 0 ? `Source: ${ghSourceLine(target, ref)}
+Source: gh ${buildGhLogArgs(target).join(" ")}` : `Source: ${ghSourceLine(target, ref)}`;
   if (!spill) {
     return {
       output: [source, "", body].join("\n"),
@@ -145,9 +161,19 @@ function renderGhResult(target, stdout) {
 async function executeGhRouting(params, url, signal, runner = runGh) {
   const target = planGhRouting(params, url);
   if (!target) return null;
-  const gh = await runner(buildGhArgs(target), params.timeoutMs ?? DEFAULT_TIMEOUT_MS, signal);
+  const timeoutMs = params.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+  signal?.throwIfAborted();
+  const gh = await runner(buildGhArgs(target), timeoutMs, signal);
+  signal?.throwIfAborted();
   if (!gh.ok) return null;
-  return renderGhResult(target, gh.stdout);
+  const logArgs = buildGhLogArgs(target);
+  let failedLogs;
+  if (logArgs) {
+    const logs = await runner(logArgs, timeoutMs, signal);
+    signal?.throwIfAborted();
+    if (logs.ok && logs.stdout !== "") failedLogs = logs.stdout;
+  }
+  return renderGhResult(target, gh.stdout, failedLogs);
 }
 var PARSABLE_MAX_BYTES = 1e6;
 var BINARY_MAX_BYTES = 5e7;

package/extensions/fetch.ts

@@ -21,7 +21,7 @@ export default function fetchExtension(pi: ExtensionAPI) {
 		name: "fetch",
 		label: "Fetch URL",
 		description:
-			"Fetch a URL over HTTP(S). HTML is extracted to Markdown (readability + turndown). Binary content (images, PDFs, archives) is saved untouched to a temp file and only a path is returned. Text/Markdown/JSON over 32KB or 1000 lines is written to a temp file with a 60-line preview; smaller content is returned inline. Parsable downloads are capped at 1MB, binary at 50MB. When the body is written to a file, grep it or read with offset/limit; converted Markdown is grep-able by heading (^#). GitHub issue/PR/repo/actions-run URLs are served via the gh CLI when available (falls back to HTTP otherwise; raw=true forces the rendered HTML page).",
+			"Fetch a URL over HTTP(S). HTML is extracted to Markdown (readability + turndown). Binary content (images, PDFs, archives) is saved untouched to a temp file and only a path is returned. Text/Markdown/JSON over 32KB or 1000 lines is written to a temp file with a 60-line preview; smaller content is returned inline. Parsable downloads are capped at 1MB, binary at 50MB. When the body is written to a file, grep it or read with offset/limit; converted Markdown is grep-able by heading (^#). GitHub issue/PR/repo/actions-run/actions-job URLs are served via the gh CLI when available (falls back to HTTP otherwise; raw=true forces the rendered HTML page); failed runs/jobs append failed-step logs (best-effort, summary-only when nothing failed).",
 		promptSnippet: "Fetch the contents of a URL",
 		parameters: Type.Object({
 			url: Type.String({ description: "Absolute http(s) URL" }),

package/lib/fetch-core.ts

@@ -29,7 +29,8 @@ export type GhTarget =
 	| { kind: "issue"; url: string }
 	| { kind: "pr"; url: string }
 	| { kind: "repo"; slug: string }
-	| { kind: "run"; slug: string; runId: string; url: string };
+	| { kind: "run"; slug: string; runId: string; url: string }
+	| { kind: "job"; slug: string; jobId: string; url: string };
 
 export function formatSize(bytes: number): string {
 	if (bytes < 1024) {
@@ -80,6 +81,9 @@ export function classifyGitHubTarget(url: URL): GhTarget | null {
 	if (segs.length === 5 && segs[2] === "actions" && segs[3] === "runs" && /^\d+$/.test(segs[4])) {
 		return { kind: "run", slug: `${owner}/${repo}`, runId: segs[4], url: `https://github.com/${owner}/${repo}/actions/runs/${segs[4]}` };
 	}
+	if (segs.length === 7 && segs[2] === "actions" && segs[3] === "runs" && /^\d+$/.test(segs[4]) && segs[5] === "job" && /^\d+$/.test(segs[6])) {
+		return { kind: "job", slug: `${owner}/${repo}`, jobId: segs[6], url: `https://github.com/${owner}/${repo}/actions/runs/${segs[4]}/job/${segs[6]}` };
+	}
 	if (segs.length === 2) {
 		return { kind: "repo", slug: `${owner}/${repo}` };
 	}
@@ -90,9 +94,16 @@ export function buildGhArgs(target: GhTarget): string[] {
 	if (target.kind === "issue") return ["issue", "view", target.url, "--comments"];
 	if (target.kind === "pr") return ["pr", "view", target.url, "--comments"];
 	if (target.kind === "run") return ["run", "view", target.runId, "--repo", target.slug];
+	if (target.kind === "job") return ["run", "view", "--job", target.jobId, "--repo", target.slug];
 	return ["repo", "view", target.slug];
 }
 
+export function buildGhLogArgs(target: GhTarget): string[] | null {
+	if (target.kind === "run") return ["run", "view", target.runId, "--log-failed", "--repo", target.slug];
+	if (target.kind === "job") return ["run", "view", "--job", target.jobId, "--log-failed", "--repo", target.slug];
+	return null;
+}
+
 const GH_MAX_BUFFER = 10_000_000; // 10 MB — an order above PARSABLE_MAX_BYTES
 
 type GhResult = { ok: true; stdout: string } | { ok: false };
@@ -135,6 +146,7 @@ function ghCommandLabel(target: GhTarget): string {
 	if (target.kind === "issue") return "issue view --comments";
 	if (target.kind === "pr") return "pr view --comments";
 	if (target.kind === "run") return "run view";
+	if (target.kind === "job") return "run view --job";
 	return "repo view";
 }
 
@@ -142,11 +154,14 @@ function ghSourceLine(target: GhTarget, ref: string): string {
 	if (target.kind === "issue") return `gh issue view ${ref} --comments`;
 	if (target.kind === "pr") return `gh pr view ${ref} --comments`;
 	if (target.kind === "run") return `gh run view ${target.runId} --repo ${target.slug}`;
+	if (target.kind === "job") return `gh run view --job ${target.jobId} --repo ${target.slug}`;
 	return `gh repo view ${ref}`;
 }
 
-function renderGhResult(target: GhTarget, stdout: string): FetchResult {
-	const body = stdout.trimEnd();
+function renderGhResult(target: GhTarget, stdout: string, failedLogs?: string): FetchResult {
+	const body = failedLogs !== undefined
+		? `${stdout.trimEnd()}\n\n## Failed step logs\n\n${failedLogs.trimEnd()}`
+		: stdout.trimEnd();
 	const ref = target.kind === "repo" ? target.slug : target.url;
 	const { spill, bytes, lines } = applyGate(body);
 	const baseDetails: FetchToolDetails = {
@@ -157,7 +172,9 @@ function renderGhResult(target: GhTarget, stdout: string): FetchResult {
 		via: "gh",
 		ghCommand: ghCommandLabel(target),
 	};
-	const source = `Source: ${ghSourceLine(target, ref)}`;
+	const source = failedLogs !== undefined
+		? `Source: ${ghSourceLine(target, ref)}\nSource: gh ${buildGhLogArgs(target)!.join(" ")}`
+		: `Source: ${ghSourceLine(target, ref)}`;
 	if (!spill) {
 		return {
 			output: [source, "", body].join("\n"),
@@ -189,9 +206,19 @@ export async function executeGhRouting(
 ): Promise<FetchResult | null> {
 	const target = planGhRouting(params, url);
 	if (!target) return null;
-	const gh = await runner(buildGhArgs(target), params.timeoutMs ?? DEFAULT_TIMEOUT_MS, signal);
+	const timeoutMs = params.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+	signal?.throwIfAborted();
+	const gh = await runner(buildGhArgs(target), timeoutMs, signal);
+	signal?.throwIfAborted();
 	if (!gh.ok) return null;
-	return renderGhResult(target, gh.stdout);
+	const logArgs = buildGhLogArgs(target);
+	let failedLogs: string | undefined;
+	if (logArgs) {
+		const logs = await runner(logArgs, timeoutMs, signal);
+		signal?.throwIfAborted();
+		if (logs.ok && logs.stdout !== "") failedLogs = logs.stdout;
+	}
+	return renderGhResult(target, gh.stdout, failedLogs);
 }
 
 const PARSABLE_MAX_BYTES = 1_000_000; // text/markdown/json download ceiling

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-quiver",
-  "version": "4.2.0",
+  "version": "4.3.0",
   "description": "Personal pack of Pi coding-agent extensions: context-safe fetch, doc_to_md PDF/DOCX/PPTX-to-Markdown conversion, session naming, a themed ASCII startup header, Opus 4.8 fast mode, and a provider-stall watchdog.",
   "author": "Jacek Juraszek",
   "license": "MIT",