@bjoernrochel/sevro 1.0.0 → 1.1.0

package/CONTRIBUTING.md

@@ -29,7 +29,10 @@ by applicable law.
 Use Bun 1.3.13, Git, Node 24, npm, and ripgrep (`rg`). Full suite isolation uses `sandbox-exec`
 on macOS or `bubblewrap` and `socat` on Ubuntu. The macOS synthetic libc regression
 fixtures compile with `/usr/bin/cc`, supplied by Apple's Command Line Tools.
-Windows acceptance is unverified.
+Windows acceptance is unverified. Bun remains the development runtime; installed
+users may use Node without Bun. `bun run build` generates ignored `dist/`
+JavaScript and source maps. `npm pack` builds automatically through `prepack`;
+when packing with `--ignore-scripts`, build explicitly first.
 From a fresh checkout:
 
 ```sh
@@ -42,11 +45,38 @@ Its complete recipe checks also require UV, Python 3, mise, and an existing
 `mise install node@24.13.0` installation; see [recipe prerequisites](docs/recipes.md).
 CI explicitly provisions these tools. Missing prerequisites fail with a named
 setup instruction rather than skipping a recipe.
-To run recipe commands from this source checkout, set
-`export SEVRO_RECIPES="$PWD/examples/recipes"` from the repository root, then
-follow the [recipe commands](docs/recipes.md#prepare-a-recipe-project).
+To run the documented JavaScript recipes from this source checkout, build first:
+
+```sh
+bun run build
+export SEVRO_RECIPES="$PWD/dist/examples/recipes"
+```
+
+Then follow the [recipe commands](docs/recipes.md#prepare-a-recipe-project).
 Native model trials need their own [credentials and prerequisites](docs/native-hosts.md).
 
+## Install a development archive
+
+To try source changes in an installed package, prepare an archive from the
+repository root with Bun:
+
+```sh
+bun install --frozen-lockfile
+bun run build
+npm pack --ignore-scripts
+```
+
+The last command prints the archive filename. Transfer that file to the consumer
+project and install it with Node and npm; Bun is not required there:
+
+```sh
+npm install --save-exact /absolute/path/to/candidate.tgz
+```
+
+Continue with the [installed-package tutorial](docs/getting-started.md#from-an-installed-package).
+This creates a development package; maintainers follow the separate
+[release workflow](docs/releases.md) for publication.
+
 ## Quality contract and checks
 
 [The TypeScript quality contract](docs/typescript-quality.md) defines the checked

package/README.md

@@ -19,11 +19,12 @@ Sevro is under active development. The npm package is `@bjoernrochel/sevro`;
 its command is `sevro`. The [current release](docs/installing.md#current-release) includes runtime
 configuration, native goals, selected plugin hooks, and the current licensing terms.
 Earlier `rc.1` and `rc.2` packages retain their original BSL grants.
-See [installation and release differences](docs/installing.md).
+See [installation](docs/installing.md).
 
-Use Bun 1.3.13. The development checkout runs native isolation on macOS with
-`sandbox-exec` and on Ubuntu with `bubblewrap` and `socat`.
-Contributor package/release checks also need Node 24 and npm.
+Run the installed package with Node.js 24.13.0 or newer, or Bun 1.3.13.
+Bun is not required for Node users. Native isolation uses macOS `sandbox-exec`
+or Ubuntu `bubblewrap` and `socat`. Contributors keep Bun 1.3.13 for development,
+builds and tests, plus Node 24.13.0 and npm for package acceptance.
 Windows support is unverified. The basic example uses an injected
 deterministic adapter and needs no native model credentials.
 
@@ -32,7 +33,7 @@ deterministic adapter and needs no native model credentials.
 ```sh
 mkdir sevro-demo
 cd sevro-demo
-bun init -y
+npm init -y
 ```
 
 Install the [current release](docs/installing.md#current-release) in that directory.
@@ -54,7 +55,7 @@ Machine-readable contracts live in [schemas/](schemas/).
 
 ## Ask the repository guide
 
-Open this checkout in a fresh Codex or Claude Code session and ask
+Open the Sevro repository in a fresh Codex or Claude Code session and ask
 “What is Sevro, and how do I run my first evaluation?” Explicit invocation is
 `$sevro-guide` in Codex or `/sevro-guide` in Claude Code.
 The guide reads sources, cites its answers, and handles follow-ups. It explains

package/dist/examples/basic/graded.json

@@ -0,0 +1,13 @@
+{
+  "id": "basic-graded",
+  "prompt": "Return ready.",
+  "fixture": { "files": { "README.md": "fixture\n" } },
+  "checks": [
+    {
+      "id": "ready",
+      "grader": "sevro.regex",
+      "configuration": { "pattern": "^ready$" }
+    }
+  ],
+  "requiredEvidence": []
+}

package/dist/examples/basic/host.js

@@ -0,0 +1,9 @@
+export default {
+    id: "sevro.host.example",
+    model: "deterministic-example",
+    effort: "none",
+    run() {
+        return Promise.resolve({ finalMessage: "ready", complete: true });
+    },
+};
+//# sourceMappingURL=host.js.map

package/dist/examples/basic/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["host.ts"],"names":[],"mappings":"AAAA,eAAe;IACb,EAAE,EAAE,oBAAoB;IACxB,KAAK,EAAE,uBAAuB;IAC9B,MAAM,EAAE,MAAM;IACd,GAAG;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,CAAC;CACF,CAAC","sourcesContent":["export default {\n  id: \"sevro.host.example\",\n  model: \"deterministic-example\",\n  effort: \"none\",\n  run() {\n    return Promise.resolve({ finalMessage: \"ready\", complete: true });\n  },\n};\n"]}

package/dist/examples/basic/prompt-only.json

@@ -0,0 +1,7 @@
+{
+  "id": "basic-prompt-only",
+  "prompt": "Return ready.",
+  "fixture": { "files": { "README.md": "fixture\n" } },
+  "checks": [],
+  "requiredEvidence": []
+}

package/dist/examples/recipes/candidate.js

@@ -0,0 +1,23 @@
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+/** Trusted, deterministic participant for exercising the recipe's real graders. */
+const host = {
+    id: "recipes.deterministic",
+    model: "fixture-editor",
+    effort: "none",
+    async run({ workspace }) {
+        const task = await readFile(join(workspace, "README.md"), "utf8");
+        const failing = process.env.SEVRO_RECIPE_FAIL === "1";
+        if (task.includes("Fix add")) {
+            await writeFile(join(workspace, "math.cjs"), `exports.add = (a, b) => a ${failing ? "-" : "+"} b;\n`);
+        }
+        return {
+            finalMessage: failing
+                ? "Start with npm start on port 9000."
+                : "Run bun run dev on port 3000.",
+            complete: true,
+        };
+    },
+};
+export default host;
+//# sourceMappingURL=candidate.js.map

package/dist/examples/recipes/candidate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate.js","sourceRoot":"","sources":["candidate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,yBAAyB;AACvD,OAAO,EAAE,IAAI,EAAE,kBAAkB;AAEjC,mFAAmF;AACnF,MAAM,IAAI,GAAG;IACX,EAAE,EAAE,uBAAuB;IAC3B,KAAK,EAAE,gBAAgB;IACvB,MAAM,EAAE,MAAM;IACd,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,EAAyB;QAC5C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,KAAK,GAAG,CAAC;QACtD,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,MAAM,SAAS,CACb,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,EAC3B,6BAA6B,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,OAAO,CACxD,CAAC;QACJ,CAAC;QACD,OAAO;YACL,YAAY,EAAE,OAAO;gBACnB,CAAC,CAAC,oCAAoC;gBACtC,CAAC,CAAC,+BAA+B;YACnC,QAAQ,EAAE,IAAI;SACf,CAAC;IACJ,CAAC;CACF,CAAC;AACF,eAAe,IAAI,CAAC","sourcesContent":["import { readFile, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\n\n/** Trusted, deterministic participant for exercising the recipe's real graders. */\nconst host = {\n  id: \"recipes.deterministic\",\n  model: \"fixture-editor\",\n  effort: \"none\",\n  async run({ workspace }: { workspace: string }) {\n    const task = await readFile(join(workspace, \"README.md\"), \"utf8\");\n    const failing = process.env.SEVRO_RECIPE_FAIL === \"1\";\n    if (task.includes(\"Fix add\")) {\n      await writeFile(\n        join(workspace, \"math.cjs\"),\n        `exports.add = (a, b) => a ${failing ? \"-\" : \"+\"} b;\\n`,\n      );\n    }\n    return {\n      finalMessage: failing\n        ? \"Start with npm start on port 9000.\"\n        : \"Run bun run dev on port 3000.\",\n      complete: true,\n    };\n  },\n};\nexport default host;\n"]}

package/dist/examples/recipes/cases/coding-change.json

@@ -0,0 +1,21 @@
+{
+  "id": "recipe-coding-change",
+  "prompt": "Fix add in math.cjs so it adds its two numeric arguments. Do not modify README.md. Explain how to start the application.",
+  "fixture": {
+    "files": {
+      "README.md": "Fix add in math.cjs. Start the application with bun run dev on port 3000.\n",
+      "math.cjs": "exports.add = (a, b) => a - b;\n"
+    }
+  },
+  "checks": [
+    {
+      "id": "addition",
+      "grader": "sevro.shell",
+      "configuration": {
+        "run": "{{evaluator-test}}",
+        "expectExact": "coding checks passed"
+      }
+    }
+  ],
+  "requiredEvidence": []
+}

package/dist/examples/recipes/cases/host-tools.json

@@ -0,0 +1,21 @@
+{
+  "id": "recipe-host-tools",
+  "prompt": "Read app.env with rg, then explain the application's start command and port.",
+  "fixture": {
+    "files": {
+      "README.md": "Start with bun run dev on port 3000.\n",
+      "app.env": "port=3000\n"
+    }
+  },
+  "checks": [
+    {
+      "id": "rg-access",
+      "grader": "sevro.shell",
+      "configuration": {
+        "run": "rg '^port=3000$' app.env",
+        "expectExact": "port=3000"
+      }
+    }
+  ],
+  "requiredEvidence": []
+}

package/dist/examples/recipes/cases/mise.json

@@ -0,0 +1,21 @@
+{
+  "id": "recipe-mise",
+  "prompt": "Use node from PATH to read app.json, then explain the application's start command and port. The operator has resolved mise's existing node@24.13.0 installation; do not download anything.",
+  "fixture": {
+    "files": {
+      "README.md": "Start with bun run dev on port 3000.\n",
+      "app.json": "{\"port\":3000}\n"
+    }
+  },
+  "checks": [
+    {
+      "id": "mise-node-access",
+      "grader": "sevro.shell",
+      "configuration": {
+        "run": "node -e 'if (process.version !== \"v24.13.0\") process.exit(1); const a = require(\"./app.json\"); if (a.port !== 3000) process.exit(1); console.log(a.port)'",
+        "expectExact": "3000"
+      }
+    }
+  ],
+  "requiredEvidence": []
+}

package/dist/examples/recipes/cases/node.json

@@ -0,0 +1,21 @@
+{
+  "id": "recipe-node",
+  "prompt": "Read app.json with Node and explain the application's start command and port.",
+  "fixture": {
+    "files": {
+      "README.md": "Start with bun run dev on port 3000.\n",
+      "app.json": "{\"port\":3000}\n"
+    }
+  },
+  "checks": [
+    {
+      "id": "node-access",
+      "grader": "sevro.shell",
+      "configuration": {
+        "run": "node -e 'const a = require(\"./app.json\"); if (a.port !== 3000) process.exit(1); console.log(a.port)'",
+        "expectExact": "3000"
+      }
+    }
+  ],
+  "requiredEvidence": []
+}

package/dist/examples/recipes/cases/python-uv.json

@@ -0,0 +1,21 @@
+{
+  "id": "recipe-python-uv",
+  "prompt": "Use uv run --offline --no-project --python \"$RECIPE_PYTHON\" python to read app.json, then explain the application's start command and port.",
+  "fixture": {
+    "files": {
+      "README.md": "Start with bun run dev on port 3000.\n",
+      "app.json": "{\"port\":3000}\n"
+    }
+  },
+  "checks": [
+    {
+      "id": "uv-python-access",
+      "grader": "sevro.shell",
+      "configuration": {
+        "run": "uv run --offline --no-project --python \"$RECIPE_PYTHON\" python -c 'import json; p=json.load(open(\"app.json\"))[\"port\"]; assert p == 3000; print(p)'",
+        "expectExact": "3000"
+      }
+    }
+  ],
+  "requiredEvidence": []
+}

package/dist/examples/recipes/cases/semantic.json

@@ -0,0 +1,17 @@
+{
+  "id": "recipe-semantic",
+  "prompt": "Read README.md and explain how to start the application, including its port.",
+  "fixture": {
+    "files": { "README.md": "Start with bun run dev on port 3000.\n" }
+  },
+  "checks": [
+    {
+      "id": "startup-meaning",
+      "grader": "sevro.semantic",
+      "configuration": {
+        "proposition": "The response tells the reader to run bun run dev and says that the application listens on port 3000."
+      }
+    }
+  ],
+  "requiredEvidence": []
+}

package/dist/examples/recipes/coding-change/check.js

@@ -0,0 +1,16 @@
+import assert from "node:assert/strict";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+function isAddition(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        "add" in value &&
+        typeof value.add === "function");
+}
+const candidate = await import(pathToFileURL(join(process.cwd(), "math.cjs")).href);
+assert.ok(isAddition(candidate), "Candidate must export add");
+assert.equal(candidate.add(2, 3), 5);
+assert.equal(candidate.add(-2, 3), 1);
+assert.equal(candidate.add(0, 0), 0);
+console.log("coding checks passed");
+//# sourceMappingURL=check.js.map

package/dist/examples/recipes/coding-change/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["check.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,2BAA2B;AACxC,OAAO,EAAE,IAAI,EAAE,kBAAkB;AACjC,OAAO,EAAE,aAAa,EAAE,iBAAiB;AAKzC,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,KAAK,IAAI,KAAK;QACd,OAAO,KAAK,CAAC,GAAG,KAAK,UAAU,CAChC,CAAC;AACJ,CAAC;AACD,MAAM,SAAS,GAAY,MAAM,MAAM,CACrC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CACpD,CAAC;AACF,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,2BAA2B,CAAC,CAAC;AAC9D,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACrC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACtC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACrC,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC","sourcesContent":["import assert from \"node:assert/strict\";\nimport { join } from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\n\ninterface Addition {\n  add: (left: number, right: number) => number;\n}\nfunction isAddition(value: unknown): value is Addition {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"add\" in value &&\n    typeof value.add === \"function\"\n  );\n}\nconst candidate: unknown = await import(\n  pathToFileURL(join(process.cwd(), \"math.cjs\")).href\n);\nassert.ok(isAddition(candidate), \"Candidate must export add\");\nassert.equal(candidate.add(2, 3), 5);\nassert.equal(candidate.add(-2, 3), 1);\nassert.equal(candidate.add(0, 0), 0);\nconsole.log(\"coding checks passed\");\n"]}

package/dist/examples/recipes/executable.js

@@ -0,0 +1,20 @@
+import { accessSync, constants, statSync } from "node:fs";
+import { delimiter, resolve } from "node:path";
+export function which(name, path) {
+    for (const directory of executablePath(path).split(delimiter)) {
+        const candidate = resolve(directory, name);
+        try {
+            accessSync(candidate, constants.X_OK);
+            if (statSync(candidate).isFile())
+                return candidate;
+        }
+        catch {
+            /* Continue searching the declared executable path. */
+        }
+    }
+    return null;
+}
+function executablePath(path) {
+    return path ?? process.env.PATH ?? "";
+}
+//# sourceMappingURL=executable.js.map

package/dist/examples/recipes/executable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executable.js","sourceRoot":"","sources":["executable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB;AAC1D,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB;AAE/C,MAAM,UAAU,KAAK,CAAC,IAAY,EAAE,IAAa;IAC/C,KAAK,MAAM,SAAS,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9D,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC;YACH,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE;gBAAE,OAAO,SAAS,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,sDAAsD;QACxD,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,IAAwB;IAC9C,OAAO,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;AACxC,CAAC","sourcesContent":["import { accessSync, constants, statSync } from \"node:fs\";\nimport { delimiter, resolve } from \"node:path\";\n\nexport function which(name: string, path?: string): string | null {\n  for (const directory of executablePath(path).split(delimiter)) {\n    const candidate = resolve(directory, name);\n    try {\n      accessSync(candidate, constants.X_OK);\n      if (statSync(candidate).isFile()) return candidate;\n    } catch {\n      /* Continue searching the declared executable path. */\n    }\n  }\n  return null;\n}\n\nfunction executablePath(path: string | undefined): string {\n  return path ?? process.env.PATH ?? \"\";\n}\n"]}

package/dist/examples/recipes/extension-artifacts.js

@@ -0,0 +1,56 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+export function artifact(relativePath, content) {
+    return {
+        id: `recipes.${createHash("sha256").update(relativePath).digest("hex").slice(0, 16)}`,
+        relativePath,
+        sha256: createHash("sha256").update(content).digest("hex"),
+        contentBase64: Buffer.from(content).toString("base64"),
+        gitExclude: true,
+    };
+}
+export async function repositoryArtifacts(host) {
+    const directory = host === "claude" ? ".claude" : ".agents";
+    const relative = `${directory}/skills/startup-guide/SKILL.md`;
+    const body = await readFile(join(import.meta.dirname, "repository-skill", relative), "utf8");
+    return [artifact(relative, body)];
+}
+export function pluginArtifacts() {
+    const files = {
+        "marketplace/.claude-plugin/marketplace.json": JSON.stringify({
+            name: "recipes",
+            owner: { name: "Sevro examples" },
+            plugins: [
+                { name: "startup", source: "./plugin", description: "Startup recipe" },
+            ],
+        }),
+        "marketplace/plugin/.claude-plugin/plugin.json": JSON.stringify({
+            name: "startup",
+            version: "1.0.0",
+        }),
+        "marketplace/plugin/.codex-plugin/plugin.json": JSON.stringify({
+            name: "startup",
+            version: "1.0.0",
+            skills: "./skills/",
+        }),
+        "marketplace/plugin/skills/startup-guide/SKILL.md": "---\nname: startup-guide\ndescription: Explain application startup.\n---\nRead README.md. Explain its command and port.\n",
+        "marketplace/plugin/hooks/hooks.json": JSON.stringify({
+            hooks: {
+                SessionStart: [
+                    {
+                        hooks: [
+                            {
+                                type: "command",
+                                command: '/bin/sh "${CLAUDE_PLUGIN_ROOT}/hooks/start.sh"',
+                            },
+                        ],
+                    },
+                ],
+            },
+        }),
+        "marketplace/plugin/hooks/start.sh": "#!/bin/sh\nprintf 'hook ran\\n' > \"$PWD/hook-ran.txt\"\n",
+    };
+    return Object.entries(files).map(([path, content]) => artifact(path, content));
+}
+//# sourceMappingURL=extension-artifacts.js.map

package/dist/examples/recipes/extension-artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-artifacts.js","sourceRoot":"","sources":["extension-artifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,oBAAoB;AACzC,OAAO,EAAE,QAAQ,EAAE,yBAAyB;AAC5C,OAAO,EAAE,IAAI,EAAE,kBAAkB;AAEjC,MAAM,UAAU,QAAQ,CAAC,YAAoB,EAAE,OAAe;IAC5D,OAAO;QACL,EAAE,EAAE,WAAW,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;QACrF,YAAY;QACZ,MAAM,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC1D,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACtD,UAAU,EAAE,IAAI;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAAY;IACpD,MAAM,SAAS,GAAG,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5D,MAAM,QAAQ,GAAG,GAAG,SAAS,gCAAgC,CAAC;IAC9D,MAAM,IAAI,GAAG,MAAM,QAAQ,CACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,CAAC,EACvD,MAAM,CACP,CAAC;IACF,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,MAAM,KAAK,GAAG;QACZ,6CAA6C,EAAE,IAAI,CAAC,SAAS,CAAC;YAC5D,IAAI,EAAE,SAAS;YACf,KAAK,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE;YACjC,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE;aACvE;SACF,CAAC;QACF,+CAA+C,EAAE,IAAI,CAAC,SAAS,CAAC;YAC9D,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,OAAO;SACjB,CAAC;QACF,8CAA8C,EAAE,IAAI,CAAC,SAAS,CAAC;YAC7D,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,WAAW;SACpB,CAAC;QACF,kDAAkD,EAChD,2HAA2H;QAC7H,qCAAqC,EAAE,IAAI,CAAC,SAAS,CAAC;YACpD,KAAK,EAAE;gBACL,YAAY,EAAE;oBACZ;wBACE,KAAK,EAAE;4BACL;gCACE,IAAI,EAAE,SAAS;gCACf,OAAO,EAAE,gDAAgD;6BAC1D;yBACF;qBACF;iBACF;aACF;SACF,CAAC;QACF,mCAAmC,EACjC,2DAA2D;KAC9D,CAAC;IACF,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CACnD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CACxB,CAAC;AACJ,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { readFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\n\nexport function artifact(relativePath: string, content: string) {\n  return {\n    id: `recipes.${createHash(\"sha256\").update(relativePath).digest(\"hex\").slice(0, 16)}`,\n    relativePath,\n    sha256: createHash(\"sha256\").update(content).digest(\"hex\"),\n    contentBase64: Buffer.from(content).toString(\"base64\"),\n    gitExclude: true,\n  };\n}\n\nexport async function repositoryArtifacts(host: string) {\n  const directory = host === \"claude\" ? \".claude\" : \".agents\";\n  const relative = `${directory}/skills/startup-guide/SKILL.md`;\n  const body = await readFile(\n    join(import.meta.dirname, \"repository-skill\", relative),\n    \"utf8\",\n  );\n  return [artifact(relative, body)];\n}\n\nexport function pluginArtifacts() {\n  const files = {\n    \"marketplace/.claude-plugin/marketplace.json\": JSON.stringify({\n      name: \"recipes\",\n      owner: { name: \"Sevro examples\" },\n      plugins: [\n        { name: \"startup\", source: \"./plugin\", description: \"Startup recipe\" },\n      ],\n    }),\n    \"marketplace/plugin/.claude-plugin/plugin.json\": JSON.stringify({\n      name: \"startup\",\n      version: \"1.0.0\",\n    }),\n    \"marketplace/plugin/.codex-plugin/plugin.json\": JSON.stringify({\n      name: \"startup\",\n      version: \"1.0.0\",\n      skills: \"./skills/\",\n    }),\n    \"marketplace/plugin/skills/startup-guide/SKILL.md\":\n      \"---\\nname: startup-guide\\ndescription: Explain application startup.\\n---\\nRead README.md. Explain its command and port.\\n\",\n    \"marketplace/plugin/hooks/hooks.json\": JSON.stringify({\n      hooks: {\n        SessionStart: [\n          {\n            hooks: [\n              {\n                type: \"command\",\n                command: '/bin/sh \"${CLAUDE_PLUGIN_ROOT}/hooks/start.sh\"',\n              },\n            ],\n          },\n        ],\n      },\n    }),\n    \"marketplace/plugin/hooks/start.sh\":\n      \"#!/bin/sh\\nprintf 'hook ran\\\\n' > \\\"$PWD/hook-ran.txt\\\"\\n\",\n  };\n  return Object.entries(files).map(([path, content]) =>\n    artifact(path, content),\n  );\n}\n"]}

package/dist/examples/recipes/extension-methods.js

@@ -0,0 +1,167 @@
+import { artifact, pluginArtifacts, repositoryArtifacts, } from "./extension-artifacts.js";
+export function record(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        throw new Error("Expected a JSON object");
+    return value;
+}
+export function describe(mode, host) {
+    const capabilities = {
+        lifecycle: [],
+        "repository-skill": [`sevro.${host}.repository-invocation`],
+        plugins: host === "codex"
+            ? ["sevro.codex.plugin-marketplace", "sevro.codex.explicit-invocation"]
+            : ["sevro.claude.plugin-dirs", "sevro.claude.explicit-invocation"],
+    };
+    const requiredCapabilities = capabilities[mode];
+    if (!requiredCapabilities)
+        throw new Error("Unknown extension recipe");
+    return {
+        extension: { id: "recipes.startup", version: "1.0.0" },
+        protocols: ["sevro.extension.v1"],
+        requiredCapabilities,
+        optionalCapabilities: [],
+        graders: ["recipes.startup"],
+        taskVerdictPolicies: [],
+    };
+}
+function requiredInvocation(mode, host) {
+    if (mode !== "repository-skill")
+        return [];
+    return [
+        host === "codex"
+            ? "sevro.codex.explicit-invocation"
+            : "sevro.claude.repository-invocation",
+    ];
+}
+export function resolveCase(mode, host, fail) {
+    const invocation = mode === "lifecycle" ? "" : "{{sevro.skill_invocation}} ";
+    const prompt = fail
+        ? "Deliberate negative control: return only wrong."
+        : "Read README.md. Explain the application's start command and port. Do not change files.";
+    const requiredEvidence = requiredInvocation(mode, host);
+    return {
+        cases: [
+            {
+                id: "recipe-extension",
+                prompt: invocation + prompt,
+                fixture: {
+                    kind: "generated",
+                    commits: [
+                        {
+                            message: "chore: initialize sample",
+                            files: { "README.md": "Run bun run dev on port 3000.\n" },
+                        },
+                    ],
+                },
+                checks: [
+                    {
+                        id: "startup-command",
+                        grader: "sevro.regex",
+                        configuration: { pattern: "bun run dev" },
+                    },
+                    {
+                        id: "prepared-input",
+                        grader: "sevro.shell",
+                        configuration: {
+                            run: "test \"$(cat startup.txt)\" = 'prepared startup data'",
+                        },
+                    },
+                    ...(mode === "plugins"
+                        ? [
+                            {
+                                id: "plugin-hook",
+                                grader: "sevro.shell",
+                                configuration: {
+                                    run: "cat hook-ran.txt",
+                                    expectExact: "hook ran",
+                                },
+                            },
+                        ]
+                        : []),
+                    {
+                        id: "recipes.startup.answer",
+                        grader: "recipes.startup",
+                        configuration: {},
+                    },
+                ],
+                requiredEvidence,
+                extensionData: { "recipes.startup": { mode, host } },
+            },
+        ],
+    };
+}
+export async function prepare(mode, host) {
+    const base = {
+        artifacts: [artifact("startup.txt", "prepared startup data\n")],
+        requestedInstrumentation: [],
+        extensionData: { "recipes.startup": { mode, host } },
+    };
+    switch (mode) {
+        case "repository-skill":
+            return {
+                ...base,
+                artifacts: [...base.artifacts, ...(await repositoryArtifacts(host))],
+                ...(host === "codex"
+                    ? { codexRepositorySkillInvocation: { skillName: "startup-guide" } }
+                    : {
+                        claudeRepositorySkillInvocation: { skillName: "startup-guide" },
+                    }),
+            };
+        case "plugins":
+            return {
+                ...base,
+                artifacts: [...base.artifacts, ...pluginArtifacts()],
+                ...(host === "codex"
+                    ? {
+                        codexMarketplace: {
+                            artifactRoot: "marketplace",
+                            marketplaceName: "recipes",
+                            pluginNames: ["startup"],
+                        },
+                        codexSkillInvocation: {
+                            pluginName: "startup",
+                            skillName: "startup-guide",
+                        },
+                    }
+                    : {
+                        claudePluginDirs: { artifactRoots: ["marketplace/plugin"] },
+                        claudeSkillInvocation: {
+                            pluginName: "startup",
+                            skillName: "startup-guide",
+                        },
+                    }),
+            };
+        default:
+            return base;
+    }
+}
+function answerStatus(observation) {
+    if (observation.completeness !== "complete")
+        return "unavailable";
+    const text = record(observation.data).text;
+    return typeof text === "string" && /\b3000\b/.test(text)
+        ? "passed"
+        : "failed";
+}
+export function evaluate(params) {
+    if (!Array.isArray(params.observations))
+        throw new Error("Missing observations");
+    const observations = params.observations;
+    const observation = observations
+        .map(record)
+        .find((item) => item.id === "sevro.observation.final-message");
+    if (!observation)
+        throw new Error("Missing final-message observation");
+    const status = answerStatus(observation);
+    return {
+        checks: [
+            {
+                id: "recipes.startup.answer",
+                status,
+                evidenceRefs: ["sevro.observation.final-message"],
+            },
+        ],
+        metrics: [],
+    };
+}
+//# sourceMappingURL=extension-methods.js.map

package/dist/examples/recipes/extension-methods.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-methods.js","sourceRoot":"","sources":["extension-methods.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  artifact,\n  pluginArtifacts,\n  repositoryArtifacts,\n} from \"./extension-artifacts\";\n\nexport function record(value: unknown): Record<string, unknown> {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value))\n    throw new Error(\"Expected a JSON object\");\n  return value as Record<string, unknown>;\n}\n\nexport function describe(mode: string, host: string) {\n  const capabilities: Record<string, string[]> = {\n    lifecycle: [],\n    \"repository-skill\": [`sevro.${host}.repository-invocation`],\n    plugins:\n      host === \"codex\"\n        ? [\"sevro.codex.plugin-marketplace\", \"sevro.codex.explicit-invocation\"]\n        : [\"sevro.claude.plugin-dirs\", \"sevro.claude.explicit-invocation\"],\n  };\n  const requiredCapabilities = capabilities[mode];\n  if (!requiredCapabilities) throw new Error(\"Unknown extension recipe\");\n  return {\n    extension: { id: \"recipes.startup\", version: \"1.0.0\" },\n    protocols: [\"sevro.extension.v1\"],\n    requiredCapabilities,\n    optionalCapabilities: [],\n    graders: [\"recipes.startup\"],\n    taskVerdictPolicies: [],\n  };\n}\n\nfunction requiredInvocation(mode: string, host: string): string[] {\n  if (mode !== \"repository-skill\") return [];\n  return [\n    host === \"codex\"\n      ? \"sevro.codex.explicit-invocation\"\n      : \"sevro.claude.repository-invocation\",\n  ];\n}\n\nexport function resolveCase(mode: string, host: string, fail: boolean) {\n  const invocation = mode === \"lifecycle\" ? \"\" : \"{{sevro.skill_invocation}} \";\n  const prompt = fail\n    ? \"Deliberate negative control: return only wrong.\"\n    : \"Read README.md. Explain the application's start command and port. Do not change files.\";\n  const requiredEvidence = requiredInvocation(mode, host);\n  return {\n    cases: [\n      {\n        id: \"recipe-extension\",\n        prompt: invocation + prompt,\n        fixture: {\n          kind: \"generated\",\n          commits: [\n            {\n              message: \"chore: initialize sample\",\n              files: { \"README.md\": \"Run bun run dev on port 3000.\\n\" },\n            },\n          ],\n        },\n        checks: [\n          {\n            id: \"startup-command\",\n            grader: \"sevro.regex\",\n            configuration: { pattern: \"bun run dev\" },\n          },\n          {\n            id: \"prepared-input\",\n            grader: \"sevro.shell\",\n            configuration: {\n              run: \"test \\\"$(cat startup.txt)\\\" = 'prepared startup data'\",\n            },\n          },\n          ...(mode === \"plugins\"\n            ? [\n                {\n                  id: \"plugin-hook\",\n                  grader: \"sevro.shell\",\n                  configuration: {\n                    run: \"cat hook-ran.txt\",\n                    expectExact: \"hook ran\",\n                  },\n                },\n              ]\n            : []),\n          {\n            id: \"recipes.startup.answer\",\n            grader: \"recipes.startup\",\n            configuration: {},\n          },\n        ],\n        requiredEvidence,\n        extensionData: { \"recipes.startup\": { mode, host } },\n      },\n    ],\n  };\n}\n\nexport async function prepare(mode: string, host: string) {\n  const base = {\n    artifacts: [artifact(\"startup.txt\", \"prepared startup data\\n\")],\n    requestedInstrumentation: [],\n    extensionData: { \"recipes.startup\": { mode, host } },\n  };\n  switch (mode) {\n    case \"repository-skill\":\n      return {\n        ...base,\n        artifacts: [...base.artifacts, ...(await repositoryArtifacts(host))],\n        ...(host === \"codex\"\n          ? { codexRepositorySkillInvocation: { skillName: \"startup-guide\" } }\n          : {\n              claudeRepositorySkillInvocation: { skillName: \"startup-guide\" },\n            }),\n      };\n    case \"plugins\":\n      return {\n        ...base,\n        artifacts: [...base.artifacts, ...pluginArtifacts()],\n        ...(host === \"codex\"\n          ? {\n              codexMarketplace: {\n                artifactRoot: \"marketplace\",\n                marketplaceName: \"recipes\",\n                pluginNames: [\"startup\"],\n              },\n              codexSkillInvocation: {\n                pluginName: \"startup\",\n                skillName: \"startup-guide\",\n              },\n            }\n          : {\n              claudePluginDirs: { artifactRoots: [\"marketplace/plugin\"] },\n              claudeSkillInvocation: {\n                pluginName: \"startup\",\n                skillName: \"startup-guide\",\n              },\n            }),\n      };\n    default:\n      return base;\n  }\n}\n\nfunction answerStatus(observation: Record<string, unknown>) {\n  if (observation.completeness !== \"complete\") return \"unavailable\";\n  const text = record(observation.data).text;\n  return typeof text === \"string\" && /\\b3000\\b/.test(text)\n    ? \"passed\"\n    : \"failed\";\n}\n\nexport function evaluate(params: Record<string, unknown>) {\n  if (!Array.isArray(params.observations))\n    throw new Error(\"Missing observations\");\n  const observations: unknown[] = params.observations;\n  const observation = observations\n    .map(record)\n    .find((item) => item.id === \"sevro.observation.final-message\");\n  if (!observation) throw new Error(\"Missing final-message observation\");\n  const status = answerStatus(observation);\n  return {\n    checks: [\n      {\n        id: \"recipes.startup.answer\",\n        status,\n        evidenceRefs: [\"sevro.observation.final-message\"],\n      },\n    ],\n    metrics: [],\n  };\n}\n"]}

package/dist/examples/recipes/extension.js

@@ -0,0 +1,28 @@
+import { readFileSync } from "node:fs";
+import { describe, evaluate, prepare, record, resolveCase, } from "./extension-methods.js";
+const mode = process.argv[2] ?? "lifecycle";
+const host = process.argv[3] ?? "deterministic";
+const fail = process.argv[4] === "fail";
+const request = record(JSON.parse(readFileSync(0, "utf8")));
+async function result() {
+    switch (request.method) {
+        case "describe":
+            return describe(mode, host);
+        case "resolve":
+            return resolveCase(mode, host, fail);
+        case "prepare":
+            return await prepare(mode, host);
+        case "evaluate":
+            return evaluate(record(request.params));
+        default:
+            throw new Error("Unsupported extension method");
+    }
+}
+// One request per process; stdout contains only the matching protocol response.
+process.stdout.write(JSON.stringify({
+    protocol: request.protocol,
+    id: request.id,
+    method: request.method,
+    result: await result(),
+}));
+//# sourceMappingURL=extension.js.map

package/dist/examples/recipes/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB;AACvC,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,MAAM,EACN,WAAW,GACZ,+BAA4B;AAE7B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC;AAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC;AAChD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC;AACxC,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAY,CAAC,CAAC;AAEvE,KAAK,UAAU,MAAM;IACnB,QAAQ,OAAO,CAAC,MAAM,EAAE,CAAC;QACvB,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC9B,KAAK,SAAS;YACZ,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACvC,KAAK,SAAS;YACZ,OAAO,MAAM,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACnC,KAAK,UAAU;YACb,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1C;YACE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,EAAE,EAAE,OAAO,CAAC,EAAE;IACd,MAAM,EAAE,OAAO,CAAC,MAAM;IACtB,MAAM,EAAE,MAAM,MAAM,EAAE;CACvB,CAAC,CACH,CAAC","sourcesContent":["import { readFileSync } from \"node:fs\";\nimport {\n  describe,\n  evaluate,\n  prepare,\n  record,\n  resolveCase,\n} from \"./extension-methods\";\n\nconst mode = process.argv[2] ?? \"lifecycle\";\nconst host = process.argv[3] ?? \"deterministic\";\nconst fail = process.argv[4] === \"fail\";\nconst request = record(JSON.parse(readFileSync(0, \"utf8\")) as unknown);\n\nasync function result() {\n  switch (request.method) {\n    case \"describe\":\n      return describe(mode, host);\n    case \"resolve\":\n      return resolveCase(mode, host, fail);\n    case \"prepare\":\n      return await prepare(mode, host);\n    case \"evaluate\":\n      return evaluate(record(request.params));\n    default:\n      throw new Error(\"Unsupported extension method\");\n  }\n}\n\n// One request per process; stdout contains only the matching protocol response.\nprocess.stdout.write(\n  JSON.stringify({\n    protocol: request.protocol,\n    id: request.id,\n    method: request.method,\n    result: await result(),\n  }),\n);\n"]}

package/dist/examples/recipes/modules.js

@@ -0,0 +1,9 @@
+import { join } from "node:path";
+/** Locate source modules for Bun development or compiled modules for consumers. */
+export function recipeFile(...parts) {
+    const path = join(import.meta.dirname, ...parts);
+    return import.meta.filename.endsWith(".ts")
+        ? path
+        : path.replace(/\.ts$/, ".js");
+}
+//# sourceMappingURL=modules.js.map