javi-forge 1.6.0 → 1.7.0

package/dist/ui/StackSelector.js

@@ -1,9 +1,17 @@
-import React, { useState, useEffect, useRef } from 'react';
-import { Box, Text, useInput } from 'ink';
-import { detectStack, STACK_LABELS } from '../lib/common.js';
-import { theme } from './theme.js';
-import { useCIMode } from './CIContext.js';
-const ALL_STACKS = ['node', 'python', 'go', 'rust', 'java-gradle', 'java-maven', 'elixir'];
+import { Box, Text, useInput } from "ink";
+import React, { useEffect, useRef, useState } from "react";
+import { detectStack, STACK_LABELS } from "../lib/common.js";
+import { useCIMode } from "./CIContext.js";
+import { theme } from "./theme.js";
+const ALL_STACKS = [
+    "node",
+    "python",
+    "go",
+    "rust",
+    "java-gradle",
+    "java-maven",
+    "elixir",
+];
 export default function StackSelector({ projectDir, onConfirm }) {
     const isCI = useCIMode();
     const autoConfirmed = useRef(false);
@@ -11,7 +19,7 @@ export default function StackSelector({ projectDir, onConfirm }) {
     const [detectedStack, setDetectedStack] = useState(null);
     const [detecting, setDetecting] = useState(true);
     useEffect(() => {
-        detectStack(projectDir).then(result => {
+        detectStack(projectDir).then((result) => {
             if (result) {
                 setDetectedStack(result.stackType);
                 const idx = ALL_STACKS.indexOf(result.stackType);
@@ -28,13 +36,13 @@ export default function StackSelector({ projectDir, onConfirm }) {
             onConfirm(ALL_STACKS[cursor]);
         }
     }, [isCI, detecting]); // eslint-disable-line react-hooks/exhaustive-deps
-    useInput((input, key) => {
+    useInput((_input, key) => {
         if (detecting)
             return;
         if (key.upArrow)
-            setCursor(c => Math.max(0, c - 1));
+            setCursor((c) => Math.max(0, c - 1));
         if (key.downArrow)
-            setCursor(c => Math.min(ALL_STACKS.length - 1, c + 1));
+            setCursor((c) => Math.min(ALL_STACKS.length - 1, c + 1));
         if (key.return) {
             onConfirm(ALL_STACKS[cursor]);
         }
@@ -46,20 +54,22 @@ export default function StackSelector({ projectDir, onConfirm }) {
     return (React.createElement(Box, { flexDirection: "column" },
         React.createElement(Text, { bold: true }, "Select project stack:"),
         detectedStack && (React.createElement(Text, { color: theme.success },
-            '  ',
+            "  ",
             "Auto-detected: ",
             STACK_LABELS[detectedStack])),
         React.createElement(Box, { marginTop: 1, flexDirection: "column", borderStyle: "single", borderLeft: true, borderRight: false, borderTop: false, borderBottom: false, borderColor: theme.muted, paddingLeft: 1 }, ALL_STACKS.map((stack, i) => (React.createElement(Box, { key: stack },
-            React.createElement(Text, { color: i === cursor ? theme.primary : 'white' },
-                i === cursor ? '\u25b6 ' : '  ',
-                stack === detectedStack ? '\u25c9' : '\u25cb',
+            React.createElement(Text, { color: i === cursor ? theme.primary : "white" },
+                i === cursor ? "\u25b6 " : "  ",
+                stack === detectedStack ? "\u25c9" : "\u25cb",
                 " ",
                 STACK_LABELS[stack],
-                stack === detectedStack && (React.createElement(Text, { color: theme.success, dimColor: true }, "  (detected)"))))))),
+                stack === detectedStack && (React.createElement(Text, { color: theme.success, dimColor: true },
+                    " ",
+                    "(detected)"))))))),
         React.createElement(Box, { marginTop: 1, gap: 2 },
             React.createElement(Text, { color: theme.primary }, STACK_LABELS[ALL_STACKS[cursor]]),
             React.createElement(Text, { color: theme.muted, dimColor: true },
-                '\u2191\u2193',
-                " navigate  Enter confirm"))));
+                "\u2191\u2193",
+                " navigate Enter confirm"))));
 }
 //# sourceMappingURL=StackSelector.js.map

package/dist/ui/Summary.d.ts

@@ -1,5 +1,5 @@
-import React from 'react';
-import type { InitStep } from '../types/index.js';
+import React from "react";
+import type { InitStep } from "../types/index.js";
 interface Props {
     steps: InitStep[];
     dryRun: boolean;
@@ -7,6 +7,6 @@ interface Props {
     stack?: string;
     elapsedMs?: number;
 }
-export default function Summary({ steps, dryRun, projectName, stack, elapsedMs }: Props): React.JSX.Element;
+export default function Summary({ steps, dryRun, projectName, stack, elapsedMs, }: Props): React.JSX.Element;
 export {};
 //# sourceMappingURL=Summary.d.ts.map

package/dist/ui/Summary.js

@@ -1,29 +1,35 @@
-import React, { useEffect } from 'react';
-import { Box, Text, useApp, useInput } from 'ink';
-import { theme } from './theme.js';
-import { useCIMode } from './CIContext.js';
+import { Box, Text, useApp, useInput } from "ink";
+import React, { useEffect } from "react";
+import { useCIMode } from "./CIContext.js";
+import { theme } from "./theme.js";
 /** Map stack to the install command hint */
 function getInstallHint(stack) {
     switch (stack) {
-        case 'node': return 'pnpm install';
-        case 'python': return 'pip install -r requirements.txt';
-        case 'go': return 'go mod tidy';
-        case 'rust': return 'cargo build';
-        case 'java-gradle': return './gradlew build';
-        case 'java-maven': return 'mvn install';
-        case 'elixir': return 'mix deps.get';
-        default: return null;
+        case "node":
+            return "pnpm install";
+        case "python":
+            return "pip install -r requirements.txt";
+        case "go":
+            return "go mod tidy";
+        case "rust":
+            return "cargo build";
+        case "java-gradle":
+            return "./gradlew build";
+        case "java-maven":
+            return "mvn install";
+        case "elixir":
+            return "mix deps.get";
+        default:
+            return null;
     }
 }
-export default function Summary({ steps, dryRun, projectName, stack, elapsedMs }) {
+export default function Summary({ steps, dryRun, projectName, stack, elapsedMs, }) {
     const { exit } = useApp();
     const isCI = useCIMode();
-    const done = steps.filter(s => s.status === 'done').length;
-    const skipped = steps.filter(s => s.status === 'skipped').length;
-    const errors = steps.filter(s => s.status === 'error');
-    const elapsed = elapsedMs != null
-        ? `${(elapsedMs / 1000).toFixed(1)}s`
-        : null;
+    const done = steps.filter((s) => s.status === "done").length;
+    const skipped = steps.filter((s) => s.status === "skipped").length;
+    const errors = steps.filter((s) => s.status === "error");
+    const elapsed = elapsedMs != null ? `${(elapsedMs / 1000).toFixed(1)}s` : null;
     // Auto-exit in CI mode
     useEffect(() => {
         if (isCI) {
@@ -39,75 +45,79 @@ export default function Summary({ steps, dryRun, projectName, stack, elapsedMs }
     const installHint = getInstallHint(stack);
     return (React.createElement(Box, { flexDirection: "column" },
         React.createElement(Text, { bold: true, color: errors.length > 0 ? theme.warning : theme.success },
-            dryRun ? '\u25cb Dry run complete' : '\u2713 Project scaffolded',
+            dryRun ? "\u25cb Dry run complete" : "\u2713 Project scaffolded",
             elapsed && React.createElement(Text, { color: theme.muted },
-                "  Completed in ",
+                " Completed in ",
                 elapsed)),
         React.createElement(Box, { marginTop: 1 },
-            React.createElement(Text, { color: theme.muted }, "  Project: "),
+            React.createElement(Text, { color: theme.muted }, " Project: "),
             React.createElement(Text, { color: theme.primary, bold: true }, projectName),
             stack && React.createElement(Text, { color: theme.muted },
-                "  (",
+                " (",
                 stack,
                 ")")),
         dryRun && (React.createElement(Box, { marginTop: 1 },
-            React.createElement(Text, { color: theme.warning, bold: true }, "  No changes were made (dry run)"))),
-        React.createElement(Box, { marginTop: 1, flexDirection: "column" }, steps.map(step => (React.createElement(Box, { key: step.id, marginLeft: 2 }, step.status === 'done' ? (React.createElement(Text, { color: theme.success },
-            '\u2713',
+            React.createElement(Text, { color: theme.warning, bold: true },
+                " ",
+                "No changes were made (dry run)"))),
+        React.createElement(Box, { marginTop: 1, flexDirection: "column" }, steps.map((step) => (React.createElement(Box, { key: step.id, marginLeft: 2 }, step.status === "done" ? (React.createElement(Text, { color: theme.success },
+            "\u2713",
             " ",
             step.label,
-            step.detail ? React.createElement(Text, { color: theme.muted, dimColor: true },
-                "  ",
-                step.detail) : null)) : step.status === 'skipped' ? (React.createElement(Text, { color: theme.muted },
-            '\u2013',
+            step.detail ? (React.createElement(Text, { color: theme.muted, dimColor: true },
+                " ",
+                step.detail)) : null)) : step.status === "skipped" ? (React.createElement(Text, { color: theme.muted },
+            "\u2013",
             " ",
             step.label,
             step.detail ? React.createElement(Text, { dimColor: true },
-                "  ",
-                step.detail) : null)) : step.status === 'error' ? (React.createElement(Text, { color: theme.error },
-            '\u2717',
+                " ",
+                step.detail) : null)) : step.status === "error" ? (React.createElement(Text, { color: theme.error },
+            "\u2717",
             " ",
             step.label,
-            step.detail ? React.createElement(Text, { color: theme.muted, dimColor: true },
-                "  ",
-                step.detail) : null)) : null)))),
+            step.detail ? (React.createElement(Text, { color: theme.muted, dimColor: true },
+                " ",
+                step.detail)) : null)) : null)))),
         React.createElement(Box, { marginTop: 1, flexDirection: "column" },
             React.createElement(Text, { color: theme.success },
-                "  ",
-                '\u2713',
+                " ",
+                "\u2713",
                 " ",
                 done,
                 " steps completed"),
             skipped > 0 && (React.createElement(Text, { color: theme.muted },
-                "  ",
-                '\u2013',
+                " ",
+                "\u2013",
                 " ",
                 skipped,
                 " steps skipped")),
             errors.length > 0 && (React.createElement(Box, { flexDirection: "column" },
                 React.createElement(Text, { color: theme.error },
-                    "  ",
-                    '\u2717',
+                    " ",
+                    "\u2717",
                     " ",
                     errors.length,
                     " errors:"),
-                errors.map(e => (React.createElement(Text, { key: `err-${e.id}`, color: theme.error },
-                    "    ",
-                    '\u2022',
+                errors.map((e) => (React.createElement(Text, { key: `err-${e.id}`, color: theme.error },
+                    " ",
+                    "\u2022",
                     " ",
                     e.label,
                     ": ",
                     e.detail)))))),
         !dryRun && errors.length === 0 && (React.createElement(Box, { marginTop: 1, flexDirection: "column" },
-            React.createElement(Text, { color: theme.muted, bold: true }, "  Next steps:"),
+            React.createElement(Text, { color: theme.muted, bold: true },
+                " ",
+                "Next steps:"),
             React.createElement(Text, { color: theme.primary },
-                "    cd ",
+                " cd ",
                 projectName),
             installHint && React.createElement(Text, { color: theme.primary },
-                "    ",
+                " ",
                 installHint),
-            React.createElement(Text, { color: theme.primary }, "    npx javi-ai sync"),
-            React.createElement(Text, { color: theme.primary }, "    javi-forge doctor"))),
+            React.createElement(Text, { color: theme.primary }, " npx javi-ai sync"),
+            React.createElement(Text, { color: theme.primary }, " javi-forge doctor"))),
         React.createElement(Box, { marginTop: 1 },
             React.createElement(Text, { color: theme.muted, dimColor: true }, "Press Enter to exit"))));
 }

package/dist/ui/Welcome.d.ts

@@ -1,4 +1,4 @@
-import React from 'react';
+import React from "react";
 interface Props {
     onDone: () => void;
 }

package/dist/ui/Welcome.js

@@ -1,9 +1,9 @@
-import React, { useEffect } from 'react';
-import { Box, Text } from 'ink';
-import Spinner from 'ink-spinner';
-import Header from './Header.js';
-import { theme } from './theme.js';
-import { useCIMode } from './CIContext.js';
+import { Box, Text } from "ink";
+import Spinner from "ink-spinner";
+import React, { useEffect } from "react";
+import { useCIMode } from "./CIContext.js";
+import Header from "./Header.js";
+import { theme } from "./theme.js";
 export default function Welcome({ onDone }) {
     const isCI = useCIMode();
     useEffect(() => {
@@ -18,28 +18,27 @@ export default function Welcome({ onDone }) {
             React.createElement(Box, { marginTop: 1, flexDirection: "column" },
                 React.createElement(Text, null,
                     React.createElement(Text, { color: theme.primary },
-                        '\u25c6',
-                        " Templates  "),
+                        "\u25c6",
+                        " Templates "),
                     React.createElement(Text, { color: theme.muted }, " Go, Java, Node, Python, Rust CI")),
                 React.createElement(Text, null,
                     React.createElement(Text, { color: theme.success },
-                        '\u25c6',
-                        " Memory     "),
+                        "\u25c6",
+                        " Memory "),
                     React.createElement(Text, { color: theme.muted }, " Engram, Obsidian Brain")),
                 React.createElement(Text, null,
                     React.createElement(Text, { color: theme.accent },
-                        '\u25c6',
-                        " SDD        "),
+                        "\u25c6",
+                        " SDD "),
                     React.createElement(Text, { color: theme.muted }, " Spec-Driven Development")),
                 React.createElement(Text, null,
                     React.createElement(Text, { color: theme.warning },
-                        '\u25c6',
-                        " Review     "),
+                        "\u25c6",
+                        " Review "),
                     React.createElement(Text, { color: theme.muted }, " GHAGGA code review"))),
             React.createElement(Box, { marginTop: 1 },
                 React.createElement(Text, { color: theme.muted },
                     React.createElement(Spinner, { type: "dots" }),
-                    ' ',
-                    "Detecting your environment...")))));
+                    " Detecting your environment...")))));
 }
 //# sourceMappingURL=Welcome.js.map

package/dist/ui/theme.d.ts

@@ -6,5 +6,5 @@ export declare const theme: {
     readonly muted: "gray";
     readonly accent: "magenta";
 };
-export type ThemeColor = typeof theme[keyof typeof theme];
+export type ThemeColor = (typeof theme)[keyof typeof theme];
 //# sourceMappingURL=theme.d.ts.map

package/dist/ui/theme.js

@@ -1,9 +1,9 @@
 export const theme = {
-    primary: '#f97316', // orange
-    success: 'green',
-    warning: 'yellow',
-    error: 'red',
-    muted: 'gray',
-    accent: 'magenta',
+    primary: "#f97316", // orange
+    success: "green",
+    warning: "yellow",
+    error: "red",
+    muted: "gray",
+    accent: "magenta",
 };
 //# sourceMappingURL=theme.js.map

package/lib/common.psm1

@@ -0,0 +1,167 @@
+# =============================================================================
+# lib/common.psm1 - Shared functions for javi-forge (PowerShell)
+# =============================================================================
+# Mirror of lib/common.sh for Windows / PowerShell users.
+#
+# Import from scripts:   Import-Module "$PSScriptRoot/../lib/common.psm1" -Force
+# Import from ci-local:  Import-Module "$PSScriptRoot/../lib/common.psm1" -Force
+#
+# Keep this file in sync with lib/common.sh. The function signatures use
+# PowerShell verb-noun conventions but the BEHAVIOUR must match the bash
+# version. Diff against lib/common.sh on every change.
+# =============================================================================
+
+Set-StrictMode -Version Latest
+
+# =============================================================================
+# Logging helpers
+# =============================================================================
+function Write-Ok    { param([string]$Message) Write-Host "  [OK]   $Message" -ForegroundColor Green }
+function Write-Warn  { param([string]$Message) Write-Host "  [WARN] $Message" -ForegroundColor Yellow }
+function Write-Fail  { param([string]$Message) Write-Host "  [FAIL] $Message" -ForegroundColor Red }
+function Write-Info  { param([string]$Message) Write-Host "  [INFO] $Message" -ForegroundColor Cyan }
+function Write-Step  { param([string]$Message) Write-Host $Message -ForegroundColor Yellow }
+
+# =============================================================================
+# Backup-FileIfExists - Create a .bak copy of a file before overwriting
+# =============================================================================
+function Backup-FileIfExists {
+    param([Parameter(Mandatory)][string]$Path)
+    if (Test-Path -LiteralPath $Path -PathType Leaf) {
+        Copy-Item -LiteralPath $Path -Destination "$Path.bak" -Force
+        Write-Host "  Backed up existing $Path" -ForegroundColor Yellow
+    }
+}
+
+# =============================================================================
+# Get-Stack - Auto-detect project technology stack
+# =============================================================================
+# Returns a hashtable with: StackType, BuildTool, JavaVersion
+# Detects: java-gradle, java-maven, node, python, go, rust
+# Mirrors detect_stack() from lib/common.sh.
+# =============================================================================
+function Get-Stack {
+    param([string]$ProjectDir = '.')
+
+    $result = @{
+        StackType   = 'unknown'
+        BuildTool   = ''
+        JavaVersion = '21'
+    }
+
+    # Allow user override via $env:CI_LOCAL_STACK. Mirrors the bash side.
+    $override = $env:CI_LOCAL_STACK
+    if ($override) {
+        $valid = @('node', 'python', 'go', 'rust', 'java-gradle', 'java-maven')
+        if ($valid -contains $override) {
+            $result.StackType = $override
+            switch ($override) {
+                'node' {
+                    if      (Test-Path -LiteralPath (Join-Path $ProjectDir 'pnpm-lock.yaml') -PathType Leaf) { $result.BuildTool = 'pnpm' }
+                    elseif  (Test-Path -LiteralPath (Join-Path $ProjectDir 'yarn.lock')      -PathType Leaf) { $result.BuildTool = 'yarn' }
+                    else    { $result.BuildTool = 'npm' }
+                }
+                'python' {
+                    if     (Test-Path -LiteralPath (Join-Path $ProjectDir 'uv.lock')     -PathType Leaf) { $result.BuildTool = 'uv' }
+                    elseif (Test-Path -LiteralPath (Join-Path $ProjectDir 'poetry.lock') -PathType Leaf) { $result.BuildTool = 'poetry' }
+                    elseif (Test-Path -LiteralPath (Join-Path $ProjectDir 'Pipfile')     -PathType Leaf) { $result.BuildTool = 'pipenv' }
+                    else   { $result.BuildTool = 'pip' }
+                }
+                'go'          { $result.BuildTool = 'go' }
+                'rust'        { $result.BuildTool = 'cargo' }
+                'java-gradle' { $result.BuildTool = 'gradle' }
+                'java-maven'  { $result.BuildTool = 'maven' }
+            }
+            return $result
+        }
+        Write-Warning "CI_LOCAL_STACK='$override' is not recognised. Falling back to auto-detection."
+    }
+
+    # Java + Gradle
+    $gradleKts = Join-Path $ProjectDir 'build.gradle.kts'
+    $gradle    = Join-Path $ProjectDir 'build.gradle'
+    if ((Test-Path -LiteralPath $gradleKts -PathType Leaf) -or
+        (Test-Path -LiteralPath $gradle    -PathType Leaf)) {
+        $result.StackType = 'java-gradle'
+        $result.BuildTool = 'gradle'
+        # Extract Java version from build file (regex parity with sh version)
+        $sourceFile = if (Test-Path -LiteralPath $gradleKts -PathType Leaf) { $gradleKts } else { $gradle }
+        try {
+            $content = Get-Content -LiteralPath $sourceFile -Raw -ErrorAction Stop
+            if ($sourceFile -like '*.kts') {
+                if ($content -match 'languageVersion\s*=\s*JavaLanguageVersion\.of\(\s*(\d+)') {
+                    $result.JavaVersion = $Matches[1]
+                }
+            } else {
+                if ($content -match 'sourceCompatibility\s*=\s*[''"]?\s*(\d+)') {
+                    $result.JavaVersion = $Matches[1]
+                }
+            }
+        } catch {
+            # Keep default '21'
+        }
+        return $result
+    }
+
+    # Java + Maven
+    if (Test-Path -LiteralPath (Join-Path $ProjectDir 'pom.xml') -PathType Leaf) {
+        $result.StackType = 'java-maven'
+        $result.BuildTool = 'maven'
+        return $result
+    }
+
+    # Node.js
+    if (Test-Path -LiteralPath (Join-Path $ProjectDir 'package.json') -PathType Leaf) {
+        $result.StackType = 'node'
+        if      (Test-Path -LiteralPath (Join-Path $ProjectDir 'pnpm-lock.yaml') -PathType Leaf) { $result.BuildTool = 'pnpm' }
+        elseif  (Test-Path -LiteralPath (Join-Path $ProjectDir 'yarn.lock')      -PathType Leaf) { $result.BuildTool = 'yarn' }
+        else    { $result.BuildTool = 'npm' }
+        return $result
+    }
+
+    # Python — uv > poetry > pipenv > pip
+    $pyMarker = @('pyproject.toml', 'setup.py', 'requirements.txt') |
+        ForEach-Object { Join-Path $ProjectDir $_ } |
+        Where-Object   { Test-Path -LiteralPath $_ -PathType Leaf } |
+        Select-Object -First 1
+    if ($pyMarker) {
+        $result.StackType = 'python'
+        if     (Test-Path -LiteralPath (Join-Path $ProjectDir 'uv.lock')     -PathType Leaf) { $result.BuildTool = 'uv' }
+        elseif (Test-Path -LiteralPath (Join-Path $ProjectDir 'poetry.lock') -PathType Leaf) { $result.BuildTool = 'poetry' }
+        elseif (Test-Path -LiteralPath (Join-Path $ProjectDir 'Pipfile')     -PathType Leaf) { $result.BuildTool = 'pipenv' }
+        else   { $result.BuildTool = 'pip' }
+        return $result
+    }
+
+    # Go
+    if (Test-Path -LiteralPath (Join-Path $ProjectDir 'go.mod') -PathType Leaf) {
+        $result.StackType = 'go'
+        $result.BuildTool = 'go'
+        return $result
+    }
+
+    # Rust
+    if (Test-Path -LiteralPath (Join-Path $ProjectDir 'Cargo.toml') -PathType Leaf) {
+        $result.StackType = 'rust'
+        $result.BuildTool = 'cargo'
+        return $result
+    }
+
+    return $result
+}
+
+# =============================================================================
+# Test-CommandExists - Returns $true if a command is available in PATH
+# =============================================================================
+# Replaces "command -v X" from bash.
+# =============================================================================
+function Test-CommandExists {
+    param([Parameter(Mandatory)][string]$Name)
+    [bool](Get-Command -Name $Name -ErrorAction SilentlyContinue)
+}
+
+Export-ModuleMember -Function `
+    Write-Ok, Write-Warn, Write-Fail, Write-Info, Write-Step, `
+    Backup-FileIfExists, `
+    Get-Stack, `
+    Test-CommandExists

package/lib/common.sh

@@ -95,6 +95,36 @@ detect_stack() {
     BUILD_TOOL=""
     JAVA_VERSION="21"
 
+    # Allow user to override auto-detection. Useful for hybrid projects
+    # (Node + Go) where the first-match rule otherwise locks the choice.
+    # Recognised values: node, python, go, rust, java-gradle, java-maven.
+    if [ -n "${CI_LOCAL_STACK:-}" ]; then
+        case "$CI_LOCAL_STACK" in
+            node|python|go|rust|java-gradle|java-maven)
+                STACK_TYPE="$CI_LOCAL_STACK"
+                case "$STACK_TYPE" in
+                    node)
+                        if [ -f "$project_dir/pnpm-lock.yaml" ]; then BUILD_TOOL="pnpm"
+                        elif [ -f "$project_dir/yarn.lock" ]; then BUILD_TOOL="yarn"
+                        else BUILD_TOOL="npm"; fi ;;
+                    python)
+                        if [ -f "$project_dir/uv.lock" ]; then BUILD_TOOL="uv"
+                        elif [ -f "$project_dir/poetry.lock" ]; then BUILD_TOOL="poetry"
+                        elif [ -f "$project_dir/Pipfile" ]; then BUILD_TOOL="pipenv"
+                        else BUILD_TOOL="pip"; fi ;;
+                    go)          BUILD_TOOL="go" ;;
+                    rust)        BUILD_TOOL="cargo" ;;
+                    java-gradle) BUILD_TOOL="gradle" ;;
+                    java-maven)  BUILD_TOOL="maven" ;;
+                esac
+                return
+                ;;
+            *)
+                echo "WARNING: CI_LOCAL_STACK='$CI_LOCAL_STACK' is not recognised. Falling back to auto-detection." >&2
+                ;;
+        esac
+    fi
+
     # Java + Gradle
     if [[ -f "$project_dir/build.gradle" || -f "$project_dir/build.gradle.kts" ]]; then
         STACK_TYPE="java-gradle"