Skip to content

feat: Squad memory provider example with governed memory - #2

Merged
devigned merged 1 commit into
mainfrom
examples/squad-memory
Jun 3, 2026
Merged

feat: Squad memory provider example with governed memory#2
devigned merged 1 commit into
mainfrom
examples/squad-memory

Conversation

@devigned

@devigned devigned commented Jun 3, 2026

Copy link
Copy Markdown
Owner

Summary

Add examples/squad-memory/ demonstrating KD6 as a registered MemoryProvider for Squad's LocalMemoryStore. All memory operations flow through Squad's governance layer (classification, audit) before being persisted to KD6.

Depends on: PR #3 (name-based store routing)

What it demonstrates

  1. Governed writes — Squad classifies, audits, then persists to KD6
  2. Governed search — Squad governance + KD6 FTS5 results combined
  3. Direct KD6 verification — memories are persisted and searchable
  4. Name-based store routing/v1/stores/_default/memories just works, no UUID resolution needed

Components

File Purpose
kd6-provider.ts KD6 MemoryProvider using real Squad SDK types
main.ts Governed demo with LocalMemoryStore + KD6 registered
validate.ts Direct provider validation (12 assertions)
README.md Setup instructions

Squad → KD6 mapping

Squad Class KD6 Layer Purpose
LOCAL episodic Session-local context
DECISION semantic Architectural decisions
POLICY procedural Team-wide policies

Verified

  • npm start — governed write/search against live KD6 ✅
  • npm run validate — 12/12 assertions pass ✅
  • make ci — 149 Rust tests pass ✅
  • Name-based routing eliminates the UUID workaround that was previously needed

@devigned
devigned force-pushed the examples/squad-memory branch from 56afff5 to 0d6c7c8 Compare June 3, 2026 18:31
@devigned devigned changed the title feat: add Squad memory provider example feat: Squad memory provider example with governed memory Jun 3, 2026
@devigned
devigned changed the base branch from main to refactor/name-based-store-routing June 3, 2026 18:31
@devigned
devigned force-pushed the examples/squad-memory branch 3 times, most recently from 198a7ef to 800f015 Compare June 3, 2026 18:53
@devigned
devigned force-pushed the refactor/name-based-store-routing branch from 76be898 to cb36901 Compare June 3, 2026 19:42
Base automatically changed from refactor/name-based-store-routing to main June 3, 2026 19:44
Demonstrates using KD6 as a registered MemoryProvider for Squad's
LocalMemoryStore. Includes three entry points:

- npm start: minimal governed memory quickstart
- npm run sprint: multi-session sprint simulation showing governance,
  knowledge graphs, audit trails, lifecycle management, and GDPR
  compliance across a team building a recipe-sharing app
- npm run validate: 12-assertion provider validation suite

The sprint simulation shows why persistent memory matters for
multi-agent teams: knowledge compounds across sessions, decisions
link via typed graph edges, and compliance features (TTL, audit,
GDPR purge) keep the system production-ready.

Signed-off-by: David Justice <david@justice.dev>
@devigned
devigned force-pushed the examples/squad-memory branch from 800f015 to d29651b Compare June 3, 2026 19:48
@devigned
devigned merged commit 8a58961 into main Jun 3, 2026
1 check passed
@devigned
devigned deleted the examples/squad-memory branch June 3, 2026 19:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant