@aquex/cmos-mcp 1.0.0

package/dist/tools/cmos/errors.js

@@ -0,0 +1,315 @@
+"use strict";
+/**
+ * CMOS Error Codes
+ *
+ * Standardized error codes for all CMOS tools.
+ * Each code maps to a consistent error pattern with actionable suggestions.
+ *
+ * @module tools/cmos/errors
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CmosErrors = exports.VALID_CONTEXT_TYPES = exports.VALID_SESSION_TYPES = exports.VALID_STATE_TRANSITIONS = exports.VALID_MISSION_STATUSES = exports.CMOS_ERROR_CODES = void 0;
+exports.createError = createError;
+exports.createSuccess = createSuccess;
+exports.withSanitizedFields = withSanitizedFields;
+/**
+ * CMOS-specific error codes.
+ * Naming convention: ENTITY_ERROR_TYPE
+ */
+exports.CMOS_ERROR_CODES = {
+    // Database errors
+    DB_NOT_FOUND: 'DB_NOT_FOUND',
+    DB_CONNECTION_FAILED: 'DB_CONNECTION_FAILED',
+    DB_QUERY_FAILED: 'DB_QUERY_FAILED',
+    DB_SCHEMA_MISMATCH: 'DB_SCHEMA_MISMATCH',
+    // Mission errors
+    MISSION_NOT_FOUND: 'MISSION_NOT_FOUND',
+    MISSION_INVALID_STATE: 'MISSION_INVALID_STATE',
+    MISSION_INVALID_TRANSITION: 'MISSION_INVALID_TRANSITION',
+    MISSION_ALREADY_COMPLETED: 'MISSION_ALREADY_COMPLETED',
+    MISSION_ALREADY_BLOCKED: 'MISSION_ALREADY_BLOCKED',
+    // Context errors
+    CONTEXT_NOT_FOUND: 'CONTEXT_NOT_FOUND',
+    CONTEXT_INVALID_TYPE: 'CONTEXT_INVALID_TYPE',
+    CONTEXT_PARSE_ERROR: 'CONTEXT_PARSE_ERROR',
+    CONTEXT_CONDENSATION_FAILED: 'CONTEXT_CONDENSATION_FAILED',
+    // Session errors
+    SESSION_NOT_FOUND: 'SESSION_NOT_FOUND',
+    SESSION_ALREADY_ACTIVE: 'SESSION_ALREADY_ACTIVE',
+    SESSION_NOT_ACTIVE: 'SESSION_NOT_ACTIVE',
+    SESSION_INVALID_TYPE: 'SESSION_INVALID_TYPE',
+    // Sprint errors
+    SPRINT_NOT_FOUND: 'SPRINT_NOT_FOUND',
+    SPRINT_ID_EXISTS: 'SPRINT_ID_EXISTS',
+    SPRINT_ALREADY_COMPLETED: 'SPRINT_ALREADY_COMPLETED',
+    SPRINT_NOT_READY: 'SPRINT_NOT_READY',
+    // Validation errors
+    INVALID_PARAMETER: 'INVALID_PARAMETER',
+    INVALID_ACTION: 'INVALID_ACTION',
+    MISSING_PARAMETER: 'MISSING_PARAMETER',
+    PROJECT_ID_MISMATCH: 'PROJECT_ID_MISMATCH',
+    // Snapshot errors
+    SNAPSHOT_NOT_FOUND: 'SNAPSHOT_NOT_FOUND',
+    SNAPSHOT_CREATION_FAILED: 'SNAPSHOT_CREATION_FAILED',
+    SNAPSHOT_RESTORE_FAILED: 'SNAPSHOT_RESTORE_FAILED',
+    // CMOS detection errors
+    CMOS_NOT_DETECTED: 'CMOS_NOT_DETECTED',
+    // Dashboard errors (Sprint 28)
+    DASHBOARD_UNREACHABLE: 'DASHBOARD_UNREACHABLE',
+    DASHBOARD_AUTH_FAILED: 'DASHBOARD_AUTH_FAILED',
+    DASHBOARD_NOT_FOUND: 'DASHBOARD_NOT_FOUND',
+    DASHBOARD_ERROR: 'DASHBOARD_ERROR',
+    DASHBOARD_NOT_CONFIGURED: 'DASHBOARD_NOT_CONFIGURED',
+    DASHBOARD_UPGRADE_REQUIRED: 'DASHBOARD_UPGRADE_REQUIRED',
+    // Device code flow errors (Sprint 58 m01)
+    DEVICE_CODE_EXPIRED: 'DEVICE_CODE_EXPIRED',
+    DEVICE_CODE_ACCESS_DENIED: 'DEVICE_CODE_ACCESS_DENIED',
+};
+/**
+ * Valid mission statuses for validation.
+ */
+exports.VALID_MISSION_STATUSES = [
+    'Queued',
+    'Current',
+    'In Progress',
+    'Completed',
+    'Blocked',
+    'Dropped',
+    'Deferred',
+];
+/**
+ * Valid state transitions for missions.
+ */
+exports.VALID_STATE_TRANSITIONS = {
+    Queued: ['Current', 'In Progress', 'Dropped', 'Deferred'],
+    Current: ['In Progress', 'Blocked', 'Dropped', 'Deferred'],
+    'In Progress': ['Completed', 'Blocked', 'Dropped', 'Deferred'],
+    Completed: [], // Terminal state
+    Blocked: ['In Progress', 'Current', 'Dropped', 'Deferred'],
+    Dropped: [], // Terminal state — soft parked, cannot be re-activated
+    Deferred: ['Queued', 'Current', 'Dropped'], // Temporarily parked — can re-queue or drop
+};
+/**
+ * Valid session types matching cmos/docs/session-management-guide.md.
+ */
+exports.VALID_SESSION_TYPES = [
+    'onboarding',
+    'planning',
+    'review',
+    'research',
+    'check-in',
+    'custom',
+];
+/**
+ * Valid context types.
+ */
+exports.VALID_CONTEXT_TYPES = ['project_context', 'master_context'];
+/**
+ * Create a standardized error result.
+ */
+function createError(error) {
+    return {
+        success: false,
+        error,
+    };
+}
+/**
+ * Create a success result.
+ */
+function createSuccess(data, warnings, sanitizedFields) {
+    const result = {
+        success: true,
+        data,
+    };
+    if (warnings && warnings.length > 0) {
+        result.warnings = warnings;
+    }
+    if (sanitizedFields && sanitizedFields.length > 0) {
+        result.sanitizedFields = sanitizedFields;
+    }
+    return result;
+}
+/**
+ * Attach sanitizedFields to an already-constructed result, preserving the rest
+ * of the shape. No-op when the sanitization surfaced nothing.
+ *
+ * Useful for wrapping existing handlers where restructuring createSuccess call
+ * sites would be invasive — the handler computes its result, then calls this.
+ */
+function withSanitizedFields(result, sanitizedFields) {
+    if (!sanitizedFields || sanitizedFields.length === 0) {
+        return result;
+    }
+    return { ...result, sanitizedFields };
+}
+/**
+ * Error factory functions for common error patterns.
+ */
+exports.CmosErrors = {
+    dbNotFound(path) {
+        return {
+            code: exports.CMOS_ERROR_CODES.DB_NOT_FOUND,
+            message: `CMOS database not found at '${path}'`,
+            suggestion: 'Ensure the cmos/ directory exists and contains db/cmos.sqlite',
+        };
+    },
+    dbConnectionFailed(path, reason) {
+        return {
+            code: exports.CMOS_ERROR_CODES.DB_CONNECTION_FAILED,
+            message: `Failed to connect to database at '${path}': ${reason}`,
+            suggestion: 'Check file permissions and ensure the database is not locked',
+        };
+    },
+    missionNotFound(missionId) {
+        return {
+            code: exports.CMOS_ERROR_CODES.MISSION_NOT_FOUND,
+            message: `Mission '${missionId}' not found`,
+            suggestion: 'Use cmos_mission_list to see available missions',
+        };
+    },
+    missionInvalidTransition(missionId, currentStatus, targetStatus) {
+        const validTransitions = exports.VALID_STATE_TRANSITIONS[currentStatus];
+        return {
+            code: exports.CMOS_ERROR_CODES.MISSION_INVALID_TRANSITION,
+            message: `Cannot transition mission '${missionId}' from '${currentStatus}' to '${targetStatus}'`,
+            currentState: currentStatus,
+            validTransitions,
+            suggestion: validTransitions.length > 0
+                ? `Valid transitions from '${currentStatus}': ${validTransitions.join(', ')}`
+                : `Mission is in terminal state '${currentStatus}' and cannot be changed`,
+        };
+    },
+    contextNotFound(contextType) {
+        return {
+            code: exports.CMOS_ERROR_CODES.CONTEXT_NOT_FOUND,
+            message: `Context '${contextType}' not found`,
+            suggestion: 'Use cmos_context_view to list available contexts',
+            validValues: exports.VALID_CONTEXT_TYPES,
+        };
+    },
+    invalidParameter(field, providedValue, validValues) {
+        const error = {
+            code: exports.CMOS_ERROR_CODES.INVALID_PARAMETER,
+            message: `Invalid value for parameter '${field}'`,
+            field,
+            providedValue,
+        };
+        if (validValues) {
+            error.validValues = validValues;
+            error.suggestion = `Valid values: ${validValues.join(', ')}`;
+        }
+        return error;
+    },
+    invalidAction(tool, providedValue, availableActions) {
+        const normalizedValue = typeof providedValue === 'string' ? providedValue.trim() : '';
+        return {
+            code: exports.CMOS_ERROR_CODES.INVALID_ACTION,
+            message: normalizedValue
+                ? `Action '${normalizedValue}' is not supported for ${tool}`
+                : `Action is required for ${tool}`,
+            suggestion: `Use one of the available actions: ${availableActions.join(', ')}`,
+            field: 'action',
+            providedValue,
+            validValues: [...availableActions],
+            availableActions: [...availableActions],
+            available_actions: [...availableActions],
+        };
+    },
+    missingParameter(field) {
+        return {
+            code: exports.CMOS_ERROR_CODES.MISSING_PARAMETER,
+            message: `Required parameter '${field}' is missing`,
+            field,
+            suggestion: `Please provide a value for '${field}'`,
+        };
+    },
+    sessionNotFound(sessionId) {
+        return {
+            code: exports.CMOS_ERROR_CODES.SESSION_NOT_FOUND,
+            message: `Session '${sessionId}' not found`,
+            suggestion: 'Use cmos_session_list to see available sessions',
+        };
+    },
+    sessionNotActive(sessionId) {
+        return {
+            code: exports.CMOS_ERROR_CODES.SESSION_NOT_ACTIVE,
+            message: `Session '${sessionId}' is not active`,
+            suggestion: 'Only active sessions can be captured to or completed',
+        };
+    },
+    cmosNotDetected(searchPath) {
+        return {
+            code: exports.CMOS_ERROR_CODES.CMOS_NOT_DETECTED,
+            message: `CMOS directory not found starting from '${searchPath}'`,
+            suggestion: 'CMOS tools require a cmos/ directory with db/cmos.sqlite. Create one or navigate to a CMOS-enabled project.',
+        };
+    },
+    snapshotNotFound(snapshotId) {
+        return {
+            code: exports.CMOS_ERROR_CODES.SNAPSHOT_NOT_FOUND,
+            message: `Snapshot '${snapshotId}' not found`,
+            suggestion: 'Use cmos_db_snapshot to create a new snapshot',
+        };
+    },
+    sprintNotFound(sprintId) {
+        return {
+            code: exports.CMOS_ERROR_CODES.SPRINT_NOT_FOUND,
+            message: `Sprint '${sprintId}' not found`,
+            suggestion: 'Use cmos_sprint with action="list" to see available sprints',
+        };
+    },
+    sprintIdExists(sprintId) {
+        return {
+            code: exports.CMOS_ERROR_CODES.SPRINT_ID_EXISTS,
+            message: `Sprint '${sprintId}' already exists`,
+            suggestion: 'Choose a different sprint ID or use cmos_sprint with action="update" to modify it',
+        };
+    },
+    dashboardUnreachable(url, reason) {
+        return {
+            code: exports.CMOS_ERROR_CODES.DASHBOARD_UNREACHABLE,
+            message: `Dashboard unreachable at '${url}': ${reason}`,
+            suggestion: 'Ensure the cmos-dashboard is running and CMOS_DASHBOARD_URL is correctly configured',
+        };
+    },
+    dashboardAuthFailed(url) {
+        return {
+            code: exports.CMOS_ERROR_CODES.DASHBOARD_AUTH_FAILED,
+            message: `Authentication failed for dashboard at '${url}'`,
+            suggestion: 'Verify CMOS_DASHBOARD_USER and CMOS_DASHBOARD_PASSWORD are correct',
+        };
+    },
+    dashboardNotFound(resource, detail, hint) {
+        const message = detail
+            ? `Dashboard 404 on ${resource}: ${detail}`
+            : `Dashboard resource not found: ${resource}`;
+        return {
+            code: exports.CMOS_ERROR_CODES.DASHBOARD_NOT_FOUND,
+            message,
+            suggestion: hint ?? 'Verify the resource ID or address is correct',
+        };
+    },
+    dashboardError(message) {
+        return {
+            code: exports.CMOS_ERROR_CODES.DASHBOARD_ERROR,
+            message: `Dashboard error: ${message}`,
+            suggestion: 'Check the dashboard logs for more details',
+        };
+    },
+    dashboardNotConfigured() {
+        return {
+            code: exports.CMOS_ERROR_CODES.DASHBOARD_NOT_CONFIGURED,
+            message: 'This feature requires a dashboard account. Sign up at https://cmos.aquex.ai to enable sync, messaging, and cross-project features.',
+            suggestion: 'Set CMOS_DASHBOARD_URL=https://cmos.aquex.ai (or your dashboard host) and run cmos_auth(action="login") to bootstrap credentials. Local-only CMOS works without this.',
+        };
+    },
+    dashboardUpgradeRequired(detail) {
+        const detailSuffix = detail ? `: ${detail}` : '';
+        return {
+            code: exports.CMOS_ERROR_CODES.DASHBOARD_UPGRADE_REQUIRED,
+            message: `This feature requires a paid dashboard tier${detailSuffix}. Upgrade at https://cmos.aquex.ai to access it.`,
+            suggestion: 'Visit https://cmos.aquex.ai to view tier options and upgrade. Local-only CMOS features remain unaffected.',
+        };
+    },
+};
+//# sourceMappingURL=errors.js.map

package/dist/tools/cmos/errors.js.map

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

package/dist/tools/cmos/fts5-retriever.d.ts

@@ -0,0 +1,101 @@
+import type { CmosDatabaseClient } from './client';
+export type RankedResultType = 'decision' | 'learning' | 'mission' | 'session';
+/** A single ranked retrieval result. */
+export interface RankedResult {
+    /** Unique row ID in the source table */
+    id: number;
+    /** Content type */
+    type: RankedResultType;
+    /** The primary text of the result */
+    text: string;
+    /** Combined relevance + recency score (higher is better) */
+    score: number;
+    /** Raw BM25 score from FTS5 (positive, higher is better) */
+    bm25Score: number;
+    /** Recency decay factor 0–1 (1 = fresh, approaches 0 for old items) */
+    recencyFactor: number;
+    /** Age in days at retrieval time */
+    ageDays: number;
+    /** Sprint the item belongs to (null if unknown) */
+    sprintId: string | null;
+    /** Item category (decisions only, null otherwise) */
+    category: string | null;
+    /** Evidence references (decisions only, null otherwise) */
+    evidence: string | null;
+    /** ISO timestamp the item was created */
+    createdAt: string | null;
+}
+/** Options for retrieval. */
+export interface RetrievalOptions {
+    /** Max results to return (default: 5) */
+    limit?: number;
+    /** Content types to include (default: ['decision']) */
+    types?: RankedResultType[];
+    /** Last N sprints to include (0 = all, default: 0) */
+    sprintRange?: number;
+    /** Weight given to recency decay: 0 = pure BM25, 1 = full decay (default: 0.5) */
+    recencyWeight?: number;
+    /** Minimum combined score to include in results (default: 0) */
+    minScore?: number;
+    /** Status filter for decisions (default: ['active']) */
+    statusFilter?: string[];
+}
+/** What a retriever backend supports. */
+export interface RetrieverCapabilities {
+    /** Backend identifier */
+    backend: 'fts5' | 'vector' | 'hybrid';
+    /** Whether semantic (embedding-based) search is supported */
+    semanticSearch: boolean;
+    /** Content types this retriever can search */
+    supportedTypes: RankedResultType[];
+    /** Whether recency boost is applied */
+    recencyBoost: boolean;
+}
+/** Pluggable retrieval interface. All retriever backends implement this. */
+export interface IRetriever {
+    /**
+     * Search for content relevant to the query string.
+     * Returns ranked results ordered by combined score (descending).
+     */
+    search(query: string, options?: RetrievalOptions): RankedResult[];
+    /**
+     * Fetch a specific item by ID and type.
+     * Returns null if not found.
+     */
+    get(id: number, type: RankedResultType): RankedResult | null;
+    /** What this retriever supports. */
+    capabilities(): RetrieverCapabilities;
+}
+/**
+ * FTS5-based retriever using SQLite's built-in full-text search.
+ *
+ * Scores results using BM25 × recency decay:
+ *   score = bm25Score * (1 - w + w * exp(-ageDays / halfLife))
+ * where w = recencyWeight (0 = pure BM25, 1 = full recency decay).
+ *
+ * Currently supports 'decision' type only. Other types (learning, mission, session)
+ * can be added in future sprints via the IRetriever interface.
+ */
+export declare class FTS5Retriever implements IRetriever {
+    private readonly client;
+    constructor(client: CmosDatabaseClient);
+    capabilities(): RetrieverCapabilities;
+    search(query: string, options?: RetrievalOptions): RankedResult[];
+    get(id: number, type: RankedResultType): RankedResult | null;
+    private searchDecisions;
+    private tryFts5;
+    private scoreDecisionRows;
+    private keywordLikeFallback;
+}
+/**
+ * Compute the recency decay factor for an item created at the given ISO timestamp.
+ * Formula: exp(-ageDays / RECENCY_HALF_LIFE_DAYS)
+ * Range: 0–1 (1 = just created, approaches 0 for very old items).
+ */
+export declare function computeRecencyFactor(ageDays: number): number;
+/**
+ * Compute item age in days from its created_at ISO timestamp.
+ * Returns 0 for null/invalid timestamps (treat as current).
+ */
+export declare function computeAgeDays(createdAt: string | null): number;
+//# sourceMappingURL=fts5-retriever.d.ts.map

package/dist/tools/cmos/fts5-retriever.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fts5-retriever.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/fts5-retriever.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAMnD,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/E,wCAAwC;AACxC,MAAM,WAAW,YAAY;IAC3B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IAEX,mBAAmB;IACnB,IAAI,EAAE,gBAAgB,CAAC;IAEvB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IAEb,4DAA4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IAEd,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAElB,uEAAuE;IACvE,aAAa,EAAE,MAAM,CAAC;IAEtB,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAEhB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,yCAAyC;IACzC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,6BAA6B;AAC7B,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,uDAAuD;IACvD,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAE3B,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,wDAAwD;IACxD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,yCAAyC;AACzC,MAAM,WAAW,qBAAqB;IACpC,yBAAyB;IACzB,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAEtC,6DAA6D;IAC7D,cAAc,EAAE,OAAO,CAAC;IAExB,8CAA8C;IAC9C,cAAc,EAAE,gBAAgB,EAAE,CAAC;IAEnC,uCAAuC;IACvC,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAAC;IAElE;;;OAGG;IACH,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,YAAY,GAAG,IAAI,CAAC;IAE7D,oCAAoC;IACpC,YAAY,IAAI,qBAAqB,CAAC;CACvC;AAkBD;;;;;;;;;GASG;AACH,qBAAa,aAAc,YAAW,UAAU;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,kBAAkB;IAEvD,YAAY,IAAI,qBAAqB;IASrC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,YAAY,EAAE;IA8BrE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,YAAY,GAAG,IAAI;IAwC5D,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,OAAO;IA6Bf,OAAO,CAAC,iBAAiB;IAsDzB,OAAO,CAAC,mBAAmB;CAsD5B;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAM/D"}

package/dist/tools/cmos/fts5-retriever.js

@@ -0,0 +1,210 @@
+"use strict";
+// ABOUTME: FTS5Retriever — Layer 3 working retrieval, v1 backend.
+// Implements IRetriever using the decisions_fts virtual table with BM25 × recency decay scoring.
+// Zero new dependencies. VectorRetriever is a future optional backend.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FTS5Retriever = void 0;
+exports.computeRecencyFactor = computeRecencyFactor;
+exports.computeAgeDays = computeAgeDays;
+const schema_migrations_1 = require("./schema-migrations");
+const supersession_detection_1 = require("./supersession-detection");
+// ─── Constants ────────────────────────────────────────────────────────────────
+/** Recency decay half-life in days. After this many days, score is halved. */
+const RECENCY_HALF_LIFE_DAYS = 60;
+/** Default recency weight (blend between BM25 and recency decay). */
+const DEFAULT_RECENCY_WEIGHT = 0.5;
+/** Default number of results to return. */
+const DEFAULT_LIMIT = 5;
+/** FTS5 candidate pool multiplier before score filtering. */
+const CANDIDATE_POOL_MULTIPLIER = 5;
+// ─── FTS5Retriever ────────────────────────────────────────────────────────────
+/**
+ * FTS5-based retriever using SQLite's built-in full-text search.
+ *
+ * Scores results using BM25 × recency decay:
+ *   score = bm25Score * (1 - w + w * exp(-ageDays / halfLife))
+ * where w = recencyWeight (0 = pure BM25, 1 = full recency decay).
+ *
+ * Currently supports 'decision' type only. Other types (learning, mission, session)
+ * can be added in future sprints via the IRetriever interface.
+ */
+class FTS5Retriever {
+    constructor(client) {
+        this.client = client;
+    }
+    capabilities() {
+        return {
+            backend: 'fts5',
+            semanticSearch: false,
+            supportedTypes: ['decision'],
+            recencyBoost: true,
+        };
+    }
+    search(query, options = {}) {
+        const { limit = DEFAULT_LIMIT, types = ['decision'], recencyWeight = DEFAULT_RECENCY_WEIGHT, minScore = 0, statusFilter = ['active'], } = options;
+        const results = [];
+        for (const type of types) {
+            if (type === 'decision') {
+                const decisionResults = this.searchDecisions(query, limit * CANDIDATE_POOL_MULTIPLIER, recencyWeight, statusFilter);
+                results.push(...decisionResults);
+            }
+            // Future: learning, mission, session backends added here
+        }
+        return results
+            .filter((r) => r.score >= minScore)
+            .sort((a, b) => b.score - a.score)
+            .slice(0, limit);
+    }
+    get(id, type) {
+        if (type !== 'decision')
+            return null;
+        const result = this.client.getOne(`SELECT id, decision_text, category, sprint_id, evidence, created_at, status
+       FROM strategic_decisions
+       WHERE id = ?`, [id]);
+        if (!result.success || !result.data)
+            return null;
+        const row = result.data;
+        const ageDays = computeAgeDays(row.created_at);
+        const recencyFactor = computeRecencyFactor(ageDays);
+        return {
+            id: row.id,
+            type: 'decision',
+            text: row.decision_text,
+            score: recencyFactor, // No BM25 for direct get
+            bm25Score: 1.0,
+            recencyFactor,
+            ageDays,
+            sprintId: row.sprint_id,
+            category: row.category,
+            evidence: row.evidence,
+            createdAt: row.created_at,
+        };
+    }
+    // ─── Private ─────────────────────────────────────────────────────────────
+    searchDecisions(query, candidateLimit, recencyWeight, statusFilter) {
+        (0, schema_migrations_1.ensureDecisionsFts5)(this.client);
+        const keywords = (0, supersession_detection_1.extractKeywords)(query);
+        if (keywords.length === 0)
+            return [];
+        // Try FTS5 first
+        const ftsResults = this.tryFts5(keywords, candidateLimit);
+        if (ftsResults !== null) {
+            return this.scoreDecisionRows(ftsResults, recencyWeight, statusFilter);
+        }
+        // Keyword LIKE fallback
+        return this.keywordLikeFallback(keywords, candidateLimit, recencyWeight, statusFilter);
+    }
+    tryFts5(keywords, candidateLimit) {
+        // Check FTS5 table exists
+        const check = this.client.getOne("SELECT name FROM sqlite_master WHERE type='table' AND name='decisions_fts'", []);
+        if (!check.success || !check.data)
+            return null;
+        // Build OR query with quoted literals to handle special chars
+        const ftsQuery = keywords
+            .slice(0, 10)
+            .map((k) => `"${k.replace(/"/g, '""')}"`)
+            .join(' OR ');
+        try {
+            const result = this.client.getMany('SELECT rowid, rank FROM decisions_fts WHERE decisions_fts MATCH ? ORDER BY rank LIMIT ?', [ftsQuery, candidateLimit]);
+            if (!result.success || !result.data || result.data.length === 0)
+                return null;
+            return result.data;
+        }
+        catch {
+            return null;
+        }
+    }
+    scoreDecisionRows(ftsRows, recencyWeight, statusFilter) {
+        const rowIds = ftsRows.map((r) => r.rowid);
+        // Build a rowid → rank map for scoring after DB fetch
+        const rankMap = new Map(ftsRows.map((r) => [r.rowid, r.rank]));
+        const placeholders = rowIds.map(() => '?').join(', ');
+        const statusPlaceholders = statusFilter.map(() => '?').join(', ');
+        const result = this.client.getMany(`SELECT id, decision_text, category, sprint_id, evidence, created_at
+       FROM strategic_decisions
+       WHERE id IN (${placeholders})
+         AND status IN (${statusPlaceholders})`, [...rowIds, ...statusFilter]);
+        if (!result.success || !result.data)
+            return [];
+        return result.data.map((row) => {
+            const rawRank = rankMap.get(row.id) ?? -1;
+            // FTS5 rank is negative: more negative = better match
+            // Convert to positive: higher bm25Score = better match
+            const bm25Score = Math.abs(rawRank);
+            const ageDays = computeAgeDays(row.created_at);
+            const recencyFactor = computeRecencyFactor(ageDays);
+            const score = bm25Score * (1 - recencyWeight + recencyWeight * recencyFactor);
+            return {
+                id: row.id,
+                type: 'decision',
+                text: row.decision_text,
+                score,
+                bm25Score,
+                recencyFactor,
+                ageDays,
+                sprintId: row.sprint_id,
+                category: row.category,
+                evidence: row.evidence,
+                createdAt: row.created_at,
+            };
+        });
+    }
+    keywordLikeFallback(keywords, candidateLimit, recencyWeight, statusFilter) {
+        const topKeywords = keywords.slice(0, 5);
+        const likeConditions = topKeywords.map(() => 'LOWER(decision_text) LIKE ?');
+        const likeParams = topKeywords.map((k) => `%${k.toLowerCase()}%`);
+        const statusPlaceholders = statusFilter.map(() => '?').join(', ');
+        const result = this.client.getMany(`SELECT id, decision_text, category, sprint_id, evidence, created_at
+       FROM strategic_decisions
+       WHERE status IN (${statusPlaceholders})
+         AND (${likeConditions.join(' OR ')})
+       LIMIT ?`, [...statusFilter, ...likeParams, candidateLimit]);
+        if (!result.success || !result.data)
+            return [];
+        return result.data.map((row) => {
+            // No BM25 in fallback — use keyword overlap as proxy
+            const matchCount = topKeywords.filter((k) => row.decision_text.toLowerCase().includes(k)).length;
+            const bm25Score = matchCount / topKeywords.length; // Normalize 0–1
+            const ageDays = computeAgeDays(row.created_at);
+            const recencyFactor = computeRecencyFactor(ageDays);
+            const score = bm25Score * (1 - recencyWeight + recencyWeight * recencyFactor);
+            return {
+                id: row.id,
+                type: 'decision',
+                text: row.decision_text,
+                score,
+                bm25Score,
+                recencyFactor,
+                ageDays,
+                sprintId: row.sprint_id,
+                category: row.category,
+                evidence: row.evidence,
+                createdAt: row.created_at,
+            };
+        });
+    }
+}
+exports.FTS5Retriever = FTS5Retriever;
+// ─── Scoring helpers ──────────────────────────────────────────────────────────
+/**
+ * Compute the recency decay factor for an item created at the given ISO timestamp.
+ * Formula: exp(-ageDays / RECENCY_HALF_LIFE_DAYS)
+ * Range: 0–1 (1 = just created, approaches 0 for very old items).
+ */
+function computeRecencyFactor(ageDays) {
+    return Math.exp(-ageDays / RECENCY_HALF_LIFE_DAYS);
+}
+/**
+ * Compute item age in days from its created_at ISO timestamp.
+ * Returns 0 for null/invalid timestamps (treat as current).
+ */
+function computeAgeDays(createdAt) {
+    if (!createdAt)
+        return 0;
+    const created = new Date(createdAt).getTime();
+    if (isNaN(created))
+        return 0;
+    const nowMs = Date.now();
+    return Math.max(0, (nowMs - created) / (1000 * 60 * 60 * 24));
+}
+//# sourceMappingURL=fts5-retriever.js.map

package/dist/tools/cmos/fts5-retriever.js.map

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