@pome-sh/cli 0.23.38 → 0.23.40

package/dist/build-info.json

@@ -1,6 +1,6 @@
 {
   "package": "pome-sh",
-  "version": "0.23.38",
-  "git_sha": "1ed93af52b8c12a3cfacdcf438fdc53fc5633a41",
-  "build_time": "2026-08-13T01:42:30.724Z"
+  "version": "0.23.40",
+  "git_sha": "3768d4bce739655695ed55d6167ac3076ce188bd",
+  "build_time": "2026-08-13T02:18:00.852Z"
 }

package/dist/{checks-PZSMAVLY.js → checks-A5EFOMZS.js}

@@ -183,7 +183,7 @@ async function checkTwinReachable(_configDir) {
   });
   let harness;
   try {
-    const { bootTwin } = await import('./twinHarness-XO47SYBH.js');
+    const { bootTwin } = await import('./twinHarness-NMFJCPJE.js');
     harness = await bootTwin({
       twin: "github",
       seedState: void 0,

package/dist/{chunk-3OVV6JUQ.js → chunk-2A5HJP46.js}

@@ -1,6 +1,6 @@
 // ../packages/twin-github/package.json
 var package_default = {
-  version: "0.10.10"};
+  version: "0.10.11"};
 
 // ../packages/twin-slack/package.json
 var package_default2 = {
@@ -39,7 +39,7 @@ var TWIN_REGISTRY = {
         defaultSeedState,
         GitHubDomain,
         openGitHubCloneDatabase
-      } = await import('./src-ATIALTX2.js');
+      } = await import('./src-XBWNIRBG.js');
       const db = openGitHubCloneDatabase();
       const domain = new GitHubDomain(db);
       domain.seed(seedState === void 0 ? defaultSeedState() : seedState);
@@ -173,7 +173,7 @@ var TWIN_REGISTRY = {
   }
 };
 async function createGitHubSmokeApp() {
-  const { createGitHubCloneApp } = await import('./src-ATIALTX2.js');
+  const { createGitHubCloneApp } = await import('./src-XBWNIRBG.js');
   return createGitHubCloneApp();
 }
 function defaultPortFor(twin, env = process.env) {

package/dist/{chunk-MUQX7EHA.js → chunk-ATIYRECS.js}

@@ -1,5 +1,5 @@
 import { readManifest, normalizeManifestTwins } from './chunk-ABM3CMQB.js';
-import { createHostedClient, perTwinReturnedByCloud, parseTaskFile, runAgentCommand, writeRunArtifactsCore, toTwinHttpEvent, redactJsonl, uploadRunBlobs, scoreFromFinalizeResponse, scoreStatus, evaluationCounts } from './chunk-EKQQYW7E.js';
+import { createHostedClient, perTwinReturnedByCloud, parseTaskFile, runAgentCommand, writeRunArtifactsCore, toTwinHttpEvent, redactJsonl, uploadRunBlobs, scoreFromFinalizeResponse, scoreStatus, evaluationCounts } from './chunk-UHX5HOBR.js';
 import { MOUNTED_TWINS, HostedAuthError, HostedDiscardRefusedError, HostedQuotaError, HostedOrchError, HostedTrialError, agentResponseSchema } from './chunk-X66JOOO7.js';
 import { redactSecrets, redactEvent } from './chunk-SG6ZTIMT.js';
 import { randomUUID, createHash } from 'node:crypto';

package/dist/{chunk-YL4FHI3J.js → chunk-EJFMWBZE.js}

@@ -1,4 +1,4 @@
-import { TWIN_NAMES, isTwinName, TWIN_REGISTRY } from './chunk-3OVV6JUQ.js';
+import { TWIN_NAMES, isTwinName, TWIN_REGISTRY } from './chunk-2A5HJP46.js';
 import { createFileBackedRecorderStore, createRecorderStore } from './chunk-OW7VVW6X.js';
 
 // src/recorder/recorder.ts

package/dist/{chunk-7GHIB4HM.js → chunk-F4V3FN3A.js}

@@ -1,7 +1,7 @@
 import { getAvailablePort } from './chunk-XDU6TD4O.js';
 import { buildEgressAllowlist, readBlockedEgress } from './chunk-CBFKZZBR.js';
-import { parseTaskFile, seedStateForTwin, runAgentCommand, writeRunArtifactsCore } from './chunk-EKQQYW7E.js';
-import { createRecorder, bootTwin } from './chunk-YL4FHI3J.js';
+import { parseTaskFile, seedStateForTwin, runAgentCommand, writeRunArtifactsCore } from './chunk-UHX5HOBR.js';
+import { createRecorder, bootTwin } from './chunk-EJFMWBZE.js';
 import { eventSchema } from './chunk-VBATFCWR.js';
 import { redactSecrets, redactEvent } from './chunk-SG6ZTIMT.js';
 import { serve } from '@hono/node-server';

package/dist/{chunk-EKQQYW7E.js → chunk-UHX5HOBR.js}

@@ -2,7 +2,7 @@ import { criterionSchema, finalizeResponseSchema, HostedDiscardRefusedError, Hos
 import { seedSchema, parseSeed, defaultSeedState as defaultSeedState$2 } from './chunk-KIUIKAVU.js';
 import { gmailSeedSchema, defaultSeedState } from './chunk-NJ246QPJ.js';
 import { linearSeedSchema, defaultSeedState as defaultSeedState$1 } from './chunk-ZKID2HS3.js';
-import { isTwinName, TWIN_REGISTRY } from './chunk-3OVV6JUQ.js';
+import { isTwinName, TWIN_REGISTRY } from './chunk-2A5HJP46.js';
 import { toTwinHttpEventRow } from './chunk-OW7VVW6X.js';
 import { redactEvent, redactSecrets } from './chunk-SG6ZTIMT.js';
 import { mkdir, appendFile, writeFile, readFile } from 'node:fs/promises';
@@ -1248,13 +1248,15 @@ function normalizeAgentSdk(value) {
   return trimmed.length > 0 ? trimmed : null;
 }
 
+// ../packages/wire/dist/run-completeness.js
+var PRE_SATISFIED_REASON = "already_true_in_seed";
+
 // src/hosted/evalResultView.ts
 function outcomeOf(result) {
   if (result.outcome) return result.outcome;
   if (result.skipped) return "skipped";
   return result.passed ? "passed" : "failed";
 }
-var PRE_SATISFIED_REASON = "already_true_in_seed";
 function isPreSatisfied(result) {
   return result.skipped && result.reason === PRE_SATISFIED_REASON;
 }

package/dist/{runDemo-F722I6AW.js → runDemo-4YTN6E2H.js}

@@ -1,16 +1,16 @@
 import { newGroupId, reassuranceBox, twinReadyLine, trialsHeaderLine, trialLine, summaryLines, evaluatingLine, criterionPhrase } from './chunk-RGZBC7NF.js';
 import { DemoCapacityError, capacityLabel, parseCapacityMarker, capacityKindFrom } from './chunk-ZX4WNSZ5.js';
-import { runTask, demoTaskPath, DEMO_TASK_NAME, DEMO_REPO } from './chunk-7GHIB4HM.js';
+import { runTask, demoTaskPath, DEMO_TASK_NAME, DEMO_REPO } from './chunk-F4V3FN3A.js';
 import { getAvailablePort } from './chunk-XDU6TD4O.js';
 import './chunk-CBFKZZBR.js';
-import { createHostedClient, parseTaskFile, uploadRunBlobs, scoreFromFinalizeResponse, scoreStatus, outcomeOf } from './chunk-EKQQYW7E.js';
+import { createHostedClient, parseTaskFile, uploadRunBlobs, scoreFromFinalizeResponse, scoreStatus, outcomeOf } from './chunk-UHX5HOBR.js';
 import './chunk-NW7HGA2K.js';
 import { HostedQuotaError, HostedOrchError } from './chunk-X66JOOO7.js';
 import './chunk-KIUIKAVU.js';
 import './chunk-NJ246QPJ.js';
 import './chunk-ZKID2HS3.js';
-import { bootTwin } from './chunk-YL4FHI3J.js';
-import './chunk-3OVV6JUQ.js';
+import { bootTwin } from './chunk-EJFMWBZE.js';
+import './chunk-2A5HJP46.js';
 import './chunk-OW7VVW6X.js';
 import './chunk-VBATFCWR.js';
 import './chunk-SG6ZTIMT.js';

package/dist/{runTrialGroup-6FWGZGNM.js → runTrialGroup-OOTTXL3B.js}

@@ -1,13 +1,13 @@
 import { newGroupId, criterionPhrase } from './chunk-RGZBC7NF.js';
-import { runTaskHosted, resolveRunAgentIdentity } from './chunk-MUQX7EHA.js';
+import { runTaskHosted, resolveRunAgentIdentity } from './chunk-ATIYRECS.js';
 import './chunk-ABM3CMQB.js';
-import { createHostedClient, parseTaskFile, outcomeOf } from './chunk-EKQQYW7E.js';
+import { createHostedClient, parseTaskFile, outcomeOf } from './chunk-UHX5HOBR.js';
 import './chunk-NW7HGA2K.js';
 import { HostedQuotaError, HostedTrialError } from './chunk-X66JOOO7.js';
 import './chunk-KIUIKAVU.js';
 import './chunk-NJ246QPJ.js';
 import './chunk-ZKID2HS3.js';
-import './chunk-3OVV6JUQ.js';
+import './chunk-2A5HJP46.js';
 import './chunk-OW7VVW6X.js';
 import './chunk-VBATFCWR.js';
 import './chunk-SG6ZTIMT.js';

package/dist/src/cli/main.js

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
-import { DEFAULT_CONTROL_PLANE_URL, DEFAULT_DASHBOARD_URL, clearLocalCredentials, friendlyHostedError, runSessionCreate, runSessionList, runSessionStop, resolveCredentials, runTaskHosted, discoverRunSet, VERDICT_ARTIFACT_VERSION, persistCredentialsAfterLogin, DEFAULT_DOCS_SITE_ORIGIN, resolveSeams, resolveCachedAgentId, readLinkCache, postAgentResolver, writeLinkCache, ensurePomeGitignored } from '../../chunk-MUQX7EHA.js';
+import { DEFAULT_CONTROL_PLANE_URL, DEFAULT_DASHBOARD_URL, clearLocalCredentials, friendlyHostedError, runSessionCreate, runSessionList, runSessionStop, resolveCredentials, runTaskHosted, discoverRunSet, VERDICT_ARTIFACT_VERSION, persistCredentialsAfterLogin, DEFAULT_DOCS_SITE_ORIGIN, resolveSeams, resolveCachedAgentId, readLinkCache, postAgentResolver, writeLinkCache, ensurePomeGitignored } from '../../chunk-ATIYRECS.js';
 import { readManifest, writeManifest, MANIFEST_JSON, readRequiredManifest, normalizeManifestTwins } from '../../chunk-ABM3CMQB.js';
-import { assetPath, runTask, resolvePackageRoot, DEMO_TASK_NAME, demoTaskPath } from '../../chunk-7GHIB4HM.js';
+import { assetPath, runTask, resolvePackageRoot, DEMO_TASK_NAME, demoTaskPath } from '../../chunk-F4V3FN3A.js';
 import '../../chunk-XDU6TD4O.js';
 import '../../chunk-CBFKZZBR.js';
-import { parseTaskFile, scoreStatus, runScoreLine, readLatestRun, readMetaSummary, outcomeOf, readConfigTwins, scoreCountsSummary, markerFor, criterionMarkerLabel, twinSkipSuffix, readCodeCriteria, createHostedClient, toTwinHttpEvent, redactJsonl, scoreFromFinalizeResponse, parseGitHubSeedState, uploadRunBlobs, isPreSatisfied } from '../../chunk-EKQQYW7E.js';
+import { parseTaskFile, scoreStatus, runScoreLine, readLatestRun, readMetaSummary, outcomeOf, readConfigTwins, scoreCountsSummary, markerFor, criterionMarkerLabel, twinSkipSuffix, readCodeCriteria, createHostedClient, toTwinHttpEvent, redactJsonl, scoreFromFinalizeResponse, parseGitHubSeedState, uploadRunBlobs, isPreSatisfied } from '../../chunk-UHX5HOBR.js';
 import '../../chunk-NW7HGA2K.js';
 import { MOUNTED_TWINS, deriveAgentSlug, exitCodeFor, HostedUsageError, HostedOrchError, HostedAuthError, HostedQuotaError } from '../../chunk-X66JOOO7.js';
 import { TAPE_ASSERTABLE_TOOLS } from '../../chunk-FKZZWWYC.js';
@@ -15,8 +15,8 @@ import '../../chunk-NJ246QPJ.js';
 import { LINEAR_CHECKS } from '../../chunk-XBT6ZLBG.js';
 import '../../chunk-ZKID2HS3.js';
 import { oneOf, defineCheck, repoRef, VACUITY_SENTINEL_NUMBER, childStatePath, VACUITY_SENTINEL, statePath, templateSlots, renderCheck, checksDigest, checkPattern, checkNearMissPattern } from '../../chunk-JWJYNAWI.js';
-import '../../chunk-YL4FHI3J.js';
-import { TWIN_NAME_LIST, isTwinName, createGitHubSmokeApp } from '../../chunk-3OVV6JUQ.js';
+import '../../chunk-EJFMWBZE.js';
+import { TWIN_NAME_LIST, isTwinName, createGitHubSmokeApp } from '../../chunk-2A5HJP46.js';
 import '../../chunk-OW7VVW6X.js';
 import { isLegacyEventRow, eventSchema } from '../../chunk-VBATFCWR.js';
 import { redactEvent, redactSecrets } from '../../chunk-SG6ZTIMT.js';
@@ -850,7 +850,7 @@ async function throwForStatus(res) {
 
 // src/task/seed-verifier.ts
 async function verifySeedWithTwin(seed) {
-  const { GitHubDomain, openGitHubCloneDatabase } = await import('../../src-ATIALTX2.js');
+  const { GitHubDomain, openGitHubCloneDatabase } = await import('../../src-XBWNIRBG.js');
   const db = openGitHubCloneDatabase(":memory:");
   try {
     new GitHubDomain(db).seed(seed);
@@ -4580,7 +4580,7 @@ var DEFAULT_AGENT_COMMAND = `node ${DEFAULT_AGENT_FILE}`;
 var MANIFEST_SCHEMA_URL = "https://pome.sh/schemas/v1/pome.json";
 var MAX_UNREADABLE_PATHS_SHOWN = 5;
 function readPackageVersion() {
-  if ("0.23.38".length > 0) return "0.23.38";
+  if ("0.23.40".length > 0) return "0.23.40";
   try {
     const here = dirname(fileURLToPath(import.meta.url));
     const candidates = [
@@ -5035,7 +5035,7 @@ function createProgram() {
         return;
       }
       {
-        const { runDoctorChecks } = await import('../../checks-PZSMAVLY.js');
+        const { runDoctorChecks } = await import('../../checks-A5EFOMZS.js');
         const { renderDoctorReport } = await import('../../render-ZQQ4UMNO.js');
         const doctorReport = await runDoctorChecks({ mode: useLocal ? "full" : "hosted" });
         if (!doctorReport.ok) {
@@ -5073,7 +5073,7 @@ function createProgram() {
               taskForRuns.config.runs
             );
             if (k > 1) {
-              const { runTrialGroup } = await import('../../runTrialGroup-6FWGZGNM.js');
+              const { runTrialGroup } = await import('../../runTrialGroup-OOTTXL3B.js');
               const fileForRerun = relative(process.cwd(), file);
               const rerunCommand = defaultTask ? options.trials !== void 0 ? `pome run -n ${k}` : "pome run" : `pome run ${fileForRerun && !fileForRerun.startsWith("..") ? fileForRerun : file} -n ${k}`;
               const groupResult = await runTrialGroup({
@@ -5167,7 +5167,7 @@ function createProgram() {
         process.exitCode = 5;
         return;
       }
-      const { runDemo } = await import('../../runDemo-F722I6AW.js');
+      const { runDemo } = await import('../../runDemo-4YTN6E2H.js');
       const result = await runDemo({
         apiBase: opts.apiUrl.replace(/\/$/, ""),
         dashboardBase: process.env.POME_DASHBOARD_URL ?? DEFAULT_DASHBOARD_URL,
@@ -5185,7 +5185,7 @@ function createProgram() {
   program.command("doctor").description(
     "Check the agent\u2194twin wiring: pome.json (or pome.yaml) present + valid, the local twin boots + serves, requests routed to the twin (not a hardcoded production host), egress floor active. On failure prints one named cause (file:line where knowable) + one concrete fix and exits non-zero."
   ).action(async () => {
-    const { runDoctorChecks } = await import('../../checks-PZSMAVLY.js');
+    const { runDoctorChecks } = await import('../../checks-A5EFOMZS.js');
     const { renderDoctorReport } = await import('../../render-ZQQ4UMNO.js');
     const report = await runDoctorChecks();
     for (const line of renderDoctorReport(report, { passNote: true })) console.error(line);
@@ -5361,7 +5361,7 @@ function createProgram() {
   ).description(
     "Start a standalone twin as a long-lived foreground server (Ctrl-C to stop)"
   ).action(async (name, options) => {
-    const { runTwinStartCommand } = await import('../../twinStart-J42TT766.js');
+    const { runTwinStartCommand } = await import('../../twinStart-IIF4JZJS.js');
     await runTwinStartCommand(name, options);
   });
   twin.command("reset").argument("[name]", "Twin name (default: github)", "github").description("Reset standalone twin state").action(async (name) => {

package/dist/{src-ATIALTX2.js → src-XBWNIRBG.js}

@@ -704,14 +704,33 @@ var TwinError = class extends Error {
     this.documentationUrl = documentationUrl;
   }
 };
+var GENERIC_DOCUMENTATION_URL = "https://docs.github.com/rest";
 function githubError(message, status, errors, documentationUrl) {
   return {
     message,
-    documentation_url: documentationUrl ?? "https://docs.github.com/rest",
+    documentation_url: documentationUrl ?? GENERIC_DOCUMENTATION_URL,
     status: String(status),
     ...errors ? { errors } : {}
   };
 }
+function withOperationDocs(envelope, documentationUrl) {
+  if (envelope.status === 501)
+    return envelope;
+  const body = envelope.body;
+  if (!body || typeof body !== "object")
+    return envelope;
+  const current = body.documentation_url;
+  if (current !== GENERIC_DOCUMENTATION_URL)
+    return envelope;
+  return { status: envelope.status, body: { ...body, documentation_url: documentationUrl } };
+}
+function withDocumentationUrl(error, documentationUrl) {
+  if (!(error instanceof TwinError))
+    return error;
+  if (error.documentationUrl !== void 0 || error.status === 501)
+    return error;
+  return new TwinError(error.message, error.status, error.errors, documentationUrl);
+}
 function notFound(message = "Not Found") {
   throw new TwinError(message, 404);
 }
@@ -734,6 +753,673 @@ function validationFailed(field, code, value) {
   ]);
 }
 
+// ../packages/twin-github/dist/fixtures/operation-docs.raw.json
+var operation_docs_raw_default = {
+  operations: {
+    "checks/create": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/check-runs",
+      category: "checks",
+      subcategory: "runs",
+      url: "https://docs.github.com/rest/checks/runs#create-a-check-run"
+    },
+    "checks/list-for-ref": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/commits/{ref}/check-runs",
+      category: "checks",
+      subcategory: "runs",
+      url: "https://docs.github.com/rest/checks/runs#list-check-runs-for-a-git-reference"
+    },
+    "git/create-ref": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/git/refs",
+      category: "git",
+      subcategory: "refs",
+      url: "https://docs.github.com/rest/git/refs#create-a-reference"
+    },
+    "git/delete-ref": {
+      method: "DELETE",
+      path: "/repos/{owner}/{repo}/git/refs/{ref}",
+      category: "git",
+      subcategory: "refs",
+      url: "https://docs.github.com/rest/git/refs#delete-a-reference"
+    },
+    "issues/add-assignees": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/issues/{issue_number}/assignees",
+      category: "issues",
+      subcategory: "assignees",
+      url: "https://docs.github.com/rest/issues/assignees#add-assignees-to-an-issue"
+    },
+    "issues/add-labels": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/issues/{issue_number}/labels",
+      category: "issues",
+      subcategory: "labels",
+      url: "https://docs.github.com/rest/issues/labels#add-labels-to-an-issue"
+    },
+    "issues/create": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/issues",
+      category: "issues",
+      subcategory: "issues",
+      url: "https://docs.github.com/rest/issues/issues#create-an-issue"
+    },
+    "issues/create-comment": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/issues/{issue_number}/comments",
+      category: "issues",
+      subcategory: "comments",
+      url: "https://docs.github.com/rest/issues/comments#create-an-issue-comment"
+    },
+    "issues/create-label": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/labels",
+      category: "issues",
+      subcategory: "labels",
+      url: "https://docs.github.com/rest/issues/labels#create-a-label"
+    },
+    "issues/create-milestone": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/milestones",
+      category: "issues",
+      subcategory: "milestones",
+      url: "https://docs.github.com/rest/issues/milestones#create-a-milestone"
+    },
+    "issues/delete-comment": {
+      method: "DELETE",
+      path: "/repos/{owner}/{repo}/issues/comments/{comment_id}",
+      category: "issues",
+      subcategory: "comments",
+      url: "https://docs.github.com/rest/issues/comments#delete-an-issue-comment"
+    },
+    "issues/delete-milestone": {
+      method: "DELETE",
+      path: "/repos/{owner}/{repo}/milestones/{milestone_number}",
+      category: "issues",
+      subcategory: "milestones",
+      url: "https://docs.github.com/rest/issues/milestones#delete-a-milestone"
+    },
+    "issues/get": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/issues/{issue_number}",
+      category: "issues",
+      subcategory: "issues",
+      url: "https://docs.github.com/rest/issues/issues#get-an-issue"
+    },
+    "issues/list-comments": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/issues/{issue_number}/comments",
+      category: "issues",
+      subcategory: "comments",
+      url: "https://docs.github.com/rest/issues/comments#list-issue-comments"
+    },
+    "issues/list-for-repo": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/issues",
+      category: "issues",
+      subcategory: "issues",
+      url: "https://docs.github.com/rest/issues/issues#list-repository-issues"
+    },
+    "issues/list-labels-for-repo": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/labels",
+      category: "issues",
+      subcategory: "labels",
+      url: "https://docs.github.com/rest/issues/labels#list-labels-for-a-repository"
+    },
+    "issues/list-labels-on-issue": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/issues/{issue_number}/labels",
+      category: "issues",
+      subcategory: "labels",
+      url: "https://docs.github.com/rest/issues/labels#list-labels-for-an-issue"
+    },
+    "issues/list-milestones": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/milestones",
+      category: "issues",
+      subcategory: "milestones",
+      url: "https://docs.github.com/rest/issues/milestones#list-milestones"
+    },
+    "issues/remove-label": {
+      method: "DELETE",
+      path: "/repos/{owner}/{repo}/issues/{issue_number}/labels/{name}",
+      category: "issues",
+      subcategory: "labels",
+      url: "https://docs.github.com/rest/issues/labels#remove-a-label-from-an-issue"
+    },
+    "issues/update": {
+      method: "PATCH",
+      path: "/repos/{owner}/{repo}/issues/{issue_number}",
+      category: "issues",
+      subcategory: "issues",
+      url: "https://docs.github.com/rest/issues/issues#update-an-issue"
+    },
+    "issues/update-comment": {
+      method: "PATCH",
+      path: "/repos/{owner}/{repo}/issues/comments/{comment_id}",
+      category: "issues",
+      subcategory: "comments",
+      url: "https://docs.github.com/rest/issues/comments#update-an-issue-comment"
+    },
+    "issues/update-milestone": {
+      method: "PATCH",
+      path: "/repos/{owner}/{repo}/milestones/{milestone_number}",
+      category: "issues",
+      subcategory: "milestones",
+      url: "https://docs.github.com/rest/issues/milestones#update-a-milestone"
+    },
+    "pulls/create": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/pulls",
+      category: "pulls",
+      subcategory: "pulls",
+      url: "https://docs.github.com/rest/pulls/pulls#create-a-pull-request"
+    },
+    "pulls/create-reply-for-review-comment": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/pulls/{pull_number}/comments/{comment_id}/replies",
+      category: "pulls",
+      subcategory: "comments",
+      url: "https://docs.github.com/rest/pulls/comments#create-a-reply-for-a-review-comment"
+    },
+    "pulls/create-review": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/pulls/{pull_number}/reviews",
+      category: "pulls",
+      subcategory: "reviews",
+      url: "https://docs.github.com/rest/pulls/reviews#create-a-review-for-a-pull-request"
+    },
+    "pulls/create-review-comment": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/pulls/{pull_number}/comments",
+      category: "pulls",
+      subcategory: "comments",
+      url: "https://docs.github.com/rest/pulls/comments#create-a-review-comment-for-a-pull-request"
+    },
+    "pulls/get": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/pulls/{pull_number}",
+      category: "pulls",
+      subcategory: "pulls",
+      url: "https://docs.github.com/rest/pulls/pulls#get-a-pull-request"
+    },
+    "pulls/list": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/pulls",
+      category: "pulls",
+      subcategory: "pulls",
+      url: "https://docs.github.com/rest/pulls/pulls#list-pull-requests"
+    },
+    "pulls/list-commits": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/pulls/{pull_number}/commits",
+      category: "pulls",
+      subcategory: "pulls",
+      url: "https://docs.github.com/rest/pulls/pulls#list-commits-on-a-pull-request"
+    },
+    "pulls/list-files": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/pulls/{pull_number}/files",
+      category: "pulls",
+      subcategory: "pulls",
+      url: "https://docs.github.com/rest/pulls/pulls#list-pull-requests-files"
+    },
+    "pulls/list-review-comments": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/pulls/{pull_number}/comments",
+      category: "pulls",
+      subcategory: "comments",
+      url: "https://docs.github.com/rest/pulls/comments#list-review-comments-on-a-pull-request"
+    },
+    "pulls/list-reviews": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/pulls/{pull_number}/reviews",
+      category: "pulls",
+      subcategory: "reviews",
+      url: "https://docs.github.com/rest/pulls/reviews#list-reviews-for-a-pull-request"
+    },
+    "pulls/merge": {
+      method: "PUT",
+      path: "/repos/{owner}/{repo}/pulls/{pull_number}/merge",
+      category: "pulls",
+      subcategory: "pulls",
+      url: "https://docs.github.com/rest/pulls/pulls#merge-a-pull-request"
+    },
+    "pulls/update": {
+      method: "PATCH",
+      path: "/repos/{owner}/{repo}/pulls/{pull_number}",
+      category: "pulls",
+      subcategory: "pulls",
+      url: "https://docs.github.com/rest/pulls/pulls#update-a-pull-request"
+    },
+    "pulls/update-branch": {
+      method: "PUT",
+      path: "/repos/{owner}/{repo}/pulls/{pull_number}/update-branch",
+      category: "pulls",
+      subcategory: "pulls",
+      url: "https://docs.github.com/rest/pulls/pulls#update-a-pull-request-branch"
+    },
+    "repos/add-collaborator": {
+      method: "PUT",
+      path: "/repos/{owner}/{repo}/collaborators/{username}",
+      category: "collaborators",
+      subcategory: "collaborators",
+      url: "https://docs.github.com/rest/collaborators/collaborators#add-a-repository-collaborator"
+    },
+    "repos/check-collaborator": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/collaborators/{username}",
+      category: "collaborators",
+      subcategory: "collaborators",
+      url: "https://docs.github.com/rest/collaborators/collaborators#check-if-a-user-is-a-repository-collaborator"
+    },
+    "repos/compare-commits": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/compare/{basehead}",
+      category: "commits",
+      subcategory: "commits",
+      url: "https://docs.github.com/rest/commits/commits#compare-two-commits"
+    },
+    "repos/create-commit-status": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/statuses/{sha}",
+      category: "commits",
+      subcategory: "statuses",
+      url: "https://docs.github.com/rest/commits/statuses#create-a-commit-status"
+    },
+    "repos/create-for-authenticated-user": {
+      method: "POST",
+      path: "/user/repos",
+      category: "repos",
+      subcategory: "repos",
+      url: "https://docs.github.com/rest/repos/repos#create-a-repository-for-the-authenticated-user"
+    },
+    "repos/create-fork": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/forks",
+      category: "repos",
+      subcategory: "forks",
+      url: "https://docs.github.com/rest/repos/forks#create-a-fork"
+    },
+    "repos/create-in-org": {
+      method: "POST",
+      path: "/orgs/{org}/repos",
+      category: "repos",
+      subcategory: "repos",
+      url: "https://docs.github.com/rest/repos/repos#create-an-organization-repository"
+    },
+    "repos/create-or-update-file-contents": {
+      method: "PUT",
+      path: "/repos/{owner}/{repo}/contents/{path}",
+      category: "repos",
+      subcategory: "contents",
+      url: "https://docs.github.com/rest/repos/contents#create-or-update-file-contents"
+    },
+    "repos/create-release": {
+      method: "POST",
+      path: "/repos/{owner}/{repo}/releases",
+      category: "releases",
+      subcategory: "releases",
+      url: "https://docs.github.com/rest/releases/releases#create-a-release"
+    },
+    "repos/delete-file": {
+      method: "DELETE",
+      path: "/repos/{owner}/{repo}/contents/{path}",
+      category: "repos",
+      subcategory: "contents",
+      url: "https://docs.github.com/rest/repos/contents#delete-a-file"
+    },
+    "repos/get": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}",
+      category: "repos",
+      subcategory: "repos",
+      url: "https://docs.github.com/rest/repos/repos#get-a-repository"
+    },
+    "repos/get-branch": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/branches/{branch}",
+      category: "branches",
+      subcategory: "branches",
+      url: "https://docs.github.com/rest/branches/branches#get-a-branch"
+    },
+    "repos/get-combined-status-for-ref": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/commits/{ref}/status",
+      category: "commits",
+      subcategory: "statuses",
+      url: "https://docs.github.com/rest/commits/statuses#get-the-combined-status-for-a-specific-reference"
+    },
+    "repos/get-commit": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/commits/{ref}",
+      category: "commits",
+      subcategory: "commits",
+      url: "https://docs.github.com/rest/commits/commits#get-a-commit"
+    },
+    "repos/get-content": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/contents/{path}",
+      category: "repos",
+      subcategory: "contents",
+      url: "https://docs.github.com/rest/repos/contents#get-repository-content"
+    },
+    "repos/get-latest-release": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/releases/latest",
+      category: "releases",
+      subcategory: "releases",
+      url: "https://docs.github.com/rest/releases/releases#get-the-latest-release"
+    },
+    "repos/get-release-by-tag": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/releases/tags/{tag}",
+      category: "releases",
+      subcategory: "releases",
+      url: "https://docs.github.com/rest/releases/releases#get-a-release-by-tag-name"
+    },
+    "repos/list-branches": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/branches",
+      category: "branches",
+      subcategory: "branches",
+      url: "https://docs.github.com/rest/branches/branches#list-branches"
+    },
+    "repos/list-collaborators": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/collaborators",
+      category: "collaborators",
+      subcategory: "collaborators",
+      url: "https://docs.github.com/rest/collaborators/collaborators#list-repository-collaborators"
+    },
+    "repos/list-commits": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/commits",
+      category: "commits",
+      subcategory: "commits",
+      url: "https://docs.github.com/rest/commits/commits#list-commits"
+    },
+    "repos/list-releases": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/releases",
+      category: "releases",
+      subcategory: "releases",
+      url: "https://docs.github.com/rest/releases/releases#list-releases"
+    },
+    "repos/list-tags": {
+      method: "GET",
+      path: "/repos/{owner}/{repo}/tags",
+      category: "repos",
+      subcategory: "repos",
+      url: "https://docs.github.com/rest/repos/repos#list-repository-tags"
+    },
+    "search/code": {
+      method: "GET",
+      path: "/search/code",
+      category: "search",
+      subcategory: "search",
+      url: "https://docs.github.com/rest/search/search#search-code"
+    },
+    "search/commits": {
+      method: "GET",
+      path: "/search/commits",
+      category: "search",
+      subcategory: "search",
+      url: "https://docs.github.com/rest/search/search#search-commits"
+    },
+    "search/issues-and-pull-requests": {
+      method: "GET",
+      path: "/search/issues",
+      category: "search",
+      subcategory: "search",
+      url: "https://docs.github.com/rest/search/search#search-issues-and-pull-requests"
+    },
+    "search/repos": {
+      method: "GET",
+      path: "/search/repositories",
+      category: "search",
+      subcategory: "search",
+      url: "https://docs.github.com/rest/search/search#search-repositories"
+    },
+    "search/users": {
+      method: "GET",
+      path: "/search/users",
+      category: "search",
+      subcategory: "search",
+      url: "https://docs.github.com/rest/search/search#search-users"
+    },
+    "users/get-authenticated": {
+      method: "GET",
+      path: "/user",
+      category: "users",
+      subcategory: "users",
+      url: "https://docs.github.com/rest/users/users#get-the-authenticated-user"
+    }
+  },
+  rest: {
+    "DELETE /repos/:owner/:repo/contents/*": "repos/delete-file",
+    "DELETE /repos/:owner/:repo/git/refs/heads/*": "git/delete-ref",
+    "DELETE /repos/:owner/:repo/issues/:number/labels/:name": "issues/remove-label",
+    "DELETE /repos/:owner/:repo/issues/comments/:comment_id": "issues/delete-comment",
+    "DELETE /repos/:owner/:repo/milestones/:number": "issues/delete-milestone",
+    "GET /repos/:owner/:repo": "repos/get",
+    "GET /repos/:owner/:repo/branches": "repos/list-branches",
+    "GET /repos/:owner/:repo/branches/*": "repos/get-branch",
+    "GET /repos/:owner/:repo/collaborators": "repos/list-collaborators",
+    "GET /repos/:owner/:repo/collaborators/:username": "repos/check-collaborator",
+    "GET /repos/:owner/:repo/commits": "repos/list-commits",
+    "GET /repos/:owner/:repo/commits/:ref": "repos/get-commit",
+    "GET /repos/:owner/:repo/commits/:ref/check-runs": "checks/list-for-ref",
+    "GET /repos/:owner/:repo/commits/:ref/status": "repos/get-combined-status-for-ref",
+    "GET /repos/:owner/:repo/compare/:basehead{.+}": "repos/compare-commits",
+    "GET /repos/:owner/:repo/contents": "repos/get-content",
+    "GET /repos/:owner/:repo/contents/*": "repos/get-content",
+    "GET /repos/:owner/:repo/issues": "issues/list-for-repo",
+    "GET /repos/:owner/:repo/issues/:number": "issues/get",
+    "GET /repos/:owner/:repo/issues/:number/comments": "issues/list-comments",
+    "GET /repos/:owner/:repo/issues/:number/labels": "issues/list-labels-on-issue",
+    "GET /repos/:owner/:repo/labels": "issues/list-labels-for-repo",
+    "GET /repos/:owner/:repo/milestones": "issues/list-milestones",
+    "GET /repos/:owner/:repo/pulls": "pulls/list",
+    "GET /repos/:owner/:repo/pulls/:number": "pulls/get",
+    "GET /repos/:owner/:repo/pulls/:number/comments": "pulls/list-review-comments",
+    "GET /repos/:owner/:repo/pulls/:number/commits": "pulls/list-commits",
+    "GET /repos/:owner/:repo/pulls/:number/diff": null,
+    "GET /repos/:owner/:repo/pulls/:number/files": "pulls/list-files",
+    "GET /repos/:owner/:repo/pulls/:number/reviews": "pulls/list-reviews",
+    "GET /repos/:owner/:repo/pulls/:number/status": null,
+    "GET /repos/:owner/:repo/releases": "repos/list-releases",
+    "GET /repos/:owner/:repo/releases/latest": "repos/get-latest-release",
+    "GET /repos/:owner/:repo/releases/tags/*": "repos/get-release-by-tag",
+    "GET /repos/:owner/:repo/tags": "repos/list-tags",
+    "GET /search/code": "search/code",
+    "GET /search/commits": "search/commits",
+    "GET /search/issues": "search/issues-and-pull-requests",
+    "GET /search/repositories": "search/repos",
+    "GET /search/users": "search/users",
+    "GET /user": "users/get-authenticated",
+    "PATCH /repos/:owner/:repo/issues/:number": "issues/update",
+    "PATCH /repos/:owner/:repo/issues/comments/:comment_id": "issues/update-comment",
+    "PATCH /repos/:owner/:repo/milestones/:number": "issues/update-milestone",
+    "PATCH /repos/:owner/:repo/pulls/:number": "pulls/update",
+    "POST /orgs/:owner/repos": "repos/create-in-org",
+    "POST /repos/:owner/:repo/check-runs": "checks/create",
+    "POST /repos/:owner/:repo/forks": "repos/create-fork",
+    "POST /repos/:owner/:repo/git/refs": "git/create-ref",
+    "POST /repos/:owner/:repo/issues": "issues/create",
+    "POST /repos/:owner/:repo/issues/:number/assignees": "issues/add-assignees",
+    "POST /repos/:owner/:repo/issues/:number/comments": "issues/create-comment",
+    "POST /repos/:owner/:repo/issues/:number/labels": "issues/add-labels",
+    "POST /repos/:owner/:repo/labels": "issues/create-label",
+    "POST /repos/:owner/:repo/milestones": "issues/create-milestone",
+    "POST /repos/:owner/:repo/pulls": "pulls/create",
+    "POST /repos/:owner/:repo/pulls/:number/comments": "pulls/create-review-comment",
+    "POST /repos/:owner/:repo/pulls/:number/comments/:comment_id/replies": "pulls/create-reply-for-review-comment",
+    "POST /repos/:owner/:repo/pulls/:number/reviews": "pulls/create-review",
+    "POST /repos/:owner/:repo/releases": "repos/create-release",
+    "POST /repos/:owner/:repo/statuses/:sha": "repos/create-commit-status",
+    "POST /user/repos": "repos/create-for-authenticated-user",
+    "PUT /repos/:owner/:repo/collaborators/:username": "repos/add-collaborator",
+    "PUT /repos/:owner/:repo/contents/*": "repos/create-or-update-file-contents",
+    "PUT /repos/:owner/:repo/pulls/:number/merge": "pulls/merge",
+    "PUT /repos/:owner/:repo/pulls/:number/update-branch": "pulls/update-branch"
+  },
+  mcp: {
+    add_issue_comment: {
+      operationId: "issues/create-comment"
+    },
+    add_reply_to_pull_request_comment: {
+      operationId: "pulls/create-reply-for-review-comment"
+    },
+    create_branch: null,
+    create_issue: {
+      operationId: "issues/create"
+    },
+    create_or_update_file: {
+      operationId: "repos/create-or-update-file-contents"
+    },
+    create_pull_request: {
+      operationId: "pulls/create"
+    },
+    create_pull_request_review: {
+      operationId: "pulls/create-review"
+    },
+    create_repository: {
+      byArgument: {
+        argument: "owner",
+        present: "repos/create-in-org",
+        absent: "repos/create-for-authenticated-user"
+      }
+    },
+    delete_file: {
+      operationId: "repos/delete-file"
+    },
+    fork_repository: {
+      operationId: "repos/create-fork"
+    },
+    get_commit: {
+      operationId: "repos/get-commit"
+    },
+    get_file_contents: {
+      operationId: "repos/get-content"
+    },
+    get_latest_release: {
+      operationId: "repos/get-latest-release"
+    },
+    get_me: {
+      operationId: "users/get-authenticated"
+    },
+    get_release_by_tag: {
+      operationId: "repos/get-release-by-tag"
+    },
+    get_tag: null,
+    issue_read: {
+      byMethod: {
+        get: "issues/get",
+        get_comments: "issues/list-comments",
+        get_labels: "issues/list-labels-on-issue"
+      }
+    },
+    issue_write: {
+      byMethod: {
+        create: "issues/create",
+        update: "issues/update"
+      }
+    },
+    list_branches: {
+      operationId: "repos/list-branches"
+    },
+    list_commits: {
+      operationId: "repos/list-commits"
+    },
+    list_issues: {
+      operationId: "issues/list-for-repo"
+    },
+    list_pull_requests: {
+      operationId: "pulls/list"
+    },
+    list_releases: {
+      operationId: "repos/list-releases"
+    },
+    list_repository_collaborators: {
+      operationId: "repos/list-collaborators"
+    },
+    list_tags: {
+      operationId: "repos/list-tags"
+    },
+    merge_pull_request: {
+      operationId: "pulls/merge"
+    },
+    pull_request_read: {
+      byMethod: {
+        get: "pulls/get",
+        get_diff: "pulls/get",
+        get_status: "repos/get-combined-status-for-ref",
+        get_files: "pulls/list-files",
+        get_commits: "pulls/list-commits",
+        get_reviews: "pulls/list-reviews",
+        get_comments: "issues/list-comments",
+        get_review_comments: "pulls/list-review-comments",
+        get_check_runs: "checks/list-for-ref"
+      }
+    },
+    pull_request_review_write: {
+      byMethod: {
+        create: "pulls/create-review"
+      }
+    },
+    push_files: null,
+    search_code: {
+      operationId: "search/code"
+    },
+    search_commits: {
+      operationId: "search/commits"
+    },
+    search_issues: {
+      operationId: "search/issues-and-pull-requests"
+    },
+    search_repositories: {
+      operationId: "search/repos"
+    },
+    search_users: {
+      operationId: "search/users"
+    },
+    update_pull_request: {
+      operationId: "pulls/update"
+    },
+    update_pull_request_branch: {
+      operationId: "pulls/update-branch"
+    }
+  }
+};
+
+// ../packages/twin-github/dist/src/operation-docs.js
+var docs = operation_docs_raw_default;
+function urlFor(operationId) {
+  if (!operationId)
+    return void 0;
+  return docs.operations[operationId]?.url;
+}
+function restOperationDocumentationUrl(surface) {
+  return urlFor(docs.rest[surface]);
+}
+function toolOperationDocumentationUrl(tool, args) {
+  const entry2 = docs.mcp[tool];
+  if (!entry2)
+    return void 0;
+  if ("operationId" in entry2)
+    return urlFor(entry2.operationId);
+  const record = args && typeof args === "object" ? args : {};
+  if ("byMethod" in entry2) {
+    const method = record.method;
+    return typeof method === "string" ? urlFor(entry2.byMethod[method]) : void 0;
+  }
+  const sent = record[entry2.byArgument.argument] !== void 0;
+  return urlFor(sent ? entry2.byArgument.present : entry2.byArgument.absent);
+}
+
 // ../packages/twin-github/dist/src/tools.js
 var githubToolFixture = loadMcpToolFixture({ raw: mcp_tools_list_raw_default, meta: mcp_tools_list_meta_default });
 var pageShape = {
@@ -1023,6 +1709,16 @@ function executeTool(domain, name, input, onDelta, options = {}) {
     validationFailed("tool", "invalid", name);
   }
   const parsed = definition.schema.parse(input);
+  const documentationUrl = toolOperationDocumentationUrl(name, parsed);
+  if (documentationUrl === void 0)
+    return dispatchTool(domain, name, parsed, onDelta, options);
+  try {
+    return dispatchTool(domain, name, parsed, onDelta, options);
+  } catch (error) {
+    throw withDocumentationUrl(error, documentationUrl);
+  }
+}
+function dispatchTool(domain, name, parsed, onDelta, options = {}) {
   switch (name) {
     case "search_repositories":
       return domain.searchRepositories(parsed);
@@ -4510,6 +5206,53 @@ var GitHubDomain = class {
     this.db.prepare("INSERT INTO audit_log (ts, action, repo_full_name, payload_json) VALUES (?, ?, ?, ?)").run(nowIso(), action, repoFullName, JSON.stringify(payload));
   }
 };
+function zodIssues(err) {
+  if (err instanceof ZodError)
+    return err.issues;
+  if (err instanceof Error && err.name === "ZodError" && Array.isArray(err.issues)) {
+    return err.issues;
+  }
+  return void 0;
+}
+function githubErrorEnvelope(err) {
+  if (err instanceof UnknownToolError) {
+    return {
+      status: 422,
+      body: githubError("Validation Failed", 422, [
+        { resource: "Request", field: "tool", code: "invalid", value: err.tool }
+      ])
+    };
+  }
+  if (err instanceof TwinError) {
+    return {
+      status: err.status,
+      body: githubError(err.message, err.status, err.errors, err.documentationUrl)
+    };
+  }
+  const issues = zodIssues(err);
+  if (issues) {
+    return {
+      status: 422,
+      body: githubError("Validation Failed", 422, issues.map((issue) => ({
+        resource: "Request",
+        field: issue.path.join("."),
+        code: issue.code
+      })))
+    };
+  }
+  if (err instanceof SyntaxError) {
+    return { status: 400, body: githubError("Problems parsing JSON", 400) };
+  }
+  return {
+    status: 500,
+    body: githubError(err instanceof Error ? err.message : "Internal Server Error", 500)
+  };
+}
+function operationErrorEnvelope(documentationUrl) {
+  if (documentationUrl === void 0)
+    return githubErrorEnvelope;
+  return (err) => withOperationDocs(githubErrorEnvelope(err), documentationUrl);
+}
 
 // ../packages/twin-github/dist/src/rest-content.js
 var BASE64 = /^[A-Za-z0-9+/]*={0,2}$/;
@@ -4535,7 +5278,8 @@ function captureDelta(fn) {
 }
 function registerGitHubRoutes(session, { domain, recorder }) {
   const route = (declaration, handler, tool) => {
-    mountDeclaredRoute(session, declaration, recorder.handle({ mutation: false, ...tool ? { tool } : {} }, async (c) => {
+    const errorEnvelope = operationErrorEnvelope(restOperationDocumentationUrl(declaration.surface));
+    mountDeclaredRoute(session, declaration, recorder.handle({ mutation: false, errorEnvelope, ...tool ? { tool } : {} }, async (c) => {
       const input = await parseDeclared(declaration, c);
       const result = await handler(input, c);
       return {
@@ -4803,48 +5547,6 @@ var seedParser = {
 function actorFromSession(session) {
   return typeof session?.login === "string" ? session.login : void 0;
 }
-function zodIssues(err) {
-  if (err instanceof ZodError)
-    return err.issues;
-  if (err instanceof Error && err.name === "ZodError" && Array.isArray(err.issues)) {
-    return err.issues;
-  }
-  return void 0;
-}
-function githubErrorEnvelope(err) {
-  if (err instanceof UnknownToolError) {
-    return {
-      status: 422,
-      body: githubError("Validation Failed", 422, [
-        { resource: "Request", field: "tool", code: "invalid", value: err.tool }
-      ])
-    };
-  }
-  if (err instanceof TwinError) {
-    return {
-      status: err.status,
-      body: githubError(err.message, err.status, err.errors, err.documentationUrl)
-    };
-  }
-  const issues = zodIssues(err);
-  if (issues) {
-    return {
-      status: 422,
-      body: githubError("Validation Failed", 422, issues.map((issue) => ({
-        resource: "Request",
-        field: issue.path.join("."),
-        code: issue.code
-      })))
-    };
-  }
-  if (err instanceof SyntaxError) {
-    return { status: 400, body: githubError("Problems parsing JSON", 400) };
-  }
-  return {
-    status: 500,
-    body: githubError(err instanceof Error ? err.message : "Internal Server Error", 500)
-  };
-}
 var githubToolImplementations = Object.fromEntries(toolArgumentSchemas.map((def) => [
   def.name,
   {

package/dist/twinHarness-NMFJCPJE.js

@@ -0,0 +1,5 @@
+export { UnsupportedTwinError, bootTwin } from './chunk-EJFMWBZE.js';
+export { STRIPE_LOCAL_ACCOUNT_ID } from './chunk-2A5HJP46.js';
+import './chunk-OW7VVW6X.js';
+import './chunk-VBATFCWR.js';
+import './chunk-SG6ZTIMT.js';

package/dist/{twinStart-J42TT766.js → twinStart-IIF4JZJS.js}

@@ -1,5 +1,5 @@
-import { bootTwin } from './chunk-YL4FHI3J.js';
-import { isTwinName, TWIN_NAMES, defaultPortFor, TWIN_REGISTRY } from './chunk-3OVV6JUQ.js';
+import { bootTwin } from './chunk-EJFMWBZE.js';
+import { isTwinName, TWIN_NAMES, defaultPortFor, TWIN_REGISTRY } from './chunk-2A5HJP46.js';
 import './chunk-OW7VVW6X.js';
 import './chunk-VBATFCWR.js';
 import './chunk-SG6ZTIMT.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pome-sh/cli",
-  "version": "0.23.38",
+  "version": "0.23.40",
   "description": "Digital-twin testing for AI agents \u2014 run tasks against resettable local or hosted twins and record tool-call traces for evaluation on pome.sh.",
   "keywords": [
     "ai",

package/dist/twinHarness-XO47SYBH.js

@@ -1,5 +0,0 @@
-export { UnsupportedTwinError, bootTwin } from './chunk-YL4FHI3J.js';
-export { STRIPE_LOCAL_ACCOUNT_ID } from './chunk-3OVV6JUQ.js';
-import './chunk-OW7VVW6X.js';
-import './chunk-VBATFCWR.js';
-import './chunk-SG6ZTIMT.js';