@sharpee/ext-testing 0.9.62-beta → 0.9.66-beta

package/dist-npm/types.d.ts

@@ -1,375 +0,0 @@
-/**
- * @sharpee/ext-testing - Type definitions
- *
- * Core interfaces for the testing extension, generalized from Dungeo's GDT implementation.
- */
-import type { WorldModel, IFEntity, AuthorModel } from '@sharpee/world-model';
-/**
- * Configuration for the testing extension
- */
-export interface TestingExtensionConfig {
-    /**
-     * Interactive debug mode (GDT-style) configuration
-     */
-    debugMode?: {
-        /** Enable interactive debug commands */
-        enabled?: boolean;
-        /** Command prefix (default: 'gdt') */
-        prefix?: string;
-        /** Optional password to enter debug mode */
-        password?: string | null;
-    };
-    /**
-     * Test mode configuration for transcript testing
-     */
-    testMode?: {
-        /** Enable test commands ($teleport, $assert, etc.) */
-        enabled?: boolean;
-        /** Use deterministic random for reproducible tests */
-        deterministicRandom?: boolean;
-        /** Enable assertion commands */
-        assertions?: boolean;
-    };
-    /**
-     * Checkpoint configuration
-     */
-    checkpoints?: {
-        /** Directory for checkpoint files */
-        directory?: string;
-    };
-    /**
-     * Additional story-specific commands
-     */
-    commands?: DebugCommand[];
-}
-/**
- * Context provided to debug commands for inspecting and modifying game state.
- * Wraps WorldModel with convenience methods for common debug operations.
- */
-export interface DebugContext {
-    /** Direct access to world model (read operations) */
-    readonly world: WorldModel;
-    /** Author model for bypassing game rules during setup */
-    readonly author: AuthorModel;
-    /** Current player entity */
-    readonly player: IFEntity;
-    /** Debug flags (story-specific state) */
-    readonly flags: Map<string, boolean>;
-    /**
-     * Find entity by ID or partial name match
-     */
-    findEntity(idOrName: string): IFEntity | undefined;
-    /**
-     * Find room by ID or partial name match
-     */
-    findRoom(idOrName: string): IFEntity | undefined;
-    /**
-     * Get all entities matching a predicate
-     */
-    findEntities(predicate: (entity: IFEntity) => boolean): IFEntity[];
-    /**
-     * Get current player location
-     */
-    getPlayerLocation(): IFEntity | undefined;
-    /**
-     * Get player inventory as array of entities
-     */
-    getInventory(): IFEntity[];
-    /**
-     * Get all entities at a location
-     */
-    getContents(locationId: string): IFEntity[];
-    /**
-     * Teleport player to a room
-     */
-    teleportPlayer(roomId: string): boolean;
-    /**
-     * Move an object to a location
-     */
-    moveObject(objectId: string, locationId: string): boolean;
-    /**
-     * Give an object to player (add to inventory)
-     */
-    takeObject(objectId: string): boolean;
-    /**
-     * Remove an object from the game (move to limbo)
-     */
-    removeObject(objectId: string): boolean;
-    /**
-     * Spawn an object at a location
-     */
-    spawnObject(objectId: string, locationId: string): boolean;
-    /**
-     * Set a debug flag
-     */
-    setFlag(name: string, value: boolean): void;
-    /**
-     * Get a debug flag value
-     */
-    getFlag(name: string): boolean;
-}
-/**
- * Result of executing a debug command
- */
-export interface CommandResult {
-    /** Whether the command succeeded */
-    success: boolean;
-    /** Output lines to display */
-    output: string[];
-    /** Error message if failed */
-    error?: string;
-    /** Optional data for programmatic use */
-    data?: Record<string, unknown>;
-}
-/**
- * Categories for organizing commands
- */
-export type CommandCategory = 'display' | 'alter' | 'toggle' | 'utility' | 'test' | 'annotation';
-/**
- * A debug/test command handler
- */
-export interface DebugCommand {
-    /**
-     * Short code for GDT mode (e.g., "AH" for teleport)
-     */
-    code: string;
-    /**
-     * Test syntax for transcript mode (e.g., "teleport")
-     */
-    testSyntax?: string;
-    /**
-     * Human-readable name
-     */
-    name: string;
-    /**
-     * Brief description for help text
-     */
-    description: string;
-    /**
-     * Command category for organization
-     */
-    category: CommandCategory;
-    /**
-     * Usage pattern (e.g., "teleport <room>")
-     */
-    usage?: string;
-    /**
-     * Execute the command
-     */
-    execute(context: DebugContext, args: string[]): CommandResult;
-}
-/**
- * Registry for debug commands
- */
-export interface CommandRegistry {
-    /**
-     * Register a command
-     */
-    register(command: DebugCommand): void;
-    /**
-     * Get command by GDT code
-     */
-    getByCode(code: string): DebugCommand | undefined;
-    /**
-     * Get command by test syntax
-     */
-    getByTestSyntax(syntax: string): DebugCommand | undefined;
-    /**
-     * Get all commands
-     */
-    getAll(): DebugCommand[];
-    /**
-     * Get commands by category
-     */
-    getByCategory(category: CommandCategory): DebugCommand[];
-}
-/**
- * Serialized checkpoint data
- */
-export interface CheckpointData {
-    /** Format version */
-    version: '1.0.0';
-    /** When checkpoint was created */
-    timestamp: number;
-    /** Metadata about the checkpoint */
-    metadata: {
-        /** Optional name for the checkpoint */
-        name?: string;
-        /** Current turn number */
-        turn: number;
-        /** Player location at checkpoint */
-        location?: string;
-    };
-    /** Serialized world state */
-    worldState: string;
-    /** Scheduler state (daemons, fuses) */
-    schedulerState?: {
-        turn: number;
-        daemons: SerializedDaemon[];
-        fuses: SerializedFuse[];
-    };
-}
-/**
- * Serialized daemon data
- */
-export interface SerializedDaemon {
-    id: string;
-    handler: string;
-    interval: number;
-    lastRun: number;
-    data?: Record<string, unknown>;
-}
-/**
- * Serialized fuse data
- */
-export interface SerializedFuse {
-    id: string;
-    handler: string;
-    turnsRemaining: number;
-    data?: Record<string, unknown>;
-}
-/**
- * Checkpoint storage interface
- */
-export interface CheckpointStore {
-    /**
-     * Save a checkpoint
-     */
-    save(name: string, data: CheckpointData): Promise<void>;
-    /**
-     * Load a checkpoint
-     */
-    load(name: string): Promise<CheckpointData | undefined>;
-    /**
-     * List available checkpoints
-     */
-    list(): Promise<string[]>;
-    /**
-     * Delete a checkpoint
-     */
-    delete(name: string): Promise<boolean>;
-    /**
-     * Check if checkpoint exists
-     */
-    exists(name: string): Promise<boolean>;
-}
-/**
- * Types of annotations playtesters can create
- */
-export type AnnotationType = 'comment' | 'bug' | 'note' | 'confusing' | 'expected' | 'bookmark';
-/**
- * Context captured with each annotation
- */
-export interface AnnotationContext {
-    /** Current room ID */
-    roomId: string;
-    /** Current room name */
-    roomName: string;
-    /** Current turn number */
-    turn: number;
-    /** Current score */
-    score: number;
-    /** The command that was just executed */
-    lastCommand: string;
-    /** The game's response to that command */
-    lastResponse: string;
-    /** Items currently in player's inventory */
-    inventory: string[];
-}
-/**
- * A single annotation from a playtester
- */
-export interface Annotation {
-    /** Unique identifier */
-    id: string;
-    /** When the annotation was created */
-    timestamp: number;
-    /** Type of annotation */
-    type: AnnotationType;
-    /** The annotation text */
-    text: string;
-    /** Game state context when annotation was made */
-    context: AnnotationContext;
-    /** Session this annotation belongs to (if any) */
-    sessionId?: string;
-}
-/**
- * A playtest session containing multiple annotations
- */
-export interface AnnotationSession {
-    /** Unique session identifier */
-    id: string;
-    /** Human-readable session name */
-    name: string;
-    /** When session started */
-    startTime: number;
-    /** When session ended (undefined if still active) */
-    endTime?: number;
-    /** All annotations in this session */
-    annotations: Annotation[];
-}
-/**
- * Storage interface for annotations
- */
-export interface AnnotationStore {
-    /** Start a new annotation session */
-    startSession(name: string): string;
-    /** End the current session */
-    endSession(): AnnotationSession | undefined;
-    /** Get the current active session */
-    getCurrentSession(): AnnotationSession | undefined;
-    /** Add an annotation with context */
-    addAnnotation(type: AnnotationType, text: string, context: AnnotationContext): Annotation;
-    /** Get all annotations (current session or all if no session) */
-    getAnnotations(): Annotation[];
-    /** Get annotations filtered by type */
-    getAnnotationsByType(type: AnnotationType): Annotation[];
-    /** Export annotations as markdown report */
-    exportMarkdown(): string;
-    /** Export annotations as JSON */
-    exportJson(): string;
-    /** Clear all annotations */
-    clear(): void;
-}
-/**
- * Interface for the testing extension
- */
-export interface ITestingExtension {
-    /** Extension configuration */
-    readonly config: TestingExtensionConfig;
-    /** Command registry */
-    readonly commands: CommandRegistry;
-    /** Checkpoint store */
-    readonly checkpoints: CheckpointStore;
-    /** Annotation store */
-    readonly annotations: AnnotationStore;
-    /**
-     * Execute a GDT-style command (e.g., "AH room-id")
-     */
-    executeGdtCommand(input: string, world: WorldModel): CommandResult;
-    /**
-     * Execute a test command (e.g., "$teleport room-id")
-     */
-    executeTestCommand(input: string, world: WorldModel): CommandResult;
-    /**
-     * Create a debug context for the current world state
-     */
-    createContext(world: WorldModel): DebugContext;
-    /**
-     * Save current state as checkpoint
-     */
-    saveCheckpoint(name: string, world: WorldModel): Promise<void>;
-    /**
-     * Restore state from checkpoint
-     */
-    restoreCheckpoint(name: string, world: WorldModel): Promise<boolean>;
-    /**
-     * Set context for annotation commands (called by transcript-tester after each command)
-     */
-    setCommandContext(command: string, response: string): void;
-    /**
-     * Add an annotation directly (for # comments from transcript-tester)
-     */
-    addAnnotation(type: AnnotationType, text: string, world: WorldModel): Annotation;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist-npm/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist-npm/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/src/annotations/context.ts

@@ -1,47 +0,0 @@
-/**
- * Annotation Context Capture
- *
- * Utility to capture current game state for annotations.
- */
-
-import type { WorldModel } from '@sharpee/world-model';
-import type { AnnotationContext } from '../types.js';
-
-/**
- * Capture the current game state for annotation context
- */
-export function captureContext(
-  world: WorldModel,
-  lastCommand: string,
-  lastResponse: string
-): AnnotationContext {
-  const player = world.getPlayer();
-  const locationId = player ? world.getLocation(player.id) : undefined;
-  const location = locationId ? world.getEntity(locationId) : undefined;
-  const inventory = player ? world.getContents(player.id) : [];
-
-  return {
-    roomId: locationId ?? 'unknown',
-    roomName: location?.name ?? locationId ?? 'unknown',
-    turn: (world.getStateValue('turnCount') as number) ?? (world.getStateValue('moves') as number) ?? 0,
-    score: (world.getStateValue('score') as number) ?? 0,
-    lastCommand,
-    lastResponse,
-    inventory: inventory.map((e) => e.name ?? e.id),
-  };
-}
-
-/**
- * Create an empty/default context (for when no command has been executed yet)
- */
-export function createEmptyContext(): AnnotationContext {
-  return {
-    roomId: 'unknown',
-    roomName: 'unknown',
-    turn: 0,
-    score: 0,
-    lastCommand: '',
-    lastResponse: '',
-    inventory: [],
-  };
-}

package/src/annotations/index.ts

@@ -1,6 +0,0 @@
-/**
- * Annotations module - Playtester feedback capture (ADR-109)
- */
-
-export { createAnnotationStore } from './store.js';
-export { captureContext, createEmptyContext } from './context.js';

package/src/annotations/store.ts

@@ -1,219 +0,0 @@
-/**
- * Annotation Store Implementation
- *
- * In-memory storage for playtester annotations with session management.
- */
-
-import type { AnnotationType, Annotation, AnnotationContext, AnnotationSession, AnnotationStore } from '../types.js';
-
-/**
- * Generate a unique ID
- */
-function generateId(): string {
-  return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
-}
-
-/**
- * Create an in-memory annotation store
- */
-export function createAnnotationStore(): AnnotationStore {
-  let currentSession: AnnotationSession | undefined;
-  let allAnnotations: Annotation[] = [];
-
-  return {
-    // Session management
-    startSession(name: string): string {
-      // End any existing session first
-      if (currentSession) {
-        currentSession.endTime = Date.now();
-      }
-
-      const id = generateId();
-      currentSession = {
-        id,
-        name,
-        startTime: Date.now(),
-        annotations: [],
-      };
-
-      return id;
-    },
-
-    endSession(): AnnotationSession | undefined {
-      if (!currentSession) {
-        return undefined;
-      }
-
-      currentSession.endTime = Date.now();
-      const ended = currentSession;
-      currentSession = undefined;
-      return ended;
-    },
-
-    getCurrentSession(): AnnotationSession | undefined {
-      return currentSession;
-    },
-
-    // Annotation capture
-    addAnnotation(type: AnnotationType, text: string, context: AnnotationContext): Annotation {
-      const annotation: Annotation = {
-        id: generateId(),
-        timestamp: Date.now(),
-        type,
-        text,
-        context,
-        sessionId: currentSession?.id,
-      };
-
-      allAnnotations.push(annotation);
-
-      if (currentSession) {
-        currentSession.annotations.push(annotation);
-      }
-
-      return annotation;
-    },
-
-    getAnnotations(): Annotation[] {
-      if (currentSession) {
-        return [...currentSession.annotations];
-      }
-      return [...allAnnotations];
-    },
-
-    getAnnotationsByType(type: AnnotationType): Annotation[] {
-      const source = currentSession ? currentSession.annotations : allAnnotations;
-      return source.filter((a) => a.type === type);
-    },
-
-    // Export
-    exportMarkdown(): string {
-      return formatMarkdownReport(currentSession, allAnnotations);
-    },
-
-    exportJson(): string {
-      const data = currentSession
-        ? { session: currentSession }
-        : { annotations: allAnnotations };
-      return JSON.stringify(data, null, 2);
-    },
-
-    // Cleanup
-    clear(): void {
-      currentSession = undefined;
-      allAnnotations = [];
-    },
-  };
-}
-
-/**
- * Format annotations as a markdown report (per ADR-109)
- */
-function formatMarkdownReport(
-  session: AnnotationSession | undefined,
-  allAnnotations: Annotation[]
-): string {
-  const annotations = session ? session.annotations : allAnnotations;
-  const lines: string[] = [];
-
-  // Header
-  if (session) {
-    lines.push(`# Play Test Session: ${session.name}`);
-    lines.push(`Date: ${new Date(session.startTime).toLocaleString()}`);
-    if (session.endTime) {
-      const durationMs = session.endTime - session.startTime;
-      const durationMins = Math.round(durationMs / 60000);
-      lines.push(`Duration: ${durationMins} minutes`);
-    }
-  } else {
-    lines.push('# Playtest Annotations');
-    lines.push(`Generated: ${new Date().toLocaleString()}`);
-  }
-  lines.push('');
-
-  // 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');
-
-  // Bugs section
-  if (bugs.length > 0) {
-    lines.push(`## Bugs (${bugs.length})`);
-    bugs.forEach((bug, i) => {
-      lines.push(`${i + 1}. [Turn ${bug.context.turn}, ${bug.context.roomName}] "${bug.text}"`);
-      lines.push(`   - Command: ${bug.context.lastCommand}`);
-      lines.push(`   - Response: ${truncate(bug.context.lastResponse, 100)}`);
-      lines.push('');
-    });
-  }
-
-  // Notes section
-  if (notes.length > 0) {
-    lines.push(`## Notes (${notes.length})`);
-    notes.forEach((note, i) => {
-      lines.push(`${i + 1}. [Turn ${note.context.turn}, ${note.context.roomName}] "${note.text}"`);
-    });
-    lines.push('');
-  }
-
-  // Confusion points
-  if (confusing.length > 0) {
-    lines.push(`## Confusion Points (${confusing.length})`);
-    confusing.forEach((c, i) => {
-      lines.push(`${i + 1}. [Turn ${c.context.turn}, ${c.context.roomName}]`);
-      lines.push(`   - After: ${c.context.lastCommand}`);
-      lines.push(`   - Response: ${truncate(c.context.lastResponse, 100)}`);
-      lines.push('');
-    });
-  }
-
-  // Expected behavior
-  if (expected.length > 0) {
-    lines.push(`## Expected Behavior (${expected.length})`);
-    expected.forEach((e, i) => {
-      lines.push(`${i + 1}. [Turn ${e.context.turn}, ${e.context.roomName}]`);
-      lines.push(`   - Expected: ${e.text}`);
-      lines.push(`   - Actual: ${truncate(e.context.lastResponse, 100)}`);
-      lines.push('');
-    });
-  }
-
-  // Bookmarks
-  if (bookmarks.length > 0) {
-    lines.push(`## Bookmarks (${bookmarks.length})`);
-    bookmarks.forEach((b, i) => {
-      lines.push(`${i + 1}. "${b.text}" at Turn ${b.context.turn}, ${b.context.roomName}`);
-    });
-    lines.push('');
-  }
-
-  // Comments (silent feedback)
-  if (comments.length > 0) {
-    lines.push(`## Comments (${comments.length})`);
-    comments.forEach((c, i) => {
-      lines.push(`${i + 1}. [Turn ${c.context.turn}, ${c.context.roomName}] "${c.text}"`);
-    });
-    lines.push('');
-  }
-
-  // Summary stats
-  lines.push('## Summary');
-  lines.push(`- Total annotations: ${annotations.length}`);
-  lines.push(`- Bugs: ${bugs.length}`);
-  lines.push(`- Notes: ${notes.length}`);
-  lines.push(`- Confusion points: ${confusing.length}`);
-  lines.push(`- Bookmarks: ${bookmarks.length}`);
-
-  return lines.join('\n');
-}
-
-/**
- * Truncate a string to max length
- */
-function truncate(str: string, maxLen: number): string {
-  if (str.length <= maxLen) return str;
-  return str.substring(0, maxLen - 3) + '...';
-}

package/src/checkpoints/index.ts

@@ -1,2 +0,0 @@
-export { serializeCheckpoint, deserializeCheckpoint, validateCheckpoint } from './serializer.js';
-export { createFileStore, createMemoryStore, createLocalStorageStore } from './store.js';