@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,227 @@
+"use strict";
+/**
+ * Constraint Lifecycle Handler
+ *
+ * Manages structured constraints with staleness detection and archival:
+ * - list: View active/all constraints
+ * - review: Show stale + expired constraints with staleness scores
+ * - archive: Batch archive stale/expired constraints
+ *
+ * Wired into cmos_context(action="constraints").
+ *
+ * @module tools/cmos/cmos-constraints
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosConstraints = cmosConstraints;
+exports.getStaleConstraintCount = getStaleConstraintCount;
+exports.formatConstraintsForLLM = formatConstraintsForLLM;
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const schema_migrations_1 = require("./schema-migrations");
+// ─── Staleness Scoring ───────────────────────────────────────────────────────
+const DEFAULT_STALENESS_THRESHOLD_DAYS = 30;
+/**
+ * Compute a staleness score (0-100) for a constraint.
+ * - Expired constraints get 100
+ * - Age-based scoring: linearly increases from 0 to 80 over threshold days
+ * - No expiry adds 20 bonus points (incentivizes setting TTLs)
+ */
+function computeStalenessScore(constraint, now, thresholdDays) {
+    // Expired constraints are maximally stale
+    if (constraint.expires_at) {
+        const expiresAt = new Date(constraint.expires_at);
+        if (expiresAt <= now) {
+            return { score: 100, reason: 'expired' };
+        }
+    }
+    const createdAt = new Date(constraint.created_at);
+    const ageDays = (now.getTime() - createdAt.getTime()) / (1000 * 60 * 60 * 24);
+    // Age-based score: 0 at 0 days, 80 at thresholdDays
+    const ageScore = Math.min(80, Math.round((ageDays / thresholdDays) * 80));
+    // Bonus for no expiry set
+    const noExpiryBonus = constraint.expires_at ? 0 : 20;
+    const score = Math.min(100, ageScore + noExpiryBonus);
+    const reason = constraint.expires_at ? 'old_sprint' : 'stale_no_expiry';
+    return { score, reason };
+}
+// ─── Handlers ────────────────────────────────────────────────────────────────
+async function cmosConstraints(params) {
+    const action = params.constraintAction;
+    if (!action || !['list', 'review', 'archive'].includes(action)) {
+        return (0, errors_1.createError)({
+            code: 'INVALID_ACTION',
+            message: `Invalid constraint action: '${action}'`,
+            suggestion: 'Use constraintAction: list | review | archive',
+            validValues: ['list', 'review', 'archive'],
+        });
+    }
+    return (0, client_1.withClient)((client) => {
+        (0, schema_migrations_1.ensureConstraintsTable)(client);
+        switch (action) {
+            case 'list':
+                return listConstraints(client, params.constraintStatus ?? 'active');
+            case 'review':
+                return reviewConstraints(client, params.stalenessThresholdDays ?? DEFAULT_STALENESS_THRESHOLD_DAYS);
+            case 'archive':
+                return archiveConstraints(client, params.constraintIds);
+            default:
+                return (0, errors_1.createError)({
+                    code: 'INVALID_ACTION',
+                    message: `Unknown constraint action: '${action}'`,
+                });
+        }
+    }, { projectRoot: params.projectRoot });
+}
+function listConstraints(client, status) {
+    const result = client.getMany(`SELECT id, content, status, session_id, sprint_id, created_at, expires_at, archived_at
+     FROM constraints WHERE status = ? ORDER BY created_at ASC`, [status]);
+    if (!result.success || !result.data) {
+        return (0, errors_1.createError)({
+            code: 'DB_QUERY_FAILED',
+            message: 'Failed to query constraints',
+        });
+    }
+    const items = result.data.map((row) => ({
+        id: row.id,
+        content: row.content,
+        status: row.status,
+        sessionId: row.session_id,
+        sprintId: row.sprint_id,
+        createdAt: row.created_at,
+        expiresAt: row.expires_at,
+        archivedAt: row.archived_at,
+    }));
+    return (0, errors_1.createSuccess)({
+        constraintAction: 'list',
+        items,
+        affected: items.length,
+        message: `Found ${items.length} constraint(s) with status '${status}'`,
+    });
+}
+function reviewConstraints(client, thresholdDays) {
+    // Get all active constraints
+    const result = client.getMany(`SELECT id, content, status, session_id, sprint_id, created_at, expires_at, archived_at
+     FROM constraints WHERE status = 'active' ORDER BY created_at ASC`, []);
+    if (!result.success || !result.data) {
+        return (0, errors_1.createError)({
+            code: 'DB_QUERY_FAILED',
+            message: 'Failed to query constraints for review',
+        });
+    }
+    const now = new Date();
+    const reviewItems = [];
+    for (const row of result.data) {
+        const { score, reason } = computeStalenessScore(row, now, thresholdDays);
+        // Only include constraints that are stale (score >= 50) or expired
+        if (score >= 50) {
+            reviewItems.push({
+                id: row.id,
+                content: row.content,
+                status: row.status,
+                sessionId: row.session_id,
+                sprintId: row.sprint_id,
+                createdAt: row.created_at,
+                expiresAt: row.expires_at,
+                archivedAt: row.archived_at,
+                stalenessScore: score,
+                reason,
+            });
+        }
+    }
+    // Sort by staleness score descending
+    reviewItems.sort((a, b) => b.stalenessScore - a.stalenessScore);
+    return (0, errors_1.createSuccess)({
+        constraintAction: 'review',
+        reviewItems,
+        affected: reviewItems.length,
+        message: reviewItems.length > 0
+            ? `${reviewItems.length} constraint(s) flagged for review (threshold: ${thresholdDays} days)`
+            : `No stale constraints found (threshold: ${thresholdDays} days)`,
+    });
+}
+function archiveConstraints(client, ids) {
+    const now = new Date().toISOString();
+    if (!ids || ids.length === 0) {
+        // Archive all expired constraints
+        const result = client.execute(`UPDATE constraints SET status = 'archived', archived_at = ?
+       WHERE status = 'active' AND expires_at IS NOT NULL AND expires_at <= ?`, [now, now]);
+        const affected = result.success && result.data?.changes ? result.data.changes : 0;
+        return (0, errors_1.createSuccess)({
+            constraintAction: 'archive',
+            affected,
+            message: affected > 0
+                ? `${affected} expired constraint(s) archived`
+                : 'No expired constraints to archive',
+        });
+    }
+    let affected = 0;
+    for (const id of ids) {
+        const result = client.execute(`UPDATE constraints SET status = 'archived', archived_at = ? WHERE id = ? AND status = 'active'`, [now, id]);
+        if (result.success && result.data?.changes && result.data.changes > 0) {
+            affected++;
+        }
+    }
+    return (0, errors_1.createSuccess)({
+        constraintAction: 'archive',
+        affected,
+        message: `${affected} constraint(s) archived`,
+    });
+}
+// ─── Staleness Helpers (for onboard integration) ─────────────────────────────
+/**
+ * Count stale + expired active constraints.
+ * Returns 0 if the constraints table doesn't exist.
+ */
+function getStaleConstraintCount(client, thresholdDays = DEFAULT_STALENESS_THRESHOLD_DAYS) {
+    const tableCheck = client.getOne("SELECT name FROM sqlite_master WHERE type='table' AND name='constraints'", []);
+    if (!tableCheck.success || !tableCheck.data)
+        return 0;
+    const now = new Date();
+    const thresholdDate = new Date(now.getTime() - thresholdDays * 24 * 60 * 60 * 1000).toISOString();
+    // Count expired
+    const expiredResult = client.getOne(`SELECT COUNT(*) AS count FROM constraints
+     WHERE status = 'active' AND expires_at IS NOT NULL AND expires_at <= ?`, [now.toISOString()]);
+    const expired = expiredResult.success && expiredResult.data ? expiredResult.data.count : 0;
+    // Count old without expiry
+    const staleResult = client.getOne(`SELECT COUNT(*) AS count FROM constraints
+     WHERE status = 'active' AND expires_at IS NULL AND created_at <= ?`, [thresholdDate]);
+    const stale = staleResult.success && staleResult.data ? staleResult.data.count : 0;
+    return expired + stale;
+}
+// ─── LLM Formatter ──────────────────────────────────────────────────────────
+function formatConstraintsForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        return `Failed to manage constraints: ${error?.message ?? 'Unknown error'}`;
+    }
+    const d = result.data;
+    if (d.constraintAction === 'list' && d.items) {
+        if (d.items.length === 0) {
+            return 'No active constraints found.';
+        }
+        const lines = [`**Constraints (${d.items.length})**`, ''];
+        for (const item of d.items) {
+            const expiry = item.expiresAt ? ` [expires: ${item.expiresAt.split('T')[0]}]` : '';
+            const sprint = item.sprintId ? ` (${item.sprintId})` : '';
+            lines.push(`  #${item.id} [${item.status}]${sprint}${expiry}: ${item.content}`);
+        }
+        return lines.join('\n');
+    }
+    if (d.constraintAction === 'review' && d.reviewItems) {
+        if (d.reviewItems.length === 0) {
+            return 'No stale constraints found.';
+        }
+        const lines = [`**Constraint Review (${d.reviewItems.length} flagged)**`, ''];
+        for (const item of d.reviewItems) {
+            const expiry = item.expiresAt
+                ? ` [expires: ${item.expiresAt.split('T')[0]}]`
+                : ' [no expiry]';
+            lines.push(`  #${item.id} [score: ${item.stalenessScore}] (${item.reason})${expiry}: ${item.content}`);
+        }
+        lines.push('');
+        lines.push('Use constraintAction="archive" with constraintIds to archive stale constraints.');
+        return lines.join('\n');
+    }
+    return d.message;
+}
+//# sourceMappingURL=cmos-constraints.js.map

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

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

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

@@ -0,0 +1,129 @@
+/**
+ * cmos_context_condense Tool
+ *
+ * MCP tool for automatically reducing context size while preserving
+ * semantic value. Addresses monotonic context growth where master_context
+ * grows indefinitely with no automated reduction mechanism.
+ *
+ * Three strategy levels:
+ * - conservative: Only removes old entries, trims summaries
+ * - auto (default): Conservative + deduplication + sprint-level collapse
+ * - aggressive: Auto + removes old sprint detail + limits decisions
+ *
+ * @module tools/cmos/cmos-context-condense
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+import { type ContextSizeMetrics } from './context-retention';
+/**
+ * Per-section condensation detail.
+ */
+export interface SectionCondensation {
+    section: string;
+    beforeBytes: number;
+    afterBytes: number;
+    action: string;
+    preview?: string[];
+}
+/**
+ * Result of context condense operation.
+ */
+export interface CmosContextCondenseResult {
+    /** Size before condensation */
+    beforeSize: ContextSizeMetrics;
+    /** Size after condensation (same as before in dryRun) */
+    afterSize: ContextSizeMetrics;
+    /** Reduction percentage */
+    reductionPercent: number;
+    /** Target size in KB derived from targetSizePercent */
+    targetSizeKb: number;
+    /** Target percentage requested by the caller */
+    targetSizePercent: number;
+    /** Whether the target was met after condensation */
+    targetMet: boolean;
+    /** Per-section breakdown */
+    sectionsCondensed: SectionCondensation[];
+    /** Snapshot ID from auto-snapshot (null in dryRun) */
+    snapshotId: number | null;
+    /** Strategy used */
+    strategy: 'conservative' | 'auto' | 'aggressive';
+    /** Whether this was a dry run */
+    dryRun: boolean;
+    /** Context type condensed */
+    contextType: 'master_context' | 'project_context';
+    /** Summary message */
+    message: string;
+}
+/**
+ * Input parameters schema for cmos_context_condense tool.
+ */
+export declare const cmosContextCondenseSchema: z.ZodObject<{
+    contextType: z.ZodEnum<["master_context", "project_context"]>;
+    targetSizePercent: z.ZodDefault<z.ZodNumber>;
+    strategy: z.ZodDefault<z.ZodEnum<["conservative", "auto", "aggressive"]>>;
+    dryRun: z.ZodDefault<z.ZodBoolean>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    contextType: "project_context" | "master_context";
+    targetSizePercent: number;
+    strategy: "conservative" | "auto" | "aggressive";
+    dryRun: boolean;
+    projectRoot?: string | undefined;
+}, {
+    contextType: "project_context" | "master_context";
+    projectRoot?: string | undefined;
+    targetSizePercent?: number | undefined;
+    strategy?: "conservative" | "auto" | "aggressive" | undefined;
+    dryRun?: boolean | undefined;
+}>;
+export type CmosContextCondenseParams = z.infer<typeof cmosContextCondenseSchema>;
+/**
+ * MCP Tool Definition for cmos_context_condense.
+ */
+export declare const cmosContextCondenseToolDefinition: {
+    readonly name: "cmos_context_condense";
+    readonly description: "Automatically reduce context size while preserving semantic value. Supports three strategies: conservative (remove stale next_steps), auto (conservative + prune session_history), aggressive (auto + limit context_notes + archived_sprint_summaries + clear table-backed constraints). Use dryRun=true to preview changes.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly contextType: {
+                readonly type: "string";
+                readonly enum: readonly ["master_context", "project_context"];
+                readonly description: "Which context to condense";
+            };
+            readonly targetSizePercent: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly default: 60;
+                readonly description: "Target percentage of the 100KB limit (default: 60)";
+            };
+            readonly strategy: {
+                readonly type: "string";
+                readonly enum: readonly ["conservative", "auto", "aggressive"];
+                readonly default: "auto";
+                readonly description: "Condensation strategy: conservative, auto (default), or aggressive";
+            };
+            readonly dryRun: {
+                readonly type: "boolean";
+                readonly default: false;
+                readonly description: "Preview changes without applying (default: false)";
+            };
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly required: readonly ["contextType"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute the cmos_context_condense tool.
+ */
+export declare function cmosContextCondense(params: CmosContextCondenseParams): Promise<CmosToolResult<CmosContextCondenseResult>>;
+/**
+ * Format context condense result for LLM readability.
+ */
+export declare function formatContextCondenseForLLM(result: CmosToolResult<CmosContextCondenseResult>): string;
+//# sourceMappingURL=cmos-context-condense.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-context-condense.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-context-condense.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAW,MAAM,SAAS,CAAC;AAEvD,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,+BAA+B;IAC/B,UAAU,EAAE,kBAAkB,CAAC;IAE/B,yDAAyD;IACzD,SAAS,EAAE,kBAAkB,CAAC;IAE9B,2BAA2B;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IAEzB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IAErB,gDAAgD;IAChD,iBAAiB,EAAE,MAAM,CAAC;IAE1B,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IAEnB,4BAA4B;IAC5B,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;IAEzC,sDAAsD;IACtD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B,oBAAoB;IACpB,QAAQ,EAAE,cAAc,GAAG,MAAM,GAAG,YAAY,CAAC;IAEjD,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC;IAEhB,6BAA6B;IAC7B,WAAW,EAAE,gBAAgB,GAAG,iBAAiB,CAAC;IAElD,sBAAsB;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;EAuBpC,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAElF;;GAEG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCpC,CAAC;AAMX;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAC,CAoSpD;AA6XD;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,cAAc,CAAC,yBAAyB,CAAC,GAChD,MAAM,CAuDR"}