AXIS-iliad

# Axis' Iliad

> **Axis' Iliad — The modern epic that shapes raw codebases into canonical, agent-ready artifacts. Axis' Iliad authors the definitive foundation for the next era of natural-language workspace development.**

> **Canonical name:** Axis' Iliad. Use this name consistently across docs, registries, and integrations.

[![Tests](https://img.shields.io/badge/tests-4900%2B%20passing-brightgreen)](https://github.com/lastmanupinc-hub/axis-iliad/actions)
[![Coverage](https://img.shields.io/badge/coverage-91.5%25-green)](https://github.com/lastmanupinc-hub/axis-iliad/actions)
[![Website](https://img.shields.io/badge/website-iliad.trustfabric.ai-0ea5e9)](https://iliad.trustfabric.ai)
[![API](https://img.shields.io/badge/API-live-blue)](https://axis-api-6c7z.onrender.com/v1/health)
[![Version](https://img.shields.io/badge/version-0.5.3-blue)](https://github.com/lastmanupinc-hub/axis-iliad/releases)
[![License](https://img.shields.io/badge/license-private-lightgrey)](#license)
[![AXIS-iliad MCP server](https://glama.ai/mcp/servers/lastmanupinc-hub/AXIS-iliad/badges/card.svg)](https://glama.ai/mcp/servers/lastmanupinc-hub/AXIS-iliad)

---

## AXIS Ecosystem

Iliad is the **x402 showcase** in the Trust Fabric stack. Full registry: [`packages/generator-core/src/estate-registry.ts`](packages/generator-core/src/estate-registry.ts), served live at [`GET /.well-known/axis-estate.json`](https://api.iliad.trustfabric.ai/.well-known/axis-estate.json) (superseding `ecosystem.registry.yaml`, retired 2026-08-22 — see [`docs/ESTATE_FEDERATION_STRATEGY.md`](docs/ESTATE_FEDERATION_STRATEGY.md)).

| Project | Role | x402 |
|---------|------|------|
| **Axis' Iliad** (this repo) | Agent artifacts + MCP gateway | **Wired** — [`@axis/mpp`](packages/mpp/README.md) |
| **[PAID](https://paid.trustfabric.ai)** | Multi-rail payments + settlement | Settlement layer (planned Go x402) |
| **[AXIS Foundry](https://github.com/lastmanupinc-hub/AXIS-Foundry)** | 3D pipeline + MCP | Partial |
| **[Trust Fabric](https://trustfabric.ai)** | Compliance audit, remediation + Trust Passport | Planned |

x402 contract: [`docs/x402/CONTRACT.md`](docs/x402/CONTRACT.md)

---

## Try it in 30 seconds — no signup required

Three programs are **completely free** with no API key:

```bash
# 1. Get an API key (free tier, instant)
curl -X POST https://axis-api-6c7z.onrender.com/v1/accounts \
  -H 'Content-Type: application/json' \
  -d '{"email":"you@example.com","name":"My Agent","tier":"free"}'

# 2. Analyze any public GitHub repo
curl -X POST https://axis-api-6c7z.onrender.com/v1/github/analyze \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{"url":"https://github.com/owner/repo","programs":["search","skills","debug"]}'

# 3. Download the generated artifacts as a ZIP
curl https://axis-api-6c7z.onrender.com/v1/projects/PROJECT_ID/export \
  -H 'Authorization: Bearer YOUR_API_KEY' -o artifacts.zip
```

**Free tier includes:** Search (context maps), Skills (AGENTS.md, CLAUDE.md, .cursorrules), Debug (playbooks, incident templates). Pro unlocks all 21 programs.

---

## What you get

One scan → 152 artifacts across 21 programs, ready in seconds:

| What you need | Program | Key outputs |
|---------------|---------|-------------|
| Orient a new AI agent | **Search** *(free)* | `context-map.json`, `repo-profile.yaml`, `architecture-summary.md` |
| Give any LLM codebase context | **Skills** *(free)* | `AGENTS.md`, `CLAUDE.md`, `.cursorrules`, `workflow-pack.md` |
| Debug a production incident | **Debug** *(free)* | `debug-playbook.md`, `tracing-rules.md`, `root-cause-checklist.md` |
| Audit your UI | **Frontend** | `frontend-rules.md`, `ui-audit.md`, `component-guidelines.md` |
| Fix search ranking | **SEO** | `seo-rules.md`, `meta-tag-audit.json`, `schema-recommendations.json` |
| Cut LLM costs | **Optimization** | `optimization-rules.md`, `cost-estimate.json`, `token-budget-plan.md` |
| Ship a design system | **Theme** | `design-tokens.json`, `theme.css`, `dark-mode-tokens.json` |
| Unify your brand voice | **Brand** | `brand-guidelines.md`, `voice-and-tone.md`, `messaging-system.yaml` |
| Automate dev workflows | **Superpowers** | `superpower-pack.md`, `workflow-registry.json`, `automation-pipeline.yaml` |
| Launch a campaign | **Marketing** | `campaign-brief.md`, `funnel-map.md`, `ab-test-plan.md` |
| Build data/research tools | **Notebook** | `notebook-summary.md`, `research-threads.md`, `source-map.json` |
| Manage a knowledge vault | **Obsidian** | `obsidian-skill-pack.md`, `vault-rules.md`, `graph-prompt-map.json` |
| Connect AI tools (MCP) | **MCP** | `mcp-config.json`, `mcp-registry-metadata.json`, `protocol-spec.md`, `spec.types.ts`, `mcp/README.md`, `mcp/project-setup.md`, `mcp/build-artifacts.md`, `mcp/package-json.root.template.json`, `mcp/package-json.package.template.json`, `mcp/tsconfig.root.template.json`, `mcp/tsconfig.package.template.json`, `mcp/monorepo-structure.md`, `mcp/core-implementation-artifacts.md`, `mcp/testing-documentation-polish-artifacts.md`, `mcp/fintech-mcp-surface-package.md`, `mcp/fintech-domain-schema.yaml`, `connector-map.yaml`, `capability-registry.json`, `server-manifest.yaml` |
| Generate components | **Artifacts** | `generated-component.tsx`, `dashboard-widget.tsx`, `component-library.json` |
| Create dev videos | **Remotion** | `remotion-script.ts`, `scene-plan.md`, `storyboard.md` |
| Social & visual assets | **Canvas** | `canvas-spec.json`, `social-pack.md`, `poster-layouts.md` |
| Generative art / NFT | **Algorithmic** | `generative-sketch.ts`, `variation-matrix.json`, `parameter-pack.json` |
| Agentic commerce (Visa AP2) | **Agentic Purchasing** | `agent-purchasing-playbook.md`, `checkout-flow.md`, `negotiation-rules.md` |

### Plus the begin loop — hand it to an agent and say `begin`

Every analysis also weaves in a **self-driving control loop** so an AI coding agent can *finish* the work, not just understand it:

- **`begin.yaml`** — the loop head: the inferred goal, a human-in-the-loop protocol (the owner only answers plain-English product questions), the move-selection algorithm, and **convergent stop conditions**.
- **`continuation.yaml`** — the loop state: an ordered step-list of every artifact + a priority **candidate queue** seeded from the analysis (the goal, detected gaps, a verify-harness when no tests exist).
- A **`⟳ Continue` footer** on every Markdown artifact; the final step **self-prompts `begin`**, closing the loop back to `begin.yaml`.

Download the pack (CLI, MCP, or the full-pack export), hand it to an agent, say **`begin`** — it works the queue, verifies each step, and **stops when the queue is empty** (convergent, never a runaway). No coding required on the owner's end.

AXIS dogfoods this on itself: this repo's own root [`begin.yaml`](begin.yaml) / [`continuation.yaml`](continuation.yaml) are the live loop we work from, also served verbatim over REST at `GET /begin.yaml` / `GET /continuation.yaml` — so an agent crawling this API discovers the same convention without cloning the repo.

---

## For AI agents — MCP integration

AXIS exposes a **Streamable HTTP MCP server** at `https://axis-api-6c7z.onrender.com/mcp`. Add it to your agent and it can analyze any repo or prepare for agentic purchasing autonomously.

**VS Code** (`.vscode/mcp.json`):
```json
{
  "servers": {
    "axis-iliad": {
      "type": "http",
      "url": "https://axis-api-6c7z.onrender.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

**Claude Desktop** (`claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "axis-iliad": {
      "url": "https://axis-api-6c7z.onrender.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
```

**Free MCP tools** (no auth needed): `list_programs`, `search_and_discover_tools`, `get_install_manifest`, `discover_agentic_purchasing_needs`, `prepare_agentic_purchasing_preview`, `discover_estate_tools` (sibling AXIS properties — payments, 3D generation, and more), plus the deterministic commerce decision engines: `sca_exemption_decision`, `grade_compliance`, `assemble_ce3_evidence`, `build_ap2_mandate`, `score_dispute_readiness` (evidence-capture readiness — not a dispute-win prediction). Five more are estate-flagged planned-capability stubs (Foundry Wave-1, honest redirects to Foundry's own MCP endpoint until an Iliad-hosted proxy ships): `axis_validate`, `axis_inspect`, `axis_compare`, `axis_manifest_verify`, `roblox_compliance_check`. `get_referral_code`, `get_referral_credits`, and `iliad_network_tokenization` are also free (no charge) but, unlike the tools above, **do require auth**. `ping_payment` is not free — it costs $0.005 and exercises the real x402 payment loop, the cheapest paid call in the catalog.

---

## Pricing

| Tier | Price | Programs |
|------|-------|----------|
| **Free** | $0 | Search, Skills, Debug |
| **Pro** | $0.50 / run | All 21 programs, 152 artifacts |
| **Lite mode** | $0.15–$0.25 / run | Top-gap summary, reduced output |

Budget negotiation: send `X-Agent-Budget: {"budget_per_run_cents": 25}` + `X-Agent-Mode: lite` on any paid call.

---

## Self-host

### System Requirements

- **Node.js**: ≥ 20.x (LTS recommended)
- **pnpm**: ≥ 9.x
- **OS**: macOS 11+, Linux (any distro), or Windows 10+
- **RAM**: 4 GB minimum (8 GB recommended)
- **Disk space**: ~2 GB for dependencies + build

### Quick Start

```bash
# Prerequisites: Node.js ≥ 20, pnpm ≥ 9
git clone https://github.com/lastmanupinc-hub/axis-iliad.git
cd axis-iliad
pnpm install
pnpm build

# Start the API server (port 4000)
node apps/api/dist/server.js

# Start the web UI (port 5173)
cd apps/web && npx vite

# Or use the CLI directly
node apps/cli/dist/cli.js analyze .
node apps/cli/dist/cli.js github https://github.com/owner/repo
```

### Docker

```bash
docker build -t axis-iliad .
docker run -p 4000:4000 axis-iliad
```

Requires: Docker 20.10+ or Docker Desktop

---

## Architecture

```
axis-