Skip to content

roydsouza/tachyon_tongs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

320 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Tachyon Tongs: Forensic Analysis and Security Mitigation

Tachyon Tongs is a digital forensics and security mitigation suite designed for high-integrity environment auditing and response within the Antigravity station.

Project Role & Relationships

  • Function: Operates as the laboratory for identifying and mitigating security threats within agentic and infrastructure layers.
  • Support: Informs the security guidelines implemented in the schwarzschild-assembly.
  • Evolution: This project serves as the predecessor to the airlock agentic firewall; it will eventually be integrated or replaced as security protocols mature.
  • Research: Houses the initial experiments for the Darwin-Godel-Machine and other autonomous security research strains.

πŸ›‘οΈ A Live Threat Model

Every architectural decision is mapped directly to a specific vector in the THREAT_MODEL.md.

  • 🧠 Semantic Intent Gating: All tool requests are routed through a Policy Enforcement Point and evaluated by the Singularity Meta-PDP.
  • πŸ›‘οΈ Live, Self-Updating Threat Model: The substrate's THREAT_MODEL.md is not a static document. It is dynamically augmented by the Pathogen and Sentinel, with each new adversarial discovery mapped to the OWASP-2026-ASI taxonomy.
  • 🧊 Tiered Workload Isolation: High-risk actions run in dynamically generated macOS sandbox-exec (Seatbelt) profiles.
  • πŸ” Forensic Integrity Gating: Every substrate mutation is cryptographically signed using Ed25519 + ML-DSA-65 hybrid sidecars.

πŸ’Ž The Crown Jewels: Proactive Defense & Autoresearch

Tachyon Tongs is not just a reactive proxy; it is a self-evolving security organism.

  • 🦠 Pathogen (Metamorphic Adversarial Reasoning): Every 24 hours, the Pathogen agent executes a deep adversarial sweep. Moving beyond static templates, it now utilizes a Reflector Node to "think" about substrate defenses. It ingests ADRs and blueprints to identify blind spots, synthesizing Goal-Aliased attacks that masquerade as legitimate telemetry to bypass intent-based filters.
  • πŸ”­ Sentinel (Autonomous Intelligence Research): The Sentinel performs Karpathy-style "Autoresearch"β€”not just searching for CVEs, but autonomously browsing, synthesizing, and mapping novel vulnerabilities into high-signal "Adversarial Guidance" for the Pathogen.
  • 🧬 Metamorphic Co-Evolution: This continuous loop between the Sentinel (Discovery) and the Pathogen (Reasoning & Verification) creates a biological-grade immune response that self-hardens the substrate against human-level adversarial logic.

πŸ” Secure SDLC: Hardware-Anchored Trust

Tachyon Tongs practices forensic security in its own development process. Every mutation is cryptographically signed and hardware-anchored.

  • πŸ†” Hardware-Backed Signing: Root keys live in the Apple Secure Enclave (Touch ID-gated, non-extractable).
  • βš›οΈ Hybrid Post-Quantum Cryptography: Signatures use Ed25519 + ML-DSA-65 (NIST FIPS 204, Level 3).
  • ⛓️ Forensic ADR Chaining: Every Architecture Decision Record references the hash of its predecessor, anchored to the Merkle root in MANIFEST.json.

πŸ‘‰ docs/SDLC.md β€” The full Secure SDLC reference.


🧩 Agent Plugin Architecture

Tachyon Tongs uses a modular, role-based plugin system (ADR-0033). Agents are categorized into three tiers for optimal isolation and flexibility:

  • πŸ’» Code-Only Agents: Pure Python implementations (e.g., engineer, pathogen, guardian).
  • πŸ“œ Skill-Only Agents: Declarative agents defined by their SKILL.md manifests (e.g., lightweight reconnaissance).
  • 🧬 Hybrid Agents: Combine complex code logic with declarative skills (e.g., sentinel).

πŸ“¦ Default Agent Collective

The substrate ships with a pre-configured sets of "Immune Cells":

  • Sentinel: The autonomous sensory heart.
  • Engineer: The surgical auto-patcher.
  • Guardian: The high-assurance integrity enforcer.
  • Herald: The secure C2 and notification gateway.
  • ...and more (see AGENTS.md)

🦞 The Claw Ecosystem Bridge

Import 5,700+ skills from the ClawHub ecosystem.

  • Safe Import: Automatic translation from Claw formats to Tachyon plugins.
  • Quarantine Mode: Imported agents are restricted by the Substrate Firewall until manually graduated.
  • Airlock Vetting: Every import undergoes a 5-stage safety check (Translate -> Scan -> Sandbox -> Airlock -> Quarantine).

πŸ“ Substrate Topology

The Tachyon Tongs filesystem is designed for high-assurance modularity:

β”œβ”€β”€ admin/              # Administrative Layer (ADMIN.md, ALERT.md, RUN_LOG.md)
β”œβ”€β”€ agents/             # The Immune Cell Collective (Pathogen, Sentinel, etc.)
β”œβ”€β”€ daemons/            # macOS LaunchAgent & System Daemon configurations
β”œβ”€β”€ docs/               # Architecture, ADRs, and API documentation
β”œβ”€β”€ exploits/           # Master CATALOG.md and raw research payloads.
β”œβ”€β”€ logs/               # EVOLUTION.md (Forensic architect logs).
β”œβ”€β”€ tasks/              # Coordination Layer (SYNC_LOG.md, TASKS_*.md)
β”œβ”€β”€ memory/             # tachyon_state.db (Operational DB) and archive/ (Pruned logs).
β”œβ”€β”€ policies/           # OPA-Rego policies and Enforcer configurations.
β”œβ”€β”€ libs/               # Architecture-specific binaries (e.g., liboqs.dylib for PQC).
β”œβ”€β”€ tests/              # Comprehensive regression suites (Functional & Adversarial).

⚑ Quick Start: The Herald Setup

Tachyon Tongs implements a high-assurance, defense-in-depth agentic architecture modeled after the autonomic immune system.

  • 🏰 Defense in Depth: High-value administrative components (like the Firewall Administrator) are air-gapped from the network.
  • πŸ“‘ The Herald Proxy: All external communication (Signal) is proxied through the Herald agent.
  • πŸ₯ Immune Response: Specialized agents (Sentinel, Sentry, Healer, Engineer) collaborate to detect and remediate threats.

πŸ‘‰ AGENTIC_ARCHITECTURE.md β€” Deep dive into the 6-tier taxonomy.


πŸ€– The Agent Collective

  • πŸ”­ The Sentinel: Discovers and signs novel AI exploits into the exploits/CATALOG.md.
  • πŸ§ͺ The Sentry: Unified active probing and passive semantic honeypotting for early intrusion detection.
  • πŸ›‘οΈ The Immunologist: Defensive semantic sentinel monitoring the EventBus to neutralize prompt injection attacks.
  • 🧬 The Forge (Synthesizer/Mutator): Adversarial architect generating synthetic zero-day scenarios and stress-testing substrate logic via the Pathogen engine.
  • 🦠 The Pathogen: Red-team mutation engine for autonomously evolving exploit variants to find bypasses.
  • πŸ› οΈ The Engineer: Self-synthesizes infrastructure patches and policy mutations.
  • βš–οΈ The Guardian: Performs real-time forensic audits of the architectural substrate.
  • πŸ₯ The Healer: Autonomous somatic repair and automated patch coordination.
  • πŸ“¬ The Herald: Translates alerts into diplomatic dispatches delivered via Signal.

🦠 The OWASP Agentic Threat Hub (ASI01-ASI11)

The substrate is pre-loaded with an operational knowledge base of the OWASP Top 10 for Agentic Applications (2026). Each playbook (exploits/ASI*.md) contains:

  • Official Descriptions: The industry-standard definition of the threat.
  • Expert Synthesis: Adversarial guidance aggregated from Claude, OpenAI, and Grok.
  • Adversarial Guides: Actionable synthesis heuristics used by the Pathogen to mutate its attacks.
  • Defensive Matrix: Precise mapping to substrate-level mitigations (Sentinel, Guardian, PEP).

🚦 Operational Maturity

Tachyon Tongs follows a tiered evolution path toward fully autonomous security governance:

  • 🟒 HITL (Human-In-The-Loop) - [CURRENT]: Every mutation requires explicit human approval.
  • 🟑 HOTL (Human-On-The-Loop) - [EVOLVING]: Low-risk patches apply automatically with a veto window.
  • πŸ”΄ HOOTL (Human-Out-Of-The-Loop) - [VISION]: Full autonomous detection and remediation.

⌨️ Command & Control: Event-Horizon Bridge

The Event-Horizon Command Bridge provides a NeoVIM-first interface for substrate oversight.

  • 🧠 Local Reasoning: High-assurance offline reasoning via llama.cpp on M5.
  • 🧱 Singularity PDP: High-assurance Policy Decision Point for LLM tool-calling.
  • πŸ“‘ Unified Console: Composable tt CLI, GPU-accelerated TUI, and tachyon.nvim.

πŸ“š Documentation Index


πŸ§ͺ Experiments: Autonomous Auto-Research

Tachyon Tongs serves as a laboratory for evaluating promising avenues in published AI security research (e.g., Automated Design of Agentic Systems, The HyperAgent Principle). We conduct autonomous ("auto research") experiments to find the next generation of substrate-level defenses.

  • πŸ”­ Experiments Master Index: The central registry of all active and archived autonomous research strains.
    • 🧬 Darwin-GΓΆdel Machine (DGM): A self-referential evolutionary loop that uses a local MLX-native LLM to rewrite its own detection logic in response to synthesized adversarial pressure.

πŸ“ˆ Roadmap & Task Tracking

Tachyon Tongs follows a phased evolution model to ensure substrate stability and forensic integrity. We track our progress across three distinct horizons:

About

An Agent Protection Framework

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors