docs: replace Project Memory placeholder with real content; refresh indexes

Author: Michael

workspace/docs/Obsidian/docs/Soulfield-OS—Project-Memory.md

@@ -6,8 +6,99 @@ labels: [aiden, memory, context-spine, pipeline, lens]
 
 # Soulfield OS — Project Memory
 
-(placeholder) Project memory content to be added here.
+This document tracks the evolution of **Soulfield OS** and its assistant (Aiden), with structured notes for future planning and Obsidian use.
 
+---
+
+## ✅ Progress So Far
+
+### Lens System
+- Started with **TruthLens** only.
+- Expanded into **stacked lenses** (Truth, Causality, Extrapolation, Contradiction, Rights, Structure).
+- Built YAML **pipeline templates** for Research, Strategy, Execution, Analytics.
+- Defined **Lens Trail certificates** for auditability.
+
+### Orchestration & CLI
+- Added **`sf` commands** (research, specify, index, apply, inspect).
+- New **context commands**:
+  - `sf context:test` → one-off heartbeat + calendar sync.
+  - `sf context:query` → semantic/tag mode queries.
+  - `sf context:backfill` → embed raw heartbeats.
+- CLI doc updates + quick reference guide.
+
+### Context Spine
+- **Heartbeat (15m)** → stores time markers in Pinecone.
+- **Calendar (hourly)** → Google Calendar sync (with OAuth2 refresh token).
+- **Retention** → prunes old heartbeats/events beyond `CONTEXT_RETENTION_DAYS`.
+- **Observability** → counters + logs for embeddings, events, Pinecone ops.
+
+### Embeddings & Memory
+- Local embeddings via `@xenova/transformers` (MiniLM-L6-v2, 384-dim).
+- Optional OpenAI fallback (disabled due to quota issues).
+- Pinecone adapter supports `embedAndUpsert` and `upsertRaw`.
+- Confirmed heartbeat + calendar items queryable.
+
+### Development Flow
+- Repo under **GitLens control** (feature branch: `feat/context-spine-embeddings`).
+- Direct push to main blocked (PRs required).
+- Codex assists with Git (merge/rebase/PR creation).
+
+### Example Funnel Run
+- Query: *“Should we launch a subscription SaaS product for SMEs in the EU next quarter?”*
+- Output: full funnel with TruthLens, CausalityLens, ContradictionLens, ExtrapolationLens, RightsLens, StructureLens.
+- Consensus: **delay full rollout → pilot in one market first**.
+
+### Policy & Guardrails
+- Drafted **hallucination mitigation policy** (mark unknowns, block simulation).
+- **Non-simulation contract** = no fake identities, no “oracle” mode.
+
+---
+
+## 🔍 Open Questions
+1. **MCP Migration**
+   - Adopt MCP architecture early or keep current orchestrator?
+   - Personal use: CLI MCP agent for time management + business funnels.
+
+2. **Memory Ingestion Strategy**
+   - How should Aiden receive files (code, docs, ideas, strategies)?
+   - Balance between `.md` (Obsidian) and `.json` (structured Pinecone).
+
+3. **UI/UX Layer**
+   - Visual frontend for `sf` commands + funnel outputs.
+   - Integration with Obsidian for knowledge navigation.
+
+4. **Finance Agent**
+   - Separate agent for trading (stocks, futures, crypto).
+   - Needs **ReasoningLens** to separate gambling impulses from strategy.
+   - Enforce strict risk parameters (e.g., 1:2 risk/reward).
+
+---
+
+## 🚀 Next Steps
+
+### Technical
+- [ ] PR: Merge `feat/context-spine-embeddings` into main.
+- [ ] Add **ReasoningLens** (risk analysis, cost/benefit).
+- [ ] Expand `sf context:query` to support **calendar planning**.
+- [ ] Explore MCP planning doc for future migration.
+
+### Workflow
+- [ ] Plan **Obsidian ↔ Aiden** connection for `.md` + `.json` sync.
+- [ ] Document **memory ingestion flow** (manual file upload vs. auto indexing).
+- [ ] Draft **finance agent spec** (inputs, lenses, constraints).
+
+### Personal
+- [ ] Use calendar blocks for time management between projects.
+- [ ] Test Aiden with daily task planning (via heartbeats + calendar).
+- [ ] Evaluate trading strategies to feed into finance agent later.
+
+---
+
+## 📌 One-Liner
+Soulfield OS = **orchestration hub**.  
+Lenses = **filters of trust + reasoning**.  
+Aiden = **memory + execution assistant**.  
+Together → *reliable, structured AI for business and beyond*.
 
 ## 🔗 Cross-links
 - [[../docs/Soulfield-OS—Project-Memory.md]]