feat: typescript migration (#40)

* chore: initialize TypeScript configuration and build setup

- Add tsconfig.json for root and mcp-server with strict type checking
- Install typescript and @types/node as devDependencies
- Add npm build script for TypeScript compilation
- Update main entrypoint to compiled dist/shannon.js
- Update Dockerfile to build TypeScript before running
- Configure output directory and module resolution for Node.js

* refactor: migrate codebase from JavaScript to TypeScript

- Convert all 37 JavaScript files to TypeScript (.js -> .ts)
- Add type definitions in src/types/ for agents, config, errors, session
- Update mcp-server with proper TypeScript types
- Move entry point from shannon.mjs to src/shannon.ts
- Update tsconfig.json with rootDir: "./src" for cleaner dist output
- Update Dockerfile to build TypeScript before runtime
- Update package.json paths to use compiled dist/shannon.js

No runtime behavior changes - pure type safety migration.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* docs: update CLI references from ./shannon.mjs to shannon

- Update help text in src/cli/ui.ts
- Update usage examples in src/cli/command-handler.ts
- Update setup message in src/shannon.ts
- Update CLAUDE.md documentation with TypeScript file structure
- Replace all ./shannon.mjs references with shannon command

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* chore: remove unnecessary eslint-disable comments

ESLint is not configured in this project, making these comments redundant.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

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

@@ -10,60 +10,50 @@
  * 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]
- */
+import type { ErrorResponse } from '../types/tool-responses.js';
 
 /**
  * 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) {
+export function createValidationError(
+  message: string,
+  retryable: boolean = true,
+  context?: Record<string, unknown>
+): ErrorResponse {
   return {
     status: 'error',
     message,
     errorType: 'ValidationError',
     retryable,
-    context,
+    ...(context !== undefined && { 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) {
+export function createCryptoError(
+  message: string,
+  retryable: boolean = false,
+  context?: Record<string, unknown>
+): ErrorResponse {
   return {
     status: 'error',
     message,
     errorType: 'CryptoError',
     retryable,
-    context,
+    ...(context !== undefined && { 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) {
+export function createGenericError(
+  error: unknown,
+  retryable: boolean = false,
+  context?: Record<string, unknown>
+): ErrorResponse {
   const message = error instanceof Error ? error.message : String(error);
   const errorType = error instanceof Error ? error.constructor.name : 'UnknownError';
 
@@ -72,6 +62,6 @@ export function createGenericError(error, retryable = false, context) {
     message,
     errorType,
     retryable,
-    context,
+    ...(context !== undefined && { context }),
   };
 }

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

@@ -14,14 +14,14 @@
 import { writeFileSync, mkdirSync } from 'fs';
 import { join } from 'path';
 
+declare global {
+  var __SHANNON_TARGET_DIR: string | undefined;
+}
+
 /**
  * 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) {
+export function saveDeliverableFile(filename: string, content: string): string {
   // Use target directory from global context (set by createShannonHelperServer)
   const targetDir = global.__SHANNON_TARGET_DIR || process.cwd();
   const deliverablesDir = join(targetDir, 'deliverables');
@@ -30,7 +30,7 @@ export function saveDeliverableFile(filename, content) {
   // Ensure deliverables directory exists
   try {
     mkdirSync(deliverablesDir, { recursive: true });
-  } catch (error) {
+  } catch {
     // Directory might already exist, ignore
   }