@venlyfinance/settlement-mcp 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -100,3 +100,7 @@ Frontend toolset: the judgment layer for interface assembly.
 ### Removed
 
 - **`stage_transfer`**, as promised in 0.3.0's deprecation: use `create_fiat_transfer`, whose inputs match the OpenAPI contract directly. The skills pack is updated accordingly.
+
+## 0.4.1 – 2026-08-07
+
+- `venly://frontend/agents` now carries the full cold-start recipe, learned from a fresh-agent build run: Tailwind + path-alias prerequisites before `shadcn init`, the non-interactive `-y -b radix -p nova` flags, that blocks land under `components/venly/` at the project root (relative imports, not the `@/` alias), that `shadcn add` auto-installs the npm dependencies, and the `.js`-extension bundler note.

package/dist/constants.d.ts

@@ -1,7 +1,7 @@
 /** Shared constants. The default environment is MOCK so an unconfigured run
  * never touches real infrastructure; staging/production are explicit. */
 export declare const SERVER_NAME = "venly-finance-mcp-server";
-export declare const SERVER_VERSION = "0.4.0";
+export declare const SERVER_VERSION = "0.4.1";
 export declare const ENVIRONMENT_FLAG = "VENLY_ENV";
 export type VenlyEnvironment = "mock" | "staging" | "production";
 export declare function resolveVenlyEnvironment(env: Record<string, string | undefined>): VenlyEnvironment;

package/dist/constants.js

@@ -1,7 +1,7 @@
 /** Shared constants. The default environment is MOCK so an unconfigured run
  * never touches real infrastructure; staging/production are explicit. */
 export const SERVER_NAME = "venly-finance-mcp-server";
-export const SERVER_VERSION = "0.4.0";
+export const SERVER_VERSION = "0.4.1";
 export const ENVIRONMENT_FLAG = "VENLY_ENV";
 export function resolveVenlyEnvironment(env) {
     // Default is MOCK (since 0.3.0): the mock-first product must not point at

package/dist/frontend.js

@@ -94,11 +94,27 @@ export function reviewScreenSource(source) {
 }
 const AGENTS_TEXT = `# Composition rules for coding agents building on the Venly UI registry
 
-Delivery: add the registry once to components.json -
+Delivery: the shadcn CLI expects a working shadcn environment BEFORE any
+registry install. On a fresh Vite/React app that means, in order:
+1. Install Tailwind (\`npm i tailwindcss @tailwindcss/vite\`) and wire the
+   \`@/\` path alias in tsconfig + vite config - \`shadcn init\` refuses to
+   run without both.
+2. \`npx shadcn@latest init -y -b radix -p nova\` (the -b/-p flags keep it
+   non-interactive; the kit is plain React + Radix-compatible, so any base
+   works - it never imports base-library components itself).
+3. Add the registry once to components.json -
   { "registries": { "@venlyfinance": "${REGISTRY_URL_TEMPLATE}" } }
-then install blocks with the shadcn CLI, e.g. \`npx shadcn@latest add @venlyfinance/receive\`.
-Each block auto-installs its components, the venly-tokens file and the
-@venlyfinance/react data layer. Import tokens.css once at the app root.
+4. \`npx shadcn@latest add @venlyfinance/receive @venlyfinance/send @venlyfinance/activity -y -o\`.
+   Each block auto-installs its components, the venly-tokens file AND its
+   npm dependencies (@venlyfinance/react, @venlyfinance/sdk, TanStack
+   Query) - no separate npm install step is needed.
+
+Install layout: files land under \`components/venly/\` at the PROJECT ROOT
+(not src/), preserving their relative imports - import them with a relative
+path (e.g. \`../components/venly/blocks/receive.js\`), not the \`@/\` alias.
+The sources use TypeScript-style \`.js\` extensions on .tsx imports: fine
+under Vite/esbuild/Next; webpack needs \`extensionAlias\`. Import the
+installed venly-tokens css once at the app root.
 
 1. Never hand-roll API calls, auth, retries, or transfer state - every read
    is a hook, every regulated lifecycle is a flow machine from

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venlyfinance/settlement-mcp",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Venly Finance MCP: SDK-backed tools, resources and prompts for building international money products safely.",
   "type": "module",
   "bin": {