Home

AXIS Wiki

Distributed cluster-management substrate: hardware fact collection, deterministic resource-aware placement, and safety-gated execution of AI workloads across SSH-reachable nodes.

This wiki combines the auto-generated DeepWiki codebase documentation with C4 architecture diagrams and an architecture review, all code-verified.

Architecture

• Architecture Diagrams (C4 L3) — per-layer component diagrams (L1–L5).
• Architecture Improvement Report — top findings (Problem→Cause→Verify→Fix).

Documentation map

• AXIS Overview
  • Getting Started
  • Design Principles and Architecture
• CLI Reference
  • Cluster Inspection Commands
  • Task Management Commands
  • Daemon and Serve Commands
  • AI Assistant Commands
• Fact Collection and Discovery
  • NodeFacts Data Model
  • Local and Remote Collectors
  • Node Discovery and Transport
• Snapshot Assembly and Daemon Cache
  • Snapshot Building
  • Daemon Lifecycle and Cache Management
  • Persistent State Management
• Placement Engine
  • Filter, Rank, and Select Pipeline
  • Workload Inference and Classification
  • Empirical Feedback and Failure Memory
• Execution Engine
  • Guarded Execution Pipeline
  • Safety Evaluation System
  • Resource Reservation Ledger
• Advisory Layer: AI Surfaces
  • Agent Framework
  • Chat Interface
  • MCP Server and Client
  • HTTP API
• Events, Knowledge, and Observability
  • Event Bus and Webhooks
  • Cluster Knowledge and Context
• Configuration Reference
• CI/CD, Release, and Developer Tooling
  • CI Pipeline and Quality Gates
  • Release Pipeline and Versioning
  • Developer Workflow and Contributing
• Glossary