Skip to content

v0.1.0 — first public release

Choose a tag to compare

@Ref34t Ref34t released this 20 May 16:11
· 156 commits to main since this release
3669fd1

First public release of Agent Ready — an open-source WordPress plugin that turns a site into a first-class citizen of the AI-agent web. A single Context Profile (configured once under Tools → Context) drives every agent-facing surface: what's exposed, how it's served, and how it's scored.

Modules

Four coherent modules ship in v0.1, all driven by one profile:

  • Markdown Views — deterministic HTML → Markdown rendering for any public URL, with three URL forms (.md path, ?format=md query, Accept: text/markdown content negotiation) and uniform 404 on denial. Per-post cache with content-hash invalidation, Gutenberg sidebar preview, WP-CLI command (wp agentready md preview), REST endpoint for admin tooling. Optional LLM cleanup pass with safety guard.
  • LLMs Index — /llms.txt generator publishing a discovery surface for AI agents. Conflict detection against robots.txt. Editorial-entries admin UI for site owners to add curated non-WordPress URLs. Optional LLM-powered pass drafts per-entry descriptions from post content. WP-CLI: wp agentready llms-txt {status,regen,preview}.
  • Context Score — 0–100 readiness audit across six weighted sub-scores (discoverability 20, content readability 15, schema coverage 10, exposure safety 15, integration health 15, Markdown conversion quality 25). Admin page under Tools → Context Score, Site Health integration, REST endpoint, WP-CLI wp agentready context-score recompute. LLM-generated narrative with rule-based fallback.
  • Schema Coordination — detects whether your SEO plugin (Yoast, Rank Math, AIOSEO, The SEO Framework) already emits JSON-LD. When one is active, Agent Ready emits nothing competing. When none is active, optionally emits a native WebSite + Organization + per-content schema set (toggle in the Context Profile; default off) so the schema sub-score is achievable without a third-party plugin.

Privacy and storage

  • No content leaves your server. Zero external HTTP calls in the deterministic surfaces.
  • Optional LLM features (Markdown cleanup, /llms.txt descriptions, Context Score narrative) consult the WP AI Client only when explicitly toggled on.
  • Two custom tables: {prefix}agentready_md_cache (one row per published post served as Markdown) and {prefix}agentready_score_audit_log (one row per audit run, retained for trend analysis). Both dropped on uninstall.

Requirements

  • WordPress 6.9+
  • PHP 7.4+
  • WP AI Client (optional — required only by the LLM-using modules; deterministic features run fully locally without it)

Installation

Once approved on wp.org: search for "Agent Ready" in Plugins → Add New, or install via WP-CLI: wp plugin install agentready --activate.

Before wp.org approval: download the ZIP attached to this release and install via Plugins → Add New → Upload Plugin.

Acknowledgements

  • Layered CI (PHPCS WordPress + WordPressVIPMinimum, Plugin Check Tool, PHPStan level 5, PHPUnit unit × 2 PHP versions, PHPUnit integration × 4 cells) catches regressions before they ship.
  • Built on the WordPress AI Client surface to keep AI provider integration WordPress-native rather than reinventing it.

Full changelog

Cumulative commit list since the initial scaffold:

Markdown Views (#5, #6, #51, #52, #53)

  • feat(#5): Markdown Views deterministic floor (Phases 1-4) — #36
  • feat(#5): Markdown Views admin surfaces + docs (Phases 5-9) — #40
  • feat(#6): Markdown Views LLM cleanup engine + safety guard (Phase A) — #46
  • feat(#6): wire Client_Wrapper to wp_ai_client_prompt — #49
  • feat(#6): Markdown Views cleanup admin UI + approval flow (Phase B) — #50
  • fix(#52): re-run dbDelta on admin_init when schema lags — #54
  • feat(#53): stuck-pending UX hint after 60s waiting on WP cron — #55
  • fix(#37,#38): MD-escape link brackets / parens; fence inline code by max backtick run — #77

LLMs Index (#7, #8, #66)

  • feat(#7): LLMs Index Phase A — /llms.txt generator floor — #56
  • feat(#7): LLMs Index Phase B — conflict detection + admin notice — #60
  • feat(#7): LLMs Index Phase C — editorial entries admin UI — #65
  • fix(#66): classify 4xx WP_Error returns as Permanent_Error — #67
  • feat(#8): LLM-powered /llms.txt entry descriptions — Phase A engine + WP-CLI — #68
  • feat(#8): LLM-powered /llms.txt entry descriptions — Phase B admin UI — #69

Context Score (#9, #10, #11)

  • feat(#9): Context Score engine — 0–100 score + 6 sub-scores + wp context audit — #71
  • feat(#10): build Context Score admin UI — Tools page, REST, Site Health — #72
  • feat(#11): build Context Score LLM narrative with rule-based fallback — #74

Schema Coordination (#12, #73)

  • feat(#12): build gap-fill JSON-LD emitter with SEO plugin deference — #75
  • feat(#73): gate native JSON-LD emission behind a Profile toggle; credit it in Context Score — #76

Infrastructure + release prep

  • chore(#3): build layered CI matrix (PHPCS + Plugin Check + PHPUnit) — #17
  • chore(#18): rename plugin to AgentReady (drop "wp" for wp.org policy) — #19
  • chore(#13): add PHPStan level 5 static analysis — #26
  • feat(#4): add Context Profile admin screen — #27
  • chore(#29): clear WP Plugin Check warnings (Domain Path + load_plugin_textdomain) — #32
  • chore(#80): build wp.org distribution ZIP — tools/build-zip.sh + .distignore + CI verification — #83
  • chore(#78): wp.org submission readiness — correct headers, readme rewrite, "Agent Ready" rename — #81
  • chore(#79): build wp.org placeholder assets — banner, icon, screenshots — #82
  • chore(#84): exclude webpack.config.js from wp.org distribution ZIP — #85
  • chore(#86): fix wp.org attribution — Mohamed Khaled as Author + Contributor — #87

What's next (v0.1.1 fast-follow)

  • AI Assistant Preview pane — render a page as ChatGPT / Claude consume it (#45)
  • ai.txt and /.well-known/ discovery surface detection (#22)
  • MCP / WordPress Abilities API integration (#21)
  • Native Schema_Emitter expansion so schema coverage is fully achievable without any SEO plugin (#73 follow-up)
  • LLMs Index test hardening (#57–#64)