@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,255 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosSessionToolDefinition = exports.cmosSessionSchema = exports.CMOS_SESSION_ACTIONS = void 0;
+exports.cmosSession = cmosSession;
+exports.formatSessionForLLM = formatSessionForLLM;
+const zod_1 = require("zod");
+const errors_1 = require("./errors");
+const cmos_session_list_1 = require("./cmos-session-list");
+const cmos_session_start_1 = require("./cmos-session-start");
+const cmos_session_capture_1 = require("./cmos-session-capture");
+const cmos_session_complete_1 = require("./cmos-session-complete");
+const checkpoint_backfill_1 = require("./checkpoint-backfill");
+exports.CMOS_SESSION_ACTIONS = ['list', 'start', 'capture', 'complete'];
+exports.cmosSessionSchema = zod_1.z
+    .object({
+    action: zod_1.z
+        .enum(exports.CMOS_SESSION_ACTIONS)
+        .describe('Session action: list | start | capture | complete'),
+    // list params
+    status: zod_1.z
+        .enum(cmos_session_list_1.VALID_SESSION_STATUSES)
+        .optional()
+        .describe('Filter by session status for list action'),
+    type: zod_1.z
+        .enum(errors_1.VALID_SESSION_TYPES)
+        .optional()
+        .describe('Session type filter for list, or type for start action'),
+    sprintId: zod_1.z.string().optional().describe('Sprint ID filter for list action'),
+    page: zod_1.z.number().int().positive().optional().describe('Page number for list action'),
+    pageSize: zod_1.z.number().int().positive().max(100).optional().describe('Page size for list action'),
+    // start params
+    title: zod_1.z.string().optional().describe('Session title for start action (required for start)'),
+    agent: zod_1.z.string().optional().describe('Agent identifier for start/capture/complete actions'),
+    autoRefreshMasterContext: zod_1.z
+        .boolean()
+        .optional()
+        .describe('Auto-refresh master context on start'),
+    // capture params
+    sessionId: zod_1.z
+        .string()
+        .optional()
+        .describe('Session ID (auto-detected if omitted) for capture/complete actions'),
+    category: zod_1.z
+        .enum(cmos_session_capture_1.VALID_CAPTURE_CATEGORIES)
+        .optional()
+        .describe('Capture category for capture action (required for capture)'),
+    content: zod_1.z
+        .string()
+        .optional()
+        .describe('Capture content for capture action (required for capture)'),
+    context: zod_1.z.string().optional().describe('Additional context for capture action'),
+    missionId: zod_1.z.string().optional().describe('Associated mission ID for capture action'),
+    evidence: zod_1.z
+        .array(zod_1.z.object({ type: zod_1.z.string(), id: zod_1.z.string() }))
+        .optional()
+        .describe('Array of TraceLab evidence references [{type, id}] for decision captures'),
+    citesLearningIds: zod_1.z
+        .array(zod_1.z.number().int().positive())
+        .optional()
+        .describe('Learning IDs this capture/decision cites. Bumps last_reviewed_at on each — applies to capture(category=decision|learning) and complete(decisions[]).'),
+    // complete params
+    summary: zod_1.z
+        .string()
+        .optional()
+        .describe('Session summary for complete action (required for complete)'),
+    nextSteps: zod_1.z.array(zod_1.z.string()).optional().describe('Next steps for complete action'),
+    decisions: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe('Decisions captured at session close; each entry is inserted into strategic_decisions'),
+    projectRoot: zod_1.z
+        .string()
+        .optional()
+        .describe('Project root directory to search for CMOS database (defaults to cwd)'),
+})
+    .strict();
+exports.cmosSessionToolDefinition = {
+    name: 'cmos_session',
+    description: 'Consolidated session tool with action parameter support. ' +
+        'Actions: list, start, capture, complete. ' +
+        'Routes to the existing session handlers without changing session business logic.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: [...exports.CMOS_SESSION_ACTIONS],
+                description: 'Session action: list | start | capture | complete',
+            },
+            status: {
+                type: 'string',
+                enum: [...cmos_session_list_1.VALID_SESSION_STATUSES],
+                description: 'Filter by session status for list action',
+            },
+            type: {
+                type: 'string',
+                enum: [...errors_1.VALID_SESSION_TYPES],
+                description: 'Session type for list/start actions',
+            },
+            sprintId: { type: 'string', description: 'Sprint ID filter for list action' },
+            page: { type: 'number', minimum: 1, description: 'Page number for list action' },
+            pageSize: {
+                type: 'number',
+                minimum: 1,
+                maximum: 100,
+                description: 'Page size for list action',
+            },
+            title: { type: 'string', description: 'Session title for start action' },
+            agent: { type: 'string', description: 'Agent identifier for start/capture/complete actions' },
+            autoRefreshMasterContext: {
+                type: 'boolean',
+                description: 'Auto-refresh master context on start',
+            },
+            sessionId: { type: 'string', description: 'Session ID for capture/complete actions' },
+            category: {
+                type: 'string',
+                enum: [...cmos_session_capture_1.VALID_CAPTURE_CATEGORIES],
+                description: 'Capture category for capture action',
+            },
+            content: { type: 'string', description: 'Capture content for capture action' },
+            context: { type: 'string', description: 'Additional context for capture action' },
+            missionId: { type: 'string', description: 'Associated mission ID for capture action' },
+            evidence: {
+                type: 'array',
+                items: {
+                    type: 'object',
+                    properties: {
+                        type: { type: 'string', description: 'Evidence type' },
+                        id: { type: 'string', description: 'Evidence identifier' },
+                    },
+                    required: ['type', 'id'],
+                },
+                description: 'Array of TraceLab evidence references [{type, id}] for decision captures',
+            },
+            citesLearningIds: {
+                type: 'array',
+                items: { type: 'integer', minimum: 1 },
+                description: 'Learning IDs this capture/decision cites. Bumps last_reviewed_at on each — applies to capture(category=decision|learning) and complete(decisions[]).',
+            },
+            summary: { type: 'string', description: 'Session summary for complete action' },
+            nextSteps: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Next steps for complete action',
+            },
+            decisions: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Decisions captured at session close; each entry is inserted into strategic_decisions',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['action'],
+        additionalProperties: false,
+    },
+};
+function isSessionAction(value) {
+    return exports.CMOS_SESSION_ACTIONS.includes(value);
+}
+async function cmosSession(params) {
+    const actionValue = typeof params.action === 'string' ? params.action : '';
+    if (!isSessionAction(actionValue)) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.invalidAction('cmos_session', actionValue, exports.CMOS_SESSION_ACTIONS));
+    }
+    switch (actionValue) {
+        case 'list':
+            return (0, cmos_session_list_1.cmosSessionList)({
+                status: params.status,
+                type: params.type,
+                sprintId: params.sprintId,
+                page: params.page,
+                pageSize: params.pageSize,
+                projectRoot: params.projectRoot,
+            });
+        case 'start':
+            return (0, cmos_session_start_1.cmosSessionStart)({
+                type: params.type ?? 'planning',
+                title: params.title ?? '',
+                agent: params.agent,
+                sprintId: params.sprintId,
+                autoRefreshMasterContext: params.autoRefreshMasterContext,
+                projectRoot: params.projectRoot,
+            });
+        case 'capture':
+            return (0, cmos_session_capture_1.cmosSessionCapture)({
+                sessionId: params.sessionId,
+                category: params.category ?? 'context',
+                content: params.content ?? '',
+                context: params.context,
+                missionId: params.missionId,
+                evidence: params.evidence,
+                agent: params.agent,
+                citesLearningIds: params.citesLearningIds,
+                projectRoot: params.projectRoot,
+            });
+        case 'complete': {
+            const result = await (0, cmos_session_complete_1.cmosSessionComplete)({
+                sessionId: params.sessionId,
+                summary: params.summary ?? '',
+                nextSteps: params.nextSteps,
+                decisions: params.decisions,
+                agent: params.agent,
+                citesLearningIds: params.citesLearningIds,
+                projectRoot: params.projectRoot,
+            });
+            if (result.success) {
+                (0, checkpoint_backfill_1.triggerCheckpointBackfill)({ projectRoot: params.projectRoot, force: false });
+            }
+            return result;
+        }
+    }
+}
+function formatSessionForLLM(action, result) {
+    if (!result.success && result.error?.code === 'INVALID_ACTION') {
+        const availableActions = result.error.availableActions ??
+            result.error.available_actions ??
+            result.error.validValues ??
+            [];
+        const lines = ['❌ Failed to execute cmos_session', '', `Error: ${result.error.message}`];
+        if (availableActions.length > 0) {
+            lines.push('');
+            lines.push(`Available actions: ${availableActions.join(', ')}`);
+        }
+        if (result.error.suggestion) {
+            lines.push('');
+            lines.push(`Suggestion: ${result.error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    switch (action) {
+        case 'list':
+            return (0, cmos_session_list_1.formatSessionListForLLM)(result);
+        case 'start':
+            return (0, cmos_session_start_1.formatSessionStartForLLM)(result);
+        case 'capture':
+            return (0, cmos_session_capture_1.formatSessionCaptureForLLM)(result);
+        case 'complete':
+            return (0, cmos_session_complete_1.formatSessionCompleteForLLM)(result);
+        default:
+            return result.success ? '✓ Session action completed' : '❌ Failed to execute cmos_session';
+    }
+}
+//# sourceMappingURL=cmos-session.js.map

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

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

package/dist/tools/cmos/cmos-sprint-add.d.ts

@@ -0,0 +1,114 @@
+/**
+ * cmos_sprint_add Tool
+ *
+ * MCP tool for creating new sprints in the CMOS database.
+ * Validates sprint ID uniqueness and required fields.
+ *
+ * @module tools/cmos/cmos-sprint-add
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+/**
+ * Result type for cmos_sprint_add.
+ */
+export interface SprintAddResult {
+    /** Created sprint ID */
+    id: string;
+    /** Sprint title */
+    title: string;
+    /** Confirmation message */
+    message: string;
+}
+/**
+ * Input parameters schema for cmos_sprint_add tool.
+ */
+export declare const cmosSprintAddSchema: z.ZodObject<{
+    /** Unique sprint identifier */
+    sprintId: z.ZodString;
+    /** Sprint title */
+    title: z.ZodString;
+    /** Strategic focus of the sprint */
+    focus: z.ZodOptional<z.ZodString>;
+    /** Sprint status */
+    status: z.ZodOptional<z.ZodString>;
+    /** Start date in ISO format */
+    startDate: z.ZodOptional<z.ZodString>;
+    /** End date in ISO format */
+    endDate: z.ZodOptional<z.ZodString>;
+    /** Optional: explicit project root to search from */
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sprintId: string;
+    title: string;
+    projectRoot?: string | undefined;
+    status?: string | undefined;
+    focus?: string | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+}, {
+    sprintId: string;
+    title: string;
+    projectRoot?: string | undefined;
+    status?: string | undefined;
+    focus?: string | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+}>;
+export type CmosSprintAddParams = z.infer<typeof cmosSprintAddSchema>;
+/**
+ * MCP Tool Definition for cmos_sprint_add.
+ */
+export declare const cmosSprintAddToolDefinition: {
+    readonly name: "cmos_sprint_add";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly sprintId: {
+                readonly type: "string";
+                readonly description: "Unique sprint identifier (e.g., \"sprint-15\")";
+            };
+            readonly title: {
+                readonly type: "string";
+                readonly description: "Sprint title (required)";
+            };
+            readonly focus: {
+                readonly type: "string";
+                readonly description: "Strategic focus or theme of the sprint";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly description: "Sprint status (default: \"Active\"). Common values: Active, Completed, Planned";
+            };
+            readonly startDate: {
+                readonly type: "string";
+                readonly description: "Start date in ISO format (e.g., \"2025-01-01\")";
+            };
+            readonly endDate: {
+                readonly type: "string";
+                readonly description: "End date in ISO format (e.g., \"2025-01-15\")";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["sprintId", "title"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute the cmos_sprint_add tool.
+ *
+ * @param params - Tool parameters
+ * @returns CmosToolResult with created sprint or actionable error
+ */
+export declare function cmosSprintAdd(params: CmosSprintAddParams): Promise<CmosToolResult<SprintAddResult>>;
+/**
+ * Format sprint add result for LLM readability.
+ *
+ * @param result - Sprint add result
+ * @returns Human-readable summary
+ */
+export declare function formatSprintAddForLLM(result: CmosToolResult<SprintAddResult>): string;
+//# sourceMappingURL=cmos-sprint-add.d.ts.map

package/dist/tools/cmos/cmos-sprint-add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-sprint-add.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-sprint-add.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IAEX,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IAEd,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;IAC9B,+BAA+B;;IAG/B,mBAAmB;;IAGnB,oCAAoC;;IAGpC,oBAAoB;;IAMpB,+BAA+B;;IAG/B,6BAA6B;;IAG7B,qDAAqD;;;;;;;;;;;;;;;;;;EAKrD,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyC9B,CAAC;AAEX;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAiE1C;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,CAAC,eAAe,CAAC,GAAG,MAAM,CAsBrF"}

package/dist/tools/cmos/cmos-sprint-add.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * cmos_sprint_add Tool
+ *
+ * MCP tool for creating new sprints in the CMOS database.
+ * Validates sprint ID uniqueness and required fields.
+ *
+ * @module tools/cmos/cmos-sprint-add
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosSprintAddToolDefinition = exports.cmosSprintAddSchema = void 0;
+exports.cmosSprintAdd = cmosSprintAdd;
+exports.formatSprintAddForLLM = formatSprintAddForLLM;
+const zod_1 = require("zod");
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+/**
+ * Input parameters schema for cmos_sprint_add tool.
+ */
+exports.cmosSprintAddSchema = zod_1.z.object({
+    /** Unique sprint identifier */
+    sprintId: zod_1.z.string().min(1).describe('Unique sprint identifier (e.g., "sprint-15")'),
+    /** Sprint title */
+    title: zod_1.z.string().min(1).describe('Sprint title (required)'),
+    /** Strategic focus of the sprint */
+    focus: zod_1.z.string().optional().describe('Strategic focus or theme of the sprint'),
+    /** Sprint status */
+    status: zod_1.z
+        .string()
+        .optional()
+        .describe('Sprint status (default: "Active"). Common values: Active, Completed, Planned'),
+    /** Start date in ISO format */
+    startDate: zod_1.z.string().optional().describe('Start date in ISO format (e.g., "2025-01-01")'),
+    /** End date in ISO format */
+    endDate: zod_1.z.string().optional().describe('End date in ISO format (e.g., "2025-01-15")'),
+    /** Optional: explicit project root to search from */
+    projectRoot: zod_1.z
+        .string()
+        .optional()
+        .describe('Project root directory to search for CMOS database (defaults to cwd)'),
+});
+/**
+ * MCP Tool Definition for cmos_sprint_add.
+ */
+exports.cmosSprintAddToolDefinition = {
+    name: 'cmos_sprint_add',
+    description: 'Create a new sprint in the CMOS database. ' +
+        'Requires a unique sprint ID and title. ' +
+        'Optionally set focus, status, and date range.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            sprintId: {
+                type: 'string',
+                description: 'Unique sprint identifier (e.g., "sprint-15")',
+            },
+            title: {
+                type: 'string',
+                description: 'Sprint title (required)',
+            },
+            focus: {
+                type: 'string',
+                description: 'Strategic focus or theme of the sprint',
+            },
+            status: {
+                type: 'string',
+                description: 'Sprint status (default: "Active"). Common values: Active, Completed, Planned',
+            },
+            startDate: {
+                type: 'string',
+                description: 'Start date in ISO format (e.g., "2025-01-01")',
+            },
+            endDate: {
+                type: 'string',
+                description: 'End date in ISO format (e.g., "2025-01-15")',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['sprintId', 'title'],
+        additionalProperties: false,
+    },
+};
+/**
+ * Execute the cmos_sprint_add tool.
+ *
+ * @param params - Tool parameters
+ * @returns CmosToolResult with created sprint or actionable error
+ */
+async function cmosSprintAdd(params) {
+    const { sprintId, title, focus, status, startDate, endDate } = params;
+    // Validate required parameters
+    if (!sprintId || sprintId.trim() === '') {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('sprintId'));
+    }
+    if (!title || title.trim() === '') {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('title'));
+    }
+    return (0, client_1.withClientValidated)((client) => {
+        // Check if sprint ID already exists
+        const existingResult = client.getOne('SELECT id FROM sprints WHERE id = ?', [
+            sprintId,
+        ]);
+        if (!existingResult.success) {
+            return (0, errors_1.createError)(existingResult.error ?? { code: 'DB_QUERY_FAILED', message: 'Failed to check sprint' });
+        }
+        if (existingResult.data) {
+            return (0, errors_1.createError)(errors_1.CmosErrors.sprintIdExists(sprintId));
+        }
+        // Insert new sprint
+        const insertResult = client.execute(`INSERT INTO sprints (id, title, focus, status, start_date, end_date)
+        VALUES (?, ?, ?, ?, ?, ?)`, [
+            sprintId,
+            title.trim(),
+            focus?.trim() || null,
+            status?.trim() || 'Active',
+            startDate?.trim() || null,
+            endDate?.trim() || null,
+        ]);
+        if (!insertResult.success) {
+            return (0, errors_1.createError)(insertResult.error ?? { code: 'DB_QUERY_FAILED', message: 'Failed to create sprint' });
+        }
+        if (insertResult.data?.changes === 0) {
+            return (0, errors_1.createError)({
+                code: 'DB_QUERY_FAILED',
+                message: 'Sprint was not created (no rows affected)',
+                suggestion: 'Check database permissions and try again',
+            });
+        }
+        return (0, errors_1.createSuccess)({
+            id: sprintId,
+            title: title.trim(),
+            message: `Sprint '${sprintId}' created successfully`,
+        });
+    }, { projectRoot: params.projectRoot });
+}
+/**
+ * Format sprint add result for LLM readability.
+ *
+ * @param result - Sprint add result
+ * @returns Human-readable summary
+ */
+function formatSprintAddForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = ['❌ Failed to create sprint', '', `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 = [
+        '✓ Sprint created successfully',
+        '',
+        `   ID: ${data.id}`,
+        `   Title: ${data.title}`,
+    ];
+    return lines.join('\n');
+}
+//# sourceMappingURL=cmos-sprint-add.js.map

package/dist/tools/cmos/cmos-sprint-add.js.map

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

package/dist/tools/cmos/cmos-sprint-analytics.d.ts

@@ -0,0 +1,66 @@
+/**
+ * cmos_sprint analytics action
+ *
+ * Computes KPIs across sprint history: velocity, completion rate trends,
+ * decision volume, session patterns, and cycle time trends.
+ * Read-only — does not mutate the database.
+ *
+ * @module tools/cmos/cmos-sprint-analytics
+ */
+import type { CmosToolResult } from './types';
+export interface SprintDataPoint {
+    sprintId: string;
+    title: string;
+    status: string | null;
+    totalMissions: number;
+    completedMissions: number;
+    blockedMissions: number;
+    completionRate: number;
+    avgCycleTimeDays: number | null;
+    decisionsCount: number;
+    learningsCount: number;
+    sessionsCount: number;
+    /** Sessions linked to at least one mission via session_missions */
+    linkedSessionsCount: number;
+}
+export interface TrendDirection {
+    direction: 'increasing' | 'decreasing' | 'stable';
+    /** Change from first half average to second half average */
+    changePercent: number;
+}
+export interface SprintAnalyticsResult {
+    /** Per-sprint data points (chronological) */
+    sprints: SprintDataPoint[];
+    /** Aggregated cross-sprint KPIs */
+    aggregates: {
+        totalSprints: number;
+        completedSprints: number;
+        totalMissions: number;
+        totalCompleted: number;
+        overallCompletionRate: number;
+        avgVelocity: number;
+        avgCycleTimeDays: number | null;
+        totalDecisions: number;
+        totalLearnings: number;
+        totalSessions: number;
+        totalLinkedSessions: number;
+    };
+    /** Computed trends (first half vs second half of sprint history) */
+    trends: {
+        velocity: TrendDirection;
+        completionRate: TrendDirection;
+        decisionsPerSprint: TrendDirection;
+        cycleTime: TrendDirection | null;
+    };
+    /** Human-readable trend highlights */
+    highlights: string[];
+}
+export interface CmosSprintAnalyticsParams {
+    /** Optional project root */
+    projectRoot?: string;
+    /** Limit to last N sprints (default: all completed) */
+    limit?: number;
+}
+export declare function cmosSprintAnalytics(params: CmosSprintAnalyticsParams): Promise<CmosToolResult<SprintAnalyticsResult>>;
+export declare function formatSprintAnalyticsForLLM(result: CmosToolResult<SprintAnalyticsResult>): string;
+//# sourceMappingURL=cmos-sprint-analytics.d.ts.map

package/dist/tools/cmos/cmos-sprint-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-sprint-analytics.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-sprint-analytics.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK9C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,mEAAmE;IACnE,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;IAClD,4DAA4D;IAC5D,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,OAAO,EAAE,eAAe,EAAE,CAAC;IAE3B,mCAAmC;IACnC,UAAU,EAAE;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,WAAW,EAAE,MAAM,CAAC;QACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IAEF,oEAAoE;IACpE,MAAM,EAAE;QACN,QAAQ,EAAE,cAAc,CAAC;QACzB,cAAc,EAAE,cAAc,CAAC;QAC/B,kBAAkB,EAAE,cAAc,CAAC;QACnC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAC;KAClC,CAAC;IAEF,sCAAsC;IACtC,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC,CA4ChD;AAgRD,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,cAAc,CAAC,qBAAqB,CAAC,GAAG,MAAM,CA6DjG"}