@agentskit/doc-bridge 1.3.0 → 1.4.0

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # Changelog
 
+## 1.4.0
+
+### Minor Changes
+
+- 14a9075: Add a portable, fail-closed Doc Bridge handoff skill with a zero-credential resolver and synthetic compatibility fixture for Agent Skills runtimes.
+
+### Patch Changes
+
+- 5133bda: Expose the portable Doc Bridge handoff skill as a discoverable Pi package.
+- 14a9075: Add a Cursor plugin manifest, pinned MCP configuration, and handoff skill.
+
 ## 1.3.0
 
 ### Minor Changes

package/README.md

@@ -116,7 +116,7 @@ Using Cline? Follow the deterministic [`llms-install.md`](llms-install.md) setup
 |---------|------------|--------------------|
 | **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.2.1` |
+| **GitHub Action / CI** | Fail stale indexes and broken human-doc links on PRs | `AgentsKit-io/doc-bridge@v1.3.0` |
 | **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`, `vitepress`, `starlight`, `nextra`, `plain-markdown` |
 | **Monorepo routing** | Discover workspaces and checks | `pnpm-monorepo`, `nx` |
@@ -125,6 +125,26 @@ Using Cline? Follow the deterministic [`llms-install.md`](llms-install.md) setup
 
 See [docs/getting-started.md](docs/getting-started.md), [docs/mcp.md](docs/mcp.md), and [docs/examples.md](docs/examples.md).
 
+### Cursor plugin
+
+This repository also contains a Cursor plugin that pairs the read-only Doc Bridge MCP server with a handoff skill. It resolves `startHere`, `readBeforeEditing`, `editRoots`, and `checks` before Cursor edits a routed repository. The plugin does not request credentials or write project files through MCP.
+
+### Portable Agent Skill
+
+[`skills/doc-bridge-handoff`](skills/doc-bridge-handoff) packages the same fail-closed routing contract in the open Agent Skills layout for OpenClaw-compatible clients, Hermes Agent, Pi, Cursor, and other runtimes that can execute a local skill script. The skill prefers the read-only MCP tool and falls back to a pinned, zero-credential CLI resolver. It never edits files, runs returned checks, or grants authority outside `editRoots`.
+
+Install the published skill from [ClawHub](https://clawhub.ai/emersonbraun/skills/doc-bridge-handoff):
+
+```bash
+clawhub install doc-bridge-handoff
+```
+
+Pi users can install the same source-owned skill through the npm package:
+
+```bash
+pi install npm:@agentskit/doc-bridge
+```
+
 ## Claude Desktop MCP Bundle
 
 Doc Bridge can be packaged as a local MCP Bundle for Claude Desktop. The bundle keeps the eight MCP tools read-only and asks the user to select the repository's `doc-bridge.config.json`; that file defines the project boundary Doc Bridge may read.
@@ -226,7 +246,7 @@ permissions:
 
 steps:
   - uses: actions/checkout@v4
-  - uses: AgentsKit-io/doc-bridge@v1.2.1
+  - uses: AgentsKit-io/doc-bridge@v1.3.0
     with:
       config-path: doc-bridge.config.json
 ```
@@ -312,7 +332,7 @@ ak-docs memory promote --pr              # opens draft PR via gh
 
 ## Status
 
-**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.
+**v1.3.0 stable** — deterministic Documentation Standard v1 conformance, VitePress, Starlight, Nextra, and Nx discovery, verified release provenance, Marketplace Action, doctor + CI + skill, and full Tier A/B/C.
 
 ```bash
 pnpm install && pnpm build && pnpm test

package/action.yml

@@ -20,7 +20,7 @@ inputs:
   package-version:
     description: Exact @agentskit/doc-bridge npm version (kept in sync with this Action release)
     required: false
-    default: '1.3.0'
+    default: '1.4.0'
 
 runs:
   using: composite

package/dist/cli/program.js

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