feature/story_141: Report Hooks | Error Handlers | Aggregation (#2)

* Added Report Hooks | Error Handlers
* Added Aggregation to reporting
* Added 15 Policies for Github Rulesets and Branch Protections 
* Added permissions scans
* Added regex for CODEOWNERS files

Author: lotsofthoughts

.github/workflows/test.yml

@@ -0,0 +1,40 @@
+name: Run Test Coverage
+permissions:
+  contents: write
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Deno
+        uses: denoland/setup-deno@v2
+        with:
+          deno-version: v2.x
+
+      - name: Install npm Dependencies
+        run: deno install
+      - name: Unit and Integration Tests Job
+        env:
+          PROD_TOKEN: ${{ secrets.PROD_TOKEN }}
+          PROD_REPO: ${{ secrets.PROD_REPO }}
+          PROD_OWNER: 'pkgdist'
+          TEAMS_WEB_HOOK: ${{ env.TEAMS_WEB_HOOK }}
+        run: |
+          deno test --allow-env --allow-read --allow-write --allow-net --allow-sys --allow-run --coverage=coverage --trace-leaks
+      - name: Generate coverage report
+        env:
+          PROD_TOKEN: ${{ secrets.PROD_TOKEN }}
+          PROD_REPO: ${{ secrets.PROD_REPO }}
+          PROD_OWNER: 'pkgdist'
+          TEAMS_WEB_HOOK: ${{ env.TEAMS_WEB_HOOK }}
+        run: |
+          deno coverage coverage --lcov > coverage.lcov
+          deno coverage coverage --html report
+          echo "HTML coverage in ./report/index.html"
+
+      - name: Upload coverage HTML
+        uses: actions/upload-artifact@v4
+        with:
+          name: html-coverage
+          path: coverage/html/index.html

.semver.build.tag

@@ -1 +1 @@
-0.2.5+38821
+0.3.0+41161

.semver.commit.tag

@@ -1,3 +1,3 @@
-Last Commit: commit 637fe303c8f42fcab74a7dde6cce311881bf3325
+Last Commit: commit 28c1bb07d3d3950a3bc609c6406ca58f193e7d76
 Author: Lyns <lotsofthoughts@lynsei.com>
-Date:   Mon Jun 23 12:37:10 2025 -0400
+Date:   Fri Jun 27 15:42:52 2025 -0400

.semver.version.tag

@@ -1 +1 @@
-0.2.7
+0.3.1

Makefile

@@ -84,6 +84,7 @@ install: ## Install all required SAST tools, hooks, and repository tags, multi-c
 	make setup-brew
 	make install-tools
 	make tag
+	make test
 	make check
 	make bump-build
 	make set-version
@@ -139,14 +140,14 @@ bump-build:  ## Bump the build version to a random build number
 build-release:  ## Run release build
 	./scripts/build_release.sh
 
-ci-bump:  ## Build number (bump) releases:  Full CI Add-Commit-Tag-Push Process                                i.e.- '$make ci-bump int="109" msg="feature/story_109: Msg"'
+ci-bump:  ## Bump the build bump and commit-tag-push                               i.e.- '$make ci-bump int="109" msg="feature/story_109: Msg"'
 	./scripts/ci_bump.sh $(int) "$(msg)"
 
-ci-patch:  ## Patch releases: Full CI Add-Commit-Tag-Push Process
+ci-patch:  ## Patch releases bump and commit-tag-push
 	./scripts/ci_patch.sh $(int) "$(msg)"
 
-ci-minor:  ## Minor releases: Full CI Process Add-Commit-Tag-Push Process
+ci-minor:  ## Minor releases bump and commit-tag-push
 	./scripts/ci_minor.sh $(int) "$(msg)"
 
-ci-major:  ## Major releases: Full CI Process Add-Commit-Tag-Push Process
+ci-major:  ## Major releases bump and commit-tag-push
 	./scripts/ci_minor.sh $(int) "$(msg)"

README.md

@@ -22,33 +22,36 @@ for information on the latest release.
 >
 > This @softdist/extensions module is generic and opensource
 
-This is a library for reporting and scoring tools. These tools can be used for
-virtually any purpose as a standard reporting & notifications library. The
-project goal is to provide a variety of reporting options which can be extended
-easily for scoring, notifications, or to generate complex reports based on the
-inspection of Github Scopes, Azure Scopes, and other objects.
+This is a general library for comparison, github scopes, and reporting. These
+tools can be used for virtually any purpose as a standard reporting &
+notifications library. The project goal is to provide a variety of reporting
+options which can be extended easily for scoring, notifications, or to generate
+complex reports based on the inspection of Github Scopes, Azure Scopes, and
+other objects.
 
 ## Exported Modules
 
-| Feature Name | Purpose                                                                                   |
-| :----------- | :---------------------------------------------------------------------------------------- |
-| `$colors`    | Automatic error logging and warn/notice stream logging with colors                        |
-| `$const`     | Declared generic constants for local system paths and GITHUB API                          |
-| `$compare`   | Comparison functions for deep YML objects.                                                |
-| `$error`     | Generic error functions for including messages with specific colors                       |
-| `$ruleset`   | Github Rulesets and Rule scopes for detecting branch protections                          |
-| `$report`    | Reporting function for scoring tabulation in streams, and notification functions in teams |
-| `$reporting` | v2 of the report functionality implements a Reporting object and the concept of hooks     |
-| `$streams`   | Optic FileStream object for logging colored error messages to evaluated streams           |
-| `$token`     | Token acquisition for GitHub CLI default, or .envcrypt files, or environment vars         |
-| `$webhook`   | Webhook secret acquisition IFFE functions                                                 |
+| Feature Name | Purpose                                                                                |
+| :----------- | :------------------------------------------------------------------------------------- |
+| `$colors`    | Automatic error logging and warn/notice stream logging with colors                     |
+| `$const`     | Declared generic constants for local system paths and GITHUB API                       |
+| `$compare`   | Comparison functions for deep YML objects.                                             |
+| `$error`     | Generic error functions for including messages with specific colors                    |
+| `$file`      | File regex and comparison functions.                                                   |
+| `$perms`     | Permissions scanning functions                                                         |
+| `$ruleset`   | Github Rulesets and Rule scopes for detecting branch protections                       |
+| `$report`    | Async reporting stream for tabulation of callback data into a simplified report stream |
+| `$reporting` | Reporting object and the concept of hooks and custom entry types/ exceptions.          |
+| `$streams`   | Optic FileStream object for logging colored error messages to evaluated streams        |
+| `$token`     | Token acquisition for GitHub CLI default, or .envcrypt files, or environment vars      |
+| `$webhook`   | Webhook secret acquisition IFFE functions                                              |
 
 ## Exported Variables
 
-| Variable           | Description                         |
-| :----------------- | :---------------------------------- |
-| `generatedVersion` | Software Version Information        |
-| `Type`             | Types used throughout this software |
+| Variable           | Description                                        |
+| :----------------- | :------------------------------------------------- |
+| `generatedVersion` | Software Version Information                       |
+| `Type`             | Types and Interfaces used throughout this software |
 
 ## Github Scopes
 
@@ -90,7 +93,7 @@ The purpose is to abstract the reporting methods into a JSR package which can be
 called using `deno run` by passing the `--import-map` flag and referencing a
 JSON import map file containing this package.
 
-### Reporting Custom Objects in 0.2.6
+### Reporting Custom Objects in 0.2.6+
 
 Passing custom objects to the `createReport` function is now trivial.
 
@@ -149,7 +152,7 @@ Here is an example import map for testing
     "@onjara/optic": "jsr:@onjara/optic@^2.0.3",
     "@alikia/random-key": "jsr:@alikia/random-key@^1.0.1",
     "@deno/dnt": "jsr:@deno/dnt@^0.41.2",
-    "@softdist/extensions": "jsr:@softdist/extensions@0.2.4",
+    "@softdist/extensions": "jsr:@softdist/extensions@0.3.0",
     "@std/assert": "jsr:@std/assert@1.0.13",
     "@std/fmt": "jsr:@std/fmt@^1.0.7",
     "@std/fs": "jsr:@std/fs@^1.0.17",
@@ -169,15 +172,21 @@ Here is an example import map for testing
 The following diagram explains the current logical flow of how to call and
 utilize this package.
 
+## Logical Diagram
+
+The following logical diagram is written in Mermaid and does not display on
+jsr.io.
+[View Diagram on Github](https://github.com/pkgdist/extensions?tab=readme-ov-file#logical-diagram).
+
 ```mermaid
 ---
-title: Rule Engine Binary
+title: Extensions
 ---
   graph TD;
-      external_program-->dynamic_code_execution-->import_statement-->softdist_extensions
-      softdist_extensions-->reporting-->scopes-->github
-      scopes-->azure
-      softdist_extensions-->notifications-->webhooks
+      external_program-->dynamic_code_execution-->import_statement-->extensions
+      extensions-->reporting-->scopes-->github
+      extensions-->notifications-->webhooks
+      extensions-->aggregate-->custom_types-->custom_entries-->custom_exceptions
 ```
 
 ## About FileStream

deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@softdist/extensions",
-  "version": "0.2.7",
+  "version": "0.3.1",
   "license": "MIT",
   "exports": "./src/mod.ts",
   "test": {
@@ -58,11 +58,12 @@
     "@octokit/core": "npm:@octokit/core@^7.0.2",
     "@onjara/optic": "jsr:@onjara/optic@^2.0.3",
     "@alikia/random-key": "jsr:@alikia/random-key@^1.0.1",
-    "@deno/dnt": "jsr:@deno/dnt@^0.41.2",
+    "@deno/dnt": "jsr:@deno/dnt@^0.42.1",
     "@std/assert": "jsr:@std/assert@1.0.13",
     "@std/fmt": "jsr:@std/fmt@^1.0.7",
-    "@std/fs": "jsr:@std/fs@^1.0.17",
+    "@std/fs": "jsr:@std/fs@^1.0.18",
     "@cliffy/command": "jsr:@cliffy/command@^1.0.0-rc.7",
-    "lefthook": "npm:lefthook@^1.11.12"
+    "@std/path": "jsr:@std/path@^1.1.0",
+    "lefthook": "npm:lefthook@^1.11.14"
   }
 }