Merge pull request #8 from focaxisdev/codex/v0.6.0-universal-agent-memory

Deja Vu v0.6.0: universal agent memory starter kit

Author: focaxisdev

.github/workflows/ci.yml

@@ -0,0 +1,39 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+
+      - name: Install
+        run: npm ci
+
+      - name: Source tests
+        run: npm run test:src:readonly
+
+      - name: Memory lint
+        run: npm run lint:memory
+
+      - name: Feedback report
+        run: npm run report:feedback
+
+      - name: Build
+        run: npm run build
+
+      - name: Pack verification
+        run: npm run test:pack

AGENTS.md

@@ -0,0 +1,32 @@
+# Deja Vu Project Memory Rules
+
+## Memory Identity
+
+- Protocol: Deja Vu Protocol v0.4
+- Scope: `project:deja-vu`
+- Memory root: `memory/`
+
+For the full protocol details, see docs/protocol.md.
+
+## Recall Before Substantial Work
+
+Before substantial planning, coding, release preparation, or documentation changes:
+
+1. Inspect `memory/impressions.jsonl` for familiar cues.
+2. If there is no familiarity, do not load memory by default.
+3. If familiarity is weak, read `memory/summary.md`.
+4. If familiarity is strong, read only the 1-3 linked records needed for the task.
+5. Do not load the whole memory tree unless the user explicitly asks.
+
+## Durable Writeback Only
+
+Write back only durable project memory:
+
+- accepted product positioning
+- protocol or starter-kit decisions
+- CLI scope decisions
+- release readiness notes
+- unresolved follow-ups
+- safety or privacy constraints
+
+Never store secrets, full transcripts, PII, raw logs, low-signal chatter, or disposable exploration noise.

CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.6.0] - 2026-05-17
+
+- Reworked the README first screen around the "3-file memory system" positioning.
+- Added a copy-first `starter-kit/` with minimal `AGENTS.md`, memory files, and per-agent prompts.
+- Added comparison, compatibility, flow diagram, demo walkthrough, launch copy, and v0.6.0 release checklist docs.
+- Added the optional unified `deja-vu init`, `deja-vu doctor`, and `deja-vu explain` CLI.
+- Split read-only source tests from npm pack verification with `test:src:readonly` and `test:pack`.
+- Updated scripted recall to distinguish missing setup as `not_initialized`.
+
 ## [0.5.0] - 2026-04-25
 
 - Made remember/writeback a first-class companion to recall with a post-task writeback routing table in the README, protocol, workflow, and AGENTS template.