@viadee/opencode-installation 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 viadee Unternehmensberatung AG
+
+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

@@ -1,3 +1,29 @@
-# Temporary Holding Version
+# viadee OpenCode Installation
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Installer scripts for **viadee OpenCode**, the viadee sbx kit that runs OpenCode
+in a Docker Sandbox with LiteLLM, websearch and OCR preconfigured. They are
+published to npm with every kit release only so they can be downloaded without
+authentication through jsDelivr; the package has no JavaScript entry point.
+
+## Einrichtung
+
+macOS / Linux:
+
+```bash
+curl -fsSL https://cdn.jsdelivr.net/npm/@viadee/opencode-installation/install.sh | bash
+```
+
+Windows (PowerShell):
+
+```powershell
+irm https://cdn.jsdelivr.net/npm/@viadee/opencode-installation/install.ps1 | iex
+```
+
+Das Skript installiert bei Bedarf sbx (Homebrew bzw. winget), schaltet die
+Telemetrie ab, meldet bei Docker an, erlaubt die viadee-Images, initialisiert
+die Netzwerk-Policy `balanced`, fragt den LiteLLM-Key ab, erklärt auf Wunsch
+eigene Keys pro Projekt (`sbx secret set litellm --sandbox <projekt>`) und
+richtet den Kurzbefehl `sbx run opencode` ein. Jeder Schritt ist wiederholbar.
+
+Anleitung und Problembehebung:
+[viadee OpenCode in Confluence](https://viadee.atlassian.net/wiki/spaces/APT/pages/3080093832).

package/install.ps1

@@ -0,0 +1,97 @@
+# Richtet viadee OpenCode (ein sbx-Kit) unter Windows ein.
+#
+#   irm https://cdn.jsdelivr.net/npm/@viadee/opencode-installation/install.ps1 | iex
+#
+# Jeder Schritt ist wiederholbar; bereits erledigte Schritte werden uebersprungen.
+# Bewusst nur ASCII: Windows PowerShell 5.1 dekodiert per irm geladene Skripte
+# ohne Zeichensatzangabe nicht als UTF-8.
+# Laeuft als Skriptblock, damit `return` bei `irm | iex` nicht das Fenster schliesst.
+& {
+    $ErrorActionPreference = 'Continue'
+    $Image = 'ghcr.io/viadee-internal/viadee-opencode-kit:latest'
+    $DocsUrl = 'https://viadee.atlassian.net/wiki/spaces/APT/pages/3080093832'
+
+    function Write-Step([string] $Text) { Write-Host "`n==> $Text" -ForegroundColor Cyan }
+    function Write-Info([string] $Text) { Write-Host "    $Text" }
+    function Confirm-Step([string] $Question) {
+        $reply = Read-Host "$Question [J/n]"
+        return -not ($reply -match '^[nN]')
+    }
+    # Wie Confirm-Step, aber ohne Eingabe gilt Nein.
+    function Confirm-Optional([string] $Question) {
+        $reply = Read-Host "$Question [j/N]"
+        return $reply -match '^[jJyY]'
+    }
+    function Assert-Success([string] $Command) {
+        if ($LASTEXITCODE -ne 0) { throw "$Command ist fehlgeschlagen (Exit-Code $LASTEXITCODE)." }
+    }
+
+    Write-Host "viadee OpenCode - Einrichtung`nAnleitung: $DocsUrl"
+
+    Write-Step 'Docker Sandbox (sbx)'
+    if (Get-Command sbx -ErrorAction SilentlyContinue) {
+        Write-Info 'sbx ist bereits installiert.'
+    } else {
+        if (-not (Get-Command winget -ErrorAction SilentlyContinue)) {
+            Write-Info "winget fehlt. Bitte sbx installieren und das Skript erneut ausfuehren: $DocsUrl"
+            return
+        }
+        winget install -h Docker.sbx
+        Assert-Success 'winget install Docker.sbx'
+        $env:Path = [Environment]::GetEnvironmentVariable('Path', 'Machine') + ';' + [Environment]::GetEnvironmentVariable('Path', 'User')
+        if (-not (Get-Command sbx -ErrorAction SilentlyContinue)) {
+            Write-Info 'sbx wurde installiert. Bitte eine neue PowerShell oeffnen und das Skript erneut ausfuehren.'
+            return
+        }
+    }
+
+    Write-Step 'Telemetrie an Docker abschalten'
+    [Environment]::SetEnvironmentVariable('SBX_NO_TELEMETRY', '1', 'User')
+    $env:SBX_NO_TELEMETRY = '1'
+    Write-Info 'Fuer den eigenen Benutzer gesetzt.'
+
+    Write-Step 'Bei Docker anmelden'
+    if (Confirm-Step 'sbx login ausfuehren? (ueberspringen mit n, falls bereits angemeldet)') {
+        sbx login
+        Assert-Success 'sbx login'
+    }
+
+    Write-Step 'Images aus dem viadee-GitHub erlauben'
+    $current = (sbx settings get kit.allowedSources 2>&1 | Out-String).Trim()
+    if ($current.Contains('"docker.io/"') -and $current.Contains('"ghcr.io/viadee-internal/"')) {
+        Write-Info 'Bereits erlaubt.'
+    } else {
+        if ($current) { Write-Info "Bisheriger Wert wird ersetzt: $current" }
+        # --% uebergibt den JSON-Wert unveraendert; ohne entfernt Windows PowerShell die Anfuehrungszeichen.
+        sbx --% settings set kit.allowedSources "[\"docker.io/\",\"ghcr.io/viadee-internal/\"]"
+        Assert-Success 'sbx settings set kit.allowedSources'
+    }
+
+    Write-Step 'Netzwerk-Policy festlegen (balanced)'
+    sbx policy init balanced
+    if ($LASTEXITCODE -ne 0) { Write-Info 'Die Policy ist bereits eingerichtet; uebersprungen.' }
+
+    Write-Step 'LiteLLM-Key hinterlegen'
+    Write-Info 'Der Key bleibt auf diesem Rechner; die Sandbox sieht ihn nie.'
+    if (Confirm-Step 'Key jetzt hinterlegen oder ersetzen? (ueberspringen mit n, falls bereits hinterlegt)') {
+        sbx secret set litellm
+        Assert-Success 'sbx secret set litellm'
+    }
+    if (Confirm-Optional 'Nutzt du je nach Projekt verschiedene LiteLLM-Keys (Projektnummern)?') {
+        Write-Info 'Der Key oben gilt fuer alle Projekte. Fuer ein Projekt mit eigener Projektnummer'
+        Write-Info 'einmalig einen eigenen Key fuer dessen Sandbox hinterlegen:'
+        Write-Info ''
+        Write-Info '    sbx secret set litellm --sandbox mein-projekt'
+        Write-Info ''
+        Write-Info 'Der Name muss zum Start passen: sbx run --name mein-projekt opencode'
+        Write-Info 'Aendern mit --force, entfernen mit: sbx secret rm litellm --sandbox mein-projekt'
+    }
+
+    Write-Step 'Kurzbefehl einrichten'
+    sbx settings set kit.shortcuts.opencode $Image
+    Assert-Success 'sbx settings set kit.shortcuts.opencode'
+    Write-Info 'sbx run opencode startet jetzt viadee OpenCode.'
+
+    Write-Host "`nFertig. Im Projektordner starten mit:`n`n    sbx run --name mein-projekt opencode`n"
+    Write-Host "Ohne Kurzbefehl: sbx run --name mein-projekt $Image"
+}

package/install.sh

@@ -0,0 +1,145 @@
+#!/usr/bin/env bash
+# Richtet viadee OpenCode (ein sbx-Kit) auf macOS und Linux ein.
+#
+#   curl -fsSL https://cdn.jsdelivr.net/npm/@viadee/opencode-installation/install.sh | bash
+#
+# Jeder Schritt ist wiederholbar; bereits erledigte Schritte werden übersprungen.
+set -euo pipefail
+
+IMAGE="ghcr.io/viadee-internal/viadee-opencode-kit:latest"
+ALLOWED_SOURCES='["docker.io/","ghcr.io/viadee-internal/"]'
+DOCS_URL="https://viadee.atlassian.net/wiki/spaces/APT/pages/3080093832"
+
+step() { printf '\n==> %s\n' "$1"; }
+info() { printf '    %s\n' "$1"; }
+
+# Bei `curl | bash` ist stdin das Skript selbst; Eingaben kommen vom Terminal.
+if (exec </dev/tty) 2>/dev/null; then
+  exec 3</dev/tty
+else
+  exec 3<&0
+fi
+
+confirm() {
+  local reply=""
+  printf '%s [J/n] ' "$1"
+  read -r reply <&3 || true
+  case "$reply" in
+    [nN]*) return 1 ;;
+    *) return 0 ;;
+  esac
+}
+
+# Wie confirm, aber ohne Eingabe gilt Nein.
+confirm_no() {
+  local reply=""
+  printf '%s [j/N] ' "$1"
+  read -r reply <&3 || true
+  case "$reply" in
+    [jJyY]*) return 0 ;;
+    *) return 1 ;;
+  esac
+}
+
+shell_profile() {
+  case "$(basename "${SHELL:-}")" in
+    zsh) echo "$HOME/.zshrc" ;;
+    bash) if [ "$(uname -s)" = "Darwin" ]; then echo "$HOME/.bash_profile"; else echo "$HOME/.bashrc"; fi ;;
+    *) echo "$HOME/.profile" ;;
+  esac
+}
+
+install_sbx() {
+  step "Docker Sandbox (sbx)"
+  if command -v sbx >/dev/null 2>&1; then
+    info "sbx ist bereits installiert."
+    return
+  fi
+  if [ "$(uname -s)" = "Darwin" ] && command -v brew >/dev/null 2>&1; then
+    brew install docker/tap/sbx
+  else
+    info "sbx ist nicht installiert. Bitte sbx installieren und das Skript erneut ausführen:"
+    info "$DOCS_URL"
+    exit 1
+  fi
+}
+
+disable_telemetry() {
+  step "Telemetrie an Docker abschalten"
+  export SBX_NO_TELEMETRY=1
+  local profile
+  profile="$(shell_profile)"
+  if [ -f "$profile" ] && grep -q 'SBX_NO_TELEMETRY' "$profile"; then
+    info "Bereits in $profile gesetzt."
+  else
+    printf '\n# viadee OpenCode: keine Telemetrie an Docker senden\nexport SBX_NO_TELEMETRY=1\n' >>"$profile"
+    info "In $profile eingetragen."
+  fi
+}
+
+docker_login() {
+  step "Bei Docker anmelden"
+  if confirm "sbx login ausführen? (überspringen mit n, falls bereits angemeldet)"; then
+    sbx login <&3
+  fi
+}
+
+allow_sources() {
+  step "Images aus dem viadee-GitHub erlauben"
+  local current
+  current="$(sbx settings get kit.allowedSources 2>/dev/null || true)"
+  if [[ "$current" == *'"docker.io/"'* && "$current" == *'"ghcr.io/viadee-internal/"'* ]]; then
+    info "Bereits erlaubt."
+    return
+  fi
+  if [ -n "$current" ]; then
+    info "Bisheriger Wert wird ersetzt: $current"
+  fi
+  sbx settings set kit.allowedSources "$ALLOWED_SOURCES"
+}
+
+init_policy() {
+  step "Netzwerk-Policy festlegen (balanced)"
+  if ! sbx policy init balanced; then
+    info "Die Policy ist bereits eingerichtet; übersprungen."
+  fi
+}
+
+store_key() {
+  step "LiteLLM-Key hinterlegen"
+  info "Der Key bleibt auf diesem Rechner; die Sandbox sieht ihn nie."
+  if confirm "Key jetzt hinterlegen oder ersetzen? (überspringen mit n, falls bereits hinterlegt)"; then
+    sbx secret set litellm <&3
+  fi
+  if confirm_no "Nutzt du je nach Projekt verschiedene LiteLLM-Keys (Projektnummern)?"; then
+    info "Der Key oben gilt für alle Projekte. Für ein Projekt mit eigener Projektnummer"
+    info "einmalig einen eigenen Key für dessen Sandbox hinterlegen:"
+    info ""
+    info "    sbx secret set litellm --sandbox mein-projekt"
+    info ""
+    info "Der Name muss zum Start passen: sbx run --name mein-projekt opencode"
+    info "Ändern mit --force, entfernen mit: sbx secret rm litellm --sandbox mein-projekt"
+  fi
+}
+
+set_shortcut() {
+  step "Kurzbefehl einrichten"
+  sbx settings set kit.shortcuts.opencode "$IMAGE"
+  info "sbx run opencode startet jetzt viadee OpenCode."
+}
+
+main() {
+  printf 'viadee OpenCode – Einrichtung\nAnleitung: %s\n' "$DOCS_URL"
+  install_sbx
+  disable_telemetry
+  docker_login
+  allow_sources
+  init_policy
+  store_key
+  set_shortcut
+  printf '\nFertig. Im Projektordner starten mit:\n\n    sbx run --name mein-projekt opencode\n\n'
+  printf 'Ohne Kurzbefehl: sbx run --name mein-projekt %s\n' "$IMAGE"
+}
+
+# Erst nach dem vollständigen Download ausführen (wichtig bei `curl | bash`).
+main "$@"

package/package.json

@@ -1,6 +1,21 @@
 {
   "name": "@viadee/opencode-installation",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Installer scripts that set up viadee OpenCode, the viadee sbx kit for OpenCode",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/viadee-internal/viadee-opencode-kit.git",
+    "directory": "installer"
+  },
+  "homepage": "https://viadee.atlassian.net/wiki/spaces/APT/pages/3080093832",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "install.sh",
+    "install.ps1",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT"
+}