# Changelog

A running history of changes to the Autohand documentation site.

## 2026-08-12

- Replaced site-wide documentation typography with local `Autohand Sans` 400 and applied `Autohand Mono` to code and syntax components.
- Updated `scripts/generate-og-images.mjs` to embed Autohand Sans 400 in every text layer and remove obsolete OG assets.
- Made `website_blueprint` default-off and gated Blueprint links, navigation, routes, and SEO/discovery output in `DocsLayout.vue`, `index`, and `scripts/optimize-seo-geo.mjs`.
- Reworked `index` into one goal-first journey for Autohand Code, the Code Agent SDK, and extensions, with responsive navigation and Integrations promoted in the resource directory.
- Added compact accessible language tabs, executable run commands, expected output, a completion checkpoint, troubleshooting links, and a two-image Console walkthrough to `agent-sdk/quickstart`.
- Replaced the static provider comparison in `guides/model-selection` with constraint-first guidance generated from the shared model-provider manifest.
- Added contextual ranking and neutral loading feedback to `Search.vue`, including a direct path to the SDK API-key setup.
- Reorganized `DocsLayout.vue` with a top-level Integrations destination and progressive, task-grouped SDK and integrations navigation.
- Updated `scripts/build-changelog.mjs` so exact page entries in this changelog can supply trustworthy last-modified metadata before a commit exists.
- Added a real `integrations/` landing page with an open directory, availability and credential cues, and clean-route-aware sidebar navigation.
- Added answer-first setup facts, visible FAQs, matching `FAQPage` schema, and GEO contract coverage across all 25 integration guides.
- Reworked the `integrations/linear`, `integrations/sentry`, and `integrations/datadog` coming-soon presentation into an unboxed status layout.
- Corrected the home Code Agent SDK examples to use `AUTOHAND_API_KEY`, added Shiki syntax highlighting, and replaced home surface text copy controls with accessible icons.

## 2026-08-11

- Added the `agent-sdk/quickstart` API-key flow with Console screenshots, one-time-secret guidance, and `AUTOHAND_API_KEY` setup, and surfaced the Console link in the home SDK starter.
- Added language and Autohand model selectors with live SDK examples to the documentation home page.
- Refined the documentation home typography and replaced the grid-and-bracket path cards with an open Autohand-specific pathway layout.
- Redesigned the documentation home page with a full-width path-first layout, surface tabs, quickstart actions, and responsive navigation cards.
- Added the `getting-started/plans-and-pricing` section as twelve dedicated pages: overview, pricing and limits, usage limits, one page per plan (free, pro, max, team, enterprise), provider API, available models, payment methods, and FAQ.
- Documented that the Free plan does not require a credit card, with GitHub account age as the primary eligibility signal and a card on file only as an optional alternative.
- Named the individual tier `Autohand Code Pro` throughout the plans documentation, replacing the former `Premium` product name.
- Documented the non-refundable subscription policy and end-of-period cancellation on `plans-and-pricing/payment-methods` and in the plans FAQ.
- Added a `Plans & Pricing` navigation section under Getting started in `DocsLayout.vue`, expanded automatically on any plans page.
- Added DeepSeek V4 Flash to the recommended coding models table in `models/index`.

## 2026-07-31

- Reworked `tutorials/extensions/authoring-your-first-extension` into a Level 100, task-oriented tutorial with prerequisites, learning objectives, troubleshooting, and advanced next steps.
- Added `tutorials/extensions/500-atlassian-rovo-integration` with a declarative Agent Skill, native Rovo MCP configuration, OAuth and API-token boundaries, write confirmation, verification, Forge separation, and production test guidance.
- Updated the Extensions tutorial index, navigation, and contract tests for the Level 500 Atlassian Rovo integration.
- Expanded `tutorials/extensions/authoring-your-first-extension` with the built-in `$extension-builder` fast path, a complete contributed `SKILL.md`, project-scoped installation, skill invocation, and lifecycle verification.
- Added `agent-sdk/concepts/cli-runtime-control` with the complete v1.0.4 cross-language control surface for reset, browser handoff, auto-mode, approvals, saved sessions, timed YOLO, MCP, project learning, tool inspection, context compaction, and auto-mode events.
- Updated all CLI-backed language API references, the Agent SDK overview, and navigation to expose native runtime-control method names and the shared protocol contracts.

## 2026-07-30

- Added `agent-sdk/io/step-control` and updated the TypeScript API, sessions, and hooks/events docs for `stopWhen`, concurrent-session awareness, and complete CLI-backed event parity.
- Added `working-with-autohand-code/mobile-handoff` and updated CLI navigation and `/go` docs for live steering, durable queues, mobile commands, approvals, exact session resume, and delivery safeguards.

## 2026-07-29

- Added `guides/cursor-alternative` with source-backed Cursor AI, Cursor IDE, CLI, pricing-model, and migration comparisons; corrected the Cursor import reference and linked the guide from navigation.
- Fixed social previews across docs pages with complete Open Graph image metadata, correctly sized `1200×630` PNGs, and a regression test for the published image contract.
- Canonicalized production navigation links and moved legacy `/docs/*.html` handling to one-hop permanent redirects to reduce redirected URL discovery in Search Console.

## 2026-07-28

- Rebuilt `working-with-autohand-code/configuration` against the current CLI schema, including config precedence, project overlays, providers, sessions, memory, status-line settings, feature flags, browser integration, and runtime-only controls.
- Updated `working-with-autohand-code/extensions`, `guides/extensions`, and extension tutorials for declarative tools, agents, and skills plus explicitly trusted runtime commands, UI, hooks, providers, flags, and permission policy.
- Added `guides/extensions/adapt-pi-package` and `tutorials/extensions/workspace-brief-extension` for Pi compatibility and the declarative tool-plus-Agent-Skill pattern.
- Refreshed `working-with-autohand-code/cli-reference`, `working-with-autohand-code/slash-commands`, navigation, and collection indexes for structured output, extensions, background process control, announcements, changelog access, and browser-neutral commands.
- Added configuration and extension documentation contract tests covering current CLI fields, trust boundaries, navigation, and shipped examples.

## 2026-07-21

- Added `tutorials/extensions/build-runtime-extension` with an end-to-end trusted Extension API v1 build covering slash commands, Ink UI, line segments, shortcuts, flags, hooks, providers, permission policy, trust, daily use, and lifecycle proof.
- Updated Blueprint source-development commands to use the canonical Cargo package and path (`blueprint` and `crates/blueprint`) and renamed the source-discovery variable to `BLUEPRINT_INDEX_WORKSPACE`.

## 2026-07-20

- Updated the Blueprint manual and product references to use the canonical `blueprint` command, `BLUEPRINT_WORKSPACE` with its `~/.blueprint` default, `blueprint-index` skill, and `blueprint` MCP registration; clarified that non-Git umbrella folders automatically discover separate Git repositories and `--no-root` skips only a supplied Git root.

## 2026-07-17

- Added a global `Blueprint` entry to the `DocsLayout.vue` top navigation with correct Blueprint and Code active states.
- Updated the home-page product suite with Autohand Code and Code Agent SDK, removed Commander, and staged Squad behind `docs_assembly_false`.
- Linked the `working-with-autohand-code/blueprint` product-name note to the EvoGraph research paper.
- Refined the `working-with-autohand-code/blueprint` introduction to position Blueprint as purpose-built for evolutionary traction.

## 2026-07-16

- Added the `working-with-autohand-code/blueprint` user manual covering installation, indexing, search and lineage, Skills and MCP, coding-agent setup, and operations.
- Added Blueprint directly below Evolve in `DocsLayout.vue`, with expandable links for every manual page.
- Added `guides/build-my-company-brain` and featured it in the Guides index as an end-to-end multi-repository Blueprint workflow.
- Added `tests/blueprint-docs.test.mjs` and refreshed generated discovery artifacts for the new Blueprint routes.

## 2026-07-15

- Added `working-with-autohand-code/extensions` documentation comparing the Code Agent SDK and CLI extension paths, with lifecycle and Extension API v1 references.
- Added the `guides/extensions` category covering extension architecture, package design, barebone CLI composition, tools and agents, security, scopes, lifecycle, and distribution.
- Added the `tutorials/extensions` category with nine detailed builds, including authoring a first extension and recreating all five shipped CLI examples.
- Updated `DocsLayout.vue` and the Code, Guides, and Tutorials indexes so all extension pages are grouped and discoverable in the shared navigation.
- Added `tests/extensions-docs.test.mjs` to verify page structure, navigation coverage, build-path guidance, bare-mode boundaries, and the CLI extension contract.
- Refreshed `db/seed.sql` and generated discovery artifacts with the new extension routes.

## 2026-07-14

- Gated `working-with-autohand-code/assembly` navigation, routes, generated discovery files, search, and build output behind the default-off `docs_assembly_false` flag.
- Added `guides/teams-and-swarms` user manuals for sub-agents, task-based agent teams, `/deep-research`, `/autoresearch`, and 24 orchestration playbooks.
- Added the `Orchestrate Team of Agents` Guides category, grouping the Sub-agent Catalog and the new orchestration manuals in the sidebar and Guides index.
- Expanded `DocsLayout.vue` with 24 named playbook links grouped by engineering, operations, research, and optimization instead of a generic use-case link.
- Corrected `working-with-autohand-code/slash-commands` for the implemented `/deep-research` contract and linked both new research-command manuals.
- Updated SEO and Open Graph generators to label the `teams-and-swarms` route as `Orchestrate Team of Agents` in generated breadcrumbs.

## 2026-07-13

- Fixed broken `/docs/*` links in local dev and production by adding a Vite middleware rewrite and a Cloudflare Pages redirect (`/docs/*` → `/*`). Pages such as `/docs/guides/sub-agent-catalog.html` now load correctly.
- Added headless deployment tutorials for VPS, AWS EC2, DigitalOcean, Docker, Cloudflare Tunnel, Workers, and Containers, with navigation and Markdown mirrors.
- Refreshed `working-with-autohand-code/cli-reference` and `working-with-autohand-code/slash-commands` against the current Autohand Code CLI.
- Added Sakana AI provider setup and GLM 5.2 model guidance across integrations, model selection, and Agent SDK examples.
- Routed `/docs/admin` and related administration paths to the primary Autohand admin experience.
- Unified the shared docs shell with normalized routes, expanded navigation groups, and a generated right-side table of contents.
- Standardized code-block presentation, installer tabs, typography, and responsive docs styling.
- Added the changelog, sitemap, robots, SEO/GEO metadata, Markdown export, and LLM discovery publishing pipeline.
- Added repository contribution guidance for changelog discipline and build validation.
- Refreshed `db/seed.sql` so the docs catalog includes all 224 current pages and navigation sections.
- Removed trailing whitespace from generated changelog Atom entries.
- Updated `working-with-autohand-code/slash-commands` to reflect the latest Autohand CLI slash command registry: added `/fork`, `/clone`, `/tree`, `/statusline`, `/usage`, `/go`, `/handoff session`, `/review`, `/pr-review`, `/deep-research`, `/deep-search`, `/autoresearch`, `/setup`, `/yolo`, `/tools`, `/experiments`, `/goal`, `/squad`, `/skills info`, `/skills deactivate`, and `/agents new`; corrected `/search` to web-search provider configuration; removed `/commit`; updated the generated Markdown mirror.
- Fixed the shared `DocsLayout` bootstrap for `guides/sub-agent-catalog` and `tutorials/build-specialist-agent-team`, restoring navigation and footer rendering.
- Added `guides/sub-agent-catalog` and `tutorials/build-specialist-agent-team` with Autohand Code 0.9.3 availability, approval, installation, and delegation guidance.
- Updated `working-with-autohand-code/agent-teams`, guide and tutorial indexes, and sidebar navigation with catalog and GitHub links.

## 2026-06-26

- Moved the sidebar `New` badge from `working-with-autohand-code/chrome` to the Assembly section.
- Added Cursor Agent to the `working-with-autohand-code/assembly` supported harness coverage.
- Expanded `working-with-autohand-code/assembly` with stronger positioning, supported harnesses, custom profile steps, and failed-session restart guidance.
- Added a `/code/assembly/` route shortcut for local and deployed Assembly docs access.
- Added a new collapsible **Assembly** category under **Working with Autohand** (`src/components/DocsLayout.vue`).
- Added Assembly getting-started pages covering installation, dashboard, creating sessions, projects and profiles, sessions and audit logs, memory, and events and hooks (`src/working-with-autohand-code/assembly/`).
- Captured real Assembly UI screenshots and saved them to `public/media/assembly/`.

## 2026-06-25

- Expanded hooks, automation, and tool-extension examples with JavaScript, TypeScript, Python, Go, Java, Swift, and curl variants.
- Expanded all Tutorials sidebar groups on `/tutorials/` so the full tutorial inventory is visible.
- Restored `DocsLayout.vue` right-side table of contents and fixed duplicated `CodeBlock.vue` headers.
- Fixed generated code examples in hooks and automation pages so Vue can compile the docs shell.
- Switched documentation font to Manrope across all pages and components.
- Improved docs discoverability by generating a comprehensive `sitemap.xml` with image metadata for 196 pages.
- Strengthened structured data for collection/index pages using `CollectionPage` with `hasPart` → `ItemList`.
- Fixed code-block HTML entity rendering for inline `<script>`-supplied code samples.
- Restructured external provider tutorial references into card lists with title, domain, description, and external-link indicator.
- Added a hooks and events guide under Code (`/working-with-autohand-code/hooks-and-events.html`).
- Added a hooks and events technical article under Agent SDK Core Concepts (`/agent-sdk/concepts/hooks-and-events.html`).
- Added an "Extend with Tools" article under Agent SDK Extend with Tools (`/agent-sdk/tools/extend-with-tools.html`).
- Added a new Agent SDK Automation category with overview, event-driven agents, scheduled tasks, CI/CD integrations, and real-time notifications articles.
- Added a new `/guides/automation/` category with overview, hooks and events, and building event-driven agents guides.
- Added a new `/tutorials/automations/` category with overview, real-time notifications, CI reviewer bot, and event-driven refactor tutorials.
- Added a new `/tutorials/extend-with-tools.html` tutorial.
- Updated sidebar navigation, guide index, and tutorial index with the new categories.

## 2026-06-09

- Initial documentation platform release with guides, tutorials, API reference, and search.
