refactor: migrate core config and routing to typescript

Author: MackDing

AGENTS.md

@@ -17,8 +17,9 @@
 
 ## Test Commands
 
-- `npm test`: run the full unit test suite with `node --test`.
-- `npm run check`: run a syntax check on the entrypoint and fail fast on invalid JS.
+- `npm test`: run the full unit test suite with the Node test runner plus `tsx`.
+- `npm run check`: run the repository typecheck gate.
+- `npm run typecheck`: run `tsc --noEmit` directly.
 - `npm run healthcheck`: run the local runtime health check.
 
 ## Lint And Format

README.md

@@ -87,7 +87,8 @@ npm run healthcheck
 
 - `npm run start` - start the bot
 - `npm run dev` - watch mode for local development
-- `npm run check` - syntax validation
+- `npm run check` - TypeScript-aware type and syntax validation for the mixed JS/TS codebase
+- `npm run typecheck` - run the TypeScript compiler in `--noEmit` mode
 - `npm run lint` - ESLint for source, tests, scripts, and local JS/CJS config files
 - `npm run lint:fix` - apply safe lint fixes
 - `npm run format` - format repository files with Prettier
@@ -102,7 +103,7 @@ npm run healthcheck
 ```text
 Telegram Message
   -> src/bot/handlers.js
-  -> src/orchestrator/router.js
+  -> src/orchestrator/router.ts
      -> src/runner/ptyManager.js        (coding tasks -> Codex CLI)
      -> src/orchestrator/skills/*.js    (general tasks -> MCP/GitHub subagents)
   -> src/bot/formatter.js
@@ -112,7 +113,7 @@ Telegram Message
 Core modules:
 
 - `src/index.js`: bootstrap and lifecycle
-- `src/config.js`: env parsing and validation
+- `src/config.ts`: env parsing and validation
 - `src/bot/`: auth middleware, formatting, command handlers
 - `src/orchestrator/`: routing + MCP client + skills
 - `src/runner/ptyManager.js`: Codex PTY process + streaming
@@ -153,8 +154,8 @@ How they are triggered:
 
 Where this happens:
 
-- Router decision order: [router.js](/Users/ding/Documents/Code/Github/codex-telegram-claws/src/orchestrator/router.js)
-- Skill toggles per chat: [skillRegistry.js](/Users/ding/Documents/Code/Github/codex-telegram-claws/src/orchestrator/skillRegistry.js)
+- Router decision order: [router.ts](/Users/ding/Documents/Code/Github/codex-telegram-claws/src/orchestrator/router.ts)
+- Skill toggles per chat: [skillRegistry.ts](/Users/ding/Documents/Code/Github/codex-telegram-claws/src/orchestrator/skillRegistry.ts)
 - Telegram command entrypoints: [handlers.js](/Users/ding/Documents/Code/Github/codex-telegram-claws/src/bot/handlers.js)
 
 Operationally, subagents are the bot's control plane. Codex remains the coding execution plane.

docs/enterprise-architecture.md

@@ -107,9 +107,9 @@ Implementation roadmap: [phase-1-roadmap.md](/Users/ding/Documents/Code/Github/c
 
 For enterprise rollout, migrate the following first:
 
-- `src/config.js`
-- `src/orchestrator/router.js`
-- `src/orchestrator/skillRegistry.js`
+- `src/config.ts`
+- `src/orchestrator/router.ts`
+- `src/orchestrator/skillRegistry.ts`
 - `src/orchestrator/mcpClient.js`
 - `src/runner/ptyManager.js`
 - `src/runner/shellManager.js`

docs/phase-1-roadmap.md

@@ -17,9 +17,9 @@ Phase 1 hardens the current single-host beta so it can be distributed to subsidi
 
 Scope:
 
-- Migrate `src/config.js`
-- Migrate `src/orchestrator/router.js`
-- Migrate `src/orchestrator/skillRegistry.js`
+- Migrate `src/config.ts`
+- Migrate `src/orchestrator/router.ts`
+- Migrate `src/orchestrator/skillRegistry.ts`
 - Migrate `src/orchestrator/mcpClient.js`
 - Migrate `src/runner/ptyManager.js`
 - Migrate `src/runner/shellManager.js`

eslint.config.js

@@ -1,4 +1,6 @@
 import js from "@eslint/js";
+import tsPlugin from "@typescript-eslint/eslint-plugin";
+import tsParser from "@typescript-eslint/parser";
 import globals from "globals";
 
 export default [
@@ -23,5 +25,26 @@ export default [
     rules: {
       "no-console": "off"
     }
+  },
+  {
+    files: ["**/*.ts"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: "latest",
+        sourceType: "module"
+      },
+      globals: {
+        ...globals.node
+      }
+    },
+    plugins: {
+      "@typescript-eslint": tsPlugin
+    },
+    rules: {
+      ...tsPlugin.configs.recommended.rules,
+      "no-console": "off",
+      "no-undef": "off"
+    }
   }
 ];