@volter/twin-github 0.1.0

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@volter/twin-github",
+  "version": "0.1.0",
+  "description": "Local GitHub twin \u2014 PR-evidence REST; your real `@octokit/rest` talks to it unmodified. Mirror, simulate, and fork. Built on @volter/twin.",
+  "keywords": [
+    "twin",
+    "local",
+    "mock",
+    "mirror",
+    "simulator",
+    "fixtures",
+    "testing",
+    "sdk",
+    "api",
+    "localstack",
+    "github",
+    "octokit",
+    "pull-requests"
+  ],
+  "author": "Volter (https://github.com/volter-ai)",
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "client",
+    "test-fixtures",
+    "README.md",
+    "LICENSE",
+    "!test-fixtures/*.SOURCE.md",
+    "!**/*.test.ts",
+    "!**/*.test.tsx"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/volter-ai/twin.git",
+    "directory": "packages/twin/github"
+  },
+  "homepage": "https://github.com/volter-ai/twin/tree/main/packages/twin/github#readme",
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "bin": {
+    "world-github": "src/cli.ts"
+  },
+  "scripts": {
+    "test": "bun test src/*.test.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7"
+  },
+  "peerDependencies": {
+    "@volter/twin": "0.1.0"
+  },
+  "devDependencies": {
+    "@volter/twin": "0.1.0",
+    "@volter/twin-tooling": "0.1.0",
+    "@octokit/rest": "^22.0.1",
+    "playwright": "^1.61.0",
+    "@types/bun": "^1.2.20",
+    "@types/node": "^24.0.0",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "typescript": "^5.9.0"
+  },
+  "engines": {
+    "bun": ">=1.2.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,40 @@
+#!/usr/bin/env bun
+// world-github — the GitHub PR-evidence twin CLI (R14): serve | mirror | conformance.
+import { hasFlag, optionValue } from '@volter/twin/args';
+import { createGithubMirrorServer } from './github-mirror-ui.ts';
+import { createGithubTwinServer } from './github-server.ts';
+
+const cmd = process.argv[2];
+const rest = process.argv.slice(3);
+const port = Number(optionValue(rest, '--port', '0')) || undefined;
+const root = optionValue(rest, '--root') || undefined;
+const readOnly = hasFlag(rest, "--read-only");
+
+if (cmd === 'serve') {
+  const s = createGithubTwinServer({ readOnly, ...(root ? { root } : {}), ...(port ? { port } : {}) });
+  process.stdout.write(`github twin (GitHub REST) at http://127.0.0.1:${s.port}\n`);
+  await new Promise(() => {});
+} else if (cmd === 'mirror') {
+  const s = createGithubMirrorServer({ ...(root ? { root } : {}), ...(port ? { port } : {}) });
+  process.stdout.write(`github mirror UI (PR evidence) at http://127.0.0.1:${s.port}\n`);
+  await new Promise(() => {});
+} else if (cmd === 'conformance') {
+  // dev-only; lazy so the bin runs without @volter/twin-tooling
+  const {
+    checkGithubConformance, githubCommentCoverage, githubCoverage, githubReviewCoverage,
+    loadGithubCommentSchema, loadGithubKnownDeviations, loadGithubPrSchema, loadGithubReviewSchema,
+  } = await import('./github-conformance.ts');
+  const [prSchema, reviewSchema, commentSchema, known] = await Promise.all([
+    loadGithubPrSchema(), loadGithubReviewSchema(), loadGithubCommentSchema(), loadGithubKnownDeviations(),
+  ]);
+  const report = checkGithubConformance(prSchema, { ...(root ? { root } : {}), known });
+  const coverage = {
+    pull_request: githubCoverage(prSchema),
+    pull_request_review: githubReviewCoverage(reviewSchema),
+    issue_comment: githubCommentCoverage(commentSchema),
+  };
+  process.stdout.write(`${JSON.stringify({ ...report, coverage }, null, 2)}\n`);
+  process.exit(report.ok ? 0 : 1);
+} else {
+  process.stdout.write('Usage: world-github <serve|mirror|conformance> [--read-only] [--port N] [--root DIR]\n');
+}