@aquex/cmos-mcp 1.0.0

package/dist/tools/cmos/tier-config.js

@@ -0,0 +1,123 @@
+"use strict";
+/**
+ * Tier Config Loader
+ *
+ * Reads and parses tier configuration files from cmos/tiers/{tierName}.md.
+ * Returns structured frontmatter + prose body for injection into onboard payload.
+ *
+ * @module tools/cmos/tier-config
+ */
+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.loadTierConfig = loadTierConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml_1 = require("yaml");
+/**
+ * Load a tier config from cmos/tiers/{tierName}.md.
+ *
+ * Parses YAML frontmatter for structured fields and returns the prose body as guide.
+ * Falls back to build.md if the requested tier file doesn't exist.
+ *
+ * @param tierName - 'general', 'managed', or 'build'
+ * @param serverRoot - Root directory of the server (defaults to __dirname/../../..)
+ * @returns Parsed tier config or null if even fallback fails
+ */
+function loadTierConfig(tierName, serverRoot) {
+    const root = serverRoot ?? path.resolve(__dirname, '../../..');
+    const tiersDir = path.join(root, 'cmos', 'tiers');
+    let filePath = path.join(tiersDir, `${tierName}.md`);
+    // Fall back to build.md if requested file doesn't exist
+    if (!fs.existsSync(filePath)) {
+        filePath = path.join(tiersDir, 'build.md');
+        if (!fs.existsSync(filePath)) {
+            return null;
+        }
+    }
+    try {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        return parseTierFile(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parse a tier config file with YAML frontmatter.
+ */
+function parseTierFile(content) {
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!frontmatterMatch) {
+        return {
+            tier: 'build',
+            label: 'Build',
+            description: '',
+            toolsUse: [],
+            toolsSkip: [],
+            vocabulary: {},
+            sessionTypes: [],
+            onboardFieldsShow: [],
+            onboardFieldsHide: [],
+            guide: content.trim(),
+        };
+    }
+    const yamlStr = frontmatterMatch[1];
+    const prose = frontmatterMatch[2].trim();
+    const fm = (0, yaml_1.parse)(yamlStr);
+    // Normalize vocabulary: YAML null (~) stays null, strings pass through
+    const rawVocab = (fm.vocabulary ?? {});
+    const vocabulary = {};
+    for (const [key, value] of Object.entries(rawVocab)) {
+        vocabulary[key] = value == null ? null : String(value);
+    }
+    return {
+        tier: String(fm.tier ?? 'build'),
+        label: String(fm.label ?? 'Build'),
+        description: String(fm.description ?? ''),
+        toolsUse: toStringArray(fm.tools_use),
+        toolsSkip: toStringArray(fm.tools_skip),
+        vocabulary,
+        sessionTypes: toStringArray(fm.session_types),
+        onboardFieldsShow: toStringArray(fm.onboard_fields_show),
+        onboardFieldsHide: toStringArray(fm.onboard_fields_hide),
+        guide: prose,
+    };
+}
+function toStringArray(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.map(String);
+}
+//# sourceMappingURL=tier-config.js.map

package/dist/tools/cmos/tier-config.js.map

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

package/dist/tools/cmos/types.d.ts

@@ -0,0 +1,164 @@
+/**
+ * CMOS Tool Types
+ *
+ * Shared type definitions for all CMOS MCP tools.
+ * All tools return CmosToolResult<T> for consistent agent-friendly responses.
+ *
+ * @module tools/cmos/types
+ */
+/**
+ * Structured error response for CMOS tools.
+ * Designed to be actionable - agents can self-correct from these errors.
+ */
+export interface CmosToolError {
+    /** Machine-readable error code (e.g., 'MISSION_NOT_FOUND', 'INVALID_STATE') */
+    code: string;
+    /** Human-readable explanation of what went wrong */
+    message: string;
+    /** Actionable suggestion for how to fix the error */
+    suggestion?: string;
+    /** For validation errors: list of valid values the agent can use */
+    validValues?: string[];
+    /** For consolidated action tools: list of valid actions */
+    availableActions?: string[];
+    /** Snake_case alias for MCP-facing structured content compatibility */
+    available_actions?: string[];
+    /** For state errors: the current state that caused the error */
+    currentState?: string;
+    /** For state errors: valid transitions from current state */
+    validTransitions?: string[];
+    /** Field that caused the error (for validation errors) */
+    field?: string;
+    /** Value that was provided (for validation errors) */
+    providedValue?: unknown;
+    /** Additional diagnostic context for debugging or remediation */
+    details?: string;
+    /** Processing phase where the failure occurred */
+    phase?: string;
+    /** Specific operation that failed within a phase */
+    operation?: string;
+}
+/**
+ * One sanitized field entry surfaced on a tool response.
+ * Sprint 56 m02: CMOS write-path handlers scan free-text fields for XML
+ * marshalling artifacts and strip-and-surface when detected, so the caller
+ * can tell which field was altered and why.
+ */
+export interface SanitizedFieldReport {
+    /** The field name (or array path like `decisions[2]`) that was sanitized. */
+    field: string;
+    /** Short human-readable explanation of what was stripped. */
+    reason: string;
+}
+/**
+ * Standard result type for all CMOS tools.
+ * Follows the pattern: { success: boolean, data?: T, error?: CmosToolError }
+ *
+ * @template T - The type of data returned on success
+ */
+export interface CmosToolResult<T = unknown> {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** The result data (present when success is true) */
+    data?: T;
+    /** Error details (present when success is false) */
+    error?: CmosToolError;
+    /** Optional warnings that don't prevent success but should be noted */
+    warnings?: string[];
+    /** Per-field entries for free-text fields that were sanitized on write. */
+    sanitizedFields?: SanitizedFieldReport[];
+}
+/**
+ * Mission status values as stored in the database.
+ */
+export type MissionStatus = 'Queued' | 'Current' | 'In Progress' | 'Completed' | 'Blocked' | 'Dropped' | 'Deferred';
+/**
+ * Mission record from the database.
+ */
+export interface Mission {
+    id: string;
+    sprint_id: string | null;
+    name: string;
+    status: MissionStatus;
+    completed_at: string | null;
+    notes: string | null;
+    objective: string | null;
+    context: string | null;
+    success_criteria: string | null;
+    deliverables: string | null;
+    reference_docs: string | null;
+    domain_fields: string | null;
+    metadata: string | null;
+}
+/**
+ * Sprint record from the database.
+ */
+export interface Sprint {
+    id: string;
+    title: string;
+    focus: string | null;
+    status: string | null;
+    start_date: string | null;
+    end_date: string | null;
+    total_missions: number | null;
+    completed_missions: number | null;
+}
+/**
+ * Context record from the database.
+ */
+export interface Context {
+    id: string;
+    source_path: string;
+    content: string;
+    updated_at: string | null;
+}
+/**
+ * Session record from the database.
+ */
+export interface Session {
+    id: string;
+    type: string;
+    title: string;
+    sprint_id: string | null;
+    started_at: string;
+    completed_at: string | null;
+    agent: string;
+    summary: string | null;
+    status: string;
+    captures: string | null;
+    next_steps: string | null;
+    metadata: string | null;
+}
+/**
+ * Database health check result.
+ */
+export interface DbHealthResult {
+    connected: boolean;
+    version: string;
+    path: string;
+    tables: string[];
+    missionCount: number;
+    sessionCount: number;
+    contextCount: number;
+}
+/**
+ * Mission list query parameters.
+ */
+export interface MissionListParams {
+    status?: MissionStatus;
+    sprintId?: string;
+    limit?: number;
+    includeDeleted?: boolean;
+}
+/**
+ * Mission state transition event.
+ */
+export interface MissionStateChange {
+    missionId: string;
+    fromStatus: MissionStatus | null;
+    toStatus: MissionStatus;
+    changedAt: string;
+    changedBy: string;
+    notes?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tools/cmos/types.d.ts.map

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

package/dist/tools/cmos/types.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * CMOS Tool Types
+ *
+ * Shared type definitions for all CMOS MCP tools.
+ * All tools return CmosToolResult<T> for consistent agent-friendly responses.
+ *
+ * @module tools/cmos/types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/tools/cmos/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tools/cmos/types.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG"}

package/dist/tools/combine-packs.d.ts

@@ -0,0 +1,194 @@
+/**
+ * combine_packs MCP Tool
+ *
+ * Combines multiple domain packs into a single cohesive pack with
+ * dependency resolution and merge strategy support.
+ *
+ * Algorithm:
+ * 1. Validate input pack names
+ * 2. Load packs from registry
+ * 3. Resolve dependencies
+ * 4. Combine using specified strategy
+ * 5. Return combined pack as YAML
+ *
+ * @module tools/combine-packs
+ */
+import { SecureYAMLLoader } from '../loaders/yaml-loader';
+import { RegistryParser } from '../registry/registry-parser';
+import { DomainPackLoader } from '../domains/domain-pack-loader';
+import { PackCombiner } from '../combination/pack-combiner';
+import { CombinationStrategy } from '../combination/types';
+/**
+ * Parameters for combine_packs tool
+ */
+export interface CombinePacksParams {
+    /** Array of pack names to combine (required) */
+    packNames: string[];
+    /** Merge strategy to use (default: 'deep-merge') */
+    strategy?: CombinationStrategy;
+    /** For 'selective' strategy: paths to override */
+    overridePaths?: string[];
+    /** For 'selective' strategy: paths to merge */
+    mergePaths?: string[];
+    /** Whether to resolve dependencies automatically (default: true) */
+    resolveDependencies?: boolean;
+    /** Output format (default: 'yaml') */
+    format?: 'yaml' | 'json';
+}
+/**
+ * MCP Tool Definition for creating combined packs
+ */
+export declare const createCombinedPackToolDefinition: {
+    readonly name: "create_combined_pack";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["packNames"];
+        readonly properties: {
+            readonly packNames: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly minItems: 1;
+                readonly description: "Array of domain pack names to combine (use get_available_domains to see options)";
+            };
+            readonly strategy: {
+                readonly type: "string";
+                readonly enum: readonly ["deep-merge", "override", "selective"];
+                readonly default: "deep-merge";
+                readonly description: "Merge strategy: \"deep-merge\" (recursive merge), \"override\" (last wins), or \"selective\" (user-controlled)";
+            };
+            readonly overridePaths: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "For selective strategy: field paths to override (e.g., [\"spec.resources\"])";
+            };
+            readonly mergePaths: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "For selective strategy: field paths to merge (e.g., [\"spec.dependencies\"])";
+            };
+            readonly resolveDependencies: {
+                readonly type: "boolean";
+                readonly default: true;
+                readonly description: "Whether to automatically resolve and include dependencies";
+            };
+            readonly format: {
+                readonly type: "string";
+                readonly enum: readonly ["yaml", "json"];
+                readonly default: "yaml";
+                readonly description: "Output format for the combined pack";
+            };
+        };
+    };
+};
+/**
+ * Legacy alias maintained for one release cycle
+ */
+export declare const combinePacksToolDefinitionDeprecated: {
+    readonly name: "combine_packs";
+    readonly description: "[DEPRECATED] Use create_combined_pack instead. Provides the same multi-pack combination workflow.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["packNames"];
+        readonly properties: {
+            readonly packNames: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly minItems: 1;
+                readonly description: "Array of domain pack names to combine (use get_available_domains to see options)";
+            };
+            readonly strategy: {
+                readonly type: "string";
+                readonly enum: readonly ["deep-merge", "override", "selective"];
+                readonly default: "deep-merge";
+                readonly description: "Merge strategy: \"deep-merge\" (recursive merge), \"override\" (last wins), or \"selective\" (user-controlled)";
+            };
+            readonly overridePaths: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "For selective strategy: field paths to override (e.g., [\"spec.resources\"])";
+            };
+            readonly mergePaths: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "For selective strategy: field paths to merge (e.g., [\"spec.dependencies\"])";
+            };
+            readonly resolveDependencies: {
+                readonly type: "boolean";
+                readonly default: true;
+                readonly description: "Whether to automatically resolve and include dependencies";
+            };
+            readonly format: {
+                readonly type: "string";
+                readonly enum: readonly ["yaml", "json"];
+                readonly default: "yaml";
+                readonly description: "Output format for the combined pack";
+            };
+        };
+    };
+};
+/**
+ * CombinePacksToolImpl
+ *
+ * Main implementation class for pack combination
+ */
+export declare class CombinePacksToolImpl {
+    private packLoader;
+    private combiner;
+    private registry;
+    private loader;
+    constructor(packLoader: DomainPackLoader, combiner: PackCombiner, registry: RegistryParser, loader: SecureYAMLLoader);
+    /**
+     * Execute the combine_packs tool
+     *
+     * @param params - Tool parameters
+     * @param registryPath - Path to domain pack registry
+     * @returns Combined pack as formatted string with metadata
+     */
+    execute(params: CombinePacksParams, registryPath: string): Promise<{
+        success: boolean;
+        combinedPack?: string;
+        loadOrder?: string[];
+        errors?: string[];
+        warnings?: string[];
+    }>;
+    /**
+     * Preview pack combination without executing
+     *
+     * @param params - Tool parameters
+     * @param registryPath - Path to domain pack registry
+     * @returns Preview information
+     */
+    preview(params: CombinePacksParams, registryPath: string): Promise<{
+        success: boolean;
+        loadOrder?: string[];
+        dependencies?: string[];
+        warnings?: string[];
+        errors?: string[];
+    }>;
+    /**
+     * Format combined pack as YAML or JSON
+     */
+    private formatOutput;
+}
+/**
+ * Factory function to create tool instance
+ */
+export declare function createCombinePacksTool(packLoader: DomainPackLoader, registry: RegistryParser, loader: SecureYAMLLoader): CombinePacksToolImpl;
+/**
+ * Tool handler function for MCP server integration
+ */
+export declare function handleCombinePacks(params: CombinePacksParams, registryPath: string, packLoader: DomainPackLoader, registry: RegistryParser, loader: SecureYAMLLoader): Promise<string>;
+//# sourceMappingURL=combine-packs.d.ts.map

package/dist/tools/combine-packs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combine-packs.d.ts","sourceRoot":"","sources":["../../src/tools/combine-packs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAgB,MAAM,sBAAsB,CAAC;AAGzE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,gDAAgD;IAChD,SAAS,EAAE,MAAM,EAAE,CAAC;IAEpB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAE/B,kDAAkD;IAClD,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB,oEAAoE;IACpE,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+CnC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,oCAAoC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAKvC,CAAC;AAEX;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,MAAM,CAAmB;gBAG/B,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,YAAY,EACtB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,gBAAgB;IAQ1B;;;;;;OAMG;IACG,OAAO,CACX,MAAM,EAAE,kBAAkB,EAC1B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;IA4EF;;;;;;OAMG;IACG,OAAO,CACX,MAAM,EAAE,kBAAkB,EAC1B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;QACT,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IAwCF;;OAEG;IACH,OAAO,CAAC,YAAY;CASrB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,gBAAgB,GACvB,oBAAoB,CAGtB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,gBAAgB,EAC5B,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,MAAM,CAAC,CAiCjB"}