@sharpee/stdlib 3.0.0 → 3.1.0

package/actions/standard/talking/talking.d.ts

@@ -9,9 +9,24 @@
  * 2. execute: Analyze conversation state (no world mutations)
  * 3. blocked: Handle validation failures
  * 4. report: Emit talked event and success message
+ *
+ * Interceptor consultation (ADR-118) runs through the shared lifecycle
+ * engine (ADR-228) via `talkingLifecycle` — no hand-rolled hook plumbing.
  */
 import { Action } from '../../enhanced-types';
 import { ActionMetadata } from '../../../validation';
+import { ActionLifecycleDescriptor } from '../../lifecycle';
+/**
+ * Interceptor surface (ADR-228): the person talked to is the only
+ * consultable entity of a TALK command.
+ *
+ * Wiring this closed a live Dungeo dead-registration bug (ADR-118 hook
+ * audit): `TrollTalkingInterceptor` — a preValidate veto implementing the
+ * MDL-canon "Unfortunately, the troll can't hear you" when the troll is
+ * incapacitated — was registered under `if.action.talking` but never
+ * consulted, because talking was unwired.
+ */
+export declare const talkingLifecycle: ActionLifecycleDescriptor;
 export declare const talkingAction: Action & {
     metadata: ActionMetadata;
 };

package/actions/standard/talking/talking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"talking.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/talking/talking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAK/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAiBrD,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAoM9D,CAAC"}
+{"version":3,"file":"talking.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/talking/talking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAK/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EACL,yBAAyB,EAQ1B,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE,yBAS9B,CAAC;AAeF,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAgO9D,CAAC"}

package/actions/standard/talking/talking.js

@@ -10,13 +10,37 @@
  * 2. execute: Analyze conversation state (no world mutations)
  * 3. blocked: Handle validation failures
  * 4. report: Emit talked event and success message
+ *
+ * Interceptor consultation (ADR-118) runs through the shared lifecycle
+ * engine (ADR-228) via `talkingLifecycle` — no hand-rolled hook plumbing.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.talkingAction = void 0;
+exports.talkingAction = exports.talkingLifecycle = void 0;
 const world_model_1 = require("@sharpee/world-model");
 const constants_1 = require("../../constants");
 const types_1 = require("../../../scope/types");
 const utils_1 = require("../../../utils");
+const lifecycle_1 = require("../../lifecycle");
+/**
+ * Interceptor surface (ADR-228): the person talked to is the only
+ * consultable entity of a TALK command.
+ *
+ * Wiring this closed a live Dungeo dead-registration bug (ADR-118 hook
+ * audit): `TrollTalkingInterceptor` — a preValidate veto implementing the
+ * MDL-canon "Unfortunately, the troll can't hear you" when the troll is
+ * incapacitated — was registered under `if.action.talking` but never
+ * consulted, because talking was unwired.
+ */
+exports.talkingLifecycle = {
+    actionId: constants_1.IFActions.TALKING,
+    slots: [
+        {
+            id: 'target',
+            actionIds: [constants_1.IFActions.TALKING],
+            resolve: (ctx) => ctx.command.directObject?.entity
+        }
+    ]
+};
 function getTalkingSharedData(context) {
     return context.sharedData;
 }
@@ -52,6 +76,10 @@ exports.talkingAction = {
                 error: 'no_target'
             };
         }
+        const state = (0, lifecycle_1.resolveLifecycle)(context, exports.talkingLifecycle);
+        const preVeto = (0, lifecycle_1.runPreValidate)(context, state);
+        if (preVeto)
+            return preVeto;
         // Check if target is visible
         if (!context.canSee(target)) {
             return {
@@ -94,6 +122,10 @@ exports.talkingAction = {
                 params: { target: (0, utils_1.nounPhraseFor)(target) }
             };
         }
+        // Canonical placement (ADR-228): postValidate runs after ALL standard validation
+        const postVeto = (0, lifecycle_1.runPostValidate)(context, state);
+        if (postVeto)
+            return postVeto;
         return { valid: true };
     },
     execute(context) {
@@ -164,12 +196,20 @@ exports.talkingAction = {
         sharedData.targetName = target.name;
         sharedData.messageId = messageId;
         sharedData.eventData = eventData;
+        const state = (0, lifecycle_1.getLifecycleState)(context);
+        if (state)
+            (0, lifecycle_1.runPostExecute)(context, state);
     },
     blocked(context, result) {
         const target = context.command.directObject?.entity;
-        return [context.event('if.event.talk_blocked', {
+        // Fully-qualified message IDs (containing dots) are used as-is —
+        // e.g. an interceptor veto like 'dungeo.troll.cant_hear_you';
+        // short keys (e.g. 'not_visible') get the action ID prefix
+        const error = result.error || '';
+        const messageId = error.includes('.') ? error : `${context.action.id}.${error}`;
+        const events = [context.event('if.event.talk_blocked', {
                 blocked: true,
-                messageId: `${context.action.id}.${result.error}`,
+                messageId,
                 // params carry EntityInfo for the formatter chain (ADR-158)
                 params: {
                     ...result.params,
@@ -179,6 +219,12 @@ exports.talkingAction = {
                 targetId: target?.id,
                 targetName: target?.name
             })];
+        if (result.error) {
+            const state = (0, lifecycle_1.getLifecycleState)(context);
+            if (state)
+                (0, lifecycle_1.runOnBlocked)(context, state, events, 'if.event.talk_blocked', result.error);
+        }
+        return events;
     },
     report(context) {
         const events = [];
@@ -191,6 +237,9 @@ exports.talkingAction = {
             params: { target: target ? (0, utils_1.nounPhraseFor)(target) : { name: sharedData.targetName } },
             ...sharedData.eventData
         }));
+        const state = (0, lifecycle_1.getLifecycleState)(context);
+        if (state)
+            (0, lifecycle_1.runPostReport)(context, state, events, 'if.event.talked');
         return events;
     },
     group: "social",

package/actions/standard/talking/talking.js.map

@@ -1 +1 @@
-{"version":3,"file":"talking.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/talking/talking.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"talking.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/talking/talking.ts"],"names":[],"mappings":"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"}

package/actions/standard/telling/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Telling action (ADR-230 Phase 6) — public exports.
+ */
+export { tellingAction, tellingLifecycle } from './telling';
+//# sourceMappingURL=index.d.ts.map

package/actions/standard/telling/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/telling/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC"}

package/actions/standard/telling/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tellingLifecycle = exports.tellingAction = void 0;
+/**
+ * Telling action (ADR-230 Phase 6) — public exports.
+ */
+var telling_1 = require("./telling");
+Object.defineProperty(exports, "tellingAction", { enumerable: true, get: function () { return telling_1.tellingAction; } });
+Object.defineProperty(exports, "tellingLifecycle", { enumerable: true, get: function () { return telling_1.tellingLifecycle; } });
+//# sourceMappingURL=index.js.map

package/actions/standard/telling/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/telling/index.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,qCAA4D;AAAnD,wGAAA,aAAa,OAAA;AAAE,2GAAA,gBAAgB,OAAA"}

package/actions/standard/telling/telling.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Telling action (ADR-230 Phase 6, sketch ruling 4) — minimal interceptable
+ * TELL :recipient ABOUT :topic.
+ *
+ * TELL is a core IF verb players constantly try, but there is no platform
+ * conversation system yet: this action validates the social preconditions
+ * and reports a helpful default ("X doesn't seem interested") that
+ * per-entity interceptors (or a future conversation extension) override.
+ * No world mutation, ever.
+ *
+ * Four-phase pattern; interceptor consultation through the shared
+ * lifecycle engine (ADR-228) via `tellingLifecycle`.
+ */
+import { Action } from '../../enhanced-types';
+import { ActionMetadata } from '../../../validation';
+import { ActionLifecycleDescriptor } from '../../lifecycle';
+/**
+ * Interceptor surface (ADR-228): the person told is the only consultable
+ * entity of a TELL command.
+ */
+export declare const tellingLifecycle: ActionLifecycleDescriptor;
+export declare const tellingAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=telling.d.ts.map

package/actions/standard/telling/telling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telling.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/telling/telling.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAI/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EACL,yBAAyB,EAQ1B,MAAM,iBAAiB,CAAC;AAEzB;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,yBAS9B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAoF9D,CAAC"}

package/actions/standard/telling/telling.js

@@ -0,0 +1,114 @@
+"use strict";
+/**
+ * Telling action (ADR-230 Phase 6, sketch ruling 4) — minimal interceptable
+ * TELL :recipient ABOUT :topic.
+ *
+ * TELL is a core IF verb players constantly try, but there is no platform
+ * conversation system yet: this action validates the social preconditions
+ * and reports a helpful default ("X doesn't seem interested") that
+ * per-entity interceptors (or a future conversation extension) override.
+ * No world mutation, ever.
+ *
+ * Four-phase pattern; interceptor consultation through the shared
+ * lifecycle engine (ADR-228) via `tellingLifecycle`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tellingAction = exports.tellingLifecycle = void 0;
+const world_model_1 = require("@sharpee/world-model");
+const constants_1 = require("../../constants");
+const types_1 = require("../../../scope/types");
+const utils_1 = require("../../../utils");
+const lifecycle_1 = require("../../lifecycle");
+/**
+ * Interceptor surface (ADR-228): the person told is the only consultable
+ * entity of a TELL command.
+ */
+exports.tellingLifecycle = {
+    actionId: constants_1.IFActions.TELLING,
+    slots: [
+        {
+            id: 'target',
+            actionIds: [constants_1.IFActions.TELLING],
+            resolve: (ctx) => ctx.command.directObject?.entity
+        }
+    ]
+};
+exports.tellingAction = {
+    id: constants_1.IFActions.TELLING,
+    requiredMessages: ['no_target', 'not_visible', 'too_far', 'not_actor', 'not_interested'],
+    group: 'social',
+    metadata: {
+        requiresDirectObject: true,
+        requiresIndirectObject: false,
+        directObjectScope: types_1.ScopeLevel.AWARE
+    },
+    validate(context) {
+        const target = context.command.directObject?.entity;
+        if (!target) {
+            return { valid: false, error: 'no_target' };
+        }
+        const state = (0, lifecycle_1.resolveLifecycle)(context, exports.tellingLifecycle);
+        const preVeto = (0, lifecycle_1.runPreValidate)(context, state);
+        if (preVeto)
+            return preVeto;
+        if (!context.canSee(target)) {
+            return { valid: false, error: 'not_visible' };
+        }
+        if (context.world.getLocation(target.id) !== context.world.getLocation(context.player.id)) {
+            return { valid: false, error: 'too_far' };
+        }
+        if (!target.has(world_model_1.TraitType.ACTOR)) {
+            return { valid: false, error: 'not_actor', params: { target: (0, utils_1.nounPhraseFor)(target) } };
+        }
+        const postVeto = (0, lifecycle_1.runPostValidate)(context, state);
+        if (postVeto)
+            return postVeto;
+        return { valid: true };
+    },
+    execute(context) {
+        // No world mutation — asking is pure conversation surface.
+        const state = (0, lifecycle_1.getLifecycleState)(context);
+        if (state)
+            (0, lifecycle_1.runPostExecute)(context, state);
+    },
+    blocked(context, result) {
+        const target = context.command.directObject?.entity;
+        const error = result.error || '';
+        const messageId = error.includes('.') ? error : `${context.action.id}.${error}`;
+        const events = [
+            context.event('if.event.tell_blocked', {
+                blocked: true,
+                messageId,
+                params: { ...result.params, target: target ? (0, utils_1.nounPhraseFor)(target) : undefined },
+                reason: result.error,
+                targetId: target?.id,
+                targetName: target?.name
+            })
+        ];
+        if (result.error) {
+            const state = (0, lifecycle_1.getLifecycleState)(context);
+            if (state)
+                (0, lifecycle_1.runOnBlocked)(context, state, events, 'if.event.tell_blocked', result.error);
+        }
+        return events;
+    },
+    report(context) {
+        const target = context.command.directObject.entity;
+        const topic = context.command.indirectObject?.parsed?.text ??
+            context.command.parsed?.structure?.extras?.topic;
+        const events = [
+            context.event('if.event.told', {
+                messageId: `${context.action.id}.not_interested`,
+                params: { target: (0, utils_1.nounPhraseFor)(target), topic },
+                targetId: target.id,
+                targetName: target.name,
+                topic
+            })
+        ];
+        const state = (0, lifecycle_1.getLifecycleState)(context);
+        if (state)
+            (0, lifecycle_1.runPostReport)(context, state, events, 'if.event.told');
+        return events;
+    }
+};
+//# sourceMappingURL=telling.js.map

package/actions/standard/telling/telling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telling.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/telling/telling.ts"],"names":[],"mappings":"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"}

package/actions/standard/throwing/throwing.d.ts

@@ -14,6 +14,17 @@
  */
 import { Action } from '../../enhanced-types';
 import { ActionMetadata } from '../../../validation';
+import { ActionLifecycleDescriptor } from '../../lifecycle';
+/**
+ * Interceptor surface (ADR-228): BOTH the thrown item and the target are
+ * consulted, in the published D3-B order (direct object first). This
+ * retires the audit's single-winner rule (target-else-item) — a glacier
+ * can react to being hit AND an explosive can react to being thrown in
+ * the same command. Both consultations are seeded with the full
+ * item/target context (the receiving entity's hooks read `itemId` to
+ * know what hit them).
+ */
+export declare const throwingLifecycle: ActionLifecycleDescriptor;
 export declare const throwingAction: Action & {
     metadata: ActionMetadata;
 };

package/actions/standard/throwing/throwing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"throwing.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/throwing/throwing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAoGrD,eAAO,MAAM,cAAc,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA2b/D,CAAC"}
+{"version":3,"file":"throwing.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/throwing/throwing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAoBrD,OAAO,EACL,yBAAyB,EAQ1B,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,EAAE,yBA0B/B,CAAC;AA0EF,eAAO,MAAM,cAAc,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA6Y/D,CAAC"}

package/actions/standard/throwing/throwing.js

@@ -14,11 +14,48 @@
  * 4. report: standard events → postReport hook (additional effects)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.throwingAction = void 0;
+exports.throwingAction = exports.throwingLifecycle = void 0;
 const world_model_1 = require("@sharpee/world-model");
 const constants_1 = require("../../constants");
 const types_1 = require("../../../scope/types");
 const utils_1 = require("../../../utils");
+const lifecycle_1 = require("../../lifecycle");
+/**
+ * Interceptor surface (ADR-228): BOTH the thrown item and the target are
+ * consulted, in the published D3-B order (direct object first). This
+ * retires the audit's single-winner rule (target-else-item) — a glacier
+ * can react to being hit AND an explosive can react to being thrown in
+ * the same command. Both consultations are seeded with the full
+ * item/target context (the receiving entity's hooks read `itemId` to
+ * know what hit them).
+ */
+exports.throwingLifecycle = {
+    actionId: constants_1.IFActions.THROWING,
+    slots: [
+        {
+            id: 'item',
+            actionIds: [constants_1.IFActions.THROWING],
+            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
+            })
+        },
+        {
+            id: 'target',
+            actionIds: [constants_1.IFActions.THROWING],
+            resolve: (ctx) => ctx.command.indirectObject?.entity,
+            seedData: (ctx, entity) => ({
+                itemId: ctx.command.directObject?.entity?.id,
+                itemName: ctx.command.directObject?.entity?.name,
+                targetId: entity.id,
+                targetName: entity.name
+            })
+        }
+    ]
+};
 /**
  * Helper to convert a string direction to Direction constant
  */
@@ -101,34 +138,13 @@ exports.throwingAction = {
         const item = context.command.directObject?.entity;
         const target = context.command.indirectObject?.entity;
         const direction = context.command.parsed.extras?.direction;
-        const sharedData = getThrowingSharedData(context);
         if (!item) {
             return { valid: false, error: 'no_item' };
         }
-        // Check for interceptor on the target entity (ADR-118)
-        // Interceptors are on the thing being thrown AT, not the item being thrown
-        const interceptorResult = target ? context.world.getInterceptorForAction(target, constants_1.IFActions.THROWING) : undefined;
-        const interceptor = interceptorResult?.interceptor;
-        const interceptorData = {
-            // Pass item info to interceptor so it knows what's being thrown
-            itemId: item.id,
-            itemName: item.name
-        };
-        // Store for later phases
-        sharedData.interceptor = interceptor;
-        sharedData.interceptorData = interceptorData;
-        // === PRE-VALIDATE HOOK ===
-        // Called before standard validation - can block early
-        if (interceptor?.preValidate && target) {
-            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, lifecycle_1.resolveLifecycle)(context, exports.throwingLifecycle);
+        const preVeto = (0, lifecycle_1.runPreValidate)(context, state);
+        if (preVeto)
+            return preVeto;
         // Item must be carried (or implicitly takeable)
         // This enables "throw apple at bob" when apple is on the ground
         const carryCheck = context.requireCarriedOrImplicitTake(item);
@@ -178,18 +194,10 @@ exports.throwingAction = {
                 };
             }
         }
-        // === POST-VALIDATE HOOK ===
-        // Called after standard validation passes - can add entity-specific conditions
-        if (interceptor?.postValidate && target) {
-            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, lifecycle_1.runPostValidate)(context, state);
+        if (postVeto)
+            return postVeto;
         return { valid: true };
     },
     execute(context) {
@@ -239,6 +247,11 @@ exports.throwingAction = {
                     sharedData.capabilityBehavior = behavior;
                     sharedData.capabilityTrait = capTrait;
                     behavior.execute(target, context.world, context.player.id, context.sharedData);
+                    // ADR-228 D7.2: capability behavior first, then interceptor
+                    // hooks — this path previously returned before postExecute.
+                    const capState = (0, lifecycle_1.getLifecycleState)(context);
+                    if (capState)
+                        (0, lifecycle_1.runPostExecute)(context, capState);
                     return;
                 }
             }
@@ -346,31 +359,15 @@ exports.throwingAction = {
             // The event system will handle actual removal if needed
             context.world.moveEntity(item.id, ''); // Empty string = nowhere
         }
-        // === POST-EXECUTE HOOK ===
-        // Called after standard execution - can perform additional mutations
-        const interceptor = sharedData.interceptor;
-        const interceptorData = sharedData.interceptorData || {};
-        if (interceptor?.postExecute && target) {
-            interceptor.postExecute(target, context.world, actor.id, interceptorData);
-        }
+        const state = (0, lifecycle_1.getLifecycleState)(context);
+        if (state)
+            (0, lifecycle_1.runPostExecute)(context, state);
     },
     blocked(context, result) {
         const item = context.command.directObject?.entity;
         const target = context.command.indirectObject?.entity;
-        const sharedData = getThrowingSharedData(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 — params carry EntityInfo (ADR-158)
-        return [context.event('if.event.throw_blocked', {
+        const events = [context.event('if.event.throw_blocked', {
                 blocked: true,
                 messageId: `${context.action.id}.${result.error}`,
                 params: {
@@ -384,6 +381,12 @@ exports.throwingAction = {
                 targetId: target?.id,
                 targetName: target?.name
             })];
+        if (result.error) {
+            const state = (0, lifecycle_1.getLifecycleState)(context);
+            if (state)
+                (0, lifecycle_1.runOnBlocked)(context, state, events, 'if.event.throw_blocked', result.error);
+        }
+        return events;
     },
     report(context) {
         const sharedData = getThrowingSharedData(context);
@@ -399,6 +402,11 @@ exports.throwingAction = {
                 const effects = sharedData.capabilityBehavior.report(target, context.world, context.player.id, context.sharedData);
                 events.push(...effectsToEvents(effects, context));
             }
+            // ADR-228 D7.2: capability behavior first, then interceptor hooks —
+            // this path previously returned before postReport.
+            const capState = (0, lifecycle_1.getLifecycleState)(context);
+            if (capState)
+                (0, lifecycle_1.runPostReport)(context, capState, events, 'if.event.thrown');
             return events;
         }
         // Build event data with messageId for text rendering
@@ -443,18 +451,9 @@ exports.throwingAction = {
                 targetName: sharedData.targetName
             }));
         }
-        // === POST-REPORT HOOK ===
-        // Apply interceptor's override (replaces if.event.thrown.messageId)
-        // and/or emit (additional events). See ISSUE-074.
-        const interceptor = sharedData.interceptor;
-        const interceptorData = sharedData.interceptorData || {};
-        if (interceptor?.postReport) {
-            const target = context.command.indirectObject?.entity;
-            if (target) {
-                const result = interceptor.postReport(target, context.world, context.player.id, interceptorData);
-                (0, world_model_1.applyInterceptorReportResult)(events, 'if.event.thrown', result, context);
-            }
-        }
+        const state = (0, lifecycle_1.getLifecycleState)(context);
+        if (state)
+            (0, lifecycle_1.runPostReport)(context, state, events, 'if.event.thrown');
         return events;
     },
     group: "interaction"