codingbuddy 3.1.2 → 4.0.0

package/dist/src/mcp/handlers/session.handler.d.ts

@@ -0,0 +1,15 @@
+import type { ToolDefinition } from './base.handler';
+import type { ToolResponse } from '../response.utils';
+import { AbstractHandler } from './abstract-handler';
+import { SessionService } from '../../session/session.service';
+export declare class SessionHandler extends AbstractHandler {
+    private readonly sessionService;
+    constructor(sessionService: SessionService);
+    protected getHandledTools(): string[];
+    protected handleTool(toolName: string, args: Record<string, unknown> | undefined): Promise<ToolResponse>;
+    getToolDefinitions(): ToolDefinition[];
+    private handleCreateSession;
+    private handleGetSession;
+    private handleGetActiveSession;
+    private handleUpdateSession;
+}

package/dist/src/mcp/handlers/session.handler.js

@@ -0,0 +1,238 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionHandler = void 0;
+const common_1 = require("@nestjs/common");
+const abstract_handler_1 = require("./abstract-handler");
+const session_service_1 = require("../../session/session.service");
+const response_utils_1 = require("../response.utils");
+const validation_constants_1 = require("../../shared/validation.constants");
+let SessionHandler = class SessionHandler extends abstract_handler_1.AbstractHandler {
+    constructor(sessionService) {
+        super();
+        this.sessionService = sessionService;
+    }
+    getHandledTools() {
+        return [
+            'create_session',
+            'get_session',
+            'get_active_session',
+            'update_session',
+        ];
+    }
+    async handleTool(toolName, args) {
+        switch (toolName) {
+            case 'create_session':
+                return this.handleCreateSession(args);
+            case 'get_session':
+                return this.handleGetSession(args);
+            case 'get_active_session':
+                return this.handleGetActiveSession();
+            case 'update_session':
+                return this.handleUpdateSession(args);
+            default:
+                return (0, response_utils_1.createErrorResponse)(`Unknown tool: ${toolName}`);
+        }
+    }
+    getToolDefinitions() {
+        return [
+            {
+                name: 'create_session',
+                description: 'Create a new session document to track PLAN/ACT/EVAL workflow. Call this at the start of a new task to enable cross-mode context sharing.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        title: {
+                            type: 'string',
+                            description: 'Session title/slug (e.g., "auth-feature", "fix-login-bug")',
+                        },
+                        task: {
+                            type: 'string',
+                            description: 'Initial task description',
+                        },
+                    },
+                    required: ['title'],
+                },
+            },
+            {
+                name: 'get_session',
+                description: 'Get a session document by ID. Use this to read previous mode context.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        sessionId: {
+                            type: 'string',
+                            description: 'Session ID (filename without .md extension)',
+                        },
+                    },
+                    required: ['sessionId'],
+                },
+            },
+            {
+                name: 'get_active_session',
+                description: 'Get the most recent active session. IMPORTANT: Call this at the start of ACT mode to get the recommended agent from PLAN.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                    required: [],
+                },
+            },
+            {
+                name: 'update_session',
+                description: 'Update a session document with new section data. Call this to record your work in each mode (PLAN/ACT/EVAL).',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        sessionId: {
+                            type: 'string',
+                            description: 'Session ID to update',
+                        },
+                        mode: {
+                            type: 'string',
+                            enum: ['PLAN', 'ACT', 'EVAL', 'AUTO'],
+                            description: 'Current workflow mode',
+                        },
+                        primaryAgent: {
+                            type: 'string',
+                            description: 'Primary agent used in this mode',
+                        },
+                        recommendedActAgent: {
+                            type: 'string',
+                            description: 'Agent recommended for ACT phase (only set in PLAN mode)',
+                        },
+                        recommendedActAgentConfidence: {
+                            type: 'number',
+                            description: 'Confidence score for recommendation (0-1)',
+                        },
+                        specialists: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Specialist agents used',
+                        },
+                        task: {
+                            type: 'string',
+                            description: 'Task description',
+                        },
+                        decisions: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Key decisions made',
+                        },
+                        notes: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Implementation notes',
+                        },
+                        status: {
+                            type: 'string',
+                            enum: ['in_progress', 'completed', 'blocked'],
+                            description: 'Status of this section',
+                        },
+                    },
+                    required: ['sessionId', 'mode'],
+                },
+            },
+        ];
+    }
+    async handleCreateSession(args) {
+        const title = (0, validation_constants_1.extractRequiredString)(args, 'title');
+        if (title === null) {
+            return (0, response_utils_1.createErrorResponse)('Missing required parameter: title');
+        }
+        const task = (0, validation_constants_1.extractOptionalString)(args, 'task');
+        const result = await this.sessionService.createSession({
+            title,
+            task: task ?? undefined,
+        });
+        if (result.success) {
+            return (0, response_utils_1.createJsonResponse)(result);
+        }
+        return (0, response_utils_1.createErrorResponse)(result.error || 'Failed to create session');
+    }
+    async handleGetSession(args) {
+        const sessionId = (0, validation_constants_1.extractRequiredString)(args, 'sessionId');
+        if (sessionId === null) {
+            return (0, response_utils_1.createErrorResponse)('Missing required parameter: sessionId');
+        }
+        const session = await this.sessionService.getSession(sessionId);
+        if (!session) {
+            return (0, response_utils_1.createErrorResponse)(`Session not found: ${sessionId}`);
+        }
+        return (0, response_utils_1.createJsonResponse)(session);
+    }
+    async handleGetActiveSession() {
+        const session = await this.sessionService.getActiveSession();
+        if (!session) {
+            return (0, response_utils_1.createJsonResponse)({
+                found: false,
+                message: 'No active session found. Create one with create_session tool.',
+            });
+        }
+        const planSection = session.sections.find(s => s.mode === 'PLAN');
+        const recommendedActAgent = planSection?.recommendedActAgent;
+        const recommendedActAgentConfidence = planSection?.recommendedActAgentConfidence;
+        return (0, response_utils_1.createJsonResponse)({
+            found: true,
+            session,
+            recommendedActAgent: recommendedActAgent
+                ? {
+                    agent: recommendedActAgent,
+                    confidence: recommendedActAgentConfidence,
+                }
+                : null,
+        });
+    }
+    async handleUpdateSession(args) {
+        const sessionId = (0, validation_constants_1.extractRequiredString)(args, 'sessionId');
+        if (sessionId === null) {
+            return (0, response_utils_1.createErrorResponse)('Missing required parameter: sessionId');
+        }
+        const mode = (0, validation_constants_1.extractRequiredString)(args, 'mode');
+        if (mode === null) {
+            return (0, response_utils_1.createErrorResponse)('Missing required parameter: mode');
+        }
+        if (!['PLAN', 'ACT', 'EVAL', 'AUTO'].includes(mode)) {
+            return (0, response_utils_1.createErrorResponse)(`Invalid mode: ${mode}. Must be PLAN, ACT, EVAL, or AUTO`);
+        }
+        const result = await this.sessionService.updateSession({
+            sessionId,
+            section: {
+                mode: mode,
+                primaryAgent: (0, validation_constants_1.extractOptionalString)(args, 'primaryAgent') ?? undefined,
+                recommendedActAgent: (0, validation_constants_1.extractOptionalString)(args, 'recommendedActAgent') ?? undefined,
+                recommendedActAgentConfidence: typeof args?.recommendedActAgentConfidence === 'number'
+                    ? args.recommendedActAgentConfidence
+                    : undefined,
+                specialists: Array.isArray(args?.specialists)
+                    ? args.specialists
+                    : undefined,
+                task: (0, validation_constants_1.extractOptionalString)(args, 'task') ?? undefined,
+                decisions: Array.isArray(args?.decisions)
+                    ? args.decisions
+                    : undefined,
+                notes: Array.isArray(args?.notes)
+                    ? args.notes
+                    : undefined,
+                status: (0, validation_constants_1.extractOptionalString)(args, 'status') ?? undefined,
+            },
+        });
+        if (result.success) {
+            return (0, response_utils_1.createJsonResponse)(result);
+        }
+        return (0, response_utils_1.createErrorResponse)(result.error || 'Failed to update session');
+    }
+};
+exports.SessionHandler = SessionHandler;
+exports.SessionHandler = SessionHandler = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [session_service_1.SessionService])
+], SessionHandler);
+//# sourceMappingURL=session.handler.js.map

package/dist/src/mcp/handlers/session.handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.handler.js","sourceRoot":"","sources":["../../../../src/mcp/handlers/session.handler.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAG5C,yDAAqD;AACrD,mEAA+D;AAC/D,sDAA4E;AAC5E,4EAG2C;AAWpC,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,kCAAe;IACjD,YAA6B,cAA8B;QACzD,KAAK,EAAE,CAAC;QADmB,mBAAc,GAAd,cAAc,CAAgB;IAE3D,CAAC;IAES,eAAe;QACvB,OAAO;YACL,gBAAgB;YAChB,aAAa;YACb,oBAAoB;YACpB,gBAAgB;SACjB,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,UAAU,CACxB,QAAgB,EAChB,IAAyC;QAEzC,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,gBAAgB;gBACnB,OAAO,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACxC,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACrC,KAAK,oBAAoB;gBACvB,OAAO,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACvC,KAAK,gBAAgB;gBACnB,OAAO,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;YACxC;gBACE,OAAO,IAAA,oCAAmB,EAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,kBAAkB;QAChB,OAAO;YACL;gBACE,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EACT,2IAA2I;gBAC7I,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,KAAK,EAAE;4BACL,IAAI,EAAE,QAAQ;4BACd,WAAW,EACT,4DAA4D;yBAC/D;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,0BAA0B;yBACxC;qBACF;oBACD,QAAQ,EAAE,CAAC,OAAO,CAAC;iBACpB;aACF;YACD;gBACE,IAAI,EAAE,aAAa;gBACnB,WAAW,EACT,uEAAuE;gBACzE,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,SAAS,EAAE;4BACT,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,6CAA6C;yBAC3D;qBACF;oBACD,QAAQ,EAAE,CAAC,WAAW,CAAC;iBACxB;aACF;YACD;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EACT,2HAA2H;gBAC7H,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE,EAAE;oBACd,QAAQ,EAAE,EAAE;iBACb;aACF;YACD;gBACE,IAAI,EAAE,gBAAgB;gBACtB,WAAW,EACT,8GAA8G;gBAChH,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,UAAU,EAAE;wBACV,SAAS,EAAE;4BACT,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,sBAAsB;yBACpC;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC;4BACrC,WAAW,EAAE,uBAAuB;yBACrC;wBACD,YAAY,EAAE;4BACZ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,iCAAiC;yBAC/C;wBACD,mBAAmB,EAAE;4BACnB,IAAI,EAAE,QAAQ;4BACd,WAAW,EACT,yDAAyD;yBAC5D;wBACD,6BAA6B,EAAE;4BAC7B,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,2CAA2C;yBACzD;wBACD,WAAW,EAAE;4BACX,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;4BACzB,WAAW,EAAE,wBAAwB;yBACtC;wBACD,IAAI,EAAE;4BACJ,IAAI,EAAE,QAAQ;4BACd,WAAW,EAAE,kBAAkB;yBAChC;wBACD,SAAS,EAAE;4BACT,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;4BACzB,WAAW,EAAE,oBAAoB;yBAClC;wBACD,KAAK,EAAE;4BACL,IAAI,EAAE,OAAO;4BACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;4BACzB,WAAW,EAAE,sBAAsB;yBACpC;wBACD,MAAM,EAAE;4BACN,IAAI,EAAE,QAAQ;4BACd,IAAI,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,SAAS,CAAC;4BAC7C,WAAW,EAAE,wBAAwB;yBACtC;qBACF;oBACD,QAAQ,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC;iBAChC;aACF;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAC/B,IAAyC;QAEzC,MAAM,KAAK,GAAG,IAAA,4CAAqB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,IAAA,oCAAmB,EAAC,mCAAmC,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,IAAI,GAAG,IAAA,4CAAqB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAEjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC;YACrD,KAAK;YACL,IAAI,EAAE,IAAI,IAAI,SAAS;SACxB,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,IAAA,mCAAkB,EAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,IAAA,oCAAmB,EAAC,MAAM,CAAC,KAAK,IAAI,0BAA0B,CAAC,CAAC;IACzE,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,IAAyC;QAEzC,MAAM,SAAS,GAAG,IAAA,4CAAqB,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC3D,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO,IAAA,oCAAmB,EAAC,uCAAuC,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAEhE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAA,oCAAmB,EAAC,sBAAsB,SAAS,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,IAAA,mCAAkB,EAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAEO,KAAK,CAAC,sBAAsB;QAClC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,gBAAgB,EAAE,CAAC;QAE7D,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,IAAA,mCAAkB,EAAC;gBACxB,KAAK,EAAE,KAAK;gBACZ,OAAO,EACL,+DAA+D;aAClE,CAAC,CAAC;QACL,CAAC;QAGD,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAClE,MAAM,mBAAmB,GAAG,WAAW,EAAE,mBAAmB,CAAC;QAC7D,MAAM,6BAA6B,GACjC,WAAW,EAAE,6BAA6B,CAAC;QAE7C,OAAO,IAAA,mCAAkB,EAAC;YACxB,KAAK,EAAE,IAAI;YACX,OAAO;YAEP,mBAAmB,EAAE,mBAAmB;gBACtC,CAAC,CAAC;oBACE,KAAK,EAAE,mBAAmB;oBAC1B,UAAU,EAAE,6BAA6B;iBAC1C;gBACH,CAAC,CAAC,IAAI;SACT,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,mBAAmB,CAC/B,IAAyC;QAEzC,MAAM,SAAS,GAAG,IAAA,4CAAqB,EAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC3D,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO,IAAA,oCAAmB,EAAC,uCAAuC,CAAC,CAAC;QACtE,CAAC;QAED,MAAM,IAAI,GAAG,IAAA,4CAAqB,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACjD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,IAAA,oCAAmB,EAAC,kCAAkC,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,OAAO,IAAA,oCAAmB,EACxB,iBAAiB,IAAI,oCAAoC,CAC1D,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,CAAC;YACrD,SAAS;YACT,OAAO,EAAE;gBACP,IAAI,EAAE,IAAY;gBAClB,YAAY,EAAE,IAAA,4CAAqB,EAAC,IAAI,EAAE,cAAc,CAAC,IAAI,SAAS;gBACtE,mBAAmB,EACjB,IAAA,4CAAqB,EAAC,IAAI,EAAE,qBAAqB,CAAC,IAAI,SAAS;gBACjE,6BAA6B,EAC3B,OAAO,IAAI,EAAE,6BAA6B,KAAK,QAAQ;oBACrD,CAAC,CAAC,IAAI,CAAC,6BAA6B;oBACpC,CAAC,CAAC,SAAS;gBACf,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC;oBAC3C,CAAC,CAAE,IAAI,CAAC,WAAwB;oBAChC,CAAC,CAAC,SAAS;gBACb,IAAI,EAAE,IAAA,4CAAqB,EAAC,IAAI,EAAE,MAAM,CAAC,IAAI,SAAS;gBACtD,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC;oBACvC,CAAC,CAAE,IAAI,CAAC,SAAsB;oBAC9B,CAAC,CAAC,SAAS;gBACb,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;oBAC/B,CAAC,CAAE,IAAI,CAAC,KAAkB;oBAC1B,CAAC,CAAC,SAAS;gBACb,MAAM,EACH,IAAA,4CAAqB,EAAC,IAAI,EAAE,QAAQ,CAGvB,IAAI,SAAS;aAC9B;SACF,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,IAAA,mCAAkB,EAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,IAAA,oCAAmB,EAAC,MAAM,CAAC,KAAK,IAAI,0BAA0B,CAAC,CAAC;IACzE,CAAC;CACF,CAAA;AAtQY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;qCAEkC,gCAAc;GADhD,cAAc,CAsQ1B"}

package/dist/src/session/__tests__/session-test.utils.d.ts

@@ -0,0 +1,5 @@
+import type { SessionMetadata, SessionSection, SessionDocument } from '../session.types';
+export declare function createTestMetadata(overrides?: Partial<SessionMetadata>): SessionMetadata;
+export declare function createTestSection(mode: 'PLAN' | 'ACT' | 'EVAL' | 'AUTO', overrides?: Partial<Omit<SessionSection, 'mode'>>): SessionSection;
+export declare function createTestDocument(sections?: SessionSection[], metadataOverrides?: Partial<SessionMetadata>): SessionDocument;
+export declare function createRoundtripTestDocument(language?: string): SessionDocument;

package/dist/src/session/__tests__/session-test.utils.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTestMetadata = createTestMetadata;
+exports.createTestSection = createTestSection;
+exports.createTestDocument = createTestDocument;
+exports.createRoundtripTestDocument = createRoundtripTestDocument;
+function createTestMetadata(overrides = {}) {
+    return {
+        id: 'test-session',
+        title: 'Test Session',
+        createdAt: '2026-01-11T10:00:00Z',
+        updatedAt: '2026-01-11T12:00:00Z',
+        status: 'active',
+        ...overrides,
+    };
+}
+function createTestSection(mode, overrides = {}) {
+    return {
+        mode,
+        timestamp: '10:00',
+        ...overrides,
+    };
+}
+function createTestDocument(sections = [], metadataOverrides = {}) {
+    return {
+        metadata: createTestMetadata(metadataOverrides),
+        sections,
+    };
+}
+function createRoundtripTestDocument(language = 'en') {
+    const titles = {
+        en: 'Roundtrip Test',
+        ko: '왕복 테스트',
+        ja: 'ラウンドトリップテスト',
+        zh: '往返测试',
+        es: 'Prueba de ida y vuelta',
+    };
+    return {
+        metadata: createTestMetadata({
+            id: 'roundtrip-test',
+            title: titles[language] || titles.en,
+        }),
+        sections: [
+            {
+                mode: 'PLAN',
+                timestamp: '10:00',
+                primaryAgent: 'solution-architect',
+                recommendedActAgent: 'backend-developer',
+                recommendedActAgentConfidence: 0.95,
+                specialists: ['security', 'test-strategy'],
+                task: 'Implement feature',
+                decisions: ['Decision 1', 'Decision 2'],
+                notes: ['Note 1'],
+                status: 'completed',
+            },
+        ],
+    };
+}
+//# sourceMappingURL=session-test.utils.js.map

package/dist/src/session/__tests__/session-test.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-test.utils.js","sourceRoot":"","sources":["../../../../src/session/__tests__/session-test.utils.ts"],"names":[],"mappings":";;AAsBA,gDAWC;AAYD,8CASC;AAcD,gDAQC;AASD,kEA+BC;AA9FD,SAAgB,kBAAkB,CAChC,YAAsC,EAAE;IAExC,OAAO;QACL,EAAE,EAAE,cAAc;QAClB,KAAK,EAAE,cAAc;QACrB,SAAS,EAAE,sBAAsB;QACjC,SAAS,EAAE,sBAAsB;QACjC,MAAM,EAAE,QAAQ;QAChB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAYD,SAAgB,iBAAiB,CAC/B,IAAsC,EACtC,YAAmD,EAAE;IAErD,OAAO;QACL,IAAI;QACJ,SAAS,EAAE,OAAO;QAClB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAcD,SAAgB,kBAAkB,CAChC,WAA6B,EAAE,EAC/B,oBAA8C,EAAE;IAEhD,OAAO;QACL,QAAQ,EAAE,kBAAkB,CAAC,iBAAiB,CAAC;QAC/C,QAAQ;KACT,CAAC;AACJ,CAAC;AASD,SAAgB,2BAA2B,CACzC,WAAmB,IAAI;IAEvB,MAAM,MAAM,GAA2B;QACrC,EAAE,EAAE,gBAAgB;QACpB,EAAE,EAAE,QAAQ;QACZ,EAAE,EAAE,aAAa;QACjB,EAAE,EAAE,MAAM;QACV,EAAE,EAAE,wBAAwB;KAC7B,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,kBAAkB,CAAC;YAC3B,EAAE,EAAE,gBAAgB;YACpB,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,EAAE;SACrC,CAAC;QACF,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,OAAO;gBAClB,YAAY,EAAE,oBAAoB;gBAClC,mBAAmB,EAAE,mBAAmB;gBACxC,6BAA6B,EAAE,IAAI;gBACnC,WAAW,EAAE,CAAC,UAAU,EAAE,eAAe,CAAC;gBAC1C,IAAI,EAAE,mBAAmB;gBACzB,SAAS,EAAE,CAAC,YAAY,EAAE,YAAY,CAAC;gBACvC,KAAK,EAAE,CAAC,QAAQ,CAAC;gBACjB,MAAM,EAAE,WAAW;aACpB;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/session/index.d.ts

@@ -0,0 +1,3 @@
+export { SessionModule } from './session.module';
+export { SessionService } from './session.service';
+export type { SessionDocument, SessionSection, SessionMetadata, CreateSessionOptions, UpdateSessionOptions, SessionOperationResult, } from './session.types';

package/dist/src/session/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionService = exports.SessionModule = void 0;
+var session_module_1 = require("./session.module");
+Object.defineProperty(exports, "SessionModule", { enumerable: true, get: function () { return session_module_1.SessionModule; } });
+var session_service_1 = require("./session.service");
+Object.defineProperty(exports, "SessionService", { enumerable: true, get: function () { return session_service_1.SessionService; } });
+//# sourceMappingURL=index.js.map

package/dist/src/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/session/index.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA"}

package/dist/src/session/session.cache.d.ts

@@ -0,0 +1,19 @@
+import type { SessionDocument } from './session.types';
+export declare class SessionCache {
+    private readonly cache;
+    private activeSessionId;
+    private activeSessionTimestamp;
+    private isCacheValid;
+    get(sessionId: string): SessionDocument | null;
+    set(sessionId: string, session: SessionDocument): void;
+    invalidateAll(): void;
+    invalidate(sessionId: string): void;
+    getActiveSessionId(): string | null;
+    setActiveSessionId(sessionId: string): void;
+    invalidateActiveSession(): void;
+    getStats(): {
+        size: number;
+        maxSize: number;
+        hasActiveSession: boolean;
+    };
+}

package/dist/src/session/session.cache.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionCache = void 0;
+const CACHE_TTL_MS = 30_000;
+const MAX_CACHE_SIZE = 100;
+class SessionCache {
+    constructor() {
+        this.cache = new Map();
+        this.activeSessionId = null;
+        this.activeSessionTimestamp = 0;
+    }
+    isCacheValid(timestamp) {
+        return Date.now() - timestamp < CACHE_TTL_MS;
+    }
+    get(sessionId) {
+        const entry = this.cache.get(sessionId);
+        if (entry && this.isCacheValid(entry.timestamp)) {
+            return entry.session;
+        }
+        if (entry) {
+            this.cache.delete(sessionId);
+        }
+        return null;
+    }
+    set(sessionId, session) {
+        if (this.cache.has(sessionId)) {
+            this.cache.delete(sessionId);
+        }
+        while (this.cache.size >= MAX_CACHE_SIZE) {
+            const oldestKey = this.cache.keys().next().value;
+            if (oldestKey !== undefined) {
+                this.cache.delete(oldestKey);
+            }
+            else {
+                break;
+            }
+        }
+        this.cache.set(sessionId, {
+            session,
+            timestamp: Date.now(),
+        });
+    }
+    invalidateAll() {
+        this.cache.clear();
+        this.activeSessionId = null;
+        this.activeSessionTimestamp = 0;
+    }
+    invalidate(sessionId) {
+        this.cache.delete(sessionId);
+        if (this.activeSessionId === sessionId) {
+            this.activeSessionId = null;
+            this.activeSessionTimestamp = 0;
+        }
+    }
+    getActiveSessionId() {
+        if (this.activeSessionId &&
+            this.isCacheValid(this.activeSessionTimestamp)) {
+            return this.activeSessionId;
+        }
+        if (this.activeSessionId) {
+            this.activeSessionId = null;
+            this.activeSessionTimestamp = 0;
+        }
+        return null;
+    }
+    setActiveSessionId(sessionId) {
+        this.activeSessionId = sessionId;
+        this.activeSessionTimestamp = Date.now();
+    }
+    invalidateActiveSession() {
+        this.activeSessionId = null;
+        this.activeSessionTimestamp = 0;
+    }
+    getStats() {
+        return {
+            size: this.cache.size,
+            maxSize: MAX_CACHE_SIZE,
+            hasActiveSession: this.activeSessionId !== null,
+        };
+    }
+}
+exports.SessionCache = SessionCache;
+//# sourceMappingURL=session.cache.js.map

package/dist/src/session/session.cache.js.map

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

package/dist/src/session/session.module.d.ts

@@ -0,0 +1,2 @@
+export declare class SessionModule {
+}

package/dist/src/session/session.module.js

@@ -0,0 +1,23 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionModule = void 0;
+const common_1 = require("@nestjs/common");
+const session_service_1 = require("./session.service");
+const config_module_1 = require("../config/config.module");
+let SessionModule = class SessionModule {
+};
+exports.SessionModule = SessionModule;
+exports.SessionModule = SessionModule = __decorate([
+    (0, common_1.Module)({
+        imports: [config_module_1.CodingBuddyConfigModule],
+        providers: [session_service_1.SessionService],
+        exports: [session_service_1.SessionService],
+    })
+], SessionModule);
+//# sourceMappingURL=session.module.js.map

package/dist/src/session/session.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.module.js","sourceRoot":"","sources":["../../../src/session/session.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAwC;AACxC,uDAAmD;AACnD,2DAAkE;AAO3D,IAAM,aAAa,GAAnB,MAAM,aAAa;CAAG,CAAA;AAAhB,sCAAa;wBAAb,aAAa;IALzB,IAAA,eAAM,EAAC;QACN,OAAO,EAAE,CAAC,uCAAuB,CAAC;QAClC,SAAS,EAAE,CAAC,gCAAc,CAAC;QAC3B,OAAO,EAAE,CAAC,gCAAc,CAAC;KAC1B,CAAC;GACW,aAAa,CAAG"}

package/dist/src/session/session.parser.d.ts

@@ -0,0 +1,22 @@
+import type { SessionDocument, SessionSection, SessionMetadata } from './session.types';
+export interface LocalizedLabels {
+    SESSION_HEADER: string;
+    CREATED_PREFIX: string;
+    UPDATED_PREFIX: string;
+    STATUS_PREFIX: string;
+    PRIMARY_AGENT_PREFIX: string;
+    RECOMMENDED_ACT_AGENT_PREFIX: string;
+    SPECIALISTS_PREFIX: string;
+    SECTION_SEPARATOR: string;
+    TASK_HEADER: string;
+    DECISIONS_HEADER: string;
+    NOTES_HEADER: string;
+}
+export declare const LOCALIZED_LABELS: Record<string, LocalizedLabels>;
+export interface ParseContext {
+    metadata: SessionMetadata;
+    sections: SessionSection[];
+    currentSection: Partial<SessionSection> | null;
+    currentListType: 'decisions' | 'notes' | null;
+}
+export declare function parseDocument(content: string, sessionId: string): SessionDocument;