feat(forge_pheno_memory): wire thegent-memory v2 polyglot facade (PR 4 of the 3-PR sequence, ADR-096)

[KooshaPari]

Summary

This is the contribution-back step of the 3-PR forgecode improvement sequence (ADR-096, accepted 2026-06-23). It adds a new workspace member crates/forge_pheno_memory that wires the thegent-memory v2 polyglot facade (supermemory + letta + cognee + mem0) into forgecode's Infra + Domain pattern.

Forgecode agents can now use a stable, scope-routed memory API without coupling themselves to any specific memory engine.

Companion repos

• Plugin bundle (fork of the user-side installation): KooshaPari/pheno-forge-plugins v0.1.0 — 6 systemd-managed sidecar plugins (supermemory, letta, cognee, mem0, config, tracing) brought up at machine boot.
• Memory substrate (the v2 polyglot facade this PR consumes): KooshaPari/thegent#1144 (merged) — MemoryPort trait + 4 adapters + CompositeAdapter router.
• C-ABI bridge (for non-Rust consumers): KooshaPari/pheno-cdylib-bridge v0.1.0 — 8 C symbols, used by the C smoke test in c/examples/smoke.c.

What this PR adds

New crate: crates/forge_pheno_memory/

use forge_pheno_memory::{PhenoMemoryService, PhenoMemoryScope};
use thegent_memory::v2::{MemoryValue, MemoryQuery};

let svc = PhenoMemoryService::with_defaults();

svc.store(PhenoMemoryScope::Episodic.into(), "k", "v".into()).await?;
let recs = svc.recall(
    PhenoMemoryScope::Episodic.into(),
    MemoryQuery::new("q"),
).await?;

Scope routing (locked per ADR-096)

MemoryScope	Backing engine	Default endpoint
Episodic	supermemory (smfs filesystem)	http://127.0.0.1:3030
Identity	letta (subconscious blocks)	http://127.0.0.1:8283
ProjectKnowledge	cognee (knowledge graph)	stdio cognee-mcp
Fallback	mem0	http://127.0.0.1:8000

Errors

PhenoMemoryError is a thiserror::Error enum that surfaces MemoryError from the underlying v2 port. Variants: Network, Backend, NotFound, Serde, Unavailable, Invalid, Internal.

Test results

test result: ok. 3 passed; 0 failed   (config_defaults, service_constructs, scope_round_trip)

Why this is additive

• thegent-memory is a path dep (can be swapped for a crates.io dep once it's published).
• forge_pheno_memory is a new workspace member; no existing crate is modified.
• No new build dependency is required to compile the rest of the workspace (the new crate is opt-in via workspace member).

Refs

• ADR-096: docs/adr/2026-06-23/ADR-096-forgecode-improvement.md
• Master plan: findings/2026-06-23-forgecode-improvement-plan.md
• Spec: thegent/docs/specs/memory/v2.md (memory v2 polyglot facade)
• PR 1 (user-side): KooshaPari/pheno-forge-plugins v0.1.0
• PR 2 (memory substrate): KooshaPari/thegent#1144 (merged)
• PR 3 (C-ABI for non-Rust consumers): KooshaPari/pheno-cdylib-bridge v0.1.0

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution.
0 out of 3 committers have signed the CLA.

❌ Phenotype Agent
❌ KooshaPari
❌ Dmouse92

---

Phenotype Agent seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}