S58: README rewrite + HERALD.md + fresh install fixes (#140)

* docs: rewrite README with verified claims + add HERALD.md progress tracker

README rewritten and verified against live system:
- All commands tested and confirmed working
- drone systems shows 23 (15 core + 8 test), documented correctly
- seedgo at 33 standards (was incorrectly stated as 34)
- Docker setup-workspace.sh fork URL noted
- setup.sh sudo requirement documented
- prax monitor marked as interactive
- Added Standards, Communication, and Structure sections
- Removed session tracking (moved to HERALD.md)
- Branch table expanded with roles and descriptions

HERALD.md: Living progress doc for Patrick to read between sessions.
Contains session history, active DPLANs, milestones, known issues.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* fix(install): registry format mismatch + seedgo CLI entry point

Bugs found via fresh Docker install test:

1. setup.sh generated AIPASS_REGISTRY.json with branches as dict (keyed
   by name), but seedgo's discovery.py expected a list of dicts. Result:
   `drone @seedgo audit aipass` was completely broken on any fresh install.
   Fix: setup.sh now generates list format (matching existing registry).

2. setup.sh verified `seedgo --help` but seedgo has no CLI entry point —
   it's only accessible via `drone @seedgo`. Fix: check `drone @seedgo --help`
   instead, remove broken symlink attempt.

3. seedgo discovery.py now handles both list and dict registry formats
   defensively (in case old registries exist).

4. README updated to remove seedgo standalone CLI claims.

Verified: full fresh install in Docker container — setup.sh completes
successfully, drone systems shows 15 branches, seedgo audit runs clean.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

src/aipass/seedgo/apps/handlers/audit/discovery.py

@@ -94,7 +94,12 @@ def discover_branches(include_private: bool = False) -> List[Dict[str, str]]:
 
         registry_dir = registry_path.parent
 
-        for branch in registry_data.get('branches', []):
+        raw_branches = registry_data.get('branches', [])
+        # Handle both list format and dict format (keyed by name)
+        if isinstance(raw_branches, dict):
+            raw_branches = list(raw_branches.values())
+
+        for branch in raw_branches:
             branch_name = branch.get('name', '')
             raw_path = branch.get('path', '')
             branch_path = Path(raw_path)