@jaypie/mcp 0.8.30 → 0.8.31

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.30#e4c15172"
+const BUILD_VERSION_STRING = "@jaypie/mcp@0.8.31#0d902410"
     ;
 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.30",
+  "version": "0.8.31",
   "description": "Jaypie MCP",
   "repository": {
     "type": "git",

package/release-notes/dynamodb/0.6.0.md

@@ -0,0 +1,42 @@
+---
+version: 0.6.0
+date: 2026-04-13
+summary: Replace `putEntity` with `createEntity` (conditional `attribute_not_exists(id)`) to remove the silent-clobber footgun
+---
+
+## Breaking changes
+
+- **Removed `putEntity`.** The unconditional `PutCommand` it issued was a
+  silent-clobber footgun: callers using it as "ensure exists" overwrote
+  embedded fields (e.g., `messages: []`) on every call. `putEntity` was also
+  semantically identical to `updateEntity`, so it was dead weight as well as
+  a trap. Migrate based on intent:
+  - "I want this row to exist, do nothing if it already does" → `createEntity`
+  - "I want this row to be exactly these values, replacing any prior state" → `updateEntity`
+
+## New
+
+- **`createEntity({ entity })`**: writes with
+  `ConditionExpression: "attribute_not_exists(id)"`. On
+  `ConditionalCheckFailedException`, returns `null` instead of throwing.
+  Other errors propagate normally. Return type is `StorableEntity | null`.
+
+## MCP
+
+- The `dynamodb_put` tool is renamed to `dynamodb_create` and now wraps
+  `createEntity`.
+
+## Migration
+
+```ts
+// Before
+await putEntity({ entity });          // silently overwrote on second call
+
+// After — pick the verb that matches intent
+await createEntity({ entity });       // ensure exists; null if id taken
+await updateEntity({ entity });       // overwrite (was putEntity's actual behavior)
+```
+
+Internal callers in `seedExport` (`seedEntityIfNotExists`, `seedEntities`)
+were migrated: the create paths use `createEntity`; the `replace: true`
+path uses `updateEntity`.

package/release-notes/fabric/0.3.1.md

@@ -0,0 +1,14 @@
+---
+version: 0.3.1
+date: 2026-04-13
+summary: FabricData create service uses `createEntity` (was `putEntity`) from `@jaypie/dynamodb` 0.6.0
+---
+
+## Changes
+
+- `createCreateService` (the POST `/{model}` handler in FabricData) now
+  imports `createEntity` instead of `putEntity`. Behavior is unchanged in
+  practice: the create service generates a fresh UUID for `id`, so the new
+  conditional write never collides; if a caller supplies a colliding `id`
+  via a custom transform, the service now returns `null` instead of
+  silently overwriting.

package/release-notes/mcp/0.8.31.md

@@ -0,0 +1,12 @@
+---
+version: 0.8.31
+date: 2026-04-13
+summary: Update dynamodb skill docs and pull `@jaypie/dynamodb` 0.6.0 (`createEntity` replaces `putEntity`)
+---
+
+## Changes
+
+- `dynamodb` skill updated: `putEntity` examples and table entry replaced
+  with `createEntity`.
+- Pulls `@jaypie/dynamodb` 0.6.0 with renamed MCP tool `dynamodb_create`
+  (was `dynamodb_put`).

package/release-notes/testkit/1.2.33.md

@@ -0,0 +1,11 @@
+---
+version: 1.2.33
+date: 2026-04-13
+summary: Replace `putEntity` mock with `createEntity` to match `@jaypie/dynamodb` 0.6.0
+---
+
+## Changes
+
+- Removed `putEntity` mock; added `createEntity` mock that returns the
+  indexed entity (or `null` to simulate `ConditionalCheckFailedException`,
+  via `mockResolvedValueOnce(null)`).

package/skills/dynamodb.md

@@ -33,7 +33,7 @@ The runtime package provides entity operations, GSI-based queries, key builders,
 import {
   APEX,
   initClient,
-  putEntity,
+  createEntity,
   getEntity,
   deleteEntity,
   queryByScope,
@@ -44,7 +44,7 @@ import {
 Or through the main package:
 
 ```typescript
-import { APEX, initClient, putEntity, queryByScope } from "jaypie";
+import { APEX, initClient, createEntity, queryByScope } from "jaypie";
 ```
 
 ### Client Initialization
@@ -121,10 +121,10 @@ interface StorableEntity {
 ### Entity Operations
 
 ```typescript
-import { APEX, putEntity, getEntity, updateEntity, deleteEntity, archiveEntity, destroyEntity } from "@jaypie/dynamodb";
+import { APEX, createEntity, getEntity, updateEntity, deleteEntity, archiveEntity, destroyEntity } from "@jaypie/dynamodb";
 
 // Create entity — indexEntity auto-populates GSI keys, createdAt, updatedAt
-const record = await putEntity({
+const record = await createEntity({
   entity: {
     model: "record",
     id: crypto.randomUUID(),
@@ -157,7 +157,7 @@ await destroyEntity({ id: "abc-123" });
 
 | Function | Description |
 |----------|-------------|
-| `putEntity({ entity })` | Create or replace (auto-indexes GSI keys, auto-timestamps) |
+| `createEntity({ entity })` | Create entity; returns `null` if `id` exists (conditional `attribute_not_exists(id)`) |
 | `getEntity({ id })` | Get by primary key (id only) |
 | `updateEntity({ entity })` | Update (sets `updatedAt`, re-indexes) |
 | `deleteEntity({ id })` | Soft delete (`deletedAt`, `#deleted` suffix on GSI pk) |
@@ -169,16 +169,16 @@ await destroyEntity({ id: "abc-123" });
 The `scope` field enables parent-child relationships:
 
 ```typescript
-import { APEX, calculateScope, putEntity, queryByScope } from "@jaypie/dynamodb";
+import { APEX, calculateScope, createEntity, queryByScope } from "@jaypie/dynamodb";
 
 // Root-level entity: scope = APEX ("@")
-await putEntity({ entity: { model: "chat", scope: APEX, ... } });
+await createEntity({ entity: { model: "chat", scope: APEX, ... } });
 
 // Child entity: scope = "{parent.model}#{parent.id}"
 const chat = { model: "chat", id: "abc-123" };
 const messageScope = calculateScope(chat); // "chat#abc-123"
 
-await putEntity({
+await createEntity({
   entity: { model: "message", scope: messageScope, ... },
 });
 
@@ -394,7 +394,7 @@ Mock `@jaypie/dynamodb` via testkit. Key builders and `indexEntity` work correct
 import {
   APEX,
   indexEntity,
-  putEntity,
+  createEntity,
   queryByScope,
   seedEntities,
 } from "@jaypie/testkit/mock";