@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,259 @@
+"use strict";
+// ABOUTME: cmos_feedback — review surface for agent_feedback rows written by the Sprint 56 m03 standing channel.
+// ABOUTME: Consolidated tool with list | triage | resolve | archive actions.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosFeedbackToolDefinition = exports.cmosFeedbackSchema = exports.CMOS_FEEDBACK_ACTIONS = void 0;
+exports.cmosFeedback = cmosFeedback;
+exports.formatFeedbackForLLM = formatFeedbackForLLM;
+/**
+ * cmos_feedback Tool
+ *
+ * Review/triage surface for the agent_feedback standing channel. Agents write
+ * UX feedback via the `agentFeedback` parameter on cmos_session_complete,
+ * cmos_mission_transition, and cmos_agent_onboard. The operator uses this
+ * tool to read, triage, resolve, and archive those entries.
+ *
+ * @module tools/cmos/cmos-feedback
+ */
+const zod_1 = require("zod");
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const schema_migrations_1 = require("./schema-migrations");
+/** Valid actions on the cmos_feedback consolidated tool. */
+exports.CMOS_FEEDBACK_ACTIONS = ['list', 'triage', 'resolve', 'archive'];
+exports.cmosFeedbackSchema = zod_1.z
+    .object({
+    action: zod_1.z
+        .enum(exports.CMOS_FEEDBACK_ACTIONS)
+        .describe('Feedback action: list | triage | resolve | archive'),
+    feedbackId: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .optional()
+        .describe('Target feedback row ID (required for triage/resolve/archive)'),
+    status: zod_1.z
+        .enum(schema_migrations_1.AGENT_FEEDBACK_STATUSES)
+        .optional()
+        .describe('Filter by status on list (default: "open")'),
+    toolName: zod_1.z
+        .string()
+        .optional()
+        .describe('Filter by originating tool name on list (e.g. "cmos_session_complete")'),
+    limit: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe('Max entries to return on list (default 50, max 200)'),
+    resolutionNote: zod_1.z
+        .string()
+        .max(1000)
+        .optional()
+        .describe('Optional free-text note for resolve/archive actions'),
+    projectRoot: zod_1.z
+        .string()
+        .optional()
+        .describe('Project root directory to search for CMOS database (defaults to cwd)'),
+})
+    .strict();
+exports.cmosFeedbackToolDefinition = {
+    name: 'cmos_feedback',
+    description: 'Review and triage the agent_feedback standing channel. Actions: list (filterable by status + tool_name), triage (mark under review), resolve (close with optional note), archive (hide without resolving).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: [...exports.CMOS_FEEDBACK_ACTIONS],
+                description: 'Feedback action: list | triage | resolve | archive',
+            },
+            feedbackId: {
+                type: 'number',
+                description: 'Target feedback row ID (required for triage/resolve/archive)',
+            },
+            status: {
+                type: 'string',
+                enum: [...schema_migrations_1.AGENT_FEEDBACK_STATUSES],
+                description: 'Filter by status on list (default: "open")',
+            },
+            toolName: {
+                type: 'string',
+                description: 'Filter by originating tool name on list',
+            },
+            limit: {
+                type: 'number',
+                minimum: 1,
+                maximum: 200,
+                description: 'Max entries to return on list (default 50, max 200)',
+            },
+            resolutionNote: {
+                type: 'string',
+                maxLength: 1000,
+                description: 'Optional free-text note for resolve/archive actions',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['action'],
+        additionalProperties: false,
+    },
+};
+function rowToEntry(row) {
+    return {
+        id: row.id,
+        toolName: row.tool_name,
+        body: row.body,
+        status: row.status,
+        sessionId: row.session_id,
+        sprintId: row.sprint_id,
+        missionId: row.mission_id,
+        projectId: row.project_id,
+        createdAt: row.created_at,
+        resolvedAt: row.resolved_at,
+        resolutionNote: row.resolution_note,
+    };
+}
+async function cmosFeedback(params) {
+    const action = params.action;
+    return (0, client_1.withClientValidated)((client) => {
+        (0, schema_migrations_1.ensureAgentFeedbackTable)(client);
+        if (action === 'list') {
+            const status = params.status ?? 'open';
+            const limit = params.limit ?? 50;
+            const conditions = ['status = ?'];
+            const args = [status];
+            if (params.toolName) {
+                conditions.push('tool_name = ?');
+                args.push(params.toolName);
+            }
+            const where = `WHERE ${conditions.join(' AND ')}`;
+            const rowsResult = client.getMany(`SELECT id, tool_name, body, status, session_id, sprint_id, mission_id, project_id,
+                  created_at, resolved_at, resolution_note
+           FROM agent_feedback ${where}
+           ORDER BY created_at DESC
+           LIMIT ${limit}`, args);
+            if (!rowsResult.success) {
+                return (0, errors_1.createError)(rowsResult.error ?? {
+                    code: errors_1.CMOS_ERROR_CODES.DB_QUERY_FAILED,
+                    message: 'Failed to list agent feedback',
+                });
+            }
+            const rows = rowsResult.data ?? [];
+            const entries = rows.map(rowToEntry);
+            const totalResult = client.getOne(`SELECT COUNT(*) as count FROM agent_feedback ${where}`, args);
+            const totalCount = totalResult.success && totalResult.data ? totalResult.data.count : entries.length;
+            const toolGroupsResult = client.getMany(`SELECT tool_name, COUNT(*) as c FROM agent_feedback ${where}
+           GROUP BY tool_name ORDER BY c DESC`, args);
+            const countsByTool = {};
+            if (toolGroupsResult.success && toolGroupsResult.data) {
+                for (const g of toolGroupsResult.data) {
+                    countsByTool[g.tool_name] = g.c;
+                }
+            }
+            const statusGroupsResult = client.getMany(`SELECT status, COUNT(*) as c FROM agent_feedback ${params.toolName ? 'WHERE tool_name = ?' : ''}
+           GROUP BY status`, params.toolName ? [params.toolName] : []);
+            const countsByStatus = {};
+            if (statusGroupsResult.success && statusGroupsResult.data) {
+                for (const g of statusGroupsResult.data) {
+                    countsByStatus[g.status] = g.c;
+                }
+            }
+            return (0, errors_1.createSuccess)({
+                entries,
+                countsByTool,
+                countsByStatus,
+                totalCount,
+                limit,
+            });
+        }
+        // mutation actions: triage | resolve | archive
+        if (typeof params.feedbackId !== 'number') {
+            return (0, errors_1.createError)({
+                code: errors_1.CMOS_ERROR_CODES.MISSING_PARAMETER,
+                message: `feedbackId is required for action='${action}'`,
+                suggestion: 'Pass feedbackId (integer, as returned from cmos_feedback action="list")',
+            });
+        }
+        const currentResult = client.getOne('SELECT id, status, resolved_at, resolution_note FROM agent_feedback WHERE id = ?', [params.feedbackId]);
+        if (!currentResult.success) {
+            return (0, errors_1.createError)(currentResult.error ?? {
+                code: errors_1.CMOS_ERROR_CODES.DB_QUERY_FAILED,
+                message: 'Failed to load feedback row',
+            });
+        }
+        if (!currentResult.data) {
+            return (0, errors_1.createError)({
+                code: 'FEEDBACK_NOT_FOUND',
+                message: `Feedback #${params.feedbackId} not found`,
+                suggestion: 'Use cmos_feedback(action="list") to see available entries',
+            });
+        }
+        const previousStatus = currentResult.data.status;
+        let nextStatus;
+        let resolvedAt = currentResult.data.resolved_at;
+        let resolutionNote = currentResult.data.resolution_note;
+        if (action === 'triage') {
+            nextStatus = 'triaged';
+        }
+        else if (action === 'resolve') {
+            nextStatus = 'resolved';
+            resolvedAt = new Date().toISOString();
+            resolutionNote = params.resolutionNote?.trim() || resolutionNote;
+        }
+        else {
+            nextStatus = 'archived';
+            resolvedAt = resolvedAt ?? new Date().toISOString();
+            resolutionNote = params.resolutionNote?.trim() || resolutionNote;
+        }
+        const updateResult = client.execute(`UPDATE agent_feedback
+         SET status = ?, resolved_at = ?, resolution_note = ?
+         WHERE id = ?`, [nextStatus, resolvedAt, resolutionNote, params.feedbackId]);
+        if (!updateResult.success) {
+            return (0, errors_1.createError)(updateResult.error ?? {
+                code: errors_1.CMOS_ERROR_CODES.DB_QUERY_FAILED,
+                message: 'Failed to update feedback row',
+            });
+        }
+        return (0, errors_1.createSuccess)({
+            feedbackId: params.feedbackId,
+            previousStatus,
+            currentStatus: nextStatus,
+            resolutionNote,
+            message: `Feedback #${params.feedbackId}: ${previousStatus} → ${nextStatus}`,
+        });
+    }, { projectRoot: params.projectRoot });
+}
+function formatFeedbackForLLM(action, result) {
+    if (!result.success || !result.data) {
+        const err = result.error;
+        return `❌ cmos_feedback(${action}) failed: ${err?.message ?? 'Unknown error'}${err?.suggestion ? `\n  Suggestion: ${err.suggestion}` : ''}`;
+    }
+    if (action === 'list') {
+        const d = result.data;
+        if (d.entries.length === 0) {
+            return `No agent feedback matching filter (limit ${d.limit}).`;
+        }
+        const head = `Agent feedback — ${d.entries.length} of ${d.totalCount} entries (limit ${d.limit}).`;
+        const byTool = Object.entries(d.countsByTool)
+            .map(([k, v]) => `${k}=${v}`)
+            .join(', ');
+        const byStatus = Object.entries(d.countsByStatus)
+            .map(([k, v]) => `${k}=${v}`)
+            .join(', ');
+        const meta = `By tool: ${byTool || '(none)'} | All statuses: ${byStatus || '(none)'}`;
+        const lines = d.entries.slice(0, 10).map((e) => {
+            const snippet = e.body.length > 140 ? `${e.body.slice(0, 137)}…` : e.body;
+            return `  #${e.id} [${e.status}] ${e.toolName} @ ${e.createdAt}\n    ${snippet}`;
+        });
+        const more = d.entries.length > 10 ? `\n  ... ${d.entries.length - 10} more` : '';
+        return `${head}\n${meta}\n${lines.join('\n')}${more}`;
+    }
+    const m = result.data;
+    const noteLine = m.resolutionNote ? `\n  Note: ${m.resolutionNote}` : '';
+    return `${m.message}${noteLine}`;
+}
+//# sourceMappingURL=cmos-feedback.js.map

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

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

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

@@ -0,0 +1,81 @@
+/**
+ * cmos_learnings list action
+ *
+ * Lists learnings from the CMOS database with filtering by category,
+ * sprint, status, and date range. Supports pagination.
+ *
+ * @module tools/cmos/cmos-learnings-list
+ */
+import type { CmosToolResult } from './types';
+/**
+ * Learning record surfaced to clients.
+ */
+export interface Learning {
+    /** 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;
+    /**
+     * Sprint 61 m03 — institutional-rule flag. When 1, the learning is excluded
+     * from staleness flagging and from the staleness count surfaced on agent
+     * onboard. Toggle via cmos_learnings(action="update", evergreen=true|false).
+     */
+    evergreen: boolean;
+}
+/**
+ * Result of learnings list operation.
+ */
+export interface CmosLearningsListResult {
+    /** List of learnings */
+    learnings: Learning[];
+    /** Total count (for pagination) */
+    totalCount: number;
+    /** Current page */
+    page: number;
+    /** Page size used */
+    pageSize: number;
+    /** Whether there are more results */
+    hasMore: boolean;
+}
+/**
+ * Input parameters for learnings list action.
+ */
+export interface CmosLearningsListParams {
+    /** Optional: filter by category */
+    category?: string;
+    /** Optional: filter by sprint ID */
+    sprintId?: string;
+    /** Optional: filter by status (default: all) */
+    status?: string;
+    /** Optional: filter by date range start (ISO format) */
+    since?: string;
+    /** Optional: filter by date range end (ISO format) */
+    until?: string;
+    /** Optional: page number (1-indexed, default: 1) */
+    page?: number;
+    /** Optional: results per page (1-100, default: 20) */
+    pageSize?: number;
+    /** Optional: explicit project root */
+    projectRoot?: string;
+}
+/**
+ * Execute the learnings list action.
+ */
+export declare function cmosLearningsList(params?: CmosLearningsListParams): Promise<CmosToolResult<CmosLearningsListResult>>;
+/**
+ * Format learnings list result for LLM readability.
+ */
+export declare function formatLearningsListForLLM(result: CmosToolResult<CmosLearningsListResult>): string;
+//# sourceMappingURL=cmos-learnings-list.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-learnings-list.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-learnings-list.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,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;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,wBAAwB;IACxB,SAAS,EAAE,QAAQ,EAAE,CAAC;IAEtB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IAEnB,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb,qBAAqB;IACrB,QAAQ,EAAE,MAAM,CAAC;IAEjB,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,GAAE,uBAA4B,GACnC,OAAO,CAAC,cAAc,CAAC,uBAAuB,CAAC,CAAC,CA6FlD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,cAAc,CAAC,uBAAuB,CAAC,GAAG,MAAM,CA4CjG"}

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

@@ -0,0 +1,120 @@
+"use strict";
+/**
+ * cmos_learnings list action
+ *
+ * Lists learnings from the CMOS database with filtering by category,
+ * sprint, status, and date range. Supports pagination.
+ *
+ * @module tools/cmos/cmos-learnings-list
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosLearningsList = cmosLearningsList;
+exports.formatLearningsListForLLM = formatLearningsListForLLM;
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const schema_migrations_1 = require("./schema-migrations");
+/**
+ * Execute the learnings list action.
+ */
+async function cmosLearningsList(params = {}) {
+    const page = params.page ?? 1;
+    const pageSize = params.pageSize ?? 20;
+    const offset = (page - 1) * pageSize;
+    return (0, client_1.withClient)((client) => {
+        // Sprint 61 m03: lazy-migrate the evergreen column on read paths so
+        // un-migrated DBs don't hit `no such column: evergreen`.
+        (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);
+        }
+        if (params.status) {
+            conditions.push('status = ?');
+            queryParams.push(params.status);
+        }
+        if (params.since) {
+            conditions.push('created_at >= ?');
+            queryParams.push(params.since);
+        }
+        if (params.until) {
+            conditions.push('created_at <= ?');
+            queryParams.push(params.until);
+        }
+        const whereClause = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        // Get total count
+        const countResult = client.getOne(`SELECT COUNT(*) as count FROM learnings ${whereClause}`, queryParams);
+        const totalCount = countResult.success && countResult.data ? countResult.data.count : 0;
+        // Get paginated results
+        const listResult = client.getMany(`SELECT id, content, category, status, sprint_id, session_id, mission_id, created_at, evergreen
+         FROM learnings ${whereClause}
+         ORDER BY created_at DESC, id DESC
+         LIMIT ? OFFSET ?`, [...queryParams, pageSize, offset]);
+        const learnings = listResult.success && listResult.data
+            ? listResult.data.map((row) => ({
+                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,
+                evergreen: row.evergreen === 1,
+            }))
+            : [];
+        return (0, errors_1.createSuccess)({
+            learnings,
+            totalCount,
+            page,
+            pageSize,
+            hasMore: offset + learnings.length < totalCount,
+        });
+    }, { projectRoot: params.projectRoot });
+}
+/**
+ * Format learnings list result for LLM readability.
+ */
+function formatLearningsListForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        return [
+            '❌ Failed to retrieve learnings',
+            '',
+            `Error: ${error?.message ?? 'Unknown error'}`,
+            error?.suggestion ? `Suggestion: ${error.suggestion}` : '',
+        ]
+            .filter(Boolean)
+            .join('\n');
+    }
+    const data = result.data;
+    const lines = [];
+    lines.push('📚 **Learnings**');
+    lines.push('');
+    lines.push(`Showing ${data.learnings.length} of ${data.totalCount} learnings (page ${data.page})`);
+    lines.push('');
+    if (data.learnings.length === 0) {
+        lines.push('No learnings found matching the criteria.');
+        return lines.join('\n');
+    }
+    for (const l of data.learnings) {
+        const category = l.category ? ` <${l.category}>` : '';
+        const sprint = l.sprintId ? ` (${l.sprintId})` : '';
+        const mission = l.missionId ? ` {${l.missionId}}` : '';
+        const status = l.status !== 'active' ? ` [${l.status}]` : '';
+        const evergreen = l.evergreen ? ' [evergreen]' : '';
+        lines.push(`• #${l.id} ${l.content}${category}${sprint}${mission}${status}${evergreen}`);
+        lines.push(`  Created: ${l.createdAt}`);
+        lines.push('');
+    }
+    if (data.hasMore) {
+        lines.push(`More results available. Use page=${data.page + 1} to see next page.`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=cmos-learnings-list.js.map

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

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

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

@@ -0,0 +1,27 @@
+import type { CmosToolResult } from './types';
+export interface CmosLearningsReaffirmResult {
+    /** ID of the reaffirmed learning */
+    learningId: number;
+    /** Status after reaffirm (unchanged from before) */
+    status: string;
+    /** ISO timestamp the review was recorded at */
+    reaffirmedAt: string;
+    /** Confirmation message */
+    message: string;
+}
+export interface CmosLearningsReaffirmParams {
+    /** Learning ID to reaffirm */
+    learningId: number;
+    /** Optional: explicit project root */
+    projectRoot?: string;
+}
+/**
+ * Bump last_reviewed_at on an existing learning without changing its status.
+ *
+ * Use this when triaging evergreen learnings — staleness detection respects the review
+ * timestamp (COALESCE(last_reviewed_at, created_at)) so a reaffirmed learning won't get
+ * re-flagged next sprint.
+ */
+export declare function cmosLearningsReaffirm(params: CmosLearningsReaffirmParams): Promise<CmosToolResult<CmosLearningsReaffirmResult>>;
+export declare function formatLearningsReaffirmForLLM(result: CmosToolResult<CmosLearningsReaffirmResult>): string;
+//# sourceMappingURL=cmos-learnings-reaffirm.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-learnings-reaffirm.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-learnings-reaffirm.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C,MAAM,WAAW,2BAA2B;IAC1C,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,2BAA2B;IAC1C,8BAA8B;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,2BAA2B,GAClC,OAAO,CAAC,cAAc,CAAC,2BAA2B,CAAC,CAAC,CA4CtD;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,cAAc,CAAC,2BAA2B,CAAC,GAClD,MAAM,CAqBR"}

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

@@ -0,0 +1,69 @@
+"use strict";
+// ABOUTME: cmos_learnings(action="reaffirm") — mark an evergreen learning as still valid
+// by bumping last_reviewed_at without changing status. Stops staleness re-firing on triaged
+// learnings each sprint (Sprint 52 m03).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosLearningsReaffirm = cmosLearningsReaffirm;
+exports.formatLearningsReaffirmForLLM = formatLearningsReaffirmForLLM;
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const schema_migrations_1 = require("./schema-migrations");
+/**
+ * Bump last_reviewed_at on an existing learning without changing its status.
+ *
+ * Use this when triaging evergreen learnings — staleness detection respects the review
+ * timestamp (COALESCE(last_reviewed_at, created_at)) so a reaffirmed learning won't get
+ * re-flagged next sprint.
+ */
+async function cmosLearningsReaffirm(params) {
+    if (!params.learningId || typeof params.learningId !== 'number') {
+        return (0, errors_1.createError)(errors_1.CmosErrors.missingParameter('learningId'));
+    }
+    return (0, client_1.withClientValidated)((client) => {
+        (0, schema_migrations_1.ensureReviewTimestamps)(client);
+        const existing = client.getOne('SELECT id, status 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 nowIso = new Date().toISOString();
+        const updateResult = client.execute('UPDATE learnings SET last_reviewed_at = ? WHERE id = ?', [nowIso, params.learningId]);
+        if (!updateResult.success) {
+            return (0, errors_1.createError)({
+                code: errors_1.CMOS_ERROR_CODES.DB_QUERY_FAILED,
+                message: `Failed to reaffirm learning: ${updateResult.error?.message ?? 'Unknown error'}`,
+            });
+        }
+        return (0, errors_1.createSuccess)({
+            learningId: params.learningId,
+            status: existing.data.status,
+            reaffirmedAt: nowIso,
+            message: `Learning #${params.learningId} reaffirmed — last_reviewed_at bumped`,
+        });
+    }, { projectRoot: params.projectRoot });
+}
+function formatLearningsReaffirmForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        return [
+            '❌ Failed to reaffirm learning',
+            '',
+            `Error: ${error?.message ?? 'Unknown error'}`,
+            error?.suggestion ? `Suggestion: ${error.suggestion}` : '',
+        ]
+            .filter(Boolean)
+            .join('\n');
+    }
+    const d = result.data;
+    return [
+        '✓ **Learning Reaffirmed**',
+        '',
+        `**Learning**: #${d.learningId}`,
+        `**Status**: ${d.status} (unchanged)`,
+        `**Reaffirmed at**: ${d.reaffirmedAt}`,
+    ].join('\n');
+}
+//# sourceMappingURL=cmos-learnings-reaffirm.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-learnings-reaffirm.js","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-learnings-reaffirm.ts"],"names":[],"mappings":";AAAA,yFAAyF;AACzF,4FAA4F;AAC5F,yCAAyC;;AAgCzC,sDA8CC;AAED,sEAuBC;AArGD,qCAA+C;AAE/C,qCAAoF;AACpF,2DAA6D;AAoB7D;;;;;;GAMG;AACI,KAAK,UAAU,qBAAqB,CACzC,MAAmC;IAEnC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QAChE,OAAO,IAAA,oBAAW,EAAC,mBAAU,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,IAAA,4BAAmB,EACxB,CAAC,MAAM,EAAE,EAAE;QACT,IAAA,0CAAsB,EAAC,MAAM,CAAC,CAAC;QAE/B,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAC5B,+CAA+C,EAC/C,CAAC,MAAM,CAAC,UAAU,CAAC,CACpB,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,OAAO,IAAA,oBAAW,EAA8B;gBAC9C,IAAI,EAAE,yBAAgB,CAAC,iBAAiB;gBACxC,OAAO,EAAE,aAAa,MAAM,CAAC,UAAU,YAAY;gBACnD,UAAU,EAAE,oDAAoD;aACjE,CAAC,CAAC;QACL,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CACjC,wDAAwD,EACxD,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAC5B,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,IAAA,oBAAW,EAA8B;gBAC9C,IAAI,EAAE,yBAAgB,CAAC,eAAe;gBACtC,OAAO,EAAE,gCAAgC,YAAY,CAAC,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE;aAC1F,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAA,sBAAa,EAA8B;YAChD,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,MAAM;YAC5B,YAAY,EAAE,MAAM;YACpB,OAAO,EAAE,aAAa,MAAM,CAAC,UAAU,uCAAuC;SAC/E,CAAC,CAAC;IACL,CAAC,EACD,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,CACpC,CAAC;AACJ,CAAC;AAED,SAAgB,6BAA6B,CAC3C,MAAmD;IAEnD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC3B,OAAO;YACL,+BAA+B;YAC/B,EAAE;YACF,UAAU,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE;YAC7C,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,eAAe,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE;SAC3D;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;IACtB,OAAO;QACL,2BAA2B;QAC3B,EAAE;QACF,kBAAkB,CAAC,CAAC,UAAU,EAAE;QAChC,eAAe,CAAC,CAAC,MAAM,cAAc;QACrC,sBAAsB,CAAC,CAAC,YAAY,EAAE;KACvC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}