@sharpee/stdlib 2.2.0 → 3.1.0

package/actions/standard/listening/listening.js

@@ -8,15 +8,35 @@
  * Uses four-phase pattern:
  * 1. validate: Always succeeds (no preconditions for listening)
  * 2. execute: Analyze sounds (no world mutations)
- * 3. blocked: Handle validation failures (n/a - always succeeds)
+ * 3. blocked: Handle validation failures (only interceptor vetoes)
  * 4. report: Emit listened event and success message
+ *
+ * Interceptor consultation (ADR-118) runs through the shared lifecycle
+ * engine (ADR-228) via `listeningLifecycle` — no hand-rolled hook plumbing.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listeningAction = void 0;
+exports.listeningAction = exports.listeningLifecycle = void 0;
 const world_model_1 = require("@sharpee/world-model");
 const constants_1 = require("../../constants");
 const scope_1 = require("../../../scope");
 const utils_1 = require("../../../utils");
+const lifecycle_1 = require("../../lifecycle");
+/**
+ * Interceptor surface (ADR-228): the listened-to target is the only
+ * consultable entity of a LISTEN command. Listening to the environment
+ * ("listen") has no direct object, so the slot resolves to undefined —
+ * zero consultations.
+ */
+exports.listeningLifecycle = {
+    actionId: constants_1.IFActions.LISTENING,
+    slots: [
+        {
+            id: 'target',
+            actionIds: [constants_1.IFActions.LISTENING],
+            resolve: (ctx) => ctx.command.directObject?.entity
+        }
+    ]
+};
 function getListeningSharedData(context) {
     return context.sharedData;
 }
@@ -125,7 +145,15 @@ exports.listeningAction = {
         directObjectScope: scope_1.ScopeLevel.AWARE
     },
     validate(context) {
-        // Listening always succeeds - no preconditions
+        const state = (0, lifecycle_1.resolveLifecycle)(context, exports.listeningLifecycle);
+        const preVeto = (0, lifecycle_1.runPreValidate)(context, state);
+        if (preVeto)
+            return preVeto;
+        // Listening always succeeds - no standard preconditions.
+        // 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) {
@@ -136,11 +164,15 @@ exports.listeningAction = {
         sharedData.messageId = analysis.messageId;
         sharedData.params = analysis.params;
         sharedData.eventData = analysis.eventData;
+        const state = (0, lifecycle_1.getLifecycleState)(context);
+        if (state)
+            (0, lifecycle_1.runPostExecute)(context, state);
     },
     blocked(context, result) {
         // Listening always succeeds, but include blocked for consistency
+        // (interceptor preValidate/postValidate vetoes land here)
         const target = context.command.directObject?.entity;
-        return [context.event('if.event.listen_blocked', {
+        const events = [context.event('if.event.listen_blocked', {
                 blocked: true,
                 messageId: `${context.action.id}.${result.error}`,
                 // params carry EntityInfo for the formatter chain (ADR-158)
@@ -152,6 +184,12 @@ exports.listeningAction = {
                 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.listen_blocked', result.error);
+        }
+        return events;
     },
     report(context) {
         const events = [];
@@ -162,6 +200,9 @@ exports.listeningAction = {
             params: sharedData.params,
             ...sharedData.eventData
         }));
+        const state = (0, lifecycle_1.getLifecycleState)(context);
+        if (state)
+            (0, lifecycle_1.runPostReport)(context, state, events, 'if.event.listened');
         return events;
     }
 };

package/actions/standard/listening/listening.js.map

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

package/actions/standard/locking/locking.d.ts

@@ -11,6 +11,15 @@
  */
 import { Action } from '../../enhanced-types';
 import { ActionMetadata } from '../../../validation';
+import { ActionLifecycleDescriptor } from '../../lifecycle';
+/**
+ * Interceptor surface (ADR-228/229 R2): the locked target and the
+ * explicit key are the consultable entities of a LOCK command,
+ * published order target → key (D3-B). Explicit keys only — an
+ * auto-inferred key is not a command entity (same documented rule as
+ * attacking's inferred weapons). Symmetric seedData mirrors putting.
+ */
+export declare const lockingLifecycle: ActionLifecycleDescriptor;
 export declare const lockingAction: Action & {
     metadata: ActionMetadata;
 };

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

@@ -1 +1 @@
-{"version":3,"file":"locking.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/locking/locking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAgCrD,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAiO9D,CAAC"}
+{"version":3,"file":"locking.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/locking/locking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAmC,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AASrD,OAAO,EACL,yBAAyB,EAQ1B,MAAM,iBAAiB,CAAC;AAEzB;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,yBA6B9B,CAAC;AAwBF,eAAO,MAAM,aAAa,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,CAAA;CAwP9D,CAAC"}

package/actions/standard/locking/locking.js

@@ -11,13 +11,51 @@
  * 3. report: Generate events from sharedData
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.lockingAction = void 0;
+exports.lockingAction = exports.lockingLifecycle = void 0;
 const world_model_1 = require("@sharpee/world-model");
 const constants_1 = require("../../constants");
 const scope_1 = require("../../../scope");
 const lock_shared_1 = require("../lock-shared");
 const locking_messages_1 = require("./locking-messages");
 const utils_1 = require("../../../utils");
+const lifecycle_1 = require("../../lifecycle");
+/**
+ * Interceptor surface (ADR-228/229 R2): the locked target and the
+ * explicit key are the consultable entities of a LOCK command,
+ * published order target → key (D3-B). Explicit keys only — an
+ * auto-inferred key is not a command entity (same documented rule as
+ * attacking's inferred weapons). Symmetric seedData mirrors putting.
+ */
+exports.lockingLifecycle = {
+    actionId: constants_1.IFActions.LOCKING,
+    slots: [
+        {
+            id: 'target',
+            actionIds: [constants_1.IFActions.LOCKING],
+            resolve: (ctx) => ctx.command.directObject?.entity,
+            seedData: (ctx, entity) => {
+                const key = ctx.command.instrument?.entity ?? ctx.command.indirectObject?.entity;
+                return {
+                    targetId: entity.id,
+                    targetName: entity.name,
+                    keyId: key?.id,
+                    keyName: key?.name
+                };
+            }
+        },
+        {
+            id: 'key',
+            actionIds: [constants_1.IFActions.LOCKING],
+            resolve: (ctx) => ctx.command.instrument?.entity ?? ctx.command.indirectObject?.entity,
+            seedData: (ctx, entity) => ({
+                keyId: entity.id,
+                keyName: entity.name,
+                targetId: ctx.command.directObject?.entity?.id,
+                targetName: ctx.command.directObject?.entity?.name
+            })
+        }
+    ]
+};
 function getLockingSharedData(context) {
     return context.sharedData;
 }
@@ -56,6 +94,10 @@ exports.lockingAction = {
                 error: locking_messages_1.MESSAGES.NO_TARGET
             };
         }
+        const state = (0, lifecycle_1.resolveLifecycle)(context, exports.lockingLifecycle);
+        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(noun, scope_1.ScopeLevel.REACHABLE);
         if (!scopeCheck.ok) {
@@ -92,6 +134,10 @@ exports.lockingAction = {
         if (keyValidation) {
             return keyValidation;
         }
+        // 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 };
     },
     /**
@@ -163,6 +209,9 @@ exports.lockingAction = {
         if (withKey) {
             sharedData.params.key = (0, utils_1.nounPhraseFor)(withKey);
         }
+        const state = (0, lifecycle_1.getLifecycleState)(context);
+        if (state)
+            (0, lifecycle_1.runPostExecute)(context, state);
     },
     /**
      * Report phase - generates events after successful execution
@@ -184,7 +233,7 @@ exports.lockingAction = {
                 })];
         }
         // Emit domain event with messageId (simplified pattern - ADR-097)
-        return [
+        const events = [
             context.event('if.event.locked', {
                 // Rendering data (messageId + params for text-service)
                 messageId: `${context.action.id}.${sharedData.messageId}`,
@@ -200,6 +249,10 @@ exports.lockingAction = {
                 sound: sharedData.sound
             })
         ];
+        const state = (0, lifecycle_1.getLifecycleState)(context);
+        if (state)
+            (0, lifecycle_1.runPostReport)(context, state, events, 'if.event.locked');
+        return events;
     },
     /**
      * Generate events when validation fails
@@ -208,7 +261,7 @@ exports.lockingAction = {
      */
     blocked(context, result) {
         const noun = context.command.directObject?.entity;
-        return [context.event('if.event.lock_blocked', {
+        const events = [context.event('if.event.lock_blocked', {
                 // Rendering data
                 messageId: `${context.action.id}.${result.error}`,
                 params: result.params || {},
@@ -217,6 +270,12 @@ exports.lockingAction = {
                 targetName: noun?.name,
                 reason: result.error
             })];
+        if (result.error) {
+            const state = (0, lifecycle_1.getLifecycleState)(context);
+            if (state)
+                (0, lifecycle_1.runOnBlocked)(context, state, events, 'if.event.lock_blocked', result.error);
+        }
+        return events;
     },
     metadata: {
         requiresDirectObject: true,

package/actions/standard/locking/locking.js.map

@@ -1 +1 @@
-{"version":3,"file":"locking.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/locking/locking.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"locking.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/locking/locking.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAKH,sDAAkG;AAClG,+CAA4C;AAC5C,0CAA4C;AAE5C,gDAAmG;AACnG,yDAA8C;AAC9C,0CAA+C;AAC/C,+CASyB;AAEzB;;;;;;GAMG;AACU,QAAA,gBAAgB,GAA8B;IACzD,QAAQ,EAAE,qBAAS,CAAC,OAAO;IAC3B,KAAK,EAAE;QACL;YACE,EAAE,EAAE,QAAQ;YACZ,SAAS,EAAE,CAAC,qBAAS,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;gBACxB,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;gBACjF,OAAO;oBACL,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,UAAU,EAAE,MAAM,CAAC,IAAI;oBACvB,KAAK,EAAE,GAAG,EAAE,EAAE;oBACd,OAAO,EAAE,GAAG,EAAE,IAAI;iBACnB,CAAC;YACJ,CAAC;SACF;QACD;YACE,EAAE,EAAE,KAAK;YACT,SAAS,EAAE,CAAC,qBAAS,CAAC,OAAO,CAAC;YAC9B,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM;YACtF,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC1B,KAAK,EAAE,MAAM,CAAC,EAAE;gBAChB,OAAO,EAAE,MAAM,CAAC,IAAI;gBACpB,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,EAAE;gBAC9C,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI;aACnD,CAAC;SACH;KACF;CACF,CAAC;AAoBF,SAAS,oBAAoB,CAAC,OAAsB;IAClD,OAAO,OAAO,CAAC,UAA+B,CAAC;AACjD,CAAC;AAEY,QAAA,aAAa,GAA0C;IAClE,EAAE,EAAE,qBAAS,CAAC,OAAO;IAErB,qDAAqD;IACrD,YAAY,EAAE;QACZ,MAAM,EAAE,kBAAU,CAAC,SAAS;QAC5B,GAAG,EAAE,kBAAU,CAAC,OAAO;KACxB;IAED,gBAAgB,EAAE;QAChB,WAAW;QACX,cAAc;QACd,QAAQ;QACR,WAAW;QACX,gBAAgB;QAChB,YAAY;QACZ,QAAQ;QACR,aAAa;QACb,YAAY;QACZ,cAAc;KACf;IACD,KAAK,EAAE,mBAAmB;IAE1B;;;OAGG;IACH,QAAQ,CAAC,OAAsB;QAC7B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;QAClD,8FAA8F;QAC9F,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;QAE7F,4BAA4B;QAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,2BAAQ,CAAC,SAAS;aAC1B,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,4BAAgB,EAAC,OAAO,EAAE,wBAAgB,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAA,0BAAc,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC/C,IAAI,OAAO;YAAE,OAAO,OAAO,CAAC;QAE5B,iDAAiD;QACjD,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,kBAAU,CAAC,SAAS,CAAC,CAAC;QACpE,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,OAAO,UAAU,CAAC,KAAM,CAAC;QAC3B,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,2BAAQ,CAAC,YAAY;gBAC5B,MAAM,EAAE,EAAE,IAAI,EAAE,IAAA,qBAAa,EAAC,IAAI,CAAC,EAAE;aACtC,CAAC;QACJ,CAAC;QAED,+CAA+C;QAC/C,IAAI,CAAC,8BAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,+CAA+C;YAC/C,IAAI,8BAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,2BAAQ,CAAC,cAAc;oBAC9B,MAAM,EAAE,EAAE,IAAI,EAAE,IAAA,qBAAa,EAAC,IAAI,CAAC,EAAE;iBACtC,CAAC;YACJ,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,CAAC,uBAAS,CAAC,QAAQ,CAAC,IAAI,8BAAgB,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAClE,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,KAAK,EAAE,2BAAQ,CAAC,UAAU;oBAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,IAAA,qBAAa,EAAC,IAAI,CAAC,EAAE;iBACtC,CAAC;YACJ,CAAC;QACH,CAAC;QAED,gDAAgD;QAChD,MAAM,aAAa,GAAG,IAAA,qCAAuB,EAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5E,IAAI,aAAa,EAAE,CAAC;YAClB,OAAO,aAAa,CAAC;QACvB,CAAC;QAED,iFAAiF;QACjF,MAAM,QAAQ,GAAG,IAAA,2BAAe,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACjD,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAsB;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAa,CAAC,MAAO,CAAC;QACnD,gEAAgE;QAChE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,CAAC;QAC7F,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QAEjD,8BAA8B;QAC9B,MAAM,QAAQ,GAAG,IAAA,gCAAkB,EAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QAE5D,oDAAoD;QACpD,MAAM,MAAM,GAAgB,8BAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEjE,mBAAmB;QACnB,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,EAAE,CAAC;QAC9B,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC;QAElC,yCAAyC;QACzC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC;YACzB,wCAAwC;YACxC,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACpB,UAAU,CAAC,cAAc,GAAG,WAAW,CAAC;YAC1C,CAAC;iBAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACxB,UAAU,CAAC,cAAc,GAAG,QAAQ,CAAC;YACvC,CAAC;iBAAM,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBAChC,UAAU,CAAC,cAAc,GAAG,gBAAgB,CAAC;YAC/C,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,cAAc,GAAG,WAAW,CAAC;YAC1C,CAAC;YACD,OAAO;QACT,CAAC;QAED,oBAAoB;QACpB,UAAU,CAAC,MAAM,GAAG,KAAK,CAAC;QAE1B,qCAAqC;QACrC,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;YACzB,UAAU,CAAC,WAAW,GAAG,IAAI,CAAC;QAChC,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,sBAAsB;QACtB,IAAI,OAAO,EAAE,CAAC;YACZ,UAAU,CAAC,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC;YAC9B,UAAU,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;QACpC,CAAC;QAED,oCAAoC;QACpC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,UAAU,CAAC,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC;QACtC,CAAC;QAED,8DAA8D;QAC9D,qEAAqE;QACrE,UAAU,CAAC,SAAS,GAAG,IAAA,kCAAoB,EAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QAC7D,UAAU,CAAC,MAAM,GAAG;YAClB,IAAI,EAAE,IAAA,qBAAa,EAAC,IAAI,CAAC;SAC1B,CAAC;QAEF,0BAA0B;QAC1B,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;YACzB,UAAU,CAAC,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC;QACvC,CAAC;QACD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;YACpB,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC;QAClC,CAAC;QACD,IAAI,OAAO,EAAE,CAAC;YACZ,UAAU,CAAC,MAAM,CAAC,GAAG,GAAG,IAAA,qBAAa,EAAC,OAAO,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,KAAK,GAAG,IAAA,6BAAiB,EAAC,OAAO,CAAC,CAAC;QACzC,IAAI,KAAK;YAAE,IAAA,0BAAc,EAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5C,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,OAAsB;QAC3B,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;QACjD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;QAElD,uDAAuD;QACvD,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YACtB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE;oBAC7C,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,UAAU,CAAC,cAAc,EAAE;oBAC9D,4DAA4D;oBAC5D,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAA,qBAAa,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,UAAU,EAAE,EAAE;oBAC9E,QAAQ,EAAE,UAAU,CAAC,QAAQ;oBAC7B,UAAU,EAAE,UAAU,CAAC,UAAU;oBACjC,MAAM,EAAE,UAAU,CAAC,cAAc;iBAClC,CAAC,CAAC,CAAC;QACN,CAAC;QAED,kEAAkE;QAClE,MAAM,MAAM,GAAqB;YAC/B,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE;gBAC/B,uDAAuD;gBACvD,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,UAAU,CAAC,SAAS,EAAE;gBACzD,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,8CAA8C;gBAC9C,QAAQ,EAAE,UAAU,CAAC,QAAQ;gBAC7B,UAAU,EAAE,UAAU,CAAC,UAAU;gBACjC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE;gBAC1B,WAAW,EAAE,UAAU,CAAC,WAAW;gBACnC,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,KAAK,EAAE,UAAU,CAAC,KAAK;aACxB,CAAC;SACH,CAAC;QAEF,MAAM,KAAK,GAAG,IAAA,6BAAiB,EAAC,OAAO,CAAC,CAAC;QACzC,IAAI,KAAK;YAAE,IAAA,yBAAa,EAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAEpE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAsB,EAAE,MAAwB;QACtD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC;QAElD,MAAM,MAAM,GAAqB,CAAC,OAAO,CAAC,KAAK,CAAC,uBAAuB,EAAE;gBACvE,iBAAiB;gBACjB,SAAS,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK,EAAE;gBACjD,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;gBAC3B,cAAc;gBACd,QAAQ,EAAE,IAAI,EAAE,EAAE;gBAClB,UAAU,EAAE,IAAI,EAAE,IAAI;gBACtB,MAAM,EAAE,MAAM,CAAC,KAAK;aACrB,CAAC,CAAC,CAAC;QAEJ,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,MAAM,KAAK,GAAG,IAAA,6BAAiB,EAAC,OAAO,CAAC,CAAC;YACzC,IAAI,KAAK;gBAAE,IAAA,wBAAY,EAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACzF,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,QAAQ,EAAE;QACR,oBAAoB,EAAE,IAAI;QAC1B,sBAAsB,EAAE,KAAK;QAC7B,iBAAiB,EAAE,kBAAU,CAAC,SAAS;KACxC;CACF,CAAC"}

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

@@ -5,4 +5,5 @@
 export { lookingAction } from './looking';
 export * from './looking-events';
 export { resolveSnippetDescription, SnippetWorldQueries } from './snippet-resolver';
+export { registerSnippetGate, lookupSnippetGate, clearSnippetGates, SnippetGate, } from './snippet-gate-registry';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/looking/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/looking/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACpF,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,GACZ,MAAM,yBAAyB,CAAC"}

package/actions/standard/looking/index.js

@@ -18,10 +18,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveSnippetDescription = exports.lookingAction = void 0;
+exports.clearSnippetGates = exports.lookupSnippetGate = exports.registerSnippetGate = exports.resolveSnippetDescription = exports.lookingAction = void 0;
 var looking_1 = require("./looking");
 Object.defineProperty(exports, "lookingAction", { enumerable: true, get: function () { return looking_1.lookingAction; } });
 __exportStar(require("./looking-events"), exports);
 var snippet_resolver_1 = require("./snippet-resolver");
 Object.defineProperty(exports, "resolveSnippetDescription", { enumerable: true, get: function () { return snippet_resolver_1.resolveSnippetDescription; } });
+var snippet_gate_registry_1 = require("./snippet-gate-registry");
+Object.defineProperty(exports, "registerSnippetGate", { enumerable: true, get: function () { return snippet_gate_registry_1.registerSnippetGate; } });
+Object.defineProperty(exports, "lookupSnippetGate", { enumerable: true, get: function () { return snippet_gate_registry_1.lookupSnippetGate; } });
+Object.defineProperty(exports, "clearSnippetGates", { enumerable: true, get: function () { return snippet_gate_registry_1.clearSnippetGates; } });
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/looking/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,mDAAiC;AACjC,uDAAoF;AAA3E,6HAAA,yBAAyB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/looking/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAEH,qCAA0C;AAAjC,wGAAA,aAAa,OAAA;AACtB,mDAAiC;AACjC,uDAAoF;AAA3E,6HAAA,yBAAyB,OAAA;AAClC,iEAKiC;AAJ/B,4HAAA,mBAAmB,OAAA;AACnB,0HAAA,iBAAiB,OAAA;AACjB,0HAAA,iBAAiB,OAAA"}

package/actions/standard/looking/snippet-gate-registry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Registered snippet-gate seam (ADR-211 Decision 3 / Q4) — non-presence
+ * `while` conditions on description fragments.
+ *
+ * Purpose: presence gates compile to serializable `mentions` data; every OTHER
+ * fragment condition is a predicate only its owning runtime (the Chord loader,
+ * package 2) can evaluate. This registry is the seam between the two: the
+ * runtime registers a thunk per `(roomId, marker)` at story load, and the
+ * snippet resolver consults it alongside — never replacing — the `mentions`
+ * data gate.
+ *
+ * Public interface: `registerSnippetGate`, `clearSnippetGates` (loader/test
+ * lifecycle), `lookupSnippetGate` (the resolver's read side).
+ *
+ * Owner context: `@sharpee/stdlib` — stdlib owns the scan and the gate
+ * (ADR-209 boundary resolution); this file sits beside `snippet-resolver.ts`,
+ * its one consumer. Modeled on the world-model state-clauses registry SHAPE
+ * (Map-based, idempotent-last-wins) with its own keying and lifecycle.
+ *
+ * LIFECYCLE CONTRACT (Q4): nothing here is serialized — a gate is a live
+ * closure and never touches a save file. Callers re-register every story load;
+ * that is what makes save/restore a non-event for gated fragments (the loader
+ * re-registers on the fresh process's load, and an in-game RESTORE reuses the
+ * registrations already in place). A story switch in one process clears first.
+ */
+/**
+ * A registered fragment gate: returns true while the fragment may render.
+ * A thunk, not a world-taking function — the registering runtime closes over
+ * its own world access and condition evaluator.
+ */
+export type SnippetGate = () => boolean;
+/**
+ * Register (or replace) the gate for one `(roomId, marker)` site. Idempotent —
+ * the latest registration wins, so a loader re-registering on a fresh load is
+ * a no-op rather than a stack of stale closures.
+ *
+ * @param roomId the room whose description carries the marker
+ * @param marker the marker name inside that room's description
+ * @param gate returns true while the fragment may render
+ */
+export declare function registerSnippetGate(roomId: string, marker: string, gate: SnippetGate): void;
+/**
+ * The resolver's read side: the registered gate for a site, if any.
+ *
+ * @param roomId the room being resolved
+ * @param marker the marker being resolved
+ * @returns the gate, or undefined when the site is ungated (the common case)
+ */
+export declare function lookupSnippetGate(roomId: string, marker: string): SnippetGate | undefined;
+/**
+ * Drop every registration — for tests and for a same-process story switch
+ * (a new story's load must not inherit another story's gates).
+ */
+export declare function clearSnippetGates(): void;
+//# sourceMappingURL=snippet-gate-registry.d.ts.map

package/actions/standard/looking/snippet-gate-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet-gate-registry.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/looking/snippet-gate-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC;AAOxC;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAE3F;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEzF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}

package/actions/standard/looking/snippet-gate-registry.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Registered snippet-gate seam (ADR-211 Decision 3 / Q4) — non-presence
+ * `while` conditions on description fragments.
+ *
+ * Purpose: presence gates compile to serializable `mentions` data; every OTHER
+ * fragment condition is a predicate only its owning runtime (the Chord loader,
+ * package 2) can evaluate. This registry is the seam between the two: the
+ * runtime registers a thunk per `(roomId, marker)` at story load, and the
+ * snippet resolver consults it alongside — never replacing — the `mentions`
+ * data gate.
+ *
+ * Public interface: `registerSnippetGate`, `clearSnippetGates` (loader/test
+ * lifecycle), `lookupSnippetGate` (the resolver's read side).
+ *
+ * Owner context: `@sharpee/stdlib` — stdlib owns the scan and the gate
+ * (ADR-209 boundary resolution); this file sits beside `snippet-resolver.ts`,
+ * its one consumer. Modeled on the world-model state-clauses registry SHAPE
+ * (Map-based, idempotent-last-wins) with its own keying and lifecycle.
+ *
+ * LIFECYCLE CONTRACT (Q4): nothing here is serialized — a gate is a live
+ * closure and never touches a save file. Callers re-register every story load;
+ * that is what makes save/restore a non-event for gated fragments (the loader
+ * re-registers on the fresh process's load, and an in-game RESTORE reuses the
+ * registrations already in place). A story switch in one process clears first.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerSnippetGate = registerSnippetGate;
+exports.lookupSnippetGate = lookupSnippetGate;
+exports.clearSnippetGates = clearSnippetGates;
+/** `(roomId, marker)` → gate. The `\0` join cannot collide with entity ids. */
+const gates = new Map();
+const keyOf = (roomId, marker) => `${roomId}\0${marker}`;
+/**
+ * Register (or replace) the gate for one `(roomId, marker)` site. Idempotent —
+ * the latest registration wins, so a loader re-registering on a fresh load is
+ * a no-op rather than a stack of stale closures.
+ *
+ * @param roomId the room whose description carries the marker
+ * @param marker the marker name inside that room's description
+ * @param gate returns true while the fragment may render
+ */
+function registerSnippetGate(roomId, marker, gate) {
+    gates.set(keyOf(roomId, marker), gate);
+}
+/**
+ * The resolver's read side: the registered gate for a site, if any.
+ *
+ * @param roomId the room being resolved
+ * @param marker the marker being resolved
+ * @returns the gate, or undefined when the site is ungated (the common case)
+ */
+function lookupSnippetGate(roomId, marker) {
+    return gates.get(keyOf(roomId, marker));
+}
+/**
+ * Drop every registration — for tests and for a same-process story switch
+ * (a new story's load must not inherit another story's gates).
+ */
+function clearSnippetGates() {
+    gates.clear();
+}
+//# sourceMappingURL=snippet-gate-registry.js.map

package/actions/standard/looking/snippet-gate-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snippet-gate-registry.js","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/looking/snippet-gate-registry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;;AAuBH,kDAEC;AASD,8CAEC;AAMD,8CAEC;AAnCD,+EAA+E;AAC/E,MAAM,KAAK,GAAG,IAAI,GAAG,EAAuB,CAAC;AAE7C,MAAM,KAAK,GAAG,CAAC,MAAc,EAAE,MAAc,EAAU,EAAE,CAAC,GAAG,MAAM,KAAK,MAAM,EAAE,CAAC;AAEjF;;;;;;;;GAQG;AACH,SAAgB,mBAAmB,CAAC,MAAc,EAAE,MAAc,EAAE,IAAiB;IACnF,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,iBAAiB,CAAC,MAAc,EAAE,MAAc;IAC9D,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB;IAC/B,KAAK,CAAC,KAAK,EAAE,CAAC;AAChB,CAAC"}

package/actions/standard/looking/snippet-resolver.d.ts

@@ -1,11 +1,17 @@
 /**
- * Room-description snippet resolver (ADR-209) — the scan/gate/resolve pass.
+ * Room-description snippet resolver (ADR-209 machinery, ADR-211 join rule) —
+ * the scan/gate/resolve pass.
  *
  * Splits a room description at `{snippet:name}` markers and builds the spliced
  * `Sequence` phrase: `Verbatim` prose segments interleaved with each marker's
  * resolved value (`Literal` for a fixed text, `Choice` for a variant list,
- * `Empty` for a gated-out / empty entry). Purely mechanical — every rendered
- * character is author-written.
+ * `Empty` for a gated-out / empty entry), each wrapped in a mode-annotated
+ * `Spliced` computed from the AUTHORED marker site (ADR-211 Decision 2).
+ * Fragments are BARE — this resolver emits no separator characters, ever; the
+ * join characters (`', '` / `' '`) are locale realization and belong to the
+ * Assembler. Boundary sites (start of text, paragraph edge) never wrap in
+ * `Spliced` at all: their separator is always empty, so the content phrase is
+ * emitted directly.
  *
  * Public interface: `resolveSnippetDescription`, `SnippetWorldQueries`.
  *

package/actions/standard/looking/snippet-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snippet-resolver.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/looking/snippet-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAEV,QAAQ,EAER,UAAU,EAEX,MAAM,oBAAoB,CAAC;AAG5B;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACjD,0DAA0D;IAC1D,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACjE;AAkDD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,mBAAmB,EAC1B,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GACzD,QAAQ,CAgEV"}
+{"version":3,"file":"snippet-resolver.d.ts","sourceRoot":"","sources":["../../../../../../../../../repos/sharpee_v2/packages/stdlib/src/actions/standard/looking/snippet-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAEV,QAAQ,EAER,UAAU,EAEX,MAAM,oBAAoB,CAAC;AAI5B;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,mEAAmE;IACnE,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACjD,0DAA0D;IAC1D,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CACjE;AAoFD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,UAAU,EACpB,KAAK,EAAE,mBAAmB,EAC1B,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GACzD,QAAQ,CA+FV"}

package/actions/standard/looking/snippet-resolver.js

@@ -1,12 +1,18 @@
 "use strict";
 /**
- * Room-description snippet resolver (ADR-209) — the scan/gate/resolve pass.
+ * Room-description snippet resolver (ADR-209 machinery, ADR-211 join rule) —
+ * the scan/gate/resolve pass.
  *
  * Splits a room description at `{snippet:name}` markers and builds the spliced
  * `Sequence` phrase: `Verbatim` prose segments interleaved with each marker's
  * resolved value (`Literal` for a fixed text, `Choice` for a variant list,
- * `Empty` for a gated-out / empty entry). Purely mechanical — every rendered
- * character is author-written.
+ * `Empty` for a gated-out / empty entry), each wrapped in a mode-annotated
+ * `Spliced` computed from the AUTHORED marker site (ADR-211 Decision 2).
+ * Fragments are BARE — this resolver emits no separator characters, ever; the
+ * join characters (`', '` / `' '`) are locale realization and belong to the
+ * Assembler. Boundary sites (start of text, paragraph edge) never wrap in
+ * `Spliced` at all: their separator is always empty, so the content phrase is
+ * emitted directly.
  *
  * Public interface: `resolveSnippetDescription`, `SnippetWorldQueries`.
  *
@@ -20,6 +26,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.resolveSnippetDescription = resolveSnippetDescription;
 const if_domain_1 = require("@sharpee/if-domain");
+const snippet_gate_registry_1 = require("./snippet-gate-registry");
 /** Normalize the four `SnippetEntry` forms (ADR-209 Interface contracts). */
 function normalizeEntry(entry) {
     if (typeof entry === 'string') {
@@ -51,8 +58,41 @@ function resolveText(item, roomId, marker, resolveMessage) {
         console.warn(`[snippet] room "${roomId}": message '${item.messageId}' for marker '${marker}' not found`);
         return '';
     }
+    // Bare-fragment rule on RESOLVED texts (ADR-211 AC-10): literal texts are
+    // gated at load; a messageId resolves at render, so enforcement here is the
+    // broken-build log posture — warn and join as-is, never throw mid-turn.
+    if (resolved !== '' && SEPARATOR_LED.test(resolved)) {
+        // eslint-disable-next-line no-console
+        console.warn(`[snippet] room "${roomId}": message '${item.messageId}' for marker '${marker}' is not a bare fragment ` +
+            `(leads with punctuation/whitespace) — the separator is platform-owned; joining as-is`);
+    }
     return resolved;
 }
+/** Separator-shaped leading characters a bare fragment must not carry (ADR-211). */
+const SEPARATOR_LED = /^[\s,.;:?!]/;
+/**
+ * Classify one marker site from the authored prose PRECEDING it (ADR-211
+ * Decision 2 edge rules). Markers are transparent — `precedingProse` is the
+ * concatenation of prose segments only, so an adjacent marker contributes no
+ * characters and the mode comes from the nearest real prose character.
+ */
+function classifySite(precedingProse) {
+    let i = precedingProse.length - 1;
+    let newlines = 0;
+    while (i >= 0 && /\s/.test(precedingProse[i])) {
+        if (precedingProse[i] === '\n')
+            newlines++;
+        i--;
+    }
+    if (i < 0)
+        return 'boundary'; // start of text
+    if (newlines >= 2)
+        return 'boundary'; // paragraph edge
+    // `.?!` end a sentence; `;:` don't, but they already ARE the join — a comma
+    // after them is never English, so they take the space-join too (the
+    // concealment-test dust site pinned this; ADR-211 Decision 2 amended).
+    return /[.?!;:]/.test(precedingProse[i]) ? 'sentence' : 'clause';
+}
 /**
  * Resolve the description text of a snippet-bearing room to its spliced
  * `Sequence` (ADR-209).
@@ -98,6 +138,24 @@ function resolveSnippetDescription(text, roomId, snippets, world, resolveMessage
             if (!present)
                 return { kind: 'empty' };
         }
+        // Registered gate (ADR-211 Decision 3 / Q4): a non-presence `while`
+        // condition registered per (roomId, marker) by the runtime that owns it.
+        // Applied alongside — never replacing — the `mentions` data gate above;
+        // both must hold. A throwing gate follows the render-graceful posture:
+        // log, splice nothing, never abort the turn.
+        const gate = (0, snippet_gate_registry_1.lookupSnippetGate)(roomId, name);
+        if (gate !== undefined) {
+            let holds = false;
+            try {
+                holds = gate();
+            }
+            catch (err) {
+                // eslint-disable-next-line no-console
+                console.warn(`[snippet] room "${roomId}": gate for marker '${name}' threw: ${err}`);
+            }
+            if (!holds)
+                return { kind: 'empty' };
+        }
         const texts = norm.texts.map((t) => resolveText(t, roomId, name, resolveMessage));
         // Single fixed text (string / SnippetText form): Literal, every render.
         if (norm.selector === undefined) {
@@ -116,11 +174,15 @@ function resolveSnippetDescription(text, roomId, snippets, world, resolveMessage
             messageKey: name,
         };
     };
+    // The authored prose seen so far — the site classifier's input. Markers are
+    // transparent (they contribute no characters), so only prose accrues.
+    let precedingProse = '';
     for (let i = 0; i < pieces.length; i++) {
         if (i % 2 === 0) {
             // Prose segment — opaque author text, exempt from whitespace collapse.
             if (pieces[i] !== '')
                 parts.push({ kind: 'verbatim', text: pieces[i] });
+            precedingProse += pieces[i];
         }
         else {
             const name = pieces[i];
@@ -129,7 +191,16 @@ function resolveSnippetDescription(text, roomId, snippets, world, resolveMessage
                 phrase = resolveMarker(name);
                 resolved.set(name, phrase);
             }
-            parts.push(phrase);
+            // ADR-211 Decision 2: the SITE decides the join mode — per occurrence,
+            // so a duplicate marker shares its resolved phrase (AC-8: one Choice
+            // node, one counter advance) but each site wraps it in its own mode.
+            // Boundary sites emit the content directly (their separator is always
+            // empty; `Spliced.mode` stays a true two-value enum), and a resolved
+            // `Empty` (gated-out / unbound / empty text) needs no wrapper — there
+            // is nothing to join.
+            const mode = classifySite(precedingProse);
+            const wrap = mode !== 'boundary' && phrase.kind !== 'empty';
+            parts.push(wrap ? { kind: 'spliced', mode, content: phrase } : phrase);
         }
     }
     return { kind: 'seq', parts };