git.lucas.co / cce-graph
node-based graph editor
git clone https://git.lucas.co/cce-graph.git

commitf97ca8e376616d54d44dc74a569b6c269ecf3502
parent96f2b1a8fc
authorLucas Galante <[email protected]>
date2026-09-19 07:26
docs: committing is not publishing — origin is a pushable bare repo

This file said `origin` was fetch-only and that committing locally published
via gitsite. That stopped being true when `~/.local/bin/git-bare-sync.sh` added
the bare layer: `origin` is the local bare repo `~/git/cce-graph.git`, a
real pushable remote, and the old static mirror
`https://git.lucas.co/cce-graph.git` is demoted to the `published` remote —
it never accepted a push (dumb HTTP, no receive-pack), which is the whole reason
the bare layer exists.

Acting on the stale wording leaves work that looks published on this machine and
is not on the site. That gap was workspace-wide on 2026-09-18: 21 crates held
unpushed commits, because the bulk pusher read `repos.conf` field 2 as a work
tree when that field holds the bare path, and skipped all 34 repos in silence.

The chain is `git commit` → `git push origin main` → `gitsite.timer` → the site.

Matches the wording already corrected in cce-compositor/WORKSPACE.md and
cce-remote/CLAUDE.md.

Co-Authored-By: Claude Opus 5 <[email protected]>

 CLAUDE.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/CLAUDE.md b/CLAUDE.md
index 9dd8d71..bc50124 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -7,9 +7,10 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 `cce-graph` is a node-graph / mood-board editor client for the CCE Wayland desktop
 environment: a grid-aligned canvas of connected nodes plus free-floating images, saved
 as KDL project directories. It is one crate of the multi-repo `cce` workspace (its own
-git repo side-by-side with its siblings; published read-only at
-`https://git.lucas.co/cce-graph.git` via the gitsite system — the local repo is the
-source of truth, there is no push remote). Read the workspace-level
+git repo side-by-side with its siblings; `origin` is the local *bare* repo
+`~/git/cce-graph.git`, so **committing is not publishing — `git push origin main` is**,
+after which the gitsite system mirrors it to `https://git.lucas.co/cce-graph.git`, the
+old fetch-only static mirror now kept as the `published` remote). Read the workspace-level
 `../cce-compositor/WORKSPACE.md` first — workspace layout, the `cce-ui` toolkit, config
 conventions, and the multi-repo rules (each crate is its own git repo; commit here, not at
 the workspace root) all live there.