@agentskit/doc-bridge 1.1.1 → 1.2.3

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # Changelog
 
+## 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
+
+- 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
@@ -35,7 +73,7 @@
 
 ### Features
 
-- **Landing** — `docs/landing/index.html` deployed to GitHub Pages (`https://agentskit-io.github.io/doc-bridge/`)
+- **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)
 

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.4.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

@@ -2,12 +2,16 @@
 
 [![npm](https://img.shields.io/npm/v/@agentskit/doc-bridge?style=flat-square)](https://www.npmjs.com/package/@agentskit/doc-bridge)
 [![CI](https://img.shields.io/github/actions/workflow/status/AgentsKit-io/doc-bridge/ci.yml?branch=master&style=flat-square)](https://github.com/AgentsKit-io/doc-bridge/actions/workflows/ci.yml)
-[![Pages](https://img.shields.io/github/actions/workflow/status/AgentsKit-io/doc-bridge/pages.yml?branch=master&label=pages&style=flat-square)](https://agentskit-io.github.io/doc-bridge/)
+[![Pages](https://img.shields.io/github/actions/workflow/status/AgentsKit-io/doc-bridge/pages.yml?branch=master&label=pages&style=flat-square)](https://doc-bridge.agentskit.io/)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE)
 [![Node](https://img.shields.io/badge/node-%3E%3D22-339933?style=flat-square)](package.json)
 [![TypeScript](https://img.shields.io/badge/types-TypeScript-3178c6?style=flat-square)](dist/index.d.ts)
 
-**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/)
+**npm:** [`@agentskit/doc-bridge`](https://www.npmjs.com/package/@agentskit/doc-bridge) · **CLI:** `ak-docs` · **Landing:** [agentskit-io.github.io/doc-bridge](https://doc-bridge.agentskit.io/)
+
+**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.**
 
@@ -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,14 +290,14 @@ 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
 pnpm smoke:ollama    # optional — skips if Ollama/peers unavailable
 ```
 
-**Landing:** https://agentskit-io.github.io/doc-bridge/
+**Landing:** https://doc-bridge.agentskit.io/
 
 ## Contributing
 

package/action.yml

@@ -18,46 +18,48 @@ 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.3'
 
 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
+        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
-
-    - name: Build index
-      shell: bash
-      run: |
-        if [ -n "${{ inputs.config-path }}" ]; then
-          ak-docs index --config "${{ inputs.config-path }}"
+        # When this Action runs against the Doc Bridge repository itself (CI dogfood),
+        # install the workspace package so gates exercise the PR under test — not a
+        # stale published npm version that may lag the local ecosystem contract.
+        if [ -f package.json ] && [ "$(node -p "try{require('./package.json').name}catch{''}")" = "@agentskit/doc-bridge" ]; then
+          npm install -g .
         else
-          ak-docs index
+          npm install -g "@agentskit/doc-bridge@${DOC_BRIDGE_PACKAGE_VERSION}"
         fi
 
     - 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 +67,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

@@ -716,7 +716,10 @@ var ManifestSchema = z2.object({
   schemaVersion: z2.literal(2),
   parentBrand: z2.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema }).passthrough(),
   products: z2.array(ProductSchema).min(1),
-  properties: z2.array(LegacyPropertySchema).length(4),
+  // Historical four-product shim or full seven-product projection of products[].
+  properties: z2.array(LegacyPropertySchema).refine((value) => value.length === 4 || value.length === 7, {
+    message: "must project either the legacy four products or the full seven-product catalog"
+  }),
   builder: z2.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema, url: HttpsUrlSchema }).passthrough().optional()
 }).passthrough();
 var EvidenceSchema = z2.discriminatedUnion("type", [
@@ -749,7 +752,16 @@ var ClaimsSchema = z2.object({
   manifestSchemaVersion: z2.literal(2),
   products: z2.array(ClaimProductSchema)
 }).passthrough();
-var LEGACY_PRODUCT_IDS = ["agentskit", "akos", "playbook", "registry"];
+var LEGACY_FOUR_PRODUCT_IDS = ["agentskit", "akos", "playbook", "registry"];
+var FULL_SEVEN_PRODUCT_IDS = [
+  "agentskit",
+  "registry",
+  "agentskit-chat",
+  "playbook",
+  "doc-bridge",
+  "code-review",
+  "akos"
+];
 var parseCanonicalEcosystemContract = (manifestInput, claimsInput) => {
   const manifest = ManifestSchema.parse(manifestInput);
   const claims = ClaimsSchema.parse(claimsInput);
@@ -775,7 +787,8 @@ var parseCanonicalEcosystemContract = (manifestInput, claimsInput) => {
       if (!products.has(nextId)) throw new Error(`Product ${product.id} references unknown product ${nextId}.`);
     }
   }
-  for (const [index, id] of LEGACY_PRODUCT_IDS.entries()) {
+  const propertyIds = manifest.properties.length === 7 ? FULL_SEVEN_PRODUCT_IDS : LEGACY_FOUR_PRODUCT_IDS;
+  for (const [index, id] of propertyIds.entries()) {
     const legacy = manifest.properties[index];
     const product = products.get(id);
     if (!legacy || !product || legacy.id !== id || !product.surfaces.home) {
@@ -1334,7 +1347,7 @@ var buildLookup = (config, packages, corpus, indexOutFile, humanDocs = {}, root
 };
 
 // src/version.ts
-var PACKAGE_VERSION = "1.1.1";
+var PACKAGE_VERSION = "1.2.3";
 
 // src/index-builder/capabilities.ts
 var renderCapabilitiesJson = (config, index, paths) => {
@@ -3694,7 +3707,7 @@ Teams track handoff % and human-bridge % daily.
 - npm: https://www.npmjs.com/package/@agentskit/doc-bridge
 - repo: https://github.com/AgentsKit-io/doc-bridge
 - skill: https://github.com/AgentsKit-io/doc-bridge/blob/master/docs/skills/doc-bridge.md
-- landing: https://agentskit-io.github.io/doc-bridge/
+- landing: https://doc-bridge.agentskit.io/
 `;
 var docBridgePatternPayload = () => ({
   ...DOC_BRIDGE_PATTERN_META,