improve doc + bugfix

This commit is contained in:
Pierre
2026-05-25 23:47:48 +02:00
parent 8e50b85e08
commit b100b3a77c
3 changed files with 19 additions and 19 deletions
+11 -11
View File
@@ -84,7 +84,7 @@ Meta-Fuse is a read-only process in the MetaMesh ecosystem that:
│ [3] meta-stremio (PROCESS-READ) │ │ [3] meta-stremio (PROCESS-READ) │
│ └─► Reads metadata from KV, streams media content │ │ └─► Reads metadata from KV, streams media content │
│ │ │ │
│ [4] meta-orbit (SHARING-READ-WRITE) │ │ [4] meta-share (SHARING-READ-WRITE) │
│ └─► P2P metadata sync across network │ │ └─► P2P metadata sync across network │
│ │ │ │
└────────────────────────────────────────────────────────────────────────────┘ └────────────────────────────────────────────────────────────────────────────┘
@@ -104,7 +104,7 @@ http://meta-core:9000
/urls API Response (JSON): /urls API Response (JSON):
{ {
"hostname": "meta-core-dev", "hostname": "metacore-app",
"baseUrl": "http://localhost:8083", "baseUrl": "http://localhost:8083",
"apiUrl": "http://meta-core:9000", "apiUrl": "http://meta-core:9000",
"redisUrl": "redis://meta-core:6379", "redisUrl": "redis://meta-core:6379",
@@ -606,10 +606,10 @@ journalctl -u meta-fuse-driver -f
cat /meta-core/locks/kv-leader.info cat /meta-core/locks/kv-leader.info
# Check /urls API # Check /urls API
curl -k https://dev.localhost:8083/api/urls curl -k https://metacore-dev.localhost:8083/api/urls
# Verify redis is running (on leader) # Verify redis is running (on leader)
docker exec meta-core-dev redis-cli ping docker exec metacore-app redis-cli ping
# Check meta-fuse logs # Check meta-fuse logs
docker logs meta-fuse | grep "KV" docker logs meta-fuse | grep "KV"
@@ -632,10 +632,10 @@ docker logs meta-fuse | grep "wsgidav"
```bash ```bash
# Check Redis has file data (flat key format) # Check Redis has file data (flat key format)
docker exec meta-core-dev redis-cli keys "file:*" | head -20 docker exec metacore-app redis-cli keys "file:*" | head -20
# Check file index # Check file index
docker exec meta-core-dev redis-cli scard "file:__index__" docker exec metacore-app redis-cli scard "file:__index__"
# Verify source files exist # Verify source files exist
ls -la /files/watch/ ls -la /files/watch/
@@ -644,7 +644,7 @@ ls -la /files/watch/
curl http://localhost:3000/api/fuse/stats curl http://localhost:3000/api/fuse/stats
# Check streaming state builder stats # Check streaming state builder stats
docker logs meta-fuse-dev | grep "State builder" docker logs metafuse-app | grep "State builder"
``` ```
## Technology Stack ## Technology Stack
@@ -665,7 +665,7 @@ Meta-Fuse is designed to work seamlessly with other MetaMesh services:
- **meta-sort**: Provides metadata in KV database - **meta-sort**: Provides metadata in KV database
- **meta-stremio**: Can stream files exposed by meta-fuse - **meta-stremio**: Can stream files exposed by meta-fuse
- **meta-orbit**: Syncs metadata across P2P network - **meta-share**: Syncs metadata across P2P network
### Connecting to meta-sort ### Connecting to meta-sort
@@ -673,13 +673,13 @@ Ensure meta-sort is running and has processed files:
```bash ```bash
# Check meta-sort processing status # Check meta-sort processing status
curl -k https://dev.localhost:8180/api/processing/status curl -k https://metasort-dev.localhost:8180/api/processing/status
# Verify Redis has metadata (via meta-core) # Verify Redis has metadata (via meta-core)
docker exec meta-core-dev redis-cli scard "file:__index__" docker exec metacore-app redis-cli scard "file:__index__"
# Check meta:events stream has events # Check meta:events stream has events
docker exec meta-core-dev redis-cli xlen "meta:events" docker exec metacore-app redis-cli xlen "meta:events"
``` ```
Meta-fuse will automatically discover the KV database through the shared lock file at `/meta-core/locks/kv-leader.info`. Meta-fuse will automatically discover the KV database through the shared lock file at `/meta-core/locks/kv-leader.info`.
+7 -7
View File
@@ -535,29 +535,29 @@ List all discovered MetaMesh services.
"services": [ "services": [
{ {
"name": "meta-sort", "name": "meta-sort",
"url": "http://meta-sort-dev", "url": "http://metasort-app",
"api": "http://meta-sort-dev/api", "api": "http://metasort-app/api",
"status": "healthy", "status": "healthy",
"role": "writer" "role": "writer"
}, },
{ {
"name": "meta-fuse", "name": "meta-fuse",
"url": "http://meta-fuse-dev", "url": "http://metafuse-app",
"api": "http://meta-fuse-dev/api", "api": "http://metafuse-app/api",
"status": "healthy", "status": "healthy",
"role": "reader" "role": "reader"
}, },
{ {
"name": "meta-stremio", "name": "meta-stremio",
"url": "http://meta-stremio-dev", "url": "http://metastremio-app",
"api": "http://meta-stremio-dev/api", "api": "http://metastremio-app/api",
"status": "healthy", "status": "healthy",
"role": "reader" "role": "reader"
} }
], ],
"current": "meta-fuse", "current": "meta-fuse",
"leader": { "leader": {
"hostname": "meta-core-dev", "hostname": "metacore-app",
"baseUrl": "http://localhost:8083", "baseUrl": "http://localhost:8083",
"apiUrl": "http://meta-core:9000", "apiUrl": "http://meta-core:9000",
"redisUrl": "redis://meta-core:6379", "redisUrl": "redis://meta-core:6379",
+1 -1
View File
@@ -350,7 +350,7 @@ The `onFileComplete` callback is called when:
``` ```
[meta-fuse] Starting meta-fuse... [meta-fuse] Starting meta-fuse...
[KVManager] Waiting for leader... [KVManager] Waiting for leader...
[LeaderClient] Leader found: meta-core-dev at redis://meta-core:6379 [LeaderClient] Leader found: metacore-app at redis://meta-core:6379
[meta-fuse] KV Manager ready, initializing VFS with streaming bootstrap... [meta-fuse] KV Manager ready, initializing VFS with streaming bootstrap...
[StreamingStateBuilder] Initialized with 12 VFS-relevant properties [StreamingStateBuilder] Initialized with 12 VFS-relevant properties
[meta-fuse] Replaying meta:events stream from position 0... [meta-fuse] Replaying meta:events stream from position 0...