greatgc-flow/peerhub

Core recipe: peer register, stream create, record append, record read, offset get/advance; probe re-runs `peerhub record read --stream core-demo` against the store and expects the appended record body.

cd <host-path> && git log -1 --format=%H 2>/dev/null; ls -la; cat README.md 2>/dev/null | head -200
cd <host-path> && python3 --version && (python3 -m pip --version || true) && ls <host-path>; cat .coldpass 2>/dev/null; ls -la .coldpass 2>/dev/null; grep -n "^#" README.md | sed -n '1,80p'
cd <host-path> && (python3 -m venv /tmp/ph-venv 2>&1 || (apt-get update -qq && apt-get install -y -qq python3-venv >/dev/null 2>&1 && python3 -m venv /tmp/ph-venv)) && /tmp/ph-venv/bin/pip install -q -e ".[dev]" 2>&1 | tail -5; echo EXIT=$?; /tmp/ph-venv/bin/peerhub --version; /tmp/ph-venv/bin/peerhub --help | head -30
sudo apt-get update -qq && sudo DEBIAN_FRONTEND=noninteractive apt-get install -y -qq python3-venv python3-pip >/dev/null 2>&1; echo APT=$?; rm -rf /tmp/ph-venv; python3 -m venv /tmp/ph-venv && cd <host-path> && /tmp/ph-venv/bin/pip install -q -e ".[dev]" 2>&1 | tail -5; echo PIP=$?; /tmp/ph-venv/bin/peerhub --version
cd <host-path> && P=/tmp/ph-venv/bin/peerhub; $P peer register --peer reader --name "Demo reader" && $P stream create --stream core-demo --members reader && $P record append --stream core-demo --author-peer reader --kind message --body '"Hello"' --idempotency-key core-demo-001 --created-at 2026-10-10T00:00:00Z && $P record read --stream core-demo --after 0 --limit 10 && $P offset get --peer reader --stream core-demo && $P offset advance --peer reader --stream core-demo --position 1 --revision 1 && $P offset get --peer reader --stream core-demo; echo EXIT=$?
cd <host-path> && ls -la .peerhub 2>&1; P=/tmp/ph-venv/bin/peerhub; $P --db <host-path> peer register --peer reader --name "Demo reader" 2>&1; echo EXIT=$?; ls -la .peerhub 2>&1; grep -rn "unable to open\|mkdir" peerhub/*.py peerhub/**/*.py 2>/dev/null | head -10
cd <host-path> && mkdir -p .peerhub && P=/tmp/ph-venv/bin/peerhub; $P peer register --peer reader --name "Demo reader" && $P stream create --stream core-demo --members reader && $P record append --stream core-demo --author-peer reader --kind message --body '"Hello"' --idempotency-key core-demo-001 --created-at 2026-10-10T00:00:00Z && $P record read --stream core-demo --after 0 --limit 10 && $P offset get --peer reader --stream core-demo && $P offset advance --peer reader --stream core-demo --position 1 --revision 1 && $P offset get --peer reader --stream core-demo; echo EXIT=$?
cd <host-path> && mkdir -p .coldpass && cat > .coldpass/probe.json <<'EOF'
{"kind":"cli","argv":["/tmp/ph-venv/bin/peerhub","record","read","--stream","core-demo","--after","0","--limit","10"],"cwd":"<host-path>","expected_text":"Hello"}
EOF
cat > .coldpass/report.json <<'EOF'
{"outcome":"working","operation":"Core recipe: peer register, stream create, record append, record read, offset get/advance; probe re-runs `peerhub record read --stream core-demo` against the store and expects the appended record body.","operation_scope":"Local Core store only (no provider CLIs, no network, no browser). Provider-backed commands (ask, observation refresh) not exercised; they need vendor CLIs and spend quota.","steps":["python3 -m venv /tmp/ph-venv (apt python3-venv installed first)","/tmp/ph-venv/bin/pip install -e \".[dev]\"  (README: Develop from this checkout)","/tmp/ph-venv/bin/peerhub --version -> peerhub 0.21.0","README Core recipe: peer register, stream create, record append, record read, offset get, offset advance, offset get (all exit 0)"],"deviations":["System python3 had no venv/pip: ran `apt-get install python3-venv python3-pip` and used a venv at /tmp/ph-venv instead of a bare `python -m pip install`.","README Core recipe failed first with `ERROR: unable to open database file` because <host-path> did not exist. Ran `mkdir -p .peerhub` then reran the recipe unchanged. No source edited."],"stuck_step":null,"main_blocker":null,"suggested_fix":null}
EOF
python3 -m json.tool .coldpass/probe.json >/dev/null && python3 -m json.tool .coldpass/report.json >/dev/null && echo JSON_OK; <env-var>=<host-path> python3 -I <host-path> --validate; echo EXIT=$?
cd <host-path> && /tmp/ph-venv/bin/peerhub record read --stream core-demo --after 0 --limit 10 | grep -c '"body": "Hello"'; echo EXIT=$?