@cbnventures/nova 0.17.0 → 0.18.0

package/build/src/types/toolkit/logger.d.ts

@@ -1,160 +1,205 @@
-import type { SharedLoggerCustomizeReturns, SharedLogLevel, SharedLogOptions } from '../shared.d.ts';
+import type { Shared_LoggerCustomizeReturns, Shared_LogLevel, Shared_LogOptions } from '../shared.d.ts';
 
 /**
  * Toolkit - Logger - Customize.
  *
  * @since 0.11.0
  */
-export type ToolkitLoggerCustomizeOptions = SharedLogOptions;
+export type Toolkit_Logger_Runner_Customize_Options = Shared_LogOptions;
 
-export type ToolkitLoggerCustomizeReturns = SharedLoggerCustomizeReturns;
+export type Toolkit_Logger_Runner_Customize_Returns = Shared_LoggerCustomizeReturns;
+
+/**
+ * Toolkit - Logger - Customize - Debug.
+ *
+ * @since 0.11.0
+ */
+export type Toolkit_Logger_Runner_Customize_Debug_Message = unknown[];
+
+export type Toolkit_Logger_Runner_Customize_Debug_Returns = void;
+
+/**
+ * Toolkit - Logger - Customize - Dev.
+ *
+ * @since 0.12.0
+ */
+export type Toolkit_Logger_Runner_Customize_Dev_Message = unknown[];
+
+export type Toolkit_Logger_Runner_Customize_Dev_Returns = void;
+
+/**
+ * Toolkit - Logger - Customize - Error.
+ *
+ * @since 0.11.0
+ */
+export type Toolkit_Logger_Runner_Customize_Error_Message = unknown[];
+
+export type Toolkit_Logger_Runner_Customize_Error_Returns = void;
+
+/**
+ * Toolkit - Logger - Customize - Info.
+ *
+ * @since 0.11.0
+ */
+export type Toolkit_Logger_Runner_Customize_Info_Message = unknown[];
+
+export type Toolkit_Logger_Runner_Customize_Info_Returns = void;
+
+/**
+ * Toolkit - Logger - Customize - Warn.
+ *
+ * @since 0.11.0
+ */
+export type Toolkit_Logger_Runner_Customize_Warn_Message = unknown[];
+
+export type Toolkit_Logger_Runner_Customize_Warn_Returns = void;
 
 /**
  * Toolkit - Logger - Debug.
  *
  * @since 0.11.0
  */
-export type ToolkitLoggerDebugMessage = unknown[];
+export type Toolkit_Logger_Runner_Debug_Message = unknown[];
 
-export type ToolkitLoggerDebugReturns = void;
+export type Toolkit_Logger_Runner_Debug_Returns = void;
 
 /**
  * Toolkit - Logger - Dev.
  *
  * @since 0.12.0
  */
-export type ToolkitLoggerDevMessage = unknown[];
+export type Toolkit_Logger_Runner_Dev_Message = unknown[];
 
-export type ToolkitLoggerDevReturns = void;
+export type Toolkit_Logger_Runner_Dev_Returns = void;
 
 /**
  * Toolkit - Logger - Emit.
  *
  * @since 0.11.0
  */
-export type ToolkitLoggerEmitLevel = SharedLogLevel;
+export type Toolkit_Logger_Runner_Emit_Level = Shared_LogLevel;
 
-export type ToolkitLoggerEmitOptions = SharedLogOptions;
+export type Toolkit_Logger_Runner_Emit_Options = Shared_LogOptions;
 
-export type ToolkitLoggerEmitMessage = unknown[];
+export type Toolkit_Logger_Runner_Emit_Message = unknown[];
 
-export type ToolkitLoggerEmitReturns = void;
+export type Toolkit_Logger_Runner_Emit_Returns = void;
 
-export type ToolkitLoggerEmitPadTopCount = number;
+export type Toolkit_Logger_Runner_Emit_PadTopCount = number;
 
-export type ToolkitLoggerEmitPadBottomCount = number;
+export type Toolkit_Logger_Runner_Emit_PadBottomCount = number;
 
-export type ToolkitLoggerEmitPadTop = string;
+export type Toolkit_Logger_Runner_Emit_PadTop = string;
 
-export type ToolkitLoggerEmitPadBottom = string;
+export type Toolkit_Logger_Runner_Emit_PadBottom = string;
 
-export type ToolkitLoggerEmitStream = NodeJS.WriteStream;
+export type Toolkit_Logger_Runner_Emit_Stream = NodeJS.WriteStream;
 
-export type ToolkitLoggerEmitFormattedMessage = string;
+export type Toolkit_Logger_Runner_Emit_FormattedMessage = string;
 
-export type ToolkitLoggerEmitPrefix = string;
+export type Toolkit_Logger_Runner_Emit_Prefix = string;
 
-export type ToolkitLoggerEmitPrefixVisibleLength = number;
+export type Toolkit_Logger_Runner_Emit_PrefixVisibleLength = number;
 
-export type ToolkitLoggerEmitIndent = string;
+export type Toolkit_Logger_Runner_Emit_Indent = string;
 
-export type ToolkitLoggerEmitLinebreakPattern = RegExp;
+export type Toolkit_Logger_Runner_Emit_LinebreakPattern = RegExp;
 
-export type ToolkitLoggerEmitAlignedMessage = string;
+export type Toolkit_Logger_Runner_Emit_AlignedMessage = string;
 
-export type ToolkitLoggerEmitPayload = string;
+export type Toolkit_Logger_Runner_Emit_Payload = string;
 
 /**
  * Toolkit - Logger - Error.
  *
  * @since 0.11.0
  */
-export type ToolkitLoggerErrorMessage = unknown[];
+export type Toolkit_Logger_Runner_Error_Message = unknown[];
 
-export type ToolkitLoggerErrorReturns = void;
+export type Toolkit_Logger_Runner_Error_Returns = void;
 
 /**
  * Toolkit - Logger - Info.
  *
  * @since 0.11.0
  */
-export type ToolkitLoggerInfoMessage = unknown[];
+export type Toolkit_Logger_Runner_Info_Message = unknown[];
 
-export type ToolkitLoggerInfoReturns = void;
+export type Toolkit_Logger_Runner_Info_Returns = void;
 
 /**
  * Toolkit - Logger - Prefix.
  *
  * @since 0.11.0
  */
-export type ToolkitLoggerPrefixLevel = SharedLogLevel;
+export type Toolkit_Logger_Runner_Prefix_Level = Shared_LogLevel;
 
-export type ToolkitLoggerPrefixOptions = SharedLogOptions;
+export type Toolkit_Logger_Runner_Prefix_Options = Shared_LogOptions;
 
-export type ToolkitLoggerPrefixReturns = string;
+export type Toolkit_Logger_Runner_Prefix_Returns = string;
 
-export type ToolkitLoggerPrefixLevelLabelUpper = string;
+export type Toolkit_Logger_Runner_Prefix_LevelLabelUpper = string;
 
-export type ToolkitLoggerPrefixScopeLabel = string | null;
+export type Toolkit_Logger_Runner_Prefix_ScopeLabel = string | null;
 
-export type ToolkitLoggerPrefixShowScope = boolean;
+export type Toolkit_Logger_Runner_Prefix_ShowScope = boolean;
 
-export type ToolkitLoggerPrefixScopeTag = string;
+export type Toolkit_Logger_Runner_Prefix_ScopeTag = string;
 
-export type ToolkitLoggerPrefixColoredLevelLabel = string | undefined;
+export type Toolkit_Logger_Runner_Prefix_ColoredLevelLabel = string | undefined;
 
-export type ToolkitLoggerPrefixTimestamp = string;
+export type Toolkit_Logger_Runner_Prefix_Timestamp = string;
 
 /**
  * Toolkit - Logger - Scope Label.
  *
  * @since 0.12.0
  */
-export type ToolkitLoggerScopeLabelOptions = SharedLogOptions;
+export type Toolkit_Logger_Runner_ScopeLabel_Options = Shared_LogOptions;
 
-export type ToolkitLoggerScopeLabelReturns = string | null;
+export type Toolkit_Logger_Runner_ScopeLabel_Returns = string | null;
 
-export type ToolkitLoggerScopeLabelSegments = string[];
+export type Toolkit_Logger_Runner_ScopeLabel_Segments = string[];
 
 /**
  * Toolkit - Logger - Should Log.
  *
  * @since 0.11.0
  */
-export type ToolkitLoggerShouldLogLevel = SharedLogLevel;
+export type Toolkit_Logger_Runner_ShouldLog_Level = Shared_LogLevel;
 
-export type ToolkitLoggerShouldLogReturns = boolean;
+export type Toolkit_Logger_Runner_ShouldLog_Returns = boolean;
 
-export type ToolkitLoggerShouldLogWeights = Record<SharedLogLevel, number>;
+export type Toolkit_Logger_Runner_ShouldLog_Weights = Record<Shared_LogLevel, number>;
 
-export type ToolkitLoggerShouldLogIsBrowser = boolean;
+export type Toolkit_Logger_Runner_ShouldLog_IsBrowser = boolean;
 
-export type ToolkitLoggerShouldLogNodeEnv = string;
+export type Toolkit_Logger_Runner_ShouldLog_NodeEnv = string;
 
-export type ToolkitLoggerShouldLogCurrentLogLevel = string;
+export type Toolkit_Logger_Runner_ShouldLog_CurrentLogLevel = string;
 
-export type ToolkitLoggerShouldLogDefaultLogLevel = SharedLogLevel | undefined;
+export type Toolkit_Logger_Runner_ShouldLog_DefaultLogLevel = Shared_LogLevel | undefined;
 
-export type ToolkitLoggerShouldLogPreferredLogLevelCurrentLogLevel = SharedLogLevel;
+export type Toolkit_Logger_Runner_ShouldLog_PreferredLogLevelCurrentLogLevel = Shared_LogLevel;
 
-export type ToolkitLoggerShouldLogPreferredLogLevel = SharedLogLevel;
+export type Toolkit_Logger_Runner_ShouldLog_PreferredLogLevel = Toolkit_Logger_Runner_ShouldLog_PreferredLogLevelCurrentLogLevel;
 
 /**
  * Toolkit - Logger - Strip ANSI Colors.
  *
  * @since 0.11.0
  */
-export type ToolkitLoggerStripAnsiColorsValue = string;
+export type Toolkit_Logger_Runner_StripAnsiColors_Value = string;
 
-export type ToolkitLoggerStripAnsiColorsReturns = string;
+export type Toolkit_Logger_Runner_StripAnsiColors_Returns = string;
 
-export type ToolkitLoggerStripAnsiColorsPattern = RegExp;
+export type Toolkit_Logger_Runner_StripAnsiColors_Pattern = RegExp;
 
 /**
  * Toolkit - Logger - Warn.
  *
  * @since 0.11.0
  */
-export type ToolkitLoggerWarnMessage = unknown[];
+export type Toolkit_Logger_Runner_Warn_Message = unknown[];
 
-export type ToolkitLoggerWarnReturns = void;
+export type Toolkit_Logger_Runner_Warn_Returns = void;

package/build/src/types/toolkit/markdown-table.d.ts

@@ -1,45 +1,77 @@
 import type { MarkdownTable } from '../../toolkit/index.js';
 
+/**
+ * Toolkit - Markdown Table - Headers.
+ *
+ * @since 0.11.0
+ */
+export type Toolkit_MarkdownTable_Runner_Headers = string[];
+
+/**
+ * Toolkit - Markdown Table - Minimum Column Width.
+ *
+ * @since 0.11.0
+ */
+export type Toolkit_MarkdownTable_Runner_MinimumColumnWidth = number;
+
+/**
+ * Toolkit - Markdown Table - Pad Delimiter Row.
+ *
+ * @since 0.11.0
+ */
+export type Toolkit_MarkdownTable_Runner_PadDelimiterRow = boolean;
+
+/**
+ * Toolkit - Markdown Table - Rows.
+ *
+ * @since 0.11.0
+ */
+export type Toolkit_MarkdownTable_Runner_Row = string[];
+
+export type Toolkit_MarkdownTable_Runner_Rows = Toolkit_MarkdownTable_Runner_Row[];
+
 /**
  * Toolkit - Markdown Table - Add Row.
  *
  * @since 0.11.0
  */
-export type ToolkitMarkdownTableAddRowRow = string[];
+export type Toolkit_MarkdownTable_Runner_AddRow_Row = string[];
 
-export type ToolkitMarkdownTableAddRowReturns = MarkdownTable;
+export type Toolkit_MarkdownTable_Runner_AddRow_Returns = MarkdownTable;
 
 /**
  * Toolkit - Markdown Table - Compute Column Widths.
  *
  * @since 0.11.0
  */
-export type ToolkitMarkdownTableComputeColumnWidthsReturns = number[];
+export type Toolkit_MarkdownTable_Runner_ComputeColumnWidths_Returns = number[];
+
+export type Toolkit_MarkdownTable_Runner_ComputeColumnWidths_ColumnsLength = number;
 
-export type ToolkitMarkdownTableComputeColumnWidthsColumnsLength = number;
+export type Toolkit_MarkdownTable_Runner_ComputeColumnWidths_Row = string[];
 
-export type ToolkitMarkdownTableComputeColumnWidthsRow = string[];
+export type Toolkit_MarkdownTable_Runner_ComputeColumnWidths_Rows = Toolkit_MarkdownTable_Runner_ComputeColumnWidths_Row[];
 
-export type ToolkitMarkdownTableComputeColumnWidthsRows = ToolkitMarkdownTableComputeColumnWidthsRow[];
+export type Toolkit_MarkdownTable_Runner_ComputeColumnWidths_Widths = number[];
 
-export type ToolkitMarkdownTableComputeColumnWidthsColumnWidth = number;
+export type Toolkit_MarkdownTable_Runner_ComputeColumnWidths_ColumnWidth = number;
 
-export type ToolkitMarkdownTableComputeColumnWidthsStrippedCell = string;
+export type Toolkit_MarkdownTable_Runner_ComputeColumnWidths_StrippedCell = string;
 
 /**
  * Toolkit - Markdown Table - Constructor.
  *
  * @since 0.11.0
  */
-export type ToolkitMarkdownTableConstructorHeaders = string[];
+export type Toolkit_MarkdownTable_Runner_Constructor_Headers = string[];
 
-export type ToolkitMarkdownTableConstructorOptionsMinimumColumnWidth = number;
+export type Toolkit_MarkdownTable_Runner_Constructor_Options_MinimumColumnWidth = number;
 
-export type ToolkitMarkdownTableConstructorOptionsPadDelimiterRow = boolean;
+export type Toolkit_MarkdownTable_Runner_Constructor_Options_PadDelimiterRow = boolean;
 
-export type ToolkitMarkdownTableConstructorOptions = {
-  minimumColumnWidth: ToolkitMarkdownTableConstructorOptionsMinimumColumnWidth;
-  padDelimiterRow: ToolkitMarkdownTableConstructorOptionsPadDelimiterRow;
+export type Toolkit_MarkdownTable_Runner_Constructor_Options = {
+  minimumColumnWidth: Toolkit_MarkdownTable_Runner_Constructor_Options_MinimumColumnWidth;
+  padDelimiterRow: Toolkit_MarkdownTable_Runner_Constructor_Options_PadDelimiterRow;
 };
 
 /**
@@ -47,113 +79,83 @@ export type ToolkitMarkdownTableConstructorOptions = {
  *
  * @since 0.11.0
  */
-export type ToolkitMarkdownTableEscapeCellValue = string;
+export type Toolkit_MarkdownTable_Runner_EscapeCell_Value = string;
 
-export type ToolkitMarkdownTableEscapeCellReturns = string;
+export type Toolkit_MarkdownTable_Runner_EscapeCell_Returns = string;
 
-export type ToolkitMarkdownTableEscapeCellPipePattern = RegExp;
+export type Toolkit_MarkdownTable_Runner_EscapeCell_PipePattern = RegExp;
 
-export type ToolkitMarkdownTableEscapeCellLinebreakPattern = RegExp;
+export type Toolkit_MarkdownTable_Runner_EscapeCell_LinebreakPattern = RegExp;
 
 /**
  * Toolkit - Markdown Table - Format Delimiter.
  *
  * @since 0.11.0
  */
-export type ToolkitMarkdownTableFormatDelimiterColumnWidths = number[];
+export type Toolkit_MarkdownTable_Runner_FormatDelimiter_ColumnWidths = number[];
 
-export type ToolkitMarkdownTableFormatDelimiterReturns = string;
+export type Toolkit_MarkdownTable_Runner_FormatDelimiter_Returns = string;
 
-export type ToolkitMarkdownTableFormatDelimiterMinimumWidth = number;
+export type Toolkit_MarkdownTable_Runner_FormatDelimiter_MinimumWidth = number;
 
-export type ToolkitMarkdownTableFormatDelimiterUsePaddedDelimiter = boolean;
+export type Toolkit_MarkdownTable_Runner_FormatDelimiter_UsePaddedDelimiter = boolean;
 
-export type ToolkitMarkdownTableFormatDelimiterColumnCells = string[];
+export type Toolkit_MarkdownTable_Runner_FormatDelimiter_ColumnCells = string[];
 
-export type ToolkitMarkdownTableFormatDelimiterDelimiter = string;
+export type Toolkit_MarkdownTable_Runner_FormatDelimiter_Delimiter = string;
 
-export type ToolkitMarkdownTableFormatDelimiterRowBody = string;
+export type Toolkit_MarkdownTable_Runner_FormatDelimiter_RowBody = string;
 
 /**
  * Toolkit - Markdown Table - Format Row.
  *
  * @since 0.11.0
  */
-export type ToolkitMarkdownTableFormatRowCells = string[];
+export type Toolkit_MarkdownTable_Runner_FormatRow_Cells = string[];
 
-export type ToolkitMarkdownTableFormatRowWidths = number[];
+export type Toolkit_MarkdownTable_Runner_FormatRow_Widths = number[];
 
-export type ToolkitMarkdownTableFormatRowReturns = string;
+export type Toolkit_MarkdownTable_Runner_FormatRow_Returns = string;
 
-export type ToolkitMarkdownTableFormatRowEscapedCells = string[];
+export type Toolkit_MarkdownTable_Runner_FormatRow_EscapedCells = string[];
 
-export type ToolkitMarkdownTableFormatRowEscapedCell = string;
-
-/**
- * Toolkit - Markdown Table - Headers.
- *
- * @since 0.11.0
- */
-export type ToolkitMarkdownTableHeaders = string[];
-
-/**
- * Toolkit - Markdown Table - Minimum Column Width.
- *
- * @since 0.11.0
- */
-export type ToolkitMarkdownTableMinimumColumnWidth = number;
+export type Toolkit_MarkdownTable_Runner_FormatRow_EscapedCell = string;
 
 /**
  * Toolkit - Markdown Table - Pad Cell.
  *
  * @since 0.11.0
  */
-export type ToolkitMarkdownTablePadCellString = string;
+export type Toolkit_MarkdownTable_Runner_PadCell_String = string;
 
-export type ToolkitMarkdownTablePadCellWidth = number;
+export type Toolkit_MarkdownTable_Runner_PadCell_Width = number;
 
-export type ToolkitMarkdownTablePadCellReturns = string;
+export type Toolkit_MarkdownTable_Runner_PadCell_Returns = string;
 
-export type ToolkitMarkdownTablePadCellPadding = number;
-
-/**
- * Toolkit - Markdown Table - Pad Delimiter Row.
- *
- * @since 0.11.0
- */
-export type ToolkitMarkdownTablePadDelimiterRow = boolean;
+export type Toolkit_MarkdownTable_Runner_PadCell_Padding = number;
 
 /**
  * Toolkit - Markdown Table - Render.
  *
  * @since 0.11.0
  */
-export type ToolkitMarkdownTableRenderReturns = string;
-
-export type ToolkitMarkdownTableRenderColumnWidths = number[];
+export type Toolkit_MarkdownTable_Runner_Render_Returns = string;
 
-export type ToolkitMarkdownTableRenderHeader = string;
+export type Toolkit_MarkdownTable_Runner_Render_ColumnWidths = number[];
 
-export type ToolkitMarkdownTableRenderDelimiter = string;
+export type Toolkit_MarkdownTable_Runner_Render_Header = string;
 
-export type ToolkitMarkdownTableRenderBody = string;
-
-/**
- * Toolkit - Markdown Table - Rows.
- *
- * @since 0.11.0
- */
-export type ToolkitMarkdownTableRow = string[];
+export type Toolkit_MarkdownTable_Runner_Render_Delimiter = string;
 
-export type ToolkitMarkdownTableRows = ToolkitMarkdownTableRow[];
+export type Toolkit_MarkdownTable_Runner_Render_Body = string;
 
 /**
  * Toolkit - Markdown Table - Strip ANSI Colors.
  *
  * @since 0.11.0
  */
-export type ToolkitMarkdownTableStripAnsiColorsString = string;
+export type Toolkit_MarkdownTable_Runner_StripAnsiColors_String = string;
 
-export type ToolkitMarkdownTableStripAnsiColorsReturns = string;
+export type Toolkit_MarkdownTable_Runner_StripAnsiColors_Returns = string;
 
-export type ToolkitMarkdownTableStripAnsiColorsPattern = RegExp;
+export type Toolkit_MarkdownTable_Runner_StripAnsiColors_Pattern = RegExp;

package/build/templates/generators/github/workflows/publish/targets/aws-amplify-nextjs.yml

@@ -10,7 +10,7 @@ publish-aws-amplify-nextjs-[__TARGET_ID__]:
       uses: "actions/checkout@v6"
 
     - name: "Download build artifacts"
-      uses: "actions/download-artifact@v4"
+      uses: "actions/download-artifact@v8"
       with:
         name: "[__ARTIFACT_NAME__]"
 

package/build/templates/generators/github/workflows/publish/targets/cloudflare-pages-docusaurus.yml

@@ -10,7 +10,7 @@ publish-cloudflare-pages-docusaurus-[__TARGET_ID__]:
       uses: "actions/checkout@v6"
 
     - name: "Download build artifacts"
-      uses: "actions/download-artifact@v4"
+      uses: "actions/download-artifact@v8"
       with:
         name: "[__ARTIFACT_NAME__]"
         path: "[__WORKING_DIR__]/build"

package/build/templates/generators/github/workflows/publish/targets/github-action.yml

@@ -0,0 +1,121 @@
+publish-github-action-[__TARGET_ID__]:
+  needs: [__NEEDS__]
+  runs-on: "ubuntu-latest"
+  timeout-minutes: 10
+  permissions:
+    contents: "write"
+    id-token: "write"
+    attestations: "write"
+[__JOBS_CONDITION__]
+  steps:
+    - name: "Checkout repository"
+      uses: "actions/checkout@v6"
+      with:
+        persist-credentials: false
+
+    - name: "Download build artifacts"
+      uses: "actions/download-artifact@v8"
+      with:
+        name: "[__ARTIFACT_NAME__]"
+        path: "${{ vars.ACTION_OUTPUT_PATH }}"
+
+    - name: "Configure git identity"
+      if: "${{ env.PUBLISH == 'true' }}"
+      run: |
+        set -euo pipefail
+        git config --global user.name "github-actions[bot]"
+        git config --global user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+    - name: "Verify release context"
+      if: "${{ env.PUBLISH == 'true' }}"
+      env:
+        TAG_NAME: "${{ github.event.release.tag_name }}"
+      run: |
+        set -euo pipefail
+        if [ -z "$TAG_NAME" ]; then
+          echo "::error::The github-action target requires a release.published event with a tag name. Manual workflow_dispatch with dry-run=false is not supported."
+          exit 1
+        fi
+
+    - name: "Initialize release workspace"
+      if: "${{ env.PUBLISH == 'true' }}"
+      env:
+        GITHUB_TOKEN: "${{ secrets.GITHUB_TOKEN }}"
+      run: |
+        set -euo pipefail
+        rm -rf "$RUNNER_TEMP/release"
+        mkdir -p "$RUNNER_TEMP/release"
+        cd "$RUNNER_TEMP/release"
+        git init -b "${{ vars.RELEASE_BRANCH_NAME }}"
+        git remote add origin "https://github.com/${{ github.repository }}.git"
+        git config --local http.https://github.com/.extraheader "Authorization: basic $(printf 'x-access-token:%s' "$GITHUB_TOKEN" | base64 | tr -d '\n')"
+
+        # If the release branch exists remotely, fetch and reset to it so the new commit lands on top.
+        if git ls-remote --exit-code --heads origin "${{ vars.RELEASE_BRANCH_NAME }}" > /dev/null; then
+          git fetch origin "${{ vars.RELEASE_BRANCH_NAME }}"
+          git reset --hard "origin/${{ vars.RELEASE_BRANCH_NAME }}"
+          git rm -rf . > /dev/null 2>&1 || true
+        fi
+
+    - name: "Stage release tree"
+      if: "${{ env.PUBLISH == 'true' }}"
+      run: |
+        set -euo pipefail
+        cd "$GITHUB_WORKSPACE"
+        STAGE="$RUNNER_TEMP/release"
+
+        # Required: action.yml and the built action directory.
+        cp "${{ vars.ACTION_YML_PATH }}" "$STAGE/action.yml"
+        mkdir -p "$STAGE/action"
+        cp -R "${{ vars.ACTION_OUTPUT_PATH }}/." "$STAGE/action/"
+
+        # Optional: common community-repo files. Copy if present on main, skip silently if not.
+        for optional in README.md LICENSE SECURITY.md NOTICE CHANGELOG.md; do
+          if [ -f "$optional" ]; then
+            cp "$optional" "$STAGE/$optional"
+          fi
+        done
+
+    - name: "Commit and push release"
+      if: "${{ env.PUBLISH == 'true' }}"
+      env:
+        TAG_NAME: "${{ github.event.release.tag_name }}"
+      run: |
+        set -euo pipefail
+        cd "$RUNNER_TEMP/release"
+        git add -A
+        git commit -m "Release $TAG_NAME"
+        git push origin "${{ vars.RELEASE_BRANCH_NAME }}" --force
+
+    - name: "Force-retag semver and floating major"
+      if: "${{ env.PUBLISH == 'true' }}"
+      env:
+        TAG_NAME: "${{ github.event.release.tag_name }}"
+        IS_PRERELEASE: "${{ github.event.release.prerelease }}"
+      run: |
+        set -euo pipefail
+        cd "$RUNNER_TEMP/release"
+
+        # Re-point the semver tag onto the orphan commit (GitHub created it on main; we move it).
+        git tag -f "$TAG_NAME"
+        git push origin "refs/tags/$TAG_NAME" --force
+
+        # Derive floating major (e.g., v2.1.3 -> v2; primary-v1.2.3 -> primary-v1).
+        # Skips the major retag when the tag isn't <prefix->v<digits> shaped or when
+        # the release is marked as a prerelease — the floating major should only
+        # track stable releases.
+        MAJOR="$(printf '%s' "$TAG_NAME" | sed -E 's/^(([a-zA-Z][a-zA-Z0-9_-]*-)?v[0-9]+).*/\1/')"
+        if [ "$IS_PRERELEASE" = "true" ]; then
+          echo "Release $TAG_NAME is marked as a prerelease; skipping floating major retag."
+        elif [ "$MAJOR" = "$TAG_NAME" ]; then
+          echo "Tag $TAG_NAME is not v-prefixed semver; skipping floating major retag."
+        else
+          git tag -f "$MAJOR"
+          git push origin "refs/tags/$MAJOR" --force
+        fi
+
+    - name: "Attest build provenance"
+      if: "${{ env.PUBLISH == 'true' }}"
+      uses: "actions/attest-build-provenance@v2"
+      with:
+        subject-path: "${{ vars.ACTION_OUTPUT_PATH }}/${{ vars.ACTION_ENTRY_POINT }}"

package/build/templates/generators/github/workflows/publish/targets/github-packages.yml

@@ -34,7 +34,7 @@ publish-github-packages-[__TARGET_ID__]:
         fi
 
     - name: "Download build artifacts"
-      uses: "actions/download-artifact@v4"
+      uses: "actions/download-artifact@v8"
       with:
         name: "[__ARTIFACT_NAME__]"
         path: "[__WORKING_DIR__]/build"

package/build/templates/generators/github/workflows/publish/targets/github-pages-docusaurus.yml

@@ -12,7 +12,7 @@ publish-github-pages-docusaurus-[__TARGET_ID__]:
       uses: "actions/checkout@v6"
 
     - name: "Download build artifacts"
-      uses: "actions/download-artifact@v4"
+      uses: "actions/download-artifact@v8"
       with:
         name: "[__ARTIFACT_NAME__]"
         path: "[__WORKING_DIR__]/build"

package/build/templates/generators/github/workflows/publish/targets/npm.yml

@@ -26,7 +26,7 @@ publish-npm-[__TARGET_ID__]:
         fi
 
     - name: "Download build artifacts"
-      uses: "actions/download-artifact@v4"
+      uses: "actions/download-artifact@v8"
       with:
         name: "[__ARTIFACT_NAME__]"
         path: "[__WORKING_DIR__]/build"

package/build/templates/generators/github/workflows/publish/targets/vercel-nextjs.yml

@@ -16,7 +16,7 @@ publish-vercel-nextjs-[__TARGET_ID__]:
         package-manager-cache: false
 
     - name: "Download build artifacts"
-      uses: "actions/download-artifact@v4"
+      uses: "actions/download-artifact@v8"
       with:
         name: "[__ARTIFACT_NAME__]"