@sharpee/stdlib 3.0.0 → 3.3.0

package/actions/standard/putting/putting.js

@@ -17,17 +17,58 @@
  * - "put X and Y in box" - puts multiple specified items
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.puttingAction = void 0;
-const types_1 = require("../../../scope/types");
+exports.puttingAction = exports.puttingLifecycle = void 0;
+const types_js_1 = require("../../../scope/types.js");
 const world_model_1 = require("@sharpee/world-model");
-const snapshot_utils_1 = require("../../base/snapshot-utils");
-const constants_1 = require("../../constants");
-const putting_messages_1 = require("./putting-messages");
+const snapshot_utils_js_1 = require("../../base/snapshot-utils.js");
+const constants_js_1 = require("../../constants.js");
+const putting_messages_js_1 = require("./putting-messages.js");
+const index_js_1 = require("../../lifecycle/index.js");
 // Import types
-const putting_types_1 = require("./putting-types");
+const putting_types_js_1 = require("./putting-types.js");
 // Import multi-object helpers
-const multi_object_handler_1 = require("../../../helpers/multi-object-handler");
-const utils_1 = require("../../../utils");
+const multi_object_handler_js_1 = require("../../../helpers/multi-object-handler.js");
+const index_js_2 = require("../../../utils/index.js");
+/**
+ * Interceptor surface (ADR-228): BOTH the item and the container/supporter
+ * are consulted (D3-B order: direct object first). Each side's sharedData
+ * is seeded with the other's identity (D3 sub-ruling — symmetric context);
+ * in a multi-object command the container's seed carries the item
+ * currently being processed, which is what makes the trophy-case
+ * postExecute award score once per deposited treasure (D4).
+ */
+exports.puttingLifecycle = {
+    actionId: constants_js_1.IFActions.PUTTING,
+    slots: [
+        {
+            id: 'item',
+            actionIds: [constants_js_1.IFActions.PUTTING],
+            resolve: (ctx) => ctx.command.directObject?.entity,
+            seedData: (ctx, entity) => ({
+                itemId: entity.id,
+                itemName: entity.name,
+                targetId: ctx.command.indirectObject?.entity?.id,
+                targetName: ctx.command.indirectObject?.entity?.name,
+                preposition: ctx.command.parsed.structure.preposition?.text
+            })
+        },
+        {
+            id: 'container',
+            actionIds: [constants_js_1.IFActions.PUTTING],
+            resolve: (ctx) => ctx.command.indirectObject?.entity,
+            seedData: (ctx, entity, multiObjectItem) => {
+                const item = multiObjectItem ?? ctx.command.directObject?.entity;
+                return {
+                    itemId: item?.id,
+                    itemName: item?.name,
+                    targetId: entity.id,
+                    targetName: entity.name,
+                    preposition: ctx.command.parsed.structure.preposition?.text
+                };
+            }
+        }
+    ]
+};
 // ============================================================================
 // Helper Functions (standalone to avoid `this` issues in object literal)
 // ============================================================================
@@ -37,6 +78,11 @@ const utils_1 = require("../../../utils");
 function determineTargetPreposition(preposition, target) {
     const isContainer = target.has(world_model_1.TraitType.CONTAINER);
     const isSupporter = target.has(world_model_1.TraitType.SUPPORTER);
+    // `move X to Y` (ADR-230 D4, Phase 1 move ruling): `to` names no
+    // in/on choice — resolve by destination type like the bare form.
+    if (preposition === 'to') {
+        preposition = undefined;
+    }
     if (preposition) {
         // User specified a preposition
         if ((preposition === 'in' || preposition === 'into' || preposition === 'inside') && isContainer) {
@@ -50,15 +96,15 @@ function determineTargetPreposition(preposition, target) {
             if (preposition === 'in' || preposition === 'into' || preposition === 'inside') {
                 return {
                     targetPreposition: 'in',
-                    error: putting_messages_1.PuttingMessages.NOT_CONTAINER,
-                    params: { destination: (0, utils_1.nounPhraseFor)(target) }
+                    error: putting_messages_js_1.PuttingMessages.NOT_CONTAINER,
+                    params: { destination: (0, index_js_2.nounPhraseFor)(target) }
                 };
             }
             else {
                 return {
                     targetPreposition: 'on',
-                    error: putting_messages_1.PuttingMessages.NOT_SURFACE,
-                    params: { destination: (0, utils_1.nounPhraseFor)(target) }
+                    error: putting_messages_js_1.PuttingMessages.NOT_SURFACE,
+                    params: { destination: (0, index_js_2.nounPhraseFor)(target) }
                 };
             }
         }
@@ -74,8 +120,8 @@ function determineTargetPreposition(preposition, target) {
         else {
             return {
                 targetPreposition: 'in',
-                error: putting_messages_1.PuttingMessages.NOT_CONTAINER,
-                params: { destination: (0, utils_1.nounPhraseFor)(target) }
+                error: putting_messages_js_1.PuttingMessages.NOT_CONTAINER,
+                params: { destination: (0, index_js_2.nounPhraseFor)(target) }
             };
         }
     }
@@ -86,11 +132,11 @@ function determineTargetPreposition(preposition, target) {
 function validateSingleEntity(context, item, target, preposition) {
     // Prevent putting something inside/on itself
     if (item.id === target.id) {
-        const messageId = preposition === 'on' ? putting_messages_1.PuttingMessages.CANT_PUT_ON_ITSELF : putting_messages_1.PuttingMessages.CANT_PUT_IN_ITSELF;
+        const messageId = preposition === 'on' ? putting_messages_js_1.PuttingMessages.CANT_PUT_ON_ITSELF : putting_messages_js_1.PuttingMessages.CANT_PUT_IN_ITSELF;
         return {
             valid: false,
             error: messageId,
-            params: { item: (0, utils_1.nounPhraseFor)(item) }
+            params: { item: (0, index_js_2.nounPhraseFor)(item) }
         };
     }
     // Check if item is already in/on target
@@ -98,11 +144,11 @@ function validateSingleEntity(context, item, target, preposition) {
         const relation = target.has(world_model_1.TraitType.SUPPORTER) ? 'on' : 'in';
         return {
             valid: false,
-            error: putting_messages_1.PuttingMessages.ALREADY_THERE,
+            error: putting_messages_js_1.PuttingMessages.ALREADY_THERE,
             params: {
-                item: (0, utils_1.nounPhraseFor)(item),
+                item: (0, index_js_2.nounPhraseFor)(item),
                 relation: relation,
-                destination: (0, utils_1.nounPhraseFor)(target)
+                destination: (0, index_js_2.nounPhraseFor)(target)
             }
         };
     }
@@ -117,16 +163,16 @@ function validateSingleEntity(context, item, target, preposition) {
         if (target.has(world_model_1.TraitType.OPENABLE) && !world_model_1.OpenableBehavior.isOpen(target)) {
             return {
                 valid: false,
-                error: putting_messages_1.PuttingMessages.CONTAINER_CLOSED,
-                params: { container: (0, utils_1.nounPhraseFor)(target) }
+                error: putting_messages_js_1.PuttingMessages.CONTAINER_CLOSED,
+                params: { container: (0, index_js_2.nounPhraseFor)(target) }
             };
         }
         // Check capacity
         if (!world_model_1.ContainerBehavior.canAccept(target, item, context.world)) {
             return {
                 valid: false,
-                error: putting_messages_1.PuttingMessages.NO_ROOM,
-                params: { container: (0, utils_1.nounPhraseFor)(target) }
+                error: putting_messages_js_1.PuttingMessages.NO_ROOM,
+                params: { container: (0, index_js_2.nounPhraseFor)(target) }
             };
         }
     }
@@ -135,63 +181,28 @@ function validateSingleEntity(context, item, target, preposition) {
         if (!world_model_1.SupporterBehavior.canAccept(target, item, context.world)) {
             return {
                 valid: false,
-                error: putting_messages_1.PuttingMessages.NO_SPACE,
-                params: { surface: (0, utils_1.nounPhraseFor)(target) }
+                error: putting_messages_js_1.PuttingMessages.NO_SPACE,
+                params: { surface: (0, index_js_2.nounPhraseFor)(target) }
             };
         }
     }
     return { valid: true, targetPreposition };
 }
 /**
- * Validate a multi-object command (put all in box, put X and Y on table)
- */
-function validateMultiObject(context) {
-    const target = context.command.indirectObject?.entity;
-    const preposition = context.command.parsed.structure.preposition?.text;
-    // Must have a destination
-    if (!target) {
-        return { valid: false, error: putting_messages_1.PuttingMessages.NO_DESTINATION };
-    }
-    // For putting, scope is 'carried' - only put things we're holding
-    const items = (0, multi_object_handler_1.expandMultiObject)(context, { scope: 'carried' });
-    if (items.length === 0) {
-        return { valid: false, error: putting_messages_1.PuttingMessages.NOTHING_TO_PUT };
-    }
-    // Validate each entity, store results
-    const results = items.map(item => {
-        const validation = validateSingleEntity(context, item.entity, target, preposition);
-        return {
-            entity: item.entity,
-            success: validation.valid,
-            error: validation.valid ? undefined : validation.error,
-            errorParams: validation.valid ? undefined : validation.params,
-            targetPreposition: validation.targetPreposition
-        };
-    });
-    // Store results for execute/report phases
-    const sharedData = (0, putting_types_1.getPuttingSharedData)(context);
-    sharedData.multiObjectResults = results;
-    // Valid if at least one can be put
-    const anySuccess = results.some(r => r.success);
-    if (!anySuccess) {
-        // All failed - return the first error
-        return { valid: false, error: results[0].error, params: results[0].errorParams };
-    }
-    return { valid: true };
-}
-/**
- * Execute putting a single entity
+ * Execute putting a single entity. Mutation results are written into
+ * `scratch` — the single-object sharedData or the item's multi-object
+ * itemData (ADR-228 D4).
  */
-function executeSingleEntity(context, item, target, result, targetPreposition) {
-    result.targetPreposition = targetPreposition;
+function executeSingleEntity(context, item, target, scratch, targetPreposition) {
+    scratch.targetPreposition = targetPreposition;
     // Delegate to appropriate behavior
     if (targetPreposition === 'in') {
         const putResult = world_model_1.ContainerBehavior.addItem(target, item, context.world);
-        result.putResult = putResult;
+        scratch.putResult = putResult;
     }
     else {
         const putResult = world_model_1.SupporterBehavior.addItem(target, item, context.world);
-        result.putResult = putResult;
+        scratch.putResult = putResult;
     }
     // Actually move the item to the target
     context.world.moveEntity(item.id, target.id);
@@ -201,13 +212,13 @@ function executeSingleEntity(context, item, target, result, targetPreposition) {
  *
  * Uses simplified event pattern (ADR-097): domain event carries messageId directly.
  */
-function reportSingleSuccess(context, item, target, result, events) {
-    const targetPreposition = result.targetPreposition;
+function reportSingleSuccess(context, item, target, scratch, events) {
+    const targetPreposition = scratch.targetPreposition;
     if (targetPreposition === 'in') {
-        const params = { item: (0, utils_1.nounPhraseFor)(item), container: (0, utils_1.nounPhraseFor)(target) };
+        const params = { item: (0, index_js_2.nounPhraseFor)(item), container: (0, index_js_2.nounPhraseFor)(target) };
         events.push(context.event('if.event.put_in', {
             // Rendering data (messageId + params for text-service)
-            messageId: `${context.action.id}.${putting_messages_1.PuttingMessages.PUT_IN}`,
+            messageId: `${context.action.id}.${putting_messages_js_1.PuttingMessages.PUT_IN}`,
             params,
             // Domain data (for event sourcing / handlers)
             itemId: item.id,
@@ -216,15 +227,15 @@ function reportSingleSuccess(context, item, target, result, events) {
             targetName: target.name,
             actorId: context.player.id,
             preposition: 'in',
-            itemSnapshot: (0, snapshot_utils_1.captureEntitySnapshot)(item, context.world, true),
-            targetSnapshot: (0, snapshot_utils_1.captureEntitySnapshot)(target, context.world, true)
+            itemSnapshot: (0, snapshot_utils_js_1.captureEntitySnapshot)(item, context.world, true),
+            targetSnapshot: (0, snapshot_utils_js_1.captureEntitySnapshot)(target, context.world, true)
         }));
     }
     else {
-        const params = { item: (0, utils_1.nounPhraseFor)(item), surface: (0, utils_1.nounPhraseFor)(target) };
+        const params = { item: (0, index_js_2.nounPhraseFor)(item), surface: (0, index_js_2.nounPhraseFor)(target) };
         events.push(context.event('if.event.put_on', {
             // Rendering data (messageId + params for text-service)
-            messageId: `${context.action.id}.${putting_messages_1.PuttingMessages.PUT_ON}`,
+            messageId: `${context.action.id}.${putting_messages_js_1.PuttingMessages.PUT_ON}`,
             params,
             // Domain data (for event sourcing / handlers)
             itemId: item.id,
@@ -233,8 +244,8 @@ function reportSingleSuccess(context, item, target, result, events) {
             targetName: target.name,
             actorId: context.player.id,
             preposition: 'on',
-            itemSnapshot: (0, snapshot_utils_1.captureEntitySnapshot)(item, context.world, true),
-            targetSnapshot: (0, snapshot_utils_1.captureEntitySnapshot)(target, context.world, true)
+            itemSnapshot: (0, snapshot_utils_js_1.captureEntitySnapshot)(item, context.world, true),
+            targetSnapshot: (0, snapshot_utils_js_1.captureEntitySnapshot)(target, context.world, true)
         }));
     }
 }
@@ -243,28 +254,28 @@ function reportSingleSuccess(context, item, target, result, events) {
  *
  * Uses simplified event pattern (ADR-097): domain event carries messageId directly.
  */
-function reportSingleBlocked(context, item, target, error, errorParams, events) {
+function reportSingleBlocked(context, item, target, result, events) {
     events.push(context.event('if.event.put_blocked', {
         // Rendering data — EntityInfo for the formatter chain (ADR-158)
-        messageId: `${context.action.id}.${error}`,
-        params: { ...errorParams, item: (0, utils_1.nounPhraseFor)(item), destination: (0, utils_1.nounPhraseFor)(target) },
+        messageId: (0, index_js_1.blockedMessageId)(context, result),
+        params: { ...result.params, item: (0, index_js_2.nounPhraseFor)(item), destination: (0, index_js_2.nounPhraseFor)(target) },
         // Domain data — strings for handlers
         itemId: item.id,
         itemName: item.name,
         targetId: target.id,
         targetName: target.name,
-        reason: error
+        reason: result.error
     }));
 }
 // ============================================================================
 // Action Definition
 // ============================================================================
 exports.puttingAction = {
-    id: constants_1.IFActions.PUTTING,
+    id: constants_js_1.IFActions.PUTTING,
     // Default scope requirements for this action's slots
     defaultScope: {
-        item: types_1.ScopeLevel.REACHABLE, // REACHABLE allows implicit take
-        target: types_1.ScopeLevel.REACHABLE
+        item: types_js_1.ScopeLevel.REACHABLE, // REACHABLE allows implicit take
+        target: types_js_1.ScopeLevel.REACHABLE
     },
     requiredMessages: [
         'no_target',
@@ -286,59 +297,54 @@ exports.puttingAction = {
     metadata: {
         requiresDirectObject: true,
         requiresIndirectObject: true,
-        directObjectScope: types_1.ScopeLevel.REACHABLE, // REACHABLE allows implicit take
-        indirectObjectScope: types_1.ScopeLevel.REACHABLE
+        directObjectScope: types_js_1.ScopeLevel.REACHABLE, // REACHABLE allows implicit take
+        indirectObjectScope: types_js_1.ScopeLevel.REACHABLE
     },
     validate(context) {
-        // Check for multi-object command
-        if ((0, multi_object_handler_1.isMultiObjectCommand)(context)) {
-            return validateMultiObject(context);
+        const target = context.command.indirectObject?.entity;
+        const preposition = context.command.parsed.structure.preposition?.text;
+        // Check for multi-object command — full per-item lifecycle (ADR-228 D4).
+        // This is what fixes the live trophy-case bug: every deposited item
+        // now runs the container's hooks.
+        if ((0, multi_object_handler_js_1.isMultiObjectCommand)(context)) {
+            // Must have a destination
+            if (!target) {
+                return { valid: false, error: putting_messages_js_1.PuttingMessages.NO_DESTINATION };
+            }
+            // For putting, scope is 'carried' - only put things we're holding
+            const items = (0, multi_object_handler_js_1.expandMultiObject)(context, { scope: 'carried' }).map(i => i.entity);
+            if (items.length === 0) {
+                return { valid: false, error: putting_messages_js_1.PuttingMessages.NOTHING_TO_PUT };
+            }
+            const results = (0, index_js_1.runMultiObjectValidate)(context, exports.puttingLifecycle, 'item', items, (ctx, item, itemData) => {
+                const validation = validateSingleEntity(ctx, item, target, preposition);
+                itemData.targetPreposition = validation.targetPreposition;
+                return validation;
+            });
+            // Valid if at least one can be put; all-fail returns the first error
+            if (!results.some(r => r.success)) {
+                return { valid: false, error: results[0].error, errorQualified: results[0].errorQualified, params: results[0].errorParams };
+            }
+            return { valid: true };
         }
         // Single object validation
-        const actor = context.player;
         const item = context.command.directObject?.entity;
-        const target = context.command.indirectObject?.entity;
-        const preposition = context.command.parsed.structure.preposition?.text;
-        const sharedData = (0, putting_types_1.getPuttingSharedData)(context);
         // Validate we have an item
         if (!item) {
-            return { valid: false, error: putting_messages_1.PuttingMessages.NO_TARGET };
+            return { valid: false, error: putting_messages_js_1.PuttingMessages.NO_TARGET };
         }
         // Validate we have a destination
         if (!target) {
             return {
                 valid: false,
-                error: putting_messages_1.PuttingMessages.NO_DESTINATION,
-                params: { item: (0, utils_1.nounPhraseFor)(item) }
+                error: putting_messages_js_1.PuttingMessages.NO_DESTINATION,
+                params: { item: (0, index_js_2.nounPhraseFor)(item) }
             };
         }
-        // Check for interceptor on the target entity (ADR-118)
-        // Interceptors are on the container/supporter receiving the item
-        const interceptorResult = context.world.getInterceptorForAction(target, constants_1.IFActions.PUTTING);
-        const interceptor = interceptorResult?.interceptor;
-        const interceptorData = {
-            // Pass item info to interceptor so it knows what's being put
-            itemId: item.id,
-            itemName: item.name,
-            targetId: target.id,
-            targetName: target.name,
-            preposition: preposition
-        };
-        // Store for later phases
-        sharedData.interceptor = interceptor;
-        sharedData.interceptorData = interceptorData;
-        // === PRE-VALIDATE HOOK ===
-        // Called before standard validation - can block early
-        if (interceptor?.preValidate) {
-            const result = interceptor.preValidate(target, context.world, actor.id, interceptorData);
-            if (result !== null) {
-                return {
-                    valid: result.valid,
-                    error: result.error,
-                    params: result.params
-                };
-            }
-        }
+        const state = (0, index_js_1.resolveLifecycle)(context, exports.puttingLifecycle);
+        const preVeto = (0, index_js_1.runPreValidate)(context, state);
+        if (preVeto)
+            return preVeto;
         // Item must be carried (or implicitly takeable)
         // This enables "put apple in box" when apple is on the ground
         const carryCheck = context.requireCarriedOrImplicitTake(item);
@@ -350,36 +356,25 @@ exports.puttingAction = {
         if (!standardResult.valid) {
             return standardResult;
         }
-        // === POST-VALIDATE HOOK ===
-        // Called after standard validation passes - can add entity-specific conditions
-        if (interceptor?.postValidate) {
-            const result = interceptor.postValidate(target, context.world, actor.id, interceptorData);
-            if (result !== null) {
-                return {
-                    valid: result.valid,
-                    error: result.error,
-                    params: result.params
-                };
-            }
-        }
+        // Canonical placement (ADR-228): postValidate runs after ALL standard validation
+        const postVeto = (0, index_js_1.runPostValidate)(context, state);
+        if (postVeto)
+            return postVeto;
         return standardResult;
     },
     execute(context) {
-        const actor = context.player;
-        const sharedData = (0, putting_types_1.getPuttingSharedData)(context);
+        const sharedData = (0, putting_types_js_1.getPuttingSharedData)(context);
         const target = context.command.indirectObject.entity;
         const preposition = context.command.parsed.structure.preposition?.text;
-        // Check for multi-object command
-        if (sharedData.multiObjectResults) {
+        // Multi-object command: per-item execute + hooks (D4 — the container's
+        // postExecute fires once per deposited item)
+        const multi = (0, index_js_1.getMultiObjectLifecycle)(context);
+        if (multi) {
             // Determine target preposition once for the batch
             const { targetPreposition } = determineTargetPreposition(preposition, target);
-            // Execute for each successful validation
-            for (const result of sharedData.multiObjectResults) {
-                if (result.success) {
-                    executeSingleEntity(context, result.entity, target, result, targetPreposition);
-                }
-            }
-            // Note: Multi-object commands don't support interceptors currently
+            (0, index_js_1.runMultiObjectExecute)(context, multi, (ctx, item, itemData) => {
+                executeSingleEntity(ctx, item, target, itemData, targetPreposition);
+            });
             return;
         }
         // Single object execution
@@ -387,45 +382,30 @@ exports.puttingAction = {
         // Determine the target preposition
         const { targetPreposition } = determineTargetPreposition(preposition, target);
         // Store data for report phase
-        sharedData.targetPreposition = targetPreposition;
-        // Delegate to appropriate behavior
-        if (targetPreposition === 'in') {
-            const result = world_model_1.ContainerBehavior.addItem(target, item, context.world);
-            sharedData.putResult = result;
-        }
-        else {
-            const result = world_model_1.SupporterBehavior.addItem(target, item, context.world);
-            sharedData.putResult = result;
-        }
-        // Actually move the item to the target
-        context.world.moveEntity(item.id, target.id);
-        // === POST-EXECUTE HOOK ===
-        // Called after standard execution - can perform additional mutations
-        const interceptor = sharedData.interceptor;
-        const interceptorData = sharedData.interceptorData || {};
-        if (interceptor?.postExecute) {
-            interceptor.postExecute(target, context.world, actor.id, interceptorData);
-        }
+        executeSingleEntity(context, item, target, sharedData, targetPreposition);
+        const state = (0, index_js_1.getLifecycleState)(context);
+        if (state)
+            (0, index_js_1.runPostExecute)(context, state);
     },
     report(context) {
-        const sharedData = (0, putting_types_1.getPuttingSharedData)(context);
+        const sharedData = (0, putting_types_js_1.getPuttingSharedData)(context);
         const target = context.command.indirectObject.entity;
         const events = [];
         // Prepend any implicit take events (from requireCarriedOrImplicitTake)
         if (context.sharedData.implicitTakeEvents) {
             events.push(...context.sharedData.implicitTakeEvents);
         }
-        // Check for multi-object command
-        if (sharedData.multiObjectResults) {
-            // Generate events for each item (success and failure)
-            for (const result of sharedData.multiObjectResults) {
-                if (result.success) {
-                    reportSingleSuccess(context, result.entity, target, result, events);
-                }
-                else {
-                    reportSingleBlocked(context, result.entity, target, result.error, result.errorParams, events);
-                }
-            }
+        // Multi-object command: per-item success/blocked events + hooks (D4)
+        const multi = (0, index_js_1.getMultiObjectLifecycle)(context);
+        if (multi) {
+            const preposition = context.command.parsed.structure.preposition?.text;
+            const { targetPreposition } = determineTargetPreposition(preposition, target);
+            const primaryEventType = targetPreposition === 'in' ? 'if.event.put_in' : 'if.event.put_on';
+            (0, index_js_1.runMultiObjectReport)(context, multi, events, primaryEventType, 'if.event.put_blocked', (ctx, item, itemData, evts) => {
+                reportSingleSuccess(ctx, item, target, itemData, evts);
+            }, (ctx, item, itemResult, evts) => {
+                reportSingleBlocked(ctx, item, target, itemResult, evts);
+            });
             return events;
         }
         // Single object report
@@ -433,10 +413,10 @@ exports.puttingAction = {
         const targetPreposition = sharedData.targetPreposition;
         // Emit domain event with messageId (simplified pattern - ADR-097)
         if (targetPreposition === 'in') {
-            const params = { item: (0, utils_1.nounPhraseFor)(item), container: (0, utils_1.nounPhraseFor)(target) };
+            const params = { item: (0, index_js_2.nounPhraseFor)(item), container: (0, index_js_2.nounPhraseFor)(target) };
             events.push(context.event('if.event.put_in', {
                 // Rendering data (messageId + params for text-service)
-                messageId: `${context.action.id}.${putting_messages_1.PuttingMessages.PUT_IN}`,
+                messageId: `${context.action.id}.${putting_messages_js_1.PuttingMessages.PUT_IN}`,
                 params,
                 // Domain data (for event sourcing / handlers)
                 itemId: item.id,
@@ -445,15 +425,15 @@ exports.puttingAction = {
                 targetName: target.name,
                 actorId: context.player.id,
                 preposition: 'in',
-                itemSnapshot: (0, snapshot_utils_1.captureEntitySnapshot)(item, context.world, true),
-                targetSnapshot: (0, snapshot_utils_1.captureEntitySnapshot)(target, context.world, true)
+                itemSnapshot: (0, snapshot_utils_js_1.captureEntitySnapshot)(item, context.world, true),
+                targetSnapshot: (0, snapshot_utils_js_1.captureEntitySnapshot)(target, context.world, true)
             }));
         }
         else {
-            const params = { item: (0, utils_1.nounPhraseFor)(item), surface: (0, utils_1.nounPhraseFor)(target) };
+            const params = { item: (0, index_js_2.nounPhraseFor)(item), surface: (0, index_js_2.nounPhraseFor)(target) };
             events.push(context.event('if.event.put_on', {
                 // Rendering data (messageId + params for text-service)
-                messageId: `${context.action.id}.${putting_messages_1.PuttingMessages.PUT_ON}`,
+                messageId: `${context.action.id}.${putting_messages_js_1.PuttingMessages.PUT_ON}`,
                 params,
                 // Domain data (for event sourcing / handlers)
                 itemId: item.id,
@@ -462,19 +442,14 @@ exports.puttingAction = {
                 targetName: target.name,
                 actorId: context.player.id,
                 preposition: 'on',
-                itemSnapshot: (0, snapshot_utils_1.captureEntitySnapshot)(item, context.world, true),
-                targetSnapshot: (0, snapshot_utils_1.captureEntitySnapshot)(target, context.world, true)
+                itemSnapshot: (0, snapshot_utils_js_1.captureEntitySnapshot)(item, context.world, true),
+                targetSnapshot: (0, snapshot_utils_js_1.captureEntitySnapshot)(target, context.world, true)
             }));
         }
-        // === POST-REPORT HOOK ===
-        // Apply interceptor's override (replaces if.event.put_in/put_on messageId)
-        // and/or emit (additional events). See ISSUE-074.
-        const interceptor = sharedData.interceptor;
-        const interceptorData = sharedData.interceptorData || {};
-        if (interceptor?.postReport) {
-            const result = interceptor.postReport(target, context.world, context.player.id, interceptorData);
+        const state = (0, index_js_1.getLifecycleState)(context);
+        if (state) {
             const primaryEventType = targetPreposition === 'in' ? 'if.event.put_in' : 'if.event.put_on';
-            (0, world_model_1.applyInterceptorReportResult)(events, primaryEventType, result, context);
+            (0, index_js_1.runPostReport)(context, state, events, primaryEventType);
         }
         return events;
     },
@@ -486,25 +461,13 @@ exports.puttingAction = {
     blocked(context, result) {
         const item = context.command.directObject?.entity;
         const target = context.command.indirectObject?.entity;
-        const sharedData = (0, putting_types_1.getPuttingSharedData)(context);
-        // === ON-BLOCKED HOOK ===
-        // Called when action is blocked - can provide custom blocked handling
-        const interceptor = sharedData.interceptor;
-        const interceptorData = sharedData.interceptorData || {};
-        if (interceptor?.onBlocked && target && result.error) {
-            const customEffects = interceptor.onBlocked(target, context.world, context.player.id, result.error, interceptorData);
-            if (customEffects !== null) {
-                // Interceptor provided custom blocked effects
-                return customEffects.map(effect => context.event(effect.type, effect.payload));
-            }
-        }
         // Standard blocked handling — EntityInfo for formatter chain (ADR-158)
-        return [context.event('if.event.put_blocked', {
-                messageId: `${context.action.id}.${result.error}`,
+        const events = [context.event('if.event.put_blocked', {
+                messageId: (0, index_js_1.blockedMessageId)(context, result),
                 params: {
                     ...result.params,
-                    item: item ? (0, utils_1.nounPhraseFor)(item) : undefined,
-                    destination: target ? (0, utils_1.nounPhraseFor)(target) : undefined
+                    item: item ? (0, index_js_2.nounPhraseFor)(item) : undefined,
+                    destination: target ? (0, index_js_2.nounPhraseFor)(target) : undefined
                 },
                 itemId: item?.id,
                 itemName: item?.name,
@@ -512,6 +475,25 @@ exports.puttingAction = {
                 targetName: target?.name,
                 reason: result.error
             })];
+        if (result.error) {
+            const state = (0, index_js_1.getLifecycleState)(context);
+            if (state) {
+                // Single-object path: notify all consultations (ADR-228 D2/D3)
+                (0, index_js_1.runOnBlocked)(context, state, events, 'if.event.put_blocked', result.error);
+            }
+            else {
+                // Multi-object all-fail path: the blocked event carries the FIRST
+                // failed item's error, so only that item's consultations are
+                // notified here — the other items produced no events for hooks to
+                // decorate. (Partial failures are handled per item in report().)
+                const multi = (0, index_js_1.getMultiObjectLifecycle)(context);
+                const first = multi?.[0];
+                if (first && !first.success) {
+                    (0, index_js_1.runOnBlocked)(context, first.state, events, 'if.event.put_blocked', first.error ?? result.error);
+                }
+            }
+        }
+        return events;
     }
 };
 //# sourceMappingURL=putting.js.map