@aquex/cmos-mcp 1.0.0

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

@@ -0,0 +1,136 @@
+"use strict";
+// ABOUTME: cmos_status tool — at-a-glance status payload for support and ops surfaces.
+// ABOUTME: Sprint 62 m06; 5 required fields per dashboard-team shape sketch (msg 416315a7), cross-side parity with onboard.authState.authTier.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cmosStatusToolDefinition = exports.cmosStatusSchema = void 0;
+exports.cmosStatus = cmosStatus;
+exports.formatStatusForLLM = formatStatusForLLM;
+/**
+ * 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
+ */
+const zod_1 = require("zod");
+const client_1 = require("./client");
+const errors_1 = require("./errors");
+const project_identity_1 = require("./project-identity");
+const dashboard_client_1 = require("./dashboard-client");
+const auth_state_1 = require("../../auth/auth-state");
+exports.cmosStatusSchema = zod_1.z.object({
+    projectRoot: zod_1.z
+        .string()
+        .optional()
+        .describe('Project root directory to search for CMOS database (defaults to cwd)'),
+});
+exports.cmosStatusToolDefinition = {
+    name: 'cmos_status',
+    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.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            projectRoot: {
+                type: 'string',
+                description: 'Project root directory to search for CMOS database (defaults to cwd)',
+            },
+        },
+        additionalProperties: false,
+    },
+};
+/**
+ * Local-only sentinel for the cmos_address field when the project has no
+ * canonical address yet (fresh project) or its identity is stuck on
+ * `cmos://unknown/*` (pre-canonicalization).
+ */
+const LOCAL_ONLY_ADDRESS = 'local-only';
+function normalizeCmosAddress(raw) {
+    if (!raw)
+        return LOCAL_ONLY_ADDRESS;
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return LOCAL_ONLY_ADDRESS;
+    if (trimmed.startsWith('cmos://unknown/'))
+        return LOCAL_ONLY_ADDRESS;
+    return trimmed;
+}
+async function resolveLastSyncAt(projectRoot) {
+    // Build a dashboard client opportunistically. If we can't authenticate
+    // (no credentials / unreachable / 4xx), the status payload returns null
+    // for last_sync_at without surfacing an error.
+    const clientResult = await dashboard_client_1.DashboardClient.fromEnvForProject(projectRoot);
+    if (!clientResult.success || !clientResult.data) {
+        return null;
+    }
+    try {
+        const statusResult = await clientResult.data.client.getSyncStatus();
+        if (statusResult.success && statusResult.data) {
+            return statusResult.data.lastSyncAt ?? null;
+        }
+    }
+    catch {
+        // Non-fatal — cmos_status must always return useful data even when the
+        // dashboard is unreachable.
+    }
+    return null;
+}
+/**
+ * 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`).
+ */
+async function cmosStatus(params = {}) {
+    return (0, client_1.withClientAsync)(async (client) => {
+        const identity = (0, project_identity_1.getProjectIdentity)(client);
+        const cmos_address = normalizeCmosAddress(identity?.cmos_address);
+        const dashboard_url = (0, dashboard_client_1.resolveDashboardBaseUrl)();
+        const authState = await (0, auth_state_1.computeAuthState)({ projectRoot: params.projectRoot });
+        const last_sync_at = await resolveLastSyncAt(params.projectRoot);
+        const result = {
+            cmos_address,
+            dashboard_url,
+            auth_tier: authState.authTier,
+            last_sync_at,
+            last_delivery_observed_at: authState.lastDeliveryObservedAt,
+        };
+        return (0, errors_1.createSuccess)(result);
+    }, { projectRoot: params.projectRoot });
+}
+/**
+ * Format the status payload for LLM-readable text output. The structuredContent
+ * carries the canonical 5-field shape; this format is for the chat surface.
+ */
+function formatStatusForLLM(result) {
+    if (!result.success || !result.data) {
+        const error = result.error;
+        const lines = ['cmos_status failed', '', `Error: ${error?.message ?? 'Unknown error'}`];
+        if (error?.suggestion) {
+            lines.push('', `Suggestion: ${error.suggestion}`);
+        }
+        return lines.join('\n');
+    }
+    const s = result.data;
+    return [
+        'CMOS Status',
+        '',
+        `cmos_address:              ${s.cmos_address}`,
+        `dashboard_url:             ${s.dashboard_url}`,
+        `auth_tier:                 ${s.auth_tier}`,
+        `last_sync_at:              ${s.last_sync_at ?? 'never'}`,
+        `last_delivery_observed_at: ${s.last_delivery_observed_at ?? 'never'}`,
+        s.auth_tier === 'none'
+            ? '\nNo dashboard credentials configured. Run cmos_auth(action="login") to bootstrap, or sign up at https://cmos.aquex.ai.'
+            : '',
+    ]
+        .filter(Boolean)
+        .join('\n');
+}
+//# sourceMappingURL=cmos-status.js.map

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

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

package/dist/tools/cmos/context-freshness.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Shared context freshness and refresh helpers.
+ *
+ * Provides:
+ * - master_context freshness calculations against latest completed activity
+ * - actionable stale warnings
+ * - master_context auto-refresh from completed missions/sprints since last update
+ *
+ * @module tools/cmos/context-freshness
+ */
+import type { CmosDatabaseClient } from './client';
+/**
+ * Default staleness threshold for master_context drift.
+ */
+export declare const DEFAULT_CONTEXT_STALE_THRESHOLD_DAYS = 7;
+/**
+ * Calculated freshness for a context against completed mission/session activity.
+ */
+export interface ContextFreshness {
+    contextId: string;
+    contextUpdatedAt: string | null;
+    latestMissionCompletionAt: string | null;
+    latestSessionCompletionAt: string | null;
+    latestActivityAt: string | null;
+    lagDays: number | null;
+    isStale: boolean;
+    staleThresholdDays: number;
+}
+/**
+ * Result of attempting to refresh master_context from recent completion activity.
+ */
+export interface MasterContextAutoRefreshResult {
+    attempted: boolean;
+    refreshed: boolean;
+    missionsAdded: number;
+    sprintsAdded: number;
+    snapshotId: number | null;
+    contextUpdatedAt: string | null;
+    latestAggregatedActivityAt: string | null;
+    warnings: string[];
+}
+/**
+ * Calculate freshness of a context compared to latest completed mission/session activity.
+ */
+export declare function calculateContextFreshness(client: CmosDatabaseClient, options?: {
+    contextId?: string;
+    staleThresholdDays?: number;
+}): {
+    freshness: ContextFreshness;
+    warnings: string[];
+};
+/**
+ * Build an actionable warning when master_context is stale.
+ */
+export declare function buildContextStalenessWarning(freshness: ContextFreshness): string | null;
+/**
+ * Refresh master_context with completed missions/sprints since its last update.
+ *
+ * This is a best-effort helper: failures are returned as warnings so callers can
+ * continue non-critical workflows (for example, session start).
+ */
+export declare function refreshMasterContextFromRecentActivity(client: CmosDatabaseClient, options?: {
+    source?: string;
+    now?: string;
+    since?: string | null;
+}): MasterContextAutoRefreshResult;
+//# sourceMappingURL=context-freshness.d.ts.map

package/dist/tools/cmos/context-freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-freshness.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/context-freshness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAInD;;GAEG;AACH,eAAO,MAAM,oCAAoC,IAAI,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA+BD;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE;IACP,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACxB,GACL;IAAE,SAAS,EAAE,gBAAgB,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAyDrD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAgBvF;AAED;;;;;GAKG;AACH,wBAAgB,sCAAsC,CACpD,MAAM,EAAE,kBAAkB,EAC1B,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAClB,GACL,8BAA8B,CA6NhC"}

package/dist/tools/cmos/context-freshness.js

@@ -0,0 +1,352 @@
+"use strict";
+/**
+ * Shared context freshness and refresh helpers.
+ *
+ * Provides:
+ * - master_context freshness calculations against latest completed activity
+ * - actionable stale warnings
+ * - master_context auto-refresh from completed missions/sprints since last update
+ *
+ * @module tools/cmos/context-freshness
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONTEXT_STALE_THRESHOLD_DAYS = void 0;
+exports.calculateContextFreshness = calculateContextFreshness;
+exports.buildContextStalenessWarning = buildContextStalenessWarning;
+exports.refreshMasterContextFromRecentActivity = refreshMasterContextFromRecentActivity;
+const crypto = __importStar(require("crypto"));
+const MILLIS_PER_DAY = 24 * 60 * 60 * 1000;
+/**
+ * Default staleness threshold for master_context drift.
+ */
+exports.DEFAULT_CONTEXT_STALE_THRESHOLD_DAYS = 7;
+/**
+ * Calculate freshness of a context compared to latest completed mission/session activity.
+ */
+function calculateContextFreshness(client, options = {}) {
+    const contextId = options.contextId ?? 'master_context';
+    const staleThresholdDays = options.staleThresholdDays ?? exports.DEFAULT_CONTEXT_STALE_THRESHOLD_DAYS;
+    const warnings = [];
+    const contextResult = client.getOne('SELECT updated_at FROM contexts WHERE id = ?', [contextId]);
+    if (!contextResult.success) {
+        warnings.push(`Unable to read ${contextId}.updated_at for freshness check: ${contextResult.error?.message ?? 'Unknown error'}.`);
+    }
+    const contextUpdatedAt = contextResult.success ? (contextResult.data?.updated_at ?? null) : null;
+    const missionResult = client.getOne(`SELECT MAX(completed_at) AS ts
+       FROM missions
+      WHERE completed_at IS NOT NULL`, []);
+    if (!missionResult.success) {
+        warnings.push(`Unable to read latest completed mission timestamp for freshness check: ${missionResult.error?.message ?? 'Unknown error'}.`);
+    }
+    const latestMissionCompletionAt = missionResult.success ? (missionResult.data?.ts ?? null) : null;
+    const sessionResult = client.getOne(`SELECT MAX(completed_at) AS ts
+       FROM sessions
+      WHERE completed_at IS NOT NULL`, []);
+    if (!sessionResult.success) {
+        warnings.push(`Unable to read latest completed session timestamp for freshness check: ${sessionResult.error?.message ?? 'Unknown error'}.`);
+    }
+    const latestSessionCompletionAt = sessionResult.success ? (sessionResult.data?.ts ?? null) : null;
+    const latestActivityAt = maxIsoTimestamp(latestMissionCompletionAt, latestSessionCompletionAt);
+    const lagDays = calculateLagDays(contextUpdatedAt, latestActivityAt);
+    const freshness = {
+        contextId,
+        contextUpdatedAt,
+        latestMissionCompletionAt,
+        latestSessionCompletionAt,
+        latestActivityAt,
+        lagDays,
+        isStale: lagDays !== null && lagDays > staleThresholdDays,
+        staleThresholdDays,
+    };
+    return { freshness, warnings };
+}
+/**
+ * Build an actionable warning when master_context is stale.
+ */
+function buildContextStalenessWarning(freshness) {
+    if (!freshness.isStale) {
+        return null;
+    }
+    const lagDays = freshness.lagDays !== null ? freshness.lagDays.toFixed(1) : 'unknown';
+    const updatedAt = freshness.contextUpdatedAt ?? 'unknown';
+    const latestAt = freshness.latestActivityAt ?? 'unknown';
+    return (`${freshness.contextId} appears stale: updated_at=${updatedAt}, ` +
+        `latest completed mission/session activity=${latestAt}, lag=${lagDays} days ` +
+        `(threshold=${freshness.staleThresholdDays} days). ` +
+        'Recommended action: run cmos_context_update(), or start a review session with ' +
+        'cmos_session_start(type="review", title="Context refresh") and complete it.');
+}
+/**
+ * Refresh master_context with completed missions/sprints since its last update.
+ *
+ * This is a best-effort helper: failures are returned as warnings so callers can
+ * continue non-critical workflows (for example, session start).
+ */
+function refreshMasterContextFromRecentActivity(client, options = {}) {
+    const warnings = [];
+    const now = options.now ?? new Date().toISOString();
+    const snapshotSource = options.source ?? 'session_start:auto_refresh';
+    const contextResult = client.getOne('SELECT source_path, content, updated_at FROM contexts WHERE id = ?', ['master_context']);
+    if (!contextResult.success) {
+        return {
+            attempted: true,
+            refreshed: false,
+            missionsAdded: 0,
+            sprintsAdded: 0,
+            snapshotId: null,
+            contextUpdatedAt: null,
+            latestAggregatedActivityAt: null,
+            warnings: [
+                `Auto-refresh skipped: failed to read master_context: ${contextResult.error?.message ?? 'Unknown error'}.`,
+            ],
+        };
+    }
+    const sourcePath = contextResult.data?.source_path ?? 'context/MASTER_CONTEXT.json';
+    const cutoff = options.since ?? contextResult.data?.updated_at ?? null;
+    let content = {};
+    if (contextResult.data?.content) {
+        try {
+            content = JSON.parse(contextResult.data.content);
+        }
+        catch {
+            return {
+                attempted: true,
+                refreshed: false,
+                missionsAdded: 0,
+                sprintsAdded: 0,
+                snapshotId: null,
+                contextUpdatedAt: contextResult.data.updated_at,
+                latestAggregatedActivityAt: null,
+                warnings: [
+                    'Auto-refresh skipped: master_context content is invalid JSON. Repair context JSON before retrying.',
+                ],
+            };
+        }
+    }
+    const completedMissions = ensureObjectArray(content, 'completed_missions');
+    const completedSprints = ensureObjectArray(content, 'completed_sprints');
+    const existingMissionIds = new Set();
+    for (const item of completedMissions) {
+        const idValue = item['mission_id'];
+        if (typeof idValue === 'string' && idValue.trim().length > 0) {
+            existingMissionIds.add(idValue);
+        }
+    }
+    const existingSprintIds = new Set();
+    for (const item of completedSprints) {
+        const idValue = item['sprint_id'];
+        if (typeof idValue === 'string' && idValue.trim().length > 0) {
+            existingSprintIds.add(idValue);
+        }
+    }
+    const missionQuery = `SELECT id, name, objective, notes, sprint_id, completed_at
+       FROM missions
+      WHERE status = 'Completed'
+        AND completed_at IS NOT NULL` +
+        (cutoff ? ' AND completed_at > ?' : '') +
+        ' ORDER BY completed_at ASC';
+    const missionResult = client.getMany(missionQuery, cutoff ? [cutoff] : []);
+    const missions = missionResult.success ? (missionResult.data ?? []) : [];
+    if (!missionResult.success) {
+        warnings.push(`Auto-refresh could not read completed missions: ${missionResult.error?.message ?? 'Unknown error'}.`);
+    }
+    let missionsAdded = 0;
+    let latestAggregatedActivityAt = null;
+    for (const mission of missions) {
+        if (existingMissionIds.has(mission.id)) {
+            continue;
+        }
+        completedMissions.push({
+            mission_id: mission.id,
+            mission_name: mission.name,
+            objective: mission.objective,
+            notes: mission.notes,
+            completed_at: mission.completed_at,
+            sprint_id: mission.sprint_id,
+        });
+        existingMissionIds.add(mission.id);
+        missionsAdded += 1;
+        latestAggregatedActivityAt = maxIsoTimestamp(latestAggregatedActivityAt, mission.completed_at);
+    }
+    const sprintQuery = `SELECT
+       s.id,
+       s.title,
+       s.focus,
+       s.status,
+       COUNT(m.id) AS total_missions,
+       SUM(CASE WHEN m.status = 'Completed' THEN 1 ELSE 0 END) AS completed_missions,
+       MAX(m.completed_at) AS last_completed_at
+     FROM sprints s
+     JOIN missions m ON m.sprint_id = s.id
+     GROUP BY s.id, s.title, s.focus, s.status
+     HAVING COUNT(m.id) > 0
+       AND SUM(CASE WHEN m.status != 'Completed' THEN 1 ELSE 0 END) = 0
+       AND MAX(m.completed_at) IS NOT NULL` +
+        (cutoff ? ' AND MAX(m.completed_at) > ?' : '') +
+        ' ORDER BY MAX(m.completed_at) ASC';
+    const sprintResult = client.getMany(sprintQuery, cutoff ? [cutoff] : []);
+    const sprints = sprintResult.success ? (sprintResult.data ?? []) : [];
+    if (!sprintResult.success) {
+        warnings.push(`Auto-refresh could not read completed sprints: ${sprintResult.error?.message ?? 'Unknown error'}.`);
+    }
+    let sprintsAdded = 0;
+    for (const sprint of sprints) {
+        if (existingSprintIds.has(sprint.id)) {
+            continue;
+        }
+        completedSprints.push({
+            sprint_id: sprint.id,
+            title: sprint.title,
+            focus: sprint.focus,
+            status: sprint.status,
+            total_missions: sprint.total_missions,
+            completed_missions: sprint.completed_missions,
+            completed_at: sprint.last_completed_at,
+        });
+        existingSprintIds.add(sprint.id);
+        sprintsAdded += 1;
+        latestAggregatedActivityAt = maxIsoTimestamp(latestAggregatedActivityAt, sprint.last_completed_at);
+    }
+    if (missionsAdded === 0 && sprintsAdded === 0) {
+        return {
+            attempted: true,
+            refreshed: false,
+            missionsAdded: 0,
+            sprintsAdded: 0,
+            snapshotId: null,
+            contextUpdatedAt: contextResult.data?.updated_at ?? null,
+            latestAggregatedActivityAt,
+            warnings,
+        };
+    }
+    const serialized = JSON.stringify(content);
+    const persistResult = contextResult.data
+        ? client.execute('UPDATE contexts SET content = ?, updated_at = ? WHERE id = ?', [
+            serialized,
+            now,
+            'master_context',
+        ])
+        : client.execute('INSERT INTO contexts (id, source_path, content, updated_at) VALUES (?, ?, ?, ?)', ['master_context', sourcePath, serialized, now]);
+    if (!persistResult.success) {
+        return {
+            attempted: true,
+            refreshed: false,
+            missionsAdded: 0,
+            sprintsAdded: 0,
+            snapshotId: null,
+            contextUpdatedAt: contextResult.data?.updated_at ?? null,
+            latestAggregatedActivityAt,
+            warnings: [
+                ...warnings,
+                `Auto-refresh found updates but failed to persist master_context: ${persistResult.error?.message ?? 'Unknown error'}.`,
+            ],
+        };
+    }
+    const snapshotId = createContextSnapshotWithDedup(client, 'master_context', serialized, snapshotSource, now, warnings);
+    return {
+        attempted: true,
+        refreshed: true,
+        missionsAdded,
+        sprintsAdded,
+        snapshotId,
+        contextUpdatedAt: now,
+        latestAggregatedActivityAt,
+        warnings,
+    };
+}
+function ensureObjectArray(content, key) {
+    const existing = content[key];
+    if (!Array.isArray(existing)) {
+        const created = [];
+        content[key] = created;
+        return created;
+    }
+    const normalized = existing.filter(isPlainObject);
+    if (normalized.length !== existing.length) {
+        content[key] = normalized;
+    }
+    return normalized;
+}
+function createContextSnapshotWithDedup(client, contextId, content, source, now, warnings) {
+    const hash = crypto.createHash('sha256').update(content).digest('hex').substring(0, 16);
+    const existingResult = client.getOne('SELECT id FROM context_snapshots WHERE context_id = ? AND content_hash = ?', [contextId, hash]);
+    if (existingResult.success && existingResult.data) {
+        return existingResult.data.id;
+    }
+    if (!existingResult.success) {
+        warnings.push(`Auto-refresh snapshot dedupe lookup failed: ${existingResult.error?.message ?? 'Unknown error'}.`);
+        return null;
+    }
+    const insertResult = client.execute(`INSERT INTO context_snapshots (context_id, source, content_hash, content, created_at)
+     VALUES (?, ?, ?, ?, ?)`, [contextId, source, hash, content, now]);
+    if (!insertResult.success) {
+        warnings.push(`Auto-refresh updated master_context but failed to create snapshot: ${insertResult.error?.message ?? 'Unknown error'}.`);
+        return null;
+    }
+    return Number(insertResult.data?.lastInsertRowid);
+}
+function calculateLagDays(contextUpdatedAt, latestActivityAt) {
+    if (!contextUpdatedAt || !latestActivityAt) {
+        return null;
+    }
+    const contextTs = Date.parse(contextUpdatedAt);
+    const latestTs = Date.parse(latestActivityAt);
+    if (!Number.isFinite(contextTs) || !Number.isFinite(latestTs)) {
+        return null;
+    }
+    if (latestTs <= contextTs) {
+        return 0;
+    }
+    return Math.round(((latestTs - contextTs) / MILLIS_PER_DAY) * 100) / 100;
+}
+function maxIsoTimestamp(...timestamps) {
+    let max = null;
+    for (const ts of timestamps) {
+        if (!ts)
+            continue;
+        const parsed = Date.parse(ts);
+        if (!Number.isFinite(parsed))
+            continue;
+        if (!max || parsed > max.parsed) {
+            max = { value: ts, parsed };
+        }
+    }
+    return max?.value ?? null;
+}
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=context-freshness.js.map

package/dist/tools/cmos/context-freshness.js.map

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

package/dist/tools/cmos/context-retention.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Shared context size and condensation helpers for CMOS context tools.
+ *
+ * Provides:
+ * - Context size metrics with configurable limits/warning thresholds
+ * - Retention policy parsing from environment
+ * - Sprint-aware archival of old context detail into snapshot-backed summaries
+ *
+ * @module tools/cmos/context-retention
+ */
+import type { CmosDatabaseClient } from './client';
+export interface ContextRetentionPolicy {
+    keepDetailSprints: number;
+    warningThresholdPercent: number;
+    sizeLimitKb: number;
+    targetSizeKb: number;
+}
+export interface ContextSizeMetrics {
+    sizeBytes: number;
+    sizeKb: number;
+    limitKb: number;
+    warningThresholdPercent: number;
+    usagePercent: number;
+    nearLimit: boolean;
+}
+export interface ContextCondensationResult {
+    changed: boolean;
+    archivedSprintIds: string[];
+    archivedCounts: {
+        sessionHistory: number;
+        recentSessions: number;
+        nextSteps: number;
+        total: number;
+    };
+    archiveSnapshotId: number | null;
+    sizeBefore: ContextSizeMetrics;
+    sizeAfter: ContextSizeMetrics;
+    notes: string[];
+}
+export declare function getContextRetentionPolicy(): ContextRetentionPolicy;
+export declare function calculateContextSizeMetrics(content: Record<string, unknown> | string, options?: {
+    limitKb?: number;
+    warningThresholdPercent?: number;
+}): ContextSizeMetrics;
+export declare function buildContextSizeWarning(contextLabel: string, metrics: ContextSizeMetrics): string | null;
+export declare function resolveContextSizeSettings(content: Record<string, unknown>, defaults?: Partial<ContextRetentionPolicy>): {
+    limitKb: number;
+    warningThresholdPercent: number;
+};
+/**
+ * Condense sprint detail older than retention policy and preserve the original
+ * full detail in a context snapshot before archival changes are written.
+ */
+export declare function condenseContextForRetention(client: CmosDatabaseClient, contextId: 'master_context' | 'project_context', content: Record<string, unknown>, options?: {
+    source?: string;
+    policy?: Partial<ContextRetentionPolicy>;
+}): ContextCondensationResult;
+//# sourceMappingURL=context-retention.d.ts.map

package/dist/tools/cmos/context-retention.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-retention.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/context-retention.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAOnD,MAAM,WAAW,sBAAsB;IACrC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uBAAuB,EAAE,MAAM,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB,EAAE,MAAM,CAAC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE;QACd,cAAc,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAiBD,wBAAgB,yBAAyB,IAAI,sBAAsB,CAelE;AAED,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,EACzC,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,uBAAuB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/D,kBAAkB,CAkBpB;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,kBAAkB,GAC1B,MAAM,GAAG,IAAI,CAMf;AAED,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,GACzC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,uBAAuB,EAAE,MAAM,CAAA;CAAE,CAkBtD;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,gBAAgB,GAAG,iBAAiB,EAC/C,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,CAAC,EAAE;IACR,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC1C,GACA,yBAAyB,CAsF3B"}