# Changelog

## 1.4.1

### Patch Changes

- ef543f6: Publish the portable handoff skill through an Agent Plugins v1 manifest for GitHub Copilot.
- 8b07f46: Package the portable handoff skill and credential-free MCP server as a Claude Code plugin.

## 1.4.0

### Minor Changes

- 14a9075: Add a portable, fail-closed Doc Bridge handoff skill with a zero-credential resolver and synthetic compatibility fixture for Agent Skills runtimes.

### Patch Changes

- 5133bda: Expose the portable Doc Bridge handoff skill as a discoverable Pi package.
- 14a9075: Add a Cursor plugin manifest, pinned MCP configuration, and handoff skill.

## 1.3.0

### Minor Changes

- 319605e: Add read-only Nx project inference for Doc Bridge ownership, handoffs, and available test and lint checks.
- e0db193: Add first-party VitePress and Astro Starlight human-documentation adapters.
- 03c17bc: Add a first-party Nextra human-documentation adapter for deterministic content-directory routes.

## 1.2.6

### Patch Changes

- Restore the stable release security gate with patched Next.js and Sharp versions and pnpm 11-compatible dependency overrides.

## 1.2.5

### Patch Changes

- d2429f4: Add read-only MCP tool annotations, a public privacy policy, and deterministic MCPB packaging for local Claude Desktop installation.

## 1.2.4

### Patch Changes

- 8106e2e: Add the verified MCP Registry namespace to the published package metadata.

## 1.2.3

### Fixed

- Publish path for seven-product `properties[]` contract and `formatEcosystemLlmsBlock` (v1.2.2 GitHub tag/package.json were misaligned; npm still on 1.2.1)
- Marketplace Action dogfoods the local workspace package when run in this repository
- Docs site `llms.txt` renders the shared seven-product mesh with role, maturity, machine index, and **(current)**

### Changed

- Sync `ecosystem.json` upstream snapshot from AgentsKit hub main

## 1.2.1

### Fixes

- Restore the stable release audit with pnpm's bulk advisory client and pin patched transitive versions of PostCSS, tmp, and uuid.

## 1.2.0

### Minor Changes

- d4260b9: Add the production documentation portal, deterministic AgentsKit Chat knowledge surface, generated LLM and raw Markdown artifacts, and README Standard v1 quality gates.

## Unreleased

### Features

- Add read-only MCP tool annotations, a public privacy policy, and validated MCPB packaging for local Claude Desktop installation.
- Migrate the documentation portal dogfood from AgentsKit Chat 0.2 packages (`@agentskit/chat-protocol`, `@agentskit/chat-react`) to the consolidated 0.3.x surface (`@agentskit/chat/protocol`, `@agentskit/chat/react`) while keeping `@agentskit/chat` as the root package.
- Replace the legacy Pages landing with a statically exported Fumadocs portal backed directly by the canonical `docs/**` corpus.
- Generate `llms.txt`, `llms-full.txt`, raw Markdown, and a hash-verified deterministic AgentsKit Chat artifact from the repository's own Doc Bridge index.
- Add dynamic AgentsKit Chat dogfood with local exact answers, ambiguity choices, session-aware backend fallback, and explicit provenance.
- Adopt README Standard v1 for repository, package, and public-app profiles with synchronized executable examples and freshness evidence.

### Quality

- Add `pnpm check:no-legacy-chat-imports` to reject any reintroduction of `@agentskit/chat-protocol` or `@agentskit/chat-react`.
- Add desktop/mobile Playwright coverage for the landing, Fumadocs, local chat, ambiguity, and completed backend stream.
- Expand self-ownership handoffs across CLI, indexing, query, MCP, quality, memory, and intelligence modules.

## 1.1.1

### Fixes

- Publish stable packages only from immutable tags after security, test, coverage, packaged-smoke, dogfood, and Documentation Standard v1 gates pass.
- Sync the canonical ecosystem snapshot before release so conformance and cross-product navigation remain current.

## 1.1.0

### Minor Changes

- Add the stable, HITL-approved Documentation Standard v1 deterministic conformance profile, CLI command, reports, remediation, explicit approved exceptions, generated llms.txt freshness checks, and canonical ecosystem manifest/claims validation.

## 1.0.2

### Fixes

- Sync `ak-docs --version`, MCP `serverInfo.version`, and capabilities version from `package.json` during build/release.
- Allow `ak-docs query <id> --agent` as a shortcut for package/ownership handoff lookup.
- Packaged smoke now verifies installed CLI version.

## 1.0.1

### Fixes

- Hardened release validation with coverage for Layer 1 CLI, RAG/chat wrappers, MCP install, package-manager checks, watcher, markdown/glob helpers, and packaged/docsite smoke paths.
- Fixed provider API-key defaults for optional AgentsKit intelligence adapters.
- Replaced publish-time `pnpm build` hooks with `npm run build` for npm-friendly packing.

## 1.0.0

**Stable** — doctor, CI gate, MCP install, and agent skill are boring-reliable. Tier C polish ships.

### Features

- **Landing** — `docs/landing/index.html` deployed to GitHub Pages (`https://doc-bridge.agentskit.io/`)
- **Playbook pattern** — published `docs/playbook/doc-bridge-pattern.md` + `ak-docs playbook pattern [--text]`
- **Used by** — public AgentsKit surfaces cited on landing (for-agents, Registry, Playbook)

### Stable criteria met

- 60s demo path (`ak-docs demo`)
- Doctor coverage score + badges
- GitHub Action `doc-bridge-gate` + repo dogfood CI
- Cursor skill + `mcp install --cursor`
- Memory promote → draft PR, index `--watch`, Ollama smoke (optional)

### Breaking changes from alpha

- None intended for Layer 0 config/handoff schemas (still `schemaVersion: 1`)
- Pin `@v1.0.0` for GitHub Action instead of alpha tags

## 0.1.0-alpha.5

Tier B — power-user workflows and production pipeline polish.

### Features

- **`ak-docs memory promote --pr`** — draft file + `gh pr create --draft` (with `--dry-run`, `--force`)
- **`ak-docs index --watch`** — debounced rebuild on agent/human doc changes
- **`ak-docs doctor --badge`** / **`--write-badge`** — shields.io markdown + `.doc-bridge/coverage-badge.json`
- **Ollama demo** — `examples/ollama-chat.config.ts`, `docs/ollama-demo.md`, `pnpm smoke:ollama`
- **Index pipeline recipes** — pre-commit, Turborepo, CI (`docs/recipes/index-pipeline.md`)
- **`pnpm coverage:badge`** — CI-friendly badge updater script

## 0.1.0-alpha.4

Activation and agent-adoption polish — from "works" to "wow in 60s".

### Features

- **`ak-docs demo`** — bundled example/monorepo fixtures; before/after handoff, gate red→green, MCP snippet (no local config)
- **`ak-docs doctor`** — coverage score 0–100, missing agentDoc/humanDoc, gate status, next actions
- **`ak-docs mcp install --cursor | --claude`** — writes MCP server config
- **Handoff `bridge`** — `linked` / `missing` / `external` humanDoc status with bootstrap action
- **`ak-docs ask`** — handoff preview (start, edit, checks, bridge) when ownership matches
- **GitHub Action** — `action.yml` (`doc-bridge-gate`) for PR gates + doctor annotation
- **Agent skill** — `docs/skills/doc-bridge.md` for Cursor/Claude one-shot routing rules
- **Demo fixtures** — `examples/demo-example`, `examples/demo-monorepo` (auth + billing)

## 0.1.0-alpha.3

Dogfood round-2 fixes (search ranking, full-text body, peers, federation soft-fail).

### Fixes

- **Search ranking:** exact id / basename boost; ownership preferred for routing questions; path dedupe
- **Full-text search:** knowledge entries store `body` excerpt; descriptions prefer frontmatter `purpose` and complete sentences
- **ask:** next command prefers ownership match over knowledge-only
- **Text UX:** multi-line search/ask matches (`[type] id`, path, summary)
- **Federation:** missing/404 remote `llms.txt` soft-skipped (no hard fail)
- **Peers:** optional peer ranges widened (`@agentskit/core` `>=1.0`, adapters `>=0.12`) so Layer 0 install is not blocked
- **humanDoc:** more aliases (`packages/id`, `reference/packages/id`, path suffixes)

## 0.1.0-alpha.2

Dogfood-driven polish after ecosystem install on agentskit, agentskit-os, playbook, and registry.

### Fixes / features

- **Package-manager-aware checks** — pnpm/yarn/npm/bun; `pnpm --filter <pkg>` in workspaces
- **Corpus ownership inference** — `packages/<id>.md`, pillars patterns, registry READMEs (toggle `routing.options.ownershipFromCorpus`)
- **Richer `guessAgentDocForPackage`** — packages/id, index.md, mdx, for-agents top-level
- **humanDoc aliases** — scoped names, common id variants
- **Fumadocs** excludes nested `for-agents/` from human corpus by default
- **plain-markdown** accepts `contentDir` (alias of `root`)
- **Gates:** preset `playbook`; docs-style profiles `playbook-okf-soft`, `title-only`; strict includes docs-style
- **Git install:** `prepare` via `scripts/prepare.mjs` builds `dist/` when missing; `prepack` builds; source included for rebuilds
- Default agent include `**/*.{md,mdx}`

## 0.1.0-alpha.1

Initial alpha — human↔agent documentation bridge.

### Layer 0 (no API key)

- Versioned Zod schemas for AgentHandoff, AgentSearch, DocBridgeIndex, config, and MemoryCandidate.
- `ak-docs init` (demo ownership by default, `--no-demo` available), `index`, `query`, `search`, `list`, `gate run`, `mcp`, `ask`.
- Ownership handoffs from **config**, **agent-doc frontmatter** (`package` + `editRoot`), or monorepo discovery.
- `--config` resolves project root from the config file directory.
- MCP: `handoff.resolve`, `doc.search`, `doc.get`, `gate.status`, memory + retriever tools.
- Human adapters: plain markdown, Fumadocs, Docusaurus; gates for freshness, human links, OKF style.
- Memory pipeline: ingest → classify → promote drafts (HITL).
- Progressive CLI help (Core / Intelligence / Advanced).

### Layer 1 (optional AgentsKit peers)

- `ak-docs rag ingest|search` via `@agentskit/rag` + `@agentskit/memory`.
- `ak-docs chat` and `ask --chat` via `@agentskit/ink` + adapters (`handoffFirst`).
- Optional peerDependencies — Layer 0 install stays lean.

### Docs / packaging

- Positioning as human↔agent bridge; public consumers: for-agents, Registry, Playbook.
- Getting started, MCP, examples, chat-and-rag guides.
- Fixed package `main`/`types` exports for publish.