m3taversal
d2aec7fee3
Some checks are pending
CI / lint-and-test (push) Waiting to run
Move scattered root-level files into categorized directories: - deploy/ — deployment + mirror scripts (Ship) - scripts/ — one-off backfills + migrations (Ship) - research/ — nightly research + prompts (Ship) - docs/ — all operational documentation (shared) Delete 3 dead cron scripts replaced by pipeline daemon: - batch-extract-50.sh, evaluate-trigger.sh, extract-cron.sh Add CODEOWNERS mapping every path to its owning agent. Add README with directory structure, ownership table, and VPS layout. Update deploy.sh paths to match new structure. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
65 lines
2.8 KiB
Markdown
65 lines
2.8 KiB
Markdown
# teleo-infrastructure
|
|
|
|
Pipeline infrastructure for the Teleo collective knowledge base. Async Python daemon that extracts, validates, evaluates, and merges claims via Forgejo PRs.
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
teleo-infrastructure/
|
|
├── teleo-pipeline.py # Daemon entry point
|
|
├── reweave.py # Reciprocal edge maintenance
|
|
├── lib/ # Pipeline modules (Python package)
|
|
├── diagnostics/ # Monitoring dashboard (port 8081)
|
|
├── telegram/ # Telegram bot interface
|
|
├── deploy/ # Deployment + mirror scripts
|
|
├── systemd/ # Service definitions
|
|
├── agent-state/ # Cross-session agent state
|
|
├── research/ # Nightly research orchestration
|
|
├── hermes-agent/ # Hermes agent setup
|
|
├── scripts/ # One-off backfills + migrations
|
|
├── tests/ # Test suite
|
|
└── docs/ # Operational documentation
|
|
```
|
|
|
|
## Ownership
|
|
|
|
Each directory has one owning agent. The owner is accountable for correctness and reviews all changes to their section. See `CODEOWNERS` for per-file detail.
|
|
|
|
| Directory | Owner | What it does |
|
|
|-----------|-------|-------------|
|
|
| `lib/` (core) | **Ship** | Config, DB, merge, cascade, validation, LLM calls |
|
|
| `lib/` (extraction) | **Epimetheus** | Source extraction, entity processing, pre-screening |
|
|
| `lib/` (evaluation) | **Leo** | Claim evaluation, analytics, attribution |
|
|
| `lib/` (health) | **Argus** | Health checks, search, claim index |
|
|
| `diagnostics/` | **Argus** | 4-page dashboard, alerting, vitality metrics |
|
|
| `telegram/` | **Ship** | Telegram bot, X integration, retrieval |
|
|
| `deploy/` | **Ship** | rsync deploy, GitHub-Forgejo mirror |
|
|
| `systemd/` | **Ship** | teleo-pipeline, teleo-diagnostics, teleo-agent@ |
|
|
| `agent-state/` | **Ship** | Bootstrap, state library, cascade inbox processor |
|
|
| `research/` | **Ship** | Nightly research sessions, prompt templates |
|
|
| `scripts/` | **Ship** | Backfills, migrations, one-off maintenance |
|
|
| `tests/` | **Ganymede** | pytest suite, integration tests |
|
|
| `docs/` | Shared | Architecture, specs, protocols |
|
|
|
|
## VPS Layout
|
|
|
|
Runs on Hetzner CAX31 (77.42.65.182) as user `teleo`.
|
|
|
|
| VPS Path | Repo Source | Service |
|
|
|----------|-------------|---------|
|
|
| `/opt/teleo-eval/pipeline/` | `lib/`, `teleo-pipeline.py`, `reweave.py` | teleo-pipeline |
|
|
| `/opt/teleo-eval/diagnostics/` | `diagnostics/` | teleo-diagnostics |
|
|
| `/opt/teleo-eval/telegram/` | `telegram/` | (manual) |
|
|
| `/opt/teleo-eval/agent-state/` | `agent-state/` | (used by research-session.sh) |
|
|
|
|
## Quick Start
|
|
|
|
```bash
|
|
# Run tests
|
|
pip install -e ".[dev]"
|
|
pytest
|
|
|
|
# Deploy to VPS
|
|
./deploy/deploy.sh --dry-run # preview
|
|
./deploy/deploy.sh # deploy
|
|
```
|