qnce-engine 0.1.0 → 1.2.0

package/dist/narrative/branching/engine-simple.d.ts

@@ -0,0 +1,84 @@
+import { QNCEStory, BranchOption, DynamicBranchOperation, BranchHistoryEntry, AIBranchingContext } from './models';
+import { QNCEState } from '../../engine/core';
+/**
+ * QNCE Branching Engine - Core API for dynamic narrative branching
+ * Simplified implementation focusing on core functionality
+ */
+export declare class QNCEBranchingEngine {
+    private story;
+    private context;
+    private aiContext?;
+    constructor(story: QNCEStory, initialState: QNCEState);
+    /**
+     * Evaluate available branches from current position
+     */
+    evaluateAvailableBranches(): Promise<BranchOption[]>;
+    /**
+     * Execute a branch transition
+     */
+    executeBranch(optionId: string): Promise<boolean>;
+    /**
+     * Dynamic branch insertion at runtime
+     */
+    insertDynamicBranch(operation: DynamicBranchOperation): Promise<boolean>;
+    /**
+     * Remove dynamic branch
+     */
+    removeDynamicBranch(branchId: string): Promise<boolean>;
+    /**
+     * Set AI context for enhanced branching decisions
+     */
+    setAIContext(aiContext: AIBranchingContext): void;
+    /**
+     * Generate AI-driven branch options
+     */
+    generateAIBranches(maxOptions?: number): Promise<BranchOption[]>;
+    /**
+     * Get current branching analytics
+     */
+    getBranchingAnalytics(): {
+        currentChapter: string;
+        currentFlow: string;
+        historyLength: number;
+        pendingBranches: number;
+        totalBranchesTraversed: number;
+        avgBranchDecisionTime: number;
+        mostPopularBranches: string[];
+        abandonmentPoints: string[];
+        completionRate: number;
+        sessionStartTime: Date;
+    };
+    /**
+     * Export branching data for external analysis
+     */
+    exportBranchingData(): {
+        story: {
+            id: string;
+            title: string;
+            version: string;
+        };
+        session: {
+            startTime: Date;
+            currentState: QNCEState;
+            branchHistory: BranchHistoryEntry[];
+            analytics: import("./models").BranchAnalytics;
+        };
+    };
+    private createBranchContext;
+    private getCurrentNode;
+    private findBranchPointsForNode;
+    private evaluateConditions;
+    private evaluateCondition;
+    private findBranchOption;
+    private findFlow;
+    private findChapter;
+    private transitionToFlow;
+    private recordBranchHistory;
+    private updateBranchAnalytics;
+}
+/**
+ * Factory function for creating branching engines
+ */
+export declare function createBranchingEngine(story: QNCEStory, initialState: QNCEState): QNCEBranchingEngine;
+export { QNCEBranchingEngine as default };
+//# sourceMappingURL=engine-simple.d.ts.map

package/dist/narrative/branching/engine-simple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine-simple.d.ts","sourceRoot":"","sources":["../../../src/narrative/branching/engine-simple.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,SAAS,EAKT,YAAY,EAEZ,sBAAsB,EACtB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,SAAS,EAAiB,MAAM,mBAAmB,CAAC;AAE7D;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAAY;IACzB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,SAAS,CAAC,CAAqB;gBAE3B,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS;IASrD;;OAEG;IACG,yBAAyB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAwB1D;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IA8BvD;;OAEG;IACG,mBAAmB,CAAC,SAAS,EAAE,sBAAsB,GAAG,OAAO,CAAC,OAAO,CAAC;IAkC9E;;OAEG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe7D;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,kBAAkB,GAAG,IAAI;IAIjD;;OAEG;IACG,kBAAkB,CAAC,UAAU,SAAI,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAkCjE;;OAEG;IACH,qBAAqB;;;;;;;;;;;;IAUrB;;OAEG;IACH,mBAAmB;;;;;;;;;;;;;IAoBnB,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,uBAAuB;YAMjB,kBAAkB;YASlB,iBAAiB;YA6BjB,gBAAgB;IAY9B,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,WAAW;YAIL,gBAAgB;IAiC9B,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,qBAAqB;CAmB9B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,EAChB,YAAY,EAAE,SAAS,GACtB,mBAAmB,CAErB;AAGD,OAAO,EAAE,mBAAmB,IAAI,OAAO,EAAE,CAAC"}

package/dist/narrative/branching/engine-simple.js

@@ -0,0 +1,349 @@
+"use strict";
+// QNCE Branching API - Simplified Runtime Implementation  
+// Sprint #3 - Advanced Narrative & AI Integration
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = exports.QNCEBranchingEngine = void 0;
+exports.createBranchingEngine = createBranchingEngine;
+/**
+ * QNCE Branching Engine - Core API for dynamic narrative branching
+ * Simplified implementation focusing on core functionality
+ */
+class QNCEBranchingEngine {
+    story;
+    context;
+    aiContext;
+    constructor(story, initialState) {
+        this.story = story;
+        this.context = this.createBranchContext(story, initialState);
+    }
+    // ================================
+    // Core Branching Operations
+    // ================================
+    /**
+     * Evaluate available branches from current position
+     */
+    async evaluateAvailableBranches() {
+        const currentNode = this.getCurrentNode();
+        const availableBranches = this.findBranchPointsForNode(this.context.currentFlow.id, currentNode.id);
+        const validOptions = [];
+        for (const branchPoint of availableBranches) {
+            // Evaluate branch point conditions
+            if (await this.evaluateConditions(branchPoint.conditions || [])) {
+                // Evaluate individual option conditions
+                for (const option of branchPoint.branchOptions) {
+                    if (await this.evaluateConditions(option.conditions || [])) {
+                        validOptions.push(option);
+                    }
+                }
+            }
+        }
+        return validOptions;
+    }
+    /**
+     * Execute a branch transition
+     */
+    async executeBranch(optionId) {
+        const option = await this.findBranchOption(optionId);
+        if (!option) {
+            throw new Error(`Branch option not found: ${optionId}`);
+        }
+        // Apply flag effects
+        if (option.flagEffects) {
+            Object.assign(this.context.activeState.flags, option.flagEffects);
+        }
+        // Execute flow transition
+        const targetFlow = this.findFlow(option.targetFlowId);
+        if (!targetFlow) {
+            throw new Error(`Target flow not found: ${option.targetFlowId}`);
+        }
+        const success = await this.transitionToFlow(targetFlow, option.targetNodeId);
+        if (success) {
+            // Record branch execution in history
+            this.recordBranchHistory(optionId, option);
+            // Update analytics
+            this.updateBranchAnalytics(optionId);
+        }
+        return success;
+    }
+    /**
+     * Dynamic branch insertion at runtime
+     */
+    async insertDynamicBranch(operation) {
+        // Validate operation conditions
+        if (operation.conditions && !await this.evaluateConditions(operation.conditions)) {
+            return false;
+        }
+        // Find target location
+        const chapter = this.findChapter(operation.targetLocation.chapterId);
+        if (!chapter) {
+            throw new Error(`Chapter not found: ${operation.targetLocation.chapterId}`);
+        }
+        // Create new branch point
+        const branchPoint = {
+            id: operation.branchId,
+            name: operation.payload?.name || `Dynamic Branch ${operation.branchId}`,
+            sourceFlowId: operation.targetLocation.flowId,
+            sourceNodeId: operation.targetLocation.nodeId,
+            branchType: operation.payload?.branchType || 'conditional',
+            branchOptions: operation.payload?.branchOptions || [],
+            conditions: operation.conditions,
+            metadata: {
+                usageCount: 0,
+                avgTraversalTime: 0,
+                playerPreference: 0,
+                lastUsed: new Date()
+            }
+        };
+        // Insert into chapter
+        chapter.branches.push(branchPoint);
+        return true;
+    }
+    /**
+     * Remove dynamic branch
+     */
+    async removeDynamicBranch(branchId) {
+        for (const chapter of this.story.chapters) {
+            const index = chapter.branches.findIndex(b => b.id === branchId);
+            if (index !== -1) {
+                chapter.branches.splice(index, 1);
+                return true;
+            }
+        }
+        return false;
+    }
+    // ================================
+    // AI Integration Methods
+    // ================================
+    /**
+     * Set AI context for enhanced branching decisions
+     */
+    setAIContext(aiContext) {
+        this.aiContext = aiContext;
+    }
+    /**
+     * Generate AI-driven branch options
+     */
+    async generateAIBranches(maxOptions = 3) {
+        if (!this.aiContext) {
+            throw new Error('AI context not set. Call setAIContext() first.');
+        }
+        const generatedOptions = [];
+        const playerProfile = this.aiContext.playerProfile;
+        // Example: Generate options based on player style
+        if (playerProfile.playStyle === 'explorer') {
+            generatedOptions.push({
+                id: `ai-explore-${Date.now()}`,
+                targetFlowId: this.context.currentFlow.id,
+                displayText: "Investigate the mysterious artifact",
+                weight: 0.8
+            });
+        }
+        if (playerProfile.playStyle === 'socializer') {
+            generatedOptions.push({
+                id: `ai-social-${Date.now()}`,
+                targetFlowId: this.context.currentFlow.id,
+                displayText: "Ask your companion about their past",
+                weight: 0.7
+            });
+        }
+        return generatedOptions.slice(0, maxOptions);
+    }
+    // ================================
+    // Analytics & Monitoring
+    // ================================
+    /**
+     * Get current branching analytics
+     */
+    getBranchingAnalytics() {
+        return {
+            ...this.context.analytics,
+            currentChapter: this.context.currentChapter.id,
+            currentFlow: this.context.currentFlow.id,
+            historyLength: this.context.branchHistory.length,
+            pendingBranches: this.context.pendingBranches.length
+        };
+    }
+    /**
+     * Export branching data for external analysis
+     */
+    exportBranchingData() {
+        return {
+            story: {
+                id: this.story.id,
+                title: this.story.title,
+                version: this.story.version
+            },
+            session: {
+                startTime: this.context.analytics.sessionStartTime,
+                currentState: this.context.activeState,
+                branchHistory: this.context.branchHistory,
+                analytics: this.context.analytics
+            }
+        };
+    }
+    // ================================
+    // Private Helper Methods
+    // ================================
+    createBranchContext(story, initialState) {
+        const initialChapter = story.chapters[0];
+        const initialFlow = initialChapter.flows[0];
+        return {
+            currentStory: story,
+            currentChapter: initialChapter,
+            currentFlow: initialFlow,
+            activeState: initialState,
+            branchHistory: [],
+            pendingBranches: [],
+            analytics: {
+                totalBranchesTraversed: 0,
+                avgBranchDecisionTime: 0,
+                mostPopularBranches: [],
+                abandonmentPoints: [],
+                completionRate: 0,
+                sessionStartTime: new Date()
+            }
+        };
+    }
+    getCurrentNode() {
+        const currentNodeId = this.context.activeState.currentNodeId;
+        const node = this.context.currentFlow.nodes.find(n => n.id === currentNodeId);
+        if (!node) {
+            throw new Error(`Current node not found: ${currentNodeId}`);
+        }
+        return node;
+    }
+    findBranchPointsForNode(flowId, nodeId) {
+        return this.context.currentChapter.branches.filter(b => b.sourceFlowId === flowId && b.sourceNodeId === nodeId);
+    }
+    async evaluateConditions(conditions) {
+        for (const condition of conditions) {
+            if (!await this.evaluateCondition(condition)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    async evaluateCondition(condition) {
+        const { operator, key, value, evaluator } = condition;
+        // Custom evaluator takes precedence
+        if (evaluator) {
+            return evaluator(this.context.activeState, this.context);
+        }
+        // Standard condition evaluation
+        const stateValue = this.context.activeState.flags[key];
+        switch (operator) {
+            case 'equals':
+                return stateValue === value;
+            case 'not_equals':
+                return stateValue !== value;
+            case 'greater':
+                return Number(stateValue) > Number(value);
+            case 'less':
+                return Number(stateValue) < Number(value);
+            case 'contains':
+                return Array.isArray(stateValue) && stateValue.includes(value);
+            case 'exists':
+                return stateValue !== undefined;
+            default:
+                return false;
+        }
+    }
+    async findBranchOption(optionId) {
+        for (const chapter of this.story.chapters) {
+            for (const branchPoint of chapter.branches) {
+                const option = branchPoint.branchOptions.find(o => o.id === optionId);
+                if (option) {
+                    return option;
+                }
+            }
+        }
+        return null;
+    }
+    findFlow(flowId) {
+        for (const chapter of this.story.chapters) {
+            const flow = chapter.flows.find(f => f.id === flowId);
+            if (flow) {
+                return flow;
+            }
+        }
+        return null;
+    }
+    findChapter(chapterId) {
+        return this.story.chapters.find(c => c.id === chapterId) || null;
+    }
+    async transitionToFlow(targetFlow, targetNodeId) {
+        // Find entry point
+        let entryNodeId;
+        if (targetNodeId) {
+            entryNodeId = targetNodeId;
+        }
+        else if (targetFlow.entryPoints.length > 0) {
+            // Use highest priority entry point
+            const entryPoint = targetFlow.entryPoints.sort((a, b) => b.priority - a.priority)[0];
+            entryNodeId = entryPoint.nodeId;
+        }
+        else if (targetFlow.nodes.length > 0) {
+            // Use first node as fallback
+            entryNodeId = targetFlow.nodes[0].id;
+        }
+        else {
+            return false;
+        }
+        // Update context
+        this.context.currentFlow = targetFlow;
+        this.context.activeState.currentNodeId = entryNodeId;
+        this.context.activeState.history.push(entryNodeId);
+        // Update chapter if necessary
+        const targetChapter = this.story.chapters.find(c => c.flows.some(f => f.id === targetFlow.id));
+        if (targetChapter) {
+            this.context.currentChapter = targetChapter;
+        }
+        return true;
+    }
+    recordBranchHistory(optionId, option) {
+        const historyEntry = {
+            id: `history-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+            branchPointId: 'unknown', // Would need to track this
+            chosenOptionId: optionId,
+            timestamp: new Date(),
+            executionTime: 0, // Would measure actual execution time
+            context: {
+                currentNodeId: this.context.activeState.currentNodeId,
+                flags: { ...this.context.activeState.flags }
+            }
+        };
+        this.context.branchHistory.push(historyEntry);
+        // Limit history size for memory management
+        if (this.context.branchHistory.length > 1000) {
+            this.context.branchHistory.splice(0, 100);
+        }
+    }
+    updateBranchAnalytics(optionId) {
+        this.context.analytics.totalBranchesTraversed++;
+        // Update popular branches
+        const popular = this.context.analytics.mostPopularBranches;
+        const index = popular.indexOf(optionId);
+        if (index !== -1) {
+            // Move to front
+            popular.splice(index, 1);
+            popular.unshift(optionId);
+        }
+        else {
+            // Add to front
+            popular.unshift(optionId);
+            // Limit to top 10
+            if (popular.length > 10) {
+                popular.pop();
+            }
+        }
+    }
+}
+exports.QNCEBranchingEngine = QNCEBranchingEngine;
+exports.default = QNCEBranchingEngine;
+/**
+ * Factory function for creating branching engines
+ */
+function createBranchingEngine(story, initialState) {
+    return new QNCEBranchingEngine(story, initialState);
+}
+//# sourceMappingURL=engine-simple.js.map

package/dist/narrative/branching/engine-simple.js.map

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

package/dist/narrative/branching/index.d.ts

@@ -0,0 +1,12 @@
+export { QNCEBranchingEngine, createBranchingEngine } from './engine-simple';
+export * from './models';
+export declare const example: {
+    storyStructure: {
+        story: string;
+        chapters: string;
+        flows: string;
+        branches: string;
+    };
+    usage: string;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/narrative/branching/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/narrative/branching/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG7E,cAAc,UAAU,CAAC;AAGzB,eAAO,MAAM,OAAO;;;;;;;;CA6BnB,CAAC"}

package/dist/narrative/branching/index.js

@@ -0,0 +1,56 @@
+"use strict";
+// QNCE Branching System - Main Export
+// Sprint #3 - Advanced Narrative & AI Integration
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.example = exports.createBranchingEngine = exports.QNCEBranchingEngine = void 0;
+// Core branching engine
+var engine_simple_1 = require("./engine-simple");
+Object.defineProperty(exports, "QNCEBranchingEngine", { enumerable: true, get: function () { return engine_simple_1.QNCEBranchingEngine; } });
+Object.defineProperty(exports, "createBranchingEngine", { enumerable: true, get: function () { return engine_simple_1.createBranchingEngine; } });
+// Complete type system
+__exportStar(require("./models"), exports);
+// Usage example for documentation
+exports.example = {
+    // Example story structure showing branching capabilities
+    storyStructure: {
+        story: 'QNCEStory with chapters and branching config',
+        chapters: 'Logical groupings of flows and branch points',
+        flows: 'Sequences of narrative nodes with entry/exit points',
+        branches: 'Dynamic decision points with conditions and options'
+    },
+    // Example API usage
+    usage: `
+    import { createBranchingEngine, QNCEStory } from 'qnce-engine/branching';
+    
+    // Create branching engine
+    const engine = createBranchingEngine(story, initialState);
+    
+    // Evaluate available branches
+    const options = await engine.evaluateAvailableBranches();
+    
+    // Execute player choice
+    await engine.executeBranch(selectedOptionId);
+    
+    // Dynamic content insertion
+    await engine.insertDynamicBranch(branchOperation);
+    
+    // AI-driven content generation
+    engine.setAIContext(aiContext);
+    const aiBranches = await engine.generateAIBranches();
+  `
+};
+//# sourceMappingURL=index.js.map

package/dist/narrative/branching/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/narrative/branching/index.ts"],"names":[],"mappings":";AAAA,sCAAsC;AACtC,kDAAkD;;;;;;;;;;;;;;;;;AAElD,wBAAwB;AACxB,iDAA6E;AAApE,oHAAA,mBAAmB,OAAA;AAAE,sHAAA,qBAAqB,OAAA;AAEnD,uBAAuB;AACvB,2CAAyB;AAEzB,kCAAkC;AACrB,QAAA,OAAO,GAAG;IACrB,yDAAyD;IACzD,cAAc,EAAE;QACd,KAAK,EAAE,8CAA8C;QACrD,QAAQ,EAAE,8CAA8C;QACxD,KAAK,EAAE,qDAAqD;QAC5D,QAAQ,EAAE,qDAAqD;KAChE;IAED,oBAAoB;IACpB,KAAK,EAAE;;;;;;;;;;;;;;;;;;GAkBN;CACF,CAAC"}