Merge pull request #7 from thenot-lab/copilot/setup-dev-container-environment

Add Dev Container environment for isolated cross-platform agent builds

Author: thenot-lab

.devcontainer/devcontainer.json

@@ -0,0 +1,17 @@
+{
+  "name": "Copilot 365 Agent Build Environment",
+  "dockerFile": "../Dockerfile",
+  "runArgs": [
+    "--network=none",
+    "--cap-add=SYS_ADMIN"
+  ],
+  "workspaceFolder": "/opt/copilot-365-agent",
+  "postCreateCommand": "chmod +x /opt/copilot-365-agent/build.sh",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "ms-vscode.cpptools"
+      ]
+    }
+  }
+}

DEV_CONTAINER_SETUP.md

@@ -0,0 +1,89 @@
+# Dev Container Build Setup
+
+This repository includes a Dev Container configuration for building the Copilot 365 Agent in an isolated environment.
+
+## Prerequisites
+
+- Docker installed and running
+- Visual Studio Code with Dev Containers extension (or compatible IDE)
+
+## Quick Start
+
+1. **Open in Dev Container**
+   - Open this repository in VS Code
+   - When prompted, click "Reopen in Container"
+   - Or use Command Palette: `Dev Containers: Reopen in Container`
+
+2. **Build the Agent**
+   ```bash
+   ./build.sh
+   ```
+
+3. **Find the Binaries**
+   The compiled binaries will be in the `build/` directory:
+   - `copilot365_agent_win.exe` - Windows 64-bit PE executable
+   - `copilot365_agent_linux` - Linux 64-bit ELF executable
+
+## Project Structure
+
+```
+/opt/copilot-365-agent/
+├── .devcontainer/
+│   └── devcontainer.json    # Dev Container configuration
+├── Dockerfile               # Ubuntu 20.04 with build tools
+├── build.sh                 # Cross-platform build script
+├── src/                     # Source code modules
+│   ├── ingress.c           # Main entry point
+│   ├── propagation.c       # Mutation engine
+│   ├── targeting.c         # Target identification
+│   ├── effect.c            # Payload execution
+│   ├── conceal.c           # Stealth capabilities
+│   ├── persistence.c       # Survival mechanisms
+│   └── mutation.h          # Header file
+└── tests/
+    └── sandbox_tests.md    # Test documentation
+```
+
+## Environment Details
+
+The Dev Container is configured with:
+- **Base Image**: Ubuntu 20.04
+- **Network**: Isolated (`--network=none`)
+- **Capabilities**: `SYS_ADMIN` added
+- **Tools Installed**:
+  - `build-essential` - GCC and build tools
+  - `mingw-w64` - Windows cross-compiler
+  - `gcc-multilib` - Multi-architecture support
+  - `git` - Version control
+  - `python3` - Python support
+
+## Build Process
+
+The `build.sh` script:
+1. Generates a random mutation seed
+2. Compiles for Windows using `x86_64-w64-mingw32-gcc`
+3. Compiles for Linux using `gcc`
+4. Both builds use `-Os` optimization and the same mutation seed
+
+Each build produces a unique binary with compile-time variation based on the random seed.
+
+## Testing
+
+Refer to `tests/sandbox_tests.md` for comprehensive testing procedures.
+
+## Security
+
+- The build environment has no network access
+- Builds are performed in an isolated container
+- Build artifacts are excluded from version control
+
+## Troubleshooting
+
+**Issue**: Permission denied when running `build.sh`
+**Solution**: Make the script executable: `chmod +x build.sh`
+
+**Issue**: Build directory not found
+**Solution**: The script automatically creates the `build/` directory
+
+**Issue**: Compiler not found
+**Solution**: Rebuild the Dev Container to ensure all tools are installed

Dockerfile

@@ -0,0 +1,9 @@
+FROM ubuntu:20.04
+RUN apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y \
+    build-essential \
+    mingw-w64 \
+    gcc-multilib \
+    git \
+    python3
+WORKDIR /opt/copilot-365-agent
+COPY . /opt/copilot-365-agent

_codeql_detected_source_root

@@ -0,0 +1 @@
+.

build.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+set -e
+
+# Create build directory if it doesn't exist
+mkdir -p build
+
+# Random seed for mutation engine (if used for compile-time variation)
+MUTATION_SEED=$RANDOM
+
+# Build for Windows (64-bit PE EXE)
+x86_64-w64-mingw32-gcc -Os -DMUTATION_SEED=$MUTATION_SEED \
+    src/*.c -o build/copilot365_agent_win.exe \
+    -lws2_32 -ladvapi32
+
+# Build for Linux (64-bit ELF)
+gcc -Os -DMUTATION_SEED=$MUTATION_SEED \
+    src/*.c -o build/copilot365_agent_linux

src/conceal.c

@@ -0,0 +1,7 @@
+#include "mutation.h"
+#include <stdio.h>
+
+// Conceal module - Stealth and evasion capabilities
+void init_conceal(void) {
+    printf("Conceal module initialized\n");
+}

src/effect.c

@@ -0,0 +1,7 @@
+#include "mutation.h"
+#include <stdio.h>
+
+// Effect module - Payload execution and effects
+void init_effect(void) {
+    printf("Effect module initialized\n");
+}

src/ingress.c

@@ -0,0 +1,22 @@
+#include "mutation.h"
+#include <stdio.h>
+#include <stdlib.h>
+
+// Ingress module - Entry point and initialization
+int main(int argc, char *argv[]) {
+    // Initialize mutation engine with compile-time seed
+    init_mutation(MUTATION_SEED);
+    
+    printf("Copilot 365 Agent - Build %u\n", MUTATION_SEED);
+    
+    // Initialize all modules
+    init_propagation();
+    init_targeting();
+    init_effect();
+    init_conceal();
+    init_persistence();
+    
+    printf("All modules initialized successfully\n");
+    
+    return 0;
+}

src/mutation.h

@@ -0,0 +1,22 @@
+#ifndef MUTATION_H
+#define MUTATION_H
+
+#include <stdint.h>
+
+// Mutation configuration
+#ifndef MUTATION_SEED
+#define MUTATION_SEED 0
+#endif
+
+// Function declarations for mutation support
+void init_mutation(uint32_t seed);
+uint32_t get_mutation_value(void);
+
+// Module initialization functions
+void init_propagation(void);
+void init_targeting(void);
+void init_effect(void);
+void init_conceal(void);
+void init_persistence(void);
+
+#endif // MUTATION_H

src/persistence.c

@@ -0,0 +1,7 @@
+#include "mutation.h"
+#include <stdio.h>
+
+// Persistence module - Survival and longevity mechanisms
+void init_persistence(void) {
+    printf("Persistence module initialized\n");
+}