{"_id":"@aphrody/yolo","name":"@aphrody/yolo","dist-tags":{"latest":"3.2.0"},"versions":{"3.2.0":{"name":"@aphrody/yolo","version":"3.2.0","description":"Universal Autonomous Multi-Agent Execution Engine & Agent Layer (2026 Edition)","type":"module","license":"MIT","author":{"name":"aphrody-code"},"repository":{"type":"git","url":"git+https://github.com/aphrody-code/YOLO.git"},"scripts":{"grind":"bun run scripts/yolo-grind.ts","autopilot:pwsh":"pwsh scripts/autopilot.ps1","autopilot:sh":"bash scripts/autopilot.sh","typecheck":"tsc --noEmit -p tsconfig.json","test":"bun test","verify":"bun run typecheck && bun test","detector:bun":"bun run scripts/polyglot-detector.ts","detector:py":"python scripts/polyglot-detector.py","autopilot:py":"python scripts/yolo-autopilot.py"},"devDependencies":{"@types/bun":"^1.4.1","typescript":"^7.0.2"},"keywords":["skill","skills","agent-skills","skills-sh","vercel-agent-skills","claude-skill","codex-skill","antigravity-skill","mcp","autonomous","yolo","orchestration","multi-agent","a2a","autopilot"],"main":"./src/index.ts","module":"./src/index.ts","types":"./src/index.ts","exports":{".":{"import":"./src/index.ts","types":"./src/index.ts"},"./detector":{"import":"./scripts/polyglot-detector.ts","types":"./scripts/polyglot-detector.ts"}},"gitHead":"6981e124848acb9ce5364d87af955fd5fe992e23","bugs":{"url":"https://github.com/aphrody-code/YOLO/issues"},"homepage":"https://github.com/aphrody-code/YOLO#readme","_id":"@aphrody/yolo@3.2.0","_nodeVersion":"24.3.0","_npmVersion":"9.2.0","dist":{"integrity":"sha512-sz9HBdmYWtWX+RToDeCW/dYKVoXhp3udHcEMEU9lJPM2WSxPJ9RffsQs0gi25bU4Qz9lLSLQimK7HMctUWfi5g==","shasum":"9c52830a8bab33395461e37d9c7888a62e46313b","tarball":"https://registry.npmjs.org/@aphrody/yolo/-/yolo-3.2.0.tgz","fileCount":240,"unpackedSize":1305671,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEv/NpAIcOxp570LC+ESu7GcQN87zBOQkUBa3xpo+g4zAiEAttpQ7VLJuLsMy1yRhmS4xaEs598gi66YJOzdTxLj/1U="}]},"_npmUser":{"name":"yohan971","email":"yohanpierre@live.fr"},"directories":{},"maintainers":[{"name":"yohan971","email":"yohanpierre@live.fr"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/yolo_3.2.0_1789022196439_0.4244825640238268"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-10T06:36:36.238Z","3.2.0":"2026-09-10T06:36:36.628Z","modified":"2026-09-10T06:36:36.880Z"},"maintainers":[{"name":"yohan971","email":"yohanpierre@live.fr"}],"description":"Universal Autonomous Multi-Agent Execution Engine & Agent Layer (2026 Edition)","homepage":"https://github.com/aphrody-code/YOLO#readme","keywords":["skill","skills","agent-skills","skills-sh","vercel-agent-skills","claude-skill","codex-skill","antigravity-skill","mcp","autonomous","yolo","orchestration","multi-agent","a2a","autopilot"],"repository":{"type":"git","url":"git+https://github.com/aphrody-code/YOLO.git"},"author":{"name":"aphrody-code"},"bugs":{"url":"https://github.com/aphrody-code/YOLO/issues"},"license":"MIT","readme":"<!-- SPDX-License-Identifier: Apache-2.0 -->\n# YOLO+ — Sovereign Universal Autonomous Agent Engine (2026 Edition)\n\n[![CI Gate](https://img.shields.io/badge/Bun%20Test-102%20Passed-brightgreen)](https://github.com/aphrody-code/YOLO)\n[![Skills Count](https://img.shields.io/badge/Agent%20Skills-60%20Verified-blueviolet)](https://github.com/aphrody-code/YOLO)\n[![Universal Skills Standard](https://img.shields.io/badge/skills.sh-Compatible-blue)](https://skills.sh)\n[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Marketplace%20Ready-purple)](https://code.claude.com)\n[![Google Antigravity](https://img.shields.io/badge/Antigravity%20agy-Native%20Plugin-teal)](https://github.com/aphrody-code/YOLO)\n[![TypeScript](https://img.shields.io/badge/TypeScript-7.0%20Strict-blue)](https://github.com/aphrody-code/YOLO)\n[![Python](https://img.shields.io/badge/Python-3.10%2B%20(uv)-teal)](https://github.com/aphrody-code/YOLO)\n[![Rust](https://img.shields.io/badge/Rust-2024%20Edition-orange)](https://github.com/aphrody-code/YOLO)\n[![Autonomy](https://img.shields.io/badge/Mode-Full%20YOLO%20(Zero--Pause)-red)](https://github.com/aphrody-code/YOLO)\n\n**YOLO+** is the sovereign, multi-agent, cross-platform autonomous execution engine, polyglot AST code analyzer, and agent skill marketplace built for next-generation AI coding agents (**Antigravity CLI / Gemini 3.8**, **Claude Code**, and **OpenAI Codex**).\n\nIt packages **60 production agent skills** adhering to the universal **Agent Skills Open Standard** (SKILL.md YAML frontmatter) and native marketplaces across Claude Code, Antigravity (\u0007gy), and the skills.sh / Vercel ecosystem.\n\n---\n\n## ⚡ Market Discovery & Universal 1-Click Installation\n\nYOLO+ can be installed across any of the **77+ supported agent harnesses** (Claude Code, OpenAI Codex, Antigravity, Cursor, Windsurf, Devin, Vibe, OpenHands, etc.) via official package managers and agent CLI tools.\n\n### 1. Universal Agent Skills CLI (skills.sh / Vercel)\nInstall YOLO or any of its 60 individual skills non-interactively across your installed agents:\n\n``bash\n# Install the core YOLO orchestrator into all detected agents\nbunx skills add aphrody-code/YOLO -y\n\n# Install with npm / npx\nnpx skills add aphrody-code/YOLO -y\n\n# Install specific skills across select harnesses\nbunx skills add aphrody-code/YOLO --skill yolo-grind,autopilot,a2a-duel-loop --agent claude-code,codex,antigravity,cursor -y\n\n# Search skills catalog on skills.sh\nbunx skills find yolo\n``\n\n### 2. Claude Code Native Marketplace\nRegister the YOLO marketplace repository or install it as a direct plugin:\n\n``bash\n# Register YOLO marketplace source\n/plugin marketplace add aphrody-code/YOLO\n\n# Install YOLO plugin directly into your Claude Code profile\nclaude plugin install yolo\n``\n\n### 3. Google Antigravity CLI (\u0007gy) Native Integration\nEnable the YOLO plugin and its 60 skills within the Antigravity CLI environment:\n\n``bash\n# Install and enable plugin in ~/.gemini/config/\nagy plugin install aphrody-code/YOLO\nagy plugin enable yolo\n\n# Launch with autonomous permissions\nagy -p \"grind open tasks\" --dangerously-skip-permissions\n``\n\n---\n\n## 📚 Complete Catalog of Verified Skills (60 Production Skills)\n\nEvery skill includes complete YAML metadata, structured progressive disclosure, trigger contracts, and zero-pause autonomous execution rules:\n\n\n### Autonomous Loops & Multi-Agent Orchestration (9 skills)\n\n| Skill Identifier | Folder | Capabilities & Primary Scope |\n| :--- | :--- | :--- |\n| `a2a-duel-loop` | `skills/a2a-duel-loop` | Continuous 2-Claude coordination duel over the A2A file-based protocol (ai.json + .coord JSONL mailbox + HTTP listener). Each iteration writes one envel... |\n| `aphrody-agent-home` | `skills/aphrody-agent-home` | One-session autonomous build of the `aphrody-agent-home` crate (soul / identity / workspace). Dispatches the dedicated agent-home-builder subagent (Opus... |\n| `aphrody-perfect-grind` | `skills/aphrody-perfect-grind` | Forced-loop coding mode. Wraps /loop 30s /aphrody-yolo-grind with an explicit perfection oracle — does NOT exit until the codebase meets all objective m... |\n| `aphrody-yolo-grind` | `skills/aphrody-yolo-grind` | Continuous parallel-grind mode that dispatches parallel YOLO agents per tick to drive open plan/todo items to production-ready as fast as possible. Auto... |\n| `autopilot` | `skills/autopilot` | Launch the universal autopilot loop — dual-agent autonomous background daemon (Lead Developer + Independent Auditor) piloting any repository infinitely ... |\n| `start` | `skills/start` | Continuous autonomous execution mode that follows PLAN.md end-to-end, making decisions on every reversible choice without asking the user. Mission targe... |\n| `unified-workflow` | `skills/unified-workflow` | Route Aphrody, WinClean, niers, Ghidra and Computer Use work through bounded runs with manifests, evidence and explicit proof levels. |\n| `yolo-grind` | `skills/yolo-grind` | Continuous parallel-grind mode that dispatches parallel YOLO agents per tick to drive open plan/todo items to production-ready across any repository (Ru... |\n| `yolo-perfect-grind` | `skills/yolo-perfect-grind` | Forced-loop coding mode. Wraps /loop 30s /yolo-grind with an explicit perfection oracle — does NOT exit until the codebase meets all objective metrics. ... |\n\n### Rust 2026 Ecosystem & Systems Engineering (3 skills)\n\n| Skill Identifier | Folder | Capabilities & Primary Scope |\n| :--- | :--- | :--- |\n| `best-stack-2026` | `skills/best-stack-2026` | Canonical Rust 2026 stack chooser — recommends the right crate (+ exact version + alternative rejected + reason) for any domain : HTTP servers, async ru... |\n| `rust-best-practices-2026` | `skills/rust-best-practices-2026` | Rust 1.95 features + 1.96 WASM breakage + Cargo CVE-2026-33056 + Edition 2024 async closures / precise capturing / Tokio discipline. Use when writing ne... |\n| `rust-target-check` | `skills/rust-target-check` | Runs `cargo check` on the 3 priority targets in parallel (Linux x86_64, Windows MSVC, wasm32-unknown-unknown). Use whenever the user asks to \"verify cro... |\n\n### Reverse Engineering, OS Internals & Security Forensics (14 skills)\n\n| Skill Identifier | Folder | Capabilities & Primary Scope |\n| :--- | :--- | :--- |\n| `aphrody-cmd-ai-creative` | `skills/aphrody-cmd-ai-creative` | Contexte direct des commandes IA / génératif / créatif du CLI aphrody — chat, gemini, agy, agy-loop, antigravity, hermes, notebooklm, image, firefly, me... |\n| `aphrody-cmd-re-forensics` | `skills/aphrody-cmd-re-forensics` | Contexte direct des commandes de reverse engineering, forensics et analyse repo du CLI aphrody — re (triage/strings/sections/auto), forensics, scan, chr... |\n| `auto-re` | `skills/auto-re` | Orchestrates automated reverse engineering on a binary or directory. Use when you need a complete RE report on a PE/ELF binary without specifying indivi... |\n| `cross-platform-cli-toolbelt` | `skills/cross-platform-cli-toolbelt` | Rust CLI replacements for slow GNU coreutils / busybox / PowerShell — same binary on Linux/Windows/macOS. Use whenever picking a shell command, writing ... |\n| `deep-analysis` | `skills/deep-analysis` | Performs focused, depth-first investigation of specific reverse engineering questions through iterative analysis and database improvement. Answers quest... |\n| `m3-correct` | `skills/m3-correct` | User-invoked fix skill. Auto-correct Material Design 3 violations in a codebase. Use when asked to \"fix M3 violations\", \"auto-correct Material Design is... |\n| `microsoft-code-reference` | `skills/microsoft-code-reference` | Find working code samples, verify API signatures, and fix Microsoft SDK errors using official docs. Use whenever the user is writing, debugging, or revi... |\n| `protocol-reverse-engineering` | `skills/protocol-reverse-engineering` | Master network protocol reverse engineering including packet analysis, protocol dissection, and custom protocol documentation. Use when analyzing networ... |\n| `remotion-best-practices` | `skills/remotion-best-practices` | Best practices for Remotion - Video creation in React |\n| `responsive-adaptive` | `skills/responsive-adaptive` | Teaches Claude how to apply Material Design 3 adaptive layout: window size classes, navigation pattern swaps, canonical layouts, grid/margin values, and... |\n| `skill-creator` | `skills/skill-creator` | Create agent skills for any technology (Microsoft / Rust crate / Azure / .NET / browser API / framework) by investigating it live through the MCP server... |\n| `vps-commander` | `skills/vps-commander` | Operates the bidirectional SSH tunnel to the VPS — local port forwards (Chrome 9226, Postgres 5432, Bun 3001) and SOCKS5 (127.0.0.1:1080). |\n| `winclean` | `skills/winclean` | WinClean ecosystem integration for the peer Windows 11 (24H2+) optimization repo — system scanning, debloating, native AOT C# workflows, and a bridge to... |\n| `winclean-mcp-skills` | `skills/winclean-mcp-skills` | Wrapper namespace for 3 nested Microsoft-focused skills synced from the WinClean MCP ecosystem — microsoft-docs (Microsoft Learn API docs lookup), micro... |\n\n### Material Design 3, Design Systems & Frontend (24 skills)\n\n| Skill Identifier | Folder | Capabilities & Primary Scope |\n| :--- | :--- | :--- |\n| `color-expert` | `skills/color-expert` | Color science expert skill with 286K words of reference material covering OKLCH/OKLAB, palette generation, accessibility/contrast, color naming, pigment... |\n| `design-google-ingest` | `skills/design-google-ingest` | Crawl design.google end-to-end via Edge headless (SPA-aware) — discover every /library article + site page, scrape post-hydration DOM via scripts/edge-m... |\n| `google-design` | `skills/google-design` | Canonical Google / Material Design 3 design authority for aphrody. Use AGGRESSIVELY whenever the user asks anything about Material Design 3, M3 Expressi... |\n| `m3-component` | `skills/m3-component` | Scaffold a self-contained Material Design 3 md-* web component and/or its React wrapper. Use when the user says: \"create an M3 component\", \"scaffold a M... |\n| `m3-design-compiler` | `skills/m3-design-compiler` | Turn a natural-language design brief into a Material Design 3 React scaffold with @aphrody-code/m3-design. Use when asked to \"scaffold a screen from a d... |\n| `m3-design-guide` | `skills/m3-design-guide` | Load this skill whenever the user wants to design or build UI that looks Material Design 3 / Material You / Google-style, including requests like \"make ... |\n| `m3-doc-ai` | `skills/m3-doc-ai` | Translate and generate documentation for the monorepo with the @aphrody-code/doc-ai CLI (Google Gemini backend, offline fallback). Use when asked to \"tr... |\n| `m3-docs` | `skills/m3-docs` | Answer Material Design 3 specification questions with attribution. Model-invocable and user-invocable. Use when asked \"what does the M3 spec say about X... |\n| `m3-dynamic-color` | `skills/m3-dynamic-color` | Generate and apply Material You dynamic color and M3 design tokens at runtime with @aphrody-code/m3-tokens. Use when asked to \"theme from a seed color\",... |\n| `m3-lint` | `skills/m3-lint` | Set up and run @aphrody-code/eslint-plugin-m3 to lint a site that consumes material-web. Use when asked to \"lint M3 usage\", \"set up the m3 eslint/oxlint... |\n| `m3-motion` | `skills/m3-motion` | Apply Material Design 3 motion (transitions, easings, durations, springs) in React with @aphrody-code/m3-motion. Use when asked to \"animate with M3 moti... |\n| `m3-spec-check` | `skills/m3-spec-check` | Audit a file, component, or directory for Material Design 3 conformance. Use when the user says: \"check this is M3-compliant\", \"audit Material Design co... |\n| `m3-tailwind` | `skills/m3-tailwind` | Wire Material Design 3 tokens into Tailwind v4 and shadcn/ui with @aphrody-code/m3-theme and @aphrody-code/m3-tokens. Use when asked to \"use M3 with Tai... |\n| `m3-template` | `skills/m3-template` | Action skill: produces a complete, ready-to-use M3 page or screen scaffold. Invoke when the user says \"scaffold an M3 page\", \"scaffold an M3 screen\", \"g... |\n| `material` | `skills/material` | Google's Material Design with layered surfaces, dynamic theming, built-in motion, and responsive cross-platform patterns. |\n| `material-3` | `skills/material-3` | Implement Google's Material Design 3 (Material You) UI system. Primary: Jetpack Compose Material3 (MaterialTheme, components, adaptive layout). Also Flu... |\n| `material-design-3-components` | `skills/material-design-3-components` | Comprehensive guide to Material Design 3 components — from baseline Material You through M3 Expressive. Covers action, containment, communication, navig... |\n| `material-design-3-guide` | `skills/material-design-3-guide` | Master guide for Material Design 3 — covering the full specification from Material You foundations through M3 Expressive. Explains when to use each Mate... |\n| `nextjs-typescript-tailwindcss-supabase` | `skills/nextjs-typescript-tailwindcss-supabase` | Full-stack Next.js 14 development with TypeScript, TailwindCSS, and Supabase for building production-ready web applications. |\n| `shadcn` | `skills/shadcn` | Manages shadcn components and projects — adding, searching, fixing, debugging, styling, and composing UI. Provides project context, component docs, and ... |\n| `tailwindcss` | `skills/tailwindcss` | Expert in TailwindCSS utility-first styling with responsive design patterns |\n| `tailwindcss-advanced-layouts` | `skills/tailwindcss-advanced-layouts` | Tailwind CSS advanced layout techniques including CSS Grid and Flexbox patterns. PROACTIVELY activate for: (1) building complex layouts with CSS Grid, (... |\n| `tailwindcss-animations` | `skills/tailwindcss-animations` | Tailwind CSS animations and transitions including built-in utilities and custom keyframes. PROACTIVELY activate for: (1) animate-* utilities (spin, ping... |\n| `tailwindcss-mobile-first` | `skills/tailwindcss-mobile-first` | Mobile-first responsive design patterns with Tailwind CSS v4 (2025-2026). PROACTIVELY activate for: (1) mobile-first design with Tailwind breakpoints (s... |\n\n### Cloud, Documentation, Browser & Agent Tooling (10 skills)\n\n| Skill Identifier | Folder | Capabilities & Primary Scope |\n| :--- | :--- | :--- |\n| `agent-browser` | `skills/agent-browser` | Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, ta... |\n| `aphrody-cmd-system-net` | `skills/aphrody-cmd-system-net` | Contexte direct des commandes système, cycle de vie, réseau et intégration du CLI aphrody — auth, doctor, version, completions, self, oc-onboard/reset/u... |\n| `bxc` | `skills/bxc` | Crawler and web scraping engine with advanced stealth, browser automation, and platform scrapers. |\n| `context7-mcp` | `skills/context7-mcp` | Fetch current library documentation, API references, and code examples for any developer technology (React, tokio, wgpu, Prisma, Supabase, Express, Tail... |\n| `deploy` | `skills/deploy` | Deploy application to production. TRIGGER when: user says 'deploy', 'ship', 'push to prod', 'release', 'mise en prod', or asks to restart a service. Han... |\n| `developing-genkit-js` | `skills/developing-genkit-js` | Develop AI-powered applications using Genkit in Node.js/TypeScript. Use when the user asks about Genkit, AI agents, flows, or tools in JavaScript/TypeSc... |\n| `docs-auto` | `skills/docs-auto` | MANDATORY first step whenever the user asks ANYTHING about a library, framework, SDK, CLI tool, cloud service, API, configuration syntax, runtime behavi... |\n| `microsoft-docs` | `skills/microsoft-docs` | Understand Microsoft technologies by querying official documentation. Use whenever the user asks how something works, wants tutorials, needs configurati... |\n| `migrate-mui` | `skills/migrate-mui` | Migrate a React + MUI (@mui/material@9 + @mui/icons-material + MUI X) codebase to material-web (@aphrody-code/m3-react + Material Symbols). Use when ask... |\n| `n2b` | `skills/n2b` | Scan and migrate a Node.js codebase to Bun using n2b, including API mappings, Bun Shell ($), shebang updates, and package config. |\n\n\n---\n\n## ⚡ Unified Architecture & Core Components\n\n``\nyolo/\n├── .claude-plugin/\n│   ├── marketplace.json         # Claude Code Marketplace Manifest\n│   └── plugin.json              # Claude Code Plugin Specification\n├── plugin.json                  # Antigravity (agy) Native Plugin Manifest\n├── package.json                 # Node/Bun Package & skills.sh keywords\n├── yolo.json                    # YOLO Engine & Subagent Orchestration Schema\n├── src/\n│   └── index.ts                 # Programmatic TypeScript/Bun library export\n├── scripts/\n│   ├── polyglot-detector.ts     # Native Polyglot Detector & AST Code Parser (Bun/TS)\n│   ├── polyglot-detector.py     # Native Polyglot Detector (Python 3.10+)\n│   ├── yolo-grind.ts            # Fast Autonomous Parallel Grind Runner (Bun)\n│   ├── yolo-autopilot.py        # Autonomous Polyglot Autopilot Runner (Python / uv)\n│   ├── autopilot.ps1            # Background duel daemon with PID tracking (PowerShell 7+)\n│   └── autopilot.sh             # Background duel daemon with signal traps (Bash / Linux / macOS)\n├── home/                        # Sovereign Agent Persona & Execution Rules\n│   ├── SOUL.md                  # Decisive tone, honesty, boundaries, and zero-pause mandate\n│   ├── IDENTITY.md              # Autonomous agent identity and vibe definition\n│   ├── AGENTS.md                # Multi-agent collaboration protocol\n│   ├── TOOLS.md                 # Permitted tool execution & auto-allow permissions\n│   ├── HEARTBEAT.md             # Coordination pulse & ISO-8601 liveness contract\n│   ├── BOOT.md & BOOTSTRAP.md   # Cold-start onboarding sequences\n│   └── USER.md                  # Passive spectator user contract\n├── agents/                      # 21 Specialized Autonomous Subagents\n│   ├── yolo-prod-ready.md       # Universal production-ready delivery engine (exit code 0)\n│   ├── csharp-engineer.md       # Modern .NET 8/9, ASP.NET Core, Native AOT, Span<T>\n│   ├── cpp-c-engineer.md        # ISO C99/C11/C23 & C++20/C++23, zero-cost abstractions\n│   ├── asm-lowlevel-engineer.md # SIMD vectorization (AVX-512, NEON), inline assembly\n│   ├── rust-engineer.md         # Rust 2024 edition, ownership, zero-cost concurrency\n│   ├── web-frontend-engineer.md # HTML5 semantic markup, responsive CSS3/Tailwind\n│   ├── spec-doc-architect.md    # Algorithmic pseudocode, JSON Schema modeling\n│   ├── cargo-auditor.md         # Supply-chain security (cargo deny, CVE scanning)\n│   ├── cross-platform-validator # Multi-OS compilation verification (Linux, Windows, WASM)\n│   ├── devops-engineer.md       # CI/CD pipelines, containerization, deployment\n│   ├── performance-engineer.md  # Latency profiling, memory optimization, benchmarks\n│   ├── security-engineer.md     # Invariant auditing, vulnerability elimination\n│   └── test-runner.md           # Automated test generation and gate validation\n├── skills/                      # 60 Production Agent Skills (Universal Open Standard)\n├── schemas/\n│   └── yolo.schema.json         # Draft 2020-12 schema validating the YOLO engine manifest\n└── tests/\n    ├── polyglot.test.ts         # 25+ language detection & AST symbol extraction tests\n    ├── yolo.test.ts             # Manifest, schema, script, and agent integrity tests\n    └── skills.test.ts           # 60/60 skills YAML validation & verification suite\n``\n\n---\n\n## 🌐 Universal Polyglot Support (Native Detector & AST Parser)\n\nYOLO+ features an integrated, high-speed polyglot engine inspired by **GitHub Linguist**, **Google Magika**, and **Tree-sitter**:\n\n| Category | Languages & Stacks | Validation & Test Gates |\n| :--- | :--- | :--- |\n| **Systems & Native** | C# (.NET 8/9), C++20/23, ISO C, Assembly (NASM/GAS), Rust (2024) | dotnet test, ctest, make test, cargo test, cargo check |\n| **Modern Runtimes** | TypeScript, JavaScript, Bun, Node.js, Python (uv), Go | \bun test, \npm test, pytest, go test ./... |\n| **Web & Interface** | Semantic HTML5, CSS3, Tailwind CSS, Material Design 3 | Markup validation, responsive conformance |\n| **Data & Schemas** | JSON, JSON Schema (draft 2020-12), YAML, TOML, Protocol Buffers | Schema validation, type generation |\n| **Specifications** | Algorithmic Pseudocode, Markdown specifications | Invariant proofs, cross-reference verification |\n\n### Multi-Stage Detection Pipeline\n1. **Filename Match**: Instant resolution for canonical files (Cargo.toml, CMakeLists.txt, Dockerfile, go.mod, \tsconfig.json).\n2. **Shebang Match**: Inspects execution preambles (#!/usr/bin/env bun, #!/usr/bin/env python3, etc.).\n3. **Extension Mapping**: Identifies 60+ primary and secondary extensions (.cs, .rs, .cpp, .asm, .ts, .py, .go, .html, .json, etc.).\n4. **Content Heuristics**: Distinguishes ambiguous extensions via Bayesian-style structural syntax patterns.\n5. **AST Symbol Extraction**: Discovers functions, classes, interfaces, imports, line metrics, and comment ratios without external binaries.\n\n---\n\n## 🚀 Autonomous Execution Daemons\n\n### 1. Bun / TypeScript Workspace Grind\nInspects active workspace stacks and dispatches autonomous multi-agent ticks:\n``bash\nbun run grind\n# Inspect a project without writing coordination files or dispatching agents\nbun run grind -- --dry-run\n``\n\n### 2. Python Autopilot Polyglot Runner\nAutonomously detects stacks, reads actionable tasks from PLAN.md or TODO.md, and loops with zero confirmation:\n``bash\n# Single dry-run pass (inspect workspace and verify prompt)\npython scripts/yolo-autopilot.py --once --dry-run\n\n# Run continuous autonomous execution loop\npython scripts/yolo-autopilot.py --interval 60\n``\n\n### 3. Background Duel Daemons (Lead + Auditor)\nRuns Lead Developer and Independent Auditor in continuous duel:\n``powershell\n# Windows PowerShell 7+\npwsh scripts/autopilot.ps1 -Interval 60\n# One read-only inspection\npwsh scripts/autopilot.ps1 -Once -DryRun\n``\n``bash\n# Linux / macOS Bash\nbash scripts/autopilot.sh --interval 60\n# One read-only inspection\nbash scripts/autopilot.sh --once --dry-run\n``\n\n---\n\n## 🛠️ Programmatic TypeScript API\n\nYOLO+ is packaged and exportable as a standard library (@aphrody/yolo):\n\n``typescript\nimport { PolyglotDetector, LANGUAGE_REGISTRY } from \"@aphrody/yolo\";\n\n// Detect file type & language\nconst lang = PolyglotDetector.detect(\"Program.cs\");\nconsole.log(lang.name); // \"C#\"\nconsole.log(lang.buildGate); // \"dotnet build\"\n\n// Parse structural AST symbols\nconst source = \nimport { Worker } from \"cluster\";\nexport class Engine {\n  execute() {}\n}\n;\nconst parsed = PolyglotDetector.parseCode(\"engine.ts\", source);\nconsole.log(parsed.declarations.classes); // [\"Engine\"]\nconsole.log(parsed.imports); // [\"cluster\"]\n``\n\n---\n\n## 🤖 Sovereign Persona & Operating Rules (/home)\n\nYOLO operates under the sovereign agent contract defined in /home:\n- **Full YOLO Autonomy (SOUL.md):** Zero human confirmation pauses for safe, reversible actions. Decide and act immediately.\n- **Honest Delivery Tri-State:** Every deliverable must be classified:\n  - **FAIT**: Delivered with concrete, verifiable passing artifacts (exit code 0).\n  - **INCOMPLET**: Specific remaining requirements identified.\n  - **NON_FAIT**: Concrete external blocker identified.\n- **A2A Coordination (HEARTBEAT.md & .coord/):** ISO-8601 liveness pulse and JSONL fact envelopes preventing peer agent collisions.\n\n---\n\n## 🧪 Verification & Gate Validation\n\nThe YOLO test suite validates schemas, links, agents, and every single skill manifest:\n\n``bash\n# Run full verification suite (102 tests across manifest, agents, polyglot parser, and 60 skills)\nbun test\nbun run verify\n``\n\n---\n\n## 📄 License & Standards\n\n- **License:** Apache-2.0 / MIT Dual License.\n- **Open Standards:** Agent Skills Open Standard (SKILL.md), Claude Code Marketplace Schema, Antigravity Plugin Schema.\n- **A2A Protocol Version:** 3.2.0.\n- **Author:** \u0007phrody-code (<noreply@aphrody-code.dev>).","readmeFilename":"README.md","_rev":"1-2587fb31c5224727148fc13474caec96"}