levh 2.26.8__tar.gz

levh-2.26.8/.env.example

@@ -0,0 +1,91 @@
+# ── StackMemory Environment Variables ──
+# Environment values override .stackmemory/config.json. This file is a
+# template only; StackMemory does not load .env automatically. Export the
+# variables in the process that starts the CLI/API/MCP server.
+
+
+# SQLite
+SQLITE_DB_PATH=./stackmemory.db
+# File databases use WAL and a lock wait; tune only for unusual deployments.
+# STACKMEMORY_SQLITE_BUSY_TIMEOUT_MS=5000
+# Replace-mode restore writes an online SQLite safety copy here. Default:
+# a safety-backups/ directory beside SQLITE_DB_PATH.
+# STACKMEMORY_SAFETY_BACKUP_DIR=./safety-backups
+
+# Embedding mode: "auto" (local-first; never selects OpenAI from an ambient
+# key), "local", "openai", "ollama" (fully local via an Ollama server), or
+# "hash" (offline fallback). Use openai explicitly for remote embeddings.
+EMBEDDER_MODE=local
+# OPENAI_API_KEY=sk-...
+
+# Local model name (for sentence-transformers)
+LOCAL_MODEL=all-MiniLM-L6-v2
+
+# Ollama (EMBEDDER_MODE=ollama)
+OLLAMA_URL=http://localhost:11434
+OLLAMA_MODEL=nomic-embed-text
+
+# Short-term memory max entries
+SHORT_TERM_MAX=50
+
+# Default decay half-life in hours (each memory starts here, then grows
+# its OWN half-life every time it's recalled or reinforced)
+DECAY_HALF_LIFE_HOURS=168
+
+# H(x,ψ) Weights
+HSCORE_ALPHA=0.4
+HSCORE_BETA=0.2
+HSCORE_GAMMA=0.3
+HSCORE_DELTA=0.1
+
+# Reinforcement (spaced-repetition style memory strengthening)
+# Each recall multiplies a memory's stability by (1 + gain*(0.5+importance)).
+REINFORCEMENT_GAIN=0.5
+# Cap on how durable a memory can become (hours). Default: 1 year.
+MAX_STABILITY_HOURS=8760
+# Negative feedback (memory_feedback helpful=false) multiplies stability by this.
+FEEDBACK_WEAKEN_FACTOR=0.5
+
+# Auto-capture: summarize a session's memories into one durable memory when the
+# session ends. Uses an LLM if OPENAI_API_KEY is set, else a deterministic
+# offline (extractive) summary. Off by default.
+# AUTO_SUMMARIZE_SESSIONS=false
+# SUMMARY_MODEL=gpt-4o-mini
+
+# Retroactive interference: a new memory this similar to an older one weakens it.
+# 0.97 is safe in every embedder mode (fires only on near-duplicates);
+# with a semantic embedder (local/openai/ollama), 0.88-0.92 also catches
+# contradictions ("deploy branch is main" vs "deploy branch is prod").
+# Set to 1.0 to disable.
+INTERFERENCE_THRESHOLD=0.97
+INTERFERENCE_FACTOR=0.6
+
+# API
+API_HOST=127.0.0.1
+API_PORT=8000
+
+# Optional shared-secret gate. When set, every /api/* request (except
+# /api/health) and the WebSocket must present it via the X-StackMemory-Token
+# header (or ?token= for the socket). Unset = zero-config, local use only.
+# STACKMEMORY_TOKEN=change-me
+# In-process limits apply only when STACKMEMORY_TOKEN is enabled. They slow
+# brute-force attempts on one process; use a reverse proxy for distributed
+# deployments.
+# STACKMEMORY_AUTH_RATE_LIMIT=10
+# STACKMEMORY_API_RATE_LIMIT=120
+# STACKMEMORY_RATE_LIMIT_WINDOW_SECONDS=60
+
+# Allowed CORS origins (comma-separated). Defaults to localhost only so a
+# random website can't read your local memory store from the browser.
+# Set to "*" to allow any origin (not recommended for a local tool).
+# STACKMEMORY_CORS_ORIGINS=http://localhost:3000,http://127.0.0.1:3000,http://localhost:8000,http://127.0.0.1:8000
+
+# Optional local dogfood metrics. Disabled by default. When enabled, only
+# whitelisted aggregate events are appended locally; raw memory/query content
+# is rejected and nothing is sent over the network. Processes must be restarted
+# after changing the flag.
+# STACKMEMORY_DOGFOOD_ENABLED=false
+# DOGFOOD_JOURNAL_PATH=./dogfood_events.jsonl
+
+# Optional privacy-safe local onboarding receipt path.
+# STACKMEMORY_ONBOARDING_RECEIPT_PATH=.stackmemory/onboarding-receipt.json