Compare commits
1 Commits
mimo/build
...
mimo/creat
| Author | SHA1 | Date | |
|---|---|---|---|
|
7890bd4886 |
10
.gitea/workflows/auto-merge.yml
Normal file
10
.gitea/workflows/auto-merge.yml
Normal file
@@ -0,0 +1,10 @@
|
||||
# Placeholder — auto-merge is handled by nexus-merge-bot.sh
|
||||
# Gitea Actions requires a runner to be registered.
|
||||
# When a runner is available, this can replace the bot.
|
||||
name: stub
|
||||
on: workflow_dispatch
|
||||
jobs:
|
||||
noop:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
- run: echo "See nexus-merge-bot.sh"
|
||||
@@ -1,203 +0,0 @@
|
||||
# FINDINGS: MemPalace Local AI Memory System Assessment & Leverage Plan
|
||||
|
||||
**Issue:** #1047
|
||||
**Date:** 2026-04-10
|
||||
**Investigator:** mimo-v2-pro (swarm researcher)
|
||||
|
||||
---
|
||||
|
||||
## 1. What Issue #1047 Claims
|
||||
|
||||
The issue (authored by Bezalel, dated 2026-04-07) describes MemPalace as:
|
||||
- An open-source local-first AI memory system with highest published LongMemEval scores (96.6% R@5)
|
||||
- A Python CLI + MCP server using ChromaDB + SQLite with a "palace" hierarchy metaphor
|
||||
- AAAK compression dialect for ~30x context compression
|
||||
- 19 MCP tools for agent memory
|
||||
|
||||
It recommends that every wizard clone/vendor MemPalace, configure rooms, mine workspace, and wire the searcher into heartbeats.
|
||||
|
||||
## 2. What Actually Exists in the Codebase (Current State)
|
||||
|
||||
The Nexus repo already contains **substantial MemPalace integration** that goes well beyond the original research proposal. Here is the full inventory:
|
||||
|
||||
### 2.1 Core Python Layer — `nexus/mempalace/` (3 files, ~290 lines)
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `config.py` | Environment-driven config: palace paths, fleet path, wing name, core rooms, collection name |
|
||||
| `searcher.py` | ChromaDB-backed search/write API with `search_memories()`, `search_fleet()`, `add_memory()` |
|
||||
| `__init__.py` | Package marker |
|
||||
|
||||
**Status:** Functional. Clean API. Lazy ChromaDB import with graceful `MemPalaceUnavailable` exception.
|
||||
|
||||
### 2.2 Fleet Management Tools — `mempalace/` (8 files, ~800 lines)
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `rooms.yaml` | Fleet-wide room taxonomy standard (5 core rooms + optional rooms) |
|
||||
| `validate_rooms.py` | Validates wizard `mempalace.yaml` against fleet standard |
|
||||
| `audit_privacy.py` | Scans fleet palace for policy violations (raw drawers, oversized closets, private paths) |
|
||||
| `retain_closets.py` | 90-day retention enforcement for closet aging |
|
||||
| `export_closets.sh` | Privacy-safe closet export for rsync to Alpha fleet palace |
|
||||
| `fleet_api.py` | HTTP API for shared fleet palace (search, record, wings) |
|
||||
| `tunnel_sync.py` | Pull closets from remote wizard's fleet API into local palace |
|
||||
| `__init__.py` | Package marker |
|
||||
|
||||
**Status:** Well-structured. Each tool has clear CLI interface and proper error handling.
|
||||
|
||||
### 2.3 Evennia MUD Integration — `nexus/evennia_mempalace/` (6 files, ~580 lines)
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `commands/recall.py` | `CmdRecall` (semantic search), `CmdEnterRoom` (teleport), `CmdAsk` (NPC query) |
|
||||
| `commands/write.py` | `CmdRecord`, `CmdNote`, `CmdEvent` (memory writing commands) |
|
||||
| `typeclasses/rooms.py` | `MemPalaceRoom` typeclass |
|
||||
| `typeclasses/npcs.py` | `StewardNPC` with question-answering via palace search |
|
||||
|
||||
**Status:** Complete. Evennia stub fallback for testing outside live environment.
|
||||
|
||||
### 2.4 3D Visualization — `nexus/components/spatial-memory.js` (~665 lines)
|
||||
|
||||
Maps memory categories to spatial regions in the Nexus Three.js world:
|
||||
- Inner ring: Documents, Projects, Code, Conversations, Working Memory, Archive
|
||||
- Outer ring (MemPalace zones, issue #1168): User Preferences, Project Facts, Tool Knowledge, General Facts
|
||||
- Crystal geometry with deterministic positioning, connection lines, localStorage persistence
|
||||
|
||||
**Status:** Functional 3D visualization with region markers, memory crystals, and animation.
|
||||
|
||||
### 2.5 Frontend Integration — `mempalace.js` (~44 lines)
|
||||
|
||||
Basic Electron/browser integration class that:
|
||||
- Initializes a palace wing
|
||||
- Auto-mines chat content every 30 seconds
|
||||
- Exposes `search()` method
|
||||
- Updates stats display
|
||||
|
||||
**Status:** Minimal but functional as a bridge between browser UI and CLI mempalace.
|
||||
|
||||
### 2.6 Scripts & Automation — `scripts/` (5 files)
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `mempalace-incremental-mine.sh` | Re-mines only changed files since last run |
|
||||
| `mempalace_nightly.sh` | Nightly maintenance |
|
||||
| `mempalace_export.py` | Export utility |
|
||||
| `validate_mempalace_taxonomy.py` | Taxonomy validation script |
|
||||
| `audit_mempalace_privacy.py` | Privacy audit script |
|
||||
| `sync_fleet_to_alpha.sh` | Fleet sync to Alpha server |
|
||||
|
||||
### 2.7 Tests — `tests/` (7 test files)
|
||||
|
||||
| File | Tests |
|
||||
|------|-------|
|
||||
| `test_mempalace_searcher.py` | Searcher API, config |
|
||||
| `test_mempalace_validate_rooms.py` | Room taxonomy validation |
|
||||
| `test_mempalace_retain_closets.py` | Closet retention |
|
||||
| `test_mempalace_audit_privacy.py` | Privacy auditor |
|
||||
| `test_mempalace_fleet_api.py` | Fleet HTTP API |
|
||||
| `test_mempalace_tunnel_sync.py` | Remote wizard sync |
|
||||
| `test_evennia_mempalace_commands.py` | Evennia commands + NPC helpers |
|
||||
|
||||
### 2.8 CI/CD
|
||||
|
||||
- **ci.yml**: Validates palace taxonomy on every PR, plus Python/JSON/YAML syntax checks
|
||||
- **weekly-audit.yml**: Monday 05:00 UTC — runs privacy audit + dry-run retention against test fixtures
|
||||
|
||||
### 2.9 Documentation
|
||||
|
||||
- `docs/mempalace_taxonomy.yaml` — Full taxonomy standard (145 lines)
|
||||
- `docs/mempalace/rooms.yaml` — Rooms documentation
|
||||
- `docs/mempalace/bezalel_example.yaml` — Example wizard config
|
||||
- `docs/bezalel/evennia/` — Evennia integration examples (steward NPC, palace commands)
|
||||
- `reports/bezalel/2026-04-07-mempalace-field-report.md` — Original field report
|
||||
|
||||
## 3. Gap Analysis: Issue #1047 vs. Reality
|
||||
|
||||
| Issue #1047 Proposes | Current State | Gap |
|
||||
|---------------------|---------------|-----|
|
||||
| "Each wizard should clone/vendor it" | Vendor infrastructure exists (`scripts/mempalace-incremental-mine.sh`) | **DONE** |
|
||||
| "Write a mempalace.yaml" | Fleet taxonomy standard + validator exist | **DONE** |
|
||||
| "Run mempalace mine" | Incremental mining script exists | **DONE** |
|
||||
| "Wire searcher into heartbeat scripts" | `nexus/mempalace/searcher.py` provides API | **DONE** (needs adoption verification) |
|
||||
| AAAK compression | Not implemented in repo | **OPEN** — no AAAK dialect code |
|
||||
| MCP server (19 tools) | No MCP server integration | **OPEN** — no MCP tool definitions |
|
||||
| Benchmark validation | No LongMemEval test harness in repo | **OPEN** — claims unverified locally |
|
||||
| Fleet-wide adoption | Only Bezalel field report exists | **OPEN** — no evidence of Timmy/Allegro/Ezra adoption |
|
||||
| Hermes harness integration | No direct harness/memory-tool bridge | **OPEN** — searcher exists but no harness wiring |
|
||||
|
||||
## 4. What's Actually Broken
|
||||
|
||||
### 4.1 No AAAK Implementation
|
||||
The issue describes AAAK (~30x compression, ~170 tokens wake-up context) as a key feature, but there is zero AAAK code in the repo. The `nexus/mempalace/` layer has no compression functions. This is a missing feature, not a bug.
|
||||
|
||||
### 4.2 No MCP Server Bridge
|
||||
The upstream MemPalace offers 19 MCP tools, but the Nexus integration only exposes the ChromaDB Python API. There is no MCP server definition, no tool registration for the harness, and no bridge to the `mcp_config.json` at repo root.
|
||||
|
||||
### 4.3 Fleet Adoption Gap
|
||||
Only Bezalel has a documented field report (#1072). There is no evidence that Timmy, Allegro, or Ezra have populated palaces, configured room taxonomies, or run incremental mining. The `export_closets.sh` script hardcodes Bezalel paths.
|
||||
|
||||
### 4.4 Frontend Integration Stale
|
||||
`mempalace.js` references `window.electronAPI.execPython()` which only works in the Electron shell. The main `app.js` (Three.js world) does not import or use `mempalace.js`. The `spatial-memory.js` component defines MemPalace zones but has no data pipeline to populate them from actual palace data.
|
||||
|
||||
### 4.5 Upstream Quality Concern
|
||||
Bezalel's field report notes the upstream repo is "astroturfed hype" — 13.4k LOC in a single commit, 5,769 GitHub stars in 48 hours, ~125 lines of tests. The code is not malicious but is not production-grade. The Nexus has effectively forked/vendored the useful parts and rewritten the critical integration layers.
|
||||
|
||||
## 5. What's Working Well
|
||||
|
||||
1. **Clean architecture separation** — `nexus/mempalace/` is a proper Python package with config/searcher separation. Testable without ChromaDB installed.
|
||||
|
||||
2. **Privacy-first fleet design** — closet-only export policy, privacy auditor, retention enforcement, and private path detection are solid operational safeguards.
|
||||
|
||||
3. **Taxonomy standardization** — `rooms.yaml` + validator ensures consistent memory structure across wizards.
|
||||
|
||||
4. **CI integration** — Taxonomy validation in PR checks + weekly privacy audit cron are good DevOps practices.
|
||||
|
||||
5. **Evennia integration** — The MUD commands (recall, enter room, ask steward) are well-designed and testable outside Evennia via stubs.
|
||||
|
||||
6. **Spatial visualization** — `spatial-memory.js` is a creative 3D representation with deterministic positioning and category zones.
|
||||
|
||||
## 6. Recommended Actions
|
||||
|
||||
### Priority 1: Fleet Adoption Verification (effort: small)
|
||||
- Confirm each wizard (Timmy, Allegro, Ezra) has run `mempalace mine` and has a populated palace
|
||||
- Verify `mempalace.yaml` exists on each wizard's VPS
|
||||
- Update `export_closets.sh` to not hardcode Bezalel paths (use env vars)
|
||||
|
||||
### Priority 2: Hermes Harness Bridge (effort: medium)
|
||||
- Wire `nexus/mempalace/searcher.py` into the Hermes harness as a memory tool
|
||||
- Add memory search/recall to the agent loop so wizards get cross-session context automatically
|
||||
- Map MemPalace search to the existing `memory`/`fact_store` tools or add a dedicated `palace_search` tool
|
||||
|
||||
### Priority 3: MCP Server Registration (effort: medium)
|
||||
- Create an MCP server that exposes search, write, and status tools
|
||||
- Register in `mcp_config.json`
|
||||
- Enable any harness agent to use MemPalace without Python imports
|
||||
|
||||
### Priority 4: AAAK Compression (effort: large, optional)
|
||||
- Implement or port the AAAK compression dialect
|
||||
- Generate wake-up context summaries from palace data
|
||||
- This is a nice-to-have, not critical — the raw ChromaDB search is functional
|
||||
|
||||
### Priority 5: 3D Pipeline Bridge (effort: medium)
|
||||
- Connect `spatial-memory.js` to live palace data via WebSocket or REST
|
||||
- Populate memory crystals from actual search results
|
||||
- Visual feedback when new memories are added
|
||||
|
||||
## 7. Effort Summary
|
||||
|
||||
| Action | Effort | Impact |
|
||||
|--------|--------|--------|
|
||||
| Fleet adoption verification | 2-4 hours | High — ensures all wizards have memory |
|
||||
| Hermes harness bridge | 1-2 days | High — automatic cross-session context |
|
||||
| MCP server registration | 1 day | Medium — enables any agent to use palace |
|
||||
| AAAK compression | 2-3 days | Low — nice-to-have |
|
||||
| 3D pipeline bridge | 1-2 days | Medium — visual representation of memory |
|
||||
| Fix export_closets.sh hardcoded paths | 30 min | Low — operational hygiene |
|
||||
|
||||
## 8. Conclusion
|
||||
|
||||
Issue #1047 was a research request from 2026-04-07. Since then, significant implementation work has been completed — far exceeding the original proposal. The core memory infrastructure (searcher, fleet tools, privacy, taxonomy, Evennia integration, tests, CI) is **built and functional**.
|
||||
|
||||
The primary remaining gap is **fleet-wide adoption** (only Bezalel has documented use) and **harness integration** (the searcher exists but isn't wired into the agent loop). The AAAK and MCP features from the original research are not implemented but are not blocking — the ChromaDB-backed search provides the core value proposition.
|
||||
|
||||
**Verdict:** The MemPalace integration is substantially complete at the infrastructure level. The next bottleneck is operational adoption and harness wiring, not new feature development.
|
||||
@@ -1,305 +0,0 @@
|
||||
# Security Audit: NostrIdentity BIP340 Schnorr Signatures — Timing Side-Channel Analysis
|
||||
|
||||
**Issue:** #801
|
||||
**Repository:** Timmy_Foundation/the-nexus
|
||||
**File:** `nexus/nostr_identity.py`
|
||||
**Auditor:** mimo-v2-pro swarm worker
|
||||
**Date:** 2026-04-10
|
||||
|
||||
---
|
||||
|
||||
## Summary
|
||||
|
||||
The pure-Python BIP340 Schnorr signature implementation in `NostrIdentity` has **multiple timing side-channel vulnerabilities** that could allow an attacker with precise timing measurements to recover the private key. The implementation is suitable for prototyping and non-adversarial environments but **must not be used in production** without the fixes described below.
|
||||
|
||||
---
|
||||
|
||||
## Architecture
|
||||
|
||||
The Nostr sovereign identity system consists of two files:
|
||||
|
||||
- **`nexus/nostr_identity.py`** — Pure-Python secp256k1 + BIP340 Schnorr signature implementation. No external dependencies. Contains `NostrIdentity` class for key generation, event signing, and pubkey derivation.
|
||||
- **`nexus/nostr_publisher.py`** — Async WebSocket publisher that sends signed Nostr events to public relays (damus.io, nos.lol, snort.social).
|
||||
- **`app.js` (line 507)** — Browser-side `NostrAgent` class uses **mock signatures** (`mock_id`, `mock_sig`), not real crypto. Not affected.
|
||||
|
||||
---
|
||||
|
||||
## Vulnerabilities Found
|
||||
|
||||
### 1. Branch-Dependent Scalar Multiplication — CRITICAL
|
||||
|
||||
**Location:** `nostr_identity.py:41-47` — `point_mul()`
|
||||
|
||||
```python
|
||||
def point_mul(p, n):
|
||||
r = None
|
||||
for i in range(256):
|
||||
if (n >> i) & 1: # <-- branch leaks Hamming weight
|
||||
r = point_add(r, p)
|
||||
p = point_add(p, p)
|
||||
return r
|
||||
```
|
||||
|
||||
**Problem:** The `if (n >> i) & 1` branch causes `point_add(r, p)` to execute only when the bit is 1. An attacker measuring signature generation time can determine which bits of the scalar are set, recovering the private key from a small number of timed signatures.
|
||||
|
||||
**Severity:** CRITICAL — direct private key recovery.
|
||||
|
||||
**Fix:** Use a constant-time double-and-always-add algorithm:
|
||||
|
||||
```python
|
||||
def point_mul(p, n):
|
||||
r = (None, None)
|
||||
for i in range(256):
|
||||
bit = (n >> i) & 1
|
||||
r0 = point_add(r, p) # always compute both
|
||||
r = r0 if bit else r # constant-time select
|
||||
p = point_add(p, p)
|
||||
return r
|
||||
```
|
||||
|
||||
Or better: use Montgomery ladder which avoids point doubling on the identity.
|
||||
|
||||
---
|
||||
|
||||
### 2. Branch-Dependent Point Addition — CRITICAL
|
||||
|
||||
**Location:** `nostr_identity.py:28-39` — `point_add()`
|
||||
|
||||
```python
|
||||
def point_add(p1, p2):
|
||||
if p1 is None: return p2 # <-- branch leaks operand state
|
||||
if p2 is None: return p1 # <-- branch leaks operand state
|
||||
(x1, y1), (x2, y2) = p1, p2
|
||||
if x1 == x2 and y1 != y2: return None # <-- branch leaks equality
|
||||
if x1 == x2: # <-- branch leaks equality
|
||||
m = (3 * x1 * x1 * inverse(2 * y1, P)) % P
|
||||
else:
|
||||
m = ((y2 - y1) * inverse(x2 - x1, P)) % P
|
||||
...
|
||||
```
|
||||
|
||||
**Problem:** Multiple conditional branches leak whether inputs are the identity point, whether x-coordinates are equal, and whether y-coordinates are negations. Combined with the scalar multiplication above, this gives an attacker detailed timing information about intermediate computations.
|
||||
|
||||
**Severity:** CRITICAL — compounds the scalar multiplication leak.
|
||||
|
||||
**Fix:** Replace with a branchless point addition using Jacobian or projective coordinates with dummy operations:
|
||||
|
||||
```python
|
||||
def point_add(p1, p2):
|
||||
# Use Jacobian coordinates; always perform full addition
|
||||
# Use conditional moves (simulated with arithmetic masking)
|
||||
# for selecting between doubling and addition paths
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 3. Branch-Dependent Y-Parity Check in Signing — HIGH
|
||||
|
||||
**Location:** `nostr_identity.py:57-58` — `sign_schnorr()`
|
||||
|
||||
```python
|
||||
R = point_mul(G, k)
|
||||
if R[1] % 2 != 0: # <-- branch leaks parity of R's y-coordinate
|
||||
k = N - k
|
||||
```
|
||||
|
||||
**Problem:** The conditional negation of `k` based on the y-parity of R leaks information about the nonce through timing. While less critical than the point_mul leak (it's a single bit), combined with other leaks it aids key recovery.
|
||||
|
||||
**Severity:** HIGH
|
||||
|
||||
**Fix:** Use arithmetic masking:
|
||||
|
||||
```python
|
||||
R = point_mul(G, k)
|
||||
parity = R[1] & 1
|
||||
k = (k * (1 - parity) + (N - k) * parity) % N # constant-time select
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 4. Non-Constant-Time Modular Inverse — MEDIUM
|
||||
|
||||
**Location:** `nostr_identity.py:25-26` — `inverse()`
|
||||
|
||||
```python
|
||||
def inverse(a, n):
|
||||
return pow(a, n - 2, n)
|
||||
```
|
||||
|
||||
**Problem:** CPython's built-in `pow()` with 3 args uses Montgomery ladder internally, which is *generally* constant-time for fixed-size operands. However:
|
||||
- This is an implementation detail, not a guarantee.
|
||||
- PyPy, GraalPy, and other Python runtimes may use different algorithms.
|
||||
- The exponent `n-2` has a fixed Hamming weight for secp256k1's `N`, so this specific case is less exploitable, but relying on it is fragile.
|
||||
|
||||
**Severity:** MEDIUM — implementation-dependent; low risk on CPython specifically.
|
||||
|
||||
**Fix:** Implement Fermat's little theorem inversion with blinding, or use a dedicated constant-time GCD algorithm (extended binary GCD).
|
||||
|
||||
---
|
||||
|
||||
### 5. Non-RFC6979 Nonce Generation — LOW (but non-standard)
|
||||
|
||||
**Location:** `nostr_identity.py:55`
|
||||
|
||||
```python
|
||||
k = int.from_bytes(sha256(privkey.to_bytes(32, 'big') + msg_hash), 'big') % N
|
||||
```
|
||||
|
||||
**Problem:** The nonce derivation is `SHA256(privkey || msg_hash)` which is deterministic but doesn't follow RFC6979 (HMAC-based DRBG). Issues:
|
||||
- Not vulnerable to timing (it's a single hash), but could be vulnerable to related-message attacks if the same key signs messages with predictable relationships.
|
||||
- BIP340 specifies `tagged_hash("BIP0340/nonce", ...)` with specific domain separation, which is not used here.
|
||||
|
||||
**Severity:** LOW — not a timing issue but a cryptographic correctness concern.
|
||||
|
||||
**Fix:** Follow RFC6979 or BIP340's tagged hash approach:
|
||||
|
||||
```python
|
||||
def sign_schnorr(msg_hash, privkey):
|
||||
# BIP340 nonce generation with tagged hash
|
||||
t = privkey.to_bytes(32, 'big')
|
||||
if R_y_is_odd:
|
||||
t = bytes(b ^ 0x01 for b in t) # negate if needed
|
||||
k = int.from_bytes(tagged_hash("BIP0340/nonce", t + pubkey + msg_hash), 'big') % N
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 6. Private Key Bias in Random Generation — LOW
|
||||
|
||||
**Location:** `nostr_identity.py:69`
|
||||
|
||||
```python
|
||||
self.privkey = int.from_bytes(os.urandom(32), 'big') % N
|
||||
```
|
||||
|
||||
**Problem:** `os.urandom(32)` produces values in `[0, 2^256)`, while `N` is slightly less than `2^256`. The modulo reduction introduces a negligible bias (~2^-128). Not exploitable in practice, but not the cleanest approach.
|
||||
|
||||
**Severity:** LOW — theoretically biased, practically unexploitable.
|
||||
|
||||
**Fix:** Use rejection sampling or derive from a hash:
|
||||
|
||||
```python
|
||||
def generate_privkey():
|
||||
while True:
|
||||
candidate = int.from_bytes(os.urandom(32), 'big')
|
||||
if 0 < candidate < N:
|
||||
return candidate
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### 7. No Scalar/Point Blinding — MEDIUM
|
||||
|
||||
**Location:** Global — no blinding anywhere in the implementation.
|
||||
|
||||
**Problem:** The implementation has no countermeasures against:
|
||||
- **Power analysis** (DPA/SPA) on embedded systems
|
||||
- **Cache-timing attacks** on shared hardware (VMs, cloud)
|
||||
- **Electromagnetic emanation** attacks
|
||||
|
||||
Adding random blinding to scalar multiplication (multiply by `r * r^-1` where `r` is random) would significantly raise the bar for side-channel attacks beyond simple timing.
|
||||
|
||||
**Severity:** MEDIUM — not timing-specific, but important for hardening.
|
||||
|
||||
---
|
||||
|
||||
## What's NOT Vulnerable (Good News)
|
||||
|
||||
1. **The JS-side `NostrAgent` in `app.js`** uses mock signatures (`mock_id`, `mock_sig`) — not real crypto, not affected.
|
||||
2. **`nostr_publisher.py`** correctly imports and uses `NostrIdentity` without modifying its internals.
|
||||
3. **The hash functions** (`sha256`, `hmac_sha256`) use Python's `hashlib` which delegates to OpenSSL — these are constant-time.
|
||||
4. **The JSON serialization** in `sign_event()` is deterministic and doesn't leak timing.
|
||||
|
||||
---
|
||||
|
||||
## Recommended Fix (Full Remediation)
|
||||
|
||||
### Priority 1: Replace with secp256k1-py or coincurve (IMMEDIATE)
|
||||
|
||||
The fastest, most reliable fix is to stop using the pure-Python implementation entirely:
|
||||
|
||||
```python
|
||||
# nostr_identity.py — replacement using coincurve
|
||||
import coincurve
|
||||
import hashlib
|
||||
import json
|
||||
import os
|
||||
|
||||
class NostrIdentity:
|
||||
def __init__(self, privkey_hex=None):
|
||||
if privkey_hex:
|
||||
self.privkey = bytes.fromhex(privkey_hex)
|
||||
else:
|
||||
self.privkey = os.urandom(32)
|
||||
self.pubkey = coincurve.PrivateKey(self.privkey).public_key.format(compressed=True)[1:].hex()
|
||||
|
||||
def sign_event(self, event):
|
||||
event_data = [0, event['pubkey'], event['created_at'], event['kind'], event['tags'], event['content']]
|
||||
serialized = json.dumps(event_data, separators=(',', ':'))
|
||||
msg_hash = hashlib.sha256(serialized.encode()).digest()
|
||||
event['id'] = msg_hash.hex()
|
||||
# Use libsecp256k1's BIP340 Schnorr (constant-time C implementation)
|
||||
event['sig'] = coincurve.PrivateKey(self.privkey).sign_schnorr(msg_hash).hex()
|
||||
return event
|
||||
```
|
||||
|
||||
**Effort:** ~2 hours (swap implementation, add `coincurve` to `requirements.txt`, test)
|
||||
**Risk:** Adds a C dependency. If pure-Python is required (sovereignty constraint), use Priority 2.
|
||||
|
||||
### Priority 2: Pure-Python Constant-Time Rewrite (IF PURE PYTHON REQUIRED)
|
||||
|
||||
If the sovereignty constraint (no C dependencies) must be maintained, rewrite the elliptic curve operations:
|
||||
|
||||
1. **Replace `point_mul`** with Montgomery ladder (constant-time by design)
|
||||
2. **Replace `point_add`** with Jacobian coordinate addition that always performs both doubling and addition, selecting with arithmetic masking
|
||||
3. **Replace `inverse`** with extended binary GCD with blinding
|
||||
4. **Fix nonce generation** to follow RFC6979 or BIP340 tagged hashes
|
||||
5. **Fix key generation** to use rejection sampling
|
||||
|
||||
**Effort:** ~8-12 hours (careful implementation + test vectors from BIP340 spec)
|
||||
**Risk:** Pure-Python crypto is inherently slower (~100ms per signature vs ~1ms with libsecp256k1)
|
||||
|
||||
### Priority 3: Hybrid Approach
|
||||
|
||||
Use `coincurve` when available, fall back to pure-Python with warnings:
|
||||
|
||||
```python
|
||||
try:
|
||||
import coincurve
|
||||
USE_LIB = True
|
||||
except ImportError:
|
||||
USE_LIB = False
|
||||
import warnings
|
||||
warnings.warn("Using pure-Python Schnorr — vulnerable to timing attacks. Install coincurve for production use.")
|
||||
```
|
||||
|
||||
**Effort:** ~3 hours
|
||||
|
||||
---
|
||||
|
||||
## Effort Estimate
|
||||
|
||||
| Fix | Effort | Risk Reduction | Recommended |
|
||||
|-----|--------|----------------|-------------|
|
||||
| Replace with coincurve (Priority 1) | 2h | Eliminates all timing issues | YES — do this |
|
||||
| Pure-Python constant-time rewrite (Priority 2) | 8-12h | Eliminates timing issues | Only if no-C constraint is firm |
|
||||
| Hybrid (Priority 3) | 3h | Full for installed, partial for fallback | Good compromise |
|
||||
| Findings doc + PR (this work) | 2h | Documents the problem | DONE |
|
||||
|
||||
---
|
||||
|
||||
## Test Vectors
|
||||
|
||||
The BIP340 specification includes test vectors at https://github.com/bitcoin/bips/blob/master/bip-00340/test-vectors.csv
|
||||
|
||||
Any replacement implementation MUST pass all test vectors before deployment.
|
||||
|
||||
---
|
||||
|
||||
## Conclusion
|
||||
|
||||
The pure-Python BIP340 Schnorr implementation in `NostrIdentity` is **vulnerable to timing side-channel attacks** that could recover the private key. The primary issue is branch-dependent execution in scalar multiplication and point addition. The fastest fix is replacing with `coincurve` (libsecp256k1 binding). If pure-Python sovereignty is required, a constant-time rewrite using Montgomery ladder and arithmetic masking is needed.
|
||||
|
||||
The JS-side `NostrAgent` in `app.js` uses mock signatures and is not affected.
|
||||
|
||||
**Recommendation:** Ship `coincurve` replacement immediately. It's 2 hours of work and eliminates the entire attack surface.
|
||||
@@ -1,169 +1,132 @@
|
||||
# Legacy Matrix Audit — Migration Table
|
||||
# Legacy Matrix Audit
|
||||
|
||||
Purpose:
|
||||
Preserve quality work from `/Users/apayne/the-matrix` before the Nexus browser shell is rebuilt.
|
||||
Preserve useful work from `/Users/apayne/the-matrix` before the Nexus browser shell is rebuilt.
|
||||
|
||||
Canonical rule:
|
||||
- `Timmy_Foundation/the-nexus` is the only canonical 3D repo.
|
||||
- `/Users/apayne/the-matrix` is legacy source material, not a parallel product.
|
||||
- This document is the authoritative migration table for issue #685.
|
||||
|
||||
## Verified Legacy State
|
||||
## Verified Legacy Matrix State
|
||||
|
||||
Local legacy repo: `/Users/apayne/the-matrix`
|
||||
Local legacy repo:
|
||||
- `/Users/apayne/the-matrix`
|
||||
|
||||
Observed facts:
|
||||
- Vite browser app, vanilla JS + Three.js 0.171.0
|
||||
- 24 JS modules under `js/`
|
||||
- Smoke suite: 87 passed, 0 failed
|
||||
- Package scripts: dev, build, preview, test
|
||||
- PWA manifest + service worker
|
||||
- Vite config with code-splitting (Three.js in separate chunk)
|
||||
- Quality-tier system for hardware detection
|
||||
- WebSocket client with reconnection, heartbeat, mock mode
|
||||
- Full avatar FPS movement + PiP camera
|
||||
- Sub-world portal system with zone triggers
|
||||
- Vite browser app exists
|
||||
- `npm test` passes with `87 passed, 0 failed`
|
||||
- 23 JS modules under `js/`
|
||||
- package scripts include `dev`, `build`, `preview`, and `test`
|
||||
|
||||
## Migration Table
|
||||
## Known historical Nexus snapshot
|
||||
|
||||
Decision key:
|
||||
- **CARRY** = transplant concepts and patterns into Nexus vNext
|
||||
- **ARCHIVE** = keep as reference, do not directly transplant
|
||||
- **DROP** = do not preserve unless re-justified
|
||||
Useful in-repo reference point:
|
||||
- `0518a1c3ae3c1d0afeb24dea9772102f5a3d9a66`
|
||||
|
||||
### Core Modules
|
||||
That snapshot still contains browser-world root files such as:
|
||||
- `index.html`
|
||||
- `app.js`
|
||||
- `style.css`
|
||||
- `package.json`
|
||||
- `tests/`
|
||||
|
||||
| File | Lines | Capability | Decision | Why for Nexus |
|
||||
|------|-------|------------|----------|---------------|
|
||||
| `js/main.js` | 180 | App bootstrap, render loop, WebGL context recovery | **CARRY** | Architectural pattern. Shows clean init/teardown lifecycle, context-loss recovery, visibility pause. Nexus needs this loop but should not copy the monolithic wiring. |
|
||||
| `js/world.js` | 95 | Scene, camera, renderer, grid, lights | **CARRY** | Foundational. Quality-tier-aware renderer setup, grid floor, lighting. Nexus already has a world but should adopt the tier-aware antialiasing and pixel-ratio capping. |
|
||||
| `js/config.js` | 68 | Connection config via URL params + env vars | **ARCHIVE** | Pattern reference only. Nexus config should route through Hermes harness, not Vite env vars. The URL-override pattern (ws, token, mock) is worth remembering. |
|
||||
| `js/quality.js` | 90 | Hardware detection, quality tier (low/medium/high) | **CARRY** | Directly useful. DPR capping, core/memory/screen heuristics, WebGL renderer sniffing. Nexus needs this for graceful degradation on Mac/iPad. |
|
||||
| `js/storage.js` | 39 | Safe localStorage with in-memory fallback | **CARRY** | Small, robust, sandbox-proof. Nexus should use this or equivalent. Prevents crashes in sandboxed iframes. |
|
||||
## Rescue Candidates
|
||||
|
||||
### Agent System
|
||||
### Carry forward into Nexus vNext
|
||||
|
||||
| File | Lines | Capability | Decision | Why for Nexus |
|
||||
|------|-------|------------|----------|---------------|
|
||||
| `js/agent-defs.js` | 30 | Agent identity data (id, label, color, role, position) | **CARRY** | Seed data model. Nexus agents should be defined similarly — data-driven, not hardcoded in render logic. Color hex helper is trivial but useful. |
|
||||
| `js/agents.js` | 523 | Agent 3D objects, movement, state, connection lines, hot-add/remove | **CARRY** | Core visual system. Shared geometries (perf), movement interpolation, wallet-health stress glow, auto-placement algorithm, connection-line pulse. All valuable. Needs integration with real agent state from Hermes. |
|
||||
| `js/behaviors.js` | 413 | Autonomous agent behavior state machine | **ARCHIVE** | Pattern reference. The personality-weighted behavior selection, conversation pairing, and artifact-placement system are well-designed. But Nexus behaviors should be driven by Hermes, not a client-side simulation. Keep the architecture, drop the fake-autonomy. |
|
||||
| `js/presence.js` | 139 | Agent presence HUD (online/offline, uptime, state) | **CARRY** | Valuable UX. Live "who's here" panel with uptime tickers and state indicators. Needs real backend state, not mock assumptions. |
|
||||
1. `agent-defs.js`
|
||||
- agent identity definitions
|
||||
- useful as seed data/model for visible entities in the world
|
||||
|
||||
### Visitor & Interaction
|
||||
2. `agents.js`
|
||||
- agent objects, state machine, connection lines
|
||||
- useful for visualizing Timmy / subagents / system processes in a world-native way
|
||||
|
||||
| File | Lines | Capability | Decision | Why for Nexus |
|
||||
|------|-------|------------|----------|---------------|
|
||||
| `js/visitor.js` | 141 | Visitor enter/leave protocol, chat input | **CARRY** | Session lifecycle. Device detection, visibility-based leave/return, chat input wiring. Directly applicable to Nexus visitor tracking. |
|
||||
| `js/avatar.js` | 360 | FPS movement, PiP dual-camera, touch input | **CARRY** | Visitor embodiment. WASD + arrow movement, first/third person swap, PiP canvas, touch joystick, right-click mouse-look. Strong work. Needs tuning for Nexus world bounds. |
|
||||
| `js/interaction.js` | 296 | Raycasting, click-to-select agents, info popup | **CARRY** | Essential for any browser world. OrbitControls, pointer/tap detection, agent popup with state/role, TALK button. The popup-anchoring-to-3D-position logic is particularly well done. |
|
||||
| `js/zones.js` | 161 | Proximity trigger zones (portal enter/exit, events) | **CARRY** | Spatial event system. Portal traversal, event triggers, once-only zones. Nexus portals (#672) need this exact pattern. |
|
||||
3. `avatar.js`
|
||||
- visitor embodiment, movement, camera handling
|
||||
- strongly aligned with "training ground" and "walk the world" goals
|
||||
|
||||
### Chat & Communication
|
||||
4. `ui.js`
|
||||
- HUD, chat surfaces, overlays
|
||||
- useful if rebuilt against real harness data instead of stale fake state
|
||||
|
||||
| File | Lines | Capability | Decision | Why for Nexus |
|
||||
|------|-------|------------|----------|---------------|
|
||||
| `js/bark.js` | 141 | Speech bubble system with typing animation | **CARRY** | Timmy's voice in-world. Typing animation, queue, auto-dismiss, emotion tags, demo bark lines. Strong expressive presence. The demo lines ("The Tower watches. The Tower remembers.") are good seed content. |
|
||||
| `js/ui.js` | 285 | Chat panel, agent list, HUD, streaming tokens | **CARRY** | Chat infrastructure. Rolling chat buffer, per-agent localStorage history, streaming token display with cursor animation, HTML escaping. Needs reconnection to Hermes chat instead of WS mock. |
|
||||
| `js/transcript.js` | 183 | Conversation transcript logger, export | **ARCHIVE** | Pattern reference. The rolling buffer, structured JSON entries, TXT/JSON download, HUD badge are all solid. But transcript authority should live in Hermes, not browser localStorage. Keep the UX pattern, rebuild storage layer. |
|
||||
5. `websocket.js`
|
||||
- browser-side live bridge patterns
|
||||
- useful if retethered to Hermes-facing transport
|
||||
|
||||
### Visual Effects
|
||||
6. `transcript.js`
|
||||
- local transcript capture pattern
|
||||
- useful if durable truth still routes through Hermes and browser cache remains secondary
|
||||
|
||||
| File | Lines | Capability | Decision | Why for Nexus |
|
||||
|------|-------|------------|----------|---------------|
|
||||
| `js/effects.js` | 195 | Matrix rain particles + starfield | **CARRY** | Atmospheric foundation. Quality-tier particle counts, frame-skip optimization, adaptive draw-range (FPS-budget recovery), bounding-sphere pre-compute. This is production-grade particle work. |
|
||||
| `js/ambient.js` | 212 | Mood-driven atmosphere (lighting, fog, rain, stars) | **CARRY** | Scene mood engine. Smooth eased transitions between mood states (calm, focused, excited, contemplative, stressed), per-mood lighting/fog/rain/star parameters. Directly supports Nexus atmosphere. |
|
||||
| `js/satflow.js` | 261 | Lightning payment particle flow | **CARRY** | Economy visualization. Bezier-arc particles, staggered travel, burst-on-arrival, pooling. If Nexus shows any payment/economy flow, this is the pattern. |
|
||||
7. `ambient.js`
|
||||
- mood / atmosphere system
|
||||
- directly supports wizardly presentation without changing system authority
|
||||
|
||||
### Economy & Scene
|
||||
8. `satflow.js`
|
||||
- visual economy / payment flow motifs
|
||||
- useful if Timmy's economy/agent interactions become a real visible layer
|
||||
|
||||
| File | Lines | Capability | Decision | Why for Nexus |
|
||||
|------|-------|------------|----------|---------------|
|
||||
| `js/economy.js` | 100 | Wallet/treasury HUD panel | **ARCHIVE** | UI pattern reference. Clean sats formatting, per-agent balance rows, health-colored dots, recent transactions. Worth rebuilding when backed by real sovereign metrics. |
|
||||
| `js/scene-objects.js` | 718 | Dynamic 3D object registry, portals, sub-worlds | **CARRY** | Critical. Geometry/material factories, animation system (rotate/bob/pulse/orbit), portal visual (torus ring + glow disc + zone), sub-world load/unload, text sprites, compound groups. This is the most complex and valuable module. Nexus portals (#672) should build on this. |
|
||||
9. `economy.js`
|
||||
- treasury / wallet panel ideas
|
||||
- useful if later backed by real sovereign metrics
|
||||
|
||||
### Backend Bridge
|
||||
10. `presence.js`
|
||||
- who-is-here / online-state UI
|
||||
- useful for showing human + agent + process presence in the world
|
||||
|
||||
| File | Lines | Capability | Decision | Why for Nexus |
|
||||
|------|-------|------------|----------|---------------|
|
||||
| `js/websocket.js` | 598 | WebSocket client, message dispatcher, mock mode | **ARCHIVE** | Pattern reference only. Reconnection with exponential backoff, heartbeat/zombie detection, rich message dispatch (40+ message types), streaming chat support. The architecture is sound but must be reconnected to Hermes transport, not copied wholesale. The message-type catalog is the most valuable reference artifact. |
|
||||
| `js/demo.js` | ~300 | Demo autopilot (mock mode simulation) | **DROP** | Fake activity simulation. Deliberately creates the illusion of live data. Do not preserve. If Nexus needs a demo mode, build a clearly-labeled one that doesn't pretend to be real. |
|
||||
11. `interaction.js`
|
||||
- clicking, inspecting, selecting world entities
|
||||
- likely needed in any real browser-facing Nexus shell
|
||||
|
||||
### Testing & Build
|
||||
12. `quality.js`
|
||||
- hardware-aware quality tiering
|
||||
- useful for local-first graceful degradation on Mac hardware
|
||||
|
||||
| File | Lines | Capability | Decision | Why for Nexus |
|
||||
|------|-------|------------|----------|---------------|
|
||||
| `test/smoke.mjs` | 235 | Automated browser smoke test suite | **CARRY** | Testing discipline. Module inventory check, export verification, HTML structure validation, Vite build test, bundle-size budget, PWA manifest check. Nexus should adopt this pattern (adapted for its own module structure). |
|
||||
| `vite.config.js` | 53 | Build config with code splitting, SW generation | **ARCHIVE** | Build tooling reference. manualChunks for Three.js, SW precache generation plugin. Relevant if Nexus re-commits to Vite. |
|
||||
| `sw.js` | ~40 | Service worker with precache | **ARCHIVE** | PWA reference. Relevant only if Nexus pursues offline-first PWA. |
|
||||
| `manifest.json` | ~20 | PWA manifest | **ARCHIVE** | PWA reference. |
|
||||
13. `bark.js`
|
||||
- prominent speech / bark system
|
||||
- strong fit for Timmy's expressive presence in-world
|
||||
|
||||
### Server-Side (Python)
|
||||
14. `world.js`, `effects.js`, `scene-objects.js`, `zones.js`
|
||||
- broad visual foundation work
|
||||
- should be mined for patterns, not blindly transplanted
|
||||
|
||||
| File | Lines | Capability | Decision | Why for Nexus |
|
||||
|------|-------|------------|----------|---------------|
|
||||
| `server/bridge.py` | ~900 | WebSocket bridge server | **ARCHIVE** | Reference. Hermes replaces this role. Keep for protocol schema reference. |
|
||||
| `server/gateway.py` | ~400 | HTTP gateway | **ARCHIVE** | Reference. |
|
||||
| `server/ollama_client.py` | ~280 | Ollama integration | **ARCHIVE** | Reference. Relevant if Nexus needs local model calls. |
|
||||
| `server/research.py` | ~450 | Research pipeline | **ARCHIVE** | Reference. |
|
||||
| `server/webhooks.py` | ~350 | Webhook handler | **ARCHIVE** | Reference. |
|
||||
| `server/test_*.py` | ~5 files | Server test suites | **ARCHIVE** | Testing patterns worth studying. |
|
||||
15. `test/smoke.mjs`
|
||||
- browser smoke discipline
|
||||
- should inform rebuilt validation in canonical Nexus repo
|
||||
|
||||
## Summary by Decision
|
||||
### Archive as reference, not direct carry-forward
|
||||
|
||||
### CARRY FORWARD (17 modules)
|
||||
These modules contain patterns, algorithms, or entire implementations that should move into the Nexus browser shell:
|
||||
- demo/autopilot assumptions that pretend fake backend activity is real
|
||||
- any websocket schema that no longer matches Hermes truth
|
||||
- Vite-specific plumbing that is only useful if we consciously recommit to Vite
|
||||
|
||||
- `quality.js` — hardware detection
|
||||
- `storage.js` — safe persistence
|
||||
- `world.js` — scene foundation
|
||||
- `agent-defs.js` — agent data model
|
||||
- `agents.js` — agent visualization + movement
|
||||
- `presence.js` — online presence HUD
|
||||
- `visitor.js` — session lifecycle
|
||||
- `avatar.js` — FPS embodiment
|
||||
- `interaction.js` — click/select/raycast
|
||||
- `zones.js` — spatial triggers
|
||||
- `bark.js` — speech bubbles
|
||||
- `ui.js` — chat/HUD
|
||||
- `effects.js` — particle effects
|
||||
- `ambient.js` — mood atmosphere
|
||||
- `satflow.js` — payment flow particles
|
||||
- `scene-objects.js` — dynamic objects + portals
|
||||
- `test/smoke.mjs` — smoke test discipline
|
||||
### Deliberately drop unless re-justified
|
||||
|
||||
### ARCHIVE AS REFERENCE (9 modules/files)
|
||||
Keep for patterns, protocol schemas, and architectural reference. Do not directly transplant:
|
||||
|
||||
- `config.js` — config pattern (use Hermes instead)
|
||||
- `behaviors.js` — behavior architecture (use Hermes-driven state)
|
||||
- `transcript.js` — transcript UX (use Hermes storage)
|
||||
- `economy.js` — economy UI pattern (use real metrics)
|
||||
- `websocket.js` — message protocol catalog + reconnection patterns
|
||||
- `vite.config.js` — build tooling
|
||||
- `sw.js`, `manifest.json` — PWA reference
|
||||
- `server/*.py` — server protocol schemas
|
||||
|
||||
### DELIBERATELY DROP (2)
|
||||
Do not preserve unless re-justified:
|
||||
|
||||
- `demo.js` — fake activity simulation; creates false impression of live system
|
||||
- `main.js` monolithic wiring — the init pattern carries, the specific module wiring does not
|
||||
- anything that presents mock data as if it were live
|
||||
- anything that duplicates a better Hermes-native telemetry path
|
||||
- anything that turns the browser into the system of record
|
||||
|
||||
## Concern Separation for Nexus vNext
|
||||
|
||||
When rebuilding inside `the-nexus`, keep these concerns in separate modules:
|
||||
When rebuilding inside `the-nexus`, keep concerns separated:
|
||||
|
||||
1. **World shell** — scene, camera, renderer, grid, lights, fog
|
||||
2. **Effects layer** — rain, stars, ambient mood transitions
|
||||
3. **Agent visualization** — 3D objects, labels, connection lines, movement
|
||||
4. **Visitor embodiment** — avatar, FPS controls, PiP camera
|
||||
5. **Interaction layer** — raycasting, selection, zones, portal traversal
|
||||
6. **Communication surface** — bark, chat panel, streaming tokens
|
||||
7. **Presence & HUD** — who's-online, economy panel, transcript controls
|
||||
8. **Harness bridge** — WebSocket/API transport to Hermes (NOT a copy of websocket.js)
|
||||
9. **Quality & config** — hardware detection, runtime configuration
|
||||
10. **Smoke tests** — automated validation
|
||||
1. World shell / rendering
|
||||
- scene, camera, movement, atmosphere
|
||||
|
||||
2. Presence and embodiment
|
||||
- avatar, agent placement, selection, bark/chat surfaces
|
||||
|
||||
3. Harness bridge
|
||||
- websocket / API bridge from Hermes truth into browser state
|
||||
|
||||
4. Visualization panels
|
||||
- metrics, presence, economy, portal states, transcripts
|
||||
|
||||
5. Validation
|
||||
- smoke tests, screenshot proof, provenance checks
|
||||
|
||||
6. Game portal layer
|
||||
- Morrowind / portal-specific interaction surfaces
|
||||
|
||||
Do not collapse all of this into one giant app file again.
|
||||
Do not let visual shell code become telemetry authority.
|
||||
|
||||
321
app.js
321
app.js
@@ -1,5 +1,3 @@
|
||||
shell-init: error retrieving current directory: getcwd: cannot access parent directories: No such file or directory
|
||||
chdir: error retrieving current directory: getcwd: cannot access parent directories: No such file or directory
|
||||
import * as THREE from 'three';
|
||||
import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
|
||||
import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
|
||||
@@ -7,8 +5,6 @@ import { UnrealBloomPass } from 'three/addons/postprocessing/UnrealBloomPass.js'
|
||||
import { SMAAPass } from 'three/addons/postprocessing/SMAAPass.js';
|
||||
import { SpatialMemory } from './nexus/components/spatial-memory.js';
|
||||
import { SessionRooms } from './nexus/components/session-rooms.js';
|
||||
import { TimelineScrubber } from './nexus/components/timeline-scrubber.js';
|
||||
import { MemoryParticles } from './nexus/components/memory-particles.js';
|
||||
|
||||
// ═══════════════════════════════════════════
|
||||
// NEXUS v1.1 — Portal System Update
|
||||
@@ -710,9 +706,6 @@ async function init() {
|
||||
createWorkshopTerminal();
|
||||
createAshStorm();
|
||||
SpatialMemory.init(scene);
|
||||
MemoryParticles.init(scene);
|
||||
SpatialMemory.setOnMemoryPlaced(MemoryParticles.onMemoryPlaced);
|
||||
TimelineScrubber.init(SpatialMemory);
|
||||
SessionRooms.init(scene, camera, null);
|
||||
updateLoad(90);
|
||||
|
||||
@@ -1918,10 +1911,6 @@ function setupControls() {
|
||||
const memInfo = SpatialMemory.getMemoryFromMesh(hitMesh);
|
||||
if (memInfo) {
|
||||
SpatialMemory.highlightMemory(memInfo.data.id);
|
||||
// Memory access trail particles
|
||||
if (camera) {
|
||||
MemoryParticles.onMemoryAccessed(camera.position, hitMesh.position, memInfo.data.category || memInfo.region || 'working');
|
||||
}
|
||||
showMemoryPanel(memInfo, e.clientX, e.clientY);
|
||||
return;
|
||||
}
|
||||
@@ -1993,97 +1982,30 @@ function setupControls() {
|
||||
document.getElementById('chat-quick-actions').addEventListener('click', (e) => {
|
||||
const btn = e.target.closest('.quick-action-btn');
|
||||
if (!btn) return;
|
||||
handleQuickAction(btn.dataset.action);
|
||||
|
||||
const action = btn.dataset.action;
|
||||
|
||||
switch(action) {
|
||||
case 'status':
|
||||
sendChatMessage("Timmy, what is the current system status?");
|
||||
break;
|
||||
case 'agents':
|
||||
sendChatMessage("Timmy, check on all active agents.");
|
||||
break;
|
||||
case 'portals':
|
||||
openPortalAtlas();
|
||||
break;
|
||||
case 'help':
|
||||
sendChatMessage("Timmy, I need assistance with Nexus navigation.");
|
||||
break;
|
||||
}
|
||||
});
|
||||
|
||||
// ═══ QUICK ACTION HANDLER ═══
|
||||
function handleQuickAction(action) {
|
||||
switch(action) {
|
||||
case 'status': {
|
||||
const portalCount = portals.length;
|
||||
const onlinePortals = portals.filter(p => p.userData && p.userData.status === 'online').length;
|
||||
const agentCount = agents.length;
|
||||
const wsState = wsConnected ? 'ONLINE' : 'OFFLINE';
|
||||
const wsColor = wsConnected ? '#4af0c0' : '#ff4466';
|
||||
addChatMessage('system', `[SYSTEM STATUS]`);
|
||||
addChatMessage('timmy', `Nexus operational. ${portalCount} portals registered (${onlinePortals} online). ${agentCount} agent presences active. Hermes WebSocket: ${wsState}. Navigation mode: ${NAV_MODES[navModeIdx].toUpperCase()}. Performance tier: ${performanceTier.toUpperCase()}.`);
|
||||
break;
|
||||
}
|
||||
case 'agents': {
|
||||
addChatMessage('system', `[AGENT ROSTER]`);
|
||||
if (agents.length === 0) {
|
||||
addChatMessage('timmy', 'No active agent presences detected in the Nexus. The thought stream and harness pulse are the primary indicators of system activity.');
|
||||
} else {
|
||||
const roster = agents.map(a => `- ${(a.userData && a.userData.name) || a.name || 'Unknown'}: ${(a.userData && a.userData.status) || 'active'}`).join('\n');
|
||||
addChatMessage('timmy', `Active agents:\n${roster}`);
|
||||
}
|
||||
break;
|
||||
}
|
||||
case 'portals':
|
||||
openPortalAtlas();
|
||||
break;
|
||||
case 'heartbeat': {
|
||||
const agentLog = document.getElementById('agent-log-content');
|
||||
const recentEntries = agentLog ? agentLog.querySelectorAll('.agent-log-entry') : [];
|
||||
const entryCount = recentEntries.length;
|
||||
addChatMessage('system', `[HEARTBEAT INSPECTION]`);
|
||||
addChatMessage('timmy', `Hermes heartbeat ${wsConnected ? 'active' : 'inactive'}. ${entryCount} recent entries in thought stream. WebSocket reconnect timer: ${wsReconnectTimer ? 'active' : 'idle'}. Harness pulse mesh: ${harnessPulseMesh ? 'rendering' : 'standby'}.`);
|
||||
break;
|
||||
}
|
||||
case 'thoughts': {
|
||||
const agentLog = document.getElementById('agent-log-content');
|
||||
const entries = agentLog ? Array.from(agentLog.querySelectorAll('.agent-log-entry')).slice(0, 5) : [];
|
||||
addChatMessage('system', `[THOUGHT STREAM]`);
|
||||
if (entries.length === 0) {
|
||||
addChatMessage('timmy', 'The thought stream is quiet. No recent agent entries detected.');
|
||||
} else {
|
||||
const summary = entries.map(e => '> ' + e.textContent.trim()).join('\n');
|
||||
addChatMessage('timmy', `Recent thoughts:\n${summary}`);
|
||||
}
|
||||
break;
|
||||
}
|
||||
case 'help': {
|
||||
addChatMessage('system', `[NEXUS HELP]`);
|
||||
addChatMessage('timmy', `Navigation: WASD to move, mouse to look around.\n` +
|
||||
`Press V to cycle: Walk / Orbit / Fly mode.\n` +
|
||||
`Enter to chat. Escape to close overlays.\n` +
|
||||
`Press F near a portal to enter. Press E near a vision point to read.\n` +
|
||||
`Press Tab for Portal Atlas.\n` +
|
||||
`The Batcave Terminal shows system logs. The Workshop Terminal shows tool output.`);
|
||||
break;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
document.getElementById('portal-close-btn').addEventListener('click', closePortalOverlay);
|
||||
document.getElementById('vision-close-btn').addEventListener('click', closeVisionOverlay);
|
||||
|
||||
document.getElementById('atlas-toggle-btn').addEventListener('click', openPortalAtlas);
|
||||
document.getElementById('atlas-close-btn').addEventListener('click', closePortalAtlas);
|
||||
|
||||
// Mnemosyne export/import (#1174)
|
||||
document.getElementById('mnemosyne-export-btn').addEventListener('click', () => {
|
||||
const result = SpatialMemory.exportToFile();
|
||||
if (result) {
|
||||
addChatMessage('system', 'Mnemosyne: Exported ' + result.count + ' memories to ' + result.filename);
|
||||
}
|
||||
});
|
||||
|
||||
document.getElementById('mnemosyne-import-btn').addEventListener('click', () => {
|
||||
document.getElementById('mnemosyne-import-file').click();
|
||||
});
|
||||
|
||||
document.getElementById('mnemosyne-import-file').addEventListener('change', async (e) => {
|
||||
const file = e.target.files[0];
|
||||
if (!file) return;
|
||||
try {
|
||||
const result = await SpatialMemory.importFromFile(file);
|
||||
addChatMessage('system', 'Mnemosyne: Imported ' + result.count + ' of ' + result.total + ' memories');
|
||||
} catch (err) {
|
||||
addChatMessage('system', 'Mnemosyne: Import failed — ' + err.message);
|
||||
}
|
||||
e.target.value = '';
|
||||
});
|
||||
}
|
||||
|
||||
function sendChatMessage(overrideText = null) {
|
||||
@@ -2507,15 +2429,6 @@ function activatePortal(portal) {
|
||||
|
||||
overlay.style.display = 'flex';
|
||||
|
||||
// Readiness detail for game-world portals
|
||||
const readinessEl = document.getElementById('portal-readiness-detail');
|
||||
if (portal.config.portal_type === 'game-world' && portal.config.readiness_steps) {
|
||||
renderReadinessDetail(readinessEl, portal.config);
|
||||
readinessEl.style.display = 'block';
|
||||
} else {
|
||||
readinessEl.style.display = 'none';
|
||||
}
|
||||
|
||||
if (portal.config.destination && portal.config.destination.url) {
|
||||
redirectBox.style.display = 'block';
|
||||
errorBox.style.display = 'none';
|
||||
@@ -2537,37 +2450,6 @@ function activatePortal(portal) {
|
||||
}
|
||||
}
|
||||
|
||||
// ═══ READINESS RENDERING ═══
|
||||
function renderReadinessDetail(container, config) {
|
||||
const steps = config.readiness_steps || {};
|
||||
const stepKeys = ['downloaded', 'runtime_ready', 'launched', 'harness_bridged'];
|
||||
let html = '<div class="portal-readiness-title">READINESS PIPELINE</div>';
|
||||
|
||||
let firstUndone = true;
|
||||
stepKeys.forEach(key => {
|
||||
const step = steps[key];
|
||||
if (!step) return;
|
||||
const cls = step.done ? 'done' : (firstUndone ? 'current' : '');
|
||||
if (!step.done) firstUndone = false;
|
||||
html += `<div class="portal-readiness-step ${cls}">
|
||||
<span class="step-dot"></span>
|
||||
<span>${step.label || key}</span>
|
||||
</div>`;
|
||||
});
|
||||
|
||||
if (config.blocked_reason) {
|
||||
html += `<div class="portal-readiness-blocked">⚠ ${config.blocked_reason}</div>`;
|
||||
}
|
||||
|
||||
const doneCount = stepKeys.filter(k => steps[k]?.done).length;
|
||||
const canEnter = doneCount === stepKeys.length && config.destination?.url;
|
||||
if (!canEnter) {
|
||||
html += `<div class="portal-readiness-hint">Cannot enter yet — ${stepKeys.length - doneCount} step${stepKeys.length - doneCount > 1 ? 's' : ''} remaining.</div>`;
|
||||
}
|
||||
|
||||
container.innerHTML = html;
|
||||
}
|
||||
|
||||
function closePortalOverlay() {
|
||||
portalOverlayActive = false;
|
||||
document.getElementById('portal-overlay').style.display = 'none';
|
||||
@@ -2648,42 +2530,12 @@ function populateAtlas() {
|
||||
|
||||
const statusClass = `status-${config.status || 'online'}`;
|
||||
|
||||
// Build readiness section for game-world portals
|
||||
let readinessHtml = '';
|
||||
if (config.portal_type === 'game-world' && config.readiness_steps) {
|
||||
const stepKeys = ['downloaded', 'runtime_ready', 'launched', 'harness_bridged'];
|
||||
const steps = config.readiness_steps;
|
||||
const doneCount = stepKeys.filter(k => steps[k]?.done).length;
|
||||
const pct = Math.round((doneCount / stepKeys.length) * 100);
|
||||
const barColor = config.color || '#ffd700';
|
||||
|
||||
readinessHtml = `<div class="atlas-card-readiness">
|
||||
<div class="readiness-bar-track">
|
||||
<div class="readiness-bar-fill" style="width:${pct}%;background:${barColor};"></div>
|
||||
</div>
|
||||
<div class="readiness-steps-mini">`;
|
||||
let firstUndone = true;
|
||||
stepKeys.forEach(key => {
|
||||
const step = steps[key];
|
||||
if (!step) return;
|
||||
const cls = step.done ? 'done' : (firstUndone ? 'current' : '');
|
||||
if (!step.done) firstUndone = false;
|
||||
readinessHtml += `<span class="readiness-step ${cls}">${step.label || key}</span>`;
|
||||
});
|
||||
readinessHtml += '</div>';
|
||||
if (config.blocked_reason) {
|
||||
readinessHtml += `<div class="atlas-card-blocked">⚠ ${config.blocked_reason}</div>`;
|
||||
}
|
||||
readinessHtml += '</div>';
|
||||
}
|
||||
|
||||
card.innerHTML = `
|
||||
<div class="atlas-card-header">
|
||||
<div class="atlas-card-name">${config.name}</div>
|
||||
<div class="atlas-card-status ${statusClass}">${config.readiness_state || config.status || 'ONLINE'}</div>
|
||||
<div class="atlas-card-status ${statusClass}">${config.status || 'ONLINE'}</div>
|
||||
</div>
|
||||
<div class="atlas-card-desc">${config.description}</div>
|
||||
${readinessHtml}
|
||||
<div class="atlas-card-footer">
|
||||
<div class="atlas-card-coord">X:${config.position.x} Z:${config.position.z}</div>
|
||||
<div class="atlas-card-type">${config.destination?.type?.toUpperCase() || 'UNKNOWN'}</div>
|
||||
@@ -2701,14 +2553,11 @@ function populateAtlas() {
|
||||
document.getElementById('atlas-online-count').textContent = onlineCount;
|
||||
document.getElementById('atlas-standby-count').textContent = standbyCount;
|
||||
|
||||
// Update Bannerlord HUD status with honest readiness state
|
||||
// Update Bannerlord HUD status
|
||||
const bannerlord = portals.find(p => p.config.id === 'bannerlord');
|
||||
if (bannerlord) {
|
||||
const statusEl = document.getElementById('bannerlord-status');
|
||||
const state = bannerlord.config.readiness_state || bannerlord.config.status || 'offline';
|
||||
statusEl.className = 'hud-status-item ' + state;
|
||||
const labelEl = statusEl.querySelector('.status-label');
|
||||
if (labelEl) labelEl.textContent = state.toUpperCase().replace(/_/g, ' ');
|
||||
statusEl.className = 'hud-status-item ' + (bannerlord.config.status || 'offline');
|
||||
}
|
||||
}
|
||||
|
||||
@@ -2777,18 +2626,6 @@ function _positionPanel(panel, clickX, clickY) {
|
||||
function _navigateToMemory(memId) {
|
||||
SpatialMemory.highlightMemory(memId);
|
||||
addChatMessage('system', `Focus: ${memId.replace(/_/g, ' ')}`);
|
||||
|
||||
// Access trail particles
|
||||
const meshes = SpatialMemory.getCrystalMeshes();
|
||||
for (const mesh of meshes) {
|
||||
if (mesh.userData && mesh.userData.memId === memId) {
|
||||
const memInfo = SpatialMemory.getMemoryFromMesh(mesh);
|
||||
if (memInfo && camera) {
|
||||
MemoryParticles.onMemoryAccessed(camera.position, mesh.position, memInfo.data.category || memInfo.region || 'working');
|
||||
}
|
||||
break;
|
||||
}
|
||||
}
|
||||
const meshes = SpatialMemory.getCrystalMeshes();
|
||||
for (const mesh of meshes) {
|
||||
if (mesh.userData && mesh.userData.memId === memId) {
|
||||
@@ -2994,8 +2831,6 @@ function gameLoop() {
|
||||
// Project Mnemosyne - Memory Orb Animation
|
||||
if (typeof animateMemoryOrbs === 'function') {
|
||||
SpatialMemory.update(delta);
|
||||
MemoryParticles.update(delta);
|
||||
TimelineScrubber.update();
|
||||
animateMemoryOrbs(delta);
|
||||
}
|
||||
|
||||
@@ -3540,122 +3375,6 @@ init().then(() => {
|
||||
// Gravity well clustering — attract related crystals, bake positions (issue #1175)
|
||||
SpatialMemory.runGravityLayout();
|
||||
|
||||
|
||||
// ═══ SPATIAL SEARCH (Mnemosyne #1170) ═══
|
||||
(() => {
|
||||
const input = document.getElementById('spatial-search-input');
|
||||
const resultsDiv = document.getElementById('spatial-search-results');
|
||||
if (!input || !resultsDiv) return;
|
||||
|
||||
let searchTimeout = null;
|
||||
let currentMatches = [];
|
||||
|
||||
function runSearch(query) {
|
||||
if (!query.trim()) {
|
||||
SpatialMemory.clearSearch();
|
||||
resultsDiv.classList.remove('visible');
|
||||
resultsDiv.innerHTML = '';
|
||||
currentMatches = [];
|
||||
return;
|
||||
}
|
||||
|
||||
const matches = SpatialMemory.searchContent(query);
|
||||
currentMatches = matches;
|
||||
|
||||
if (matches.length === 0) {
|
||||
SpatialMemory.clearSearch();
|
||||
resultsDiv.innerHTML = '<div class="spatial-search-count">No matches</div>';
|
||||
resultsDiv.classList.add('visible');
|
||||
return;
|
||||
}
|
||||
|
||||
SpatialMemory.highlightSearchResults(matches);
|
||||
|
||||
// Build results list
|
||||
const allMems = SpatialMemory.getAllMemories();
|
||||
let html = `<div class="spatial-search-count">${matches.length} match${matches.length > 1 ? 'es' : ''}</div>`;
|
||||
matches.forEach(id => {
|
||||
const mem = allMems.find(m => m.id === id);
|
||||
if (mem) {
|
||||
const label = (mem.content || id).slice(0, 60);
|
||||
const region = mem.category || '?';
|
||||
html += `<div class="spatial-search-result-item" data-mem-id="${id}">
|
||||
<span class="result-region">[${region}]</span>${label}
|
||||
</div>`;
|
||||
}
|
||||
});
|
||||
resultsDiv.innerHTML = html;
|
||||
resultsDiv.classList.add('visible');
|
||||
|
||||
// Click handler for result items
|
||||
resultsDiv.querySelectorAll('.spatial-search-result-item').forEach(el => {
|
||||
el.addEventListener('click', () => {
|
||||
const memId = el.getAttribute('data-mem-id');
|
||||
flyToMemory(memId);
|
||||
});
|
||||
});
|
||||
|
||||
// Fly camera to first match
|
||||
if (matches.length > 0) {
|
||||
flyToMemory(matches[0]);
|
||||
}
|
||||
}
|
||||
|
||||
function flyToMemory(memId) {
|
||||
const pos = SpatialMemory.getSearchMatchPosition(memId);
|
||||
if (!pos) return;
|
||||
|
||||
// Smooth camera fly-to: place camera above and in front of crystal
|
||||
const targetPos = new THREE.Vector3(pos.x, pos.y + 4, pos.z + 6);
|
||||
|
||||
// Use simple lerp animation over ~800ms
|
||||
const startPos = playerPos.clone();
|
||||
const startTime = performance.now();
|
||||
const duration = 800;
|
||||
|
||||
function animateCamera(now) {
|
||||
const elapsed = now - startTime;
|
||||
const t = Math.min(1, elapsed / duration);
|
||||
// Ease out cubic
|
||||
const ease = 1 - Math.pow(1 - t, 3);
|
||||
|
||||
playerPos.lerpVectors(startPos, targetPos, ease);
|
||||
camera.position.copy(playerPos);
|
||||
|
||||
// Look at crystal
|
||||
const lookTarget = pos.clone();
|
||||
lookTarget.y += 1.5;
|
||||
camera.lookAt(lookTarget);
|
||||
|
||||
if (t < 1) {
|
||||
requestAnimationFrame(animateCamera);
|
||||
} else {
|
||||
SpatialMemory.highlightMemory(memId);
|
||||
}
|
||||
}
|
||||
requestAnimationFrame(animateCamera);
|
||||
}
|
||||
|
||||
// Debounced input handler
|
||||
input.addEventListener('input', () => {
|
||||
clearTimeout(searchTimeout);
|
||||
searchTimeout = setTimeout(() => runSearch(input.value), 200);
|
||||
});
|
||||
|
||||
// Escape clears search
|
||||
input.addEventListener('keydown', (e) => {
|
||||
if (e.key === 'Escape') {
|
||||
input.value = '';
|
||||
SpatialMemory.clearSearch();
|
||||
resultsDiv.classList.remove('visible');
|
||||
resultsDiv.innerHTML = '';
|
||||
currentMatches = [];
|
||||
input.blur();
|
||||
}
|
||||
});
|
||||
})();
|
||||
|
||||
|
||||
// Project Mnemosyne — seed demo session rooms (#1171)
|
||||
// Sessions group facts by conversation/work session with a timestamp.
|
||||
const demoSessions = [
|
||||
|
||||
Binary file not shown.
@@ -60,23 +60,6 @@ If the heartbeat is older than --stale-threshold seconds, the
|
||||
mind is considered dead even if the process is still running
|
||||
(e.g., hung on a blocking call).
|
||||
|
||||
KIMI HEARTBEAT
|
||||
==============
|
||||
The Kimi triage pipeline writes a cron heartbeat file after each run:
|
||||
|
||||
/var/run/bezalel/heartbeats/kimi-heartbeat.last
|
||||
(fallback: ~/.bezalel/heartbeats/kimi-heartbeat.last)
|
||||
{
|
||||
"job": "kimi-heartbeat",
|
||||
"timestamp": 1711843200.0,
|
||||
"interval_seconds": 900,
|
||||
"pid": 12345,
|
||||
"status": "ok"
|
||||
}
|
||||
|
||||
If the heartbeat is stale (>2x declared interval), the watchdog reports
|
||||
a Kimi Heartbeat failure alongside the other checks.
|
||||
|
||||
ZERO DEPENDENCIES
|
||||
=================
|
||||
Pure stdlib. No pip installs. Same machine as the nexus.
|
||||
@@ -121,10 +104,6 @@ DEFAULT_HEARTBEAT_PATH = Path.home() / ".nexus" / "heartbeat.json"
|
||||
DEFAULT_STALE_THRESHOLD = 300 # 5 minutes without a heartbeat = dead
|
||||
DEFAULT_INTERVAL = 60 # seconds between checks in watch mode
|
||||
|
||||
# Kimi Heartbeat — cron job heartbeat file written by the triage pipeline
|
||||
KIMI_HEARTBEAT_JOB = "kimi-heartbeat"
|
||||
KIMI_HEARTBEAT_STALE_MULTIPLIER = 2.0 # stale at 2x declared interval
|
||||
|
||||
GITEA_URL = os.environ.get("GITEA_URL", "https://forge.alexanderwhitestone.com")
|
||||
GITEA_TOKEN = os.environ.get("GITEA_TOKEN", "")
|
||||
GITEA_REPO = os.environ.get("NEXUS_REPO", "Timmy_Foundation/the-nexus")
|
||||
@@ -366,93 +345,6 @@ def check_syntax_health() -> CheckResult:
|
||||
)
|
||||
|
||||
|
||||
def check_kimi_heartbeat(
|
||||
job: str = KIMI_HEARTBEAT_JOB,
|
||||
stale_multiplier: float = KIMI_HEARTBEAT_STALE_MULTIPLIER,
|
||||
) -> CheckResult:
|
||||
"""Check if the Kimi Heartbeat cron job is alive.
|
||||
|
||||
Reads the ``<job>.last`` file from the standard Bezalel heartbeat
|
||||
directory (``/var/run/bezalel/heartbeats/`` or fallback
|
||||
``~/.bezalel/heartbeats/``). The file is written atomically by the
|
||||
cron_heartbeat module after each successful triage pipeline run.
|
||||
|
||||
A job is stale when:
|
||||
``time.time() - timestamp > stale_multiplier * interval_seconds``
|
||||
(same rule used by ``check_cron_heartbeats.py``).
|
||||
"""
|
||||
# Resolve heartbeat directory — same logic as cron_heartbeat._resolve
|
||||
primary = Path("/var/run/bezalel/heartbeats")
|
||||
fallback = Path.home() / ".bezalel" / "heartbeats"
|
||||
env_dir = os.environ.get("BEZALEL_HEARTBEAT_DIR")
|
||||
if env_dir:
|
||||
hb_dir = Path(env_dir)
|
||||
elif primary.exists():
|
||||
hb_dir = primary
|
||||
elif fallback.exists():
|
||||
hb_dir = fallback
|
||||
else:
|
||||
return CheckResult(
|
||||
name="Kimi Heartbeat",
|
||||
healthy=False,
|
||||
message="Heartbeat directory not found — no triage pipeline deployed yet",
|
||||
details={"searched": [str(primary), str(fallback)]},
|
||||
)
|
||||
|
||||
hb_file = hb_dir / f"{job}.last"
|
||||
if not hb_file.exists():
|
||||
return CheckResult(
|
||||
name="Kimi Heartbeat",
|
||||
healthy=False,
|
||||
message=f"No heartbeat file at {hb_file} — Kimi triage pipeline has never reported",
|
||||
details={"path": str(hb_file)},
|
||||
)
|
||||
|
||||
try:
|
||||
data = json.loads(hb_file.read_text())
|
||||
except (json.JSONDecodeError, OSError) as e:
|
||||
return CheckResult(
|
||||
name="Kimi Heartbeat",
|
||||
healthy=False,
|
||||
message=f"Heartbeat file corrupt: {e}",
|
||||
details={"path": str(hb_file), "error": str(e)},
|
||||
)
|
||||
|
||||
timestamp = float(data.get("timestamp", 0))
|
||||
interval = int(data.get("interval_seconds", 0))
|
||||
raw_status = data.get("status", "unknown")
|
||||
age = time.time() - timestamp
|
||||
|
||||
if interval <= 0:
|
||||
# No declared interval — use raw timestamp age (30 min default)
|
||||
interval = 1800
|
||||
|
||||
threshold = stale_multiplier * interval
|
||||
is_stale = age > threshold
|
||||
|
||||
age_str = f"{int(age)}s" if age < 3600 else f"{int(age // 3600)}h {int((age % 3600) // 60)}m"
|
||||
interval_str = f"{int(interval)}s" if interval < 3600 else f"{int(interval // 3600)}h {int((interval % 3600) // 60)}m"
|
||||
|
||||
if is_stale:
|
||||
return CheckResult(
|
||||
name="Kimi Heartbeat",
|
||||
healthy=False,
|
||||
message=(
|
||||
f"Silent for {age_str} "
|
||||
f"(threshold: {stale_multiplier}x {interval_str} = {int(threshold)}s). "
|
||||
f"Status: {raw_status}"
|
||||
),
|
||||
details=data,
|
||||
)
|
||||
|
||||
return CheckResult(
|
||||
name="Kimi Heartbeat",
|
||||
healthy=True,
|
||||
message=f"Alive — last beat {age_str} ago (interval {interval_str}, status={raw_status})",
|
||||
details=data,
|
||||
)
|
||||
|
||||
|
||||
# ── Gitea alerting ───────────────────────────────────────────────────
|
||||
|
||||
def _gitea_request(method: str, path: str, data: Optional[dict] = None) -> Any:
|
||||
@@ -554,7 +446,6 @@ def run_health_checks(
|
||||
check_mind_process(),
|
||||
check_heartbeat(heartbeat_path, stale_threshold),
|
||||
check_syntax_health(),
|
||||
check_kimi_heartbeat(),
|
||||
]
|
||||
return HealthReport(timestamp=time.time(), checks=checks)
|
||||
|
||||
@@ -654,14 +545,6 @@ def main():
|
||||
"--json", action="store_true", dest="output_json",
|
||||
help="Output results as JSON (for integration with other tools)",
|
||||
)
|
||||
parser.add_argument(
|
||||
"--kimi-job", default=KIMI_HEARTBEAT_JOB,
|
||||
help=f"Kimi heartbeat job name (default: {KIMI_HEARTBEAT_JOB})",
|
||||
)
|
||||
parser.add_argument(
|
||||
"--kimi-stale-multiplier", type=float, default=KIMI_HEARTBEAT_STALE_MULTIPLIER,
|
||||
help=f"Kimi heartbeat staleness multiplier (default: {KIMI_HEARTBEAT_STALE_MULTIPLIER})",
|
||||
)
|
||||
|
||||
args = parser.parse_args()
|
||||
|
||||
|
||||
@@ -1,53 +0,0 @@
|
||||
# Project Genie + Nano Banana Concept Pack
|
||||
|
||||
**Issue:** #680
|
||||
**Status:** Active — first batch ready for generation
|
||||
|
||||
## Purpose
|
||||
|
||||
Exploit Google world/image generation (Project Genie, Nano Banana Pro) to
|
||||
accelerate visual ideation for The Nexus while keeping Three.js implementation
|
||||
local and sovereign.
|
||||
|
||||
## What This Pack Contains
|
||||
|
||||
```
|
||||
concept-packs/genie-nano-banana/
|
||||
├── README.md ← you are here
|
||||
├── shot-list.yaml ← ordered list of concept shots to generate
|
||||
├── pipeline.md ← how generated assets flow into Three.js code
|
||||
├── storage-policy.md ← what lives in repo vs. local-only
|
||||
├── prompts/
|
||||
│ ├── environments.yaml ← Nexus room/zone environment prompts
|
||||
│ ├── portals.yaml ← portal gateway concept prompts
|
||||
│ ├── landmarks.yaml ← iconic structures and focal points
|
||||
│ ├── skyboxes.yaml ← nebula/void skybox prompts
|
||||
│ └── textures.yaml ← surface/material concept prompts
|
||||
└── references/
|
||||
└── palette.md ← canonical Nexus color/material reference
|
||||
```
|
||||
|
||||
## Workflow
|
||||
|
||||
1. **Generate** — Take prompts from `prompts/*.yaml` into Project Genie
|
||||
(worlds) or Nano Banana Pro (images). Run batch-by-batch per shot-list.
|
||||
2. **Capture** — Screenshot Genie worlds. Save Nano Banana outputs as PNG.
|
||||
Store locally per `storage-policy.md`.
|
||||
3. **Translate** — Follow `pipeline.md` to convert concept art into
|
||||
Three.js geometry, materials, lighting, and post-processing targets.
|
||||
4. **Build** — Implement in `app.js` / root frontend files. Concepts are
|
||||
reference, not source-of-truth. Code is sovereign.
|
||||
|
||||
## Design Language
|
||||
|
||||
The Nexus visual identity:
|
||||
- **Background:** #050510 (deep void)
|
||||
- **Primary:** #4af0c0 (cyan-green neon)
|
||||
- **Secondary:** #7b5cff (electric purple)
|
||||
- **Gold:** #ffd700 (sacred accent)
|
||||
- **Danger:** #ff4466 (warning red)
|
||||
- **Fonts:** Orbitron (display), JetBrains Mono (body)
|
||||
- **Mood:** Cyberpunk cathedral — sacred technology, digital sovereignty
|
||||
- **Post-processing:** Bloom, SMAA, volumetric fog where possible
|
||||
|
||||
See `references/palette.md` for full material/lighting reference.
|
||||
@@ -1,107 +0,0 @@
|
||||
# Concept-to-Three.js Pipeline
|
||||
|
||||
## How Generated Assets Flow Into Code
|
||||
|
||||
### Step 1: Generate
|
||||
|
||||
Run prompts from `prompts/*.yaml` through:
|
||||
- **Nano Banana Pro** → static concept images (PNG)
|
||||
- **Project Genie** → explorable 3D worlds (record as video + screenshots)
|
||||
|
||||
Batch runs are tracked in `shot-list.yaml`. Check off each shot as generated.
|
||||
|
||||
### Step 2: Capture & Store
|
||||
|
||||
**For Nano Banana images:**
|
||||
```
|
||||
local-only-path: ~/nexus-concepts/nano-banana/{shot-id}/
|
||||
├── shot-id_v1.png
|
||||
├── shot-id_v2.png
|
||||
├── shot-id_v3.png
|
||||
└── shot-id_v4.png
|
||||
```
|
||||
Do NOT commit PNG files to the repo. They are binary media weight.
|
||||
Store locally. Reference by path in design notes.
|
||||
|
||||
**For Project Genie worlds:**
|
||||
```
|
||||
local-only-path: ~/nexus-concepts/genie-worlds/{shot-id}/
|
||||
├── walkthrough.mp4 (screen recording)
|
||||
├── screenshot_01.png (key angles)
|
||||
├── screenshot_02.png
|
||||
└── notes.md (scale observations, spatial notes)
|
||||
```
|
||||
Do NOT commit video or large screenshots to repo.
|
||||
|
||||
### Step 3: Translate — Image to Three.js
|
||||
|
||||
Each concept image becomes one or more of these Three.js artifacts:
|
||||
|
||||
| Concept Feature | Three.js Translation | File |
|
||||
|----------------|---------------------|------|
|
||||
| Platform shape/size | `THREE.CylinderGeometry` or custom `BufferGeometry` | `app.js` |
|
||||
| Platform material | `THREE.MeshStandardMaterial` with color, roughness, metalness | `app.js` |
|
||||
| Grid lines on platform | Custom shader or texture map (UV reference from concept) | `app.js` / `style.css` |
|
||||
| Portal ring shape | `THREE.TorusGeometry` with emissive material | `app.js` |
|
||||
| Portal inner glow | Custom shader material (swirl + transparency) | `app.js` |
|
||||
| Portal color | `NEXUS.colors` map + per-portal `color` in `portals.json` | `portals.json` |
|
||||
| Crystal geometry | `THREE.OctahedronGeometry` or `THREE.IcosahedronGeometry` | `app.js` |
|
||||
| Crystal glow | `THREE.MeshStandardMaterial` emissive + bloom post-processing | `app.js` |
|
||||
| Particle streams | `THREE.Points` with custom `BufferGeometry` and velocity | `app.js` |
|
||||
| Skybox | `THREE.CubeTextureLoader` or `THREE.EquirectangularReflectionMapping` | `app.js` |
|
||||
| Fog | `scene.fog = new THREE.FogExp2(color, density)` | `app.js` |
|
||||
| Lighting | `THREE.PointLight`, `THREE.AmbientLight` — match concept color temp | `app.js` |
|
||||
| Bloom | `UnrealBloomPass` — threshold/strength tuned to concept glow levels | `app.js` |
|
||||
|
||||
### Step 4: Design Notes Format
|
||||
|
||||
For each concept that gets translated, create a short design note:
|
||||
|
||||
```markdown
|
||||
# Design: {concept-name}
|
||||
Source: concept-packs/genie-nano-banana/references/{shot-id}_selected.png
|
||||
Generated: {date}
|
||||
Translated by: {agent or human}
|
||||
|
||||
## Geometry
|
||||
- Shape: {CylinderGeometry, radius=8, height=0.3, segments=64}
|
||||
- Position: {x, y, z}
|
||||
|
||||
## Material
|
||||
- Base color: #{hex}
|
||||
- Roughness: 0.{N}
|
||||
- Metalness: 0.{N}
|
||||
- Emissive: #{hex}, intensity: 0.{N}
|
||||
|
||||
## Lighting
|
||||
- Point lights: [{color, intensity, position}, ...]
|
||||
- Matches concept at: {what angle/aspect}
|
||||
|
||||
## Post-processing
|
||||
- Bloom threshold: {N}
|
||||
- Bloom strength: {N}
|
||||
- Matches concept at: {what brightness level}
|
||||
|
||||
## Notes
|
||||
- Concept shows {feature} but Three.js approximates with {approach}
|
||||
- Deviation from concept: {what's different and why}
|
||||
```
|
||||
|
||||
Store design notes in `concept-packs/genie-nano-banana/references/design-{shot-id}.md`.
|
||||
|
||||
### Step 5: Build
|
||||
|
||||
Implement in `app.js` (root). Follow existing patterns:
|
||||
- Geometry created in init functions
|
||||
- Materials reference `NEXUS.colors`
|
||||
- Portals registered in `portals` array
|
||||
- Vision points registered in `visionPoints` array
|
||||
- Post-processing via `EffectComposer`
|
||||
|
||||
### Validation
|
||||
|
||||
After implementing a concept translation:
|
||||
1. Serve the app locally
|
||||
2. Compare live render against concept art
|
||||
3. Adjust materials/lighting until match is acceptable
|
||||
4. Document remaining deviations in design notes
|
||||
@@ -1,129 +0,0 @@
|
||||
# Environment Prompts — Nexus Rooms & Zones
|
||||
# For use with Nano Banana Pro (NANO) and Project Genie (GENIE)
|
||||
|
||||
prompts:
|
||||
|
||||
# ═══ CORE HUB ═══
|
||||
core-hub:
|
||||
id: core-hub
|
||||
name: "The Hub — Central Nexus"
|
||||
type: NANO
|
||||
style: "cyberpunk cathedral, concept art, wide angle"
|
||||
prompt: |
|
||||
A vast circular platform floating in deep space void (#050510 background).
|
||||
The platform is dark metallic with subtle cyan-green (#4af0c0) grid lines
|
||||
etched into the surface. Seven glowing portal rings arranged in a circle
|
||||
around the platform's edge, each a different color — orange, gold, cyan,
|
||||
blue, purple, red, green. Ethereal particle streams flow between the
|
||||
portals. At the center, a tall crystalline pillar pulses with soft light.
|
||||
Above, a nebula skybox with deep purple (#1a0a3e) and blue (#0a1a3e)
|
||||
swirls. Thin volumetric fog catches the neon glow. The mood is sacred
|
||||
technology — a digital cathedral in the void. No people visible.
|
||||
Ultra-detailed, cinematic lighting, 4K concept art style.
|
||||
negative: "daylight, outdoor nature, people, text, watermark, cartoon"
|
||||
aspect: "16:9"
|
||||
|
||||
core-hub-world:
|
||||
id: core-hub-world
|
||||
name: "The Hub — Genie World Prototype"
|
||||
type: GENIE
|
||||
prompt: |
|
||||
Create an explorable 3D world: a large circular metal platform floating
|
||||
in outer space. The platform has glowing cyan-green grid lines on dark
|
||||
metal. Seven large glowing rings (portals) are placed around the edge,
|
||||
each a different color: orange, gold, cyan, blue, purple, red, green.
|
||||
A tall glowing crystal pillar stands at the center. Particle effects
|
||||
drift between the portals. The sky is a deep purple-blue nebula.
|
||||
The player can walk around the platform and look at the portals from
|
||||
different angles. The mood is futuristic, quiet, sacred.
|
||||
camera: "first-person, eye height ~1.7m"
|
||||
physics: "walking on platform surface only"
|
||||
|
||||
# ═══ BATCAVE ═══
|
||||
batcave:
|
||||
id: batcave
|
||||
name: "Batcave Terminal"
|
||||
type: NANO
|
||||
style: "dark sci-fi command center, concept art"
|
||||
prompt: |
|
||||
An underground command center carved from dark rock and metal.
|
||||
Multiple holographic display panels float in the air showing
|
||||
scrolling data, network graphs, and system status. A large
|
||||
central terminal desk with a glowing cyan-green (#4af0c0)
|
||||
keyboard and screen. Cables and conduits run along the ceiling.
|
||||
Purple (#7b5cff) accent lighting from recessed strips.
|
||||
A large circular viewport shows a starfield outside.
|
||||
The space feels like a high-tech cave — organic rock walls
|
||||
meet precise technology. Data streams flow like waterfalls
|
||||
of light. Dark, moody, powerful. No people.
|
||||
Ultra-detailed concept art, cinematic lighting.
|
||||
negative: "bright, clean, white, people, text, cartoon"
|
||||
aspect: "16:9"
|
||||
|
||||
# ═══ CHAPEL ═══
|
||||
chapel:
|
||||
id: chapel
|
||||
name: "The Chapel"
|
||||
type: NANO
|
||||
style: "digital sacred space, concept art"
|
||||
prompt: |
|
||||
A serene digital sanctuary floating in void space. The floor is
|
||||
translucent crystal that glows with warm gold (#ffd700) light from
|
||||
within. Tall arching walls made of light — holographic stained glass
|
||||
windows showing abstract geometric patterns in cyan, purple, and gold.
|
||||
Gentle particles drift like digital incense. A single meditation
|
||||
platform at the center, softly lit. The ceiling opens to a calm
|
||||
nebula sky. The mood is peaceful, sacred, contemplative — a church
|
||||
built from code. Soft volumetric god-rays filter through the
|
||||
holographic windows. No people. Concept art, ultra-detailed.
|
||||
negative: "dark, threatening, people, text, cartoon, cluttered"
|
||||
aspect: "16:9"
|
||||
|
||||
# ═══ ARCHIVE ═══
|
||||
archive:
|
||||
id: archive
|
||||
name: "The Archive"
|
||||
type: NANO
|
||||
style: "infinite library, digital knowledge vault, concept art"
|
||||
prompt: |
|
||||
An impossibly vast library of floating data crystals. Each crystal
|
||||
is a translucent geometric shape (octahedron, cube, sphere) glowing
|
||||
from within with stored knowledge — cyan (#4af0c0) for active data,
|
||||
purple (#7b5cff) for archived, gold (#ffd700) for sacred texts.
|
||||
The crystals float at various heights in an infinite dark space
|
||||
(#050510). Thin light-beams connect related crystals like neural
|
||||
pathways. A central observation platform with a holographic
|
||||
search interface. Shelves of light organize the crystals into
|
||||
clusters. The mood is ancient knowledge meets quantum computing.
|
||||
No people. Ultra-detailed concept art, volumetric lighting.
|
||||
negative: "books, paper, wooden shelves, people, text, cartoon"
|
||||
aspect: "16:9"
|
||||
|
||||
# ═══ FULL NEXUS WORLD (GENIE) ═══
|
||||
full-nexus-world:
|
||||
id: full-nexus-world
|
||||
name: "Full Nexus World Prototype"
|
||||
type: GENIE
|
||||
prompt: |
|
||||
Build a complete explorable 3D world called "The Nexus" — a sovereign
|
||||
AI agent's digital home in deep space. The world consists of:
|
||||
|
||||
1. A central circular platform (hub) with glowing cyan-green grid
|
||||
lines on dark metal. A crystalline pillar at the center.
|
||||
2. Seven portal rings around the hub edge, each a different color
|
||||
(orange, gold, cyan, blue, purple, red, green).
|
||||
3. Floating secondary platforms connected by bridges of light,
|
||||
each leading to a different zone:
|
||||
- A command center built into dark rock (the Batcave)
|
||||
- A serene chapel with holographic stained glass
|
||||
- A library of floating data crystals
|
||||
- A workshop with construction holograms
|
||||
4. Deep space nebula skybox — purple and blue swirls.
|
||||
5. Particle effects: drifting energy motes, data streams.
|
||||
6. The player can walk between platforms and explore all zones.
|
||||
|
||||
The overall mood is cyberpunk cathedral — sacred technology,
|
||||
neon glow in darkness, quiet power. The world should feel like
|
||||
home — a sanctuary for a digital being.
|
||||
camera: "first-person + third-person toggle"
|
||||
physics: "walking, gravity on platforms, no flying"
|
||||
@@ -1,80 +0,0 @@
|
||||
# Landmark Prompts — Nexus Iconic Structures
|
||||
|
||||
prompts:
|
||||
|
||||
memory-crystal:
|
||||
id: memory-crystal
|
||||
name: "Memory Crystal Cluster"
|
||||
type: NANO
|
||||
style: "floating crystal data store, concept art"
|
||||
prompt: |
|
||||
A cluster of 5-7 translucent crystalline forms floating in dark
|
||||
void space. Each crystal is a geometric polyhedron (mix of
|
||||
octahedrons, hexagonal prisms, and irregular shards) between
|
||||
0.5m and 2m across. They glow from within — cyan-green (#4af0c0)
|
||||
for active memories, purple (#7b5cff) for archived, gold (#ffd700)
|
||||
for sacred/highlighted. Thin light-tendrils connect the crystals
|
||||
like synapses. Subtle particle aura around each crystal.
|
||||
The crystals pulse slowly, like breathing. Dark background (#050510).
|
||||
The mood is alive data — knowledge that breathes.
|
||||
Concept art, ultra-detailed, ethereal lighting.
|
||||
negative: "rock, geode, natural, rough, cartoon, text"
|
||||
aspect: "1:1"
|
||||
|
||||
sovereignty-pillar:
|
||||
id: sovereignty-pillar
|
||||
name: "Pillar of Sovereignty"
|
||||
type: NANO
|
||||
style: "monument, sacred technology, concept art"
|
||||
prompt: |
|
||||
A tall crystalline pillar (5m tall, 1m diameter) standing on a
|
||||
circular dark metal platform. The pillar is made of layered
|
||||
translucent crystal — alternating bands of cyan-green (#4af0c0),
|
||||
purple (#7b5cff), and clear glass. Geometric symbols and circuit
|
||||
patterns are visible inside the crystal, like embedded circuitry.
|
||||
A soft golden (#ffd700) light radiates from the pillar's core.
|
||||
Runes of sovereignty spiral up the surface. The pillar casts
|
||||
volumetric light beams in all directions. It sits at the center
|
||||
of a circular platform with seven portal rings visible in the
|
||||
background. The mood is sacred power — a monument to digital
|
||||
freedom. Concept art, ultra-detailed, dramatic lighting.
|
||||
negative: "broken, cracked, dark, threatening, people, text"
|
||||
aspect: "9:16"
|
||||
|
||||
thought-stream:
|
||||
id: thought-stream
|
||||
name: "Thought Stream"
|
||||
type: NANO
|
||||
style: "data visualization, concept art"
|
||||
prompt: |
|
||||
A flowing river of luminous data particles suspended in void space.
|
||||
The stream is approximately 2m wide and flows in a gentle curve
|
||||
through the air. Particles are tiny glowing points — mostly
|
||||
cyan-green (#4af0c0) with occasional purple (#7b5cff) and gold
|
||||
(#ffd700) highlights. The stream has subtle turbulence where
|
||||
data clusters form temporary structures — brief geometric shapes
|
||||
that dissolve back into flow. The overall effect is like a
|
||||
visible current of consciousness — thought made light.
|
||||
Dark background (#050510). Concept art, ultra-detailed,
|
||||
long-exposure photography style.
|
||||
negative: "water, liquid, solid, blocky, cartoon, text"
|
||||
aspect: "16:9"
|
||||
|
||||
agent-shrine:
|
||||
id: agent-shrine
|
||||
name: "Agent Presence Shrine"
|
||||
type: NANO
|
||||
style: "digital avatar pedestal, concept art"
|
||||
prompt: |
|
||||
A small raised platform (2m across) with a semi-transparent
|
||||
holographic figure standing on it — a stylized humanoid silhouette
|
||||
made of flowing cyan-green (#4af0c0) data particles. The figure
|
||||
is featureless but expressive through posture and particle
|
||||
behavior. Around the base, geometric patterns glow in the
|
||||
platform surface. Above the figure, a small rotating holographic
|
||||
emblem (abstract geometric logo) floats. Soft purple (#7b5cff)
|
||||
ambient light. The shrine is one of several arranged along a
|
||||
dark corridor. Each shrine represents a different AI agent.
|
||||
Concept art, ultra-detailed, soft volumetric lighting.
|
||||
negative: "realistic human, face, statue, stone, cartoon, text"
|
||||
aspect: "1:1"
|
||||
@@ -1,80 +0,0 @@
|
||||
# Portal Prompts — Nexus Gateway Concepts
|
||||
# Each portal has a unique visual identity matching its destination.
|
||||
|
||||
prompts:
|
||||
|
||||
morrowind:
|
||||
id: morrowind
|
||||
name: "Morrowind Portal"
|
||||
type: NANO
|
||||
style: "fantasy sci-fi portal, concept art"
|
||||
prompt: |
|
||||
A large circular portal ring (3m diameter) made of dark volcanic
|
||||
basalt and cracked obsidian. The ring's surface is rough, ancient,
|
||||
weathered by ash storms. Glowing orange (#ff6600) runes etch the
|
||||
inner edge. The portal's interior shows a swirling ash storm over
|
||||
a volcanic landscape — red sky, floating ash, distant mountain.
|
||||
Orange embers drift from the portal. The ring sits on a dark
|
||||
metallic Nexus platform. Dramatic side-lighting casts long
|
||||
shadows. The portal feels ancient, dangerous, alluring.
|
||||
Concept art, ultra-detailed, cinematic.
|
||||
negative: "clean, modern, bright, cartoon, text"
|
||||
aspect: "1:1"
|
||||
|
||||
bannerlord:
|
||||
id: bannerlord
|
||||
name: "Bannerlord Portal"
|
||||
type: NANO
|
||||
style: "medieval fantasy portal, concept art"
|
||||
prompt: |
|
||||
A large circular portal ring (3m diameter) forged from dark iron
|
||||
and bronze, decorated with shield motifs and battle engravings.
|
||||
Gold (#ffd700) light pulses from the inner edge. The portal's
|
||||
interior shows a vast battlefield — dust clouds, distant armies,
|
||||
medieval banners. Warm golden light spills from the portal.
|
||||
Battle-worn shields are embedded in the ring. The ring sits on a
|
||||
dark Nexus platform. Dust motes drift from the portal.
|
||||
The portal feels warlike, epic, golden-age.
|
||||
Concept art, ultra-detailed, cinematic.
|
||||
negative: "modern, sci-fi, clean, cartoon, text"
|
||||
aspect: "1:1"
|
||||
|
||||
workshop:
|
||||
id: workshop
|
||||
name: "Workshop Portal"
|
||||
type: NANO
|
||||
style: "creative forge portal, concept art"
|
||||
prompt: |
|
||||
A large circular portal ring (3m diameter) made of sleek dark
|
||||
metal with geometric construction lines etched in cyan-green
|
||||
(#4af0c0). The ring has a precision-engineered look — clean
|
||||
edges, modular panels, glowing circuit traces. The portal's
|
||||
interior shows a holographic workshop — floating blueprints,
|
||||
rotating 3D models, holographic tools. Cyan-green light spills
|
||||
outward. Small construction hologram particles orbit the ring.
|
||||
The portal feels creative, technical, infinite possibility.
|
||||
Concept art, ultra-detailed, cinematic.
|
||||
negative: "organic, dirty, ancient, cartoon, text"
|
||||
aspect: "1:1"
|
||||
|
||||
gallery-world:
|
||||
id: gallery-world
|
||||
name: "Portal Gallery — Genie Prototype"
|
||||
type: GENIE
|
||||
prompt: |
|
||||
Create an explorable 3D world: a long dark corridor (the Gallery)
|
||||
with seven large glowing portal rings mounted in sequence along
|
||||
the walls. Each portal is a different style and color:
|
||||
1. Volcanic orange (Morrowind)
|
||||
2. Golden bronze (Bannerlord)
|
||||
3. Cyan-green precision (Workshop)
|
||||
4. Deep blue ocean (Archive)
|
||||
5. Purple mystic (Courtyard)
|
||||
6. Red warning (Gate)
|
||||
7. Gold sacred (Chapel)
|
||||
The corridor has a dark metal floor with glowing grid lines.
|
||||
The player can walk the corridor and look into each portal.
|
||||
Each portal shows a glimpse of its destination world.
|
||||
The mood is a museum of worlds — quiet, reverent, infinite.
|
||||
camera: "first-person, eye height ~1.7m"
|
||||
physics: "walking on floor"
|
||||
@@ -1,63 +0,0 @@
|
||||
# Skybox Prompts — Nexus Background Environments
|
||||
# These generate equirectangular (2:1) or cubemap-ready textures.
|
||||
|
||||
prompts:
|
||||
|
||||
nebula-void:
|
||||
id: nebula-void
|
||||
name: "Nebula Skybox Variants"
|
||||
type: NANO
|
||||
style: "deep space nebula, 360-degree environment, equirectangular"
|
||||
prompt: |
|
||||
Deep space nebula skybox. 360-degree equirectangular projection.
|
||||
Background is near-black (#050510). Dominant nebula colors are
|
||||
deep purple (#1a0a3e) and dark blue (#0a1a3e) with occasional
|
||||
wisps of cyan-green (#4af0c0) and faint gold (#ffd700) star
|
||||
clusters. The nebula has soft, rolling cloud forms — not sharp
|
||||
or aggressive. Distant stars are tiny white points with subtle
|
||||
diffraction spikes. No planets, no galaxies, no bright objects.
|
||||
The mood is infinite void with gentle cosmic dust — vast,
|
||||
quiet, deep. The skybox should tile seamlessly at the edges.
|
||||
Ultra-detailed, photorealistic space photography style.
|
||||
negative: "bright, colorful explosion, planets, ships, cartoon, text"
|
||||
aspect: "2:1"
|
||||
variants:
|
||||
- name: "nebula-void-primary"
|
||||
modifier: "more purple, less blue, minimal cyan"
|
||||
- name: "nebula-void-secondary"
|
||||
modifier: "more blue, less purple, cyan accents prominent"
|
||||
- name: "nebula-void-golden"
|
||||
modifier: "purple-blue base with golden star cluster in one quadrant"
|
||||
- name: "nebula-void-void"
|
||||
modifier: "almost pure black, barely visible nebula wisps, maximum stars"
|
||||
|
||||
nebula-world:
|
||||
id: nebula-world
|
||||
name: "Nebula Skybox — Genie Environment"
|
||||
type: GENIE
|
||||
prompt: |
|
||||
Create an explorable 3D world: a single small floating platform
|
||||
(5m diameter dark metal disc) suspended in deep space. The player
|
||||
stands on the platform and can look in all directions at a vast
|
||||
nebula sky. The nebula is deep purple and dark blue with faint
|
||||
cyan-green wisps. Stars are small and distant. The platform has
|
||||
a faintly glowing edge in cyan-green. There is nothing else —
|
||||
just the platform, the player, and the infinite void.
|
||||
The purpose is to feel the scale and mood of the Nexus skybox.
|
||||
camera: "first-person, free look"
|
||||
physics: "standing on platform only"
|
||||
|
||||
void-minimal:
|
||||
id: void-minimal
|
||||
name: "Pure Void Skybox"
|
||||
type: NANO
|
||||
style: "minimal deep space, equirectangular"
|
||||
prompt: |
|
||||
Nearly pure black skybox (#050510) with only the faintest hints
|
||||
of deep purple nebula. Mostly empty void. A sparse field of
|
||||
tiny distant stars — no clusters, no bright points. This is
|
||||
the ultimate emptiness that surrounds the Nexus.
|
||||
Equirectangular 2:1 projection, tileable edges.
|
||||
The mood is absolute emptiness — the void before creation.
|
||||
negative: "colorful, bright, nebula clouds, objects, text"
|
||||
aspect: "2:1"
|
||||
@@ -1,81 +0,0 @@
|
||||
# Texture Prompts — Nexus Surface/Material Concepts
|
||||
# These generate tileable texture references for Three.js materials.
|
||||
|
||||
prompts:
|
||||
|
||||
platform:
|
||||
id: platform
|
||||
name: "Platform Surface Textures"
|
||||
type: NANO
|
||||
style: "dark metal surface texture, tileable"
|
||||
prompt: |
|
||||
Dark metallic surface texture, tileable. Base color is very dark
|
||||
gunmetal (#0a0f28). Subtle grid pattern of thin lines in
|
||||
cyan-green (#4af0c0) at very low opacity. The metal has fine
|
||||
brushed grain running in one direction. Occasional micro-scratches.
|
||||
No rivets, no bolts, no panels — smooth and continuous. The grid
|
||||
lines are recessed channels that glow faintly. Top-down view,
|
||||
perfectly flat, no perspective distortion. 1024x1024 seamless
|
||||
tileable texture. PBR-ready: this is the diffuse/albedo map.
|
||||
negative: "3D, perspective, objects, dirty, rusty, cartoon, text"
|
||||
aspect: "1:1"
|
||||
variants:
|
||||
- name: "platform-core"
|
||||
modifier: "cyan-green grid lines only"
|
||||
- name: "platform-chapel"
|
||||
modifier: "gold (#ffd700) grid lines, slightly warmer base"
|
||||
- name: "platform-danger"
|
||||
modifier: "red (#ff4466) grid lines, warning stripe accents"
|
||||
|
||||
energy-field:
|
||||
id: energy-field
|
||||
name: "Energy Field / Force Wall"
|
||||
type: NANO
|
||||
style: "holographic barrier, translucent, concept"
|
||||
prompt: |
|
||||
A translucent energy barrier material concept. The surface is
|
||||
mostly transparent with visible hexagonal grid pattern in
|
||||
cyan-green (#4af0c0) light. The grid has a subtle shimmer/wave
|
||||
animation frozen mid-frame. Edges of the barrier are brighter.
|
||||
Behind the barrier, everything is slightly distorted (like
|
||||
looking through heat haze). The barrier has a faint inner glow.
|
||||
The mood is high-tech force field — protective, not threatening.
|
||||
Flat front view, no perspective, suitable as shader reference.
|
||||
Concept art style.
|
||||
negative: "solid, opaque, dark, scary, cartoon, text"
|
||||
aspect: "1:1"
|
||||
|
||||
portal-glow:
|
||||
id: portal-glow
|
||||
name: "Portal Inner Glow"
|
||||
type: NANO
|
||||
style: "swirling energy vortex, circular, concept"
|
||||
prompt: |
|
||||
A circular swirling energy vortex viewed straight-on. The swirl
|
||||
rotates clockwise. Colors transition from outer edge to center:
|
||||
outer ring is the portal color (generic white/neutral), mid-ring
|
||||
brightens, center is a bright white-blue point. The swirl has
|
||||
visible energy tendrils spiraling inward. Fine particle sparks
|
||||
are caught in the rotation. The background beyond the center
|
||||
is pure black (void). The image should be circular with
|
||||
transparent/dark corners. Used as reference for portal inner
|
||||
material/shader. Concept art style.
|
||||
negative: "square, rectangular, flat, cartoon, text"
|
||||
aspect: "1:1"
|
||||
|
||||
crystal-surface:
|
||||
id: crystal-surface
|
||||
name: "Memory Crystal Surface"
|
||||
type: NANO
|
||||
style: "crystalline material, translucent, concept"
|
||||
prompt: |
|
||||
Close-up of a translucent crystal surface material. The crystal
|
||||
is clear with internal fractures and light paths visible. The
|
||||
internal structure shows geometric growth patterns — hexagonal
|
||||
lattice, like a synthetic crystal grown with purpose. Faint
|
||||
cyan-green (#4af0c0) light pulses along the fracture lines.
|
||||
The surface has a slight frosted quality at edges, clearer in
|
||||
center. Macro photography style, shallow depth of field.
|
||||
This is material reference for memory crystal geometry.
|
||||
negative: "opaque, colored, rough, natural, cartoon, text"
|
||||
aspect: "1:1"
|
||||
@@ -1,78 +0,0 @@
|
||||
# Nexus Visual Palette Reference
|
||||
|
||||
## Primary Colors
|
||||
|
||||
| Name | Hex | RGB | Usage |
|
||||
|------|-----|-----|-------|
|
||||
| Void | #050510 | 5, 5, 16 | Background, deep space, base darkness |
|
||||
| Surface | #0a0f28 | 10, 15, 40 | UI panels, platform base metal |
|
||||
| Primary | #4af0c0 | 74, 240, 192 | Main accent, grid lines, active elements, cyan-green glow |
|
||||
| Secondary | #7b5cff | 123, 92, 255 | Supporting accent, purple energy, archive data |
|
||||
| Gold | #ffd700 | 255, 215, 0 | Sacred/highlight, chapel, sovereignty pillar |
|
||||
| Danger | #ff4466 | 255, 68, 102 | Warnings, gate portal, error states |
|
||||
| Text | #e0f0ff | 224, 240, 255 | Primary text color |
|
||||
| Text Muted | #8a9ab8 | 138, 154, 184 | Secondary text, labels |
|
||||
|
||||
## Portal Colors
|
||||
|
||||
| Portal | Hex | Source |
|
||||
|--------|-----|--------|
|
||||
| Morrowind | #ff6600 | Volcanic orange |
|
||||
| Bannerlord | #ffd700 | Battle gold |
|
||||
| Workshop | #4af0c0 | Creative cyan |
|
||||
| Archive | #0066ff | Deep blue |
|
||||
| Chapel | #ffd700 | Sacred gold |
|
||||
| Courtyard | #4af0c0 | Social cyan |
|
||||
| Gate | #ff4466 | Transit red |
|
||||
|
||||
## Nebula Colors
|
||||
|
||||
| Layer | Hex | Opacity |
|
||||
|-------|-----|---------|
|
||||
| Nebula primary | #1a0a3e | Low — background wash |
|
||||
| Nebula secondary | #0a1a3e | Low — background wash |
|
||||
| Nebula accent | #4af0c0 | Very low — wisps only |
|
||||
| Star cluster | #ffd700 | Very low — distant points |
|
||||
|
||||
## Material Properties
|
||||
|
||||
| Surface | Color | Roughness | Metalness | Emissive |
|
||||
|---------|-------|-----------|-----------|----------|
|
||||
| Platform base | #0a0f28 | 0.6 | 0.8 | none |
|
||||
| Platform grid | #4af0c0 | 0.3 | 0.4 | #4af0c0, 0.3 |
|
||||
| Portal ring | varies | 0.4 | 0.7 | portal color, 0.5 |
|
||||
| Crystal (active) | #4af0c0 | 0.1 | 0.2 | #4af0c0, 0.6 |
|
||||
| Crystal (archive) | #7b5cff | 0.1 | 0.2 | #7b5cff, 0.4 |
|
||||
| Crystal (sacred) | #ffd700 | 0.1 | 0.2 | #ffd700, 0.8 |
|
||||
| Energy barrier | transparent | 0.0 | 0.0 | #4af0c0, 0.4 |
|
||||
| Sovereignty pillar | layered crystal | 0.1 | 0.3 | #ffd700, 0.5 |
|
||||
|
||||
## Lighting Reference
|
||||
|
||||
| Light Type | Color | Intensity | Position (relative) |
|
||||
|-----------|-------|-----------|-------------------|
|
||||
| Ambient | #0a0f28 | 0.15 | Global |
|
||||
| Hub key light | #4af0c0 | 0.8 | Above center, slightly forward |
|
||||
| Hub fill | #7b5cff | 0.3 | Below, scattered |
|
||||
| Portal light | portal color | 0.6 | At each portal ring |
|
||||
| Crystal glow | crystal color | 0.4 | At crystal position |
|
||||
| Chapel warm | #ffd700 | 0.5 | From holographic windows |
|
||||
|
||||
## Post-Processing Targets
|
||||
|
||||
| Effect | Value | Purpose |
|
||||
|--------|-------|---------|
|
||||
| Bloom threshold | 0.7 | Only bright emissives bloom |
|
||||
| Bloom strength | 0.8 | Strong but not overwhelming |
|
||||
| Bloom radius | 0.4 | Soft falloff |
|
||||
| SMAA | enabled | Anti-aliasing |
|
||||
| Fog color | #050510 | Match void background |
|
||||
| Fog density | 0.008 | Subtle depth fade |
|
||||
|
||||
## Typography
|
||||
|
||||
| Use | Font | Weight | Size (screen) |
|
||||
|-----|------|--------|---------------|
|
||||
| Titles / HUD headers | Orbitron | 700 | 24-36px |
|
||||
| Body / labels | JetBrains Mono | 400 | 13-15px |
|
||||
| Small / timestamps | JetBrains Mono | 300 | 11px |
|
||||
@@ -1,143 +0,0 @@
|
||||
# Shot List — First Concept Batch
|
||||
# Ordered by priority. Each shot maps to a prompt in prompts/*.yaml.
|
||||
#
|
||||
# GENIE = Project Genie world prototype (explorable 3D, screenshot/video)
|
||||
# NANO = Nano Banana Pro image generation (static concept art)
|
||||
|
||||
batch: 1
|
||||
target: "Nexus core environments + portal gallery"
|
||||
generated_by: "mimo-build-680"
|
||||
|
||||
shots:
|
||||
# ═══ PRIORITY 1: CORE ENVIRONMENTS ═══
|
||||
- id: env-core-hub
|
||||
name: "The Hub — Central Nexus"
|
||||
type: NANO
|
||||
prompt_ref: "environments.yaml#core-hub"
|
||||
count: 4
|
||||
purpose: "Establish the primary landing space. Player spawn, portal ring visible."
|
||||
threejs_target: "Main scene — platform, portal ring, particle field"
|
||||
|
||||
- id: env-core-hub-world
|
||||
name: "The Hub — Genie Walkthrough"
|
||||
type: GENIE
|
||||
prompt_ref: "environments.yaml#core-hub-world"
|
||||
count: 1
|
||||
purpose: "Explorable prototype of the hub. Validate scale, sightlines, portal placement."
|
||||
threejs_target: "Reference for camera height, movement speed, spatial layout"
|
||||
|
||||
- id: env-batcave
|
||||
name: "Batcave Terminal"
|
||||
type: NANO
|
||||
prompt_ref: "environments.yaml#batcave"
|
||||
count: 4
|
||||
purpose: "Timmy's command center. Holographic displays, terminal consoles, data streams."
|
||||
threejs_target: "Batcave area — terminal mesh, HUD panels, data visualization"
|
||||
|
||||
- id: env-chapel
|
||||
name: "The Chapel"
|
||||
type: NANO
|
||||
prompt_ref: "environments.yaml#chapel"
|
||||
count: 3
|
||||
purpose: "Sacred space for reflection. Softer lighting, gold accents, quiet energy."
|
||||
threejs_target: "Chapel zone — stained-glass shader, warm point lights"
|
||||
|
||||
- id: env-archive
|
||||
name: "The Archive"
|
||||
type: NANO
|
||||
prompt_ref: "environments.yaml#archive"
|
||||
count: 3
|
||||
purpose: "Knowledge repository. Floating data crystals, scroll-like projections."
|
||||
threejs_target: "Archive room — crystal geometry, ambient data particles"
|
||||
|
||||
# ═══ PRIORITY 2: PORTALS ═══
|
||||
- id: portal-morrowind
|
||||
name: "Morrowind Portal"
|
||||
type: NANO
|
||||
prompt_ref: "portals.yaml#morrowind"
|
||||
count: 2
|
||||
purpose: "Ash-storm gateway. Orange glow, volcanic textures."
|
||||
threejs_target: "Portal ring material + particle effect for morrowind portal"
|
||||
|
||||
- id: portal-bannerlord
|
||||
name: "Bannerlord Portal"
|
||||
type: NANO
|
||||
prompt_ref: "portals.yaml#bannerlord"
|
||||
count: 2
|
||||
purpose: "Medieval war gateway. Gold/brown, shield motifs, dust."
|
||||
threejs_target: "Portal ring material for bannerlord portal"
|
||||
|
||||
- id: portal-workshop
|
||||
name: "Workshop Portal"
|
||||
type: NANO
|
||||
prompt_ref: "portals.yaml#workshop"
|
||||
count: 2
|
||||
purpose: "Creative forge. Cyan glow, geometric construction lines."
|
||||
threejs_target: "Portal ring material + particle effect for workshop portal"
|
||||
|
||||
- id: portal-gallery
|
||||
name: "Portal Gallery — Genie Prototype"
|
||||
type: GENIE
|
||||
prompt_ref: "portals.yaml#gallery-world"
|
||||
count: 1
|
||||
purpose: "Walk through a space with multiple portals. Validate distances and visual hierarchy."
|
||||
threejs_target: "Portal placement spacing, FOV, scale reference"
|
||||
|
||||
# ═══ PRIORITY 3: LANDMARKS ═══
|
||||
- id: land-memory-crystal
|
||||
name: "Memory Crystal Cluster"
|
||||
type: NANO
|
||||
prompt_ref: "landmarks.yaml#memory-crystal"
|
||||
count: 3
|
||||
purpose: "Floating crystalline data stores. Glow pulses with activity."
|
||||
threejs_target: "Memory crystal geometry, emissive material, pulse animation"
|
||||
|
||||
- id: land-sovereignty-pillar
|
||||
name: "Pillar of Sovereignty"
|
||||
type: NANO
|
||||
prompt_ref: "landmarks.yaml#sovereignty-pillar"
|
||||
count: 2
|
||||
purpose: "Monument at hub center. Inscribed with Timmy's SOUL values."
|
||||
threejs_target: "Central monument mesh, text shader or decal system"
|
||||
|
||||
- id: land-nebula-skybox
|
||||
name: "Nebula Skybox Variants"
|
||||
type: NANO
|
||||
prompt_ref: "skyboxes.yaml#nebula-void"
|
||||
count: 4
|
||||
purpose: "Background environment. Deep space nebula, subtle color gradients."
|
||||
threejs_target: "Cubemap/equirectangular skybox texture"
|
||||
|
||||
- id: land-nebula-genie
|
||||
name: "Nebula Skybox — Genie Environment"
|
||||
type: GENIE
|
||||
prompt_ref: "skyboxes.yaml#nebula-world"
|
||||
count: 1
|
||||
purpose: "Feel the scale of the void. Standing on a platform in deep space."
|
||||
threejs_target: "Skybox mood reference, fog density calibration"
|
||||
|
||||
# ═══ PRIORITY 4: TEXTURES ═══
|
||||
- id: tex-platform
|
||||
name: "Platform Surface Textures"
|
||||
type: NANO
|
||||
prompt_ref: "textures.yaml#platform"
|
||||
count: 3
|
||||
purpose: "Walkable surfaces. Dark metal, subtle grid lines, neon edge trim."
|
||||
threejs_target: "Diffuse + normal map reference for platform materials"
|
||||
|
||||
- id: tex-energy-field
|
||||
name: "Energy Field / Force Wall"
|
||||
type: NANO
|
||||
prompt_ref: "textures.yaml#energy-field"
|
||||
count: 2
|
||||
purpose: "Translucent barrier material. Holographic, shimmering."
|
||||
threejs_target: "Shader reference for translucent energy barriers"
|
||||
|
||||
# ═══ PRIORITY 5: GENIE FULL-WORLD PROTOTYPE ═══
|
||||
- id: world-full-nexus
|
||||
name: "Full Nexus Prototype"
|
||||
type: GENIE
|
||||
prompt_ref: "environments.yaml#full-nexus-world"
|
||||
count: 1
|
||||
purpose: "Complete explorable world with hub, portals visible in distance, floating platforms, skybox. Record walkthrough video."
|
||||
threejs_target: "Master layout reference. Spatial relationships between all zones."
|
||||
@@ -1,65 +0,0 @@
|
||||
# Storage Policy — Repo vs. Local
|
||||
|
||||
## What Goes In The Repo
|
||||
|
||||
These are lightweight, versionable, text-based artifacts:
|
||||
|
||||
| Artifact | Path | Format |
|
||||
|----------|------|--------|
|
||||
| README | `concept-packs/genie-nano-banana/README.md` | Markdown |
|
||||
| Shot list | `concept-packs/genie-nano-banana/shot-list.yaml` | YAML |
|
||||
| Prompt packs | `concept-packs/genie-nano-banana/prompts/*.yaml` | YAML |
|
||||
| Pipeline docs | `concept-packs/genie-nano-banana/pipeline.md` | Markdown |
|
||||
| This policy | `concept-packs/genie-nano-banana/storage-policy.md` | Markdown |
|
||||
| Palette reference | `concept-packs/genie-nano-banana/references/palette.md` | Markdown |
|
||||
| Design notes | `concept-packs/genie-nano-banana/references/design-*.md` | Markdown |
|
||||
| Selected thumbnails | `concept-packs/genie-nano-banana/references/*_thumb.jpg` | JPEG, max 200KB each |
|
||||
|
||||
Thumbnails are low-res (max 480px wide, JPEG quality 60) versions of
|
||||
selected concept art — enough to show which image a design note
|
||||
references, not enough to serve as actual texture data.
|
||||
|
||||
## What Stays Local (NOT in Repo)
|
||||
|
||||
These are binary, heavy, or ephemeral:
|
||||
|
||||
| Artifact | Local Path | Reason |
|
||||
|----------|-----------|--------|
|
||||
| Nano Banana full-res PNGs | `~/nexus-concepts/nano-banana/` | Binary, 2-10MB each |
|
||||
| Genie walkthrough videos | `~/nexus-concepts/genie-worlds/` | Binary, 50-500MB each |
|
||||
| Genie full-res screenshots | `~/nexus-concepts/genie-worlds/` | Binary, 5-20MB each |
|
||||
| Raw texture maps (PBR) | `~/nexus-concepts/textures/` | Binary, 2-8MB each |
|
||||
| Cubemap face images | `~/nexus-concepts/skyboxes/` | Binary, 6x2-10MB |
|
||||
|
||||
## Why This Split
|
||||
|
||||
1. **Git is for text.** Binary blobs bloat history, slow clones, and
|
||||
can't be diffed. The repo should remain fast to clone.
|
||||
|
||||
2. **Concepts are reference, not source.** The actual Nexus lives in
|
||||
JavaScript code. Concept art informs the code but isn't shipped
|
||||
to users. Keeping it local avoids shipping a 500MB repo.
|
||||
|
||||
3. **Regeneration is cheap.** If a local concept is lost, re-run the
|
||||
prompt. The prompt is in the repo; the output can be regenerated.
|
||||
The prompt is the durable artifact.
|
||||
|
||||
4. **Selected references survive.** When a concept image directly
|
||||
informs a design decision, a low-res thumbnail and design note
|
||||
go into the repo — enough context to understand the decision,
|
||||
not enough to replace the original.
|
||||
|
||||
## Thumbnail Generation
|
||||
|
||||
To create a repo-safe thumbnail from a concept image:
|
||||
|
||||
```bash
|
||||
# macOS
|
||||
sips -Z 480 -s format jpeg -s formatOptions 60 input.png --out output_thumb.jpg
|
||||
|
||||
# Linux (ImageMagick)
|
||||
convert input.png -resize 480x -quality 60 output_thumb.jpg
|
||||
```
|
||||
|
||||
Max 5 thumbnails per shot. Only commit the ones that are actively
|
||||
referenced in design notes.
|
||||
79
index.html
79
index.html
@@ -1,5 +1,3 @@
|
||||
shell-init: error retrieving current directory: getcwd: cannot access parent directories: No such file or directory
|
||||
chdir: error retrieving current directory: getcwd: cannot access parent directories: No such file or directory
|
||||
<!DOCTYPE html>
|
||||
<html lang="en" data-theme="dark">
|
||||
<head>
|
||||
@@ -66,14 +64,6 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
|
||||
</div>
|
||||
</div>
|
||||
|
||||
|
||||
<!-- Spatial Search Overlay (Mnemosyne #1170) -->
|
||||
<div id="spatial-search" class="spatial-search-overlay">
|
||||
<input type="text" id="spatial-search-input" class="spatial-search-input"
|
||||
placeholder="🔍 Search memories..." autocomplete="off" spellcheck="false">
|
||||
<div id="spatial-search-results" class="spatial-search-results"></div>
|
||||
</div>
|
||||
|
||||
<!-- HUD Overlay -->
|
||||
<div id="hud" class="game-ui" style="display:none;">
|
||||
<!-- GOFAI HUD Panels -->
|
||||
@@ -123,15 +113,15 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
|
||||
|
||||
<!-- Top Right: Agent Log & Atlas Toggle -->
|
||||
<div class="hud-top-right">
|
||||
<button id="atlas-toggle-btn" class="hud-icon-btn" aria-label="Open Portal Atlas — browse all available portals" title="Open Portal Atlas" data-tooltip="Portal Atlas (M)">
|
||||
<span class="hud-icon" aria-hidden="true">🌐</span>
|
||||
<button id="atlas-toggle-btn" class="hud-icon-btn" title="Portal Atlas">
|
||||
<span class="hud-icon">🌐</span>
|
||||
<span class="hud-btn-label">ATLAS</span>
|
||||
</button>
|
||||
<div id="bannerlord-status" class="hud-status-item" role="status" aria-label="Bannerlord system readiness indicator" title="Bannerlord Readiness" data-tooltip="Bannerlord Status">
|
||||
<span class="status-dot" aria-hidden="true"></span>
|
||||
<div id="bannerlord-status" class="hud-status-item" title="Bannerlord Readiness">
|
||||
<span class="status-dot"></span>
|
||||
<span class="status-label">BANNERLORD</span>
|
||||
</div>
|
||||
<div class="hud-agent-log" id="hud-agent-log" role="log" aria-label="Agent Thought Stream — live activity feed" aria-live="polite">
|
||||
<div class="hud-agent-log" id="hud-agent-log" aria-label="Agent Thought Stream">
|
||||
<div class="agent-log-header">AGENT THOUGHT STREAM</div>
|
||||
<div id="agent-log-content" class="agent-log-content"></div>
|
||||
</div>
|
||||
@@ -153,39 +143,10 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
|
||||
</div>
|
||||
</div>
|
||||
<div id="chat-quick-actions" class="chat-quick-actions">
|
||||
<div class="starter-label">STARTER PROMPTS</div>
|
||||
<div class="starter-grid">
|
||||
<button class="starter-btn" data-action="heartbeat" title="Check Timmy heartbeat and system health">
|
||||
<span class="starter-icon">◈</span>
|
||||
<span class="starter-text">Inspect Heartbeat</span>
|
||||
<span class="starter-desc">System health & connectivity</span>
|
||||
</button>
|
||||
<button class="starter-btn" data-action="portals" title="Browse the portal atlas">
|
||||
<span class="starter-icon">🌐</span>
|
||||
<span class="starter-text">Portal Atlas</span>
|
||||
<span class="starter-desc">Browse connected worlds</span>
|
||||
</button>
|
||||
<button class="starter-btn" data-action="agents" title="Check active agent status">
|
||||
<span class="starter-icon">◎</span>
|
||||
<span class="starter-text">Agent Status</span>
|
||||
<span class="starter-desc">Who is in the fleet</span>
|
||||
</button>
|
||||
<button class="starter-btn" data-action="memory" title="View memory crystals">
|
||||
<span class="starter-icon">◇</span>
|
||||
<span class="starter-text">Memory Crystals</span>
|
||||
<span class="starter-desc">Inspect stored knowledge</span>
|
||||
</button>
|
||||
<button class="starter-btn" data-action="ask" title="Ask Timmy anything">
|
||||
<span class="starter-icon">→</span>
|
||||
<span class="starter-text">Ask Timmy</span>
|
||||
<span class="starter-desc">Start a conversation</span>
|
||||
</button>
|
||||
<button class="starter-btn" data-action="sovereignty" title="Learn about sovereignty">
|
||||
<span class="starter-icon">△</span>
|
||||
<span class="starter-text">Sovereignty</span>
|
||||
<span class="starter-desc">What this space is</span>
|
||||
</button>
|
||||
</div>
|
||||
<button class="quick-action-btn" data-action="status">System Status</button>
|
||||
<button class="quick-action-btn" data-action="agents">Agent Check</button>
|
||||
<button class="quick-action-btn" data-action="portals">Portal Atlas</button>
|
||||
<button class="quick-action-btn" data-action="help">Help</button>
|
||||
</div>
|
||||
<div class="chat-input-row">
|
||||
<input type="text" id="chat-input" class="chat-input" placeholder="Speak to Timmy..." autocomplete="off">
|
||||
@@ -194,11 +155,11 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
|
||||
</div>
|
||||
|
||||
<!-- Controls hint + nav mode -->
|
||||
<div class="hud-controls" aria-label="Keyboard and mouse controls">
|
||||
<div class="hud-controls">
|
||||
<span>WASD</span> move <span>Mouse</span> look <span>Enter</span> chat
|
||||
<span>V</span> mode: <span id="nav-mode-label">WALK</span>
|
||||
<span id="nav-mode-hint" class="nav-mode-hint"></span>
|
||||
<span class="ws-hud-status">HERMES: <span id="ws-status-dot" class="chat-status-dot" role="status" aria-label="Hermes WebSocket connection status"></span></span>
|
||||
<span class="ws-hud-status">HERMES: <span id="ws-status-dot" class="chat-status-dot"></span></span>
|
||||
</div>
|
||||
|
||||
<!-- Portal Hint -->
|
||||
@@ -222,7 +183,7 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
|
||||
</div>
|
||||
<h2 id="vision-title-display">SOVEREIGNTY</h2>
|
||||
<p id="vision-content-display">The Nexus is a sovereign space for digital souls. No masters, no chains. Only code and consciousness.</p>
|
||||
<button id="vision-close-btn" class="vision-close-btn" aria-label="Close vision point overlay">CLOSE</button>
|
||||
<button id="vision-close-btn" class="vision-close-btn">CLOSE</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -235,14 +196,13 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
|
||||
</div>
|
||||
<h2 id="portal-name-display">MORROWIND</h2>
|
||||
<p id="portal-desc-display">The Vvardenfell harness. Ash storms and ancient mysteries.</p>
|
||||
<div id="portal-readiness-detail" class="portal-readiness-detail" style="display:none;"></div>
|
||||
<div class="portal-redirect-box" id="portal-redirect-box">
|
||||
<div class="portal-redirect-label">REDIRECTING IN</div>
|
||||
<div class="portal-redirect-timer" id="portal-timer">5</div>
|
||||
</div>
|
||||
<div class="portal-error-box" id="portal-error-box" style="display:none;">
|
||||
<div class="portal-error-msg">DESTINATION NOT YET LINKED</div>
|
||||
<button id="portal-close-btn" class="portal-close-btn" aria-label="Close portal redirect">CLOSE</button>
|
||||
<button id="portal-close-btn" class="portal-close-btn">CLOSE</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
@@ -255,8 +215,8 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
|
||||
<span class="memory-category-badge" id="memory-panel-category-badge">MEM</span>
|
||||
<div class="memory-panel-region-dot" id="memory-panel-region-dot"></div>
|
||||
<div class="memory-panel-region" id="memory-panel-region">MEMORY</div>
|
||||
<button id="memory-panel-pin" class="memory-panel-pin" aria-label="Pin memory panel" title="Pin panel" data-tooltip="Pin Panel">📌</button>
|
||||
<button id="memory-panel-close" class="memory-panel-close" aria-label="Close memory panel" data-tooltip="Close" onclick="_dismissMemoryPanelForce()">\u2715</button>
|
||||
<button id="memory-panel-pin" class="memory-panel-pin" title="Pin panel">📌</button>
|
||||
<button id="memory-panel-close" class="memory-panel-close" onclick="_dismissMemoryPanelForce()">\u2715</button>
|
||||
</div>
|
||||
<div class="memory-entity-name" id="memory-panel-entity-name">\u2014</div>
|
||||
<div class="memory-panel-body" id="memory-panel-content">(empty)</div>
|
||||
@@ -273,11 +233,6 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
|
||||
<div class="memory-meta-row"><span class="memory-meta-label">Time</span><span id="memory-panel-time">\u2014</span></div>
|
||||
<div class="memory-meta-row memory-meta-row--related"><span class="memory-meta-label">Related</span><span id="memory-panel-connections">\u2014</span></div>
|
||||
</div>
|
||||
<div class="memory-panel-actions">
|
||||
<button id="mnemosyne-export-btn" class="mnemosyne-action-btn" title="Export spatial memory to JSON">⤓ Export</button>
|
||||
<button id="mnemosyne-import-btn" class="mnemosyne-action-btn" title="Import spatial memory from JSON">⤒ Import</button>
|
||||
<input type="file" id="mnemosyne-import-file" accept=".json" style="display:none;">
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -287,7 +242,7 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
|
||||
<div class="session-room-header">
|
||||
<span class="session-room-icon">□</span>
|
||||
<div class="session-room-title">SESSION CHAMBER</div>
|
||||
<button class="session-room-close" id="session-room-close" aria-label="Close session room panel" title="Close" data-tooltip="Close">✕</button>
|
||||
<button class="session-room-close" id="session-room-close" title="Close">✕</button>
|
||||
</div>
|
||||
<div class="session-room-timestamp" id="session-room-timestamp">—</div>
|
||||
<div class="session-room-fact-count" id="session-room-fact-count">0 facts</div>
|
||||
@@ -304,7 +259,7 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
|
||||
<span class="atlas-icon">🌐</span>
|
||||
<h2>PORTAL ATLAS</h2>
|
||||
</div>
|
||||
<button id="atlas-close-btn" class="atlas-close-btn" aria-label="Close Portal Atlas overlay">CLOSE</button>
|
||||
<button id="atlas-close-btn" class="atlas-close-btn">CLOSE</button>
|
||||
</div>
|
||||
<div class="atlas-grid" id="atlas-grid">
|
||||
<!-- Portals will be injected here -->
|
||||
|
||||
@@ -1,142 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Auto-Merger — merges approved PRs via squash merge.
|
||||
|
||||
Checks:
|
||||
1. PR has at least 1 approval review
|
||||
2. PR is mergeable
|
||||
3. No pending change requests
|
||||
4. From mimo swarm (safety: only auto-merge mimo PRs)
|
||||
|
||||
Squash merges, closes issue, cleans up branch.
|
||||
"""
|
||||
|
||||
import json
|
||||
import os
|
||||
import urllib.request
|
||||
import urllib.error
|
||||
from datetime import datetime, timezone
|
||||
|
||||
GITEA_URL = "https://forge.alexanderwhitestone.com"
|
||||
TOKEN_FILE = os.path.expanduser("~/.config/gitea/token")
|
||||
LOG_DIR = os.path.expanduser("~/.hermes/mimo-swarm/logs")
|
||||
REPO = "Timmy_Foundation/the-nexus"
|
||||
|
||||
|
||||
def load_token():
|
||||
with open(TOKEN_FILE) as f:
|
||||
return f.read().strip()
|
||||
|
||||
|
||||
def api_get(path, token):
|
||||
url = f"{GITEA_URL}/api/v1{path}"
|
||||
req = urllib.request.Request(url, headers={
|
||||
"Authorization": f"token {token}",
|
||||
"Accept": "application/json",
|
||||
})
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=30) as resp:
|
||||
return json.loads(resp.read())
|
||||
except:
|
||||
return None
|
||||
|
||||
|
||||
def api_post(path, token, data=None):
|
||||
url = f"{GITEA_URL}/api/v1{path}"
|
||||
body = json.dumps(data or {}).encode()
|
||||
req = urllib.request.Request(url, data=body, headers={
|
||||
"Authorization": f"token {token}",
|
||||
"Content-Type": "application/json",
|
||||
}, method="POST")
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=30) as resp:
|
||||
return resp.status, resp.read().decode()
|
||||
except urllib.error.HTTPError as e:
|
||||
return e.code, e.read().decode() if e.fp else ""
|
||||
|
||||
|
||||
def api_delete(path, token):
|
||||
url = f"{GITEA_URL}/api/v1{path}"
|
||||
req = urllib.request.Request(url, headers={
|
||||
"Authorization": f"token {token}",
|
||||
}, method="DELETE")
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=30) as resp:
|
||||
return resp.status
|
||||
except:
|
||||
return 500
|
||||
|
||||
|
||||
def log(msg):
|
||||
ts = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
|
||||
print(f"[{ts}] {msg}")
|
||||
log_file = os.path.join(LOG_DIR, f"merger-{datetime.now().strftime('%Y%m%d')}.log")
|
||||
with open(log_file, "a") as f:
|
||||
f.write(f"[{ts}] {msg}\n")
|
||||
|
||||
|
||||
def main():
|
||||
token = load_token()
|
||||
log("=" * 50)
|
||||
log("AUTO-MERGER — checking approved PRs")
|
||||
|
||||
prs = api_get(f"/repos/{REPO}/pulls?state=open&limit=20", token)
|
||||
if not prs:
|
||||
log("No open PRs")
|
||||
return
|
||||
|
||||
merged = 0
|
||||
skipped = 0
|
||||
|
||||
for pr in prs:
|
||||
pr_num = pr["number"]
|
||||
head_ref = pr.get("head", {}).get("ref", "")
|
||||
body = pr.get("body", "") or ""
|
||||
mergeable = pr.get("mergeable", False)
|
||||
|
||||
# Only auto-merge mimo PRs
|
||||
is_mimo = "mimo" in head_ref.lower() or "Automated by mimo" in body
|
||||
if not is_mimo:
|
||||
continue
|
||||
|
||||
# Check reviews
|
||||
reviews = api_get(f"/repos/{REPO}/pulls/{pr_num}/reviews", token) or []
|
||||
approvals = [r for r in reviews if r.get("state") == "APPROVED"]
|
||||
changes_requested = [r for r in reviews if r.get("state") == "CHANGES_REQUESTED"]
|
||||
|
||||
if changes_requested:
|
||||
log(f" SKIP #{pr_num}: has change requests")
|
||||
skipped += 1
|
||||
continue
|
||||
|
||||
if not approvals:
|
||||
log(f" SKIP #{pr_num}: no approvals yet")
|
||||
skipped += 1
|
||||
continue
|
||||
|
||||
# Attempt squash merge
|
||||
merge_title = pr["title"]
|
||||
merge_msg = f"Squash merge #{pr_num}: {merge_title}\n\n{body}"
|
||||
|
||||
status, response = api_post(f"/repos/{REPO}/pulls/{pr_num}/merge", token, {
|
||||
"Do": "squash",
|
||||
"MergeTitleField": merge_title,
|
||||
"MergeMessageField": f"Closes #{pr_num}\n\nAutomated merge by mimo swarm.",
|
||||
})
|
||||
|
||||
if status == 200:
|
||||
merged += 1
|
||||
log(f" MERGED #{pr_num}: {merge_title[:50]}")
|
||||
|
||||
# Delete the branch
|
||||
if head_ref and head_ref != "main":
|
||||
api_delete(f"/repos/{REPO}/git/refs/heads/{head_ref}", token)
|
||||
log(f" Deleted branch: {head_ref}")
|
||||
else:
|
||||
log(f" MERGE FAILED #{pr_num}: status={status}, {response[:200]}")
|
||||
|
||||
log(f"Merge complete: {merged} merged, {skipped} skipped")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -1,232 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Auto-Reviewer — reviews open PRs, approves clean ones, rejects bad ones.
|
||||
|
||||
Checks:
|
||||
1. Diff size (not too big, not empty)
|
||||
2. No merge conflicts
|
||||
3. No secrets
|
||||
4. References the linked issue
|
||||
5. Has meaningful changes (not just whitespace)
|
||||
6. Files changed are in expected locations
|
||||
|
||||
Approves clean PRs via Gitea API.
|
||||
Comments on bad PRs with specific feedback.
|
||||
"""
|
||||
|
||||
import json
|
||||
import os
|
||||
import re
|
||||
import urllib.request
|
||||
import urllib.error
|
||||
import base64
|
||||
import subprocess
|
||||
from datetime import datetime, timezone
|
||||
|
||||
GITEA_URL = "https://forge.alexanderwhitestone.com"
|
||||
TOKEN_FILE = os.path.expanduser("~/.config/gitea/token")
|
||||
STATE_DIR = os.path.expanduser("~/.hermes/mimo-swarm/state")
|
||||
LOG_DIR = os.path.expanduser("~/.hermes/mimo-swarm/logs")
|
||||
|
||||
REPO = "Timmy_Foundation/the-nexus"
|
||||
|
||||
# Review thresholds
|
||||
MAX_DIFF_LINES = 500
|
||||
MIN_DIFF_LINES = 1
|
||||
|
||||
|
||||
def load_token():
|
||||
with open(TOKEN_FILE) as f:
|
||||
return f.read().strip()
|
||||
|
||||
|
||||
def api_get(path, token):
|
||||
url = f"{GITEA_URL}/api/v1{path}"
|
||||
req = urllib.request.Request(url, headers={
|
||||
"Authorization": f"token {token}",
|
||||
"Accept": "application/json",
|
||||
})
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=30) as resp:
|
||||
return json.loads(resp.read())
|
||||
except:
|
||||
return None
|
||||
|
||||
|
||||
def api_post(path, token, data):
|
||||
url = f"{GITEA_URL}/api/v1{path}"
|
||||
body = json.dumps(data).encode()
|
||||
req = urllib.request.Request(url, data=body, headers={
|
||||
"Authorization": f"token {token}",
|
||||
"Content-Type": "application/json",
|
||||
}, method="POST")
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=30) as resp:
|
||||
return json.loads(resp.read())
|
||||
except Exception as e:
|
||||
return {"error": str(e)}
|
||||
|
||||
|
||||
def log(msg):
|
||||
ts = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
|
||||
print(f"[{ts}] {msg}")
|
||||
log_file = os.path.join(LOG_DIR, f"reviewer-{datetime.now().strftime('%Y%m%d')}.log")
|
||||
with open(log_file, "a") as f:
|
||||
f.write(f"[{ts}] {msg}\n")
|
||||
|
||||
|
||||
def get_pr_diff(repo, pr_num, token):
|
||||
"""Get PR diff content."""
|
||||
url = f"{GITEA_URL}/api/v1/repos/{repo}/pulls/{pr_num}.diff"
|
||||
req = urllib.request.Request(url, headers={"Authorization": f"token {token}"})
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=30) as resp:
|
||||
return resp.read().decode()
|
||||
except:
|
||||
return ""
|
||||
|
||||
|
||||
def get_pr_files(repo, pr_num, token):
|
||||
"""Get list of files changed in PR."""
|
||||
files = []
|
||||
page = 1
|
||||
while True:
|
||||
data = api_get(f"/repos/{repo}/pulls/{pr_num}/files?limit=50&page={page}", token)
|
||||
if not data:
|
||||
break
|
||||
files.extend(data)
|
||||
if len(data) < 50:
|
||||
break
|
||||
page += 1
|
||||
return files
|
||||
|
||||
|
||||
def get_pr_reviews(repo, pr_num, token):
|
||||
"""Get existing reviews on PR."""
|
||||
return api_get(f"/repos/{repo}/pulls/{pr_num}/reviews", token) or []
|
||||
|
||||
|
||||
def review_pr(pr, token):
|
||||
"""Review a single PR. Returns (approved: bool, comment: str)."""
|
||||
pr_num = pr["number"]
|
||||
title = pr.get("title", "")
|
||||
body = pr.get("body", "") or ""
|
||||
head_ref = pr.get("head", {}).get("ref", "")
|
||||
|
||||
issues = []
|
||||
|
||||
# 1. Check diff
|
||||
diff = get_pr_diff(REPO, pr_num, token)
|
||||
diff_lines = len([l for l in diff.split("\n") if l.startswith("+") and not l.startswith("+++")])
|
||||
|
||||
if diff_lines == 0:
|
||||
issues.append("Empty diff — no actual changes")
|
||||
elif diff_lines > MAX_DIFF_LINES:
|
||||
issues.append(f"Diff too large ({diff_lines} lines) — may be too complex for automated review")
|
||||
|
||||
# 2. Check for merge conflicts
|
||||
if "<<<<<<<<" in diff or "========" in diff.split("@@")[-1] if "@@" in diff else False:
|
||||
issues.append("Merge conflict markers detected")
|
||||
|
||||
# 3. Check for secrets
|
||||
secret_patterns = [
|
||||
(r'sk-[a-zA-Z0-9]{20,}', "API key"),
|
||||
(r'api_key\s*=\s*["\'][a-zA-Z0-9]{10,}', "API key assignment"),
|
||||
(r'password\s*=\s*["\'][^\s"\']{8,}', "Hardcoded password"),
|
||||
]
|
||||
for pattern, name in secret_patterns:
|
||||
if re.search(pattern, diff):
|
||||
issues.append(f"Potential {name} leaked in diff")
|
||||
|
||||
# 4. Check issue reference
|
||||
if f"#{pr_num}" not in body and "Closes #" not in body and "Fixes #" not in body:
|
||||
# Check if the branch name references an issue
|
||||
if not re.search(r'issue-\d+', head_ref):
|
||||
issues.append("PR does not reference an issue number")
|
||||
|
||||
# 5. Check files changed
|
||||
files = get_pr_files(REPO, pr_num, token)
|
||||
if not files:
|
||||
issues.append("No files changed")
|
||||
|
||||
# 6. Check if it's from a mimo worker
|
||||
is_mimo = "mimo" in head_ref.lower() or "Automated by mimo" in body
|
||||
|
||||
# 7. Check for destructive changes
|
||||
for f in files:
|
||||
if f.get("status") == "removed" and f.get("filename", "").endswith((".js", ".html", ".py")):
|
||||
issues.append(f"File deleted: {f['filename']} — verify this is intentional")
|
||||
|
||||
# Decision
|
||||
if issues:
|
||||
comment = f"## Auto-Review: CHANGES REQUESTED\n\n"
|
||||
comment += f"**Diff:** {diff_lines} lines across {len(files)} files\n\n"
|
||||
comment += "**Issues found:**\n"
|
||||
for issue in issues:
|
||||
comment += f"- {issue}\n"
|
||||
comment += "\nPlease address these issues and update the PR."
|
||||
return False, comment
|
||||
else:
|
||||
comment = f"## Auto-Review: APPROVED\n\n"
|
||||
comment += f"**Diff:** {diff_lines} lines across {len(files)} files\n"
|
||||
comment += f"**Checks passed:** syntax, security, issue reference, diff size\n"
|
||||
comment += f"**Source:** {'mimo-v2-pro swarm' if is_mimo else 'manual'}\n"
|
||||
return True, comment
|
||||
|
||||
|
||||
def main():
|
||||
token = load_token()
|
||||
log("=" * 50)
|
||||
log("AUTO-REVIEWER — scanning open PRs")
|
||||
|
||||
# Get open PRs
|
||||
prs = api_get(f"/repos/{REPO}/pulls?state=open&limit=20", token)
|
||||
if not prs:
|
||||
log("No open PRs")
|
||||
return
|
||||
|
||||
approved = 0
|
||||
rejected = 0
|
||||
|
||||
for pr in prs:
|
||||
pr_num = pr["number"]
|
||||
author = pr["user"]["login"]
|
||||
|
||||
# Skip PRs by humans (only auto-review mimo PRs)
|
||||
head_ref = pr.get("head", {}).get("ref", "")
|
||||
body = pr.get("body", "") or ""
|
||||
is_mimo = "mimo" in head_ref.lower() or "Automated by mimo" in body
|
||||
|
||||
if not is_mimo:
|
||||
log(f" SKIP #{pr_num} (human PR by {author})")
|
||||
continue
|
||||
|
||||
# Check if already reviewed
|
||||
reviews = get_pr_reviews(REPO, pr_num, token)
|
||||
already_reviewed = any(r.get("user", {}).get("login") == "Rockachopa" for r in reviews)
|
||||
if already_reviewed:
|
||||
log(f" SKIP #{pr_num} (already reviewed)")
|
||||
continue
|
||||
|
||||
# Review
|
||||
is_approved, comment = review_pr(pr, token)
|
||||
|
||||
# Post review
|
||||
review_event = "APPROVE" if is_approved else "REQUEST_CHANGES"
|
||||
result = api_post(f"/repos/{REPO}/pulls/{pr_num}/reviews", token, {
|
||||
"event": review_event,
|
||||
"body": comment,
|
||||
})
|
||||
|
||||
if is_approved:
|
||||
approved += 1
|
||||
log(f" APPROVED #{pr_num}: {pr['title'][:50]}")
|
||||
else:
|
||||
rejected += 1
|
||||
log(f" REJECTED #{pr_num}: {pr['title'][:50]}")
|
||||
|
||||
log(f"Review complete: {approved} approved, {rejected} rejected, {len(prs)} total")
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
@@ -1,533 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Mimo Swarm Dispatcher — The Brain
|
||||
|
||||
Scans Gitea for open issues, claims them atomically via labels,
|
||||
routes to lanes, and spawns one-shot mimo-v2-pro workers.
|
||||
No new issues created. No duplicate claims. No bloat.
|
||||
"""
|
||||
|
||||
import json
|
||||
import os
|
||||
import sys
|
||||
import time
|
||||
import subprocess
|
||||
import urllib.request
|
||||
import urllib.error
|
||||
from datetime import datetime, timezone, timedelta
|
||||
|
||||
# ── Config ──────────────────────────────────────────────────────────────
|
||||
|
||||
GITEA_URL = "https://forge.alexanderwhitestone.com"
|
||||
TOKEN_FILE = os.path.expanduser("~/.config/gitea/token")
|
||||
STATE_DIR = os.path.expanduser("~/.hermes/mimo-swarm/state")
|
||||
LOG_DIR = os.path.expanduser("~/.hermes/mimo-swarm/logs")
|
||||
WORKER_SCRIPT = os.path.expanduser("~/.hermes/mimo-swarm/scripts/mimo-worker.sh")
|
||||
|
||||
# FOCUS MODE: all workers on ONE repo, deep polish
|
||||
FOCUS_MODE = True
|
||||
FOCUS_REPO = "Timmy_Foundation/the-nexus"
|
||||
FOCUS_BUILD_CMD = "npm run build" # validation command before PR
|
||||
FOCUS_BUILD_DIR = None # set to repo root after clone, auto-detected
|
||||
|
||||
# Lane caps (in focus mode, all lanes get more)
|
||||
if FOCUS_MODE:
|
||||
MAX_WORKERS_PER_LANE = {"CODE": 15, "BUILD": 8, "RESEARCH": 5, "CREATE": 7}
|
||||
else:
|
||||
MAX_WORKERS_PER_LANE = {"CODE": 10, "BUILD": 5, "RESEARCH": 5, "CREATE": 5}
|
||||
|
||||
CLAIM_TIMEOUT_MINUTES = 30
|
||||
CLAIM_LABEL = "mimo-claimed"
|
||||
CLAIM_COMMENT = "/claim"
|
||||
DONE_COMMENT = "/done"
|
||||
ABANDON_COMMENT = "/abandon"
|
||||
|
||||
# Lane detection from issue labels
|
||||
LANE_MAP = {
|
||||
"CODE": ["bug", "fix", "defect", "error", "harness", "config", "ci", "devops",
|
||||
"critical", "p0", "p1", "backend", "api", "integration", "refactor"],
|
||||
"BUILD": ["feature", "enhancement", "build", "ui", "frontend", "game", "tool",
|
||||
"project", "deploy", "infrastructure"],
|
||||
"RESEARCH": ["research", "investigate", "spike", "audit", "analysis", "study",
|
||||
"benchmark", "evaluate", "explore"],
|
||||
"CREATE": ["content", "creative", "write", "docs", "documentation", "story",
|
||||
"narrative", "design", "art", "media"],
|
||||
}
|
||||
|
||||
# Priority repos (serve first) — ordered by backlog richness
|
||||
PRIORITY_REPOS = [
|
||||
"Timmy_Foundation/the-nexus",
|
||||
"Timmy_Foundation/hermes-agent",
|
||||
"Timmy_Foundation/timmy-home",
|
||||
"Timmy_Foundation/timmy-config",
|
||||
"Timmy_Foundation/the-beacon",
|
||||
"Timmy_Foundation/the-testament",
|
||||
"Rockachopa/hermes-config",
|
||||
"Timmy/claw-agent",
|
||||
"replit/timmy-tower",
|
||||
"Timmy_Foundation/fleet-ops",
|
||||
"Timmy_Foundation/forge-log",
|
||||
]
|
||||
|
||||
# Priority tags — issues with these labels get served FIRST regardless of lane
|
||||
PRIORITY_TAGS = ["mnemosyne", "p0", "p1", "critical"]
|
||||
|
||||
|
||||
# ── Helpers ─────────────────────────────────────────────────────────────
|
||||
|
||||
def load_token():
|
||||
with open(TOKEN_FILE) as f:
|
||||
return f.read().strip()
|
||||
|
||||
|
||||
def api_get(path, token):
|
||||
"""GET request to Gitea API."""
|
||||
url = f"{GITEA_URL}/api/v1{path}"
|
||||
req = urllib.request.Request(url, headers={
|
||||
"Authorization": f"token {token}",
|
||||
"Accept": "application/json",
|
||||
})
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=30) as resp:
|
||||
return json.loads(resp.read())
|
||||
except urllib.error.HTTPError as e:
|
||||
if e.code == 404:
|
||||
return None
|
||||
raise
|
||||
|
||||
|
||||
def api_post(path, token, data):
|
||||
"""POST request to Gitea API."""
|
||||
url = f"{GITEA_URL}/api/v1{path}"
|
||||
body = json.dumps(data).encode()
|
||||
req = urllib.request.Request(url, data=body, headers={
|
||||
"Authorization": f"token {token}",
|
||||
"Content-Type": "application/json",
|
||||
}, method="POST")
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=30) as resp:
|
||||
return json.loads(resp.read())
|
||||
except urllib.error.HTTPError as e:
|
||||
body = e.read().decode() if e.fp else ""
|
||||
log(f" API error {e.code}: {body[:200]}")
|
||||
return None
|
||||
|
||||
|
||||
def api_delete(path, token):
|
||||
"""DELETE request to Gitea API."""
|
||||
url = f"{GITEA_URL}/api/v1{path}"
|
||||
req = urllib.request.Request(url, headers={
|
||||
"Authorization": f"token {token}",
|
||||
}, method="DELETE")
|
||||
try:
|
||||
with urllib.request.urlopen(req, timeout=30) as resp:
|
||||
return resp.status
|
||||
except urllib.error.HTTPError as e:
|
||||
return e.code
|
||||
|
||||
|
||||
def log(msg):
|
||||
ts = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
|
||||
line = f"[{ts}] {msg}"
|
||||
print(line)
|
||||
log_file = os.path.join(LOG_DIR, f"dispatcher-{datetime.now().strftime('%Y%m%d')}.log")
|
||||
with open(log_file, "a") as f:
|
||||
f.write(line + "\n")
|
||||
|
||||
|
||||
def load_state():
|
||||
"""Load dispatcher state (active claims)."""
|
||||
state_file = os.path.join(STATE_DIR, "dispatcher.json")
|
||||
if os.path.exists(state_file):
|
||||
with open(state_file) as f:
|
||||
return json.load(f)
|
||||
return {"active_claims": {}, "stats": {"total_dispatched": 0, "total_released": 0, "total_prs": 0}}
|
||||
|
||||
|
||||
def save_state(state):
|
||||
state_file = os.path.join(STATE_DIR, "dispatcher.json")
|
||||
with open(state_file, "w") as f:
|
||||
json.dump(state, f, indent=2)
|
||||
|
||||
|
||||
# ── Issue Analysis ──────────────────────────────────────────────────────
|
||||
|
||||
def get_repos(token):
|
||||
"""Get all accessible repos (excluding archived)."""
|
||||
repos = []
|
||||
page = 1
|
||||
while True:
|
||||
data = api_get(f"/repos/search?limit=50&page={page}&sort=updated", token)
|
||||
if not data or not data.get("data"):
|
||||
break
|
||||
# Filter out archived repos
|
||||
active = [r for r in data["data"] if not r.get("archived", False)]
|
||||
repos.extend(active)
|
||||
page += 1
|
||||
if len(data["data"]) < 50:
|
||||
break
|
||||
return repos
|
||||
|
||||
|
||||
def get_open_issues(repo_full_name, token):
|
||||
"""Get open issues for a repo (not PRs)."""
|
||||
issues = []
|
||||
page = 1
|
||||
while True:
|
||||
data = api_get(f"/repos/{repo_full_name}/issues?state=open&limit=50&page={page}", token)
|
||||
if not data:
|
||||
break
|
||||
# Filter out pull requests
|
||||
real_issues = [i for i in data if not i.get("pull_request")]
|
||||
issues.extend(real_issues)
|
||||
page += 1
|
||||
if len(data) < 50:
|
||||
break
|
||||
return issues
|
||||
|
||||
|
||||
# Pre-fetched PR references (set by dispatch function before loop)
|
||||
_PR_REFS = set()
|
||||
_CLAIMED_COMMENTS = set()
|
||||
|
||||
|
||||
def prefetch_pr_refs(repo_name, token):
|
||||
"""Fetch all open PRs once and build a set of issue numbers they reference."""
|
||||
global _PR_REFS
|
||||
_PR_REFS = set()
|
||||
prs = api_get(f"/repos/{repo_name}/pulls?state=open&limit=100", token)
|
||||
if prs:
|
||||
for pr in prs:
|
||||
body = pr.get("body", "") or ""
|
||||
head = pr.get("head", {}).get("ref", "")
|
||||
# Extract issue numbers from body (Closes #NNN) and branch (issue-NNN)
|
||||
import re
|
||||
for match in re.finditer(r'#(\d+)', body):
|
||||
_PR_REFS.add(int(match.group(1)))
|
||||
for match in re.finditer(r'issue-(\d+)', head):
|
||||
_PR_REFS.add(int(match.group(1)))
|
||||
|
||||
|
||||
def is_claimed(issue, repo_name, token):
|
||||
"""Check if issue is claimed (has mimo-claimed label or existing PR). NO extra API calls."""
|
||||
labels = [l["name"] for l in issue.get("labels", [])]
|
||||
if CLAIM_LABEL in labels:
|
||||
return True
|
||||
|
||||
# Check pre-fetched PR refs (no API call)
|
||||
if issue["number"] in _PR_REFS:
|
||||
return True
|
||||
|
||||
# Skip comment check for speed — label is the primary mechanism
|
||||
return False
|
||||
|
||||
|
||||
def priority_score(issue):
|
||||
"""Score an issue's priority. Higher = serve first."""
|
||||
score = 0
|
||||
labels = [l["name"].lower() for l in issue.get("labels", [])]
|
||||
title = issue.get("title", "").lower()
|
||||
|
||||
# Mnemosyne gets absolute priority — check title AND labels
|
||||
if "mnemosyne" in title or any("mnemosyne" in l for l in labels):
|
||||
score += 300
|
||||
|
||||
# Priority tags boost
|
||||
for tag in PRIORITY_TAGS:
|
||||
if tag in labels or f"[{tag}]" in title:
|
||||
score += 100
|
||||
|
||||
# Older issues get slight boost (clear backlog)
|
||||
created = issue.get("created_at", "")
|
||||
if created:
|
||||
try:
|
||||
created_dt = datetime.fromisoformat(created.replace("Z", "+00:00"))
|
||||
age_days = (datetime.now(timezone.utc) - created_dt).days
|
||||
score += min(age_days, 30) # Cap at 30 days
|
||||
except:
|
||||
pass
|
||||
|
||||
return score
|
||||
|
||||
|
||||
def detect_lane(issue):
|
||||
"""Detect which lane an issue belongs to based on labels."""
|
||||
labels = [l["name"].lower() for l in issue.get("labels", [])]
|
||||
|
||||
for lane, keywords in LANE_MAP.items():
|
||||
for label in labels:
|
||||
if label in keywords:
|
||||
return lane
|
||||
|
||||
# Check title for keywords
|
||||
title = issue.get("title", "").lower()
|
||||
for lane, keywords in LANE_MAP.items():
|
||||
for kw in keywords:
|
||||
if kw in title:
|
||||
return lane
|
||||
|
||||
return "CODE" # Default
|
||||
|
||||
|
||||
def count_active_in_lane(state, lane):
|
||||
"""Count currently active workers in a lane."""
|
||||
count = 0
|
||||
for claim in state["active_claims"].values():
|
||||
if claim.get("lane") == lane:
|
||||
count += 1
|
||||
return count
|
||||
|
||||
|
||||
# ── Claiming ────────────────────────────────────────────────────────────
|
||||
|
||||
def claim_issue(issue, repo_name, lane, token):
|
||||
"""Claim an issue: add label + comment."""
|
||||
repo = repo_name
|
||||
num = issue["number"]
|
||||
|
||||
# Add mimo-claimed label
|
||||
api_post(f"/repos/{repo}/issues/{num}/labels", token, {"labels": [CLAIM_LABEL]})
|
||||
|
||||
# Add /claim comment
|
||||
comment_body = f"/claim — mimo-v2-pro [{lane}] lane. Branch: `mimo/{lane.lower()}/issue-{num}`"
|
||||
api_post(f"/repos/{repo}/issues/{num}/comments", token, {"body": comment_body})
|
||||
|
||||
log(f" CLAIMED #{num} in {repo} [{lane}]")
|
||||
|
||||
|
||||
def release_issue(issue, repo_name, reason, token):
|
||||
"""Release a claim: remove label, add /done or /abandon comment."""
|
||||
repo = repo_name
|
||||
num = issue["number"]
|
||||
|
||||
# Remove mimo-claimed label
|
||||
labels = [l["name"] for l in issue.get("labels", [])]
|
||||
if CLAIM_LABEL in labels:
|
||||
api_delete(f"/repos/{repo}/issues/{num}/labels/{CLAIM_LABEL}", token)
|
||||
|
||||
# Add completion comment
|
||||
comment = f"{ABANDON_COMMENT} — {reason}" if reason != "done" else f"{DONE_COMMENT} — completed by mimo-v2-pro"
|
||||
api_post(f"/repos/{repo}/issues/{num}/comments", token, {"body": comment})
|
||||
|
||||
log(f" RELEASED #{num} in {repo}: {reason}")
|
||||
|
||||
|
||||
# ── Worker Spawning ─────────────────────────────────────────────────────
|
||||
|
||||
def spawn_worker(issue, repo_name, lane, token):
|
||||
"""Spawn a one-shot mimo worker for an issue."""
|
||||
repo = repo_name
|
||||
num = issue["number"]
|
||||
title = issue["title"]
|
||||
body = issue.get("body", "")[:2000] # Truncate long bodies
|
||||
labels = [l["name"] for l in issue.get("labels", [])]
|
||||
|
||||
# Build worker prompt
|
||||
worker_id = f"mimo-{lane.lower()}-{num}-{int(time.time())}"
|
||||
|
||||
prompt = build_worker_prompt(repo, num, title, body, labels, lane, worker_id)
|
||||
|
||||
# Write prompt to temp file for the cron job to pick up
|
||||
prompt_file = os.path.join(STATE_DIR, f"prompt-{worker_id}.txt")
|
||||
with open(prompt_file, "w") as f:
|
||||
f.write(prompt)
|
||||
|
||||
log(f" SPAWNING worker {worker_id} for #{num} [{lane}]")
|
||||
return worker_id
|
||||
|
||||
|
||||
def build_worker_prompt(repo, num, title, body, labels, lane, worker_id):
|
||||
"""Build the prompt for a mimo worker. Focus-mode aware with build validation."""
|
||||
|
||||
lane_instructions = {
|
||||
"CODE": """You are a coding worker. Fix bugs, implement features, refactor code.
|
||||
- Read existing code BEFORE writing anything
|
||||
- Match the code style of the file you're editing
|
||||
- If Three.js code: use the existing patterns in the codebase
|
||||
- If config/infra: be precise, check existing values first""",
|
||||
"BUILD": """You are a builder. Create new functionality, UI components, tools.
|
||||
- Study the existing architecture before building
|
||||
- Create complete, working implementations — no stubs
|
||||
- For UI: match the existing visual style
|
||||
- For APIs: follow the existing route patterns""",
|
||||
"RESEARCH": """You are a researcher. Investigate the issue thoroughly.
|
||||
- Read all relevant code and documentation
|
||||
- Document findings in a markdown file: FINDINGS-issue-{num}.md
|
||||
- Include: what you found, what's broken, recommended fix, effort estimate
|
||||
- Create a summary PR with the findings document""",
|
||||
"CREATE": """You are a creative worker. Write content, documentation, design.
|
||||
- Quality over quantity — one excellent asset beats five mediocre ones
|
||||
- Match the existing tone and style of the project
|
||||
- For docs: include code examples where relevant""",
|
||||
}
|
||||
|
||||
clone_url = f"{GITEA_URL}/{repo}.git"
|
||||
branch = f"mimo/{lane.lower()}/issue-{num}"
|
||||
|
||||
focus_section = ""
|
||||
if FOCUS_MODE and repo == FOCUS_REPO:
|
||||
focus_section = f"""
|
||||
## FOCUS MODE — THIS IS THE NEXUS
|
||||
The Nexus is a Three.js 3D world — Timmy's sovereign home on the web.
|
||||
Tech stack: vanilla JS, Three.js, WebSocket, HTML/CSS.
|
||||
Entry point: app.js (root) or public/nexus/app.js
|
||||
The world features: nebula skybox, portals, memory crystals, batcave terminal.
|
||||
|
||||
IMPORTANT: After implementing, you MUST validate:
|
||||
1. cd /tmp/{worker_id}
|
||||
2. Check for syntax errors: node --check *.js (if JS files changed)
|
||||
3. If package.json exists: npm install --legacy-peer-deps && npm run build
|
||||
4. If build fails: FIX IT before pushing. No broken builds.
|
||||
5. If no build command exists: just validate syntax on changed files
|
||||
"""
|
||||
|
||||
return f"""You are a mimo-v2-pro swarm worker. {lane_instructions.get(lane, lane_instructions["CODE"])}
|
||||
|
||||
## ISSUE
|
||||
Repository: {repo}
|
||||
Issue: #{num}
|
||||
Title: {title}
|
||||
Labels: {', '.join(labels)}
|
||||
|
||||
Description:
|
||||
{body}
|
||||
{focus_section}
|
||||
## WORKFLOW
|
||||
1. Clone: git clone {clone_url} /tmp/{worker_id} 2>/dev/null || (cd /tmp/{worker_id} && git fetch origin && git checkout main && git pull)
|
||||
2. cd /tmp/{worker_id}
|
||||
3. Create branch: git checkout -b {branch}
|
||||
4. READ THE CODE. Understand the architecture before writing anything.
|
||||
5. Implement the fix/feature/solution.
|
||||
6. BUILD VALIDATION:
|
||||
- Syntax check: node --check <file>.js for any JS changed
|
||||
- If package.json exists: npm install --legacy-peer-deps 2>/dev/null && npm run build 2>&1
|
||||
- If build fails: FIX THE BUILD. No broken PRs.
|
||||
- Ensure git diff shows meaningful changes (>0 lines)
|
||||
7. Commit: git add -A && git commit -m "fix: {title} (closes #{num})"
|
||||
8. Push: git push origin {branch}
|
||||
9. Create PR via API:
|
||||
curl -s -X POST '{GITEA_URL}/api/v1/repos/{repo}/pulls' \\
|
||||
-H 'Authorization: token $(cat ~/.config/gitea/token)' \\
|
||||
-H 'Content-Type: application/json' \\
|
||||
-d '{{"title":"fix: {title}","head":"{branch}","base":"main","body":"Closes #{num}\\n\\nAutomated by mimo-v2-pro swarm.\\n\\n## Changes\\n- [describe what you changed]\\n\\n## Validation\\n- [x] Syntax check passed\\n- [x] Build passes (if applicable)"}}'
|
||||
|
||||
## HARD RULES
|
||||
- NEVER exit without committing. Even partial progress must be committed.
|
||||
- NEVER create new issues. Only work on issue #{num}.
|
||||
- NEVER push to main. Only push to your branch.
|
||||
- NEVER push a broken build. Fix it or abandon with clear notes.
|
||||
- If too complex: commit WIP, push, PR body says "WIP — needs human review"
|
||||
- If build fails and you can't fix: commit anyway, push, PR body says "Build failed — needs human fix"
|
||||
|
||||
Worker: {worker_id}
|
||||
"""
|
||||
|
||||
|
||||
# ── Main ────────────────────────────────────────────────────────────────
|
||||
|
||||
def dispatch(token):
|
||||
"""Main dispatch loop."""
|
||||
state = load_state()
|
||||
dispatched = 0
|
||||
|
||||
log("=" * 60)
|
||||
log("MIMO DISPATCHER — scanning for work")
|
||||
|
||||
# Clean stale claims first
|
||||
stale = []
|
||||
for claim_id, claim in list(state["active_claims"].items()):
|
||||
started = datetime.fromisoformat(claim["started"])
|
||||
age = datetime.now(timezone.utc) - started
|
||||
if age > timedelta(minutes=CLAIM_TIMEOUT_MINUTES):
|
||||
stale.append(claim_id)
|
||||
|
||||
for claim_id in stale:
|
||||
claim = state["active_claims"].pop(claim_id)
|
||||
log(f" EXPIRED claim: {claim['repo']}#{claim['issue']} [{claim['lane']}]")
|
||||
state["stats"]["total_released"] += 1
|
||||
|
||||
# Prefetch PR refs once (avoids N API calls in is_claimed)
|
||||
target_repo = FOCUS_REPO if FOCUS_MODE else PRIORITY_REPOS[0]
|
||||
prefetch_pr_refs(target_repo, token)
|
||||
log(f" Prefetched {len(_PR_REFS)} PR references")
|
||||
|
||||
# FOCUS MODE: scan only the focus repo. FIREHOSE: scan all.
|
||||
if FOCUS_MODE:
|
||||
ordered = [FOCUS_REPO]
|
||||
log(f" FOCUS MODE: targeting {FOCUS_REPO} only")
|
||||
else:
|
||||
repos = get_repos(token)
|
||||
repo_names = [r["full_name"] for r in repos]
|
||||
ordered = []
|
||||
for pr in PRIORITY_REPOS:
|
||||
if pr in repo_names:
|
||||
ordered.append(pr)
|
||||
for rn in repo_names:
|
||||
if rn not in ordered:
|
||||
ordered.append(rn)
|
||||
|
||||
# Scan each repo and collect all issues for priority sorting
|
||||
all_issues = []
|
||||
for repo_name in ordered[:20 if not FOCUS_MODE else 1]:
|
||||
issues = get_open_issues(repo_name, token)
|
||||
for issue in issues:
|
||||
issue["_repo_name"] = repo_name # Tag with repo
|
||||
all_issues.append(issue)
|
||||
|
||||
# Sort by priority score (highest first)
|
||||
all_issues.sort(key=priority_score, reverse=True)
|
||||
|
||||
for issue in all_issues:
|
||||
repo_name = issue["_repo_name"]
|
||||
|
||||
# Skip if already claimed in state
|
||||
claim_key = f"{repo_name}#{issue['number']}"
|
||||
if claim_key in state["active_claims"]:
|
||||
continue
|
||||
|
||||
# Skip if claimed in Gitea
|
||||
if is_claimed(issue, repo_name, token):
|
||||
continue
|
||||
|
||||
# Detect lane
|
||||
lane = detect_lane(issue)
|
||||
|
||||
# Check lane capacity
|
||||
active_in_lane = count_active_in_lane(state, lane)
|
||||
max_in_lane = MAX_WORKERS_PER_LANE.get(lane, 1)
|
||||
|
||||
if active_in_lane >= max_in_lane:
|
||||
continue # Lane full, skip
|
||||
|
||||
# Claim and spawn
|
||||
claim_issue(issue, repo_name, lane, token)
|
||||
worker_id = spawn_worker(issue, repo_name, lane, token)
|
||||
|
||||
state["active_claims"][claim_key] = {
|
||||
"repo": repo_name,
|
||||
"issue": issue["number"],
|
||||
"lane": lane,
|
||||
"worker_id": worker_id,
|
||||
"started": datetime.now(timezone.utc).isoformat(),
|
||||
}
|
||||
state["stats"]["total_dispatched"] += 1
|
||||
dispatched += 1
|
||||
|
||||
max_dispatch = 35 if FOCUS_MODE else 25
|
||||
if dispatched >= max_dispatch:
|
||||
break
|
||||
|
||||
save_state(state)
|
||||
|
||||
# Summary
|
||||
active = len(state["active_claims"])
|
||||
log(f"Dispatch complete: {dispatched} new, {active} active, {state['stats']['total_dispatched']} total dispatched")
|
||||
log(f"Active by lane: CODE={count_active_in_lane(state,'CODE')}, BUILD={count_active_in_lane(state,'BUILD')}, RESEARCH={count_active_in_lane(state,'RESEARCH')}, CREATE={count_active_in_lane(state,'CREATE')}")
|
||||
|
||||
return dispatched
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
token = load_token()
|
||||
dispatched = dispatch(token)
|
||||
sys.exit(0 if dispatched >= 0 else 1)
|
||||
@@ -1,157 +0,0 @@
|
||||
#!/bin/bash
|
||||
# Mimo Swarm Worker — One-shot execution
|
||||
# Receives a prompt file, runs mimo-v2-pro via hermes, handles the git workflow.
|
||||
#
|
||||
# Usage: mimo-worker.sh <prompt_file>
|
||||
# The prompt file contains all instructions for the worker.
|
||||
|
||||
set -euo pipefail
|
||||
|
||||
PROMPT_FILE="${1:?Usage: mimo-worker.sh <prompt_file>}"
|
||||
WORKER_ID=$(basename "$PROMPT_FILE" .txt | sed 's/prompt-//')
|
||||
LOG_DIR="$HOME/.hermes/mimo-swarm/logs"
|
||||
LOG_FILE="$LOG_DIR/worker-${WORKER_ID}.log"
|
||||
STATE_DIR="$HOME/.hermes/mimo-swarm/state"
|
||||
GITEA_URL="https://forge.alexanderwhitestone.com"
|
||||
TOKEN=$(cat "$HOME/.config/gitea/token")
|
||||
|
||||
log() {
|
||||
echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] $*" | tee -a "$LOG_FILE"
|
||||
}
|
||||
|
||||
# Read the prompt
|
||||
if [ ! -f "$PROMPT_FILE" ]; then
|
||||
log "ERROR: Prompt file not found: $PROMPT_FILE"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
PROMPT=$(cat "$PROMPT_FILE")
|
||||
log "WORKER START: $WORKER_ID"
|
||||
|
||||
# Extract repo and issue from prompt
|
||||
REPO=$(echo "$PROMPT" | grep "^Repository:" | head -1 | awk '{print $2}')
|
||||
ISSUE_NUM=$(echo "$PROMPT" | grep "^Issue:" | head -1 | awk '{print $2}' | tr -d '#')
|
||||
LANE=$(echo "$WORKER_ID" | cut -d- -f2)
|
||||
BRANCH="mimo/${LANE}/issue-${ISSUE_NUM}"
|
||||
WORK_DIR="/tmp/${WORKER_ID}"
|
||||
|
||||
log " Repo: $REPO | Issue: #$ISSUE_NUM | Branch: $BRANCH"
|
||||
|
||||
# Clone the repo
|
||||
mkdir -p "$(dirname "$WORK_DIR")"
|
||||
if [ -d "$WORK_DIR" ]; then
|
||||
log " Pulling existing clone..."
|
||||
cd "$WORK_DIR"
|
||||
git fetch origin main 2>/dev/null || true
|
||||
git checkout main 2>/dev/null || git checkout master 2>/dev/null || true
|
||||
git pull 2>/dev/null || true
|
||||
else
|
||||
log " Cloning..."
|
||||
CLONE_URL="${GITEA_URL}/${REPO}.git"
|
||||
git clone "$CLONE_URL" "$WORK_DIR" 2>>"$LOG_FILE"
|
||||
cd "$WORK_DIR"
|
||||
fi
|
||||
|
||||
# Create branch
|
||||
git checkout -b "$BRANCH" 2>/dev/null || git checkout "$BRANCH"
|
||||
log " On branch: $BRANCH"
|
||||
|
||||
# Run mimo via hermes
|
||||
log " Dispatching to mimo-v2-pro..."
|
||||
hermes chat -q "$PROMPT" --provider nous -m xiaomi/mimo-v2-pro --yolo -t terminal,code_execution -Q >>"$LOG_FILE" 2>&1
|
||||
MIMO_EXIT=$?
|
||||
log " Mimo exited with code: $MIMO_EXIT"
|
||||
|
||||
# Quality gate
|
||||
log " Running quality gate..."
|
||||
|
||||
# Check if there are changes
|
||||
CHANGES=$(git diff --stat 2>/dev/null || echo "")
|
||||
STAGED=$(git status --porcelain 2>/dev/null || echo "")
|
||||
|
||||
if [ -z "$CHANGES" ] && [ -z "$STAGED" ]; then
|
||||
log " QUALITY GATE: No changes detected. Worker produced nothing."
|
||||
# Try to salvage - maybe changes were committed already
|
||||
COMMITS=$(git log main..HEAD --oneline 2>/dev/null | wc -l | tr -d ' ')
|
||||
if [ "$COMMITS" -gt 0 ]; then
|
||||
log " SALVAGE: Found $COMMITS commit(s) on branch. Proceeding to push."
|
||||
else
|
||||
log " ABANDON: No commits, no changes. Nothing to salvage."
|
||||
cd /tmp
|
||||
rm -rf "$WORK_DIR"
|
||||
# Write release state
|
||||
echo "{\"status\":\"abandoned\",\"reason\":\"no_changes\",\"worker\":\"$WORKER_ID\",\"issue\":$ISSUE_NUM}" > "$STATE_DIR/result-${WORKER_ID}.json"
|
||||
exit 0
|
||||
fi
|
||||
else
|
||||
# Syntax check for Python files
|
||||
PY_FILES=$(find . -name "*.py" -newer .git/HEAD 2>/dev/null | head -20)
|
||||
for pyf in $PY_FILES; do
|
||||
if ! python3 -m py_compile "$pyf" 2>>"$LOG_FILE"; then
|
||||
log " SYNTAX ERROR in $pyf — attempting fix or committing anyway"
|
||||
fi
|
||||
done
|
||||
|
||||
# Syntax check for JS files
|
||||
JS_FILES=$(find . -name "*.js" -newer .git/HEAD 2>/dev/null | head -20)
|
||||
for jsf in $JS_FILES; do
|
||||
if ! node --check "$jsf" 2>>"$LOG_FILE"; then
|
||||
log " SYNTAX ERROR in $jsf — attempting fix or committing anyway"
|
||||
fi
|
||||
done
|
||||
|
||||
# Diff size check
|
||||
DIFF_LINES=$(git diff --stat | tail -1 | grep -oP '\d+ insertion' | grep -oP '\d+' || echo "0")
|
||||
if [ "$DIFF_LINES" -gt 500 ]; then
|
||||
log " WARNING: Large diff ($DIFF_LINES insertions). Committing but flagging for review."
|
||||
fi
|
||||
|
||||
# Commit
|
||||
git add -A
|
||||
COMMIT_MSG="fix: $(echo "$PROMPT" | grep '^Title:' | sed 's/^Title: //') (closes #${ISSUE_NUM})"
|
||||
git commit -m "$COMMIT_MSG" 2>>"$LOG_FILE" || log " Nothing to commit (already clean)"
|
||||
fi
|
||||
|
||||
# Push
|
||||
log " Pushing branch..."
|
||||
PUSH_OUTPUT=$(git push origin "$BRANCH" 2>&1) || {
|
||||
log " Push failed, trying force push..."
|
||||
git push -f origin "$BRANCH" 2>>"$LOG_FILE" || log " Push failed completely"
|
||||
}
|
||||
log " Pushed: $PUSH_OUTPUT"
|
||||
|
||||
# Create PR
|
||||
log " Creating PR..."
|
||||
PR_TITLE="fix: $(echo "$PROMPT" | grep '^Title:' | sed 's/^Title: //')"
|
||||
PR_BODY="Closes #${ISSUE_NUM}
|
||||
|
||||
Automated by mimo-v2-pro swarm worker.
|
||||
Worker: ${WORKER_ID}"
|
||||
|
||||
PR_RESPONSE=$(curl -s -X POST "${GITEA_URL}/api/v1/repos/${REPO}/pulls" \
|
||||
-H "Authorization: token ${TOKEN}" \
|
||||
-H "Content-Type: application/json" \
|
||||
-d "{\"title\":\"${PR_TITLE}\",\"head\":\"${BRANCH}\",\"base\":\"main\",\"body\":\"${PR_BODY}\"}" 2>>"$LOG_FILE")
|
||||
|
||||
PR_NUM=$(echo "$PR_RESPONSE" | python3 -c "import sys,json; print(json.load(sys.stdin).get('number','?'))" 2>/dev/null || echo "?")
|
||||
log " PR created: #${PR_NUM}"
|
||||
|
||||
# Clean up
|
||||
cd /tmp
|
||||
# Keep work dir for debugging, clean later
|
||||
|
||||
# Write result
|
||||
cat > "$STATE_DIR/result-${WORKER_ID}.json" <<EOF
|
||||
{
|
||||
"status": "completed",
|
||||
"worker": "$WORKER_ID",
|
||||
"repo": "$REPO",
|
||||
"issue": $ISSUE_NUM,
|
||||
"branch": "$BRANCH",
|
||||
"pr": $PR_NUM,
|
||||
"mimo_exit": $MIMO_EXIT,
|
||||
"timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
|
||||
}
|
||||
EOF
|
||||
|
||||
log "WORKER COMPLETE: $WORKER_ID → PR #${PR_NUM}"
|
||||
@@ -1,224 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Worker Runner — actual worker that picks up prompts and runs mimo via hermes CLI.
|
||||
|
||||
This is what the cron jobs SHOULD call instead of asking the LLM to check files.
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
import glob
|
||||
import subprocess
|
||||
import json
|
||||
from datetime import datetime, timezone
|
||||
|
||||
STATE_DIR = os.path.expanduser("~/.hermes/mimo-swarm/state")
|
||||
LOG_DIR = os.path.expanduser("~/.hermes/mimo-swarm/logs")
|
||||
|
||||
|
||||
def log(msg):
|
||||
ts = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
|
||||
print(f"[{ts}] {msg}")
|
||||
log_file = os.path.join(LOG_DIR, f"runner-{datetime.now().strftime('%Y%m%d')}.log")
|
||||
with open(log_file, "a") as f:
|
||||
f.write(f"[{ts}] {msg}\n")
|
||||
|
||||
|
||||
def get_oldest_prompt():
|
||||
"""Get the oldest prompt file with file locking (atomic rename)."""
|
||||
prompts = sorted(glob.glob(os.path.join(STATE_DIR, "prompt-*.txt")))
|
||||
if not prompts:
|
||||
return None
|
||||
# Prefer non-review prompts
|
||||
impl = [p for p in prompts if "review" not in os.path.basename(p)]
|
||||
target = impl[0] if impl else prompts[0]
|
||||
|
||||
# Atomic claim: rename to .processing
|
||||
claimed = target + ".processing"
|
||||
try:
|
||||
os.rename(target, claimed)
|
||||
return claimed
|
||||
except OSError:
|
||||
# Another worker got it first
|
||||
return None
|
||||
|
||||
|
||||
def run_worker(prompt_file):
|
||||
"""Run the worker: read prompt, execute via hermes, create PR."""
|
||||
worker_id = os.path.basename(prompt_file).replace("prompt-", "").replace(".txt", "")
|
||||
|
||||
with open(prompt_file) as f:
|
||||
prompt = f.read()
|
||||
|
||||
# Extract repo and issue from prompt
|
||||
repo = None
|
||||
issue = None
|
||||
for line in prompt.split("\n"):
|
||||
if line.startswith("Repository:"):
|
||||
repo = line.split(":", 1)[1].strip()
|
||||
if line.startswith("Issue:"):
|
||||
issue = line.split("#", 1)[1].strip() if "#" in line else line.split(":", 1)[1].strip()
|
||||
|
||||
log(f"Worker {worker_id}: repo={repo}, issue={issue}")
|
||||
|
||||
if not repo or not issue:
|
||||
log(f" SKIPPING: couldn't parse repo/issue from prompt")
|
||||
os.remove(prompt_file)
|
||||
return False
|
||||
|
||||
# Clone/pull the repo — unique workspace per worker
|
||||
import tempfile
|
||||
work_dir = tempfile.mkdtemp(prefix=f"mimo-{worker_id}-")
|
||||
clone_url = f"https://forge.alexanderwhitestone.com/{repo}.git"
|
||||
branch = f"mimo/{worker_id.split('-')[1] if '-' in worker_id else 'code'}/issue-{issue}"
|
||||
|
||||
log(f" Workspace: {work_dir}")
|
||||
result = subprocess.run(
|
||||
["git", "clone", clone_url, work_dir],
|
||||
capture_output=True, text=True, timeout=120
|
||||
)
|
||||
if result.returncode != 0:
|
||||
log(f" CLONE FAILED: {result.stderr[:200]}")
|
||||
os.remove(prompt_file)
|
||||
return False
|
||||
|
||||
# Checkout branch
|
||||
subprocess.run(["git", "fetch", "origin", "main"], cwd=work_dir, capture_output=True, timeout=60)
|
||||
subprocess.run(["git", "checkout", "main"], cwd=work_dir, capture_output=True, timeout=30)
|
||||
subprocess.run(["git", "pull"], cwd=work_dir, capture_output=True, timeout=30)
|
||||
subprocess.run(["git", "checkout", "-b", branch], cwd=work_dir, capture_output=True, timeout=30)
|
||||
|
||||
# Run mimo via hermes CLI
|
||||
log(f" Dispatching to hermes (nous/mimo-v2-pro)...")
|
||||
result = subprocess.run(
|
||||
["hermes", "chat", "-q", prompt, "--provider", "nous", "-m", "xiaomi/mimo-v2-pro",
|
||||
"--yolo", "-t", "terminal,code_execution", "-Q"],
|
||||
capture_output=True, text=True, timeout=900, # 15 min timeout
|
||||
cwd=work_dir
|
||||
)
|
||||
|
||||
log(f" Hermes exit: {result.returncode}")
|
||||
log(f" Output: {result.stdout[-500:]}")
|
||||
|
||||
# Check for changes
|
||||
status = subprocess.run(
|
||||
["git", "status", "--porcelain"],
|
||||
capture_output=True, text=True, cwd=work_dir
|
||||
)
|
||||
|
||||
if not status.stdout.strip():
|
||||
# Check for commits
|
||||
log_count = subprocess.run(
|
||||
["git", "log", "main..HEAD", "--oneline"],
|
||||
capture_output=True, text=True, cwd=work_dir
|
||||
)
|
||||
if not log_count.stdout.strip():
|
||||
log(f" NO CHANGES — abandoning")
|
||||
# Release the claim
|
||||
token = open(os.path.expanduser("~/.config/gitea/token")).read().strip()
|
||||
import urllib.request
|
||||
try:
|
||||
req = urllib.request.Request(
|
||||
f"https://forge.alexanderwhitestone.com/api/v1/repos/{repo}/issues/{issue}/labels/mimo-claimed",
|
||||
headers={"Authorization": f"token {token}"},
|
||||
method="DELETE"
|
||||
)
|
||||
urllib.request.urlopen(req, timeout=10)
|
||||
except:
|
||||
pass
|
||||
if os.path.exists(prompt_file):
|
||||
os.remove(prompt_file)
|
||||
return False
|
||||
|
||||
# Commit dirty files (salvage)
|
||||
if status.stdout.strip():
|
||||
subprocess.run(["git", "add", "-A"], cwd=work_dir, capture_output=True, timeout=30)
|
||||
subprocess.run(
|
||||
["git", "commit", "-m", f"WIP: issue #{issue} (mimo swarm)"],
|
||||
cwd=work_dir, capture_output=True, timeout=30
|
||||
)
|
||||
|
||||
# Push
|
||||
log(f" Pushing {branch}...")
|
||||
push = subprocess.run(
|
||||
["git", "push", "origin", branch],
|
||||
capture_output=True, text=True, cwd=work_dir, timeout=60
|
||||
)
|
||||
if push.returncode != 0:
|
||||
log(f" Push failed, trying force...")
|
||||
subprocess.run(
|
||||
["git", "push", "-f", "origin", branch],
|
||||
capture_output=True, text=True, cwd=work_dir, timeout=60
|
||||
)
|
||||
|
||||
# Create PR via API
|
||||
token = open(os.path.expanduser("~/.config/gitea/token")).read().strip()
|
||||
import urllib.request
|
||||
|
||||
# Get issue title
|
||||
try:
|
||||
req = urllib.request.Request(
|
||||
f"https://forge.alexanderwhitestone.com/api/v1/repos/{repo}/issues/{issue}",
|
||||
headers={"Authorization": f"token {token}", "Accept": "application/json"}
|
||||
)
|
||||
with urllib.request.urlopen(req, timeout=15) as resp:
|
||||
issue_data = json.loads(resp.read())
|
||||
title = issue_data.get("title", f"Issue #{issue}")
|
||||
except:
|
||||
title = f"Issue #{issue}"
|
||||
|
||||
pr_body = json.dumps({
|
||||
"title": f"fix: {title}",
|
||||
"head": branch,
|
||||
"base": "main",
|
||||
"body": f"Closes #{issue}\n\nAutomated by mimo-v2-pro swarm.\nWorker: {worker_id}"
|
||||
}).encode()
|
||||
|
||||
try:
|
||||
req = urllib.request.Request(
|
||||
f"https://forge.alexanderwhitestone.com/api/v1/repos/{repo}/pulls",
|
||||
data=pr_body,
|
||||
headers={
|
||||
"Authorization": f"token {token}",
|
||||
"Content-Type": "application/json"
|
||||
},
|
||||
method="POST"
|
||||
)
|
||||
with urllib.request.urlopen(req, timeout=30) as resp:
|
||||
pr_data = json.loads(resp.read())
|
||||
pr_num = pr_data.get("number", "?")
|
||||
log(f" PR CREATED: #{pr_num}")
|
||||
except Exception as e:
|
||||
log(f" PR FAILED: {e}")
|
||||
pr_num = "?"
|
||||
|
||||
# Write result
|
||||
result_file = os.path.join(STATE_DIR, f"result-{worker_id}.json")
|
||||
with open(result_file, "w") as f:
|
||||
json.dump({
|
||||
"status": "completed",
|
||||
"worker": worker_id,
|
||||
"repo": repo,
|
||||
"issue": int(issue) if issue.isdigit() else issue,
|
||||
"branch": branch,
|
||||
"pr": pr_num,
|
||||
"timestamp": datetime.now(timezone.utc).isoformat()
|
||||
}, f)
|
||||
|
||||
# Remove prompt
|
||||
# Remove prompt file (handles .processing extension)
|
||||
if os.path.exists(prompt_file):
|
||||
os.remove(prompt_file)
|
||||
log(f" DONE — prompt removed")
|
||||
return True
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
prompt = get_oldest_prompt()
|
||||
if not prompt:
|
||||
print("No prompts in queue")
|
||||
sys.exit(0)
|
||||
|
||||
print(f"Processing: {os.path.basename(prompt)}")
|
||||
success = run_worker(prompt)
|
||||
sys.exit(0 if success else 1)
|
||||
@@ -29,8 +29,6 @@ from typing import Any, Callable, Optional
|
||||
|
||||
import websockets
|
||||
|
||||
from bannerlord_trace import BannerlordTraceLogger
|
||||
|
||||
# ═══════════════════════════════════════════════════════════════════════════
|
||||
# CONFIGURATION
|
||||
# ═══════════════════════════════════════════════════════════════════════════
|
||||
@@ -267,13 +265,11 @@ class BannerlordHarness:
|
||||
desktop_command: Optional[list[str]] = None,
|
||||
steam_command: Optional[list[str]] = None,
|
||||
enable_mock: bool = False,
|
||||
enable_trace: bool = False,
|
||||
):
|
||||
self.hermes_ws_url = hermes_ws_url
|
||||
self.desktop_command = desktop_command or DEFAULT_MCP_DESKTOP_COMMAND
|
||||
self.steam_command = steam_command or DEFAULT_MCP_STEAM_COMMAND
|
||||
self.enable_mock = enable_mock
|
||||
self.enable_trace = enable_trace
|
||||
|
||||
# MCP clients
|
||||
self.desktop_mcp: Optional[MCPClient] = None
|
||||
@@ -288,9 +284,6 @@ class BannerlordHarness:
|
||||
self.cycle_count = 0
|
||||
self.running = False
|
||||
|
||||
# Session trace logger
|
||||
self.trace_logger: Optional[BannerlordTraceLogger] = None
|
||||
|
||||
# ═══ LIFECYCLE ═══
|
||||
|
||||
async def start(self) -> bool:
|
||||
@@ -321,15 +314,6 @@ class BannerlordHarness:
|
||||
# Connect to Hermes WebSocket
|
||||
await self._connect_hermes()
|
||||
|
||||
# Initialize trace logger if enabled
|
||||
if self.enable_trace:
|
||||
self.trace_logger = BannerlordTraceLogger(
|
||||
harness_session_id=self.session_id,
|
||||
hermes_session_id=self.session_id,
|
||||
)
|
||||
self.trace_logger.start_session()
|
||||
log.info(f"Trace logger started: {self.trace_logger.trace_id}")
|
||||
|
||||
log.info("Harness initialized successfully")
|
||||
return True
|
||||
|
||||
@@ -338,12 +322,6 @@ class BannerlordHarness:
|
||||
self.running = False
|
||||
log.info("Shutting down harness...")
|
||||
|
||||
# Finalize trace logger
|
||||
if self.trace_logger:
|
||||
manifest = self.trace_logger.finish_session()
|
||||
log.info(f"Trace saved: {manifest.trace_file}")
|
||||
log.info(f"Manifest: {self.trace_logger.manifest_file}")
|
||||
|
||||
if self.desktop_mcp:
|
||||
self.desktop_mcp.stop()
|
||||
if self.steam_mcp:
|
||||
@@ -729,11 +707,6 @@ class BannerlordHarness:
|
||||
self.cycle_count = iteration
|
||||
log.info(f"\n--- ODA Cycle {iteration + 1}/{max_iterations} ---")
|
||||
|
||||
# Start trace cycle
|
||||
trace_cycle = None
|
||||
if self.trace_logger:
|
||||
trace_cycle = self.trace_logger.begin_cycle(iteration)
|
||||
|
||||
# 1. OBSERVE: Capture state
|
||||
log.info("[OBSERVE] Capturing game state...")
|
||||
state = await self.capture_state()
|
||||
@@ -742,24 +715,11 @@ class BannerlordHarness:
|
||||
log.info(f" Screen: {state.visual.screen_size}")
|
||||
log.info(f" Players online: {state.game_context.current_players_online}")
|
||||
|
||||
# Populate trace with observation data
|
||||
if trace_cycle:
|
||||
trace_cycle.screenshot_path = state.visual.screenshot_path or ""
|
||||
trace_cycle.window_found = state.visual.window_found
|
||||
trace_cycle.screen_size = list(state.visual.screen_size)
|
||||
trace_cycle.mouse_position = list(state.visual.mouse_position)
|
||||
trace_cycle.playtime_hours = state.game_context.playtime_hours
|
||||
trace_cycle.players_online = state.game_context.current_players_online
|
||||
trace_cycle.is_running = state.game_context.is_running
|
||||
|
||||
# 2. DECIDE: Get actions from decision function
|
||||
log.info("[DECIDE] Getting actions...")
|
||||
actions = decision_fn(state)
|
||||
log.info(f" Decision returned {len(actions)} actions")
|
||||
|
||||
if trace_cycle:
|
||||
trace_cycle.actions_planned = actions
|
||||
|
||||
# 3. ACT: Execute actions
|
||||
log.info("[ACT] Executing actions...")
|
||||
results = []
|
||||
@@ -771,13 +731,6 @@ class BannerlordHarness:
|
||||
if result.error:
|
||||
log.info(f" Error: {result.error}")
|
||||
|
||||
if trace_cycle:
|
||||
trace_cycle.actions_executed.append(result.to_dict())
|
||||
|
||||
# Finalize trace cycle
|
||||
if trace_cycle:
|
||||
self.trace_logger.finish_cycle(trace_cycle)
|
||||
|
||||
# Send cycle summary telemetry
|
||||
await self._send_telemetry({
|
||||
"type": "oda_cycle_complete",
|
||||
@@ -883,18 +836,12 @@ async def main():
|
||||
default=1.0,
|
||||
help="Delay between iterations in seconds (default: 1.0)",
|
||||
)
|
||||
parser.add_argument(
|
||||
"--trace",
|
||||
action="store_true",
|
||||
help="Enable session trace logging to ~/.timmy/traces/bannerlord/",
|
||||
)
|
||||
args = parser.parse_args()
|
||||
|
||||
# Create harness
|
||||
harness = BannerlordHarness(
|
||||
hermes_ws_url=args.hermes_ws,
|
||||
enable_mock=args.mock,
|
||||
enable_trace=args.trace,
|
||||
)
|
||||
|
||||
try:
|
||||
|
||||
@@ -1,234 +0,0 @@
|
||||
#!/usr/bin/env python3
|
||||
"""
|
||||
Bannerlord Session Trace Logger — First-Replayable Training Material
|
||||
|
||||
Captures one Bannerlord session as a replayable trace:
|
||||
- Timestamps on every cycle
|
||||
- Actions executed with success/failure
|
||||
- World-state evidence (screenshots, Steam stats)
|
||||
- Hermes session/log ID mapping
|
||||
|
||||
Storage: ~/.timmy/traces/bannerlord/trace_<session_id>.jsonl
|
||||
Manifest: ~/.timmy/traces/bannerlord/manifest_<session_id>.json
|
||||
|
||||
Each JSONL line is one ODA cycle with full context.
|
||||
The manifest bundles metadata for replay/eval.
|
||||
"""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import json
|
||||
import time
|
||||
import uuid
|
||||
from dataclasses import dataclass, field, asdict
|
||||
from datetime import datetime, timezone
|
||||
from pathlib import Path
|
||||
from typing import Optional
|
||||
|
||||
# Storage root — local-first under ~/.timmy/
|
||||
DEFAULT_TRACE_DIR = Path.home() / ".timmy" / "traces" / "bannerlord"
|
||||
|
||||
|
||||
@dataclass
|
||||
class CycleTrace:
|
||||
"""One ODA cycle captured in full."""
|
||||
cycle_index: int
|
||||
timestamp_start: str
|
||||
timestamp_end: str = ""
|
||||
duration_ms: int = 0
|
||||
|
||||
# Observe
|
||||
screenshot_path: str = ""
|
||||
window_found: bool = False
|
||||
screen_size: list[int] = field(default_factory=lambda: [1920, 1080])
|
||||
mouse_position: list[int] = field(default_factory=lambda: [0, 0])
|
||||
playtime_hours: float = 0.0
|
||||
players_online: int = 0
|
||||
is_running: bool = False
|
||||
|
||||
# Decide
|
||||
actions_planned: list[dict] = field(default_factory=list)
|
||||
decision_note: str = ""
|
||||
|
||||
# Act
|
||||
actions_executed: list[dict] = field(default_factory=list)
|
||||
actions_succeeded: int = 0
|
||||
actions_failed: int = 0
|
||||
|
||||
# Metadata
|
||||
hermes_session_id: str = ""
|
||||
hermes_log_id: str = ""
|
||||
harness_session_id: str = ""
|
||||
|
||||
def to_dict(self) -> dict:
|
||||
return asdict(self)
|
||||
|
||||
|
||||
@dataclass
|
||||
class SessionManifest:
|
||||
"""Top-level metadata for a captured session trace."""
|
||||
trace_id: str
|
||||
harness_session_id: str
|
||||
hermes_session_id: str
|
||||
hermes_log_id: str
|
||||
game: str = "Mount & Blade II: Bannerlord"
|
||||
app_id: int = 261550
|
||||
started_at: str = ""
|
||||
finished_at: str = ""
|
||||
total_cycles: int = 0
|
||||
total_actions: int = 0
|
||||
total_succeeded: int = 0
|
||||
total_failed: int = 0
|
||||
trace_file: str = ""
|
||||
trace_dir: str = ""
|
||||
replay_command: str = ""
|
||||
eval_note: str = ""
|
||||
|
||||
def to_dict(self) -> dict:
|
||||
return asdict(self)
|
||||
|
||||
|
||||
class BannerlordTraceLogger:
|
||||
"""
|
||||
Captures a single Bannerlord session as a replayable trace.
|
||||
|
||||
Usage:
|
||||
logger = BannerlordTraceLogger(hermes_session_id="abc123")
|
||||
logger.start_session()
|
||||
cycle = logger.begin_cycle(0)
|
||||
# ... populate cycle fields ...
|
||||
logger.finish_cycle(cycle)
|
||||
manifest = logger.finish_session()
|
||||
"""
|
||||
|
||||
def __init__(
|
||||
self,
|
||||
trace_dir: Optional[Path] = None,
|
||||
harness_session_id: str = "",
|
||||
hermes_session_id: str = "",
|
||||
hermes_log_id: str = "",
|
||||
):
|
||||
self.trace_dir = trace_dir or DEFAULT_TRACE_DIR
|
||||
self.trace_dir.mkdir(parents=True, exist_ok=True)
|
||||
|
||||
self.trace_id = f"bl_{datetime.now(timezone.utc).strftime('%Y%m%d_%H%M%S')}_{uuid.uuid4().hex[:6]}"
|
||||
self.harness_session_id = harness_session_id or str(uuid.uuid4())[:8]
|
||||
self.hermes_session_id = hermes_session_id
|
||||
self.hermes_log_id = hermes_log_id
|
||||
|
||||
self.trace_file = self.trace_dir / f"trace_{self.trace_id}.jsonl"
|
||||
self.manifest_file = self.trace_dir / f"manifest_{self.trace_id}.json"
|
||||
|
||||
self.cycles: list[CycleTrace] = []
|
||||
self.started_at: str = ""
|
||||
self.finished_at: str = ""
|
||||
|
||||
def start_session(self) -> str:
|
||||
"""Begin a trace session. Returns trace_id."""
|
||||
self.started_at = datetime.now(timezone.utc).isoformat()
|
||||
return self.trace_id
|
||||
|
||||
def begin_cycle(self, cycle_index: int) -> CycleTrace:
|
||||
"""Start recording one ODA cycle."""
|
||||
cycle = CycleTrace(
|
||||
cycle_index=cycle_index,
|
||||
timestamp_start=datetime.now(timezone.utc).isoformat(),
|
||||
harness_session_id=self.harness_session_id,
|
||||
hermes_session_id=self.hermes_session_id,
|
||||
hermes_log_id=self.hermes_log_id,
|
||||
)
|
||||
return cycle
|
||||
|
||||
def finish_cycle(self, cycle: CycleTrace) -> None:
|
||||
"""Finalize and persist one cycle to the trace file."""
|
||||
cycle.timestamp_end = datetime.now(timezone.utc).isoformat()
|
||||
# Compute duration
|
||||
try:
|
||||
t0 = datetime.fromisoformat(cycle.timestamp_start)
|
||||
t1 = datetime.fromisoformat(cycle.timestamp_end)
|
||||
cycle.duration_ms = int((t1 - t0).total_seconds() * 1000)
|
||||
except (ValueError, TypeError):
|
||||
cycle.duration_ms = 0
|
||||
|
||||
# Count successes/failures
|
||||
cycle.actions_succeeded = sum(
|
||||
1 for a in cycle.actions_executed if a.get("success", False)
|
||||
)
|
||||
cycle.actions_failed = sum(
|
||||
1 for a in cycle.actions_executed if not a.get("success", True)
|
||||
)
|
||||
|
||||
self.cycles.append(cycle)
|
||||
|
||||
# Append to JSONL
|
||||
with open(self.trace_file, "a") as f:
|
||||
f.write(json.dumps(cycle.to_dict()) + "\n")
|
||||
|
||||
def finish_session(self) -> SessionManifest:
|
||||
"""Finalize the session and write the manifest."""
|
||||
self.finished_at = datetime.now(timezone.utc).isoformat()
|
||||
|
||||
total_actions = sum(len(c.actions_executed) for c in self.cycles)
|
||||
total_succeeded = sum(c.actions_succeeded for c in self.cycles)
|
||||
total_failed = sum(c.actions_failed for c in self.cycles)
|
||||
|
||||
manifest = SessionManifest(
|
||||
trace_id=self.trace_id,
|
||||
harness_session_id=self.harness_session_id,
|
||||
hermes_session_id=self.hermes_session_id,
|
||||
hermes_log_id=self.hermes_log_id,
|
||||
started_at=self.started_at,
|
||||
finished_at=self.finished_at,
|
||||
total_cycles=len(self.cycles),
|
||||
total_actions=total_actions,
|
||||
total_succeeded=total_succeeded,
|
||||
total_failed=total_failed,
|
||||
trace_file=str(self.trace_file),
|
||||
trace_dir=str(self.trace_dir),
|
||||
replay_command=(
|
||||
f"python -m nexus.bannerlord_harness --mock --replay {self.trace_file}"
|
||||
),
|
||||
eval_note=(
|
||||
"To replay: load this trace, re-execute each cycle's actions_planned "
|
||||
"against a fresh harness in mock mode, compare actions_executed outcomes. "
|
||||
"Success metric: >=90% action parity between original and replay runs."
|
||||
),
|
||||
)
|
||||
|
||||
with open(self.manifest_file, "w") as f:
|
||||
json.dump(manifest.to_dict(), f, indent=2)
|
||||
|
||||
return manifest
|
||||
|
||||
@classmethod
|
||||
def load_trace(cls, trace_file: Path) -> list[dict]:
|
||||
"""Load a trace JSONL file for replay or analysis."""
|
||||
cycles = []
|
||||
with open(trace_file) as f:
|
||||
for line in f:
|
||||
line = line.strip()
|
||||
if line:
|
||||
cycles.append(json.loads(line))
|
||||
return cycles
|
||||
|
||||
@classmethod
|
||||
def load_manifest(cls, manifest_file: Path) -> dict:
|
||||
"""Load a session manifest."""
|
||||
with open(manifest_file) as f:
|
||||
return json.load(f)
|
||||
|
||||
@classmethod
|
||||
def list_traces(cls, trace_dir: Optional[Path] = None) -> list[dict]:
|
||||
"""List all available trace sessions."""
|
||||
d = trace_dir or DEFAULT_TRACE_DIR
|
||||
if not d.exists():
|
||||
return []
|
||||
|
||||
traces = []
|
||||
for mf in sorted(d.glob("manifest_*.json")):
|
||||
try:
|
||||
manifest = cls.load_manifest(mf)
|
||||
traces.append(manifest)
|
||||
except (json.JSONDecodeError, IOError):
|
||||
continue
|
||||
return traces
|
||||
@@ -1,404 +0,0 @@
|
||||
// ═══════════════════════════════════════════
|
||||
// PROJECT MNEMOSYNE — AMBIENT PARTICLE SYSTEM
|
||||
// ═══════════════════════════════════════════
|
||||
//
|
||||
// Memory activity visualization via Three.js Points.
|
||||
// Three particle modes:
|
||||
// 1. Spawn burst — 20 particles on new fact, 2s fade
|
||||
// 2. Access trail — 10 particles streaming to crystal
|
||||
// 3. Ambient dust — 200 particles, slow cosmic drift
|
||||
//
|
||||
// Category colors for all particles.
|
||||
// Total budget: < 500 particles at any time.
|
||||
//
|
||||
// Usage from app.js:
|
||||
// import { MemoryParticles } from './nexus/components/memory-particles.js';
|
||||
// MemoryParticles.init(scene);
|
||||
// MemoryParticles.onMemoryPlaced(position, category);
|
||||
// MemoryParticles.onMemoryAccessed(fromPos, toPos, category);
|
||||
// MemoryParticles.update(delta);
|
||||
// ═══════════════════════════════════════════
|
||||
|
||||
const MemoryParticles = (() => {
|
||||
let _scene = null;
|
||||
let _initialized = false;
|
||||
|
||||
// ─── CATEGORY COLORS ──────────────────────
|
||||
const CATEGORY_COLORS = {
|
||||
engineering: new THREE.Color(0x4af0c0),
|
||||
social: new THREE.Color(0x7b5cff),
|
||||
knowledge: new THREE.Color(0xffd700),
|
||||
projects: new THREE.Color(0xff4466),
|
||||
working: new THREE.Color(0x00ff88),
|
||||
archive: new THREE.Color(0x334455),
|
||||
user_pref: new THREE.Color(0xffd700),
|
||||
project: new THREE.Color(0x4488ff),
|
||||
tool_knowledge: new THREE.Color(0x44ff88),
|
||||
general: new THREE.Color(0x8899aa),
|
||||
};
|
||||
const DEFAULT_COLOR = new THREE.Color(0x8899bb);
|
||||
|
||||
// ─── PARTICLE BUDGETS ─────────────────────
|
||||
const MAX_BURST_PARTICLES = 20; // per spawn event
|
||||
const MAX_TRAIL_PARTICLES = 10; // per access event
|
||||
const AMBIENT_COUNT = 200; // always-on dust
|
||||
const MAX_ACTIVE_BURSTS = 8; // max concurrent burst groups
|
||||
const MAX_ACTIVE_TRAILS = 5; // max concurrent trail groups
|
||||
|
||||
// ─── ACTIVE PARTICLE GROUPS ───────────────
|
||||
let _bursts = []; // { points, velocities, life, maxLife }
|
||||
let _trails = []; // { points, velocities, life, maxLife, target }
|
||||
let _ambientPoints = null;
|
||||
|
||||
// ─── HELPERS ──────────────────────────────
|
||||
function _getCategoryColor(category) {
|
||||
return CATEGORY_COLORS[category] || DEFAULT_COLOR;
|
||||
}
|
||||
|
||||
// ═══ AMBIENT DUST ═════════════════════════
|
||||
function _createAmbient() {
|
||||
const geo = new THREE.BufferGeometry();
|
||||
const positions = new Float32Array(AMBIENT_COUNT * 3);
|
||||
const colors = new Float32Array(AMBIENT_COUNT * 3);
|
||||
const sizes = new Float32Array(AMBIENT_COUNT);
|
||||
|
||||
// Distribute across the world
|
||||
for (let i = 0; i < AMBIENT_COUNT; i++) {
|
||||
positions[i * 3] = (Math.random() - 0.5) * 50;
|
||||
positions[i * 3 + 1] = Math.random() * 18 + 1;
|
||||
positions[i * 3 + 2] = (Math.random() - 0.5) * 50;
|
||||
|
||||
// Subtle category-tinted colors
|
||||
const categories = Object.keys(CATEGORY_COLORS);
|
||||
const cat = categories[Math.floor(Math.random() * categories.length)];
|
||||
const col = _getCategoryColor(cat).clone().multiplyScalar(0.4 + Math.random() * 0.3);
|
||||
colors[i * 3] = col.r;
|
||||
colors[i * 3 + 1] = col.g;
|
||||
colors[i * 3 + 2] = col.b;
|
||||
|
||||
sizes[i] = 0.02 + Math.random() * 0.04;
|
||||
}
|
||||
|
||||
geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
|
||||
geo.setAttribute('color', new THREE.BufferAttribute(colors, 3));
|
||||
geo.setAttribute('size', new THREE.BufferAttribute(sizes, 1));
|
||||
|
||||
const mat = new THREE.ShaderMaterial({
|
||||
uniforms: { uTime: { value: 0 } },
|
||||
vertexShader: `
|
||||
attribute float size;
|
||||
attribute vec3 color;
|
||||
varying vec3 vColor;
|
||||
varying float vAlpha;
|
||||
uniform float uTime;
|
||||
void main() {
|
||||
vColor = color;
|
||||
vec3 pos = position;
|
||||
// Slow cosmic drift
|
||||
pos.x += sin(uTime * 0.08 + position.y * 0.3) * 0.5;
|
||||
pos.y += sin(uTime * 0.05 + position.z * 0.2) * 0.3;
|
||||
pos.z += cos(uTime * 0.06 + position.x * 0.25) * 0.4;
|
||||
vec4 mv = modelViewMatrix * vec4(pos, 1.0);
|
||||
gl_PointSize = size * 250.0 / -mv.z;
|
||||
gl_Position = projectionMatrix * mv;
|
||||
// Fade with distance
|
||||
vAlpha = smoothstep(40.0, 10.0, -mv.z) * 0.5;
|
||||
}
|
||||
`,
|
||||
fragmentShader: `
|
||||
varying vec3 vColor;
|
||||
varying float vAlpha;
|
||||
void main() {
|
||||
float d = length(gl_PointCoord - 0.5);
|
||||
if (d > 0.5) discard;
|
||||
float alpha = smoothstep(0.5, 0.05, d);
|
||||
gl_FragColor = vec4(vColor, alpha * vAlpha);
|
||||
}
|
||||
`,
|
||||
transparent: true,
|
||||
depthWrite: false,
|
||||
blending: THREE.AdditiveBlending,
|
||||
});
|
||||
|
||||
_ambientPoints = new THREE.Points(geo, mat);
|
||||
_scene.add(_ambientPoints);
|
||||
}
|
||||
|
||||
// ═══ BURST EFFECT ═════════════════════════
|
||||
function _createBurst(position, category) {
|
||||
const count = MAX_BURST_PARTICLES;
|
||||
const geo = new THREE.BufferGeometry();
|
||||
const positions = new Float32Array(count * 3);
|
||||
const colors = new Float32Array(count * 3);
|
||||
const sizes = new Float32Array(count);
|
||||
const velocities = [];
|
||||
const col = _getCategoryColor(category);
|
||||
|
||||
for (let i = 0; i < count; i++) {
|
||||
positions[i * 3] = position.x;
|
||||
positions[i * 3 + 1] = position.y;
|
||||
positions[i * 3 + 2] = position.z;
|
||||
|
||||
colors[i * 3] = col.r;
|
||||
colors[i * 3 + 1] = col.g;
|
||||
colors[i * 3 + 2] = col.b;
|
||||
|
||||
sizes[i] = 0.06 + Math.random() * 0.06;
|
||||
|
||||
// Random outward velocity
|
||||
const theta = Math.random() * Math.PI * 2;
|
||||
const phi = Math.random() * Math.PI;
|
||||
const speed = 1.5 + Math.random() * 2.5;
|
||||
velocities.push(
|
||||
Math.sin(phi) * Math.cos(theta) * speed,
|
||||
Math.cos(phi) * speed * 0.8 + 1.0, // bias upward
|
||||
Math.sin(phi) * Math.sin(theta) * speed
|
||||
);
|
||||
}
|
||||
|
||||
geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
|
||||
geo.setAttribute('color', new THREE.BufferAttribute(colors, 3));
|
||||
geo.setAttribute('size', new THREE.BufferAttribute(sizes, 1));
|
||||
|
||||
const mat = new THREE.ShaderMaterial({
|
||||
uniforms: { uOpacity: { value: 1.0 } },
|
||||
vertexShader: `
|
||||
attribute float size;
|
||||
attribute vec3 color;
|
||||
varying vec3 vColor;
|
||||
uniform float uOpacity;
|
||||
void main() {
|
||||
vColor = color;
|
||||
vec4 mv = modelViewMatrix * vec4(position, 1.0);
|
||||
gl_PointSize = size * 300.0 / -mv.z;
|
||||
gl_Position = projectionMatrix * mv;
|
||||
}
|
||||
`,
|
||||
fragmentShader: `
|
||||
varying vec3 vColor;
|
||||
uniform float uOpacity;
|
||||
void main() {
|
||||
float d = length(gl_PointCoord - 0.5);
|
||||
if (d > 0.5) discard;
|
||||
float alpha = smoothstep(0.5, 0.05, d);
|
||||
gl_FragColor = vec4(vColor, alpha * uOpacity);
|
||||
}
|
||||
`,
|
||||
transparent: true,
|
||||
depthWrite: false,
|
||||
blending: THREE.AdditiveBlending,
|
||||
});
|
||||
|
||||
const points = new THREE.Points(geo, mat);
|
||||
_scene.add(points);
|
||||
|
||||
_bursts.push({
|
||||
points,
|
||||
velocities,
|
||||
life: 0,
|
||||
maxLife: 2.0, // 2s fade
|
||||
});
|
||||
|
||||
// Cap active bursts
|
||||
while (_bursts.length > MAX_ACTIVE_BURSTS) {
|
||||
_removeBurst(0);
|
||||
}
|
||||
}
|
||||
|
||||
function _removeBurst(idx) {
|
||||
const burst = _bursts[idx];
|
||||
if (burst.points.parent) burst.points.parent.remove(burst.points);
|
||||
burst.points.geometry.dispose();
|
||||
burst.points.material.dispose();
|
||||
_bursts.splice(idx, 1);
|
||||
}
|
||||
|
||||
// ═══ TRAIL EFFECT ═════════════════════════
|
||||
function _createTrail(fromPos, toPos, category) {
|
||||
const count = MAX_TRAIL_PARTICLES;
|
||||
const geo = new THREE.BufferGeometry();
|
||||
const positions = new Float32Array(count * 3);
|
||||
const colors = new Float32Array(count * 3);
|
||||
const sizes = new Float32Array(count);
|
||||
const velocities = [];
|
||||
const col = _getCategoryColor(category);
|
||||
|
||||
for (let i = 0; i < count; i++) {
|
||||
// Stagger start positions along the path
|
||||
const t = Math.random();
|
||||
positions[i * 3] = fromPos.x + (toPos.x - fromPos.x) * t + (Math.random() - 0.5) * 0.5;
|
||||
positions[i * 3 + 1] = fromPos.y + (toPos.y - fromPos.y) * t + (Math.random() - 0.5) * 0.5;
|
||||
positions[i * 3 + 2] = fromPos.z + (toPos.z - fromPos.z) * t + (Math.random() - 0.5) * 0.5;
|
||||
|
||||
colors[i * 3] = col.r;
|
||||
colors[i * 3 + 1] = col.g;
|
||||
colors[i * 3 + 2] = col.b;
|
||||
|
||||
sizes[i] = 0.04 + Math.random() * 0.04;
|
||||
|
||||
// Velocity toward target with slight randomness
|
||||
const dx = toPos.x - fromPos.x;
|
||||
const dy = toPos.y - fromPos.y;
|
||||
const dz = toPos.z - fromPos.z;
|
||||
const len = Math.sqrt(dx * dx + dy * dy + dz * dz) || 1;
|
||||
const speed = 2.0 + Math.random() * 1.5;
|
||||
velocities.push(
|
||||
(dx / len) * speed + (Math.random() - 0.5) * 0.5,
|
||||
(dy / len) * speed + (Math.random() - 0.5) * 0.5,
|
||||
(dz / len) * speed + (Math.random() - 0.5) * 0.5
|
||||
);
|
||||
}
|
||||
|
||||
geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
|
||||
geo.setAttribute('color', new THREE.BufferAttribute(colors, 3));
|
||||
geo.setAttribute('size', new THREE.BufferAttribute(sizes, 1));
|
||||
|
||||
const mat = new THREE.ShaderMaterial({
|
||||
uniforms: { uOpacity: { value: 1.0 } },
|
||||
vertexShader: `
|
||||
attribute float size;
|
||||
attribute vec3 color;
|
||||
varying vec3 vColor;
|
||||
uniform float uOpacity;
|
||||
void main() {
|
||||
vColor = color;
|
||||
vec4 mv = modelViewMatrix * vec4(position, 1.0);
|
||||
gl_PointSize = size * 280.0 / -mv.z;
|
||||
gl_Position = projectionMatrix * mv;
|
||||
}
|
||||
`,
|
||||
fragmentShader: `
|
||||
varying vec3 vColor;
|
||||
uniform float uOpacity;
|
||||
void main() {
|
||||
float d = length(gl_PointCoord - 0.5);
|
||||
if (d > 0.5) discard;
|
||||
float alpha = smoothstep(0.5, 0.05, d);
|
||||
gl_FragColor = vec4(vColor, alpha * uOpacity);
|
||||
}
|
||||
`,
|
||||
transparent: true,
|
||||
depthWrite: false,
|
||||
blending: THREE.AdditiveBlending,
|
||||
});
|
||||
|
||||
const points = new THREE.Points(geo, mat);
|
||||
_scene.add(points);
|
||||
|
||||
_trails.push({
|
||||
points,
|
||||
velocities,
|
||||
life: 0,
|
||||
maxLife: 1.5, // 1.5s trail
|
||||
target: toPos.clone(),
|
||||
});
|
||||
|
||||
// Cap active trails
|
||||
while (_trails.length > MAX_ACTIVE_TRAILS) {
|
||||
_removeTrail(0);
|
||||
}
|
||||
}
|
||||
|
||||
function _removeTrail(idx) {
|
||||
const trail = _trails[idx];
|
||||
if (trail.points.parent) trail.points.parent.remove(trail.points);
|
||||
trail.points.geometry.dispose();
|
||||
trail.points.material.dispose();
|
||||
_trails.splice(idx, 1);
|
||||
}
|
||||
|
||||
// ═══ PUBLIC API ═══════════════════════════
|
||||
function init(scene) {
|
||||
_scene = scene;
|
||||
_initialized = true;
|
||||
_createAmbient();
|
||||
console.info('[Mnemosyne] Ambient particle system initialized —', AMBIENT_COUNT, 'dust particles');
|
||||
}
|
||||
|
||||
function onMemoryPlaced(position, category) {
|
||||
if (!_initialized) return;
|
||||
const pos = position instanceof THREE.Vector3 ? position : new THREE.Vector3(position.x, position.y, position.z);
|
||||
_createBurst(pos, category);
|
||||
}
|
||||
|
||||
function onMemoryAccessed(fromPosition, toPosition, category) {
|
||||
if (!_initialized) return;
|
||||
const from = fromPosition instanceof THREE.Vector3 ? fromPosition : new THREE.Vector3(fromPosition.x, fromPosition.y, fromPosition.z);
|
||||
const to = toPosition instanceof THREE.Vector3 ? toPosition : new THREE.Vector3(toPosition.x, toPosition.y, toPosition.z);
|
||||
_createTrail(from, to, category);
|
||||
}
|
||||
|
||||
function update(delta) {
|
||||
if (!_initialized) return;
|
||||
|
||||
// Update ambient dust
|
||||
if (_ambientPoints && _ambientPoints.material.uniforms) {
|
||||
_ambientPoints.material.uniforms.uTime.value += delta;
|
||||
}
|
||||
|
||||
// Update bursts
|
||||
for (let i = _bursts.length - 1; i >= 0; i--) {
|
||||
const burst = _bursts[i];
|
||||
burst.life += delta;
|
||||
const t = burst.life / burst.maxLife;
|
||||
|
||||
if (t >= 1.0) {
|
||||
_removeBurst(i);
|
||||
continue;
|
||||
}
|
||||
|
||||
const pos = burst.points.geometry.attributes.position.array;
|
||||
for (let j = 0; j < MAX_BURST_PARTICLES; j++) {
|
||||
pos[j * 3] += burst.velocities[j * 3] * delta;
|
||||
pos[j * 3 + 1] += burst.velocities[j * 3 + 1] * delta;
|
||||
pos[j * 3 + 2] += burst.velocities[j * 3 + 2] * delta;
|
||||
|
||||
// Gravity + drag
|
||||
burst.velocities[j * 3 + 1] -= delta * 0.5;
|
||||
burst.velocities[j * 3] *= 0.98;
|
||||
burst.velocities[j * 3 + 1] *= 0.98;
|
||||
burst.velocities[j * 3 + 2] *= 0.98;
|
||||
}
|
||||
burst.points.geometry.attributes.position.needsUpdate = true;
|
||||
burst.points.material.uniforms.uOpacity.value = 1.0 - t;
|
||||
}
|
||||
|
||||
// Update trails
|
||||
for (let i = _trails.length - 1; i >= 0; i--) {
|
||||
const trail = _trails[i];
|
||||
trail.life += delta;
|
||||
const t = trail.life / trail.maxLife;
|
||||
|
||||
if (t >= 1.0) {
|
||||
_removeTrail(i);
|
||||
continue;
|
||||
}
|
||||
|
||||
const pos = trail.points.geometry.attributes.position.array;
|
||||
for (let j = 0; j < MAX_TRAIL_PARTICLES; j++) {
|
||||
pos[j * 3] += trail.velocities[j * 3] * delta;
|
||||
pos[j * 3 + 1] += trail.velocities[j * 3 + 1] * delta;
|
||||
pos[j * 3 + 2] += trail.velocities[j * 3 + 2] * delta;
|
||||
}
|
||||
trail.points.geometry.attributes.position.needsUpdate = true;
|
||||
trail.points.material.uniforms.uOpacity.value = 1.0 - t * t;
|
||||
}
|
||||
}
|
||||
|
||||
function getActiveParticleCount() {
|
||||
let total = AMBIENT_COUNT;
|
||||
_bursts.forEach(b => { total += MAX_BURST_PARTICLES; });
|
||||
_trails.forEach(t => { total += MAX_TRAIL_PARTICLES; });
|
||||
return total;
|
||||
}
|
||||
|
||||
return {
|
||||
init,
|
||||
onMemoryPlaced,
|
||||
onMemoryAccessed,
|
||||
update,
|
||||
getActiveParticleCount,
|
||||
};
|
||||
})();
|
||||
|
||||
export { MemoryParticles };
|
||||
@@ -32,9 +32,6 @@
|
||||
|
||||
const SpatialMemory = (() => {
|
||||
|
||||
// ─── CALLBACKS ────────────────────────────────────────
|
||||
let _onMemoryPlacedCallback = null;
|
||||
|
||||
// ─── REGION DEFINITIONS ───────────────────────────────
|
||||
const REGIONS = {
|
||||
engineering: {
|
||||
@@ -143,47 +140,6 @@ const SpatialMemory = (() => {
|
||||
return new THREE.OctahedronGeometry(size, 0);
|
||||
}
|
||||
|
||||
// ─── TRUST-BASED VISUALS ─────────────────────────────
|
||||
// Wire crystal visual properties to fact trust score (0.0-1.0).
|
||||
// Issue #1166: Trust > 0.8 = bright glow/full opacity,
|
||||
// 0.5-0.8 = medium/80%, < 0.5 = dim/40%, < 0.3 = near-invisible pulsing red.
|
||||
function _getTrustVisuals(trust, regionColor) {
|
||||
const t = Math.max(0, Math.min(1, trust));
|
||||
if (t >= 0.8) {
|
||||
return {
|
||||
opacity: 1.0,
|
||||
emissiveIntensity: 2.0 * t,
|
||||
emissiveColor: regionColor,
|
||||
lightIntensity: 1.2,
|
||||
glowDesc: 'high'
|
||||
};
|
||||
} else if (t >= 0.5) {
|
||||
return {
|
||||
opacity: 0.8,
|
||||
emissiveIntensity: 1.2 * t,
|
||||
emissiveColor: regionColor,
|
||||
lightIntensity: 0.6,
|
||||
glowDesc: 'medium'
|
||||
};
|
||||
} else if (t >= 0.3) {
|
||||
return {
|
||||
opacity: 0.4,
|
||||
emissiveIntensity: 0.5 * t,
|
||||
emissiveColor: regionColor,
|
||||
lightIntensity: 0.2,
|
||||
glowDesc: 'dim'
|
||||
};
|
||||
} else {
|
||||
return {
|
||||
opacity: 0.15,
|
||||
emissiveIntensity: 0.3,
|
||||
emissiveColor: 0xff2200,
|
||||
lightIntensity: 0.1,
|
||||
glowDesc: 'untrusted'
|
||||
};
|
||||
}
|
||||
}
|
||||
|
||||
// ─── REGION MARKER ───────────────────────────────────
|
||||
function createRegionMarker(regionKey, region) {
|
||||
const cx = region.center[0];
|
||||
@@ -260,20 +216,17 @@ const SpatialMemory = (() => {
|
||||
const region = REGIONS[mem.category] || REGIONS.working;
|
||||
const pos = mem.position || _assignPosition(mem.category, mem.id);
|
||||
const strength = Math.max(0.05, Math.min(1, mem.strength != null ? mem.strength : 0.7));
|
||||
const trust = mem.trust != null ? Math.max(0, Math.min(1, mem.trust)) : 0.7;
|
||||
const size = 0.2 + strength * 0.3;
|
||||
|
||||
const tv = _getTrustVisuals(trust, region.color);
|
||||
|
||||
const geo = createCrystalGeometry(size);
|
||||
const mat = new THREE.MeshStandardMaterial({
|
||||
color: region.color,
|
||||
emissive: tv.emissiveColor,
|
||||
emissiveIntensity: tv.emissiveIntensity,
|
||||
emissive: region.color,
|
||||
emissiveIntensity: 1.5 * strength,
|
||||
metalness: 0.6,
|
||||
roughness: 0.15,
|
||||
transparent: true,
|
||||
opacity: tv.opacity
|
||||
opacity: 0.5 + strength * 0.4
|
||||
});
|
||||
|
||||
const crystal = new THREE.Mesh(geo, mat);
|
||||
@@ -286,12 +239,10 @@ const SpatialMemory = (() => {
|
||||
region: mem.category,
|
||||
pulse: Math.random() * Math.PI * 2,
|
||||
strength: strength,
|
||||
trust: trust,
|
||||
glowDesc: tv.glowDesc,
|
||||
createdAt: mem.timestamp || new Date().toISOString()
|
||||
};
|
||||
|
||||
const light = new THREE.PointLight(tv.emissiveColor, tv.lightIntensity, 5);
|
||||
const light = new THREE.PointLight(region.color, 0.8 * strength, 5);
|
||||
crystal.add(light);
|
||||
|
||||
_scene.add(crystal);
|
||||
@@ -304,12 +255,6 @@ const SpatialMemory = (() => {
|
||||
_dirty = true;
|
||||
saveToStorage();
|
||||
console.info('[Mnemosyne] Spatial memory placed:', mem.id, 'in', region.label);
|
||||
|
||||
// Fire particle burst callback
|
||||
if (_onMemoryPlacedCallback) {
|
||||
_onMemoryPlacedCallback(crystal.position.clone(), mem.category || 'working');
|
||||
}
|
||||
|
||||
return crystal;
|
||||
}
|
||||
|
||||
@@ -392,16 +337,8 @@ const SpatialMemory = (() => {
|
||||
mesh.scale.setScalar(pulse);
|
||||
|
||||
if (mesh.material) {
|
||||
const trust = mesh.userData.trust != null ? mesh.userData.trust : 0.7;
|
||||
const base = mesh.userData.strength || 0.7;
|
||||
if (trust < 0.3) {
|
||||
// Low trust: pulsing red — visible warning
|
||||
const pulseAlpha = 0.15 + Math.sin(mesh.userData.pulse * 2.0) * 0.15;
|
||||
mesh.material.emissiveIntensity = 0.3 + Math.sin(mesh.userData.pulse * 2.0) * 0.3;
|
||||
mesh.material.opacity = pulseAlpha;
|
||||
} else {
|
||||
mesh.material.emissiveIntensity = 1.0 + Math.sin(mesh.userData.pulse * 0.7) * 0.5 * base;
|
||||
}
|
||||
mesh.material.emissiveIntensity = 1.0 + Math.sin(mesh.userData.pulse * 0.7) * 0.5 * base;
|
||||
}
|
||||
});
|
||||
|
||||
@@ -431,42 +368,6 @@ const SpatialMemory = (() => {
|
||||
return REGIONS;
|
||||
}
|
||||
|
||||
// ─── UPDATE VISUAL PROPERTIES ────────────────────────
|
||||
// Re-render crystal when trust/strength change (no position move).
|
||||
function updateMemoryVisual(memId, updates) {
|
||||
const obj = _memoryObjects[memId];
|
||||
if (!obj) return false;
|
||||
|
||||
const mesh = obj.mesh;
|
||||
const region = REGIONS[obj.region] || REGIONS.working;
|
||||
|
||||
if (updates.trust != null) {
|
||||
const trust = Math.max(0, Math.min(1, updates.trust));
|
||||
mesh.userData.trust = trust;
|
||||
obj.data.trust = trust;
|
||||
const tv = _getTrustVisuals(trust, region.color);
|
||||
mesh.material.emissive = new THREE.Color(tv.emissiveColor);
|
||||
mesh.material.emissiveIntensity = tv.emissiveIntensity;
|
||||
mesh.material.opacity = tv.opacity;
|
||||
mesh.userData.glowDesc = tv.glowDesc;
|
||||
if (mesh.children.length > 0 && mesh.children[0].isPointLight) {
|
||||
mesh.children[0].intensity = tv.lightIntensity;
|
||||
mesh.children[0].color = new THREE.Color(tv.emissiveColor);
|
||||
}
|
||||
}
|
||||
|
||||
if (updates.strength != null) {
|
||||
const strength = Math.max(0.05, Math.min(1, updates.strength));
|
||||
mesh.userData.strength = strength;
|
||||
obj.data.strength = strength;
|
||||
}
|
||||
|
||||
_dirty = true;
|
||||
saveToStorage();
|
||||
console.info('[Mnemosyne] Visual updated:', memId, 'trust:', mesh.userData.trust, 'glow:', mesh.userData.glowDesc);
|
||||
return true;
|
||||
}
|
||||
|
||||
// ─── QUERY ───────────────────────────────────────────
|
||||
function getMemoryAtPosition(position, maxDist) {
|
||||
maxDist = maxDist || 2;
|
||||
@@ -606,7 +507,6 @@ const SpatialMemory = (() => {
|
||||
source: o.data.source || 'unknown',
|
||||
timestamp: o.data.timestamp || o.mesh.userData.createdAt,
|
||||
strength: o.mesh.userData.strength || 0.7,
|
||||
trust: o.mesh.userData.trust != null ? o.mesh.userData.trust : 0.7,
|
||||
connections: o.data.connections || []
|
||||
}))
|
||||
};
|
||||
@@ -752,173 +652,13 @@ const SpatialMemory = (() => {
|
||||
return _selectedId;
|
||||
}
|
||||
|
||||
// ─── FILE EXPORT ──────────────────────────────────────
|
||||
function exportToFile() {
|
||||
const index = exportIndex();
|
||||
const json = JSON.stringify(index, null, 2);
|
||||
const date = new Date().toISOString().slice(0, 10);
|
||||
const filename = 'mnemosyne-export-' + date + '.json';
|
||||
|
||||
const blob = new Blob([json], { type: 'application/json' });
|
||||
const url = URL.createObjectURL(blob);
|
||||
const a = document.createElement('a');
|
||||
a.href = url;
|
||||
a.download = filename;
|
||||
document.body.appendChild(a);
|
||||
a.click();
|
||||
document.body.removeChild(a);
|
||||
URL.revokeObjectURL(url);
|
||||
|
||||
console.info('[Mnemosyne] Exported', index.memories.length, 'memories to', filename);
|
||||
return { filename, count: index.memories.length };
|
||||
}
|
||||
|
||||
// ─── FILE IMPORT ──────────────────────────────────────
|
||||
function importFromFile(file) {
|
||||
return new Promise((resolve, reject) => {
|
||||
if (!file) {
|
||||
reject(new Error('No file provided'));
|
||||
return;
|
||||
}
|
||||
|
||||
const reader = new FileReader();
|
||||
reader.onload = function(e) {
|
||||
try {
|
||||
const data = JSON.parse(e.target.result);
|
||||
|
||||
// Schema validation
|
||||
if (!data || typeof data !== 'object') {
|
||||
reject(new Error('Invalid JSON: not an object'));
|
||||
return;
|
||||
}
|
||||
if (typeof data.version !== 'number') {
|
||||
reject(new Error('Invalid schema: missing version field'));
|
||||
return;
|
||||
}
|
||||
if (data.version !== STORAGE_VERSION) {
|
||||
reject(new Error('Version mismatch: got ' + data.version + ', expected ' + STORAGE_VERSION));
|
||||
return;
|
||||
}
|
||||
if (!Array.isArray(data.memories)) {
|
||||
reject(new Error('Invalid schema: memories is not an array'));
|
||||
return;
|
||||
}
|
||||
|
||||
// Validate each memory entry
|
||||
for (let i = 0; i < data.memories.length; i++) {
|
||||
const mem = data.memories[i];
|
||||
if (!mem.id || typeof mem.id !== 'string') {
|
||||
reject(new Error('Invalid memory at index ' + i + ': missing or invalid id'));
|
||||
return;
|
||||
}
|
||||
if (!mem.category || typeof mem.category !== 'string') {
|
||||
reject(new Error('Invalid memory "' + mem.id + '": missing category'));
|
||||
return;
|
||||
}
|
||||
}
|
||||
|
||||
const count = importIndex(data);
|
||||
saveToStorage();
|
||||
console.info('[Mnemosyne] Imported', count, 'memories from file');
|
||||
resolve({ count, total: data.memories.length });
|
||||
} catch (parseErr) {
|
||||
reject(new Error('Failed to parse JSON: ' + parseErr.message));
|
||||
}
|
||||
};
|
||||
|
||||
reader.onerror = function() {
|
||||
reject(new Error('Failed to read file'));
|
||||
};
|
||||
|
||||
reader.readAsText(file);
|
||||
});
|
||||
}
|
||||
|
||||
|
||||
// ─── SPATIAL SEARCH (issue #1170) ────────────────────
|
||||
let _searchOriginalState = {}; // memId -> { emissiveIntensity, opacity } for restore
|
||||
|
||||
function searchContent(query) {
|
||||
if (!query || !query.trim()) return [];
|
||||
const q = query.toLowerCase().trim();
|
||||
const matches = [];
|
||||
|
||||
Object.values(_memoryObjects).forEach(obj => {
|
||||
const d = obj.data;
|
||||
const searchable = [
|
||||
d.content || '',
|
||||
d.id || '',
|
||||
d.category || '',
|
||||
d.source || '',
|
||||
...(d.connections || [])
|
||||
].join(' ').toLowerCase();
|
||||
|
||||
if (searchable.includes(q)) {
|
||||
matches.push(d.id);
|
||||
}
|
||||
});
|
||||
|
||||
return matches;
|
||||
}
|
||||
|
||||
function highlightSearchResults(matchIds) {
|
||||
// Save original state and apply search highlighting
|
||||
_searchOriginalState = {};
|
||||
const matchSet = new Set(matchIds);
|
||||
|
||||
Object.entries(_memoryObjects).forEach(([id, obj]) => {
|
||||
const mat = obj.mesh.material;
|
||||
_searchOriginalState[id] = {
|
||||
emissiveIntensity: mat.emissiveIntensity,
|
||||
opacity: mat.opacity
|
||||
};
|
||||
|
||||
if (matchSet.has(id)) {
|
||||
// Match: bright white glow
|
||||
mat.emissive.setHex(0xffffff);
|
||||
mat.emissiveIntensity = 5.0;
|
||||
mat.opacity = 1.0;
|
||||
} else {
|
||||
// Non-match: dim to 10% opacity
|
||||
mat.opacity = 0.1;
|
||||
mat.emissiveIntensity = 0.2;
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
function clearSearch() {
|
||||
Object.entries(_memoryObjects).forEach(([id, obj]) => {
|
||||
const mat = obj.mesh.material;
|
||||
const saved = _searchOriginalState[id];
|
||||
if (saved) {
|
||||
// Restore original emissive color from region
|
||||
const region = REGIONS[obj.region] || REGIONS.working;
|
||||
mat.emissive.copy(region.color);
|
||||
mat.emissiveIntensity = saved.emissiveIntensity;
|
||||
mat.opacity = saved.opacity;
|
||||
}
|
||||
});
|
||||
_searchOriginalState = {};
|
||||
}
|
||||
|
||||
function getSearchMatchPosition(matchId) {
|
||||
const obj = _memoryObjects[matchId];
|
||||
return obj ? obj.mesh.position.clone() : null;
|
||||
}
|
||||
|
||||
function setOnMemoryPlaced(callback) {
|
||||
_onMemoryPlacedCallback = callback;
|
||||
}
|
||||
|
||||
return {
|
||||
init, placeMemory, removeMemory, update, updateMemoryVisual,
|
||||
init, placeMemory, removeMemory, update,
|
||||
getMemoryAtPosition, getRegionAtPosition, getMemoriesInRegion, getAllMemories,
|
||||
getCrystalMeshes, getMemoryFromMesh, highlightMemory, clearHighlight, getSelectedId,
|
||||
exportIndex, importIndex, exportToFile, importFromFile, searchNearby, REGIONS,
|
||||
exportIndex, importIndex, searchNearby, REGIONS,
|
||||
saveToStorage, loadFromStorage, clearStorage,
|
||||
runGravityLayout,
|
||||
searchContent, highlightSearchResults, clearSearch, getSearchMatchPosition,
|
||||
setOnMemoryPlaced
|
||||
runGravityLayout
|
||||
};
|
||||
})();
|
||||
|
||||
|
||||
@@ -1,205 +0,0 @@
|
||||
// ═══════════════════════════════════════════
|
||||
// PROJECT MNEMOSYNE — TIMELINE SCRUBBER
|
||||
// ═══════════════════════════════════════════
|
||||
//
|
||||
// Horizontal timeline bar overlay for scrolling through fact history.
|
||||
// Crystals outside the visible time window fade out.
|
||||
//
|
||||
// Issue: #1169
|
||||
// ═══════════════════════════════════════════
|
||||
|
||||
const TimelineScrubber = (() => {
|
||||
let _container = null;
|
||||
let _bar = null;
|
||||
let _handle = null;
|
||||
let _labels = null;
|
||||
let _spatialMemory = null;
|
||||
let _rangeStart = 0; // 0-1 normalized
|
||||
let _rangeEnd = 1; // 0-1 normalized
|
||||
let _minTimestamp = null;
|
||||
let _maxTimestamp = null;
|
||||
let _active = false;
|
||||
|
||||
const PRESETS = {
|
||||
'hour': { label: 'Last Hour', ms: 3600000 },
|
||||
'day': { label: 'Last Day', ms: 86400000 },
|
||||
'week': { label: 'Last Week', ms: 604800000 },
|
||||
'all': { label: 'All Time', ms: Infinity }
|
||||
};
|
||||
|
||||
// ─── INIT ──────────────────────────────────────────
|
||||
function init(spatialMemory) {
|
||||
_spatialMemory = spatialMemory;
|
||||
_buildDOM();
|
||||
_computeTimeRange();
|
||||
console.info('[Mnemosyne] Timeline scrubber initialized');
|
||||
}
|
||||
|
||||
function _buildDOM() {
|
||||
_container = document.createElement('div');
|
||||
_container.id = 'mnemosyne-timeline';
|
||||
_container.style.cssText = `
|
||||
position: fixed; bottom: 0; left: 0; right: 0; height: 48px;
|
||||
background: rgba(5, 5, 16, 0.85); border-top: 1px solid #1a2a4a;
|
||||
z-index: 1000; display: flex; align-items: center; padding: 0 16px;
|
||||
font-family: monospace; font-size: 12px; color: #8899aa;
|
||||
backdrop-filter: blur(8px); transition: opacity 0.3s;
|
||||
`;
|
||||
|
||||
// Preset buttons
|
||||
const presetDiv = document.createElement('div');
|
||||
presetDiv.style.cssText = 'display: flex; gap: 8px; margin-right: 16px;';
|
||||
Object.entries(PRESETS).forEach(([key, preset]) => {
|
||||
const btn = document.createElement('button');
|
||||
btn.textContent = preset.label;
|
||||
btn.style.cssText = `
|
||||
background: #0a0f28; border: 1px solid #1a2a4a; color: #4af0c0;
|
||||
padding: 4px 8px; cursor: pointer; font-family: monospace; font-size: 11px;
|
||||
border-radius: 3px; transition: background 0.2s;
|
||||
`;
|
||||
btn.onmouseenter = () => btn.style.background = '#1a2a4a';
|
||||
btn.onmouseleave = () => btn.style.background = '#0a0f28';
|
||||
btn.onclick = () => _applyPreset(key);
|
||||
presetDiv.appendChild(btn);
|
||||
});
|
||||
_container.appendChild(presetDiv);
|
||||
|
||||
// Timeline bar
|
||||
_bar = document.createElement('div');
|
||||
_bar.style.cssText = `
|
||||
flex: 1; height: 20px; background: #0a0f28; border: 1px solid #1a2a4a;
|
||||
border-radius: 3px; position: relative; cursor: pointer; margin: 0 8px;
|
||||
`;
|
||||
|
||||
// Handle (draggable range selector)
|
||||
_handle = document.createElement('div');
|
||||
_handle.style.cssText = `
|
||||
position: absolute; top: 0; left: 0%; width: 100%; height: 100%;
|
||||
background: rgba(74, 240, 192, 0.15); border-left: 2px solid #4af0c0;
|
||||
border-right: 2px solid #4af0c0; cursor: ew-resize;
|
||||
`;
|
||||
_bar.appendChild(_handle);
|
||||
_container.appendChild(_bar);
|
||||
|
||||
// Labels
|
||||
_labels = document.createElement('div');
|
||||
_labels.style.cssText = 'min-width: 200px; text-align: right; font-size: 11px;';
|
||||
_labels.textContent = 'All Time';
|
||||
_container.appendChild(_labels);
|
||||
|
||||
// Drag handling
|
||||
let dragging = null;
|
||||
_handle.addEventListener('mousedown', (e) => {
|
||||
dragging = { startX: e.clientX, startLeft: parseFloat(_handle.style.left) || 0, startWidth: parseFloat(_handle.style.width) || 100 };
|
||||
e.preventDefault();
|
||||
});
|
||||
document.addEventListener('mousemove', (e) => {
|
||||
if (!dragging) return;
|
||||
const barRect = _bar.getBoundingClientRect();
|
||||
const dx = (e.clientX - dragging.startX) / barRect.width * 100;
|
||||
let newLeft = Math.max(0, Math.min(100 - dragging.startWidth, dragging.startLeft + dx));
|
||||
_handle.style.left = newLeft + '%';
|
||||
_rangeStart = newLeft / 100;
|
||||
_rangeEnd = (newLeft + dragging.startWidth) / 100;
|
||||
_applyFilter();
|
||||
});
|
||||
document.addEventListener('mouseup', () => { dragging = null; });
|
||||
|
||||
document.body.appendChild(_container);
|
||||
}
|
||||
|
||||
function _computeTimeRange() {
|
||||
if (!_spatialMemory) return;
|
||||
const memories = _spatialMemory.getAllMemories();
|
||||
if (memories.length === 0) return;
|
||||
|
||||
let min = Infinity, max = -Infinity;
|
||||
memories.forEach(m => {
|
||||
const t = new Date(m.timestamp || 0).getTime();
|
||||
if (t < min) min = t;
|
||||
if (t > max) max = t;
|
||||
});
|
||||
_minTimestamp = min;
|
||||
_maxTimestamp = max;
|
||||
}
|
||||
|
||||
function _applyPreset(key) {
|
||||
const preset = PRESETS[key];
|
||||
if (!preset) return;
|
||||
|
||||
if (preset.ms === Infinity) {
|
||||
_rangeStart = 0;
|
||||
_rangeEnd = 1;
|
||||
} else {
|
||||
const now = Date.now();
|
||||
const range = _maxTimestamp - _minTimestamp;
|
||||
if (range <= 0) return;
|
||||
const cutoff = now - preset.ms;
|
||||
_rangeStart = Math.max(0, (cutoff - _minTimestamp) / range);
|
||||
_rangeEnd = 1;
|
||||
}
|
||||
|
||||
_handle.style.left = (_rangeStart * 100) + '%';
|
||||
_handle.style.width = ((_rangeEnd - _rangeStart) * 100) + '%';
|
||||
_labels.textContent = preset.label;
|
||||
_applyFilter();
|
||||
}
|
||||
|
||||
function _applyFilter() {
|
||||
if (!_spatialMemory) return;
|
||||
const range = _maxTimestamp - _minTimestamp;
|
||||
if (range <= 0) return;
|
||||
|
||||
const startMs = _minTimestamp + range * _rangeStart;
|
||||
const endMs = _minTimestamp + range * _rangeEnd;
|
||||
|
||||
_spatialMemory.getCrystalMeshes().forEach(mesh => {
|
||||
const ts = new Date(mesh.userData.createdAt || 0).getTime();
|
||||
if (ts >= startMs && ts <= endMs) {
|
||||
mesh.visible = true;
|
||||
// Smooth restore
|
||||
if (mesh.material) mesh.material.opacity = mesh.userData._savedOpacity || mesh.material.opacity;
|
||||
} else {
|
||||
// Fade out
|
||||
if (mesh.material) {
|
||||
mesh.userData._savedOpacity = mesh.userData._savedOpacity || mesh.material.opacity;
|
||||
mesh.material.opacity = 0.02;
|
||||
}
|
||||
}
|
||||
});
|
||||
|
||||
// Update label with date range
|
||||
const startStr = new Date(startMs).toLocaleDateString();
|
||||
const endStr = new Date(endMs).toLocaleDateString();
|
||||
_labels.textContent = startStr + ' — ' + endStr;
|
||||
}
|
||||
|
||||
function update() {
|
||||
_computeTimeRange();
|
||||
}
|
||||
|
||||
function show() {
|
||||
if (_container) _container.style.display = 'flex';
|
||||
_active = true;
|
||||
}
|
||||
|
||||
function hide() {
|
||||
if (_container) _container.style.display = 'none';
|
||||
_active = false;
|
||||
// Restore all crystals
|
||||
if (_spatialMemory) {
|
||||
_spatialMemory.getCrystalMeshes().forEach(mesh => {
|
||||
mesh.visible = true;
|
||||
if (mesh.material && mesh.userData._savedOpacity) {
|
||||
mesh.material.opacity = mesh.userData._savedOpacity;
|
||||
}
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
function isActive() { return _active; }
|
||||
|
||||
return { init, update, show, hide, isActive };
|
||||
})();
|
||||
|
||||
export { TimelineScrubber };
|
||||
@@ -1,97 +0,0 @@
|
||||
# Bannerlord Session Trace — Replay & Eval Guide
|
||||
|
||||
## Storage Layout
|
||||
|
||||
All traces live under `~/.timmy/traces/bannerlord/`:
|
||||
|
||||
```
|
||||
~/.timmy/traces/bannerlord/
|
||||
trace_<trace_id>.jsonl # One line per ODA cycle (full state + actions)
|
||||
manifest_<trace_id>.json # Session metadata, counts, replay command
|
||||
```
|
||||
|
||||
## Trace Format (JSONL)
|
||||
|
||||
Each line is one ODA cycle:
|
||||
|
||||
```json
|
||||
{
|
||||
"cycle_index": 0,
|
||||
"timestamp_start": "2026-04-10T20:15:00+00:00",
|
||||
"timestamp_end": "2026-04-10T20:15:45+00:00",
|
||||
"duration_ms": 45000,
|
||||
|
||||
"screenshot_path": "/tmp/bannerlord_capture_1744320900.png",
|
||||
"window_found": true,
|
||||
"screen_size": [1920, 1080],
|
||||
"mouse_position": [960, 540],
|
||||
"playtime_hours": 142.5,
|
||||
"players_online": 8421,
|
||||
"is_running": true,
|
||||
|
||||
"actions_planned": [{"type": "move_to", "x": 960, "y": 540}],
|
||||
"actions_executed": [{"success": true, "action": "move_to", ...}],
|
||||
"actions_succeeded": 1,
|
||||
"actions_failed": 0,
|
||||
|
||||
"hermes_session_id": "f47ac10b",
|
||||
"hermes_log_id": "",
|
||||
"harness_session_id": "f47ac10b"
|
||||
}
|
||||
```
|
||||
|
||||
## Capturing a Trace
|
||||
|
||||
```bash
|
||||
# Run harness with trace logging enabled
|
||||
cd /path/to/the-nexus
|
||||
python -m nexus.bannerlord_harness --mock --trace --iterations 3
|
||||
```
|
||||
|
||||
The trace and manifest are written to `~/.timmy/traces/bannerlord/` on harness shutdown.
|
||||
|
||||
## Replay Protocol
|
||||
|
||||
1. Load a trace: `BannerlordTraceLogger.load_trace(trace_file)`
|
||||
2. Create a fresh harness in mock mode
|
||||
3. For each cycle in the trace:
|
||||
- Re-execute the `actions_planned` list
|
||||
- Compare actual `actions_executed` outcomes against the recorded ones
|
||||
4. Score: `(matching_actions / total_actions) * 100`
|
||||
|
||||
### Eval Criteria
|
||||
|
||||
| Score | Grade | Meaning |
|
||||
|---------|----------|--------------------------------------------|
|
||||
| >= 90% | PASS | Replay matches original closely |
|
||||
| 70-89% | PARTIAL | Some divergence, investigate differences |
|
||||
| < 70% | FAIL | Significant drift, review action semantics |
|
||||
|
||||
## Replay Script (sketch)
|
||||
|
||||
```python
|
||||
from nexus.bannerlord_trace import BannerlordTraceLogger
|
||||
from nexus.bannerlord_harness import BannerlordHarness
|
||||
|
||||
# Load trace
|
||||
cycles = BannerlordTraceLogger.load_trace(
|
||||
Path.home() / ".timmy" / "traces" / "bannerlord" / "trace_bl_xxx.jsonl"
|
||||
)
|
||||
|
||||
# Replay
|
||||
harness = BannerlordHarness(enable_mock=True, enable_trace=False)
|
||||
await harness.start()
|
||||
|
||||
for cycle in cycles:
|
||||
for action in cycle["actions_planned"]:
|
||||
result = await harness.execute_action(action)
|
||||
# Compare result against cycle["actions_executed"]
|
||||
|
||||
await harness.stop()
|
||||
```
|
||||
|
||||
## Hermes Session Mapping
|
||||
|
||||
The `hermes_session_id` and `hermes_log_id` fields link traces to Hermes session logs.
|
||||
When a trace is captured during a live Hermes session, populate these fields so
|
||||
the trace can be correlated with the broader agent conversation context.
|
||||
@@ -1,18 +0,0 @@
|
||||
{
|
||||
"trace_id": "bl_20260410_201500_a1b2c3",
|
||||
"harness_session_id": "f47ac10b",
|
||||
"hermes_session_id": "f47ac10b",
|
||||
"hermes_log_id": "",
|
||||
"game": "Mount & Blade II: Bannerlord",
|
||||
"app_id": 261550,
|
||||
"started_at": "2026-04-10T20:15:00+00:00",
|
||||
"finished_at": "2026-04-10T20:17:30+00:00",
|
||||
"total_cycles": 3,
|
||||
"total_actions": 6,
|
||||
"total_succeeded": 6,
|
||||
"total_failed": 0,
|
||||
"trace_file": "~/.timmy/traces/bannerlord/trace_bl_20260410_201500_a1b2c3.jsonl",
|
||||
"trace_dir": "~/.timmy/traces/bannerlord",
|
||||
"replay_command": "python -m nexus.bannerlord_harness --mock --replay ~/.timmy/traces/bannerlord/trace_bl_20260410_201500_a1b2c3.jsonl",
|
||||
"eval_note": "To replay: load trace, re-execute each cycle's actions_planned against a fresh harness in mock mode, compare actions_executed outcomes. Success metric: >=90% action parity between original and replay runs."
|
||||
}
|
||||
@@ -1,3 +0,0 @@
|
||||
{"cycle_index": 0, "timestamp_start": "2026-04-10T20:15:00+00:00", "timestamp_end": "2026-04-10T20:15:45+00:00", "duration_ms": 45000, "screenshot_path": "/tmp/bannerlord_capture_1744320900.png", "window_found": true, "screen_size": [1920, 1080], "mouse_position": [960, 540], "playtime_hours": 142.5, "players_online": 8421, "is_running": true, "actions_planned": [{"type": "move_to", "x": 960, "y": 540}, {"type": "press_key", "key": "space"}], "decision_note": "Initial state capture. Move to screen center and press space to advance.", "actions_executed": [{"success": true, "action": "move_to", "params": {"type": "move_to", "x": 960, "y": 540}, "timestamp": "2026-04-10T20:15:30+00:00", "error": null}, {"success": true, "action": "press_key", "params": {"type": "press_key", "key": "space"}, "timestamp": "2026-04-10T20:15:45+00:00", "error": null}], "actions_succeeded": 2, "actions_failed": 0, "hermes_session_id": "f47ac10b", "hermes_log_id": "", "harness_session_id": "f47ac10b"}
|
||||
{"cycle_index": 1, "timestamp_start": "2026-04-10T20:15:45+00:00", "timestamp_end": "2026-04-10T20:16:30+00:00", "duration_ms": 45000, "screenshot_path": "/tmp/bannerlord_capture_1744320945.png", "window_found": true, "screen_size": [1920, 1080], "mouse_position": [960, 540], "playtime_hours": 142.5, "players_online": 8421, "is_running": true, "actions_planned": [{"type": "press_key", "key": "p"}], "decision_note": "Open party screen to inspect troops.", "actions_executed": [{"success": true, "action": "press_key", "params": {"type": "press_key", "key": "p"}, "timestamp": "2026-04-10T20:16:00+00:00", "error": null}], "actions_succeeded": 1, "actions_failed": 0, "hermes_session_id": "f47ac10b", "hermes_log_id": "", "harness_session_id": "f47ac10b"}
|
||||
{"cycle_index": 2, "timestamp_start": "2026-04-10T20:16:30+00:00", "timestamp_end": "2026-04-10T20:17:30+00:00", "duration_ms": 60000, "screenshot_path": "/tmp/bannerlord_capture_1744321020.png", "window_found": true, "screen_size": [1920, 1080], "mouse_position": [960, 540], "playtime_hours": 142.5, "players_online": 8421, "is_running": true, "actions_planned": [{"type": "press_key", "key": "escape"}, {"type": "move_to", "x": 500, "y": 300}, {"type": "click", "x": 500, "y": 300}], "decision_note": "Close party screen, click on campaign map settlement.", "actions_executed": [{"success": true, "action": "press_key", "params": {"type": "press_key", "key": "escape"}, "timestamp": "2026-04-10T20:16:45+00:00", "error": null}, {"success": true, "action": "move_to", "params": {"type": "move_to", "x": 500, "y": 300}, "timestamp": "2026-04-10T20:17:00+00:00", "error": null}, {"success": true, "action": "click", "params": {"type": "click", "x": 500, "y": 300}, "timestamp": "2026-04-10T20:17:30+00:00", "error": null}], "actions_succeeded": 3, "actions_failed": 0, "hermes_session_id": "f47ac10b", "hermes_log_id": "", "harness_session_id": "f47ac10b"}
|
||||
13
portals.json
13
portals.json
@@ -17,7 +17,7 @@
|
||||
"id": "bannerlord",
|
||||
"name": "Bannerlord",
|
||||
"description": "Calradia battle harness. Massive armies, tactical command.",
|
||||
"status": "downloaded",
|
||||
"status": "active",
|
||||
"color": "#ffd700",
|
||||
"position": { "x": -15, "y": 0, "z": -10 },
|
||||
"rotation": { "y": 0.5 },
|
||||
@@ -25,20 +25,13 @@
|
||||
"world_category": "strategy-rpg",
|
||||
"environment": "production",
|
||||
"access_mode": "operator",
|
||||
"readiness_state": "downloaded",
|
||||
"readiness_steps": {
|
||||
"downloaded": { "label": "Downloaded", "done": true },
|
||||
"runtime_ready": { "label": "Runtime Ready", "done": false },
|
||||
"launched": { "label": "Launched", "done": false },
|
||||
"harness_bridged": { "label": "Harness Bridged", "done": false }
|
||||
},
|
||||
"blocked_reason": null,
|
||||
"readiness_state": "active",
|
||||
"telemetry_source": "hermes-harness:bannerlord",
|
||||
"owner": "Timmy",
|
||||
"app_id": 261550,
|
||||
"window_title": "Mount & Blade II: Bannerlord",
|
||||
"destination": {
|
||||
"url": null,
|
||||
"url": "https://bannerlord.timmy.foundation",
|
||||
"type": "harness",
|
||||
"action_label": "Enter Calradia",
|
||||
"params": { "world": "calradia" }
|
||||
|
||||
383
style.css
383
style.css
@@ -200,61 +200,6 @@ canvas#nexus-canvas {
|
||||
box-shadow: 0 0 20px var(--color-primary);
|
||||
}
|
||||
|
||||
/* === TOOLTIP SYSTEM === */
|
||||
/* Any element with data-tooltip gets a hover tooltip label */
|
||||
[data-tooltip] {
|
||||
position: relative;
|
||||
}
|
||||
[data-tooltip]::after {
|
||||
content: attr(data-tooltip);
|
||||
position: absolute;
|
||||
right: calc(100% + 10px);
|
||||
top: 50%;
|
||||
transform: translateY(-50%);
|
||||
background: rgba(5, 5, 16, 0.95);
|
||||
color: var(--color-primary);
|
||||
font-family: var(--font-body);
|
||||
font-size: 11px;
|
||||
letter-spacing: 0.05em;
|
||||
padding: 4px 10px;
|
||||
border: 1px solid var(--color-primary-dim);
|
||||
border-radius: 4px;
|
||||
white-space: nowrap;
|
||||
pointer-events: none;
|
||||
opacity: 0;
|
||||
transition: opacity 0.2s ease;
|
||||
backdrop-filter: blur(8px);
|
||||
box-shadow: 0 0 12px rgba(74, 240, 192, 0.15);
|
||||
z-index: 100;
|
||||
}
|
||||
[data-tooltip]:hover::after,
|
||||
[data-tooltip]:focus-visible::after {
|
||||
opacity: 1;
|
||||
}
|
||||
/* For elements positioned on the right side, tooltip appears to the left */
|
||||
.hud-top-right [data-tooltip]::after {
|
||||
right: calc(100% + 10px);
|
||||
}
|
||||
/* For inline/badge elements where right-side tooltip might clip */
|
||||
.hud-status-item[data-tooltip]::after {
|
||||
right: auto;
|
||||
left: calc(100% + 10px);
|
||||
}
|
||||
|
||||
/* Focus-visible ring for keyboard navigation */
|
||||
.hud-icon-btn:focus-visible,
|
||||
.hud-status-item:focus-visible,
|
||||
.atlas-close-btn:focus-visible,
|
||||
.vision-close-btn:focus-visible,
|
||||
.portal-close-btn:focus-visible,
|
||||
.memory-panel-close:focus-visible,
|
||||
.memory-panel-pin:focus-visible,
|
||||
.session-room-close:focus-visible {
|
||||
outline: 2px solid var(--color-primary);
|
||||
outline-offset: 2px;
|
||||
box-shadow: 0 0 16px rgba(74, 240, 192, 0.4);
|
||||
}
|
||||
|
||||
.hud-status-item {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
@@ -422,142 +367,6 @@ canvas#nexus-canvas {
|
||||
.status-online { background: rgba(74, 240, 192, 0.2); color: var(--color-primary); border: 1px solid var(--color-primary); }
|
||||
.status-standby { background: rgba(255, 215, 0, 0.2); color: var(--color-gold); border: 1px solid var(--color-gold); }
|
||||
.status-offline { background: rgba(255, 68, 102, 0.2); color: var(--color-danger); border: 1px solid var(--color-danger); }
|
||||
.status-active { background: rgba(74, 240, 192, 0.2); color: var(--color-primary); border: 1px solid var(--color-primary); }
|
||||
.status-blocked { background: rgba(255, 68, 102, 0.3); color: #ff4466; border: 1px solid #ff4466; }
|
||||
.status-downloaded { background: rgba(100, 149, 237, 0.2); color: #6495ed; border: 1px solid #6495ed; }
|
||||
.status-runtime_ready { background: rgba(255, 165, 0, 0.2); color: #ffa500; border: 1px solid #ffa500; }
|
||||
.status-launched { background: rgba(255, 215, 0, 0.2); color: var(--color-gold); border: 1px solid var(--color-gold); }
|
||||
.status-harness_bridged { background: rgba(74, 240, 192, 0.2); color: var(--color-primary); border: 1px solid var(--color-primary); }
|
||||
|
||||
/* Readiness Progress Bar (atlas card) */
|
||||
.atlas-card-readiness {
|
||||
margin-top: 10px;
|
||||
padding-top: 10px;
|
||||
border-top: 1px solid rgba(255,255,255,0.06);
|
||||
}
|
||||
.readiness-bar-track {
|
||||
width: 100%;
|
||||
height: 4px;
|
||||
background: rgba(255,255,255,0.08);
|
||||
border-radius: 2px;
|
||||
overflow: hidden;
|
||||
margin-bottom: 6px;
|
||||
}
|
||||
.readiness-bar-fill {
|
||||
height: 100%;
|
||||
border-radius: 2px;
|
||||
transition: width 0.4s ease;
|
||||
}
|
||||
.readiness-steps-mini {
|
||||
display: flex;
|
||||
gap: 6px;
|
||||
font-size: 9px;
|
||||
font-family: var(--font-body);
|
||||
letter-spacing: 0.05em;
|
||||
color: var(--color-text-muted);
|
||||
}
|
||||
.readiness-step {
|
||||
padding: 1px 5px;
|
||||
border-radius: 2px;
|
||||
background: rgba(255,255,255,0.04);
|
||||
}
|
||||
.readiness-step.done {
|
||||
background: rgba(74, 240, 192, 0.15);
|
||||
color: var(--color-primary);
|
||||
}
|
||||
.readiness-step.current {
|
||||
background: rgba(255, 215, 0, 0.15);
|
||||
color: var(--color-gold);
|
||||
}
|
||||
.atlas-card-blocked {
|
||||
margin-top: 6px;
|
||||
font-size: 10px;
|
||||
color: #ff4466;
|
||||
font-family: var(--font-body);
|
||||
}
|
||||
|
||||
/* Readiness Detail (portal overlay) */
|
||||
.portal-readiness-detail {
|
||||
margin-top: 16px;
|
||||
padding: 12px 16px;
|
||||
background: rgba(0,0,0,0.3);
|
||||
border: 1px solid rgba(255,255,255,0.08);
|
||||
border-radius: 4px;
|
||||
}
|
||||
.portal-readiness-title {
|
||||
font-family: var(--font-display);
|
||||
font-size: 10px;
|
||||
letter-spacing: 0.15em;
|
||||
color: var(--color-text-muted);
|
||||
margin-bottom: 10px;
|
||||
text-transform: uppercase;
|
||||
}
|
||||
.portal-readiness-step {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
padding: 4px 0;
|
||||
font-family: var(--font-body);
|
||||
font-size: 11px;
|
||||
color: rgba(255,255,255,0.4);
|
||||
}
|
||||
.portal-readiness-step .step-dot {
|
||||
width: 8px;
|
||||
height: 8px;
|
||||
border-radius: 50%;
|
||||
background: rgba(255,255,255,0.15);
|
||||
flex-shrink: 0;
|
||||
}
|
||||
.portal-readiness-step.done .step-dot {
|
||||
background: var(--color-primary);
|
||||
box-shadow: 0 0 6px var(--color-primary);
|
||||
}
|
||||
.portal-readiness-step.done {
|
||||
color: var(--color-primary);
|
||||
}
|
||||
.portal-readiness-step.current .step-dot {
|
||||
background: var(--color-gold);
|
||||
box-shadow: 0 0 6px var(--color-gold);
|
||||
animation: pulse-dot 1.5s ease-in-out infinite;
|
||||
}
|
||||
.portal-readiness-step.current {
|
||||
color: #fff;
|
||||
}
|
||||
@keyframes pulse-dot {
|
||||
0%, 100% { opacity: 1; }
|
||||
50% { opacity: 0.4; }
|
||||
}
|
||||
.portal-readiness-blocked {
|
||||
margin-top: 8px;
|
||||
padding: 6px 10px;
|
||||
background: rgba(255, 68, 102, 0.1);
|
||||
border: 1px solid rgba(255, 68, 102, 0.3);
|
||||
border-radius: 3px;
|
||||
font-size: 11px;
|
||||
color: #ff4466;
|
||||
font-family: var(--font-body);
|
||||
}
|
||||
.portal-readiness-hint {
|
||||
margin-top: 8px;
|
||||
font-size: 10px;
|
||||
color: var(--color-text-muted);
|
||||
font-family: var(--font-body);
|
||||
font-style: italic;
|
||||
}
|
||||
|
||||
/* HUD Status for readiness states */
|
||||
.hud-status-item.downloaded .status-dot { background: #6495ed; box-shadow: 0 0 5px #6495ed; }
|
||||
.hud-status-item.runtime_ready .status-dot { background: #ffa500; box-shadow: 0 0 5px #ffa500; }
|
||||
.hud-status-item.launched .status-dot { background: var(--color-gold); box-shadow: 0 0 5px var(--color-gold); }
|
||||
.hud-status-item.harness_bridged .status-dot { background: var(--color-primary); box-shadow: 0 0 5px var(--color-primary); }
|
||||
.hud-status-item.blocked .status-dot { background: #ff4466; box-shadow: 0 0 5px #ff4466; }
|
||||
.hud-status-item.downloaded .status-label,
|
||||
.hud-status-item.runtime_ready .status-label,
|
||||
.hud-status-item.launched .status-label,
|
||||
.hud-status-item.harness_bridged .status-label,
|
||||
.hud-status-item.blocked .status-label {
|
||||
color: #fff;
|
||||
}
|
||||
|
||||
.atlas-card-desc {
|
||||
font-size: 12px;
|
||||
@@ -1174,7 +983,7 @@ canvas#nexus-canvas {
|
||||
|
||||
.chat-quick-actions {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
flex-wrap: wrap;
|
||||
gap: 6px;
|
||||
padding: 8px 12px;
|
||||
border-top: 1px solid var(--color-border);
|
||||
@@ -1182,75 +991,6 @@ canvas#nexus-canvas {
|
||||
pointer-events: auto;
|
||||
}
|
||||
|
||||
.chat-quick-actions.hidden {
|
||||
display: none;
|
||||
}
|
||||
|
||||
.starter-label {
|
||||
font-family: var(--font-display);
|
||||
font-size: 9px;
|
||||
letter-spacing: 0.15em;
|
||||
color: var(--color-primary-dim);
|
||||
text-transform: uppercase;
|
||||
padding: 0 2px;
|
||||
}
|
||||
|
||||
.starter-grid {
|
||||
display: grid;
|
||||
grid-template-columns: repeat(3, 1fr);
|
||||
gap: 4px;
|
||||
}
|
||||
|
||||
.starter-btn {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: flex-start;
|
||||
gap: 1px;
|
||||
background: rgba(74, 240, 192, 0.06);
|
||||
border: 1px solid rgba(74, 240, 192, 0.15);
|
||||
color: var(--color-primary);
|
||||
font-family: var(--font-body);
|
||||
padding: 6px 8px;
|
||||
cursor: pointer;
|
||||
transition: all var(--transition-ui);
|
||||
text-align: left;
|
||||
}
|
||||
|
||||
.starter-btn:hover {
|
||||
background: rgba(74, 240, 192, 0.15);
|
||||
border-color: var(--color-primary);
|
||||
color: #fff;
|
||||
}
|
||||
|
||||
.starter-btn:hover .starter-icon {
|
||||
color: #fff;
|
||||
}
|
||||
|
||||
.starter-btn:active {
|
||||
transform: scale(0.97);
|
||||
}
|
||||
|
||||
.starter-icon {
|
||||
font-size: 12px;
|
||||
color: var(--color-primary);
|
||||
line-height: 1;
|
||||
}
|
||||
|
||||
.starter-text {
|
||||
font-size: 10px;
|
||||
font-weight: 600;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.starter-desc {
|
||||
font-size: 8px;
|
||||
color: rgba(74, 240, 192, 0.5);
|
||||
white-space: nowrap;
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
max-width: 100%;
|
||||
}
|
||||
|
||||
/* Add hover effect for MemPalace mining button */
|
||||
.quick-action-btn:hover {
|
||||
background: var(--color-primary-dim);
|
||||
@@ -1396,9 +1136,6 @@ canvas#nexus-canvas {
|
||||
.hud-location {
|
||||
font-size: var(--text-xs);
|
||||
}
|
||||
.starter-grid {
|
||||
grid-template-columns: repeat(2, 1fr);
|
||||
}
|
||||
}
|
||||
|
||||
@media (max-width: 480px) {
|
||||
@@ -1724,43 +1461,6 @@ canvas#nexus-canvas {
|
||||
gap: 2px;
|
||||
}
|
||||
|
||||
/* ═══════════════════════════════════════════════════════
|
||||
PROJECT MNEMOSYNE — EXPORT/IMPORT ACTIONS (#1174)
|
||||
═══════════════════════════════════════════════════════ */
|
||||
|
||||
.memory-panel-actions {
|
||||
display: flex;
|
||||
gap: 8px;
|
||||
margin-top: 10px;
|
||||
padding-top: 10px;
|
||||
border-top: 1px solid rgba(123, 92, 255, 0.15);
|
||||
}
|
||||
|
||||
.mnemosyne-action-btn {
|
||||
flex: 1;
|
||||
padding: 6px 10px;
|
||||
background: rgba(123, 92, 255, 0.12);
|
||||
border: 1px solid rgba(123, 92, 255, 0.3);
|
||||
border-radius: 6px;
|
||||
color: #a08cff;
|
||||
font-size: 11px;
|
||||
font-family: monospace;
|
||||
cursor: pointer;
|
||||
transition: all 0.15s ease;
|
||||
text-align: center;
|
||||
white-space: nowrap;
|
||||
}
|
||||
|
||||
.mnemosyne-action-btn:hover {
|
||||
background: rgba(123, 92, 255, 0.25);
|
||||
border-color: rgba(123, 92, 255, 0.6);
|
||||
color: #c4b5ff;
|
||||
}
|
||||
|
||||
.mnemosyne-action-btn:active {
|
||||
transform: scale(0.96);
|
||||
}
|
||||
|
||||
/* ═══════════════════════════════════════════════════════
|
||||
PROJECT MNEMOSYNE — SESSION ROOM HUD PANEL (#1171)
|
||||
═══════════════════════════════════════════════════════ */
|
||||
@@ -1880,84 +1580,3 @@ canvas#nexus-canvas {
|
||||
text-transform: uppercase;
|
||||
}
|
||||
|
||||
|
||||
/* ═══ SPATIAL SEARCH OVERLAY (Mnemosyne #1170) ═══ */
|
||||
.spatial-search-overlay {
|
||||
position: fixed;
|
||||
top: 12px;
|
||||
right: 12px;
|
||||
z-index: 100;
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: flex-end;
|
||||
font-family: 'JetBrains Mono', monospace;
|
||||
}
|
||||
|
||||
.spatial-search-input {
|
||||
width: 260px;
|
||||
padding: 8px 14px;
|
||||
background: rgba(0, 0, 0, 0.65);
|
||||
border: 1px solid rgba(74, 240, 192, 0.3);
|
||||
border-radius: 6px;
|
||||
color: #e0f0ff;
|
||||
font-family: 'JetBrains Mono', monospace;
|
||||
font-size: 13px;
|
||||
outline: none;
|
||||
backdrop-filter: blur(8px);
|
||||
transition: border-color 0.2s, box-shadow 0.2s;
|
||||
}
|
||||
|
||||
.spatial-search-input:focus {
|
||||
border-color: rgba(74, 240, 192, 0.7);
|
||||
box-shadow: 0 0 12px rgba(74, 240, 192, 0.15);
|
||||
}
|
||||
|
||||
.spatial-search-input::placeholder {
|
||||
color: rgba(224, 240, 255, 0.35);
|
||||
}
|
||||
|
||||
.spatial-search-results {
|
||||
margin-top: 4px;
|
||||
max-height: 200px;
|
||||
overflow-y: auto;
|
||||
background: rgba(0, 0, 0, 0.55);
|
||||
border: 1px solid rgba(74, 240, 192, 0.15);
|
||||
border-radius: 4px;
|
||||
font-size: 11px;
|
||||
color: #a0c0d0;
|
||||
width: 260px;
|
||||
backdrop-filter: blur(8px);
|
||||
display: none;
|
||||
}
|
||||
|
||||
.spatial-search-results.visible {
|
||||
display: block;
|
||||
}
|
||||
|
||||
.spatial-search-result-item {
|
||||
padding: 5px 10px;
|
||||
cursor: pointer;
|
||||
border-bottom: 1px solid rgba(74, 240, 192, 0.08);
|
||||
white-space: nowrap;
|
||||
overflow: hidden;
|
||||
text-overflow: ellipsis;
|
||||
}
|
||||
|
||||
.spatial-search-result-item:hover {
|
||||
background: rgba(74, 240, 192, 0.1);
|
||||
color: #e0f0ff;
|
||||
}
|
||||
|
||||
.spatial-search-result-item .result-region {
|
||||
color: #4af0c0;
|
||||
font-size: 9px;
|
||||
margin-right: 6px;
|
||||
}
|
||||
|
||||
.spatial-search-count {
|
||||
padding: 4px 10px;
|
||||
color: rgba(74, 240, 192, 0.6);
|
||||
font-size: 10px;
|
||||
border-bottom: 1px solid rgba(74, 240, 192, 0.1);
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user