37 Commits

Author SHA1 Message Date
root
2069949a8d Add comprehensive upgrade instructions
- Added 'Upgrading from Older Versions' section with full step-by-step
- Added version history table (v1.0 - v1.4)
- Added upgrade paths for curl download and git pull
- Added backfill instructions and verification steps
- Added upgrade section to install.sh
- Added backfill_memory.py script
2026-03-04 14:59:37 -06:00
root
caebfb4b25 docs: add v1.2 patching/update instructions to README 2026-03-04 14:59:37 -06:00
root
1bb4b1daaa feat: update watcher with priority-based session file detection 2026-03-04 14:59:37 -06:00
root
87aab95ba8 feat: improve search_q.sh output
- Add result count to summary
- Increase content preview to 250 chars
- Add user_id to result display
- Improve 'no results' messaging
- Better result counting with tee
2026-03-04 14:59:37 -06:00
root
8bf10326db feat: add search_q.sh script with chronological sorting
- Search memories by keyword/phrase
- Automatically sorts results by timestamp (newest first)
- Shows formatted output with date, role, and content
- Supports environment variables for configuration
- Limits results to avoid information overload
- Handles errors gracefully
2026-03-04 14:59:37 -06:00
root
4e1d432b02 docs: add detailed installer documentation
- Explain each step the installer performs
- Show example prompts and outputs
- Document configuration values
- List post-installation verification commands
- Include installer requirements
2026-03-04 14:59:37 -06:00
root
402c03f647 fix: accept full host:port in install script
- Change defaults to include port (localhost:6333, localhost:11434)
- Show full host:port examples with actual IPs
- Use entered value directly without appending port
- Fixes duplicate port issue if user enters full format
2026-03-04 14:59:37 -06:00
root
eb9bddab69 docs: add IP examples and port info to install prompts
- Show example IPs: localhost, 10.0.0.40, 192.168.1.10
- Clarify default ports (6333 for Qdrant, 11434 for Ollama)
- Help users understand expected input format
2026-03-04 14:59:37 -06:00
root
f238812ce1 fix: handle paths with spaces in install script
- Add INSTALL_DIR variable with absolute path resolution
- Handles spaces in directory names correctly
- Uses cd/pwd trick for robust path detection
2026-03-04 14:59:37 -06:00
root
ead210b565 docs: update Quick Start with install script option
- Add Option 1: Quick Install using install.sh
- Add Option 2: Manual Install (original)
- Update verification section
- Make install script the recommended path
2026-03-04 14:59:37 -06:00
root
a194702a8a feat: add simple install script
- Interactive configuration with defaults
- Defaults to localhost for Qdrant and Ollama
- Allows custom values for all settings
- Creates systemd service with user-provided config
- Auto-starts the watcher
2026-03-04 14:59:37 -06:00
root
cdcfe2f51a docs: add requirements section
- Document vector database requirement
- Explain local vs cloud options
- Clarify IP accessibility needed
- List additional requirements (Ollama, OpenClaw, systemd)
2026-03-04 14:59:37 -06:00
root
b954064502 chore: remove development files (audit checklist and validation report) 2026-03-04 14:59:37 -06:00
root
ba4a5fd63d docs: remove v1 from title 2026-03-04 14:59:37 -06:00
root
29a1ade004 docs: add Base is Complete section
- Emphasize that Base is fully functional standalone
- Clarify upgrade is optional
- List what Base provides without addons
- Reduce pressure to upgrade
2026-03-04 14:59:37 -06:00
root
2f2d93ce7f docs: add final validation report
- 2-pass comprehensive validation
- 100% accuracy confirmed
- All systems operational
- Ready for production
2026-03-04 14:59:37 -06:00
root
62251f5566 docs: add memory usage and q command instructions
- Add Using Memories with OpenClaw section
- Document the 'q' command and its meaning
- Include context injection instructions for system prompts
- Add search priority table
- Explain when to search q vs other sources
- Include right/wrong response examples
2026-03-04 14:59:37 -06:00
root
501872d46e docs: add comprehensive How It Works section
- Add architecture diagram
- Detail step-by-step process (5 steps)
- Include code snippets for each phase
- Document session rotation handling
- Add error handling documentation
- Include collection schema details
- Document security notes
- Add performance metrics table
2026-03-04 14:59:37 -06:00
root
6a32cedb5a docs: update README with upgrade paths and coming soon notices
- Remove duplicate Base does NOT include section
- Add detailed upgrade paths for Gems and Blocks
- Add Coming Soon status indicators
- Include workflow diagrams for both addons
- Explain use cases for each upgrade option
2026-03-04 14:59:37 -06:00
root
04953bc38b Update README: Add v1 to title for clarity 2026-03-04 14:59:37 -06:00
root
d943b9d87e docs: sanitize IP addresses in README
- Replace hardcoded IPs with placeholders
- QDRANT_URL: 10.0.0.40 → <QDRANT_IP>
- OLLAMA_URL: 10.0.0.10 → <OLLAMA_IP>
- USER_ID: rob → <USER_ID>
- Update verification example command
2026-03-04 14:59:37 -06:00
root
808c021d15 docs: replace v2 references with Gems/Blocks addons
- Remove v2 from README Next Step section
- Add addon comparison table (Gems vs Blocks)
- Update prerequisite mention
- Update Python docstring to reference addons
2026-03-04 14:59:37 -06:00
root
5ea614b212 refactor: rename v1 references to base
- Remove v1 versioning from project name
- Update all references: TrueRecall v1 → TrueRecall Base
- Update paths: true-recall-v1 → true-recall-base
- Clean up README (remove version number)
- Update config description
- Update service file description and paths
2026-03-04 14:59:37 -06:00
root
e1962887a5 chore: add .gitignore for Python and session files 2026-03-04 14:59:37 -06:00
root
d88ff6cea3 feat: initial TrueRecall Base v1.0
Core components:
- Real-time memory capture daemon
- Qdrant memories_tr collection storage
- Systemd service for auto-start
- Configuration templates with placeholders

Features:
- Full conversation context capture
- Deduplication via content hashing
- User-tagged memories
- Compatible with Gems and Blocks addons
2026-03-04 14:59:37 -06:00
root
c780a24847 Fix Qdrant upsert: add required ids field
- Fixed missing 'ids' field in POST body causing 400 errors
- Backfilled 23 memory files (Feb 4 - Mar 1, 2026)
- Validation: ~20K+ total points, date coverage complete

Resolves Gitea issue #8
2026-03-04 14:37:08 -06:00
root
5c2014cb11 Fix: Proper session rotation detection (v1.2)
Fixes the bug where watcher stayed stuck on old sessions after /new or /reset.

Changes:
- Added file_score() function combining mtime + size for better detection
- Added INACTIVITY_THRESHOLD (30s) - if no new data, check for active session
- Tracks last_data_time and file size to detect stale sessions
- Switches to newer session when current is inactive

The previous v1.1 fix (mtime polling) was incomplete because new sessions
can have older mtime than recently-written old sessions.

Tested: Watcher now properly follows session rotation on /new and /reset
2026-02-28 19:09:38 -06:00
root
a053ec1c3d fix: SESSIONS_DIR env var and config dimension docs
- SESSIONS_DIR now reads from OPENCLAW_SESSIONS_DIR env var with fallback
- Fixes hardcoded path issue reported by community
- config.json: add embedding_dimensions (1024) and notes field
- Update version to 1.1 in config.json

Validated 4x:
1. SESSIONS_DIR line correct
2. config.json syntax valid
3. Both files syntax OK
4. Env var logic tested

Thanks to Rob Whyte @ Fort Myers Brewing for the suggestion.
2026-02-28 17:05:43 -06:00
root
1c24618ad9 docs: Add Gotchas section - embedding dimensions and hardcoded paths
- Document that snowflake-arctic-embed2 outputs 1024 dimensions (not 768)
- Document SESSIONS_DIR hardcoded path and how to patch with env var
- Add Known Limitations section near File Watching docs
- Fixes community feedback from GitLab issue #1

Thanks to Rob Whyte @ Fort Myers Brewing for identifying these issues.
2026-02-28 17:01:06 -06:00
root
70f5aec465 Fix: Add session rotation detection (v1.1)
- Add 1-second mtime polling to detect newer sessions
- Fixes bug where watcher stayed stuck on first session forever
- Prevents data loss when sessions rotate (was losing 2+ days of history)
- Bump version to v1.1
2026-02-28 16:51:31 -06:00
root
97a95bd3af docs: add validation rule - always validate after changes 2026-02-14 07:23:26 -06:00
root
9769839a67 docs: add counter reset root cause - removed old update_count.sh 2026-02-14 07:23:18 -06:00
root
59225f0d1b docs: add note - website complements YouTube channel 2026-02-14 07:21:21 -06:00
root
a8299b6db7 docs: add Feb 14 - SpeedyFoxAI website details, counter fix, nginx path discovery 2026-02-14 07:20:53 -06:00
root
648aa7f016 docs: add git repository section to daily log 2026-02-10 14:40:48 -06:00
root
98d14be03b docs: update MEMORY.md with git setup and sub-agent configuration 2026-02-10 14:40:31 -06:00
root
d1357c5463 Initial commit: workspace setup with skills, memory, config 2026-02-10 14:37:49 -06:00