@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * 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
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosLearningsToolDefinition = exports.cmosLearningsSchema = exports.CMOS_LEARNINGS_ACTIONS = void 0;
+exports.cmosLearnings = cmosLearnings;
+exports.formatLearningsForLLM = formatLearningsForLLM;
+const zod_1 = require("zod");
+const errors_1 = require("./errors");
+const cmos_learnings_list_1 = require("./cmos-learnings-list");
+const cmos_learnings_search_1 = require("./cmos-learnings-search");
+const cmos_learnings_update_1 = require("./cmos-learnings-update");
+const cmos_learnings_reaffirm_1 = require("./cmos-learnings-reaffirm");
+exports.CMOS_LEARNINGS_ACTIONS = ['list', 'search', 'update', 'reaffirm'];
+exports.cmosLearningsSchema = zod_1.z
+    .object({
+    action: zod_1.z
+        .enum(exports.CMOS_LEARNINGS_ACTIONS)
+        .describe('Learnings action: list | search | update | reaffirm'),
+    // list params
+    category: zod_1.z
+        .string()
+        .optional()
+        .describe('Filter by category for list/search actions (technical | process | agent-behavior | tooling)'),
+    sprintId: zod_1.z.string().optional().describe('Filter by sprint ID for list/search actions'),
+    status: zod_1.z
+        .string()
+        .optional()
+        .describe('Filter by status for list action, or new status for update action (active | archived | superseded)'),
+    since: zod_1.z.string().optional().describe('ISO date lower bound for list action'),
+    until: zod_1.z.string().optional().describe('ISO date upper bound for list action'),
+    page: zod_1.z.number().int().positive().optional().describe('Page number for list action'),
+    pageSize: zod_1.z.number().int().positive().max(100).optional().describe('Page size for list action'),
+    // search params
+    query: zod_1.z.string().optional().describe('Search query for search action (required for search)'),
+    limit: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .max(50)
+        .optional()
+        .describe('Maximum results for search action'),
+    // update params
+    learningId: zod_1.z.number().int().positive().optional().describe('Learning ID for update action'),
+    evergreen: zod_1.z
+        .boolean()
+        .optional()
+        .describe('Sprint 61 m03 — toggle institutional-rule flag. true = exclude from staleness signal; false = clear flag.'),
+    projectRoot: zod_1.z
+        .string()
+        .optional()
+        .describe('Project root directory to search for CMOS database (defaults to cwd)'),
+})
+    .strict();
+exports.cmosLearningsToolDefinition = {
+    name: 'cmos_learnings',
+    description: 'Consolidated learnings tool with action parameter support. ' +
+        'Actions: list, search, update. ' +
+        'Use list to browse learnings with category/sprint/status filters. ' +
+        'Use search to find learnings by keyword. ' +
+        'Use update to change status (active, archived, superseded). ' +
+        'Use reaffirm to mark an evergreen learning as still valid (bumps last_reviewed_at without changing status).',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: [...exports.CMOS_LEARNINGS_ACTIONS],
+                description: 'Learnings action: list | search | update | reaffirm',
+            },
+            category: {
+                type: 'string',
+                enum: ['technical', 'process', 'agent-behavior', 'tooling'],
+                description: 'Filter by category',
+            },
+            sprintId: { type: 'string', description: 'Filter by sprint ID' },
+            status: {
+                type: 'string',
+                enum: ['active', 'archived', 'superseded'],
+                description: 'Filter by status (list) or new status (update)',
+            },
+            since: { type: 'string', description: 'ISO date lower bound for list action' },
+            until: { type: 'string', description: 'ISO date upper bound for list action' },
+            page: { type: 'number', minimum: 1, description: 'Page number for list action' },
+            pageSize: {
+                type: 'number',
+                minimum: 1,
+                maximum: 100,
+                description: 'Page size for list action',
+            },
+            query: { type: 'string', description: 'Search query for search action' },
+            limit: {
+                type: 'number',
+                minimum: 1,
+                maximum: 50,
+                description: 'Maximum results for search action',
+            },
+            learningId: {
+                type: 'number',
+                minimum: 1,
+                description: 'Learning ID for update action',
+            },
+            evergreen: {
+                type: 'boolean',
+                description: 'Toggle institutional-rule flag for the learning. true = exclude from staleness signal; false = clear flag (Sprint 61 m03).',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['action'],
+        additionalProperties: false,
+    },
+};
+function isLearningsAction(value) {
+    return exports.CMOS_LEARNINGS_ACTIONS.includes(value);
+}
+async function cmosLearnings(params) {
+    const actionValue = typeof params.action === 'string' ? params.action : '';
+    if (!isLearningsAction(actionValue)) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.invalidAction('cmos_learnings', actionValue, exports.CMOS_LEARNINGS_ACTIONS));
+    }
+    switch (actionValue) {
+        case 'list':
+            return (0, cmos_learnings_list_1.cmosLearningsList)({
+                category: params.category,
+                sprintId: params.sprintId,
+                status: params.status,
+                since: params.since,
+                until: params.until,
+                page: params.page,
+                pageSize: params.pageSize,
+                projectRoot: params.projectRoot,
+            });
+        case 'search':
+            return (0, cmos_learnings_search_1.cmosLearningsSearch)({
+                query: params.query ?? '',
+                category: params.category,
+                sprintId: params.sprintId,
+                limit: params.limit,
+                projectRoot: params.projectRoot,
+            });
+        case 'update':
+            return (0, cmos_learnings_update_1.cmosLearningsUpdate)({
+                learningId: params.learningId ?? 0,
+                status: params.status,
+                evergreen: params.evergreen,
+                projectRoot: params.projectRoot,
+            });
+        case 'reaffirm':
+            return (0, cmos_learnings_reaffirm_1.cmosLearningsReaffirm)({
+                learningId: params.learningId ?? 0,
+                projectRoot: params.projectRoot,
+            });
+    }
+}
+function formatLearningsForLLM(action, result) {
+    if (!result.success && result.error?.code === 'INVALID_ACTION') {
+        const availableActions = result.error.availableActions ??
+            result.error.available_actions ??
+            result.error.validValues ??
+            [];
+        const lines = ['❌ Failed to execute cmos_learnings', '', `Error: ${result.error.message}`];
+        if (availableActions.length > 0) {
+            lines.push('');
+            lines.push(`Available actions: ${availableActions.join(', ')}`);
+        }
+        if (result.error.suggestion) {
+            lines.push('');
+            lines.push(`Suggestion: ${result.error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    switch (action) {
+        case 'list':
+            return (0, cmos_learnings_list_1.formatLearningsListForLLM)(result);
+        case 'search':
+            return (0, cmos_learnings_search_1.formatLearningsSearchForLLM)(result);
+        case 'update':
+            return (0, cmos_learnings_update_1.formatLearningsUpdateForLLM)(result);
+        case 'reaffirm':
+            return (0, cmos_learnings_reaffirm_1.formatLearningsReaffirmForLLM)(result);
+        default:
+            return result.success
+                ? '✓ Learnings action completed'
+                : '❌ Failed to execute cmos_learnings';
+    }
+}
+//# sourceMappingURL=cmos-learnings.js.map

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

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

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

@@ -0,0 +1,257 @@
+/**
+ * cmos_message Tool
+ *
+ * Consolidated messaging tool with action parameter support.
+ * Actions: send, list, respond.
+ * Calls the cmos-dashboard REST API via DashboardClient.
+ *
+ * @module tools/cmos/cmos-message
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+import { type AuthState } from '../../auth/auth-state';
+import { type DashboardMessage, type DirectoryProject } from './dashboard-client';
+import { type ResolutionCandidate, type SenderResolutionSource } from '../../intelligence/sender-context';
+export declare const CMOS_MESSAGE_ACTIONS: readonly ["send", "list", "respond", "directory", "whoami"];
+export type CmosMessageAction = (typeof CMOS_MESSAGE_ACTIONS)[number];
+export declare const VALID_MESSAGE_TYPES: readonly ["backlog_request", "question", "status_update", "info_push", "intel_request", "intel_alert"];
+export type MessageType = (typeof VALID_MESSAGE_TYPES)[number];
+export declare const VALID_MESSAGE_STATUSES: readonly ["pending", "accepted", "declined", "replied"];
+export type MessageStatus = (typeof VALID_MESSAGE_STATUSES)[number];
+export declare const VALID_RESPOND_STATUSES: readonly ["accepted", "declined", "replied"];
+export type RespondStatus = (typeof VALID_RESPOND_STATUSES)[number];
+export declare const VALID_MESSAGE_TABS: readonly ["inbox", "sent"];
+export type MessageTab = (typeof VALID_MESSAGE_TABS)[number];
+/**
+ * Message type to ActivityPub verb/object mapping.
+ */
+export declare const MESSAGE_TYPE_MAP: Record<MessageType, {
+    verb: string;
+    object: string;
+}>;
+export interface MessageSendResult {
+    messageId: string;
+    targetAddress: string;
+    status: string;
+    summary: string;
+    verb: string;
+    object: string;
+    /** Canonical cmos:// address of the sender, included when project_identity has a non-unknown address. */
+    senderAddress?: string;
+    /** Dashboard-reported delivery/routing status (e.g. "queued", "delivered"). Absent when the dashboard has not yet exposed an ACK surface. */
+    deliveryStatus?: string;
+}
+export interface MessageListResult {
+    messages: DashboardMessage[];
+    unreadCount: number;
+    totalCount: number;
+    tab: string;
+    statusFilter: string | null;
+}
+export interface MessageRespondResult {
+    messageId: string;
+    previousStatus: string;
+    currentStatus: string;
+    respondedAt: string;
+}
+export interface MessageDirectoryResult {
+    projects: DirectoryProject[];
+    totalCount: number;
+}
+export interface MessageWhoamiResult {
+    resolved: {
+        projectRoot: string | null;
+        source: SenderResolutionSource | null;
+        dashboardProjectId: string | null;
+        cmosAddress: string | null;
+        healed?: {
+            previous: string;
+            next: string;
+        };
+    };
+    candidates: ResolutionCandidate[];
+    serverInstall: {
+        root: string;
+        wouldHaveBeenUsed: boolean;
+        envCmosProjectRoot: string | null;
+    };
+    wouldAttributeAs: {
+        senderProjectId: string | null;
+        senderAddress: string | null;
+    };
+    /**
+     * Sprint 57 m04 — diagnostic auth state from the local credential store
+     * + the most recent dashboard deliveryAck. Always present so agents can
+     * self-diagnose without calling cmos_auth(action=list).
+     */
+    authState?: AuthState;
+}
+export type CmosMessageResult = MessageSendResult | MessageListResult | MessageRespondResult | MessageDirectoryResult | MessageWhoamiResult;
+export declare const cmosMessageSchema: z.ZodObject<{
+    action: z.ZodEnum<["send", "list", "respond", "directory", "whoami"]>;
+    targetAddress: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<["backlog_request", "question", "status_update", "info_push", "intel_request", "intel_alert"]>>;
+    summary: z.ZodOptional<z.ZodString>;
+    body: z.ZodOptional<z.ZodString>;
+    senderProjectId: z.ZodOptional<z.ZodString>;
+    evidence: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodString;
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        id: string;
+    }, {
+        type: string;
+        id: string;
+    }>, "many">>;
+    tab: z.ZodOptional<z.ZodEnum<["inbox", "sent"]>>;
+    status: z.ZodOptional<z.ZodEnum<["pending", "accepted", "declined", "replied"]>>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    messageId: z.ZodOptional<z.ZodString>;
+    respondStatus: z.ZodOptional<z.ZodEnum<["accepted", "declined", "replied"]>>;
+    notes: z.ZodOptional<z.ZodString>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    action: "list" | "directory" | "send" | "respond" | "whoami";
+    projectRoot?: string | undefined;
+    status?: "pending" | "accepted" | "declined" | "replied" | undefined;
+    evidence?: {
+        type: string;
+        id: string;
+    }[] | undefined;
+    type?: "backlog_request" | "question" | "status_update" | "info_push" | "intel_request" | "intel_alert" | undefined;
+    limit?: number | undefined;
+    notes?: string | undefined;
+    summary?: string | undefined;
+    targetAddress?: string | undefined;
+    body?: string | undefined;
+    senderProjectId?: string | undefined;
+    tab?: "inbox" | "sent" | undefined;
+    messageId?: string | undefined;
+    respondStatus?: "accepted" | "declined" | "replied" | undefined;
+}, {
+    action: "list" | "directory" | "send" | "respond" | "whoami";
+    projectRoot?: string | undefined;
+    status?: "pending" | "accepted" | "declined" | "replied" | undefined;
+    evidence?: {
+        type: string;
+        id: string;
+    }[] | undefined;
+    type?: "backlog_request" | "question" | "status_update" | "info_push" | "intel_request" | "intel_alert" | undefined;
+    limit?: number | undefined;
+    notes?: string | undefined;
+    summary?: string | undefined;
+    targetAddress?: string | undefined;
+    body?: string | undefined;
+    senderProjectId?: string | undefined;
+    tab?: "inbox" | "sent" | undefined;
+    messageId?: string | undefined;
+    respondStatus?: "accepted" | "declined" | "replied" | undefined;
+}>;
+export type CmosMessageParams = z.infer<typeof cmosMessageSchema>;
+interface InternalCmosMessageParams extends CmosMessageParams {
+    advertisedRoots?: readonly string[];
+}
+export declare const cmosMessageToolDefinition: {
+    readonly name: "cmos_message";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["send", "list", "respond", "directory", "whoami"];
+                readonly description: "Message action: send | list | respond | directory | whoami";
+            };
+            readonly targetAddress: {
+                readonly type: "string";
+                readonly description: "cmos:// address of the recipient. Format: cmos://username/project-name[/mission-id]";
+            };
+            readonly type: {
+                readonly type: "string";
+                readonly enum: readonly ["backlog_request", "question", "status_update", "info_push", "intel_request", "intel_alert"];
+                readonly description: "Message type: backlog_request | question | status_update | info_push | intel_request | intel_alert";
+            };
+            readonly summary: {
+                readonly type: "string";
+                readonly description: "Short description displayed in inbox list";
+            };
+            readonly body: {
+                readonly type: "string";
+                readonly description: "Full message content";
+            };
+            readonly senderProjectId: {
+                readonly type: "string";
+                readonly description: "Sender's project UUID. Resolved from local metadata.dashboard_project_id when omitted; falls back to matching local cmos_address against /api/projects/me. Agents typically do not need to pass this.";
+            };
+            readonly evidence: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "object";
+                    readonly properties: {
+                        readonly type: {
+                            readonly type: "string";
+                            readonly description: "Evidence type";
+                        };
+                        readonly id: {
+                            readonly type: "string";
+                            readonly description: "Evidence identifier";
+                        };
+                    };
+                    readonly required: readonly ["type", "id"];
+                };
+                readonly description: "TraceLab evidence references [{type, id}]";
+            };
+            readonly tab: {
+                readonly type: "string";
+                readonly enum: readonly ["inbox", "sent"];
+                readonly description: "inbox (default) or sent";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly enum: readonly ["pending", "accepted", "declined", "replied"];
+                readonly description: "Filter by message status for list action";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly description: "Max messages to return (default 20)";
+            };
+            readonly messageId: {
+                readonly type: "string";
+                readonly description: "UUID of the message to respond to";
+            };
+            readonly respondStatus: {
+                readonly type: "string";
+                readonly enum: readonly ["accepted", "declined", "replied"];
+                readonly description: "Response status: accepted | declined | replied";
+            };
+            readonly notes: {
+                readonly type: "string";
+                readonly description: "Response notes";
+            };
+            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 interface MessageWhoamiOptions {
+    explicitProjectRoot?: string;
+    mcpRoots?: readonly string[];
+    cwdOverride?: string;
+    serverInstallRootOverride?: string;
+}
+export declare function getWhoamiDiagnostics(options?: MessageWhoamiOptions): Promise<CmosToolResult<MessageWhoamiResult>>;
+/**
+ * Consolidated cmos_message tool.
+ * Creates a DashboardClient from env and dispatches to action handlers.
+ */
+export declare function cmosMessage(params: InternalCmosMessageParams): Promise<CmosToolResult<CmosMessageResult>>;
+export declare function formatMessageForLLM(action: string | undefined, result: CmosToolResult<CmosMessageResult>): string;
+export {};
+//# sourceMappingURL=cmos-message.d.ts.map

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

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