docs: SHELET v0.4.0 README — stratification, citations, comparison, FAQ - #5
Open
mordechaipotash wants to merge 1 commit into
Open
docs: SHELET v0.4.0 README — stratification, citations, comparison, FAQ#5mordechaipotash wants to merge 1 commit into
mordechaipotash wants to merge 1 commit into
Conversation
Updates the README for the v0.4.0 release, centered on the SHELET reference implementation framing that shipped in PR #3 + PR #4. Key changes: - Lead reframed: "first SHELET-compliant MCP server" with structural citation discipline, not just "your AI has amnesia" - New "SHELET Architecture" section explaining L0→L3 stratification, the governing rule, and enforcement (CHECK constraints, RLS, skill manifests, verify-skills CI) - "For AI Assistants" — added explicit citation discipline section with correct/wrong examples and the ban on stripping citations - 25-tool table flattened and stratified by L0/L1/L2/L3/utility layer - Example tunnel-state output updated to show real [conv_id · date] citations - New "Compared to" comparison table vs mem0 / Letta / Zep / Rewind / Obsidian / official MCP memory — 7 capability axes - New 8-question FAQ (privacy / SHELET / vs-competitors / embedding swap / fallback / upgrades / multi-tenant / contributing) - Cross-links to ADR-001, ADR-002, Migration 003 - Honest corrections: - Auto-sync section now says manual sync is the contract (was: claimed automatic sync; auto-sync was disabled in v0.3.1) - Windsurf marked "uses Cursor ingester pattern" (was: false claim of native auto-detect) - Removed unverified "12ms" marketing claim in favor of "sub-second" Net: 261 insertions, 131 deletions on README.md. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Rewrites the README for the v0.4.0 SHELET release.
Key changes
brain.resolve_citations(l3_id)[conv_id · YYYY-MM-DD]citations on every bulletHonest corrections
Several claims in the old README didn't match v0.4.0 reality:
Net diff
261 insertions, 131 deletions across
README.mdonly. No code changes.Test plan
<details>, code blocks)#-for-ai-assistants,#-for-humans,#install,#the-shelet-architecture,#compared-to,#faqdocs/adr/001-shelet-reference-implementation.mddocs/adr/002-supabase-canonical-backend.mdsupabase/migrations/003_shelet_l0_to_l3.sqlscripts/verify_skills.py,CHANGELOG.md,LICENSE🤖 Generated with Claude Code