@sharpee/world-model 0.9.66-beta → 0.9.67-beta

package/interfaces/command-validator.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Command validator interface for resolving entities and checking preconditions
+ */
+import type { IParsedCommand, IValidatedCommand, IValidationError } from '../commands';
+import type { Result } from "../src/index";
+/**
+ * Validator interface - resolves entities and checks preconditions
+ */
+export interface ICommandValidator {
+    /**
+     * Validate parsed command against world state
+     * @param command Parsed command to validate
+     * @returns Validated command or validation error
+     */
+    validate(command: IParsedCommand): Result<IValidatedCommand, IValidationError>;
+}
+//# sourceMappingURL=command-validator.d.ts.map

package/interfaces/command-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-validator.d.ts","sourceRoot":"","sources":["../../../../../../mnt/c/repotemp/sharpee/packages/world-model/src/interfaces/command-validator.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;CAChF"}

package/interfaces/command-validator.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Command validator interface for resolving entities and checking preconditions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=command-validator.js.map

package/interfaces/command-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-validator.js","sourceRoot":"","sources":["../../../../../../../../../mnt/c/repotemp/sharpee/packages/world-model/src/interfaces/command-validator.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/interfaces/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Core interfaces for the IF command processing system
+ */
+export * from './parser';
+export * from './command-validator';
+export * from './command-executor';
+export * from './command-processor';
+//# sourceMappingURL=index.d.ts.map

package/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../mnt/c/repotemp/sharpee/packages/world-model/src/interfaces/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC"}

package/interfaces/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Core interfaces for the IF command processing system
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./parser"), exports);
+__exportStar(require("./command-validator"), exports);
+__exportStar(require("./command-executor"), exports);
+__exportStar(require("./command-processor"), exports);
+//# sourceMappingURL=index.js.map

package/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../mnt/c/repotemp/sharpee/packages/world-model/src/interfaces/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,2CAAyB;AACzB,sDAAoC;AACpC,qDAAmC;AACnC,sDAAoC"}

package/interfaces/language-provider.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Language provider interface for Interactive Fiction
+ *
+ * This interface defines the contract for providing localized text,
+ * action patterns, and message formatting throughout the IF system.
+ *
+ * Implementations should handle:
+ * - Action patterns (verb synonyms)
+ * - Message text with parameter substitution
+ * - Localization and customization
+ */
+/**
+ * Language provider interface
+ */
+export interface ILanguageProvider {
+    /**
+     * The language code this provider supports (e.g., 'en-us', 'es-es')
+     */
+    readonly languageCode: string;
+    /**
+     * Get patterns/aliases for an action
+     * @param actionId The action identifier (e.g., 'if.action.taking')
+     * @returns Array of patterns or undefined if action not found
+     */
+    getActionPatterns(actionId: string): string[] | undefined;
+    /**
+     * Get a message by ID with optional parameter substitution
+     * @param messageId The message identifier
+     * @param params Optional parameters for substitution
+     * @returns The formatted message
+     */
+    getMessage(messageId: string, params?: Record<string, any>): string;
+    /**
+     * Check if a message exists
+     * @param messageId The message identifier
+     * @returns True if the message exists
+     */
+    hasMessage(messageId: string): boolean;
+    /**
+     * Get help text for an action
+     * @param actionId The action identifier
+     * @returns Help text or undefined if not found
+     */
+    getActionHelp?(actionId: string): {
+        description: string;
+        examples: string;
+    } | undefined;
+    /**
+     * Get all supported actions
+     * @returns Array of action IDs
+     */
+    getSupportedActions?(): string[];
+}
+/**
+ * Language provider registry interface
+ */
+export interface ILanguageProviderRegistry {
+    /**
+     * Register a language provider
+     * @param provider The language provider to register
+     */
+    register(provider: ILanguageProvider): void;
+    /**
+     * Get a language provider by code
+     * @param languageCode The language code (e.g., 'en-us')
+     * @returns The provider or undefined if not found
+     */
+    get(languageCode: string): ILanguageProvider | undefined;
+    /**
+     * Get the default language provider
+     * @returns The default provider
+     * @throws Error if no default provider is set
+     */
+    getDefault(): ILanguageProvider;
+    /**
+     * Set the default language provider
+     * @param languageCode The language code to set as default
+     */
+    setDefault(languageCode: string): void;
+    /**
+     * Get all registered language codes
+     * @returns Array of language codes
+     */
+    getAvailableLanguages(): string[];
+}
+//# sourceMappingURL=language-provider.d.ts.map

package/interfaces/language-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-provider.d.ts","sourceRoot":"","sources":["../../../../../../mnt/c/repotemp/sharpee/packages/world-model/src/interfaces/language-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IAE1D;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC;IAEpE;;;;OAIG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAEvC;;;;OAIG;IACH,aAAa,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;IAExF;;;OAGG;IACH,mBAAmB,CAAC,IAAI,MAAM,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAE5C;;;;OAIG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAEzD;;;;OAIG;IACH,UAAU,IAAI,iBAAiB,CAAC;IAEhC;;;OAGG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvC;;;OAGG;IACH,qBAAqB,IAAI,MAAM,EAAE,CAAC;CACnC"}

package/interfaces/language-provider.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Language provider interface for Interactive Fiction
+ *
+ * This interface defines the contract for providing localized text,
+ * action patterns, and message formatting throughout the IF system.
+ *
+ * Implementations should handle:
+ * - Action patterns (verb synonyms)
+ * - Message text with parameter substitution
+ * - Localization and customization
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=language-provider.js.map

package/interfaces/language-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-provider.js","sourceRoot":"","sources":["../../../../../../../../../mnt/c/repotemp/sharpee/packages/world-model/src/interfaces/language-provider.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG"}

package/interfaces/parser.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Parser interface for converting text input to parsed commands
+ */
+import type { IParsedCommand, IParseError, CommandResult } from '../commands';
+/**
+ * Parser interface - pure syntax, no world knowledge
+ */
+export interface IParser {
+    /**
+     * Parse input text into structured command
+     * @param input Raw text input
+     * @returns Parsed command or parse error
+     */
+    parse(input: string): CommandResult<IParsedCommand, IParseError>;
+}
+//# sourceMappingURL=parser.d.ts.map

package/interfaces/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../../../mnt/c/repotemp/sharpee/packages/world-model/src/interfaces/parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;CAClE"}

package/interfaces/parser.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Parser interface for converting text input to parsed commands
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=parser.js.map

package/interfaces/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../../../../../../../mnt/c/repotemp/sharpee/packages/world-model/src/interfaces/parser.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/package.json

@@ -1,9 +1,8 @@
 {
   "name": "@sharpee/world-model",
-  "version": "0.9.66-beta",
+  "version": "0.9.67-beta",
   "description": "World model for Sharpee IF platform - entities, traits, and behaviors",
   "main": "./index.js",
-  "module": "dist-npm/index.js",
   "types": "./index.d.ts",
   "exports": {
     ".": {
@@ -12,20 +11,6 @@
       "default": "./index.js"
     }
   },
-  "scripts": {
-    "build": "tsc",
-    "clean": "rimraf dist",
-    "test": "vitest",
-    "test:ci": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "test:verbose": "vitest run --reporter=verbose",
-    "lint": "eslint src --ext .ts",
-    "build:npm": "tsc --outDir dist-npm"
-  },
-  "files": [
-    "dist-npm"
-  ],
   "keywords": [
     "interactive-fiction",
     "if",

package/scope/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @file Scope System Exports
+ * @description Exports for the scope management system
+ */
+export * from './scope-rule';
+export * from './scope-registry';
+export * from './scope-evaluator';
+//# sourceMappingURL=index.d.ts.map

package/scope/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../mnt/c/repotemp/sharpee/packages/world-model/src/scope/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/scope/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * @file Scope System Exports
+ * @description Exports for the scope management system
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./scope-rule"), exports);
+__exportStar(require("./scope-registry"), exports);
+__exportStar(require("./scope-evaluator"), exports);
+//# sourceMappingURL=index.js.map

package/scope/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../../../mnt/c/repotemp/sharpee/packages/world-model/src/scope/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAEH,+CAA6B;AAC7B,mDAAiC;AACjC,oDAAkC"}

package/scope/scope-evaluator.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @file Scope Evaluator
+ * @description Evaluates scope rules to determine visible entities
+ */
+import { IScopeRule, IScopeContext, IScopeEvaluationOptions, IScopeEvaluationResult } from './scope-rule';
+import { ScopeRegistry } from './scope-registry';
+/**
+ * Evaluates scope rules to determine what entities are in scope
+ */
+export declare class ScopeEvaluator {
+    private registry;
+    private cache;
+    constructor(registry: ScopeRegistry);
+    /**
+     * Evaluate scope for a given context
+     */
+    evaluate(context: IScopeContext, options?: IScopeEvaluationOptions): IScopeEvaluationResult;
+    /**
+     * Evaluate a single rule
+     */
+    private evaluateRule;
+    /**
+     * Get entities in a location
+     */
+    private getEntitiesInLocation;
+    /**
+     * Generate cache key for a context
+     */
+    private getCacheKey;
+    /**
+     * Clear the cache
+     */
+    clearCache(): void;
+    /**
+     * Get standard scope (visible entities) for backward compatibility
+     */
+    getVisibleEntities(context: IScopeContext): string[];
+    /**
+     * Get touchable entities for backward compatibility
+     */
+    getTouchableEntities(context: IScopeContext): string[];
+    /**
+     * Check if a specific entity is in scope
+     */
+    isEntityInScope(entityId: string, context: IScopeContext): boolean;
+    /**
+     * Get scope with detailed rule information
+     */
+    getScopeWithDetails(context: IScopeContext): {
+        entities: string[];
+        ruleDetails: Map<string, {
+            rule: IScopeRule;
+            entities: string[];
+            message?: string;
+        }>;
+    };
+}
+//# sourceMappingURL=scope-evaluator.d.ts.map

package/scope/scope-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-evaluator.d.ts","sourceRoot":"","sources":["../../../../../../mnt/c/repotemp/sharpee/packages/world-model/src/scope/scope-evaluator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,UAAU,EACV,aAAa,EACb,uBAAuB,EACvB,sBAAsB,EAEvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAgB;IAChC,OAAO,CAAC,KAAK,CAAkD;gBAEnD,QAAQ,EAAE,aAAa;IAInC;;OAEG;IACH,QAAQ,CACN,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,uBAA4B,GACpC,sBAAsB;IAoEzB;;OAEG;IACH,OAAO,CAAC,YAAY;IAqDpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;OAEG;IACH,OAAO,CAAC,WAAW;IAInB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,EAAE;IAWpD;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,EAAE;IAMtD;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO;IAKlE;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG;QAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE;YACvB,IAAI,EAAE,UAAU,CAAC;YACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,OAAO,CAAC,EAAE,MAAM,CAAC;SAClB,CAAC,CAAC;KACJ;CAiBF"}

package/scope/scope-evaluator.js

@@ -0,0 +1,207 @@
+"use strict";
+/**
+ * @file Scope Evaluator
+ * @description Evaluates scope rules to determine visible entities
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScopeEvaluator = void 0;
+/**
+ * Evaluates scope rules to determine what entities are in scope
+ */
+class ScopeEvaluator {
+    registry;
+    cache = new Map();
+    constructor(registry) {
+        this.registry = registry;
+    }
+    /**
+     * Evaluate scope for a given context
+     */
+    evaluate(context, options = {}) {
+        const startTime = Date.now();
+        // Check cache if enabled
+        const cacheKey = this.getCacheKey(context);
+        if (options.cache && this.cache.has(cacheKey)) {
+            const cached = this.cache.get(cacheKey);
+            if (cached.metrics) {
+                cached.metrics.cacheHits = (cached.metrics.cacheHits || 0) + 1;
+            }
+            return cached;
+        }
+        // Get applicable rules
+        let rules = this.registry.getApplicableRules(context);
+        // Apply custom filter if provided
+        if (options.ruleFilter) {
+            rules = rules.filter(options.ruleFilter);
+        }
+        // Limit rules if specified
+        if (options.maxRules && rules.length > options.maxRules) {
+            rules = rules.slice(0, options.maxRules);
+        }
+        // Evaluate rules
+        const entityIds = new Set();
+        const appliedRules = [];
+        const skippedRules = [];
+        for (const rule of rules) {
+            const result = this.evaluateRule(rule, context);
+            if (result.conditionMet) {
+                // Add entities to scope
+                for (const entityId of result.includedEntities) {
+                    entityIds.add(entityId);
+                }
+                appliedRules.push(result);
+            }
+            else if (options.debug) {
+                skippedRules.push(rule);
+            }
+        }
+        // Build result
+        const result = {
+            entityIds,
+            appliedRules,
+            metrics: {
+                rulesEvaluated: rules.length,
+                totalTime: Date.now() - startTime,
+                cacheHits: 0
+            }
+        };
+        if (options.debug) {
+            result.skippedRules = skippedRules;
+        }
+        // Cache if enabled
+        if (options.cache) {
+            this.cache.set(cacheKey, result);
+        }
+        return result;
+    }
+    /**
+     * Evaluate a single rule
+     */
+    evaluateRule(rule, context) {
+        // Check condition
+        const conditionMet = !rule.condition || rule.condition(context);
+        if (!conditionMet) {
+            return {
+                rule,
+                includedEntities: [],
+                conditionMet: false
+            };
+        }
+        // Get entities to include
+        let includedEntities = [];
+        // Include explicit entities
+        if (rule.includeEntities) {
+            if (typeof rule.includeEntities === 'function') {
+                includedEntities = rule.includeEntities(context);
+            }
+            else {
+                includedEntities = [...rule.includeEntities];
+            }
+        }
+        // Include entities from specified locations
+        if (rule.includeLocations && context.world) {
+            for (const locationId of rule.includeLocations) {
+                const locationEntities = this.getEntitiesInLocation(context.world, locationId);
+                includedEntities.push(...locationEntities);
+            }
+        }
+        // Generate message if applicable
+        let message;
+        if (rule.message) {
+            if (typeof rule.message === 'function') {
+                message = rule.message(includedEntities[0] || '', context.actionId || '');
+            }
+            else {
+                message = rule.message;
+            }
+        }
+        return {
+            rule,
+            includedEntities,
+            conditionMet: true,
+            message
+        };
+    }
+    /**
+     * Get entities in a location
+     */
+    getEntitiesInLocation(world, locationId) {
+        const entities = [];
+        // Add the location itself
+        if (world.getEntity(locationId)) {
+            entities.push(locationId);
+        }
+        // Add contents of the location
+        if (world.getContents) {
+            const contents = world.getContents(locationId) || [];
+            entities.push(...contents.map((e) => e.id));
+            // Add nested contents
+            for (const entity of contents) {
+                if (world.getAllContents) {
+                    const nested = world.getAllContents(entity.id) || [];
+                    entities.push(...nested.map((e) => e.id));
+                }
+            }
+        }
+        return entities;
+    }
+    /**
+     * Generate cache key for a context
+     */
+    getCacheKey(context) {
+        return `${context.actorId}:${context.currentLocation}:${context.actionId || 'any'}`;
+    }
+    /**
+     * Clear the cache
+     */
+    clearCache() {
+        this.cache.clear();
+    }
+    /**
+     * Get standard scope (visible entities) for backward compatibility
+     */
+    getVisibleEntities(context) {
+        // Evaluate with looking/examining action
+        const evalContext = {
+            ...context,
+            actionId: context.actionId || 'examining'
+        };
+        const result = this.evaluate(evalContext);
+        return Array.from(result.entityIds);
+    }
+    /**
+     * Get touchable entities for backward compatibility
+     */
+    getTouchableEntities(context) {
+        // For now, touchable = visible
+        // Can be extended with distance-based rules later
+        return this.getVisibleEntities(context);
+    }
+    /**
+     * Check if a specific entity is in scope
+     */
+    isEntityInScope(entityId, context) {
+        const result = this.evaluate(context);
+        return result.entityIds.has(entityId);
+    }
+    /**
+     * Get scope with detailed rule information
+     */
+    getScopeWithDetails(context) {
+        const result = this.evaluate(context, { debug: true });
+        const ruleDetails = new Map();
+        for (const appliedRule of result.appliedRules) {
+            ruleDetails.set(appliedRule.rule.id, {
+                rule: appliedRule.rule,
+                entities: appliedRule.includedEntities,
+                message: appliedRule.message
+            });
+        }
+        return {
+            entities: Array.from(result.entityIds),
+            ruleDetails
+        };
+    }
+}
+exports.ScopeEvaluator = ScopeEvaluator;
+//# sourceMappingURL=scope-evaluator.js.map

package/scope/scope-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-evaluator.js","sourceRoot":"","sources":["../../../../../../../../../mnt/c/repotemp/sharpee/packages/world-model/src/scope/scope-evaluator.ts"],"names":[],"mappings":"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"}

package/scope/scope-registry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @file Scope Registry
+ * @description Manages scope rules and provides registration/lookup
+ */
+import { IScopeRule, IScopeContext } from './scope-rule';
+/**
+ * Registry for managing scope rules
+ */
+export declare class ScopeRegistry {
+    private rules;
+    private rulesByLocation;
+    private rulesByAction;
+    private globalRules;
+    /**
+     * Add a scope rule to the registry
+     */
+    addRule(rule: IScopeRule): void;
+    /**
+     * Remove a scope rule
+     */
+    removeRule(ruleId: string): boolean;
+    /**
+     * Get a rule by ID
+     */
+    getRule(ruleId: string): IScopeRule | undefined;
+    /**
+     * Get all rules
+     */
+    getAllRules(): IScopeRule[];
+    /**
+     * Get rules applicable to a context
+     */
+    getApplicableRules(context: IScopeContext): IScopeRule[];
+    /**
+     * Enable or disable a rule
+     */
+    setRuleEnabled(ruleId: string, enabled: boolean): boolean;
+    /**
+     * Clear all rules
+     */
+    clear(): void;
+    /**
+     * Get rules by source
+     */
+    getRulesBySource(source: string): IScopeRule[];
+    /**
+     * Get statistics about registered rules
+     */
+    getStats(): {
+        totalRules: number;
+        enabledRules: number;
+        disabledRules: number;
+        globalRules: number;
+        locationSpecificRules: number;
+        actionSpecificRules: number;
+        rulesBySource: Map<string, number>;
+    };
+}
+//# sourceMappingURL=scope-registry.d.ts.map

package/scope/scope-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-registry.d.ts","sourceRoot":"","sources":["../../../../../../mnt/c/repotemp/sharpee/packages/world-model/src/scope/scope-registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,UAAU,EACV,aAAa,EAId,MAAM,cAAc,CAAC;AAEtB;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,eAAe,CAAuC;IAC9D,OAAO,CAAC,aAAa,CAAuC;IAC5D,OAAO,CAAC,WAAW,CAA0B;IAE7C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAqC/B;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IA0BnC;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI/C;;OAEG;IACH,WAAW,IAAI,UAAU,EAAE;IAI3B;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,aAAa,GAAG,UAAU,EAAE;IAoCxD;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO;IAQzD;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE;IAK9C;;OAEG;IACH,QAAQ,IAAI;QACV,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACpC;CAgCF"}