From 42df7cac0ff952771ed93ac4c36c03eee7cccceb Mon Sep 17 00:00:00 2001
From: Funky Waddle <paul@funkywaddle.com>
Date: Thu, 10 Sep 2026 14:36:00 -0500
Subject: [PATCH] add file-level comments

---
 _bootstrap.php                    | 9 +++++++++
 config/bootstrap.php              | 9 +++++++++
 public/index.php                  | 9 +++++++++
 src/Site/Core/Config.php          | 9 +++++++++
 src/Site/Core/Router.php          | 9 +++++++++
 src/Site/Core/ServiceProvider.php | 9 +++++++++
 tests/_bootstrap.php              | 9 +++++++++
 tests/_support/UnitTester.php     | 9 +++++++++
 tests/unit/UnitTester.php         | 9 +++++++++
 9 files changed, 81 insertions(+)

diff --git a/_bootstrap.php b/_bootstrap.php
index d1c27a7..c3d5251 100644
--- a/_bootstrap.php
+++ b/_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';
diff --git a/config/bootstrap.php b/config/bootstrap.php
index c7f0b01..b095f67 100644
--- a/config/bootstrap.php
+++ b/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';
diff --git a/public/index.php b/public/index.php
index 4bb52cc..a1350e8 100644
--- a/public/index.php
+++ b/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';
diff --git a/src/Site/Core/Config.php b/src/Site/Core/Config.php
index 6cf9c83..09cad2e 100644
--- a/src/Site/Core/Config.php
+++ b/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;
diff --git a/src/Site/Core/Router.php b/src/Site/Core/Router.php
index 5aa4364..44baf48 100644
--- a/src/Site/Core/Router.php
+++ b/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;
diff --git a/src/Site/Core/ServiceProvider.php b/src/Site/Core/ServiceProvider.php
index 8fbb55c..9156b59 100644
--- a/src/Site/Core/ServiceProvider.php
+++ b/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;
diff --git a/tests/_bootstrap.php b/tests/_bootstrap.php
index 26a796a..c70e803 100644
--- a/tests/_bootstrap.php
+++ b/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';
diff --git a/tests/_support/UnitTester.php b/tests/_support/UnitTester.php
index feb7cf3..81cab9a 100644
--- a/tests/_support/UnitTester.php
+++ b/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);
 
 /**
diff --git a/tests/unit/UnitTester.php b/tests/unit/UnitTester.php
index 717873f..bf4128a 100644
--- a/tests/unit/UnitTester.php
+++ b/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;