Claudio Drews
d2228d5f95
fix: resolve 6 installation bugs in setup.sh and docker-compose ( #28 )
...
- Bug 1: QDRANT_API_KEY unbound variable (default to empty)
- Bug 2: Qdrant v1.17+ auth with empty key (conditional config)
- Bug 3: Redis crash with empty requirepass (conditional config)
- Bug 4: grep pattern now covers OPENROUTER_DS_API_KEY
- Bug 5: worker container healthcheck added
- Bug 7: execution-agent protocol installed during setup
Co-authored-by: ClaudioDrews <claudio@drews.com.br>
2026-06-08 21:53:15 -03:00
ClaudioDrews
1225af07f0
feat: add anti-theater quality rules to Pre-Action Protocol (Step 2)
...
Adds explicit examples of bad vs. good Match execution to
prevent performative compliance — the model producing vague
statements like 'Match: relevante' that satisfy the checklist
syntactically but provide zero information.
Also adds a quality rule: Match statements must cite at least
one concrete detail from the injected content so a human can
identify which block was read and what it contains.
2026-06-07 13:42:36 -03:00
Claudio Drews
a25f3a95d6
fix: add context_enhancer symlink step and Mandatory Pre-Action Protocol ( #25 )
...
setup.sh:
- Phase 5b: symlink context_enhancer.py to Hermes scripts dir
(fixes silent ModuleNotFoundError that disabled [qdrant] injection)
- Phase 9: auto-apply execution-agent-protocol.md
modifications/soul-rulebook.md:
- New section: Mandatory Pre-Action Protocol (4-step enforcement)
modifications/execution-agent-protocol.md:
- Standalone protocol for automated application by setup.sh
layers/07-ground-truth.md:
- Document behavioral gap between knowing and executing Ground Truth rules
Co-authored-by: ClaudioDrews <claudio@drews.com.br>
2026-06-07 12:10:06 -03:00
ClaudioDrews
6b11dc554a
docs: Fase B — R1 (rulebook amendments) + R2 (soul-rulebook additions)
...
R1: setup/rulebook.md reescrito como pointer para o novo arquivo
modifications/execution-agent-protocol.md, que formata as 3 seções
(Memory Architecture, Memory OS Docker stack, Mandatory Verifications)
como amendments ao Execution Agent protocol. Cada amendment especifica
onde inserir relativo às regras do protocolo. install.md passo 6
atualizado para refletir o novo formato.
R2: modifications/soul-rulebook.md ganhou duas novas seções:
- Fact feedback rule (fecha o loop de qualidade dos fatos)
- Honcho deprecation (avisa para não configurar Honcho)
2026-06-03 15:32:34 -03:00
ClaudioDrews
4e1f543a1d
docs: rewrite installation guide with real scripts and idempotent modifications ( fixes #11 )
...
Replace incomplete/outdated install instructions with accurate,
detailed steps grounded in production infrastructure.
setup/install.md:
- Step 3: run docker compose in-place (not via cp to ~/memory-os/)
- Step 5: explicit ~/.hermes/rulebook.md path, create-if-missing,
idempotency guard with Memory OS Additions v1 marker
- Step 6: document VAULT_PATH, wiki directory structure,
link to vault-curator as optional enrichment tool
- Step 7: replace fictional crontab with real maintenance scripts
and hermes cron create commands; add backfill prerequisite note
and exempt-prefix env var docs
setup/rulebook.md (NEW):
- Generic template with 3 blocks: Memory Architecture,
Memory OS infrastructure, Mandatory Verifications
- Idempotency markers on every block
modifications/soul-rulebook.md:
- SOUL.md-only (rulebook sections moved to setup/rulebook.md)
- Conditional instructions (add level 2 vs full hierarchy)
- Conflict resolution table (4 rules)
- Context injection convention with acting vs reasoning distinction
scripts/:
- 8 maintenance scripts updated with sanitized equivalents
- decay_scanner.py, semantic_dedup.py: collection_ → DECAY/DEDUP_EXEMPT_PREFIXES env vars
- reflection_trigger.py: hardcoded venv path → /usr/bin/env python3
- All shebangs normalized, all internal references removed
2026-06-03 09:29:19 -03:00
ClaudioDrews
0b32ffcfc2
Initial commit: Memory OS — 6-layer memory architecture for Hermes Agent
2026-05-31 16:50:37 -03:00