@volter/twin-github 0.1.1 → 2.0.0

package/dist/test-fixtures/github-review-schema.SOURCE.md

@@ -0,0 +1,12 @@
+# github-review-schema.json — provenance
+
+GitHub's **pull-request-review** object schema (the `POST /repos/{owner}/{repo}/pulls/{pull_number}/reviews`
+200 response), used by the GitHub twin's spec-conformance gate for review-submission responses.
+
+- **Source:** `github/rest-api-description` dereferenced OpenAPI (MIT) — fetched 2026-06-14
+- **Path:** `paths["/repos/{owner}/{repo}/pulls/{pull_number}/reviews"].post.responses["200"].content["application/json"].schema`
+
+The twin emits an INTEGER `id` (from its local sequence — real GitHub ids are integers; the
+twin once returned the string `"review:N"`). `node_id`/`_links`/`author_association` are declared
+evidence-twin scope in `github-known-deviations.json`. Refresh: re-extract and re-run
+`bun test src/github-conformance.test.ts`.

package/dist/test-fixtures/github-review-schema.json

@@ -0,0 +1,236 @@
+{
+  "title": "Pull Request Review",
+  "description": "Pull Request Reviews are reviews on pull requests.",
+  "type": "object",
+  "properties": {
+    "id": {
+      "description": "Unique identifier of the review",
+      "example": 42,
+      "type": "integer",
+      "format": "int64"
+    },
+    "node_id": {
+      "type": "string",
+      "example": "MDE3OlB1bGxSZXF1ZXN0UmV2aWV3ODA="
+    },
+    "user": {
+      "title": "Simple User",
+      "description": "A GitHub user.",
+      "type": "object",
+      "properties": {
+        "name": {
+          "nullable": true,
+          "type": "string"
+        },
+        "email": {
+          "nullable": true,
+          "type": "string"
+        },
+        "login": {
+          "type": "string",
+          "example": "octocat"
+        },
+        "id": {
+          "type": "integer",
+          "format": "int64",
+          "example": 1
+        },
+        "node_id": {
+          "type": "string",
+          "example": "MDQ6VXNlcjE="
+        },
+        "avatar_url": {
+          "type": "string",
+          "format": "uri",
+          "example": "https://github.com/images/error/octocat_happy.gif"
+        },
+        "gravatar_id": {
+          "type": "string",
+          "example": "41d064eb2195891e12d0413f63227ea7",
+          "nullable": true
+        },
+        "url": {
+          "type": "string",
+          "format": "uri",
+          "example": "https://api.github.com/users/octocat"
+        },
+        "html_url": {
+          "type": "string",
+          "format": "uri",
+          "example": "https://github.com/octocat"
+        },
+        "followers_url": {
+          "type": "string",
+          "format": "uri",
+          "example": "https://api.github.com/users/octocat/followers"
+        },
+        "following_url": {
+          "type": "string",
+          "example": "https://api.github.com/users/octocat/following{/other_user}"
+        },
+        "gists_url": {
+          "type": "string",
+          "example": "https://api.github.com/users/octocat/gists{/gist_id}"
+        },
+        "starred_url": {
+          "type": "string",
+          "example": "https://api.github.com/users/octocat/starred{/owner}{/repo}"
+        },
+        "subscriptions_url": {
+          "type": "string",
+          "format": "uri",
+          "example": "https://api.github.com/users/octocat/subscriptions"
+        },
+        "organizations_url": {
+          "type": "string",
+          "format": "uri",
+          "example": "https://api.github.com/users/octocat/orgs"
+        },
+        "repos_url": {
+          "type": "string",
+          "format": "uri",
+          "example": "https://api.github.com/users/octocat/repos"
+        },
+        "events_url": {
+          "type": "string",
+          "example": "https://api.github.com/users/octocat/events{/privacy}"
+        },
+        "received_events_url": {
+          "type": "string",
+          "format": "uri",
+          "example": "https://api.github.com/users/octocat/received_events"
+        },
+        "type": {
+          "type": "string",
+          "example": "User"
+        },
+        "site_admin": {
+          "type": "boolean"
+        },
+        "starred_at": {
+          "type": "string",
+          "example": "\"2020-07-09T00:17:55Z\""
+        },
+        "user_view_type": {
+          "type": "string",
+          "example": "public"
+        }
+      },
+      "required": [
+        "avatar_url",
+        "events_url",
+        "followers_url",
+        "following_url",
+        "gists_url",
+        "gravatar_id",
+        "html_url",
+        "id",
+        "node_id",
+        "login",
+        "organizations_url",
+        "received_events_url",
+        "repos_url",
+        "site_admin",
+        "starred_url",
+        "subscriptions_url",
+        "type",
+        "url"
+      ],
+      "nullable": true
+    },
+    "body": {
+      "description": "The text of the review.",
+      "example": "This looks great.",
+      "type": "string"
+    },
+    "state": {
+      "type": "string",
+      "example": "CHANGES_REQUESTED"
+    },
+    "html_url": {
+      "type": "string",
+      "format": "uri",
+      "example": "https://github.com/octocat/Hello-World/pull/12#pullrequestreview-80"
+    },
+    "pull_request_url": {
+      "type": "string",
+      "format": "uri",
+      "example": "https://api.github.com/repos/octocat/Hello-World/pulls/12"
+    },
+    "_links": {
+      "type": "object",
+      "properties": {
+        "html": {
+          "type": "object",
+          "properties": {
+            "href": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "href"
+          ]
+        },
+        "pull_request": {
+          "type": "object",
+          "properties": {
+            "href": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "href"
+          ]
+        }
+      },
+      "required": [
+        "html",
+        "pull_request"
+      ]
+    },
+    "submitted_at": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "commit_id": {
+      "description": "A commit SHA for the review. If the commit object was garbage collected or forcibly deleted, then it no longer exists in Git and this value will be `null`.",
+      "example": "54bb654c9e6025347f57900a4a5c2313a96b8035",
+      "type": "string",
+      "nullable": true
+    },
+    "body_html": {
+      "type": "string"
+    },
+    "body_text": {
+      "type": "string"
+    },
+    "author_association": {
+      "title": "author_association",
+      "type": "string",
+      "example": "OWNER",
+      "description": "How the author is associated with the repository.",
+      "enum": [
+        "COLLABORATOR",
+        "CONTRIBUTOR",
+        "FIRST_TIMER",
+        "FIRST_TIME_CONTRIBUTOR",
+        "MANNEQUIN",
+        "MEMBER",
+        "NONE",
+        "OWNER"
+      ]
+    }
+  },
+  "required": [
+    "id",
+    "node_id",
+    "user",
+    "body",
+    "state",
+    "commit_id",
+    "html_url",
+    "pull_request_url",
+    "_links",
+    "author_association"
+  ]
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@volter/twin-github",
-  "version": "0.1.1",
-  "description": "Local GitHub twin \u2014 PR-evidence REST; your real `@octokit/rest` talks to it unmodified. Mirror, simulate, and fork. Built on @volter/twin.",
+  "version": "2.0.0",
+  "description": "Local GitHub twin — PR-evidence REST; your real `@octokit/rest` talks to it unmodified. Mirror, simulate, and fork. Built on @volter/world-core.",
   "keywords": [
     "twin",
     "local",
@@ -30,7 +30,8 @@
     "LICENSE",
     "!test-fixtures/*.SOURCE.md",
     "!**/*.test.ts",
-    "!**/*.test.tsx"
+    "!**/*.test.tsx",
+    "dist"
   ],
   "repository": {
     "type": "git",
@@ -40,25 +41,33 @@
   "homepage": "https://github.com/volter-ai/twin/tree/main/packages/twin/github#readme",
   "type": "module",
   "exports": {
-    ".": "./src/index.ts"
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    }
   },
   "bin": {
-    "world-github": "src/cli.ts"
+    "world-github": "dist/src/cli.js"
   },
   "scripts": {
     "test": "bun test src/*.test.ts",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "build": "node ../../../scripts/publish/build.mjs",
+    "prepack": "node ../../../scripts/publish/prepare-publish.mjs prepack",
+    "postpack": "node ../../../scripts/publish/prepare-publish.mjs postpack"
   },
   "dependencies": {
+    "@volter/world-ui": "0.1.0",
     "react": "^19.2.7",
-    "react-dom": "^19.2.7"
+    "react-dom": "^19.2.7",
+    "graphql": "16.14.2"
   },
   "peerDependencies": {
-    "@volter/twin": "0.1.1"
+    "@volter/world-core": "2.0.0"
   },
   "devDependencies": {
-    "@volter/twin": "0.1.0",
-    "@volter/twin-tooling": "0.1.0",
+    "@volter/world-core": "2.0.0",
+    "@volter/world-tooling": "0.1.0",
     "@octokit/rest": "^22.0.1",
     "playwright": "^1.61.0",
     "@types/bun": "^1.2.20",
@@ -68,6 +77,6 @@
     "typescript": "^5.9.0"
   },
   "engines": {
-    "bun": ">=1.2.0"
+    "node": ">=22.3"
   }
 }

package/src/cli.ts

@@ -1,7 +1,8 @@
-#!/usr/bin/env bun
-import { keepProcessAlive } from '@volter/twin/lifecycle';
+#!/usr/bin/env node
+import { keepProcessAlive } from '@volter/world-core/lifecycle';
 // world-github — the GitHub PR-evidence twin CLI (R14): serve | mirror | conformance.
-import { hasFlag, optionValue } from '@volter/twin/args';
+import { hasFlag, optionValue } from '@volter/world-core/args';
+import './index.ts'; // the pack registers itself on load (protocol 2)
 import { createGithubMirrorServer } from './github-mirror-ui.ts';
 import { createGithubTwinServer } from './github-server.ts';
 
@@ -12,15 +13,15 @@ const root = optionValue(rest, '--root') || undefined;
 const readOnly = hasFlag(rest, "--read-only");
 
 if (cmd === 'serve') {
-  const s = createGithubTwinServer({ readOnly, ...(root ? { root } : {}), ...(port ? { port } : {}) });
+  const s = await createGithubTwinServer({ readOnly, ...(root ? { root } : {}), ...(port ? { port } : {}) });
   process.stdout.write(`github twin (GitHub REST) at http://127.0.0.1:${s.port}\n`);
   await keepProcessAlive();
 } else if (cmd === 'mirror') {
-  const s = createGithubMirrorServer({ ...(root ? { root } : {}), ...(port ? { port } : {}) });
+  const s = await createGithubMirrorServer({ ...(root ? { root } : {}), ...(port ? { port } : {}) });
   process.stdout.write(`github mirror UI (PR evidence) at http://127.0.0.1:${s.port}\n`);
   await keepProcessAlive();
 } else if (cmd === 'conformance') {
-  // dev-only; lazy so the bin runs without @volter/twin-tooling
+  // dev-only; lazy so the bin runs without @volter/world-tooling
   const {
     checkGithubConformance, githubCommentCoverage, githubCoverage, githubReviewCoverage,
     loadGithubCommentSchema, loadGithubKnownDeviations, loadGithubPrSchema, loadGithubReviewSchema,