boxdown 1.0.0

package/assets/devcontainer/utils/coding-agent-cli-update.sh

@@ -0,0 +1,360 @@
+#!/usr/bin/env bash
+#
+# Install or refresh coding-agent CLIs inside the devcontainer.
+
+set -euo pipefail
+
+DEFAULT_AGENTS=(codex opencode claude antigravity)
+UPDATE_INTERVAL_SECONDS="${BOXDOWN_CODING_AGENT_UPDATE_INTERVAL_SECONDS:-3600}"
+UPDATE_LOCK_WAIT_SECONDS="${BOXDOWN_CODING_AGENT_UPDATE_LOCK_WAIT_SECONDS:-120}"
+STATE_DIR="${BOXDOWN_CODING_AGENT_UPDATE_STATE_DIR:-${HOME}/.cache/boxdown/coding-agent-clis}"
+
+log() {
+  echo "coding-agent-cli-update: $*" >&2
+}
+
+usage() {
+  cat >&2 <<'EOF'
+Usage: coding-agent-cli-update.sh <install|update-now|maybe-update> [codex|opencode|claude|antigravity...]
+EOF
+}
+
+numeric_or_default() {
+  local value="$1"
+  local default_value="$2"
+
+  case "${value}" in
+    '' | *[!0-9]*) printf '%s\n' "${default_value}" ;;
+    *) printf '%s\n' "${value}" ;;
+  esac
+}
+
+env_value() {
+  local name="$1"
+  local default_value="$2"
+  local value="${!name-}"
+
+  printf '%s\n' "${value:-${default_value}}"
+}
+
+agent_env_prefix() {
+  case "$1" in
+    codex) printf '%s\n' CODEX ;;
+    opencode) printf '%s\n' OPENCODE ;;
+    claude) printf '%s\n' CLAUDE ;;
+    antigravity) printf '%s\n' ANTIGRAVITY ;;
+    *)
+      log "unknown coding-agent CLI: $1"
+      return 1
+      ;;
+  esac
+}
+
+agent_stamp_file() {
+  local agent="$1"
+  local prefix
+  local legacy_value
+
+  prefix="$(agent_env_prefix "${agent}")" || return 1
+  if [ "${agent}" = "codex" ]; then
+    legacy_value="${BOXDOWN_CODEX_UPDATE_STAMP_FILE:-}"
+    if [ -n "${legacy_value}" ]; then
+      printf '%s\n' "${legacy_value}"
+      return 0
+    fi
+  fi
+  env_value "BOXDOWN_${prefix}_UPDATE_STAMP_FILE" "${STATE_DIR}/${agent}.stamp"
+}
+
+agent_lock_dir() {
+  local agent="$1"
+  local prefix
+  local legacy_value
+
+  prefix="$(agent_env_prefix "${agent}")" || return 1
+  if [ "${agent}" = "codex" ]; then
+    legacy_value="${BOXDOWN_CODEX_UPDATE_LOCK_DIR:-}"
+    if [ -n "${legacy_value}" ]; then
+      printf '%s\n' "${legacy_value}"
+      return 0
+    fi
+  fi
+  env_value "BOXDOWN_${prefix}_UPDATE_LOCK_DIR" "${STATE_DIR}/${agent}.lock"
+}
+
+agent_interval_seconds() {
+  local agent="$1"
+  local prefix
+
+  prefix="$(agent_env_prefix "${agent}")" || return 1
+  env_value "BOXDOWN_${prefix}_UPDATE_INTERVAL_SECONDS" "${UPDATE_INTERVAL_SECONDS}"
+}
+
+agent_lock_wait_seconds() {
+  local agent="$1"
+  local prefix
+
+  prefix="$(agent_env_prefix "${agent}")" || return 1
+  env_value "BOXDOWN_${prefix}_UPDATE_LOCK_WAIT_SECONDS" "${UPDATE_LOCK_WAIT_SECONDS}"
+}
+
+ensure_state_dir() {
+  local stamp_file="$1"
+  local lock_dir="$2"
+
+  mkdir -p "$(dirname "${stamp_file}")" "$(dirname "${lock_dir}")"
+}
+
+stamp_fresh() {
+  local agent="$1"
+  local stamp_file="$2"
+  local interval_seconds
+  local stamp_time
+  local now
+
+  interval_seconds="$(numeric_or_default "$(agent_interval_seconds "${agent}")" 3600)"
+  if [ "${interval_seconds}" = "0" ]; then
+    return 1
+  fi
+
+  if [ ! -f "${stamp_file}" ]; then
+    return 1
+  fi
+
+  stamp_time="$(stat -c %Y "${stamp_file}" 2>/dev/null || stat -f %m "${stamp_file}" 2>/dev/null || printf '0')"
+  now="$(date +%s)"
+  [ "$((now - stamp_time))" -lt "${interval_seconds}" ]
+}
+
+wait_for_existing_lock() {
+  local agent="$1"
+  local lock_dir="$2"
+  local wait_seconds
+  local deadline
+
+  wait_seconds="$(numeric_or_default "$(agent_lock_wait_seconds "${agent}")" 120)"
+  deadline=$((SECONDS + wait_seconds))
+
+  while [ -d "${lock_dir}" ]; do
+    if [ "${SECONDS}" -ge "${deadline}" ]; then
+      return 1
+    fi
+
+    sleep 1
+  done
+}
+
+acquire_lock() {
+  local agent="$1"
+  local lock_dir="$2"
+
+  if mkdir "${lock_dir}" 2>/dev/null; then
+    ACTIVE_LOCK_DIR="${lock_dir}"
+    return 0
+  fi
+
+  log "${agent}: another update is running; waiting for it to finish."
+  wait_for_existing_lock "${agent}" "${lock_dir}" || {
+    log "${agent}: another update is still running; skipping this preflight."
+    return 1
+  }
+
+  mkdir "${lock_dir}" 2>/dev/null || return 1
+  ACTIVE_LOCK_DIR="${lock_dir}"
+}
+
+release_lock() {
+  if [ -n "${ACTIVE_LOCK_DIR:-}" ]; then
+    rmdir "${ACTIVE_LOCK_DIR}" 2>/dev/null || true
+    ACTIVE_LOCK_DIR=""
+  fi
+}
+
+run_installer_url() {
+  local url="$1"
+  shift
+
+  curl -fsSL "${url}" | "$@"
+}
+
+install_codex() {
+  local url
+
+  url="${BOXDOWN_CODEX_INSTALL_URL:-https://chatgpt.com/codex/install.sh}"
+  run_installer_url "${url}" env CODEX_NON_INTERACTIVE=1 sh
+}
+
+update_codex() {
+  if command -v codex >/dev/null 2>&1; then
+    if codex update; then
+      return 0
+    fi
+
+    log "codex: codex update failed; falling back to installer."
+  fi
+
+  install_codex
+}
+
+install_opencode() {
+  local url
+
+  url="${BOXDOWN_OPENCODE_INSTALL_URL:-https://opencode.ai/install}"
+  run_installer_url "${url}" bash -s -- --no-modify-path
+}
+
+update_opencode() {
+  if command -v opencode >/dev/null 2>&1; then
+    if opencode upgrade --method curl; then
+      return 0
+    fi
+
+    log "opencode: opencode upgrade failed; falling back to installer."
+  fi
+
+  install_opencode
+}
+
+install_claude() {
+  local url
+
+  url="${BOXDOWN_CLAUDE_INSTALL_URL:-https://claude.ai/install.sh}"
+  run_installer_url "${url}" bash
+}
+
+update_claude() {
+  if command -v claude >/dev/null 2>&1; then
+    if claude update; then
+      return 0
+    fi
+
+    log "claude: claude update failed; falling back to installer."
+  fi
+
+  install_claude
+}
+
+install_antigravity() {
+  local url
+
+  url="${BOXDOWN_ANTIGRAVITY_INSTALL_URL:-https://antigravity.google/cli/install.sh}"
+  run_installer_url "${url}" bash -s -- --skip-path
+}
+
+update_antigravity() {
+  install_antigravity
+}
+
+run_agent_update() {
+  case "$1" in
+    codex) update_codex ;;
+    opencode) update_opencode ;;
+    claude) update_claude ;;
+    antigravity) update_antigravity ;;
+    *)
+      log "unknown coding-agent CLI: $1"
+      return 1
+      ;;
+  esac
+}
+
+touch_stamp() {
+  local stamp_file="$1"
+
+  touch "${stamp_file}"
+}
+
+update_now_agent() {
+  local agent="$1"
+  local stamp_file
+  local lock_dir
+  local result=0
+
+  stamp_file="$(agent_stamp_file "${agent}")" || return 1
+  lock_dir="$(agent_lock_dir "${agent}")" || return 1
+  ensure_state_dir "${stamp_file}" "${lock_dir}"
+  acquire_lock "${agent}" "${lock_dir}" || return 1
+  if run_agent_update "${agent}"; then
+    touch_stamp "${stamp_file}"
+  else
+    result=$?
+  fi
+  release_lock
+  return "${result}"
+}
+
+maybe_update_agent() {
+  local agent="$1"
+  local stamp_file
+  local lock_dir
+  local result=0
+
+  stamp_file="$(agent_stamp_file "${agent}")" || return 1
+  lock_dir="$(agent_lock_dir "${agent}")" || return 1
+  ensure_state_dir "${stamp_file}" "${lock_dir}"
+  if stamp_fresh "${agent}" "${stamp_file}"; then
+    return 0
+  fi
+
+  acquire_lock "${agent}" "${lock_dir}" || return 0
+  if stamp_fresh "${agent}" "${stamp_file}"; then
+    release_lock
+    return 0
+  fi
+
+  if run_agent_update "${agent}"; then
+    touch_stamp "${stamp_file}"
+  else
+    result=$?
+  fi
+  release_lock
+  return "${result}"
+}
+
+run_action_for_agent() {
+  local action="$1"
+  local agent="$2"
+
+  case "${action}" in
+    install | update-now)
+      update_now_agent "${agent}"
+      ;;
+    maybe-update)
+      maybe_update_agent "${agent}"
+      ;;
+    *)
+      usage
+      return 1
+      ;;
+  esac
+}
+
+main() {
+  local action="${1:-}"
+  local failures=0
+  local agents
+
+  if [ -z "${action}" ]; then
+    usage
+    return 1
+  fi
+  shift
+
+  if [ "$#" -eq 0 ]; then
+    agents=("${DEFAULT_AGENTS[@]}")
+  else
+    agents=("$@")
+  fi
+
+  for agent in "${agents[@]}"; do
+    if ! run_action_for_agent "${action}" "${agent}"; then
+      log "${agent}: ${action} failed."
+      failures=$((failures + 1))
+    fi
+  done
+
+  [ "${failures}" -eq 0 ]
+}
+
+trap 'release_lock' EXIT
+main "$@"

package/assets/devcontainer/utils/deps-install.sh

@@ -0,0 +1,87 @@
+#!/usr/bin/env bash
+# Install workspace JS dependencies when package.json exists (non-fatal on failure).
+
+main() {
+  [[ -f package.json ]] || return 0
+  local pm
+  pm=$(detect_package_manager)
+  install_dependencies "$pm" || true
+}
+
+detect_package_manager() {
+  local pm
+  if pm=$(detect_package_manager_from_lockfiles); then
+    echo "$pm"
+    return
+  fi
+  if pm=$(detect_package_manager_from_repo_markers); then
+    echo "$pm"
+    return
+  fi
+  if pm=$(detect_package_manager_from_package_json); then
+    echo "$pm"
+    return
+  fi
+  echo npm
+}
+
+detect_package_manager_from_lockfiles() {
+  if [[ -f pnpm-lock.yaml ]]; then
+    echo pnpm
+    return 0
+  fi
+  if [[ -f bun.lockb || -f bun.lock ]]; then
+    echo bun
+    return 0
+  fi
+  if [[ -f yarn.lock ]]; then
+    echo yarn
+    return 0
+  fi
+  if [[ -f package-lock.json ]]; then
+    echo npm
+    return 0
+  fi
+  return 1
+}
+
+detect_package_manager_from_repo_markers() {
+  if [[ -f pnpm-workspace.yaml ]]; then
+    echo pnpm
+    return 0
+  fi
+  if [[ -f bunfig.toml ]]; then
+    echo bun
+    return 0
+  fi
+  if [[ -f .yarnrc.yml ]]; then
+    echo yarn
+    return 0
+  fi
+  return 1
+}
+
+detect_package_manager_from_package_json() {
+  [[ -f package.json ]] || return 1
+  node -e "
+    const p = require('./package.json');
+    const spec = p.packageManager;
+    if (!spec || typeof spec !== 'string') process.exit(1);
+    const name = spec.split('@')[0].trim();
+    if (!['pnpm', 'npm', 'yarn', 'bun'].includes(name)) process.exit(1);
+    console.log(name);
+  " 2>/dev/null || return 1
+}
+
+install_dependencies() {
+  local pm="$1"
+  case "$pm" in
+    pnpm) pnpm install ;;
+    npm) npm install ;;
+    yarn) yarn install ;;
+    bun) bun install ;;
+    *) npm install ;;
+  esac
+}
+
+main "$@"

package/assets/devcontainer/utils/ssh-bootstrap.sh

@@ -0,0 +1,200 @@
+#!/usr/bin/env bash
+#
+# Container-side SSH setup for the repo-local devcontainer workflow.
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+WORKSPACE_FOLDER="${BOXDOWN_CONTAINER_WORKSPACE_FOLDER:-$(cd "${SCRIPT_DIR}/../.." && pwd -P)}"
+REPO_NAME="${BOXDOWN_WORKSPACE_BASENAME:-$(basename "${WORKSPACE_FOLDER}")}"
+SSH_USER="${DEVCONTAINER_SSH_USER:-node}"
+PUBLIC_KEY_FILE="${DEVCONTAINER_SSH_PUBLIC_KEY_FILE:-${WORKSPACE_FOLDER}/.devcontainer/.ssh/id_ed25519.pub}"
+OPENSSH_CONFIGURE_TIMEOUT_SECONDS="${DEVCONTAINER_OPENSSH_CONFIGURE_TIMEOUT_SECONDS:-180}"
+
+as_root() {
+  if [ "$(id -u)" -eq 0 ]; then
+    "$@"
+  else
+    sudo "$@"
+  fi
+}
+
+ssh_user_home() {
+  getent passwd "${SSH_USER}" | cut -d: -f6
+}
+
+openssh_server_package_configured() {
+  local status
+
+  if ! command -v dpkg-query >/dev/null 2>&1; then
+    return 0
+  fi
+
+  status="$(dpkg-query -W -f='${Status}' openssh-server 2>/dev/null || true)"
+  [ "${status}" = "install ok installed" ]
+}
+
+openssh_server_configured() {
+  [ -x /usr/sbin/sshd ] || return 1
+  getent passwd sshd >/dev/null 2>&1 || return 1
+  openssh_server_package_configured
+}
+
+package_manager_running() {
+  if command -v pgrep >/dev/null 2>&1; then
+    pgrep -x apt >/dev/null 2>&1 ||
+      pgrep -x apt-get >/dev/null 2>&1 ||
+      pgrep -x dpkg >/dev/null 2>&1
+    return $?
+  fi
+
+  ps -eo comm= | grep -Eq '^(apt|apt-get|dpkg)$'
+}
+
+configure_pending_dpkg_packages() {
+  if ! command -v dpkg >/dev/null 2>&1; then
+    return 1
+  fi
+
+  # Feed "no" answers so a recovering openssh-server postinst cannot block if
+  # another path already generated host keys before dpkg completed.
+  printf 'n\nn\nn\nn\nn\n' |
+    as_root env DEBIAN_FRONTEND=noninteractive dpkg --configure -a
+}
+
+ensure_openssh_server_configured() {
+  local deadline
+
+  if openssh_server_configured; then
+    return 0
+  fi
+
+  echo "ssh-bootstrap: waiting for openssh-server package configuration before generating SSH host keys." >&2
+  deadline=$((SECONDS + OPENSSH_CONFIGURE_TIMEOUT_SECONDS))
+
+  while ! openssh_server_configured; do
+    if ! package_manager_running; then
+      configure_pending_dpkg_packages || true
+    fi
+
+    if openssh_server_configured; then
+      return 0
+    fi
+
+    if [ "${SECONDS}" -ge "${deadline}" ]; then
+      echo "ssh-bootstrap: openssh-server did not finish configuring within ${OPENSSH_CONFIGURE_TIMEOUT_SECONDS}s." >&2
+      if command -v dpkg-query >/dev/null 2>&1; then
+        dpkg-query -W -f='ssh-bootstrap: openssh-server status: ${Status}\n' openssh-server >&2 || true
+      fi
+      if ! getent passwd sshd >/dev/null 2>&1; then
+        echo "ssh-bootstrap: missing sshd privilege separation user." >&2
+      fi
+      return 1
+    fi
+
+    sleep 2
+  done
+}
+
+install_openssh_server() {
+  if [ ! -x /usr/sbin/sshd ]; then
+    as_root apt-get update
+    as_root env DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends openssh-server
+  fi
+
+  ensure_openssh_server_configured
+}
+
+install_authorized_key_if_present() {
+  local user_home
+  local authorized_keys
+  local public_key
+
+  if [ ! -r "${PUBLIC_KEY_FILE}" ]; then
+    echo "ssh-bootstrap: no public key at ${PUBLIC_KEY_FILE}; skipping authorized_keys setup."
+    return 0
+  fi
+
+  user_home="$(ssh_user_home)"
+  if [ -z "${user_home}" ]; then
+    echo "ssh-bootstrap: could not resolve home directory for ${SSH_USER}." >&2
+    return 1
+  fi
+
+  authorized_keys="${user_home}/.ssh/authorized_keys"
+  public_key="$(sed -n '1p' "${PUBLIC_KEY_FILE}")"
+
+  as_root install -d -m 0700 -o "${SSH_USER}" -g "${SSH_USER}" "${user_home}/.ssh"
+  as_root touch "${authorized_keys}"
+  as_root chown "${SSH_USER}:${SSH_USER}" "${authorized_keys}"
+  as_root chmod 0600 "${authorized_keys}"
+
+  if ! as_root grep -qxF "${public_key}" "${authorized_keys}"; then
+    printf '%s\n' "${public_key}" | as_root tee -a "${authorized_keys}" >/dev/null
+  fi
+
+  as_root chown "${SSH_USER}:${SSH_USER}" "${authorized_keys}"
+  as_root chmod 0600 "${authorized_keys}"
+}
+
+ensure_workspace_home_symlink() {
+  local user_home
+  local link_path
+
+  user_home="$(ssh_user_home)"
+  if [ -z "${user_home}" ]; then
+    echo "ssh-bootstrap: could not resolve home directory for ${SSH_USER}." >&2
+    return 1
+  fi
+
+  link_path="${user_home}/${REPO_NAME}"
+
+  if [ -e "${link_path}" ] && [ ! -L "${link_path}" ]; then
+    echo "ssh-bootstrap: ${link_path} already exists and is not a symlink; leaving it unchanged." >&2
+    return 0
+  fi
+
+  as_root ln -sfn "${WORKSPACE_FOLDER}" "${link_path}"
+  as_root chown -h "${SSH_USER}:${SSH_USER}" "${link_path}"
+}
+
+ensure_runtime_ready() {
+  if [ ! -x /usr/sbin/sshd ]; then
+    echo "ssh-bootstrap: /usr/sbin/sshd is missing. Recreate the devcontainer so post-create installs openssh-server." >&2
+    return 1
+  fi
+
+  ensure_openssh_server_configured
+  as_root ssh-keygen -A
+  as_root install -d -m 0755 /run/sshd
+  install_authorized_key_if_present
+  ensure_workspace_home_symlink
+  as_root /usr/sbin/sshd -t \
+    -o PubkeyAuthentication=yes \
+    -o PasswordAuthentication=no \
+    -o KbdInteractiveAuthentication=no \
+    -o AllowTcpForwarding=yes \
+    -o AllowStreamLocalForwarding=yes \
+    -o PermitTTY=yes
+}
+
+main() {
+  case "${1:-runtime}" in
+    install)
+      install_openssh_server
+      ;;
+    runtime)
+      ensure_runtime_ready
+      ;;
+    all)
+      install_openssh_server
+      ensure_runtime_ready
+      ;;
+    *)
+      echo "Usage: $(basename "$0") [install|runtime|all]" >&2
+      return 1
+      ;;
+  esac
+}
+
+main "$@"

package/dist/bin/cli.cjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+const require_main = require('../main-BuEptwlL.cjs');
+
+//#region src/bin/cli.ts
+require_main.runCli().then((exitCode) => {
+	process.exitCode = exitCode;
+}, (error) => {
+	process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+	process.exitCode = 1;
+});
+
+//#endregion

package/dist/bin/cli.d.cts

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

package/dist/bin/cli.d.mts

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

package/dist/bin/cli.mjs

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+import { i as runCli } from "../main-ZFTrSVgt.mjs";
+
+//#region src/bin/cli.ts
+runCli().then((exitCode) => {
+	process.exitCode = exitCode;
+}, (error) => {
+	process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+	process.exitCode = 1;
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=cli.mjs.map

package/dist/bin/cli.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.mjs","names":[],"sources":["../../src/bin/cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { runCli } from '../main.ts'\n\nrunCli().then((exitCode) => {\n  process.exitCode = exitCode\n}, (error: unknown) => {\n  process.stderr.write(`${error instanceof Error ? error.message : String(error)}\\n`)\n  process.exitCode = 1\n})\n"],"mappings":";;;;AAGA,QAAQ,CAAC,MAAM,aAAa;AAC1B,SAAQ,WAAW;IACjB,UAAmB;AACrB,SAAQ,OAAO,MAAM,GAAG,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC,IAAI;AACnF,SAAQ,WAAW;EACnB"}