oopath: Sovereign PATH MANIPULATOR

================================================================================
                                oopath
               Sovereign openOODA PATH MANIPULATOR
================================================================================

Sovereign PATH MANIPULATOR
Sovereign path syntax sanitizer normalizing relative components and dot segments.
Two Faces, One Engine: Modern terminal ergonomics for humans • Zero-leakage MCP for AI agents
Written in 100% pure openOODA.

---

1. Quick Install

Automated Installer (Linux x86_64 & aarch64)

curl -fsSL https://openooda-tools.github.io/oopath/install.sh | bash

Native Package Managers

# Arch Linux (AUR / PKGBUILD)
yay -S oopath-bin
# Or manual PKGBUILD:
cd packaging/arch && makepkg -si

# Debian / Ubuntu (.deb)
curl -fsSL https://openooda-tools.github.io/oopath/install.sh | bash -s -- --deb

# Fedora / RHEL (.rpm)
curl -fsSL https://openooda-tools.github.io/oopath/install.sh | bash -s -- --rpm

Uninstallation

oopath-uninstall
# or: curl -fsSL https://openooda-tools.github.io/oopath/uninstall.sh | bash

---

2. CLI Usage

usage: oopath [options] [ARGUMENTS]...

Sovereign path syntax sanitizer normalizing relative components and dot segments.

Options:
  -h, --help           display this help and exit
  -v, --version        output version information and exit
      --json           output formatted as JSON Lines
      --color <WHEN>   colorize output: auto, always, never [default: auto]
      --theme <NAME>   override active oote palette
      --mcp            run as Model Context Protocol stdio server

---

3. Theming Integration (oote)

oopath synchronizes visual styles and status colors with oote:

• Configuration: Reads active palette from ~/.openooda/theme.oot.
• Environment Overrides: Respects $OODA_THEME and $NO_COLOR.

---

4. Model Context Protocol (MCP)

When invoked with --mcp, oopath runs a JSON-RPC 2.0 stdio server providing structured tools for AI coding agents:

oopath --mcp

---

5. Security & Zero Ambient Authority

• Pure Capability Bounded: Operates strictly with explicit tokens (&FsReadCap, &FsWriteCap, &McpCap). Physical absence of ambient disk/net leakage.
• Negative-Trust Architecture: Strict input validation and operational limits.
• Hermetic Binary: Standalone zero-dependency executable.

---

6. License

Apache License, Version 2.0. See LICENSE for details.