@theihtisham/agent-shadow-brain 6.0.0 → 6.0.2

package/README.md

@@ -1,10 +1,25 @@
 <div align="center">
 
-<a href="https://github.com/theihtisham/agent-shadow-brain/raw/main/docs/launch/shadow-brain-motion-explainer-narrated.mp4">
-  <img src="Banner (2).png" alt="Shadow Brain v6.0 — Hive Mind · Click to watch the 2-minute explainer" width="100%">
+<a href="https://github.com/theihtisham/agent-shadow-brain">
+  <img src="banner-v6.0.2.png" alt="Shadow Brain v6.0.2 — Singularity · 35 new modules · 5 viral features · 10 brain-quality upgrades · One brain, every agent" width="100%">
 </a>
-
-### 🎬 **[▶ Watch the 2-minute explainer](https://github.com/theihtisham/agent-shadow-brain/raw/main/docs/launch/shadow-brain-motion-explainer-narrated.mp4)** · Click the banner above
+<a href="https://trendshift.io/repositories/25944" target="_blank"><img src="https://trendshift.io/api/badge/repositories/25944" alt="lsdefine%2FGenericAgent | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+<br/><br/>
+
+<!-- v6.0.2 hero video — auto-plays muted on GitHub README -->
+<video src="https://raw.githubusercontent.com/theihtisham/agent-shadow-brain/main/docs/launch/shadow-brain-v6.0.2-hero.mp4"
+       poster="banner-v6.0.2.png"
+       autoplay
+       muted
+       loop
+       controls
+       playsinline
+       width="100%">
+  Your browser doesn't support inline video.
+  <a href="https://github.com/theihtisham/agent-shadow-brain/releases/tag/v6.0.2">Watch the v6.0.2 hero video on the release page</a>.
+</video>
+
+### 🎬 **2-minute v6.0.2 hero above — auto-plays muted · click 🔊 to unmute · [v6.0.2 release page](https://github.com/theihtisham/agent-shadow-brain/releases/tag/v6.0.2) · [original 2-min explainer](docs/launch/shadow-brain-motion-explainer-narrated.mp4) · [dashboard tour](docs/launch/shadow-brain-dashboard-tour.mp4)**
 
 [![npm version](https://img.shields.io/npm/v/@theihtisham/agent-shadow-brain?color=a855f7&labelColor=1a0a2e&style=for-the-badge&logo=npm)](https://www.npmjs.com/package/@theihtisham/agent-shadow-brain)
 [![npm downloads](https://img.shields.io/npm/dt/@theihtisham/agent-shadow-brain?color=06b6d4&labelColor=1a0a2e&style=for-the-badge)](https://www.npmjs.com/package/@theihtisham/agent-shadow-brain)
@@ -12,8 +27,8 @@
 [![license](https://img.shields.io/badge/license-MIT-8b5cf6?labelColor=1a0a2e&style=for-the-badge)](https://github.com/theihtisham/agent-shadow-brain/blob/main/LICENSE)
 [![TypeScript](https://img.shields.io/badge/TypeScript-100%25-3178c6?labelColor=1a0a2e&style=for-the-badge&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
 [![node](https://img.shields.io/badge/node-%3E%3D18-22c55e?labelColor=1a0a2e&style=for-the-badge&logo=node.js)](https://nodejs.org/)
-[![Brain Modules](https://img.shields.io/badge/brain_modules-48-ec4899?labelColor=1a0a2e&style=for-the-badge)](#-architecture)
-[![CLI Commands](https://img.shields.io/badge/CLI-90%2B_commands-eab308?labelColor=1a0a2e&style=for-the-badge&logo=windowsterminal)](#-cli-reference)
+[![Brain Modules](https://img.shields.io/badge/brain_modules-122-ec4899?labelColor=1a0a2e&style=for-the-badge)](#-architecture)
+[![CLI Commands](https://img.shields.io/badge/CLI-120%2B_commands-eab308?labelColor=1a0a2e&style=for-the-badge&logo=windowsterminal)](#-cli-reference)
 [![MCP Tools](https://img.shields.io/badge/MCP-60%2B_tools-8b5cf6?labelColor=1a0a2e&style=for-the-badge&logo=anthropic)](#-mcp-tools)
 [![Tests](https://img.shields.io/badge/tests-148%2F148_passing-10b981?labelColor=1a0a2e&style=for-the-badge&logo=vitest)](#)
 [![Local First](https://img.shields.io/badge/local--first-ollama_default-f97316?labelColor=1a0a2e&style=for-the-badge&logo=ollama)](#)
@@ -21,15 +36,30 @@
 
 <br/>
 
-# 🧠 Shadow Brain v6.0 — Hive Mind
+# 🧠 Shadow Brain v6.0.2 — Singularity
 
 ### *The first open-source brain that every AI coding agent on your machine can share.*
 
 **Claude Code · Cursor · Cline · Codex · Copilot · Windsurf · Kilo · Roo · OpenCode · Aider** — all running on one local brain. What one agent learns, every agent knows. What one sub-agent discovers, every sub-agent inherits.
 
+> **🆕 v6.0.2 "Singularity" — 19 world-first features. Every one of them shareable.**
+>
+> **The 5 viral artifacts** — each renders as a tweet-ready PNG/SVG/MP4:
+> 🎬 **Brain Replay** · 🧬 **Brain DNA** · 🗳️ **Hive Voice** · ⏰ **Time Capsule** · 🔬 **Brain Diff**
+>
+> **The 14 advanced features** — Spotify-Wrapped-meets-AI-codebase:
+> 🎵 **Brain Cinema** (auto 60s SVG-animated video of brain growth) · 🎼 **Brain Sonification** (your codebase as music) · 🏆 **Brain Trophies** (25 achievements + share cards) · 🎁 **Brain Holiday Card** (year-in-review) · 🧭 **Brain Coach** (proactive idle suggestions) · 🗺️ **Brain Quest** (gamified onboarding adventures) · 📓 **Brain Notebook** (Jupyter-style brain explorer) · ⚡ **Brain Reflex** (local-model inline completion) · 🔥 **Brain Roast** (comedy code reviews, 6 personas) · 🔮 **Brain Tarot** (78-card divination from git+brain) · 🎨 **Brain ASCII** (terminal art representations) · 😂 **Brain Memes** (auto-generated dev memes) · 🌌 **Brain 3D** (Three.js rotatable graph viewer) · 💞 **Brain Doppelganger** (find your codebase's twin)
+>
+> **The infrastructure** — real ANN HNSW index · Constitution layer · Confidence Gate · multimodal vision (llava) · LoRA distillation pipeline · SWE-Bench-Lite eval harness · OpenTelemetry-lite tracing · git-trackable Markdown brain export/import.
+>
+> [Full release notes →](docs/launch/RELEASE_NOTES_v6.0.2.md)
+
 ```bash
 # 30 seconds. Every agent + sub-agent on your machine becomes smarter.
 npx @theihtisham/agent-shadow-brain@latest attach-all
+
+# Or — the 30-second wow tour
+npx @theihtisham/agent-shadow-brain@latest demo
 ```
 
 **[🎬 Video](https://github.com/theihtisham/agent-shadow-brain/raw/main/docs/launch/shadow-brain-motion-explainer-narrated.mp4) · [📦 npm](https://www.npmjs.com/package/@theihtisham/agent-shadow-brain) · [⭐ Star on GitHub](https://github.com/theihtisham/agent-shadow-brain) · [📚 Docs](https://github.com/theihtisham/agent-shadow-brain/tree/main/docs) · [🐛 Issues](https://github.com/theihtisham/agent-shadow-brain/issues)**
@@ -58,6 +88,76 @@ npx @theihtisham/agent-shadow-brain attach-all
 
 ---
 
+## 🆕 What's New in v6.0.2 — "Singularity"
+
+> **35 new modules + 27 new CLI commands + 7 sample artifacts. Zero new npm deps. tsc-clean.**
+
+### 🌟 The 5 World-First Viral Features
+
+Every one of these renders as a tweet-ready PNG/SVG. *Cursor doesn't have these. Cline doesn't have these. Nobody has these.*
+
+| | Feature | What it does |
+|---|---|---|
+| 🎬 | **[Brain Replay](docs/launch/v6.0.2-samples/brain-replay-sample.svg)** | Scrubbable timeline of every brain event since day-zero. Drag the cursor, rewind to any moment. SVG export. |
+| 🧬 | **[Brain DNA](docs/launch/v6.0.2-samples/brain-dna-sample.svg)** | Spotify-Wrapped-style fingerprint card. 8 personality archetypes (The Architect, The Debugger, …). 1080×1080 share card. |
+| 🗳️ | **Hive Voice** | 3 local models debate-vote on every architecture question. See consensus, dissent, and confidence — live. SVG bar chart. |
+| ⏰ | **Brain Time Capsule** | Freeze + label + resurrect brain snapshots. "Here's what we knew about React in January." Ed25519-signed bundles. |
+| 🔬 | **Brain Diff** | Semantic diff between two brains. Venn-diagram SVG + English narrative. "What did Team A learn that Team B didn't?" |
+
+```bash
+shadow-brain dna card --out my-brain.svg                    # 🧬 generate your DNA card
+shadow-brain replay export --format svg --out timeline.svg  # 🎬 scrubbable timeline
+shadow-brain hive-voice ask "Server Components by default?" # 🗳️ multi-model vote
+shadow-brain capsule freeze --label "pre-redesign"          # ⏰ freeze a snapshot
+shadow-brain brain-diff compare brain-a/ brain-b/           # 🔬 semantic diff
+```
+
+### 🎁 14 More Advanced Features
+
+| | | | |
+|---|---|---|---|
+| 🎵 **Brain Cinema** — auto-procedural 60-sec SVG video | 🎼 **Brain Sonification** — your codebase as music (WAV) | 🏆 **Brain Trophies** — 25 achievements w/ share cards | 🎁 **Brain Holiday Card** — year-in-review SVG |
+| 🧭 **Brain Coach** — 10 proactive idle-suggestion rules | 🗺️ **Brain Quest** — 5 gamified onboarding adventures | 📓 **Brain Notebook** — Jupyter-style brain explorer | ⚡ **Brain Reflex** — local-model inline completion |
+| 🔥 **Brain Roast** — comedy code review (6 personas) | 🔮 **Brain Tarot** — 78-card divination from git+brain | 🎨 **Brain ASCII** — terminal-art brain (6 styles) | 😂 **Brain Memes** — auto-generated dev memes (10 templates) |
+| 🌌 **Brain 3D** — rotatable Three.js graph viewer | 💞 **Brain Doppelganger** — find your codebase's twin | | |
+
+### 🧠 10 Brain-Quality Upgrades (the engineering wins)
+
+| Recall quality | Memory arch | Efficiency | Intelligence | Size + Learning |
+|---|---|---|---|---|
+| **Rerank** (BM25 + cosine hybrid) | **Memory Tiers** (episodic/semantic) | **Working Memory** (LRU + predictive prefetch) | **Contradictions** (46 polarity pairs) | **Quantize** (int8 vectors, 4× smaller, 0.000298 mean error) |
+| **Query Expander** (synonyms + abbrev + HyDE) | **Consolidator** (dedup + abstractions) | **Recall Cache** (bloom filter, 65k bits, ~4% FP @ 10k keys) | **Graph Walker** (5 edge types, 3-hop BFS) | **Active Learner** (accept/reject feedback bias) |
+
+### ⚙️ Production Infrastructure
+
+- **Real ANN vector index** (`embeddings-v2.ts`) — HNSW-style graph, M=8, sub-100ms recall over 10k vectors, sharded persistence (5MB cap), auto-pulls `nomic-embed-text` from Ollama on first run
+- **Constitution layer** — `<project>/.shadow-brain/constitution.md` parser + hot-reload + injection
+- **Confidence Gate** — active output filter, Brier score + ECE stats
+- **Multimodal vision** — Ollama llava / llava-llama3 / bakllava ingestion
+- **Markdown brain export/import** — git-trackable `.shadow-brain.md` round-trip
+- **OpenTelemetry-lite tracing** — OTel-compatible JSONL, daily rotation
+- **LoRA distillation pipeline** (`tools/lora-pipeline/`) — turn your brain into a Qwen2.5-Coder-1.5B adapter
+- **SWE-Bench-Lite harness** (`tools/swe-bench-lite/`) — 10 curated bugs, brain-on vs brain-off, statistical scoring
+- **30-second demo**: `npx @theihtisham/agent-shadow-brain demo`
+
+### 📊 v6.0.2 by the numbers
+
+| | |
+|---|---|
+| New brain modules | **35** (25 features + 10 quality stack) |
+| New CLI command groups | **27** |
+| New LOC | **~16,000** (TypeScript) |
+| New npm dependencies | **0** |
+| Sample artifacts shipped | **7** (DNA card, Replay timeline, Cinema, Holiday wrapped, Tarot, Trophy wall, 3D viewer HTML) |
+| Quantization roundtrip error | **0.000298** (16× better than spec) |
+| TypeScript errors | **0** |
+
+**Full release notes:** [docs/launch/RELEASE_NOTES_v6.0.2.md](docs/launch/RELEASE_NOTES_v6.0.2.md)
+**Strategic roadmap (v7+):** [docs/ROADMAP-v7.md](docs/ROADMAP-v7.md)
+**Launch playbook:** [docs/VIRAL-PLAYBOOK.md](docs/VIRAL-PLAYBOOK.md)
+
+---
+
 ## 🔥 Why Shadow Brain? (the 60-second pitch)
 
 | Without Shadow Brain | With Shadow Brain v6 |

package/dist/brain/brain-3d.d.ts

@@ -0,0 +1,79 @@
+import { GlobalBrain } from './global-brain.js';
+import { BrainReplay } from './brain-replay.js';
+export type LayoutKind = 'force-directed' | 'sphere' | 'helix' | 'galaxy';
+export interface SceneNode {
+    id: string;
+    label: string;
+    group: string;
+    position: [number, number, number];
+    size: number;
+    color: string;
+    importance: number;
+    metadata: Record<string, unknown>;
+}
+export interface SceneEdge {
+    source: string;
+    target: string;
+    weight: number;
+    kind: 'similarity' | 'causal' | 'temporal' | 'agent-handoff';
+}
+export interface CameraSpec {
+    position: [number, number, number];
+    lookAt: [number, number, number];
+    fov: number;
+    near: number;
+    far: number;
+}
+export interface LightSpec {
+    type: 'ambient' | 'directional' | 'point';
+    color: string;
+    intensity: number;
+    position?: [number, number, number];
+}
+export interface ThemeSpec {
+    background: string;
+    backgroundGradient: [string, string];
+    primary: string;
+    secondary: string;
+    accent: string;
+    edgeColor: string;
+}
+export interface SceneData {
+    version: '1.0';
+    generatedAt: string;
+    layout: LayoutKind;
+    nodes: SceneNode[];
+    edges: SceneEdge[];
+    camera: CameraSpec;
+    lights: LightSpec[];
+    theme: ThemeSpec;
+    meta: {
+        project: string;
+        nodeCount: number;
+        edgeCount: number;
+        empty: boolean;
+    };
+}
+export declare class Brain3d {
+    private brain;
+    private replay;
+    constructor(brain?: GlobalBrain, replay?: BrainReplay);
+    /** Build a scene-data object ready for any Three.js renderer. */
+    exportScene(project: string, opts?: {
+        layout?: LayoutKind;
+        nodeLimit?: number;
+    }): Promise<SceneData>;
+    /** Self-contained HTML viewer — open in any browser and the brain rotates. */
+    htmlViewer(scene: SceneData): string;
+    /** Minimal glTF JSON. Embeds node positions inline; no binary buffers. */
+    glTfExport(scene: SceneData): string;
+    private emptyScene;
+    private safeInit;
+    private resolveProjectId;
+    private buildNodes;
+    private buildEdges;
+    private applyLayout;
+}
+export declare function getBrain3d(): Brain3d;
+export declare function resetBrain3dForTests(): void;
+//# sourceMappingURL=brain-3d.d.ts.map

package/dist/brain/brain-3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-3d.d.ts","sourceRoot":"","sources":["../../src/brain/brain-3d.ts"],"names":[],"mappings":"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"}