Changelog

0.1.7 - 2026-05-22

Added default-on anonymous product telemetry and agentrail telemetry status, agentrail telemetry off, and agentrail telemetry on CLI controls.

Fixed product telemetry delivery so default customer installs use AgentRail's bundled public PostHog capture key instead of requiring customers to configure AGENTRAIL_TELEMETRY_POSTHOG_KEY.

Added configurable GitHub review policy for AgentRail PRs: follow GitHub rules, always require approval, or skip approval waits once CI is green.
Added setup and provider-connect prompts plus --code-review-policy for non-interactive configuration.
Exposed review policy metadata through submit responses and updated OpenAPI, TypeScript SDK, and Python SDK models.

Preserved review policy through GitHub issue intake, Linear-backed GitHub submit fallback, PR submission, CI projection, and review feedback.
Kept always_require tasks from exposing ship until review approval is present.
Validated repaired task-source codeReviewPolicy values before persistence.

Expanded provider readiness checks for GitHub, CircleCI, and Linear so setup reports missing files, missing config, missing env vars, remote provider settings, and repo linkage gaps with clear remediation.
agentrail provider test <provider> now uses the same readiness engine as agentrail provider doctor <provider>, so token checks cannot pass while end-to-end provider setup is still blocked.
Updated setup docs to clarify that provider connect is the setup/autofix path and that provider test verifies AgentRail lifecycle readiness, not only credentials.

Improved Linear readiness validation so invalid API keys are rejected by a real Linear API check and non-JSON Linear error bodies produce actionable setup output.
Tightened GitHub webhook readiness checks so configured repos must have matching active remote webhooks with the required AgentRail events.

Replaced task-webhook subscriptions with generic AgentRail event subscriptions. Consumers should move from /task-webhook-subscriptions to /event-subscriptions.
Event subscription IDs now use the evsub_ prefix instead of whsub_.
Event delivery requests now identify the subscription with X-AgentRail-Subscription-Id; consumers that previously read X-AgentRail-Webhook-Id should update their header parsing.
Local file persistence now uses AGENTRAIL_EVENT_SUBSCRIPTION_STORE_PATH and AGENTRAIL_EVENT_DELIVERY_STORE_PATH for event subscription and delivery state.

Added agentrail event subscribe, agentrail event subscriptions, and agentrail event unsubscribe for managing event subscriptions from the CLI.
Added managed local runner supervision so AgentRail can keep configured local agents awake and start assigned work from task events.
Added run-scoped managed runner context commands and APIs so child agents can inspect only their assigned run/task context.
Added AI-assisted task routing with setup-time choices for local runner/model and fallback behavior when no suitable agent exists.
Added stricter managed-runner execution policies for Codex, Claude Code, Cursor, and external sandbox wrappers.
Added GitHub Actions and CircleCI lifecycle coverage for PR submission, CI summaries, review feedback, shipping, rollback readiness, and provider metadata.
Added regression coverage for npm package hygiene, OpenAPI/SDK freshness fields, lifecycle transitions, and end-to-end server runtime wiring.

Updated local setup, provider setup, doctor checks, and integration docs around hosted-aware local operation, AI routing, and provider readiness.
Renamed user-facing routing setup language from skills to capabilities to avoid confusion with agent runtime skills.
Improved task actions and blocker wording so agents and users see clearer next steps after CI failures, review feedback, or missing provider setup.

Fixed the stock server runtime so GitHub submit and ship operations call the GitHub API instead of the local AgentRail public URL.
Fixed provider-backed shipping so merged tasks persist done state, rollback availability, ship operation metadata, and merge commit metadata.
Fixed managed runner lifecycle reliability around review-change wakeups, CI recovery, stale CI/review observations, and duplicate GitHub PR submissions.
Fixed managed runner worktree writes, run handoff writes, protected instruction file mode restoration, and strict runner policy checks.
Fixed CircleCI setup and readiness to use full project slugs, support automatic branch-triggered projects, retry failed API triggers, and bound trigger dedupe memory.
Fixed GitHub and CircleCI provider setup readiness so provider connect can create missing CI templates and report what still needs to be committed or configured.
Fixed GitHub polling so first-run imports can start from now instead of pulling historical issues unexpectedly.