diff --git a/.doc-bridge/capabilities.json b/.doc-bridge/capabilities.json index 73ba75c9..9c2eac81 100644 --- a/.doc-bridge/capabilities.json +++ b/.doc-bridge/capabilities.json @@ -7,7 +7,7 @@ "name": "AgentsKit", "root": "." }, - "contentHash": "d52ecd9dd5e5571c517fa610b57907ef984d513558e2b59b23d1705b9da1e247", + "contentHash": "45e8809fb96d100c3daa2bd6455734a0d6918f09c542ef28bd5b318649a0615d", "artifacts": { "index": ".doc-bridge/index.json", "llmsTxt": ".doc-bridge/llms.txt" diff --git a/.doc-bridge/index.json b/.doc-bridge/index.json index 5274f002..c8b68d36 100644 --- a/.doc-bridge/index.json +++ b/.doc-bridge/index.json @@ -1,8 +1,8 @@ { "schemaVersion": 1, - "contentHash": "d52ecd9dd5e5571c517fa610b57907ef984d513558e2b59b23d1705b9da1e247", + "contentHash": "45e8809fb96d100c3daa2bd6455734a0d6918f09c542ef28bd5b318649a0615d", "contentHashAlgo": "sha256-semantic-v1", - "generatedAt": "2026-10-12T11:25:16.961Z", + "generatedAt": "2026-10-13T16:28:42.235Z", "project": { "name": "AgentsKit", "root": "." @@ -424,7 +424,7 @@ "document", "project" ], - "contentHash": "13a5b8c2a23d497ac70a65b60c5e96c6a2d6b5e302b7d88d6479b30d00815b20" + "contentHash": "b5edb3458cfc22b1e67ef4450738de258f59716919b26fb97da8c042816962bf" }, { "id": "document:apps/docs-next/content/blog/hello-agentskit.mdx", @@ -5069,6 +5069,18 @@ ], "contentHash": "65639fc3e23b39a849c93f231ad6e1ab70a4fd3231ab97a58052415dccddb2c0" }, + { + "id": "document:apps/docs-next/content/docs/use-cases/repo-docs.mdx", + "type": "document", + "title": "repo-docs.mdx", + "path": "apps/docs-next/content/docs/use-cases/repo-docs.mdx", + "description": "Coding agents guess when repository docs are written only for humans. They edit the sibling package, run the wrong test, or miss the guide that already explains the rule.", + "tags": [ + "document", + "human" + ], + "contentHash": "e2e81af76dd0f19afde9c1a651b47b67edd3e98d36f1c8b751e2c0f4f5500d00" + }, { "id": "document:apps/docs-next/content/docs/use-cases/research-agent.mdx", "type": "document", @@ -5127,7 +5139,7 @@ "document", "project" ], - "contentHash": "09cad6996fecff6542b5cfd1bd6eacc42829e7545c699ed775c24e6e14f8668f" + "contentHash": "0363bc906888a3e2037287b3d5048f9c3360ab3a4d6adba4d69562652f1e7972" }, { "id": "document:apps/docs-next/shell/README.md", @@ -5331,7 +5343,7 @@ "document", "project" ], - "contentHash": "bff85b5de2f6fd76479024149e525ae74f4f7c6ec5fe57d83d0bab1a7136f352" + "contentHash": "0eda1e7af31c228d3a8fc58cfab5f69d183f015334060f459a3a5589c82c4971" }, { "id": "document:apps/registry/AGENTS.md", @@ -5511,7 +5523,7 @@ "document", "project" ], - "contentHash": "8e06bb4bd3317631a6301f111f9deb1543bd999999abcbe2d1b0f53b94d0b158" + "contentHash": "b10398218b71f12509f6d53532c32fe5b30dc8da93fca185cf74cfef352f53a6" }, { "id": "document:apps/visual-react/README.md", @@ -8400,6 +8412,21 @@ ], "contentHash": "272d3c32bd884b26ee1e044d4fc54981c3adfede0bba595d8558dd59d086e937" }, + { + "id": "module:apps/docs-next/app/api/downloads/route.ts", + "type": "module", + "title": "route.ts", + "path": "apps/docs-next/app/api/downloads/route.ts", + "symbols": [ + "GET" + ], + "tags": [ + "module", + "ts", + "downloads" + ], + "contentHash": "bae05c85d348445b7d77f47eddfb7227e38207b4af599783bca09953c7ebd5a6" + }, { "id": "module:apps/docs-next/app/api/ecosystem.json/route.ts", "type": "module", @@ -8601,6 +8628,52 @@ ], "contentHash": "2abfafa9cb1372cae872b0047fe7c820f838844e036b54f54e00bfb2b2c84101" }, + { + "id": "module:apps/docs-next/app/downloads/downloads-dashboard.tsx", + "type": "module", + "title": "downloads-dashboard.tsx", + "path": "apps/docs-next/app/downloads/downloads-dashboard.tsx", + "symbols": [ + "DownloadsDashboard" + ], + "tags": [ + "module", + "tsx", + "downloads" + ], + "contentHash": "26d0960a1596869a5123d7e1fa8dbf0b3b8d6944f0a2c8fa2fffe1a0af594ff1" + }, + { + "id": "module:apps/docs-next/app/downloads/layout.tsx", + "type": "module", + "title": "layout.tsx", + "path": "apps/docs-next/app/downloads/layout.tsx", + "symbols": [ + "DownloadsLayout" + ], + "tags": [ + "module", + "tsx", + "downloads" + ], + "contentHash": "9d4a01c5c819ff48da410f38f20991694bf31599a3f76ce2f458647a13e33681" + }, + { + "id": "module:apps/docs-next/app/downloads/page.tsx", + "type": "module", + "title": "page.tsx", + "path": "apps/docs-next/app/downloads/page.tsx", + "symbols": [ + "DownloadsPage", + "metadata" + ], + "tags": [ + "module", + "tsx", + "downloads" + ], + "contentHash": "7c635ea02bd62b05ebadd685192356fc602b63b46d3eb0b8eb5f70106fceb733" + }, { "id": "module:apps/docs-next/app/ecosystem-claims.js/route.ts", "type": "module", @@ -11055,6 +11128,29 @@ ], "contentHash": "cec0b68a6f1132f9ef62d34624ceb702182cb975eb128d014f6f6a365b627b14" }, + { + "id": "module:apps/docs-next/lib/npm-downloads.ts", + "type": "module", + "title": "npm-downloads.ts", + "path": "apps/docs-next/lib/npm-downloads.ts", + "symbols": [ + "DailyCount", + "DownloadsData", + "FIRST_PUBLISHED_DAY", + "PACKAGE_NAMES", + "PackageCounts", + "PackageName", + "addDays", + "dateChunks", + "sumDays" + ], + "tags": [ + "module", + "ts", + "lib" + ], + "contentHash": "c36f670b93f1cd4a7dfbf74073142d45c68268abfa0ea043f1e2b17117af57c2" + }, { "id": "module:apps/docs-next/lib/openrouter.ts", "type": "module", @@ -11673,6 +11769,19 @@ ], "contentHash": "fa871ad1b43f433d4eead422637f4f0047105d23f592debd1aebc576ac7c9c33" }, + { + "id": "module:apps/docs-next/tests/npm-downloads.test.ts", + "type": "module", + "title": "npm-downloads.test.ts", + "path": "apps/docs-next/tests/npm-downloads.test.ts", + "tags": [ + "module", + "ts", + "test", + "tests" + ], + "contentHash": "5ed5c1554e838b24b40b78d9978b67d07a56b09beec5e12294a4a27103bca063" + }, { "id": "module:apps/docs-next/tests/public-resources.test.ts", "type": "module", @@ -38588,8 +38697,8 @@ "changes": {} }, "inputs": { - "hash": "ec642fbcb0d4dd5ad4adaba9c57f35682ed92f42f09f50d87f0308159de8098d", - "fileCount": 2649, + "hash": "23a53391eb5a3a9672e9045987c1715cb9941e591ec1fa01e755827cb2c82582", + "fileCount": 2656, "projectionVersion": 2 }, "retrieval": { @@ -38611,9 +38720,9 @@ "projection": { "type": "retrieval-index", "schemaVersion": 1, - "contentHash": "dfe8567e4b2c7102037b95948d723b97b5d5c1297b819096c6de828102f48801", + "contentHash": "2353370e26856e5cd5ee47533c4399d3743a4079d8d7637101f20262bc0cfd15", "contentHashAlgo": "sha256-semantic-v1", - "snapshotHash": "834617fa48b0946678f330675f0d97a43b7f6e43ec0020d9e65b42ac983b2cf2", + "snapshotHash": "df203c6fe60d6de6d26c9eca0241d0e3ca69e781f0d651c33683f57b448e338e", "overlayHash": "f99666ff9119084dd25c2974ae64eb6935ec2aa785ff5ad478fb9d541f7a5e94", "configurationHash": "d80c82274083d35277566814974f568159fa9b1442b2a41ee0931a2620d4f4a3", "lexiconVersion": 1, @@ -38633,7 +38742,7 @@ }, "lexical": { "version": 1, - "documentCount": 2518, + "documentCount": 2525, "fieldNames": [ "aliases", "body", @@ -38644,13 +38753,13 @@ "title" ], "averageFieldLength": { - "aliases": 3.015488482922955, - "body": 61.772041302621126, - "headings": 4.016679904686259, - "path": 7.611993645750596, - "summary": 4.5472597299444, - "symbols": 7.505957108816521, - "title": 3.3788721207307386 + "aliases": 3.0154455445544555, + "body": 61.715643564356434, + "headings": 4.009108910891089, + "path": 7.614257425742574, + "summary": 4.541782178217821, + "symbols": 7.50059405940594, + "title": 3.3786138613861385 } }, "entries": [ @@ -39046,7 +39155,7 @@ ], "outbound": [] }, - "contentHash": "db16d6e6aedd39af524b30cbbe07bf8224cfd08aecf940c59a6abe88485a2b25", + "contentHash": "424c0ef4d5090a15f978d863a7b95ef0d7d552fba5a9a2682b18e26750b1a371", "provenance": "observed", "confidence": "observed" }, @@ -42277,7 +42386,7 @@ } ] }, - "contentHash": "13a5b8c2a23d497ac70a65b60c5e96c6a2d6b5e302b7d88d6479b30d00815b20", + "contentHash": "b5edb3458cfc22b1e67ef4450738de258f59716919b26fb97da8c042816962bf", "provenance": "observed", "confidence": "observed" }, @@ -66690,6 +66799,39 @@ "provenance": "observed", "confidence": "observed" }, + { + "id": "document:apps/docs-next/content/docs/use-cases/repo-docs.mdx", + "kind": "document", + "path": "apps/docs-next/content/docs/use-cases/repo-docs.mdx", + "title": "repo-docs.mdx", + "summary": "Coding agents guess when repository docs are written only for humans. They edit the sibling package, run the wrong test, or miss the guide that already explains the rule.", + "audience": "human", + "aliases": [], + "tags": [ + "document", + "human" + ], + "fields": { + "title": "repo-docs.mdx", + "headings": "When to use it Install and first commands Connect coding agents over MCP Related", + "path": "apps/docs-next/content/docs/use-cases/repo-docs.mdx", + "symbols": "", + "summary": "Coding agents guess when repository docs are written only for humans. They edit the sibling package, run the wrong test, or miss the guide that already explains the rule.", + "body": "Coding agents guess when repository docs are written only for humans. They edit the sibling package, run the wrong test, or miss the guide that already explains the rule. turns your existing docs into a deterministic index. For a package or area, it returns a handoff with the file to read first, the roots the agent may edit, the checks that prove the change, and the human doc for the same area. When to use it - Your repository has human docs (Fumadocs, Docusaurus, VitePress, Starlight, Nextra, or plain Markdown) and agents keep ignoring them. - You want agents to resolve ownership before they edit a package. - You want stale-index and broken human-guide-link gates in CI. The deterministic layer needs no LLM and no API key. Optional LLM remediation and chat are separate, opt-in features. Install and first commands Requires Node 22 or newer. The starter handoff proves the wiring, not real ownership. Replace the generated example with your repository's edit roots and checks, reindex, then query your real package. The full setup is in the . Useful follow-ups: Connect coding agents over MCP Add the ak-docs server to your MCP client (Cursor, Claude Desktop, or any MCP-compatible agent) from the repository root: Agents can then call handoff.resolve before editing, doc.search and doc.get to read indexed docs, and gate.status to check freshness. Run npx ak-docs index before starting the server in a fresh checkout and after doc changes. Related - - -", + "aliases": "document human" + }, + "graph": { + "pagerank": 0, + "inboundLinks": 0, + "coveredBy": [], + "mentionedBy": [], + "inbound": [], + "outbound": [] + }, + "contentHash": "e2e81af76dd0f19afde9c1a651b47b67edd3e98d36f1c8b751e2c0f4f5500d00", + "provenance": "observed", + "confidence": "observed" + }, { "id": "document:apps/docs-next/content/docs/use-cases/research-agent.mdx", "kind": "document", @@ -66903,7 +67045,7 @@ "path": "apps/docs-next/README.md", "symbols": "", "summary": "Profile: public-app", - "body": "docs-next Profile: public-app", - "body": "landing Profile: