@agentskit/doc-bridge 1.2.6 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +8 -0
- package/README.md +9 -3
- package/action.yml +1 -1
- package/dist/cli/program.js +344 -130
- package/dist/cli/program.js.map +1 -1
- package/dist/config/index.d.ts +1 -1
- package/dist/config/index.js +3 -1
- package/dist/config/index.js.map +1 -1
- package/dist/{index-DGI9TBLE.d.ts → index-DAeq_OIi.d.ts} +22 -22
- package/dist/index.d.ts +7 -4
- package/dist/index.js +320 -105
- package/dist/index.js.map +1 -1
- package/docs/POSITIONING.md +1 -1
- package/docs/examples.md +4 -0
- package/docs/getting-started.md +1 -1
- package/docs/landing/index.html +1 -1
- package/docs/qa/vitepress-starlight-adapters.md +19 -0
- package/docs/spec/config-v1.md +33 -2
- package/examples/nextra-only.config.ts +17 -0
- package/examples/nx-monorepo.config.ts +11 -0
- package/examples/starlight-only.config.ts +17 -0
- package/examples/vitepress-only.config.ts +19 -0
- package/mcpb/manifest.json +1 -1
- package/package.json +4 -2
- package/src/config/schema.ts +3 -1
- package/src/index-builder/build-handoffs.ts +2 -0
- package/src/index-builder/build-index.ts +7 -1
- package/src/index-builder/human-adapters/index.ts +6 -0
- package/src/index-builder/human-adapters/nextra.ts +43 -0
- package/src/index-builder/human-adapters/starlight.ts +40 -0
- package/src/index-builder/human-adapters/vitepress.ts +43 -0
- package/src/index-builder/plugins/nx.ts +161 -0
- package/src/index-builder/plugins/pnpm-monorepo.ts +1 -0
- package/src/index-builder/watch-index.ts +11 -2
- package/src/index.ts +1 -0
- package/src/version.ts +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,13 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 1.3.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- 319605e: Add read-only Nx project inference for Doc Bridge ownership, handoffs, and available test and lint checks.
|
|
8
|
+
- e0db193: Add first-party VitePress and Astro Starlight human-documentation adapters.
|
|
9
|
+
- 03c17bc: Add a first-party Nextra human-documentation adapter for deterministic content-directory routes.
|
|
10
|
+
|
|
3
11
|
## 1.2.6
|
|
4
12
|
|
|
5
13
|
### Patch Changes
|
package/README.md
CHANGED
|
@@ -106,6 +106,8 @@ npx ak-docs query package example --agent
|
|
|
106
106
|
ak-docs mcp install --cursor # wires MCP into .cursor/mcp.json
|
|
107
107
|
```
|
|
108
108
|
|
|
109
|
+
Using Cline? Follow the deterministic [`llms-install.md`](llms-install.md) setup. It runs the pinned MCP server through `pnpm dlx` without adding Doc Bridge to your repository dependencies.
|
|
110
|
+
|
|
109
111
|
## What ships
|
|
110
112
|
|
|
111
113
|
|
|
@@ -116,8 +118,8 @@ ak-docs mcp install --cursor # wires MCP into .cursor/mcp.json
|
|
|
116
118
|
| **MCP server** | Let Cursor, Claude Code, Codex-style agents resolve handoffs before editing | `ak-docs mcp`, `handoff.resolve` |
|
|
117
119
|
| **GitHub Action / CI** | Fail stale indexes and broken human-doc links on PRs | `AgentsKit-io/doc-bridge@v1.2.1` |
|
|
118
120
|
| **Documentation conformance** | Check the stable ecosystem standard with auditable evidence | `ak-docs conformance run documentation-standard-v1 --text` |
|
|
119
|
-
| **Doc adapters** | Link human docs to agent docs | `fumadocs`, `docusaurus`, `plain-markdown` |
|
|
120
|
-
| **Monorepo routing** | Discover workspaces and checks | `pnpm-monorepo` |
|
|
121
|
+
| **Doc adapters** | Link human docs to agent docs | `fumadocs`, `docusaurus`, `vitepress`, `starlight`, `nextra`, `plain-markdown` |
|
|
122
|
+
| **Monorepo routing** | Discover workspaces and checks | `pnpm-monorepo`, `nx` |
|
|
121
123
|
| **Memory pipeline** | Turn agent notes into reviewable documentation drafts | `memory ingest`, `classify`, `promote --pr` |
|
|
122
124
|
| **Optional RAG/chat** | Ground chat in the same handoff-first index | `@agentskit/rag`, `@agentskit/ink`, `ak-docs chat` |
|
|
123
125
|
|
|
@@ -255,7 +257,7 @@ Gate fails with `Index is stale. Run: ak-docs index` — same check in CI annota
|
|
|
255
257
|
| **CLI** | `query` / `search` / `list` / `ask` / `gate` / `memory` / `bootstrap` |
|
|
256
258
|
| **MCP** | `handoff.resolve`, `doc.search`, `doc.get`, `gate.status`, … |
|
|
257
259
|
| **Gates** | Freshness, human-link validation, optional OKF style |
|
|
258
|
-
| **Adapters** | `pnpm-monorepo`, `fumadocs`, `docusaurus`, `plain-markdown` |
|
|
260
|
+
| **Adapters** | `pnpm-monorepo`, `nx`, `fumadocs`, `docusaurus`, `vitepress`, `starlight`, `nextra`, `plain-markdown` |
|
|
259
261
|
|
|
260
262
|
### Optional AgentsKit peers
|
|
261
263
|
|
|
@@ -290,8 +292,12 @@ Designed for and dogfooded on open AgentsKit surfaces:
|
|
|
290
292
|
|---------|---------|
|
|
291
293
|
| Solo markdown | [`examples/minimal-plain-markdown.config.ts`](examples/minimal-plain-markdown.config.ts) |
|
|
292
294
|
| pnpm monorepo | [`examples/pnpm-monorepo.config.ts`](examples/pnpm-monorepo.config.ts) |
|
|
295
|
+
| Nx monorepo | [`examples/nx-monorepo.config.ts`](examples/nx-monorepo.config.ts) |
|
|
293
296
|
| Demo monorepo | [`examples/demo-monorepo/`](examples/demo-monorepo/) |
|
|
294
297
|
| Fumadocs + chat | [`examples/fumadocs-with-chat.config.ts`](examples/fumadocs-with-chat.config.ts) |
|
|
298
|
+
| VitePress | [`examples/vitepress-only.config.ts`](examples/vitepress-only.config.ts) |
|
|
299
|
+
| Astro Starlight | [`examples/starlight-only.config.ts`](examples/starlight-only.config.ts) |
|
|
300
|
+
| Nextra | [`examples/nextra-only.config.ts`](examples/nextra-only.config.ts) |
|
|
295
301
|
|
|
296
302
|
Contract: [`docs/spec/config-v1.md`](docs/spec/config-v1.md) · CLI: [`docs/spec/cli.md`](docs/spec/cli.md) · MCP: [`docs/mcp.md`](docs/mcp.md) · Skill: [`docs/skills/doc-bridge.md`](docs/skills/doc-bridge.md) · Pattern: [`docs/playbook/doc-bridge-pattern.md`](docs/playbook/doc-bridge-pattern.md) · Recipes: [`docs/recipes/index-pipeline.md`](docs/recipes/index-pipeline.md)
|
|
297
303
|
|