Axis Iliad - Codebase Intelligence For Agentic Commerce

Axis' Iliad

Axis' Iliad — 生のコードベースを、エージェント対応の標準的なアーティファクトへと形作る現代の叙事詩です。Axis' Iliad は、自然言語によるワークスペース開発の次の時代に向けた、決定的な基盤を作り上げます。

標準名称： Axis' Iliad。この名称は、ドキュメント、レジストリ、インテグレーション全体で一貫して使用してください。

---

AXIS エコシステム

Iliad は、Trust Fabric スタックにおけるx402 のショーケースです。レジストリ全体は packages/generator-core/src/estate-registry.ts にあり、GET /.well-known/axis-estate.json でライブ配信されています（ecosystem.registry.yaml に代わるもので、同ファイルは 2026-08-22 に廃止されました。詳細は docs/ESTATE_FEDERATION_STRATEGY.md を参照してください）。

プロジェクト	役割	x402
Axis' Iliad（このリポジトリ）	エージェントアーティファクト + MCP ゲートウェイ	接続済み — @axis/mpp
PAID	マルチレール決済 + 決済処理	決済レイヤー（Go x402 を計画中）
AXIS Foundry	3D パイプライン + MCP	一部対応
Trust Fabric	コンプライアンス監査、修正 + Trust Passport	計画中

x402 コントラクト：docs/x402/CONTRACT.md

---

30 秒で試す — サインアップ不要

各プログラムでは、API キーなしで無料のアーティファクトを利用できます。全 152 個のうち 47 個が無料です。3 つのプログラムはすべて無料で利用できます：

# 1. Get an API key (free tier, instant)
curl -X POST https://api.iliad.trustfabric.ai/v1/accounts \
  -H 'Content-Type: application/json' \
  -d '{"email":"[email protected]","name":"My Agent","tier":"free"}'

# 2. Analyze any public GitHub repo
curl -X POST https://api.iliad.trustfabric.ai/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://api.iliad.trustfabric.ai/v1/projects/PROJECT_ID/export \
  -H 'Authorization: Bearer YOUR_API_KEY' -o artifacts.zip

無料枠の内容： 全 21 プログラムにわたる 47 個のアーティファクトです。Search（コンテキストマップ）、Skills（AGENTS.md、CLAUDE.md、.cursorrules）、Debug（プレイブック、インシデントテンプレート）はすべて無料で利用でき、さらに他の各プログラムの主要アーティファクト（デザイントークン、Dockerfile、MCP 設定、ブランドガイドラインなど）も含まれます。支払いにより、各プログラムの残りのアーティファクトが利用可能になります。

---

得られるもの

1 回のスキャンで 21 のプログラムにわたる 152 個の成果物を、数秒で生成できます。

必要なもの	プログラム	主な出力
新しい AI エージェントに概要を把握させる	Search (無料)	context-map.json、repo-profile.yaml、architecture-summary.md
あらゆる LLM にコードベースのコンテキストを提供する	Skills (無料)	AGENTS.md、CLAUDE.md、.cursorrules、workflow-pack.md
本番環境のインシデントをデバッグする	Debug (無料)	debug-playbook.md、tracing-rules.md、root-cause-checklist.md
UI を監査する	Frontend	frontend-rules.md、ui-audit.md、component-guidelines.md
検索順位を改善する	SEO	seo-rules.md、meta-tag-audit.json、schema-recommendations.json
LLM のコストを削減する	Optimization	optimization-rules.md、cost-estimate.json、token-budget-plan.md
デザインシステムをリリースする	Theme	design-tokens.json、theme.css、dark-mode-tokens.json
ブランドの声を統一する	Brand	brand-guidelines.md、voice-and-tone.md、messaging-system.yaml
開発ワークフローを自動化する	Superpowers	superpower-pack.md、workflow-registry.json、automation-pipeline.yaml
キャンペーンを開始する	Marketing	campaign-brief.md、funnel-map.md、ab-test-plan.md
データ／リサーチツールを構築する	Notebook	notebook-summary.md、research-threads.md、source-map.json
ナレッジ保管庫を管理する	Obsidian	obsidian-skill-pack.md、vault-rules.md、graph-prompt-map.json
AI ツールを接続する（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
コンポーネントを生成する	Artifacts	generated-component.tsx、dashboard-widget.tsx、component-library.json
開発動画を作成する	Remotion	remotion-script.ts、scene-plan.md、storyboard.md
ソーシャル／ビジュアルアセット	Canvas	canvas-spec.json、social-pack.md、poster-layouts.md
ジェネレーティブアート／NFT	Algorithmic	generative-sketch.ts、variation-matrix.json、parameter-pack.json
エージェント型コマース（Visa AP2）	Agentic Purchasing	agent-purchasing-playbook.md、checkout-flow.md、negotiation-rules.md

さらに begin ループ — エージェントに渡して begin と伝えましょう

すべての分析には、AI コーディングエージェントが作業を理解するだけでなく、完了できるようにする自律制御ループも組み込まれています。

• begin.yaml — ループの起点です。推定された目標、human-in-the-loop プロトコル（担当者が回答するのは平易な英語によるプロダクト関連の質問のみ）、次の作業を選択するアルゴリズム、そして収束する停止条件が含まれます。
• continuation.yaml — ループの状態です。すべての成果物を並べた順序付きのステップリストと、分析結果をもとに初期化された優先度付きの候補キュー（目標、検出された不足点、テストが存在しない場合の検証ハーネス）が含まれます。
• すべての Markdown 成果物には ⟳ Continue フッターが付きます。最後のステップでは begin を自己プロンプトし、ループを begin.yaml に戻します。

パックをダウンロードし（CLI、MCP、またはフルパックのエクスポート）、エージェントに渡して begin と伝えましょう。エージェントはキューに沿って作業し、各ステップを検証して、キューが空になった時点で停止します（収束するため、暴走することはありません）。担当者側でコーディングする必要はありません。

AXIS はこれを自分自身にも活用しています。このリポジトリのルートにある begin.yaml / continuation.yaml は、私たちが実際に使っている稼働中のループです。また、REST から GET /begin.yaml / GET /continuation.yaml でそのまま提供されるため、この API を巡回するエージェントは、リポジトリをクローンしなくても同じ規約を確認できます。

---

AI エージェント向け — MCP 統合

AXIS は https://api.iliad.trustfabric.ai/mcp で Streamable HTTP MCP サーバーを公開しています。エージェントに追加すると、あらゆるリポジトリを分析したり、エージェント型購買に自律的に備えたりできます。

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "axis-iliad": {
      "type": "http",
      "url": "https://api.iliad.trustfabric.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "axis-iliad": {
      "url": "https://api.iliad.trustfabric.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

無料の MCP ツール（認証不要）：list_programs、search_and_discover_tools、get_install_manifest、discover_agentic_purchasing_needs、prepare_agentic_purchasing_preview、discover_estate_tools（兄弟関係にある AXIS プロパティ — 決済、3D 生成など）、および決定論的なコマース判定エンジン：sca_exemption_decision、grade_compliance、assemble_ce3_evidence、build_ap2_mandate、score_dispute_readiness（証拠収集の準備状況 — 紛争に勝つ予測ではありません）。さらに 5 つのツールは、estate フラグ付きの計画中機能のスタブです（Foundry Wave-1。Iliad ホストのプロキシが提供されるまでは、Foundry 独自の MCP エンドポイントにリダイレクトします）：axis_validate、axis_inspect、axis_compare、axis_manifest_verify、roblox_compliance_check。get_referral_code、get_referral_credits、iliad_network_tokenization も無料（料金不要）ですが、上記のツールとは異なり、認証が必要です。ping_payment は無料ではありません。料金は $0.01 で、カタログ内で最も安価な有料呼び出しとして、実際の x402 決済ループを実行します。

---

料金

ティア	料金	プログラム
Free	$0	21 個すべてのプログラムで 47 個のアーティファクト（Search、Skills、Debug をすべて利用可能）
Pro	$3.00 / 実行	21 個すべてのプログラム、152 個のアーティファクト
Lite mode	$0.15–$0.25 / 実行	上位のギャップの概要、出力を削減

予算交渉：有料呼び出し時に X-Agent-Budget: {"budget_per_run_cents": 25} と X-Agent-Mode: lite を送信してください。

---

セルフホスト

システム要件

• Node.js：≥ 20.x（LTS を推奨）
• pnpm：≥ 9.x
• OS：macOS 11 以降、Linux（任意のディストリビューション）、または Windows 10 以降
• RAM：最低 4 GB（8 GB を推奨）
• ディスク容量：依存関係とビルド用に約 2 GB

クイックスタート

# 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

必要なもの：Docker 20.10 以降、または Docker Desktop

---

アーキテクチャ

axis-iliad/
├── apps/
│   ├── api/          → Zero-dependency HTTP server (port 4000, 188 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

コアパイプライン

メソッド	パス	説明
POST	/v1/snapshots	リポジトリのスナップショットをアップロードします（マルチパートファイルアップロード）
POST	/v1/github/analyze	GitHub URL からリポジトリを分析します
GET	/v1/snapshots/:id	スナップショットのメタデータを取得します
GET	/v1/projects/:project_id/snapshots	プロジェクトのスナップショット一覧を取得します
POST	/v1/search/export	検索プログラムを実行します
POST	/v1/skills/generate	スキルプログラムを実行します
POST	/v1/debug/analyze	デバッグプログラムを実行します
POST	/v1/frontend/audit	フロントエンドプログラムを実行します
POST	/v1/seo/analyze	SEO プログラムを実行します
POST	/v1/optimization/analyze	最適化プログラムを実行します
POST	/v1/theme/generate	テーマプログラムを実行します
POST	/v1/brand/generate	ブランドプログラムを実行します
POST	/v1/superpowers/generate	superpowers プログラムを実行します
POST	/v1/marketing/generate	マーケティングプログラムを実行します
POST	/v1/notebook/generate	ノートブックプログラムを実行します
POST	/v1/obsidian/analyze	obsidian プログラムを実行します
POST	/v1/mcp/provision	MCP プログラムを実行します
POST	/v1/artifacts/generate	アーティファクトプログラムを実行します
POST	/v1/remotion/generate	remotion プログラムを実行します
POST	/v1/canvas/generate	canvas プログラムを実行します
POST	/v1/algorithmic/generate	algorithmic プログラムを実行します
POST	/v1/agentic-purchasing/generate	エージェント型購買プログラムを実行します
GET	/v1/programs	すべてのプログラムとジェネレーター数の一覧を取得します
GET	/v1/projects/:id/generated-files/:path	個別の生成ファイルをダウンロードします
GET	/v1/projects/:id/export	生成ファイルの ZIP をダウンロードします

請求とアカウント

メソッド	パス	説明
POST	/v1/accounts	アカウントを作成します
GET	/v1/account	アカウント情報を取得します
POST	/v1/account/keys	API キーを作成します
GET	/v1/account/keys	API キーの一覧を取得します
POST	/v1/account/keys/:id/revoke	API キーを無効化します
GET	/v1/account/usage	使用状況の統計を取得します
GET	/v1/account/quota	クォータ情報を取得します
POST	/v1/account/tier	請求プランを更新します
POST	/v1/account/programs	プログラムの利用権を更新します
POST	/v1/account/github-token	暗号化された GitHub トークンを保存します
GET	/v1/account/github-token	GitHub トークンの一覧を取得します
DELETE	/v1/account/github-token/:token_id	GitHub トークンを削除します
GET	/v1/billing/history	請求プラン変更の監査履歴
GET	/v1/billing/proration	プラン変更時の日割り計算プレビュー

ファネルとプラン

メソッド	パス	説明
GET	/v1/plans	プランカタログを取得します
POST	/v1/account/seats	チームメンバーを招待します
GET	/v1/account/seats	チームシートの一覧を取得します
POST	/v1/account/seats/:id/revoke	シートを無効化します
GET	/v1/account/upgrade-prompts	状況に応じたアップグレード案内を取得します
GET	/v1/account/funnel-status	ファネルの段階を取得します
GET	/v1/admin/funnel-metrics	ファネル分析データを集計します

検索とバージョン

メソッド	パス	説明
POST	/v1/search/index	全文検索用にスナップショットの内容をインデックス化します
POST	/v1/search/query	インデックス化されたコンテンツを対象に全文検索します
GET	/v1/search/:id/stats	検索インデックスの統計情報を取得します
GET	/v1/snapshots/:id/versions	生成バージョンの一覧を取得します
GET	/v1/snapshots/:id/versions/:num	ファイルを含む特定のバージョンを取得します
GET	/v1/snapshots/:id/diff?old=N&new=M	2 つのバージョン間の差分

Webhook

メソッド	パス	説明
POST	/v1/account/webhooks	Webhook を作成します
GET	/v1/account/webhooks	Webhook の一覧を取得します
DELETE	/v1/account/webhooks/:id	Webhook を削除します
POST	/v1/account/webhooks/:id/toggle	Webhook の有効・無効を切り替えます
GET	/v1/account/webhooks/:id/deliveries	配信試行の一覧を取得します

インフラストラクチャ

メソッド	パス	説明
GET	/v1/health	ヘルスチェック
GET	/v1/health/live	ライブネスプローブ
GET	/v1/health/ready	レディネスプローブ（DB 接続）
GET	/v1/metrics	Prometheus 形式のメトリクス
GET	/v1/db/stats	データベース統計
POST	/v1/db/maintenance	データベースのメンテナンス（vacuum、WAL チェックポイント）
GET	/v1/docs	OpenAPI 3.1 仕様
GET	/v1/admin/stats	システム全体の統計
GET	/v1/admin/accounts	管理者：すべてのアカウントを一覧表示
GET	/v1/admin/activity	管理者：最近のアクティビティフィード

入力方法

1. ファイルアップロード — multipart ボディを使用して POST /v1/snapshots
2. GitHub URL — { "url": "https://github.com/..." } を指定して POST /v1/github/analyze
3. CLI（ローカル） — axis analyze <directory> でローカルファイルをスキャン
4. CLI（リモート） — axis github <url> で GitHub から取得

技術スタック

• ランタイム: Node.js 20+、TypeScript 5.7 strict
• バックエンド: 依存関係ゼロのカスタム HTTP ルーター、Neon Postgres（pg、非同期プール）
• フロントエンド: Vite 6 + React 19、CSS デザインシステム（ダークテーマ）
• テスト: Vitest 4 — 約190ファイルにわたる約4,900件のテストを Postgres 16 に対して実行
• ベンチマーク: Vitest ベンチハーネス（packages/repo-parser/src/perf.bench.ts、npx vitest bench）で、200ファイル規模の parseRepo を測定します。ここでは特定のレイテンシ値を示していません。このリポジトリ独自の誠実性ポリシー（packages/generator-core/src/perf-compliance.test.ts を参照）では、チェックイン済みの機械生成結果ファイルを出典としないパフォーマンス値の引用を禁止しています。このベンチマーク用の結果ファイルはまだ存在しません。7つのエージェント型購買エンジンには結果ファイルがあります：packages/generator-core/perf-results.json（pnpm bench:compliance で再生成）。
• ビルド: pnpm ワークスペース、パッケージごとに tsc
• CI: GitHub Actions（Node 20/22 マトリックス、カバレッジ、依存関係監査、Docker ビルド）

開発

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

ジェネレーター、エンドポイント、またはプログラムの追加方法については、CONTRIBUTING.md を参照してください。

入力方法

方法	手順
GitHub URL	{"url":"https://github.com/..."} を指定して POST /v1/github/analyze
ファイルアップロード	POST /v1/snapshots の multipart ボディ
CLI（ローカル）	axis analyze <directory>
CLI（リモート）	axis github <url>
MCP	tools/call → analyze_repo または analyze_files

---

ウェブサイト: https://iliad.trustfabric.ai · ライブ API: https://api.iliad.trustfabric.ai · ドキュメント: https://api.iliad.trustfabric.ai/v1/docs · MCP: https://api.iliad.trustfabric.ai/mcp

ライセンス

非公開。すべての権利を保有します。