smart_ide/scripts/ensure-ia-dev-project-link.sh
Nicolas Cantu cfa1f435cb refactor: centralize HTTP proxy helpers and align IA_DEV_ROOT resolution (0.0.6)
Initial state:
- HTTP proxy utilities (Bearer parsing, hop-by-hop headers, body limits, safe path validation) were duplicated between smart-ide-sso-gateway and smart-ide-global-api.
- IA_DEV_ROOT auto-resolution order differed between bash (ensure-ia-dev-project-link.sh) and TypeScript (ia-dev-gateway getIaDevRoot), and could fall back to non-existing paths.

Motivation:
- Reduce duplication and drift across proxy layers.
- Enforce consistent, explicit IA_DEV_ROOT behavior across scripts and services.

Resolution:
- Add package @4nk/smart-ide-http-utils and reuse it from smart-ide-sso-gateway and smart-ide-global-api.
- Align IA_DEV_ROOT resolution to prefer ./services/ia_dev then ./ia_dev; fail fast when missing/misconfigured.

Root cause:
- Cross-service utilities were implemented ad-hoc in each service.
- Historical layout transitions (ia_dev gitlink vs vendored services/ia_dev) left multiple resolvers with different priorities.

Impacted features:
- HTTP proxy chain (SSO gateway -> global API -> upstream services).
- ia-dev-gateway startup/operation when IA_DEV_ROOT is missing or invalid.

Code modified:
- packages/smart-ide-http-utils/**
- services/smart-ide-global-api/src/server.ts
- services/smart-ide-sso-gateway/src/server.ts
- services/ia-dev-gateway/src/paths.ts
- scripts/ensure-ia-dev-project-link.sh

Documentation modified:
- docs/system-architecture.md
- docs/ia_dev-module.md
- docs/repo/README.md

Configurations modified:
- services/smart-ide-global-api/package.json
- services/smart-ide-sso-gateway/package.json

Files in deploy modified:
- None

Files in logs impacted:
- None (runtime logs only)

Databases and other sources modified:
- None

Off-project modifications:
- None

Files in .smartIde modified:
- None

Files in .secrets modified:
- None

New patch version in VERSION:
- 0.0.6

CHANGELOG.md updated:
- yes
2026-04-04 20:34:49 +02:00

37 lines
1.1 KiB
Bash
Executable File

#!/usr/bin/env bash
# Create IA_DEV_ROOT/projects/<id> -> ../../projects/<id> so ia_dev scripts resolve conf.json
# from the monorepo versioned projects/<id>/.
set -euo pipefail
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
PROJECT_ID="${1:?usage: $(basename "$0") <project_id>}"
CONF="${ROOT}/projects/${PROJECT_ID}/conf.json"
if [[ ! -f "${CONF}" ]]; then
echo "Missing ${CONF}" >&2
exit 1
fi
IA_DEV_DIR=""
if [[ -d "${ROOT}/services/ia_dev" ]]; then
IA_DEV_DIR="${ROOT}/services/ia_dev"
elif [[ -d "${ROOT}/ia_dev" ]]; then
IA_DEV_DIR="${ROOT}/ia_dev"
else
echo "Missing ia_dev directory: expected '${ROOT}/services/ia_dev' or '${ROOT}/ia_dev'" >&2
exit 1
fi
LINK_PARENT="${IA_DEV_DIR}/projects"
TARGET="../../projects/${PROJECT_ID}"
if [[ "${IA_DEV_DIR}" == "${ROOT}/services/ia_dev" ]]; then
TARGET="../../../projects/${PROJECT_ID}"
fi
LINK_NAME="${LINK_PARENT}/${PROJECT_ID}"
mkdir -p "${LINK_PARENT}"
if [[ -e "${LINK_NAME}" && ! -L "${LINK_NAME}" ]]; then
echo "Refusing to replace non-symlink: ${LINK_NAME}" >&2
exit 1
fi
ln -sfn "${TARGET}" "${LINK_NAME}"
echo "OK: ${LINK_NAME} -> ${TARGET}"