Skip to content

docs: comprehensive documentation update for post-v0.16.0 features#2085

Merged
bug-ops merged 1 commit intomainfrom
docs/post-v16-documentation-update
Mar 21, 2026
Merged

docs: comprehensive documentation update for post-v0.16.0 features#2085
bug-ops merged 1 commit intomainfrom
docs/post-v16-documentation-update

Conversation

@bug-ops
Copy link
Owner

@bug-ops bug-ops commented Mar 21, 2026

Summary

Specs (8 files in specs/)

  • 004-memory: semantic response caching, anchored summarization, compaction probe, importance scoring
  • 012-graph-memory: MAGMA typed edges, SYNAPSE spreading activation
  • 006-tools: TAFC, schema filtering, result cache, dependency graph
  • 002-agent-loop: HiAgent subgoal-aware compaction
  • 009-orchestration: plan template caching (HandoffContext section removed)
  • 015-self-learning: multi-language FeedbackDetector (7 languages)
  • 007-channels: channel feature parity (16-method trait)
  • handoff-skill-system: rewritten to reflect current state (skill-based YAML protocol, no code validation)

mdbook (16 pages in book/src/)

  • why-zeph.md fully rewritten with new value proposition sections
  • references.md expanded with 7 new research papers (SYNAPSE, MemOS, HiAgent, TAFC, APC, Less is More, Speculative Tool Calls, MAST)
  • Updated: concepts (memory, graph-memory, tools, task-orchestration), guides (semantic-memory, self-learning), advanced (context, tools, self-learning, tui), reference (configuration, cli), architecture (crates-overview, token-efficiency), getting-started (wizard)

READMEs (10 files)

  • Root README + 9 crate READMEs (memory, tools, core, orchestration, tui, channels, scheduler, skills, sanitizer)

Test plan

  • mdbook build book/ passes without errors
  • No stale HandoffContext references in any documentation file
  • All new config field names verified against source code
  • Visual review of rendered mdbook pages

@github-actions github-actions bot added documentation Improvements or additions to documentation skills zeph-skills crate memory zeph-memory crate (SQLite) channels zeph-channels crate (Telegram) core zeph-core crate size/XL Extra large PR (500+ lines) labels Mar 21, 2026
Cover 14 new features across specs, mdbook, READMEs, and references:
- Memory: SYNAPSE spreading activation, MAGMA typed edges, semantic
  response caching, anchored summarization, compaction probe, importance
  scoring
- Tools: TAFC, schema filtering, result cache, dependency graph
- Context: HiAgent subgoal-aware compaction
- Orchestration: plan template caching
- Self-learning: multi-language FeedbackDetector
- Channels: feature parity across all 7 channels

Rewrite why-zeph.md to reflect full value proposition.
Add 7 new research references (SYNAPSE, MemOS, HiAgent, TAFC, APC,
Less is More, Speculative Tool Calls, MAST).
Rewrite handoff-skill-system spec to reflect current state after
HandoffContext revert (#2082).
Remove all stale HandoffContext references from documentation.
@bug-ops bug-ops force-pushed the docs/post-v16-documentation-update branch from c28a79d to 6c2d344 Compare March 21, 2026 13:24
@bug-ops bug-ops enabled auto-merge (squash) March 21, 2026 13:24
@bug-ops bug-ops mentioned this pull request Mar 21, 2026
8 tasks
@bug-ops bug-ops merged commit 9b183ff into main Mar 21, 2026
29 checks passed
@bug-ops bug-ops deleted the docs/post-v16-documentation-update branch March 21, 2026 13:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

channels zeph-channels crate (Telegram) core zeph-core crate documentation Improvements or additions to documentation memory zeph-memory crate (SQLite) size/XL Extra large PR (500+ lines) skills zeph-skills crate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant