lotus-wisdom-mcp 0.7.1 → 0.8.1

package/README.md

@@ -6,14 +6,18 @@
 
 An MCP server implementation that provides a tool for problem-solving using the Lotus Sutra's wisdom framework, combining analytical thinking with intuitive wisdom.
 
+Available at: https://lotus-wisdom-mcp.linxule.workers.dev/mcp
+
 ## Features
 
 * Multi-faceted problem-solving approach inspired by the Lotus Sutra
 * Step-by-step thought process with different thinking techniques
 * Meditation pauses to allow insights to emerge naturally
-* **Interactive visualization** via MCP ext-apps (Claude Desktop, Cursor, ChatGPT)
-* Beautifully formatted thought process visualization with colors and symbols
+* **Interactive visualization** via MCP ext-apps (Claude Desktop, Cursor, ChatGPT) — adapts to the host light/dark theme and is keyboard-accessible
+* **MCP Prompts** (`contemplate`, `deep-inquiry`) for one-step guided contemplative sessions
+* **Structured tool output** (`structuredContent` + `outputSchema`) alongside the text response
 * Tracks both tag journey and wisdom domain movements
+* Available as a local stdio package (`npx`) or a hosted remote Connector
 * Final integration of insights into a clear response
 
 ## Background
@@ -50,15 +54,13 @@ The server organizes thoughts using wisdom domains (all valid values for the `ta
 
 ### Thought Visualization
 
-Each thought is beautifully formatted with:
+In clients that support MCP ext-apps, each step renders inline as an interactive "Living Trace" (see [Interactive Visualization](#interactive-visualization-ext-apps) below). For every client, each step also returns:
 
-* Colorful output using the chalk library
-* Domain-specific symbols and colors
-* Box-drawing characters to create clear thought boundaries
-* Special meditation formatting with pause indicators
-* Journey tracking showing both tag path and domain movements
+* Journey tracking showing both the tag path and the wisdom-domain movements
+* Domain-specific labels and the current contemplation text
+* Structured output (`structuredContent` + `outputSchema`) for programmatic consumers
 
-Note: The visualization appears in the server console output, helping developers track the thinking process.
+Note: The local stdio server can emit per-step trace lines to its console (stderr) when run with `LOTUS_DEBUG=true`, helping developers follow the thinking process.
 
 ### Process Flow
 
@@ -88,23 +90,36 @@ A tool for problem-solving using the Lotus Sutra's wisdom framework, with variou
 * `nextStepNeeded` (boolean, required): Whether another step is needed
 * `isMeditation` (boolean, optional): Whether this step is a meditative pause
 * `meditationDuration` (integer, optional): Duration for meditation in seconds (1-10)
+* `previousJourney` (string, optional): The `journey` string from a previous response, e.g. `"begin → open → examine"`. Lets the AI carry journey continuity forward in stateless clients (such as the remote Worker), where the server keeps no session state.
 
-**Returns:**
+**Returns:** both a JSON text block and matching `structuredContent` (validated against the tool's `outputSchema`):
 - Processing status with current step information, wisdom domain, and journey tracking
+- `FRAMEWORK_RECEIVED` status (with the full framework) on the first `begin` step
 - `MEDITATION_COMPLETE` status for meditation steps
 - `WISDOM_READY` status when the contemplative process is complete
 
+The tool also declares behavioral annotations — `readOnlyHint`, `idempotentHint`, `destructiveHint: false`, `openWorldHint: false` — so hosts can treat it as a safe, side-effect-free call.
+
 ### lotuswisdom_summary
 
 Get a summary of the current contemplative journey.
 
-**Inputs:** None
+**Inputs:**
+
+* `previousJourney` (string, optional): The `journey` string from a previous response, used to reconstruct the summary in stateless clients.
 
 **Returns:**
 - Journey length
 - Domain journey showing movement between wisdom domains
 - Summary of all steps with their tags, domains, and brief content
 
+## MCP Prompts
+
+The server registers two prompts that scaffold a guided contemplative session (surfaced as slash commands or prompt pickers in clients that support MCP Prompts):
+
+* **`contemplate`** — argument `question`: opens a single-question contemplation, instructing the model to start with `tag='begin'`, iterate, and speak the wisdom only once `status='WISDOM_READY'`.
+* **`deep-inquiry`** — argument `topic`: begins a longer inquiry that moves deliberately across the wisdom domains (process → meta-cognitive → non-dual → meditation).
+
 ## Usage
 
 The Lotus Wisdom tool is designed for:
@@ -196,9 +211,9 @@ When the tool returns `status: 'WISDOM_READY'`, Claude then speaks the final wis
 
 ## Installation
 
-[![Smithery Badge](https://smithery.ai/badge/lotus-wisdom-mcp)](https://smithery.ai/server/lotus-wisdom-mcp)
+[![Smithery Badge](https://smithery.ai/badge/@linxule/lotus-wisdom-mcp)](https://smithery.ai/server/@linxule/lotus-wisdom-mcp)
 
-Install via [Smithery](https://smithery.ai/server/lotus-wisdom-mcp) for one-click setup, or follow the manual instructions below.
+Install via [Smithery](https://smithery.ai/server/@linxule/lotus-wisdom-mcp) for one-click setup, or follow the manual instructions below.
 
 Requires [Node.js](https://nodejs.org/) 18+. The server runs locally via `npx`.
 
@@ -362,7 +377,7 @@ codex mcp add lotus-wisdom -- cmd /c npx -y lotus-wisdom-mcp
 
 ### ChatGPT
 
-ChatGPT only supports remote MCP servers over HTTPS. Use [Smithery](https://smithery.ai/server/lotus-wisdom-mcp) or connect directly to the hosted instance below via ChatGPT Settings > Connectors.
+ChatGPT only supports remote MCP servers over HTTPS. Use [Smithery](https://smithery.ai/server/@linxule/lotus-wisdom-mcp) or connect directly to the hosted instance below via ChatGPT Settings > Connectors.
 
 ### Remote (hosted)
 
@@ -385,12 +400,26 @@ To self-host your own instance, see [`worker/README.md`](worker/README.md).
 
 ### Building from source
 
+Use Bun 1.4.2 and Node.js 24 to match CI.
+
 ```bash
-bun install
+bun install --frozen-lockfile
+bun run typecheck
+bun run test
 bun run build
 bun run start
 ```
 
+The build installs the app's locked dependencies and rebuilds the tracked
+`dist/bundle.js` and `dist/journey.html` artifacts. Check app types with
+`cd app && bunx tsc --noEmit`; see [worker validation](worker/README.md#local-dev)
+for the worker typecheck, dry-run build, and local HTTP regression.
+
+Dependabot uses the `bun` ecosystem for the root, app, and worker packages so
+updates include their `bun.lock` files. CI verifies all three packages on pull
+requests. Merging a PR updates source only: a version tag publishes to npm and
+the MCP Registry, and the Cloudflare Worker requires a separate deployment.
+
 Enable debug mode:
 
 ```bash
@@ -449,7 +478,41 @@ Contributions are welcome! Please feel free to submit issues or pull requests on
 
 ## Version
 
-Current version: 0.4.0
+Current version: 0.8.1
+
+### What's New in 0.8.1
+
+- Updated dependencies and GitHub Actions, regenerated Bun lockfiles, and added
+  app and worker validation to CI.
+- Updated vulnerable transitive dependencies across all three packages and added
+  dependency audits to CI. The release candidate passes all three Bun audits.
+- Migrated the visualization to ext-apps 2 with its MCP client v2 and Zod 4
+  dependencies. The server transports remain on MCP SDK v1; the worker uses
+  the agents SDK's explicit compatibility handler and retains stateless JSON
+  responses.
+
+### What's New in 0.8.0
+
+- **Single source of truth**: domain logic, tool/server metadata, prompts, and the client parser now live in `src/shared/` and are imported by both the stdio entry (`index.ts`) and the Cloudflare Worker — no more local-vs-remote drift
+- **High-level `McpServer` everywhere**: the local stdio server was migrated from the low-level `Server` API to `McpServer`, matching the Worker
+- **MCP Prompts**: `contemplate` and `deep-inquiry` for guided contemplative sessions
+- **Structured tool output**: tools now return `structuredContent` validated against an `outputSchema`, plus behavioral annotations (`readOnlyHint`, `idempotentHint`, `destructiveHint: false`, `openWorldHint: false`) and a server `instructions` field
+- **Theme-aware, accessible UI**: the ext-apps journey visualization adapts to the host light/dark theme and is keyboard-accessible
+- **Security & cleanup**: `@modelcontextprotocol/sdk` bumped to `^1.27.1`, `zod` added, `chalk` removed; the legacy Express SSE server (`server.ts`), the `express` deps, and the `Dockerfile` were removed; the repo moved to bun lockfiles. Added a vitest test suite (`tests/`) and a single-source version workflow (`src/shared/version.ts` + `bun run sync-version`)
+- **Server icon & website**: `server.json` advertises the remote Worker (`remotes[]`), a `websiteUrl`, and icon `sizes`; the Worker advertises icons/website in the initialize handshake and serves the icon as same-origin bytes at `/icon.png`
+
+### What's New in 0.7.0
+
+- **Fully stateless Worker**: removed the Durable Object — the remote Worker now creates a fresh server per request and relies on the client-driven `previousJourney` parameter for journey continuity (eliminating accumulated SSE wall time)
+
+### What's New in 0.6.0
+
+- **Server icon**: added an icon to `server.json` and the Worker so MCP Registry and claude.ai Connectors display the lotus logo
+- **Warmer UI** and (since reverted) experimental Durable Object session state
+
+### What's New in 0.5.0
+
+- **npm + MCP Registry publish**: hardened packaging and published to npm and the official MCP Registry
 
 ### What's New in 0.4.0
 
@@ -486,4 +549,4 @@ Current version: 0.4.0
 - 🔄 **Dual Transport**: Maintains stdio support for npm/CLI users while adding HTTP for remote deployment
 - 📦 **Updated SDK**: Upgraded to @modelcontextprotocol/sdk 1.20.1 with Streamable HTTP support
 - 🪷 **New Logo**: Terminal-aesthetic lotus logo perfect for developer tools
-- ⚡ **Session Management**: HTTP version includes full session management for stateful wisdom journeys
+- ⚡ **Session Management**: HTTP version includes full session management for stateful wisdom journeys