fable-agent/docs/biomimicry-positioning.md

57 lines
3.2 KiB
Markdown

# Biomimicry Positioning
## Thesis
fable-agent uses biological metaphors only when they map to verifiable engineering primitives:
```text
immune system → layered security gates
nervous system → receipt/event observability
biological computation → adaptive, event-driven evaluation
```
The product claim stays narrow: fable-agent is not a new organism or orchestrator; it is an agentic attestation layer that records proof, risk, and deploy readiness.
## External validation signals
| Signal | Pattern | fable-agent mapping | Source |
|---|---|---|---|
| BioDefense | Immune-system-inspired defense-in-depth for LLM agents | 5-layer verification: safety gate → AST/glyph scanners → build/test/docs → attestation → guarded deploy | [BioDefense gist](https://gist.github.com/andreschauer/e0f958c2a279062559ae8306f946b43d) |
| Agent Nervous System / agent observability | Tool traces, spans, eval gates, release enforcement | Receipt consumers and `.runs/<id>/channel.jsonl` events | [Braintrust agent observability guide](https://www.braintrust.dev/articles/agent-observability-complete-guide-2026) |
| SNNs for finance | Biologically inspired temporal/event processing in markets | Event receipts and benchmark set graders over vibes | [arXiv:2512.05868](https://arxiv.org/abs/2512.05868) |
## Architecture analogy
| Biological layer | Engineering layer | Current fable-agent primitive |
|---|---|---|
| Innate immune response | Fast input triage | `plinius safety`, content safety gate, adaptive reframing detection |
| Pattern recognition receptors | Structural threat detection | AST capability scanner, glyph/covert-channel scanner |
| Adaptive immunity | Learned risk memory | receipts, hallucination detections, RSI verification receipts |
| Memory B cell | Pattern cache for repeat encounters | `.fable/memory-b-cells.json`, `fable.memory_b_cell.v1` |
| Nervous system | Runtime telemetry | channel events, typed receipts, attestations |
| Motor reflex | Controlled action | guarded `8099/deploy via git-proxy` decision path |
## Boundaries
- Do not claim biological novelty; claim engineering convergence.
- Do not claim generic self-healing until non-canary degraded repair is proven.
- Do not treat memory as proof; receipts remain the trust primitive.
- Current guarded deploy path is `8099/deploy via git-proxy`; `8098 deploy-webhook` is legacy infrastructure context, not the decision primitive.
## Product line
```text
Biological systems survive by sensing, verifying, remembering, and acting through constrained channels.
fable-agent applies that pattern to agent work: scan, verify, attest, and only then deploy.
```
## Live implementation checklist
| Biological primitive | Implementation | Status |
|---|---|---|
| Immune system | 5-layer verification pipeline | implemented |
| Memory B cell | Pattern cache: first encounter scans, repeat encounter cache hits | implemented |
| Apoptosis | Deploy gate / kill switch remains fail-closed | implemented via guarded deploy checks |
| Homeostasis | Receipt consumer freshness check | implemented via `fable5 receipt-health` |
| Nervous system | Receipt/channel/attestation event surface | implemented via `.runs/<id>/channel.jsonl` and attestations |