add file-level comments

_bootstrap.php

@@ -1,2 +1,11 @@
 <?php
+/**
+ * File: _bootstrap.php
+ *
+ * Author: Funky Waddle
+ * Date: 2026-09-10
+ *
+ * Purpose:
+ *   Bootstrap file for the application.
+ */
 require __DIR__ . '/vendor/autoload.php';

config/bootstrap.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * File: config/bootstrap.php
+ *
+ * Author: Funky Waddle
+ * Date: 2026-09-10
+ *
+ * Purpose:
+ *   Bootstrap configuration and DI container.
+ */
 declare(strict_types=1);
 
 require __DIR__ . '/../vendor/autoload.php';

public/index.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * File: public/index.php
+ *
+ * Author: Funky Waddle
+ * Date: 2026-09-10
+ *
+ * Purpose:
+ *   Front controller entry point that outputs a simple message.
+ */
 declare(strict_types=1);
 
 $container = require __DIR__ . '/../config/bootstrap.php';

src/Site/Core/Config.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * File: src/Site/Core/Config.php
+ *
+ * Author: Funky Waddle
+ * Date: 2026-09-10
+ *
+ * Purpose:
+ *   Configuration service that loads environment variables and optionally fetches secrets from Infisical.
+ */
 declare(strict_types=1);
 
 namespace SiteWeaver\Core;

src/Site/Core/Router.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * File: src/Site/Core/Router.php
+ *
+ * Author: Funky Waddle
+ * Date: 2026-09-10
+ *
+ * Purpose:
+ *   Very small custom router.
+ */
 declare(strict_types=1);
 
 namespace SiteWeaver\Core;

src/Site/Core/ServiceProvider.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * File: src/Site/Core/ServiceProvider.php
+ *
+ * Author: Funky Waddle
+ * Date: 2026-09-10
+ *
+ * Purpose:
+ *   Base class for all service providers.
+ */
 declare(strict_types=1);
 
 namespace SiteWeaver\Core;

tests/_bootstrap.php

@@ -1,2 +1,11 @@
 <?php
+/**
+ * File: tests/_bootstrap.php
+ *
+ * Author: Funky Waddle
+ * Date: 2026-09-10
+ *
+ * Purpose:
+ *   Bootstrap file for Codeception tests.
+ */
 require __DIR__ . '/../vendor/autoload.php';

tests/_support/UnitTester.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * File: tests/_support/UnitTester.php
+ *
+ * Author: Funky Waddle
+ * Date: 2026-09-10
+ *
+ * Purpose:
+ *   Unit tester support class for Codeception.
+ */
 declare(strict_types=1);
 
 /**

tests/unit/UnitTester.php

@@ -1,4 +1,13 @@
 <?php
+/**
+ * File: tests/unit/UnitTester.php
+ *
+ * Author: Funky Waddle
+ * Date: 2026-09-10
+ *
+ * Purpose:
+ *   Test actor used by Codeception unit suite.
+ */
 
 namespace Tests\unit;