git-digger 1.9.23 → 1.9.25

package/README.md

@@ -97,6 +97,161 @@ eg:
 commit message: `-3- I did that thing`
 produces: { ease: 3 }
 
+## Structured Output
+
+Both commands support machine-readable JSON output for CI/CD pipelines and automation scripts via the `--format` flag.
+
+### Format Options
+
+- `--format=text` (default): Writes JSON to a file and prints a confirmation message
+- `--format=json`: Outputs structured JSON to stdout wrapped in a status envelope
+
+### Text Mode (Default)
+
+**Example command:**
+```bash
+digger current-contribution-data $(pwd)
+```
+
+**Output:**
+```
+Data written to currentContributionData.json
+```
+
+The JSON data is written to `currentContributionData.json` (or the file specified by `--output-file`).
+
+### JSON Mode
+
+**Example command:**
+```bash
+digger current-contribution-data $(pwd) --format=json
+```
+
+**Success response:**
+```json
+{
+  "status": "success",
+  "data": {
+    "storyId": "STORY-123",
+    "contributors": [
+      {
+        "email": "user@example.com",
+        "name": "John Doe"
+      }
+    ],
+    "commits": [
+      {
+        "sha": "abc123",
+        "message": "[STORY-123] [patch] Fix bug",
+        "dateTime": "2026-05-19T10:30:00Z"
+      }
+    ],
+    "semver": "Patch",
+    "label": "my-project",
+    "firstCommitDateTime": "2026-05-19T10:30:00Z",
+    "lastCommitDateTime": "2026-05-19T10:30:00Z",
+    "ease": 3
+  }
+}
+```
+
+**Fields:**
+- `status`: Always `"success"` for valid operations
+- `data`: The contribution data object (see [ContributionDataJson.kt](../digger-json/src/commonMain/kotlin/com/zegreatrob/tools/digger/json/ContributionDataJson.kt) for full schema)
+- `data.storyId`: Story identifier parsed from commit messages
+- `data.contributors`: Array of contributor objects with email and name
+- `data.commits`: Array of commit objects
+- `data.semver`: Semantic version type (`"Major"`, `"Minor"`, `"Patch"`, `"None"`)
+- `data.label`: Repository or project label
+- `data.firstCommitDateTime`: ISO 8601 timestamp of first commit
+- `data.lastCommitDateTime`: ISO 8601 timestamp of last commit
+- `data.ease`: Joy/ease score (1-5) parsed from commit messages
+
+### AllContributionData JSON Mode
+
+**Example command:**
+```bash
+digger all-contribution-data $(pwd) --format=json
+```
+
+**Success response:**
+```json
+{
+  "status": "success",
+  "data": [
+    {
+      "storyId": "STORY-123",
+      "contributors": [...],
+      "commits": [...],
+      "semver": "Patch",
+      "label": "my-project",
+      "firstCommitDateTime": "2026-05-19T10:30:00Z",
+      "lastCommitDateTime": "2026-05-19T10:30:00Z",
+      "ease": 3
+    },
+    {
+      "storyId": "STORY-124",
+      ...
+    }
+  ]
+}
+```
+
+The `data` field contains an array of contribution data objects, one for each contribution period.
+
+### CI Integration Examples
+
+**Extract story ID in GitHub Actions:**
+```yaml
+- name: Get current contribution
+  id: contribution
+  run: |
+    STORY_ID=$(digger current-contribution-data $(pwd) --format=json | jq -r '.data.storyId')
+    echo "story-id=$STORY_ID" >> $GITHUB_OUTPUT
+
+- name: Use story ID
+  run: echo "Current story: ${{ steps.contribution.outputs.story-id }}"
+```
+
+**Extract contributor list in bash:**
+```bash
+# Get contributors
+CONTRIBUTORS=$(digger current-contribution-data $(pwd) --format=json | jq -r '.data.contributors[].name')
+
+echo "Contributors:"
+echo "$CONTRIBUTORS"
+```
+
+**Check semver type:**
+```bash
+OUTPUT=$(digger current-contribution-data $(pwd) --format=json 2>/dev/null)
+SEMVER=$(echo "$OUTPUT" | jq -r '.data.semver')
+
+case "$SEMVER" in
+  "Major")
+    echo "Breaking change detected"
+    ;;
+  "Minor")
+    echo "New feature detected"
+    ;;
+  "Patch")
+    echo "Bug fix detected"
+    ;;
+  "None")
+    echo "No version bump"
+    ;;
+esac
+```
+
+**Extract all story IDs:**
+```bash
+# Get all contributions and extract story IDs
+STORY_IDS=$(digger all-contribution-data $(pwd) --format=json | jq -r '.data[].storyId' | sort -u)
+
+echo "All story IDs:"
+echo "$STORY_IDS"
+```
+
 ## Help
 
 For a full listing of the available options in the program, please use the built-in help command.

package/kotlin/clikt-clikt-mordant.js

@@ -1,22 +1,22 @@
 (function (_, kotlin_clikt_clikt, kotlin_kotlin, kotlin_mordant_mordant) {
   'use strict';
   //region block: imports
-  var CoreCliktCommand = kotlin_clikt_clikt.$_$.b;
+  var CoreCliktCommand = kotlin_clikt_clikt.$_$.a;
   var VOID = kotlin_kotlin.$_$.c;
   var Unit_instance = kotlin_kotlin.$_$.v;
   var protoOf = kotlin_kotlin.$_$.da;
   var initMetadataForClass = kotlin_kotlin.$_$.f9;
-  var selfAndAncestors = kotlin_clikt_clikt.$_$.f;
+  var selfAndAncestors = kotlin_clikt_clikt.$_$.e;
   var mapNotNull = kotlin_kotlin.$_$.ib;
   var firstOrNull = kotlin_kotlin.$_$.db;
   var Terminal_init_$Create$ = kotlin_mordant_mordant.$_$.h;
   var last = kotlin_kotlin.$_$.hb;
   var MultiplatformSystem_instance = kotlin_mordant_mordant.$_$.e;
-  var FileNotFound = kotlin_clikt_clikt.$_$.c;
+  var FileNotFound = kotlin_clikt_clikt.$_$.b;
   var Terminal = kotlin_mordant_mordant.$_$.b;
   var Whitespace_NORMAL_getInstance = kotlin_mordant_mordant.$_$.f;
   var Text_init_$Create$ = kotlin_mordant_mordant.$_$.i;
-  var AbstractHelpFormatter = kotlin_clikt_clikt.$_$.h;
+  var AbstractHelpFormatter = kotlin_clikt_clikt.$_$.g;
   var verticalLayout = kotlin_mordant_mordant.$_$.a;
   var charSequenceLength = kotlin_kotlin.$_$.w8;
   var definitionList = kotlin_mordant_mordant.$_$.c;
@@ -66,10 +66,10 @@
     return new MordantHelpFormatter(it);
   }
   function installMordant$lambda$lambda_0(it) {
-    return MultiplatformSystem_instance.e26(it);
+    return MultiplatformSystem_instance.f26(it);
   }
   function installMordant$lambda$lambda_1(it) {
-    var tmp0_elvis_lhs = MultiplatformSystem_instance.g26(it);
+    var tmp0_elvis_lhs = MultiplatformSystem_instance.h26(it);
     var tmp;
     if (tmp0_elvis_lhs == null) {
       throw new FileNotFound(it);
@@ -79,14 +79,14 @@
     return tmp;
   }
   function installMordant$lambda$lambda_2(it) {
-    MultiplatformSystem_instance.f26(it);
+    MultiplatformSystem_instance.g26(it);
     return Unit_instance;
   }
   function installMordant$lambda$lambda_3(context, message, trailingNewline, err) {
     if (trailingNewline) {
-      get_terminal(context).e2g(message, VOID, VOID, VOID, VOID, err);
+      get_terminal(context).f2g(message, VOID, VOID, VOID, VOID, err);
     } else {
-      get_terminal(context).c2g(message, VOID, VOID, VOID, VOID, err);
+      get_terminal(context).d2g(message, VOID, VOID, VOID, VOID, err);
     }
     return Unit_instance;
   }
@@ -117,21 +117,21 @@
   }
   function MordantHelpFormatter$formatHelp$lambda(this$0, $error, $prolog, $epilog, $parameters, $programName) {
     return function ($this$verticalLayout) {
-      $this$verticalLayout.u2c(1);
-      $this$verticalLayout.r2c(this$0.r1q($error, $prolog, $epilog, $parameters, $programName));
+      $this$verticalLayout.v2c(1);
+      $this$verticalLayout.s2c(this$0.r1q($error, $prolog, $epilog, $parameters, $programName));
       return Unit_instance;
     };
   }
   function MordantHelpFormatter$renderUsage$lambda($prog, $usageParts) {
     return function ($this$definitionList) {
-      $this$definitionList.o2g($prog, Text_init_$Create$($usageParts, Whitespace_NORMAL_getInstance()));
-      $this$definitionList.i2g_1 = true;
-      $this$definitionList.l2g(1);
+      $this$definitionList.p2g($prog, Text_init_$Create$($usageParts, Whitespace_NORMAL_getInstance()));
+      $this$definitionList.j2g_1 = true;
+      $this$definitionList.m2g(1);
       return Unit_instance;
     };
   }
   function MordantHelpFormatter$renderProlog$lambda($this$withPadding) {
-    $this$withPadding.r2e_1 = 2;
+    $this$withPadding.s2e_1 = 2;
     return Unit_instance;
   }
   function MordantHelpFormatter$renderParameters$lambda(this$0, $parameters) {
@@ -139,31 +139,31 @@
       var _iterator__ex2g4s = this$0.e1s($parameters).r();
       while (_iterator__ex2g4s.s()) {
         var section = _iterator__ex2g4s.t();
-        $this$definitionList.o2g(section.y1p_1, section.z1p_1);
+        $this$definitionList.p2g(section.y1p_1, section.z1p_1);
       }
       return Unit_instance;
     };
   }
   function MordantHelpFormatter$renderOptionGroup$lambda($this$withPadding) {
-    $this$withPadding.o2e_1 = 1;
-    $this$withPadding.r2e_1 = 2;
-    $this$withPadding.q2e_1 = 1;
+    $this$withPadding.p2e_1 = 1;
+    $this$withPadding.s2e_1 = 2;
+    $this$withPadding.r2e_1 = 1;
     return Unit_instance;
   }
   function MordantHelpFormatter$renderOptionGroup$lambda_0($markdown, this$0, $options) {
     return function ($this$verticalLayout) {
-      $this$verticalLayout.t2c($markdown);
-      $this$verticalLayout.t2c(this$0.o1s($options));
+      $this$verticalLayout.u2c($markdown);
+      $this$verticalLayout.u2c(this$0.o1s($options));
       return Unit_instance;
     };
   }
   function MordantHelpFormatter$buildParameterList$lambda($rows, this$0) {
     return function ($this$definitionList) {
-      $this$definitionList.i2g_1 = true;
+      $this$definitionList.j2g_1 = true;
       var _iterator__ex2g4s = $rows.r();
       while (_iterator__ex2g4s.s()) {
         var row = _iterator__ex2g4s.t();
-        $this$definitionList.p2g(this$0.j1t(row), this$0.k1t(row));
+        $this$definitionList.q2g(this$0.k1t(row), this$0.l1t(row));
       }
       return Unit_instance;
     };
@@ -174,18 +174,18 @@
     showRequiredTag = showRequiredTag === VOID ? false : showRequiredTag;
     AbstractHelpFormatter.call(this, context, requiredOptionMarker, showDefaultValues, showRequiredTag);
   }
-  protoOf(MordantHelpFormatter).t2h = function () {
-    return get_terminal(this.f1q_1).n29_1;
+  protoOf(MordantHelpFormatter).u2h = function () {
+    return get_terminal(this.f1q_1).o29_1;
   };
   protoOf(MordantHelpFormatter).c1k = function (error, prolog, epilog, parameters, programName) {
     var widget = verticalLayout(MordantHelpFormatter$formatHelp$lambda(this, error, prolog, epilog, parameters, programName));
-    return get_terminal(this.f1q_1).f2g(widget);
+    return get_terminal(this.f1q_1).g2g(widget);
   };
   protoOf(MordantHelpFormatter).t1q = function (parameters, error) {
     return Text_init_$Create$(this.x1q(parameters, error));
   };
   protoOf(MordantHelpFormatter).s1q = function (parameters, programName) {
-    var title = this.u2h(this.q1q().e1t());
+    var title = this.v2h(this.q1q().f1t());
     var prog = title + ' ' + programName;
     var usageParts = this.b1r(parameters);
     var tmp;
@@ -198,11 +198,11 @@
     return tmp;
   };
   protoOf(MordantHelpFormatter).u1q = function (prolog) {
-    var tmp = this.v2h(prolog);
+    var tmp = this.w2h(prolog);
     return withPadding(tmp, false, MordantHelpFormatter$renderProlog$lambda);
   };
   protoOf(MordantHelpFormatter).w1q = function (epilog) {
-    return this.v2h(epilog);
+    return this.w2h(epilog);
   };
   protoOf(MordantHelpFormatter).v1q = function (parameters) {
     return definitionList(MordantHelpFormatter$renderParameters$lambda(this, parameters));
@@ -220,7 +220,7 @@
     var options = destination;
     if (help == null)
       return this.o1s(options);
-    var tmp = this.v2h(help);
+    var tmp = this.w2h(help);
     var markdown = withPadding(tmp, false, MordantHelpFormatter$renderOptionGroup$lambda);
     return verticalLayout(MordantHelpFormatter$renderOptionGroup$lambda_0(markdown, this, options));
   };
@@ -230,36 +230,36 @@
     return '<' + name.toLowerCase() + '>';
   };
   protoOf(MordantHelpFormatter).m1s = function (name) {
-    return this.t2h().c29('danger').a22(name);
+    return this.u2h().d29('danger').b22(name);
   };
   protoOf(MordantHelpFormatter).v1s = function (name) {
-    return this.t2h().c29('muted').a22(name);
+    return this.u2h().d29('muted').b22(name);
   };
   protoOf(MordantHelpFormatter).l1q = function (name) {
-    return this.t2h().c29('info').a22(name);
+    return this.u2h().d29('info').b22(name);
   };
   protoOf(MordantHelpFormatter).o1q = function (name) {
-    return this.t2h().c29('info').a22(name);
+    return this.u2h().d29('info').b22(name);
   };
   protoOf(MordantHelpFormatter).p1q = function (name) {
-    return this.t2h().c29('info').a22(name);
+    return this.u2h().d29('info').b22(name);
   };
   protoOf(MordantHelpFormatter).d1s = function (title) {
-    return this.t2h().c29('warning').a22(title);
+    return this.u2h().d29('warning').b22(title);
   };
-  protoOf(MordantHelpFormatter).u2h = function (title) {
-    return this.t2h().c29('warning').a22(title);
+  protoOf(MordantHelpFormatter).v2h = function (title) {
+    return this.u2h().d29('warning').b22(title);
   };
   protoOf(MordantHelpFormatter).z1q = function (title) {
-    return this.t2h().c29('danger').a22(title);
+    return this.u2h().d29('danger').b22(title);
   };
   protoOf(MordantHelpFormatter).e1r = function (parameter) {
-    return this.t2h().c29('muted').a22(parameter);
+    return this.u2h().d29('muted').b22(parameter);
   };
   protoOf(MordantHelpFormatter).x1s = function (metavar) {
-    return this.t2h().c29('warning').r25(this.t2h().c29('muted')).a22(metavar);
+    return this.u2h().d29('warning').s25(this.u2h().d29('muted')).b22(metavar);
   };
-  protoOf(MordantHelpFormatter).j1t = function (row) {
+  protoOf(MordantHelpFormatter).k1t = function (row) {
     var tmp;
     // Inline function 'kotlin.text.isNullOrEmpty' call
     var this_0 = row.c1q_1;
@@ -281,13 +281,13 @@
     var termPrefix = tmp;
     return Text_init_$Create$(termPrefix + row.a1q_1, Whitespace_PRE_WRAP_getInstance());
   };
-  protoOf(MordantHelpFormatter).k1t = function (row) {
-    return isBlank(row.b1q_1) ? Text_init_$Create$('') : this.v2h(row.b1q_1);
+  protoOf(MordantHelpFormatter).l1t = function (row) {
+    return isBlank(row.b1q_1) ? Text_init_$Create$('') : this.w2h(row.b1q_1);
   };
   protoOf(MordantHelpFormatter).o1s = function (rows) {
     return definitionList(MordantHelpFormatter$buildParameterList$lambda(rows, this));
   };
-  protoOf(MordantHelpFormatter).v2h = function (text) {
+  protoOf(MordantHelpFormatter).w2h = function (text) {
     return Text_init_$Create$(replace(text, '\n\n', '\x85\x85'), Whitespace_NORMAL_getInstance());
   };
   //region block: exports