zeph 0.18.4

Lightweight AI agent with hybrid inference, skills-first architecture, and multi-channel I/O
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96

# Zeph Specs

Feature principle documents — key invariants for coding agents.
See `constitution.md` for project-wide non-negotiable rules.

## Foundation

| Doc | Contents |
|---|---|
| `001-system-invariants/spec.md` | Cross-cutting architectural invariants |
| `constitution.md` | Project-wide non-negotiable rules |

## Core Agent

| Doc | Contents | Crate |
|---|---|---|
| `002-agent-loop/spec.md` | Agent loop, turn lifecycle, context pressure, HiAgent subgoal-aware compaction | `zeph-core` |
| `027-runtime-layer/spec.md` | RuntimeLayer middleware — before/after chat and tool hooks, catch_unwind guard | `zeph-core` |
| `028-hooks/spec.md` | Reactive hooks: cwd_changed / file_changed events, FileChangeWatcher, ZEPH_* env vars | `zeph-core` |
| `020-config-loading/spec.md` | Config resolution order, mode-agnostic defaults | `zeph-core` |

## LLM & Inference

| Doc | Contents | Crate |
|---|---|---|
| `003-llm-providers/spec.md` | LlmProvider trait, AnyProvider, prompt caching | `zeph-llm` |
| `022-config-simplification/spec.md` | Provider Registry Architecture: [[llm.providers]], PILOT LinUCB bandit routing, BaRP, MAR | `zeph-config`, `zeph-core` |
| `023-complexity-triage-routing/spec.md` | Pre-inference complexity classification: ComplexityTier, TriageRouter, context escalation | `zeph-llm`, `zeph-config` |
| `024-multi-model-design/spec.md` | Multi-model design principle: complexity tiers, *_provider subsystem reference pattern | cross-cutting |
| `025-classifiers/spec.md` | Candle ML classifiers: injection detection, PII detection, LlmClassifier for feedback | `zeph-classifiers` |

## Memory

| Doc | Contents | Crate |
|---|---|---|
| `004-memory/spec.md` | SQLite + Qdrant, compaction, A-MAC, MemScene, Kumiho, D-MEM, CraniMem, ACON, AsyncMemoryRouter, multi-vector chunking, GAAMA, BATS, Focus compression, SleepGate | `zeph-memory` |
| `012-graph-memory/spec.md` | Entity graph, BFS recall, community detection, MAGMA typed edges, SYNAPSE spreading activation | `zeph-memory` |
| `database-abstraction/spec.md` | PostgreSQL backend: zeph-db crate, DatabaseDriver trait, Dialect trait, sql!() macro, migrations | `zeph-db` |

## Skills & Self-Learning

| Doc | Contents | Crate |
|---|---|---|
| `005-skills/spec.md` | SKILL.md format, registry, matching, hot-reload, skill trust governance, SkillOrchestra LinUCB, D2Skill, NL generation, GitHub mining, channel allowlist | `zeph-skills` |
| `015-self-learning/spec.md` | FeedbackDetector, Wilson score, SAGE RL, ARISE, STEM, ERL, learning.rs submodules | `zeph-skills` |

## Tools & Execution

| Doc | Contents | Crate |
|---|---|---|
| `006-tools/spec.md` | ToolExecutor, CompositeExecutor, TAFC, utility gate, adversarial policy gate, shell sandbox, file read sandbox, tool invocation phase taxonomy | `zeph-tools` |
| `016-output-filtering/spec.md` | FilterPipeline, CommandMatcher, SecurityPatterns | `zeph-tools` |

## Channels & I/O

| Doc | Contents | Crate |
|---|---|---|
| `007-channels/spec.md` | Channel trait, AnyChannel dispatch, streaming, channel feature parity | `zeph-channels` |
| `011-tui/spec.md` | ratatui dashboard, spinner rule, TuiChannel | `zeph-tui` |
| `026-tui-subagent-management/spec.md` | Interactive TUI subagent sidebar, j/k navigation, JSONL transcript viewer | `zeph-tui` |
| `019-gateway/spec.md` | HTTP webhook ingestion, bearer auth | `zeph-gateway` |
| `018-scheduler/spec.md` | Cron scheduler, SQLite persistence | `zeph-scheduler` |

## Protocols

| Doc | Contents | Crate |
|---|---|---|
| `008-mcp/spec.md` | MCP client, server lifecycle, semantic tool discovery, elicitation, tool collision detection, intent-anchor nonce | `zeph-mcp` |
| `013-acp/spec.md` | ACP transports, sessions, permissions, fork/resume, capability advertisement, /agent.json | `zeph-acp` |
| `014-a2a/spec.md` | A2A protocol, agent discovery, JSON-RPC 2.0, IBCT tokens | `zeph-a2a` |
| `handoff-skill-system/spec.md` | Skill-based YAML handoff protocol for inter-agent communication | `zeph-orchestration` |

## Orchestration & Sub-Agents

| Doc | Contents | Crate |
|---|---|---|
| `009-orchestration/spec.md` | DAG planner, DagScheduler, AgentRouter, /plan, VMAO adaptive replanning, cascade routing | `zeph-orchestration` |
| `subagent-context-propagation/report.md` | /agent spawn context gap analysis — 12 gaps, phase-based fix plan | `zeph-subagent` |

## Security

| Doc | Contents | Crate |
|---|---|---|
| `010-security/spec.md` | Vault, shell sandbox, content isolation, SSRF, IPI defense, PII NER, cross-tool injection correlation, AgentRFC audit, IBCT, credential scrubbing | cross-cutting |

## Code Intelligence

| Doc | Contents | Crate |
|---|---|---|
| `017-index/spec.md` | AST indexing, semantic retrieval, repo map | `zeph-index` |

## Infrastructure & Build

| Doc | Contents | Crate |
|---|---|---|
| `029-feature-flags/spec.md` | Feature flag decision rules, surviving flag inventory (22 flags), bundle definitions | `Cargo.toml` |