@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,219 @@
+/**
+ * cmos_sprint Tool
+ *
+ * Proof-of-concept consolidated tool for the action-parameterized pattern.
+ * This routes actions to the existing sprint handlers without rewriting the
+ * underlying sprint business logic.
+ *
+ * @module tools/cmos/cmos-sprint
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+import { type SprintAddResult } from './cmos-sprint-add';
+import { type CmosSprintCompleteResult } from './cmos-sprint-complete';
+import { type CmosSprintListResult } from './cmos-sprint-list';
+import { type SprintShowResult } from './cmos-sprint-show';
+import { type SprintUpdateResult } from './cmos-sprint-update';
+import { type SprintRetroResult } from './cmos-sprint-retro';
+import { type SprintCarryForwardResult } from './cmos-sprint-carry-forward';
+import { type SprintAnalyticsResult } from './cmos-sprint-analytics';
+export declare const CMOS_SPRINT_ACTIONS: readonly ["list", "show", "add", "update", "complete", "retro", "carry_forward", "analytics"];
+export type CmosSprintAction = (typeof CMOS_SPRINT_ACTIONS)[number];
+export type CmosSprintResult = CmosSprintListResult | SprintShowResult | SprintAddResult | SprintUpdateResult | CmosSprintCompleteResult | SprintRetroResult | SprintCarryForwardResult | SprintAnalyticsResult;
+/**
+ * Consolidated schema for all sprint actions.
+ * Individual handlers still validate action-specific requirements.
+ */
+export declare const cmosSprintSchema: z.ZodObject<{
+    action: z.ZodEnum<["list", "show", "add", "update", "complete", "retro", "carry_forward", "analytics"]>;
+    sprintId: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    focus: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    fields: z.ZodOptional<z.ZodObject<{
+        title: z.ZodOptional<z.ZodString>;
+        focus: z.ZodOptional<z.ZodString>;
+        status: z.ZodOptional<z.ZodString>;
+        startDate: z.ZodOptional<z.ZodString>;
+        endDate: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        status?: string | undefined;
+        focus?: string | undefined;
+        title?: string | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+    }, {
+        status?: string | undefined;
+        focus?: string | undefined;
+        title?: string | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+    }>>;
+    summary: z.ZodOptional<z.ZodString>;
+    condensation: z.ZodOptional<z.ZodEnum<["none", "conservative", "auto", "aggressive"]>>;
+    targetSizePercent: z.ZodOptional<z.ZodNumber>;
+    targetAddress: z.ZodOptional<z.ZodString>;
+    send: z.ZodOptional<z.ZodBoolean>;
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    action: "show" | "list" | "complete" | "add" | "update" | "retro" | "carry_forward" | "analytics";
+    projectRoot?: string | undefined;
+    status?: string | undefined;
+    sprintId?: string | undefined;
+    limit?: number | undefined;
+    focus?: string | undefined;
+    title?: string | undefined;
+    fields?: {
+        status?: string | undefined;
+        focus?: string | undefined;
+        title?: string | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+    } | undefined;
+    targetSizePercent?: number | undefined;
+    summary?: string | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    condensation?: "conservative" | "auto" | "aggressive" | "none" | undefined;
+    targetAddress?: string | undefined;
+    send?: boolean | undefined;
+}, {
+    action: "show" | "list" | "complete" | "add" | "update" | "retro" | "carry_forward" | "analytics";
+    projectRoot?: string | undefined;
+    status?: string | undefined;
+    sprintId?: string | undefined;
+    limit?: number | undefined;
+    focus?: string | undefined;
+    title?: string | undefined;
+    fields?: {
+        status?: string | undefined;
+        focus?: string | undefined;
+        title?: string | undefined;
+        startDate?: string | undefined;
+        endDate?: string | undefined;
+    } | undefined;
+    targetSizePercent?: number | undefined;
+    summary?: string | undefined;
+    startDate?: string | undefined;
+    endDate?: string | undefined;
+    condensation?: "conservative" | "auto" | "aggressive" | "none" | undefined;
+    targetAddress?: string | undefined;
+    send?: boolean | undefined;
+}>;
+export type CmosSprintParams = z.infer<typeof cmosSprintSchema>;
+/**
+ * MCP Tool Definition for cmos_sprint.
+ */
+export declare const cmosSprintToolDefinition: {
+    readonly name: "cmos_sprint";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly action: {
+                readonly type: "string";
+                readonly enum: readonly ["list", "show", "add", "update", "complete", "retro", "carry_forward", "analytics"];
+                readonly description: "Sprint action: list | show | add | update | complete";
+            };
+            readonly sprintId: {
+                readonly type: "string";
+                readonly description: "Sprint ID for show/add/update/complete actions";
+            };
+            readonly title: {
+                readonly type: "string";
+                readonly description: "Sprint title for add action";
+            };
+            readonly focus: {
+                readonly type: "string";
+                readonly description: "Strategic focus or theme for add action";
+            };
+            readonly status: {
+                readonly type: "string";
+                readonly description: "Filter or sprint status depending on action";
+            };
+            readonly startDate: {
+                readonly type: "string";
+                readonly description: "Sprint start date for add action";
+            };
+            readonly endDate: {
+                readonly type: "string";
+                readonly description: "Sprint end date for add action";
+            };
+            readonly limit: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly description: "Maximum sprints to return for list action";
+            };
+            readonly fields: {
+                readonly type: "object";
+                readonly description: "Fields payload for update action";
+                readonly properties: {
+                    readonly title: {
+                        readonly type: "string";
+                        readonly description: "Sprint title";
+                    };
+                    readonly focus: {
+                        readonly type: "string";
+                        readonly description: "Strategic focus or theme of the sprint";
+                    };
+                    readonly status: {
+                        readonly type: "string";
+                        readonly description: "Sprint status (e.g., \"Active\", \"Completed\")";
+                    };
+                    readonly startDate: {
+                        readonly type: "string";
+                        readonly description: "Start date in ISO format (e.g., \"2025-01-01\")";
+                    };
+                    readonly endDate: {
+                        readonly type: "string";
+                        readonly description: "End date in ISO format (e.g., \"2025-01-15\")";
+                    };
+                };
+                readonly additionalProperties: false;
+            };
+            readonly summary: {
+                readonly type: "string";
+                readonly description: "Closeout summary for complete action";
+            };
+            readonly condensation: {
+                readonly type: "string";
+                readonly enum: readonly ["none", "conservative", "auto", "aggressive"];
+                readonly description: "Optional condensation strategy for complete action";
+            };
+            readonly targetSizePercent: {
+                readonly type: "number";
+                readonly minimum: 1;
+                readonly maximum: 100;
+                readonly description: "Target size percent for complete action condensation";
+            };
+            readonly targetAddress: {
+                readonly type: "string";
+                readonly description: "cmos:// address for carry_forward action (e.g., cmos://derek/cmos-dashboard)";
+            };
+            readonly send: {
+                readonly type: "boolean";
+                readonly description: "Whether to actually send messages for carry_forward (default true, false = dry run)";
+            };
+            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;
+    };
+};
+/**
+ * Route a consolidated sprint request to the existing action-specific handler.
+ */
+export declare function cmosSprint(params: CmosSprintParams): Promise<CmosToolResult<CmosSprintResult>>;
+/**
+ * Format consolidated sprint responses by delegating to the existing formatter
+ * for the selected action. This keeps the POC close to the current output style.
+ */
+export declare function formatSprintForLLM(action: string | undefined, result: CmosToolResult<CmosSprintResult>): string;
+//# sourceMappingURL=cmos-sprint.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-sprint.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-sprint.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,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAIL,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAIL,KAAK,wBAAwB,EAC9B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,yBAAyB,CAAC;AAEjC,eAAO,MAAM,mBAAmB,+FAStB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,MAAM,MAAM,gBAAgB,GACxB,oBAAoB,GACpB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,wBAAwB,GACxB,iBAAiB,GACjB,wBAAwB,GACxB,qBAAqB,CAAC;AAY1B;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6ClB,CAAC;AAEZ,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgG3B,CAAC;AAMX;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAqE3C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,MAAM,EAAE,cAAc,CAAC,gBAAgB,CAAC,GACvC,MAAM,CA2CR"}

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

@@ -0,0 +1,304 @@
+"use strict";
+/**
+ * cmos_sprint Tool
+ *
+ * Proof-of-concept consolidated tool for the action-parameterized pattern.
+ * This routes actions to the existing sprint handlers without rewriting the
+ * underlying sprint business logic.
+ *
+ * @module tools/cmos/cmos-sprint
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosSprintToolDefinition = exports.cmosSprintSchema = exports.CMOS_SPRINT_ACTIONS = void 0;
+exports.cmosSprint = cmosSprint;
+exports.formatSprintForLLM = formatSprintForLLM;
+const zod_1 = require("zod");
+const errors_1 = require("./errors");
+const cmos_sprint_add_1 = require("./cmos-sprint-add");
+const cmos_sprint_complete_1 = require("./cmos-sprint-complete");
+const checkpoint_backfill_1 = require("./checkpoint-backfill");
+const cmos_sprint_list_1 = require("./cmos-sprint-list");
+const cmos_sprint_show_1 = require("./cmos-sprint-show");
+const cmos_sprint_update_1 = require("./cmos-sprint-update");
+const cmos_sprint_retro_1 = require("./cmos-sprint-retro");
+const cmos_sprint_carry_forward_1 = require("./cmos-sprint-carry-forward");
+const cmos_sprint_analytics_1 = require("./cmos-sprint-analytics");
+exports.CMOS_SPRINT_ACTIONS = [
+    'list',
+    'show',
+    'add',
+    'update',
+    'complete',
+    'retro',
+    'carry_forward',
+    'analytics',
+];
+const cmosSprintFieldsSchema = zod_1.z
+    .object({
+    title: zod_1.z.string().optional().describe('Sprint title'),
+    focus: zod_1.z.string().optional().describe('Strategic focus or theme of the sprint'),
+    status: zod_1.z.string().optional().describe('Sprint status (e.g., "Active", "Completed")'),
+    startDate: zod_1.z.string().optional().describe('Start date in ISO format (e.g., "2025-01-01")'),
+    endDate: zod_1.z.string().optional().describe('End date in ISO format (e.g., "2025-01-15")'),
+})
+    .strict();
+/**
+ * Consolidated schema for all sprint actions.
+ * Individual handlers still validate action-specific requirements.
+ */
+exports.cmosSprintSchema = zod_1.z
+    .object({
+    action: zod_1.z
+        .enum(exports.CMOS_SPRINT_ACTIONS)
+        .describe('Sprint action: list | show | add | update | complete'),
+    sprintId: zod_1.z.string().optional().describe('Sprint ID for show/add/update/complete actions'),
+    title: zod_1.z.string().optional().describe('Sprint title for add action'),
+    focus: zod_1.z.string().optional().describe('Strategic focus or theme for add action'),
+    status: zod_1.z.string().optional().describe('Filter or sprint status depending on action'),
+    startDate: zod_1.z.string().optional().describe('Sprint start date for add action'),
+    endDate: zod_1.z.string().optional().describe('Sprint end date for add action'),
+    limit: zod_1.z
+        .number()
+        .int()
+        .positive()
+        .max(100)
+        .optional()
+        .describe('Maximum sprints to return for list action'),
+    fields: cmosSprintFieldsSchema.optional().describe('Fields payload for update action'),
+    summary: zod_1.z.string().optional().describe('Closeout summary for complete action'),
+    condensation: zod_1.z
+        .enum(['none', 'conservative', 'auto', 'aggressive'])
+        .optional()
+        .describe('Optional condensation strategy for complete action'),
+    targetSizePercent: zod_1.z
+        .number()
+        .min(1)
+        .max(100)
+        .optional()
+        .describe('Target size percent for complete action condensation'),
+    targetAddress: zod_1.z
+        .string()
+        .optional()
+        .describe('cmos:// address for carry_forward action (e.g., cmos://derek/cmos-dashboard)'),
+    send: zod_1.z
+        .boolean()
+        .optional()
+        .describe('Whether to actually send messages for carry_forward (default true, false = dry run)'),
+    projectRoot: zod_1.z
+        .string()
+        .optional()
+        .describe('Project root directory to search for CMOS database (defaults to cwd)'),
+})
+    .strict();
+/**
+ * MCP Tool Definition for cmos_sprint.
+ */
+exports.cmosSprintToolDefinition = {
+    name: 'cmos_sprint',
+    description: 'Consolidated sprint tool with action parameter support. ' +
+        'Actions: list, show, add, update, complete, retro, carry_forward, analytics. ' +
+        'Use retro to auto-generate a sprint retrospective report with KPIs, decisions, learnings, and git commit summary. ' +
+        'Use carry_forward to detect sync gaps and blocked missions and send backlog_request messages to a target project. ' +
+        'Use analytics to compute cross-sprint trend KPIs: velocity, completion rate, decision volume, cycle time.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            action: {
+                type: 'string',
+                enum: [...exports.CMOS_SPRINT_ACTIONS],
+                description: 'Sprint action: list | show | add | update | complete',
+            },
+            sprintId: {
+                type: 'string',
+                description: 'Sprint ID for show/add/update/complete actions',
+            },
+            title: {
+                type: 'string',
+                description: 'Sprint title for add action',
+            },
+            focus: {
+                type: 'string',
+                description: 'Strategic focus or theme for add action',
+            },
+            status: {
+                type: 'string',
+                description: 'Filter or sprint status depending on action',
+            },
+            startDate: {
+                type: 'string',
+                description: 'Sprint start date for add action',
+            },
+            endDate: {
+                type: 'string',
+                description: 'Sprint end date for add action',
+            },
+            limit: {
+                type: 'number',
+                minimum: 1,
+                maximum: 100,
+                description: 'Maximum sprints to return for list action',
+            },
+            fields: {
+                type: 'object',
+                description: 'Fields payload for update action',
+                properties: {
+                    title: { type: 'string', description: 'Sprint title' },
+                    focus: { type: 'string', description: 'Strategic focus or theme of the sprint' },
+                    status: { type: 'string', description: 'Sprint status (e.g., "Active", "Completed")' },
+                    startDate: {
+                        type: 'string',
+                        description: 'Start date in ISO format (e.g., "2025-01-01")',
+                    },
+                    endDate: {
+                        type: 'string',
+                        description: 'End date in ISO format (e.g., "2025-01-15")',
+                    },
+                },
+                additionalProperties: false,
+            },
+            summary: {
+                type: 'string',
+                description: 'Closeout summary for complete action',
+            },
+            condensation: {
+                type: 'string',
+                enum: ['none', 'conservative', 'auto', 'aggressive'],
+                description: 'Optional condensation strategy for complete action',
+            },
+            targetSizePercent: {
+                type: 'number',
+                minimum: 1,
+                maximum: 100,
+                description: 'Target size percent for complete action condensation',
+            },
+            targetAddress: {
+                type: 'string',
+                description: 'cmos:// address for carry_forward action (e.g., cmos://derek/cmos-dashboard)',
+            },
+            send: {
+                type: 'boolean',
+                description: 'Whether to actually send messages for carry_forward (default true, false = dry run)',
+            },
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        required: ['action'],
+        additionalProperties: false,
+    },
+};
+function isSprintAction(value) {
+    return exports.CMOS_SPRINT_ACTIONS.includes(value);
+}
+/**
+ * Route a consolidated sprint request to the existing action-specific handler.
+ */
+async function cmosSprint(params) {
+    const actionValue = typeof params.action === 'string' ? params.action : '';
+    if (!isSprintAction(actionValue)) {
+        return (0, errors_1.createError)(errors_1.CmosErrors.invalidAction('cmos_sprint', actionValue, exports.CMOS_SPRINT_ACTIONS));
+    }
+    switch (actionValue) {
+        case 'list':
+            return (0, cmos_sprint_list_1.cmosSprintList)({
+                status: params.status,
+                limit: params.limit,
+                projectRoot: params.projectRoot,
+            });
+        case 'show':
+            return (0, cmos_sprint_show_1.cmosSprintShow)({
+                sprintId: params.sprintId ?? '',
+                projectRoot: params.projectRoot,
+            });
+        case 'add':
+            return (0, cmos_sprint_add_1.cmosSprintAdd)({
+                sprintId: params.sprintId ?? '',
+                title: params.title ?? '',
+                focus: params.focus,
+                status: params.status,
+                startDate: params.startDate,
+                endDate: params.endDate,
+                projectRoot: params.projectRoot,
+            });
+        case 'update':
+            return (0, cmos_sprint_update_1.cmosSprintUpdate)({
+                sprintId: params.sprintId ?? '',
+                fields: (params.fields ?? {}),
+                projectRoot: params.projectRoot,
+            });
+        case 'complete': {
+            const result = await (0, cmos_sprint_complete_1.cmosSprintComplete)({
+                sprintId: params.sprintId ?? '',
+                summary: params.summary ?? '',
+                condensation: params.condensation,
+                targetSizePercent: params.targetSizePercent,
+                projectRoot: params.projectRoot,
+            });
+            if (result.success) {
+                (0, checkpoint_backfill_1.triggerCheckpointBackfill)({ projectRoot: params.projectRoot, force: true });
+            }
+            return result;
+        }
+        case 'retro':
+            return (0, cmos_sprint_retro_1.cmosSprintRetro)({
+                sprintId: params.sprintId ?? '',
+                projectRoot: params.projectRoot,
+            });
+        case 'carry_forward':
+            return (0, cmos_sprint_carry_forward_1.cmosSprintCarryForward)({
+                sprintId: params.sprintId ?? '',
+                targetAddress: params.targetAddress ?? '',
+                send: params.send,
+                projectRoot: params.projectRoot,
+            });
+        case 'analytics':
+            return (0, cmos_sprint_analytics_1.cmosSprintAnalytics)({
+                limit: params.limit,
+                projectRoot: params.projectRoot,
+            });
+    }
+}
+/**
+ * Format consolidated sprint responses by delegating to the existing formatter
+ * for the selected action. This keeps the POC close to the current output style.
+ */
+function formatSprintForLLM(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_sprint', '', `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_sprint_list_1.formatSprintListForLLM)(result);
+        case 'show':
+            return (0, cmos_sprint_show_1.formatSprintShowForLLM)(result);
+        case 'add':
+            return (0, cmos_sprint_add_1.formatSprintAddForLLM)(result);
+        case 'update':
+            return (0, cmos_sprint_update_1.formatSprintUpdateForLLM)(result);
+        case 'complete':
+            return (0, cmos_sprint_complete_1.formatSprintCompleteForLLM)(result);
+        case 'retro':
+            return (0, cmos_sprint_retro_1.formatSprintRetroForLLM)(result);
+        case 'carry_forward':
+            return (0, cmos_sprint_carry_forward_1.formatSprintCarryForwardForLLM)(result);
+        case 'analytics':
+            return (0, cmos_sprint_analytics_1.formatSprintAnalyticsForLLM)(result);
+        default:
+            return result.success ? '✓ Sprint action completed' : '❌ Failed to execute cmos_sprint';
+    }
+}
+//# sourceMappingURL=cmos-sprint.js.map

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

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

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

@@ -0,0 +1,69 @@
+/**
+ * cmos_status Tool
+ *
+ * Returns a structured status payload that mirrors what an operator or support
+ * agent would want to see at a glance: which cmos:// address this project
+ * advertises, which dashboard URL it's pointed at, the auth tier (mirroring
+ * onboard.authState.authTier exactly so support can read both sides the same
+ * way), and last-sync / last-delivery timestamps.
+ *
+ * Field contract is FROZEN per dashboard team msg 416315a7. Any shape change
+ * to the 5 required fields requires coordination with cmos://derek/cmos-dashboard
+ * before shipping (see cmos_decisions #642).
+ *
+ * @module tools/cmos/cmos-status
+ */
+import { z } from 'zod';
+import type { CmosToolResult } from './types';
+import type { AuthTier } from '../../auth/auth-state';
+/**
+ * Public status payload. The five top-level fields are FROZEN — adding,
+ * removing, or renaming any of them is a cross-side parity break and must
+ * coordinate with the dashboard team before shipping.
+ */
+export interface CmosStatusResult {
+    /** Project's cmos:// identity, or "local-only" when not dashboard-connected. */
+    cmos_address: string;
+    /** Runtime CMOS_DASHBOARD_URL value (always defined post-Sprint 62 m02 bake). */
+    dashboard_url: string;
+    /** Mirrors onboard.authState.authTier exactly: device-code | legacy-env | password-fallback | none. */
+    auth_tier: AuthTier;
+    /** ISO timestamp of last successful /api/sync/* round-trip; null if never. */
+    last_sync_at: string | null;
+    /** ISO timestamp of last successful message delivery; null if never. */
+    last_delivery_observed_at: string | null;
+}
+export declare const cmosStatusSchema: z.ZodObject<{
+    projectRoot: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    projectRoot?: string | undefined;
+}, {
+    projectRoot?: string | undefined;
+}>;
+export type CmosStatusParams = z.infer<typeof cmosStatusSchema>;
+export declare const cmosStatusToolDefinition: {
+    readonly name: "cmos_status";
+    readonly description: "Return a structured status payload for the current project: cmos_address, dashboard_url, auth_tier, last_sync_at, last_delivery_observed_at. Mirrors onboard.authState.authTier on the auth_tier field for cross-side parity with the dashboard. Useful for support/ops triage and at-a-glance health.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly projectRoot: {
+                readonly type: "string";
+                readonly description: "Project root directory to search for CMOS database (defaults to cwd)";
+            };
+        };
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Execute cmos_status. Always returns success=true with all 5 frozen fields
+ * populated; the only error path is the underlying CMOS DB being absent
+ * (handled by `withClientAsync`).
+ */
+export declare function cmosStatus(params?: CmosStatusParams): Promise<CmosToolResult<CmosStatusResult>>;
+/**
+ * Format the status payload for LLM-readable text output. The structuredContent
+ * carries the canonical 5-field shape; this format is for the chat surface.
+ */
+export declare function formatStatusForLLM(result: CmosToolResult<CmosStatusResult>): string;
+//# sourceMappingURL=cmos-status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cmos-status.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/cmos-status.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gFAAgF;IAChF,YAAY,EAAE,MAAM,CAAC;IACrB,iFAAiF;IACjF,aAAa,EAAE,MAAM,CAAC;IACtB,uGAAuG;IACvG,SAAS,EAAE,QAAQ,CAAC;IACpB,8EAA8E;IAC9E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,wEAAwE;IACxE,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED,eAAO,MAAM,gBAAgB;;;;;;EAK3B,CAAC;AAEH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAEhE,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;CAc3B,CAAC;AAsCX;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,MAAM,GAAE,gBAAqB,GAC5B,OAAO,CAAC,cAAc,CAAC,gBAAgB,CAAC,CAAC,CAwB3C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,cAAc,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAyBnF"}