Skip to content

LLP 0118-0125: hermes log forwarding cluster - #331

Merged
philcunliffe merged 2 commits into
masterfrom
worktree-hermes-plugin-llps
Jul 20, 2026
Merged

LLP 0118-0125: hermes log forwarding cluster#331
philcunliffe merged 2 commits into
masterfrom
worktree-hermes-plugin-llps

Conversation

@philcunliffe

@philcunliffephilcunliffe commented Jul 20, 2026

Copy link
Copy Markdown
Contributor

What

Docs-only PR: the LLP cluster for a new @hypaware/hermes client adapter that forwards Hermes Agent activity into HypAware. All eight docs are Accepted (approved for implementation; they flip to Active as the implementation PRs land). No code.

The cluster

LLPTypeSettles
0118SpecRequirements R1-R10: hermes sessions land in ai_gateway_messages, idempotent, policy-honoring, read-only against hermes, auto-ongoing, observable
0119DecisionCapture seam: pull from ~/.hermes/state.db (canonical SQLite store); rejects a hermes-side push plugin and base_url wire attach
0120DecisionDataset: materialize via ai_gateway.projected_exchange with client_name='hermes'; no new table
0121DecisionPackaging: bundled in plugins-workspace/ beside claude/codex
0122Designnode:sqlite read-only reader, per-session watermark poll, deterministic session-end part, full projection mapping
0123PlanT1-T6: engines bump + reader → projector → backfill ∥ source → wiring → hermetic smoke
0124DecisionChannel sessions (Telegram/Discord/...) get canonical policy scope path ~/.hermes/channels/<source>: default full, standard marking machinery covers local-only/ignore, no bespoke config key
0125Decisionengines floor moves to Node >=22.12 (Node 20 is EOL; node:sqlite needed); CI gains a 22+24 matrix

Notes

  • Grilled 2026-07-20: the channel-privacy scope path (0124), the session-end receipt part (0122), and the engines bump (0125) all came out of that session; id-format concerns were verified moot (graph content-addresses ids).
  • Cluster was renumbered from 0115-0121 after claude-desktop-attach claimed 0115-0117.
  • The cluster is neutral-drivable: 0118-0121 + 0124-0125 are the accepted request set; 0122 design and 0123 plan are accepted seeds the pipeline can execute from directly.
  • ref-check is clean on all eight docs (the 91 repo-wide errors are pre-existing on master).

🤖 Generated with Claude Code

philcunliffeand others added 2 commits July 20, 2026 15:01
…, plan)
Design docs for a @hypaware/hermes client adapter that imports Hermes Agent
(NousResearch/hermes-agent) activity into ai_gateway_messages:
- 0118 spec: requirements R1-R10 for capturing hermes sessions
- 0119 decision: pull from ~/.hermes/state.db (not push, not the wire)
- 0120 decision: rows materialize into ai_gateway_messages via
ai_gateway.projected_exchange, no new table
- 0121 decision: bundled in plugins-workspace beside claude/codex
- 0122 design: node:sqlite reader, watermark poll, session-end part,
projection mapping
- 0123 plan: T1-T6
- 0124 decision: channel sessions get canonical policy scope path
~/.hermes/channels/<source> (default full, standard marking machinery
covers local-only/ignore)
- 0125 decision: engines floor moves to Node >=22.12
Grilled with Phil 2026-07-20; cluster renumbered from 0115-0121 after
claude-desktop-attach claimed 0115-0117.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Status Draft -> Accepted on all eight docs; plan note updated to reflect
the cluster landing via its own docs PR.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@philcunliffe
philcunliffe merged commit 10516c2 into masterJul 20, 2026
4 checks passed
@philcunliffe
philcunliffe deleted the worktree-hermes-plugin-llps branch July 20, 2026 22:07
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@philcunliffe