@sharpee/ext-testing 0.9.61-beta

package/dist-npm/extension.js

@@ -0,0 +1,938 @@
+"use strict";
+/**
+ * Testing Extension
+ *
+ * Main extension class that provides debug and testing capabilities.
+ * Implements the ITestingExtension interface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestingExtension = void 0;
+const debug_context_js_1 = require("./context/debug-context.js");
+const registry_js_1 = require("./commands/registry.js");
+const store_js_1 = require("./checkpoints/store.js");
+const serializer_js_1 = require("./checkpoints/serializer.js");
+const index_js_1 = require("./annotations/index.js");
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    debugMode: {
+        enabled: true,
+        prefix: 'gdt',
+        password: null,
+    },
+    testMode: {
+        enabled: true,
+        deterministicRandom: true,
+        assertions: true,
+    },
+    checkpoints: {
+        directory: './checkpoints',
+    },
+    commands: [],
+};
+/**
+ * Testing Extension implementation
+ */
+class TestingExtension {
+    config;
+    commands;
+    checkpoints;
+    annotations;
+    isDebugModeActive = false;
+    // Context tracking for annotations
+    lastCommand = '';
+    lastResponse = '';
+    constructor(config = {}) {
+        // Merge config with defaults
+        this.config = {
+            debugMode: { ...DEFAULT_CONFIG.debugMode, ...config.debugMode },
+            testMode: { ...DEFAULT_CONFIG.testMode, ...config.testMode },
+            checkpoints: { ...DEFAULT_CONFIG.checkpoints, ...config.checkpoints },
+            commands: config.commands ?? [],
+        };
+        // Initialize command registry
+        this.commands = (0, registry_js_1.createCommandRegistry)();
+        // Register built-in commands
+        this.registerBuiltInCommands();
+        // Register custom commands
+        for (const command of this.config.commands ?? []) {
+            this.commands.register(command);
+        }
+        // Initialize checkpoint store
+        // Use memory store by default; file store requires explicit path
+        if (this.config.checkpoints?.directory) {
+            this.checkpoints = (0, store_js_1.createFileStore)(this.config.checkpoints.directory);
+        }
+        else {
+            this.checkpoints = (0, store_js_1.createMemoryStore)();
+        }
+        // Initialize annotation store
+        this.annotations = (0, index_js_1.createAnnotationStore)();
+    }
+    /**
+     * Register built-in debug commands
+     */
+    registerBuiltInCommands() {
+        // Help command
+        this.commands.register({
+            code: 'HE',
+            testSyntax: 'help',
+            name: 'Help',
+            description: 'Display available commands',
+            category: 'utility',
+            execute: (context, args) => this.cmdHelp(context, args),
+        });
+        // Teleport command
+        this.commands.register({
+            code: 'AH',
+            testSyntax: 'teleport',
+            name: 'Teleport',
+            description: 'Teleport player to a room',
+            category: 'alter',
+            usage: 'teleport <room-id>',
+            execute: (context, args) => this.cmdTeleport(context, args),
+        });
+        // Take command
+        this.commands.register({
+            code: 'TK',
+            testSyntax: 'take',
+            name: 'Take Item',
+            description: 'Give an item to the player',
+            category: 'alter',
+            usage: 'take <item-id>',
+            execute: (context, args) => this.cmdTake(context, args),
+        });
+        // Move command
+        this.commands.register({
+            code: 'AO',
+            testSyntax: 'move',
+            name: 'Move Object',
+            description: 'Move an object to a location',
+            category: 'alter',
+            usage: 'move <object-id> <location-id>',
+            execute: (context, args) => this.cmdMove(context, args),
+        });
+        // Remove command
+        this.commands.register({
+            code: 'RO',
+            testSyntax: 'remove',
+            name: 'Remove Object',
+            description: 'Remove an object from the game',
+            category: 'alter',
+            usage: 'remove <object-id>',
+            execute: (context, args) => this.cmdRemove(context, args),
+        });
+        // Display Player command
+        this.commands.register({
+            code: 'DA',
+            testSyntax: 'player',
+            name: 'Display Adventurer',
+            description: 'Show player state and inventory',
+            category: 'display',
+            execute: (context, args) => this.cmdDisplayPlayer(context, args),
+        });
+        // Display Room command
+        this.commands.register({
+            code: 'DR',
+            testSyntax: 'room',
+            name: 'Display Room',
+            description: 'Show current room details',
+            category: 'display',
+            execute: (context, args) => this.cmdDisplayRoom(context, args),
+        });
+        // Display Object command
+        this.commands.register({
+            code: 'DO',
+            testSyntax: 'object',
+            name: 'Display Object',
+            description: 'Show object details',
+            category: 'display',
+            usage: 'object <object-id>',
+            execute: (context, args) => this.cmdDisplayObject(context, args),
+        });
+        // Saves list command
+        this.commands.register({
+            code: 'SL',
+            testSyntax: 'saves',
+            name: 'List Saves',
+            description: 'List available checkpoints',
+            category: 'utility',
+            execute: (context, args) => this.cmdListSaves(context, args),
+        });
+        // Describe Entity command (detailed)
+        this.commands.register({
+            code: 'DE',
+            testSyntax: 'describe',
+            name: 'Describe Entity',
+            description: 'Full entity inspection with all traits',
+            category: 'display',
+            usage: 'describe <entity-id>',
+            execute: (context, args) => this.cmdDescribeEntity(context, args),
+        });
+        // Display State command
+        this.commands.register({
+            code: 'DS',
+            testSyntax: 'state',
+            name: 'Display State',
+            description: 'Show game state (turn, score, entity counts)',
+            category: 'display',
+            execute: (context, args) => this.cmdDisplayState(context, args),
+        });
+        // Display Exits command
+        this.commands.register({
+            code: 'DX',
+            testSyntax: 'exits',
+            name: 'Display Exits',
+            description: 'Show room exits in detail',
+            category: 'display',
+            usage: 'exits [room-id]',
+            execute: (context, args) => this.cmdDisplayExits(context, args),
+        });
+        // No Deaths (immortality on)
+        this.commands.register({
+            code: 'ND',
+            testSyntax: 'immortal',
+            name: 'No Deaths',
+            description: 'Enable immortality mode',
+            category: 'toggle',
+            execute: (context, args) => this.cmdNoDeaths(context, args),
+        });
+        // Restore Deaths (immortality off)
+        this.commands.register({
+            code: 'RD',
+            testSyntax: 'mortal',
+            name: 'Restore Deaths',
+            description: 'Disable immortality mode',
+            category: 'toggle',
+            execute: (context, args) => this.cmdRestoreDeaths(context, args),
+        });
+        // Kill Entity
+        this.commands.register({
+            code: 'KL',
+            testSyntax: 'kill',
+            name: 'Kill Entity',
+            description: 'Kill an NPC or entity',
+            category: 'alter',
+            usage: 'kill <entity-id>',
+            execute: (context, args) => this.cmdKillEntity(context, args),
+        });
+        // Exit GDT
+        this.commands.register({
+            code: 'EX',
+            testSyntax: 'exit',
+            name: 'Exit',
+            description: 'Exit debug mode',
+            category: 'utility',
+            execute: (context, args) => this.cmdExit(context, args),
+        });
+        // =========================================================================
+        // Annotation Commands (ADR-109)
+        // =========================================================================
+        // Bug annotation
+        this.commands.register({
+            code: 'BG',
+            testSyntax: 'bug',
+            name: 'Bug',
+            description: 'Flag a bug',
+            category: 'annotation',
+            usage: 'bug <description>',
+            execute: (context, args) => this.cmdBug(context, args),
+        });
+        // Note annotation
+        this.commands.register({
+            code: 'NT',
+            testSyntax: 'note',
+            name: 'Note',
+            description: 'Add a general note',
+            category: 'annotation',
+            usage: 'note <text>',
+            execute: (context, args) => this.cmdNote(context, args),
+        });
+        // Confusing annotation
+        this.commands.register({
+            code: 'CF',
+            testSyntax: 'confusing',
+            name: 'Confusing',
+            description: 'Mark last interaction as confusing',
+            category: 'annotation',
+            execute: (context, args) => this.cmdConfusing(context, args),
+        });
+        // Expected behavior annotation
+        this.commands.register({
+            code: 'EP',
+            testSyntax: 'expected',
+            name: 'Expected',
+            description: 'Document expected behavior',
+            category: 'annotation',
+            usage: 'expected <what was expected>',
+            execute: (context, args) => this.cmdExpected(context, args),
+        });
+        // Bookmark annotation
+        this.commands.register({
+            code: 'BM',
+            testSyntax: 'bookmark',
+            name: 'Bookmark',
+            description: 'Create a named save point',
+            category: 'annotation',
+            usage: 'bookmark <name>',
+            execute: (context, args) => this.cmdBookmark(context, args),
+        });
+        // Session management
+        this.commands.register({
+            code: 'SS',
+            testSyntax: 'session',
+            name: 'Session',
+            description: 'Start or end annotation session',
+            category: 'annotation',
+            usage: 'session start <name> | session end',
+            execute: (context, args) => this.cmdSession(context, args),
+        });
+        // Review annotations
+        this.commands.register({
+            code: 'RV',
+            testSyntax: 'review',
+            name: 'Review',
+            description: 'Show current session annotations',
+            category: 'annotation',
+            execute: (context, args) => this.cmdReview(context, args),
+        });
+        // Export annotations
+        this.commands.register({
+            code: 'XP',
+            testSyntax: 'export',
+            name: 'Export',
+            description: 'Export annotations as markdown',
+            category: 'annotation',
+            execute: (context, args) => this.cmdExport(context, args),
+        });
+    }
+    // =========================================================================
+    // Public API
+    // =========================================================================
+    /**
+     * Execute a GDT-style command
+     */
+    executeGdtCommand(input, world) {
+        if (!this.config.debugMode?.enabled) {
+            return { success: false, output: [], error: 'Debug mode is disabled' };
+        }
+        const { code, args } = (0, registry_js_1.parseGdtInput)(input);
+        if (!code) {
+            return { success: false, output: [], error: 'No command specified' };
+        }
+        const command = this.commands.getByCode(code);
+        if (!command) {
+            return { success: false, output: [], error: `Unknown command: ${code}` };
+        }
+        const context = this.createContext(world);
+        return command.execute(context, args);
+    }
+    /**
+     * Execute a test command ($command syntax)
+     */
+    executeTestCommand(input, world) {
+        if (!this.config.testMode?.enabled) {
+            return { success: false, output: [], error: 'Test mode is disabled' };
+        }
+        const parsed = (0, registry_js_1.parseTestInput)(input);
+        if (!parsed) {
+            return { success: false, output: [], error: 'Invalid test command format' };
+        }
+        const { syntax, args } = parsed;
+        const command = this.commands.getByTestSyntax(syntax);
+        if (!command) {
+            return { success: false, output: [], error: `Unknown test command: $${syntax}` };
+        }
+        const context = this.createContext(world);
+        return command.execute(context, args);
+    }
+    /**
+     * Create a debug context for the world
+     */
+    createContext(world) {
+        return (0, debug_context_js_1.createDebugContext)(world);
+    }
+    /**
+     * Save a checkpoint
+     */
+    async saveCheckpoint(name, world) {
+        const data = (0, serializer_js_1.serializeCheckpoint)(world, name);
+        await this.checkpoints.save(name, data);
+    }
+    /**
+     * Restore from a checkpoint
+     */
+    async restoreCheckpoint(name, world) {
+        const data = await this.checkpoints.load(name);
+        if (!data) {
+            return false;
+        }
+        (0, serializer_js_1.deserializeCheckpoint)(data, world);
+        return true;
+    }
+    /**
+     * Set context for annotation commands (called by transcript-tester after each command)
+     */
+    setCommandContext(command, response) {
+        this.lastCommand = command;
+        this.lastResponse = response;
+    }
+    /**
+     * Add an annotation directly (for # comments from transcript-tester)
+     */
+    addAnnotation(type, text, world) {
+        const context = (0, index_js_1.captureContext)(world, this.lastCommand, this.lastResponse);
+        return this.annotations.addAnnotation(type, text, context);
+    }
+    // =========================================================================
+    // Built-in Command Implementations
+    // =========================================================================
+    cmdHelp(_context, _args) {
+        const output = ['Available Commands:', ''];
+        const categories = ['display', 'alter', 'toggle', 'utility', 'test'];
+        for (const category of categories) {
+            const commands = this.commands.getByCategory(category);
+            if (commands.length === 0)
+                continue;
+            output.push(`${category.toUpperCase()}:`);
+            for (const cmd of commands) {
+                const testSyntax = cmd.testSyntax ? `$${cmd.testSyntax}` : '';
+                output.push(`  ${cmd.code.padEnd(4)} ${testSyntax.padEnd(12)} - ${cmd.description}`);
+            }
+            output.push('');
+        }
+        return { success: true, output };
+    }
+    cmdTeleport(context, args) {
+        if (args.length === 0) {
+            return { success: false, output: [], error: 'Usage: teleport <room-name>' };
+        }
+        // Join args to support multi-word room names like "Reservoir North"
+        const roomId = args.join(' ');
+        const room = context.findRoom(roomId);
+        if (!room) {
+            return { success: false, output: [], error: `Room not found: ${roomId}` };
+        }
+        const success = context.teleportPlayer(room.id);
+        if (success) {
+            return {
+                success: true,
+                output: [`Teleported to: ${room.name || room.id}`],
+            };
+        }
+        else {
+            return { success: false, output: [], error: 'Failed to teleport' };
+        }
+    }
+    cmdTake(context, args) {
+        if (args.length === 0) {
+            return { success: false, output: [], error: 'Usage: take <item-name>' };
+        }
+        // Join args to support multi-word names like "brass lantern"
+        const itemId = args.join(' ');
+        const item = context.findEntity(itemId);
+        if (!item) {
+            return { success: false, output: [], error: `Item not found: ${itemId}` };
+        }
+        const success = context.takeObject(item.id);
+        if (success) {
+            return {
+                success: true,
+                output: [`Took: ${item.name || item.id}`],
+            };
+        }
+        else {
+            return { success: false, output: [], error: 'Failed to take item' };
+        }
+    }
+    cmdMove(context, args) {
+        if (args.length < 2) {
+            return { success: false, output: [], error: 'Usage: move <object-id> <location-id>' };
+        }
+        const [objectId, locationId] = args;
+        const object = context.findEntity(objectId);
+        const location = context.findEntity(locationId);
+        if (!object) {
+            return { success: false, output: [], error: `Object not found: ${objectId}` };
+        }
+        if (!location) {
+            return { success: false, output: [], error: `Location not found: ${locationId}` };
+        }
+        const success = context.moveObject(object.id, location.id);
+        if (success) {
+            return {
+                success: true,
+                output: [`Moved ${object.name || object.id} to ${location.name || location.id}`],
+            };
+        }
+        else {
+            return { success: false, output: [], error: 'Failed to move object' };
+        }
+    }
+    cmdRemove(context, args) {
+        if (args.length === 0) {
+            return { success: false, output: [], error: 'Usage: remove <object-name>' };
+        }
+        // Join args to support multi-word names
+        const objectId = args.join(' ');
+        const object = context.findEntity(objectId);
+        if (!object) {
+            return { success: false, output: [], error: `Object not found: ${objectId}` };
+        }
+        const success = context.removeObject(object.id);
+        if (success) {
+            return {
+                success: true,
+                output: [`Removed: ${object.name || object.id}`],
+            };
+        }
+        else {
+            return { success: false, output: [], error: 'Failed to remove object' };
+        }
+    }
+    cmdDisplayPlayer(context, _args) {
+        const player = context.player;
+        const location = context.getPlayerLocation();
+        const inventory = context.getInventory();
+        const output = [
+            'PLAYER STATUS',
+            `  ID: ${player.id}`,
+            `  Location: ${location?.name || location?.id || 'unknown'}`,
+            `  Inventory (${inventory.length} items):`,
+        ];
+        for (const item of inventory) {
+            output.push(`    - ${item.name || item.id}`);
+        }
+        return { success: true, output };
+    }
+    cmdDisplayRoom(context, _args) {
+        const room = context.getPlayerLocation();
+        if (!room) {
+            return { success: false, output: [], error: 'Player location unknown' };
+        }
+        const contents = context.getContents(room.id);
+        const objects = contents.filter((e) => e.id !== context.player.id);
+        const output = [
+            'ROOM STATUS',
+            `  ID: ${room.id}`,
+            `  Name: ${room.name || 'unnamed'}`,
+            `  Contents (${objects.length} objects):`,
+        ];
+        for (const obj of objects) {
+            output.push(`    - ${obj.name || obj.id}`);
+        }
+        // TODO: Show exits when that API is available
+        return { success: true, output };
+    }
+    cmdDisplayObject(context, args) {
+        if (args.length === 0) {
+            return { success: false, output: [], error: 'Usage: object <object-name>' };
+        }
+        // Join args to support multi-word names
+        const objectId = args.join(' ');
+        const object = context.findEntity(objectId);
+        if (!object) {
+            return { success: false, output: [], error: `Object not found: ${objectId}` };
+        }
+        const locationId = context.world.getLocation(object.id);
+        const location = locationId ? context.world.getEntity(locationId) : undefined;
+        const output = [
+            'OBJECT STATUS',
+            `  ID: ${object.id}`,
+            `  Name: ${object.name || 'unnamed'}`,
+            `  Type: ${object.type}`,
+            `  Location: ${location?.name || location?.id || 'none'}`,
+            `  Traits:`,
+        ];
+        if (object.traits) {
+            for (const [, trait] of object.traits) {
+                output.push(`    - ${trait.type}`);
+            }
+        }
+        return { success: true, output };
+    }
+    cmdListSaves(_context, _args) {
+        // Note: This is a synchronous stub. Full checkpoint listing
+        // requires async access - use $saves from transcript-tester instead.
+        return {
+            success: true,
+            output: ['Use $saves in transcript tests to list checkpoints.'],
+        };
+    }
+    cmdDescribeEntity(context, args) {
+        if (args.length === 0) {
+            return { success: false, output: [], error: 'Usage: describe <entity-id>' };
+        }
+        const entity = context.findEntity(args.join(' '));
+        if (!entity) {
+            return { success: false, output: [], error: `Entity not found: ${args.join(' ')}` };
+        }
+        const output = [];
+        // Header
+        output.push('╔══════════════════════════════════════════════════════════════╗');
+        output.push(`║ ENTITY: ${entity.id.substring(0, 53).padEnd(53)} ║`);
+        output.push('╚══════════════════════════════════════════════════════════════╝');
+        output.push('');
+        // Basic Info
+        output.push('┌─ BASIC INFO ─────────────────────────────────────────────────┐');
+        output.push(`│ ID:   ${entity.id}`);
+        output.push(`│ Type: ${entity.type}`);
+        output.push(`│ Name: ${entity.name ?? '<unnamed>'}`);
+        output.push('└──────────────────────────────────────────────────────────────┘');
+        output.push('');
+        // Location
+        output.push('┌─ LOCATION ────────────────────────────────────────────────────┐');
+        const locationId = context.world.getLocation(entity.id);
+        if (locationId) {
+            const locationEntity = context.findEntity(locationId);
+            output.push(`│ In: ${locationEntity?.name ?? locationId} (${locationId})`);
+        }
+        else {
+            output.push('│ In: <nowhere>');
+        }
+        output.push('└──────────────────────────────────────────────────────────────┘');
+        output.push('');
+        // All Traits
+        output.push('┌─ TRAITS ──────────────────────────────────────────────────────┐');
+        if (!entity.traits || entity.traits.size === 0) {
+            output.push('│ <none>');
+        }
+        else {
+            for (const [traitType, trait] of entity.traits) {
+                output.push(`│`);
+                output.push(`│ ▸ ${traitType}`);
+                // Show trait properties
+                const props = Object.entries(trait).filter(([key]) => key !== 'type' && !key.startsWith('_'));
+                for (const [key, value] of props) {
+                    output.push(`│   ${key}: ${formatValue(value)}`);
+                }
+            }
+        }
+        output.push('└──────────────────────────────────────────────────────────────┘');
+        output.push('');
+        // Contents (if applicable)
+        const contents = context.getContents(entity.id);
+        if (contents.length > 0) {
+            output.push('┌─ CONTENTS ─────────────────────────────────────────────────────┐');
+            for (const item of contents) {
+                output.push(`│ • ${item.name ?? item.id} (${item.id})`);
+            }
+            output.push('└──────────────────────────────────────────────────────────────┘');
+        }
+        return { success: true, output };
+    }
+    cmdDisplayState(context, _args) {
+        const { world } = context;
+        const output = [];
+        output.push('=== GAME STATE ===');
+        output.push('');
+        // Core stats
+        const moves = world.getStateValue('moves') ?? 0;
+        const turnCount = world.getStateValue('turnCount') ?? moves;
+        const score = world.getStateValue('score') ?? 0;
+        const maxScore = world.getStateValue('maxScore') ?? 0;
+        output.push(`Turn: ${turnCount}`);
+        output.push(`Moves: ${moves}`);
+        output.push(`Score: ${score}/${maxScore}`);
+        // Game phase
+        const gamePhase = world.getStateValue('gamePhase') ?? 'playing';
+        const gameOver = world.getStateValue('gameOver') ?? false;
+        output.push('');
+        output.push(`Phase: ${gamePhase}`);
+        output.push(`Game Over: ${gameOver ? 'YES' : 'no'}`);
+        // Entity counts
+        output.push('');
+        output.push('Entity Counts:');
+        const allEntities = world.getAllEntities();
+        const rooms = allEntities.filter((e) => e.type === 'room');
+        const objects = allEntities.filter((e) => e.type !== 'room' && e.type !== 'player');
+        output.push(`  Rooms: ${rooms.length}`);
+        output.push(`  Objects: ${objects.length}`);
+        output.push(`  Total: ${allEntities.length}`);
+        // Debug flags
+        output.push('');
+        output.push('Debug Flags:');
+        output.push(`  Immortal: ${context.getFlag('immortal') ? 'YES' : 'no'}`);
+        return { success: true, output };
+    }
+    cmdDisplayExits(context, args) {
+        // Find the room to display
+        let room;
+        if (args.length > 0) {
+            room = context.findRoom(args[0]);
+            if (!room) {
+                return { success: false, output: [], error: `Room not found: ${args[0]}` };
+            }
+        }
+        else {
+            room = context.getPlayerLocation();
+            if (!room) {
+                return { success: false, output: [], error: 'Player has no location' };
+            }
+        }
+        const output = [];
+        output.push('=== EXITS ===');
+        output.push('');
+        output.push(`Room: ${room.name ?? room.id} (${room.id})`);
+        output.push('');
+        // Get room trait for exits
+        const roomTrait = room.traits?.get('room');
+        const exits = roomTrait?.exits ?? {};
+        const allDirections = [
+            'NORTH', 'SOUTH', 'EAST', 'WEST',
+            'NORTHEAST', 'NORTHWEST', 'SOUTHEAST', 'SOUTHWEST',
+            'UP', 'DOWN', 'IN', 'OUT',
+        ];
+        let exitCount = 0;
+        for (const dir of allDirections) {
+            const exit = exits[dir];
+            if (exit) {
+                exitCount++;
+                const destRoom = context.findRoom(exit.destination);
+                const destName = destRoom?.name ?? exit.destination;
+                let line = `  ${dir.padEnd(10)} -> ${destName}`;
+                if (exit.via) {
+                    const viaEntity = context.findEntity(exit.via);
+                    line += ` [via: ${viaEntity?.name ?? exit.via}]`;
+                }
+                output.push(line);
+            }
+        }
+        if (exitCount === 0) {
+            output.push('  <no exits>');
+        }
+        output.push('');
+        output.push(`Total exits: ${exitCount}`);
+        return { success: true, output };
+    }
+    cmdNoDeaths(context, _args) {
+        if (context.getFlag('immortal')) {
+            return { success: true, output: ['Immortality already enabled.'] };
+        }
+        context.setFlag('immortal', true);
+        return { success: true, output: ['Immortality ENABLED. You cannot die.'] };
+    }
+    cmdRestoreDeaths(context, _args) {
+        if (!context.getFlag('immortal')) {
+            return { success: true, output: ['Immortality already disabled.'] };
+        }
+        context.setFlag('immortal', false);
+        return { success: true, output: ['Immortality DISABLED. You can die again.'] };
+    }
+    cmdKillEntity(context, args) {
+        if (args.length === 0) {
+            return { success: false, output: [], error: 'Usage: kill <entity-id>' };
+        }
+        const entity = context.findEntity(args.join(' '));
+        if (!entity) {
+            return { success: false, output: [], error: `Entity not found: ${args.join(' ')}` };
+        }
+        // Mark entity as dead
+        entity.isDead = true;
+        entity.isAlive = false;
+        // Check for combatant trait
+        const combatant = entity.traits?.get('combatant');
+        if (combatant?.kill) {
+            combatant.kill();
+        }
+        return {
+            success: true,
+            output: [`Killed: ${entity.name ?? entity.id}`],
+        };
+    }
+    cmdExit(context, _args) {
+        context.setFlag('active', false);
+        return { success: true, output: ['Returning to game.'] };
+    }
+    // =========================================================================
+    // Annotation Command Implementations (ADR-109)
+    // =========================================================================
+    cmdBug(context, args) {
+        if (args.length === 0) {
+            return { success: false, output: [], error: 'Usage: bug <description>' };
+        }
+        const text = args.join(' ');
+        const annotationContext = (0, index_js_1.captureContext)(context.world, this.lastCommand, this.lastResponse);
+        const annotation = this.annotations.addAnnotation('bug', text, annotationContext);
+        return {
+            success: true,
+            output: [`Bug logged: "${text}" [Turn ${annotation.context.turn}, ${annotation.context.roomName}]`],
+        };
+    }
+    cmdNote(context, args) {
+        if (args.length === 0) {
+            return { success: false, output: [], error: 'Usage: note <text>' };
+        }
+        const text = args.join(' ');
+        const annotationContext = (0, index_js_1.captureContext)(context.world, this.lastCommand, this.lastResponse);
+        const annotation = this.annotations.addAnnotation('note', text, annotationContext);
+        return {
+            success: true,
+            output: [`Note added: "${text}" [Turn ${annotation.context.turn}]`],
+        };
+    }
+    cmdConfusing(context, _args) {
+        const annotationContext = (0, index_js_1.captureContext)(context.world, this.lastCommand, this.lastResponse);
+        const annotation = this.annotations.addAnnotation('confusing', '', annotationContext);
+        return {
+            success: true,
+            output: [`Marked as confusing: "${this.lastCommand}" [Turn ${annotation.context.turn}]`],
+        };
+    }
+    cmdExpected(context, args) {
+        if (args.length === 0) {
+            return { success: false, output: [], error: 'Usage: expected <what was expected>' };
+        }
+        const text = args.join(' ');
+        const annotationContext = (0, index_js_1.captureContext)(context.world, this.lastCommand, this.lastResponse);
+        const annotation = this.annotations.addAnnotation('expected', text, annotationContext);
+        return {
+            success: true,
+            output: [`Expected: "${text}" (Got: "${this.lastResponse.substring(0, 50)}...")`],
+            data: { annotation },
+        };
+    }
+    cmdBookmark(context, args) {
+        if (args.length === 0) {
+            return { success: false, output: [], error: 'Usage: bookmark <name>' };
+        }
+        const name = args.join(' ');
+        const annotationContext = (0, index_js_1.captureContext)(context.world, this.lastCommand, this.lastResponse);
+        const annotation = this.annotations.addAnnotation('bookmark', name, annotationContext);
+        // Also save a checkpoint with this name
+        const checkpointData = (0, serializer_js_1.serializeCheckpoint)(context.world, name);
+        this.checkpoints.save(name, checkpointData).catch(() => {
+            // Silently ignore checkpoint save errors
+        });
+        return {
+            success: true,
+            output: [`Bookmark "${name}" created at Turn ${annotation.context.turn}, ${annotation.context.roomName}`],
+        };
+    }
+    cmdSession(_context, args) {
+        if (args.length === 0) {
+            return { success: false, output: [], error: 'Usage: session start <name> | session end' };
+        }
+        const subcommand = args[0].toLowerCase();
+        if (subcommand === 'start') {
+            if (args.length < 2) {
+                return { success: false, output: [], error: 'Usage: session start <name>' };
+            }
+            const name = args.slice(1).join(' ');
+            const sessionId = this.annotations.startSession(name);
+            return {
+                success: true,
+                output: [`Session "${name}" started (ID: ${sessionId})`],
+            };
+        }
+        if (subcommand === 'end') {
+            const ended = this.annotations.endSession();
+            if (!ended) {
+                return { success: false, output: [], error: 'No active session to end' };
+            }
+            const duration = ended.endTime
+                ? Math.round((ended.endTime - ended.startTime) / 60000)
+                : 0;
+            return {
+                success: true,
+                output: [
+                    `Session "${ended.name}" ended`,
+                    `Duration: ${duration} minutes`,
+                    `Annotations: ${ended.annotations.length}`,
+                ],
+            };
+        }
+        return { success: false, output: [], error: 'Usage: session start <name> | session end' };
+    }
+    cmdReview(_context, _args) {
+        const session = this.annotations.getCurrentSession();
+        const annotations = this.annotations.getAnnotations();
+        const output = [];
+        if (session) {
+            output.push(`=== Session: ${session.name} ===`);
+            output.push(`Started: ${new Date(session.startTime).toLocaleTimeString()}`);
+        }
+        else {
+            output.push('=== Annotations (no active session) ===');
+        }
+        output.push('');
+        if (annotations.length === 0) {
+            output.push('No annotations yet.');
+        }
+        else {
+            // Group by type
+            const bugs = annotations.filter((a) => a.type === 'bug');
+            const notes = annotations.filter((a) => a.type === 'note');
+            const confusing = annotations.filter((a) => a.type === 'confusing');
+            const expected = annotations.filter((a) => a.type === 'expected');
+            const bookmarks = annotations.filter((a) => a.type === 'bookmark');
+            const comments = annotations.filter((a) => a.type === 'comment');
+            if (bugs.length > 0) {
+                output.push(`Bugs: ${bugs.length}`);
+                bugs.forEach((b) => output.push(`  - [T${b.context.turn}] ${b.text}`));
+            }
+            if (notes.length > 0) {
+                output.push(`Notes: ${notes.length}`);
+                notes.forEach((n) => output.push(`  - [T${n.context.turn}] ${n.text}`));
+            }
+            if (confusing.length > 0) {
+                output.push(`Confusion points: ${confusing.length}`);
+            }
+            if (expected.length > 0) {
+                output.push(`Expected behavior: ${expected.length}`);
+            }
+            if (bookmarks.length > 0) {
+                output.push(`Bookmarks: ${bookmarks.length}`);
+                bookmarks.forEach((b) => output.push(`  - "${b.text}" at T${b.context.turn}`));
+            }
+            if (comments.length > 0) {
+                output.push(`Comments: ${comments.length}`);
+            }
+        }
+        output.push('');
+        output.push(`Total: ${annotations.length} annotations`);
+        return { success: true, output };
+    }
+    cmdExport(_context, _args) {
+        const markdown = this.annotations.exportMarkdown();
+        return {
+            success: true,
+            output: markdown.split('\n'),
+        };
+    }
+}
+exports.TestingExtension = TestingExtension;
+/**
+ * Format a value for display
+ */
+function formatValue(value) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    if (typeof value === 'string')
+        return `"${value}"`;
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    if (typeof value === 'number')
+        return String(value);
+    if (Array.isArray(value)) {
+        if (value.length === 0)
+            return '[]';
+        if (value.length <= 3)
+            return `[${value.map((v) => formatValue(v)).join(', ')}]`;
+        return `[${value.slice(0, 2).map((v) => formatValue(v)).join(', ')}, ... (${value.length} items)]`;
+    }
+    if (typeof value === 'object') {
+        const keys = Object.keys(value);
+        if (keys.length === 0)
+            return '{}';
+        if (keys.length <= 2) {
+            return `{${keys.map((k) => `${k}: ${formatValue(value[k])}`).join(', ')}}`;
+        }
+        return `{... (${keys.length} keys)}`;
+    }
+    return String(value);
+}
+//# sourceMappingURL=extension.js.map