fix(backend): removed useless comment

Author: Pauldatcom

apps/backend/.gitignore

@@ -1,4 +1,4 @@
-# Dependencies
+
 node_modules/
 npm-debug.log*
 yarn-debug.log*
@@ -8,54 +8,52 @@ package-lock.json
 yarn.lock
 pnpm-lock.yaml
 
-# Build outputs
 dist/
 build/
 *.tsbuildinfo
 
-# Environment variables
+
 .env
 .env.local
 .env.*.local
 .env.production
 .env.development
 .env.test
 
-# IDE and editor files
+
 .vscode/
 .idea/
 *.swp
 *.swo
 *~
 .DS_Store
 
-# Logs
 logs/
 *.log
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
 lerna-debug.log*
 
-# Testing
+
 coverage/
 .nyc_output/
 *.lcov
 
-# Temporary files
+
 tmp/
 temp/
 *.tmp
 
-# Database
+
 *.db
 *.sqlite
 *.sqlite3
 
-# OS files
+
 Thumbs.db
 .DS_Store
 
-# Drizzle
+
 drizzle/
 

apps/backend/src/application/use-cases/create-tape.ts

@@ -13,8 +13,6 @@ export class CreateTapeUseCase {
    * Default: tape "______1", state "A", final "HALT"
    */
   async execute(): Promise<{ id: string }> {
-    // Default unary machine configuration
-    // Note: Machine halts when no matching transition is found
     const defaultTransitions = [
       { currentState: "A", readSymbol: "_", writeSymbol: "_", moveDirection: "R" as const, nextState: "A" },
       { currentState: "A", readSymbol: "1", writeSymbol: "1", moveDirection: "R" as const, nextState: "B" },

apps/backend/src/application/use-cases/execute-step.ts

@@ -17,13 +17,12 @@ export class ExecuteStepUseCase {
    * @returns Updated tape record or null if not found
    */
   async execute(id: string): Promise<TapeRecord | null> {
-    // Load tape from database
     const record = await this.repository.findById(id);
     if (!record) {
       return null;
     }
 
-    // Reconstruct domain objects
+
     const tape = new Tape(record.content, record.headPosition);
     const machine = new TuringMachine(
       tape,
@@ -32,10 +31,8 @@ export class ExecuteStepUseCase {
       record.finalStates
     );
 
-    // Execute one step
     machine.executeStep();
 
-    // Save updated state back to database
     const updated = await this.repository.update(id, {
       content: tape.getContent(),
       headPosition: tape.getHeadPosition(),

apps/backend/src/application/use-cases/reset-tape.ts

@@ -23,7 +23,7 @@ export class ResetTapeUseCase {
       return null;
     }
 
-    // Reconstruct domain objects
+
     const tape = new Tape(record.content, record.headPosition);
     const machine = new TuringMachine(
       tape,
@@ -32,10 +32,8 @@ export class ResetTapeUseCase {
       record.finalStates
     );
 
-    // Reset to initial state using stored initialContent
     machine.reset(record.initialContent, 0);
 
-    // Save updated state back to database
     const updated = await this.repository.update(id, {
       content: tape.getContent(),
       headPosition: tape.getHeadPosition(),

apps/backend/src/application/use-cases/run-machine.ts

@@ -31,7 +31,7 @@ export class RunMachineUseCase {
       return null;
     }
 
-    // Reconstruct domain objects
+
     const tape = new Tape(record.content, record.headPosition);
     const machine = new TuringMachine(
       tape,
@@ -40,11 +40,9 @@ export class RunMachineUseCase {
       record.finalStates
     );
 
-    // Execute multiple steps
     const maxSteps = options.maxSteps ?? 1000;
     const stepsExecuted = machine.run(maxSteps);
 
-    // Save updated state back to database
     const updated = await this.repository.update(id, {
       content: tape.getContent(),
       headPosition: tape.getHeadPosition(),

apps/backend/src/domain/tape.ts

@@ -18,65 +18,47 @@ export class Tape {
     this.headPosition = Math.max(0, headPosition);
   }
 
-  /**
-   * Reads the symbol at the current head position
-   * Returns blank "_" if position is out of bounds
-   */
+  
   read(): string {
     if (this.headPosition < 0 || this.headPosition >= this.cells.length) {
       return "_";
     }
     return this.cells[this.headPosition] || "_";
   }
 
-  /**
-   * Writes a symbol at the current head position
-   * Expands the tape if necessary
-   */
+  
   write(symbol: string): void {
-    // Expand tape if head is beyond current bounds
     while (this.headPosition >= this.cells.length) {
       this.cells.push("_");
     }
     this.cells[this.headPosition] = symbol;
   }
 
-  /**
-   * Moves the head left (decrements position)
-   * Prevents negative positions
-   */
+  
   moveLeft(): void {
     if (this.headPosition > 0) {
       this.headPosition--;
     }
   }
 
-  /**
-   * Moves the head right (increments position)
-   */
+  
   moveRight(): void {
     this.headPosition++;
   }
 
-  /**
-   * Gets the current head position
-   */
+  
   getHeadPosition(): number {
     return this.headPosition;
   }
 
-  /**
-   * Gets the tape content as a string
-   */
+
   getContent(): string {
     return this.cells.join("");
   }
 
-  /**
-   * Gets the tape content as an array
-   */
+  
   getCells(): string[] {
-    return [...this.cells]; // Return defensive copy
+    return [...this.cells]; 
   }
 
   /**
@@ -89,9 +71,7 @@ export class Tape {
     this.headPosition = Math.max(0, headPosition);
   }
 
-  /**
-   * Creates a copy of the tape (for immutability patterns)
-   */
+  
   clone(): Tape {
     const cloned = new Tape(this.getContent(), this.headPosition);
     return cloned;

apps/backend/src/domain/turing-machine.ts

@@ -6,9 +6,7 @@
 
 import { Tape } from "./tape.js";
 
-/**
- * Transition rule for the Turing machine
- */
+
 export interface Transition {
   currentState: string;
   readSymbol: string;
@@ -44,59 +42,50 @@ export class TuringMachine {
     this.finalStates = new Set(finalStates);
   }
 
-  /**
-   * Gets the current state
-   */
+  
   getCurrentState(): string {
     return this.currentState;
   }
 
-  /**
-   * Gets the tape
-   */
+  
   getTape(): Tape {
     return this.tape;
   }
 
-  /**
-   * Checks if the machine is in a final state
-   */
+  
   isInFinalState(): boolean {
     return this.finalStates.has(this.currentState);
   }
 
-  /**
-   * Executes a single step of the machine
-   * @returns true if step was executed, false if machine is halted
-   */
+  
   executeStep(): boolean {
-    // Check if already in final state
+    
     if (this.isInFinalState()) {
       return false;
     }
 
-    // Read current symbol
+    
     const readSymbol = this.tape.read();
 
-    // Find matching transition
+    
     const transition = this.transitions.find(
       (t) => t.currentState === this.currentState && t.readSymbol === readSymbol
     );
 
     if (!transition) {
-      // No transition found - machine halts
+      
       return false;
     }
 
-    // Execute transition: write, move, change state
+    
     this.tape.write(transition.writeSymbol);
 
     if (transition.moveDirection === "L") {
       this.tape.moveLeft();
     } else if (transition.moveDirection === "R") {
       this.tape.moveRight();
     }
-    // If direction is neither L nor R, don't move (for "no move" behavior)
+    
 
     this.currentState = transition.nextState;
 
@@ -126,23 +115,19 @@ export class TuringMachine {
     this.currentState = this.initialState;
   }
 
-  /**
-   * Gets all transitions
-   */
+  
+
+
   getTransitions(): Transition[] {
-    return [...this.transitions]; // Return defensive copy
+    return [...this.transitions]; 
   }
 
-  /**
-   * Gets initial state
-   */
+  
   getInitialState(): string {
     return this.initialState;
   }
 
-  /**
-   * Gets final states
-   */
+  
   getFinalStates(): string[] {
     return Array.from(this.finalStates);
   }

apps/backend/src/index.ts

@@ -1,21 +1,15 @@
-/**
- * Entry Point
- * Starts the Fastify server with database connection
- */
+
 
 import { createServer } from "./server.js";
 import { validateEnv } from "./infrastructure/config/env.js";
 import { ConfigurationError } from "./domain/errors.js";
 
 async function start() {
   try {
-    // Validate environment variables
     const config = validateEnv();
 
-    // Create and configure server
     const server = await createServer(config.DATABASE_URL);
 
-    // Start listening
     await server.listen({ port: config.PORT, host: config.HOST });
 
     console.log(`Server listening at http://${config.HOST}:${config.PORT}`);

apps/backend/src/infrastructure/config/env.ts

@@ -32,15 +32,8 @@ const envSchema = z.object({
     .default("development"),
 });
 
-/**
- * Validated environment configuration
- */
 export type EnvConfig = z.infer<typeof envSchema>;
 
-/**
- * Validates and returns environment configuration
- * Throws ConfigurationError if validation fails
- */
 export function validateEnv(): EnvConfig {
   try {
     return envSchema.parse({

apps/backend/src/infrastructure/database/client.ts

@@ -10,17 +10,12 @@ import * as schema from "./schema.js";
  * @returns Drizzle database instance
  */
 export function createDatabaseClient(connectionString: string) {
-  // Create postgres connection
   const queryClient = postgres(connectionString);
 
-  // Create Drizzle instance with schema
   const db = drizzle(queryClient, { schema });
 
   return db;
 }
 
-/**
- * Type for the database client
- */
 export type DatabaseClient = ReturnType<typeof createDatabaseClient>;