@agentskit/doc-bridge 1.1.1 → 1.2.1

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 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
+
+- 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

package/CONTRIBUTING.md

@@ -18,6 +18,7 @@ pnpm build
 - Prefer existing helpers and Node APIs before adding dependencies.
 - Add or update the smallest test that would fail if the behavior regresses.
 - Public contract changes must update the relevant docs under `docs/spec/` or `docs/schemas/`.
+- Dogfood AgentsKit Chat 0.3.x only: `@agentskit/chat`, `@agentskit/chat/protocol`, and `@agentskit/chat/react`. Never reintroduce `@agentskit/chat-protocol` or `@agentskit/chat-react` (`pnpm check:no-legacy-chat-imports`).
 
 ## Pull request checklist
 

package/README.md

@@ -9,6 +9,10 @@
 
 **npm:** [`@agentskit/doc-bridge`](https://www.npmjs.com/package/@agentskit/doc-bridge) · **CLI:** `ak-docs` · **Landing:** [agentskit-io.github.io/doc-bridge](https://agentskit-io.github.io/doc-bridge/)
 
+**Topics:** `ai-agents` · `documentation` · `developer-experience` · `mcp` · `llms-txt` · `typescript`
+
+**Compatibility:** node >=22 · TypeScript 5.8+ · pnpm, npm, or yarn consumers
+
 **Turn your docs into executable handoffs for coding agents.**
 
 doc-bridge reads your repo docs, ownership map, and human documentation site, then gives every agent the same answer:
@@ -18,7 +22,7 @@ doc-bridge reads your repo docs, ownership map, and human documentation site, th
 - which checks prove the change
 - which human docs explain the feature
 
-It is not a wiki, not hosted RAG, and not another chat UI. The core works **without any LLM or API key**.
+It is not a wiki or hosted RAG. The core works **without any LLM or API key**; the documentation portal dogfoods AgentsKit Chat as an optional surface over that deterministic layer.
 
 ![doc-bridge maps human docs into structured agent handoffs](docs/landing/assets/doc-bridge-hero.webp)
 
@@ -74,6 +78,24 @@ Monorepo fixture with auth + billing:
 npx ak-docs demo --fixture monorepo --text
 ```
 
+### Verify the real handoff path
+
+This checked example runs the bundled demo through the public CLI. The README gate compares this block byte-for-byte with the executable fixture and runs it on every PR.
+
+<!-- readme-command:verify-handoff -->
+<!-- readme-example:verify-handoff -->
+```js
+import { execFileSync } from 'node:child_process'
+
+execFileSync(process.execPath, ['bin/ak-docs.js', 'demo', '--text'], {
+  stdio: 'inherit',
+})
+```
+
+```bash
+node examples/verify-handoff.mjs
+```
+
 Full setup in your repo:
 
 ```bash
@@ -91,7 +113,7 @@ ak-docs mcp install --cursor   # wires MCP into .cursor/mcp.json
 |---------|------------|--------------------|
 | **CLI** | Inspect ownership, search docs, run gates, ask local questions | `ak-docs query`, `search`, `ask`, `doctor`, `gate` |
 | **MCP server** | Let Cursor, Claude Code, Codex-style agents resolve handoffs before editing | `ak-docs mcp`, `handoff.resolve` |
-| **GitHub Action / CI** | Fail stale indexes and broken human-doc links on PRs | `AgentsKit-io/doc-bridge@v1.1.1` |
+| **GitHub Action / CI** | Fail stale indexes and broken human-doc links on PRs | `AgentsKit-io/doc-bridge@v1.2.1` |
 | **Documentation conformance** | Check the stable ecosystem standard with auditable evidence | `ak-docs conformance run documentation-standard-v1 --text` |
 | **Doc adapters** | Link human docs to agent docs | `fumadocs`, `docusaurus`, `plain-markdown` |
 | **Monorepo routing** | Discover workspaces and checks | `pnpm-monorepo` |
@@ -181,11 +203,18 @@ Next actions
 Reuse the bundled GitHub Action on every PR:
 
 ```yaml
-- uses: AgentsKit-io/doc-bridge@v1.1.1
-  with:
-    config-path: doc-bridge.config.json
+permissions:
+  contents: read
+
+steps:
+  - uses: actions/checkout@v4
+  - uses: AgentsKit-io/doc-bridge@v1.2.1
+    with:
+      config-path: doc-bridge.config.json
 ```
 
+The Action checks the committed index before changing anything, pins the matching npm package, and rejects non-exact package versions. See the [Marketplace guide](docs/MARKETPLACE.md).
+
 ![handoff coverage](https://img.shields.io/badge/handoff_coverage-100%25-2ea44f?style=flat-square) ![human bridge](https://img.shields.io/badge/human_bridge-0%25-cb2431?style=flat-square)
 
 Run `ak-docs doctor --badge` locally to refresh — or `pnpm coverage:badge` in CI.
@@ -221,7 +250,9 @@ ak-docs rag ingest && ak-docs chat
 
 See **[docs/chat-and-rag.md](docs/chat-and-rag.md)**.
 
-## Who uses it (public)
+## AgentsKit ecosystem
+
+### Who uses it (public)
 
 Designed for and dogfooded on open AgentsKit surfaces:
 
@@ -230,7 +261,7 @@ Designed for and dogfooded on open AgentsKit surfaces:
 | **for-agents** | [agentskit.io/docs/for-agents](https://www.agentskit.io/docs/for-agents) |
 | **Registry** | [registry.agentskit.io](https://registry.agentskit.io/) |
 | **Playbook** | [playbook.agentskit.io](https://playbook.agentskit.io/llms.txt) |
-| **AgentsKit Chat** | [chat framework](https://github.com/AgentsKit-io/agentskit-chat) |
+| **AgentsKit Chat** | [documentation](https://chat.agentskit.io) · [source](https://github.com/AgentsKit-io/agentskit-chat) |
 | **AgentsKit OS** | [akos.agentskit.io](https://akos.agentskit.io) |
 | **Code Review** | [repository-native CLI](https://github.com/AgentsKit-io/code-review-cli) |
 | **This repo** | CI green · `ak-docs gate run` on every PR |
@@ -259,7 +290,7 @@ ak-docs memory promote --pr              # opens draft PR via gh
 
 ## Status
 
-**v1.1.1 stable** — deterministic Documentation Standard v1 conformance, verified release provenance, doctor + CI + skill, landing, Playbook pattern, and full Tier A/B/C.
+**v1.2.1 stable** — deterministic Documentation Standard v1 conformance, verified release provenance, Fumadocs portal, Marketplace Action, doctor + CI + skill, and full Tier A/B/C.
 
 ```bash
 pnpm install && pnpm build && pnpm test

package/action.yml

@@ -18,46 +18,41 @@ inputs:
     required: false
     default: '22'
   package-version:
-    description: npm package version pin (e.g. 1.1.1)
+    description: Exact @agentskit/doc-bridge npm version (kept in sync with this Action release)
     required: false
-    default: ''
+    default: '1.2.1'
 
 runs:
   using: composite
   steps:
     - name: Setup Node
-      uses: actions/setup-node@v4
+      uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v4
       with:
         node-version: ${{ inputs.node-version }}
 
     - name: Install ak-docs
       shell: bash
+      env:
+        DOC_BRIDGE_PACKAGE_VERSION: ${{ inputs.package-version }}
       run: |
-        VERSION="${{ inputs.package-version }}"
-        if [ -n "$VERSION" ]; then
-          npm install -g "@agentskit/doc-bridge@${VERSION}"
-        else
-          npm install -g @agentskit/doc-bridge
-        fi
-
-    - name: Build index
-      shell: bash
-      run: |
-        if [ -n "${{ inputs.config-path }}" ]; then
-          ak-docs index --config "${{ inputs.config-path }}"
-        else
-          ak-docs index
+        if [[ ! "$DOC_BRIDGE_PACKAGE_VERSION" =~ ^[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?$ ]]; then
+          echo "::error title=Invalid package-version::Use an exact semver version such as 1.2.1"
+          exit 2
         fi
+        npm install -g "@agentskit/doc-bridge@${DOC_BRIDGE_PACKAGE_VERSION}"
 
     - name: Run gates
       shell: bash
+      env:
+        DOC_BRIDGE_CONFIG_PATH: ${{ inputs.config-path }}
+        DOC_BRIDGE_GATE_ID: ${{ inputs.gate }}
       run: |
-        if [ -n "${{ inputs.gate }}" ] && [ -n "${{ inputs.config-path }}" ]; then
-          ak-docs gate run "${{ inputs.gate }}" --config "${{ inputs.config-path }}"
-        elif [ -n "${{ inputs.gate }}" ]; then
-          ak-docs gate run "${{ inputs.gate }}"
-        elif [ -n "${{ inputs.config-path }}" ]; then
-          ak-docs gate run --config "${{ inputs.config-path }}"
+        if [ -n "$DOC_BRIDGE_GATE_ID" ] && [ -n "$DOC_BRIDGE_CONFIG_PATH" ]; then
+          ak-docs gate run "$DOC_BRIDGE_GATE_ID" --config "$DOC_BRIDGE_CONFIG_PATH"
+        elif [ -n "$DOC_BRIDGE_GATE_ID" ]; then
+          ak-docs gate run "$DOC_BRIDGE_GATE_ID"
+        elif [ -n "$DOC_BRIDGE_CONFIG_PATH" ]; then
+          ak-docs gate run --config "$DOC_BRIDGE_CONFIG_PATH"
         else
           ak-docs gate run
         fi
@@ -65,9 +60,11 @@ runs:
     - name: Doctor coverage (annotation)
       shell: bash
       continue-on-error: true
+      env:
+        DOC_BRIDGE_CONFIG_PATH: ${{ inputs.config-path }}
       run: |
-        if [ -n "${{ inputs.config-path }}" ]; then
-          REPORT="$(ak-docs doctor --text --config "${{ inputs.config-path }}" 2>&1 || true)"
+        if [ -n "$DOC_BRIDGE_CONFIG_PATH" ]; then
+          REPORT="$(ak-docs doctor --text --config "$DOC_BRIDGE_CONFIG_PATH" 2>&1 || true)"
         else
           REPORT="$(ak-docs doctor --text 2>&1 || true)"
         fi

package/dist/cli/program.js

@@ -1334,7 +1334,7 @@ var buildLookup = (config, packages, corpus, indexOutFile, humanDocs = {}, root
 };
 
 // src/version.ts
-var PACKAGE_VERSION = "1.1.1";
+var PACKAGE_VERSION = "1.2.1";
 
 // src/index-builder/capabilities.ts
 var renderCapabilitiesJson = (config, index, paths) => {