@jaypie/mcp 0.8.4 → 0.8.5

package/dist/suites/docs/index.js

@@ -9,7 +9,7 @@ import { gt } from 'semver';
 /**
  * Docs Suite - Documentation services (skill, version, release_notes)
  */
-const BUILD_VERSION_STRING = "@jaypie/mcp@0.8.4#71fb4b1f"
+const BUILD_VERSION_STRING = "@jaypie/mcp@0.8.5#68f73d91"
     ;
 const __filename$1 = fileURLToPath(import.meta.url);
 const __dirname$1 = path.dirname(__filename$1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaypie/mcp",
-  "version": "0.8.4",
+  "version": "0.8.5",
   "description": "Jaypie MCP",
   "repository": {
     "type": "git",

package/release-notes/constructs/1.2.37.md

@@ -0,0 +1,11 @@
+---
+version: 1.2.37
+date: 2026-03-27
+summary: Fix JaypieQueuedLambda environment prop forwarding
+---
+
+## Changes
+
+- Fix `JaypieQueuedLambda` silently dropping custom `environment` variables when using array syntax
+- Queue URL (`CDK_ENV_QUEUE_URL`) now added via `addEnvironment()` after construction instead of spreading into the environment object
+- Closes #252

package/release-notes/jaypie/1.2.26.md

@@ -0,0 +1,9 @@
+---
+version: 1.2.26
+date: 2026-03-27
+summary: Bump @jaypie/logger to 1.2.8 for configurable ddsource
+---
+
+## Changes
+
+- Updated `@jaypie/logger` dependency to `^1.2.8` for configurable `DD_SOURCE` env var support

package/release-notes/logger/1.2.8.md

@@ -0,0 +1,10 @@
+---
+version: 1.2.8
+date: 2026-03-27
+summary: Make DatadogTransport ddsource configurable via DD_SOURCE env var
+---
+
+## Changes
+
+- `DatadogTransport` now reads `DD_SOURCE` and `PROJECT_SOURCE` env vars to configure `ddsource` field (default remains `"nodejs"`)
+- Enables proper Datadog log pipeline routing for Lambda (`source:lambda`), ECS (`source:docker`), etc.

package/release-notes/mcp/0.8.5.md

@@ -0,0 +1,10 @@
+---
+version: 0.8.5
+date: 2026-03-27
+summary: Add migrations skill documenting JaypieMigration construct
+---
+
+## Changes
+
+- New `migrations` skill documenting `JaypieMigration` CDK construct
+- Added sync reminder for skill category listings in CLAUDE.md

package/skills/agents.md

@@ -34,7 +34,7 @@ Complete stack styles, techniques, and traditions.
 
 Contents: index, releasenotes
 Development: apikey, documentation, errors, llm, logs, mocks, monorepo, style, subpackages, tests, tools
-Infrastructure: aws, cdk, cicd, datadog, dns, dynamodb, express, lambda, secrets, streaming, variables, websockets
+Infrastructure: aws, cdk, cicd, datadog, dns, dynamodb, express, lambda, migrations, secrets, streaming, variables, websockets
 Patterns: api, fabric, handlers, models, services, vocabulary
 Recipes: recipe-api-server
 Meta: issues, jaypie, mcp, skills

package/skills/cdk.md

@@ -1,6 +1,6 @@
 ---
 description: CDK constructs and deployment patterns
-related: apikey, aws, cicd, dynamodb, express, lambda, secrets, streaming, websockets
+related: apikey, aws, cicd, dynamodb, express, lambda, migrations, secrets, streaming, websockets
 ---
 
 # CDK Constructs

package/skills/infrastructure.md

@@ -20,6 +20,7 @@ Cloud infrastructure and deployment patterns.
 | `datadog` | Datadog and observability |
 | `dns` | DNS and domain configuration |
 | `dynamodb` | DynamoDB patterns and queries |
+| `migrations` | DynamoDB migration custom resources |
 | `secrets` | AWS Secrets Manager |
 | `variables` | Environment variables reference |
 | `websockets` | WebSocket API Gateway constructs |

package/skills/migrations.md

@@ -0,0 +1,121 @@
+---
+description: DynamoDB migration custom resources that run on every CDK deploy
+related: cdk, dynamodb, lambda, secrets
+---
+
+# Migrations
+
+Jaypie provides `JaypieMigration` for running DynamoDB migrations as CloudFormation custom resources. Migrations execute automatically on every `cdk deploy`.
+
+## Overview
+
+`JaypieMigration` wraps a `JaypieLambda` in a CloudFormation custom resource provider. The Lambda runs during stack create/update, making it ideal for data migrations, seed scripts, and schema changes.
+
+## Usage
+
+```typescript
+import { JaypieDynamoDb, JaypieMigration } from "@jaypie/constructs";
+import * as lambda from "aws-cdk-lib/aws-lambda";
+
+const table = new JaypieDynamoDb(this, "myApp");
+
+new JaypieMigration(this, "SeedData", {
+  code: "dist/migrations/seed",     // Pre-built bundle directory
+  handler: "index.handler",
+  tables: [table],
+  dependencies: [table],            // Ensures table exists first
+});
+```
+
+## Props
+
+| Prop | Type | Default | Description |
+|------|------|---------|-------------|
+| `code` | `lambda.Code \| string` | *required* | Path to bundled migration code or CDK Code object |
+| `handler` | `string` | `"index.handler"` | Lambda entry point |
+| `tables` | `dynamodb.ITable[]` | `[]` | DynamoDB tables to grant read/write access |
+| `secrets` | `SecretsArrayItem[]` | `[]` | Secrets to make available to the Lambda |
+| `dependencies` | `Construct[]` | `[]` | Constructs that must be created before the migration runs |
+
+## Behavior
+
+- **Timeout**: 5 minutes (vs 30s for API Lambdas) to accommodate long-running migrations
+- **Role**: Tagged as `CDK.ROLE.PROCESSING`
+- **Execution**: Runs on every deploy via CloudFormation custom resource
+- **Dependencies**: Use `dependencies` to ensure tables and other resources exist before the migration executes
+
+## Migration Lambda Handler
+
+The migration Lambda receives a CloudFormation custom resource event. Return a result to signal success; throw to signal failure and roll back the stack.
+
+```typescript
+// src/migrations/seed/index.ts
+import { initClient, seedEntities, APEX } from "@jaypie/dynamodb";
+
+export const handler = async (event: any) => {
+  await initClient();
+
+  await seedEntities([
+    { alias: "config-main", model: "config", name: "Main Config", scope: APEX },
+    { alias: "vocab-en", model: "vocabulary", name: "English", scope: APEX },
+  ]);
+
+  return { status: "complete" };
+};
+```
+
+## Building Migration Code
+
+Bundle migrations separately using esbuild, then reference the output directory:
+
+```typescript
+// CDK stack
+new JaypieMigration(this, "SeedData", {
+  code: "../api/dist/migrations/seed",
+  handler: "index.handler",
+  tables: [table],
+  dependencies: [table],
+});
+```
+
+Or use `lambda.Code.fromAsset()` for more control:
+
+```typescript
+import * as lambda from "aws-cdk-lib/aws-lambda";
+
+new JaypieMigration(this, "SeedData", {
+  code: lambda.Code.fromAsset("../api/dist/migrations/seed"),
+  tables: [table],
+  dependencies: [table],
+});
+```
+
+## With Secrets
+
+Pass secrets when the migration needs external service access (e.g., MongoDB):
+
+```typescript
+new JaypieMigration(this, "DataMigration", {
+  code: "dist/migrations/migrate-to-dynamo",
+  secrets: ["MONGODB_URI"],
+  tables: [table],
+  dependencies: [table],
+});
+```
+
+## Construct Internals
+
+`JaypieMigration` creates three resources:
+
+1. **`JaypieLambda`** - The migration function (exposed as `migration.lambda`)
+2. **`cr.Provider`** - CloudFormation custom resource provider wrapping the Lambda
+3. **`cdk.CustomResource`** - The custom resource that triggers on every deploy
+
+Dependencies are attached to the custom resource so the migration waits for prerequisite resources.
+
+## See Also
+
+- **`skill("cdk")`** - CDK constructs and deployment patterns
+- **`skill("dynamodb")`** - DynamoDB key design, entity operations, and seed utilities
+- **`skill("lambda")`** - Lambda handler wrappers and lifecycle
+- **`skill("secrets")`** - Secret management with JaypieEnvSecret

package/skills/skills.md

@@ -17,7 +17,7 @@ Look up skills by alias: `mcp__jaypie__skill(alias)`
 |----------|--------|
 | contents | index, releasenotes |
 | development | apikey, documentation, errors, llm, logs, mocks, monorepo, style, subpackages, tests, tools |
-| infrastructure | aws, cdk, cicd, datadog, dns, dynamodb, express, lambda, secrets, streaming, variables, websockets |
+| infrastructure | aws, cdk, cicd, datadog, dns, dynamodb, express, lambda, migrations, secrets, streaming, variables, websockets |
 | patterns | api, fabric, handlers, models, services, vocabulary |
 | recipes | recipe-api-server |
 | meta | issues, jaypie, mcp, skills |