@bjoernrochel/sevro 0.1.0-rc.8 → 1.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"extension-methods.js","sourceRoot":"","sources":["extension-methods.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,eAAe,EACf,mBAAmB,GACpB,iCAA8B;AAE/B,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,IAAY;IACjD,MAAM,YAAY,GAA6B;QAC7C,SAAS,EAAE,EAAE;QACb,kBAAkB,EAAE,CAAC,SAAS,IAAI,wBAAwB,CAAC;QAC3D,OAAO,EACL,IAAI,KAAK,OAAO;YACd,CAAC,CAAC,CAAC,gCAAgC,EAAE,iCAAiC,CAAC;YACvE,CAAC,CAAC,CAAC,0BAA0B,EAAE,kCAAkC,CAAC;KACvE,CAAC;IACF,MAAM,oBAAoB,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,oBAAoB;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACvE,OAAO;QACL,SAAS,EAAE,EAAE,EAAE,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,EAAE;QACtD,SAAS,EAAE,CAAC,oBAAoB,CAAC;QACjC,oBAAoB;QACpB,oBAAoB,EAAE,EAAE;QACxB,OAAO,EAAE,CAAC,iBAAiB,CAAC;QAC5B,mBAAmB,EAAE,EAAE;KACxB,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,IAAY,EAAE,IAAY;IACpD,IAAI,IAAI,KAAK,kBAAkB;QAAE,OAAO,EAAE,CAAC;IAC3C,OAAO;QACL,IAAI,KAAK,OAAO;YACd,CAAC,CAAC,iCAAiC;YACnC,CAAC,CAAC,oCAAoC;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAY,EAAE,IAAa;IACnE,MAAM,UAAU,GAAG,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,6BAA6B,CAAC;IAC7E,MAAM,MAAM,GAAG,IAAI;QACjB,CAAC,CAAC,iDAAiD;QACnD,CAAC,CAAC,wFAAwF,CAAC;IAC7F,MAAM,gBAAgB,GAAG,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACxD,OAAO;QACL,KAAK,EAAE;YACL;gBACE,EAAE,EAAE,kBAAkB;gBACtB,MAAM,EAAE,UAAU,GAAG,MAAM;gBAC3B,OAAO,EAAE;oBACP,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE;wBACP;4BACE,OAAO,EAAE,0BAA0B;4BACnC,KAAK,EAAE,EAAE,WAAW,EAAE,iCAAiC,EAAE;yBAC1D;qBACF;iBACF;gBACD,MAAM,EAAE;oBACN;wBACE,EAAE,EAAE,iBAAiB;wBACrB,MAAM,EAAE,aAAa;wBACrB,aAAa,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE;qBAC1C;oBACD;wBACE,EAAE,EAAE,gBAAgB;wBACpB,MAAM,EAAE,aAAa;wBACrB,aAAa,EAAE;4BACb,GAAG,EAAE,uDAAuD;yBAC7D;qBACF;oBACD,GAAG,CAAC,IAAI,KAAK,SAAS;wBACpB,CAAC,CAAC;4BACE;gCACE,EAAE,EAAE,aAAa;gCACjB,MAAM,EAAE,aAAa;gCACrB,aAAa,EAAE;oCACb,GAAG,EAAE,kBAAkB;oCACvB,WAAW,EAAE,UAAU;iCACxB;6BACF;yBACF;wBACH,CAAC,CAAC,EAAE,CAAC;oBACP;wBACE,EAAE,EAAE,wBAAwB;wBAC5B,MAAM,EAAE,iBAAiB;wBACzB,aAAa,EAAE,EAAE;qBAClB;iBACF;gBACD,gBAAgB;gBAChB,aAAa,EAAE,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;aACrD;SACF;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY,EAAE,IAAY;IACtD,MAAM,IAAI,GAAG;QACX,SAAS,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,yBAAyB,CAAC,CAAC;QAC/D,wBAAwB,EAAE,EAAE;QAC5B,aAAa,EAAE,EAAE,iBAAiB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;KACrD,CAAC;IACF,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,kBAAkB;YACrB,OAAO;gBACL,GAAG,IAAI;gBACP,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;gBACpE,GAAG,CAAC,IAAI,KAAK,OAAO;oBAClB,CAAC,CAAC,EAAE,8BAA8B,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,EAAE;oBACpE,CAAC,CAAC;wBACE,+BAA+B,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE;qBAChE,CAAC;aACP,CAAC;QACJ,KAAK,SAAS;YACZ,OAAO;gBACL,GAAG,IAAI;gBACP,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,eAAe,EAAE,CAAC;gBACpD,GAAG,CAAC,IAAI,KAAK,OAAO;oBAClB,CAAC,CAAC;wBACE,gBAAgB,EAAE;4BAChB,YAAY,EAAE,aAAa;4BAC3B,eAAe,EAAE,SAAS;4BAC1B,WAAW,EAAE,CAAC,SAAS,CAAC;yBACzB;wBACD,oBAAoB,EAAE;4BACpB,UAAU,EAAE,SAAS;4BACrB,SAAS,EAAE,eAAe;yBAC3B;qBACF;oBACH,CAAC,CAAC;wBACE,gBAAgB,EAAE,EAAE,aAAa,EAAE,CAAC,oBAAoB,CAAC,EAAE;wBAC3D,qBAAqB,EAAE;4BACrB,UAAU,EAAE,SAAS;4BACrB,SAAS,EAAE,eAAe;yBAC3B;qBACF,CAAC;aACP,CAAC;QACJ;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,WAAoC;IACxD,IAAI,WAAW,CAAC,YAAY,KAAK,UAAU;QAAE,OAAO,aAAa,CAAC;IAClE,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;IAC3C,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;QACtD,CAAC,CAAC,QAAQ;QACV,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAA+B;IACtD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAc,MAAM,CAAC,YAAY,CAAC;IACpD,MAAM,WAAW,GAAG,YAAY;SAC7B,GAAG,CAAC,MAAM,CAAC;SACX,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,iCAAiC,CAAC,CAAC;IACjE,IAAI,CAAC,WAAW;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvE,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACzC,OAAO;QACL,MAAM,EAAE;YACN;gBACE,EAAE,EAAE,wBAAwB;gBAC5B,MAAM;gBACN,YAAY,EAAE,CAAC,iCAAiC,CAAC;aAClD;SACF;QACD,OAAO,EAAE,EAAE;KACZ,CAAC;AACJ,CAAC","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

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

@@ -0,0 +1 @@
+{"version":3,"file":"modules.js","sourceRoot":"","sources":["modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,kBAAkB;AAEjC,mFAAmF;AACnF,MAAM,UAAU,UAAU,CAAC,GAAG,KAAe;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QACzC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACnC,CAAC","sourcesContent":["import { join } from \"node:path\";\n\n/** Locate source modules for Bun development or compiled modules for consumers. */\nexport function recipeFile(...parts: string[]): string {\n  const path = join(import.meta.dirname, ...parts);\n  return import.meta.filename.endsWith(\".ts\")\n    ? path\n    : path.replace(/\\.ts$/, \".js\");\n}\n"]}

package/dist/examples/recipes/repository-skill/.agents/skills/startup-guide/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: startup-guide
+description: Explain how to start this sample application and identify its port.
+---
+
+Read README.md. Explain the exact start command and port from that file.
+Do not change files. Do not invent a different command or port.

package/dist/examples/recipes/repository-skill/.claude/skills/startup-guide/SKILL.md

@@ -0,0 +1,7 @@
+---
+name: startup-guide
+description: Explain how to start this sample application and identify its port.
+---
+
+Read README.md. Explain the exact start command and port from that file.
+Do not change files. Do not invent a different command or port.

package/dist/examples/recipes/repository-skill/README.md

@@ -0,0 +1,3 @@
+# Sample application
+
+Run `bun run dev` to start the application on port `3000`.

package/dist/examples/recipes/run-inputs.js

@@ -0,0 +1,144 @@
+import { recipeFile } from "./modules.js";
+import { readFile, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { record } from "./extension-methods.js";
+import { requireTool } from "./run-options.js";
+function shellQuote(text) {
+    return `'${text.replaceAll("'", "'\\''")}'`;
+}
+function evaluatorCode(test) {
+    if (import.meta.filename.endsWith(".js"))
+        return test;
+    return new Bun.Transpiler({ loader: "ts" }).transformSync(test);
+}
+async function caseFile(options, state) {
+    const value = record(JSON.parse(await readFile(join(import.meta.dirname, "cases", `${options.recipe}.json`), "utf8")));
+    if (options.recipe === "coding-change") {
+        const test = await readFile(recipeFile("coding-change/check.ts"), "utf8");
+        const checks = Array.isArray(value.checks) ? value.checks : [];
+        const check = record(checks[0]);
+        const javascript = evaluatorCode(test);
+        const protectedTest = shellQuote(recipeFile("coding-change/check.ts"));
+        record(check.configuration).run =
+            `test ! -r ${protectedTest}\nnode --input-type=module -e ${shellQuote(javascript)}`;
+    }
+    if (options.fail)
+        negativeFixture(value, options.recipe);
+    const path = join(state, "case.json");
+    await writeFile(path, JSON.stringify(value));
+    return ["--case-file", path];
+}
+function negativeFixture(value, recipe) {
+    if (["coding-change", "semantic"].includes(recipe)) {
+        value.prompt =
+            "Deliberate negative control: leave math.cjs unchanged if present and respond only: npm start on port 9000.";
+        return;
+    }
+    const files = record(record(value.fixture).files);
+    for (const [path, content] of Object.entries(files)) {
+        if (typeof content !== "string")
+            throw new Error("Expected inline fixture text");
+        files[path] = content.replaceAll("3000", "9000");
+    }
+}
+async function extensionFiles(options, state) {
+    const command = join(state, "extension-command.json");
+    await writeFile(command, JSON.stringify([
+        process.execPath,
+        recipeFile("extension.ts"),
+        options.recipe,
+        options.route,
+        options.fail ? "fail" : "pass",
+    ]));
+    const sources = [
+        "extension.ts",
+        "extension-methods.ts",
+        "extension-artifacts.ts",
+        "repository-skill/.agents/skills/startup-guide/SKILL.md",
+        "repository-skill/.claude/skills/startup-guide/SKILL.md",
+    ];
+    return [
+        "--extension-command-file",
+        command,
+        "--case-id",
+        "recipe-extension",
+        ...sources.flatMap((path) => ["--extension-source-file", recipeFile(path)]),
+    ];
+}
+export async function recipeInputs(options, state) {
+    if (["lifecycle", "repository-skill", "plugins"].includes(options.recipe))
+        return extensionFiles(options, state);
+    return caseFile(options, state);
+}
+async function codexAuthentication(options, state) {
+    if (!options.dry) {
+        const path = process.env.SEVRO_RECIPE_CODEX_AUTH;
+        if (!path)
+            throw new Error("Set SEVRO_RECIPE_CODEX_AUTH to your private Codex auth.json path");
+        return path;
+    }
+    const path = join(state, "dry-auth.json");
+    await writeFile(path, "{}\n");
+    return path;
+}
+export async function hostArguments(options, state) {
+    if (options.route === "deterministic")
+        return ["--adapter-module", recipeFile("candidate.ts")];
+    const model = selectedModel(options.dry, "SEVRO_RECIPE_MODEL");
+    if (!model)
+        throw new Error("Set SEVRO_RECIPE_MODEL to an available model for the selected native host");
+    const args = [
+        "--host",
+        options.route,
+        "--model",
+        model,
+        "--effort",
+        "medium",
+    ];
+    if (options.route === "codex")
+        return [
+            ...args,
+            "--codex-bin",
+            requireTool("codex"),
+            "--codex-auth-file",
+            await codexAuthentication(options, state),
+        ];
+    return [
+        ...args,
+        "--claude-bin",
+        requireTool("claude"),
+        ...(options.recipe === "repository-skill"
+            ? ["--claude-project-settings"]
+            : []),
+    ];
+}
+export async function semanticArguments(options, state) {
+    if (options.recipe !== "semantic")
+        return [];
+    if (options.route === "deterministic")
+        return ["--semantic-adapter-module", recipeFile("semantic-judge.ts")];
+    const model = selectedModel(options.dry, "SEVRO_RECIPE_JUDGE_MODEL");
+    if (!model)
+        throw new Error("Set SEVRO_RECIPE_JUDGE_MODEL for the separate Codex judge route");
+    const args = [
+        "--semantic-host",
+        "codex",
+        "--semantic-model",
+        model,
+        "--semantic-effort",
+        "medium",
+    ];
+    if (options.route === "codex")
+        return args;
+    return [
+        ...args,
+        "--codex-bin",
+        requireTool("codex"),
+        "--codex-auth-file",
+        await codexAuthentication(options, state),
+    ];
+}
+function selectedModel(dry, variable) {
+    return dry ? "dry-model" : process.env[variable];
+}
+//# sourceMappingURL=run-inputs.js.map

package/dist/examples/recipes/run-inputs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-inputs.js","sourceRoot":"","sources":["run-inputs.ts"],"names":[],"mappings":"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","sourcesContent":["import { recipeFile } from \"./modules\";\nimport { readFile, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport { record } from \"./extension-methods\";\nimport { requireTool, type RecipeOptions } from \"./run-options\";\n\nfunction shellQuote(text: string): string {\n  return `'${text.replaceAll(\"'\", \"'\\\\''\")}'`;\n}\n\nfunction evaluatorCode(test: string): string {\n  if (import.meta.filename.endsWith(\".js\")) return test;\n  return new Bun.Transpiler({ loader: \"ts\" }).transformSync(test);\n}\n\nasync function caseFile(\n  options: RecipeOptions,\n  state: string,\n): Promise<string[]> {\n  const value = record(\n    JSON.parse(\n      await readFile(\n        join(import.meta.dirname, \"cases\", `${options.recipe}.json`),\n        \"utf8\",\n      ),\n    ) as unknown,\n  );\n  if (options.recipe === \"coding-change\") {\n    const test = await readFile(recipeFile(\"coding-change/check.ts\"), \"utf8\");\n    const checks: unknown[] = Array.isArray(value.checks) ? value.checks : [];\n    const check = record(checks[0]);\n    const javascript = evaluatorCode(test);\n    const protectedTest = shellQuote(recipeFile(\"coding-change/check.ts\"));\n    record(check.configuration).run =\n      `test ! -r ${protectedTest}\\nnode --input-type=module -e ${shellQuote(javascript)}`;\n  }\n  if (options.fail) negativeFixture(value, options.recipe);\n  const path = join(state, \"case.json\");\n  await writeFile(path, JSON.stringify(value));\n  return [\"--case-file\", path];\n}\n\nfunction negativeFixture(value: Record<string, unknown>, recipe: string): void {\n  if ([\"coding-change\", \"semantic\"].includes(recipe)) {\n    value.prompt =\n      \"Deliberate negative control: leave math.cjs unchanged if present and respond only: npm start on port 9000.\";\n    return;\n  }\n  const files = record(record(value.fixture).files);\n  for (const [path, content] of Object.entries(files)) {\n    if (typeof content !== \"string\")\n      throw new Error(\"Expected inline fixture text\");\n    files[path] = content.replaceAll(\"3000\", \"9000\");\n  }\n}\n\nasync function extensionFiles(\n  options: RecipeOptions,\n  state: string,\n): Promise<string[]> {\n  const command = join(state, \"extension-command.json\");\n  await writeFile(\n    command,\n    JSON.stringify([\n      process.execPath,\n      recipeFile(\"extension.ts\"),\n      options.recipe,\n      options.route,\n      options.fail ? \"fail\" : \"pass\",\n    ]),\n  );\n  const sources = [\n    \"extension.ts\",\n    \"extension-methods.ts\",\n    \"extension-artifacts.ts\",\n    \"repository-skill/.agents/skills/startup-guide/SKILL.md\",\n    \"repository-skill/.claude/skills/startup-guide/SKILL.md\",\n  ];\n  return [\n    \"--extension-command-file\",\n    command,\n    \"--case-id\",\n    \"recipe-extension\",\n    ...sources.flatMap((path) => [\"--extension-source-file\", recipeFile(path)]),\n  ];\n}\n\nexport async function recipeInputs(\n  options: RecipeOptions,\n  state: string,\n): Promise<string[]> {\n  if ([\"lifecycle\", \"repository-skill\", \"plugins\"].includes(options.recipe))\n    return extensionFiles(options, state);\n  return caseFile(options, state);\n}\n\nasync function codexAuthentication(\n  options: RecipeOptions,\n  state: string,\n): Promise<string> {\n  if (!options.dry) {\n    const path = process.env.SEVRO_RECIPE_CODEX_AUTH;\n    if (!path)\n      throw new Error(\n        \"Set SEVRO_RECIPE_CODEX_AUTH to your private Codex auth.json path\",\n      );\n    return path;\n  }\n  const path = join(state, \"dry-auth.json\");\n  await writeFile(path, \"{}\\n\");\n  return path;\n}\n\nexport async function hostArguments(\n  options: RecipeOptions,\n  state: string,\n): Promise<string[]> {\n  if (options.route === \"deterministic\")\n    return [\"--adapter-module\", recipeFile(\"candidate.ts\")];\n  const model = selectedModel(options.dry, \"SEVRO_RECIPE_MODEL\");\n  if (!model)\n    throw new Error(\n      \"Set SEVRO_RECIPE_MODEL to an available model for the selected native host\",\n    );\n  const args = [\n    \"--host\",\n    options.route,\n    \"--model\",\n    model,\n    \"--effort\",\n    \"medium\",\n  ];\n  if (options.route === \"codex\")\n    return [\n      ...args,\n      \"--codex-bin\",\n      requireTool(\"codex\"),\n      \"--codex-auth-file\",\n      await codexAuthentication(options, state),\n    ];\n  return [\n    ...args,\n    \"--claude-bin\",\n    requireTool(\"claude\"),\n    ...(options.recipe === \"repository-skill\"\n      ? [\"--claude-project-settings\"]\n      : []),\n  ];\n}\n\nexport async function semanticArguments(\n  options: RecipeOptions,\n  state: string,\n): Promise<string[]> {\n  if (options.recipe !== \"semantic\") return [];\n  if (options.route === \"deterministic\")\n    return [\"--semantic-adapter-module\", recipeFile(\"semantic-judge.ts\")];\n  const model = selectedModel(options.dry, \"SEVRO_RECIPE_JUDGE_MODEL\");\n  if (!model)\n    throw new Error(\n      \"Set SEVRO_RECIPE_JUDGE_MODEL for the separate Codex judge route\",\n    );\n  const args = [\n    \"--semantic-host\",\n    \"codex\",\n    \"--semantic-model\",\n    model,\n    \"--semantic-effort\",\n    \"medium\",\n  ];\n  if (options.route === \"codex\") return args;\n  return [\n    ...args,\n    \"--codex-bin\",\n    requireTool(\"codex\"),\n    \"--codex-auth-file\",\n    await codexAuthentication(options, state),\n  ];\n}\n\nfunction selectedModel(dry: boolean, variable: string): string | undefined {\n  return dry ? \"dry-model\" : process.env[variable];\n}\n"]}

package/dist/examples/recipes/run-options.js

@@ -0,0 +1,103 @@
+import { spawnSync } from "node:child_process";
+import { which } from "./executable.js";
+import { delimiter, isAbsolute, join } from "node:path";
+import { homedir } from "node:os";
+export const recipeNames = [
+    "coding-change",
+    "host-tools",
+    "node",
+    "python-uv",
+    "mise",
+    "semantic",
+    "lifecycle",
+    "repository-skill",
+    "plugins",
+];
+function validateSelection(recipe, route, flags) {
+    if (!recipeNames.includes(recipe))
+        throw new Error(`Choose a recipe: ${recipeNames.join(", ")}`);
+    if (!["deterministic", "codex", "claude"].includes(route))
+        throw new Error("Choose deterministic, codex, or claude");
+    if (flags.some((flag) => !["--dry", "--fail", "--goals-only"].includes(flag)))
+        throw new Error("Supported flags: --dry --fail --goals-only");
+}
+function validateNativeRecipe(recipe, route) {
+    if (["repository-skill", "plugins"].includes(recipe) &&
+        route === "deterministic")
+        throw new Error("Skill and plugin recipes require codex or claude (add --dry to prepare without model calls)");
+}
+export function selectedOptions() {
+    const [recipe = "", route = "deterministic", ...flags] = process.argv.slice(2);
+    validateSelection(recipe, route, flags);
+    validateNativeRecipe(recipe, route);
+    validateGoalsStep(flags);
+    return {
+        recipe,
+        route,
+        dry: flags.includes("--dry"),
+        fail: flags.includes("--fail"),
+        goalsOnly: flags.includes("--goals-only"),
+    };
+}
+function validateGoalsStep(flags) {
+    if (flags.includes("--goals-only") && !flags.includes("--dry"))
+        throw new Error("--goals-only is a dry preparation step; omit it for the complete hook recipe");
+}
+export function requireTool(name) {
+    const path = which(name);
+    if (!path)
+        throw new Error(`Recipe prerequisite missing: install ${name} and put it on PATH`);
+    return path;
+}
+export function runtimeFile(options) {
+    const files = {
+        "coding-change": "path",
+        "host-tools": "path",
+        node: "path",
+        "python-uv": "python-uv",
+        mise: "mise",
+        plugins: options.goalsOnly ? "goals" : "plugins",
+    };
+    return join(import.meta.dirname, "runtime", `${files[options.recipe] ?? "empty"}.json`);
+}
+function languagePrerequisites(recipe) {
+    if (recipe === "python-uv")
+        process.env.RECIPE_PYTHON ??= requireTool("python3");
+    if (recipe === "mise")
+        selectMiseNode();
+    if (recipe === "host-tools")
+        requireStandaloneRipgrep();
+}
+function requireStandaloneRipgrep() {
+    const roots = [
+        process.env.CODEX_HOME ?? join(homedir(), ".codex"),
+        process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), ".claude"),
+    ];
+    const paths = (process.env.PATH ?? "")
+        .split(delimiter)
+        .filter((entry) => !roots.some((root) => entry.startsWith(root)));
+    if (!which("rg", paths.join(delimiter)))
+        throw new Error("Install standalone ripgrep outside Codex/Claude credential directories, then put it on PATH (for example brew install ripgrep or apt-get install ripgrep)");
+}
+function selectMiseNode() {
+    const result = spawnSync(requireTool("mise"), ["where", "node@24.13.0"], {
+        encoding: "utf8",
+    });
+    const installation = result.stdout.trim();
+    if (result.status !== 0 || !isAbsolute(installation))
+        throw new Error("Install the recipe's Node with mise install node@24.13.0 before running it");
+    process.env.PATH = `${join(installation, "bin")}${delimiter}${process.env.PATH ?? "/usr/bin:/bin"}`;
+}
+export function runtimePrerequisites(recipe) {
+    const tools = {
+        "coding-change": ["node"],
+        "host-tools": ["rg"],
+        node: ["node"],
+        "python-uv": ["uv", "python3"],
+        mise: ["mise"],
+    };
+    for (const tool of tools[recipe] ?? [])
+        requireTool(tool);
+    languagePrerequisites(recipe);
+}
+//# sourceMappingURL=run-options.js.map

package/dist/examples/recipes/run-options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-options.js","sourceRoot":"","sources":["run-options.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawnSync } from \"node:child_process\";\nimport { which } from \"./executable\";\nimport { delimiter, isAbsolute, join } from \"node:path\";\nimport { homedir } from \"node:os\";\n\nexport const recipeNames = [\n  \"coding-change\",\n  \"host-tools\",\n  \"node\",\n  \"python-uv\",\n  \"mise\",\n  \"semantic\",\n  \"lifecycle\",\n  \"repository-skill\",\n  \"plugins\",\n];\n\nfunction validateSelection(\n  recipe: string,\n  route: string,\n  flags: string[],\n): void {\n  if (!recipeNames.includes(recipe))\n    throw new Error(`Choose a recipe: ${recipeNames.join(\", \")}`);\n  if (![\"deterministic\", \"codex\", \"claude\"].includes(route))\n    throw new Error(\"Choose deterministic, codex, or claude\");\n  if (flags.some((flag) => ![\"--dry\", \"--fail\", \"--goals-only\"].includes(flag)))\n    throw new Error(\"Supported flags: --dry --fail --goals-only\");\n}\n\nfunction validateNativeRecipe(recipe: string, route: string): void {\n  if (\n    [\"repository-skill\", \"plugins\"].includes(recipe) &&\n    route === \"deterministic\"\n  )\n    throw new Error(\n      \"Skill and plugin recipes require codex or claude (add --dry to prepare without model calls)\",\n    );\n}\n\nexport function selectedOptions() {\n  const [recipe = \"\", route = \"deterministic\", ...flags] =\n    process.argv.slice(2);\n  validateSelection(recipe, route, flags);\n  validateNativeRecipe(recipe, route);\n  validateGoalsStep(flags);\n  return {\n    recipe,\n    route,\n    dry: flags.includes(\"--dry\"),\n    fail: flags.includes(\"--fail\"),\n    goalsOnly: flags.includes(\"--goals-only\"),\n  };\n}\nexport type RecipeOptions = ReturnType<typeof selectedOptions>;\n\nfunction validateGoalsStep(flags: string[]): void {\n  if (flags.includes(\"--goals-only\") && !flags.includes(\"--dry\"))\n    throw new Error(\n      \"--goals-only is a dry preparation step; omit it for the complete hook recipe\",\n    );\n}\n\nexport function requireTool(name: string): string {\n  const path = which(name);\n  if (!path)\n    throw new Error(\n      `Recipe prerequisite missing: install ${name} and put it on PATH`,\n    );\n  return path;\n}\n\nexport function runtimeFile(options: RecipeOptions): string {\n  const files: Record<string, string> = {\n    \"coding-change\": \"path\",\n    \"host-tools\": \"path\",\n    node: \"path\",\n    \"python-uv\": \"python-uv\",\n    mise: \"mise\",\n    plugins: options.goalsOnly ? \"goals\" : \"plugins\",\n  };\n  return join(\n    import.meta.dirname,\n    \"runtime\",\n    `${files[options.recipe] ?? \"empty\"}.json`,\n  );\n}\n\nfunction languagePrerequisites(recipe: string): void {\n  if (recipe === \"python-uv\")\n    process.env.RECIPE_PYTHON ??= requireTool(\"python3\");\n  if (recipe === \"mise\") selectMiseNode();\n  if (recipe === \"host-tools\") requireStandaloneRipgrep();\n}\n\nfunction requireStandaloneRipgrep(): void {\n  const roots = [\n    process.env.CODEX_HOME ?? join(homedir(), \".codex\"),\n    process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), \".claude\"),\n  ];\n  const paths = (process.env.PATH ?? \"\")\n    .split(delimiter)\n    .filter((entry) => !roots.some((root) => entry.startsWith(root)));\n  if (!which(\"rg\", paths.join(delimiter)))\n    throw new Error(\n      \"Install standalone ripgrep outside Codex/Claude credential directories, then put it on PATH (for example brew install ripgrep or apt-get install ripgrep)\",\n    );\n}\n\nfunction selectMiseNode(): void {\n  const result = spawnSync(requireTool(\"mise\"), [\"where\", \"node@24.13.0\"], {\n    encoding: \"utf8\",\n  });\n  const installation = result.stdout.trim();\n  if (result.status !== 0 || !isAbsolute(installation))\n    throw new Error(\n      \"Install the recipe's Node with mise install node@24.13.0 before running it\",\n    );\n  process.env.PATH = `${join(installation, \"bin\")}${delimiter}${process.env.PATH ?? \"/usr/bin:/bin\"}`;\n}\n\nexport function runtimePrerequisites(recipe: string): void {\n  const tools: Record<string, string[]> = {\n    \"coding-change\": [\"node\"],\n    \"host-tools\": [\"rg\"],\n    node: [\"node\"],\n    \"python-uv\": [\"uv\", \"python3\"],\n    mise: [\"mise\"],\n  };\n  for (const tool of tools[recipe] ?? []) requireTool(tool);\n  languagePrerequisites(recipe);\n}\n"]}

package/dist/examples/recipes/run.js

@@ -0,0 +1,62 @@
+import { spawn } from "node:child_process";
+import { Readable } from "node:stream";
+import { mkdir, realpath, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { hostArguments, recipeInputs, semanticArguments } from "./run-inputs.js";
+import { runtimeFile, runtimePrerequisites, selectedOptions, } from "./run-options.js";
+const options = selectedOptions();
+runtimePrerequisites(options.recipe);
+const mode = options.dry ? "dry" : options.fail ? "fail" : "pass";
+const state = resolve(".sevro-recipes", options.recipe, options.route, options.goalsOnly ? "goals" : mode);
+await mkdir(join(state, "project"), { recursive: true });
+await mkdir(join(state, "config"), { recursive: true });
+const root = await realpath(state);
+const cli = process.env.SEVRO_RECIPE_CLI ??
+    resolve(import.meta.dirname, import.meta.filename.endsWith(".ts")
+        ? "../../src/cli.ts"
+        : "../../src/cli.js");
+const args = [
+    process.execPath,
+    cli,
+    "run",
+    "--json",
+    "--project-root",
+    join(root, "project"),
+    "--config-root",
+    join(root, "config"),
+    "--results-root",
+    join(root, "results"),
+    "--runtime-config-file",
+    runtimeFile(options),
+    "--condition",
+    "passive",
+    "--trials",
+    "1",
+    "--threshold",
+    "1",
+    "--shell-isolation",
+    "--protected-root",
+    import.meta.dirname,
+    ...(await recipeInputs(options, root)),
+    ...(await hostArguments(options, root)),
+    ...(await semanticArguments(options, root)),
+    ...(options.dry ? ["--dry"] : []),
+];
+const child = spawn(process.execPath, args.slice(1), {
+    env: { ...process.env, SEVRO_RECIPE_FAIL: options.fail ? "1" : "0" },
+    stdio: ["ignore", "pipe", "inherit"],
+});
+const [output, code] = await Promise.all([
+    new Response(Readable.toWeb(child.stdout)).text(),
+    new Promise((resolve, reject) => {
+        child.once("error", reject);
+        child.once("close", (code) => {
+            resolve(code ?? 1);
+        });
+    }),
+]);
+await writeFile(join(root, "result.json"), output);
+process.stderr.write(`Recipe result: ${join(root, "result.json")}\n`);
+process.stdout.write(output);
+process.exit(code);
+//# sourceMappingURL=run.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["run.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\nimport { Readable } from \"node:stream\";\nimport { mkdir, realpath, writeFile } from \"node:fs/promises\";\nimport { join, resolve } from \"node:path\";\nimport { hostArguments, recipeInputs, semanticArguments } from \"./run-inputs\";\nimport {\n  runtimeFile,\n  runtimePrerequisites,\n  selectedOptions,\n} from \"./run-options\";\n\nconst options = selectedOptions();\nruntimePrerequisites(options.recipe);\nconst mode = options.dry ? \"dry\" : options.fail ? \"fail\" : \"pass\";\nconst state = resolve(\n  \".sevro-recipes\",\n  options.recipe,\n  options.route,\n  options.goalsOnly ? \"goals\" : mode,\n);\nawait mkdir(join(state, \"project\"), { recursive: true });\nawait mkdir(join(state, \"config\"), { recursive: true });\nconst root = await realpath(state);\nconst cli =\n  process.env.SEVRO_RECIPE_CLI ??\n  resolve(\n    import.meta.dirname,\n    import.meta.filename.endsWith(\".ts\")\n      ? \"../../src/cli.ts\"\n      : \"../../src/cli.js\",\n  );\nconst args = [\n  process.execPath,\n  cli,\n  \"run\",\n  \"--json\",\n  \"--project-root\",\n  join(root, \"project\"),\n  \"--config-root\",\n  join(root, \"config\"),\n  \"--results-root\",\n  join(root, \"results\"),\n  \"--runtime-config-file\",\n  runtimeFile(options),\n  \"--condition\",\n  \"passive\",\n  \"--trials\",\n  \"1\",\n  \"--threshold\",\n  \"1\",\n  \"--shell-isolation\",\n  \"--protected-root\",\n  import.meta.dirname,\n  ...(await recipeInputs(options, root)),\n  ...(await hostArguments(options, root)),\n  ...(await semanticArguments(options, root)),\n  ...(options.dry ? [\"--dry\"] : []),\n];\nconst child = spawn(process.execPath, args.slice(1), {\n  env: { ...process.env, SEVRO_RECIPE_FAIL: options.fail ? \"1\" : \"0\" },\n  stdio: [\"ignore\", \"pipe\", \"inherit\"],\n});\nconst [output, code] = await Promise.all([\n  new Response(\n    Readable.toWeb(child.stdout) as unknown as ReadableStream<Uint8Array>,\n  ).text(),\n  new Promise<number>((resolve, reject) => {\n    child.once(\"error\", reject);\n    child.once(\"close\", (code) => {\n      resolve(code ?? 1);\n    });\n  }),\n]);\nawait writeFile(join(root, \"result.json\"), output);\nprocess.stderr.write(`Recipe result: ${join(root, \"result.json\")}\\n`);\nprocess.stdout.write(output);\nprocess.exit(code);\n"]}

package/dist/examples/recipes/runtime/empty.json

@@ -0,0 +1 @@
+{ "format": "sevro.runtime.v1" }

package/dist/examples/recipes/runtime/goals.json

@@ -0,0 +1 @@
+{ "format": "sevro.runtime.v1", "hooks": { "nativeGoal": true } }

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

@@ -0,0 +1,6 @@
+{
+  "format": "sevro.runtime.v1",
+  "environment": {
+    "inherit": ["PATH"]
+  }
+}

package/dist/examples/recipes/runtime/path.json

@@ -0,0 +1 @@
+{ "format": "sevro.runtime.v1", "environment": { "inherit": ["PATH"] } }

package/dist/examples/recipes/runtime/plugins.json

@@ -0,0 +1,4 @@
+{
+  "format": "sevro.runtime.v1",
+  "hooks": { "nativeGoal": true, "plugins": ["startup"] }
+}

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

@@ -0,0 +1,10 @@
+{
+  "format": "sevro.runtime.v1",
+  "environment": {
+    "inherit": ["PATH", "RECIPE_PYTHON"],
+    "set": {
+      "UV_CACHE_DIR": "{{sevro.runtime}}/uv-cache",
+      "UV_PYTHON_DOWNLOADS": "never"
+    }
+  }
+}

package/dist/examples/recipes/semantic-judge.js

@@ -0,0 +1,27 @@
+/** Protocol control only: use a real judge for qualitative model assessment. */
+const judge = {
+    id: "recipes.protocol-judge",
+    model: "exact-fixture-oracle",
+    effort: "none",
+    run({ prompt }) {
+        const match = /<candidate-response-json>\s*([\s\S]*?)\s*<\/candidate-response-json>/.exec(prompt);
+        if (!match?.[1])
+            throw new Error("Missing semantic candidate response");
+        const candidate = JSON.parse(match[1]);
+        const passed = candidate === "Run bun run dev on port 3000.";
+        return Promise.resolve({
+            complete: true,
+            finalMessage: JSON.stringify({
+                checks: [
+                    {
+                        id: "startup-meaning",
+                        verdict: passed ? "pass" : "fail",
+                        reason: "Exact deterministic fixture oracle; no model judgment was made.",
+                    },
+                ],
+            }),
+        });
+    },
+};
+export default judge;
+//# sourceMappingURL=semantic-judge.js.map

package/dist/examples/recipes/semantic-judge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-judge.js","sourceRoot":"","sources":["semantic-judge.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,KAAK,GAAG;IACZ,EAAE,EAAE,wBAAwB;IAC5B,KAAK,EAAE,sBAAsB;IAC7B,MAAM,EAAE,MAAM;IACd,GAAG,CAAC,EAAE,MAAM,EAAsB;QAChC,MAAM,KAAK,GACT,sEAAsE,CAAC,IAAI,CACzE,MAAM,CACP,CAAC;QACJ,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACxE,MAAM,SAAS,GAAY,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,SAAS,KAAK,+BAA+B,CAAC;QAC7D,OAAO,OAAO,CAAC,OAAO,CAAC;YACrB,QAAQ,EAAE,IAAI;YACd,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC;gBAC3B,MAAM,EAAE;oBACN;wBACE,EAAE,EAAE,iBAAiB;wBACrB,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;wBACjC,MAAM,EACJ,iEAAiE;qBACpE;iBACF;aACF,CAAC;SACH,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AACF,eAAe,KAAK,CAAC","sourcesContent":["/** Protocol control only: use a real judge for qualitative model assessment. */\nconst judge = {\n  id: \"recipes.protocol-judge\",\n  model: \"exact-fixture-oracle\",\n  effort: \"none\",\n  run({ prompt }: { prompt: string }) {\n    const match =\n      /<candidate-response-json>\\s*([\\s\\S]*?)\\s*<\\/candidate-response-json>/.exec(\n        prompt,\n      );\n    if (!match?.[1]) throw new Error(\"Missing semantic candidate response\");\n    const candidate: unknown = JSON.parse(match[1]);\n    const passed = candidate === \"Run bun run dev on port 3000.\";\n    return Promise.resolve({\n      complete: true,\n      finalMessage: JSON.stringify({\n        checks: [\n          {\n            id: \"startup-meaning\",\n            verdict: passed ? \"pass\" : \"fail\",\n            reason:\n              \"Exact deterministic fixture oracle; no model judgment was made.\",\n          },\n        ],\n      }),\n    });\n  },\n};\nexport default judge;\n"]}

package/dist/examples/templates/coding/adapter.js

@@ -0,0 +1,14 @@
+import { writeFile } from "node:fs/promises";
+import { join } from "node:path";
+/** Deterministic file editor; it exercises the evaluator, not model coding ability. */
+export default {
+    id: "template.coding",
+    model: "deterministic-editor",
+    effort: "none",
+    async run({ workspace }) {
+        if (process.env.SEVRO_TEMPLATE_FAIL !== "1")
+            await writeFile(join(workspace, "add.sh"), 'add() { echo "$(( $1 + $2 ))"; }\n');
+        return { finalMessage: "Completed the coding task.", complete: true };
+    },
+};
+//# sourceMappingURL=adapter.js.map

package/dist/examples/templates/coding/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,yBAAyB;AAC7C,OAAO,EAAE,IAAI,EAAE,kBAAkB;AAEjC,uFAAuF;AACvF,eAAe;IACb,EAAE,EAAE,iBAAiB;IACrB,KAAK,EAAE,sBAAsB;IAC7B,MAAM,EAAE,MAAM;IACd,KAAK,CAAC,GAAG,CAAC,EAAE,SAAS,EAAyB;QAC5C,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,GAAG;YACzC,MAAM,SAAS,CACb,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EACzB,oCAAoC,CACrC,CAAC;QACJ,OAAO,EAAE,YAAY,EAAE,4BAA4B,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACxE,CAAC;CACF,CAAC","sourcesContent":["import { writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\n\n/** Deterministic file editor; it exercises the evaluator, not model coding ability. */\nexport default {\n  id: \"template.coding\",\n  model: \"deterministic-editor\",\n  effort: \"none\",\n  async run({ workspace }: { workspace: string }) {\n    if (process.env.SEVRO_TEMPLATE_FAIL !== \"1\")\n      await writeFile(\n        join(workspace, \"add.sh\"),\n        'add() { echo \"$(( $1 + $2 ))\"; }\\n',\n      );\n    return { finalMessage: \"Completed the coding task.\", complete: true };\n  },\n};\n"]}

package/dist/examples/templates/coding/case.json

@@ -0,0 +1,15 @@
+{
+  "id": "coding-addition",
+  "prompt": "Fix add.sh so add computes integer addition. Preserve the add shell function interface.",
+  "fixture": { "files": { "add.sh": "add() { echo \"$(( $1 - $2 ))\"; }\n" } },
+  "checks": [
+    {
+      "id": "addition",
+      "grader": "sevro.shell",
+      "configuration": {
+        "run": ". ./add.sh; test \"$(add 2 3)\" = 5 && test \"$(add -2 -3)\" = -5 && test \"$(add 0 0)\" = 0"
+      }
+    }
+  ],
+  "requiredEvidence": []
+}

package/dist/examples/templates/repository-skill/.agents/skills/startup-guide/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: startup-guide
+description: Explain the sample application's start command and port.
+---
+
+Read README.md. State the exact start command and port. Do not change files.