Axis Iliad — Codebase Intelligence For Agentic Commerce

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: packages/generator-core/src/estate-registry.ts, served live at GET /.well-known/axis-estate.json (superseding ecosystem.registry.yaml, retired 2026-08-22 — see docs/ESTATE_FEDERATION_STRATEGY.md).

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

x402 contract: docs/x402/CONTRACT.md

---

Try it in 30 seconds — no signup required

Every program ships free artifacts with no API key — 47 of the 152 in total. Three programs are free in full:

# 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: 47 artifacts spanning all 21 programs — Search (context maps), Skills (AGENTS.md, CLAUDE.md, .cursorrules) and Debug (playbooks, incident templates) in full, plus each other program's headline artifact (design tokens, Dockerfile, MCP config, brand guidelines, ...). Paying unlocks each program's remaining artifacts.

---

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 / 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, 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.01 and exercises the real x402 payment loop, the cheapest paid call in the catalog.

---

Pricing

Tier	Price	Programs
Free	$0	47 artifacts across all 21 programs (Search, Skills, Debug in full)
Pro	$3.00 / 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

# 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, 187 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/ → 152 generators across 21 programs
└── vitest.config.ts  → Shared test config

Programs (21)

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 harness (packages/repo-parser/src/perf.bench.ts, npx vitest bench) covers parseRepo at 200-file scale; no specific latency number is pinned here — this repo's own honesty policy (see packages/generator-core/src/perf-compliance.test.ts) bans citing a perf figure unless it's sourced from a checked-in, machine-generated results file, which doesn't yet exist for this bench. The 7 agentic-purchasing engines DO have one: packages/generator-core/perf-results.json (regenerate via pnpm bench:compliance).
• 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.