qnce-engine 1.3.2 → 1.4.1

package/README.md

@@ -2,22 +2,65 @@
 
 **Quantum Narrative Convergence Engine** - A framework-agnostic TypeScript library for creating interactive narrative experiences with quantum-inspired mechanics.
 
-> **🚀 Latest v1.3.1 (Import & Persistence):** New `qnce-import` CLI (Custom JSON, Twison with tags→`meta.tags`, experimental Ink), persistence adapters (Memory, LocalStorage, SessionStorage, File, IndexedDB), and `qnce-play` support for storage backends and non-interactive runs.
+> **🚀 Latest v1.4.0 (Adaptive Performance & Quantum Primitives):** Adaptive perf pipeline (dynamic batch sizing, backoff, guarded retry, smoothed p95), expanded telemetry metrics, structured logging, memory optimizations, and first experimental quantum primitives (Entangler, Phase, Measurement). Previous 1.3.x delivered import & persistence foundations.
 
 [![npm version](https://badge.fury.io/js/qnce-engine.svg)](https://badge.fury.io/js/qnce-engine)
+[![npm downloads](https://img.shields.io/npm/d18m/qnce-engine.svg)](https://www.npmjs.com/package/qnce-engine)
 [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
 > New: Lightweight, privacy-safe telemetry (opt-in). CLI now supports `--telemetry` and `--telemetry-report`, with p50/p95 batch send latency. See the wiki: [Analytics & Telemetry](https://github.com/ByteSower/qnce-engine/blob/main/wiki/Analytics-and-Telemetry.md).
 
+## TL;DR Quickstart
+
+```bash
+# Install
+npm install qnce-engine
+
+# Play the demo story (from this repo)
+node examples/quickstart-demo.js
+
+# Live performance monitor (global CLI)
+npm install -g qnce-engine
+qnce-perf dashboard
+qnce-perf stream 1000 | jq '.'   # NDJSON streaming (optional)
+```
+
+New to coding? Start here:
+- Beginner Guide (no code): wiki/Beginner-Guide.md
+- Getting Started: wiki/Getting-Started.md
+
+## Documentation & Guides
+
+- Getting Started (wiki)
+- Analytics & Telemetry (wiki)
+- Branching Guide (wiki)
+- Performance Tuning (wiki)
+- Error Handling & Debug (docs/ERROR-HANDLING-AND-DEBUG.md)
+- Adapter Lifecycle (docs/ADAPTER-LIFECYCLE.md)
+- Deprecation Policy (docs/DEPRECATION-POLICY.md)
+
+## Public Roadmap
+
+High-level, non-sensitive roadmap: [`docs/PUBLIC_ROADMAP.md`](./docs/PUBLIC_ROADMAP.md). Internal sprint artifacts are intentionally excluded from the repository for security/privacy.
+
+
 ## Core Concepts
 
 - **Superposition:** Multiple narrative outcomes exist simultaneously until a choice is made
 - **Collapse:** Player choices "collapse" the narrative to a specific path, updating state and flags
 - **Entanglement:** Early decisions affect later outcomes, enabling complex, interconnected stories
 
+New to coding? See the no-code [Beginner Guide](wiki/Beginner-Guide.md) to create and play a story from the terminal.
+
 ## ✨ Current Features (v1.3.0)
 
+### 🧪 Experimental (Opt-in)
+Early quantum helpers are available behind feature flags. They are off by default and safe to ignore. See the wiki for details and examples:
+
+- Experimental APIs: https://github.com/ByteSower/qnce-engine/blob/main/wiki/API-Reference.md#-experimental-opt-in
+- Release Notes (Unreleased): https://github.com/ByteSower/qnce-engine/blob/main/wiki/Release-Notes.md#unreleased
+
 ### 💾 State Persistence & Checkpoints
 - **Complete save/load system** with data integrity validation
 - **Lightweight checkpoints** for undo/redo functionality
@@ -53,6 +96,7 @@
 - **Background processing** for non-blocking operations
 - **Hot-reload capabilities** with <3.5ms story updates
 - **Comprehensive monitoring** with built-in CLI tools
+ - **Adaptive perf pipeline (beta)** with dynamic batch sizing & backoff
 
 #### Basic Flag-Based Conditions
 
@@ -215,6 +259,10 @@ engine.clearConditionEvaluator();
 - **Expression Caching:** Conditions are compiled once and cached for subsequent evaluations
 - **Safe Evaluation:** All expressions are sanitized to prevent code injection
 - **Minimal Overhead:** Choice filtering adds <1ms to `getAvailableChoices()` calls
+
+## Examples
+
+- Opt‑in quantum helpers (FeatureFlags + attachQuantumFeatures): `examples/quantum-integration-demo.ts`
 - **Error Isolation:** Invalid conditions don't affect other choices in the same node
 
 ### ⚡ Performance Infrastructure
@@ -223,6 +271,7 @@ engine.clearConditionEvaluator();
 - **🔥 Hot-Reload:** <3.5ms live story updates with delta patching
 - **📊 Real-time Profiling:** Comprehensive event instrumentation and analysis
 - **🖥️ Live Monitoring:** `qnce-perf` CLI dashboard with performance alerts
+ - **🧠 Adaptive Flush (Beta):** Dynamic telemetry/perf batch sizing + rejection backoff for smoother throughput
 
 ### Performance Dashboard
 ```bash
@@ -234,10 +283,67 @@ qnce-perf live 1000
 
 # Export performance data
 qnce-perf export > performance-report.json
+
+# Stream NDJSON (metrics+thread stats per line)
+qnce-perf stream 1000 | jq '.'
 ```
 
 **[📚 Complete Performance Guide →](docs/PERFORMANCE.md)**
 
+### Adaptive Performance (Beta)
+
+The PerfReporter now implements adaptive heuristics to optimize background flush behavior.
+
+Key components:
+
+1. Exponential Backoff (R2)
+  - Triggered after consecutive flush dispatch rejections (e.g. thread pool queue full)
+  - Delay doubles each rejection (base 20ms, cap 500ms)
+  - Prevents tight retry loops and reduces queue pressure
+
+2. Dynamic Batch Sizing (R6)
+  - Starts from a configured base batch size
+  - Upscales when: backlog is large AND p95 send latency remains low (<25ms or <50ms tiers)
+    * Low latency + backlog > 2× base ⇒ scale toward up to ~3× base
+    * Low latency + backlog > 4× base ⇒ scale toward up to ~4× base (ceiling)
+  - Downscales aggressively when rejection streak ≥2 (divides batch by streak factor, never below 10)
+  - Exposed via `lastEffectiveBatchSize` in flush metrics snapshot
+
+3. Rejection Rate Metric
+  - `rejectionRate` (0–1) = rejectedFlushes / (accepted + rejected)
+  - Fast signal for sustained downstream pressure; enables dashboard or future auto-tuning hooks
+
+4. Debug Accessor
+  - `__getInternalPerfDebug()` includes: `consecutiveRejects`, `backoffDelayMs`, `nextAllowedFlushTime`, `lastEffectiveBatchSize`
+
+5. Environment Flag
+  - Set `QNCE_SUPPRESS_PERF_WARN=1` to silence repetitive flush failure warnings (e.g. in CI)
+  - Set `QNCE_DISABLE_ADAPTIVE_BATCH=1` to force fixed `batchSize` (disables dynamic scaling but keeps backoff)
+
+Status & Stability:
+- Marked `@beta` and subject to heuristic tuning (thresholds & scaling formula may evolve)
+- Safe to consume metrics (`rejectionRate`, `lastEffectiveBatchSize`, `adaptiveEnabled`) for observability, not yet for strict alert SLAs
+
+Example (inspection inside tests / diagnostics):
+```ts
+import { getPerfReporter } from 'qnce-engine/performance';
+
+const reporter = getPerfReporter();
+const snapshot = reporter.getFlushMetrics();
+console.log(snapshot.rejectionRate, snapshot.lastEffectiveBatchSize, snapshot.adaptiveEnabled);
+
+// Internal (beta) debug details
+// @ts-expect-error internal accessor
+console.log(reporter.__getInternalPerfDebug());
+
+// Force fixed batch sizing (example)
+// (Re-create reporter before use to apply config/env values)
+// const fixed = getPerfReporter({ batchSize: 100, disableAdaptiveBatch: true });
+// Snapshot field `adaptiveEnabled` will be false when dynamic sizing disabled.
+```
+
+If you experiment with tuning, please open an issue with: base batch size, average backlog, p95 latency trajectory, and observed rejectionRate.
+
 ## Installation
 
 ```bash
@@ -580,7 +686,7 @@ const engine = createQNCEEngine(storyData, {}, true, {
 // Monitor performance in real-time with CLI dashboard
 ```
 
-**📖 Complete Performance Guide:** [docs/PERFORMANCE_GUIDE.md](docs/PERFORMANCE_GUIDE.md)
+**📖 Complete Performance Guide:** [docs/PERFORMANCE.md](docs/PERFORMANCE.md)
 
 ## Core API
 
@@ -1078,6 +1184,17 @@ npm run build:watch
 npm run lint
 ```
 
+## 🔒 Security
+
+QNCE Engine follows security best practices and provides guidance for secure usage:
+
+- **Vulnerability Reporting**: Please report security vulnerabilities privately via [GitHub Security Advisories](https://github.com/ByteSower/qnce-engine/security/advisories/new)
+- **Supported Versions**: Security updates are provided for current stable versions (1.3.x) and previous major version (1.2.x)
+- **Input Validation**: Always validate story data and user inputs from untrusted sources
+- **State Security**: Use QNCE's built-in integrity validation when loading serialized states
+
+For detailed security guidelines, see our [Security Policy](SECURITY.md).
+
 ## License
 
 MIT - See LICENSE file for details.
@@ -1220,3 +1337,18 @@ try {
   }
 }
 ```
+
+    ## 🧪 Experimental (Opt-in)
+
+    These are off by default and safe to import. Enable with `FeatureFlags` when ready to experiment.
+
+    ```ts
+    import { attachQuantumFeatures, FeatureFlags, Phase } from 'qnce-engine';
+    const engine = createQNCEEngine(story);
+    const q = attachQuantumFeatures(engine, new FeatureFlags({ 'quantum.phases': true, 'quantum.entanglement': true }));
+    const alpha = new Phase('alpha', ({ flags }) => !!flags.unlockAlpha);
+    q.isPhaseActive(alpha);
+    q.entangle(e => e.bind('a', 'b', v => Number(v) * 2));
+    ```
+
+    APIs: `FeatureFlags`, `Phase`, `Entangler`, `attachQuantumFeatures` (all `@experimental`).

package/dist/adapters/contracts.d.ts

@@ -11,7 +11,7 @@ export interface StoryAdapter {
     detect?(source: unknown): boolean;
     mapIds?(storyData: StoryData, strategy?: 'deterministic' | 'passthrough'): StoryData;
 }
-export interface SaveEnvelope<TPayload = any> {
+export interface SaveEnvelope<TPayload = unknown> {
     version: number;
     storyId: string;
     storyVersion: string;

package/dist/adapters/contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/adapters/contracts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5E,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACjD,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAClC,MAAM,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,SAAS,CAAC;CACtF;AAGD,MAAM,WAAW,YAAY,CAAC,QAAQ,GAAG,GAAG;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,QAAQ,CAAC;CACnB"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/adapters/contracts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5E,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACjD,MAAM,CAAC,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAClC,MAAM,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,eAAe,GAAG,aAAa,GAAG,SAAS,CAAC;CACtF;AAGD,MAAM,WAAW,YAAY,CAAC,QAAQ,GAAG,OAAO;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,QAAQ,CAAC;CACnB"}

package/dist/adapters/storage/MockAdapters.d.ts

@@ -0,0 +1,89 @@
+import type { StorageAdapter, SerializedState, PersistenceResult, SerializationOptions, LoadOptions } from '../../engine/types';
+export interface FailingAdapterOptions {
+    failSaves?: boolean;
+    failLoads?: boolean;
+    failDeletes?: boolean;
+    delayMs?: number;
+}
+/** Adapter that can be configured to fail certain operations */
+export declare class FailingStorageAdapter implements StorageAdapter {
+    private opts;
+    constructor(opts?: FailingAdapterOptions);
+    save(key: string, data: SerializedState, _options?: SerializationOptions): Promise<PersistenceResult>;
+    load(key: string, _options?: LoadOptions): Promise<SerializedState | null>;
+    delete(key: string): Promise<boolean>;
+    list(): Promise<string[]>;
+    exists(key: string): Promise<boolean>;
+    getStats(): Promise<{
+        totalSize: number;
+        keyCount: number;
+        [k: string]: unknown;
+    }>;
+    clear(): Promise<boolean>;
+}
+export interface RetryAdapterOptions {
+    failCount: number;
+    maxAttempts?: number;
+    delayMs?: number;
+}
+/** Adapter that fails first N saves then succeeds, to exercise retry logic (future). */
+export declare class FlakySaveAdapter implements StorageAdapter {
+    private opts;
+    private attempts;
+    constructor(opts: RetryAdapterOptions);
+    save(key: string, data: SerializedState, _options?: SerializationOptions): Promise<PersistenceResult>;
+    load(key: string): Promise<SerializedState | null>;
+    delete(key: string): Promise<boolean>;
+    list(): Promise<string[]>;
+    exists(key: string): Promise<boolean>;
+    getStats(): Promise<{
+        totalSize: number;
+        keyCount: number;
+        [k: string]: unknown;
+    }>;
+    clear(): Promise<boolean>;
+}
+/** Adapter introducing artificial latency without failures. */
+export declare class SlowStorageAdapter implements StorageAdapter {
+    private delayMs;
+    constructor(delayMs?: number);
+    private lag;
+    save(key: string, data: SerializedState): Promise<PersistenceResult>;
+    load(key: string): Promise<SerializedState | null>;
+    delete(key: string): Promise<boolean>;
+    list(): Promise<string[]>;
+    exists(key: string): Promise<boolean>;
+    getStats(): Promise<{
+        totalSize: number;
+        keyCount: number;
+        [k: string]: unknown;
+    }>;
+    clear(): Promise<boolean>;
+}
+export interface TimeoutAdapterOptions {
+    timeoutFailCount: number;
+    resolveDelayMs?: number;
+    timeoutDelayMs?: number;
+}
+/**
+ * Adapter that simulates network timeouts for the first N save attempts by rejecting.
+ * After those attempts it succeeds (optionally with a delay). Useful to exercise retry logic and telemetry attempts field.
+ */
+export declare class TimeoutSaveAdapter implements StorageAdapter {
+    private opts;
+    private attempt;
+    constructor(opts: TimeoutAdapterOptions);
+    private delay;
+    save(key: string, data: SerializedState): Promise<PersistenceResult>;
+    load(key: string): Promise<SerializedState | null>;
+    delete(key: string): Promise<boolean>;
+    list(): Promise<string[]>;
+    exists(key: string): Promise<boolean>;
+    getStats(): Promise<{
+        totalSize: number;
+        keyCount: number;
+        [k: string]: unknown;
+    }>;
+    clear(): Promise<boolean>;
+}
+//# sourceMappingURL=MockAdapters.d.ts.map

package/dist/adapters/storage/MockAdapters.d.ts.map

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

package/dist/adapters/storage/MockAdapters.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeoutSaveAdapter = exports.SlowStorageAdapter = exports.FlakySaveAdapter = exports.FailingStorageAdapter = void 0;
+/** Simple in-memory backing store shared across mock adapters */
+const store = new Map();
+/** Adapter that can be configured to fail certain operations */
+class FailingStorageAdapter {
+    opts;
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    async save(key, data, _options) {
+        if (this.opts.delayMs)
+            await new Promise(r => setTimeout(r, this.opts.delayMs));
+        if (this.opts.failSaves)
+            return { success: false, error: 'mock-save-failed' };
+        store.set(key, data);
+        return { success: true };
+    }
+    async load(key, _options) {
+        if (this.opts.delayMs)
+            await new Promise(r => setTimeout(r, this.opts.delayMs));
+        if (this.opts.failLoads)
+            throw new Error('mock-load-failed');
+        return store.get(key) ?? null;
+    }
+    async delete(key) {
+        if (this.opts.failDeletes)
+            return false;
+        return store.delete(key);
+    }
+    async list() { return [...store.keys()]; }
+    async exists(key) { return store.has(key); }
+    async getStats() { return { totalSize: store.size, keyCount: store.size }; }
+    async clear() { store.clear(); return true; }
+}
+exports.FailingStorageAdapter = FailingStorageAdapter;
+/** Adapter that fails first N saves then succeeds, to exercise retry logic (future). */
+class FlakySaveAdapter {
+    opts;
+    attempts = 0;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async save(key, data, _options) {
+        if (this.opts.delayMs)
+            await new Promise(r => setTimeout(r, this.opts.delayMs));
+        this.attempts++;
+        if (this.attempts <= this.opts.failCount)
+            return { success: false, error: 'transient-error' };
+        store.set(key, data);
+        return { success: true }; // attempts tracked internally; tests inspect adapter state if needed
+    }
+    async load(key) { return store.get(key) ?? null; }
+    async delete(key) { return store.delete(key); }
+    async list() { return [...store.keys()]; }
+    async exists(key) { return store.has(key); }
+    async getStats() { return { totalSize: store.size, keyCount: store.size }; }
+    async clear() { store.clear(); return true; }
+}
+exports.FlakySaveAdapter = FlakySaveAdapter;
+/** Adapter introducing artificial latency without failures. */
+class SlowStorageAdapter {
+    delayMs;
+    constructor(delayMs = 25) {
+        this.delayMs = delayMs;
+    }
+    async lag() { await new Promise(r => setTimeout(r, this.delayMs)); }
+    async save(key, data) { await this.lag(); store.set(key, data); return { success: true }; }
+    async load(key) { await this.lag(); return store.get(key) ?? null; }
+    async delete(key) { await this.lag(); return store.delete(key); }
+    async list() { await this.lag(); return [...store.keys()]; }
+    async exists(key) { await this.lag(); return store.has(key); }
+    async getStats() { return { totalSize: store.size, keyCount: store.size }; }
+    async clear() { await this.lag(); store.clear(); return true; }
+}
+exports.SlowStorageAdapter = SlowStorageAdapter;
+/**
+ * Adapter that simulates network timeouts for the first N save attempts by rejecting.
+ * After those attempts it succeeds (optionally with a delay). Useful to exercise retry logic and telemetry attempts field.
+ */
+class TimeoutSaveAdapter {
+    opts;
+    attempt = 0;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async delay(ms) { if (ms)
+        await new Promise(r => setTimeout(r, ms)); }
+    async save(key, data) {
+        this.attempt++;
+        if (this.attempt <= this.opts.timeoutFailCount) {
+            await this.delay(this.opts.timeoutDelayMs);
+            // Simulate a network timeout by throwing (engine converts to failed PersistenceResult)
+            throw new Error('timeout');
+        }
+        await this.delay(this.opts.resolveDelayMs);
+        store.set(key, data);
+        return { success: true };
+    }
+    async load(key) { return store.get(key) ?? null; }
+    async delete(key) { return store.delete(key); }
+    async list() { return [...store.keys()]; }
+    async exists(key) { return store.has(key); }
+    async getStats() { return { totalSize: store.size, keyCount: store.size }; }
+    async clear() { store.clear(); return true; }
+}
+exports.TimeoutSaveAdapter = TimeoutSaveAdapter;
+//# sourceMappingURL=MockAdapters.js.map

package/dist/adapters/storage/MockAdapters.js.map

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

package/dist/adapters/story/CustomJSONAdapter.d.ts

@@ -3,7 +3,7 @@ import type { StoryData } from '../../engine/core';
 import type { ValidationResult } from '../../engine/validation';
 export declare class CustomJSONAdapter implements StoryAdapter {
     load(source: string | object, options?: AdapterOptions): Promise<StoryData>;
-    validate(_storyData: StoryData): ValidationResult;
+    validate(): ValidationResult;
     detect(source: unknown): boolean;
 }
 export default CustomJSONAdapter;

package/dist/adapters/story/CustomJSONAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CustomJSONAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/story/CustomJSONAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,qBAAa,iBAAkB,YAAW,YAAY;IAC9C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IA+DjF,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,gBAAgB;IAIjD,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;CAYjC;AAED,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"CustomJSONAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/story/CustomJSONAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,qBAAa,iBAAkB,YAAW,YAAY;IAC9C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IA6FjF,QAAQ,IAAI,gBAAgB;IAI5B,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;CAYjC;AAED,eAAe,iBAAiB,CAAC"}

package/dist/adapters/story/CustomJSONAdapter.js

@@ -9,7 +9,7 @@ class CustomJSONAdapter {
         if (!data || typeof data !== 'object')
             throw new Error('Invalid story source');
         const initialNodeId = data.initialNodeId || 'start';
-        const nodes = data.nodes || [];
+        const nodes = data.nodes ?? [];
         if (!Array.isArray(nodes))
             throw new Error('Invalid nodes array');
         const normalized = {
@@ -17,10 +17,14 @@ class CustomJSONAdapter {
             nodes: nodes.map((n) => ({
                 id: String(n.id),
                 text: String(n.text ?? ''),
-                meta: n.meta && typeof n.meta === 'object'
-                    ? {
-                        tags: Array.isArray(n.meta.tags) ? n.meta.tags.map((t) => String(t)) : undefined
-                    }
+                meta: n && typeof n === 'object' && n.meta && typeof n.meta === 'object'
+                    ? (() => {
+                        const meta = n.meta;
+                        const tags = meta.tags;
+                        return {
+                            tags: Array.isArray(tags) ? tags.map((t) => String(t)) : undefined,
+                        };
+                    })()
                     : undefined,
                 choices: Array.isArray(n.choices)
                     ? n.choices.map((c) => ({
@@ -54,25 +58,27 @@ class CustomJSONAdapter {
             }
         }
         else {
-            // Lenient mode: warn on unknown keys
+            // Lenient mode: ignore unknown keys silently
             const allowedNodeKeys = new Set(['id', 'text', 'choices', 'meta']);
             const allowedChoiceKeys = new Set([
                 'text', 'nextNodeId', 'flagEffects', 'flagRequirements', 'timeRequirements', 'inventoryRequirements', 'enabled', 'condition'
             ]);
             for (const n of nodes) {
-                for (const k of Object.keys(n))
-                    if (!allowedNodeKeys.has(k))
-                        console.warn(`[QNCE] Unknown node key ignored: ${k}`);
-                for (const c of (n.choices || [])) {
-                    for (const ck of Object.keys(c))
-                        if (!allowedChoiceKeys.has(ck))
-                            console.warn(`[QNCE] Unknown choice key ignored: ${ck}`);
+                for (const k of Object.keys(n)) {
+                    // ignore unknown keys
+                    void (allowedNodeKeys.has(k));
+                }
+                for (const c of n.choices || []) {
+                    for (const ck of Object.keys(c)) {
+                        // ignore unknown keys
+                        void (allowedChoiceKeys.has(ck));
+                    }
                 }
             }
         }
         return normalized;
     }
-    validate(_storyData) {
+    validate() {
         return { isValid: true };
     }
     detect(source) {

package/dist/adapters/story/CustomJSONAdapter.js.map

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

package/dist/adapters/story/InkAdapter.d.ts

@@ -3,7 +3,7 @@ import type { StoryData } from '../../engine/core';
 import type { ValidationResult } from '../../engine/validation';
 export declare class InkAdapter implements StoryAdapter {
     load(source: string | object, options?: AdapterOptions): Promise<StoryData>;
-    validate(_storyData: StoryData): ValidationResult;
+    validate(): ValidationResult;
     detect(source: unknown): boolean;
 }
 export default InkAdapter;

package/dist/adapters/story/InkAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InkAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/story/InkAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,qBAAa,UAAW,YAAW,YAAY;IACvC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAwBjF,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,gBAAgB;IAEjD,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;CAKjC;AAED,eAAe,UAAU,CAAC"}
+{"version":3,"file":"InkAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/story/InkAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGhE,qBAAa,UAAW,YAAW,YAAY;IACvC,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IAuBjF,QAAQ,IAAI,gBAAgB;IAE5B,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;CAKjC;AAED,eAAe,UAAU,CAAC"}

package/dist/adapters/story/InkAdapter.js

@@ -9,23 +9,20 @@ class InkAdapter {
         const obj = typeof source === 'string' ? JSON.parse(source) : source;
         if (!obj || typeof obj !== 'object')
             throw new Error('Invalid Ink JSON');
-        // Heuristic: accept a simplified format { knots: { [name]: { text, choices: [{ text, target }] } } , start?: string }
-        const knots = obj.knots || {};
+        const knots = (obj.knots) || {};
         const idPrefix = options?.idPrefix ?? '';
-        if (!options?.experimentalInk && (obj.inkVersion || obj.listDefs || obj.inkState)) {
-            console.warn('[QNCE] Ink JSON appears complex; using minimal adapter. Pass experimentalInk to attempt richer import.');
-        }
+        // Silently proceed in non-experimental mode; no console noise in library code
         const nodes = Object.keys(knots).map((k) => ({
             id: `${idPrefix}${k}`,
-            text: String(knots[k].text ?? ''),
-            choices: Array.isArray(knots[k].choices)
-                ? knots[k].choices.map((c) => ({ text: String(c.text ?? ''), nextNodeId: `${idPrefix}${c.target}` }))
+            text: String(knots[k]?.text ?? ''),
+            choices: Array.isArray(knots[k]?.choices)
+                ? knots[k].choices.map((c) => ({ text: String(c.text ?? ''), nextNodeId: `${idPrefix}${String(c.target ?? '')}` }))
                 : [],
         }));
         const initialNodeId = `${idPrefix}${(obj.start ?? Object.keys(knots)[0] ?? 'start')}`;
         return { initialNodeId, nodes };
     }
-    validate(_storyData) { return { isValid: true }; }
+    validate() { return { isValid: true }; }
     detect(source) {
         let obj = source;
         if (typeof source === 'string') {
@@ -36,7 +33,7 @@ class InkAdapter {
                 return false;
             }
         }
-        return !!obj && typeof obj === 'object' && (!!obj.knots || !!obj.inkVersion);
+        return !!obj && typeof obj === 'object' && ('knots' in obj || 'inkVersion' in obj);
     }
 }
 exports.InkAdapter = InkAdapter;

package/dist/adapters/story/InkAdapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"InkAdapter.js","sourceRoot":"","sources":["../../../src/adapters/story/InkAdapter.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,sGAAsG;;;AAMtG,yEAAyE;AACzE,MAAa,UAAU;IACrB,KAAK,CAAC,IAAI,CAAC,MAAuB,EAAE,OAAwB;QAC1D,MAAM,GAAG,GAAQ,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1E,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAEzE,sHAAsH;QACtH,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;QAEzC,IAAI,CAAE,OAAe,EAAE,eAAe,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3F,OAAO,CAAC,IAAI,CAAC,wGAAwG,CAAC,CAAC;QACzH,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3C,EAAE,EAAE,GAAG,QAAQ,GAAG,CAAC,EAAE;YACrB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;YACjC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACtC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC1G,CAAC,CAAC,EAAE;SACP,CAAC,CAAC,CAAC;QAEJ,MAAM,aAAa,GAAG,GAAG,QAAQ,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,EAAE,CAAC;QACtF,OAAO,EAAE,aAAa,EAAE,KAAK,EAAe,CAAC;IAC/C,CAAC;IAED,QAAQ,CAAC,UAAqB,IAAsB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE/E,MAAM,CAAC,MAAe;QACpB,IAAI,GAAG,GAAQ,MAAM,CAAC;QACtB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAAC,IAAI,CAAC;gBAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,KAAK,CAAC;YAAC,CAAC;QAAC,CAAC;QAC7F,OAAO,CAAC,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC/E,CAAC;CACF;AAhCD,gCAgCC;AAED,kBAAe,UAAU,CAAC"}
+{"version":3,"file":"InkAdapter.js","sourceRoot":"","sources":["../../../src/adapters/story/InkAdapter.ts"],"names":[],"mappings":";AAAA,oDAAoD;AACpD,sGAAsG;;;AAMtG,yEAAyE;AACzE,MAAa,UAAU;IACrB,KAAK,CAAC,IAAI,CAAC,MAAuB,EAAE,OAAwB;QAC5D,MAAM,GAAG,GAA4B,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAkC,CAAC;QACzH,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QAI3E,MAAM,KAAK,GAAG,CAAE,GAAwC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;QACpE,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;QAEzC,8EAA8E;QAE9E,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3C,EAAE,EAAE,GAAG,QAAQ,GAAG,CAAC,EAAE;YACrB,IAAI,EAAE,MAAM,CAAE,KAAK,CAAC,CAAC,CAAsB,EAAE,IAAI,IAAI,EAAE,CAAC;YACxD,OAAO,EAAE,KAAK,CAAC,OAAO,CAAE,KAAK,CAAC,CAAC,CAAsB,EAAE,OAAO,CAAC;gBAC7D,CAAC,CAAG,KAAK,CAAC,CAAC,CAAU,CAAC,OAAuD,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,GAAG,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9K,CAAC,CAAC,EAAE;SACP,CAAC,CAAC,CAAC;QAEJ,MAAM,aAAa,GAAG,GAAG,QAAQ,GAAG,CAAG,GAA2B,CAAC,KAAgB,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,EAAE,CAAC;QAC3H,OAAO,EAAE,aAAa,EAAE,KAAK,EAAe,CAAC;IAC/C,CAAC;IAED,QAAQ,KAAuB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAE1D,MAAM,CAAC,MAAe;QACtB,IAAI,GAAG,GAAY,MAAM,CAAC;QACxB,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAAC,IAAI,CAAC;gBAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC;gBAAC,OAAO,KAAK,CAAC;YAAC,CAAC;QAAC,CAAC;QAC/F,OAAO,CAAC,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,OAAO,IAAI,GAAG,IAAI,YAAY,IAAI,GAAG,CAAC,CAAC;IACnF,CAAC;CACF;AA/BD,gCA+BC;AAED,kBAAe,UAAU,CAAC"}

package/dist/adapters/story/TwisonAdapter.d.ts

@@ -3,7 +3,7 @@ import type { StoryData } from '../../engine/core';
 import type { ValidationResult } from '../../engine/validation';
 export declare class TwisonAdapter implements StoryAdapter {
     load(source: string | object, options?: AdapterOptions): Promise<StoryData>;
-    validate(_storyData: StoryData): ValidationResult;
+    validate(): ValidationResult;
     detect(source: unknown): boolean;
 }
 export default TwisonAdapter;

package/dist/adapters/story/TwisonAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TwisonAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/story/TwisonAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAiBhE,qBAAa,aAAc,YAAW,YAAY;IAC1C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IA4CjF,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,gBAAgB;IAIjD,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;CAOjC;AAED,eAAe,aAAa,CAAC"}
+{"version":3,"file":"TwisonAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/story/TwisonAdapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC7E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAiBhE,qBAAa,aAAc,YAAW,YAAY;IAC1C,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC;IA4CjF,QAAQ,IAAI,gBAAgB;IAI5B,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO;CAOjC;AAED,eAAe,aAAa,CAAC"}