@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,374 @@
+"use strict";
+/**
+ * cmos_session_search Tool
+ *
+ * MCP tool for searching session history by keyword.
+ * Searches across titles, summaries, and captures.
+ *
+ * @module tools/cmos/cmos-session-search
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosSessionSearchToolDefinition = exports.cmosSessionSearchSchema = exports.VALID_SESSION_TYPES = void 0;
+exports.cmosSessionSearch = cmosSessionSearch;
+exports.formatSessionSearchForLLM = formatSessionSearchForLLM;
+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 cmos_session_capture_1 = require("./cmos-session-capture");
+/**
+ * Input parameters schema for cmos_session_search tool.
+ */
+exports.cmosSessionSearchSchema = zod_1.z.object({
+    /** Search query (required) */
+    query: zod_1.z
+        .string()
+        .min(1)
+        .describe('Search query - keywords to find in session titles, summaries, and captures'),
+    /** Filter by capture category */
+    category: zod_1.z
+        .enum(cmos_session_capture_1.VALID_CAPTURE_CATEGORIES)
+        .optional()
+        .describe('Filter by capture category: decision, learning, constraint, context, next-step'),
+    /** Filter by session type */
+    type: zod_1.z
+        .enum(errors_1.VALID_SESSION_TYPES)
+        .optional()
+        .describe('Filter by session type: planning, review, research, onboarding, check-in, custom'),
+    /** Filter sessions created after this date */
+    since: zod_1.z
+        .string()
+        .optional()
+        .describe('Filter sessions started after this ISO date (e.g., "2024-01-01")'),
+    /** Filter sessions created before this date */
+    until: zod_1.z.string().optional().describe('Filter sessions started before this ISO date'),
+    /** Maximum results to return */
+    limit: zod_1.z
+        .number()
+        .min(1)
+        .max(100)
+        .default(20)
+        .optional()
+        .describe('Maximum sessions to return (1-100, default: 20)'),
+    /** 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_search.
+ */
+exports.cmosSessionSearchToolDefinition = {
+    name: 'cmos_session_search',
+    description: 'Search session history by keyword. Searches across titles, summaries, and captures. Supports filtering by capture category, session type, and date range.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                minLength: 1,
+                description: 'Search query - keywords to find in session titles, summaries, and captures',
+            },
+            category: {
+                type: 'string',
+                enum: cmos_session_capture_1.VALID_CAPTURE_CATEGORIES,
+                description: 'Filter by capture category: decision, learning, constraint, context, next-step',
+            },
+            type: {
+                type: 'string',
+                enum: errors_1.VALID_SESSION_TYPES,
+                description: 'Filter by session type: planning, review, research, onboarding, check-in, custom',
+            },
+            since: {
+                type: 'string',
+                description: 'Filter sessions started after this ISO date (e.g., "2024-01-01")',
+            },
+            until: {
+                type: 'string',
+                description: 'Filter sessions started before this ISO date',
+            },
+            limit: {
+                type: 'number',
+                minimum: 1,
+                maximum: 100,
+                description: 'Maximum sessions to return (1-100, default: 20)',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['query'],
+        additionalProperties: false,
+    },
+};
+/**
+ * Execute the cmos_session_search tool.
+ *
+ * Searches sessions using SQLite LIKE with multiple keywords.
+ *
+ * @param params - Tool parameters
+ * @returns CmosToolResult with search results
+ */
+async function cmosSessionSearch(params) {
+    if (!params.query || params.query.trim().length === 0) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('query'));
+    }
+    const limit = params.limit ?? 20;
+    const query = params.query.trim().toLowerCase();
+    // Split query into keywords for better matching
+    const keywords = query.split(/\s+/).filter((k) => k.length >= 2);
+    if (keywords.length === 0) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.invalidParameter('query', query, ['At least one keyword with 2+ characters']));
+    }
+    return (0, client_1.withClient)((client) => {
+        // Build WHERE clauses for session-level filters
+        const clauses = [];
+        const queryParams = [];
+        // Add session type filter
+        if (params.type) {
+            clauses.push('type = ?');
+            queryParams.push(params.type);
+        }
+        // Add date range filters
+        if (params.since) {
+            clauses.push('started_at >= ?');
+            queryParams.push(params.since);
+        }
+        if (params.until) {
+            clauses.push('started_at <= ?');
+            queryParams.push(params.until);
+        }
+        // Build search condition (search in title, summary, and captures)
+        const searchConditions = [];
+        for (const keyword of keywords) {
+            searchConditions.push(`(LOWER(title) LIKE ? OR LOWER(COALESCE(summary, '')) LIKE ? OR LOWER(COALESCE(captures, '')) LIKE ?)`);
+            queryParams.push(`%${keyword}%`, `%${keyword}%`, `%${keyword}%`);
+        }
+        if (searchConditions.length > 0) {
+            clauses.push(`(${searchConditions.join(' AND ')})`);
+        }
+        const whereClause = clauses.length > 0 ? `WHERE ${clauses.join(' AND ')}` : '';
+        // Get matching sessions
+        const result = client.getMany(`SELECT id, type, title, status, sprint_id, started_at, completed_at, summary, captures
+           FROM sessions
+           ${whereClause}
+          ORDER BY started_at DESC
+          LIMIT ?`, [...queryParams, limit + 10] // Fetch extra for filtering
+        );
+        if (!result.success || !result.data) {
+            return (0, errors_1.createSuccess)({
+                query: params.query,
+                results: [],
+                totalMatches: 0,
+                limited: false,
+                filters: {
+                    category: params.category,
+                    type: params.type,
+                    since: params.since,
+                    until: params.until,
+                },
+            });
+        }
+        // Process results and compute relevance
+        const processedResults = [];
+        for (const row of result.data) {
+            // Parse captures JSON
+            let captures = [];
+            try {
+                captures = JSON.parse(row.captures || '[]');
+            }
+            catch {
+                captures = [];
+            }
+            // Filter captures by category if specified
+            if (params.category) {
+                captures = captures.filter((c) => c.category === params.category);
+            }
+            // Find matches
+            const matchedIn = [];
+            let relevance = 0;
+            // Check title
+            const titleLower = row.title.toLowerCase();
+            for (const keyword of keywords) {
+                if (titleLower.includes(keyword)) {
+                    if (!matchedIn.includes('title'))
+                        matchedIn.push('title');
+                    relevance += 3; // Title matches are weighted higher
+                }
+            }
+            // Check summary
+            const summaryLower = (row.summary || '').toLowerCase();
+            for (const keyword of keywords) {
+                if (summaryLower.includes(keyword)) {
+                    if (!matchedIn.includes('summary'))
+                        matchedIn.push('summary');
+                    relevance += 2; // Summary matches are weighted medium
+                }
+            }
+            // Check captures and find matching ones
+            const matchedCaptures = [];
+            for (const capture of captures) {
+                const contentLower = capture.content.toLowerCase();
+                let captureMatches = false;
+                for (const keyword of keywords) {
+                    if (contentLower.includes(keyword)) {
+                        captureMatches = true;
+                        relevance += 1;
+                    }
+                }
+                if (captureMatches) {
+                    if (!matchedIn.includes('captures'))
+                        matchedIn.push('captures');
+                    // Create highlight snippet
+                    const highlight = createHighlight(capture.content, keywords);
+                    matchedCaptures.push({
+                        category: capture.category,
+                        content: capture.content,
+                        timestamp: capture.timestamp,
+                        highlight,
+                    });
+                }
+            }
+            // Skip if no matches found
+            if (matchedIn.length === 0)
+                continue;
+            // Skip if category filter is set and no matching captures
+            if (params.category &&
+                matchedCaptures.length === 0 &&
+                !matchedIn.includes('title') &&
+                !matchedIn.includes('summary')) {
+                continue;
+            }
+            processedResults.push({
+                id: row.id,
+                type: row.type,
+                title: row.title,
+                status: row.status,
+                sprintId: row.sprint_id,
+                startedAt: row.started_at,
+                completedAt: row.completed_at,
+                summary: row.summary,
+                captureCount: captures.length,
+                matchedCaptures,
+                matchedIn,
+                relevance,
+            });
+        }
+        // Sort by relevance
+        processedResults.sort((a, b) => b.relevance - a.relevance);
+        // Apply limit
+        const limitedResults = processedResults.slice(0, limit);
+        const totalMatches = processedResults.length;
+        return (0, errors_1.createSuccess)({
+            query: params.query,
+            results: limitedResults,
+            totalMatches,
+            limited: totalMatches > limit,
+            filters: {
+                category: params.category,
+                type: params.type,
+                since: params.since,
+                until: params.until,
+            },
+        });
+    }, { projectRoot: params.projectRoot });
+}
+/**
+ * Create a highlight snippet showing keyword matches in context.
+ */
+function createHighlight(content, keywords) {
+    const maxLength = 100;
+    const contentLower = content.toLowerCase();
+    // Find first keyword position
+    let firstMatchPos = content.length;
+    for (const keyword of keywords) {
+        const pos = contentLower.indexOf(keyword);
+        if (pos !== -1 && pos < firstMatchPos) {
+            firstMatchPos = pos;
+        }
+    }
+    // Extract snippet around the match
+    const start = Math.max(0, firstMatchPos - 20);
+    const end = Math.min(content.length, firstMatchPos + maxLength - 20);
+    let snippet = content.slice(start, end);
+    // Add ellipsis if truncated
+    if (start > 0)
+        snippet = '...' + snippet;
+    if (end < content.length)
+        snippet = snippet + '...';
+    return snippet;
+}
+/**
+ * Format session search result for LLM readability.
+ *
+ * @param result - Session search result
+ * @returns Human-readable summary
+ */
+function formatSessionSearchForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        return [
+            '? Failed to search sessions',
+            '',
+            `Error: ${error?.message ?? 'Unknown error'}`,
+            error?.suggestion ? `Suggestion: ${error.suggestion}` : '',
+        ]
+            .filter(Boolean)
+            .join('\n');
+    }
+    const data = result.data;
+    const lines = [];
+    // Header
+    lines.push('? **Session Search Results**');
+    lines.push('');
+    lines.push(`Query: "${data.query}"`);
+    lines.push(`Found: ${data.totalMatches} session${data.totalMatches === 1 ? '' : 's'}`);
+    // Show filters if applied
+    const activeFilters = [];
+    if (data.filters.category)
+        activeFilters.push(`category: ${data.filters.category}`);
+    if (data.filters.type)
+        activeFilters.push(`type: ${data.filters.type}`);
+    if (data.filters.since)
+        activeFilters.push(`since: ${data.filters.since}`);
+    if (data.filters.until)
+        activeFilters.push(`until: ${data.filters.until}`);
+    if (activeFilters.length > 0) {
+        lines.push(`Filters: ${activeFilters.join(', ')}`);
+    }
+    if (data.limited) {
+        lines.push(`(Showing top ${data.results.length} results)`);
+    }
+    lines.push('');
+    if (data.results.length === 0) {
+        lines.push('No sessions found matching the query.');
+        lines.push('');
+        lines.push('**Suggestions**:');
+        lines.push('  - Try different keywords');
+        lines.push('  - Remove filters to broaden search');
+        lines.push('  - Use cmos_session_list to browse all sessions');
+        return lines.join('\n');
+    }
+    // List results
+    for (const r of data.results) {
+        const statusIcon = r.status === 'active' ? '?' : '?';
+        lines.push(`${statusIcon} **${r.title}** (${r.type})`);
+        lines.push(`   ID: ${r.id} | Status: ${r.status}`);
+        lines.push(`   Started: ${r.startedAt}${r.completedAt ? ` | Completed: ${r.completedAt}` : ''}`);
+        lines.push(`   Matched in: ${r.matchedIn.join(', ')} | Relevance: ${r.relevance}`);
+        if (r.matchedCaptures.length > 0) {
+            lines.push(`   Matching captures (${r.matchedCaptures.length}):`);
+            for (const mc of r.matchedCaptures.slice(0, 3)) {
+                lines.push(`     - [${mc.category}] ${mc.highlight}`);
+            }
+            if (r.matchedCaptures.length > 3) {
+                lines.push(`     ... and ${r.matchedCaptures.length - 3} more`);
+            }
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=cmos-session-search.js.map

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

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

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

@@ -0,0 +1,136 @@
+/**
+ * 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
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+import { VALID_SESSION_TYPES, type SessionType } from './errors';
+import { type ContextFreshness } from './context-freshness';
+export { VALID_SESSION_TYPES };
+export type { SessionType };
+/**
+ * Result of session start operation.
+ */
+export interface CmosSessionStartResult {
+    /** Generated session ID (e.g., PS-2024-12-10-001) */
+    sessionId: string;
+    /** Session type */
+    type: SessionType;
+    /** Session title */
+    title: string;
+    /** When the session was started */
+    startedAt: string;
+    /** Agent that started the session */
+    agent: string;
+    /** Associated sprint ID (if any) */
+    sprintId: string | null;
+    /** Whether the sprintId was auto-detected from the active sprint */
+    sprintAutoTagged: boolean;
+    /** Master context auto-refresh status for this start operation */
+    contextAutoRefresh: {
+        enabled: boolean;
+        refreshed: boolean;
+        missionsAdded: number;
+        sprintsAdded: number;
+        snapshotId: number | null;
+    };
+    /** Freshness of master_context after start handling */
+    contextFreshness: ContextFreshness;
+    /** Message describing the result */
+    message: string;
+}
+/**
+ * Input parameters schema for cmos_session_start tool.
+ */
+export declare const cmosSessionStartSchema: z.ZodObject<{
+    /** Session type */
+    type: z.ZodEnum<["onboarding", "planning", "review", "research", "check-in", "custom"]>;
+    /** Session title */
+    title: z.ZodString;
+    /** Optional agent name */
+    agent: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    /** Optional sprint ID */
+    sprintId: z.ZodOptional<z.ZodString>;
+    /** Optional auto-refresh behavior for master_context */
+    autoRefreshMasterContext: z.ZodOptional<z.ZodBoolean>;
+    /** Optional project root */
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "onboarding" | "planning" | "review" | "research" | "check-in" | "custom";
+    title: string;
+    projectRoot?: string | undefined;
+    agent?: string | undefined;
+    sprintId?: string | undefined;
+    autoRefreshMasterContext?: boolean | undefined;
+}, {
+    type: "onboarding" | "planning" | "review" | "research" | "check-in" | "custom";
+    title: string;
+    projectRoot?: string | undefined;
+    agent?: string | undefined;
+    sprintId?: string | undefined;
+    autoRefreshMasterContext?: boolean | undefined;
+}>;
+export type CmosSessionStartParams = z.infer<typeof cmosSessionStartSchema>;
+/**
+ * MCP Tool Definition for cmos_session_start.
+ */
+export declare const cmosSessionStartToolDefinition: {
+    readonly name: "cmos_session_start";
+    readonly 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.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["onboarding", "planning", "review", "research", "check-in", "custom"];
+                readonly description: "Session type: onboarding, planning, review, research, check-in, or custom";
+            };
+            readonly title: {
+                readonly type: "string";
+                readonly description: "Short descriptive title for the session (e.g., \"Sprint 13 planning\")";
+                readonly minLength: 1;
+                readonly maxLength: 255;
+            };
+            readonly agent: {
+                readonly type: "string";
+                readonly description: "Agent starting the session (default: \"assistant\")";
+            };
+            readonly sprintId: {
+                readonly type: "string";
+                readonly description: "Optional sprint ID to associate with this session";
+            };
+            readonly autoRefreshMasterContext: {
+                readonly type: "boolean";
+                readonly description: "Whether to auto-refresh master_context from recent completed missions/sprints before starting the session (default: true)";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["type", "title"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Generate a session ID in the format PS-YYYY-MM-DD-NNN.
+ */
+export declare function generateSessionId(existingIds: string[]): string;
+/**
+ * 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
+ */
+export declare function cmosSessionStart(params: CmosSessionStartParams): Promise<CmosToolResult<CmosSessionStartResult>>;
+/**
+ * Format session start result for LLM readability.
+ */
+export declare function formatSessionStartForLLM(result: CmosToolResult<CmosSessionStartResult>): string;
+//# sourceMappingURL=cmos-session-start.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-session-start.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-session-start.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,SAAS,CAAC;AACvD,OAAO,EAKL,mBAAmB,EACnB,KAAK,WAAW,EACjB,MAAM,UAAU,CAAC;AAClB,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAC/B,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAElB,mBAAmB;IACnB,IAAI,EAAE,WAAW,CAAC;IAElB,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IAEd,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAElB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IAEd,oCAAoC;IACpC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,oEAAoE;IACpE,gBAAgB,EAAE,OAAO,CAAC;IAE1B,kEAAkE;IAClE,kBAAkB,EAAE;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B,CAAC;IAEF,uDAAuD;IACvD,gBAAgB,EAAE,gBAAgB,CAAC;IAEnC,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB;IACjC,mBAAmB;;IAKnB,oBAAoB;;IAOpB,0BAA0B;;IAO1B,yBAAyB;;IAGzB,wDAAwD;;IAQxD,4BAA4B;;;;;;;;;;;;;;;;EAK5B,CAAC;AAEH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCjC,CAAC;AAEX;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAkB/D;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC,cAAc,CAAC,sBAAsB,CAAC,CAAC,CA4LjD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,CAAC,sBAAsB,CAAC,GAAG,MAAM,CAyD/F"}