Changelog Highlights
See full source changelog in repository root: CHANGELOG.md.
0.29.1 (2026-03-30)
- Fixed the
m260317_160000_add_target_sets_tablesupgrade path for drifted installs whereagents_credentialsis missing even though older credential migrations are already marked as applied. - Fixed migration retry behavior so partially created
agents_credential_target_setstables get their missing foreign keys restored on the next run.
0.29.0 (2026-03-23)
- Added bounded read boundaries and explicit run reporting for managed Jobs, including job-scoped selectors and
jobs:read/jobs:reportruntime support. - Renamed the operator-facing workflow model to
Jobs, kept governed-writeBoundariesseparate, and tightened account/job fit signals around broader-than-needed access. - Reworked account capability selection and Create Job setup around safer defaults, shared capability pills, prompt-first job authoring, and filtered account-card matching.
0.28.1 (2026-03-22)
- Polished the
AccountsandWorkflowsregistries around calmer shared table treatment, leading type icons, cleaner account references, and removal of the legacy Accounts lifecycle panel. - Tightened the account-template presentation so read-only installs no longer show redundant write-only access columns when governed writing is off.
- Fixed workflow handoff bundle generation so the exported README and worker scripts no longer fail on undefined interpolated variables during download.
0.28.0 (2026-03-22)
- Added the first operator-managed
WorkflowsCP surface with registry/detail views, template-based workflow creation, managed-account matching guidance, and handoff bundle export. - Added workflow storage/service support, dedicated migrations, and workflow regression coverage for the new read-only workflow slice.
- Clarified across the docs and CP that Agents stores workflow intent and visibility, while the actual work still runs in external workers.
0.27.2 (2026-03-22)
- Added a first-run onboarding start flow at
agents/startwith guidedwelcome,create, andreadystates for setting up the first managed account. - Added persisted onboarding state tracking plus dedicated migration/service support so the control panel can track onboarding progress, preview stages, dismissal, and completion.
- Added onboarding regression coverage and expanded the onboarding docs/assets around the new start experience.
0.27.1 (2026-03-21)
- Moved the manual governed draft-request tool out of
Approvalsand intoStatusas a setup/fallback utility, and removed the separate Settings toggle so it now follows governed-writing availability. - Refined the
Statusverdict and card surfaces around linked operator guides, quieter text-link action rows, and less button-heavy secondary detail actions. - Tightened the surrounding CP handoff copy so
AccountsandStatuspoint operators at the manual request test only when that flow is actually available to them.
0.27.0 (2026-03-21)
- Added the first
F19workflow-starter slice with a publicGoverned Content Refreshguide and companion worker scaffold. - Added manual governed
entry.updateDraftapproval requests directly inApprovalsand refreshed the surrounding operator wording/date treatment. - Polished
Accounts,Approvals, andTarget Setsaround calmer table cells, clearer worker helpers, and more consistent Craft-native link/date behavior.
0.26.0 (2026-03-20)
- Added the
F12external adapter foundation: provider registry, registration event, dynamic external-resource routes, and external scope exposure through capabilities, OpenAPI, and schema. - Added grouped
External plugin scopesinAccountsso operators can assign adapter-backed read scopes by provider and resource. - Added a minimal standalone
Retourreference adapter package, public adapter docs, and an opt-in real-install QA harness.
0.25.5 (2026-03-20)
- Reworked the
Accountstemplate shelf around agency-first workflow profiles and a tighter default set of reusable service patterns. - Added
SEO & Metadata Auditor,Commerce Catalog QA,Accessibility Review, andLaunch QA, and moved narrower templates into a secondaryMore templatessection. - Hid governed-write and Commerce-only templates when those capabilities are unavailable, and removed the old
Site Structure Reviewshelf entry.
0.25.4 (2026-03-20)
- Added configurable approval timing fields to
Rulesfor due, escalation, and expiry minutes. - Reworked the
Approvalstables to use clearer operator wording, less raw implementation detail, linked CP-user approvers inApplied / Completed, and dual-control progress in pending rule cells. - Surfaced past-due approval requests in the
Statusapprovals card and tightened pending approval actions around compact symbol buttons.
0.25.3 (2026-03-20)
- Fixed
Webhook ProbeandWebhook Test Sinkpayload dialogs so JSON renders correctly instead of showing HTML entities. - Clarified the
Accountsstatus card summary with active, paused, and revoked totals on the first line. - Softened unbounded write-capable accounts from a constant
Needs attentionfault to a visibleReviewposture when no other account issues exist.
0.25.2 (2026-03-20)
- Reworked
Statusinto a compact dashboard with a large verdict card, focused operator cards, and modal-hosted detail/probe/sink surfaces. - Limited deep links to problematic Status rows, hid write-related cards when governed writes are off, and replaced empty green-state verdict chrome with operator tips.
- Switched the
Accountscard registry to a four-column desktop grid and removed plugin-level table-header bottom borders for a calmer CP rhythm.
0.25.1 (2026-03-18)
- Simplified Accounts cards by removing visible scope chips and the bottom action row.
- Moved the add/edit form to an on-demand top-right flow and added visible
.envpreviews plusCopy .envin account details.
0.25.0 (2026-03-18)
- Added governed write
Target Setswith reusable allowed entry/site bounds for write-capable managed accounts. - Added a dedicated
Agents -> Target SetsCP page and kept runnable worker setup account-scoped instead of target-set-scoped. - Enforced target-set boundaries at both approval-request time and execution time, and aligned the public CP shell around cleaner section boundaries and bounded-write summaries.
0.24.0 (2026-03-17)
- Added a production-safe
Webhook Probecard inStatusfor synthetic signed deliveries against the live receiver. - Added a small webhook probe ledger with recent runs, payload inspection, triggered-by metadata, and cooldown visibility.
- Reused the shared signing/delivery path and clarified the distinction between the live probe and the dev-only
Webhook Test Sink.
0.23.0 (2026-03-17)
- Added a Craft-style Accounts registry table with a
Table | Cardsswitch, proper table semantics, and a shared details modal for managed-account actions. - Added an
After / Beforetoggle inside Focus mode and simplified approval review down toStructuredplusFocus. - Published a public
Agents vs Element APIpage to explain when Agents is a better fit than bespoke Element API endpoints.
0.22.3 (2026-03-16)
- Added a third
Focusdiff tab for governed approval review with muted context and emphasized changed text for proofing-oriented reading. - Refined the diff modal chrome around the new Focus view with lighter header/tab surfaces, cleaner active-tab behavior, and monospaced proofing typography.
0.22.2 (2026-03-16)
- Restored inline async
Rotatebehavior inAccountsso token rotation no longer drops back to a full postback. - Brightened the one-time token overlay actions and switched them to the smaller Craft button treatment for clearer contrast against the dark overlay.
0.22.1 (2026-03-15)
- Fixed completed approval diffs for governed
entry.updateDraftrequests soApplied / Completedcan compare the applied revision against the previous revision even after the active draft is gone. - Added a stale-status reset action and aligned the top
Statusverdict with the same final summary logic shown in the proof cards. - Refined Accounts, Approvals, and Status card framing so more of the control-plane surface now uses shared muted strip headers and Craft-native action treatments.
0.22.0 (2026-03-15)
- Added a dedicated
Diffaction next toReviewfor governedentry.updateDraftapprovals. - Added a changed-only
Structureddiff view plus aRedlinetab for text-focused approval review with surrounding context. - Bound approval diffs to the exact saved draft when one is linked and clarified canonical-request fallback when no readable saved draft is available yet.
- Refined the
Approvalstables and diff modal framing so the review surface feels more native in the Craft CP.
0.21.12 (2026-03-15)
- Published a public operator-facing
Scope Guidewith plain-language explanations of what each scope unlocks, when a worker would need it, and when it usually should not be assigned. - Published a governed
entry.updateDraftworker example plus matching workflow docs so operators and developers can test the full approval-driven draft-write path end to end. - Added an
Entry Translation Draftsaccount template and workflow guide for bounded localization-draft workflows that stay inside approvals. - Made
Accountsthe canonical Agents landing page, updated the Settings -> Plugins entry to openAgents -> Settingsinside the Agents CP, and added direct header links to the first-worker guide and scope guide.
0.21.11 (2026-03-15)
- Bound approved governed entry-draft requests to the exact saved draft created by execution so later review/apply surfaces no longer have to reconstruct draft identity from loose payload fragments.
- Blocked governed draft creation when a canonical entry already has a saved draft and surfaced the resulting conflict details directly in
Approvals, including the conflicting draft ids and draft links for operator follow-up.
0.21.10 (2026-03-14)
- Published the
First Workerguide and bootstrap example so operators and developers now have a stable public path from account creation to a working scheduled worker. - Reworked the Accounts bootstrap flow around a lighter direct edit trigger, one-time worker
.envexport, asyncTest Account/Rotate/Revokeactions, and clearer in-product guidance for first-worker setup. - Added
F19workflow starter kits and companion workers to the roadmap, and refreshed the public marketing banner asset.
0.21.9 (2026-03-14)
- Reworked
Settingsaround native Craft CP tabs with one shared top-rightSave Settingsaction instead of per-panel save actions and custom tab chrome. - Refined the
Statussurface with explicit card ordering, calmer detail toggles, and consistent human-readable timestamps across operator-facing tables and summaries. - Enriched
Operator Notificationsrecent-delivery rows so recipients resolve to clickable CP user names plus delivery channels when possible. - Polished
Approvalsjourney cards by muting empty stages, hiding empty-state chevrons, and keeping the staged control view aligned with the rest of the CP.
0.21.8 (2026-03-14)
- Reworked
Approvalsinto a max-width journey of card-based stages with centered divider dots, embedded rules management, and toggleable sections that align with the rest of the CP. - Added inline
Edit/Deleteactions for approval rules and replaced the stale free-text action-pattern example with a human-readable governed-action selector. - Stacked pending decision buttons vertically with consistent widths for clearer high-risk approval actions.
0.21.7 (2026-03-13)
- Hid Commerce-only scopes from runtime defaults, capabilities, and the Accounts scope picker when Craft Commerce is not installed.
- Reworked the Accounts scope picker into a responsive multi-column layout with group guidance so operators can evaluate access decisions more easily on wider viewports.
0.21.6 (2026-03-13)
- Treated Commerce availability as optional in readiness diagnostics so CMS-only installs no longer surface a degraded
Statusstate after update.
0.21.5 (2026-03-13)
- Removed the remaining bootstrap-only missing-account warning from the
Statusdegradation path so healthy fresh installs no longer renderDegradedafter update. - Applied the muted notice background treatment to the
Statussummary strip while keeping the summary items themselves transparent.
0.21.4 (2026-03-13)
- Softened the fresh-install
Statusposture so healthy environments without any accounts now read asReadyinstead ofBlocked. - Reframed the main
Statussurface around operator-facing account language instead of internal credential terminology for the core readiness and action-mapping flow. - Hid the
Operator Notificationscard fromStatuswhen operator notifications are disabled. - Updated the internal roadmap with explicit pre-1.0 milestones for full multi-site/multi-store support and Craft Cloud compatibility.
0.21.3 (2026-03-13)
- Added an account-scoped API token reveal overlay for create/rotate flows so copy/download actions stay anchored to the affected account card.
- Added finer Accounts pulse-simulation controls for local demo and QA flows.
0.21.2 (2026-03-13)
- Softened the
Statusreadiness verdict for healthy low-traffic environments so they stayReadywhile confidence is still building, instead of defaulting toUnproven. - Reframed
Traffic / AccessandConfidence / Observabilitymessaging to keep quiet-but-healthy installs calm and positive without hiding real monitoring gaps.
0.21.1 (2026-03-13)
- Added a persisted short description field for managed accounts so account cards and the add/edit form can carry a concise operator-facing purpose note.
- Added a dedicated compact
Account Templatessection with broader starter profiles, including aLegal & Consent Checkertemplate for core site/compliance review. - Reordered the Agents CP IA to
Status,Accounts,Approvals, andSettings. - Grouped account scopes by type and reworked dual-control approvals to show two explicit approval buttons with consumed-slot disable states.
- Removed the temporary waiting-table rejection/note inputs and dropped legacy case-specific account templates.
0.21.0 (2026-03-13)
- Added queue-backed operator email notifications for approval requests, approval decisions, execution issues, webhook delivery failures, and scheduled system-status checks.
- Added per-account
Approval recipientsrouting so governed-write alerts can target selected CP users instead of only a global recipient list. - Switched managed account ownership to a native Craft user relation with safe legacy-owner fallback for existing installs.
- Added explicit last-handoff details to the
Operator NotificationsStatus card so operators can verify recent SMTP delivery attempts in the CP.
0.20.0 (2026-03-12)
- Added a dev-only
Webhook Test Sinkwith local capture history, signature verification, CP inspection, and a one-clickSend test webhookflow for local webhook validation. - Added env-aware webhook URL and secret fields in Settings so the runtime transport can be configured from the CP with normal Craft env-var handling.
- Realigned the CP IA and canonical routes around
Status,Approvals,Accounts, andSettings, using/status,/approvals, and/accountsas the visible paths. - Improved first-run Status posture with
Ready to Connect, optional sync-state until configured, and a dedicated diagnostics bundle card. - Removed Discovery Docs from the core plugin surface, routes, generated files, diagnostics bundle, and public docs.
0.10.9 (2026-03-11)
- Reworked the top-level CP IA to
Status,Approvals,Accounts,Discovery Docs, andSettings, removing local sidebars from the primary operator surfaces. - Added a
Ready to Connectbootstrap verdict for fresh installs so healthy but inactive environments no longer default toUnproven. - Renamed the CP-facing
Controlsurface toApprovalswhile keeping governed-write routes and redirects compatible. - Reframed account webhook subscriptions as event-interest routing and added a
Monthly Report Agentstarter template.
0.10.8 (2026-03-11)
- Merged dashboard security posture fully into
Readiness, with one combined state card, one action-mapping table, and a shared proof-card grid. - Added proof-card detail dialogs for
Traffic / Access,Delivery / Webhooks,Integration / Capacity,Credentials / Policy, andConfidence / Observability. - Removed the standalone
Securitydashboard tab while keeping legacy route compatibility through readiness redirects and preserved anchors. - Removed the readiness-page security technical JSON section in favor of the merged proof-card/detail-dialog model.
0.10.7 (2026-03-11)
- Reworked Dashboard
Readinessinto a state-card-driven operator surface with integrated action mapping. - Reworked Dashboard
Securityto match the same operator model while keeping dead-letter queue replay actions below the summary card. - Added account-card focus deep links so remediation links can jump operators into the relevant Accounts context.
- Fixed the Security dashboard dead-letter queue summary so an empty queue no longer causes a Twig render error.
0.10.6 (2026-03-09)
- Refined Control CP tables to use a more consistent Waiting for Decision-derived header and body treatment across approvals, follow-up, activity, and rules views.
- Added collapsed-by-default disclosure toggles for Approved, Applied / Completed, Runs That Need Follow-up, Activity Log, and inline Proposed changes details.
- Tightened Control CP spacing and card-strip behavior for a more consistent Craft-native operator experience across desktop and mobile.
0.10.5 (2026-03-09)
- Hardened machine-write auth: query-token transport stays read-only, while write routes now require header auth and
Content-Type: application/json. - Bound sync-state checkpoint writes to the authenticated credential id to prevent cross-credential checkpoint overwrites.
- Persisted explicit approval assurance modes and downgrade reasons, and now surface them in Control CP/audit messaging.
- Managed credential generation now fails closed if secure entropy is unavailable.
0.10.4 (2026-03-09)
- Added guarded incident snapshot endpoint:
GET /agents/v1/incidentswithincidents:readscope. - Added
severity/limitfiltering and strict-redacted incident payloads derived from runtime reliability signals. - Updated scope/docs/release parity for incidents across README, runbooks, and QA checks.
0.10.2 (2026-03-08)
- Unified Control CP and governed write APIs behind one gate:
PLUGIN_AGENTS_WRITES_EXPERIMENTAL.
0.10.1 (2026-03-08)
- Renamed governed draft-write scope to
entries:write:draftand keptentries:writeas a deprecated compatibility alias. - Simplified governed approval flow: final approval executes immediately, with clearer approved/apply/completed states in Control CP.
- Dual-approval now degrades to single approval when only one active CP user exists.
0.10.0 (2026-03-07)
- Added governed write action support for
entry.updateDraftviaPOST /agents/v1/control/actions/executewith schema/OpenAPI payload metadata. - Added experimental
entries:writescope (gated byPLUGIN_AGENTS_WRITES_EXPERIMENTAL=true) and per-account write indicators in CP cards. - Added per-account human-approval control for write-capable accounts and fixed its CP persistence/edit hydration behavior.
- Removed legacy refund/return experimental aliases; governed write surfaces now use writes-specific experimental flags only.
0.9.3 (2026-03-07)
- Migrated sync-state naming across docs/contracts/QA from legacy
/consumers/*wording to canonical/sync-state/*. - Refined CP dashboard/accounts UX with unified metric-strip cards, improved filter states, and updated discovery-doc card interactions.
- Upgraded reliability threshold settings to Craft env-var-aware inputs and fixed env-var threshold parsing/evaluation behavior.
0.9.0 (2026-03-06)
- Shipped schema/OpenAPI-based templates and tested reference automations for canonical first jobs.
- Shipped integration starter packs (
curl,javascript,python) for faster onboarding. - Expanded reliability and diagnostics surfaces with threshold-driven triage and richer bundle payloads.
- Shipped lifecycle governance endpoint/CLI/CP visibility for ownership, stale usage, expiry, and rotation risk posture.
- Removed Control CP surface from public/operator UX while keeping internal control-plane internals feature-flagged.
0.8.7 (2026-03-05)
- Reordered CP subnavigation so
Agentsappears directly belowDashboard.
0.8.6 (2026-03-05)
- Reworked CP agent management to card-based create/edit workflows and agent-first wording.
- Added managed-agent pause/resume lifecycle support with persisted pause state.
- Added live per-agent usage activity indicators with runtime setting toggle and query-param simulation support.
0.8.5 (2026-03-04)
- Added environment profile resolver with optional
PLUGIN_AGENTS_ENV_PROFILE(local|test|staging|production) and inferred profile fallback. - Added profile-based runtime defaults for auth/rate-limit/webhook posture when explicit
PLUGIN_AGENTS_*values are unset. - Added runtime profile metadata across health/readiness/capabilities/schema/diagnostics outputs (
environmentProfile,environmentProfileSource,profileDefaultsApplied,effectivePolicyVersion). - Added read-only CP Environment Profile posture visibility in Security views.
0.8.1 (2026-03-04)
- Added inventory-aware product snapshots:
GET /agents/v1/productsnow includeshasUnlimitedStockandtotalStockper item. - Added low-stock filtering on
GET /agents/v1/productsvialowStockandlowStockThresholdquery parameters (full-sync mode). - Added inventory fields to variant list payloads so
GET /agents/v1/variantsnow exposesstock,hasUnlimitedStock, andisAvailable.
0.8.0 (2026-03-04)
- Added read APIs for additional Craft and Commerce resources: users (flag-gated), assets, categories, tags, global sets, addresses (flag-gated), content blocks, variants, subscriptions, transfers, and donations.
- Expanded
GET /agents/v1/changescoverage to include newly exposed resources for broader incremental-sync parity. - Added canonical agent handbook link exposure in discovery outputs (
/llms.txt,/llms-full.txt).
0.7.0 (2026-03-04)
- Added one-click diagnostics bundle surfaces across API (
GET /agents/v1/diagnostics/bundle), CP download flow, and CLI (craft agents/diagnostics-bundle). - Added
diagnostics:readscope with capabilities/OpenAPI/schema contract coverage.
0.6.2 (2026-03-04)
- Fixed release metadata/tag alignment by shipping a fresh immutable patch release for plugin-store ingestion.
- Fixed plugin-version fallback constants in API/readiness telemetry to match the current release.
0.6.1 (2026-03-03)
- Fixed adoption metrics runtime fatal by using the existing security posture API.
- Fixed machine-client POST compatibility by disabling CSRF on token-authenticated API routes.
- Fixed dual-approval decision race conditions with optimistic concurrency guards.
- Fixed stale version fallback constants and added release-gate checks to prevent regression.
0.6.0 (2026-03-03)
- Added observability metrics endpoint:
GET /agents/v1/metrics(metrics:read). - Added CP Readiness telemetry snapshot and runbook/alert guidance.
- Added adoption instrumentation endpoint:
GET /agents/v1/adoption/metrics(adoption:read).
0.5.0 (2026-03-03)
- Hardened API contract parity and deterministic request validation paths.
- Improved CP UX grouping and metric color coding.
- Added canonical first-agent jobs, quickstart guidance, and stronger regression gates.