@terreno/mcp 57.2.0 → 57.4.0

package/README.md

@@ -1,6 +1,6 @@
 # @terreno/mcp
 
-MCP (Model Context Protocol) server for Terreno. Provides documentation, tools, and prompts for building full-stack applications with Terreno packages.
+MCP server for Terreno - provides documentation, tools, and prompts for building full-stack apps.
 
 ## Features
 
@@ -18,7 +18,12 @@ Documentation resources accessible via MCP:
 
 Code generation tools:
 
-- `terreno_bootstrap_app` - Scaffold a new full-stack Terreno app (frontend, backend, rules, MCP)
+- `terreno_search_docs` - Search bundled Terreno documentation (call before guessing APIs). Optional `version` selects a retained docs snapshot; omit for current `next` docs.
+- `terreno_get_component_docs` - Full `@terreno/ui` props table for one component
+- `terreno_get_upgrade_guide` - Lockstep upgrade notes between two `@terreno/*` versions
+- `terreno_search_update_notes` - Search bundled upgrade markdown and optional backend announcement help API
+- `terreno_get_update_note` - Fetch one full update note by id (`upgrade:<semver>` or `announcement:<mongoId>`)
+- `terreno_ask_update_help` - Ask a natural-language question; returns ranked matches with full update bodies
 - `terreno_bootstrap_ai_rules` - Scaffold AI assistant rules files for Cursor, Claude Code, etc.
 - `terreno_generate_model` - Generate a Mongoose model with proper Terreno conventions
 - `terreno_generate_route` - Generate a modelRouter route configuration
@@ -39,8 +44,9 @@ Code generation prompts:
 - `terreno_add_authentication` - Generate authentication setup
 - `terreno_migrate_to_terreno_app` - Migrate from setupServer to TerrenoApp pattern
 - `terreno_style_guide` - Get the Terreno code style guide
+- `terreno_upgrade` - Lockstep Terreno upgrade workflow
 
-## Installation
+## Install
 
 ```bash
 # From the monorepo root
@@ -80,6 +86,10 @@ Add to your project's `.claude/settings.json`:
 }
 ```
 
+### Update help (optional)
+
+When `TERRENO_HELP_API_URL` points at a Terreno backend with `AnnouncementsApp({help: {enabled: true}})`, the update-note tools also search live product announcements (published by default; pass `includeArchived: true` for archived notes). Set `TERRENO_HELP_API_TOKEN` when the help routes require authentication.
+
 ## Development
 
 ```bash
@@ -265,3 +275,11 @@ This will generate a comprehensive prompt with instructions for creating:
 - Backend model with proper schema
 - API routes with permissions
 - Frontend list, detail, and form screens
+
+## Documentation
+
+Full API reference: [docs/reference/mcp-server.md](https://github.com/flourishhealth/terreno/blob/master/docs/reference/mcp-server.md)
+
+## License and Contributing
+
+Licensed under the [MIT License](https://github.com/flourishhealth/terreno/blob/master/LICENSE). See [CONTRIBUTING.md](https://github.com/flourishhealth/terreno/blob/master/CONTRIBUTING.md) for contribution guidelines.

package/dist/bootstrap.d.ts

@@ -1,23 +1,5 @@
 import type { Tool } from "@modelcontextprotocol/server";
-/** Pinned so `npx -y` does not resolve a moving `@latest` target in generated MCP configs. */
-export declare const PLAYWRIGHT_MCP_PACKAGE_VERSION = "0.0.76";
 export declare const bootstrapTools: Tool[];
-interface BootstrapArgs {
-    appName: string;
-    appDisplayName: string;
-    description?: string;
-    mcpServerUrl?: string;
-}
-export interface BootstrapAiRulesArgs extends BootstrapArgs {
-    /** Optional `@terreno/*` package ids to include (e.g. `["api","ui"]`). Omits others from merged guidelines. */
-    packages?: string[];
-}
-export declare const handleBootstrapAiRulesToolCall: (args: Record<string, unknown>) => {
-    content: Array<{
-        type: "text";
-        text: string;
-    }>;
-};
 export declare const handleBootstrapToolCall: (name: string, args: Record<string, unknown>) => {
     content: Array<{
         type: "text";

package/dist/bootstrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,8BAA8B,CAAC;AAUvD,8FAA8F;AAC9F,eAAO,MAAM,8BAA8B,WAAW,CAAC;AAEvD,eAAO,MAAM,cAAc,EAAE,IAAI,EA4DhC,CAAC;AAEF,UAAU,aAAa;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,+GAA+G;IAC/G,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AA41ED,eAAO,MAAM,8BAA8B,GACzC,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B;IAAC,OAAO,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CA4E/C,CAAC;AAqIF,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B;IAAC,OAAO,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CA4H/C,CAAC;AAGF,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,eAAO,MAAM,gBAAgB,EAAE,eAAe,EAkB7C,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B;IAAC,QAAQ,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAA;KAAC,CAAC,CAAA;CAiEzE,CAAC"}
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../src/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,IAAI,EAAC,MAAM,8BAA8B,CAAC;AAgBvD,eAAO,MAAM,cAAc,EAAE,IAAI,EA+BhC,CAAC;AAwcF,eAAO,MAAM,uBAAuB,GAClC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B;IAAC,OAAO,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAC,CAAC,CAAA;CAQ/C,CAAC;AAGF,UAAU,eAAe;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,eAAO,MAAM,gBAAgB,EAAE,eAAe,EAkB7C,CAAC;AAEF,eAAO,MAAM,4BAA4B,GACvC,MAAM,MAAM,EACZ,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC3B;IAAC,QAAQ,EAAE,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAA;KAAC,CAAC,CAAA;CA8DzE,CAAC"}