@cleocode/mcp-server 0.86.0

package/dist/domains/release.js

@@ -0,0 +1,400 @@
+/**
+ * Release Domain Handler
+ *
+ * Implements all 12 release operations for CLEO MCP server:
+ * - Query (3): version, verify, changelog
+ * - Mutate (9): bump, tag, publish, rollback, prepare, changelog, commit, push, gates.run
+ *
+ * Each operation maps to corresponding CLEO CLI commands with proper
+ * parameter validation and error handling.
+ *
+ * @task T2934
+ */
+/**
+ * Release domain handler implementation
+ */
+export class ReleaseHandler {
+    executor;
+    constructor(executor) {
+        this.executor = executor;
+    }
+    /**
+     * Query operations (read-only)
+     */
+    async query(operation, params) {
+        const startTime = Date.now();
+        // Require executor for all operations
+        if (!this.executor) {
+            return this.createErrorResponse('cleo_query', 'release', operation, 'E_NOT_INITIALIZED', 'Release handler not initialized with executor', startTime);
+        }
+        try {
+            switch (operation) {
+                case 'version':
+                    return await this.queryVersion(params);
+                case 'verify':
+                    return await this.queryVerify(params);
+                case 'changelog':
+                    return await this.queryChangelog(params);
+                default:
+                    return this.createErrorResponse('cleo_query', 'release', operation, 'E_INVALID_OPERATION', `Unknown query operation: ${operation}`, startTime);
+            }
+        }
+        catch (error) {
+            return this.handleError('cleo_query', 'release', operation, error, startTime);
+        }
+    }
+    /**
+     * Mutate operations (write)
+     */
+    async mutate(operation, params) {
+        const startTime = Date.now();
+        // Require executor for all operations
+        if (!this.executor) {
+            return this.createErrorResponse('cleo_mutate', 'release', operation, 'E_NOT_INITIALIZED', 'Release handler not initialized with executor', startTime);
+        }
+        try {
+            switch (operation) {
+                case 'bump':
+                    return await this.mutateBump(params);
+                case 'tag':
+                    return await this.mutateTag(params);
+                case 'publish':
+                    return await this.mutatePublish(params);
+                case 'rollback':
+                    return await this.mutateRollback(params);
+                case 'prepare':
+                    return await this.mutatePrepare(params);
+                case 'changelog':
+                    return await this.mutateChangelog(params);
+                case 'commit':
+                    return await this.mutateCommit(params);
+                case 'push':
+                    return await this.mutatePush(params);
+                case 'gates.run':
+                    return await this.mutateGatesRun(params);
+                default:
+                    return this.createErrorResponse('cleo_mutate', 'release', operation, 'E_INVALID_OPERATION', `Unknown mutate operation: ${operation}`, startTime);
+            }
+        }
+        catch (error) {
+            return this.handleError('cleo_mutate', 'release', operation, error, startTime);
+        }
+    }
+    /**
+     * Get supported operations
+     */
+    getSupportedOperations() {
+        return {
+            query: ['version', 'verify', 'changelog'],
+            mutate: ['bump', 'tag', 'publish', 'rollback', 'prepare', 'changelog', 'commit', 'push', 'gates.run'],
+        };
+    }
+    // ===== Query Operations =====
+    /**
+     * version - Get current version
+     * CLI: cleo version
+     */
+    async queryVersion(params) {
+        const startTime = Date.now();
+        const result = await this.executor.execute({
+            domain: 'version',
+            operation: '',
+            flags: { json: true },
+        });
+        return this.wrapExecutorResult(result, 'cleo_query', 'release', 'version', startTime);
+    }
+    /**
+     * verify - Verify version consistency
+     * CLI: ./dev/validate-version.sh
+     */
+    async queryVerify(params) {
+        const startTime = Date.now();
+        const result = await this.executor.execute({
+            domain: 'validate-version',
+            operation: '',
+            flags: { json: true },
+            customCommand: './dev/validate-version.sh',
+        });
+        return this.wrapExecutorResult(result, 'cleo_query', 'release', 'verify', startTime);
+    }
+    /**
+     * changelog - Get changelog content
+     * CLI: cat CHANGELOG.md
+     */
+    async queryChangelog(params) {
+        const startTime = Date.now();
+        if (!params?.version) {
+            return this.createErrorResponse('cleo_query', 'release', 'changelog', 'E_INVALID_INPUT', 'version is required', startTime);
+        }
+        const result = await this.executor.execute({
+            domain: 'changelog',
+            operation: '',
+            args: [params.version],
+            flags: { json: true },
+            customCommand: 'cat CHANGELOG.md',
+        });
+        return this.wrapExecutorResult(result, 'cleo_query', 'release', 'changelog', startTime);
+    }
+    // ===== Mutate Operations =====
+    /**
+     * bump - Bump version (patch/minor/major)
+     * CLI: ./dev/bump-version.sh <type>
+     */
+    async mutateBump(params) {
+        const startTime = Date.now();
+        if (!params?.type) {
+            return this.createErrorResponse('cleo_mutate', 'release', 'bump', 'E_INVALID_INPUT', 'type is required (patch, minor, or major)', startTime);
+        }
+        // Validate type
+        if (!['patch', 'minor', 'major'].includes(params.type)) {
+            return this.createErrorResponse('cleo_mutate', 'release', 'bump', 'E_INVALID_INPUT', `Invalid type: ${params.type}. Must be patch, minor, or major`, startTime);
+        }
+        const result = await this.executor.execute({
+            domain: 'bump-version',
+            operation: '',
+            args: [params.type],
+            flags: { json: true },
+            customCommand: './dev/bump-version.sh',
+        });
+        return this.wrapExecutorResult(result, 'cleo_mutate', 'release', 'bump', startTime);
+    }
+    /**
+     * tag - Create git tag
+     * CLI: git tag -a v<version> -m <message>
+     */
+    async mutateTag(params) {
+        const startTime = Date.now();
+        if (!params?.version) {
+            return this.createErrorResponse('cleo_mutate', 'release', 'tag', 'E_INVALID_INPUT', 'version is required', startTime);
+        }
+        const args = ['-a', `v${params.version}`, '-m', params.message || `Release v${params.version}`];
+        const result = await this.executor.execute({
+            domain: 'git',
+            operation: 'tag',
+            args,
+            flags: { json: true },
+            customCommand: 'git',
+        });
+        return this.wrapExecutorResult(result, 'cleo_mutate', 'release', 'tag', startTime);
+    }
+    /**
+     * publish - Publish release
+     * CLI: ./dev/release-version.sh <type> [--push]
+     */
+    async mutatePublish(params) {
+        const startTime = Date.now();
+        if (!params?.type) {
+            return this.createErrorResponse('cleo_mutate', 'release', 'publish', 'E_INVALID_INPUT', 'type is required (patch, minor, or major)', startTime);
+        }
+        // Validate type
+        if (!['patch', 'minor', 'major'].includes(params.type)) {
+            return this.createErrorResponse('cleo_mutate', 'release', 'publish', 'E_INVALID_INPUT', `Invalid type: ${params.type}. Must be patch, minor, or major`, startTime);
+        }
+        const args = [params.type];
+        const flags = { json: true };
+        if (params?.push) {
+            flags.push = true;
+        }
+        const result = await this.executor.execute({
+            domain: 'release-version',
+            operation: '',
+            args,
+            flags,
+            customCommand: './dev/release-version.sh',
+        });
+        return this.wrapExecutorResult(result, 'cleo_mutate', 'release', 'publish', startTime);
+    }
+    /**
+     * rollback - Rollback to previous version
+     * CLI: git tag -d v<version> && git push --delete origin v<version>
+     */
+    async mutateRollback(params) {
+        const startTime = Date.now();
+        if (!params?.version) {
+            return this.createErrorResponse('cleo_mutate', 'release', 'rollback', 'E_INVALID_INPUT', 'version is required', startTime);
+        }
+        if (!params?.reason) {
+            return this.createErrorResponse('cleo_mutate', 'release', 'rollback', 'E_INVALID_INPUT', 'reason is required', startTime);
+        }
+        // Delete local tag
+        await this.executor.execute({
+            domain: 'git',
+            operation: 'tag',
+            args: ['-d', `v${params.version}`],
+            customCommand: 'git',
+        });
+        // Delete remote tag
+        const result = await this.executor.execute({
+            domain: 'git',
+            operation: 'push',
+            args: ['--delete', 'origin', `v${params.version}`],
+            flags: { json: true },
+            customCommand: 'git',
+        });
+        return this.wrapExecutorResult(result, 'cleo_mutate', 'release', 'rollback', startTime);
+    }
+    // ===== New Mutate Operations =====
+    /**
+     * prepare - Prepare release (dry-run validation)
+     * CLI: ./dev/release-version.sh <type> --dry-run
+     */
+    async mutatePrepare(params) {
+        const startTime = Date.now();
+        if (!params?.version) {
+            return this.createErrorResponse('cleo_mutate', 'release', 'prepare', 'E_INVALID_INPUT', 'version is required', startTime);
+        }
+        const type = params.type || 'patch';
+        const result = await this.executor.execute({
+            domain: 'release-version',
+            operation: '',
+            args: [type],
+            flags: { json: true, 'dry-run': true },
+            customCommand: './dev/release-version.sh',
+        });
+        return this.wrapExecutorResult(result, 'cleo_mutate', 'release', 'prepare', startTime);
+    }
+    /**
+     * changelog (mutate) - Generate changelog
+     * CLI: scripts/generate-changelog.sh
+     */
+    async mutateChangelog(params) {
+        const startTime = Date.now();
+        if (!params?.version) {
+            return this.createErrorResponse('cleo_mutate', 'release', 'changelog', 'E_INVALID_INPUT', 'version is required', startTime);
+        }
+        const result = await this.executor.execute({
+            domain: 'generate-changelog',
+            operation: '',
+            args: [params.version],
+            flags: { json: true },
+            customCommand: './scripts/generate-changelog.sh',
+        });
+        return this.wrapExecutorResult(result, 'cleo_mutate', 'release', 'changelog', startTime);
+    }
+    /**
+     * commit - Create release commit
+     * CLI: git commit -m "chore: Release v<version>"
+     */
+    async mutateCommit(params) {
+        const startTime = Date.now();
+        if (!params?.version) {
+            return this.createErrorResponse('cleo_mutate', 'release', 'commit', 'E_INVALID_INPUT', 'version is required', startTime);
+        }
+        const message = `chore: Release v${params.version}`;
+        const args = ['-m', message];
+        if (params?.files && params.files.length > 0) {
+            // Stage specific files first
+            await this.executor.execute({
+                domain: 'git',
+                operation: 'add',
+                args: params.files,
+                customCommand: 'git',
+            });
+        }
+        const result = await this.executor.execute({
+            domain: 'git',
+            operation: 'commit',
+            args,
+            flags: { json: true },
+            customCommand: 'git',
+        });
+        return this.wrapExecutorResult(result, 'cleo_mutate', 'release', 'commit', startTime);
+    }
+    /**
+     * push - Push to remote with tags
+     * CLI: git push [<remote>] --follow-tags
+     */
+    async mutatePush(params) {
+        const startTime = Date.now();
+        if (!params?.version) {
+            return this.createErrorResponse('cleo_mutate', 'release', 'push', 'E_INVALID_INPUT', 'version is required', startTime);
+        }
+        const remote = params.remote || 'origin';
+        const args = [remote, '--follow-tags'];
+        const result = await this.executor.execute({
+            domain: 'git',
+            operation: 'push',
+            args,
+            flags: { json: true },
+            customCommand: 'git',
+        });
+        return this.wrapExecutorResult(result, 'cleo_mutate', 'release', 'push', startTime);
+    }
+    /**
+     * gates.run - Run release gates (tests, lint, security)
+     * CLI: Run test suite and validation checks
+     */
+    async mutateGatesRun(params) {
+        const startTime = Date.now();
+        const flags = { json: true };
+        if (params?.gates && params.gates.length > 0) {
+            flags.gates = params.gates.join(',');
+        }
+        const result = await this.executor.execute({
+            domain: 'release',
+            operation: 'gates',
+            flags,
+        });
+        return this.wrapExecutorResult(result, 'cleo_mutate', 'release', 'gates.run', startTime);
+    }
+    // ===== Helper Methods =====
+    /**
+     * Wrap executor result in DomainResponse format
+     */
+    wrapExecutorResult(result, gateway, domain, operation, startTime) {
+        const duration_ms = Date.now() - startTime;
+        if (result.success) {
+            return {
+                _meta: {
+                    gateway,
+                    domain,
+                    operation,
+                    version: '1.0.0',
+                    timestamp: new Date().toISOString(),
+                    duration_ms,
+                },
+                success: true,
+                data: result.data,
+            };
+        }
+        return {
+            _meta: {
+                gateway,
+                domain,
+                operation,
+                version: '1.0.0',
+                timestamp: new Date().toISOString(),
+                duration_ms,
+            },
+            success: false,
+            error: result.error,
+        };
+    }
+    /**
+     * Create error response
+     */
+    createErrorResponse(gateway, domain, operation, code, message, startTime) {
+        return {
+            _meta: {
+                gateway,
+                domain,
+                operation,
+                version: '1.0.0',
+                timestamp: new Date().toISOString(),
+                duration_ms: Date.now() - startTime,
+            },
+            success: false,
+            error: {
+                code,
+                message,
+            },
+        };
+    }
+    /**
+     * Handle unexpected errors
+     */
+    handleError(gateway, domain, operation, error, startTime) {
+        return this.createErrorResponse(gateway, domain, operation, 'E_INTERNAL_ERROR', error instanceof Error ? error.message : String(error), startTime);
+    }
+}
+//# sourceMappingURL=release.js.map

package/dist/domains/release.js.map

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

package/dist/domains/research.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Research Domain Handler
+ *
+ * Implements all 10 research operations for CLEO MCP server:
+ * - Query (5): list, stats, validate, search, export
+ * - Mutate (5): link, unlink, import, aggregate, report
+ *
+ * Maps to cleo research CLI commands with proper parameter validation.
+ *
+ * @task T2931
+ */
+import { DomainHandler, DomainResponse } from '../lib/router.js';
+import { CLIExecutor } from '../lib/executor.js';
+/**
+ * Research domain handler implementation
+ */
+export declare class ResearchHandler implements DomainHandler {
+    private executor;
+    private manifestReader;
+    constructor(executor: CLIExecutor, manifestPath?: string);
+    /**
+     * Query operations (read-only)
+     */
+    query(operation: string, params?: Record<string, unknown>): Promise<DomainResponse>;
+    /**
+     * Mutate operations (write)
+     */
+    mutate(operation: string, params?: Record<string, unknown>): Promise<DomainResponse>;
+    /**
+     * Get supported operations
+     */
+    getSupportedOperations(): {
+        query: string[];
+        mutate: string[];
+    };
+    /**
+     * list - List research entries
+     * CLI: cleo research list [--task <id>] [--status <status>] [--type <type>] [--topic <topic>] [--limit <n>] [--actionable]
+     */
+    private queryList;
+    /**
+     * stats - Research statistics
+     * CLI: cleo research stats [--epic <id>]
+     */
+    private queryStats;
+    /**
+     * validate - Validate research links
+     * CLI: cleo research validate <taskId>
+     */
+    private queryValidate;
+    /**
+     * search - Search research entries
+     * CLI: cleo research show <query> [--confidence <n>] [--limit <n>]
+     */
+    private querySearch;
+    /**
+     * export - Export research data
+     * CLI: cleo research export [--format <fmt>] [--status <status>] [--type <type>]
+     */
+    private queryExport;
+    /**
+     * manifest.read - Read manifest entries
+     * Direct: ManifestReader (not CLI)
+     */
+    private queryManifestRead;
+    /**
+     * manifest.validate - Validate manifest integrity
+     * Direct: ManifestReader (not CLI)
+     */
+    private queryManifestValidate;
+    /**
+     * manifest.summary - Get manifest statistics
+     * Direct: ManifestReader (not CLI)
+     */
+    private queryManifestSummary;
+    /**
+     * link - Link research to task
+     * CLI: cleo research link <taskId> <researchId> [--notes <text>]
+     */
+    private mutateLink;
+    /**
+     * unlink - Unlink research from task
+     * CLI: cleo research unlink <taskId> <researchId>
+     */
+    private mutateUnlink;
+    /**
+     * import - Import research data
+     * CLI: cleo research import <source> [--overwrite]
+     */
+    private mutateImport;
+    /**
+     * aggregate - Aggregate research findings
+     * CLI: cleo research aggregate <id1> <id2> ... [--output <file>]
+     */
+    private mutateAggregate;
+    /**
+     * report - Generate research report
+     * CLI: cleo research report [--epic <id>] [--format <fmt>] [--include-links]
+     */
+    private mutateReport;
+    /**
+     * show - Get research entry details
+     * CLI: cleo research show <researchId>
+     */
+    private queryShow;
+    /**
+     * pending - Get pending research items
+     * CLI: cleo research pending [--epicId <id>]
+     */
+    private queryPending;
+    /**
+     * inject - Get protocol injection content
+     * CLI: cleo research inject <protocolType> [--taskId <id>] [--variant <variant>]
+     */
+    private mutateInject;
+    /**
+     * manifest.append - Append entry to MANIFEST.jsonl
+     * Direct: Validates and appends to manifest file
+     */
+    private mutateManifestAppend;
+    /**
+     * manifest.archive - Archive old manifest entries
+     * Direct: Reads manifest, filters by date, writes archived entries
+     */
+    private mutateManifestArchive;
+    /**
+     * Wrap executor result in DomainResponse format
+     */
+    private wrapExecutorResult;
+    /**
+     * Create error response
+     */
+    private createErrorResponse;
+    /**
+     * Handle unexpected errors
+     */
+    private handleError;
+}
+//# sourceMappingURL=research.d.ts.map

package/dist/domains/research.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research.d.ts","sourceRoot":"","sources":["../../src/domains/research.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAyHjD;;GAEG;AACH,qBAAa,eAAgB,YAAW,aAAa;IAIjD,OAAO,CAAC,QAAQ;IAHlB,OAAO,CAAC,cAAc,CAAiB;gBAG7B,QAAQ,EAAE,WAAW,EAC7B,YAAY,GAAE,MAAkD;IAKlE;;OAEG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IA0CzF;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAoC1F;;OAEG;IACH,sBAAsB,IAAI;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAS/D;;;OAGG;YACW,SAAS;IAqBvB;;;OAGG;YACW,UAAU;IAexB;;;OAGG;YACW,aAAa;IAwB3B;;;OAGG;YACW,WAAW;IA4BzB;;;OAGG;YACW,WAAW;IAiBzB;;;OAGG;YACW,iBAAiB;IAqC/B;;;OAGG;YACW,qBAAqB;IA8BnC;;;OAGG;YACW,oBAAoB;IAgClC;;;OAGG;YACW,UAAU;IA2BxB;;;OAGG;YACW,YAAY;IAwB1B;;;OAGG;YACW,YAAY;IA2B1B;;;OAGG;YACW,eAAe;IA2B7B;;;OAGG;YACW,YAAY;IAiB1B;;;OAGG;YACW,SAAS;IAwBvB;;;OAGG;YACW,YAAY;IAe1B;;;OAGG;YACW,YAAY;IA4B1B;;;OAGG;YACW,oBAAoB;IAiElC;;;OAGG;YACW,qBAAqB;IAgFnC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsC1B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyB3B;;OAEG;IACH,OAAO,CAAC,WAAW;CAgBpB"}