work-ally 0.2.0-alpha.1

package/internal/modules/bootstrap/setup.sh

@@ -0,0 +1,144 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck disable=SC1091
+. "$SCRIPT_DIR/../../lib/common.sh"
+work_ally_init_context
+work_ally_ensure_state_dirs
+
+cmd_name=$(work_ally_cmd_name)
+ASSISTANT_NAME=""
+ASSISTANT_REMOTE=""
+TARGET_WORKSPACE="${WORK_ALLY_WORKSPACE_ROOT:-}"
+
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --assistant)
+      [ "$#" -ge 2 ] || work_ally_die "--assistant requires a value"
+      ASSISTANT_NAME="$2"
+      shift 2
+      ;;
+    --assistant=*)
+      ASSISTANT_NAME="${1#--assistant=}"
+      shift
+      ;;
+    --workspace)
+      [ "$#" -ge 2 ] || work_ally_die "--workspace requires a value"
+      TARGET_WORKSPACE="$2"
+      shift 2
+      ;;
+    --workspace=*)
+      TARGET_WORKSPACE="${1#--workspace=}"
+      shift
+      ;;
+    --remote)
+      [ "$#" -ge 2 ] || work_ally_die "--remote requires a value"
+      ASSISTANT_REMOTE="$2"
+      shift 2
+      ;;
+    --remote=*)
+      ASSISTANT_REMOTE="${1#--remote=}"
+      shift
+      ;;
+    -h|--help)
+      cat <<USAGE
+Usage: $cmd_name setup [assistant-name] [--assistant <name>] [--workspace <path>] [--remote <git-url>]
+USAGE
+      exit 0
+      ;;
+    *)
+      if [ -z "$ASSISTANT_NAME" ]; then
+        ASSISTANT_NAME="$1"
+        shift
+      else
+        work_ally_die "Unknown argument: $1"
+      fi
+      ;;
+  esac
+done
+
+[ -n "$TARGET_WORKSPACE" ] || work_ally_die "--workspace is required"
+[ -d "$TARGET_WORKSPACE" ] || work_ally_die "Workspace directory not found: $TARGET_WORKSPACE"
+TARGET_WORKSPACE=$(cd "$TARGET_WORKSPACE" && pwd)
+export WORK_ALLY_WORKSPACE_ROOT="$TARGET_WORKSPACE"
+
+work_ally_note "Bootstrapping work-ally runtime shell"
+work_ally_require_cmd node
+work_ally_require_cmd npm
+work_ally_require_cmd codex
+work_ally_install_bridge_dependencies
+
+if [ -z "$ASSISTANT_NAME" ] && [ -n "${WORK_ALLY_ASSISTANT_NAME:-}" ]; then
+  ASSISTANT_NAME="$WORK_ALLY_ASSISTANT_NAME"
+fi
+if [ -z "$ASSISTANT_REMOTE" ] && [ -n "${WORK_ALLY_ASSISTANT_GIT_REMOTE:-}" ]; then
+  ASSISTANT_REMOTE="$WORK_ALLY_ASSISTANT_GIT_REMOTE"
+fi
+
+if [ -n "$ASSISTANT_NAME" ]; then
+  existing_workspace=""
+  work_ally_validate_assistant_name "$ASSISTANT_NAME"
+  if work_ally_registry_has_assistant "$ASSISTANT_NAME"; then
+    existing_workspace=$(work_ally_assistant_registered_workspace "$ASSISTANT_NAME" || true)
+    if [ -n "$existing_workspace" ] && [ "$existing_workspace" != "$TARGET_WORKSPACE" ]; then
+      work_ally_die "Assistant $ASSISTANT_NAME is already bound to $existing_workspace. Create a different assistant for $TARGET_WORKSPACE."
+    fi
+  fi
+
+  work_ally_hydrate_assistant_context "$ASSISTANT_NAME"
+  "$WORK_ALLY_IMPLEMENTATION_DIR/internal/modules/config/init-env.sh"
+  work_ally_load_env
+
+  manage_args=("$ASSISTANT_NAME" --workspace "$TARGET_WORKSPACE")
+  if [ -n "$ASSISTANT_REMOTE" ]; then
+    manage_args+=(--git-remote "$ASSISTANT_REMOTE")
+  fi
+
+  if work_ally_registry_has_assistant "$ASSISTANT_NAME"; then
+    work_ally_note "Reusing assistant $ASSISTANT_NAME"
+    "$WORK_ALLY_IMPLEMENTATION_DIR/internal/modules/assistant/manage.sh" ensure "${manage_args[@]}"
+  else
+    "$WORK_ALLY_IMPLEMENTATION_DIR/internal/modules/assistant/manage.sh" add "${manage_args[@]}"
+  fi
+
+  work_ally_hydrate_assistant_context "$ASSISTANT_NAME"
+  work_ally_env_set WORK_ALLY_ASSISTANT_NAME "$ASSISTANT_NAME"
+  if [ -n "$ASSISTANT_REMOTE" ]; then
+    work_ally_env_set WORK_ALLY_ASSISTANT_GIT_REMOTE "$ASSISTANT_REMOTE"
+  fi
+  work_ally_project_registry_set "$TARGET_WORKSPACE" "$ASSISTANT_NAME"
+fi
+
+cat <<EOF2
+
+Setup complete.
+EOF2
+
+if [ -n "$ASSISTANT_NAME" ]; then
+  cat <<EOF2
+
+Assistant desk is ready:
+  - assistant: $ASSISTANT_NAME
+  - workspace: $TARGET_WORKSPACE
+  - desk: $WORK_ALLY_ASSISTANT_HOME
+  - config: $WORK_ALLY_ENV_FILE
+
+Next steps:
+  1. Edit $WORK_ALLY_ENV_FILE
+     Required for Feishu IM: FEISHU_APP_ID, FEISHU_APP_SECRET
+     Optional access control: WORK_ALLY_ALLOWED_USER_IDS (comma-separated)
+  2. Optional: set WORK_ALLY_ASSISTANT_GIT_REMOTE in $WORK_ALLY_ENV_FILE if you want auto-push
+  3. Optional: if you want Feishu docs and Codex has not installed it yet,
+     set FEISHU_MCP_SERVER_URL then run: $cmd_name mcp install-feishu --assistant $ASSISTANT_NAME
+  4. Run: $cmd_name start --assistant $ASSISTANT_NAME
+EOF2
+else
+  cat <<EOF2
+
+Next steps:
+  1. Re-run with an assistant name: $cmd_name setup <name> --workspace <path>
+  2. Edit the assistant config file once it is created
+  3. Run: $cmd_name start --assistant <name>
+EOF2
+fi

package/internal/modules/config/init-env.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck disable=SC1091
+. "$SCRIPT_DIR/../../lib/common.sh"
+work_ally_init_context
+
+work_ally_ensure_state_dirs
+work_ally_ensure_env_defaults

package/internal/modules/global/manage.sh

@@ -0,0 +1,154 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck disable=SC1091
+. "$SCRIPT_DIR/../../lib/common.sh"
+
+WORK_ALLY_HOME="${WORK_ALLY_HOME:-$HOME/.work-ally}"
+WORK_ALLY_ASSISTANTS_DIR="${WORK_ALLY_ASSISTANTS_DIR:-$WORK_ALLY_HOME/assistants}"
+WORK_ALLY_PROJECT_REGISTRY_FILE="${WORK_ALLY_PROJECT_REGISTRY_FILE:-$WORK_ALLY_HOME/projects/registry.yaml}"
+WORK_ALLY_ASSISTANT_REGISTRY_FILE="${WORK_ALLY_ASSISTANT_REGISTRY_FILE:-$WORK_ALLY_ASSISTANTS_DIR/registry.yaml}"
+
+usage() {
+  local cmd_name
+  cmd_name=$(work_ally_cmd_name)
+  cat <<USAGE
+Usage: $cmd_name global <command> [args]
+
+Commands:
+  list                    Show running assistants across this machine
+  stop --assistant <name> Stop the instance for the target assistant
+  stop --pid <pid>        Stop the instance by bridge pid
+USAGE
+}
+
+list_running_instances() {
+  local assistants assistant_name runtime_dir pid_file health_file pid
+
+  [ -f "$WORK_ALLY_ASSISTANT_REGISTRY_FILE" ] || return 0
+  assistants=$(awk '/^  [^[:space:]]+:$/ { name=$0; sub(/^  /, "", name); sub(/:$/, "", name); print name }' "$WORK_ALLY_ASSISTANT_REGISTRY_FILE")
+  [ -n "$assistants" ] || return 0
+
+  while IFS= read -r assistant_name; do
+    [ -n "$assistant_name" ] || continue
+    runtime_dir="$(work_ally_assistant_runtime_dir "$assistant_name")"
+    pid_file="$runtime_dir/bridge.pid"
+    health_file="$runtime_dir/bridge.health.json"
+    pid=$(work_ally_read_pid "$pid_file" || true)
+    if [ -z "$pid" ] && [ -f "$health_file" ]; then
+      pid=$(sed -nE 's/.*"pid"[[:space:]]*:[[:space:]]*([0-9]+).*/\1/p' "$health_file" | head -n 1)
+    fi
+    if [ -n "$pid" ] && work_ally_is_pid_alive "$pid"; then
+      printf '%s\t%s\n' "$pid" "$assistant_name"
+    fi
+  done <<EOF2
+$assistants
+EOF2
+}
+
+read_env_field() {
+  local file="$1"
+  local key="$2"
+  [ -f "$file" ] || return 0
+  sed -nE "s/^${key}=(.*)$/\\1/p" "$file" | tail -n 1
+}
+
+resolve_assistant_by_pid() {
+  local target_pid="$1"
+  list_running_instances | awk -F '\t' -v pid="$target_pid" '$1 == pid { print $2; exit }'
+}
+
+list_instances() {
+  local rows count assistant_name env_file health_file channel app_id health_updated pid workspace
+  rows=$(list_running_instances || true)
+  if [ -z "$rows" ]; then
+    printf 'instances: 0\n'
+    return 0
+  fi
+
+  count=$(printf '%s\n' "$rows" | awk 'NF { count += 1 } END { print count + 0 }')
+  printf 'instances: %s\n' "$count"
+
+  while IFS=$'\t' read -r pid assistant_name; do
+    [ -n "$pid" ] || continue
+    [ -n "$assistant_name" ] || continue
+
+    workspace=$(work_ally_assistant_registered_workspace "$assistant_name" || true)
+    env_file=$(work_ally_assistant_env_file "$assistant_name")
+    health_file="$(work_ally_assistant_runtime_dir "$assistant_name")/bridge.health.json"
+    channel=$(read_env_field "$env_file" WORK_ALLY_CHANNEL_IMPL)
+    app_id=$(read_env_field "$env_file" FEISHU_APP_ID)
+    if [ -f "$health_file" ]; then
+      health_updated=$(sed -nE 's/.*"updated_at"[[:space:]]*:[[:space:]]*"([^"]*)".*/\1/p' "$health_file" 2>/dev/null | head -n 1 || true)
+    else
+      health_updated=""
+    fi
+
+    printf -- '---\n'
+    printf 'bridge pid: %s\n' "$pid"
+    printf 'assistant: %s\n' "$assistant_name"
+    [ -n "$workspace" ] && printf 'workspace: %s\n' "$workspace"
+    printf 'channel: %s\n' "${channel:-unknown}"
+    [ -n "$app_id" ] && printf 'app id: %s\n' "$app_id"
+    [ -n "$health_updated" ] && printf 'last health update: %s\n' "$health_updated"
+  done <<EOF2
+$rows
+EOF2
+}
+
+stop_instance() {
+  local mode="$1"
+  local target="$2"
+  local assistant_name=""
+
+  case "$mode" in
+    --assistant)
+      assistant_name="$target"
+      ;;
+    --pid)
+      assistant_name=$(resolve_assistant_by_pid "$target")
+      ;;
+    *)
+      work_ally_die "Unknown stop mode: $mode"
+      ;;
+  esac
+
+  [ -n "$assistant_name" ] || work_ally_die "No running ally instance matched: $target"
+
+  WORK_ALLY_HOME="$WORK_ALLY_HOME" \
+  WORK_ALLY_ASSISTANTS_DIR="$WORK_ALLY_ASSISTANTS_DIR" \
+  WORK_ALLY_ASSISTANT_REGISTRY_FILE="$WORK_ALLY_ASSISTANT_REGISTRY_FILE" \
+  WORK_ALLY_PROJECT_REGISTRY_FILE="$WORK_ALLY_PROJECT_REGISTRY_FILE" \
+  WORK_ALLY_ASSISTANT_NAME="$assistant_name" \
+  WORK_ALLY_INSTALL_ROOT="$WORK_ALLY_IMPLEMENTATION_DIR" \
+  WORK_ALLY_IMPLEMENTATION_DIR="$WORK_ALLY_IMPLEMENTATION_DIR" \
+  WORK_ALLY_CMD_NAME="$(work_ally_cmd_name)" \
+  "$WORK_ALLY_IMPLEMENTATION_DIR/internal/modules/runtime/stop.sh"
+}
+
+SUBCMD="${1:-list}"
+shift || true
+
+case "$SUBCMD" in
+  list)
+    list_instances
+    ;;
+  stop)
+    case "${1:-}" in
+      --assistant|--pid)
+        [ $# -ge 2 ] || work_ally_die "global stop requires a target"
+        stop_instance "$1" "$2"
+        ;;
+      *)
+        work_ally_die "Usage: $(work_ally_cmd_name) global stop --assistant <name> | --pid <pid>"
+        ;;
+    esac
+    ;;
+  help|-h|--help)
+    usage
+    ;;
+  *)
+    work_ally_die "Unknown global command: $SUBCMD"
+    ;;
+esac

package/internal/modules/handoff/manage.sh

@@ -0,0 +1,54 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck disable=SC1091
+. "$SCRIPT_DIR/../../lib/common.sh"
+work_ally_init_context
+if [ -z "${WORK_ALLY_ASSISTANT_NAME:-}" ]; then
+  WORK_ALLY_ASSISTANT_NAME=$(work_ally_resolve_assistant_name_from_args "$@" || true)
+fi
+if [ -n "${WORK_ALLY_ASSISTANT_NAME:-}" ]; then
+  work_ally_sync_workspace_root_from_assistant "$WORK_ALLY_ASSISTANT_NAME"
+  work_ally_hydrate_assistant_context "$WORK_ALLY_ASSISTANT_NAME"
+fi
+work_ally_ensure_state_dirs
+work_ally_load_env
+work_ally_load_assistant_state || true
+work_ally_require_assistant_profile_ready "$WORK_ALLY_ASSISTANT_NAME"
+work_ally_require_cmd codex
+
+SUBCMD="${1:-}"
+shift || true
+
+case "$SUBCMD" in
+  codex|attach|new|continue|threads)
+    export WORK_ALLY_ASSISTANT_MODE="${WORK_ALLY_ASSISTANT_MODE:-assistant}"
+    export WORK_ALLY_ASSISTANT_NAME
+    export WORK_ALLY_ASSISTANT_HOME="${WORK_ALLY_ASSISTANT_HOME:-$(work_ally_assistant_registered_home "$WORK_ALLY_ASSISTANT_NAME")}"
+    export WORK_ALLY_ASSISTANT_CODEX_HOME="${WORK_ALLY_ASSISTANT_CODEX_HOME:-$(work_ally_assistant_registered_codex_home "$WORK_ALLY_ASSISTANT_NAME")}"
+    exec env \
+      CODEX_HOME="$WORK_ALLY_ASSISTANT_CODEX_HOME" \
+      WORK_ALLY_ASSISTANT_MODE="$WORK_ALLY_ASSISTANT_MODE" \
+      WORK_ALLY_ASSISTANT_NAME="$WORK_ALLY_ASSISTANT_NAME" \
+      WORK_ALLY_ASSISTANT_HOME="$WORK_ALLY_ASSISTANT_HOME" \
+      WORK_ALLY_ASSISTANT_CODEX_HOME="$WORK_ALLY_ASSISTANT_CODEX_HOME" \
+      node "$WORK_ALLY_IMPLEMENTATION_DIR/bridge/src/server.ts" handoff "$SUBCMD" "$@"
+    ;;
+  thread-sync)
+    export WORK_ALLY_ASSISTANT_MODE="${WORK_ALLY_ASSISTANT_MODE:-assistant}"
+    export WORK_ALLY_ASSISTANT_NAME
+    export WORK_ALLY_ASSISTANT_HOME="${WORK_ALLY_ASSISTANT_HOME:-$(work_ally_assistant_registered_home "$WORK_ALLY_ASSISTANT_NAME")}"
+    export WORK_ALLY_ASSISTANT_CODEX_HOME="${WORK_ALLY_ASSISTANT_CODEX_HOME:-$(work_ally_assistant_registered_codex_home "$WORK_ALLY_ASSISTANT_NAME")}"
+    exec env \
+      CODEX_HOME="$WORK_ALLY_ASSISTANT_CODEX_HOME" \
+      WORK_ALLY_ASSISTANT_MODE="$WORK_ALLY_ASSISTANT_MODE" \
+      WORK_ALLY_ASSISTANT_NAME="$WORK_ALLY_ASSISTANT_NAME" \
+      WORK_ALLY_ASSISTANT_HOME="$WORK_ALLY_ASSISTANT_HOME" \
+      WORK_ALLY_ASSISTANT_CODEX_HOME="$WORK_ALLY_ASSISTANT_CODEX_HOME" \
+      node "$WORK_ALLY_IMPLEMENTATION_DIR/bridge/src/server.ts" thread-sync "$@"
+    ;;
+  *)
+    work_ally_die "Unknown handoff subcommand: ${SUBCMD:-<missing>}"
+    ;;
+esac

package/internal/modules/mcp/manage.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck disable=SC1091
+. "$SCRIPT_DIR/../../lib/common.sh"
+work_ally_init_context
+if [ -z "${WORK_ALLY_ASSISTANT_NAME:-}" ]; then
+  WORK_ALLY_ASSISTANT_NAME=$(work_ally_resolve_assistant_name_from_args "$@" || true)
+fi
+if [ -n "${WORK_ALLY_ASSISTANT_NAME:-}" ]; then
+  work_ally_sync_workspace_root_from_assistant "$WORK_ALLY_ASSISTANT_NAME"
+  work_ally_hydrate_assistant_context "$WORK_ALLY_ASSISTANT_NAME"
+fi
+work_ally_ensure_state_dirs
+work_ally_load_env
+work_ally_require_cmd codex
+cmd_name=$(work_ally_cmd_name)
+
+NAME=feishu
+SUBCMD="${1:-status}"
+shift || true
+
+filtered_args=()
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --assistant)
+      [ "$#" -ge 2 ] || work_ally_die "--assistant requires a value"
+      shift 2
+      ;;
+    --assistant=*)
+      shift
+      ;;
+    *)
+      filtered_args+=("$1")
+      shift
+      ;;
+  esac
+done
+if [ "${#filtered_args[@]}" -gt 0 ]; then
+  set -- "${filtered_args[@]}"
+else
+  set --
+fi
+
+restart_hint() {
+  local bridge_status
+  bridge_status=$(work_ally_process_status bridge)
+  if [[ "$bridge_status" = running* ]]; then
+    work_ally_warn "Codex MCP config is shared by the current user. If runtime is already running, restart with: $cmd_name restart"
+  fi
+}
+
+case "$SUBCMD" in
+  list)
+    exec codex mcp list "$@"
+    ;;
+  status)
+    if codex mcp get "$NAME" --json; then
+      exit 0
+    fi
+    work_ally_warn "Feishu MCP is not installed for the current user."
+    work_ally_note "Set FEISHU_MCP_SERVER_URL in $WORK_ALLY_ENV_FILE, then run: $cmd_name mcp install-feishu"
+    exit 1
+    ;;
+  install-feishu)
+    URL="${FEISHU_MCP_SERVER_URL:-}"
+    [ -n "$URL" ] || work_ally_die "FEISHU_MCP_SERVER_URL is required in $WORK_ALLY_ENV_FILE"
+    work_ally_note "Installing Feishu MCP into current user's Codex config"
+    codex mcp add "$NAME" --url "$URL"
+    work_ally_ok "Feishu MCP installed"
+    restart_hint
+    ;;
+  remove-feishu)
+    work_ally_note "Removing Feishu MCP from current user's Codex config"
+    codex mcp remove "$NAME"
+    work_ally_ok "Feishu MCP removed"
+    restart_hint
+    ;;
+  *)
+    work_ally_die "Unknown mcp subcommand: $SUBCMD"
+    ;;
+esac

package/internal/modules/ops/logs.sh

@@ -0,0 +1,76 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck disable=SC1091
+. "$SCRIPT_DIR/../../lib/common.sh"
+work_ally_init_context
+if [ -z "${WORK_ALLY_ASSISTANT_NAME:-}" ]; then
+  WORK_ALLY_ASSISTANT_NAME=$(work_ally_resolve_assistant_name_from_args "$@" || true)
+fi
+if [ -n "${WORK_ALLY_ASSISTANT_NAME:-}" ]; then
+  work_ally_sync_workspace_root_from_assistant "$WORK_ALLY_ASSISTANT_NAME"
+  work_ally_hydrate_assistant_context "$WORK_ALLY_ASSISTANT_NAME"
+fi
+work_ally_ensure_state_dirs
+work_ally_load_env
+
+filtered_args=()
+while [ "$#" -gt 0 ]; do
+  case "$1" in
+    --assistant)
+      [ "$#" -ge 2 ] || work_ally_die "--assistant requires a value"
+      shift 2
+      ;;
+    --assistant=*)
+      shift
+      ;;
+    *)
+      filtered_args+=("$1")
+      shift
+      ;;
+  esac
+done
+if [ "${#filtered_args[@]}" -gt 0 ]; then
+  set -- "${filtered_args[@]}"
+else
+  set --
+fi
+
+TARGET="${1:-timeline}"
+MODE="${2:-follow}"
+SHIFT_COUNT=2
+
+case "$TARGET" in
+  timeline|bridge|runtime|supervisor|routine)
+    ;;
+  follow|print|--print|--tail)
+    MODE="$TARGET"
+    TARGET="timeline"
+    SHIFT_COUNT=1
+    ;;
+  *)
+    work_ally_die "Unknown log target: $TARGET"
+    ;;
+esac
+
+LOG_FILE=$(work_ally_log_file_for "$TARGET")
+mkdir -p "$WORK_ALLY_LOG_DIR"
+[ -f "$LOG_FILE" ] || touch "$LOG_FILE"
+work_ally_prune_logs
+
+case "$MODE" in
+  follow)
+    tail -f "$LOG_FILE"
+    ;;
+  print|--print)
+    cat "$LOG_FILE"
+    ;;
+  --tail)
+    shift "$SHIFT_COUNT"
+    tail -n "${1:-200}" "$LOG_FILE"
+    ;;
+  *)
+    work_ally_die "Unknown logs mode: $MODE"
+    ;;
+esac

package/internal/modules/routines/manage.sh

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck disable=SC1091
+. "$SCRIPT_DIR/../../lib/common.sh"
+work_ally_init_context
+work_ally_ensure_state_dirs
+if [ -n "${WORK_ALLY_ASSISTANT_NAME:-}" ]; then
+  work_ally_sync_workspace_root_from_assistant "$WORK_ALLY_ASSISTANT_NAME"
+  work_ally_hydrate_assistant_context "$WORK_ALLY_ASSISTANT_NAME"
+fi
+
+SUBCMD="${1:-list}"
+shift || true
+
+work_ally_load_env
+work_ally_load_assistant_state || true
+cmd_name=$(work_ally_cmd_name)
+
+if [ -z "${WORK_ALLY_ASSISTANT_NAME:-}" ]; then
+  WORK_ALLY_ASSISTANT_NAME=$(work_ally_resolve_assistant_name_from_args "$@")
+fi
+work_ally_sync_workspace_root_from_assistant "$WORK_ALLY_ASSISTANT_NAME"
+work_ally_hydrate_assistant_context "$WORK_ALLY_ASSISTANT_NAME"
+
+work_ally_require_assistant_profile_ready "$WORK_ALLY_ASSISTANT_NAME"
+export WORK_ALLY_ASSISTANT_MODE="assistant"
+export WORK_ALLY_ASSISTANT_HOME="$(work_ally_assistant_registered_home "$WORK_ALLY_ASSISTANT_NAME")"
+export WORK_ALLY_ASSISTANT_CODEX_HOME="$(work_ally_assistant_registered_codex_home "$WORK_ALLY_ASSISTANT_NAME")"
+
+run_bridge_cli() {
+  env     WORK_ALLY_ASSISTANT_MODE="${WORK_ALLY_ASSISTANT_MODE:-assistant}"     WORK_ALLY_ASSISTANT_NAME="$WORK_ALLY_ASSISTANT_NAME"     WORK_ALLY_ASSISTANT_HOME="${WORK_ALLY_ASSISTANT_HOME:-}"     WORK_ALLY_ASSISTANT_CODEX_HOME="${WORK_ALLY_ASSISTANT_CODEX_HOME:-}"     node "$WORK_ALLY_IMPLEMENTATION_DIR/bridge/src/server.ts" routine "$@"
+}
+
+case "$SUBCMD" in
+  list)
+    run_bridge_cli list
+    ;;
+  run)
+    [ $# -ge 1 ] || work_ally_die "Usage: $cmd_name routine run <routine-id>"
+    run_bridge_cli run "$@"
+    ;;
+  enable)
+    [ $# -ge 1 ] || work_ally_die "Usage: $cmd_name routine enable <routine-id>"
+    run_bridge_cli enable "$@"
+    ;;
+  disable)
+    [ $# -ge 1 ] || work_ally_die "Usage: $cmd_name routine disable <routine-id>"
+    run_bridge_cli disable "$@"
+    ;;
+  *)
+    work_ally_die "Unknown routine subcommand: $SUBCMD"
+    ;;
+esac

package/internal/modules/runtime/assistant-autosave.sh

@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+# shellcheck disable=SC1091
+. "$SCRIPT_DIR/../../lib/common.sh"
+work_ally_init_context
+if [ -z "${WORK_ALLY_ASSISTANT_NAME:-}" ]; then
+  WORK_ALLY_ASSISTANT_NAME=$(work_ally_resolve_assistant_name_from_args "$@" || true)
+fi
+if [ -n "${WORK_ALLY_ASSISTANT_NAME:-}" ]; then
+  work_ally_sync_workspace_root_from_assistant "$WORK_ALLY_ASSISTANT_NAME"
+  work_ally_hydrate_assistant_context "$WORK_ALLY_ASSISTANT_NAME"
+fi
+work_ally_ensure_state_dirs
+work_ally_load_env
+work_ally_load_assistant_state || true
+
+[ -n "${WORK_ALLY_ASSISTANT_HOME:-}" ] || exit 0
+interval=$(work_ally_assistant_autosave_interval)
+work_ally_assistant_git_setup "$WORK_ALLY_ASSISTANT_HOME" "${WORK_ALLY_ASSISTANT_GIT_REMOTE:-}" || true
+
+while :; do
+  sleep "$interval"
+  work_ally_assistant_git_checkpoint "$WORK_ALLY_ASSISTANT_HOME" "autosave" || true
+done

package/internal/modules/runtime/restart.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR=$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)
+"$SCRIPT_DIR/stop.sh" "$@"
+"$SCRIPT_DIR/start.sh" "$@"