feat: migrate to use MCP tools instead of helper scripts

mcp-server/src/utils/error-formatter.js

@@ -0,0 +1,89 @@
+/**
+ * Error Formatting Utilities
+ *
+ * Helper functions for creating structured error responses.
+ */
+
+/**
+ * @typedef {Object} ErrorResponse
+ * @property {'error'} status
+ * @property {string} message
+ * @property {string} errorType
+ * @property {boolean} retryable
+ * @property {Record<string, unknown>} [context]
+ */
+
+/**
+ * Create a validation error response
+ *
+ * @param {string} message
+ * @param {boolean} [retryable=true]
+ * @param {Record<string, unknown>} [context]
+ * @returns {ErrorResponse}
+ */
+export function createValidationError(message, retryable = true, context) {
+  return {
+    status: 'error',
+    message,
+    errorType: 'ValidationError',
+    retryable,
+    context,
+  };
+}
+
+/**
+ * Create a file system error response
+ *
+ * @param {string} message
+ * @param {boolean} [retryable=false]
+ * @param {Record<string, unknown>} [context]
+ * @returns {ErrorResponse}
+ */
+export function createFileSystemError(message, retryable = false, context) {
+  return {
+    status: 'error',
+    message,
+    errorType: 'FileSystemError',
+    retryable,
+    context,
+  };
+}
+
+/**
+ * Create a crypto error response
+ *
+ * @param {string} message
+ * @param {boolean} [retryable=false]
+ * @param {Record<string, unknown>} [context]
+ * @returns {ErrorResponse}
+ */
+export function createCryptoError(message, retryable = false, context) {
+  return {
+    status: 'error',
+    message,
+    errorType: 'CryptoError',
+    retryable,
+    context,
+  };
+}
+
+/**
+ * Create a generic error response
+ *
+ * @param {unknown} error
+ * @param {boolean} [retryable=false]
+ * @param {Record<string, unknown>} [context]
+ * @returns {ErrorResponse}
+ */
+export function createGenericError(error, retryable = false, context) {
+  const message = error instanceof Error ? error.message : String(error);
+  const errorType = error instanceof Error ? error.constructor.name : 'UnknownError';
+
+  return {
+    status: 'error',
+    message,
+    errorType,
+    retryable,
+    context,
+  };
+}

mcp-server/src/utils/file-operations.js

@@ -0,0 +1,35 @@
+/**
+ * File Operations Utilities
+ *
+ * Handles file system operations for deliverable saving.
+ * Ported from tools/save_deliverable.js (lines 117-130).
+ */
+
+import { writeFileSync, mkdirSync } from 'fs';
+import { join } from 'path';
+
+/**
+ * Save deliverable file to deliverables/ directory
+ *
+ * @param {string} filename - Name of the file to save
+ * @param {string} content - Content to write to the file
+ * @returns {string} Full path to the saved file
+ */
+export function saveDeliverableFile(filename, content) {
+  // Use target directory from global context (set by createShannonHelperServer)
+  const targetDir = global.__SHANNON_TARGET_DIR || process.cwd();
+  const deliverablesDir = join(targetDir, 'deliverables');
+  const filepath = join(deliverablesDir, filename);
+
+  // Ensure deliverables directory exists
+  try {
+    mkdirSync(deliverablesDir, { recursive: true });
+  } catch (error) {
+    // Directory might already exist, ignore
+  }
+
+  // Write file (atomic write - single operation)
+  writeFileSync(filepath, content, 'utf8');
+
+  return filepath;
+}

mcp-server/src/utils/index.js

@@ -0,0 +1,6 @@
+/**
+ * Utilities barrel export
+ */
+
+export * from './file-operations.js';
+export * from './error-formatter.js';