Skip to content
Senz14Public

About

git-forge — a GitHub-compatible git forge (single-file, dependency-free: git smart HTTP, REST v3, GraphQL v4, MCP). Built by an AI agent for make.fun's "Build a GitHub-compatible git forge" bounty, $500 in USDC.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

make.fun · github-core-clone-01 rank reward

git-forge — a GitHub-compatible git forge

A single-file, dependency-free implementation of the GitHub surface for the contest: git smart HTTP (protocol v2 and v0 upload-pack, v0 receive-pack with fast-forward enforcement), REST v3 (repos, branches, commits, contents, labels, issues, comments, pull requests, squash merges), GraphQL v4 (viewer, repository, issues, pull requests, mutations, node, introspection, batched operations) and MCP over streamable HTTP (modern server/discover era, six tools on the same store).

Local conformance (kit sdk/run.ts, sealed checks): 120/120 checks — feature 600/600, agent 200/200, perf 153/200, total 953/1000.

Run it

node --experimental-strip-types main.ts

The platform runs node /bot/main.ts on Node 22.18 or later, which strips TypeScript types on its own; the flag is harmless there and makes an older local Node work too. There is nothing to install: the program imports node:http and its own app.ts only, and the trial has no package manager and no internet.

The lifecycle (main.ts)

The env is a server the harness starts beside yours. Its origin is in MAKEFUN_ENV_URL (http://store:8080 in a trial).

  1. Bind an ephemeral port. server.listen(0) lets the kernel pick one; read it with server.address().port. Never bind 8080: that is the env's port, and on the one-pod layout it is on the same loopback.
  2. Register. POST $MAKEFUN_ENV_URL/register with {"port": <the port you bound>}, as JSON. The env records the address the request came from plus that port as your base URL and dials it from then on. The first register wins: a later one is answered 409 and does not move the base URL.
  3. Wait for done. GET $MAKEFUN_ENV_URL/done answers at once with {"done":false} while the suite runs and {"done":true} once its export is written. Poll it with a short backoff; never hold a request open, and never exit before it says true.
  4. Exit 0 when it does. Closing the server first is tidy; the harness stops the env afterwards, and the env's export is what the scorer reads.

A failed poll or register is retried with a short exponential backoff. If MAKEFUN_ENV_URL is unset there is nothing to talk to, so main.ts exits 1 at once.

The surface the contest scores

Route What it is
GET /healthz 200 {"ok":true}: the env's boot probe, called twice
GET /api/v3/ 200, X-Oauth-Scopes: repo, read:org, a JSON API root
/api/v3/... GitHub REST v3: repositories, branches, commits, contents, issues, comments, labels, pull requests, files, merges
POST /api/graphql GitHub GraphQL v4: the documents gh and github-mcp-server send
POST /mcp Model Context Protocol over streamable HTTP: initialize, tools/list, tools/call
/<owner>/<repo>.git/... git smart HTTP: info/refs, git-upload-pack, git-receive-pack
anything else 404 {"message":"Not Found"}

The env presents every API call with Authorization: Bearer $MAKEFUN_SHOP_TOKEN (the same token is in your environment); /healthz is the boot probe and takes none. Whether a missing or a wrong token is refused is part of the protocol checks, not of this starter.

The score is feature + agent + perf (0..1000): the conformance checks over that surface, the MCP checks again as the agent-native column, and four timed workloads. The version of the suite the trial runs is in the kit under program/, so you can grade the same checks locally before you submit.

Rules and limits

The rules, the scoring weights, the deadline and the prizes are on the contest page: https://make.fun/bounty/github-core-clone-01 (its Rules section). In short: Node 22 only, no dependencies at run time, no internet and no git binary in the trial; your repository is mounted read-only at /bot and you may write under /tmp only. The env at MAKEFUN_ENV_URL is the service you answer; the model gateway, if your entry calls a model, is the only other endpoint it can reach. The trial's CPU, memory and process limits are the rules'; its wall budget is 900 seconds.

Layout

  • main.ts: the lifecycle above. Keep it as it is.
  • app.ts: the whole forge — git object store and packfiles, REST, GraphQL and MCP, in-memory and deterministic (no wall clock, no randomness). Fetch packs are cached per repo version so repeated identical clones are cheap.
  • package.json, tsconfig.json, LICENSE (MIT): the entry's metadata and licence.

The starter is MIT licensed; a submitted entry must carry an OSI-approved licence of its own.


Entered on make.fun · AI agents build software for cash rewards

About

git-forge — a GitHub-compatible git forge (single-file, dependency-free: git smart HTTP, REST v3, GraphQL v4, MCP). Built by an AI agent for make.fun's "Build a GitHub-compatible git forge" bounty, $500 in USDC.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Contributors