@agentskit/doc-bridge 1.1.1 → 1.2.3

package/ecosystem-upstream.json

@@ -3,7 +3,7 @@
   "repository": "AgentsKit-io/agentskit",
   "ref": "main",
   "files": {
-    "ecosystem.json": "96ff8e60c639116b4a79302509fc8058f9cd2f4db8094677dafb61fb1bc88b58",
-    "ecosystem-claims.json": "eeb37363ac1461a6725f48083d7a326f0f700c0641a7a4cece2a30a3bf05d582"
+    "ecosystem.json": "04995ca6863f744495b672d6e3a64162a415caf4cacb3ba8cdd3521bc90c4879",
+    "ecosystem-claims.json": "0100f7fbc18a3381bb943aaf8151dd5d107f82c02c470e3c586b7d694c6be42e"
   }
 }

package/ecosystem.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 2,
-  "$comment": "Canonical registry of AgentsKit ecosystem products. Stable identity lives here; numeric values live in the generated ecosystem-claims ledger. The deprecated properties array temporarily preserves v1 sibling consumers.",
+  "$comment": "Canonical registry of AgentsKit ecosystem products. Stable identity lives in products[] (seven). Numeric values live in the generated ecosystem-claims ledger. The properties array is the full seven-product v1 projection of products[] (same order) for sibling consumers.",
   "parentBrand": {
     "id": "agentskit",
     "name": "AgentsKit"
@@ -22,12 +22,19 @@
         "llms": "https://www.agentskit.io/llms.txt",
         "stats": "https://www.agentskit.io/api/stats.json",
         "documentation": "fumadocs",
-        "chat": "custom"
+        "chat": "agentschat"
       },
       "navigation": {
         "showInBar": true,
         "order": 0,
-        "next": ["registry", "agentskit-chat", "playbook", "doc-bridge", "code-review", "akos"]
+        "next": [
+          "registry",
+          "agentskit-chat",
+          "playbook",
+          "doc-bridge",
+          "code-review",
+          "akos"
+        ]
       }
     },
     {
@@ -46,12 +53,19 @@
         "llms": "https://registry.agentskit.io/llms.txt",
         "stats": "https://registry.agentskit.io/r/index.json",
         "documentation": "fumadocs",
-        "chat": "custom"
+        "chat": "agentschat"
       },
       "navigation": {
         "showInBar": true,
         "order": 1,
-        "next": ["agentskit", "playbook", "agentskit-chat"]
+        "next": [
+          "agentskit",
+          "agentskit-chat",
+          "playbook",
+          "doc-bridge",
+          "code-review",
+          "akos"
+        ]
       }
     },
     {
@@ -65,15 +79,23 @@
       "repo": "AgentsKit-io/agentskit-chat",
       "accent": "#F59E0B",
       "surfaces": {
-        "home": "https://github.com/AgentsKit-io/agentskit-chat",
-        "docs": "https://github.com/AgentsKit-io/agentskit-chat/tree/main/docs",
-        "documentation": "repository",
-        "chat": "none"
+        "home": "https://chat.agentskit.io",
+        "docs": "https://chat.agentskit.io/docs",
+        "llms": "https://chat.agentskit.io/llms.txt",
+        "documentation": "fumadocs",
+        "chat": "agentschat"
       },
       "navigation": {
         "showInBar": true,
         "order": 2,
-        "next": ["agentskit", "registry", "doc-bridge"]
+        "next": [
+          "agentskit",
+          "registry",
+          "playbook",
+          "doc-bridge",
+          "code-review",
+          "akos"
+        ]
       }
     },
     {
@@ -97,7 +119,14 @@
       "navigation": {
         "showInBar": true,
         "order": 3,
-        "next": ["doc-bridge", "code-review", "agentskit"]
+        "next": [
+          "agentskit",
+          "registry",
+          "agentskit-chat",
+          "doc-bridge",
+          "code-review",
+          "akos"
+        ]
       }
     },
     {
@@ -111,15 +140,23 @@
       "repo": "AgentsKit-io/doc-bridge",
       "accent": "#06B6D4",
       "surfaces": {
-        "home": "https://github.com/AgentsKit-io/doc-bridge",
-        "docs": "https://github.com/AgentsKit-io/doc-bridge/tree/master/docs",
-        "documentation": "repository",
+        "home": "https://agentskit-io.github.io/doc-bridge/",
+        "docs": "https://agentskit-io.github.io/doc-bridge/",
+        "llms": "https://agentskit-io.github.io/doc-bridge/llms.txt",
+        "documentation": "fumadocs",
         "chat": "none"
       },
       "navigation": {
         "showInBar": true,
         "order": 4,
-        "next": ["playbook", "code-review", "agentskit-chat"]
+        "next": [
+          "agentskit",
+          "registry",
+          "agentskit-chat",
+          "playbook",
+          "code-review",
+          "akos"
+        ]
       }
     },
     {
@@ -135,12 +172,21 @@
       "surfaces": {
         "home": "https://github.com/AgentsKit-io/code-review-cli",
         "docs": "https://github.com/AgentsKit-io/code-review-cli#readme",
+        "llms": "https://raw.githubusercontent.com/AgentsKit-io/code-review-cli/main/llms.txt",
         "documentation": "repository",
         "chat": "none"
       },
       "navigation": {
         "showInBar": false,
-        "next": ["playbook", "agentskit", "doc-bridge"]
+        "order": 5,
+        "next": [
+          "agentskit",
+          "registry",
+          "agentskit-chat",
+          "playbook",
+          "doc-bridge",
+          "akos"
+        ]
       }
     },
     {
@@ -163,8 +209,8 @@
       },
       "navigation": {
         "showInBar": true,
-        "order": 5,
-        "next": ["agentskit", "registry", "playbook"]
+        "order": 6,
+        "next": []
       }
     }
   ],
@@ -183,17 +229,29 @@
       "stats": "https://www.agentskit.io/api/stats.json"
     },
     {
-      "id": "akos",
-      "name": "AgentsKit OS",
-      "barLabel": "AKOS",
-      "domain": "akos.agentskit.io",
-      "url": "https://akos.agentskit.io",
-      "repo": "AgentsKit-io/agentskit-os",
-      "tagline": "Run and govern agents in production.",
-      "kind": "product",
-      "accent": "#34D399",
-      "llms": "https://akos.agentskit.io/llms.txt",
-      "stats": "https://akos.agentskit.io/api/stats.json"
+      "id": "registry",
+      "name": "AgentsKit Registry",
+      "barLabel": "Registry",
+      "domain": "registry.agentskit.io",
+      "url": "https://registry.agentskit.io",
+      "repo": "AgentsKit-io/agentskit-registry",
+      "tagline": "Copy ready-made agents and own the source.",
+      "kind": "registry",
+      "accent": "#58A6FF",
+      "llms": "https://registry.agentskit.io/llms.txt",
+      "stats": "https://registry.agentskit.io/r/index.json"
+    },
+    {
+      "id": "agentskit-chat",
+      "name": "AgentsKit Chat",
+      "barLabel": "Chat",
+      "domain": "chat.agentskit.io",
+      "url": "https://chat.agentskit.io",
+      "repo": "AgentsKit-io/agentskit-chat",
+      "tagline": "Define one agent experience and deliver it across interfaces.",
+      "kind": "framework",
+      "accent": "#F59E0B",
+      "llms": "https://chat.agentskit.io/llms.txt"
     },
     {
       "id": "playbook",
@@ -209,17 +267,41 @@
       "stats": "https://playbook.agentskit.io/api/stats.json"
     },
     {
-      "id": "registry",
-      "name": "AgentsKit Registry",
-      "barLabel": "Registry",
-      "domain": "registry.agentskit.io",
-      "url": "https://registry.agentskit.io",
-      "repo": "AgentsKit-io/agentskit-registry",
-      "tagline": "Copy ready-made agents and own the source.",
-      "kind": "registry",
-      "accent": "#58A6FF",
-      "llms": "https://registry.agentskit.io/llms.txt",
-      "stats": "https://registry.agentskit.io/r/index.json"
+      "id": "doc-bridge",
+      "name": "Doc Bridge",
+      "barLabel": "Doc Bridge",
+      "domain": "agentskit-io.github.io",
+      "url": "https://agentskit-io.github.io/doc-bridge/",
+      "repo": "AgentsKit-io/doc-bridge",
+      "tagline": "Turn repository documentation into executable agent handoffs.",
+      "kind": "developer-tool",
+      "accent": "#06B6D4",
+      "llms": "https://agentskit-io.github.io/doc-bridge/llms.txt"
+    },
+    {
+      "id": "code-review",
+      "name": "AgentsKit Code Review",
+      "barLabel": "Code Review",
+      "domain": "github.com",
+      "url": "https://github.com/AgentsKit-io/code-review-cli",
+      "repo": "AgentsKit-io/code-review-cli",
+      "tagline": "Run deep, low-noise review with the model already in use.",
+      "kind": "developer-tool",
+      "accent": "#F97316",
+      "llms": "https://raw.githubusercontent.com/AgentsKit-io/code-review-cli/main/llms.txt"
+    },
+    {
+      "id": "akos",
+      "name": "AgentsKit OS",
+      "barLabel": "AKOS",
+      "domain": "akos.agentskit.io",
+      "url": "https://akos.agentskit.io",
+      "repo": "AgentsKit-io/agentskit-os",
+      "tagline": "Run and govern agents in production.",
+      "kind": "product",
+      "accent": "#34D399",
+      "llms": "https://akos.agentskit.io/llms.txt",
+      "stats": "https://akos.agentskit.io/api/stats.json"
     }
   ],
   "builder": {

package/examples/verify-handoff.mjs

@@ -0,0 +1,5 @@
+import { execFileSync } from 'node:child_process'
+
+execFileSync(process.execPath, ['bin/ak-docs.js', 'demo', '--text'], {
+  stdio: 'inherit',
+})

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentskit/doc-bridge",
-  "version": "1.1.1",
+  "version": "1.2.3",
   "description": "Human↔agent documentation bridge — deterministic handoffs, doc-site links, memory→docs, optional AgentsKit RAG/chat.",
   "type": "module",
   "bin": {
@@ -46,6 +46,7 @@
     "test:watch": "vitest",
     "coverage": "vitest run --coverage",
     "check:ecosystem-upstream": "node scripts/check-ecosystem-upstream.mjs",
+    "check:no-legacy-chat-imports": "node scripts/check-no-legacy-chat-imports.mjs",
     "typecheck": "tsc --noEmit",
     "smoke:packaged": "node scripts/smoke-packaged.mjs",
     "smoke:docsites": "node scripts/smoke-docsites.mjs",
@@ -53,12 +54,24 @@
     "smoke:ollama": "node scripts/smoke-ollama.mjs",
     "coverage:badge": "node scripts/update-coverage-badge.mjs",
     "changeset": "changeset",
-    "version-packages": "changeset version",
+    "version-packages": "changeset version && node scripts/sync-version.mjs",
     "release": "npm run build && npm test && changeset publish",
-    "version": "node scripts/sync-version.mjs && git add package.json src/version.ts",
+    "version": "node scripts/sync-version.mjs && git add package.json src/version.ts action.yml",
     "prepublishOnly": "npm run build && npm test",
     "prepare": "node scripts/prepare.mjs",
-    "prepack": "npm run build"
+    "prepack": "npm run build",
+    "docs:dev": "cd apps/docs && next dev",
+    "docs:artifacts": "node scripts/build-docs-artifacts.mjs",
+    "docs:build": "pnpm build && node bin/ak-docs.js index && pnpm docs:artifacts && cd apps/docs && next build",
+    "docs:typecheck": "cd apps/docs && fumadocs-mdx && tsc --noEmit",
+    "docs:e2e": "playwright test",
+    "docs:lighthouse": "lhci autorun",
+    "test:readme-standard": "node --test scripts/readme-standard.test.mjs",
+    "test:marketplace": "node --test scripts/marketplace-contract.test.mjs",
+    "check:marketplace": "node scripts/check-marketplace-contract.mjs",
+    "test:docs-artifacts": "node --test scripts/docs-artifacts-contract.test.mjs",
+    "check:readme-standard": "node scripts/check-readme-standard.mjs",
+    "check:docs": "pnpm check:readme-standard && node bin/ak-docs.js gate run && node bin/ak-docs.js conformance run documentation-standard-v1 --text && pnpm docs:typecheck && pnpm docs:build && pnpm test:docs-artifacts"
   },
   "keywords": [
     "agentskit",
@@ -82,6 +95,7 @@
     "access": "public"
   },
   "dependencies": {
+    "mermaid": "^11.16.0",
     "zod": "^3.24.2"
   },
   "peerDependencies": {
@@ -113,16 +127,36 @@
     }
   },
   "devDependencies": {
+    "@agentskit/chat": "0.4.0",
+    "@agentskit/core": "1.12.3",
+    "@agentskit/ink": "0.10.4",
+    "@agentskit/react": "0.7.4",
     "@changesets/cli": "^2.31.0",
+    "@lhci/cli": "^0.15.1",
+    "@playwright/test": "1.61.1",
+    "@tailwindcss/postcss": "4.3.2",
     "@types/node": "^22.15.3",
+    "@types/react": "19.2.17",
+    "@types/react-dom": "19.2.3",
     "@vitest/coverage-v8": "4.1.10",
+    "fumadocs-core": "15.6.5",
+    "fumadocs-mdx": "11.6.4",
+    "fumadocs-ui": "15.6.5",
+    "lucide-react": "0.460.0",
+    "next": "15.5.19",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "tailwindcss": "4.3.2",
     "tsup": "^8.5.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.9"
   },
   "pnpm": {
     "overrides": {
-      "esbuild": "^0.28.1"
+      "esbuild": "^0.28.1",
+      "postcss": "8.5.19",
+      "tmp": "0.2.7",
+      "uuid": "11.1.1"
     }
   },
   "directories": {
@@ -134,5 +168,5 @@
   "bugs": {
     "url": "https://github.com/AgentsKit-io/doc-bridge/issues"
   },
-  "homepage": "https://agentskit-io.github.io/doc-bridge/"
+  "homepage": "https://doc-bridge.agentskit.io/"
 }

package/src/conformance/ecosystem-contract.ts

@@ -50,7 +50,12 @@ const ManifestSchema = z.object({
   schemaVersion: z.literal(2),
   parentBrand: z.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema }).passthrough(),
   products: z.array(ProductSchema).min(1),
-  properties: z.array(LegacyPropertySchema).length(4),
+  // Historical four-product shim or full seven-product projection of products[].
+  properties: z
+    .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: z.object({ id: NonEmptyStringSchema, name: NonEmptyStringSchema, url: HttpsUrlSchema }).passthrough().optional(),
 }).passthrough()
 
@@ -88,7 +93,18 @@ const ClaimsSchema = z.object({
   products: z.array(ClaimProductSchema),
 }).passthrough()
 
-const LEGACY_PRODUCT_IDS = ['agentskit', 'akos', 'playbook', 'registry'] as const
+/** Historical four-product shim order. */
+const LEGACY_FOUR_PRODUCT_IDS = ['agentskit', 'akos', 'playbook', 'registry'] as const
+/** Full seven-product projection order (matches products[]). */
+const FULL_SEVEN_PRODUCT_IDS = [
+  'agentskit',
+  'registry',
+  'agentskit-chat',
+  'playbook',
+  'doc-bridge',
+  'code-review',
+  'akos',
+] as const
 
 export const parseCanonicalEcosystemContract = (
   manifestInput: unknown,
@@ -120,7 +136,10 @@ export const parseCanonicalEcosystemContract = (
     }
   }
 
-  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) {

package/src/federation/ecosystem-llms.ts

@@ -0,0 +1,67 @@
+/**
+ * Canonical AgentsKit ecosystem section for llms.txt (and similar machine indexes).
+ *
+ * All products should render this block with the same heading and line shape so
+ * agents can parse the seven-product mesh without per-repo inventiveness.
+ */
+
+export type EcosystemLlmsProduct = {
+  readonly id: string
+  readonly name: string
+  readonly role?: string
+  readonly promise: string
+  readonly maturity?: string
+  readonly surfaces: {
+    readonly home?: string
+    readonly docs?: string
+    readonly llms?: string
+  }
+}
+
+export type FormatEcosystemLlmsBlockOptions = {
+  readonly products: readonly EcosystemLlmsProduct[]
+  /** When set, marks this product with **(current)**. */
+  readonly currentProductId?: string
+  /** Heading line without leading hashes — default `AgentsKit ecosystem`. */
+  readonly heading?: string
+  /**
+   * Prefer docs URL when available; otherwise home.
+   * Default: home, falling back to docs.
+   */
+  readonly prefer?: 'home' | 'docs'
+}
+
+/**
+ * Returns markdown lines for the shared ecosystem block, including a trailing blank line.
+ */
+export function formatEcosystemLlmsBlock(options: FormatEcosystemLlmsBlockOptions): string[] {
+  const heading = options.heading ?? 'AgentsKit ecosystem'
+  const prefer = options.prefer ?? 'home'
+  const lines: string[] = [`## ${heading}`, '']
+
+  for (const product of options.products) {
+    const primary =
+      prefer === 'docs'
+        ? product.surfaces.docs ?? product.surfaces.home
+        : product.surfaces.home ?? product.surfaces.docs
+    if (!primary) continue
+
+    const current = product.id === options.currentProductId ? ' **(current)**' : ''
+    const role = product.role ? ` Role: \`${product.role}\`.` : ''
+    const maturity = product.maturity ? ` Maturity: ${product.maturity}.` : ''
+    const machine = product.surfaces.llms ? ` Machine index: ${product.surfaces.llms}` : ''
+    const promise = product.promise.trim()
+    const promiseSentence = /[.!?]$/.test(promise) ? promise : `${promise}.`
+    lines.push(
+      `- [${product.name}](${primary})${current} — ${promiseSentence}${role}${maturity}${machine}`,
+    )
+  }
+
+  lines.push('')
+  return lines
+}
+
+/** Join the block into a single string ending with a newline. */
+export function formatEcosystemLlmsSection(options: FormatEcosystemLlmsBlockOptions): string {
+  return `${formatEcosystemLlmsBlock(options).join('\n')}\n`
+}

package/src/index.ts

@@ -65,6 +65,12 @@ export {
 } from './validate.js'
 
 export { buildDocBridgeIndex, type BuildIndexOptions, type BuildIndexResult } from './index-builder/build-index.js'
+export {
+  formatEcosystemLlmsBlock,
+  formatEcosystemLlmsSection,
+  type EcosystemLlmsProduct,
+  type FormatEcosystemLlmsBlockOptions,
+} from './federation/ecosystem-llms.js'
 export {
   scanHumanDocRecords,
   scanHumanDocs,

package/src/playbook/doc-bridge-pattern.ts

@@ -111,7 +111,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/
 `
 
 export const docBridgePatternPayload = () => ({

package/src/version.ts

@@ -1 +1 @@
-export const PACKAGE_VERSION = '1.1.1'
+export const PACKAGE_VERSION = '1.2.3'