@sharpee/ext-testing 0.9.61-beta

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 David Cornelson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/annotations/context.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 declare function captureContext(world: WorldModel, lastCommand: string, lastResponse: string): AnnotationContext;
+/**
+ * Create an empty/default context (for when no command has been executed yet)
+ */
+export declare function createEmptyContext(): AnnotationContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/annotations/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/annotations/context.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,UAAU,EACjB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,iBAAiB,CAenB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,iBAAiB,CAUtD"}

package/dist/annotations/context.js

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Annotation Context Capture
+ *
+ * Utility to capture current game state for annotations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.captureContext = captureContext;
+exports.createEmptyContext = createEmptyContext;
+/**
+ * Capture the current game state for annotation context
+ */
+function captureContext(world, lastCommand, lastResponse) {
+    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') ?? world.getStateValue('moves') ?? 0,
+        score: world.getStateValue('score') ?? 0,
+        lastCommand,
+        lastResponse,
+        inventory: inventory.map((e) => e.name ?? e.id),
+    };
+}
+/**
+ * Create an empty/default context (for when no command has been executed yet)
+ */
+function createEmptyContext() {
+    return {
+        roomId: 'unknown',
+        roomName: 'unknown',
+        turn: 0,
+        score: 0,
+        lastCommand: '',
+        lastResponse: '',
+        inventory: [],
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/annotations/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/annotations/context.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAQH,wCAmBC;AAKD,gDAUC;AArCD;;GAEG;AACH,SAAgB,cAAc,CAC5B,KAAiB,EACjB,WAAmB,EACnB,YAAoB;IAEpB,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IACjC,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACrE,MAAM,QAAQ,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAE7D,OAAO;QACL,MAAM,EAAE,UAAU,IAAI,SAAS;QAC/B,QAAQ,EAAE,QAAQ,EAAE,IAAI,IAAI,UAAU,IAAI,SAAS;QACnD,IAAI,EAAG,KAAK,CAAC,aAAa,CAAC,WAAW,CAAY,IAAK,KAAK,CAAC,aAAa,CAAC,OAAO,CAAY,IAAI,CAAC;QACnG,KAAK,EAAG,KAAK,CAAC,aAAa,CAAC,OAAO,CAAY,IAAI,CAAC;QACpD,WAAW;QACX,YAAY;QACZ,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC;KAChD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB;IAChC,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,EAAE;QAChB,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC"}

package/dist/annotations/index.d.ts

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

package/dist/annotations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/annotations/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}

package/dist/annotations/index.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * Annotations module - Playtester feedback capture (ADR-109)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEmptyContext = exports.captureContext = exports.createAnnotationStore = void 0;
+var store_js_1 = require("./store.js");
+Object.defineProperty(exports, "createAnnotationStore", { enumerable: true, get: function () { return store_js_1.createAnnotationStore; } });
+var context_js_1 = require("./context.js");
+Object.defineProperty(exports, "captureContext", { enumerable: true, get: function () { return context_js_1.captureContext; } });
+Object.defineProperty(exports, "createEmptyContext", { enumerable: true, get: function () { return context_js_1.createEmptyContext; } });
+//# sourceMappingURL=index.js.map

package/dist/annotations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/annotations/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAAmD;AAA1C,iHAAA,qBAAqB,OAAA;AAC9B,2CAAkE;AAAzD,4GAAA,cAAc,OAAA;AAAE,gHAAA,kBAAkB,OAAA"}

package/dist/annotations/store.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Annotation Store Implementation
+ *
+ * In-memory storage for playtester annotations with session management.
+ */
+import type { AnnotationStore } from '../types.js';
+/**
+ * Create an in-memory annotation store
+ */
+export declare function createAnnotationStore(): AnnotationStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/annotations/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/annotations/store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAoE,eAAe,EAAE,MAAM,aAAa,CAAC;AASrH;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,eAAe,CAwFvD"}

package/dist/annotations/store.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Annotation Store Implementation
+ *
+ * In-memory storage for playtester annotations with session management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAnnotationStore = createAnnotationStore;
+/**
+ * Generate a unique ID
+ */
+function generateId() {
+    return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+/**
+ * Create an in-memory annotation store
+ */
+function createAnnotationStore() {
+    let currentSession;
+    let allAnnotations = [];
+    return {
+        // Session management
+        startSession(name) {
+            // End any existing session first
+            if (currentSession) {
+                currentSession.endTime = Date.now();
+            }
+            const id = generateId();
+            currentSession = {
+                id,
+                name,
+                startTime: Date.now(),
+                annotations: [],
+            };
+            return id;
+        },
+        endSession() {
+            if (!currentSession) {
+                return undefined;
+            }
+            currentSession.endTime = Date.now();
+            const ended = currentSession;
+            currentSession = undefined;
+            return ended;
+        },
+        getCurrentSession() {
+            return currentSession;
+        },
+        // Annotation capture
+        addAnnotation(type, text, context) {
+            const annotation = {
+                id: generateId(),
+                timestamp: Date.now(),
+                type,
+                text,
+                context,
+                sessionId: currentSession?.id,
+            };
+            allAnnotations.push(annotation);
+            if (currentSession) {
+                currentSession.annotations.push(annotation);
+            }
+            return annotation;
+        },
+        getAnnotations() {
+            if (currentSession) {
+                return [...currentSession.annotations];
+            }
+            return [...allAnnotations];
+        },
+        getAnnotationsByType(type) {
+            const source = currentSession ? currentSession.annotations : allAnnotations;
+            return source.filter((a) => a.type === type);
+        },
+        // Export
+        exportMarkdown() {
+            return formatMarkdownReport(currentSession, allAnnotations);
+        },
+        exportJson() {
+            const data = currentSession
+                ? { session: currentSession }
+                : { annotations: allAnnotations };
+            return JSON.stringify(data, null, 2);
+        },
+        // Cleanup
+        clear() {
+            currentSession = undefined;
+            allAnnotations = [];
+        },
+    };
+}
+/**
+ * Format annotations as a markdown report (per ADR-109)
+ */
+function formatMarkdownReport(session, allAnnotations) {
+    const annotations = session ? session.annotations : allAnnotations;
+    const lines = [];
+    // 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, maxLen) {
+    if (str.length <= maxLen)
+        return str;
+    return str.substring(0, maxLen - 3) + '...';
+}
+//# sourceMappingURL=store.js.map

package/dist/annotations/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../src/annotations/store.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAcH,sDAwFC;AAlGD;;GAEG;AACH,SAAS,UAAU;IACjB,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB;IACnC,IAAI,cAA6C,CAAC;IAClD,IAAI,cAAc,GAAiB,EAAE,CAAC;IAEtC,OAAO;QACL,qBAAqB;QACrB,YAAY,CAAC,IAAY;YACvB,iCAAiC;YACjC,IAAI,cAAc,EAAE,CAAC;gBACnB,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACtC,CAAC;YAED,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;YACxB,cAAc,GAAG;gBACf,EAAE;gBACF,IAAI;gBACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,WAAW,EAAE,EAAE;aAChB,CAAC;YAEF,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,UAAU;YACR,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,cAAc,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,cAAc,CAAC;YAC7B,cAAc,GAAG,SAAS,CAAC;YAC3B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,iBAAiB;YACf,OAAO,cAAc,CAAC;QACxB,CAAC;QAED,qBAAqB;QACrB,aAAa,CAAC,IAAoB,EAAE,IAAY,EAAE,OAA0B;YAC1E,MAAM,UAAU,GAAe;gBAC7B,EAAE,EAAE,UAAU,EAAE;gBAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;gBACrB,IAAI;gBACJ,IAAI;gBACJ,OAAO;gBACP,SAAS,EAAE,cAAc,EAAE,EAAE;aAC9B,CAAC;YAEF,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAEhC,IAAI,cAAc,EAAE,CAAC;gBACnB,cAAc,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9C,CAAC;YAED,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,cAAc;YACZ,IAAI,cAAc,EAAE,CAAC;gBACnB,OAAO,CAAC,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;YACzC,CAAC;YACD,OAAO,CAAC,GAAG,cAAc,CAAC,CAAC;QAC7B,CAAC;QAED,oBAAoB,CAAC,IAAoB;YACvC,MAAM,MAAM,GAAG,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC;YAC5E,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC/C,CAAC;QAED,SAAS;QACT,cAAc;YACZ,OAAO,oBAAoB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAC9D,CAAC;QAED,UAAU;YACR,MAAM,IAAI,GAAG,cAAc;gBACzB,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE;gBAC7B,CAAC,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACvC,CAAC;QAED,UAAU;QACV,KAAK;YACH,cAAc,GAAG,SAAS,CAAC;YAC3B,cAAc,GAAG,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,oBAAoB,CAC3B,OAAsC,EACtC,cAA4B;IAE5B,MAAM,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC;IACnE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,SAAS;IACT,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,IAAI,CAAC,wBAAwB,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,KAAK,CAAC,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;QACpE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC;YACvD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC;YACpD,KAAK,CAAC,IAAI,CAAC,aAAa,YAAY,UAAU,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,cAAc,IAAI,IAAI,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAC1D,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,gBAAgB;IAChB,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IACzD,MAAM,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IACpE,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAEjE,eAAe;IACf,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,KAAK,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;YACtB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,CAAC,QAAQ,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;YAC1F,KAAK,CAAC,IAAI,CAAC,iBAAiB,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;YACvD,KAAK,CAAC,IAAI,CAAC,kBAAkB,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACxE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,gBAAgB;IAChB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,QAAQ,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QAC/F,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,mBAAmB;IACnB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,wBAAwB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QACxD,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACzB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACxE,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;YACnD,KAAK,CAAC,IAAI,CAAC,kBAAkB,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACtE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oBAAoB;IACpB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,yBAAyB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QACxD,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACxE,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACvC,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACpE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,YAAY;IACZ,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,iBAAiB,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QACjD,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACzB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvF,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,6BAA6B;IAC7B,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;QAC/C,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACxB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,gBAAgB;IAChB,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,CAAC,IAAI,CAAC,wBAAwB,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;IACzD,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,KAAK,CAAC,IAAI,CAAC,uBAAuB,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,gBAAgB,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC;IAE/C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,GAAW,EAAE,MAAc;IAC3C,IAAI,GAAG,CAAC,MAAM,IAAI,MAAM;QAAE,OAAO,GAAG,CAAC;IACrC,OAAO,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;AAC9C,CAAC"}

package/dist/checkpoints/index.d.ts

@@ -0,0 +1,3 @@
+export { serializeCheckpoint, deserializeCheckpoint, validateCheckpoint } from './serializer.js';
+export { createFileStore, createMemoryStore, createLocalStorageStore } from './store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/checkpoints/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/checkpoints/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACjG,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

package/dist/checkpoints/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLocalStorageStore = exports.createMemoryStore = exports.createFileStore = exports.validateCheckpoint = exports.deserializeCheckpoint = exports.serializeCheckpoint = void 0;
+var serializer_js_1 = require("./serializer.js");
+Object.defineProperty(exports, "serializeCheckpoint", { enumerable: true, get: function () { return serializer_js_1.serializeCheckpoint; } });
+Object.defineProperty(exports, "deserializeCheckpoint", { enumerable: true, get: function () { return serializer_js_1.deserializeCheckpoint; } });
+Object.defineProperty(exports, "validateCheckpoint", { enumerable: true, get: function () { return serializer_js_1.validateCheckpoint; } });
+var store_js_1 = require("./store.js");
+Object.defineProperty(exports, "createFileStore", { enumerable: true, get: function () { return store_js_1.createFileStore; } });
+Object.defineProperty(exports, "createMemoryStore", { enumerable: true, get: function () { return store_js_1.createMemoryStore; } });
+Object.defineProperty(exports, "createLocalStorageStore", { enumerable: true, get: function () { return store_js_1.createLocalStorageStore; } });
+//# sourceMappingURL=index.js.map

package/dist/checkpoints/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/checkpoints/index.ts"],"names":[],"mappings":";;;AAAA,iDAAiG;AAAxF,oHAAA,mBAAmB,OAAA;AAAE,sHAAA,qBAAqB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AACvE,uCAAyF;AAAhF,2GAAA,eAAe,OAAA;AAAE,6GAAA,iBAAiB,OAAA;AAAE,mHAAA,uBAAuB,OAAA"}

package/dist/checkpoints/serializer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Checkpoint Serializer
+ *
+ * Handles serialization and deserialization of game state for checkpoints.
+ * Captures world model state and scheduler state (daemons, fuses).
+ */
+import type { WorldModel } from '@sharpee/world-model';
+import type { CheckpointData } from '../types.js';
+/**
+ * Serialize current game state to checkpoint data
+ */
+export declare function serializeCheckpoint(world: WorldModel, name?: string): CheckpointData;
+/**
+ * Deserialize checkpoint data and restore game state
+ */
+export declare function deserializeCheckpoint(checkpoint: CheckpointData, world: WorldModel): void;
+/**
+ * Validate checkpoint data structure
+ */
+export declare function validateCheckpoint(data: unknown): data is CheckpointData;
+//# sourceMappingURL=serializer.d.ts.map

package/dist/checkpoints/serializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.d.ts","sourceRoot":"","sources":["../../src/checkpoints/serializer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAoC,MAAM,aAAa,CAAC;AAEpF;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,CAwBhB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,cAAc,EAC1B,KAAK,EAAE,UAAU,GAChB,IAAI,CAaN;AAgCD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,cAAc,CAwBxE"}

package/dist/checkpoints/serializer.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * Checkpoint Serializer
+ *
+ * Handles serialization and deserialization of game state for checkpoints.
+ * Captures world model state and scheduler state (daemons, fuses).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeCheckpoint = serializeCheckpoint;
+exports.deserializeCheckpoint = deserializeCheckpoint;
+exports.validateCheckpoint = validateCheckpoint;
+/**
+ * Serialize current game state to checkpoint data
+ */
+function serializeCheckpoint(world, name) {
+    const player = world.getPlayer();
+    const playerLocation = player ? world.getLocation(player.id) : undefined;
+    // Get world state via WorldModel.toJSON()
+    const worldState = world.toJSON();
+    // TODO: Get scheduler state when scheduler API is available
+    // For now, scheduler state is omitted
+    const schedulerState = undefined;
+    const checkpoint = {
+        version: '1.0.0',
+        timestamp: Date.now(),
+        metadata: {
+            name,
+            turn: getTurnNumber(world),
+            location: playerLocation,
+        },
+        worldState,
+        schedulerState,
+    };
+    return checkpoint;
+}
+/**
+ * Deserialize checkpoint data and restore game state
+ */
+function deserializeCheckpoint(checkpoint, world) {
+    // Validate version
+    if (checkpoint.version !== '1.0.0') {
+        throw new Error(`Unsupported checkpoint version: ${checkpoint.version}`);
+    }
+    // Restore world state via WorldModel.loadJSON()
+    world.loadJSON(checkpoint.worldState);
+    // TODO: Restore scheduler state when scheduler API is available
+    if (checkpoint.schedulerState) {
+        restoreSchedulerState(world, checkpoint.schedulerState);
+    }
+}
+/**
+ * Get current turn number from world
+ */
+function getTurnNumber(world) {
+    // Try to get turn from world metadata or state
+    // This may need adjustment based on actual WorldModel API
+    try {
+        const state = JSON.parse(world.toJSON());
+        return state.turn ?? 0;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Restore scheduler state (daemons and fuses)
+ */
+function restoreSchedulerState(world, state) {
+    // TODO: Implement when scheduler serialization API is available
+    // This will need access to the engine's scheduler service
+    console.warn('Scheduler state restoration not yet implemented');
+}
+/**
+ * Validate checkpoint data structure
+ */
+function validateCheckpoint(data) {
+    if (!data || typeof data !== 'object') {
+        return false;
+    }
+    const checkpoint = data;
+    if (checkpoint.version !== '1.0.0') {
+        return false;
+    }
+    if (typeof checkpoint.timestamp !== 'number') {
+        return false;
+    }
+    if (!checkpoint.metadata || typeof checkpoint.metadata !== 'object') {
+        return false;
+    }
+    if (typeof checkpoint.worldState !== 'string') {
+        return false;
+    }
+    return true;
+}
+//# sourceMappingURL=serializer.js.map

package/dist/checkpoints/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../src/checkpoints/serializer.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAQH,kDA2BC;AAKD,sDAgBC;AAmCD,gDAwBC;AA9GD;;GAEG;AACH,SAAgB,mBAAmB,CACjC,KAAiB,EACjB,IAAa;IAEb,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;IACjC,MAAM,cAAc,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEzE,0CAA0C;IAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;IAElC,4DAA4D;IAC5D,sCAAsC;IACtC,MAAM,cAAc,GAAG,SAAS,CAAC;IAEjC,MAAM,UAAU,GAAmB;QACjC,OAAO,EAAE,OAAO;QAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,QAAQ,EAAE;YACR,IAAI;YACJ,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC;YAC1B,QAAQ,EAAE,cAAc;SACzB;QACD,UAAU;QACV,cAAc;KACf,CAAC;IAEF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAgB,qBAAqB,CACnC,UAA0B,EAC1B,KAAiB;IAEjB,mBAAmB;IACnB,IAAI,UAAU,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,gDAAgD;IAChD,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAEtC,gEAAgE;IAChE,IAAI,UAAU,CAAC,cAAc,EAAE,CAAC;QAC9B,qBAAqB,CAAC,KAAK,EAAE,UAAU,CAAC,cAAc,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,KAAiB;IACtC,+CAA+C;IAC/C,0DAA0D;IAC1D,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,qBAAqB,CAC5B,KAAiB,EACjB,KAIC;IAED,gEAAgE;IAChE,0DAA0D;IAC1D,OAAO,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,IAAa;IAC9C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,UAAU,GAAG,IAA+B,CAAC;IAEnD,IAAI,UAAU,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,UAAU,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,QAAQ,IAAI,OAAO,UAAU,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACpE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,UAAU,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/checkpoints/store.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Checkpoint Store
+ *
+ * File-based storage for checkpoints.
+ * Supports both Node.js (filesystem) and browser (localStorage) environments.
+ */
+import type { CheckpointStore } from '../types.js';
+/**
+ * Create a file-based checkpoint store (Node.js)
+ */
+export declare function createFileStore(directory: string): CheckpointStore;
+/**
+ * Create a memory-based checkpoint store (for testing or browser)
+ */
+export declare function createMemoryStore(): CheckpointStore;
+/**
+ * Create a localStorage-based checkpoint store (browser)
+ */
+export declare function createLocalStorageStore(prefix?: string): CheckpointStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/checkpoints/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/checkpoints/store.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnE;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,CA2FlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,eAAe,CAwBnD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,GAAE,MAA8B,GAAG,eAAe,CAiD/F"}