@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,155 @@
+/**
+ * cmos_sprint_complete Tool
+ *
+ * MCP tool for closing out a sprint in one operation. It validates readiness,
+ * snapshots both contexts, clears stale sprint-linked next steps, optionally
+ * runs condensation, and returns a closeout receipt with size telemetry.
+ *
+ * @module tools/cmos/cmos-sprint-complete
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+import { type ContextSizeMetrics } from './context-retention';
+type CloseoutCondensationStrategy = 'none' | 'conservative' | 'auto' | 'aggressive';
+/**
+ * Sprint summary KPIs computed during closeout.
+ */
+export interface SprintKPIs {
+    completionRate: number;
+    avgCycleTimeDays: number | null;
+    decisionCount: number;
+    learningCount: number;
+    blockedCount: number;
+}
+/**
+ * Lifecycle trigger results from sprint completion.
+ */
+export interface SprintLifecycleTriggers {
+    decisionsArchived: number;
+    learningsArchived: number;
+    kpis: SprintKPIs;
+    dbSnapshotId: string | null;
+}
+/**
+ * Sprint readiness summary used in the closeout receipt.
+ */
+export interface SprintCloseoutReadiness {
+    totalMissions: number;
+    completedMissions: number;
+    blockedMissions: number;
+    skippedMissions: number;
+    openMissions: number;
+    completedMissionIds: string[];
+    blockedMissionIds: string[];
+    skippedMissionIds: string[];
+    openMissionIds: string[];
+}
+/**
+ * Per-context closeout details.
+ */
+export interface SprintCloseoutContextResult {
+    snapshotId: number | null;
+    beforeSize: ContextSizeMetrics;
+    afterSize: ContextSizeMetrics;
+    nextStepsCleared: number;
+    condensation?: {
+        strategy: Exclude<CloseoutCondensationStrategy, 'none'>;
+        snapshotId: number | null;
+        reductionPercent: number;
+        targetMet: boolean;
+        message: string;
+    };
+}
+/**
+ * Result returned by cmos_sprint_complete.
+ */
+export interface CmosSprintCompleteResult {
+    sprintId: string;
+    previousStatus: string | null;
+    currentStatus: 'Completed';
+    summary: string;
+    completedAt: string;
+    readiness: SprintCloseoutReadiness;
+    contexts: {
+        masterContext: SprintCloseoutContextResult;
+        projectContext: SprintCloseoutContextResult;
+        totalBeforeSizeKb: number;
+        totalAfterSizeKb: number;
+    };
+    lifecycle: SprintLifecycleTriggers;
+    message: string;
+}
+/**
+ * Input parameters schema for cmos_sprint_complete.
+ */
+export declare const cmosSprintCompleteSchema: z.ZodObject<{
+    sprintId: z.ZodString;
+    summary: z.ZodString;
+    condensation: z.ZodOptional<z.ZodDefault<z.ZodEnum<["none", "conservative", "auto", "aggressive"]>>>;
+    targetSizePercent: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    sprintId: string;
+    summary: string;
+    projectRoot?: string | undefined;
+    targetSizePercent?: number | undefined;
+    condensation?: "conservative" | "auto" | "aggressive" | "none" | undefined;
+}, {
+    sprintId: string;
+    summary: string;
+    projectRoot?: string | undefined;
+    targetSizePercent?: number | undefined;
+    condensation?: "conservative" | "auto" | "aggressive" | "none" | undefined;
+}>;
+export type CmosSprintCompleteParams = z.infer<typeof cmosSprintCompleteSchema>;
+/**
+ * MCP Tool Definition for cmos_sprint_complete.
+ */
+export declare const cmosSprintCompleteToolDefinition: {
+    readonly name: "cmos_sprint_complete";
+    readonly description: "Close out a sprint in one operation. Validates sprint readiness, marks the sprint Completed with endDate, snapshots both contexts, clears stale sprint-linked next steps, and optionally runs context condensation.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly sprintId: {
+                readonly type: "string";
+                readonly description: "The sprint ID to close out (e.g., \"sprint-22\")";
+            };
+            readonly summary: {
+                readonly type: "string";
+                readonly description: "Short closeout summary describing what the sprint delivered";
+                readonly minLength: 1;
+                readonly maxLength: 2000;
+            };
+            readonly condensation: {
+                readonly type: "string";
+                readonly enum: readonly ["none", "conservative", "auto", "aggressive"];
+                readonly default: "none";
+                readonly description: "Optional context condensation strategy to run after snapshots and next-step cleanup";
+            };
+            readonly targetSizePercent: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly default: 60;
+                readonly description: "Target percentage of the context size limit when condensation is requested";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["sprintId", "summary"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute the cmos_sprint_complete tool.
+ */
+export declare function cmosSprintComplete(params: CmosSprintCompleteParams): Promise<CmosToolResult<CmosSprintCompleteResult>>;
+/**
+ * Format sprint closeout results for LLM readability.
+ */
+export declare function formatSprintCompleteForLLM(result: CmosToolResult<CmosSprintCompleteResult>): string;
+export {};
+//# sourceMappingURL=cmos-sprint-complete.d.ts.map

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

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