@sharpee/stdlib 3.0.0 → 3.3.0

package/actions/standard/tool-shared.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Shared tool-requirement validation for tool-gated actions (ADR-230 D3).
+ *
+ * Mirrors validateKeyRequirements (lock-shared.ts) for the author-configured
+ * tool pattern: a trait declares which tool works (toolId/toolIds), the
+ * action's validate() calls this helper, and an entity with no tool
+ * requirement ignores an offered tool exactly as a keyless lockable ignores
+ * keyless LOCK. Used by opening (D3b) and cutting (D3c).
+ *
+ * Public interface: TOOL_MESSAGES, validateToolRequirements().
+ * Owner context: stdlib standard actions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TOOL_MESSAGES = void 0;
+exports.validateToolRequirements = validateToolRequirements;
+const index_js_1 = require("../../utils/index.js");
+/**
+ * Shared message constants for tool validation.
+ * These are message IDs, not English strings - lang-en-us resolves them.
+ */
+exports.TOOL_MESSAGES = {
+    NO_TOOL: 'no_tool',
+    TOOL_NOT_HELD: 'tool_not_held',
+    WRONG_TOOL: 'wrong_tool',
+};
+/**
+ * Validates an action's tool requirement against the command's tool.
+ *
+ * @param context action context (for actor/world lookups)
+ * @param target the tool-gated entity
+ * @param tool the command's explicit tool entity, if any
+ * @param requiresTool whether the target declares a tool requirement
+ *   (e.g. OpenableBehavior.requiresTool(target))
+ * @param canUseWith trait-specific predicate for "this tool works"
+ *   (e.g. (id) => OpenableBehavior.canOpenWith(target, id))
+ * @returns a failed ValidationResult, or null when validation passes
+ */
+function validateToolRequirements(context, target, tool, requiresTool, canUseWith) {
+    if (!requiresTool) {
+        return null; // No tool required — an offered tool is ignored, not an error
+    }
+    // Tool is required but not provided
+    if (!tool) {
+        return {
+            valid: false,
+            error: exports.TOOL_MESSAGES.NO_TOOL,
+            params: { item: (0, index_js_1.nounPhraseFor)(target) }
+        };
+    }
+    // Check if player has the tool
+    const actor = context.player;
+    const toolLocation = context.world.getLocation(tool.id);
+    if (toolLocation !== actor.id) {
+        return {
+            valid: false,
+            error: exports.TOOL_MESSAGES.TOOL_NOT_HELD,
+            params: { tool: (0, index_js_1.nounPhraseFor)(tool) }
+        };
+    }
+    // Check if it's the right tool
+    if (!canUseWith(tool.id)) {
+        return {
+            valid: false,
+            error: exports.TOOL_MESSAGES.WRONG_TOOL,
+            params: {
+                tool: (0, index_js_1.nounPhraseFor)(tool),
+                item: (0, index_js_1.nounPhraseFor)(target)
+            }
+        };
+    }
+    return null; // All tool validations pass
+}
+//# sourceMappingURL=tool-shared.js.map

package/actions/standard/tool-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-shared.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/tool-shared.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AA6BH,4DA4CC;AApED,mDAAqD;AAErD;;;GAGG;AACU,QAAA,aAAa,GAAG;IAC3B,OAAO,EAAE,SAAS;IAClB,aAAa,EAAE,eAAe;IAC9B,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,SAAgB,wBAAwB,CACtC,OAAsB,EACtB,MAAgB,EAChB,IAA0B,EAC1B,YAAqB,EACrB,UAAyC;IAEzC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,CAAC,8DAA8D;IAC7E,CAAC;IAED,oCAAoC;IACpC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,qBAAa,CAAC,OAAO;YAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,IAAA,wBAAa,EAAC,MAAM,CAAC,EAAE;SACxC,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;IAC7B,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACxD,IAAI,YAAY,KAAK,KAAK,CAAC,EAAE,EAAE,CAAC;QAC9B,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,qBAAa,CAAC,aAAa;YAClC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAA,wBAAa,EAAC,IAAI,CAAC,EAAE;SACtC,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,qBAAa,CAAC,UAAU;YAC/B,MAAM,EAAE;gBACN,IAAI,EAAE,IAAA,wBAAa,EAAC,IAAI,CAAC;gBACzB,IAAI,EAAE,IAAA,wBAAa,EAAC,MAAM,CAAC;aAC5B;SACF,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC,CAAC,4BAA4B;AAC3C,CAAC"}

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

@@ -1,6 +1,6 @@
 /**
  * Touching action - touch or feel objects
  */
-export { touchingAction } from './touching';
-export * from './touching-events';
+export { touchingAction } from './touching.js';
+export * from './touching-events.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/touching/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,cAAc,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/touching/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,cAAc,sBAAsB,CAAC"}

package/actions/standard/touching/index.js

@@ -18,7 +18,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.touchingAction = void 0;
-var touching_1 = require("./touching");
-Object.defineProperty(exports, "touchingAction", { enumerable: true, get: function () { return touching_1.touchingAction; } });
-__exportStar(require("./touching-events"), exports);
+var touching_js_1 = require("./touching.js");
+Object.defineProperty(exports, "touchingAction", { enumerable: true, get: function () { return touching_js_1.touchingAction; } });
+__exportStar(require("./touching-events.js"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/touching/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,uCAA4C;AAAnC,0GAAA,cAAc,OAAA;AACvB,oDAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/touching/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;;AAEH,6CAA+C;AAAtC,6GAAA,cAAc,OAAA;AACvB,uDAAqC"}

package/actions/standard/touching/touching.d.ts

@@ -9,9 +9,18 @@
  * 2. execute: Compute tactile properties (no world mutations)
  * 3. blocked: Generate events when validation fails
  * 4. report: Generate success events
+ *
+ * Interceptor consultation (ADR-118) runs through the shared lifecycle
+ * engine (ADR-228) via `touchingLifecycle` — no hand-rolled hook plumbing.
+ */
+import { Action } from '../../enhanced-types.js';
+import { ActionMetadata } from '../../../validation/index.js';
+import { ActionLifecycleDescriptor } from '../../lifecycle/index.js';
+/**
+ * Interceptor surface (ADR-228): the touched target is the only consultable
+ * entity of a TOUCH command.
  */
-import { Action } from '../../enhanced-types';
-import { ActionMetadata } from '../../../validation';
+export declare const touchingLifecycle: ActionLifecycleDescriptor;
 export declare const touchingAction: Action & {
     metadata: ActionMetadata;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"touching.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/touching/touching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAK/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAkBrD,eAAO,MAAM,cAAc,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA8N/D,CAAC"}
+{"version":3,"file":"touching.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/touching/touching.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,yBAAyB,CAAC;AAKlF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG9D,OAAO,EACL,yBAAyB,EAS1B,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,yBAS/B,CAAC;AAgBF,eAAO,MAAM,cAAc,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAiP/D,CAAC"}

package/actions/standard/touching/touching.js

@@ -10,21 +10,39 @@
  * 2. execute: Compute tactile properties (no world mutations)
  * 3. blocked: Generate events when validation fails
  * 4. report: Generate success events
+ *
+ * Interceptor consultation (ADR-118) runs through the shared lifecycle
+ * engine (ADR-228) via `touchingLifecycle` — no hand-rolled hook plumbing.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.touchingAction = void 0;
+exports.touchingAction = exports.touchingLifecycle = 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 constants_js_1 = require("../../constants.js");
+const types_js_1 = require("../../../scope/types.js");
+const index_js_1 = require("../../../utils/index.js");
+const index_js_2 = require("../../lifecycle/index.js");
+/**
+ * Interceptor surface (ADR-228): the touched target is the only consultable
+ * entity of a TOUCH command.
+ */
+exports.touchingLifecycle = {
+    actionId: constants_js_1.IFActions.TOUCHING,
+    slots: [
+        {
+            id: 'target',
+            actionIds: [constants_js_1.IFActions.TOUCHING],
+            resolve: (ctx) => ctx.command.directObject?.entity
+        }
+    ]
+};
 function getTouchingSharedData(context) {
     return context.sharedData;
 }
 exports.touchingAction = {
-    id: constants_1.IFActions.TOUCHING,
+    id: constants_js_1.IFActions.TOUCHING,
     // Default scope requirements for this action's slots
     defaultScope: {
-        target: types_1.ScopeLevel.REACHABLE
+        target: types_js_1.ScopeLevel.REACHABLE
     },
     requiredMessages: [
         'no_target',
@@ -33,11 +51,9 @@ exports.touchingAction = {
         'feels_normal',
         'feels_warm',
         'feels_hot',
-        'feels_cold',
         'feels_soft',
         'feels_hard',
         'feels_smooth',
-        'feels_rough',
         'feels_wet',
         'device_vibrating',
         'immovable_object',
@@ -52,7 +68,7 @@ exports.touchingAction = {
     metadata: {
         requiresDirectObject: true,
         requiresIndirectObject: false,
-        directObjectScope: types_1.ScopeLevel.REACHABLE
+        directObjectScope: types_js_1.ScopeLevel.REACHABLE
     },
     validate(context) {
         const target = context.command.directObject?.entity;
@@ -64,11 +80,19 @@ exports.touchingAction = {
                 params: {}
             };
         }
+        const state = (0, index_js_2.resolveLifecycle)(context, exports.touchingLifecycle);
+        const preVeto = (0, index_js_2.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);
+        const scopeCheck = context.requireScope(target, types_js_1.ScopeLevel.REACHABLE);
         if (!scopeCheck.ok) {
             return scopeCheck.error;
         }
+        // Canonical placement (ADR-228): postValidate runs after ALL standard validation
+        const postVeto = (0, index_js_2.runPostValidate)(context, state);
+        if (postVeto)
+            return postVeto;
         // Tactile property computation happens in execute phase
         return { valid: true };
     },
@@ -188,24 +212,33 @@ exports.touchingAction = {
         sharedData.targetName = target.name;
         sharedData.messageId = messageId;
         sharedData.eventData = eventData;
+        const state = (0, index_js_2.getLifecycleState)(context);
+        if (state)
+            (0, index_js_2.runPostExecute)(context, state);
     },
     /**
      * Generate events when validation fails
      */
     blocked(context, result) {
         const target = context.command.directObject?.entity;
-        return [context.event('if.event.touch_blocked', {
+        const events = [context.event('if.event.touch_blocked', {
                 blocked: true,
-                messageId: `${context.action.id}.${result.error}`,
+                messageId: (0, index_js_2.blockedMessageId)(context, result),
                 // params carry EntityInfo for the formatter chain (ADR-158)
                 params: {
                     ...result.params,
-                    target: target ? (0, utils_1.nounPhraseFor)(target) : undefined
+                    target: target ? (0, index_js_1.nounPhraseFor)(target) : undefined
                 },
                 reason: result.error,
                 targetId: target?.id,
                 targetName: target?.name
             })];
+        if (result.error) {
+            const state = (0, index_js_2.getLifecycleState)(context);
+            if (state)
+                (0, index_js_2.runOnBlocked)(context, state, events, 'if.event.touch_blocked', result.error);
+        }
+        return events;
     },
     report(context) {
         const events = [];
@@ -215,9 +248,12 @@ exports.touchingAction = {
         const target = context.command.directObject?.entity;
         events.push(context.event('if.event.touched', {
             messageId: `${context.action.id}.${sharedData.messageId || 'touched'}`,
-            params: { target: target ? (0, utils_1.nounPhraseFor)(target) : { name: sharedData.targetName } },
+            params: { target: target ? (0, index_js_1.nounPhraseFor)(target) : { name: sharedData.targetName } },
             ...sharedData.eventData
         }));
+        const state = (0, index_js_2.getLifecycleState)(context);
+        if (state)
+            (0, index_js_2.runPostReport)(context, state, events, 'if.event.touched');
         return events;
     },
     group: "sensory"

package/actions/standard/touching/touching.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Turning action (ADR-090 capability dispatch + ADR-228 lifecycle) —
+ * public exports.
+ */
+export { turningAction, turningLifecycle } from './turning.js';
+export { TurningMessages } from './turning-messages.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/actions/standard/turning/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurningMessages = exports.turningLifecycle = exports.turningAction = void 0;
+/**
+ * Turning action (ADR-090 capability dispatch + ADR-228 lifecycle) —
+ * public exports.
+ */
+var turning_js_1 = require("./turning.js");
+Object.defineProperty(exports, "turningAction", { enumerable: true, get: function () { return turning_js_1.turningAction; } });
+Object.defineProperty(exports, "turningLifecycle", { enumerable: true, get: function () { return turning_js_1.turningLifecycle; } });
+var turning_messages_js_1 = require("./turning-messages.js");
+Object.defineProperty(exports, "TurningMessages", { enumerable: true, get: function () { return turning_messages_js_1.TurningMessages; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/turning/index.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,2CAA+D;AAAtD,2GAAA,aAAa,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AACxC,6DAAwD;AAA/C,sHAAA,eAAe,OAAA"}

package/actions/standard/turning/turning-messages.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Message constants for the turning action (chord go-live G1 shortlist,
+ * 2026-07-17).
+ *
+ * These constants provide type safety for message IDs within stdlib.
+ * The lang-en-us package uses matching string literals (stable, injected at runtime).
+ */
+export declare const TurningMessages: {
+    readonly NO_TARGET: "no_target";
+    readonly CANT_TURN_THAT: "cant_turn_that";
+    readonly TURNED: "turned";
+};
+export type TurningMessageId = typeof TurningMessages[keyof typeof TurningMessages];
+//# sourceMappingURL=turning-messages.d.ts.map

package/actions/standard/turning/turning-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turning-messages.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/turning/turning-messages.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;;;;CAOlB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,OAAO,eAAe,CAAC,MAAM,OAAO,eAAe,CAAC,CAAC"}

package/actions/standard/turning/turning-messages.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TurningMessages = void 0;
+/**
+ * Message constants for the turning action (chord go-live G1 shortlist,
+ * 2026-07-17).
+ *
+ * These constants provide type safety for message IDs within stdlib.
+ * The lang-en-us package uses matching string literals (stable, injected at runtime).
+ */
+exports.TurningMessages = {
+    // Error messages
+    NO_TARGET: 'no_target',
+    CANT_TURN_THAT: 'cant_turn_that',
+    // Success message (typically overridden by the entity's implementation)
+    TURNED: 'turned',
+};
+//# sourceMappingURL=turning-messages.js.map

package/actions/standard/turning/turning-messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turning-messages.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/turning/turning-messages.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACU,QAAA,eAAe,GAAG;IAC7B,iBAAiB;IACjB,SAAS,EAAE,WAAW;IACtB,cAAc,EAAE,gBAAgB;IAEhC,wEAAwE;IACxE,MAAM,EAAE,QAAQ;CACR,CAAC"}

package/actions/standard/turning/turning.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Turning action (ADR-090 capability dispatch + ADR-228 lifecycle;
+ * chord go-live G1 shortlist, 2026-07-17).
+ *
+ * TURN has no standard semantics — a wheel rotates, a dial sets a number,
+ * a crank activates (the ADR-090 verb table documents TURN as deliberately
+ * entity-specific). The action performs NO mutation itself; the turn
+ * OUTCOME is the target entity's own registered implementation, on either
+ * surface (cutting's dual-surface shape, minus its trait gate — turning
+ * has no eligibility trait):
+ *   - an ADR-090 capability behavior registered for if.action.turning
+ *     (TS authors), invoked from execute/report/blocked; or
+ *   - an ADR-228 interceptor (Chord `on turning it`) whose postExecute
+ *     owns the mutation and whose postReport owns the narration.
+ *
+ * An entity with NEITHER surface refuses with cant_turn_that — the same
+ * answer the old full-delegation factory action gave.
+ *
+ * NOTE: the switching phrasal forms (`turn :device on|off`, `turn on|off
+ * :device`) keep their own mapping — this action owns only the bare
+ * `turn|rotate|twist :target` shapes, at priority 95 so switching wins.
+ *
+ * Four-phase pattern (ADR-051):
+ * 1. validate: implementation presence (behavior XOR interceptor)
+ * 2. execute: delegate to the capability behavior, if that's the surface
+ * 3. report: behavior effects, or the standard turned event for interceptors
+ * 4. blocked: standard blocked event through the lifecycle engine
+ */
+import { Action } from '../../enhanced-types.js';
+import { ActionMetadata } from '../../../validation/index.js';
+import { ActionLifecycleDescriptor } from '../../lifecycle/index.js';
+/**
+ * Interceptor surface (ADR-228): the turned target is the single
+ * consultable entity of a TURN command.
+ */
+export declare const turningLifecycle: ActionLifecycleDescriptor;
+export declare const turningAction: Action & {
+    metadata: ActionMetadata;
+};
+//# sourceMappingURL=turning.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"turning.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/turning/turning.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,yBAAyB,CAAC;AAQlF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAI9D,OAAO,EACL,yBAAyB,EAS1B,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,yBAa9B,CAAC;AAqBF,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CA0J9D,CAAC"}

package/actions/standard/turning/turning.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * Turning action (ADR-090 capability dispatch + ADR-228 lifecycle;
+ * chord go-live G1 shortlist, 2026-07-17).
+ *
+ * TURN has no standard semantics — a wheel rotates, a dial sets a number,
+ * a crank activates (the ADR-090 verb table documents TURN as deliberately
+ * entity-specific). The action performs NO mutation itself; the turn
+ * OUTCOME is the target entity's own registered implementation, on either
+ * surface (cutting's dual-surface shape, minus its trait gate — turning
+ * has no eligibility trait):
+ *   - an ADR-090 capability behavior registered for if.action.turning
+ *     (TS authors), invoked from execute/report/blocked; or
+ *   - an ADR-228 interceptor (Chord `on turning it`) whose postExecute
+ *     owns the mutation and whose postReport owns the narration.
+ *
+ * An entity with NEITHER surface refuses with cant_turn_that — the same
+ * answer the old full-delegation factory action gave.
+ *
+ * NOTE: the switching phrasal forms (`turn :device on|off`, `turn on|off
+ * :device`) keep their own mapping — this action owns only the bare
+ * `turn|rotate|twist :target` shapes, at priority 95 so switching wins.
+ *
+ * Four-phase pattern (ADR-051):
+ * 1. validate: implementation presence (behavior XOR interceptor)
+ * 2. execute: delegate to the capability behavior, if that's the surface
+ * 3. report: behavior effects, or the standard turned event for interceptors
+ * 4. blocked: standard blocked event through the lifecycle engine
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.turningAction = exports.turningLifecycle = void 0;
+const world_model_1 = require("@sharpee/world-model");
+const constants_js_1 = require("../../constants.js");
+const types_js_1 = require("../../../scope/types.js");
+const turning_messages_js_1 = require("./turning-messages.js");
+const index_js_1 = require("../../../utils/index.js");
+const index_js_2 = require("../../lifecycle/index.js");
+/**
+ * Interceptor surface (ADR-228): the turned target is the single
+ * consultable entity of a TURN command.
+ */
+exports.turningLifecycle = {
+    actionId: constants_js_1.IFActions.TURNING,
+    slots: [
+        {
+            id: 'target',
+            actionIds: [constants_js_1.IFActions.TURNING],
+            resolve: (ctx) => ctx.command.directObject?.entity,
+            seedData: (ctx, entity) => ({
+                targetId: entity.id,
+                targetName: entity.name
+            })
+        }
+    ]
+};
+/**
+ * Convert capability effects to semantic events. Effect messageIds are
+ * forwarded unchanged — implementations MUST emit fully-qualified ids
+ * (stdlib CLAUDE.md capability-effect rule; short keys render blank on
+ * the universal dispatch path).
+ */
+function effectsToEvents(effects, context) {
+    return effects.map((effect) => context.event(effect.type, { ...effect.payload }));
+}
+exports.turningAction = {
+    id: constants_js_1.IFActions.TURNING,
+    defaultScope: {
+        target: types_js_1.ScopeLevel.REACHABLE
+    },
+    requiresHolding: false,
+    requiredMessages: [
+        'no_target',
+        'cant_turn_that',
+        'turned'
+    ],
+    metadata: {
+        requiresDirectObject: true,
+        requiresIndirectObject: false,
+        directObjectScope: types_js_1.ScopeLevel.REACHABLE
+    },
+    group: 'manipulation',
+    validate(context) {
+        const noun = context.command.directObject?.entity;
+        if (!noun) {
+            return { valid: false, error: turning_messages_js_1.TurningMessages.NO_TARGET };
+        }
+        const state = (0, index_js_2.resolveLifecycle)(context, exports.turningLifecycle);
+        const preVeto = (0, index_js_2.runPreValidate)(context, state);
+        if (preVeto)
+            return preVeto;
+        const scopeCheck = context.requireScope(noun, types_js_1.ScopeLevel.REACHABLE);
+        if (!scopeCheck.ok) {
+            return scopeCheck.error;
+        }
+        // Implementation presence (dual-surface): a capability behavior on one
+        // of the target's traits, or an interceptor consulting this action.
+        const capabilityTrait = (0, world_model_1.findTraitWithCapability)(noun, constants_js_1.IFActions.TURNING);
+        const behavior = capabilityTrait
+            ? context.world.getBehaviorForCapability(capabilityTrait, constants_js_1.IFActions.TURNING)
+            : undefined;
+        const hasInterceptor = !!context.world.getInterceptorForAction(noun, constants_js_1.IFActions.TURNING);
+        if (!behavior && !hasInterceptor) {
+            return {
+                valid: false,
+                error: turning_messages_js_1.TurningMessages.CANT_TURN_THAT,
+                params: { target: (0, index_js_1.nounPhraseFor)(noun) }
+            };
+        }
+        let data;
+        if (behavior) {
+            const sharedData = {};
+            const behaviorResult = behavior.validate(noun, context.world, context.player.id, sharedData);
+            if (!behaviorResult.valid) {
+                return {
+                    valid: false,
+                    error: behaviorResult.error,
+                    // Capability-behavior error codes are fully-qualified by policy
+                    // (stdlib CLAUDE.md capability-effect rule) — ADR-231 D1 provenance.
+                    // Keyless vetoes fall back to an action-local id, so only a
+                    // supplied key carries the mark.
+                    errorQualified: behaviorResult.error != null,
+                    params: behaviorResult.params
+                };
+            }
+            data = { behavior, sharedData };
+        }
+        const postVeto = (0, index_js_2.runPostValidate)(context, state);
+        if (postVeto)
+            return postVeto;
+        return { valid: true, data };
+    },
+    /**
+     * Execute — the action mutates NOTHING itself. A capability-behavior
+     * implementation runs here; an interceptor implementation runs in its
+     * own postExecute hook via the lifecycle engine.
+     */
+    execute(context) {
+        const noun = context.command.directObject.entity;
+        const data = context.validationResult?.data;
+        if (data?.behavior) {
+            data.behavior.execute(noun, context.world, context.player.id, data.sharedData);
+            context.sharedData.turningDispatch = data;
+        }
+        const state = (0, index_js_2.getLifecycleState)(context);
+        if (state)
+            (0, index_js_2.runPostExecute)(context, state);
+    },
+    report(context) {
+        const noun = context.command.directObject.entity;
+        const data = (context.sharedData.turningDispatch ?? context.validationResult?.data);
+        let events;
+        if (data?.behavior) {
+            // Capability surface: the implementation owns the narration.
+            events = effectsToEvents(data.behavior.report(noun, context.world, context.player.id, data.sharedData), context);
+        }
+        else {
+            // Interceptor surface: standard turned event; the implementation's
+            // postReport override typically replaces the generic message.
+            events = [
+                context.event('if.event.turned', {
+                    messageId: `${context.action.id}.${turning_messages_js_1.TurningMessages.TURNED}`,
+                    params: { target: (0, index_js_1.nounPhraseFor)(noun) },
+                    targetId: noun.id,
+                    targetName: noun.name,
+                    actorId: context.player.id
+                })
+            ];
+        }
+        const state = (0, index_js_2.getLifecycleState)(context);
+        if (state)
+            (0, index_js_2.runPostReport)(context, state, events, 'if.event.turned');
+        return events;
+    },
+    blocked(context, result) {
+        const noun = context.command.directObject?.entity;
+        const messageId = (0, index_js_2.blockedMessageId)(context, result);
+        const events = [
+            context.event('if.event.turn_blocked', {
+                messageId,
+                params: {
+                    ...result.params,
+                    target: noun ? (0, index_js_1.nounPhraseFor)(noun) : undefined
+                },
+                targetId: noun?.id,
+                targetName: noun?.name,
+                reason: result.error
+            })
+        ];
+        if (result.error) {
+            const state = (0, index_js_2.getLifecycleState)(context);
+            if (state)
+                (0, index_js_2.runOnBlocked)(context, state, events, 'if.event.turn_blocked', result.error);
+        }
+        return events;
+    }
+};
+//# sourceMappingURL=turning.js.map

package/actions/standard/turning/turning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turning.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/turning/turning.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;;;AAIH,sDAI8B;AAC9B,qDAA+C;AAE/C,sDAAqD;AACrD,+DAAwD;AACxD,sDAAwD;AACxD,uDAUkC;AAElC;;;GAGG;AACU,QAAA,gBAAgB,GAA8B;IACzD,QAAQ,EAAE,wBAAS,CAAC,OAAO;IAC3B,KAAK,EAAE;QACL;YACE,EAAE,EAAE,QAAQ;YACZ,SAAS,EAAE,CAAC,wBAAS,CAAC,OAAO,CAAC;YAC9B,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM;YAClD,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC1B,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,UAAU,EAAE,MAAM,CAAC,IAAI;aACxB,CAAC;SACH;KACF;CACF,CAAC;AAWF;;;;;GAKG;AACH,SAAS,eAAe,CAAC,OAA2B,EAAE,OAAsB;IAC1E,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;AACpF,CAAC;AAEY,QAAA,aAAa,GAA0C;IAClE,EAAE,EAAE,wBAAS,CAAC,OAAO;IAErB,YAAY,EAAE;QACZ,MAAM,EAAE,qBAAU,CAAC,SAAS;KAC7B;IAED,eAAe,EAAE,KAAK;IAEtB,gBAAgB,EAAE;QAChB,WAAW;QACX,gBAAgB;QAChB,QAAQ;KACT;IACD,QAAQ,EAAE;QACR,oBAAoB,EAAE,IAAI;QAC1B,sBAAsB,EAAE,KAAK;QAC7B,iBAAiB,EAAE,qBAAU,CAAC,SAAS;KACxC;IACD,KAAK,EAAE,cAAc;IAErB,QAAQ,CAAC,OAAsB;QAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;QAElD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,qCAAe,CAAC,SAAS,EAAE,CAAC;QAC5D,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,2BAAgB,EAAC,OAAO,EAAE,wBAAgB,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAA,yBAAc,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAE5B,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,qBAAU,CAAC,SAAS,CAAC,CAAC;QACpE,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,OAAO,UAAU,CAAC,KAAM,CAAC;QAC3B,CAAC;QAED,uEAAuE;QACvE,oEAAoE;QACpE,MAAM,eAAe,GAAG,IAAA,qCAAuB,EAAC,IAAI,EAAE,wBAAS,CAAC,OAAO,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAG,eAAe;YAC9B,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,wBAAwB,CAAC,eAAe,EAAE,wBAAS,CAAC,OAAO,CAAC;YAC5E,CAAC,CAAC,SAAS,CAAC;QACd,MAAM,cAAc,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,IAAI,EAAE,wBAAS,CAAC,OAAO,CAAC,CAAC;QAExF,IAAI,CAAC,QAAQ,IAAI,CAAC,cAAc,EAAE,CAAC;YACjC,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,qCAAe,CAAC,cAAc;gBACrC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAA,wBAAa,EAAC,IAAI,CAAC,EAAE;aACxC,CAAC;QACJ,CAAC;QAED,IAAI,IAAqC,CAAC;QAC1C,IAAI,QAAQ,EAAE,CAAC;YACb,MAAM,UAAU,GAAyB,EAAE,CAAC;YAC5C,MAAM,cAAc,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YAC7F,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;gBAC1B,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,cAAc,CAAC,KAAK;oBAC3B,gEAAgE;oBAChE,qEAAqE;oBACrE,4DAA4D;oBAC5D,iCAAiC;oBACjC,cAAc,EAAE,cAAc,CAAC,KAAK,IAAI,IAAI;oBAC5C,MAAM,EAAE,cAAc,CAAC,MAAM;iBAC9B,CAAC;YACJ,CAAC;YACD,IAAI,GAAG,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,QAAQ,GAAG,IAAA,0BAAe,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAsB;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAa,CAAC,MAAO,CAAC;QACnD,MAAM,IAAI,GAAG,OAAO,CAAC,gBAAgB,EAAE,IAAuC,CAAC;QAE/E,IAAI,IAAI,EAAE,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YAC/E,OAAO,CAAC,UAAU,CAAC,eAAe,GAAG,IAAI,CAAC;QAC5C,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,4BAAiB,EAAC,OAAO,CAAC,CAAC;QACzC,IAAI,KAAK;YAAE,IAAA,yBAAc,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED,MAAM,CAAC,OAAsB;QAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAa,CAAC,MAAO,CAAC;QACnD,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC,eAAe,IAAI,OAAO,CAAC,gBAAgB,EAAE,IAAI,CAErE,CAAC;QAEd,IAAI,MAAwB,CAAC;QAC7B,IAAI,IAAI,EAAE,QAAQ,EAAE,CAAC;YACnB,6DAA6D;YAC7D,MAAM,GAAG,eAAe,CACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,EAC7E,OAAO,CACR,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,mEAAmE;YACnE,8DAA8D;YAC9D,MAAM,GAAG;gBACP,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE;oBAC/B,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,qCAAe,CAAC,MAAM,EAAE;oBAC3D,MAAM,EAAE,EAAE,MAAM,EAAE,IAAA,wBAAa,EAAC,IAAI,CAAC,EAAE;oBACvC,QAAQ,EAAE,IAAI,CAAC,EAAE;oBACjB,UAAU,EAAE,IAAI,CAAC,IAAI;oBACrB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE;iBAC3B,CAAC;aACH,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,4BAAiB,EAAC,OAAO,CAAC,CAAC;QACzC,IAAI,KAAK;YAAE,IAAA,wBAAa,EAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAEpE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,CAAC,OAAsB,EAAE,MAAwB;QACtD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;QAElD,MAAM,SAAS,GAAG,IAAA,2BAAgB,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAEpD,MAAM,MAAM,GAAqB;YAC/B,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE;gBACrC,SAAS;gBACT,MAAM,EAAE;oBACN,GAAG,MAAM,CAAC,MAAM;oBAChB,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,IAAA,wBAAa,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;iBAC/C;gBACD,QAAQ,EAAE,IAAI,EAAE,EAAE;gBAClB,UAAU,EAAE,IAAI,EAAE,IAAI;gBACtB,MAAM,EAAE,MAAM,CAAC,KAAK;aACrB,CAAC;SACH,CAAC;QAEF,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,IAAA,4BAAiB,EAAC,OAAO,CAAC,CAAC;YACzC,IAAI,KAAK;gBAAE,IAAA,uBAAY,EAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACzF,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}