personal memory agent
Add make dev target for worktree development against fixtures
- Add *.port to .gitignore (health/convey.port runtime artifact)
- Add make dev Makefile target: starts supervisor with fixture journal,
no observers, no daily processing, PATH set for worktree venv
- Add Worktree Development section to AGENTS.md Quick Reference
- Commit maint migration state to fixtures (prevents regeneration)
+43
-1
+1
.gitignore
+1
.gitignore
+21
AGENTS.md
+21
AGENTS.md
···
225
225
make clean-install # Clean and reinstall
226
226
```
227
227
228
+
### Worktree Development
229
+
230
+
Run the full stack (supervisor + callosum + sense + cortex + convey) against test fixture data:
231
+
232
+
```bash
233
+
make dev # Start stack (Ctrl+C to stop)
234
+
```
235
+
236
+
In a second terminal, take screenshots or hit endpoints:
237
+
```bash
238
+
export JOURNAL_PATH=tests/fixtures/journal
239
+
export PATH=$(pwd)/.venv/bin:$PATH
240
+
sol screenshot / -o scratch/home.png
241
+
curl -s http://localhost:$(cat tests/fixtures/journal/health/convey.port)/
242
+
```
243
+
244
+
Notes:
245
+
* Agents won't execute without API keys — this is expected in worktrees
246
+
* Output artifacts go in `scratch/` (git-ignored)
247
+
* Service logs: `tests/fixtures/journal/health/<service>.log`
248
+
228
249
### File Locations
229
250
* **Entry Points**: `sol.py` `COMMANDS` dict
230
251
* **Test Fixtures**: `tests/fixtures/journal/` - complete mock journal
+5
-1
Makefile
+5
-1
Makefile
···
1
1
# solstone Makefile
2
2
# Python-based AI-driven desktop journaling toolkit
3
3
4
-
.PHONY: install uninstall test test-apps test-app test-only test-integration test-integration-only test-all format ci clean clean-install coverage watch versions update update-prices pre-commit skills all
4
+
.PHONY: install uninstall test test-apps test-app test-only test-integration test-integration-only test-all format ci clean clean-install coverage watch versions update update-prices pre-commit skills dev all
5
5
6
6
# Default target - install package in editable mode
7
7
all: install
···
96
96
if [ "$$count" -gt 0 ]; then \
97
97
echo "Linked $$count skill(s) into $(SKILL_DIRS)"; \
98
98
fi
99
+
100
+
# Start local dev stack against fixture journal (no observers, no daily processing)
101
+
dev: .installed
102
+
$(TEST_ENV) PATH=$(CURDIR)/$(VENV_BIN):$$PATH $(VENV_BIN)/sol supervisor 0 --no-observers --no-daily
99
103
100
104
# Test environment - use fixtures journal for all tests
101
105
TEST_ENV = JOURNAL_PATH=tests/fixtures/journal
+10
tests/fixtures/journal/maint/agents/001_migrate_agent_run_logs.jsonl
+10
tests/fixtures/journal/maint/agents/001_migrate_agent_run_logs.jsonl
···
1
+
{"event": "exec", "ts": 1770952499902, "app": "agents", "task": "001_migrate_agent_run_logs", "cmd": ["/home/jer/.local/share/hopper/lodes/vymuqdvr/worktree/.venv/bin/python", "-m", "apps.agents.maint.001_migrate_agent_run_logs"]}
2
+
{"event": "line", "ts": 1770952500054, "line": "Migrating agent run logs in: tests/fixtures/journal/agents"}
3
+
{"event": "line", "ts": 1770952500054, "line": "Migration complete"}
4
+
{"event": "line", "ts": 1770952500054, "line": " moved: 0"}
5
+
{"event": "line", "ts": 1770952500054, "line": " symlinks_removed: 0"}
6
+
{"event": "line", "ts": 1770952500054, "line": " symlinks_created: 0"}
7
+
{"event": "line", "ts": 1770952500054, "line": " day_index_entries:0"}
8
+
{"event": "line", "ts": 1770952500054, "line": " skipped: 0"}
9
+
{"event": "line", "ts": 1770952500054, "line": " errors: 0"}
10
+
{"event": "exit", "ts": 1770952500087, "exit_code": 0, "duration_ms": 184}
+3
tests/fixtures/journal/maint/search/003_migrate_index_stream.jsonl
+3
tests/fixtures/journal/maint/search/003_migrate_index_stream.jsonl
···
1
+
{"event": "exec", "ts": 1770952500274, "app": "search", "task": "003_migrate_index_stream", "cmd": ["/home/jer/.local/share/hopper/lodes/vymuqdvr/worktree/.venv/bin/python", "-m", "apps.search.maint.003_migrate_index_stream"]}
2
+
{"event": "line", "ts": 1770952500394, "line": "No existing index found, nothing to migrate"}
3
+
{"event": "exit", "ts": 1770952500420, "exit_code": 0, "duration_ms": 146}
+3
tests/fixtures/journal/maint/settings/002_restructure_stream_dirs.jsonl
+3
tests/fixtures/journal/maint/settings/002_restructure_stream_dirs.jsonl
···
1
+
{"event": "exec", "ts": 1770952500087, "app": "settings", "task": "002_restructure_stream_dirs", "cmd": ["/home/jer/.local/share/hopper/lodes/vymuqdvr/worktree/.venv/bin/python", "-m", "apps.settings.maint.002_restructure_stream_dirs"]}
2
+
{"event": "line", "ts": 1770952500247, "line": "Journal already uses stream directory layout. Nothing to do."}
3
+
{"event": "exit", "ts": 1770952500274, "exit_code": 0, "duration_ms": 187}