fix(hooks): C2 failure trails + C3 GREPLICA_HOME pin (#145)

[aadivyaraushan]

Summary

Part C correctness/runtime fixes from #145:

• C2 — Hook worker failures are no longer a black hole: each failure appends one JSON line to $GREPLICA_HOME/logs/hook-worker.jsonl, and run artifacts are retained under $GREPLICA_HOME/logs/runs/ (last 20). Successful updates still clean up the temp run dir.
• C3 — resolveGreplicaHome() reports path + source (GREPLICA_HOME | ENGINEERING_CONTEXT_HOME | default). Hook worker / agent spawn env pins GREPLICA_HOME to the parent-resolved path. greplica doctor prints the active home path and source before Database/Config.

Skips C5 (owned by #108). Does not include C1/C4/C6 (separate PR).

Test plan

• npm run typecheck && npm test (includes new check-greplica-home-pin and check-hook-worker-failures)
• User-facing dry-runs for C2 and C3 (transcripts below)

Unit summary (commit 3f7d0d0)

> npm test
Transcript bundle checks passed.
Repo context checks passed.
Install option checks passed.
Repository installation checks passed.
Managed CLI checks passed.
Graph view checks passed.
Graph view offline browser check passed: charts rendered with zero network access.
Source membership checks passed.
check-proposal-validate: ok
BM25 tokenizer checks passed.
check-anchor-drift: ok
Find similar claims checks passed.
Proposal validation dedupe checks passed.
check-opencode-sqlite-transcript: ok
check-greplica-home-pin: ok
check-hook-worker-failures: ok

Dry-run transcripts

C3 — doctor + env pin

Greplica doctor
Repo: demo
...
Greplica home: /tmp/greplica-c2-c3-demo-U7D1He/home
Greplica home source: GREPLICA_HOME
Database: /tmp/greplica-c2-c3-demo-U7D1He/home/graph.db
...

parent resolved: {"path":"/tmp/greplica-c2-c3-demo-U7D1He/home","source":"GREPLICA_HOME"}
child env GREPLICA_HOME: /tmp/greplica-c2-c3-demo-U7D1He/home
pin matches parent: true

# ENGINEERING_CONTEXT_HOME when GREPLICA_HOME unset:
resolved: {"path":".../eng-home","source":"ENGINEERING_CONTEXT_HOME"}
child GREPLICA_HOME: .../eng-home
pinned equal: true

C2 — failed memory update leaves a trail

# Forced spawn claude ENOENT via empty PATH inside maybeUpdateWorkingMemory
log exists: true
log contents:
{"timestamp":"2026-07-22T14:02:51.087Z","platform":"claude","session_id":"dry-run-fail-session","phase":"working_memory_update","error":"spawn claude ENOENT"}
runs dir exists: true
retained runs: [ '2026-07-22T14-02-51-088Z-claude-dry-run-fail-session' ]
retained entries: [ 'agent-events.jsonl' ]

Made with Cursor

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.