@sharpee/stdlib 2.2.0 → 3.1.0

package/actions/standard/entering/entering.js

@@ -5,18 +5,36 @@
  * This action handles entering objects that have the ENTRY trait or
  * are containers/supporters marked as enterable.
  *
- * Uses four-phase pattern with interceptor support (ADR-118):
- * 1. validate: preValidate hook → standard checks → postValidate hook
- * 2. execute: standard mutation → postExecute hook
- * 3. blocked: onBlocked hook (if validation failed)
- * 4. report: standard events → postReport hook (additional effects)
+ * Uses four-phase pattern:
+ * 1. validate: Check target exists and can be entered
+ * 2. execute: Move the actor into the target
+ * 3. blocked: Generate error events when validation fails
+ * 4. report: Generate success events
+ *
+ * Interceptor consultation (ADR-118) runs through the shared lifecycle
+ * engine (ADR-228) via `enteringLifecycle` — no hand-rolled hook plumbing.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.enteringAction = void 0;
+exports.enteringAction = exports.enteringLifecycle = void 0;
 const world_model_1 = require("@sharpee/world-model");
 const constants_1 = require("../../constants");
 const entering_messages_1 = require("./entering-messages");
 const utils_1 = require("../../../utils");
+const lifecycle_1 = require("../../lifecycle");
+/**
+ * Interceptor surface (ADR-228): the entered target is the only
+ * consultable entity of an ENTER command.
+ */
+exports.enteringLifecycle = {
+    actionId: constants_1.IFActions.ENTERING,
+    slots: [
+        {
+            id: 'target',
+            actionIds: [constants_1.IFActions.ENTERING],
+            resolve: (ctx) => ctx.command.directObject?.entity
+        }
+    ]
+};
 function getEnteringSharedData(context) {
     return context.sharedData;
 }
@@ -41,7 +59,6 @@ exports.enteringAction = {
     validate(context) {
         const actor = context.player;
         const target = context.command.directObject?.entity;
-        const sharedData = getEnteringSharedData(context);
         // Validate target
         if (!target) {
             return {
@@ -49,25 +66,10 @@ exports.enteringAction = {
                 error: entering_messages_1.EnteringMessages.NO_TARGET
             };
         }
-        // Check for interceptor on the target entity (ADR-118)
-        const interceptorResult = context.world.getInterceptorForAction(target, constants_1.IFActions.ENTERING);
-        const interceptor = interceptorResult?.interceptor;
-        const interceptorData = {};
-        // 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, lifecycle_1.resolveLifecycle)(context, exports.enteringLifecycle);
+        const preVeto = (0, lifecycle_1.runPreValidate)(context, state);
+        if (preVeto)
+            return preVeto;
         // Check scope - must be able to reach the target
         const scopeCheck = context.requireScope(target, types_1.ScopeLevel.REACHABLE);
         if (!scopeCheck.ok) {
@@ -98,18 +100,10 @@ exports.enteringAction = {
                 params: { container: (0, utils_1.nounPhraseFor)(target) }
             };
         }
-        // === 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, lifecycle_1.runPostValidate)(context, state);
+        if (postVeto)
+            return postVeto;
         return { valid: true };
     },
     /**
@@ -134,13 +128,9 @@ exports.enteringAction = {
             preposition
         };
         sharedData.enteringState = state;
-        // === 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);
-        }
+        const lifecycleState = (0, lifecycle_1.getLifecycleState)(context);
+        if (lifecycleState)
+            (0, lifecycle_1.runPostExecute)(context, lifecycleState);
     },
     /**
      * Report events after successful entering
@@ -172,15 +162,9 @@ exports.enteringAction = {
                 fromLocation: state.fromLocation,
                 preposition: state.preposition
             })];
-        // === POST-REPORT HOOK ===
-        // Apply interceptor's override (replaces if.event.entered.messageId)
-        // and/or emit (additional events). See ISSUE-074.
-        const interceptor = sharedData.interceptor;
-        const interceptorData = sharedData.interceptorData || {};
-        if (interceptor?.postReport && target) {
-            const result = interceptor.postReport(target, context.world, context.player.id, interceptorData);
-            (0, world_model_1.applyInterceptorReportResult)(events, 'if.event.entered', result, context);
-        }
+        const lifecycleState = (0, lifecycle_1.getLifecycleState)(context);
+        if (lifecycleState)
+            (0, lifecycle_1.runPostReport)(context, lifecycleState, events, 'if.event.entered');
         return events;
     },
     /**
@@ -189,20 +173,8 @@ exports.enteringAction = {
      */
     blocked(context, result) {
         const target = context.command.directObject?.entity;
-        const sharedData = getEnteringSharedData(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.entered', {
+        const events = [context.event('if.event.entered', {
                 blocked: true,
                 messageId: `${context.action.id}.${result.error}`,
                 params: { place: target ? (0, utils_1.nounPhraseFor)(target) : undefined, ...result.params },
@@ -210,6 +182,12 @@ exports.enteringAction = {
                 targetId: target?.id,
                 targetName: target?.name
             })];
+        if (result.error) {
+            const lifecycleState = (0, lifecycle_1.getLifecycleState)(context);
+            if (lifecycleState)
+                (0, lifecycle_1.runOnBlocked)(context, lifecycleState, events, 'if.event.entered', result.error);
+        }
+        return events;
     },
     metadata: {
         requiresDirectObject: true,

package/actions/standard/entering/entering.js.map

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

package/actions/standard/examining/examining.d.ts

@@ -12,6 +12,12 @@
  */
 import { Action } from '../../enhanced-types';
 import { ActionMetadata } from '../../../validation';
+import { ActionLifecycleDescriptor } from '../../lifecycle';
+/**
+ * Interceptor surface (ADR-228): the examined target is the only
+ * consultable entity of an EXAMINE command.
+ */
+export declare const examiningLifecycle: ActionLifecycleDescriptor;
 export declare const examiningAction: Action & {
     metadata: ActionMetadata;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"examining.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/examining/examining.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAYrD,eAAO,MAAM,eAAe,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAwHhE,CAAC"}
+{"version":3,"file":"examining.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/examining/examining.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAG/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAMrD,OAAO,EACL,yBAAyB,EAQ1B,MAAM,iBAAiB,CAAC;AAEzB;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,yBAShC,CAAC;AAOF,eAAO,MAAM,eAAe,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA6IhE,CAAC"}

package/actions/standard/examining/examining.js

@@ -12,12 +12,27 @@
  * 4. blocked: Generate error events when validation fails
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.examiningAction = void 0;
+exports.examiningAction = exports.examiningLifecycle = void 0;
 const constants_1 = require("../../constants");
 const types_1 = require("../../../scope/types");
 const emit_illustrations_1 = require("../../helpers/emit-illustrations");
 const data_builder_types_1 = require("../../data-builder-types");
 const world_model_1 = require("@sharpee/world-model");
+const lifecycle_1 = require("../../lifecycle");
+/**
+ * Interceptor surface (ADR-228): the examined target is the only
+ * consultable entity of an EXAMINE command.
+ */
+exports.examiningLifecycle = {
+    actionId: constants_1.IFActions.EXAMINING,
+    slots: [
+        {
+            id: 'target',
+            actionIds: [constants_1.IFActions.EXAMINING],
+            resolve: (ctx) => ctx.command.directObject?.entity
+        }
+    ]
+};
 // Import our data builder
 const examining_data_1 = require("./examining-data");
 const examining_messages_1 = require("./examining-messages");
@@ -54,6 +69,10 @@ exports.examiningAction = {
                 error: examining_messages_1.ExaminingMessages.NO_TARGET
             };
         }
+        const state = (0, lifecycle_1.resolveLifecycle)(context, exports.examiningLifecycle);
+        const preVeto = (0, lifecycle_1.runPreValidate)(context, state);
+        if (preVeto)
+            return preVeto;
         // Check scope - must be able to see the target (unless examining yourself)
         if (noun.id !== actor.id) {
             const scopeCheck = context.requireScope(noun, types_1.ScopeLevel.VISIBLE);
@@ -61,11 +80,19 @@ exports.examiningAction = {
                 return scopeCheck.error;
             }
         }
+        // Canonical placement (ADR-228): postValidate runs after ALL standard validation
+        const postVeto = (0, lifecycle_1.runPostValidate)(context, state);
+        if (postVeto)
+            return postVeto;
         // Valid - all event data will be built in report()
         return { valid: true };
     },
     execute(context) {
-        // No mutations - examining is a read-only action
+        // No standard mutations - examining is a read-only action.
+        // Interceptor postExecute hooks may still mutate (ADR-228).
+        const state = (0, lifecycle_1.getLifecycleState)(context);
+        if (state)
+            (0, lifecycle_1.runPostExecute)(context, state);
     },
     report(context) {
         // report() is only called on success - validation passed
@@ -101,12 +128,15 @@ exports.examiningAction = {
                 isContentsMessage: true
             }));
         }
+        const state = (0, lifecycle_1.getLifecycleState)(context);
+        if (state)
+            (0, lifecycle_1.runPostReport)(context, state, events, 'if.event.examined');
         return events;
     },
     blocked(context, result) {
         // blocked() is called when validation fails
         const noun = context.command.directObject?.entity;
-        return [context.event('if.event.examined', {
+        const events = [context.event('if.event.examined', {
                 blocked: true,
                 messageId: `${context.action.id}.${result.error}`,
                 // params carry EntityInfo for the formatter chain (ADR-158);
@@ -116,6 +146,12 @@ exports.examiningAction = {
                 targetId: noun?.id,
                 targetName: noun?.name
             })];
+        if (result.error) {
+            const state = (0, lifecycle_1.getLifecycleState)(context);
+            if (state)
+                (0, lifecycle_1.runOnBlocked)(context, state, events, 'if.event.examined', result.error);
+        }
+        return events;
     },
     group: "observation",
     metadata: {

package/actions/standard/examining/examining.js.map

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

package/actions/standard/exiting/exiting.d.ts

@@ -4,6 +4,12 @@
  * This action handles exiting objects that the actor is currently inside/on.
  */
 import { Action } from '../../enhanced-types';
+import { ActionLifecycleDescriptor } from '../../lifecycle';
+/**
+ * Interceptor surface (ADR-228): the container/supporter being exited —
+ * `on exiting it` on a boat, cage, or bed fires here.
+ */
+export declare const exitingLifecycle: ActionLifecycleDescriptor;
 import { ActionMetadata } from '../../../validation';
 export declare const exitingAction: Action & {
     metadata: ActionMetadata;

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

@@ -1 +1 @@
-{"version":3,"file":"exiting.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/exiting/exiting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAA0D,MAAM,sBAAsB,CAAC;AA6BtG,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAmJ9D,CAAC"}
+{"version":3,"file":"exiting.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/exiting/exiting.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAA0D,MAAM,sBAAsB,CAAC;AAWtG,OAAO,EACL,yBAAyB,EAQ1B,MAAM,iBAAiB,CAAC;AAgBzB;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,yBAS9B,CAAC;AAoBF,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA0K9D,CAAC"}

package/actions/standard/exiting/exiting.js

@@ -5,11 +5,41 @@
  * This action handles exiting objects that the actor is currently inside/on.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.exitingAction = void 0;
+exports.exitingAction = exports.exitingLifecycle = void 0;
 const world_model_1 = require("@sharpee/world-model");
 const constants_1 = require("../../constants");
 const exiting_messages_1 = require("./exiting-messages");
 const utils_1 = require("../../../utils");
+const lifecycle_1 = require("../../lifecycle");
+/**
+ * The enterable the actor is currently inside/on — exiting's affected
+ * entity is never a parsed object (EXIT takes no noun), so it resolves
+ * implicitly from the actor's location (ADR-228 D3 implicit-entity slot).
+ * Resolves undefined when the actor is directly in a room.
+ */
+function resolveCurrentContainer(context) {
+    const currentLocation = context.world.getLocation(context.player.id);
+    if (!currentLocation)
+        return undefined;
+    const container = context.world.getEntity(currentLocation);
+    if (!container || container.has(world_model_1.TraitType.ROOM))
+        return undefined;
+    return container;
+}
+/**
+ * Interceptor surface (ADR-228): the container/supporter being exited —
+ * `on exiting it` on a boat, cage, or bed fires here.
+ */
+exports.exitingLifecycle = {
+    actionId: constants_1.IFActions.EXITING,
+    slots: [
+        {
+            id: 'container',
+            actionIds: [constants_1.IFActions.EXITING],
+            resolve: resolveCurrentContainer
+        }
+    ]
+};
 function getExitingSharedData(context) {
     return context.sharedData;
 }
@@ -28,6 +58,10 @@ exports.exitingAction = {
     validate(context) {
         const actor = context.player;
         const currentLocation = context.world.getLocation(actor.id);
+        const state = (0, lifecycle_1.resolveLifecycle)(context, exports.exitingLifecycle);
+        const preVeto = (0, lifecycle_1.runPreValidate)(context, state);
+        if (preVeto)
+            return preVeto;
         if (!currentLocation) {
             return {
                 valid: false,
@@ -68,6 +102,10 @@ exports.exitingAction = {
                 };
             }
         }
+        // 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 };
     },
     /**
@@ -98,6 +136,9 @@ exports.exitingAction = {
         };
         const sharedData = getExitingSharedData(context);
         sharedData.exitingState = state;
+        const lifecycleState = (0, lifecycle_1.getLifecycleState)(context);
+        if (lifecycleState)
+            (0, lifecycle_1.runPostExecute)(context, lifecycleState);
     },
     /**
      * Report phase - generates events after successful execution
@@ -120,7 +161,7 @@ exports.exitingAction = {
         // params carry EntityInfo for the formatter chain (ADR-158);
         // re-derive from the entity since it's available via context.world.
         const fromEntity = context.world.getEntity(state.fromLocation);
-        return [context.event('if.event.exited', {
+        const events = [context.event('if.event.exited', {
                 messageId: `${context.action.id}.exited`,
                 params: { place: fromEntity ? (0, utils_1.nounPhraseFor)(fromEntity) : { name: state.fromLocationName } },
                 fromLocation: state.fromLocation,
@@ -128,18 +169,28 @@ exports.exitingAction = {
                 toLocation: state.toLocation,
                 preposition: state.preposition
             })];
+        const lifecycleState = (0, lifecycle_1.getLifecycleState)(context);
+        if (lifecycleState)
+            (0, lifecycle_1.runPostReport)(context, lifecycleState, events, 'if.event.exited');
+        return events;
     },
     /**
      * Generate events when validation fails
      * Called instead of execute/report when validate returns invalid
      */
     blocked(context, result) {
-        return [context.event('if.event.exited', {
+        const events = [context.event('if.event.exited', {
                 blocked: true,
                 messageId: `${context.action.id}.${result.error}`,
                 params: result.params || {},
                 reason: result.error
             })];
+        if (result.error) {
+            const state = (0, lifecycle_1.getLifecycleState)(context);
+            if (state)
+                (0, lifecycle_1.runOnBlocked)(context, state, events, 'if.event.exited', result.error);
+        }
+        return events;
     },
     metadata: {
         requiresDirectObject: false,

package/actions/standard/exiting/exiting.js.map

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

package/actions/standard/giving/giving.d.ts

@@ -9,9 +9,30 @@
  * 2. execute: Transfer item, store result in sharedData
  * 3. blocked: Generate events when validation fails
  * 4. report: Generate success events from sharedData
+ *
+ * Interceptor consultation (ADR-118) runs through the shared lifecycle
+ * engine (ADR-228) via `givingLifecycle` — no hand-rolled hook plumbing.
  */
 import { Action } from '../../enhanced-types';
 import { ActionMetadata } from '../../../validation';
+import { ActionLifecycleDescriptor } from '../../lifecycle';
+/**
+ * Interceptor surface (ADR-228): BOTH the given item and the recipient
+ * are consulted (D3-B published order: direct object first), each side's
+ * sharedData seeded with the other entity's identity (D3 sub-ruling —
+ * symmetric context, same shape as putting's descriptor).
+ *
+ * Item-side limitation (ADR-118 hook audit): before this wiring the item
+ * side was fully dead — no validate-phase block was possible; giving's
+ * only story seam was the recipient's execute-phase-only ADR-090
+ * capability behavior (see execute() below). The item slot is declared
+ * anyway per the Phase-5 ruling — documenting the limitation beats
+ * silently omitting the slot. Note also: when an ADR-090 capability
+ * behavior handles the give, report() is delegated to it and no
+ * `if.event.given` primary event exists for a postReport override to
+ * target (the engine's defensive warn fires instead; `emit` still works).
+ */
+export declare const givingLifecycle: ActionLifecycleDescriptor;
 export declare const givingAction: Action & {
     metadata: ActionMetadata;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"giving.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/giving/giving.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAwCrD,eAAO,MAAM,YAAY,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA2Q7D,CAAC"}
+{"version":3,"file":"giving.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/giving/giving.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAerD,OAAO,EACL,yBAAyB,EAQ1B,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,EAAE,yBA0B7B,CAAC;AA0BF,eAAO,MAAM,YAAY,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAuS7D,CAAC"}