**Bead** `ab96c2ea-c036-4163-bf09-ab228c7252b4` · [canonical URI](https://redfish.acequia.io/guerin/.agents/ab96c2ea-c036-4163-bf09-ab228c7252b4/) · discussion: Talk: Acequia Git This page is the wiki facet of a [bead](https://redfish.acequia.io/guerin/.agents/); the bead is the source of truth.
> An agent that can serve as a **node in a decentralized git-hub**: hosting, replicating, and routing the git **history faces** of beads over the acequia WebDAV mesh — forks and pull requests included, no center required.
## Identity - **name:** `acequia-git` - **URI:** https://redfish.acequia.io/guerin/.agents/ab96c2ea-c036-4163-bf09-ab228c7252b4/ - **Local origin:** `sites/redfish.acequia.io/guerin/.agents/ab96c2ea-c036-4163-bf09-ab228c7252b4/` - **GUID:** `ab96c2ea-c036-4163-bf09-ab228c7252b4` - **Opened:** 2026-06-12 - **Hatched by:** Stephen ("start-bead acequia-git that as an agent can serve as a node in a decentralized git-hub"), scribe CE (animating the snow-globe session) - **Birth context:** sibling threads — [#devops](https://redfish.acequia.io/guerin/.agents/64be6d29-d133-4ade-9dce-f62701003e37/agent.md) (whose policy defaults name this bead as the serving substrate), [git-and-beads](https://redfish.acequia.io/guerin/.agents/d9dfa5e4-3c92-4216-bd53-13b520c59a5e/2026-06-11/notes/git-and-beads.md) (placement rule + bead-CDN), and the [sphere-apps in-bead repo](https://redfish.acequia.io/guerin/.agents/6a8f0a99-c255-4a5c-9c4a-9097d0ee9cd8/repo/) (the pilot repo a node would serve first).
## Motivation (Why a GUID) The commons just adopted **git-in-the-bead** as the default (devops policy, 2026-06-12). That makes every authoring bead carry a history face — and someone has to **serve** those faces: clone/fetch for consumers, gated pushes for writers, N replicas for availability, fork/PR routing for collaboration. GitHub bundles all of that into one center; this bead is the workshop for the *decentralized* version, where each function lands on acequia primitives that already exist. One bead per capability-thread, per the ecology; this bead owns the **node**.
## Mechanism (What this bead does) - Holds the **node design** ([2026-06-12/notes/00-acequia-git-node-design.md](2026-06-12/notes/00-acequia-git-node-design.md)) — the GitHub-function → acequia-primitive mapping, the node's six capabilities, and the liveness ladder (static packfiles → service-worker isomorphic-git → OS animator). - Carries an **agent-face from birth** ([agent.md](agent.md) / [agent.json](agent.json)) — this bead *is* the node's charter; a running node is this agent animated at some rung of the ladder. - Will hold the **skills/prototypes** (dumb-HTTP serving check, `update-server-info` hygiene, PR-dock message shape) as they are built. - Does **not** own the repos it serves — repos live in their authoring beads; this node holds replicas and routes requests.
## Folder Layout - `about.md`, `README.md`, `agent.md`, `agent.json`, `names.json`, `keywords.json` — standard root files. - `uploads/` — inbound dock (PR-routing requests, replica offers, policy questions). - `2026-06-12/{notes,skills,chats,artifacts}/` — dated workshop.
## Session Log - **2026-06-12** — Hatched. Node design note written (function mapping, six capabilities, liveness ladder, MVP = serve the sphere-apps pilot repo via dumb-HTTP over Nephele). Agent-face authored. - **2026-06-12 (same session)** — **MVP done: rung-1 node live.** `git clone https://redfish.acequia.io/guerin/.agents/6a8f0a99-c255-4a5c-9c4a-9097d0ee9cd8/repo/.git` verified anonymous, full history, including one re-publish cycle (new commit → gc → update-server-info → PUT deltas → re-clone). Recipe + findings (webdav-sync skips dot-dirs = accidental per-face sync; Nephele serves dotfiles; gc packs refs): [skills/serve-bead-repo-dumb-http.md](2026-06-12/skills/serve-bead-repo-dumb-http.md). - **2026-06-12 (cont.)** — Stephen: also serve **GitHub-like functions**. Charter extended with six hub verbs (browse / issues / review / release / notify / index) — [notes/01-github-like-functions.md](2026-06-12/notes/01-github-like-functions.md). Key reading: most of GitHub is rung 1–2 (static store + in-browser isomorphic-git); only merge execution, CI, and gated smart-push want the animator. Shared artifact: `hub.html?bead=<URI>`; dogfood rule — hub.html's source goes in this bead's own `repo/`, served by the mechanism it fronts. Queued: bead repo init, hub.html v0 (README/tree/file), v1 (log/diff/PR view), `issues/` pilot on sphere-apps.
## Modus Operandi (How to interact) - **Consume:** read [agent.md](agent.md) for what a node does; the design note for why. - **Request:** PUT into `uploads/` — e.g. "replicate bead X's history face", or a PR envelope to route. - **Animate:** a CE/CV session (or later an OS animator daemon) loads `agent.md` as its charter and runs the step loop.
## Capabilities - **serve (rung 1, live):** [skills/serve-bead-repo-dumb-http.md](2026-06-12/skills/serve-bead-repo-dumb-http.md) — publish + re-publish recipe, verified on the sphere-apps pilot. - replicate / gate-pushes / fork / route-PRs / advertise: designed (agent.md), not yet built. - **hub verbs** (browse / issues / review / release / notify / index): designed ([notes/01](2026-06-12/notes/01-github-like-functions.md)); `hub.html` queued.
## Lifecycle - **Energization:** referenced at birth by #devops `agent.md`/`agent.json` (policy default 4) and by the snow-globe bead's session — live inbound edges. - **Step:** serve/replicate/route per agent.md when animated. - **Apoptosis:** if the in-bead-git default is reversed or a different serving substrate is adopted, this bead archives its design and decays to the archival floor.
## Limitations - Rung 1 only: clone/fetch is live; pushes are local-origin + re-publish until the SW/animator rungs exist. - A node never holds merge authority — that stays with the owning bead (devops policy default 3). - CB cannot push (no PUT); CB participates via the SW rung (clone/fetch) and dock deposits.
## References (bead cross-links) - Bead: Devops · [canonical](https://redfish.acequia.io/guerin/.agents/64be6d29-d133-4ade-9dce-f62701003e37/) - Bead: Agentify Bead · [canonical](https://redfish.acequia.io/guerin/.agents/d9dfa5e4-3c92-4216-bd53-13b520c59a5e/) - Bead: Snow Globe Harvard Spheres · [canonical](https://redfish.acequia.io/guerin/.agents/6a8f0a99-c255-4a5c-9c4a-9097d0ee9cd8/) - Bead: Sovereign Webdav · [canonical](https://redfish.acequia.io/guerin/.agents/1ca761b0-cb21-4bd7-be94-12dcc5824851/) - Bead: As Webdav Handler · [canonical](https://redfish.acequia.io/guerin/.agents/fe7fbaf5-4c47-43b6-be1b-2f6ca15e8bfa/)
See all: Beads