first commit

.github/copilot-instructions.md

@@ -0,0 +1,50 @@
+# Copilot Instructions for AI Coding Agents
+
+## Project Overview
+This is a TypeScript-based Discord bot project, organized for modularity and clarity. The bot is structured to support command handling, event listeners, web endpoints, and startup routines.
+
+## Architecture & Key Components
+- **src/**: Main source directory.
+  - **commands/**: Each file implements a bot command (e.g., `ping.ts`).
+  - **handlers/**: Contains logic for registering commands and startup routines.
+  - **listeners/**: Event-driven handlers for Discord events, organized by event type (e.g., `GuildMemberAdd`, `messageCreate`).
+  - **lib/**: Shared utilities for command registration and startup handler loading.
+  - **web/**: Web endpoints for bot-related actions (e.g., `gitCommit.ts`).
+  - **config.ts**: Central configuration file.
+  - **types.ts**: Project-specific type definitions.
+  - **webserver.ts**: Entry point for the web server.
+  - **index.ts**: Main bot entry point.
+
+## Developer Workflows
+- **Build & Run**: Use Node.js with `pnpm` for dependency management. Start the bot with `pnpm start` or `node src/index.ts`.
+- **Debugging**: Modular structure allows targeted debugging. Focus on the relevant handler or listener for the event/command.
+- **No tests or linting scripts**: If needed, add them to `package.json`.
+
+## Project Conventions
+- **Event listeners** are grouped by event type in subfolders under `listeners/`.
+- **Commands** are implemented as individual files in `commands/` and registered via `handlers/registerCommands.ts`.
+- **Startup routines** are in `handlers/startup/` and loaded via `lib/loadStartupHandlers.ts`.
+- **Web endpoints** are in `web/` and served by `webserver.ts`.
+- **Type definitions** are centralized in `types.ts`.
+- **Configuration** is managed in `config.ts`.
+
+## Integration & Communication
+- **Discord.js** (or similar) is assumed for bot interaction, though not explicitly shown.
+- **Webserver** integrates with bot logic via endpoints in `web/`.
+- **Command and event registration** is handled via utility files in `lib/` and `handlers/`.
+
+## Examples
+- To add a new command: Create a file in `commands/`, then ensure it's registered in `handlers/registerCommands.ts`.
+- To handle a new Discord event: Add a handler in the appropriate `listeners/<Event>/` folder.
+- To add a startup routine: Implement in `handlers/startup/` and register via `lib/loadStartupHandlers.ts`.
+
+## References
+- [src/index.ts](src/index.ts): Bot entry point
+- [src/webserver.ts](src/webserver.ts): Web server entry point
+- [src/handlers/registerCommands.ts](src/handlers/registerCommands.ts): Command registration
+- [src/lib/commandRegistry.ts](src/lib/commandRegistry.ts): Command registry utility
+- [src/listeners/messageCreate/logMessage.ts](src/listeners/messageCreate/logMessage.ts): Example event handler
+
+---
+
+**Review and update these instructions as the project evolves. If any section is unclear or incomplete, please provide feedback for improvement.**