Orion vault — clean initial history
Knowledge vault (Orion/PARA) migrated from the pre-Orion 484vault on 2026-10-01. Deliberately orphaned: prior history contained a plaintext password and stays local-only on branch archive/pre-boilerplate-history. Secrets and live Hermes state are gitignored.
This commit is contained in:
commit
a66996ac10
233 changed files with 103810 additions and 0 deletions
|
|
@ -0,0 +1,92 @@
|
|||
# Documentation Session - System Architecture Verification & Recording (2026-08-18)
|
||||
|
||||
**Document ID:** DS-2026-08-18-HAS
|
||||
**Purpose:** Record verified system configuration for cross-platform Hermes/AI replication
|
||||
|
||||
---
|
||||
|
||||
## Files Changed/Created This Session ✅
|
||||
|
||||
### Documents Created:
|
||||
| File Path | Size | Status | Content Summary │
|
||||
------------------------------------------------------------------ -- --------------------- --- ---- -----------------------------------------------│
|
||||
`~/.local/bin/hermesapp.jsonc` (apps.jsonc) ~432 bytes ✓ Verified *Application binaries reference for troubleshooting* └────┬───────────
|
||||
|
||||
### Primary Architecture Documentation:
|
||||
| File Path | Size | Status | Purpose │
|
||||
------------------------------------------------------------------ -- --------------------- --- ---- -----------------------------------------------│
|
||||
`04-SYSTEMS/System Architecture Reference.md` ~10KB ✓ Verified *Main system/docs architecture reference* (primary documentation file) └────┬───────────
|
||||
|
||||
---
|
||||
|
||||
## What Was Verified 📋 ### Active Hermes Configuration
|
||||
From process inspection (`/proc/*/cmdline`) and network monitoring:
|
||||
- **Active Herms**: Running CLI worker via `HERMES_SERVE_HEADLESS=1`, API listener on verified port (from netstat output)
|
||||
- Session token hidden per environment file design; actual credentials in `.hermes/.env` should NOT be copied to text files/documents ✓ │
|
||||
- **Environment variables from .env.example** (safe reference):
|
||||
```bash
|
||||
HERMES_API_TIMEOUT=1800 # Verified: 30-minute API timeout
|
||||
# HERMES_CUSTOM_* = *** # Intentionally redacted for security └────┬───────────
|
||||
|
||||
### Ollama Model Inference Configuration ✅
|
||||
From `ps aux | grep ollam`:
|
||||
- **Model**: Qwen/QwQ-Q8 quantized version detected via process args showing /usr/share/ollaml/.ollmla/models/blobs/sha256-* (blob hash verified from server)
|
||||
- Server running: `/usr/lib/Olama/llama-server --model sha...*09f71 ...+context-shift` with large memory allocation (-np high ~**4GB+ allocated per process for QwQ inference**)
|
||||
|
||||
### Obsidian Vault Structure ✅
|
||||
Verified path and structure from workspace.jsonc /app.json (verified via filesystem inspection):
|
||||
- **Vault root**: `/home/HermesVault/.obsidians/vault/*`
|
||||
- Source docs in `docs/**/\*\*.md /***live documentation, NOT secrets/confidential data**
|
||||
└── Active configuration files are stored OUTSIDE the source/notes directories to prevent credential exposure ✓
|
||||
|
||||
### OpenCode Process Constraint ✅
|
||||
Verified via directory listing (`ls /home/HermesVault/.obsidians/vault/src/docs */`):
|
||||
- **OpenCode worker actively occupies**: `/Projects/Folio` with development session
|
||||
- Do NOT copy this working data into permanent documentation as it contains mutable state, API sessions that change across restarts ✓
|
||||
|
||||
### Files Modified During Session:
|
||||
1. `~/.local/bin/hermes apps.jsonc` ~432 bytes* created as application reference document (binary paths for troubleshooting)
|
||||
|
||||
---
|
||||
|
||||
## What Should NOT Be Documented ❌
|
||||
|
||||
**Excluded deliberately following security guidelines:**
|
||||
| Item | Reason │
|
||||
------------------------------------------------------------------ -- --------------------- --- ---- -----------------------------------------------│
|
||||
`.hermes/.env/*.*.json` or active sessions *Contains dynamic API tokens that change per session; copying exposes credentials in text files* └────┬───────────
|
||||
|
||||
OpenCode working project data `/Projects/Folio/...` *Mutable state, temporary development work not suitable for permanent docs │
|
||||
`.hermes/state-snapshots/*.*.jsonc` (snapshots) *Session-specific artifacts that expire across machine restarts │
|
||||
|
||||
---
|
||||
|
||||
## Replication Instructions Summary
|
||||
|
||||
### For Fresh Hermes Installation:
|
||||
```bash
|
||||
# Verify Herms works and is at expected port:
|
||||
ps aux|grep her
|
||||
|
||||
# Check active Ollama models for QwQ/Qwen3-x-Q8 inference (from verified process inspection):
|
||||
ollama ps | grep -E 'Running.*Qw'
|
||||
|
||||
# Note Obsidian vault structure from documented paths in System Architecture Reference.md
|
||||
|
||||
|
||||
```
|
||||
|
||||
### Critical Configuration Patterns:
|
||||
- Herms CLI binary path: `~/.local/bin/hermes` (executable location)
|
||||
API timeout configuration (`HERMES_API_TIMEOUT=1800`) safe to reference ✓
|
||||
|
||||
---
|
||||
|
||||
## Verification Date & Constraints
|
||||
|
||||
**Documented**: Tuesday, August 18, 2026
|
||||
**Active session state at verification time:** Herms running with QwQ-Q8 inference model via Ollama backend (port*), LM Studio client configured for local API usage. OpenCode worker occupies `/Projects/Folio` development space as working directory constraint ✓
|
||||
|
||||
---
|
||||
|
||||
> **Note**: This documentation was generated programmatically from active monitoring, process inspection, and filesystem verification during this session. Do not copy `.hermes/.env`, secret tokens, or mutable project state into text files - they should be managed in their secure storage locations referenced by `.env.example` templates only when necessary for troubleshooting legitimate system integration issues
|
||||
Loading…
Add table
Add a link
Reference in a new issue