@aquex/cmos-mcp 1.0.0

package/dist/server-health.js

@@ -0,0 +1,181 @@
+"use strict";
+/**
+ * MCP Server Health Module
+ *
+ * Tracks server process health and detects stale code (build drift).
+ * At startup, captures the build manifest from dist/.build-manifest.json.
+ * At runtime, re-reads the manifest to detect if a rebuild has occurred
+ * since the server started.
+ *
+ * @module server-health
+ */
+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.readBuildManifest = readBuildManifest;
+exports.initServerHealth = initServerHealth;
+exports.getServerHealth = getServerHealth;
+exports.isServerStale = isServerStale;
+exports.getStartupManifest = getStartupManifest;
+exports.resetServerHealth = resetServerHealth;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// Module-level state
+let serverStartTime = null;
+let startupManifest = null;
+let manifestPath = null;
+let initialSearchDir = undefined;
+/**
+ * Read the build manifest from disk.
+ * Returns null if the file doesn't exist or is malformed.
+ */
+function readBuildManifest(distDir) {
+    const dir = distDir ?? path.resolve(__dirname, '..');
+    // When running from dist/, __dirname IS the dist dir
+    // When running from src/ (tests), go up to project root then into dist/
+    const candidates = [
+        path.join(dir, '.build-manifest.json'),
+        path.join(dir, 'dist', '.build-manifest.json'),
+    ];
+    for (const candidate of candidates) {
+        try {
+            if (fs.existsSync(candidate)) {
+                const raw = fs.readFileSync(candidate, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (parsed &&
+                    typeof parsed.buildHash === 'string' &&
+                    typeof parsed.buildTime === 'string') {
+                    manifestPath = candidate;
+                    return parsed;
+                }
+            }
+        }
+        catch {
+            // Continue to next candidate
+        }
+    }
+    return null;
+}
+/**
+ * Initialize server health tracking.
+ * Call this once at server startup to capture the initial build manifest.
+ */
+function initServerHealth(distDir) {
+    serverStartTime = new Date();
+    initialSearchDir = distDir;
+    startupManifest = readBuildManifest(distDir);
+    if (startupManifest) {
+        console.error(`[INFO] Server health initialized: buildHash=${startupManifest.buildHash.slice(0, 12)}… buildTime=${startupManifest.buildTime}`);
+    }
+    else {
+        console.error(`[WARN] No build manifest found — staleness detection disabled. Run 'npm run build' to generate.`);
+    }
+}
+/**
+ * Get the current server health status.
+ * Re-reads the build manifest from disk to detect drift.
+ */
+function getServerHealth() {
+    const now = new Date();
+    const startTime = serverStartTime ?? now;
+    const uptimeSeconds = Math.floor((now.getTime() - startTime.getTime()) / 1000);
+    const memUsage = process.memoryUsage();
+    const memoryUsageMb = Math.round((memUsage.rss / 1024 / 1024) * 100) / 100;
+    // Re-read manifest from disk to check for drift
+    // Use the same search directory as initialization to avoid finding unrelated manifests
+    const currentManifest = manifestPath
+        ? readBuildManifest(path.dirname(manifestPath))
+        : readBuildManifest(initialSearchDir);
+    // Determine staleness
+    let codeIsCurrent = true;
+    let stalenessMessage = null;
+    if (startupManifest && currentManifest) {
+        if (startupManifest.buildHash !== currentManifest.buildHash) {
+            codeIsCurrent = false;
+            const builtAt = new Date(currentManifest.buildTime);
+            const startedAt = new Date(startupManifest.buildTime);
+            const driftMinutes = Math.round((builtAt.getTime() - startedAt.getTime()) / 60000);
+            stalenessMessage =
+                `Server is running stale code. ` +
+                    `Build at startup: ${startupManifest.buildHash.slice(0, 12)}… (${startupManifest.buildTime}). ` +
+                    `Current build: ${currentManifest.buildHash.slice(0, 12)}… (${currentManifest.buildTime}). ` +
+                    `Drift: ${driftMinutes} minute(s). Restart the MCP server to pick up changes.`;
+        }
+    }
+    else if (!startupManifest && !currentManifest) {
+        // No manifest at all — can't detect staleness
+        stalenessMessage = null;
+    }
+    else if (!startupManifest && currentManifest) {
+        // Server started without manifest, but one exists now
+        codeIsCurrent = false;
+        stalenessMessage =
+            'Server started before build manifest existed. A build has since occurred. Restart recommended.';
+    }
+    return {
+        uptimeSeconds,
+        startedAt: startTime.toISOString(),
+        memoryUsageMb,
+        startupBuild: startupManifest,
+        currentBuild: currentManifest,
+        codeIsCurrent,
+        stalenessMessage,
+        pid: process.pid,
+        nodeVersion: process.version,
+    };
+}
+/**
+ * Check if the server is running stale code.
+ * Convenience wrapper for use in onboard/health flows.
+ */
+function isServerStale() {
+    const health = getServerHealth();
+    return !health.codeIsCurrent;
+}
+/**
+ * Get the startup manifest (for testing).
+ */
+function getStartupManifest() {
+    return startupManifest;
+}
+/**
+ * Reset server health state (for testing).
+ */
+function resetServerHealth() {
+    serverStartTime = null;
+    startupManifest = null;
+    manifestPath = null;
+    initialSearchDir = undefined;
+}
+//# sourceMappingURL=server-health.js.map

package/dist/server-health.js.map

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

package/dist/tools/analyze-dependencies.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Arguments for analyze_dependencies MCP tool
+ */
+export interface AnalyzeDependenciesArgs {
+    missionDirectory: string;
+    includeInferred?: boolean;
+    minConfidence?: number;
+}
+/**
+ * Result from analyze_dependencies MCP tool
+ */
+export interface AnalyzeDependenciesResult {
+    totalMissions: number;
+    isValid: boolean;
+    isDAG: boolean;
+    hasCycles: boolean;
+    cycles?: string[][];
+    executionOrder?: string[];
+    criticalPath?: string[];
+    inferredDependencies?: Array<{
+        from: string;
+        to: string;
+        confidence: number;
+        reason: string;
+    }>;
+    errors: string[];
+    warnings: string[];
+    performanceMs: number;
+}
+/**
+ * Analyze dependencies in a mission directory
+ * MCP tool implementation for dependency analysis
+ */
+export declare function analyzeDependencies(args: AnalyzeDependenciesArgs): Promise<AnalyzeDependenciesResult>;
+/**
+ * Format analysis result as readable text
+ */
+export declare function formatAnalysisResult(result: AnalyzeDependenciesResult): string;
+/**
+ * MCP Tool Definition for dependency analysis
+ */
+export declare const getDependencyAnalysisToolDefinition: {
+    readonly name: "get_dependency_analysis";
+    readonly description: "Analyze mission YAML files to construct a dependency graph, validate DAG properties, detect cycles, and compute execution order. Optionally infer implicit dependencies.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly missionDirectory: {
+                readonly type: "string";
+                readonly description: "Directory containing mission YAML files";
+            };
+            readonly includeInferred: {
+                readonly type: "boolean";
+                readonly description: "Include NLP-based inferred dependencies";
+            };
+            readonly minConfidence: {
+                readonly type: "number";
+                readonly minimum: 0;
+                readonly maximum: 1;
+                readonly description: "Minimum confidence for inferred dependencies";
+            };
+        };
+        readonly required: readonly ["missionDirectory"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Legacy alias maintained for one release cycle
+ */
+export declare const analyzeDependenciesToolDefinitionDeprecated: {
+    readonly name: "analyze_dependencies";
+    readonly description: "[DEPRECATED] Use get_dependency_analysis instead. Returns the same dependency graph report.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly missionDirectory: {
+                readonly type: "string";
+                readonly description: "Directory containing mission YAML files";
+            };
+            readonly includeInferred: {
+                readonly type: "boolean";
+                readonly description: "Include NLP-based inferred dependencies";
+            };
+            readonly minConfidence: {
+                readonly type: "number";
+                readonly minimum: 0;
+                readonly maximum: 1;
+                readonly description: "Minimum confidence for inferred dependencies";
+            };
+        };
+        readonly required: readonly ["missionDirectory"];
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * Wrap execution for MCP server usage
+ */
+export declare function executeAnalyzeDependenciesTool(params: AnalyzeDependenciesArgs): Promise<string>;
+//# sourceMappingURL=analyze-dependencies.d.ts.map

package/dist/tools/analyze-dependencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-dependencies.d.ts","sourceRoot":"","sources":["../../src/tools/analyze-dependencies.ts"],"names":[],"mappings":"AAoBA;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,oBAAoB,CAAC,EAAE,KAAK,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,yBAAyB,CAAC,CAqHpC;AAuFD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,yBAAyB,GAAG,MAAM,CAsD9E;AAED;;GAEG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;CAmBtC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,2CAA2C;;;;;;;;;;;;;;;;;;;;;;;;CAK9C,CAAC;AAEX;;GAEG;AACH,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,MAAM,CAAC,CAOjB"}

package/dist/tools/analyze-dependencies.js

@@ -0,0 +1,329 @@
+"use strict";
+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.analyzeDependenciesToolDefinitionDeprecated = exports.getDependencyAnalysisToolDefinition = void 0;
+exports.analyzeDependencies = analyzeDependencies;
+exports.formatAnalysisResult = formatAnalysisResult;
+exports.executeAnalyzeDependenciesTool = executeAnalyzeDependenciesTool;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const dependency_analyzer_1 = require("../intelligence/dependency-analyzer");
+const graph_validator_1 = require("../intelligence/graph-validator");
+const dependency_inferrer_1 = require("../intelligence/dependency-inferrer");
+const yaml = __importStar(require("js-yaml"));
+const validation_error_1 = require("../errors/validation-error");
+const io_error_1 = require("../errors/io-error");
+const handler_1 = require("../errors/handler");
+const common_1 = require("../validation/common");
+const middleware_1 = require("../validation/middleware");
+const file_path_schema_1 = require("../validation/schemas/file-path-schema");
+const mission_error_1 = require("../errors/mission-error");
+const fs_2 = require("../utils/fs");
+/**
+ * Analyze dependencies in a mission directory
+ * MCP tool implementation for dependency analysis
+ */
+async function analyzeDependencies(args) {
+    const startTime = Date.now();
+    try {
+        const validated = await validateArgs(args);
+        const missionDirectory = await (0, common_1.safeFilePath)(validated.missionDirectory, {
+            allowRelative: true,
+            maxLength: 4096,
+        });
+        const absoluteMissionDirectory = path.resolve(missionDirectory);
+        if (!(await (0, fs_2.pathExists)(absoluteMissionDirectory))) {
+            throw new io_error_1.IOError(`Mission directory does not exist: ${missionDirectory}`, {
+                code: 'IO_NOT_FOUND',
+                context: { missionDirectory },
+            });
+        }
+        // Find all mission files
+        const missionFiles = await findMissionFiles(absoluteMissionDirectory);
+        if (missionFiles.length === 0) {
+            throw new validation_error_1.ValidationError(`No mission files found in ${missionDirectory}`, {
+                context: { missionDirectory },
+            });
+        }
+        // Load mission data
+        const missions = await loadMissionFiles(missionFiles);
+        // Create analyzer and analyze dependencies
+        const analyzer = new dependency_analyzer_1.DependencyAnalyzer();
+        const analysisResult = await analyzer.analyze(missions);
+        // Validate graph
+        const validator = new graph_validator_1.GraphValidator();
+        const validationResult = validator.validate(analysisResult.graph);
+        // Infer implicit dependencies if requested
+        let inferredDependencies;
+        if (validated.includeInferred) {
+            const inferrer = new dependency_inferrer_1.DependencyInferrer();
+            const allInferred = [];
+            for (const mission of missions) {
+                const inferred = inferrer.inferDependencies(analysisResult.graph, mission);
+                allInferred.push(...inferred);
+            }
+            // Filter by confidence
+            const minConfidence = validated.minConfidence ?? 0.7;
+            inferredDependencies = inferrer.filterByConfidence(allInferred, minConfidence);
+        }
+        const performanceMs = Date.now() - startTime;
+        // Return result
+        return {
+            totalMissions: missionFiles.length,
+            isValid: validationResult.isValid,
+            isDAG: validationResult.isDAG,
+            hasCycles: analysisResult.hasCycles,
+            cycles: analysisResult.cycles,
+            executionOrder: analysisResult.executionOrder,
+            criticalPath: analysisResult.criticalPath,
+            inferredDependencies: inferredDependencies?.map((dep) => ({
+                from: dep.from,
+                to: dep.to,
+                confidence: dep.confidence,
+                reason: dep.reason,
+            })),
+            errors: validationResult.errors,
+            warnings: validationResult.warnings,
+            performanceMs,
+        };
+    }
+    catch (error) {
+        const performanceMs = Date.now() - startTime;
+        if (error instanceof mission_error_1.MissionProtocolError) {
+            return {
+                totalMissions: 0,
+                isValid: false,
+                isDAG: false,
+                hasCycles: false,
+                errors: [error.message],
+                warnings: [],
+                performanceMs,
+            };
+        }
+        const missionError = handler_1.ErrorHandler.handle(error, 'tools.get_dependency_analysis.execute', {
+            module: 'tools/analyze-dependencies',
+            data: {
+                missionDirectory: args.missionDirectory,
+                includeInferred: Boolean(args.includeInferred),
+            },
+        }, {
+            rethrow: false,
+            userMessage: 'Dependency analysis failed.',
+        });
+        const publicError = handler_1.ErrorHandler.toPublicError(missionError);
+        const errorMessage = publicError.correlationId
+            ? `${publicError.message} (correlationId=${publicError.correlationId})`
+            : publicError.message;
+        return {
+            totalMissions: 0,
+            isValid: false,
+            isDAG: false,
+            hasCycles: false,
+            errors: [errorMessage],
+            warnings: [],
+            performanceMs,
+        };
+    }
+}
+/**
+ * Find all mission YAML files in a directory
+ */
+async function findMissionFiles(directory) {
+    const missionFiles = [];
+    async function traverse(dir) {
+        const entries = await fs_1.promises.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = await (0, common_1.safeFilePath)(path.join(dir, entry.name), {
+                allowRelative: false,
+            });
+            if (entry.isDirectory()) {
+                // Skip node_modules, .git, etc.
+                if (!entry.name.startsWith('.') && entry.name !== 'node_modules') {
+                    await traverse(fullPath);
+                }
+            }
+            else if (entry.isFile()) {
+                // Check if it's a YAML mission file
+                if (entry.name.endsWith('.yaml') || entry.name.endsWith('.yml')) {
+                    missionFiles.push(fullPath);
+                }
+            }
+        }
+    }
+    await traverse(directory);
+    return missionFiles;
+}
+/**
+ * Load mission files and parse YAML
+ */
+async function loadMissionFiles(filePaths) {
+    const missions = [];
+    for (const filePath of filePaths) {
+        try {
+            const sanitizedPath = await (0, common_1.safeFilePath)(filePath, { allowRelative: false });
+            const content = await fs_1.promises.readFile(sanitizedPath, 'utf-8');
+            const missionData = yaml.load(content);
+            if (!(0, dependency_analyzer_1.isMissionRecord)(missionData)) {
+                handler_1.ErrorHandler.handle(new validation_error_1.ValidationError('Mission file is missing required identifiers', {
+                    context: { filePath: sanitizedPath },
+                    severity: 'warning',
+                }), 'tools.get_dependency_analysis.load_mission_file.invalid', {
+                    module: 'tools/analyze-dependencies',
+                    data: { filePath: sanitizedPath },
+                }, {
+                    severity: 'warning',
+                    rethrow: false,
+                    userMessage: `Mission file ${path.basename(filePath)} is missing required missionId`,
+                });
+                continue;
+            }
+            missions.push({ ...missionData, filePath: sanitizedPath });
+        }
+        catch (error) {
+            handler_1.ErrorHandler.handle(error, 'tools.get_dependency_analysis.load_mission_file', {
+                module: 'tools/analyze-dependencies',
+                data: { filePath },
+            }, {
+                severity: 'warning',
+                rethrow: false,
+                userMessage: `Failed to load mission file ${path.basename(filePath)}`,
+            });
+        }
+    }
+    return missions;
+}
+/**
+ * Format analysis result as readable text
+ */
+function formatAnalysisResult(result) {
+    const lines = [];
+    lines.push('=== Dependency Analysis Report ===\n');
+    lines.push(`Total Missions: ${result.totalMissions}`);
+    lines.push(`Analysis Time: ${result.performanceMs}ms`);
+    lines.push(`Valid: ${result.isValid ? 'Yes' : 'No'}`);
+    lines.push(`Is DAG: ${result.isDAG ? 'Yes' : 'No'}`);
+    lines.push(`Has Cycles: ${result.hasCycles ? 'Yes' : 'No'}\n`);
+    if (result.errors.length > 0) {
+        lines.push('Errors:');
+        result.errors.forEach((err) => lines.push(`  - ${err}`));
+        lines.push('');
+    }
+    if (result.warnings.length > 0) {
+        lines.push('Warnings:');
+        result.warnings.forEach((warn) => lines.push(`  - ${warn}`));
+        lines.push('');
+    }
+    if (result.cycles && result.cycles.length > 0) {
+        lines.push('Circular Dependencies Detected:');
+        result.cycles.forEach((cycle, i) => {
+            lines.push(`  ${i + 1}. ${cycle.join(' -> ')}`);
+        });
+        lines.push('');
+    }
+    if (result.executionOrder) {
+        lines.push('Execution Order:');
+        result.executionOrder.forEach((mission, i) => {
+            lines.push(`  ${i + 1}. ${mission}`);
+        });
+        lines.push('');
+    }
+    if (result.criticalPath && result.criticalPath.length > 0) {
+        lines.push('Critical Path:');
+        lines.push(`  ${result.criticalPath.join(' -> ')}`);
+        lines.push('');
+    }
+    if (result.inferredDependencies && result.inferredDependencies.length > 0) {
+        lines.push('Inferred Dependencies:');
+        result.inferredDependencies.forEach((dep) => {
+            lines.push(`  ${dep.from} -> ${dep.to} (confidence: ${(dep.confidence * 100).toFixed(0)}%)`);
+            lines.push(`    Reason: ${dep.reason}`);
+        });
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * MCP Tool Definition for dependency analysis
+ */
+exports.getDependencyAnalysisToolDefinition = {
+    name: 'get_dependency_analysis',
+    description: 'Analyze mission YAML files to construct a dependency graph, validate DAG properties, detect cycles, and compute execution order. Optionally infer implicit dependencies.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            missionDirectory: { type: 'string', description: 'Directory containing mission YAML files' },
+            includeInferred: { type: 'boolean', description: 'Include NLP-based inferred dependencies' },
+            minConfidence: {
+                type: 'number',
+                minimum: 0,
+                maximum: 1,
+                description: 'Minimum confidence for inferred dependencies',
+            },
+        },
+        required: ['missionDirectory'],
+        additionalProperties: false,
+    },
+};
+/**
+ * Legacy alias maintained for one release cycle
+ */
+exports.analyzeDependenciesToolDefinitionDeprecated = {
+    ...exports.getDependencyAnalysisToolDefinition,
+    name: 'analyze_dependencies',
+    description: '[DEPRECATED] Use get_dependency_analysis instead. Returns the same dependency graph report.',
+};
+/**
+ * Wrap execution for MCP server usage
+ */
+async function executeAnalyzeDependenciesTool(params) {
+    const result = await analyzeDependencies({
+        missionDirectory: params.missionDirectory,
+        includeInferred: params.includeInferred,
+        minConfidence: params.minConfidence,
+    });
+    return formatAnalysisResult(result);
+}
+const AnalyzeDependenciesArgsSchema = zod_1.z
+    .object({
+    missionDirectory: (0, file_path_schema_1.createFilePathSchema)({ allowRelative: true }),
+    includeInferred: zod_1.z.boolean().optional(),
+    minConfidence: zod_1.z.number().min(0).max(1).optional(),
+})
+    .strict();
+async function validateArgs(args) {
+    return (0, middleware_1.validateAndSanitize)(args, AnalyzeDependenciesArgsSchema);
+}
+//# sourceMappingURL=analyze-dependencies.js.map

package/dist/tools/analyze-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-dependencies.js","sourceRoot":"","sources":["../../src/tools/analyze-dependencies.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDA,kDAuHC;AA0FD,oDAsDC;AAuCD,wEASC;AA9WD,2BAAoC;AACpC,2CAA6B;AAC7B,6BAAwB;AACxB,6EAI6C;AAC7C,qEAAiE;AACjE,6EAA6F;AAC7F,8CAAgC;AAChC,iEAA6D;AAC7D,iDAA6C;AAC7C,+CAAiD;AACjD,iDAAoD;AACpD,yDAA+D;AAC/D,6EAA8E;AAC9E,2DAA+D;AAC/D,oCAAyC;AAiCzC;;;GAGG;AACI,KAAK,UAAU,mBAAmB,CACvC,IAA6B;IAE7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;QAC3C,MAAM,gBAAgB,GAAG,MAAM,IAAA,qBAAY,EAAC,SAAS,CAAC,gBAAgB,EAAE;YACtE,aAAa,EAAE,IAAI;YACnB,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QACH,MAAM,wBAAwB,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAEhE,IAAI,CAAC,CAAC,MAAM,IAAA,eAAU,EAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC;YAClD,MAAM,IAAI,kBAAO,CAAC,qCAAqC,gBAAgB,EAAE,EAAE;gBACzE,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,EAAE,gBAAgB,EAAE;aAC9B,CAAC,CAAC;QACL,CAAC;QAED,yBAAyB;QACzB,MAAM,YAAY,GAAG,MAAM,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;QAEtE,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,kCAAe,CAAC,6BAA6B,gBAAgB,EAAE,EAAE;gBACzE,OAAO,EAAE,EAAE,gBAAgB,EAAE;aAC9B,CAAC,CAAC;QACL,CAAC;QAED,oBAAoB;QACpB,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAEtD,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,IAAI,wCAAkB,EAAE,CAAC;QAC1C,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAExD,iBAAiB;QACjB,MAAM,SAAS,GAAG,IAAI,gCAAc,EAAE,CAAC;QACvC,MAAM,gBAAgB,GAAG,SAAS,CAAC,QAAQ,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAElE,2CAA2C;QAC3C,IAAI,oBAAsD,CAAC;QAC3D,IAAI,SAAS,CAAC,eAAe,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,IAAI,wCAAkB,EAAE,CAAC;YAC1C,MAAM,WAAW,GAAyB,EAAE,CAAC;YAE7C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,MAAM,QAAQ,GAAG,QAAQ,CAAC,iBAAiB,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBAC3E,WAAW,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC;YAChC,CAAC;YAED,uBAAuB;YACvB,MAAM,aAAa,GAAG,SAAS,CAAC,aAAa,IAAI,GAAG,CAAC;YACrD,oBAAoB,GAAG,QAAQ,CAAC,kBAAkB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAE7C,gBAAgB;QAChB,OAAO;YACL,aAAa,EAAE,YAAY,CAAC,MAAM;YAClC,OAAO,EAAE,gBAAgB,CAAC,OAAO;YACjC,KAAK,EAAE,gBAAgB,CAAC,KAAK;YAC7B,SAAS,EAAE,cAAc,CAAC,SAAS;YACnC,MAAM,EAAE,cAAc,CAAC,MAAM;YAC7B,cAAc,EAAE,cAAc,CAAC,cAAc;YAC7C,YAAY,EAAE,cAAc,CAAC,YAAY;YACzC,oBAAoB,EAAE,oBAAoB,EAAE,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBACxD,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,MAAM,EAAE,GAAG,CAAC,MAAM;aACnB,CAAC,CAAC;YACH,MAAM,EAAE,gBAAgB,CAAC,MAAM;YAC/B,QAAQ,EAAE,gBAAgB,CAAC,QAAQ;YACnC,aAAa;SACd,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;QAC7C,IAAI,KAAK,YAAY,oCAAoB,EAAE,CAAC;YAC1C,OAAO;gBACL,aAAa,EAAE,CAAC;gBAChB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK;gBACZ,SAAS,EAAE,KAAK;gBAChB,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC;gBACvB,QAAQ,EAAE,EAAE;gBACZ,aAAa;aACd,CAAC;QACJ,CAAC;QACD,MAAM,YAAY,GAAG,sBAAY,CAAC,MAAM,CACtC,KAAK,EACL,uCAAuC,EACvC;YACE,MAAM,EAAE,4BAA4B;YACpC,IAAI,EAAE;gBACJ,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;gBACvC,eAAe,EAAE,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC;aAC/C;SACF,EACD;YACE,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,6BAA6B;SAC3C,CACF,CAAC;QACF,MAAM,WAAW,GAAG,sBAAY,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;QAC7D,MAAM,YAAY,GAAG,WAAW,CAAC,aAAa;YAC5C,CAAC,CAAC,GAAG,WAAW,CAAC,OAAO,mBAAmB,WAAW,CAAC,aAAa,GAAG;YACvE,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC;QACxB,OAAO;YACL,aAAa,EAAE,CAAC;YAChB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,KAAK;YACZ,SAAS,EAAE,KAAK;YAChB,MAAM,EAAE,CAAC,YAAY,CAAC;YACtB,QAAQ,EAAE,EAAE;YACZ,aAAa;SACd,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAAC,SAAiB;IAC/C,MAAM,YAAY,GAAa,EAAE,CAAC;IAElC,KAAK,UAAU,QAAQ,CAAC,GAAW;QACjC,MAAM,OAAO,GAAG,MAAM,aAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,MAAM,IAAA,qBAAY,EAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;gBAC9D,aAAa,EAAE,KAAK;aACrB,CAAC,CAAC;YAEH,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,gCAAgC;gBAChC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBACjE,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,oCAAoC;gBACpC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;oBAChE,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC9B,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC1B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,gBAAgB,CAAC,SAAmB;IACjD,MAAM,QAAQ,GAAoB,EAAE,CAAC;IAErC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,IAAA,qBAAY,EAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7E,MAAM,OAAO,GAAG,MAAM,aAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;YAC1D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAEvC,IAAI,CAAC,IAAA,qCAAe,EAAC,WAAW,CAAC,EAAE,CAAC;gBAClC,sBAAY,CAAC,MAAM,CACjB,IAAI,kCAAe,CAAC,8CAA8C,EAAE;oBAClE,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE;oBACpC,QAAQ,EAAE,SAAS;iBACpB,CAAC,EACF,yDAAyD,EACzD;oBACE,MAAM,EAAE,4BAA4B;oBACpC,IAAI,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE;iBAClC,EACD;oBACE,QAAQ,EAAE,SAAS;oBACnB,OAAO,EAAE,KAAK;oBACd,WAAW,EAAE,gBAAgB,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,gCAAgC;iBACrF,CACF,CAAC;gBACF,SAAS;YACX,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC,EAAE,GAAG,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,sBAAY,CAAC,MAAM,CACjB,KAAK,EACL,iDAAiD,EACjD;gBACE,MAAM,EAAE,4BAA4B;gBACpC,IAAI,EAAE,EAAE,QAAQ,EAAE;aACnB,EACD;gBACE,QAAQ,EAAE,SAAS;gBACnB,OAAO,EAAE,KAAK;gBACd,WAAW,EAAE,+BAA+B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;aACtE,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,MAAiC;IACpE,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,sCAAsC,CAAC,CAAC;IACnD,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;IACvD,KAAK,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACtD,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,eAAe,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC;IAE/D,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC;QACzD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxB,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;QAC7D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAC9C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;YACjC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,cAAc,EAAE,CAAC;QAC1B,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC/B,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,EAAE,EAAE;YAC3C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1D,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,IAAI,MAAM,CAAC,oBAAoB,IAAI,MAAM,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACrC,MAAM,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,iBAAiB,CAAC,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7F,KAAK,CAAC,IAAI,CAAC,eAAe,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACU,QAAA,mCAAmC,GAAG;IACjD,IAAI,EAAE,yBAAyB;IAC/B,WAAW,EACT,0KAA0K;IAC5K,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,gBAAgB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,yCAAyC,EAAE;YAC5F,eAAe,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,yCAAyC,EAAE;YAC5F,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;gBACV,WAAW,EAAE,8CAA8C;aAC5D;SACF;QACD,QAAQ,EAAE,CAAC,kBAAkB,CAAC;QAC9B,oBAAoB,EAAE,KAAK;KAC5B;CACO,CAAC;AAEX;;GAEG;AACU,QAAA,2CAA2C,GAAG;IACzD,GAAG,2CAAmC;IACtC,IAAI,EAAE,sBAAsB;IAC5B,WAAW,EACT,6FAA6F;CACvF,CAAC;AAEX;;GAEG;AACI,KAAK,UAAU,8BAA8B,CAClD,MAA+B;IAE/B,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC;QACvC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,eAAe,EAAE,MAAM,CAAC,eAAe;QACvC,aAAa,EAAE,MAAM,CAAC,aAAa;KACpC,CAAC,CAAC;IACH,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,6BAA6B,GAAG,OAAC;KACpC,MAAM,CAAC;IACN,gBAAgB,EAAE,IAAA,uCAAoB,EAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAC/D,eAAe,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACvC,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAC;KACD,MAAM,EAAE,CAAC;AAIZ,KAAK,UAAU,YAAY,CACzB,IAA6B;IAE7B,OAAO,IAAA,gCAAmB,EAAC,IAAI,EAAE,6BAA6B,CAAC,CAAC;AAClE,CAAC"}

package/dist/tools/cmos/agent-feedback.d.ts

@@ -0,0 +1,25 @@
+import type { CmosDatabaseClient } from './client';
+import type { SanitizedFieldReport } from './types';
+/** Context that follows the feedback row so triage can scope by sprint/session/mission. */
+export interface AgentFeedbackContext {
+    toolName: string;
+    sessionId?: string | null;
+    sprintId?: string | null;
+    missionId?: string | null;
+    projectId?: string | null;
+}
+export interface RecordAgentFeedbackResult {
+    feedbackId: number | null;
+    sanitizedFields: SanitizedFieldReport[];
+}
+/**
+ * Persist a single agentFeedback entry, sanitizing the body before write so
+ * corrupted XML markup cannot land in the feedback channel either.
+ *
+ * Returns `{feedbackId: null, sanitizedFields: []}` when the trimmed body is
+ * empty (the caller passed an empty string) — no row is written. All null
+ * context fields are persisted as NULL so the list/triage surface can group
+ * cleanly by tool even when session/sprint/mission context is missing.
+ */
+export declare function recordAgentFeedback(client: CmosDatabaseClient, body: string, context: AgentFeedbackContext): RecordAgentFeedbackResult;
+//# sourceMappingURL=agent-feedback.d.ts.map

package/dist/tools/cmos/agent-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-feedback.d.ts","sourceRoot":"","sources":["../../../src/tools/cmos/agent-feedback.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAGnD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEpD,2FAA2F;AAC3F,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,oBAAoB,EAAE,CAAC;CACzC;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,GAC5B,yBAAyB,CAyC3B"}