Agent Data Hub v0.1.13

Agent Data Hub v0.1.13

Agent Data Hub v0.1.13 is a first-run and local-operations hardening release
for the local-first technical preview.

It keeps the product claim narrow: reviewed context for humans and agents, not
a hosted service, not an autonomous memory grabber, and not a replacement for
repo-local working rules.

What Changed

Public First-Run Compression

• The README quickstart now points new users through one short path instead of
  presenting several equal-looking startup routes.
• The public getting-started guide now separates the fast path, expected first
  checks, troubleshooting, mobile preview, and manual path.
• A new first-run demo session documents the exact happy path: start the demo,
  open the demo project, review one draft, prepare one agent handoff, and check
  the boundaries.

Local Ops Reliability

• agent-hub doctor diagnoses the local Docker/Postgres Hub runtime without
  writing memory.
• scripts/db_doctor.sh checks Docker, Compose, the configured container and
  volume, Postgres readiness, recent logs, agent-hub status, and
  agent-hub check.
• scripts/db_recover.sh --apply provides a guarded recovery path for known
  stale Postgres lock-file failures.
• Recovery creates a Docker-volume snapshot first, recreates only the
  container, removes only empty or NUL-only postmaster.pid, and never removes
  volumes or alters Hub memory rows.

Backup Health Friction Reduced

• Regular preflight still requires a fresh local backup with a valid checksum.
• Configured remote backup parity is still checked and reported.
• Remote parity becomes a hard blocker only with
  AGENT_HUB_REQUIRE_REMOTE_BACKUP=1 or
  scripts/db_backup_health.sh --require-remote.

Recommended First Run

From a fresh folder:

git clone https://github.com/AlexanderSmyslowski/central-agent-data-hub.git
cd central-agent-data-hub
scripts/first_run_demo.sh

Then follow:

docs/public/first-run-demo-session.md

Verification

This release candidate was checked with:

git diff --check
bash -n scripts/*.sh
.venv/bin/python -m compileall agent_hub
.venv/bin/python -m pytest -q
agent-hub doctor
.venv/bin/python -m agent_hub.cli doctor
scripts/db_backup_health.sh --require --require-remote
scripts/db_recover.sh
scripts/smoke_public_demo.sh
agent-hub status
agent-hub check

Boundaries

• no schema change
• no migration
• no new dependency
• no new Hub-memory write path
• no hosted service
• no automatic recovery without explicit --apply
• no autonomous agent execution
• no authentication or role system

Release Position

v0.1.13 is suitable for evaluating whether a new developer can understand the
core loop quickly: start a neutral local demo, inspect reviewed memory, review a
draft explicitly, prepare an agent handoff, and diagnose local runtime problems
without guessing.

It remains a technical preview. The release improves first-run clarity and
local reliability; it does not broaden Agent Data Hub into a hosted product or
an automatic memory system.