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.

---

AXIS Ecosystem

Iliad is the x402 showcase in the Trust Fabric stack. Full registry: ecosystem.registry.yaml.

Project	Role	x402
Axis' Iliad (this repo)	Agent artifacts + MCP gateway	Wired — @axis/mpp
PAI'D	Multi-rail payments + settlement	Settlement layer (planned Go x402)
AXIS Foundry	3D pipeline + MCP	Partial
Trust Fabric	Certification marketplace	Planned

x402 contract: docs/x402/CONTRACT.md

---

Try it in 30 seconds — no signup required

Three programs are completely free with no API key:

# 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 20 programs.

---

What you get

One scan → 142 artifacts across 20 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 / 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):

{
  "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):

{
  "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, discover_commerce_tools, discover_agentic_purchasing_needs, get_referral_code, get_referral_credits, 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)

---

Pricing

Tier	Price	Programs
Free	$0	Search, Skills, Debug
Pro	$0.50 / run	All 20 programs, 142 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

# 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

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

Requires: Docker 20.10+ or Docker Desktop

---

Architecture

axis-iliad/
├── apps/
│   ├── api/          → Zero-dependency HTTP server (port 4000, 157 endpoints)
│   ├── cli/          → CLI tool: axis analyze <dir> | axis github <url>
│   └── web/          → Vite + React 19 SPA (dark theme, toast, command palette)
├── packages/
│   ├── snapshots/    → Snapshot intake, Postgres (Neon) persistence, billing, funnel
│   ├── repo-parser/  → Language detection (60+), framework detection (10), import graph
│   ├── context-engine/ → Context map builder, repo profile, route/architecture analysis
│   └── generator-core/ → 142 generators across 20 programs
└── vitest.config.ts  → Shared test config

Programs (20)

Program	Outputs	Tier
Search	context-map.json, repo-profile.yaml, architecture-summary.md, dependency-hotspots.md	Free
Skills	AGENTS.md, CLAUDE.md, .cursorrules, workflow-pack.md, policy-pack.md	Free
Debug	debug-playbook.md, incident-template.md, tracing-rules.md, root-cause-checklist.md	Free
Frontend	frontend-rules.md, component-guidelines.md, layout-patterns.md, ui-audit.md	Pro
SEO	seo-rules.md, schema-recommendations.json, route-priority-map.md, content-audit.md, meta-tag-audit.json	Pro
Optimization	optimization-rules.md, prompt-diff-report.md, cost-estimate.json, token-budget-plan.md	Pro
Theme	design-tokens.json, theme.css, theme-guidelines.md, component-theme-map.json, dark-mode-tokens.json	Pro
Brand	brand-guidelines.md, voice-and-tone.md, content-constraints.md, messaging-system.yaml, channel-rulebook.md	Pro
Superpowers	superpower-pack.md, workflow-registry.json, test-generation-rules.md, refactor-checklist.md, automation-pipeline.yaml	Pro
Marketing	campaign-brief.md, funnel-map.md, sequence-pack.md, cro-playbook.md, ab-test-plan.md	Pro
Notebook	notebook-summary.md, source-map.json, study-brief.md, research-threads.md, citation-index.json	Pro
Obsidian	obsidian-skill-pack.md, vault-rules.md, graph-prompt-map.json, linking-policy.md, template-pack.md	Pro
MCP	mcp-config.json, mcp-registry-metadata.json, protocol-spec.md, connector-map.yaml, capability-registry.json, server-manifest.yaml	Pro
Artifacts	generated-component.tsx, dashboard-widget.tsx, embed-snippet.ts, artifact-spec.md, component-library.json	Pro
Remotion	remotion-script.ts, scene-plan.md, render-config.json, asset-checklist.md, storyboard.md	Pro
Canvas	canvas-spec.json, social-pack.md, poster-layouts.md, asset-guidelines.md, brand-board.md	Pro
Algorithmic	generative-sketch.ts, parameter-pack.json, collection-map.md, export-manifest.yaml, variation-matrix.json	Pro
Agentic Purchasing	agent-purchasing-playbook.md, product-schema.json, checkout-flow.md, negotiation-rules.md, commerce-registry.json	Pro
Closer	packaging/README.md, Dockerfile, .github/workflows/ci.yml, packaging-report.md, DISTRIBUTABLE.md, Makefile	Pro
Deploy	deploy/Dockerfile, deploy/render.yaml, deploy/deploy.sh, deploy/worker.ts, deploy-qualification-report.md	Pro

API Endpoints

Core Pipeline

Method	Path	Description
POST	/v1/snapshots	Upload repo snapshot (multipart file upload)
POST	/v1/github/analyze	Analyze repo from GitHub URL
GET	/v1/snapshots/:id	Get snapshot metadata
GET	/v1/projects/:project_id/snapshots	List snapshots for project
POST	/v1/search/export	Run search program
POST	/v1/skills/generate	Run skills program
POST	/v1/debug/analyze	Run debug program
POST	/v1/frontend/audit	Run frontend program
POST	/v1/seo/analyze	Run SEO program
POST	/v1/optimization/analyze	Run optimization program
POST	/v1/theme/generate	Run theme program
POST	/v1/brand/generate	Run brand program
POST	/v1/superpowers/generate	Run superpowers program
POST	/v1/marketing/generate	Run marketing program
POST	/v1/notebook/generate	Run notebook program
POST	/v1/obsidian/analyze	Run obsidian program
POST	/v1/mcp/provision	Run MCP program
POST	/v1/artifacts/generate	Run artifacts program
POST	/v1/remotion/generate	Run remotion program
POST	/v1/canvas/generate	Run canvas program
POST	/v1/algorithmic/generate	Run algorithmic program
POST	/v1/agentic-purchasing/generate	Run agentic purchasing program
GET	/v1/programs	List all programs with generator counts
GET	/v1/projects/:id/generated-files/:path	Download individual generated file
GET	/v1/projects/:id/export	Download ZIP of generated files

Billing & Account

Method	Path	Description
POST	/v1/accounts	Create account
GET	/v1/account	Get account info
POST	/v1/account/keys	Create API key
GET	/v1/account/keys	List API keys
POST	/v1/account/keys/:id/revoke	Revoke API key
GET	/v1/account/usage	Get usage stats
GET	/v1/account/quota	Get quota info
POST	/v1/account/tier	Update billing tier
POST	/v1/account/programs	Update program entitlements
POST	/v1/account/github-token	Save encrypted GitHub token
GET	/v1/account/github-token	List GitHub tokens
DELETE	/v1/account/github-token/:token_id	Delete GitHub token
GET	/v1/billing/history	Billing tier change audit trail
GET	/v1/billing/proration	Proration preview for tier changes

Funnel & Plans

Method	Path	Description
GET	/v1/plans	Get plan catalog
POST	/v1/account/seats	Invite team member
GET	/v1/account/seats	List team seats
POST	/v1/account/seats/:id/revoke	Revoke seat
GET	/v1/account/upgrade-prompts	Get contextual upgrade prompts
GET	/v1/account/funnel-status	Get funnel stage
GET	/v1/admin/funnel-metrics	Aggregate funnel analytics

Search & Versions

Method	Path	Description
POST	/v1/search/index	Index snapshot content for full-text search
POST	/v1/search/query	Full-text search across indexed content
GET	/v1/search/:id/stats	Search index statistics
GET	/v1/snapshots/:id/versions	List generation versions
GET	/v1/snapshots/:id/versions/:num	Get specific version with files
GET	/v1/snapshots/:id/diff?old=N&new=M	Diff between two versions

Webhooks

Method	Path	Description
POST	/v1/account/webhooks	Create webhook
GET	/v1/account/webhooks	List webhooks
DELETE	/v1/account/webhooks/:id	Delete webhook
POST	/v1/account/webhooks/:id/toggle	Toggle webhook active/disabled
GET	/v1/account/webhooks/:id/deliveries	List delivery attempts

Infrastructure

Method	Path	Description
GET	/v1/health	Health check
GET	/v1/health/live	Liveness probe
GET	/v1/health/ready	Readiness probe (DB connectivity)
GET	/v1/metrics	Prometheus-style metrics
GET	/v1/db/stats	Database statistics
POST	/v1/db/maintenance	Database maintenance (vacuum, WAL checkpoint)
GET	/v1/docs	OpenAPI 3.1 specification
GET	/v1/admin/stats	System-wide statistics
GET	/v1/admin/accounts	Admin: list all accounts
GET	/v1/admin/activity	Admin: recent activity feed

Input Methods

1. File Upload — POST /v1/snapshots with multipart body
2. GitHub URL — POST /v1/github/analyze with { "url": "https://github.com/..." }
3. CLI (local) — axis analyze <directory> scans local files
4. CLI (remote) — axis github <url> fetches from GitHub

Tech Stack

• Runtime: Node.js 20+, TypeScript 5.7 strict
• Backend: Zero-dependency custom HTTP router, Neon Postgres (pg, async pooled)
• Frontend: Vite 6 + React 19, CSS design system (dark theme)
• Testing: Vitest 4 — ~4,900 tests across ~190 files, run against Postgres 16
• Benchmarks: Vitest bench — parseRepo 200 files in ~21ms; deterministic 142-artifact generation in ~300ms
• Build: pnpm workspaces, tsc per package
• CI: GitHub Actions (Node 20/22 matrix, coverage, dep audit, Docker build)

Development

pnpm install          # Install all dependencies
pnpm build            # Build all packages + apps
pnpm test             # Run all tests
npx vitest run        # Run tests directly
npx vitest bench      # Run performance benchmarks
npx vitest --coverage # Run tests with coverage report

See CONTRIBUTING.md for how to add a generator, endpoint, or program.

Input methods

Method	How
GitHub URL	POST /v1/github/analyze with {"url":"https://github.com/..."}
File upload	POST /v1/snapshots multipart body
CLI (local)	axis analyze <directory>
CLI (remote)	axis github <url>
MCP	tools/call → analyze_repo or analyze_files

---

Website: https://iliad.trustfabric.ai · Live API: https://axis-api-6c7z.onrender.com · Docs: https://axis-api-6c7z.onrender.com/v1/docs · MCP: https://axis-api-6c7z.onrender.com/mcp

License

Private. All rights reserved.