v0.3.1

Full Changelog: v0.3.0...v0.3.1

v0.3.0

Oratos v0.3.0

Released: 2026-06-10

One crate, stronger CI, and cross-platform fixes. The workspace is consolidated into a single oratos package (library + CLI), with expanded GitHub Actions workflows and Windows path handling for site-root audit rules.

Highlights

• Single crate — cargo install oratos ships the CLI and library modules (oratos::core, oratos::html, oratos::audit, oratos::report, oratos::generate)
• CI/CD — separate workflows for CI, code quality, dependencies, release, and test setup (90% coverage gate, cargo deny, cross-platform tests)
• docs.rs — full README rendered as crate documentation
• Windows — site-root rules (structured.missing-organization, etc.) work with backslash paths
• Dependencies — scraper 0.27 (removes unmaintained fxhash from the tree)

Install

cargo install oratos

GitHub Releases — prebuilt binaries for Linux x86_64, macOS Apple Silicon, and Windows x86_64:

Platform	Asset
Linux x86_64	oratos-v0.3.0-linux-x86_64.tar.gz
macOS Apple Silicon	oratos-v0.3.0-macos-aarch64.tar.gz
Windows x86_64	oratos-v0.3.0-windows-x86_64.zip

Upgrade from v0.2.0

Breaking: library crates merged

If you depended on separate crates, switch to one dependency:

# Before (v0.2)
oratos-core = "0.2"
oratos-audit = "0.2"

# After (v0.3)
oratos = "0.3"

use oratos::{audit_pages, load_pages, AuditReport, OratosConfig};
// or module paths: oratos::core::Finding, oratos::html::HtmlPage, etc.

The CLI is unchanged — same oratos audit, oratos generate, and oratos prompt commands.

Report version

JSON/console/markdown reports now report core_version 0.3.0.

Local install path

cargo install --path crates/oratos

CI for downstream projects

No changes required if you install the oratos binary. See docs/ci.md for quality gates and SARIF upload examples.

Documentation

• Architecture (updated single-crate layout)
• CI/CD (workflow reference)
• Publishing (single-crate publish + tag release)

Full changelog

See CHANGELOG.md.

v0.2.0 - Configurability and site-aware auditing

Oratos v0.2.0

Released: 2026-06-08

Configurability and site-aware auditing: project config file, rule ignores, git changed-only mode, and optional HTTP crawl with robots/sitemap support.

Highlights

• oratos.toml — [audit] and [crawl] sections; auto-discovered from site root
• Rule ignores — ignore_rules = ["seo.missing-twitter-card"] suppresses findings
• --changed-only — audit only HTML files changed in git diff HEAD
• --crawl — same-origin multi-page fetch for URL targets (with robots.txt + sitemap.xml)
• oratos prompt phoenix — remediation prompts for Phoenix priv/static exports
• New rules — structured.missing-article, structured.missing-organization

Install

cargo install oratos

Upgrade from v0.1.0

• Report core_version is now 0.2.0 (JSON/console/markdown headers).
• URL audits still fetch one page by default; enable crawl with --crawl or [crawl] enabled = true.
• Copy examples/oratos.toml.example to your site root as oratos.toml if you want file-based defaults.

New CLI flags

oratos audit <target> [--config PATH] [--crawl] [--changed-only] ...
oratos prompt phoenix <file-or-url> [--output PATH]

Documentation

• Configuration
• Roadmap
• Rule catalog (updated rule IDs)
• ADRs 0002–0006 in docs/decisions/

Full changelog

See CHANGELOG.md.

Oratos v0.1.0

Oratos v0.1.0

First public release of Oratos - website visibility intelligence for SEO, accessibility, structured metadata, and AI readiness. Audit static HTML, local exports, or live URLs from the CLI and wire it into CI like Lighthouse CI or Credo.

Highlights

• oratos audit - crawl a directory, single HTML file, or URL; score pages and emit findings with stable rule_ids
• Five report formats - console, JSON, Markdown, HTML, SARIF
• oratos generate - draft llms.txt and metadata / JSON-LD recommendations
• oratos prompt html - LLM remediation prompts that preserve visible content
• CI-friendly - --fail-under, --strict, --output for quality gates and artifacts

Install

From source (today):

cargo install oratos

Or from source:

git clone https://github.com/latentmeta/oratos
cd oratos
cargo install --path crates/oratos-cli

Prebuilt binaries (when the release workflow completes):

Platform	Asset
Linux x86_64	oratos-v0.1.0-linux-x86_64.tar.gz
macOS Apple Silicon	oratos-v0.1.0-macos-aarch64.tar.gz
Windows x86_64	oratos-v0.1.0-windows-x86_64.tar.gz

Extract and run oratos (or oratos.exe on Windows).

Quick start

oratos audit examples/static_site
oratos audit examples/static_site --format json --output report.json
oratos audit ./priv/static --fail-under 85 --strict
oratos generate llms examples/static_site
oratos prompt html examples/static_site/index.html

What it checks

Category	Examples
SEO	Title, meta description, canonical, headings, Open Graph, Twitter cards, broken internal links
Accessibility	lang, alt text, landmarks, form labels, link text, heading hierarchy
Structured data	JSON-LD presence/validity, WebPage, BreadcrumbList, ImageObject hints
LLM readiness	llms.txt (site-level), extractable text, summaries, image descriptions

Scoring is 0–100 per category with weighted overall score (SEO 30%, A11y 25%, Structured Data 25%, LLM 20%). See docs/scoring.md.

CLI surface

oratos audit <target> [--format console|json|markdown|html|sarif] [--output PATH] [--fail-under SCORE] [--strict]
oratos generate llms <target> [--output PATH]
oratos generate metadata <target> [--output PATH]
oratos prompt html <file-or-url> [--output PATH]

Workspace crates

• oratos-core - models, scoring, findings
• oratos-html - load and parse HTML
• oratos-audit - rule engine (~30 rules; full catalog)
• oratos-generate - llms.txt, metadata, prompts
• oratos-report - formatters
• oratos - CLI package (oratos binary; sources in crates/oratos-cli)

Documentation

• Architecture
• Reports & JSON schema
• CI/CD
• Phoenix / Mix
• Tutorials (outlines in v0.1.0)

Notable fixes in this release

• UTF-8-safe text truncation in generators
• Correct scoring for performance-hint findings (e.g. image dimensions)
• Site-level llm.missing-llms-txt (once per site, not per page)
• SARIF: deduplicated driver rules, omit empty locations
• Internal link resolution for relative and root-relative paths

Known limitations (v0.1.0)

• Install via cargo install oratos or release binaries; see docs/publishing.md for crate layout
• URL audits fetch a single page (no multi-page crawl over HTTP)
• Tutorials are outlines; rule silencing/config is not yet exposed in CLI
• macOS release builds target Apple Silicon (aarch64); Intel Mac users should build from source

Full changelog

See CHANGELOG.md.

---

License: MIT