@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,201 @@
+/**
+ * cmos_session_complete Tool
+ *
+ * MCP tool for completing an active session.
+ * Captures are aggregated into master context when session completes.
+ *
+ * @module tools/cmos/cmos-session-complete
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+import type { CaptureCategory } from './cmos-session-capture';
+/**
+ * Result of session complete operation.
+ */
+export interface CmosSessionCompleteResult {
+    /** Completed session ID */
+    sessionId: string;
+    /** Session type */
+    type: string;
+    /** Session title */
+    title: string;
+    /** Completion summary */
+    summary: string;
+    /** When the session was completed */
+    completedAt: string;
+    /** How long the session lasted */
+    durationMinutes: number;
+    /** Number of captures in the session */
+    captureCount: number;
+    /** Breakdown of captures by category */
+    capturesByCategory: Partial<Record<CaptureCategory, number>>;
+    /** Next steps recorded (if any) */
+    nextSteps: string[] | null;
+    /** Context aggregation results */
+    aggregation: {
+        /** Captures routed to master_context by category */
+        capturesRouted: Record<string, number>;
+        /** Whether contexts were updated */
+        contextsUpdated: boolean;
+        /** Snapshot IDs created (null if none) */
+        projectSnapshotId: number | null;
+        masterSnapshotId: number | null;
+        /** Retention condensation details */
+        condensation?: {
+            projectArchivedSprints: string[];
+            masterArchivedSprints: string[];
+            projectArchiveSnapshotId: number | null;
+            masterArchiveSnapshotId: number | null;
+        };
+    };
+    /** Number of next-steps extracted to the next_steps table */
+    nextStepsExtracted: number;
+    /**
+     * Number of decisions from the `decisions[]` parameter or decision-category
+     * captures that were inserted into strategic_decisions. Deduped rows
+     * (already in the table for this session) are not counted.
+     */
+    decisionsExtracted: number;
+    /** Number of constraints extracted to the constraints table */
+    constraintsExtracted: number;
+    /** Message describing the result */
+    message: string;
+    /** Persisted agent_feedback.id when agentFeedback was supplied (Sprint 56 m03). */
+    feedbackId?: number;
+    /**
+     * Learning IDs whose `last_reviewed_at` was bumped because the caller passed
+     * them in `citesLearningIds[]`. Sprint 61 m01.
+     */
+    explicitlyReaffirmedLearningIds?: number[];
+    /**
+     * Learning IDs whose `last_reviewed_at` was bumped because at least one
+     * decision text in `decisions[]` overlapped them by IMPLICIT_REAFFIRM_KEYWORD_FLOOR
+     * keywords. Sprint 61 m01.
+     */
+    implicitlyReaffirmedLearningIds?: number[];
+    /**
+     * Learning IDs the caller passed in `citesLearningIds[]` that did not
+     * resolve to existing rows. Sprint 61 m01.
+     */
+    missingCitedLearningIds?: number[];
+}
+/**
+ * Input parameters schema for cmos_session_complete tool.
+ */
+export declare const cmosSessionCompleteSchema: z.ZodObject<{
+    /** Session ID to complete (optional - uses active session if not provided) */
+    sessionId: z.ZodOptional<z.ZodString>;
+    /** Completion summary */
+    summary: z.ZodString;
+    /** Optional next steps */
+    nextSteps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Optional decisions captured at session close. Each entry becomes a
+     * strategic_decisions row with sprint_id derived from the session.
+     */
+    decisions: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Optional agent name */
+    agent: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    /** Optional free-text UX feedback from the agent (Sprint 56 m03). */
+    agentFeedback: z.ZodOptional<z.ZodString>;
+    /**
+     * Optional explicit list of learning IDs the session's decisions cite.
+     * Bumps `last_reviewed_at` on each — keeps still-true institutional rules
+     * out of the staleness pile (Sprint 61 m01).
+     */
+    citesLearningIds: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    /** Optional project root */
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    summary: string;
+    projectRoot?: string | undefined;
+    agent?: string | undefined;
+    agentFeedback?: string | undefined;
+    decisions?: string[] | undefined;
+    nextSteps?: string[] | undefined;
+    sessionId?: string | undefined;
+    citesLearningIds?: number[] | undefined;
+}, {
+    summary: string;
+    projectRoot?: string | undefined;
+    agent?: string | undefined;
+    agentFeedback?: string | undefined;
+    decisions?: string[] | undefined;
+    nextSteps?: string[] | undefined;
+    sessionId?: string | undefined;
+    citesLearningIds?: number[] | undefined;
+}>;
+export type CmosSessionCompleteParams = z.infer<typeof cmosSessionCompleteSchema>;
+/**
+ * MCP Tool Definition for cmos_session_complete.
+ */
+export declare const cmosSessionCompleteToolDefinition: {
+    readonly name: "cmos_session_complete";
+    readonly description: "Complete an active session with a summary. Captures are aggregated into master context. Only active sessions can be completed.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly sessionId: {
+                readonly type: "string";
+                readonly description: "Session ID to complete (uses active session if not provided)";
+            };
+            readonly summary: {
+                readonly type: "string";
+                readonly description: "Summary of what was accomplished in the session";
+                readonly minLength: 1;
+                readonly maxLength: 2000;
+            };
+            readonly nextSteps: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Optional list of next steps or action items";
+            };
+            readonly decisions: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Optional list of strategic decisions to materialize into strategic_decisions rows";
+            };
+            readonly agent: {
+                readonly type: "string";
+                readonly description: "Agent completing the session (default: \"assistant\")";
+            };
+            readonly agentFeedback: {
+                readonly type: "string";
+                readonly maxLength: 2000;
+                readonly description: "Optional free-text UX feedback. Use this to report rough edges, improvement ideas, or surprising tool behavior you hit during this session. Reviewed periodically via cmos_feedback(action=\"list\").";
+            };
+            readonly citesLearningIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                };
+                readonly description: "Learning IDs the session decisions cite. Bumps last_reviewed_at on each — applies to the decisions[] write path.";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["summary"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute the cmos_session_complete tool.
+ *
+ * Completes an active session and marks it as completed.
+ *
+ * @param params - Tool parameters
+ * @returns CmosToolResult with completion info or actionable error
+ */
+export declare function cmosSessionComplete(params: CmosSessionCompleteParams): Promise<CmosToolResult<CmosSessionCompleteResult>>;
+/**
+ * Format session complete result for LLM readability.
+ */
+export declare function formatSessionCompleteForLLM(result: CmosToolResult<CmosSessionCompleteResult>): string;
+//# sourceMappingURL=cmos-session-complete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-session-complete.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-session-complete.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,SAAS,CAAC;AAQhE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAa9D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,2BAA2B;IAC3B,SAAS,EAAE,MAAM,CAAC;IAElB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,oBAAoB;IACpB,KAAK,EAAE,MAAM,CAAC;IAEd,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IAEpB,kCAAkC;IAClC,eAAe,EAAE,MAAM,CAAC;IAExB,wCAAwC;IACxC,YAAY,EAAE,MAAM,CAAC;IAErB,wCAAwC;IACxC,kBAAkB,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAC;IAE7D,mCAAmC;IACnC,SAAS,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAE3B,kCAAkC;IAClC,WAAW,EAAE;QACX,oDAAoD;QACpD,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,oCAAoC;QACpC,eAAe,EAAE,OAAO,CAAC;QACzB,0CAA0C;QAC1C,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,qCAAqC;QACrC,YAAY,CAAC,EAAE;YACb,sBAAsB,EAAE,MAAM,EAAE,CAAC;YACjC,qBAAqB,EAAE,MAAM,EAAE,CAAC;YAChC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;YACxC,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;SACxC,CAAC;KACH,CAAC;IAEF,6DAA6D;IAC7D,kBAAkB,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAE3B,+DAA+D;IAC/D,oBAAoB,EAAE,MAAM,CAAC;IAE7B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAEhB,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,+BAA+B,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3C;;;;OAIG;IACH,+BAA+B,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3C;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;CACpC;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB;IACpC,8EAA8E;;IAM9E,yBAAyB;;IAGzB,0BAA0B;;IAG1B;;;OAGG;;IAMH,0BAA0B;;IAO1B,qEAAqE;;IASrE;;;;OAIG;;IAQH,4BAA4B;;;;;;;;;;;;;;;;;;;;EAK5B,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDpC,CAAC;AAEX;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAC,CAiZpD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,cAAc,CAAC,yBAAyB,CAAC,GAChD,MAAM,CAiER"}