[LoveS0ph1e]

Summary

This PR adds a memory plugin for Google Antigravity, implementing the EverOS v2 backend protocol (/api/v2/memory/*).

Developed under Project ArtEmis (LoveS0ph1e/ArtEmis), it provides persistent, cross-session memory with zero external dependencies and fail-open resilience.

---

Architectural Highlights

• Pure ESM & Zero-Dependency: Built strictly with Node.js >=20.0.0 native standard libraries (node:fs, node:child_process, node:readline, native fetch and crypto). Zero external npm runtime dependencies.
• Three-Tier Progressive Disclosure:
  • L1 Persistent Profile (<everos_profile>): Frozen covenants & tacit preferences injected at SessionStart (99% KV Prompt Cache hit rate).
  • L2 Ephemeral Memory (<everos_memory>): Highly relevant cases and interaction history dynamically injected at PreInvocation (read-once, 0 context tax).
  • L3 On-Demand MCP Exploration: Dedicated Model Context Protocol server exposing everos_search_memory, everos_get_profile, and everos_add_memory.
• Two-Phase Commit (2PC) State Machine: Observation and settlement indices are decoupled. Includes client-side acked_chunks tracking for incremental retry without memory duplication.
• Windows 11 Resilient:
  • Natural Drain Protocol: Strictly enforces process.exitCode = 0 over process.exit(0) to prevent premature stdout pipe truncation.
  • Detached Async Dispatch: Background sweep workers reduce SessionStart execution from >15s down to ~300ms, eliminating host hard-timeout kills.
• Fair Dual-Track Search: Interleaved polling between project-level facts and user-level preferences prevents starvation.
• Code Generic & JSX Protection: Precise regex matching preserves TypeScript generics (Array<T>) and JSX tags in user transcripts.

---

Verification & Testing

• Manifest Security Gates: 16/16 PASS via scripts/check-manifests.mjs (enforcing zero runtime dependencies and path leakage defense).
• Unit & Integration Suite: 120/120 PASS (0 FAIL) with --test-concurrency=1 avoiding NTFS lock flaky issues.
• Live Verification: Simulated full Antigravity lifecycle (SessionStart -> PreInvocation -> Stop -> 2PC Flush -> MCP stdio handshake).

---

Maintenance & Upstream Sync

• Original upstream/standalone repository: https://github.com/LoveS0ph1e/ArtEmis
• License: Apache-2.0