@aquex/cmos-mcp 1.0.0

package/dist/tools/cmos/cmos-session-start.js

@@ -0,0 +1,305 @@
+"use strict";
+/**
+ * cmos_session_start Tool
+ *
+ * MCP tool for starting a new session in CMOS.
+ * Sessions capture planning, onboarding, review, and research activities.
+ *
+ * @module tools/cmos/cmos-session-start
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosSessionStartToolDefinition = exports.cmosSessionStartSchema = exports.VALID_SESSION_TYPES = void 0;
+exports.generateSessionId = generateSessionId;
+exports.cmosSessionStart = cmosSessionStart;
+exports.formatSessionStartForLLM = formatSessionStartForLLM;
+const zod_1 = require("zod");
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+Object.defineProperty(exports, "VALID_SESSION_TYPES", { enumerable: true, get: function () { return errors_1.VALID_SESSION_TYPES; } });
+const context_freshness_1 = require("./context-freshness");
+/**
+ * Input parameters schema for cmos_session_start tool.
+ */
+exports.cmosSessionStartSchema = zod_1.z.object({
+    /** Session type */
+    type: zod_1.z
+        .enum(errors_1.VALID_SESSION_TYPES)
+        .describe('Session type: onboarding, planning, review, research, check-in, or custom'),
+    /** Session title */
+    title: zod_1.z
+        .string()
+        .min(1)
+        .max(255)
+        .describe('Short descriptive title for the session (e.g., "Sprint 13 planning")'),
+    /** Optional agent name */
+    agent: zod_1.z
+        .string()
+        .default('assistant')
+        .optional()
+        .describe('Agent starting the session (default: "assistant")'),
+    /** Optional sprint ID */
+    sprintId: zod_1.z.string().optional().describe('Optional sprint ID to associate with this session'),
+    /** Optional auto-refresh behavior for master_context */
+    autoRefreshMasterContext: zod_1.z
+        .boolean()
+        .optional()
+        .describe('Whether to auto-refresh master_context from recent completed missions/sprints before starting the session (default: true)'),
+    /** Optional project root */
+    projectRoot: zod_1.z
+        .string()
+        .optional()
+        .describe('Project root directory to search for CMOS database (defaults to cwd)'),
+});
+/**
+ * MCP Tool Definition for cmos_session_start.
+ */
+exports.cmosSessionStartToolDefinition = {
+    name: 'cmos_session_start',
+    description: 'Start a new session for planning, onboarding, review, or research work. Sessions capture insights and decisions outside of mission-oriented build work. Only one session can be active at a time.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            type: {
+                type: 'string',
+                enum: errors_1.VALID_SESSION_TYPES,
+                description: 'Session type: onboarding, planning, review, research, check-in, or custom',
+            },
+            title: {
+                type: 'string',
+                description: 'Short descriptive title for the session (e.g., "Sprint 13 planning")',
+                minLength: 1,
+                maxLength: 255,
+            },
+            agent: {
+                type: 'string',
+                description: 'Agent starting the session (default: "assistant")',
+            },
+            sprintId: {
+                type: 'string',
+                description: 'Optional sprint ID to associate with this session',
+            },
+            autoRefreshMasterContext: {
+                type: 'boolean',
+                description: 'Whether to auto-refresh master_context from recent completed missions/sprints before starting the session (default: true)',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['type', 'title'],
+        additionalProperties: false,
+    },
+};
+/**
+ * Generate a session ID in the format PS-YYYY-MM-DD-NNN.
+ */
+function generateSessionId(existingIds) {
+    const now = new Date();
+    const dateStr = now.toISOString().split('T')[0];
+    const prefix = `PS-${dateStr}-`;
+    // Find the highest counter for today
+    let maxCounter = 0;
+    for (const id of existingIds) {
+        if (id.startsWith(prefix)) {
+            const counterStr = id.slice(prefix.length);
+            const counter = parseInt(counterStr, 10);
+            if (!isNaN(counter) && counter > maxCounter) {
+                maxCounter = counter;
+            }
+        }
+    }
+    return `${prefix}${String(maxCounter + 1).padStart(3, '0')}`;
+}
+/**
+ * Execute the cmos_session_start tool.
+ *
+ * Creates a new session in the database. Only one session can be active at a time.
+ *
+ * @param params - Tool parameters
+ * @returns CmosToolResult with session info or actionable error
+ */
+async function cmosSessionStart(params) {
+    // Explicit empty/whitespace title check returns the domain-specific
+    // MISSING_PARAMETER code rather than a generic Zod validation error.
+    if (!params.title || params.title.trim() === '') {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('title'));
+    }
+    // Validate all remaining parameters against the schema (catches type/length
+    // violations regardless of call site — MCP layer or direct invocation).
+    const parseResult = exports.cmosSessionStartSchema.safeParse(params);
+    if (!parseResult.success) {
+        const firstError = parseResult.error.errors[0];
+        return (0, errors_1.createError)({
+            code: errors_1.CMOS_ERROR_CODES.INVALID_PARAMETER,
+            message: `Validation error: ${firstError?.message ?? 'Unknown error'}`,
+            field: firstError?.path.join('.') || undefined,
+            providedValue: firstError?.path.length
+                ? params[String(firstError.path[0])]
+                : undefined,
+        });
+    }
+    const sessionType = params.type;
+    const title = params.title.trim();
+    const agent = params.agent ?? 'assistant';
+    const autoRefreshMasterContext = params.autoRefreshMasterContext ?? true;
+    return (0, client_1.withClientValidated)((client) => {
+        const warnings = [];
+        // Check for existing active session
+        const activeResult = client.getOne('SELECT id, type, title, started_at FROM sessions WHERE status = ?', ['active']);
+        if (!activeResult.success) {
+            return (0, errors_1.createError)(activeResult.error ?? {
+                code: 'DB_QUERY_FAILED',
+                message: 'Failed to check for active sessions',
+            });
+        }
+        if (activeResult.data) {
+            const active = activeResult.data;
+            return (0, errors_1.createError)({
+                code: errors_1.CMOS_ERROR_CODES.SESSION_ALREADY_ACTIVE,
+                message: `Session '${active.id}' is already active`,
+                suggestion: `Complete the active session first with cmos_session_complete, or use cmos_session_capture to add to it`,
+                currentState: active.id,
+            });
+        }
+        const now = new Date().toISOString();
+        let refreshSummary = {
+            enabled: autoRefreshMasterContext,
+            refreshed: false,
+            missionsAdded: 0,
+            sprintsAdded: 0,
+            snapshotId: null,
+        };
+        if (autoRefreshMasterContext) {
+            const refreshResult = (0, context_freshness_1.refreshMasterContextFromRecentActivity)(client, {
+                source: 'session_start:auto_refresh',
+                now,
+            });
+            warnings.push(...refreshResult.warnings);
+            refreshSummary = {
+                enabled: true,
+                refreshed: refreshResult.refreshed,
+                missionsAdded: refreshResult.missionsAdded,
+                sprintsAdded: refreshResult.sprintsAdded,
+                snapshotId: refreshResult.snapshotId,
+            };
+        }
+        const freshnessResult = (0, context_freshness_1.calculateContextFreshness)(client, { contextId: 'master_context' });
+        warnings.push(...freshnessResult.warnings);
+        const staleWarning = (0, context_freshness_1.buildContextStalenessWarning)(freshnessResult.freshness);
+        if (staleWarning) {
+            const suffix = autoRefreshMasterContext
+                ? 'Auto-refresh ran, but context is still behind the latest activity.'
+                : 'Auto-refresh was disabled for this session start.';
+            warnings.push(`${staleWarning} ${suffix}`);
+        }
+        // Auto-detect active sprint if sprintId not explicitly provided
+        let sprintId = params.sprintId ?? null;
+        let sprintAutoTagged = false;
+        if (!sprintId) {
+            const activeSprintResult = client.getOne("SELECT id FROM sprints WHERE status = 'Active' ORDER BY COALESCE(start_date, '') DESC, rowid DESC LIMIT 1", []);
+            if (activeSprintResult.success && activeSprintResult.data) {
+                sprintId = activeSprintResult.data.id;
+                sprintAutoTagged = true;
+            }
+        }
+        // Insert the new session, retrying on UNIQUE constraint collision (e.g. DB restore
+        // or concurrent write between SELECT and INSERT).
+        const todayPrefix = `PS-${new Date().toISOString().split('T')[0]}-`;
+        const MAX_ID_RETRIES = 3;
+        let sessionId = '';
+        let insertResult = client.execute('SELECT 1', []); // placeholder; overwritten in loop
+        insertResult = { success: false }; // ensure loop runs at least once
+        for (let attempt = 0; attempt < MAX_ID_RETRIES; attempt++) {
+            const existingResult = client.getMany('SELECT id FROM sessions WHERE id LIKE ? ORDER BY id DESC', [`${todayPrefix}%`]);
+            const existingIds = existingResult.success && existingResult.data ? existingResult.data.map((r) => r.id) : [];
+            sessionId = generateSessionId(existingIds);
+            insertResult = client.execute(`INSERT INTO sessions (id, type, title, sprint_id, started_at, agent, status, captures, next_steps, metadata)
+           VALUES (?, ?, ?, ?, ?, ?, 'active', '[]', NULL, NULL)`, [sessionId, sessionType, title, sprintId, now, agent]);
+            if (insertResult.success)
+                break;
+            // Only retry on UNIQUE constraint violation on the session ID field
+            const isIdCollision = insertResult.error?.code === errors_1.CMOS_ERROR_CODES.INVALID_PARAMETER &&
+                insertResult.error?.field === 'id';
+            if (!isIdCollision)
+                break;
+        }
+        if (!insertResult.success) {
+            return (0, errors_1.createError)({
+                code: errors_1.CMOS_ERROR_CODES.DB_QUERY_FAILED,
+                message: `Failed to create session: ${insertResult.error?.message ?? 'Unknown error'}`,
+                suggestion: 'Check database permissions and schema integrity',
+            });
+        }
+        // Insert session event
+        const rawEvent = JSON.stringify({
+            ts: now,
+            agent,
+            session: sessionId,
+            action: 'start',
+            status: 'active',
+            summary: title,
+        });
+        client.execute(`INSERT INTO session_events (ts, agent, mission, action, status, summary, next_hint, raw_event)
+         VALUES (?, ?, ?, 'start', 'active', ?, ?, ?)`, [now, agent, sessionId, title, sprintId, rawEvent]);
+        return (0, errors_1.createSuccess)({
+            sessionId,
+            type: sessionType,
+            title,
+            startedAt: now,
+            agent,
+            sprintId,
+            sprintAutoTagged,
+            contextAutoRefresh: refreshSummary,
+            contextFreshness: freshnessResult.freshness,
+            message: sprintAutoTagged
+                ? `Session '${sessionId}' started: ${title} (auto-tagged to ${sprintId})`
+                : `Session '${sessionId}' started: ${title}`,
+        }, warnings);
+    }, { projectRoot: params.projectRoot });
+}
+/**
+ * Format session start result for LLM readability.
+ */
+function formatSessionStartForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = ['❌ Failed to start session', '', `Error: ${error?.message ?? 'Unknown error'}`];
+        if (error?.suggestion) {
+            lines.push('');
+            lines.push(`Suggestion: ${error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    const data = result.data;
+    const lines = [
+        `🎬 **Session Started**`,
+        '',
+        `**Session ID**: ${data.sessionId}`,
+        `**Type**: ${data.type}`,
+        `**Title**: ${data.title}`,
+        `**Agent**: ${data.agent}`,
+        `**Started**: ${data.startedAt}`,
+    ];
+    if (data.sprintId) {
+        lines.push(`**Sprint**: ${data.sprintId}${data.sprintAutoTagged ? ' (auto-tagged)' : ''}`);
+    }
+    lines.push(`**Auto-refresh**: ${data.contextAutoRefresh.enabled ? 'enabled' : 'disabled'}`);
+    if (data.contextAutoRefresh.enabled) {
+        lines.push(`  refreshed=${data.contextAutoRefresh.refreshed}, missions_added=${data.contextAutoRefresh.missionsAdded}, sprints_added=${data.contextAutoRefresh.sprintsAdded}`);
+    }
+    lines.push(`**Context Freshness**: ${data.contextFreshness.isStale ? 'stale' : 'fresh'}${data.contextFreshness.lagDays !== null
+        ? ` (${data.contextFreshness.lagDays.toFixed(1)} day lag)`
+        : ''}`);
+    if (result.warnings && result.warnings.length > 0) {
+        lines.push('');
+        lines.push('Warnings:');
+        for (const warning of result.warnings) {
+            lines.push(`- ${warning}`);
+        }
+    }
+    lines.push('');
+    lines.push('Next: Use `cmos_session_capture` to record insights, then `cmos_session_complete` when done.');
+    return lines.join('\n');
+}
+//# sourceMappingURL=cmos-session-start.js.map

package/dist/tools/cmos/cmos-session-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-session-start.js","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-session-start.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AA2JH,8CAkBC;AAUD,4CA8LC;AAKD,4DAyDC;AAjbD,6BAAwB;AACxB,qCAA+C;AAE/C,qCAOkB;AAST,oGAXP,4BAAmB,OAWO;AAR5B,2DAK6B;AA+C7B;;GAEG;AACU,QAAA,sBAAsB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC7C,mBAAmB;IACnB,IAAI,EAAE,OAAC;SACJ,IAAI,CAAC,4BAAmB,CAAC;SACzB,QAAQ,CAAC,2EAA2E,CAAC;IAExF,oBAAoB;IACpB,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,CAAC,sEAAsE,CAAC;IAEnF,0BAA0B;IAC1B,KAAK,EAAE,OAAC;SACL,MAAM,EAAE;SACR,OAAO,CAAC,WAAW,CAAC;SACpB,QAAQ,EAAE;SACV,QAAQ,CAAC,mDAAmD,CAAC;IAEhE,yBAAyB;IACzB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;IAE7F,wDAAwD;IACxD,wBAAwB,EAAE,OAAC;SACxB,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,QAAQ,CACP,2HAA2H,CAC5H;IAEH,4BAA4B;IAC5B,WAAW,EAAE,OAAC;SACX,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,sEAAsE,CAAC;CACpF,CAAC,CAAC;AAIH;;GAEG;AACU,QAAA,8BAA8B,GAAG;IAC5C,IAAI,EAAE,oBAAoB;IAC1B,WAAW,EACT,mMAAmM;IACrM,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,4BAAmB;gBACzB,WAAW,EAAE,2EAA2E;aACzF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sEAAsE;gBACnF,SAAS,EAAE,CAAC;gBACZ,SAAS,EAAE,GAAG;aACf;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mDAAmD;aACjE;YACD,wBAAwB,EAAE;gBACxB,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,2HAA2H;aAC9H;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,sEAAsE;aACpF;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;QAC3B,oBAAoB,EAAE,KAAK;KAC5B;CACO,CAAC;AAEX;;GAEG;AACH,SAAgB,iBAAiB,CAAC,WAAqB;IACrD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,OAAO,GAAG,CAAC;IAEhC,qCAAqC;IACrC,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,MAAM,EAAE,IAAI,WAAW,EAAE,CAAC;QAC7B,IAAI,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;gBAC5C,UAAU,GAAG,OAAO,CAAC;YACvB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED;;;;;;;GAOG;AACI,KAAK,UAAU,gBAAgB,CACpC,MAA8B;IAE9B,oEAAoE;IACpE,qEAAqE;IACrE,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAChD,OAAO,IAAA,oBAAW,EAAC,mBAAU,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,4EAA4E;IAC5E,wEAAwE;IACxE,MAAM,WAAW,GAAG,8BAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAC7D,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO,IAAA,oBAAW,EAAC;YACjB,IAAI,EAAE,yBAAgB,CAAC,iBAAiB;YACxC,OAAO,EAAE,qBAAqB,UAAU,EAAE,OAAO,IAAI,eAAe,EAAE;YACtE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS;YAC9C,aAAa,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM;gBACpC,CAAC,CAAE,MAAkC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjE,CAAC,CAAC,SAAS;SACd,CAAC,CAAC;IACL,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC;IAChC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,WAAW,CAAC;IAC1C,MAAM,wBAAwB,GAAG,MAAM,CAAC,wBAAwB,IAAI,IAAI,CAAC;IAEzE,OAAO,IAAA,4BAAmB,EACxB,CAAC,MAAM,EAAE,EAAE;QACT,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,oCAAoC;QACpC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAChC,mEAAmE,EACnE,CAAC,QAAQ,CAAC,CACX,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,IAAA,oBAAW,EAChB,YAAY,CAAC,KAAK,IAAI;gBACpB,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,qCAAqC;aAC/C,CACF,CAAC;QACJ,CAAC;QAED,IAAI,YAAY,CAAC,IAAI,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC;YACjC,OAAO,IAAA,oBAAW,EAAyB;gBACzC,IAAI,EAAE,yBAAgB,CAAC,sBAAsB;gBAC7C,OAAO,EAAE,YAAY,MAAM,CAAC,EAAE,qBAAqB;gBACnD,UAAU,EAAE,wGAAwG;gBACpH,YAAY,EAAE,MAAM,CAAC,EAAE;aACxB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,IAAI,cAAc,GAMd;YACF,OAAO,EAAE,wBAAwB;YACjC,SAAS,EAAE,KAAK;YAChB,aAAa,EAAE,CAAC;YAChB,YAAY,EAAE,CAAC;YACf,UAAU,EAAE,IAAI;SACjB,CAAC;QAEF,IAAI,wBAAwB,EAAE,CAAC;YAC7B,MAAM,aAAa,GAAG,IAAA,0DAAsC,EAAC,MAAM,EAAE;gBACnE,MAAM,EAAE,4BAA4B;gBACpC,GAAG;aACJ,CAAC,CAAC;YACH,QAAQ,CAAC,IAAI,CAAC,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YACzC,cAAc,GAAG;gBACf,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,aAAa,CAAC,SAAS;gBAClC,aAAa,EAAE,aAAa,CAAC,aAAa;gBAC1C,YAAY,EAAE,aAAa,CAAC,YAAY;gBACxC,UAAU,EAAE,aAAa,CAAC,UAAU;aACrC,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,IAAA,6CAAyB,EAAC,MAAM,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC3F,QAAQ,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,YAAY,GAAG,IAAA,gDAA4B,EAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAC7E,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,wBAAwB;gBACrC,CAAC,CAAC,oEAAoE;gBACtE,CAAC,CAAC,mDAAmD,CAAC;YACxD,QAAQ,CAAC,IAAI,CAAC,GAAG,YAAY,IAAI,MAAM,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,gEAAgE;QAChE,IAAI,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC;QACvC,IAAI,gBAAgB,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CACtC,2GAA2G,EAC3G,EAAE,CACH,CAAC;YACF,IAAI,kBAAkB,CAAC,OAAO,IAAI,kBAAkB,CAAC,IAAI,EAAE,CAAC;gBAC1D,QAAQ,GAAG,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;gBACtC,gBAAgB,GAAG,IAAI,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,mFAAmF;QACnF,kDAAkD;QAClD,MAAM,WAAW,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACpE,MAAM,cAAc,GAAG,CAAC,CAAC;QACzB,IAAI,SAAS,GAAG,EAAE,CAAC;QACnB,IAAI,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,mCAAmC;QACtF,YAAY,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,iCAAiC;QAEpE,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,cAAc,EAAE,OAAO,EAAE,EAAE,CAAC;YAC1D,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CACnC,0DAA0D,EAC1D,CAAC,GAAG,WAAW,GAAG,CAAC,CACpB,CAAC;YACF,MAAM,WAAW,GACf,cAAc,CAAC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAE5F,SAAS,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;YAE3C,YAAY,GAAG,MAAM,CAAC,OAAO,CAC3B;iEACuD,EACvD,CAAC,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,CAAC,CACtD,CAAC;YAEF,IAAI,YAAY,CAAC,OAAO;gBAAE,MAAM;YAEhC,oEAAoE;YACpE,MAAM,aAAa,GACjB,YAAY,CAAC,KAAK,EAAE,IAAI,KAAK,yBAAgB,CAAC,iBAAiB;gBAC/D,YAAY,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;YACrC,IAAI,CAAC,aAAa;gBAAE,MAAM;QAC5B,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,IAAA,oBAAW,EAAyB;gBACzC,IAAI,EAAE,yBAAgB,CAAC,eAAe;gBACtC,OAAO,EAAE,6BAA6B,YAAY,CAAC,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE;gBACtF,UAAU,EAAE,iDAAiD;aAC9D,CAAC,CAAC;QACL,CAAC;QAED,uBAAuB;QACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;YAC9B,EAAE,EAAE,GAAG;YACP,KAAK;YACL,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,OAAO;YACf,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CACZ;sDAC8C,EAC9C,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,CACnD,CAAC;QAEF,OAAO,IAAA,sBAAa,EAClB;YACE,SAAS;YACT,IAAI,EAAE,WAAW;YACjB,KAAK;YACL,SAAS,EAAE,GAAG;YACd,KAAK;YACL,QAAQ;YACR,gBAAgB;YAChB,kBAAkB,EAAE,cAAc;YAClC,gBAAgB,EAAE,eAAe,CAAC,SAAS;YAC3C,OAAO,EAAE,gBAAgB;gBACvB,CAAC,CAAC,YAAY,SAAS,cAAc,KAAK,oBAAoB,QAAQ,GAAG;gBACzE,CAAC,CAAC,YAAY,SAAS,cAAc,KAAK,EAAE;SAC/C,EACD,QAAQ,CACT,CAAC;IACJ,CAAC,EACD,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CACpC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAgB,wBAAwB,CAAC,MAA8C;IACrF,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,MAAM,KAAK,GAAG,CAAC,2BAA2B,EAAE,EAAE,EAAE,UAAU,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE,CAAC,CAAC;QAE/F,IAAI,KAAK,EAAE,UAAU,EAAE,CAAC;YACtB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;IACzB,MAAM,KAAK,GAAG;QACZ,wBAAwB;QACxB,EAAE;QACF,mBAAmB,IAAI,CAAC,SAAS,EAAE;QACnC,aAAa,IAAI,CAAC,IAAI,EAAE;QACxB,cAAc,IAAI,CAAC,KAAK,EAAE;QAC1B,cAAc,IAAI,CAAC,KAAK,EAAE;QAC1B,gBAAgB,IAAI,CAAC,SAAS,EAAE;KACjC,CAAC;IAEF,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC7F,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;IAC5F,IAAI,IAAI,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CACR,eAAe,IAAI,CAAC,kBAAkB,CAAC,SAAS,oBAAoB,IAAI,CAAC,kBAAkB,CAAC,aAAa,mBAAmB,IAAI,CAAC,kBAAkB,CAAC,YAAY,EAAE,CACnK,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CACR,0BAA0B,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GACzE,IAAI,CAAC,gBAAgB,CAAC,OAAO,KAAK,IAAI;QACpC,CAAC,CAAC,KAAK,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW;QAC1D,CAAC,CAAC,EACN,EAAE,CACH,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CACR,8FAA8F,CAC/F,CAAC;IAEF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/cmos/cmos-session.d.ts

@@ -0,0 +1,223 @@
+/**
+ * cmos_session Tool
+ *
+ * Consolidated session tool with action parameter support.
+ * Actions: list, start, capture, complete.
+ * Routes to existing session handlers without rewriting business logic.
+ *
+ * @module tools/cmos/cmos-session
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+import { type CmosSessionListResult } from './cmos-session-list';
+import { type CmosSessionStartResult } from './cmos-session-start';
+import { type CmosSessionCaptureResult } from './cmos-session-capture';
+import { type CmosSessionCompleteResult } from './cmos-session-complete';
+export declare const CMOS_SESSION_ACTIONS: readonly ["list", "start", "capture", "complete"];
+export type CmosSessionAction = (typeof CMOS_SESSION_ACTIONS)[number];
+export type CmosSessionResult = CmosSessionListResult | CmosSessionStartResult | CmosSessionCaptureResult | CmosSessionCompleteResult;
+export declare const cmosSessionSchema: z.ZodObject<{
+    action: z.ZodEnum<["list", "start", "capture", "complete"]>;
+    status: z.ZodOptional<z.ZodEnum<["active", "completed", "canceled"]>>;
+    type: z.ZodOptional<z.ZodEnum<["onboarding", "planning", "review", "research", "check-in", "custom"]>>;
+    sprintId: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    title: z.ZodOptional<z.ZodString>;
+    agent: z.ZodOptional<z.ZodString>;
+    autoRefreshMasterContext: z.ZodOptional<z.ZodBoolean>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    category: z.ZodOptional<z.ZodEnum<["decision", "learning", "constraint", "context", "next-step"]>>;
+    content: z.ZodOptional<z.ZodString>;
+    context: z.ZodOptional<z.ZodString>;
+    missionId: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        id: string;
+    }, {
+        type: string;
+        id: string;
+    }>, "many">>;
+    citesLearningIds: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    summary: z.ZodOptional<z.ZodString>;
+    nextSteps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    decisions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    action: "list" | "start" | "capture" | "complete";
+    projectRoot?: string | undefined;
+    status?: "active" | "completed" | "canceled" | undefined;
+    category?: "context" | "constraint" | "decision" | "learning" | "next-step" | undefined;
+    evidence?: {
+        type: string;
+        id: string;
+    }[] | undefined;
+    agent?: string | undefined;
+    type?: "onboarding" | "planning" | "review" | "research" | "check-in" | "custom" | undefined;
+    sprintId?: string | undefined;
+    missionId?: string | undefined;
+    title?: string | undefined;
+    context?: string | undefined;
+    content?: string | undefined;
+    decisions?: string[] | undefined;
+    nextSteps?: string[] | undefined;
+    summary?: string | undefined;
+    sessionId?: string | undefined;
+    page?: number | undefined;
+    pageSize?: number | undefined;
+    autoRefreshMasterContext?: boolean | undefined;
+    citesLearningIds?: number[] | undefined;
+}, {
+    action: "list" | "start" | "capture" | "complete";
+    projectRoot?: string | undefined;
+    status?: "active" | "completed" | "canceled" | undefined;
+    category?: "context" | "constraint" | "decision" | "learning" | "next-step" | undefined;
+    evidence?: {
+        type: string;
+        id: string;
+    }[] | undefined;
+    agent?: string | undefined;
+    type?: "onboarding" | "planning" | "review" | "research" | "check-in" | "custom" | undefined;
+    sprintId?: string | undefined;
+    missionId?: string | undefined;
+    title?: string | undefined;
+    context?: string | undefined;
+    content?: string | undefined;
+    decisions?: string[] | undefined;
+    nextSteps?: string[] | undefined;
+    summary?: string | undefined;
+    sessionId?: string | undefined;
+    page?: number | undefined;
+    pageSize?: number | undefined;
+    autoRefreshMasterContext?: boolean | undefined;
+    citesLearningIds?: number[] | undefined;
+}>;
+export type CmosSessionParams = z.infer<typeof cmosSessionSchema>;
+export declare const cmosSessionToolDefinition: {
+    readonly name: "cmos_session";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["list", "start", "capture", "complete"];
+                readonly description: "Session action: list | start | capture | complete";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["active", "completed", "canceled"];
+                readonly description: "Filter by session status for list action";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["onboarding", "planning", "review", "research", "check-in", "custom"];
+                readonly description: "Session type for list/start actions";
+            };
+            readonly sprintId: {
+                readonly type: "string";
+                readonly description: "Sprint ID filter for list action";
+            };
+            readonly page: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly description: "Page number for list action";
+            };
+            readonly pageSize: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly description: "Page size for list action";
+            };
+            readonly title: {
+                readonly type: "string";
+                readonly description: "Session title for start action";
+            };
+            readonly agent: {
+                readonly type: "string";
+                readonly description: "Agent identifier for start/capture/complete actions";
+            };
+            readonly autoRefreshMasterContext: {
+                readonly type: "boolean";
+                readonly description: "Auto-refresh master context on start";
+            };
+            readonly sessionId: {
+                readonly type: "string";
+                readonly description: "Session ID for capture/complete actions";
+            };
+            readonly category: {
+                readonly type: "string";
+                readonly enum: readonly ["decision", "learning", "constraint", "context", "next-step"];
+                readonly description: "Capture category for capture action";
+            };
+            readonly content: {
+                readonly type: "string";
+                readonly description: "Capture content for capture action";
+            };
+            readonly context: {
+                readonly type: "string";
+                readonly description: "Additional context for capture action";
+            };
+            readonly missionId: {
+                readonly type: "string";
+                readonly description: "Associated mission ID for capture action";
+            };
+            readonly evidence: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly description: "Evidence type";
+                        };
+                        readonly id: {
+                            readonly type: "string";
+                            readonly description: "Evidence identifier";
+                        };
+                    };
+                    readonly required: readonly ["type", "id"];
+                };
+                readonly description: "Array of TraceLab evidence references [{type, id}] for decision captures";
+            };
+            readonly citesLearningIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                };
+                readonly description: "Learning IDs this capture/decision cites. Bumps last_reviewed_at on each — applies to capture(category=decision|learning) and complete(decisions[]).";
+            };
+            readonly summary: {
+                readonly type: "string";
+                readonly description: "Session summary for complete action";
+            };
+            readonly nextSteps: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Next steps for complete action";
+            };
+            readonly decisions: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Decisions captured at session close; each entry is inserted into strategic_decisions";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["action"];
+        readonly additionalProperties: false;
+    };
+};
+export declare function cmosSession(params: CmosSessionParams): Promise<CmosToolResult<CmosSessionResult>>;
+export declare function formatSessionForLLM(action: string | undefined, result: CmosToolResult<CmosSessionResult>): string;
+//# sourceMappingURL=cmos-session.d.ts.map

package/dist/tools/cmos/cmos-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-session.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAKL,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAKL,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AAGjC,eAAO,MAAM,oBAAoB,mDAAoD,CAAC;AAEtF,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,MAAM,iBAAiB,GACzB,qBAAqB,GACrB,sBAAsB,GACtB,wBAAwB,GACxB,yBAAyB,CAAC;AAE9B,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkEnB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqF5B,CAAC;AAMX,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAyD5C;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,GACxC,MAAM,CAmCR"}