@jaypie/mcp 0.8.12 → 0.8.14

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.12#5f690a10"
+const BUILD_VERSION_STRING = "@jaypie/mcp@0.8.14#03cb149b"
     ;
 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.12",
+  "version": "0.8.14",
   "description": "Jaypie MCP",
   "repository": {
     "type": "git",

package/release-notes/dynamodb/0.4.3.md

@@ -0,0 +1,11 @@
+---
+version: 0.4.3
+date: 2026-04-04
+summary: Widen StorableEntity type to accept state and extra properties
+---
+
+## Changes
+
+- Added `state?: Record<string, unknown>` to `StorableEntity` for application-specific state flags
+- Added index signature `[key: string]: unknown` so downstream entity extensions type-check without casts
+- Fixes #270: TS2353 when passing `state` to `putEntity`, TS2739 when spreading partial updates to `updateEntity`

package/release-notes/jaypie/1.2.30.md

@@ -0,0 +1,9 @@
+---
+version: 1.2.30
+date: 2026-04-04
+summary: Bump @jaypie/logger to 1.2.11
+---
+
+## Changes
+
+- Updated `@jaypie/logger` dependency to `^1.2.11` for LOG_LEVEL_FIELD support

package/release-notes/llm/1.2.23.md

@@ -0,0 +1,9 @@
+---
+version: 1.2.23
+date: 2026-04-02
+summary: Deduplicate ALL.COMBINED model list
+---
+
+## Changes
+
+- Fix: `ALL.COMBINED` now deduplicates models using `Set` spread, preventing duplicate entries when provider tiers share the same model ID (e.g., Anthropic DEFAULT = SMALL)

package/release-notes/logger/1.2.11.md

@@ -0,0 +1,14 @@
+---
+version: 1.2.11
+date: 2026-04-04
+summary: Add LOG_LEVEL_FIELD env var for optional level key in JSON output
+---
+
+## Changes
+
+- Added `LOG_LEVEL_FIELD` environment variable to optionally include log level in JSON output
+  - `true` or `1`: adds `"level": "debug"` (etc.) to JSON
+  - Custom string (e.g., `"status"`): adds that key with the level value
+  - `false`, `0`, or unset: omit level from output (default, no breaking change)
+- Added `levelField` option to `Logger` constructor for programmatic control
+- Applies to both regular log output and `.var()` output

package/release-notes/mcp/0.8.14.md

@@ -0,0 +1,12 @@
+---
+version: 0.8.14
+date: 2026-04-04
+summary: Add force skill, update logs/dynamodb/variables skills
+---
+
+## Changes
+
+- Added `force` skill documenting type coercion utilities
+- Updated `logs` skill with LOG_LEVEL_FIELD documentation
+- Updated `dynamodb` skill with StorableEntity extensibility (state, index signature)
+- Updated `variables` skill with LOG_LEVEL_FIELD

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, migrations, secrets, streaming, variables, websockets
+Infrastructure: aws, cdk, cicd, datadog, dns, dynamodb, express, lambda, migrations, secrets, sqs, streaming, variables, websockets
 Patterns: api, fabric, handlers, models, services, vocabulary
 Recipes: recipe-api-server
 Meta: issues, jaypie, mcp, skills

package/skills/dynamodb.md

@@ -125,6 +125,10 @@ interface StorableEntity {
   updatedAt: string;
   archivedAt?: string;
   deletedAt?: string;
+
+  // Extensible
+  state?: Record<string, unknown>;  // Application-specific state flags
+  [key: string]: unknown;           // Additional properties allowed
 }
 ```
 

package/skills/force.md

@@ -0,0 +1,115 @@
+---
+description: Type coercion utilities for safe value conversion
+related: style, errors, variables
+---
+
+# Force
+
+Coerce values to expected types without throwing. Returns sensible defaults for invalid input.
+
+## Import
+
+```typescript
+import { force } from "@jaypie/kit";
+// or
+import { force } from "jaypie";
+```
+
+## Convenience Methods
+
+### force.array(value)
+
+Wraps non-array values in an array. Arrays pass through.
+
+```typescript
+force.array("hello");     // ["hello"]
+force.array([1, 2]);      // [1, 2]
+force.array(undefined);   // [undefined]
+```
+
+### force.boolean(value)
+
+Parses boolean with string awareness. Falsy strings: `""`, `"0"`, `"f"`, `"false"`, `"n"`, `"no"` (case-insensitive).
+
+```typescript
+force.boolean("false");   // false
+force.boolean("no");      // false
+force.boolean("0");       // false
+force.boolean("");        // false
+force.boolean("yes");     // true
+force.boolean("anything"); // true
+force.boolean(0);         // false
+force.boolean(1);         // true
+force.boolean(null);      // false
+```
+
+### force.number(value)
+
+Converts to number. Returns `0` for non-numeric input.
+
+```typescript
+force.number("42");       // 42
+force.number("abc");      // 0
+force.number(null);       // 0
+force.number(undefined);  // 0
+```
+
+### force.positive(value)
+
+Like `force.number` but clamps to minimum `0`.
+
+```typescript
+force.positive(-5);       // 0
+force.positive("10");     // 10
+force.positive("abc");    // 0
+```
+
+### force.string(value, default?)
+
+Converts to string. Second argument is default for `undefined`.
+
+```typescript
+force.string(42);         // "42"
+force.string(null);       // "null"
+force.string(undefined);  // ""
+force.string(undefined, "fallback"); // "fallback"
+force.string({ a: 1 });  // '{"a":1}'
+```
+
+### force.object(value, key?)
+
+Ensures object. Wraps scalars as `{ [key]: value }` (default key: `"value"`). Parses JSON strings.
+
+```typescript
+force.object({ a: 1 });         // { a: 1 }
+force.object(42);                // { value: 42 }
+force.object(42, "count");      // { count: 42 }
+force.object('{"a":1}');        // { a: 1 }
+force.object("hello");          // { value: "hello" }
+```
+
+## Advanced: force(value, type, options?)
+
+The base function accepts a type constructor and options:
+
+```typescript
+force(value, Number, { minimum: 0, maximum: 100 });
+force(value, Number, { nan: true }); // allow NaN instead of returning 0
+force(value, String, "default");     // default for undefined
+force(value, Object, "keyName");     // wrap key name
+```
+
+### Options
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `minimum` | `number` | Clamp number to minimum |
+| `maximum` | `number` | Clamp number to maximum |
+| `nan` | `boolean` | If `true`, return `NaN` instead of `0` for non-numeric input |
+| `key` | `string` | Key name when wrapping scalar in object (default: `"value"`) |
+
+If `minimum > maximum`, clamping is skipped.
+
+## Testing
+
+Mocked automatically via `@jaypie/testkit/mock` when mocking `jaypie` or `@jaypie/kit`.

package/skills/logs.md

@@ -72,6 +72,25 @@ LOG_LEVEL=debug npm run dev
 LOG_LEVEL=trace MODULE_LOG_LEVEL=warn npm test
 ```
 
+## Including Level in JSON Output
+
+By default, the log level is not included in JSON output (Lambda determines level from the console method). To include it:
+
+```bash
+LOG_LEVEL_FIELD=true          # Adds "level": "debug" (etc.)
+LOG_LEVEL_FIELD=status        # Adds "status": "debug" (etc.)
+LOG_LEVEL_FIELD=false         # Omit (default)
+```
+
+Or via constructor option:
+
+```typescript
+import { Logger } from "@jaypie/logger";
+
+const logger = new Logger({ format: "json", level: "debug", levelField: "status" });
+logger.info("test"); // { "message": "test", "status": "info" }
+```
+
 ## Lambda Logging
 
 Lambda handlers automatically add context:

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, migrations, secrets, streaming, variables, websockets |
+| infrastructure | aws, cdk, cicd, datadog, dns, dynamodb, express, lambda, migrations, secrets, sqs, streaming, variables, websockets |
 | patterns | api, fabric, handlers, models, services, vocabulary |
 | recipes | recipe-api-server |
 | meta | issues, jaypie, mcp, skills |

package/skills/sqs.md

@@ -0,0 +1,133 @@
+---
+description: SQS messaging patterns, queue constructs, and event parsing
+related: aws, cdk, lambda, variables
+---
+
+# SQS Messaging
+
+Jaypie provides SQS utilities through `@jaypie/aws` and CDK constructs through `@jaypie/constructs`.
+
+## Sending Messages
+
+```typescript
+import { sendMessage, sendBatchMessages } from "@jaypie/aws";
+
+// Simple usage with default queue (CDK_ENV_QUEUE_URL)
+await sendMessage({ action: "process", documentId: "doc-123" });
+
+// With explicit queue URL and options
+await sendMessage(
+  { action: "process" },
+  {
+    delaySeconds: 30,
+    messageAttributes: { Priority: { DataType: "String", StringValue: "high" } },
+    queueUrl: "https://sqs...",
+  }
+);
+
+// Batch send (automatically batched in groups of 10)
+const messages = items.map((item) => ({ action: "process", id: item.id }));
+await sendBatchMessages({ messages });
+```
+
+## Receiving Messages
+
+Parse incoming SQS/SNS events in Lambda handlers:
+
+```typescript
+import { getMessages, getSingletonMessage } from "@jaypie/aws";
+
+// Get all messages from event
+const messages = getMessages(event); // Returns array of parsed bodies
+
+// Get exactly one message or throw BadGatewayError
+const message = getSingletonMessage(event);
+```
+
+## CDK: JaypieQueue
+
+SQS queue with DLQ and Lambda trigger:
+
+```typescript
+import { JaypieQueue } from "@jaypie/constructs";
+
+const queue = new JaypieQueue(this, "ProcessQueue", {
+  visibilityTimeout: Duration.seconds(60),
+  retentionPeriod: Duration.days(7),
+});
+
+// Connect to Lambda
+queue.addEventSource(handler);
+```
+
+### Wiring Queue URL to Lambda
+
+```typescript
+import { JaypieLambda, JaypieQueue } from "@jaypie/constructs";
+
+const queue = new JaypieQueue(this, "ProcessQueue");
+
+const handler = new JaypieLambda(this, "Handler", {
+  entry: "src/handler.ts",
+  environment: {
+    CDK_ENV_QUEUE_URL: queue.queueUrl,
+  },
+});
+
+queue.grantSendMessages(handler);
+```
+
+### Resource Naming
+
+Queue names are account-global. Always include `PROJECT_ENV` and `PROJECT_NONCE` to avoid collisions:
+
+```typescript
+// Bad
+queueName: `${prefix}-process`
+
+// Good
+queueName: `${prefix}-process-${PROJECT_ENV}-${PROJECT_NONCE}`
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `CDK_ENV_QUEUE_URL` | Default SQS queue URL |
+| `PROJECT_KEY` | Used for FIFO queue message group ID |
+
+## Testing
+
+```typescript
+import { sendMessage } from "@jaypie/testkit/mock";
+import { vi } from "vitest";
+
+vi.mock("@jaypie/aws");
+
+it("sends message to queue", async () => {
+  vi.mocked(sendMessage).mockResolvedValue({ MessageId: "123" });
+
+  await handler({ documentId: "doc-123" });
+
+  expect(sendMessage).toHaveBeenCalledWith(
+    expect.objectContaining({ documentId: "doc-123" })
+  );
+});
+```
+
+## Debugging
+
+```bash
+# Check queue depth
+aws_sqs_get_queue_attributes --queueUrl "https://..."
+
+# Peek at messages
+aws_sqs_receive_message --queueUrl "https://..." --maxNumberOfMessages 5
+```
+
+## See Also
+
+- **`skill("aws")`** - Full AWS integration reference
+- **`skill("cdk")`** - CDK constructs and deployment patterns
+- **`skill("lambda")`** - Lambda handler wrappers and lifecycle
+- **`skill("variables")`** - Environment variables reference

package/skills/variables.md

@@ -37,6 +37,7 @@ log.info("Starting", { env, project: key });
 |----------|-------------|--------|
 | `NODE_ENV` | Node.js environment | development, production, test |
 | `LOG_LEVEL` | Logging verbosity | trace, debug, info, warn, error |
+| `LOG_LEVEL_FIELD` | Include level in JSON output | `true` (adds `level` key), custom string, or `false` (default) |
 
 ### Log Level in Development