@heildamm/cli 0.1.0 → 0.1.1

package/README.md

@@ -1,4 +1,3 @@
-
 <div align="center">
 <pre style="color: #8e61c6; background: transparent; border: none; font-weight: bold; line-height: 1.2;">
                                          ░▒▓▓▒░                                                    
@@ -25,6 +24,7 @@ Heildamm operates exclusively within the local `.git` directory. By applying det
 ---
 
 ## Table of Contents
+
 1. [Executive Overview](#executive-overview)
 2. [Core Principles](#core-principles)
 3. [Conceptual Model](#conceptual-model)
@@ -39,9 +39,9 @@ Heildamm operates exclusively within the local `.git` directory. By applying det
 
 Modern codebases accumulate structural complexity through continuous modification, but the contextual reasoning behind these changes is frequently lost. Traditional version control interfaces provide fragmented visibility:
 
-* **`git log`:** Outputs chronological sequences devoid of systemic context.
-* **`git blame`:** Attributes line-level authorship without accounting for temporal relevance.
-* **Code Review Platforms:** Isolate analysis to immediate, pending changes.
+- **`git log`:** Outputs chronological sequences devoid of systemic context.
+- **`git blame`:** Attributes line-level authorship without accounting for temporal relevance.
+- **Code Review Platforms:** Isolate analysis to immediate, pending changes.
 
 **Heildamm** bridges this visibility gap. It treats the repository's history as a comprehensive dataset, allowing engineering leadership and maintainers to model, analyze, and interpret the lifecycle of the codebase holistically.
 
@@ -49,42 +49,50 @@ Modern codebases accumulate structural complexity through continuous modificatio
 
 ## Core Principles
 
-* **Local-First & Secure:** All analytical processing is executed locally. Zero network requests, no external APIs, and no source code exfiltration, ensuring strict compliance with internal security policies.
-* **Deterministic Execution:** System outputs are exclusively derived from reproducible algorithms applied to raw Git data. The architecture deliberately avoids non-deterministic probabilistic models or opaque machine learning layers.
-* **Structural History:** The commit timeline is parsed not as a flat log, but as a structured sequence of architectural transformations that can be queried and grouped.
-* **Knowledge over Authorship:** Code ownership is dynamically calculated based on active contribution and recency, discarding the static and often outdated metric of original authorship.
+- **Local-First & Secure:** All analytical processing is executed locally. Zero network requests, no external APIs, and no source code exfiltration, ensuring strict compliance with internal security policies.
+- **Deterministic Execution:** System outputs are exclusively derived from reproducible algorithms applied to raw Git data. The architecture deliberately avoids non-deterministic probabilistic models or opaque machine learning layers.
+- **Structural History:** The commit timeline is parsed not as a flat log, but as a structured sequence of architectural transformations that can be queried and grouped.
+- **Knowledge over Authorship:** Code ownership is dynamically calculated based on active contribution and recency, discarding the static and often outdated metric of original authorship.
 
 ---
 
 ## Conceptual Model
 
 ### 1. Authorship and Knowledge Distribution
+
 Heildamm calculates a **"living ownership"** matrix utilizing:
-* Granular line-level attribution.
-* Temporal decay algorithms (weighting recent modifications more heavily).
-* Aggregate contribution metrics per file and subsystem.
+
+- Granular line-level attribution.
+- Temporal decay algorithms (weighting recent modifications more heavily).
+- Aggregate contribution metrics per file and subsystem.
 
 **Business Value:** Identifies active knowledge domain experts, highlights stale code maintained by inactive personnel, and quantifies knowledge silos.
 
 ### 2. Temporal Clustering (Evolution Arcs)
+
 Individual commits are mathematically grouped into **"arcs"** based on:
-* Chronological proximity.
-* File intersection and cross-dependency across commits.
+
+- Chronological proximity.
+- File intersection and cross-dependency across commits.
 
 **Business Value:** Reconstructs the narrative of the project—such as the phased rollout of a feature, the execution of technical debt reduction, or major architectural pivots—abstracting the noise of atomic commits.
 
 ### 3. Hotspot Detection
+
 Systemic risk areas are flagged by evaluating:
-* Modification frequency (commit velocity per file).
-* Unique contributor volume.
-* Codebase expansion rates over defined intervals.
+
+- Modification frequency (commit velocity per file).
+- Unique contributor volume.
+- Codebase expansion rates over defined intervals.
 
 **Business Value:** Statistically isolates files with a high probability of latent defects, pinpointing optimal candidates for targeted refactoring to prevent regressions.
 
 ### 4. Bus Factor Estimation
+
 For any given module or specific file, Heildamm computes:
-* The raw count of engineers possessing critical operational knowledge.
-* The mathematical dependency on specific individual contributors.
+
+- The raw count of engineers possessing critical operational knowledge.
+- The mathematical dependency on specific individual contributors.
 
 **Business Value:** Provides objective metrics on structural maintenance risks and aids in capacity planning and team onboarding strategies.
 
@@ -103,9 +111,10 @@ Engine Core
 ```
 
 **Planned Interface Layers:**
-* **CLI Engine:** Built for continuous integration (CI/CD) pipelines and terminal usage.
-* **Local Visualization Server:** Generates interactive, browser-based telemetry dashboards.
-* **Narrative Generator:** Compiles automated, human-readable executive summaries of codebase health.
+
+- **CLI Engine:** Built for continuous integration (CI/CD) pipelines and terminal usage.
+- **Local Visualization Server:** Generates interactive, browser-based telemetry dashboards.
+- **Narrative Generator:** Compiles automated, human-readable executive summaries of codebase health.
 
 ---
 
@@ -113,24 +122,27 @@ Engine Core
 
 The following features dictate the current development roadmap, all guaranteed to run in offline, air-gapped environments:
 
-* **Deep Git Object Parsing:** Complete historical traversal without overhead.
-* **Blame-Based Authorship Matrix:** High-fidelity contributor tracking.
-* **Recency-Weighted Scoring System:** Intelligent degradation of historical authorship.
-* **Commit Arc Clustering:** Feature-level timeline reconstruction.
-* **Volatility Hotspot Scoring:** Predictive risk assessment based on churn.
-* **Bus Factor Analytics:** Automated team dependency reporting.
+- **Deep Git Object Parsing:** Complete historical traversal without overhead.
+- **Blame-Based Authorship Matrix:** High-fidelity contributor tracking.
+- **Recency-Weighted Scoring System:** Intelligent degradation of historical authorship.
+- **Commit Arc Clustering:** Feature-level timeline reconstruction.
+- **Volatility Hotspot Scoring:** Predictive risk assessment based on churn.
+- **Bus Factor Analytics:** Automated team dependency reporting.
 
 ---
 
 ## Getting Started (Planned)
 
 ### Installation
-*(Pending release - placeholder for binary/package manager instructions)*
+
+_(Pending release - placeholder for binary/package manager instructions)_
+
 ```bash
 # Example: curl -sSL [https://heildamm.dev/install.sh](https://heildamm.dev/install.sh) | bash
 ```
 
 ### Usage Examples
+
 Execute Heildamm at the root of your Git repository:
 
 ```bash
@@ -151,5 +163,5 @@ heildamm analyze . --format json > report.json
 
 ## License
 
-Copyright © 2026. All rights reserved. 
-*(Update this section with your specific open-source or proprietary license).*
+Copyright © 2026. All rights reserved.
+_(Update this section with your specific open-source or proprietary license)._

package/bin/controllers/analyze.js

@@ -0,0 +1,2 @@
+"use strict";
+//  e o caba vai endoidar é?

package/bin/controllers/report.js

@@ -0,0 +1,2 @@
+"use strict";
+//  e o caba vai endoidar é?

package/bin/services/git/history.js

@@ -0,0 +1,2 @@
+"use strict";
+//  e o caba vai endoidar é?

package/bin/services/git/parser.js

@@ -0,0 +1,2 @@
+"use strict";
+//  e o caba vai endoidar é?

package/bin/services/metrics/busfactor.js

@@ -0,0 +1,2 @@
+"use strict";
+//  e o caba vai endoidar é?

package/bin/services/metrics/hotspots.js

@@ -0,0 +1,2 @@
+"use strict";
+//  e o caba vai endoidar é?

package/bin/services/metrics/ownership.js

@@ -0,0 +1,2 @@
+"use strict";
+//  e o caba vai endoidar é?

package/bin/services/model/commit.js

@@ -0,0 +1,2 @@
+"use strict";
+//  e o caba vai endoidar é?

package/bin/services/model/repository.js

@@ -0,0 +1,2 @@
+"use strict";
+//  e o caba vai endoidar é?

package/bin/utils/fileSystem.js

@@ -0,0 +1,2 @@
+"use strict";
+//  e o caba vai endoidar é?

package/bin/utils/logger.js

@@ -0,0 +1,2 @@
+"use strict";
+//  e o caba vai endoidar é?

package/package.json

@@ -1,9 +1,10 @@
 {
   "name": "@heildamm/cli",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A local-first Git analysis engine to extract structural, temporal, and ownership insights.",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
+  "type": "module",
   "bin": {
     "heildamm": "./bin/run.js"
   },
@@ -42,10 +43,14 @@
   ],
   "dependencies": {
     "next": "16.1.6",
-    "react": "19.2.3",
-    "react-dom": "19.2.3",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
     "server-only": "^0.0.1",
-    "zod": "^4.3.6"
+    "zod": "^4.3.6",
+    "chalk": "^5.3.0",
+    "boxen": "^7.1.1",
+    "gradient-string": "^2.0.2",
+    "figlet": "^1.7.0"
   },
   "devDependencies": {
     "@tailwindcss/postcss": "^4",
@@ -53,9 +58,10 @@
     "@types/react": "^19",
     "@types/react-dom": "^19",
     "babel-plugin-react-compiler": "1.0.0",
-    "eslint": "^9",
-    "eslint-config-next": "16.1.6",
+    "eslint": "^10",
+    "eslint-config-next": "16.2.1",
+    "prettier": "^3.8.1",
     "tailwindcss": "^4",
-    "typescript": "^5"
+    "typescript": "^6"
   }
-}
+}