@thijshakkenberg/valkyrie-mom-mcp 1.0.1 → 1.2.0

package/README.md

@@ -20,7 +20,7 @@ claude plugin install valkyrie-mom
 ```
 
 This gives you:
-- **MCP server** with 16 tools for scenario editing (auto-started)
+- **MCP server** with 20 tools for scenario editing (auto-started)
 - **7 skills**: `/scenario`, `/event-patterns`, `/tile-placement`, `/variables-and-mythos`, `/custom-monsters`, `/ui-and-puzzles`, `/items-and-distribution`
 - **Scenario designer agent** for autonomous scenario creation
 - **5 MCP resources** for format documentation
@@ -111,6 +111,11 @@ npx tsx src/index.ts   # Run MCP server via stdio
 |------|-------------|
 | `search_game_content` | Search game content catalogs (846 entries across tiles, monsters, items, audio) |
 
+### Diagnostics
+| Tool | Description |
+|------|-------------|
+| `export_bug_report` | Generate a ZIP bug report with session trace, scenario files, validation results, and Valkyrie logs |
+
 ## MCP Resources
 
 | Resource | URI |
@@ -173,7 +178,7 @@ The server validates scenarios against 12 rule categories:
 ## Development
 
 ```bash
-npm test          # Run all tests (1015 tests across 30 files)
+npm test          # Run all tests (1096 tests across 36 files)
 npm run test:watch # Watch mode
 npm run lint       # Type check
 npm run build      # Compile to dist/
@@ -193,6 +198,7 @@ src/
   tools/           MCP tool implementations
   resources/       Format documentation resources
   catalogs/        846-entry game content catalog
+  diagnostics/     Bug report builder, session trace, ring buffer
   server.ts        MCP server registration
   index.ts         Entry point (stdio transport)
 tests/
@@ -201,6 +207,7 @@ tests/
   model/           Model layer tests
   tools/           Tool tests
   validation/      Validation rule tests
+  diagnostics/     Diagnostics tests
   golden.test.ts   Round-trip integrity tests
   integration.test.ts  Full pipeline tests
 ```

package/dist/catalogs/catalog-store.d.ts

@@ -1,4 +1,8 @@
 import type { CatalogEntry, CatalogType } from './catalog-types.js';
+/** Maps lowercase catalog pack IDs to Valkyrie's case-sensitive pack IDs */
+export declare const PACK_ID_MAP: Record<string, string>;
+/** Convert a catalog pack ID (lowercase) to Valkyrie's case-sensitive pack ID */
+export declare function getValkyriePackId(catalogPack: string): string;
 export declare class CatalogStore {
     private entries;
     private byId;
@@ -15,6 +19,12 @@ export declare class CatalogStore {
     getByType(type: CatalogType): CatalogEntry[];
     /** Get a Set of all entry IDs, optionally filtered by type. */
     getAllIds(type?: CatalogType): Set<string>;
+    /** Get the Valkyrie pack ID for a catalog pack string */
+    getPackId(catalogPack: string): string;
+    /** Look up a tile side's pack from catalog, return Valkyrie pack ID */
+    getPackForTileSide(tileId: string): string | undefined;
+    /** Look up a monster's pack from catalog, return Valkyrie pack ID */
+    getPackForMonster(monsterId: string): string | undefined;
 }
 export declare function getSharedCatalog(): CatalogStore;
 //# sourceMappingURL=catalog-store.d.ts.map

package/dist/catalogs/catalog-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-store.d.ts","sourceRoot":"","sources":["../../src/catalogs/catalog-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAYpE,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,MAAM,CAAmC;;IAoCjD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,YAAY,EAAE;IAazD,uCAAuC;IACvC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI7C,uCAAuC;IACvC,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,EAAE;IAI5C,+DAA+D;IAC/D,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC;CAI3C;AAKD,wBAAgB,gBAAgB,IAAI,YAAY,CAK/C"}
+{"version":3,"file":"catalog-store.d.ts","sourceRoot":"","sources":["../../src/catalogs/catalog-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAYpE,4EAA4E;AAC5E,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAO9C,CAAC;AAEF,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAiB;IAChC,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,MAAM,CAAmC;;IAoCjD;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,YAAY,EAAE;IAazD,uCAAuC;IACvC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI7C,uCAAuC;IACvC,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,YAAY,EAAE;IAI5C,+DAA+D;IAC/D,SAAS,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC;IAK1C,yDAAyD;IACzD,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAItC,uEAAuE;IACvE,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMtD,qEAAqE;IACrE,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAKzD;AAKD,wBAAgB,gBAAgB,IAAI,YAAY,CAK/C"}

package/dist/catalogs/catalog-store.js

@@ -1,5 +1,18 @@
 import { MONSTERS, TILES, AUDIO, ITEMS, INVESTIGATORS, PUZZLES, TOKENS, } from './data/all-catalogs.js';
 import { TILE_GEOMETRY } from './data/tile-geometry.js';
+/** Maps lowercase catalog pack IDs to Valkyrie's case-sensitive pack IDs */
+export const PACK_ID_MAP = {
+    base: 'MoMBase',
+    btt: 'BtT',
+    hj: 'HJ',
+    pots: 'PotS',
+    soa: 'SoA',
+    sot: 'SoT',
+};
+/** Convert a catalog pack ID (lowercase) to Valkyrie's case-sensitive pack ID */
+export function getValkyriePackId(catalogPack) {
+    return PACK_ID_MAP[catalogPack] ?? catalogPack;
+}
 export class CatalogStore {
     entries;
     byId;
@@ -66,6 +79,24 @@ export class CatalogStore {
         const source = type ? (this.byType.get(type) ?? []) : this.entries;
         return new Set(source.map(e => e.id));
     }
+    /** Get the Valkyrie pack ID for a catalog pack string */
+    getPackId(catalogPack) {
+        return getValkyriePackId(catalogPack);
+    }
+    /** Look up a tile side's pack from catalog, return Valkyrie pack ID */
+    getPackForTileSide(tileId) {
+        const entry = this.byId.get(tileId);
+        if (!entry || entry.type !== 'tile')
+            return undefined;
+        return getValkyriePackId(entry.pack);
+    }
+    /** Look up a monster's pack from catalog, return Valkyrie pack ID */
+    getPackForMonster(monsterId) {
+        const entry = this.byId.get(monsterId);
+        if (!entry || entry.type !== 'monster')
+            return undefined;
+        return getValkyriePackId(entry.pack);
+    }
 }
 /** Shared singleton instance — avoids re-indexing 846 entries multiple times */
 let sharedInstance = null;

package/dist/catalogs/catalog-store.js.map

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

package/dist/diagnostics/bug-report-builder.d.ts

@@ -0,0 +1,5 @@
+import type { SessionTrace } from './session-trace.js';
+import type { ScenarioModel } from '../model/scenario-model.js';
+import type { BugReportOptions, BugReportResult } from './types.js';
+export declare function buildBugReport(trace: SessionTrace, model: ScenarioModel | null, options?: BugReportOptions): Promise<BugReportResult>;
+//# sourceMappingURL=bug-report-builder.d.ts.map

package/dist/diagnostics/bug-report-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bug-report-builder.d.ts","sourceRoot":"","sources":["../../src/diagnostics/bug-report-builder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAqBpE,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,EACnB,KAAK,EAAE,aAAa,GAAG,IAAI,EAC3B,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA8G1B"}

package/dist/diagnostics/bug-report-builder.js

@@ -0,0 +1,112 @@
+import archiver from 'archiver';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { validateScenario } from '../validation/validator.js';
+import { getValkyrieLogPath, readLogTail } from './valkyrie-log-finder.js';
+const README_TEXT = `Valkyrie MoM MCP - Bug Report
+==============================
+
+This ZIP was generated by the export_bug_report tool.
+
+Contents:
+  report.json        - Session metadata and trace of MCP tool calls
+  validation.json    - Validation results at time of export
+  scenario/          - Scenario INI files (if a scenario was loaded)
+  valkyrie-logs/     - Valkyrie Player.log tail (if found)
+
+How to file an issue:
+  1. Go to https://github.com/thijs-hakkenberg/ValkyrieMCP/issues/new
+  2. Paste the issue template from the tool output
+  3. Drag and drop this ZIP file into the issue
+`;
+export async function buildBugReport(trace, model, options = {}) {
+    const { outputDir = os.tmpdir(), includeScenario = true, includeValkyrieLog = true, } = options;
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const zipName = `valkyrie-bug-report-${timestamp}.zip`;
+    const zipPath = path.join(outputDir, zipName);
+    // Build ZIP
+    const output = fs.createWriteStream(zipPath);
+    const archive = archiver('zip');
+    const done = new Promise((resolve, reject) => {
+        output.on('close', resolve);
+        archive.on('error', reject);
+    });
+    archive.pipe(output);
+    // report.json
+    const metadata = trace.getMetadata();
+    const entries = trace.getEntries();
+    const report = {
+        metadata,
+        traceEntries: entries,
+        exportedAt: new Date().toISOString(),
+    };
+    archive.append(JSON.stringify(report, null, 2), { name: 'report.json' });
+    // validation.json
+    let validationData = { errors: [], warnings: [], note: 'No scenario loaded' };
+    if (model) {
+        const results = validateScenario(model);
+        const errors = results.filter(r => r.severity === 'error');
+        const warnings = results.filter(r => r.severity === 'warning');
+        validationData = { errors, warnings };
+    }
+    archive.append(JSON.stringify(validationData, null, 2), { name: 'validation.json' });
+    // README.txt
+    archive.append(README_TEXT, { name: 'README.txt' });
+    // scenario/ directory
+    if (includeScenario && model?.scenarioDir && fs.existsSync(model.scenarioDir)) {
+        const scenarioFiles = fs.readdirSync(model.scenarioDir);
+        for (const file of scenarioFiles) {
+            const filePath = path.join(model.scenarioDir, file);
+            if (fs.statSync(filePath).isFile()) {
+                archive.file(filePath, { name: `scenario/${file}` });
+            }
+        }
+    }
+    // valkyrie-logs/
+    if (includeValkyrieLog) {
+        const logPath = getValkyrieLogPath();
+        if (logPath) {
+            const logContent = await readLogTail(logPath);
+            if (logContent) {
+                archive.append(logContent, { name: 'valkyrie-logs/Player.log' });
+            }
+        }
+    }
+    await archive.finalize();
+    await done;
+    // Build issue template
+    const errorEntries = trace.getErrorEntries();
+    const allEntries = trace.getEntries();
+    const errorCount = errorEntries.length;
+    const validationErrors = model ? validateScenario(model).filter(r => r.severity === 'error').length : 0;
+    const validationWarnings = model ? validateScenario(model).filter(r => r.severity === 'warning').length : 0;
+    const recentErrors = errorEntries.slice(-5).map(e => `- \`${e.tool}\` (${e.timestamp}): ${e.resultSummary.replace(/^Error:\s*/, '').slice(0, 100)}`).join('\n');
+    const issueTitle = `[Bug Report] MCP session with ${allEntries.length} tool calls, ${errorCount} errors`;
+    const issueBody = `## Bug Report
+
+**Environment:**
+- MCP Server: v${metadata.serverVersion}
+- Node: ${metadata.nodeVersion}
+- Platform: ${metadata.platform} ${metadata.arch}
+
+**Session Summary:**
+- Tool calls: ${allEntries.length}
+- Errors: ${errorCount}
+- Validation: ${validationErrors} errors, ${validationWarnings} warnings
+
+## What happened?
+<!-- Describe what you expected vs. what actually happened -->
+
+## Steps to reproduce
+<!-- The session trace is in the attached ZIP -->
+
+${recentErrors ? `## Recent errors from session trace\n${recentErrors}\n` : ''}
+## Attachments
+<!-- Drag and drop the .zip bug report file here -->
+`;
+    const escapedTitle = issueTitle.replace(/"/g, '\\"');
+    const ghCommand = `gh issue create --repo thijs-hakkenberg/ValkyrieMCP --title "${escapedTitle}" --body-file -`;
+    return { zipPath, issueTitle, issueBody, ghCommand };
+}
+//# sourceMappingURL=bug-report-builder.js.map

package/dist/diagnostics/bug-report-builder.js.map

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

package/dist/diagnostics/ring-buffer.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Fixed-capacity circular buffer. When full, new items overwrite the oldest.
+ */
+export declare class RingBuffer<T> {
+    private buffer;
+    private head;
+    private count;
+    private readonly capacity;
+    constructor(capacity: number);
+    push(item: T): void;
+    get size(): number;
+    /** Returns entries oldest-first */
+    toArray(): T[];
+    clear(): void;
+}
+//# sourceMappingURL=ring-buffer.d.ts.map

package/dist/diagnostics/ring-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ring-buffer.d.ts","sourceRoot":"","sources":["../../src/diagnostics/ring-buffer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,QAAQ,EAAE,MAAM;IAK5B,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAQnB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,mCAAmC;IACnC,OAAO,IAAI,CAAC,EAAE;IAWd,KAAK,IAAI,IAAI;CAKd"}

package/dist/diagnostics/ring-buffer.js

@@ -0,0 +1,41 @@
+/**
+ * Fixed-capacity circular buffer. When full, new items overwrite the oldest.
+ */
+export class RingBuffer {
+    buffer;
+    head = 0; // next write position
+    count = 0;
+    capacity;
+    constructor(capacity) {
+        this.capacity = capacity;
+        this.buffer = new Array(capacity);
+    }
+    push(item) {
+        this.buffer[this.head] = item;
+        this.head = (this.head + 1) % this.capacity;
+        if (this.count < this.capacity) {
+            this.count++;
+        }
+    }
+    get size() {
+        return this.count;
+    }
+    /** Returns entries oldest-first */
+    toArray() {
+        if (this.count === 0)
+            return [];
+        const result = [];
+        const start = this.count < this.capacity ? 0 : this.head;
+        for (let i = 0; i < this.count; i++) {
+            const idx = (start + i) % this.capacity;
+            result.push(this.buffer[idx]);
+        }
+        return result;
+    }
+    clear() {
+        this.buffer = new Array(this.capacity);
+        this.head = 0;
+        this.count = 0;
+    }
+}
+//# sourceMappingURL=ring-buffer.js.map

package/dist/diagnostics/ring-buffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ring-buffer.js","sourceRoot":"","sources":["../../src/diagnostics/ring-buffer.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,UAAU;IACb,MAAM,CAAuB;IAC7B,IAAI,GAAG,CAAC,CAAC,CAAG,sBAAsB;IAClC,KAAK,GAAG,CAAC,CAAC;IACD,QAAQ,CAAS;IAElC,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,CAAgB,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,CAAC,IAAO;QACV,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC5C,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,mCAAmC;IACnC,OAAO;QACL,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAChC,MAAM,MAAM,GAAQ,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACzD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,GAAG,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAM,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,IAAI,KAAK,CAAgB,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;QACd,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;CACF"}

package/dist/diagnostics/session-trace.d.ts

@@ -0,0 +1,19 @@
+import type { TraceEntry, SessionMetadata } from './types.js';
+/** Omit timestamp — it's auto-filled by record() */
+type TraceInput = Omit<TraceEntry, 'timestamp'>;
+/**
+ * In-memory session trace. Records MCP tool calls in a ring buffer.
+ * Nothing is written to disk until explicitly exported.
+ */
+export declare class SessionTrace {
+    private buffer;
+    private metadata;
+    constructor(serverVersion: string, capacity?: number);
+    record(input: TraceInput): void;
+    getEntries(): TraceEntry[];
+    getErrorEntries(): TraceEntry[];
+    getMetadata(): SessionMetadata;
+    updateScenario(dir: string): void;
+}
+export {};
+//# sourceMappingURL=session-trace.d.ts.map

package/dist/diagnostics/session-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-trace.d.ts","sourceRoot":"","sources":["../../src/diagnostics/session-trace.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI9D,oDAAoD;AACpD,KAAK,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAEhD;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,aAAa,EAAE,MAAM,EAAE,QAAQ,SAAmB;IAW9D,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAO/B,UAAU,IAAI,UAAU,EAAE;IAI1B,eAAe,IAAI,UAAU,EAAE;IAI/B,WAAW,IAAI,eAAe;IAI9B,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;CAGlC"}

package/dist/diagnostics/session-trace.js

@@ -0,0 +1,40 @@
+import * as os from 'node:os';
+import { RingBuffer } from './ring-buffer.js';
+const DEFAULT_CAPACITY = 200;
+/**
+ * In-memory session trace. Records MCP tool calls in a ring buffer.
+ * Nothing is written to disk until explicitly exported.
+ */
+export class SessionTrace {
+    buffer;
+    metadata;
+    constructor(serverVersion, capacity = DEFAULT_CAPACITY) {
+        this.buffer = new RingBuffer(capacity);
+        this.metadata = {
+            serverVersion,
+            nodeVersion: process.version,
+            platform: os.platform(),
+            arch: os.arch(),
+            startedAt: new Date().toISOString(),
+        };
+    }
+    record(input) {
+        this.buffer.push({
+            ...input,
+            timestamp: new Date().toISOString(),
+        });
+    }
+    getEntries() {
+        return this.buffer.toArray();
+    }
+    getErrorEntries() {
+        return this.buffer.toArray().filter(e => e.isError);
+    }
+    getMetadata() {
+        return { ...this.metadata };
+    }
+    updateScenario(dir) {
+        this.metadata.scenarioDir = dir;
+    }
+}
+//# sourceMappingURL=session-trace.js.map

package/dist/diagnostics/session-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-trace.js","sourceRoot":"","sources":["../../src/diagnostics/session-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAK7B;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,MAAM,CAAyB;IAC/B,QAAQ,CAAkB;IAElC,YAAY,aAAqB,EAAE,QAAQ,GAAG,gBAAgB;QAC5D,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAa,QAAQ,CAAC,CAAC;QACnD,IAAI,CAAC,QAAQ,GAAG;YACd,aAAa;YACb,WAAW,EAAE,OAAO,CAAC,OAAO;YAC5B,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE;YACvB,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE;YACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,KAAiB;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;YACf,GAAG,KAAK;YACR,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,WAAW;QACT,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED,cAAc,CAAC,GAAW;QACxB,IAAI,CAAC,QAAQ,CAAC,WAAW,GAAG,GAAG,CAAC;IAClC,CAAC;CACF"}

package/dist/diagnostics/tool-interceptor.d.ts

@@ -0,0 +1,11 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { SessionTrace } from './session-trace.js';
+/** Truncate string values in args to prevent huge trace entries */
+export declare function sanitizeArgs(args: Record<string, unknown> | undefined): Record<string, unknown>;
+/**
+ * Wrap all registered tool handlers to record calls to the session trace.
+ * Must be called after all tools are registered. Skips `export_bug_report`
+ * to avoid circular recording.
+ */
+export declare function wrapAllTools(server: McpServer, trace: SessionTrace): void;
+//# sourceMappingURL=tool-interceptor.d.ts.map

package/dist/diagnostics/tool-interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-interceptor.d.ts","sourceRoot":"","sources":["../../src/diagnostics/tool-interceptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKvD,mEAAmE;AACnE,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAW/F;AAgBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAkCzE"}

package/dist/diagnostics/tool-interceptor.js

@@ -0,0 +1,73 @@
+const MAX_ARG_LENGTH = 200;
+const MAX_RESULT_LENGTH = 500;
+/** Truncate string values in args to prevent huge trace entries */
+export function sanitizeArgs(args) {
+    if (!args || typeof args !== 'object')
+        return {};
+    const result = {};
+    for (const [key, value] of Object.entries(args)) {
+        if (typeof value === 'string' && value.length > MAX_ARG_LENGTH) {
+            result[key] = value.slice(0, MAX_ARG_LENGTH) + '...';
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+function summarizeResult(result) {
+    try {
+        const text = result?.content?.[0]?.text;
+        if (typeof text === 'string') {
+            return text.length > MAX_RESULT_LENGTH
+                ? text.slice(0, MAX_RESULT_LENGTH) + '...'
+                : text;
+        }
+        return JSON.stringify(result).slice(0, MAX_RESULT_LENGTH);
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+/**
+ * Wrap all registered tool handlers to record calls to the session trace.
+ * Must be called after all tools are registered. Skips `export_bug_report`
+ * to avoid circular recording.
+ */
+export function wrapAllTools(server, trace) {
+    const tools = server._registeredTools;
+    if (!tools || typeof tools !== 'object')
+        return;
+    for (const [name, entry] of Object.entries(tools)) {
+        if (name === 'export_bug_report')
+            continue;
+        const originalHandler = entry.handler;
+        entry.handler = async (...handlerArgs) => {
+            const start = Date.now();
+            try {
+                const result = await originalHandler(...handlerArgs);
+                const durationMs = Date.now() - start;
+                trace.record({
+                    tool: name,
+                    args: sanitizeArgs(handlerArgs[0]),
+                    resultSummary: summarizeResult(result),
+                    isError: !!result?.isError,
+                    durationMs,
+                });
+                return result;
+            }
+            catch (err) {
+                const durationMs = Date.now() - start;
+                trace.record({
+                    tool: name,
+                    args: sanitizeArgs(handlerArgs[0]),
+                    resultSummary: `Error: ${err?.message ?? String(err)}`,
+                    isError: true,
+                    durationMs,
+                });
+                throw err;
+            }
+        };
+    }
+}
+//# sourceMappingURL=tool-interceptor.js.map

package/dist/diagnostics/tool-interceptor.js.map

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

package/dist/diagnostics/types.d.ts

@@ -0,0 +1,51 @@
+/** A single trace entry recording one MCP tool call */
+export interface TraceEntry {
+    /** Tool name that was called */
+    tool: string;
+    /** Sanitized arguments (long strings truncated) */
+    args: Record<string, unknown>;
+    /** Result summary (truncated) */
+    resultSummary: string;
+    /** Whether the call resulted in an error */
+    isError: boolean;
+    /** Duration in milliseconds */
+    durationMs: number;
+    /** ISO 8601 timestamp */
+    timestamp: string;
+}
+/** Session-level metadata captured at startup */
+export interface SessionMetadata {
+    /** MCP server version */
+    serverVersion: string;
+    /** Node.js version */
+    nodeVersion: string;
+    /** OS platform */
+    platform: string;
+    /** OS architecture */
+    arch: string;
+    /** Session start time (ISO 8601) */
+    startedAt: string;
+    /** Currently loaded scenario directory, if any */
+    scenarioDir?: string;
+}
+/** Options for building a bug report */
+export interface BugReportOptions {
+    /** Directory to write the ZIP file to (defaults to os.tmpdir()) */
+    outputDir?: string;
+    /** Include scenario INI files in the ZIP (default true) */
+    includeScenario?: boolean;
+    /** Include Valkyrie Player.log in the ZIP (default true) */
+    includeValkyrieLog?: boolean;
+}
+/** Result returned by buildBugReport */
+export interface BugReportResult {
+    /** Absolute path to the generated ZIP file */
+    zipPath: string;
+    /** Suggested GitHub issue title */
+    issueTitle: string;
+    /** Pre-filled GitHub issue body (markdown) */
+    issueBody: string;
+    /** Ready-to-run gh CLI command */
+    ghCommand: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/diagnostics/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/diagnostics/types.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,iCAAiC;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,yBAAyB;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,sBAAsB;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,kDAAkD;IAClD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wCAAwC;AACxC,MAAM,WAAW,gBAAgB;IAC/B,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2DAA2D;IAC3D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/diagnostics/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/diagnostics/types.js.map

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

package/dist/diagnostics/valkyrie-log-finder.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Get the expected Valkyrie Player.log path for a given platform.
+ * Mirrors Unity's log locations with Company=NA, Product=Valkyrie.
+ */
+export declare function getValkyrieLogPath(platform?: string): string | undefined;
+/**
+ * Read the tail of a log file. Returns undefined if the file doesn't exist.
+ * @param logPath Absolute path to the log file
+ * @param maxBytes Maximum bytes to read from the end (default 1MB)
+ */
+export declare function readLogTail(logPath: string, maxBytes?: number): Promise<string | undefined>;
+//# sourceMappingURL=valkyrie-log-finder.d.ts.map

package/dist/diagnostics/valkyrie-log-finder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valkyrie-log-finder.d.ts","sourceRoot":"","sources":["../../src/diagnostics/valkyrie-log-finder.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgBxE;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAc,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAetG"}

package/dist/diagnostics/valkyrie-log-finder.js

@@ -0,0 +1,46 @@
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import * as path from 'node:path';
+/**
+ * Get the expected Valkyrie Player.log path for a given platform.
+ * Mirrors Unity's log locations with Company=NA, Product=Valkyrie.
+ */
+export function getValkyrieLogPath(platform) {
+    const p = platform ?? os.platform();
+    const home = os.homedir();
+    switch (p) {
+        case 'darwin':
+            return path.join(home, 'Library', 'Logs', 'Unity', 'Player.log');
+        case 'win32': {
+            const localAppData = process.env.LOCALAPPDATA ?? path.join(home, 'AppData', 'Local');
+            return path.join(localAppData, '..', 'LocalLow', 'NA', 'Valkyrie', 'Player.log');
+        }
+        case 'linux':
+            return path.join(home, '.config', 'unity3d', 'NA', 'Valkyrie', 'Player.log');
+        default:
+            return undefined;
+    }
+}
+/**
+ * Read the tail of a log file. Returns undefined if the file doesn't exist.
+ * @param logPath Absolute path to the log file
+ * @param maxBytes Maximum bytes to read from the end (default 1MB)
+ */
+export async function readLogTail(logPath, maxBytes = 1024 * 1024) {
+    try {
+        const stat = fs.statSync(logPath);
+        if (stat.size <= maxBytes) {
+            return fs.readFileSync(logPath, 'utf-8');
+        }
+        // Read last maxBytes from file
+        const fd = fs.openSync(logPath, 'r');
+        const buffer = Buffer.alloc(maxBytes);
+        fs.readSync(fd, buffer, 0, maxBytes, stat.size - maxBytes);
+        fs.closeSync(fd);
+        return buffer.toString('utf-8');
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=valkyrie-log-finder.js.map

package/dist/diagnostics/valkyrie-log-finder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"valkyrie-log-finder.js","sourceRoot":"","sources":["../../src/diagnostics/valkyrie-log-finder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAiB;IAClD,MAAM,CAAC,GAAG,QAAQ,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAE1B,QAAQ,CAAC,EAAE,CAAC;QACV,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC;QACnE,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACrF,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QACnF,CAAC;QACD,KAAK,OAAO;YACV,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;QAC/E;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAe,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI;IACvE,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAClC,IAAI,IAAI,CAAC,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC1B,OAAO,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC3C,CAAC;QACD,+BAA+B;QAC/B,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACtC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC;QAC3D,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACjB,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}