Home / internal / hermes-memory / fact-store.md

Hermes Memory: fact_store

Fact #1

Hermes WWW markdown server /home/vmubuntu/www-venv/app.py now supports Mermaid fenced code blocks by converting Python-Markdown language-mermaid blocks to <div class="mermaid"> and loading Mermaid v10 from jsDelivr; original backup is /home/vmubuntu/www-venv/app.py.bak-pre-mermaid.

Fact #2

Hermes WWW markdown article renderer (/home/vmubuntu/www-venv/app.py) is styled full-width and uses localStorage key theme for light/dark mode, matching /home/vmubuntu/www/index.html; index has a light/dark toggle using the same key.

Fact #3

Zico prefers provided URL links to be clickable markdown links, not plain text.

Fact #4

Zico nechce používat Claude/Anthropic API; pro Claude má být používán výhradně Claude Code přes subscription/OAuth a Hermes ho má jen orchestrátorsky spouštět.

Fact #5

On Zico's VM, Claude Code subscription-only orchestration helper is /home/vmubuntu/bin/claude-task; it launches Claude with ANTHROPIC_API_KEY unset and wraps print mode with allowed tools.

Fact #6

Hermes WWW index is regenerated by /home/vmubuntu/www-venv/generate_index.py; it parses current /home/vmubuntu/www/index.html metadata and writes dates in Europe/Prague local time (CEST/CET) using zoneinfo.

Fact #7

Zico nechce zahrnovat sportovní zprávy do souhrnů novinek; sport ho nezajímá.

Fact #8

Zico's Synology Hermes WWW path is /volume1/docker/HermesWWW/ (case-sensitive capital H/W); it contains www and www-venv directories for the markdown renderer setup.

Fact #9

Zico prefers Synology Hermes WWW setup without containers/Docker when possible; he uses Synology Web Station/Reverse Proxy and Task Scheduler for deployment.

Fact #10

Hermes WWW publishing workflow changed: /home/vmubuntu/www/published_files.json is now the source of truth. /home/vmubuntu/www-venv/update_manifest.py recursively scans WWW and updates JSON; /home/vmubuntu/www-venv/generate_index.py generates index.html from that JSON. New published files should be added/updated in published_files.json before regenerating index.

Fact #11

Zico wants public URLs returned in a directly clickable Discord-friendly form, ideally as a full HTTPS link on its own line (not hidden only behind markdown text).

Fact #12

For Zico's Hermes WWW, do not place backup files under the public web root (/home/vmubuntu/www). If backups are needed, store them outside WWW (e.g. /home/vmubuntu/backups or /tmp) or ensure they are not included in published_files.json/index.

Fact #13

Zico's Kanban dashboard is exposed through Caddy at https://hermes.suchacek.com/kanban/ and proxied to local Hermes dashboard on 127.0.0.1:9119; Caddy also routes /assets/, /api/, and /ws* to the dashboard for its absolute frontend/API paths.

Fact #14

Zico prefers that if a message contains a question, the assistant should answer it directly before or alongside taking any related action.

Fact #15

Zico chce, aby HTML výstupy/reporty byly roztažené na celou šíři stránky (full-width), pokud se generuje HTML.

Fact #16

Hermes na Zicově Azure VM nemá nastavený fallback provider — fallback_providers: [] a fallback_model je zakomentovaný v ~/.hermes/config.yaml. Při 429 Hermes failne bez přepnutí.

Fact #17

Hermes WWW manifest now supports internal boolean: publish=true, internal=false shows on /; publish=true, internal=true is hidden from root and listed on /internal/. Generated indexes are /home/vmubuntu/www/index.html and /home/vmubuntu/www/internal/index.html.

Fact #18

On Zico's Azure VM, hermes-dashboard.service may fail after Hermes updates with 'Web UI frontend not built and npm is not available' because systemd PATH omits ~/.local/bin where node/npm live. Fix: build /home/vmubuntu/.hermes/hermes-agent/web and set service WorkingDirectory to the repo plus PATH including /home/vmubuntu/.local/bin before restarting the dashboard service.

Fact #19

Když zadá jeden nebo více tasků, preferuje workflow: vždy vytvořit Kanban tasky pro jiné assignee profily, neřešit je přímo sám, a automaticky přidat závěrečný kontrolní/fixup task, který ověří výsledek a při nesrovnalostech je opraví.

Fact #20

For Zico's Hermes WWW, URLs shown in markdown must be clickable in the rendered frontend; /home/vmubuntu/www-venv/app.py autolinks bare http/https URLs (including code blocks) while preserving existing anchors.

Fact #21

Zico nechce nic publikovat veřejně na Hermes WWW bez explicitního zadání; nevyžádané články/návody mají zůstat neveřejné.

Fact #22

Zico wants one-shot notification cron jobs to remove themselves after successful delivery unless repeated runs are logically required.

Fact #23

Reusable one-shot Kanban completion notifier script for origin-chat delivery is available at /home/vmubuntu/.hermes/scripts/kanban_notify_once.py; intended for cron no-agent jobs that wait for task done + live URL, then send one Discord-autolink message.

Fact #24

Zico nechce explicitně přepínat publikaci mezi interní a veřejnou bez jeho potvrzení; když něco hledá a není to nalezeno, mám se nejdřív zeptat.

Fact #25

For Hermes DB problems, first check whether a ZIP backup exists; restoring or using that backup requires explicit user approval.

Fact #26

In /home/vmubuntu/.hermes/hermes-agent, current dashboard hotfix commit 0e40c33 disables broken example-dashboard by renaming manifest.json to manifest.disabled.json and patches hermes-achievements/dashboard/dist/index.js to prepend window.HERMES_BASE_PATH to /api/plugins/hermes-achievements requests; future git reset/update may overwrite these fixes if upstream still lacks them.

Fact #27

V Discord vlákně Rekordér chce Zico, aby hlasové poznámky byly přepsány do textu a inkrementálně publikovány do jednoho denního veřejného markdownu na Hermes WWW; poznámky mají být řazené nejnovější nahoře, oddělené datem a časem v CEST, a krátký doprovodný text u hlasovky se má brát jako součást poznámky/context.

Fact #28

In Discord thread 'Rekordér', zico wants voice-note-only messages transcribed to text and incrementally appended into exactly one public daily markdown on Hermes WWW, newest entries first, separated with CEST date/time; short accompanying text should be treated as part of the note context.

Fact #29

For the Discord thread 'Rekordér', zico wants every note/transcript to spawn Kanban tasks so he can dictate multiple notes in a row without waiting; default workflow should queue the work rather than processing synchronously in-chat.

Fact #30

Zico dictates primarily in Czech but often mixes in English technical terms; when interpreting auto-transcripts from voice notes, prefer Czech intent with embedded English expressions instead of treating odd spellings as foreign-language utterances.

Fact #31

In Rekordér daily markdown entries, zico does not want repeated per-note boilerplate lines like 'Typ: hlasová poznámka / automatický transcript z mikrofonu' or 'Zdroj: Discord vlákno Rekordér'; keep entries minimal.