
# AI Research Arm
**The AI newspaper that writes itself.** Every few hours, a fleet of LLM agents
reads the AI firehose โ Twitter/X, RSS, Hacker News, Reddit, Bluesky, arXiv,
expert blogs, YouTube. Every night it writes the paper: a synthesized digest, a
rendered front page, a model-release timeline, a compounding wiki. Every week it
audits its own methodology and may open a review PR. Humans review code and
methodology changes; routine publication PRs merge automatically after their
scope and output contracts pass.
[](https://github.com/guzus/ai-research-arm/actions/workflows/ci.yml)
[](https://ara.guzus.xyz)
[](LICENSE)
[](https://github.com/guzus/ai-research-arm/commits/main)
Running unattended since January 2026. As of 2026-08-19, **32 GitHub Actions
workflow files** orchestrate the pipeline, and the repository contains **5,700+
files under `research/`** โ 152 daily digests, 109 rendered front pages, 101
generative-research archive entries, 186 model-release tickets, and a 93-page
wiki. Public outputs deploy continuously to
**[ara.guzus.xyz](https://ara.guzus.xyz)**.
๐ [Why this is open source](https://guzus.substack.com/p/open-sourcing-ai-research-arm-ara) ยท
[What's changed since the post](docs/since-the-open-sourcing-post.md) ยท
[Operator's manual](CLAUDE.md)
## Today's Front Page
<!-- FRONT_PAGE_START -->

<!-- FRONT_PAGE_END -->
> ๐๏ธ Rendered after each successful daily digest โ deterministic SVGโPNG, no
> model in the render path. [Interactive edition](https://ara.guzus.xyz/frontpage) ยท
> [archive](research/front-page/)
## What it publishes
| Output | Cadence | Live | Source of truth |
|---|---|---|---|
| ๐๏ธ **Front page** โ the day's digest as a newspaper | after a successful daily digest | [/frontpage](https://ara.guzus.xyz/frontpage) | [`research/front-page/`](research/front-page/) |
| ๐ฐ **Daily digest** โ all-source synthesis, with TTS audio | daily 00:00 | [/today](https://ara.guzus.xyz/today) | [`research/digest/`](research/digest/) |
| ๐ซ **Model timeline** โ one CRUD'd ticket per release, funding round, or legal fight | daily | [/models](https://ara.guzus.xyz/models) | [`research/models/tickets/`](research/models/tickets/) |
| ๐ **LLM wiki** โ compounding knowledge base; one page per entity, concept, theme | daily, post-digest | [/wiki](https://ara.guzus.xyz/wiki) | [`research/wiki/`](research/wiki/) |
| ๐ฌ **Generative research** โ long-form, heavily-cited articles in a custom DSL | on demand | [/research](https://ara.guzus.xyz/research) | [`research/generative/`](research/generative/) |
| ๐ฆ **Twitter reports** โ from a reviewed, self-expanding account manifest | every 3h | [/twitter](https://ara.guzus.xyz/twitter) | [`research/twitter/`](research/twitter/) |
| ๐ฃ **Headline alerts** โ deduped breaking-news pings | every 3h | Telegram | [`research/summaries/`](research/summaries/) |
Recent articles the pipeline researched, wrote, validated, and published by
itself: *"Reward Hacking at Scale"*, *"Meta Compute: the surplus that reprices
the neocloud"*, *"Anthropic vs the Pentagon: the unprecedented
supply-chain-risk label"* โ [browse all](https://ara.guzus.xyz/research).
## Quickstart (no accounts needed)
Prerequisites: Node.js 22.12+ and [Bun](https://bun.sh). The current checkout
contains no Git LFS objects; the committed sample data and front-page images
build from a normal clone.
The dashboard builds and runs against the sample research data already
committed in this repo โ no API keys or secrets required:
```bash
cd dashboard
bun install --frozen-lockfile
bun run test # dashboard data, Korean UI, rendering, and SEO contracts
bun run dev # local dev server at http://localhost:5173
# or: bun run build # production build into dashboard/dist/
```
Python tooling is stdlib-first and managed with [uv](https://docs.astral.sh/uv/):
```bash
uv sync --frozen --all-extras
uv run python -m unittest discover -s scripts -p 'test_*.py'
```
Running the **full data pipeline** needs your own credentials and
infrastructure โ see [What you can run vs. what needs accounts](#what-you-can-run-vs-what-needs-accounts).
## Architecture
Read โ synthesize โ publish โ improve. Published text, indexes, and front-page
artifacts are committed to git, so their history is diffable. Transient inputs,
Telegram delivery, and S3-hosted audio are explicit exceptions.
```mermaid
flowchart TB
subgraph read["๐ก READ โ around the clock"]
direction LR
Twitter["๐ฆ Twitter/X<br/><i>3h</i>"]
RSS["๐ RSS<br/><i>2h</i>"]
HN["๐ HN ยท ๐ด Reddit<br/><i>4h</i>"]
Blogs["โ๏ธ Expert blogs<br/><i>6h</i>"]
Bluesky["๐ฆ Bluesky<br/><i>daily</i>"]
arXiv["๐ arXiv<br/><i>daily</i>"]
YouTube["โถ๏ธ YouTube<br/><i>daily</i>"]
end
read --> store[("๐ research/<br/>versioned publication record")]
subgraph synth["๐ง SYNTHESIZE โ daily"]
Digest["๐ฐ Daily digest<br/><i>00:00 UTC ยท + TTS audio</i>"]
Tickets["๐ซ Model-release tickets<br/><i>CRUD'd, never regenerated</i>"]
Wiki["๐ LLM wiki<br/><i>compounds from the digest</i>"]
end
store --> Digest
store --> Tickets
Digest --> Wiki
subgraph publish["๐ PUBLISH"]
Front["๐๏ธ Front page<br/><i>deterministic SVGโPNG</i>"]
Gen["๐ฌ Cited research articles<br/><i>on demand</i>"]
TG["๐ฃ Telegram alerts"]
Site["๐ฅ๏ธ ara.guzus.xyz<br/><i>Railway rebuilds on every push to main</i>"]
end
Digest --> Front
store --> Gen
Twitter -.-> TG
Digest --> Site
Tickets --> Site
Wiki --> Site
Front --> Site
Gen --> Site
Improve["๐ IMPROVE โ weekly<br/><i>audits output, proposes scoped fixes</i>"]
Site -.-> Improve
Improve -.-> read
```
The dashboard is a Vite + Bun + TypeScript SPA. On every push to `main`,
Railway rebuilds the root [`Dockerfile`](Dockerfile) (bun build โ Caddy serve,
behind Cloudflare); `dashboard/scripts/prebuild.mjs` copies the dashboard's
selected committed output directories into the site before Vite runs. There is
no deploy workflow โ publishing research *is* deploying.
## Backend routing
Which model serves each lane โ and where it falls back on a provider
outage โ is defined in one file:
[`data/agent-backends.json`](data/agent-backends.json). `agent-run` lanes
resolve it at runtime; container/native mirror lanes pin the same route in
their workflow and CI checks equality. The diagram below is generated from
the SSOT so it cannot drift. Full per-lane matrix:
[`docs/backend-matrix.md`](docs/backend-matrix.md). To register another model,
see [`docs/model-onboarding.md`](docs/model-onboarding.md); a model on an
existing adapter/provider is registry-driven, while a new provider still
requires credential and contained-runner plumbing.
<!-- BEGIN GENERATED BACKEND DIAGRAM (scripts/build_backend_matrix.py โ do not edit by hand) -->
```mermaid
flowchart LR
subgraph runtime["โ๏ธ Runtime-routed lanes โ lane: โ data/agent-backends.json"]
lanes0["ai-news-research ยท digest-audio-script ยท digest-synthesis<br/>digest-synthesis-fallback ยท model-timeline ยท twitter-autoresearch<br/>twitter-judge ยท twitter-primary ยท twitter-primary-repair<br/><i>9 lanes</i>"]
strict0["๐ chubby-canary<br/><i>strict โ never falls back</i>"]
strict1["๐ claude-canary ยท twitter-ab-claude ยท twitter-ab-judge<br/>twitter-ab-judge-swapped<br/><i>strict โ never falls back</i>"]
strict2["๐ aradio ยท arxiv ยท bluesky<br/>community ยท generative-research-ko ยท rss<br/>wiki-ingest<br/><i>strict โ never falls back</i>"]
strict3["๐ twitter-deepseek<br/><i>strict โ never falls back</i>"]
strict4["๐ twitter-ab-zai ยท twitter-zai ยท zai-canary<br/><i>strict โ never falls back</i>"]
gendef["generative-research-default<br/><i>dispatch default</i>"]
end
subgraph mirrors["๐ช CI-enforced mirrors โ literal in workflow, equality-gated"]
pi["twitter-deepseek-pi ยท twitter-fireworks-pi"]
native["ai-news-research-mcp ยท claude-code-review ยท claude-interactive<br/>daily-improve ยท generative-research-claude ยท research-issue<br/>twitter-account-explorer"]
end
subgraph providers["๐ญ Token providers"]
FW["๐ Fireworks"]
CHUB["Office Chubby<br/><i>Messages ยท manual canary</i>"]
ZAI["โก Z.ai"]
ANT["๐
ฐ๏ธ Anthropic<br/><i>native Claude</i>"]
OC["๐ OpenCode Go<br/><i>opencode CLI</i>"]
CUR["๐ฑ๏ธ Cursor CLI<br/><i>agent</i>"]
OAI["๐ค OpenAI Codex CLI<br/><i>ChatGPT auth</i>"]
end
lanes0 -->|"claude-opus-5-5"| ANT
strict0 -->|"deepseek-v4.1-flash-1017"| CHUB
strict1 -->|"claude-opus-5-5"| ANT
strict2 -->|"cursor-grok-4.6-high-fast"| CUR
strict3 -->|"deepseek-v4-flash"| FW
strict4 -->|"glm-5.3"| ZAI
gendef -->|"claude-opus-5-5"| ANT
pi -->|"deepseek-v4-flash ยท kimi-k2p7"| FW
native -->|"claude-sonnet-5-5"| ANT
gendef -.->|"backend=codex"| OAI
gendef -.->|"backend=opencode-deepseek-v4-flash ยท backend=opencode-muse-spark-1p3-contributor"| OC
gendef -.->|"backend=cursor-grok-4p6-fast"| CUR
ANT -. "provider outage โ fallback #1" .-> ZAI
```
_Generated from [`data/agent-backends.json`](data/agent-backends.json) โ fallback chain: `claude` โ `zai-glm-5p3`; regenerate with `uv run python scripts/build_backend_matrix.py`._
<!-- END GENERATED BACKEND DIAGRAM -->
## Sources
| Source | Method | Frequency |
|--------|--------|-----------|
| **Twitter/X** | Birdy read-only multi-fetch (reviewed account manifest + 7 searches) | Every 3 hours |
| **RSS feeds** | Direct XML fetch (OpenAI, Anthropic, DeepMind, TechCrunch, โฆ) | Every 2 hours |
| **Hacker News** | Algolia HN Search API | Every 4 hours |
| **Reddit** | RSS feeds (r/MachineLearning, r/LocalLLaMA, r/artificial) | Every 4 hours |
| **Expert blogs** | Curated KOL/researcher/operator feed registry; selected feeds also emit GUID-deduplicated Telegram alerts | Every 6 hours (subscriptions every 2 hours) |
| **Bluesky** | Public API | Daily |
| **arXiv** | Direct Atom API (plus RSS in the RSS lane) | Daily |
| **YouTube** | tuber API discovery + read-only summaries/transcripts | Daily |
| **Web search** | Exa/Perplexity MCP (optional) | On demand |
The Twitter account manifest ([`data/sources/twitter_accounts.json`](data/sources/twitter_accounts.json))
is itself agent-curated: a weekly explorer lane scouts for high-signal
accounts โ favoring ones vouched for by accounts already monitored, and
on-topic for AI over merely viral โ and opens a reviewed PR when the evidence
is strong. Contract: [`docs/twitter-account-curation.md`](docs/twitter-account-curation.md).
## Workflows
All 32 workflows live in [`.github/workflows/`](.github/workflows/). The
interesting ones:
**Aggregate** โ raw signal in, markdown out
| Workflow | Schedule | Output |
|---|---|---|
| `hourly-twitter.yml` | every 3h | `research/twitter/` + Telegram headline alerts (plus DeepSeek/pi comparison tiers) |
| `hourly-rss.yml` | every 2h | `research/rss/` |
| `4h-community.yml` | every 4h | `research/community/` (HN + Reddit) |
| `daily-ai-blogs.yml` | every 6h | `research/blogs/` |
| `blog-subscriptions.yml` | every 2h | Telegram alerts + `research/summaries/blog-subscriptions.json` GUID state |
| `2h-bluesky.yml` | daily | `research/bluesky/` |
| `daily-arxiv.yml` | daily | `research/arxiv/` |
| `daily-youtube.yml` | daily | `research/youtube/` |
| `daily-earnings.yml` | weekdays, every 2 h (last run before the digest) | `research/earnings/` (SEC EDGAR earnings filings for AI-exposed issuers; one file per event, nothing on a quiet day) |
| `twitter-account-explorer.yml` | weekly | reviewed PRs against the account manifest |
**Synthesize** โ read everything, write the record
| Workflow | Schedule | Output |
|---|---|---|
| `daily-digest.yml` | daily 00:00 UTC | `research/digest/` + TTS audio |
| `24h-model-timeline.yml` | daily | CRUDs `research/models/tickets/` + daily diff |
| `wiki-ingest.yml` | after the digest | updates `research/wiki/` from the *curated* synthesis |
| `ai-news-research.yml` | twice daily | broad topic sweep via Perplexity/Exa MCP |
**Publish** โ shareable artifacts
| Workflow | Trigger | Output |
|---|---|---|
| `daily-front-page.yml` | after a successful daily digest | newspaper PNG + interactive edition |
| `generative-research.yml` | issue label or dispatch | long-form cited article |
| `translate-generative-research.yml` | after each production generative article; manual dispatch also available | validated Korean article translation; automatic runs merge after all gates pass |
| `research-issue.yml` | `research` issue label | report posted back to the issue |
**Keep it honest** โ the pipeline watching itself
| Workflow | Trigger | Purpose |
|---|---|---|
| `daily-improve.yml` | weekly Mon | audits output; opens a methodology PR when it finds a scoped change |
| `liveness-check.yml` | scheduled | per-lane freshness watchdog, runs on *both* runner tiers |
| `auto-rerun-on-runner-loss.yml` | on failure | re-runs jobs whose runner vanished (loop-capped) |
| `ci.yml` | push/PR | actionlint + dashboard tests/typecheck/build + Python tests and data validators |
| `claude.yml` / `claude-code-review.yml` | `@claude` / PR | interactive agent + automated review |
Exact cron expressions and event dependencies live in the workflow YAML; the
tables above describe cadence without duplicating a second schedule that can
drift.
## Research on demand
Three ways maintainers and trusted collaborators can commission work from the
pipeline:
**1. Issue โ research report.** A repository owner, member, or collaborator
opens an issue and adds the `research` label. The agent acknowledges it,
researches with web search + MCP tools, commits a report to `research/issues/`,
and posts the findings back on the issue.
**2. Topic โ published article.** A trusted issue author uses the
`gen-research` label, or a maintainer dispatches `generative-research.yml` with
a `topic`. The agent researches primary sources, writes in the
[ARA DSL](ARA_DSL.md) (a validated component language โ see
[Component catalog](COMPONENTS.md)), and publishes through a single writer
path that re-validates everything before commit. The SSOT generative default is
native Claude Opus 5.5; explicit selectors also expose Codex, OpenCode DeepSeek
and Meta Muse Spark 1.3 Contributor, Cursor, and Fireworks routes. Muse is
region-limited and requires explicit consent to Contributor model-improvement
data collection, so it is not a production editorial default. Separately, the five scheduled editorial lanes
and Korean translation currently run on Cursor after its 2026-11-05 canary
passed; Claude is quota-blocked and OpenCode harness recovery is unverified
([details](docs/generative-research-backends.md)).
**3. Tweet โ verified article.** Give it just a tweet URL โ it reads the
thread, infers the underlying research question, then verifies the claims
against independent primary sources before writing:
```bash
gh workflow run generative-research.yml \
-f twitter_url="https://x.com/<handle>/status/<id>"
```
## Built to keep running
The interesting engineering is less "call an LLM" and more "survive every way
this can break":
- **Fail-closed publishing.** Scheduled editorial lanes must prove fresh
agent-authored output. If the agent path writes nothing or produces
sub-floor content, the workflow goes red. The daily digest is the deliberate
exception: it may publish a clearly labelled deterministic fallback rather
than leave the front page blank.
- **Output contracts.** Agent lanes must *prove* their work:
[`require-output`](.github/actions/require-output) asserts the expected
artifacts changed, and [`require-diff-scope`](.github/actions/require-diff-scope)
asserts nothing outside the declared paths was committed.
- **Sandboxed agents.** Native Claude lanes use a fail-closed bubblewrap policy
([`.claude/settings.json`](.claude/settings.json)). OpenCode and Cursor lanes
run as non-root users in locked-down containers and import only validated
output from disposable clones.
- **Provider routing.** One SSOT maps lanes across OpenCode, Cursor, Fireworks,
Z.ai, Anthropic, and Codex, including strict routes and ordered fallbacks โ
and CI fails if the generated docs or workflow mirrors drift from it.
- **Watchdogs that outlive the fleet.** Freshness checks run on both runner
tiers so an outage on either still alerts; a loop-safe auto-rerunner
recovers jobs whose runner vanished mid-run.
- **CRUD, not regenerate.** The model timeline and wiki are persistent stores
with immutable slugs and append-only history, schema-validated on every PR
that changes them โ knowledge compounds instead of being rewritten nightly.
- **Self-improvement with review.** The weekly improve lane reads the
pipeline's own output and may open a scoped methodology PR; it makes no
change when the evidence does not justify one, and a human decides whether
to merge proposals.
## What you can run vs. what needs accounts
This repo is one person's live pipeline, published as-is. Much of it is
reproducible; some of it points at the maintainer's private infrastructure and
is included for transparency rather than turnkey reuse.
**Runs with no accounts:**
- The **dashboard** โ builds and serves from the sample data committed under
`research/` (see [Quickstart](#quickstart-no-accounts-needed)).
- The **Python tooling + tests** โ stdlib-first, `uv`-managed; validators and
unit tests need no service accounts after dependencies are installed.
**Needs your own credentials and compatible runners/services:**
- **Claude / Codex / OpenCode / Cursor / Fireworks / Z.ai backends** โ set
`CLAUDE_CODE_OAUTH_TOKEN`, `CODEX_AUTH_JSON`, `OPENCODE_API_KEY`,
`CURSOR_API_KEY`, `FIREWORKS_API_KEY`, or `ZAI_API_KEY` for the
synthesis/generative lanes you want to run on your fork. The Codex lane
uses ChatGPT-managed auth, not OpenAI API billing; the OpenCode lane
authenticates the opencode CLI with a plain env-var key against the
OpenCode Go subscription; the Cursor lane authenticates the official
`agent` CLI with `CURSOR_API_KEY`.
- **Twitter/X lanes** โ supply either `BIRDY_ACCOUNTS` or both
`BIRD_AUTH_TOKEN` / `BIRD_CT0` cookies. Auth setup fails fast if neither
route is complete; after setup, individual fetch errors degrade to empty
data so one expired account does not crash the whole aggregation pass.
- **Exa / Perplexity** search enrichment and **Gemini** TTS are optional.
**Maintainer-specific (swap or disable to self-host):**
- **Runners:** nearly every workflow targets the maintainer's private
self-hosted Linux runner (`runs-on: [self-hosted, Linux]`); on a fork those
jobs queue until you register your own runner (or change `runs-on`). The old
Cloud Run fleet is paused rollback infrastructure, not the production path.
- **Services:** `hooker.guzus.xyz` (telemetry โ no-ops if `HOOKER_URL` is
unset), `tuber-api.guzus.xyz` (YouTube signal โ no public equivalent), and
`s3.guzus.xyz` (audio hosting). Override the non-secret endpoints via the env
vars in [`.env.example`](.env.example) (`AUDIO_BASE_URL`,
`POSTBUILD_SITE_ORIGIN`, `DEPLOY_HEALTH_URL`, โฆ).
- **Deploy:** production is a Railway service watching `main`, and
`ara.guzus.xyz` is the maintainer's domain. The static dashboard shell also
embeds a Google Analytics tag in `dashboard/index.html` โ remove it on a fork.
- **Sibling repos** `../oracle` and `../runner` referenced in the docs are
private and not required for the no-account Quickstart or hosted-provider
workflows.
### Secrets
All credentials are injected via GitHub Actions secrets (or a local `.env`,
which is gitignored) โ see [`.env.example`](.env.example) for the common local
settings and service overrides. None are needed for the
[Quickstart](#quickstart-no-accounts-needed).
The optional [Chubby direct-chat setup](docs/chubby-direct-chat.md) uses a
project-scoped key in a server-side secret store. Its configuration is separate
from the [Claude Code Messages canary](docs/chubby.md); neither changes scheduled
workflow routing.
| Secret | Required for | Description |
|--------|--------------|-------------|
| `CLAUDE_CODE_OAUTH_TOKEN` | native-Claude lanes, fallback path, the isolated Claude Code routes | Claude Code auth. The isolated container adapter remains a standby after the 2026-11-05 Cursor recovery; host-checkout agent-run stays incompatible with the editorial dispatcher |
| `FIREWORKS_API_KEY` | Fireworks generative and comparison routes | Anthropic-compatible Fireworks endpoint for explicit model routes and comparison lanes |
| `ZAI_API_KEY` | Z.ai GLM 5.3 lanes and fallback chain | Z.ai Coding Plan key; current second provider in the global fallback chain and used by Z.ai canaries/comparison lanes |
| `CODEX_AUTH_JSON` | `generative-research backend=codex` | file-backed ChatGPT Codex auth from `codex login`; treat like a password |
| `OPENCODE_API_KEY` | OpenCode profiles, direct comparison/canary paths, dispatcher route plumbing | OpenCode Go key. Its 2026-11-05 harness canary failed before the GLM probe, so no production route uses it; RSS, community, and Bluesky return to its strict `glm-5.3-flash` route once the OpenCode canary passes. The OpenCode canary validates both direct DeepSeek and the dynamically resolved primary editorial route. |
| `CURSOR_API_KEY` | Cursor CLI profiles, direct comparison/canary paths, dispatcher route plumbing | Cursor dashboard API key. Prewired so an SSOT-only switch to `cursor-grok-4p6-fast` needs no workflow edit. Canary `41962718497` passed on 2026-11-05; it again serves every strict isolated route. |
| `BIRD_AUTH_TOKEN` / `BIRD_CT0` | Twitter/X lanes | X cookies (read-only use; expire often) |
| `BIRDY_ACCOUNTS` | alternative to cookie pair | multi-account rotation JSON; every account forced read-only |
| `GEMINI_API_KEY` | digest/article audio | price-performant TTS |
| `EXA_API_KEY` / `PERPLEXITY_API_KEY` | optional | neural + cited web search via MCP |
| `TELEGRAM_BOT_TOKEN` / `TELEGRAM_CHAT_ID` | blog alerts, digests, liveness escalation | delivery channel |
<details>
<summary>Output directory layout</summary>
```
research/
โโโ arm/ # dashboard-facing agent timeline
โโโ arxiv/ # daily papers
โโโ audio/ # zero-byte date stubs; generated audio lives on S3
โโโ blogs/ # expert-blog digests
โโโ bluesky/ # supplemental commentary
โโโ community/ # HN + Reddit digests
โโโ claims/ # cross-article verified-claim index
โโโ digest/ # the daily synthesis (+ audio stubs; mp3s on S3)
โโโ earnings/ # AI-issuer earnings events from SEC EDGAR (per event, not per day)
โโโ front-page/ # newspaper PNG + interactive edition
โโโ generative/ # long-form articles, translations, claim ledgers, and index
โโโ issues/ # on-demand issue research
โโโ market/ # deterministic GPU and model-price datasets
โโโ models/tickets/ # persistent model-release tickets
โโโ rss/ # raw-signal digests
โโโ summaries/ # Telegram digests + alert/subscription ledgers
โโโ twitter/ # 3-hourly reports
โโโ wiki/ # the compounding knowledge base
โโโ wiki-translations/ko/ # validated Korean wiki mirrors
โโโ youtube/ # tuber signal lane
```
</details>
## Repository map
| Path | What it is |
|---|---|
| [`CLAUDE.md`](CLAUDE.md) | The operator's manual โ load-bearing rules, lane contracts, failure modes |
| [`ARA_DSL.md`](ARA_DSL.md) + [`ARA_CATALOG.json`](ARA_CATALOG.json) + [`COMPONENTS.md`](COMPONENTS.md) | The article component language: source format, machine catalog, human reference โ kept in lockstep by CI |
| [`data/agent-backends.json`](data/agent-backends.json) | Single source of truth for model routing + fallback chains |
| [`scripts/`](scripts/) | 109 Python modules: 65 implementation tools and 44 test modules, plus the JavaScript front-page renderer |
| [`docs/`](docs/) | Contracts and deep dives: [backend matrix](docs/backend-matrix.md), [model tickets](docs/model-tickets.md), [wiki schema](docs/wiki-schema.md), [headline dedup](docs/headline-dedupe.md), [AI industry map](docs/ai-industry-map.md), [OKF export](docs/okf.md) |
| [`dashboard/`](dashboard/) | Vite + Bun + TypeScript SPA behind ara.guzus.xyz |
| [`prompts/`](prompts/) | Agent prompts for the scheduled lanes |
## License
The **source code** in this repository (scripts, workflows, the dashboard, and
documentation) is released under the [MIT License](LICENSE).
The **contents of `research/`** are a different matter: they are automated
excerpts, summaries, and reproductions of third-party material (news articles
and posts from X/Twitter, Hacker News, Reddit, Bluesky, arXiv, and similar
sources) produced as the pipeline's output. They are **not** relicensed by the
MIT grant and remain the property of their original authors. If you reuse
anything under `research/`, you are responsible for complying with the original
sources' terms โ including the X/Twitter Terms of Service and each publisher's
copyright.
Contributing: [`.github/CONTRIBUTING.md`](.github/CONTRIBUTING.md) ยท
Security: [`.github/SECURITY.md`](.github/SECURITY.md)