futrou 2.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 futrou.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,27 @@
+# Futrou CLI
+
+The **Futrou CLI** allows you to manage your Futrou projects and infrastructure from your terminal.
+
+## Installation
+To install the CLI globally, run:
+
+```bash
+npm install -g futrou
+```
+
+Or use any other favorite package manager:
+
+```bash
+yarn global add futrou
+```
+
+## Usage
+
+Once installed, you can access the CLI using the `npx futrou` command.
+
+## Documentation
+
+For more detailed guides on how to use the CLI, please visit [docs.futrou.com](https://docs.futrou.com).
+
+## License
+[MIT License](LICENSE)

package/index.cjs

@@ -0,0 +1,46 @@
+#!/usr/bin/env node
+'use strict';
+
+const { execFileSync } = require('child_process');
+const path = require('path');
+const os = require('os');
+
+const pkg = require('./package.json');
+const DIST_NAME = pkg.name;
+const NAME = pkg.productName || pkg.name;
+
+const PLATFORMS = [
+  { platform: 'linux',  arch: 'x64',   goos: 'linux',   goarch: 'amd64' },
+  { platform: 'linux',  arch: 'arm64',  goos: 'linux',   goarch: 'arm64' },
+  { platform: 'darwin', arch: 'x64',   goos: 'darwin',  goarch: 'amd64' },
+  { platform: 'darwin', arch: 'arm64',  goos: 'darwin',  goarch: 'arm64' },
+  { platform: 'win32',  arch: 'x64',   goos: 'windows', goarch: 'amd64' },
+  { platform: 'win32',  arch: 'arm64',  goos: 'windows', goarch: 'arm64' },
+];
+
+function getBinaryName() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  const entry = PLATFORMS.find(e => e.platform === platform && e.arch === arch);
+
+  if (!entry) {
+    const list = PLATFORMS.map(e => `  ${e.platform}/${e.arch}`).join('\n');
+    process.stderr.write(
+      `Unsupported platform: ${platform}/${arch}\n` +
+      `${NAME} supports:\n${list}\n`
+    );
+    process.exit(1);
+  }
+
+  const ext = platform === 'win32' ? '.exe' : '';
+  return `${DIST_NAME}-${entry.goos}-${entry.goarch}${ext}`;
+}
+
+const bin = path.join(__dirname, 'bin', getBinaryName());
+
+try {
+  execFileSync(bin, process.argv.slice(2), { stdio: 'inherit' });
+} catch (err) {
+  process.exit(err.status ?? 1);
+}

package/index.d.ts

@@ -0,0 +1 @@
+export {};

package/install.ps1

@@ -0,0 +1,186 @@
+#!/usr/bin/env pwsh
+param(
+  [String]$Version = "latest",
+  [Switch]$NoPathUpdate = $false,
+  [Switch]$DownloadWithoutCurl = $false
+)
+
+$ErrorActionPreference = "Stop"
+
+# ---------------------------------------------------------------------------
+# Colors
+# ---------------------------------------------------------------------------
+$C_RESET  = [char]27 + "[0m"
+$C_GREEN  = [char]27 + "[1;32m"
+$C_YELLOW = [char]27 + "[0;33m"
+$C_DIM    = [char]27 + "[2m"
+$C_RED    = [char]27 + "[0;31m"
+
+function Write-Info   { param($msg) Write-Output "${C_DIM}${msg}${C_RESET}" }
+function Write-Success{ param($msg) Write-Output "${C_GREEN}${msg}${C_RESET}" }
+function Write-Warn   { param($msg) Write-Output "${C_YELLOW}${msg}${C_RESET}" }
+function Write-Fail   { param($msg) Write-Output "${C_RED}error: ${msg}${C_RESET}"; exit 1 }
+
+# ---------------------------------------------------------------------------
+# Detect architecture from registry (reliable under ARM64 emulation)
+# ---------------------------------------------------------------------------
+$Arch = (Get-ItemProperty 'HKLM:\SYSTEM\CurrentControlSet\Control\Session Manager\Environment').PROCESSOR_ARCHITECTURE
+
+if (-not ($Arch -eq "AMD64" -or $Arch -eq "ARM64")) {
+  Write-Fail "Futrou CLI only supports x86_64 and ARM64 Windows."
+}
+
+$GoArch = if ($Arch -eq "ARM64") { "arm64" } else { "amd64" }
+$Target = "windows-$GoArch"
+
+# ---------------------------------------------------------------------------
+# Resolve version
+# ---------------------------------------------------------------------------
+if ($Version -match "^\d+\.\d+\.\d+$")  { $Version = "v$Version" }
+
+$BaseURL  = "https://github.com/futrou/futrou-cli/releases"
+$FileName = "futrou-$Target.exe"
+$URL = if ($Version -eq "latest") {
+  "$BaseURL/latest/download/$FileName"
+} else {
+  "$BaseURL/download/$Version/$FileName"
+}
+
+# ---------------------------------------------------------------------------
+# Install location  (%USERPROFILE%\.futrou\bin\futrou.exe)
+# ---------------------------------------------------------------------------
+$InstallRoot = if ($env:FUTROU_INSTALL) { $env:FUTROU_INSTALL } else { "$HOME\.futrou" }
+$BinDir      = "$InstallRoot\bin"
+$Exe         = "$BinDir\futrou.exe"
+
+$null = New-Item -ItemType Directory -Force -Path $BinDir
+
+# ---------------------------------------------------------------------------
+# Detect existing installation and decide action label
+# ---------------------------------------------------------------------------
+$Action = "Installing"
+$CurrentVersion = $null
+
+if (Test-Path $Exe) {
+  try {
+    $raw = & $Exe --version 2>$null
+    if ($raw -match '(\d+\.\d+\.\d+)') { $CurrentVersion = $Matches[1] }
+  } catch { }
+}
+
+if ($CurrentVersion -and $Version -ne "latest") {
+  $TargetVersion = $Version.TrimStart('v')
+  if ($CurrentVersion -eq $TargetVersion) {
+    Write-Info "Futrou CLI v$CurrentVersion is already installed at $Exe"
+    exit 0
+  }
+  $cur = [Version]$CurrentVersion
+  $tgt = [Version]$TargetVersion
+  $Action = if ($tgt -gt $cur) { "Upgrading" } elseif ($tgt -lt $cur) { "Downgrading" } else { "Reinstalling" }
+} elseif ($CurrentVersion) {
+  $Action = "Upgrading"
+}
+
+$DisplayVersion = if ($Version -eq "latest") { "latest" } else { $Version.TrimStart('v') }
+
+if ($CurrentVersion) {
+  Write-Info "$Action Futrou CLI v$CurrentVersion → v$DisplayVersion"
+} else {
+  Write-Info "Installing Futrou CLI v$DisplayVersion"
+}
+
+# ---------------------------------------------------------------------------
+# Download
+# ---------------------------------------------------------------------------
+$TmpExe = "$BinDir\futrou-tmp.exe"
+Remove-Item -Force $TmpExe -ErrorAction SilentlyContinue
+
+$downloaded = $false
+
+if (-not $DownloadWithoutCurl) {
+  try {
+    curl.exe "-#SfLo" $TmpExe $URL
+    if ($LASTEXITCODE -eq 0) { $downloaded = $true }
+  } catch { }
+}
+
+if (-not $downloaded) {
+  try {
+    Invoke-RestMethod -Uri $URL -OutFile $TmpExe
+    $downloaded = $true
+  } catch {
+    Write-Fail "Could not download $URL`n$_"
+  }
+}
+
+if (-not (Test-Path $TmpExe)) {
+  Write-Fail "Download produced no file. Did antivirus delete it?"
+}
+
+try { Remove-Item -Force $Exe -ErrorAction SilentlyContinue } catch { }
+Move-Item -Force $TmpExe $Exe
+
+# ---------------------------------------------------------------------------
+# Verify
+# ---------------------------------------------------------------------------
+$InstalledVersion = $null
+try {
+  $raw = & $Exe --version 2>$null
+  if ($raw -match '(\d+\.\d+\.\d+)') { $InstalledVersion = $Matches[1] }
+} catch { }
+
+if (-not $InstalledVersion) {
+  Write-Fail "Installed binary did not run correctly."
+}
+
+$ActionPast = switch ($Action) {
+  "Installing"  { "installed" }
+  "Upgrading"   { "upgraded" }
+  "Downgrading" { "downgraded" }
+  default       { "installed" }
+}
+
+Write-Success "Futrou CLI v$InstalledVersion was $ActionPast to $Exe"
+
+# ---------------------------------------------------------------------------
+# PATH update
+# ---------------------------------------------------------------------------
+function Get-UserPath {
+  $key = (Get-Item 'HKCU:').OpenSubKey('Environment')
+  $key.GetValue('Path', $null, [Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames)
+}
+
+function Set-UserPath([String]$Value) {
+  $key = (Get-Item 'HKCU:').OpenSubKey('Environment', $true)
+  $kind = if ($Value.Contains('%')) {
+    [Microsoft.Win32.RegistryValueKind]::ExpandString
+  } else {
+    [Microsoft.Win32.RegistryValueKind]::String
+  }
+  $key.SetValue('Path', $Value, $kind)
+
+  if (-not ("Win32.NativeMethods" -as [Type])) {
+    Add-Type -Namespace Win32 -Name NativeMethods -MemberDefinition @"
+[DllImport("user32.dll", SetLastError=true, CharSet=CharSet.Auto)]
+public static extern IntPtr SendMessageTimeout(IntPtr hWnd, uint Msg, UIntPtr wParam,
+    string lParam, uint fuFlags, uint uTimeout, out UIntPtr lpdwResult);
+"@
+  }
+  $result = [UIntPtr]::Zero
+  [Win32.NativeMethods]::SendMessageTimeout(
+    [IntPtr]0xffff, 0x1a, [UIntPtr]::Zero, "Environment", 2, 5000, [ref]$result
+  ) | Out-Null
+}
+
+if (-not $NoPathUpdate) {
+  $CurrentPath = (Get-UserPath) -split ';' | Where-Object { $_ -ne '' }
+  if ($CurrentPath -notcontains $BinDir) {
+    $NewPath = ($CurrentPath + $BinDir) -join ';'
+    Set-UserPath $NewPath
+    $env:PATH = $env:PATH + ";$BinDir"
+    Write-Info "Added $BinDir to your PATH"
+  }
+}
+
+Write-Output ""
+Write-Output "To get started, restart your terminal, then run: futrou --help"

package/install.sh

@@ -0,0 +1,246 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# On Windows under Git Bash / MINGW, delegate to PowerShell
+if [[ ${OS:-} = Windows_NT ]]; then
+  if [[ ${MSYSTEM:-} != MINGW64* ]]; then
+    powershell -c "irm https://raw.githubusercontent.com/futrou/futrou-cli/main/install.ps1 | iex"
+    exit $?
+  fi
+fi
+
+# ---------------------------------------------------------------------------
+# Colors (only when stdout is a terminal)
+# ---------------------------------------------------------------------------
+Color_Off=''
+Red=''
+Green=''
+Yellow=''
+Dim=''
+Bold_White=''
+Bold_Green=''
+
+if [[ -t 1 ]]; then
+  Color_Off='\033[0m'
+  Red='\033[0;31m'
+  Green='\033[0;32m'
+  Yellow='\033[0;33m'
+  Dim='\033[0;2m'
+  Bold_Green='\033[1;32m'
+  Bold_White='\033[1m'
+fi
+
+error()     { echo -e "${Red}error${Color_Off}:" "$@" >&2; exit 1; }
+info()      { echo -e "${Dim}$@${Color_Off}"; }
+info_bold() { echo -e "${Bold_White}$@${Color_Off}"; }
+success()   { echo -e "${Bold_Green}$@${Color_Off}"; }
+warn()      { echo -e "${Yellow}$@${Color_Off}"; }
+
+# ---------------------------------------------------------------------------
+# Detect platform
+# ---------------------------------------------------------------------------
+platform=$(uname -ms)
+
+case $platform in
+'Darwin x86_64')  target=darwin-amd64  ;;
+'Darwin arm64')   target=darwin-arm64  ;;
+'Linux x86_64')   target=linux-amd64   ;;
+'Linux aarch64' | 'Linux arm64') target=linux-arm64 ;;
+'MINGW64'*'ARM64'* | 'MINGW64'*'aarch64'*) target=windows-arm64 ;;
+'MINGW64'*)       target=windows-amd64 ;;
+*)
+  error "Unsupported platform: $platform
+Futrou CLI supports: linux/x86_64, linux/aarch64, darwin/x86_64, darwin/arm64, windows/x86_64, windows/arm64"
+  ;;
+esac
+
+# Rosetta 2 detection on macOS
+if [[ $target == darwin-amd64 ]]; then
+  if [[ $(sysctl -n sysctl.proc_translated 2>/dev/null) == 1 ]]; then
+    target=darwin-arm64
+    info "Rosetta 2 detected — downloading futrou for $target instead"
+  fi
+fi
+
+exe_ext=''
+[[ $target == windows-* ]] && exe_ext='.exe'
+
+# ---------------------------------------------------------------------------
+# Resolve version
+# ---------------------------------------------------------------------------
+GITHUB=${GITHUB:-"https://github.com"}
+REPO="$GITHUB/futrou/futrou-cli"
+
+if [[ $# -eq 0 ]]; then
+  version="latest"
+else
+  version="$1"
+fi
+
+# Normalise: accept "1.2.3" or "v1.2.3" → "v1.2.3"
+if [[ $version =~ ^[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
+  version="v$version"
+fi
+
+if [[ $version == "latest" ]]; then
+  download_url="$REPO/releases/latest/download/futrou-$target$exe_ext"
+else
+  download_url="$REPO/releases/download/$version/futrou-$target$exe_ext"
+fi
+
+# ---------------------------------------------------------------------------
+# Install location  (~/.futrou/bin/futrou)
+# ---------------------------------------------------------------------------
+install_env=FUTROU_INSTALL
+install_dir=${FUTROU_INSTALL:-$HOME/.futrou}
+bin_dir="$install_dir/bin"
+exe="$bin_dir/futrou$exe_ext"
+
+mkdir -p "$bin_dir" || error "Failed to create install directory \"$bin_dir\""
+
+# ---------------------------------------------------------------------------
+# Detect existing installation and decide action label
+# ---------------------------------------------------------------------------
+action="Installing"
+current_version=""
+
+if [[ -x "$exe" ]]; then
+  current_version=$("$exe" --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1 || true)
+fi
+
+if [[ -n "$current_version" && "$version" != "latest" ]]; then
+  target_version="${version#v}"
+  if [[ "$current_version" == "$target_version" ]]; then
+    info "Futrou CLI v$current_version is already installed at $exe"
+    exit 0
+  fi
+
+  # Compare semver: split into parts and compare numerically
+  IFS='.' read -r cur_maj cur_min cur_pat <<< "$current_version"
+  IFS='.' read -r tgt_maj tgt_min tgt_pat <<< "$target_version"
+
+  if (( tgt_maj > cur_maj )) || \
+     (( tgt_maj == cur_maj && tgt_min > cur_min )) || \
+     (( tgt_maj == cur_maj && tgt_min == cur_min && tgt_pat > cur_pat )); then
+    action="Upgrading"
+  else
+    action="Downgrading"
+  fi
+elif [[ -n "$current_version" ]]; then
+  action="Upgrading"
+fi
+
+display_version="${version#v}"
+[[ $version == "latest" ]] && display_version="latest"
+
+if [[ -n "$current_version" ]]; then
+  info "$action Futrou CLI v$current_version → v$display_version"
+else
+  info "Installing Futrou CLI v$display_version"
+fi
+
+# ---------------------------------------------------------------------------
+# Download
+# ---------------------------------------------------------------------------
+if command -v curl >/dev/null 2>&1; then
+  curl --fail --location --progress-bar --output "$exe" "$download_url" ||
+    error "Failed to download from \"$download_url\""
+elif command -v wget >/dev/null 2>&1; then
+  wget -q --show-progress -O "$exe" "$download_url" ||
+    error "Failed to download from \"$download_url\""
+else
+  error "curl or wget is required to install Futrou CLI"
+fi
+
+chmod +x "$exe"
+
+# ---------------------------------------------------------------------------
+# Verify
+# ---------------------------------------------------------------------------
+installed_version=$("$exe" --version 2>/dev/null | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1 || true)
+[[ -z $installed_version ]] && error "Downloaded binary failed to run"
+
+success "Futrou CLI v$installed_version was ${action,,} to $exe"
+
+# ---------------------------------------------------------------------------
+# PATH setup (skip if already in PATH)
+# ---------------------------------------------------------------------------
+if command -v futrou >/dev/null 2>&1; then
+  echo
+  info "Run 'futrou --help' to get started"
+  exit 0
+fi
+
+tildify() {
+  [[ $1 == $HOME/* ]] && echo "~/${1#$HOME/}" || echo "$1"
+}
+
+tilde_bin_dir=$(tildify "$bin_dir")
+quoted_install_dir="\"${install_dir//\"/\\\"}\""
+[[ $quoted_install_dir == \"$HOME/* ]] && quoted_install_dir="${quoted_install_dir/$HOME\//\$HOME/}"
+
+echo
+
+case $(basename "${SHELL:-bash}") in
+fish)
+  fish_config=$HOME/.config/fish/config.fish
+  tilde_fish_config=$(tildify "$fish_config")
+  commands=(
+    "set --export $install_env $quoted_install_dir"
+    "set --export PATH \$$install_env/bin \$PATH"
+  )
+  if [[ -w $fish_config ]]; then
+    { echo; echo '# futrou'; for cmd in "${commands[@]}"; do echo "$cmd"; done; } >> "$fish_config"
+    info "Added \"$tilde_bin_dir\" to \$PATH in \"$tilde_fish_config\""
+    info_bold "  source $tilde_fish_config"
+  else
+    info "Manually add to $tilde_fish_config:"
+    for cmd in "${commands[@]}"; do info_bold "  $cmd"; done
+  fi
+  ;;
+zsh)
+  zsh_config=$HOME/.zshrc
+  tilde_zsh_config=$(tildify "$zsh_config")
+  commands=(
+    "export $install_env=$quoted_install_dir"
+    "export PATH=\"\$$install_env/bin:\$PATH\""
+  )
+  if [[ -w $zsh_config ]]; then
+    { echo; echo '# futrou'; for cmd in "${commands[@]}"; do echo "$cmd"; done; } >> "$zsh_config"
+    info "Added \"$tilde_bin_dir\" to \$PATH in \"$tilde_zsh_config\""
+    info_bold "  exec \$SHELL"
+  else
+    info "Manually add to $tilde_zsh_config:"
+    for cmd in "${commands[@]}"; do info_bold "  $cmd"; done
+  fi
+  ;;
+bash)
+  commands=(
+    "export $install_env=$quoted_install_dir"
+    "export PATH=\"\$$install_env/bin:\$PATH\""
+  )
+  set_manually=true
+  for bash_config in "$HOME/.bash_profile" "$HOME/.bashrc"; do
+    if [[ -w $bash_config ]]; then
+      { echo; echo '# futrou'; for cmd in "${commands[@]}"; do echo "$cmd"; done; } >> "$bash_config"
+      info "Added \"$tilde_bin_dir\" to \$PATH in \"$(tildify "$bash_config")\""
+      info_bold "  source $(tildify "$bash_config")"
+      set_manually=false
+      break
+    fi
+  done
+  if [[ $set_manually == true ]]; then
+    info "Manually add to ~/.bashrc:"
+    for cmd in "${commands[@]}"; do info_bold "  $cmd"; done
+  fi
+  ;;
+*)
+  info "Manually add \"$tilde_bin_dir\" to your \$PATH:"
+  info_bold "  export $install_env=$quoted_install_dir"
+  info_bold "  export PATH=\"\$$install_env/bin:\$PATH\""
+  ;;
+esac
+
+echo
+info "To get started, run:"
+info_bold "  futrou --help"

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "futrou",
+  "productName": "Futrou CLI",
+  "version": "2.0.0",
+  "description": "Futrou CLI - Deploy and manage Futrou Cloud from your terminal.",
+  "bin": {
+    "futrou": "./index.cjs",
+    "futrou-cli": "./index.cjs"
+  },
+  "types": "./index.d.ts",
+  "os": [
+    "linux",
+    "darwin",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "keywords": [
+    "futrou",
+    "cloud",
+    "deploy",
+    "cli"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/futrou/futrou-cli.git"
+  }
+}