@sharpee/world-model 0.9.111 → 1.0.0

package/traits/acoustic/acousticDampenerTrait.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Acoustic dampener trait — obstructor-side sound-cost contribution
+ * (ADR-172). Attaches to entities (tapestries, peepholes, foam panels,
+ * heavy curtains) that, when referenced as a wall side's obstructor
+ * (via `IWallSideData.obstructedBy` per ADR-173), modify the wall's
+ * effective acoustic cost.
+ *
+ * Per ADR-173's generalized obstructor protocol, the wall does *not*
+ * hardcode rules about what obstructors do; the obstructor's own
+ * traits declare which capabilities it modifies. `AcousticDampenerTrait`
+ * is the first capability-specific obstructor trait (ADR-172); future
+ * capabilities (visual line-of-sight, olfactory, thermal) ship sibling
+ * traits via the same protocol without changes to wall-substrate code.
+ *
+ * Sign convention:
+ *   - **Positive** `contribution` adds to the wall's effective cost
+ *     (dampens — tapestry, foam panel, heavy curtain).
+ *   - **Negative** `contribution` subtracts from the wall's effective
+ *     cost (more permeable — peephole, hole, vent opening).
+ *
+ * Phase 2 ships only the trait shape. The wall's effective acoustic
+ * cost is computed by the propagation algorithm in `@sharpee/engine`
+ * (Phase 3), which consults this trait via the obstructor-protocol
+ * helpers shipped in ADR-173 Phase 5.
+ *
+ * Owner context: `@sharpee/world-model` — wall / spatial primitives.
+ *
+ * @see ADR-172 — Spatial Sound Propagation
+ * @see ADR-173 — Wall Adjacency Primitive (obstructor protocol)
+ */
+import { ITrait } from '../trait';
+/**
+ * Acoustic dampener trait — attaches to obstructor entities (tapestry,
+ * peephole, foam panel, heavy curtain).
+ *
+ * @example
+ * const tapestry = author.createEntity('tapestry', EntityType.OBJECT);
+ * tapestry.add(new AcousticDampenerTrait(2));   // +2 dampening
+ * author.moveEntity(tapestry.id, parlor.id);
+ *
+ * world.createWall({
+ *   between: [parlor, library],
+ *   sides: {
+ *     [parlor.id]: { adjective: 'oak', obstructedBy: tapestry.id },
+ *     [library.id]: { adjective: 'brick' },
+ *   },
+ * });
+ */
+export declare class AcousticDampenerTrait implements ITrait {
+    readonly contribution: number;
+    static readonly type: "if.trait.acoustic_dampener";
+    /**
+     * Per ADR-173 taxonomy. Documentation only — not enforced; obstructors
+     * are referenced by the wall's per-side `obstructedBy` and located by
+     * room at query time per the ADR-173 obstructor protocol.
+     */
+    static readonly slot = "obstructor";
+    readonly type: "if.trait.acoustic_dampener";
+    constructor(contribution: number);
+}
+//# sourceMappingURL=acousticDampenerTrait.d.ts.map

package/traits/acoustic/acousticDampenerTrait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acousticDampenerTrait.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/traits/acoustic/acousticDampenerTrait.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,qBAAsB,YAAW,MAAM;aAUtB,YAAY,EAAE,MAAM;IAThD,MAAM,CAAC,QAAQ,CAAC,IAAI,+BAA+B;IACnD;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB;IACpC,QAAQ,CAAC,IAAI,+BAA+B;gBAEhB,YAAY,EAAE,MAAM;CACjD"}

package/traits/acoustic/acousticDampenerTrait.js

@@ -0,0 +1,38 @@
+"use strict";
+// packages/world-model/src/traits/acoustic/acousticDampenerTrait.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcousticDampenerTrait = void 0;
+const trait_types_1 = require("../trait-types");
+/**
+ * Acoustic dampener trait — attaches to obstructor entities (tapestry,
+ * peephole, foam panel, heavy curtain).
+ *
+ * @example
+ * const tapestry = author.createEntity('tapestry', EntityType.OBJECT);
+ * tapestry.add(new AcousticDampenerTrait(2));   // +2 dampening
+ * author.moveEntity(tapestry.id, parlor.id);
+ *
+ * world.createWall({
+ *   between: [parlor, library],
+ *   sides: {
+ *     [parlor.id]: { adjective: 'oak', obstructedBy: tapestry.id },
+ *     [library.id]: { adjective: 'brick' },
+ *   },
+ * });
+ */
+class AcousticDampenerTrait {
+    contribution;
+    static type = trait_types_1.TraitType.ACOUSTIC_DAMPENER;
+    /**
+     * Per ADR-173 taxonomy. Documentation only — not enforced; obstructors
+     * are referenced by the wall's per-side `obstructedBy` and located by
+     * room at query time per the ADR-173 obstructor protocol.
+     */
+    static slot = 'obstructor';
+    type = trait_types_1.TraitType.ACOUSTIC_DAMPENER;
+    constructor(contribution) {
+        this.contribution = contribution;
+    }
+}
+exports.AcousticDampenerTrait = AcousticDampenerTrait;
+//# sourceMappingURL=acousticDampenerTrait.js.map

package/traits/acoustic/acousticDampenerTrait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acousticDampenerTrait.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/world-model/src/traits/acoustic/acousticDampenerTrait.ts"],"names":[],"mappings":";AAAA,oEAAoE;;;AAkCpE,gDAA2C;AAE3C;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,qBAAqB;IAUJ;IAT5B,MAAM,CAAU,IAAI,GAAG,uBAAS,CAAC,iBAAiB,CAAC;IACnD;;;;OAIG;IACH,MAAM,CAAU,IAAI,GAAG,YAAY,CAAC;IAC3B,IAAI,GAAG,uBAAS,CAAC,iBAAiB,CAAC;IAE5C,YAA4B,YAAoB;QAApB,iBAAY,GAAZ,YAAY,CAAQ;IAAG,CAAC;;AAVtD,sDAWC"}

package/traits/acoustic/acousticTrait.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Acoustic trait — wall-intrinsic sound-cost data (ADR-172).
+ *
+ * Per ADR-173's whole-wall-vs-per-side trait taxonomy, a wall's *base*
+ * acoustic cost (the contribution of its material — plaster vs masonry
+ * vs soundproof panel) is symmetric from both sides. It lives in the
+ * whole-wall slot: attached to the wall entity itself, not to either
+ * side's per-side data.
+ *
+ * Per-side dampening (a tapestry covering one face, a peephole drilled
+ * through one face) lives on the *obstructor* entity and uses
+ * `AcousticDampenerTrait` (the per-side capability-specific obstructor
+ * trait per ADR-173's generalized obstructor protocol).
+ *
+ * Phase 2 ships only the trait shape and its tier→cost table. The
+ * propagation algorithm in `@sharpee/engine` (Phase 3) consumes
+ * `ACOUSTIC_TIER_COSTS`.
+ *
+ * Owner context: `@sharpee/world-model` — wall / spatial primitives.
+ *
+ * @see ADR-172 — Spatial Sound Propagation
+ * @see ADR-173 — Wall Adjacency Primitive (taxonomy)
+ */
+import { ITrait } from '../trait';
+/**
+ * The four discrete acoustic tiers a wall material may have. Authored
+ * qualitatively at world-load time; the propagation algorithm reads the
+ * cost via `ACOUSTIC_TIER_COSTS`.
+ */
+export type AcousticTier = 'thin' | 'default' | 'thick' | 'soundproof';
+/**
+ * Platform-default acoustic costs per wall tier, in path-cost units
+ * (ADR-172). Walls without an explicit `AcousticTrait` resolve to
+ * `default`.
+ *
+ * `Infinity` for `soundproof` collapses to `silent` audibility through
+ * the standard clarity formula (`clarity = budget − cost`) without the
+ * propagation algorithm needing a special case.
+ */
+export declare const ACOUSTIC_TIER_COSTS: Readonly<Record<AcousticTier, number>>;
+/**
+ * Acoustic trait — attaches to wall entities to declare their intrinsic
+ * acoustic cost tier. Whole-wall (symmetric) per ADR-173 taxonomy.
+ *
+ * @example
+ * world.createWall({
+ *   between: [parlor, library],
+ *   whole: [new AcousticTrait('thick')],
+ *   sides: { ... }
+ * });
+ */
+export declare class AcousticTrait implements ITrait {
+    readonly tier: AcousticTier;
+    static readonly type: "if.trait.acoustic";
+    /**
+     * Per ADR-173 taxonomy. Documentation only — not enforced; the wall
+     * creation API simply attaches whole-wall traits via `wall.add()`
+     * and per-side data via `wall.sides`.
+     */
+    static readonly slot = "whole-wall";
+    readonly type: "if.trait.acoustic";
+    constructor(tier: AcousticTier);
+}
+//# sourceMappingURL=acousticTrait.d.ts.map

package/traits/acoustic/acousticTrait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acousticTrait.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/traits/acoustic/acousticTrait.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,YAAY,CAAC;AAEvE;;;;;;;;GAQG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAKrE,CAAC;AAEH;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,YAAW,MAAM;aAUd,IAAI,EAAE,YAAY;IAT9C,MAAM,CAAC,QAAQ,CAAC,IAAI,sBAAsB;IAC1C;;;;OAIG;IACH,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB;IACpC,QAAQ,CAAC,IAAI,sBAAsB;gBAEP,IAAI,EAAE,YAAY;CAC/C"}

package/traits/acoustic/acousticTrait.js

@@ -0,0 +1,47 @@
+"use strict";
+// packages/world-model/src/traits/acoustic/acousticTrait.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcousticTrait = exports.ACOUSTIC_TIER_COSTS = void 0;
+const trait_types_1 = require("../trait-types");
+/**
+ * Platform-default acoustic costs per wall tier, in path-cost units
+ * (ADR-172). Walls without an explicit `AcousticTrait` resolve to
+ * `default`.
+ *
+ * `Infinity` for `soundproof` collapses to `silent` audibility through
+ * the standard clarity formula (`clarity = budget − cost`) without the
+ * propagation algorithm needing a special case.
+ */
+exports.ACOUSTIC_TIER_COSTS = Object.freeze({
+    thin: 2,
+    default: 4,
+    thick: 6,
+    soundproof: Number.POSITIVE_INFINITY,
+});
+/**
+ * Acoustic trait — attaches to wall entities to declare their intrinsic
+ * acoustic cost tier. Whole-wall (symmetric) per ADR-173 taxonomy.
+ *
+ * @example
+ * world.createWall({
+ *   between: [parlor, library],
+ *   whole: [new AcousticTrait('thick')],
+ *   sides: { ... }
+ * });
+ */
+class AcousticTrait {
+    tier;
+    static type = trait_types_1.TraitType.ACOUSTIC;
+    /**
+     * Per ADR-173 taxonomy. Documentation only — not enforced; the wall
+     * creation API simply attaches whole-wall traits via `wall.add()`
+     * and per-side data via `wall.sides`.
+     */
+    static slot = 'whole-wall';
+    type = trait_types_1.TraitType.ACOUSTIC;
+    constructor(tier) {
+        this.tier = tier;
+    }
+}
+exports.AcousticTrait = AcousticTrait;
+//# sourceMappingURL=acousticTrait.js.map

package/traits/acoustic/acousticTrait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"acousticTrait.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/world-model/src/traits/acoustic/acousticTrait.ts"],"names":[],"mappings":";AAAA,4DAA4D;;;AA2B5D,gDAA2C;AAS3C;;;;;;;;GAQG;AACU,QAAA,mBAAmB,GAA2C,MAAM,CAAC,MAAM,CAAC;IACvF,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;IACR,UAAU,EAAE,MAAM,CAAC,iBAAiB;CACrC,CAAC,CAAC;AAEH;;;;;;;;;;GAUG;AACH,MAAa,aAAa;IAUI;IAT5B,MAAM,CAAU,IAAI,GAAG,uBAAS,CAAC,QAAQ,CAAC;IAC1C;;;;OAIG;IACH,MAAM,CAAU,IAAI,GAAG,YAAY,CAAC;IAC3B,IAAI,GAAG,uBAAS,CAAC,QAAQ,CAAC;IAEnC,YAA4B,IAAkB;QAAlB,SAAI,GAAJ,IAAI,CAAc;IAAG,CAAC;;AAVpD,sCAWC"}

package/traits/acoustic/index.d.ts

@@ -0,0 +1,3 @@
+export { AcousticTrait, ACOUSTIC_TIER_COSTS, type AcousticTier } from './acousticTrait';
+export { AcousticDampenerTrait } from './acousticDampenerTrait';
+//# sourceMappingURL=index.d.ts.map

package/traits/acoustic/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/traits/acoustic/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC"}

package/traits/acoustic/index.js

@@ -0,0 +1,10 @@
+"use strict";
+// packages/world-model/src/traits/acoustic/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AcousticDampenerTrait = exports.ACOUSTIC_TIER_COSTS = exports.AcousticTrait = void 0;
+var acousticTrait_1 = require("./acousticTrait");
+Object.defineProperty(exports, "AcousticTrait", { enumerable: true, get: function () { return acousticTrait_1.AcousticTrait; } });
+Object.defineProperty(exports, "ACOUSTIC_TIER_COSTS", { enumerable: true, get: function () { return acousticTrait_1.ACOUSTIC_TIER_COSTS; } });
+var acousticDampenerTrait_1 = require("./acousticDampenerTrait");
+Object.defineProperty(exports, "AcousticDampenerTrait", { enumerable: true, get: function () { return acousticDampenerTrait_1.AcousticDampenerTrait; } });
+//# sourceMappingURL=index.js.map

package/traits/acoustic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/world-model/src/traits/acoustic/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;;;AAEpD,iDAAwF;AAA/E,8GAAA,aAAa,OAAA;AAAE,oHAAA,mBAAmB,OAAA;AAC3C,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA"}

package/traits/implementations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"implementations.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/traits/implementations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"implementations.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/traits/implementations.ts"],"names":[],"mappings":"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"}

package/traits/implementations.js

@@ -89,6 +89,10 @@ Object.defineProperty(exports, "EnterableTrait", { enumerable: true, get: functi
 // Concealment traits (ADR-148)
 const concealmentTrait_1 = require("./concealment/concealmentTrait");
 const concealedStateTrait_1 = require("./concealment/concealedStateTrait");
+// Spatial sound traits (ADR-172)
+const acousticTrait_1 = require("./acoustic/acousticTrait");
+const acousticDampenerTrait_1 = require("./acoustic/acousticDampenerTrait");
+const listenerTrait_1 = require("./listener/listenerTrait");
 // System traits
 const storyInfoTrait_1 = require("./story-info/storyInfoTrait");
 Object.defineProperty(exports, "StoryInfoTrait", { enumerable: true, get: function () { return storyInfoTrait_1.StoryInfoTrait; } });
@@ -143,6 +147,10 @@ exports.TRAIT_IMPLEMENTATIONS = {
     // Concealment traits (ADR-148)
     [trait_types_1.TraitType.CONCEALMENT]: concealmentTrait_1.ConcealmentTrait,
     [trait_types_1.TraitType.CONCEALED_STATE]: concealedStateTrait_1.ConcealedStateTrait,
+    // Spatial sound traits (ADR-172)
+    [trait_types_1.TraitType.ACOUSTIC]: acousticTrait_1.AcousticTrait,
+    [trait_types_1.TraitType.ACOUSTIC_DAMPENER]: acousticDampenerTrait_1.AcousticDampenerTrait,
+    [trait_types_1.TraitType.LISTENER]: listenerTrait_1.ListenerTrait,
     // System traits
     [trait_types_1.TraitType.STORY_INFO]: storyInfoTrait_1.StoryInfoTrait,
     // Object property traits

package/traits/implementations.js.map

@@ -1 +1 @@
-{"version":3,"file":"implementations.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/traits/implementations.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"implementations.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/traits/implementations.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAuJH,wDAEC;AAKD,kCAMC;AAlKD,+CAA0C;AAG1C,4DAA4D;AAC5D,4DAAyD;AAmKvD,8FAnKO,6BAAa,OAmKP;AAlKf,+DAA4D;AAmK1D,+FAnKO,+BAAc,OAmKP;AAlKhB,+DAA4D;AAmK1D,+FAnKO,+BAAc,OAmKP;AAlKhB,gDAA6C;AAmK3C,0FAnKO,qBAAS,OAmKP;AAlKX,4DAAyD;AAmKvD,8FAnKO,6BAAa,OAmKP;AAlKf,4DAAyD;AAmKvD,8FAnKO,6BAAa,OAmKP;AAlKf,sDAAmD;AAmKjD,4FAnKO,yBAAW,OAmKP;AAlKb,yDAAsD;AAmKpD,6FAnKO,2BAAY,OAmKP;AAjKd,4DAAyD;AAoKvD,8FApKO,6BAAa,OAoKP;AAnKf,4DAAyD;AAoKvD,8FApKO,6BAAa,OAoKP;AAnKf,kEAA+D;AAoK7D,gGApKO,iCAAe,OAoKP;AAnKjB,4DAAyD;AAoKvD,8FApKO,6BAAa,OAoKP;AAnKf,sEAAmE;AAoKjE,iGApKO,mCAAgB,OAoKP;AAlKlB,iBAAiB;AACjB,gDAA6C;AAoK3C,0FApKO,qBAAS,OAoKP;AAnKX,+DAA4D;AA4K1D,+FA5KO,+BAAc,OA4KP;AA3KhB,sDAAmD;AAmKjD,4FAnKO,yBAAW,OAmKP;AAlKb,mDAAgD;AAmK9C,2FAnKO,uBAAU,OAmKP;AAjKZ,eAAe;AACf,mDAAgD;AAmK9C,2FAnKO,uBAAU,OAmKP;AAjKZ,aAAa;AACb,gDAA6C;AAmK3C,0FAnKO,qBAAS,OAmKP;AAjKX,sBAAsB;AACtB,4DAAyD;AAoKvD,8FApKO,6BAAa,OAoKP;AAnKf,4DAAyD;AAoKvD,8FApKO,6BAAa,OAoKP;AAnKf,4DAAyD;AAoKvD,8FApKO,6BAAa,OAoKP;AAnKf,sDAAmD;AAoKjD,4FApKO,yBAAW,OAoKP;AAnKb,kFAA+E;AAoK7E,qGApKO,2CAAoB,OAoKP;AAlKtB,gBAAgB;AAChB,sDAAmD;AAoKjD,4FApKO,yBAAW,OAoKP;AAnKb,+DAA4D;AAoK1D,+FApKO,+BAAc,OAoKP;AAnKhB,wEAAqE;AAoKnE,kGApKO,qCAAiB,OAoKP;AAnKnB,+DAA4D;AAoK1D,+FApKO,+BAAc,OAoKP;AAnKhB,4DAAyD;AAoKvD,8FApKO,6BAAa,OAoKP;AAlKf,uBAAuB;AACvB,6CAA0C;AAoKxC,yFApKO,mBAAQ,OAoKP;AAnKV,4EAAyE;AAoKvE,mGApKO,uCAAkB,OAoKP;AAlKpB,4BAA4B;AAC5B,+EAA4E;AAoK1E,oGApKO,yCAAmB,OAoKP;AAlKrB,mBAAmB;AACnB,yDAAsD;AAoKpD,6FApKO,2BAAY,OAoKP;AAnKd,+DAA4D;AAoK1D,+FApKO,+BAAc,OAoKP;AAlKhB,+BAA+B;AAC/B,qEAAkE;AAClE,2EAAwE;AAExE,iCAAiC;AACjC,4DAAyD;AACzD,4EAAyE;AACzE,4DAAyD;AAEzD,gBAAgB;AAChB,gEAA6D;AA2J3D,+FA3JO,+BAAc,OA2JP;AAzJhB;;GAEG;AACU,QAAA,qBAAqB,GAAyC;IACzE,+CAA+C;IAC/C,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,6BAAa;IACnC,CAAC,uBAAS,CAAC,SAAS,CAAC,EAAE,+BAAc;IACrC,CAAC,uBAAS,CAAC,SAAS,CAAC,EAAE,+BAAc;IACrC,CAAC,uBAAS,CAAC,IAAI,CAAC,EAAE,qBAAS;IAC3B,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,6BAAa;IACnC,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,6BAAa;IACnC,CAAC,uBAAS,CAAC,MAAM,CAAC,EAAE,yBAAW;IAC/B,CAAC,uBAAS,CAAC,OAAO,CAAC,EAAE,2BAAY;IAEjC,qBAAqB;IACrB,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,6BAAa;IACnC,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,6BAAa;IACnC,CAAC,uBAAS,CAAC,UAAU,CAAC,EAAE,iCAAe;IACvC,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,6BAAa;IACnC,CAAC,uBAAS,CAAC,YAAY,CAAC,EAAE,mCAAgB;IAE1C,iBAAiB;IACjB,CAAC,uBAAS,CAAC,IAAI,CAAC,EAAE,qBAAS;IAC3B,CAAC,uBAAS,CAAC,SAAS,CAAC,EAAE,+BAAc;IACrC,CAAC,uBAAS,CAAC,MAAM,CAAC,EAAE,yBAAW;IAC/B,CAAC,uBAAS,CAAC,KAAK,CAAC,EAAE,uBAAU;IAE7B,eAAe;IACf,CAAC,uBAAS,CAAC,KAAK,CAAC,EAAE,uBAAU;IAE7B,aAAa;IACb,CAAC,uBAAS,CAAC,IAAI,CAAC,EAAE,qBAAS;IAE3B,sBAAsB;IACtB,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,6BAAa;IACnC,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,6BAAa;IACnC,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,6BAAa;IACnC,CAAC,uBAAS,CAAC,MAAM,CAAC,EAAE,yBAAW;IAC/B,CAAC,uBAAS,CAAC,gBAAgB,CAAC,EAAE,2CAAoB;IAElD,gBAAgB;IAChB,CAAC,uBAAS,CAAC,MAAM,CAAC,EAAE,yBAAW;IAC/B,CAAC,uBAAS,CAAC,SAAS,CAAC,EAAE,+BAAc;IACrC,CAAC,uBAAS,CAAC,YAAY,CAAC,EAAE,qCAAiB;IAC3C,CAAC,uBAAS,CAAC,SAAS,CAAC,EAAE,+BAAc;IACrC,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,6BAAa;IAEnC,uBAAuB;IACvB,CAAC,uBAAS,CAAC,GAAG,CAAC,EAAE,mBAAQ;IACzB,CAAC,uBAAS,CAAC,cAAc,CAAC,EAAE,uCAAkB;IAE9C,4BAA4B;IAC5B,CAAC,uBAAS,CAAC,eAAe,CAAC,EAAE,yCAAmB;IAEhD,mBAAmB;IACnB,CAAC,uBAAS,CAAC,OAAO,CAAC,EAAE,2BAAY;IACjC,CAAC,uBAAS,CAAC,SAAS,CAAC,EAAE,+BAAc;IAErC,+BAA+B;IAC/B,CAAC,uBAAS,CAAC,WAAW,CAAC,EAAE,mCAAgD;IACzE,CAAC,uBAAS,CAAC,eAAe,CAAC,EAAE,yCAAmD;IAEhF,iCAAiC;IACjC,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,6BAA6C;IACnE,CAAC,uBAAS,CAAC,iBAAiB,CAAC,EAAE,6CAAqD;IACpF,CAAC,uBAAS,CAAC,QAAQ,CAAC,EAAE,6BAAa;IAEnC,gBAAgB;IAChB,CAAC,uBAAS,CAAC,UAAU,CAAC,EAAE,+BAAc;IAEtC,yBAAyB;IAEzB,yDAAyD;IACzD,+CAA+C;IAC/C,2EAA2E;IAC3E,8BAA8B;CAC/B,CAAC;AAEF;;GAEG;AACH,SAAgB,sBAAsB,CAAC,IAAe;IACpD,OAAO,6BAAqB,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,IAAe,EAAE,IAAU;IACrD,MAAM,UAAU,GAAG,6BAAqB,CAAC,IAAI,CAAC,CAAC;IAC/C,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/traits/index.d.ts

@@ -37,6 +37,9 @@ export * from './open-inventory';
 export * from './character-model';
 export * from './concealment';
 export * from './story-info';
+export * from './obstructor-protocol';
+export * from './acoustic';
+export * from './listener';
 export * from './register-all';
 export * from './all-traits';
 //# sourceMappingURL=index.d.ts.map

package/traits/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/traits/index.ts"],"names":[],"mappings":"AAIA,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AAGnC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAG3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAG5B,cAAc,OAAO,CAAC;AACtB,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAG7B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/traits/index.ts"],"names":[],"mappings":"AAIA,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AAGxB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,oBAAoB,CAAC;AAGnC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAG3B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAG5B,cAAc,OAAO,CAAC;AACtB,cAAc,kBAAkB,CAAC;AAGjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,eAAe,CAAC;AAG9B,cAAc,cAAc,CAAC;AAG7B,cAAc,uBAAuB,CAAC;AAGtC,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAG3B,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC"}

package/traits/index.js

@@ -64,6 +64,11 @@ __exportStar(require("./character-model"), exports);
 __exportStar(require("./concealment"), exports);
 // System traits
 __exportStar(require("./story-info"), exports);
+// Wall obstructor protocol (ADR-173 Phase 5)
+__exportStar(require("./obstructor-protocol"), exports);
+// Spatial sound traits (ADR-172 Phase 2)
+__exportStar(require("./acoustic"), exports);
+__exportStar(require("./listener"), exports);
 // Register function
 __exportStar(require("./register-all"), exports);
 // All traits in one import

package/traits/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/traits/index.ts"],"names":[],"mappings":";AAAA,2CAA2C;AAC3C,sCAAsC;;;;;;;;;;;;;;;;AAEtC,mBAAmB;AACnB,0CAAwB;AACxB,gDAA8B;AAC9B,oDAAkC;AAElC,kEAAkE;AAClE,6CAA2B;AAC3B,8CAA4B;AAC5B,yCAAuB;AACvB,6CAA2B;AAC3B,6CAA2B;AAC3B,6CAA2B;AAC3B,iDAA+B;AAC/B,yCAAuB;AACvB,8CAA4B;AAC5B,4CAA0B;AAC1B,8CAA4B;AAC5B,+CAA6B;AAC7B,6CAA2B;AAC3B,6CAA2B;AAC3B,2CAAyB;AACzB,yCAAuB;AACvB,2CAAyB;AACzB,0CAAwB;AACxB,0CAAwB;AAExB,sBAAsB;AACtB,6CAA2B;AAC3B,6CAA2B;AAC3B,6CAA2B;AAC3B,2CAAyB;AACzB,qDAAmC;AAEnC,gBAAgB;AAChB,2CAAyB;AACzB,8CAA4B;AAC5B,iDAA+B;AAC/B,8CAA4B;AAC5B,6CAA2B;AAE3B,mBAAmB;AACnB,4CAA0B;AAC1B,8CAA4B;AAE5B,aAAa;AACb,wCAAsB;AACtB,mDAAiC;AAEjC,4BAA4B;AAC5B,oDAAkC;AAElC,+BAA+B;AAC/B,gDAA8B;AAE9B,gBAAgB;AAChB,+CAA6B;AAE7B,oBAAoB;AACpB,iDAA+B;AAE/B,2BAA2B;AAC3B,+CAA6B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/traits/index.ts"],"names":[],"mappings":";AAAA,2CAA2C;AAC3C,sCAAsC;;;;;;;;;;;;;;;;AAEtC,mBAAmB;AACnB,0CAAwB;AACxB,gDAA8B;AAC9B,oDAAkC;AAElC,kEAAkE;AAClE,6CAA2B;AAC3B,8CAA4B;AAC5B,yCAAuB;AACvB,6CAA2B;AAC3B,6CAA2B;AAC3B,6CAA2B;AAC3B,iDAA+B;AAC/B,yCAAuB;AACvB,8CAA4B;AAC5B,4CAA0B;AAC1B,8CAA4B;AAC5B,+CAA6B;AAC7B,6CAA2B;AAC3B,6CAA2B;AAC3B,2CAAyB;AACzB,yCAAuB;AACvB,2CAAyB;AACzB,0CAAwB;AACxB,0CAAwB;AAExB,sBAAsB;AACtB,6CAA2B;AAC3B,6CAA2B;AAC3B,6CAA2B;AAC3B,2CAAyB;AACzB,qDAAmC;AAEnC,gBAAgB;AAChB,2CAAyB;AACzB,8CAA4B;AAC5B,iDAA+B;AAC/B,8CAA4B;AAC5B,6CAA2B;AAE3B,mBAAmB;AACnB,4CAA0B;AAC1B,8CAA4B;AAE5B,aAAa;AACb,wCAAsB;AACtB,mDAAiC;AAEjC,4BAA4B;AAC5B,oDAAkC;AAElC,+BAA+B;AAC/B,gDAA8B;AAE9B,gBAAgB;AAChB,+CAA6B;AAE7B,6CAA6C;AAC7C,wDAAsC;AAEtC,yCAAyC;AACzC,6CAA2B;AAC3B,6CAA2B;AAE3B,oBAAoB;AACpB,iDAA+B;AAE/B,2BAA2B;AAC3B,+CAA6B"}

package/traits/listener/index.d.ts

@@ -0,0 +1,2 @@
+export { ListenerTrait } from './listenerTrait';
+//# sourceMappingURL=index.d.ts.map

package/traits/listener/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/traits/listener/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC"}

package/traits/listener/index.js

@@ -0,0 +1,7 @@
+"use strict";
+// packages/world-model/src/traits/listener/index.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListenerTrait = void 0;
+var listenerTrait_1 = require("./listenerTrait");
+Object.defineProperty(exports, "ListenerTrait", { enumerable: true, get: function () { return listenerTrait_1.ListenerTrait; } });
+//# sourceMappingURL=index.js.map

package/traits/listener/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/world-model/src/traits/listener/index.ts"],"names":[],"mappings":";AAAA,oDAAoD;;;AAEpD,iDAAgD;AAAvC,8GAAA,aAAa,OAAA"}

package/traits/listener/listenerTrait.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Listener trait — marks an entity as eligible to receive
+ * `AudibilityEvent`s from the propagation function (ADR-172).
+ *
+ * Per ADR-172 §Multi-listener dispatch:
+ *  - The **player** gets this trait automatically during engine
+ *    initialization (Phase 4 wires this); story authors do not add it
+ *    manually.
+ *  - **NPCs** opt in by attaching the trait (used by L2+ for NPC
+ *    reactivity — e.g., an NPC hears a scream and runs toward it).
+ *  - **Devices** may also be Listeners (an intercom microphone, a
+ *    phone receiver, a recorder); see ADR-172 §Active acoustic
+ *    devices (deferred composition pattern).
+ *
+ * Phase 2 ships the trait as a presence flag — no data fields. Future
+ * fields (per-listener sensitivity, deafness, kind filters) require a
+ * future ADR.
+ *
+ * Owner context: `@sharpee/world-model` — sensory primitives.
+ *
+ * @see ADR-172 — Spatial Sound Propagation
+ */
+import { ITrait } from '../trait';
+/**
+ * Listener trait — presence flag. Entities carrying it are enumerated
+ * by the propagation function and receive `AudibilityEvent`s.
+ *
+ * @example
+ * // Engine player init (Phase 4) attaches automatically:
+ * player.add(new ListenerTrait());
+ *
+ * // Story-side NPC opt-in:
+ * const guard = author.createEntity('guard', EntityType.ACTOR);
+ * guard.add(new ListenerTrait());
+ */
+export declare class ListenerTrait implements ITrait {
+    static readonly type: "if.trait.listener";
+    readonly type: "if.trait.listener";
+}
+//# sourceMappingURL=listenerTrait.d.ts.map

package/traits/listener/listenerTrait.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"listenerTrait.d.ts","sourceRoot":"","sources":["../../../../../../../repos/sharpee/packages/world-model/src/traits/listener/listenerTrait.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGlC;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,MAAM,CAAC,QAAQ,CAAC,IAAI,sBAAsB;IAC1C,QAAQ,CAAC,IAAI,sBAAsB;CACpC"}

package/traits/listener/listenerTrait.js

@@ -0,0 +1,23 @@
+"use strict";
+// packages/world-model/src/traits/listener/listenerTrait.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListenerTrait = void 0;
+const trait_types_1 = require("../trait-types");
+/**
+ * Listener trait — presence flag. Entities carrying it are enumerated
+ * by the propagation function and receive `AudibilityEvent`s.
+ *
+ * @example
+ * // Engine player init (Phase 4) attaches automatically:
+ * player.add(new ListenerTrait());
+ *
+ * // Story-side NPC opt-in:
+ * const guard = author.createEntity('guard', EntityType.ACTOR);
+ * guard.add(new ListenerTrait());
+ */
+class ListenerTrait {
+    static type = trait_types_1.TraitType.LISTENER;
+    type = trait_types_1.TraitType.LISTENER;
+}
+exports.ListenerTrait = ListenerTrait;
+//# sourceMappingURL=listenerTrait.js.map

package/traits/listener/listenerTrait.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listenerTrait.js","sourceRoot":"","sources":["../../../../../../../../repos/sharpee/packages/world-model/src/traits/listener/listenerTrait.ts"],"names":[],"mappings":";AAAA,4DAA4D;;;AA0B5D,gDAA2C;AAE3C;;;;;;;;;;;GAWG;AACH,MAAa,aAAa;IACxB,MAAM,CAAU,IAAI,GAAG,uBAAS,CAAC,QAAQ,CAAC;IACjC,IAAI,GAAG,uBAAS,CAAC,QAAQ,CAAC;;AAFrC,sCAGC"}

package/traits/obstructor-protocol.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Generalized obstructor-protocol query helpers (ADR-173).
+ *
+ * A wall side may declare an `obstructedBy` reference to another entity in
+ * the same room. That obstructor's *own traits* declare the capabilities it
+ * modifies — `AcousticDampenerTrait` for sound (ADR-172), future
+ * `BreachBlockerTrait` for breaching, future `VisualConduitTrait` for
+ * line-of-sight, and so on. The wall is the aggregator: capability consumers
+ * call into this module to ask "is there a contribution from this side's
+ * obstructor for this capability?", and the wall walks both sides for the
+ * cross-side sum AC-9 + AC-10 in ADR-173 require.
+ *
+ * Per ADR-173 §"obstruction is automatically lifted when the obstructor
+ * moves", the obstructor's *current* location is re-checked at query time —
+ * the wall does not store an obstruction flag. Move the bookcase aside and
+ * the obstruction lifts without explicit event handling. Authors who want
+ * custom side-effects on movement use ADR-052 event handlers in the usual
+ * way; the default protocol behavior is purely query-time.
+ *
+ * Public interface: `getCurrentObstructor`, `findTraitOnObstructor`,
+ * `findTraitsOnObstructors`. The latter two implement the obstructor-trait
+ * protocol; the first is the underlying location-aware lookup useful for
+ * non-trait queries (e.g. a future BREACH action rendering "the bookcase
+ * blocks your access" without consulting any trait).
+ *
+ * Owner context: `@sharpee/world-model` — wall / spatial primitives.
+ */
+import type { EntityId } from "../../core/index";
+import type { IFEntity } from '../entities/if-entity';
+import type { WallEntity } from '../entities/wall-entity';
+import type { ITrait } from './trait';
+/**
+ * Narrow world-model surface required to evaluate obstructors. Implemented
+ * by `WorldModel`; passed in by callers so the helper has no implicit
+ * dependency on the full world API.
+ */
+export interface IObstructorQueryWorld {
+    getEntity(id: string): IFEntity | undefined;
+    getLocation(id: string): string | undefined;
+}
+/**
+ * Returns the entity currently obstructing a wall side, or undefined when
+ * no obstructor is in effect.
+ *
+ * Returns undefined when:
+ *  - the side has no `obstructedBy` declared
+ *  - the obstructor entity no longer exists in the world
+ *  - the obstructor is not currently located in the side's room (it was
+ *    moved aside, taken into inventory, etc.)
+ *
+ * The runtime location check is the load-bearing semantics: ADR-173 keeps
+ * obstruction state implicit so that PUSH BOOKCASE / TAKE TAPESTRY lift
+ * obstruction without further bookkeeping.
+ */
+export declare function getCurrentObstructor(wall: WallEntity, side: EntityId, world: IObstructorQueryWorld): IFEntity | undefined;
+/**
+ * Returns the capability-specific trait carried by the given side's current
+ * obstructor, or undefined if no contribution applies.
+ *
+ * Returns undefined when:
+ *  - no obstructor is currently present on this side
+ *    (per `getCurrentObstructor`)
+ *  - the obstructor lacks the requested trait
+ *
+ * AC-10 (ADR-173): an obstructor lacking the trait contributes zero to that
+ * capability — callers that sum contributions treat undefined as 0.
+ */
+export declare function findTraitOnObstructor<T extends ITrait>(wall: WallEntity, side: EntityId, traitType: string, world: IObstructorQueryWorld): T | undefined;
+/**
+ * Result of a cross-side obstructor-trait scan: one entry per side that has
+ * a current obstructor carrying the requested trait. The `side` field is
+ * the room id of the obstructed side (i.e. the room the obstructor sits
+ * in); the `obstructor` is the resolved entity; `trait` is the matching
+ * trait instance.
+ */
+export interface IObstructorTraitMatch<T extends ITrait> {
+    side: EntityId;
+    obstructor: IFEntity;
+    trait: T;
+}
+/**
+ * Walks both sides of the wall and returns the matching capability-specific
+ * trait for each side that has one.
+ *
+ * Returns an empty array when neither side has an obstructor with the
+ * requested trait — the AC-10 zero-contribution case for the cross-side
+ * aggregation pattern.
+ *
+ * This is the helper ADR-172's acoustic-cost formula consults to sum
+ * `AcousticDampenerTrait.acousticCostModifier` across both sides
+ * (AC-9 in ADR-173, AC-7 in ADR-172). Future capabilities follow the same
+ * shape — pass the trait type the capability declares, sum contributions
+ * the way that capability cares about.
+ */
+export declare function findTraitsOnObstructors<T extends ITrait>(wall: WallEntity, traitType: string, world: IObstructorQueryWorld): IObstructorTraitMatch<T>[];
+//# sourceMappingURL=obstructor-protocol.d.ts.map

package/traits/obstructor-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"obstructor-protocol.d.ts","sourceRoot":"","sources":["../../../../../../repos/sharpee/packages/world-model/src/traits/obstructor-protocol.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC7C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,qBAAqB,GAC3B,QAAQ,GAAG,SAAS,CAUtB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EACpD,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,QAAQ,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,qBAAqB,GAC3B,CAAC,GAAG,SAAS,CAIf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC,SAAS,MAAM;IACrD,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,QAAQ,CAAC;IACrB,KAAK,EAAE,CAAC,CAAC;CACV;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,SAAS,MAAM,EACtD,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,qBAAqB,GAC3B,qBAAqB,CAAC,CAAC,CAAC,EAAE,CAU5B"}

package/traits/obstructor-protocol.js

@@ -0,0 +1,77 @@
+"use strict";
+// packages/world-model/src/traits/obstructor-protocol.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentObstructor = getCurrentObstructor;
+exports.findTraitOnObstructor = findTraitOnObstructor;
+exports.findTraitsOnObstructors = findTraitsOnObstructors;
+/**
+ * Returns the entity currently obstructing a wall side, or undefined when
+ * no obstructor is in effect.
+ *
+ * Returns undefined when:
+ *  - the side has no `obstructedBy` declared
+ *  - the obstructor entity no longer exists in the world
+ *  - the obstructor is not currently located in the side's room (it was
+ *    moved aside, taken into inventory, etc.)
+ *
+ * The runtime location check is the load-bearing semantics: ADR-173 keeps
+ * obstruction state implicit so that PUSH BOOKCASE / TAKE TAPESTRY lift
+ * obstruction without further bookkeeping.
+ */
+function getCurrentObstructor(wall, side, world) {
+    const sideData = wall.getSide(side);
+    if (!sideData?.obstructedBy)
+        return undefined;
+    const obstructor = world.getEntity(sideData.obstructedBy);
+    if (!obstructor)
+        return undefined;
+    if (world.getLocation(obstructor.id) !== side)
+        return undefined;
+    return obstructor;
+}
+/**
+ * Returns the capability-specific trait carried by the given side's current
+ * obstructor, or undefined if no contribution applies.
+ *
+ * Returns undefined when:
+ *  - no obstructor is currently present on this side
+ *    (per `getCurrentObstructor`)
+ *  - the obstructor lacks the requested trait
+ *
+ * AC-10 (ADR-173): an obstructor lacking the trait contributes zero to that
+ * capability — callers that sum contributions treat undefined as 0.
+ */
+function findTraitOnObstructor(wall, side, traitType, world) {
+    const obstructor = getCurrentObstructor(wall, side, world);
+    if (!obstructor)
+        return undefined;
+    return obstructor.get(traitType);
+}
+/**
+ * Walks both sides of the wall and returns the matching capability-specific
+ * trait for each side that has one.
+ *
+ * Returns an empty array when neither side has an obstructor with the
+ * requested trait — the AC-10 zero-contribution case for the cross-side
+ * aggregation pattern.
+ *
+ * This is the helper ADR-172's acoustic-cost formula consults to sum
+ * `AcousticDampenerTrait.acousticCostModifier` across both sides
+ * (AC-9 in ADR-173, AC-7 in ADR-172). Future capabilities follow the same
+ * shape — pass the trait type the capability declares, sum contributions
+ * the way that capability cares about.
+ */
+function findTraitsOnObstructors(wall, traitType, world) {
+    const matches = [];
+    for (const side of wall.between) {
+        const obstructor = getCurrentObstructor(wall, side, world);
+        if (!obstructor)
+            continue;
+        const trait = obstructor.get(traitType);
+        if (!trait)
+            continue;
+        matches.push({ side, obstructor, trait });
+    }
+    return matches;
+}
+//# sourceMappingURL=obstructor-protocol.js.map