@ankhorage/infra 4.0.0 → 4.1.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ankhorage/infra
 
+## 4.1.0
+
+### Minor Changes
+
+- 66ef9aa: Add a provider-aware runtime port-forward lifecycle and export `ensureProjectInfrastructureRuntime` from `@ankhorage/infra/project`.
+
 ## 4.0.0
 
 ### Major Changes

package/README.md

@@ -3,7 +3,7 @@
 
 # INFRA
 
-![license: MIT](././paradox/badges/license.svg) ![npm: v3.3.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
+![license: MIT](././paradox/badges/license.svg) ![npm: v4.0.0](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![docs: paradox](././paradox/badges/docs.svg)
 
 Executable infra provider and standalone CLI for Ankhorage project workflows.
 
@@ -37,6 +37,11 @@ omit it when cwd is already inside `apps/<project>`. Programmatic project
 operations accept an explicit project path and do not require Studio or a
 particular workspace layout.
 
+Running applications can repair their provider-aware host endpoints through
+`ensureProjectInfrastructureRuntime()` from `@ankhorage/infra/project`. This
+operation only ensures the generated runtime port-forward group; it does not
+deploy, bootstrap, or reconcile infrastructure.
+
 Source: `src/readme-usage.ts`
 
 ```ts

package/dist/adapters/minikube/base/index.js

@@ -290,6 +290,13 @@ host-level Supabase Compose runtime.
 - \`reset.sh\`: requires \`ANKH_RESET_CONFIRM=${appSlug}\`; ${resetDescription}. It does not delete the Minikube profile.
 - \`destroy.sh\`: deletes only \`minikube -p ${appSlug}\`.
 
+### Port-forward groups
+
+- \`./scripts/port-forward.sh start runtime\` idempotently ensures ${supabaseKubernetesEnabled ? '`app` and `supabase-gateway`' : '`app` only'}, the host endpoints required by the running application. The same group supports \`stop\` and \`status\`.
+- \`runtime\` excludes \`studio\` and \`db-migration\`, which are operational/bootstrap endpoints.
+- \`all\` retains every generated forward, including operational/bootstrap endpoints.
+- Concrete targets remain available for individual lifecycle control.
+
 ## Generated Resources
 
 ${resourceLines}
@@ -2711,6 +2718,11 @@ CMD ["nginx", "-g", "daemon off;"]
 }
 function getPortForwardScript(args) {
     const { appSlug, supabaseKubernetesEnabled, supabaseHostPorts } = args;
+    const runtimeForwardNames = ['app', ...(supabaseKubernetesEnabled ? ['supabase-gateway'] : [])];
+    const allForwardNames = [
+        ...runtimeForwardNames,
+        ...(supabaseKubernetesEnabled ? ['studio', 'db-migration'] : []),
+    ];
     return `#!/usr/bin/env bash
 set -euo pipefail
 
@@ -2728,6 +2740,8 @@ SUPABASE_STUDIO_FORWARD_LOCAL_PORT="\${SUPABASE_STUDIO_FORWARD_LOCAL_PORT:-${sup
 SUPABASE_STUDIO_FORWARD_REMOTE_PORT="\${SUPABASE_STUDIO_FORWARD_REMOTE_PORT:-3000}"
 SUPABASE_DB_FORWARD_LOCAL_PORT="\${SUPABASE_DB_FORWARD_LOCAL_PORT:-${supabaseHostPorts.db}}"
 SUPABASE_DB_FORWARD_REMOTE_PORT="\${SUPABASE_DB_FORWARD_REMOTE_PORT:-5432}"
+RUNTIME_FORWARD_NAMES=(${runtimeForwardNames.join(' ')})
+ALL_FORWARD_NAMES=(${allForwardNames.join(' ')})
 
 if [[ -f "\${ROOT_DIR}/.env" ]]; then
   set -a
@@ -3013,26 +3027,28 @@ status_forward() {
 
 for_each_forward() {
   local action="\${1}"
-  "\${action}_forward" app
-  if [[ "\${SUPABASE_RUNTIME_ENABLED}" == "true" ]]; then
-    "\${action}_forward" supabase-gateway
-    "\${action}_forward" studio
-    "\${action}_forward" db-migration
-  fi
+  shift
+  local name
+  for name in "\${@}"; do
+    "\${action}_forward" "\${name}"
+  done
 }
 
 ACTION="\${1:-start}"
 NAME="\${2:-all}"
 
 case "\${ACTION}:\${NAME}" in
-  start:all) for_each_forward start ;;
-  stop:all) for_each_forward stop ;;
-  status:all) for_each_forward status ;;
+  start:runtime) for_each_forward start "\${RUNTIME_FORWARD_NAMES[@]}" ;;
+  stop:runtime) for_each_forward stop "\${RUNTIME_FORWARD_NAMES[@]}" ;;
+  status:runtime) for_each_forward status "\${RUNTIME_FORWARD_NAMES[@]}" ;;
+  start:all) for_each_forward start "\${ALL_FORWARD_NAMES[@]}" ;;
+  stop:all) for_each_forward stop "\${ALL_FORWARD_NAMES[@]}" ;;
+  status:all) for_each_forward status "\${ALL_FORWARD_NAMES[@]}" ;;
   start:*) start_forward "\${NAME}" ;;
   stop:*) stop_forward "\${NAME}" ;;
   status:*) status_forward "\${NAME}" ;;
   *)
-    echo "Usage: ./scripts/port-forward.sh {start|stop|status} {app|supabase-gateway|studio|db-migration|all}"
+    echo "Usage: ./scripts/port-forward.sh {start|stop|status} {app|supabase-gateway|studio|db-migration|runtime|all}"
     exit 1
     ;;
 esac