@aquex/cmos-mcp 1.0.0

package/dist/tools/cmos/cmos-learnings-search.d.ts

@@ -0,0 +1,69 @@
+/**
+ * cmos_learnings search action
+ *
+ * Searches learnings by keyword using LIKE matching.
+ * Supports filtering by category and sprint.
+ *
+ * @module tools/cmos/cmos-learnings-search
+ */
+import type { CmosToolResult } from './types';
+/**
+ * Learning search result.
+ */
+export interface LearningSearchResult {
+    /** Learning ID */
+    id: number;
+    /** Learning content text */
+    content: string;
+    /** Category (technical, process, agent-behavior, tooling) */
+    category: string | null;
+    /** Status (active, archived, superseded) */
+    status: string;
+    /** Associated sprint ID */
+    sprintId: string | null;
+    /** Associated session ID */
+    sessionId: string | null;
+    /** Associated mission ID */
+    missionId: string | null;
+    /** When the learning was recorded */
+    createdAt: string;
+    /** Relevance score (higher = more keyword matches) */
+    relevance: number;
+}
+/**
+ * Result of learnings search operation.
+ */
+export interface CmosLearningsSearchResult {
+    /** Search query used */
+    query: string;
+    /** Matching learnings */
+    results: LearningSearchResult[];
+    /** Total matches found */
+    totalMatches: number;
+    /** Whether results were limited */
+    limited: boolean;
+}
+/**
+ * Input parameters for learnings search action.
+ */
+export interface CmosLearningsSearchParams {
+    /** Search query (required) */
+    query: string;
+    /** Optional: filter by category */
+    category?: string;
+    /** Optional: filter by sprint ID */
+    sprintId?: string;
+    /** Optional: maximum results (1-50, default: 20) */
+    limit?: number;
+    /** Optional: explicit project root */
+    projectRoot?: string;
+}
+/**
+ * Execute the learnings search action.
+ */
+export declare function cmosLearningsSearch(params: CmosLearningsSearchParams): Promise<CmosToolResult<CmosLearningsSearchResult>>;
+/**
+ * Format learnings search result for LLM readability.
+ */
+export declare function formatLearningsSearchForLLM(result: CmosToolResult<CmosLearningsSearchResult>): string;
+//# sourceMappingURL=cmos-learnings-search.d.ts.map

package/dist/tools/cmos/cmos-learnings-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-learnings-search.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-learnings-search.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IAEX,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAEhB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,CAAC;IAEf,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,4BAA4B;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAElB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IAEd,yBAAyB;IACzB,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAEhC,0BAA0B;IAC1B,YAAY,EAAE,MAAM,CAAC;IAErB,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IAEd,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAC,CAsGpD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,cAAc,CAAC,yBAAyB,CAAC,GAChD,MAAM,CA6CR"}

package/dist/tools/cmos/cmos-learnings-search.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * cmos_learnings search action
+ *
+ * Searches learnings by keyword using LIKE matching.
+ * Supports filtering by category and sprint.
+ *
+ * @module tools/cmos/cmos-learnings-search
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosLearningsSearch = cmosLearningsSearch;
+exports.formatLearningsSearchForLLM = formatLearningsSearchForLLM;
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const schema_migrations_1 = require("./schema-migrations");
+/**
+ * Execute the learnings search action.
+ */
+async function cmosLearningsSearch(params) {
+    if (!params.query || params.query.trim().length === 0) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('query'));
+    }
+    const limit = params.limit ?? 20;
+    const query = params.query.trim();
+    const keywords = query
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((k) => k.length >= 2);
+    if (keywords.length === 0) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.invalidParameter('query', query, ['At least one keyword with 2+ characters']));
+    }
+    return (0, client_1.withClient)((client) => {
+        // Sprint 61 m03: lazy-migrate the evergreen column on the search read path.
+        (0, schema_migrations_1.ensureLearningsTable)(client);
+        const conditions = [];
+        const queryParams = [];
+        if (params.category) {
+            conditions.push('category = ?');
+            queryParams.push(params.category);
+        }
+        if (params.sprintId) {
+            conditions.push('sprint_id = ?');
+            queryParams.push(params.sprintId);
+        }
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const allResult = client.getMany(`SELECT id, content, category, status, sprint_id, session_id, mission_id, created_at
+         FROM learnings ${whereClause}
+         ORDER BY created_at DESC, id DESC`, queryParams);
+        if (!allResult.success || !allResult.data) {
+            return (0, errors_1.createSuccess)({
+                query,
+                results: [],
+                totalMatches: 0,
+                limited: false,
+            });
+        }
+        const matched = allResult.data
+            .map((row) => ({
+            row,
+            relevance: keywords.reduce((count, keyword) => count + (row.content.toLowerCase().includes(keyword) ? 1 : 0), 0),
+        }))
+            .filter((entry) => entry.relevance > 0)
+            .sort((a, b) => b.relevance - a.relevance ||
+            b.row.created_at.localeCompare(a.row.created_at) ||
+            b.row.id - a.row.id);
+        const totalMatches = matched.length;
+        const results = matched.slice(0, limit).map(({ row, relevance }) => ({
+            id: row.id,
+            content: row.content,
+            category: row.category,
+            status: row.status,
+            sprintId: row.sprint_id,
+            sessionId: row.session_id,
+            missionId: row.mission_id,
+            createdAt: row.created_at,
+            relevance,
+        }));
+        return (0, errors_1.createSuccess)({
+            query,
+            results,
+            totalMatches,
+            limited: totalMatches > limit,
+        });
+    }, { projectRoot: params.projectRoot });
+}
+/**
+ * Format learnings search result for LLM readability.
+ */
+function formatLearningsSearchForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        return [
+            '❌ Failed to search learnings',
+            '',
+            `Error: ${error?.message ?? 'Unknown error'}`,
+            error?.suggestion ? `Suggestion: ${error.suggestion}` : '',
+        ]
+            .filter(Boolean)
+            .join('\n');
+    }
+    const data = result.data;
+    const lines = [];
+    lines.push('🔍 **Learning Search Results**');
+    lines.push('');
+    lines.push(`Query: "${data.query}"`);
+    lines.push(`Found: ${data.totalMatches} match${data.totalMatches === 1 ? '' : 'es'}`);
+    if (data.limited) {
+        lines.push(`(Showing top ${data.results.length} results)`);
+    }
+    lines.push('');
+    if (data.results.length === 0) {
+        lines.push('No learnings found matching the query.');
+        lines.push('');
+        lines.push('**Suggestions**:');
+        lines.push('  • Try different keywords');
+        lines.push('  • Use cmos_learnings list to browse all learnings');
+        return lines.join('\n');
+    }
+    for (const r of data.results) {
+        const category = r.category ? ` <${r.category}>` : '';
+        const sprint = r.sprintId ? ` (${r.sprintId})` : '';
+        const mission = r.missionId ? ` {${r.missionId}}` : '';
+        const status = r.status !== 'active' ? ` [${r.status}]` : '';
+        lines.push(`• ${r.content}${category}${sprint}${mission}${status}`);
+        lines.push(`  Created: ${r.createdAt} | Relevance: ${r.relevance}`);
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=cmos-learnings-search.js.map

package/dist/tools/cmos/cmos-learnings-search.js.map

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

package/dist/tools/cmos/cmos-learnings-update.d.ts

@@ -0,0 +1,52 @@
+/**
+ * cmos_learnings update action
+ *
+ * Updates a learning's status (active, archived, superseded).
+ * Primary use case: archiving stale learnings.
+ *
+ * @module tools/cmos/cmos-learnings-update
+ */
+import type { CmosToolResult } from './types';
+/**
+ * Result of learnings update operation.
+ */
+export interface CmosLearningsUpdateResult {
+    /** ID of the updated learning */
+    learningId: number;
+    /** Previous status */
+    previousStatus: string;
+    /** New status after update */
+    newStatus: string;
+    /** Previous evergreen flag (Sprint 61 m03). */
+    previousEvergreen: boolean;
+    /** New evergreen flag after update (Sprint 61 m03). */
+    newEvergreen: boolean;
+    /** Confirmation message */
+    message: string;
+}
+/**
+ * Input parameters for learnings update action.
+ */
+export interface CmosLearningsUpdateParams {
+    /** Learning ID to update */
+    learningId: number;
+    /** New status (optional when only toggling evergreen). */
+    status?: string;
+    /**
+     * Sprint 61 m03 — evergreen flag. When `true`, marks the learning as a
+     * still-true institutional rule and excludes it from the staleness signal.
+     * Two-way: pass `false` to clear the flag.
+     */
+    evergreen?: boolean;
+    /** Optional: explicit project root */
+    projectRoot?: string;
+}
+/**
+ * Execute the learnings update action.
+ */
+export declare function cmosLearningsUpdate(params: CmosLearningsUpdateParams): Promise<CmosToolResult<CmosLearningsUpdateResult>>;
+/**
+ * Format learnings update result for LLM readability.
+ */
+export declare function formatLearningsUpdateForLLM(result: CmosToolResult<CmosLearningsUpdateResult>): string;
+//# sourceMappingURL=cmos-learnings-update.d.ts.map

package/dist/tools/cmos/cmos-learnings-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-learnings-update.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-learnings-update.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAM9C;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IAEnB,sBAAsB;IACtB,cAAc,EAAE,MAAM,CAAC;IAEvB,8BAA8B;IAC9B,SAAS,EAAE,MAAM,CAAC;IAElB,+CAA+C;IAC/C,iBAAiB,EAAE,OAAO,CAAC;IAE3B,uDAAuD;IACvD,YAAY,EAAE,OAAO,CAAC;IAEtB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IAEnB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,cAAc,CAAC,yBAAyB,CAAC,CAAC,CA6FpD;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,cAAc,CAAC,yBAAyB,CAAC,GAChD,MAAM,CA0BR"}

package/dist/tools/cmos/cmos-learnings-update.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * cmos_learnings update action
+ *
+ * Updates a learning's status (active, archived, superseded).
+ * Primary use case: archiving stale learnings.
+ *
+ * @module tools/cmos/cmos-learnings-update
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosLearningsUpdate = cmosLearningsUpdate;
+exports.formatLearningsUpdateForLLM = formatLearningsUpdateForLLM;
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const schema_migrations_1 = require("./schema-migrations");
+const VALID_LEARNING_STATUSES = ['active', 'archived', 'superseded'];
+/**
+ * Execute the learnings update action.
+ */
+async function cmosLearningsUpdate(params) {
+    if (!params.learningId || typeof params.learningId !== 'number') {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('learningId'));
+    }
+    const hasStatus = params.status !== undefined;
+    const hasEvergreen = params.evergreen !== undefined;
+    if (!hasStatus && !hasEvergreen) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('status or evergreen'));
+    }
+    if (hasStatus && !VALID_LEARNING_STATUSES.includes(params.status)) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.invalidParameter('status', params.status, VALID_LEARNING_STATUSES));
+    }
+    return (0, client_1.withClientValidated)((client) => {
+        // Sprint 52 m03: ensure last_reviewed_at exists so we can bump it on update.
+        // Sprint 61 m03: ensure the evergreen column exists before we read/write it.
+        (0, schema_migrations_1.ensureReviewTimestamps)(client);
+        (0, schema_migrations_1.ensureLearningsTable)(client);
+        const existing = client.getOne('SELECT id, status, evergreen FROM learnings WHERE id = ?', [params.learningId]);
+        if (!existing.success || !existing.data) {
+            return (0, errors_1.createError)({
+                code: errors_1.CMOS_ERROR_CODES.MISSION_NOT_FOUND,
+                message: `Learning #${params.learningId} not found`,
+                suggestion: 'Use cmos_learnings list to find valid learning IDs',
+            });
+        }
+        const previousStatus = existing.data.status;
+        const previousEvergreen = existing.data.evergreen === 1;
+        const newStatus = hasStatus ? params.status : previousStatus;
+        const newEvergreen = hasEvergreen ? params.evergreen : previousEvergreen;
+        const nowIso = new Date().toISOString();
+        const statusChanged = newStatus !== previousStatus;
+        const evergreenChanged = newEvergreen !== previousEvergreen;
+        if (!statusChanged && !evergreenChanged) {
+            // Idempotent set still counts as a review touch — bump the timestamp so
+            // a reviewer can use update(status=current) as a tacit "still valid" ping.
+            client.execute('UPDATE learnings SET last_reviewed_at = ? WHERE id = ?', [
+                nowIso,
+                params.learningId,
+            ]);
+            return (0, errors_1.createSuccess)({
+                learningId: params.learningId,
+                previousStatus,
+                newStatus,
+                previousEvergreen,
+                newEvergreen,
+                message: 'No changes needed',
+            });
+        }
+        const updateResult = client.execute('UPDATE learnings SET status = ?, evergreen = ?, last_reviewed_at = ? WHERE id = ?', [newStatus, newEvergreen ? 1 : 0, nowIso, params.learningId]);
+        if (!updateResult.success) {
+            return (0, errors_1.createError)({
+                code: errors_1.CMOS_ERROR_CODES.DB_QUERY_FAILED,
+                message: `Failed to update learning: ${updateResult.error?.message ?? 'Unknown error'}`,
+            });
+        }
+        const messageParts = [`Learning #${params.learningId} updated`];
+        if (statusChanged)
+            messageParts.push(`status ${previousStatus} → ${newStatus}`);
+        if (evergreenChanged) {
+            messageParts.push(`evergreen ${previousEvergreen} → ${newEvergreen}`);
+        }
+        return (0, errors_1.createSuccess)({
+            learningId: params.learningId,
+            previousStatus,
+            newStatus,
+            previousEvergreen,
+            newEvergreen,
+            message: messageParts.join(': '),
+        });
+    }, { projectRoot: params.projectRoot });
+}
+/**
+ * Format learnings update result for LLM readability.
+ */
+function formatLearningsUpdateForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        return [
+            '❌ Failed to update learning',
+            '',
+            `Error: ${error?.message ?? 'Unknown error'}`,
+            error?.suggestion ? `Suggestion: ${error.suggestion}` : '',
+        ]
+            .filter(Boolean)
+            .join('\n');
+    }
+    const d = result.data;
+    const lines = ['✓ **Learning Updated**', '', `**Learning**: #${d.learningId}`];
+    if (d.previousStatus !== d.newStatus) {
+        lines.push(`**Status**: ${d.previousStatus} → ${d.newStatus}`);
+    }
+    else {
+        lines.push(`**Status**: ${d.newStatus} (unchanged)`);
+    }
+    if (d.previousEvergreen !== d.newEvergreen) {
+        lines.push(`**Evergreen**: ${d.previousEvergreen} → ${d.newEvergreen}`);
+    }
+    else if (d.newEvergreen) {
+        lines.push(`**Evergreen**: true (unchanged)`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=cmos-learnings-update.js.map

package/dist/tools/cmos/cmos-learnings-update.js.map

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

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

@@ -0,0 +1,137 @@
+/**
+ * cmos_learnings Tool
+ *
+ * Consolidated learnings tool with action parameter support.
+ * Actions: list, search, update.
+ * Routes to existing learnings handlers without rewriting business logic.
+ *
+ * @module tools/cmos/cmos-learnings
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+import { type CmosLearningsListResult } from './cmos-learnings-list';
+import { type CmosLearningsSearchResult } from './cmos-learnings-search';
+import { type CmosLearningsUpdateResult } from './cmos-learnings-update';
+import { type CmosLearningsReaffirmResult } from './cmos-learnings-reaffirm';
+export declare const CMOS_LEARNINGS_ACTIONS: readonly ["list", "search", "update", "reaffirm"];
+export type CmosLearningsAction = (typeof CMOS_LEARNINGS_ACTIONS)[number];
+export type CmosLearningsResult = CmosLearningsListResult | CmosLearningsSearchResult | CmosLearningsUpdateResult | CmosLearningsReaffirmResult;
+export declare const cmosLearningsSchema: z.ZodObject<{
+    action: z.ZodEnum<["list", "search", "update", "reaffirm"]>;
+    category: z.ZodOptional<z.ZodString>;
+    sprintId: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    since: z.ZodOptional<z.ZodString>;
+    until: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    pageSize: z.ZodOptional<z.ZodNumber>;
+    query: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    learningId: z.ZodOptional<z.ZodNumber>;
+    evergreen: z.ZodOptional<z.ZodBoolean>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    action: "search" | "list" | "update" | "reaffirm";
+    projectRoot?: string | undefined;
+    status?: string | undefined;
+    category?: string | undefined;
+    evergreen?: boolean | undefined;
+    sprintId?: string | undefined;
+    limit?: number | undefined;
+    since?: string | undefined;
+    until?: string | undefined;
+    page?: number | undefined;
+    pageSize?: number | undefined;
+    learningId?: number | undefined;
+    query?: string | undefined;
+}, {
+    action: "search" | "list" | "update" | "reaffirm";
+    projectRoot?: string | undefined;
+    status?: string | undefined;
+    category?: string | undefined;
+    evergreen?: boolean | undefined;
+    sprintId?: string | undefined;
+    limit?: number | undefined;
+    since?: string | undefined;
+    until?: string | undefined;
+    page?: number | undefined;
+    pageSize?: number | undefined;
+    learningId?: number | undefined;
+    query?: string | undefined;
+}>;
+export type CmosLearningsParams = z.infer<typeof cmosLearningsSchema>;
+export declare const cmosLearningsToolDefinition: {
+    readonly name: "cmos_learnings";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["list", "search", "update", "reaffirm"];
+                readonly description: "Learnings action: list | search | update | reaffirm";
+            };
+            readonly category: {
+                readonly type: "string";
+                readonly enum: readonly ["technical", "process", "agent-behavior", "tooling"];
+                readonly description: "Filter by category";
+            };
+            readonly sprintId: {
+                readonly type: "string";
+                readonly description: "Filter by sprint ID";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["active", "archived", "superseded"];
+                readonly description: "Filter by status (list) or new status (update)";
+            };
+            readonly since: {
+                readonly type: "string";
+                readonly description: "ISO date lower bound for list action";
+            };
+            readonly until: {
+                readonly type: "string";
+                readonly description: "ISO date upper bound for list action";
+            };
+            readonly page: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly description: "Page number for list action";
+            };
+            readonly pageSize: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly description: "Page size for list action";
+            };
+            readonly query: {
+                readonly type: "string";
+                readonly description: "Search query for search action";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 50;
+                readonly description: "Maximum results for search action";
+            };
+            readonly learningId: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly description: "Learning ID for update action";
+            };
+            readonly evergreen: {
+                readonly type: "boolean";
+                readonly description: "Toggle institutional-rule flag for the learning. true = exclude from staleness signal; false = clear flag (Sprint 61 m03).";
+            };
+            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 cmosLearnings(params: CmosLearningsParams): Promise<CmosToolResult<CmosLearningsResult>>;
+export declare function formatLearningsForLLM(action: string | undefined, result: CmosToolResult<CmosLearningsResult>): string;
+//# sourceMappingURL=cmos-learnings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-learnings.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-learnings.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,uBAAuB,EAC7B,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,2BAA2B,EACjC,MAAM,2BAA2B,CAAC;AAEnC,eAAO,MAAM,sBAAsB,mDAAoD,CAAC;AAExF,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1E,MAAM,MAAM,mBAAmB,GAC3B,uBAAuB,GACvB,yBAAyB,GACzB,yBAAyB,GACzB,2BAA2B,CAAC;AAEhC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6CrB,CAAC;AAEZ,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEtE,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8D9B,CAAC;AAMX,wBAAsB,aAAa,CACjC,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CA2C9C;AAED,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,cAAc,CAAC,mBAAmB,CAAC,GAC1C,MAAM,CAqCR"}