@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,325 @@
+/**
+ * cmos_context Tool
+ *
+ * Consolidated context tool with action parameter support.
+ * Actions: view, update, condense, snapshot, history.
+ * Routes to existing context handlers without rewriting business logic.
+ *
+ * @module tools/cmos/cmos-context
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+import { type CmosContextViewResult } from './cmos-context-view';
+import { type CmosContextUpdateResult } from './cmos-context-update';
+import { type ProjectIdentityViewResult, type ProjectIdentityUpdateResult } from './cmos-context-project-identity';
+import { type ContextSearchResult } from './cmos-context-search';
+import { type CmosContextCondenseResult } from './cmos-context-condense';
+import { type CmosContextSnapshotResult } from './cmos-context-snapshot';
+import { type CmosContextHistoryResult } from './cmos-context-history';
+import { type NextStepsResult } from './cmos-next-steps';
+import { type ConstraintsResult } from './cmos-constraints';
+export declare const CMOS_CONTEXT_ACTIONS: readonly ["view", "update", "condense", "snapshot", "history", "next_steps", "constraints", "search"];
+export type CmosContextAction = (typeof CMOS_CONTEXT_ACTIONS)[number];
+export type CmosContextResult = CmosContextViewResult | CmosContextUpdateResult | CmosContextCondenseResult | CmosContextSnapshotResult | CmosContextHistoryResult | NextStepsResult | ConstraintsResult | ProjectIdentityViewResult | ProjectIdentityUpdateResult | ContextSearchResult;
+export declare const cmosContextSchema: z.ZodObject<{
+    action: z.ZodEnum<["view", "update", "condense", "snapshot", "history", "next_steps", "constraints", "search"]>;
+    contextType: z.ZodOptional<z.ZodEnum<["master_context", "project_context", "project_identity"]>>;
+    sizeOnly: z.ZodOptional<z.ZodBoolean>;
+    compact: z.ZodOptional<z.ZodBoolean>;
+    mode: z.ZodOptional<z.ZodEnum<["aggregate", "manual"]>>;
+    arrayUpdates: z.ZodOptional<z.ZodObject<{
+        decisions_made: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        learnings: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        constraints: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        context_notes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        learnings?: string[] | undefined;
+        context_notes?: string[] | undefined;
+        decisions_made?: string[] | undefined;
+        constraints?: string[] | undefined;
+    }, {
+        learnings?: string[] | undefined;
+        context_notes?: string[] | undefined;
+        decisions_made?: string[] | undefined;
+        constraints?: string[] | undefined;
+    }>>;
+    fieldUpdates: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        value: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        value?: unknown;
+    }, {
+        path: string;
+        value?: unknown;
+    }>, "many">>;
+    since: z.ZodOptional<z.ZodString>;
+    strategy: z.ZodOptional<z.ZodEnum<["conservative", "auto", "aggressive"]>>;
+    targetSizePercent: z.ZodOptional<z.ZodNumber>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+    source: z.ZodOptional<z.ZodString>;
+    sessionId: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    nextStepAction: z.ZodOptional<z.ZodEnum<["list", "complete", "carry", "drop"]>>;
+    nextStepStatus: z.ZodOptional<z.ZodEnum<["pending", "completed", "carried", "dropped"]>>;
+    nextStepIds: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    carryToSprint: z.ZodOptional<z.ZodString>;
+    constraintAction: z.ZodOptional<z.ZodEnum<["list", "review", "archive"]>>;
+    constraintStatus: z.ZodOptional<z.ZodEnum<["active", "archived", "expired"]>>;
+    constraintIds: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    stalenessThresholdDays: z.ZodOptional<z.ZodNumber>;
+    query: z.ZodOptional<z.ZodString>;
+    searchLimit: z.ZodOptional<z.ZodNumber>;
+    searchTypes: z.ZodOptional<z.ZodArray<z.ZodEnum<["decision", "learning", "mission", "session"]>, "many">>;
+    recencyWeight: z.ZodOptional<z.ZodNumber>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    action: "search" | "next_steps" | "constraints" | "update" | "view" | "condense" | "snapshot" | "history";
+    projectRoot?: string | undefined;
+    mode?: "aggregate" | "manual" | undefined;
+    source?: string | undefined;
+    sizeOnly?: boolean | undefined;
+    compact?: boolean | undefined;
+    contextType?: "project_context" | "master_context" | "project_identity" | undefined;
+    arrayUpdates?: {
+        learnings?: string[] | undefined;
+        context_notes?: string[] | undefined;
+        decisions_made?: string[] | undefined;
+        constraints?: string[] | undefined;
+    } | undefined;
+    fieldUpdates?: {
+        path: string;
+        value?: unknown;
+    }[] | undefined;
+    since?: string | undefined;
+    targetSizePercent?: number | undefined;
+    strategy?: "conservative" | "auto" | "aggressive" | undefined;
+    dryRun?: boolean | undefined;
+    sessionId?: string | undefined;
+    until?: string | undefined;
+    page?: number | undefined;
+    pageSize?: number | undefined;
+    recencyWeight?: number | undefined;
+    query?: string | undefined;
+    nextStepIds?: number[] | undefined;
+    nextStepAction?: "list" | "complete" | "drop" | "carry" | undefined;
+    nextStepStatus?: "pending" | "completed" | "carried" | "dropped" | undefined;
+    carryToSprint?: string | undefined;
+    constraintAction?: "review" | "list" | "archive" | undefined;
+    constraintStatus?: "active" | "archived" | "expired" | undefined;
+    constraintIds?: number[] | undefined;
+    stalenessThresholdDays?: number | undefined;
+    searchLimit?: number | undefined;
+    searchTypes?: ("session" | "mission" | "decision" | "learning")[] | undefined;
+}, {
+    action: "search" | "next_steps" | "constraints" | "update" | "view" | "condense" | "snapshot" | "history";
+    projectRoot?: string | undefined;
+    mode?: "aggregate" | "manual" | undefined;
+    source?: string | undefined;
+    sizeOnly?: boolean | undefined;
+    compact?: boolean | undefined;
+    contextType?: "project_context" | "master_context" | "project_identity" | undefined;
+    arrayUpdates?: {
+        learnings?: string[] | undefined;
+        context_notes?: string[] | undefined;
+        decisions_made?: string[] | undefined;
+        constraints?: string[] | undefined;
+    } | undefined;
+    fieldUpdates?: {
+        path: string;
+        value?: unknown;
+    }[] | undefined;
+    since?: string | undefined;
+    targetSizePercent?: number | undefined;
+    strategy?: "conservative" | "auto" | "aggressive" | undefined;
+    dryRun?: boolean | undefined;
+    sessionId?: string | undefined;
+    until?: string | undefined;
+    page?: number | undefined;
+    pageSize?: number | undefined;
+    recencyWeight?: number | undefined;
+    query?: string | undefined;
+    nextStepIds?: number[] | undefined;
+    nextStepAction?: "list" | "complete" | "drop" | "carry" | undefined;
+    nextStepStatus?: "pending" | "completed" | "carried" | "dropped" | undefined;
+    carryToSprint?: string | undefined;
+    constraintAction?: "review" | "list" | "archive" | undefined;
+    constraintStatus?: "active" | "archived" | "expired" | undefined;
+    constraintIds?: number[] | undefined;
+    stalenessThresholdDays?: number | undefined;
+    searchLimit?: number | undefined;
+    searchTypes?: ("session" | "mission" | "decision" | "learning")[] | undefined;
+}>;
+export type CmosContextParams = z.infer<typeof cmosContextSchema>;
+export declare const cmosContextToolDefinition: {
+    readonly name: "cmos_context";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["view", "update", "condense", "snapshot", "history", "next_steps", "constraints", "search"];
+                readonly description: "Context action: view | update | condense | snapshot | history | next_steps | constraints";
+            };
+            readonly contextType: {
+                readonly type: "string";
+                readonly enum: readonly ["master_context", "project_context", "project_identity"];
+                readonly description: "Context type (defaults to master_context)";
+            };
+            readonly sizeOnly: {
+                readonly type: "boolean";
+                readonly description: "Return only size info for view action";
+            };
+            readonly compact: {
+                readonly type: "boolean";
+                readonly description: "Return compact view for view action";
+            };
+            readonly mode: {
+                readonly type: "string";
+                readonly enum: readonly ["aggregate", "manual"];
+                readonly description: "Update mode for update action";
+            };
+            readonly arrayUpdates: {
+                readonly type: "object";
+                readonly description: "Array fields to append for update action";
+            };
+            readonly fieldUpdates: {
+                readonly type: "array";
+                readonly description: "Field-level updates for update action. Each entry must have \"path\" (dot-notation field name) and \"value\". Example: [{path: \"project_name\", value: \"My Project\"}, {path: \"type_fields.stack\", value: \"Node.js\"}]";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly path: {
+                            readonly type: "string";
+                            readonly description: "Field path in dot-notation (e.g. \"project_name\", \"type_fields.stack\")";
+                        };
+                        readonly value: {
+                            readonly description: "New field value";
+                        };
+                    };
+                    readonly required: readonly ["path", "value"];
+                };
+            };
+            readonly since: {
+                readonly type: "string";
+                readonly description: "ISO date filter for update/history actions";
+            };
+            readonly strategy: {
+                readonly type: "string";
+                readonly enum: readonly ["conservative", "auto", "aggressive"];
+                readonly description: "Condensation strategy for condense action";
+            };
+            readonly targetSizePercent: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly description: "Target size percent for condense action";
+            };
+            readonly dryRun: {
+                readonly type: "boolean";
+                readonly description: "Preview condensation for condense action";
+            };
+            readonly source: {
+                readonly type: "string";
+                readonly description: "Snapshot source label for snapshot action";
+            };
+            readonly sessionId: {
+                readonly type: "string";
+                readonly description: "Session ID for snapshot/history actions";
+            };
+            readonly until: {
+                readonly type: "string";
+                readonly description: "ISO date upper bound for history action";
+            };
+            readonly page: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly description: "Page number for history action";
+            };
+            readonly pageSize: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly description: "Page size for history action";
+            };
+            readonly nextStepAction: {
+                readonly type: "string";
+                readonly enum: readonly ["list", "complete", "carry", "drop"];
+                readonly description: "Sub-action for next_steps: list | complete | carry | drop";
+            };
+            readonly nextStepStatus: {
+                readonly type: "string";
+                readonly enum: readonly ["pending", "completed", "carried", "dropped"];
+                readonly description: "Filter status for next_steps list (default: pending)";
+            };
+            readonly nextStepIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                };
+                readonly description: "Next-step IDs to act on for complete/carry/drop";
+            };
+            readonly carryToSprint: {
+                readonly type: "string";
+                readonly description: "Target sprint ID for carry action";
+            };
+            readonly constraintAction: {
+                readonly type: "string";
+                readonly enum: readonly ["list", "review", "archive"];
+                readonly description: "Sub-action for constraints: list | review | archive";
+            };
+            readonly constraintStatus: {
+                readonly type: "string";
+                readonly enum: readonly ["active", "archived", "expired"];
+                readonly description: "Filter status for constraints list (default: active)";
+            };
+            readonly constraintIds: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "number";
+                };
+                readonly description: "Constraint IDs to archive";
+            };
+            readonly stalenessThresholdDays: {
+                readonly type: "number";
+                readonly description: "Staleness threshold in days for review (default: 30)";
+            };
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Search query string for search action";
+            };
+            readonly searchLimit: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 50;
+                readonly description: "Max results for search action (default: 5)";
+            };
+            readonly searchTypes: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                    readonly enum: readonly ["decision", "learning", "mission", "session"];
+                };
+                readonly description: "Content types to search (default: all)";
+            };
+            readonly recencyWeight: {
+                readonly type: "number";
+                readonly minimum: 0;
+                readonly maximum: 1;
+                readonly description: "Recency boost weight 0–1 for search action (default: 0.5)";
+            };
+            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 cmosContext(params: CmosContextParams): Promise<CmosToolResult<CmosContextResult>>;
+export declare function formatContextForLLM(action: string | undefined, result: CmosToolResult<CmosContextResult>, contextType?: string): string;
+//# sourceMappingURL=cmos-context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-context.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAKL,KAAK,yBAAyB,EAC9B,KAAK,2BAA2B,EACjC,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAGL,KAAK,mBAAmB,EAEzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,KAAK,yBAAyB,EAC/B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAG5B,eAAO,MAAM,oBAAoB,uGASvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,MAAM,iBAAiB,GACzB,qBAAqB,GACrB,uBAAuB,GACvB,yBAAyB,GACzB,yBAAyB,GACzB,wBAAwB,GACxB,eAAe,GACf,iBAAiB,GACjB,yBAAyB,GACzB,2BAA2B,GAC3B,mBAAmB,CAAC;AAExB,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyHnB,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0I5B,CAAC;AAMX,wBAAsB,WAAW,CAC/B,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CA4F5C;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,cAAc,CAAC,iBAAiB,CAAC,EACzC,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAmDR"}