@aquex/cmos-mcp 1.0.0

package/dist/tools/cmos/supersession-detection.js

@@ -0,0 +1,235 @@
+"use strict";
+/**
+ * Supersession Detection
+ *
+ * When a new decision is captured, searches existing active decisions for
+ * keyword overlap using FTS5. Returns candidate decisions that the new one
+ * may supersede. No auto-supersession — returns suggestions only.
+ *
+ * @module tools/cmos/supersession-detection
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectSupersessionCandidates = detectSupersessionCandidates;
+exports.extractKeywords = extractKeywords;
+const schema_migrations_1 = require("./schema-migrations");
+const MAX_CANDIDATES = 3;
+const MIN_KEYWORD_LENGTH = 3;
+const MIN_KEYWORDS_FOR_SEARCH = 2;
+/**
+ * Detect potential supersession candidates for a newly captured decision.
+ *
+ * Extracts keywords from the new decision text, searches active decisions
+ * via FTS5 (with keyword fallback), and returns up to MAX_CANDIDATES matches.
+ *
+ * @param client - Database client
+ * @param newDecisionText - The newly captured decision text
+ * @param excludeDecisionId - ID of the new decision to exclude from results
+ * @returns Supersession suggestion with candidates
+ */
+function detectSupersessionCandidates(client, newDecisionText, excludeDecisionId) {
+    const keywords = extractKeywords(newDecisionText);
+    if (keywords.length < MIN_KEYWORDS_FOR_SEARCH) {
+        return { candidates: [], message: null };
+    }
+    // Try FTS5 first, then keyword fallback
+    let candidates = tryFts5Candidates(client, keywords, excludeDecisionId);
+    if (candidates === null) {
+        candidates = keywordFallbackCandidates(client, keywords, excludeDecisionId);
+    }
+    if (candidates.length === 0) {
+        return { candidates: [], message: null };
+    }
+    const limited = candidates.slice(0, MAX_CANDIDATES);
+    const message = formatSuggestionMessage(limited);
+    return { candidates: limited, message };
+}
+/**
+ * Extract meaningful keywords from decision text.
+ * Filters out stop words and short tokens.
+ */
+function extractKeywords(text) {
+    const tokens = text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, ' ')
+        .split(/\s+/)
+        .filter((t) => t.length >= MIN_KEYWORD_LENGTH);
+    const unique = [...new Set(tokens)].filter((t) => !STOP_WORDS.has(t));
+    return unique;
+}
+function tryFts5Candidates(client, keywords, excludeId) {
+    // Check if FTS5 table exists
+    const ftsCheck = client.getOne("SELECT name FROM sqlite_master WHERE type='table' AND name='decisions_fts'", []);
+    if (!ftsCheck.success || !ftsCheck.data) {
+        (0, schema_migrations_1.ensureDecisionsFts5)(client);
+        const retry = client.getOne("SELECT name FROM sqlite_master WHERE type='table' AND name='decisions_fts'", []);
+        if (!retry.success || !retry.data) {
+            return null;
+        }
+    }
+    // Use OR matching so partial overlap surfaces candidates
+    const ftsQuery = keywords.map((k) => `"${k.replace(/"/g, '""')}"`).join(' OR ');
+    try {
+        const ftsResults = client.getMany('SELECT rowid, rank FROM decisions_fts WHERE decisions_fts MATCH ? ORDER BY rank LIMIT ?', [ftsQuery, MAX_CANDIDATES * 3]);
+        if (!ftsResults.success || !ftsResults.data || ftsResults.data.length === 0) {
+            return null;
+        }
+        const rowIds = ftsResults.data.map((r) => r.rowid).filter((id) => id !== excludeId);
+        if (rowIds.length === 0) {
+            return [];
+        }
+        return loadAndScoreCandidates(client, rowIds, keywords);
+    }
+    catch {
+        return null;
+    }
+}
+function keywordFallbackCandidates(client, keywords, excludeId) {
+    const columns = getTableColumns(client, 'strategic_decisions');
+    if (!columns.has('decision_text') || !columns.has('status')) {
+        return [];
+    }
+    // Build LIKE conditions for each keyword (OR matching)
+    const likeConditions = keywords.map(() => 'LOWER(decision_text) LIKE ?');
+    const likeParams = keywords.map((k) => `%${k}%`);
+    const excludeClause = excludeId !== undefined ? 'AND id != ?' : '';
+    const params = [...likeParams];
+    if (excludeId !== undefined) {
+        params.push(excludeId);
+    }
+    const result = client.getMany(`SELECT id, decision_text, sprint_id, created_at
+     FROM strategic_decisions
+     WHERE status = 'active'
+       AND (${likeConditions.join(' OR ')})
+       ${excludeClause}
+     LIMIT ?`, [...params, MAX_CANDIDATES * 3]);
+    if (!result.success || !result.data) {
+        return [];
+    }
+    return result.data
+        .map((row) => ({
+        id: row.id,
+        decisionText: row.decision_text,
+        sprintId: row.sprint_id,
+        createdAt: row.created_at,
+        overlapCount: countKeywordOverlap(row.decision_text, keywords),
+    }))
+        .filter((c) => c.overlapCount >= MIN_KEYWORDS_FOR_SEARCH)
+        .sort((a, b) => b.overlapCount - a.overlapCount);
+}
+function loadAndScoreCandidates(client, rowIds, keywords) {
+    const placeholders = rowIds.map(() => '?').join(', ');
+    const result = client.getMany(`SELECT id, decision_text, sprint_id, created_at
+     FROM strategic_decisions
+     WHERE id IN (${placeholders})
+       AND status = 'active'`, rowIds);
+    if (!result.success || !result.data) {
+        return [];
+    }
+    return result.data
+        .map((row) => ({
+        id: row.id,
+        decisionText: row.decision_text,
+        sprintId: row.sprint_id,
+        createdAt: row.created_at,
+        overlapCount: countKeywordOverlap(row.decision_text, keywords),
+    }))
+        .filter((c) => c.overlapCount >= MIN_KEYWORDS_FOR_SEARCH)
+        .sort((a, b) => b.overlapCount - a.overlapCount);
+}
+function countKeywordOverlap(text, keywords) {
+    const lower = text.toLowerCase();
+    return keywords.reduce((count, kw) => count + (lower.includes(kw) ? 1 : 0), 0);
+}
+function formatSuggestionMessage(candidates) {
+    if (candidates.length === 0)
+        return '';
+    const lines = ['Potential supersession detected:'];
+    for (const c of candidates) {
+        const sprint = c.sprintId ? ` (${c.sprintId})` : '';
+        const preview = c.decisionText.length > 80 ? c.decisionText.slice(0, 80) + '...' : c.decisionText;
+        lines.push(`  - Decision #${c.id}${sprint}: "${preview}" (${c.overlapCount} keyword overlap)`);
+    }
+    lines.push('');
+    lines.push('To mark as superseded: cmos_decisions update decisionId=<id> supersededBy=<new_id>');
+    return lines.join('\n');
+}
+function getTableColumns(client, tableName) {
+    const result = client.getMany(`PRAGMA table_info('${tableName}')`, []);
+    if (!result.success || !result.data)
+        return new Set();
+    return new Set(result.data.map((row) => row.name));
+}
+/**
+ * Common English stop words to filter from keyword extraction.
+ */
+const STOP_WORDS = new Set([
+    'the',
+    'and',
+    'for',
+    'are',
+    'but',
+    'not',
+    'you',
+    'all',
+    'can',
+    'had',
+    'her',
+    'was',
+    'one',
+    'our',
+    'out',
+    'has',
+    'have',
+    'been',
+    'will',
+    'from',
+    'they',
+    'each',
+    'make',
+    'like',
+    'been',
+    'this',
+    'that',
+    'with',
+    'into',
+    'then',
+    'than',
+    'them',
+    'these',
+    'some',
+    'would',
+    'other',
+    'about',
+    'which',
+    'when',
+    'what',
+    'there',
+    'their',
+    'said',
+    'use',
+    'used',
+    'using',
+    'should',
+    'also',
+    'does',
+    'did',
+    'just',
+    'more',
+    'most',
+    'very',
+    'after',
+    'before',
+    'between',
+    'could',
+    'still',
+    'over',
+    'such',
+    'only',
+    'where',
+    'while',
+    'being',
+    'same',
+    'both',
+    'way',
+]);
+//# sourceMappingURL=supersession-detection.js.map

package/dist/tools/cmos/supersession-detection.js.map

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