xonecas.io
60255
Zn

Zoea-Nova / commit 412d69d

chore: update docs and ignore db backup

Align documentation references to current backup handling and provider config notes while ignoring the db reset export file.

xonecas2026-02-04 412d69de2dd487107186d32c24ce78c74a28f2a1 parent e6b9436

5 files changed

.gitignore+2−0
@@ -18,3 +18,5 @@ Thumbs.db
1818
1919 # Local data (user-specific)
2020 # Note: $HOME/.zoea-nova/ is outside repo, no need to ignore
21+
22+accounts-backup.sql
AGENTS.md+1−1
@@ -60,7 +60,7 @@ The application uses SQLite for persistence.
6060
6161 - **Location**: `~/.zoea-nova/zoea.db`
6262 - **Querying**: Use `sqlite3 ~/.zoea-nova/zoea.db` to run manual queries.
63-- **Wiping**: To reset state or apply schema changes (no migrations), run `make db-reset-accounts` to export usernames/passwords to `accounts-backup.sql`, wipe the DB, recreate schema, and reimport accounts.
63+- **Wiping**: To reset state or apply schema changes (no migrations), run `make db-reset-accounts` to export usernames/passwords to `accounts-backup.sql`, wipe the DB, recreate schema, and reimport accounts. The backup file is created at repo root and is ignored by git.
6464 - **Testing**: Tests use `t.TempDir()` for isolated database files. Never use the production database path in tests.
6565
6666 ## Terminology:
documentation/KNOWN_ISSUES.md+15−4
@@ -2,19 +2,26 @@
22
33 These are the currently known issues to investigate:
44
5-## Authentication & Account Management
6-
7-- [ ] Related: Myses find each other's passwords and fail to login. Myses do not have a reliable way to re-use usernames they created in the past.
8-
95 ## Context & Memory Management
106
117 - [ ] Myses should know to prefer more recent information in their context. We should improve our context messages list to compact repeated state updates into the most recent state snapshot. We should also re-enforce the use of search tools to access older memory. Maybe increase the tool loop for longer autonomy.
128 - [ ] Evidence: Sliding-window context uses MaxContextMessages=20 with no compaction of repeated state snapshots.
9+- [ ] zoea exclusive fields in tool payload is unecessary bloat (the ollama model here.):
10+ > ````│ │ TOOL: call_42829tff:[ │ │
11+ > │ │ { │ │
12+ > │ │ "id": "22c38707-f6a9-4643-8bc4-27b47fe31cbd", │ │
13+ > │ │ "name": "test", │ │
14+ > │ │ "provider": "ollama", │ │
15+ > │ │ "state": "running" │ │
16+ > │ │ } │ │
17+ > │ │ ]```
18+ > ````
1319
1420 ## Prompt & Behavior
1521
1622 - [ ] Mysis prompt review: Encourage myses to collaborate together via zoea tooling to create a goal and collaborate towards it. Encourage to pick a Crustacean Cosmos + Zoea/Mysis themed username. Critical rules must be in every prompt, not only the first one.
1723 - [ ] Evidence: SystemPrompt includes collaboration + themed usernames; ContinuePrompt now includes limited CRITICAL REMINDERS but not the full CRITICAL RULES, so enforcement still depends on the system prompt being present in the 20-message window.
24+- [ ] mysis dont recognize their own messages in broadcast, so they reply to them
1825
1926 - [ ] Cognitive Looping and Prompt Inefficiency: Myses can get stuck in "cooldown" loops or redundant "waiting" states, consuming tokens every 30 seconds without operational progress. The system prompts Myses every tick regardless of their state. Myses may hallucinate non-existent cooldowns or fail to use non-traveling actions during long journeys.
2027 - [ ] Evidence: ContinuePrompt is sent on a fixed 30-second ticker with no state-aware suppression.
@@ -23,6 +30,7 @@ These are the currently known issues to investigate:
2330
2431 - [ ] Travel Duration: The travel to the asteroid belt is a long-duration task (30k+ ticks). The Myses correctly entered a "waiting" mode, showing they can manage long-term state without wasting tokens on redundant actions. However, Mysis should continue to act on their tick during travel. They can still use other actions when traveling, like chatting or other non-traveling actions in the game. Currently the Mysis loses their ticks waiting when they could be using the turns to explore the game A …
2532 - [ ] Evidence: ContinuePrompt is always issued while running, even during travel/cooldown states.
33+- [ ] Mysis are aware of real time, they should only know tick time.
2634
2735 ## TUI Issues
2836
@@ -30,6 +38,7 @@ These are the currently known issues to investigate:
3038 - [ ] Reasoning messages are not displayed in the UI. They should appear in the focus mysis view, and be rendered with the purple color we use for text elsewhere. Note: Reasoning capture and storage was implemented in v1.5.2, but UI display is still pending.
3139 - [ ] Username status for each mysis focus view and in commander view.
3240 - [ ] Evidence: Focus view labels are based on Role only (broadcast source ignored); reasoning is stored but not rendered; TUI models do not include account username fields.
41+- [ ] Json needs to be human formatted in TUI and preserve a "Tree" view of it use unicode for the "tree" visuals. TUI focus view needs a `verbose` toggle to show truncated or not. Use inteligent truncation: first 3 items, [x more], last 3 item.
3342
3443 ## Ollama error:
3544
@@ -53,6 +62,8 @@ These are the currently known issues to investigate:
5362
5463 - [ ] Create an OpenCode workflow command to enforce: "Save the plan, make a todo list, then follow the plan. Stop if anything deviates from the plan."
5564
65+= [ ] another opencode command: "Audit our agents, readme, and documentation/ against the code. show me the differences or inconsistencies between the two. Use @explore to help."
66+
5667 - [x] Add a Make command that:
5768 - extracts username/passwords from the current DB to a root-level file
5869 - wipes the current DB
documentation/OLLAMA_MODELS.md+1−1
@@ -179,7 +179,7 @@ Suggested `config.toml` provider settings:
179179
180180 ```toml
181181 [providers.ollama]
182-base_url = "http://localhost:11434"
182+endpoint = "http://localhost:11434"
183183
184184 # For fast testing
185185 model = "qwen3:4b"
documentation/PER_MYSIS_CONFIG_PLAN.md+2−40
@@ -23,39 +23,7 @@ Go 1.22+, SQLite (modernc.org/sqlite), go-openai, BurntSushi/toml
2323 - Create: `documentation/OPENCODE_ZEN_MODELS.md`
2424
2525 **Content:**
26-```markdown
27-# OpenCode Zen Models
28-
29-Models available through OpenCode Zen for use with Zoea Nova.
30-
31-## Free Models
32-
33-These models are free during their beta period:
34-
35-| Model | Model ID | Endpoint | Tool Support |
36-|-------|----------|----------|--------------|
37-| GLM 4.7 Free | `glm-4.7-free` | `/v1/chat/completions` | Yes |
38-| Kimi K2.5 Free | `kimi-k2.5-free` | `/v1/chat/completions` | Yes |
39-| MiniMax M2.1 Free | `minimax-m2.1-free` | `/v1/messages` | Yes |
40-| Big Pickle | `big-pickle` | `/v1/chat/completions` | Yes |
41-| GPT 5 Nano | `gpt-5-nano` | `/v1/responses` | Yes |
42-
43-## Configuration
44-
45-```toml
46-[providers.opencode_zen]
47-endpoint = "https://api.opencode.ai/v1"
48-model = "glm-4.7-free"
49-temperature = 0.7
50-```
51-
52-Credentials are stored in `~/.zoea-nova/credentials.json`.
53-
54-## References
55-
56-- [OpenCode Zen Documentation](https://opencode.ai/docs/zen/)
57-- [Model List API](https://opencode.ai/zen/v1/models)
58-```
26+Document models and configuration details in `documentation/OPENCODE_ZEN_MODELS.md`.
5927
6028 ---
6129
@@ -484,13 +452,7 @@ func TestCommanderConfigureMysisWithModel(t *testing.T) {
484452
485453 ## Database Migration Note
486454
487-This change requires schema v4 with a new `temperature` column. Per AGENTS.md, no data migrations are supported. Reset with:
488-
489-```bash
490-make db-reset-accounts
491-```
492-
493-This exports usernames/passwords to `accounts-backup.sql` before recreating the DB.
455+This change requires schema v4 with a new `temperature` column. Per AGENTS.md, no data migrations are supported. See `AGENTS.md` for the reset command and backup details.
494456
495457 ---