@skill-harness/adapters 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mojo Manyana
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { HarnessAdapter } from "@skill-harness/core";
+import { piAdapter } from "./pi.js";
+export declare function getAdapter(name: string): HarnessAdapter;
+export { piAdapter };

package/dist/index.js

@@ -0,0 +1,17 @@
+import { piAdapter } from "./pi.js";
+/**
+ * Registered harnesses. pi is the only one (per project scope). The interface
+ * (`HarnessAdapter`) is the extension point — add an entry here to support more.
+ */
+const ADAPTERS = {
+    pi: piAdapter,
+};
+export function getAdapter(name) {
+    const a = ADAPTERS[name];
+    if (!a) {
+        throw new Error(`unknown harness \`${name}\` (available: ${Object.keys(ADAPTERS).join(", ")})`);
+    }
+    return a;
+}
+export { piAdapter };
+//# sourceMappingURL=index.js.map

package/dist/pi.d.ts

@@ -0,0 +1,2 @@
+import type { HarnessAdapter } from "@skill-harness/core";
+export declare const piAdapter: HarnessAdapter;

package/dist/pi.js

@@ -0,0 +1,102 @@
+import { mkdtempSync, readFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { exec, onPath } from "@skill-harness/core";
+const PI_TIMEOUT_MS = Number(process.env.SKILL_CHECK_PI_TIMEOUT_MS ?? 300_000);
+/** Skill-activation flags for a given run mode. */
+function skillFlags(mode, skillDir) {
+    switch (mode) {
+        case "red":
+            return ["--no-skills"];
+        case "green":
+            return ["--skill", skillDir];
+        case "force": {
+            const body = readFileSync(join(skillDir, "SKILL.md"), "utf8");
+            return ["--no-skills", "--append-system-prompt", body];
+        }
+    }
+}
+function header(turnNo, total, text) {
+    const label = total === 1 ? "USER" : `USER (turn ${turnNo}/${total})`;
+    return `>>> ${label}:\n${text}\n`;
+}
+export const piAdapter = {
+    name: "pi",
+    available() {
+        return Promise.resolve(onPath("pi"));
+    },
+    /**
+     * Run a scenario through pi. Single turn → --no-session -p. Multi turn → a
+     * shared --session-dir, -c on every turn after the first. Returns a transcript
+     * interleaving user turns with assistant output.
+     */
+    async run(req) {
+        const common = [
+            "--no-context-files",
+            "--no-extensions",
+            "--provider",
+            req.model.provider,
+            "--model",
+            req.model.model,
+        ];
+        const flags = skillFlags(req.mode, req.skillDir);
+        const total = req.turns.length;
+        const parts = [];
+        if (total === 1) {
+            const args = [...flags, ...common, "--no-session", "-p", req.turns[0]];
+            const r = await exec("pi", args, { cwd: req.cwd, timeoutMs: PI_TIMEOUT_MS });
+            parts.push(header(1, 1, req.turns[0]));
+            parts.push(`<<< ASSISTANT:\n${r.stdout.trim()}\n`);
+            if (r.code !== 0)
+                parts.push(`[pi exited ${r.code}]\n${r.stderr.trim()}\n`);
+            return parts.join("\n");
+        }
+        const session = mkdtempSync(join(tmpdir(), "sc-pi-session-"));
+        for (let i = 0; i < total; i++) {
+            const turnFlags = i === 0 ? ["--session-dir", session] : ["--session-dir", session, "-c"];
+            const args = [...flags, ...common, ...turnFlags, "-p", req.turns[i]];
+            const r = await exec("pi", args, { cwd: req.cwd, timeoutMs: PI_TIMEOUT_MS });
+            parts.push(header(i + 1, total, req.turns[i]));
+            parts.push(`<<< ASSISTANT:\n${r.stdout.trim()}\n`);
+            if (r.code !== 0)
+                parts.push(`[pi exited ${r.code} on turn ${i + 1}]\n${r.stderr.trim()}\n`);
+        }
+        return parts.join("\n");
+    },
+    /**
+     * Run the judge: no skills, no context files, no session, single prompt.
+     * Judge provider `claude-code` routes to the Claude Code CLI (`claude -p`),
+     * which authenticates via the user's Claude subscription (OAuth) instead of
+     * a provider API key.
+     */
+    async judge(req) {
+        if (req.model.provider === "claude-code") {
+            const args = ["-p", req.prompt, "--model", req.model.model];
+            const r = await exec("claude", args, { cwd: req.cwd, timeoutMs: PI_TIMEOUT_MS });
+            if (r.stdout.trim().length === 0 && (r.code !== 0 || r.stderr.trim())) {
+                return `[judge error: claude exited ${r.code}] ${r.stderr.trim()}`;
+            }
+            return r.stdout;
+        }
+        const args = [
+            "--no-skills",
+            "--no-context-files",
+            "--no-extensions",
+            "--no-session",
+            "--provider",
+            req.model.provider,
+            "--model",
+            req.model.model,
+            "-p",
+            req.prompt,
+        ];
+        const r = await exec("pi", args, { cwd: req.cwd, timeoutMs: PI_TIMEOUT_MS });
+        // Surface failures: pi writes provider errors (auth, out-of-credits) to stderr
+        // and exits non-zero with empty stdout. Pass them through so grading can report.
+        if (r.stdout.trim().length === 0 && (r.code !== 0 || r.stderr.trim())) {
+            return `[judge error: pi exited ${r.code}] ${r.stderr.trim()}`;
+        }
+        return r.stdout;
+    },
+};
+//# sourceMappingURL=pi.js.map

package/package.json

@@ -0,0 +1,17 @@
+{
+    "name": "@skill-harness/adapters",
+    "version": "0.1.0",
+    "type": "module",
+    "license": "MIT",
+    "main": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": { ".": "./dist/index.js" },
+    "files": ["dist/**/*.js", "dist/**/*.d.ts", "LICENSE"],
+    "repository": { "type": "git", "url": "git+https://github.com/mojomanyana/skill-harness.git" },
+    "publishConfig": { "access": "public" },
+    "engines": { "node": ">=20" },
+    "scripts": {
+        "prepack": "cp ../../LICENSE ./LICENSE"
+    },
+    "dependencies": { "@skill-harness/core": "0.1.0" }
+}