From d3ecd047183ef9222ba3dd3082f38443ba0c7b94 Mon Sep 17 00:00:00 2001 From: ScriptedAlchemy Date: Mon, 31 Aug 2026 06:23:15 +0000 Subject: [PATCH 1/2] docs(examples/audiobook-curator): repo-root launcher opener, mcp run section, and canonical check chain The only example shipping an MCP server never documented `mcp run`, never mentioned its root `pnpm example:audiobook` launcher, and narrated deleted files in its maintainer notes. Adds the shared repo-root opener the other product examples carry, mirrors the canonical `mcp run` doc flow from examples/mcp-app for the `curator` server, prunes the refactor-archaeology sentence (keeping the entry-conventions link), and aligns `check` to the canonical `validate && build && typecheck && test` chain. --- examples/audiobook-curator/README.md | 28 +++++++++++++++++++------ examples/audiobook-curator/package.json | 2 +- 2 files changed, 23 insertions(+), 7 deletions(-) diff --git a/examples/audiobook-curator/README.md b/examples/audiobook-curator/README.md index 010737c73..6ddb92028 100644 --- a/examples/audiobook-curator/README.md +++ b/examples/audiobook-curator/README.md @@ -1,5 +1,11 @@ # Audiobook Curator +From the repository root, launch this example with: + +```bash +pnpm example:audiobook +``` + A complete TypeScript recreation of the original `audiobook-curator`, authored as one React Server Component plugin application. The same typed operation tree produces a globally installable CLI, one stdio MCP server, one Skill, and native @@ -87,6 +93,20 @@ The original thirteen commands are present: operation also has an MCP tool with the same implementation and result renderer; run `audiobook-curator --help` for exact CLI forms. +## Run the MCP server + +Run the built `curator` server in the foreground on stdio: + +```bash +pnpm exec agent-bundle mcp run --server curator --target claude +``` + +The command resolves the generated entry from the Claude target's MCP +manifest, building a temporary artifact first; pass `--artifact artifact` to +reuse the `pnpm build` output instead. Closing stdin exits 0 and Ctrl-C +exits 130, and per-server state persists under +`.agent-bundle/mcp-run/claude/curator`. + ## Safety Sources are immutable. Planning never mutates media. Conversion publishes a @@ -106,9 +126,5 @@ This example is the reference consumer of the framework-owned package build ("one config, agent-bundle owns the build"): `agent-bundle.config.ts` is a pure pass-through of the RSC application's config, and the `src/cli.ts` / `src/index.ts` conventions provide the npm bin and library outputs under -`dist/`. The former second bundler config (`rslib.config.ts`), its -`tsconfig.build.json`, the hand-written `bin/audiobook-curator.js` shim, the -self-executing `src/cli-entry.ts`, and the dual `build:cli`/`build:bundle` -script chain were all deleted when the framework took ownership. See -[`docs/entry-conventions.md`](../../docs/entry-conventions.md) for the -contract. +`dist/`. See [`docs/entry-conventions.md`](../../docs/entry-conventions.md) +for the contract. diff --git a/examples/audiobook-curator/package.json b/examples/audiobook-curator/package.json index e8643ca2a..681802341 100644 --- a/examples/audiobook-curator/package.json +++ b/examples/audiobook-curator/package.json @@ -22,7 +22,7 @@ }, "scripts": { "build": "agent-bundle build --json --output artifact", - "check": "pnpm test && pnpm typecheck && pnpm build", + "check": "pnpm validate && pnpm build && pnpm typecheck && pnpm test", "dev": "agent-bundle dev", "test": "rstest tests", "typecheck": "tsc -p tsconfig.json --noEmit", From 0a42af400817dc79bbae84a79358b41999238b9e Mon Sep 17 00:00:00 2001 From: ScriptedAlchemy Date: Mon, 31 Aug 2026 06:27:32 +0000 Subject: [PATCH 2/2] docs(examples/audiobook-curator): anchor the mcp run snippet to the example directory --- examples/audiobook-curator/README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/examples/audiobook-curator/README.md b/examples/audiobook-curator/README.md index 6ddb92028..1aac54d78 100644 --- a/examples/audiobook-curator/README.md +++ b/examples/audiobook-curator/README.md @@ -95,9 +95,11 @@ run `audiobook-curator --help` for exact CLI forms. ## Run the MCP server -Run the built `curator` server in the foreground on stdio: +From this example's directory, run the built `curator` server in the +foreground on stdio: ```bash +cd examples/audiobook-curator pnpm exec agent-bundle mcp run --server curator --target claude ```