@ankhorage/infra 4.0.0 → 4.1.0

package/dist/project/index.d.ts

@@ -2,5 +2,5 @@ export { type ResolvedInfraProject, resolveInfraProject as resolveInfraWorkspace
 export { resolveProjectInfrastructureDatabaseUrl } from '../projectDatabase.js';
 export { readProjectInfrastructureEnvironment } from '../projectEnvironment.js';
 export { type InfraProjectInspection, type InfraSyncResult, inspectProjectInfrastructure, resolveProjectInfrastructureTarget, syncProjectInfrastructure, } from '../projectInfrastructure.js';
-export { type InfraLifecycleScript, type InfraPortForwardInfo, InfraScriptExecutionError, type InfraScriptOutput, resolveProjectInfrastructurePortForward, runProjectInfrastructureLifecycle, } from '../runtime.js';
+export { ensureProjectInfrastructureRuntime, type InfraLifecycleScript, type InfraPortForwardInfo, InfraScriptExecutionError, type InfraScriptOutput, resolveProjectInfrastructurePortForward, runProjectInfrastructureLifecycle, } from '../runtime.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/project/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EACzB,mBAAmB,IAAI,4BAA4B,GACpD,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,uCAAuC,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,oCAAoC,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,4BAA4B,EAC5B,kCAAkC,EAClC,yBAAyB,GAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,uCAAuC,EACvC,iCAAiC,GAClC,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,oBAAoB,EACzB,mBAAmB,IAAI,4BAA4B,GACpD,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,uCAAuC,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,oCAAoC,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,4BAA4B,EAC5B,kCAAkC,EAClC,yBAAyB,GAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,kCAAkC,EAClC,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,yBAAyB,EACzB,KAAK,iBAAiB,EACtB,uCAAuC,EACvC,iCAAiC,GAClC,MAAM,eAAe,CAAC"}

package/dist/project/index.js

@@ -2,5 +2,5 @@ export { resolveInfraProject as resolveInfraWorkspaceProject, } from '../project
 export { resolveProjectInfrastructureDatabaseUrl } from '../projectDatabase.js';
 export { readProjectInfrastructureEnvironment } from '../projectEnvironment.js';
 export { inspectProjectInfrastructure, resolveProjectInfrastructureTarget, syncProjectInfrastructure, } from '../projectInfrastructure.js';
-export { InfraScriptExecutionError, resolveProjectInfrastructurePortForward, runProjectInfrastructureLifecycle, } from '../runtime.js';
+export { ensureProjectInfrastructureRuntime, InfraScriptExecutionError, resolveProjectInfrastructurePortForward, runProjectInfrastructureLifecycle, } from '../runtime.js';
 //# sourceMappingURL=index.js.map

package/dist/project/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,IAAI,4BAA4B,GACpD,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,uCAAuC,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,oCAAoC,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAGL,4BAA4B,EAC5B,kCAAkC,EAClC,yBAAyB,GAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAGL,yBAAyB,EAEzB,uCAAuC,EACvC,iCAAiC,GAClC,MAAM,eAAe,CAAC","sourcesContent":["export {\n  type ResolvedInfraProject,\n  resolveInfraProject as resolveInfraWorkspaceProject,\n} from '../project.js';\nexport { resolveProjectInfrastructureDatabaseUrl } from '../projectDatabase.js';\nexport { readProjectInfrastructureEnvironment } from '../projectEnvironment.js';\nexport {\n  type InfraProjectInspection,\n  type InfraSyncResult,\n  inspectProjectInfrastructure,\n  resolveProjectInfrastructureTarget,\n  syncProjectInfrastructure,\n} from '../projectInfrastructure.js';\nexport {\n  type InfraLifecycleScript,\n  type InfraPortForwardInfo,\n  InfraScriptExecutionError,\n  type InfraScriptOutput,\n  resolveProjectInfrastructurePortForward,\n  runProjectInfrastructureLifecycle,\n} from '../runtime.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/project/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,mBAAmB,IAAI,4BAA4B,GACpD,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,uCAAuC,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EAAE,oCAAoC,EAAE,MAAM,0BAA0B,CAAC;AAChF,OAAO,EAGL,4BAA4B,EAC5B,kCAAkC,EAClC,yBAAyB,GAC1B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,kCAAkC,EAGlC,yBAAyB,EAEzB,uCAAuC,EACvC,iCAAiC,GAClC,MAAM,eAAe,CAAC","sourcesContent":["export {\n  type ResolvedInfraProject,\n  resolveInfraProject as resolveInfraWorkspaceProject,\n} from '../project.js';\nexport { resolveProjectInfrastructureDatabaseUrl } from '../projectDatabase.js';\nexport { readProjectInfrastructureEnvironment } from '../projectEnvironment.js';\nexport {\n  type InfraProjectInspection,\n  type InfraSyncResult,\n  inspectProjectInfrastructure,\n  resolveProjectInfrastructureTarget,\n  syncProjectInfrastructure,\n} from '../projectInfrastructure.js';\nexport {\n  ensureProjectInfrastructureRuntime,\n  type InfraLifecycleScript,\n  type InfraPortForwardInfo,\n  InfraScriptExecutionError,\n  type InfraScriptOutput,\n  resolveProjectInfrastructurePortForward,\n  runProjectInfrastructureLifecycle,\n} from '../runtime.js';\n"]}

package/dist/readme-usage.js

@@ -28,6 +28,11 @@ import { runCli } from './cli/bin.js';
  * 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.
+ *
  * @usage
  */
 await runCli(['--help']);

package/dist/readme-usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"readme-usage.js","sourceRoot":"","sources":["../src/readme-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC","sourcesContent":["import { runCli } from './cli/bin.js';\n\n/***\n * Provider, CLI, and project API surface\n *\n * `@ankhorage/infra` owns infrastructure generation, project reconciliation,\n * and generated lifecycle execution.\n *\n * The same owner implementation backs CLI consumers and the public\n * `@ankhorage/infra/project` application-service boundary. Trusted hosts such\n * as Studio should call that subpath instead of reproducing ledger, generated\n * file, lifecycle-script, or port-forward configuration semantics.\n *\n * CLI entrypoints:\n *\n * - `ankh infra ...`\n * - `bunx @ankhorage/infra ...`\n *\n * Current command surface:\n *\n * - `validate`\n * - `generate`\n * - `status`\n * - `up`\n * - `down`\n *\n * Project resolution for the CLI is workspace-aware: pass `[project]`, or\n * omit it when cwd is already inside `apps/<project>`. Programmatic project\n * operations accept an explicit project path and do not require Studio or a\n * particular workspace layout.\n *\n * @usage\n */\nawait runCli(['--help']);\n"]}
+{"version":3,"file":"readme-usage.js","sourceRoot":"","sources":["../src/readme-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC","sourcesContent":["import { runCli } from './cli/bin.js';\n\n/***\n * Provider, CLI, and project API surface\n *\n * `@ankhorage/infra` owns infrastructure generation, project reconciliation,\n * and generated lifecycle execution.\n *\n * The same owner implementation backs CLI consumers and the public\n * `@ankhorage/infra/project` application-service boundary. Trusted hosts such\n * as Studio should call that subpath instead of reproducing ledger, generated\n * file, lifecycle-script, or port-forward configuration semantics.\n *\n * CLI entrypoints:\n *\n * - `ankh infra ...`\n * - `bunx @ankhorage/infra ...`\n *\n * Current command surface:\n *\n * - `validate`\n * - `generate`\n * - `status`\n * - `up`\n * - `down`\n *\n * Project resolution for the CLI is workspace-aware: pass `[project]`, or\n * omit it when cwd is already inside `apps/<project>`. Programmatic project\n * operations accept an explicit project path and do not require Studio or a\n * particular workspace layout.\n *\n * Running applications can repair their provider-aware host endpoints through\n * `ensureProjectInfrastructureRuntime()` from `@ankhorage/infra/project`. This\n * operation only ensures the generated runtime port-forward group; it does not\n * deploy, bootstrap, or reconcile infrastructure.\n *\n * @usage\n */\nawait runCli(['--help']);\n"]}

package/dist/runtime.d.ts

@@ -33,6 +33,12 @@ export declare function resolveProjectInfrastructurePortForward(args: {
     readonly projectPath: string;
     readonly target: string;
 }): Promise<InfraPortForwardInfo>;
+/** Ensures the generated host forwards required by a running application are active. */
+export declare function ensureProjectInfrastructureRuntime(args: {
+    readonly projectId: string;
+    readonly projectPath: string;
+    readonly target: string;
+}): Promise<InfraScriptOutput>;
 export declare function runProjectInfraScript(args: {
     readonly context: InfraCommandContext;
     readonly projectId: string;

package/dist/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;AAEnG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE;QAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB;CAOF;AAED,wBAAsB,iCAAiC,CAAC,IAAI,EAAE;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAe7B;AAED,wBAAsB,uCAAuC,CAAC,IAAI,EAAE;IAClE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkBhC;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAET"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG/D,MAAM,MAAM,oBAAoB,GAAG,SAAS,GAAG,MAAM,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC;AAEnG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,IAAI,EAAE;QAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;KACzB;CAOF;AAED,wBAAsB,iCAAiC,CAAC,IAAI,EAAE;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAe7B;AAED,wBAAsB,uCAAuC,CAAC,IAAI,EAAE;IAClE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkBhC;AAED,wFAAwF;AACxF,wBAAsB,kCAAkC,CAAC,IAAI,EAAE;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwB7B;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE;IAChD,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhB;AAED,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAET"}

package/dist/runtime.js

@@ -42,6 +42,30 @@ export async function resolveProjectInfrastructurePortForward(args) {
         url: `http://127.0.0.1:${localPort}`,
     };
 }
+/** Ensures the generated host forwards required by a running application are active. */
+export async function ensureProjectInfrastructureRuntime(args) {
+    try {
+        return await runProjectInfrastructureLifecycle({
+            args: ['start', 'runtime'],
+            projectId: args.projectId,
+            projectPath: args.projectPath,
+            script: 'port-forward',
+            target: args.target,
+        });
+    }
+    catch (error) {
+        if (!(error instanceof InfraScriptExecutionError)) {
+            throw error;
+        }
+        const detail = error.stderr.trim() || error.stdout.trim();
+        throw new InfraScriptExecutionError({
+            exitCode: error.exitCode,
+            message: `Failed to ensure infrastructure runtime for project '${args.projectId}'${detail.length > 0 ? `: ${detail}` : '.'}`,
+            stderr: error.stderr,
+            stdout: error.stdout,
+        });
+    }
+}
 export async function runProjectInfraScript(args) {
     await runProjectInfrastructureLifecycle({
         env: args.context.env,

package/dist/runtime.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,OAAO,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAC;AAc/E,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IACzC,QAAQ,CAAgB;IACxB,MAAM,CAAS;IACf,MAAM,CAAS;IAExB,YAAY,IAKX;QACC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,iCAAiC,CAAC,IASvD;IACC,MAAM,UAAU,GAAG,6BAA6B,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CACb,2BAA2B,UAAU,qCAAqC,IAAI,CAAC,SAAS,UAAU,CACnG,CAAC;IACJ,CAAC;IAED,OAAO,cAAc,CAAC;QACpB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;QACrB,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG;QAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU;KACX,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uCAAuC,CAAC,IAG7D;IACC,MAAM,WAAW,GAAG,MAAM,oCAAoC,CAAC;QAC7D,IAAI,EAAE,CAAC,6BAA6B,CAAC;QACrC,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,iBAAiB,CAAC,WAAW,CAAC,2BAA2B,CAAC,CAAC;IAE7E,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAC;IACJ,CAAC;IAED,OAAO;QACL,SAAS;QACT,GAAG,EAAE,oBAAoB,SAAS,EAAE;KACrC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,IAM3C;IACC,MAAM,iCAAiC,CAAC;QACtC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;QACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC;QACpD,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC;QACpD,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,IAI7C;IACC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC;AACjG,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAc;IAC9C,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,UAAU;YACb,OAAO,wBAAwB,CAAC;QAClC;YACE,MAAM,IAAI,KAAK,CAAC,oDAAoD,MAAM,EAAE,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,IAM7B;IACC,OAAO,IAAI,OAAO,CAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE;YAC3D,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YAClC,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;YACpB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC;YAChB,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YACxC,MAAM,IAAI,KAAK,CAAC;YAChB,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAC5B,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CACjE,CAAC;QACF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC/B,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;gBACnB,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;gBAC5B,OAAO;YACT,CAAC;YACD,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CACvB,UAAkB,EAClB,KAAY,EACZ,MAAc,EACd,MAAc;IAEd,OAAO,IAAI,yBAAyB,CAAC;QACnC,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,iCAAiC,UAAU,MAAM,KAAK,CAAC,OAAO,EAAE;QACzE,MAAM;QACN,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,UAAkB,EAClB,QAAuB,EACvB,MAAc,EACd,MAAc;IAEd,OAAO,IAAI,yBAAyB,CAAC;QACnC,QAAQ;QACR,OAAO,EAAE,iBAAiB,UAAU,sBAAsB,QAAQ,IAAI,SAAS,GAAG;QAClF,MAAM;QACN,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAyB;IAClD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACjD,OAAO,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,IAAI,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AACrF,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC","sourcesContent":["import { spawn } from 'child_process';\nimport { promises as fs } from 'fs';\nimport path from 'path';\n\nimport type { InfraCommandContext } from './commandContext.js';\nimport { readProjectInfrastructureEnvironment } from './projectEnvironment.js';\n\nexport type InfraLifecycleScript = 'destroy' | 'down' | 'port-forward' | 'reset' | 'status' | 'up';\n\nexport interface InfraScriptOutput {\n  readonly stderr: string;\n  readonly stdout: string;\n}\n\nexport interface InfraPortForwardInfo {\n  readonly localPort: number;\n  readonly url: string;\n}\n\nexport class InfraScriptExecutionError extends Error {\n  readonly exitCode: number | null;\n  readonly stderr: string;\n  readonly stdout: string;\n\n  constructor(args: {\n    readonly exitCode: number | null;\n    readonly message: string;\n    readonly stderr: string;\n    readonly stdout: string;\n  }) {\n    super(args.message);\n    this.name = 'InfraScriptExecutionError';\n    this.exitCode = args.exitCode;\n    this.stderr = args.stderr;\n    this.stdout = args.stdout;\n  }\n}\n\nexport async function runProjectInfrastructureLifecycle(args: {\n  readonly args?: readonly string[];\n  readonly env?: Readonly<Record<string, string | undefined>>;\n  readonly onStderr?: (chunk: string) => void;\n  readonly onStdout?: (chunk: string) => void;\n  readonly projectId: string;\n  readonly projectPath: string;\n  readonly script: InfraLifecycleScript;\n  readonly target: string;\n}): Promise<InfraScriptOutput> {\n  const scriptPath = resolveProjectInfraScriptPath(args);\n  if (!(await pathExists(scriptPath))) {\n    throw new Error(\n      `Infra script not found: ${scriptPath}. Run infra generate for project '${args.projectId}' first.`,\n    );\n  }\n\n  return runShellScript({\n    args: args.args ?? [],\n    env: args.env ?? process.env,\n    onStderr: args.onStderr,\n    onStdout: args.onStdout,\n    scriptPath,\n  });\n}\n\nexport async function resolveProjectInfrastructurePortForward(args: {\n  readonly projectPath: string;\n  readonly target: string;\n}): Promise<InfraPortForwardInfo> {\n  const environment = await readProjectInfrastructureEnvironment({\n    keys: ['APP_PORT_FORWARD_LOCAL_PORT'],\n    projectPath: args.projectPath,\n    target: args.target,\n  });\n  const localPort = parsePositivePort(environment.APP_PORT_FORWARD_LOCAL_PORT);\n\n  if (localPort === null) {\n    throw new Error(\n      'Generated Infra did not provide a valid APP_PORT_FORWARD_LOCAL_PORT. Regenerate infrastructure first.',\n    );\n  }\n\n  return {\n    localPort,\n    url: `http://127.0.0.1:${localPort}`,\n  };\n}\n\nexport async function runProjectInfraScript(args: {\n  readonly context: InfraCommandContext;\n  readonly projectId: string;\n  readonly projectPath: string;\n  readonly script: InfraLifecycleScript;\n  readonly target: string;\n}): Promise<void> {\n  await runProjectInfrastructureLifecycle({\n    env: args.context.env,\n    onStderr: (chunk) => args.context.writeStderr(chunk),\n    onStdout: (chunk) => args.context.writeStdout(chunk),\n    projectId: args.projectId,\n    projectPath: args.projectPath,\n    script: args.script,\n    target: args.target,\n  });\n}\n\nexport function resolveProjectInfraScriptPath(args: {\n  readonly projectPath: string;\n  readonly script: InfraLifecycleScript;\n  readonly target: string;\n}): string {\n  return path.join(args.projectPath, getInfraScriptsDirectory(args.target), `${args.script}.sh`);\n}\n\nfunction getInfraScriptsDirectory(target: string): string {\n  switch (target) {\n    case 'minikube':\n      return 'infra/minikube/scripts';\n    default:\n      throw new Error(`Unsupported deployment target for infra scripts: ${target}`);\n  }\n}\n\nasync function runShellScript(args: {\n  readonly args: readonly string[];\n  readonly env: Readonly<Record<string, string | undefined>>;\n  readonly onStderr?: (chunk: string) => void;\n  readonly onStdout?: (chunk: string) => void;\n  readonly scriptPath: string;\n}): Promise<InfraScriptOutput> {\n  return new Promise<InfraScriptOutput>((resolve, reject) => {\n    const child = spawn('bash', [args.scriptPath, ...args.args], {\n      cwd: path.dirname(args.scriptPath),\n      env: { ...args.env },\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n\n    let stdout = '';\n    let stderr = '';\n    child.stdout.setEncoding('utf8');\n    child.stderr.setEncoding('utf8');\n    child.stdout.on('data', (chunk: string) => {\n      stdout += chunk;\n      args.onStdout?.(chunk);\n    });\n    child.stderr.on('data', (chunk: string) => {\n      stderr += chunk;\n      args.onStderr?.(chunk);\n    });\n    child.once('error', (error) =>\n      reject(createStartError(args.scriptPath, error, stdout, stderr)),\n    );\n    child.once('close', (exitCode) => {\n      if (exitCode === 0) {\n        resolve({ stderr, stdout });\n        return;\n      }\n      reject(createExitError(args.scriptPath, exitCode, stdout, stderr));\n    });\n  });\n}\n\nfunction createStartError(\n  scriptPath: string,\n  error: Error,\n  stdout: string,\n  stderr: string,\n): InfraScriptExecutionError {\n  return new InfraScriptExecutionError({\n    exitCode: null,\n    message: `Failed to start infra script '${scriptPath}': ${error.message}`,\n    stderr,\n    stdout,\n  });\n}\n\nfunction createExitError(\n  scriptPath: string,\n  exitCode: number | null,\n  stdout: string,\n  stderr: string,\n): InfraScriptExecutionError {\n  return new InfraScriptExecutionError({\n    exitCode,\n    message: `Infra script '${scriptPath}' exited with code ${exitCode ?? 'unknown'}.`,\n    stderr,\n    stdout,\n  });\n}\n\nfunction parsePositivePort(value: string | undefined): number | null {\n  if (value === undefined) return null;\n  const parsed = Number.parseInt(value.trim(), 10);\n  return Number.isInteger(parsed) && parsed >= 1 && parsed <= 65_535 ? parsed : null;\n}\n\nasync function pathExists(filePath: string): Promise<boolean> {\n  try {\n    await fs.access(filePath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n"]}
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from 'child_process';\nimport { promises as fs } from 'fs';\nimport path from 'path';\n\nimport type { InfraCommandContext } from './commandContext.js';\nimport { readProjectInfrastructureEnvironment } from './projectEnvironment.js';\n\nexport type InfraLifecycleScript = 'destroy' | 'down' | 'port-forward' | 'reset' | 'status' | 'up';\n\nexport interface InfraScriptOutput {\n  readonly stderr: string;\n  readonly stdout: string;\n}\n\nexport interface InfraPortForwardInfo {\n  readonly localPort: number;\n  readonly url: string;\n}\n\nexport class InfraScriptExecutionError extends Error {\n  readonly exitCode: number | null;\n  readonly stderr: string;\n  readonly stdout: string;\n\n  constructor(args: {\n    readonly exitCode: number | null;\n    readonly message: string;\n    readonly stderr: string;\n    readonly stdout: string;\n  }) {\n    super(args.message);\n    this.name = 'InfraScriptExecutionError';\n    this.exitCode = args.exitCode;\n    this.stderr = args.stderr;\n    this.stdout = args.stdout;\n  }\n}\n\nexport async function runProjectInfrastructureLifecycle(args: {\n  readonly args?: readonly string[];\n  readonly env?: Readonly<Record<string, string | undefined>>;\n  readonly onStderr?: (chunk: string) => void;\n  readonly onStdout?: (chunk: string) => void;\n  readonly projectId: string;\n  readonly projectPath: string;\n  readonly script: InfraLifecycleScript;\n  readonly target: string;\n}): Promise<InfraScriptOutput> {\n  const scriptPath = resolveProjectInfraScriptPath(args);\n  if (!(await pathExists(scriptPath))) {\n    throw new Error(\n      `Infra script not found: ${scriptPath}. Run infra generate for project '${args.projectId}' first.`,\n    );\n  }\n\n  return runShellScript({\n    args: args.args ?? [],\n    env: args.env ?? process.env,\n    onStderr: args.onStderr,\n    onStdout: args.onStdout,\n    scriptPath,\n  });\n}\n\nexport async function resolveProjectInfrastructurePortForward(args: {\n  readonly projectPath: string;\n  readonly target: string;\n}): Promise<InfraPortForwardInfo> {\n  const environment = await readProjectInfrastructureEnvironment({\n    keys: ['APP_PORT_FORWARD_LOCAL_PORT'],\n    projectPath: args.projectPath,\n    target: args.target,\n  });\n  const localPort = parsePositivePort(environment.APP_PORT_FORWARD_LOCAL_PORT);\n\n  if (localPort === null) {\n    throw new Error(\n      'Generated Infra did not provide a valid APP_PORT_FORWARD_LOCAL_PORT. Regenerate infrastructure first.',\n    );\n  }\n\n  return {\n    localPort,\n    url: `http://127.0.0.1:${localPort}`,\n  };\n}\n\n/** Ensures the generated host forwards required by a running application are active. */\nexport async function ensureProjectInfrastructureRuntime(args: {\n  readonly projectId: string;\n  readonly projectPath: string;\n  readonly target: string;\n}): Promise<InfraScriptOutput> {\n  try {\n    return await runProjectInfrastructureLifecycle({\n      args: ['start', 'runtime'],\n      projectId: args.projectId,\n      projectPath: args.projectPath,\n      script: 'port-forward',\n      target: args.target,\n    });\n  } catch (error) {\n    if (!(error instanceof InfraScriptExecutionError)) {\n      throw error;\n    }\n\n    const detail = error.stderr.trim() || error.stdout.trim();\n    throw new InfraScriptExecutionError({\n      exitCode: error.exitCode,\n      message: `Failed to ensure infrastructure runtime for project '${args.projectId}'${\n        detail.length > 0 ? `: ${detail}` : '.'\n      }`,\n      stderr: error.stderr,\n      stdout: error.stdout,\n    });\n  }\n}\n\nexport async function runProjectInfraScript(args: {\n  readonly context: InfraCommandContext;\n  readonly projectId: string;\n  readonly projectPath: string;\n  readonly script: InfraLifecycleScript;\n  readonly target: string;\n}): Promise<void> {\n  await runProjectInfrastructureLifecycle({\n    env: args.context.env,\n    onStderr: (chunk) => args.context.writeStderr(chunk),\n    onStdout: (chunk) => args.context.writeStdout(chunk),\n    projectId: args.projectId,\n    projectPath: args.projectPath,\n    script: args.script,\n    target: args.target,\n  });\n}\n\nexport function resolveProjectInfraScriptPath(args: {\n  readonly projectPath: string;\n  readonly script: InfraLifecycleScript;\n  readonly target: string;\n}): string {\n  return path.join(args.projectPath, getInfraScriptsDirectory(args.target), `${args.script}.sh`);\n}\n\nfunction getInfraScriptsDirectory(target: string): string {\n  switch (target) {\n    case 'minikube':\n      return 'infra/minikube/scripts';\n    default:\n      throw new Error(`Unsupported deployment target for infra scripts: ${target}`);\n  }\n}\n\nasync function runShellScript(args: {\n  readonly args: readonly string[];\n  readonly env: Readonly<Record<string, string | undefined>>;\n  readonly onStderr?: (chunk: string) => void;\n  readonly onStdout?: (chunk: string) => void;\n  readonly scriptPath: string;\n}): Promise<InfraScriptOutput> {\n  return new Promise<InfraScriptOutput>((resolve, reject) => {\n    const child = spawn('bash', [args.scriptPath, ...args.args], {\n      cwd: path.dirname(args.scriptPath),\n      env: { ...args.env },\n      stdio: ['ignore', 'pipe', 'pipe'],\n    });\n\n    let stdout = '';\n    let stderr = '';\n    child.stdout.setEncoding('utf8');\n    child.stderr.setEncoding('utf8');\n    child.stdout.on('data', (chunk: string) => {\n      stdout += chunk;\n      args.onStdout?.(chunk);\n    });\n    child.stderr.on('data', (chunk: string) => {\n      stderr += chunk;\n      args.onStderr?.(chunk);\n    });\n    child.once('error', (error) =>\n      reject(createStartError(args.scriptPath, error, stdout, stderr)),\n    );\n    child.once('close', (exitCode) => {\n      if (exitCode === 0) {\n        resolve({ stderr, stdout });\n        return;\n      }\n      reject(createExitError(args.scriptPath, exitCode, stdout, stderr));\n    });\n  });\n}\n\nfunction createStartError(\n  scriptPath: string,\n  error: Error,\n  stdout: string,\n  stderr: string,\n): InfraScriptExecutionError {\n  return new InfraScriptExecutionError({\n    exitCode: null,\n    message: `Failed to start infra script '${scriptPath}': ${error.message}`,\n    stderr,\n    stdout,\n  });\n}\n\nfunction createExitError(\n  scriptPath: string,\n  exitCode: number | null,\n  stdout: string,\n  stderr: string,\n): InfraScriptExecutionError {\n  return new InfraScriptExecutionError({\n    exitCode,\n    message: `Infra script '${scriptPath}' exited with code ${exitCode ?? 'unknown'}.`,\n    stderr,\n    stdout,\n  });\n}\n\nfunction parsePositivePort(value: string | undefined): number | null {\n  if (value === undefined) return null;\n  const parsed = Number.parseInt(value.trim(), 10);\n  return Number.isInteger(parsed) && parsed >= 1 && parsed <= 65_535 ? parsed : null;\n}\n\nasync function pathExists(filePath: string): Promise<boolean> {\n  try {\n    await fs.access(filePath);\n    return true;\n  } catch {\n    return false;\n  }\n}\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ankhorage/infra",
   "type": "module",
-  "version": "4.0.0",
+  "version": "4.1.0",
   "description": "Project-aware infrastructure generation library and executable Ankh provider for Ankhorage.",
   "homepage": "https://github.com/ankhorage/infra#readme",
   "bugs": {

package/src/adapters/minikube/README.md

@@ -30,9 +30,17 @@ when provided by caller.
 - `scripts/reset.sh`: requires `ANKH_RESET_CONFIRM=<slug>` and deletes/recreates namespaces `app` and `supabase`, including Supabase DB and Storage PVC data. It does not delete the Minikube profile.
 - `scripts/destroy.sh`: stops slug-owned port-forwards and runs `minikube delete -p <slug>`.
 - `scripts/status.sh`: reports profile, namespace, workload, and port-forward health.
-- `scripts/port-forward.sh`: owns named forwards for `app`, `supabase-gateway`, `studio`, and `db-migration`.
+- `scripts/port-forward.sh`: owns named forwards for `app`, `supabase-gateway`, `studio`, and `db-migration`, plus provider-aware `runtime` and `all` groups.
 - `scripts/build-app-image.sh`: exports Expo web build from app source and builds the Docker image.
 
+The `runtime` group is the canonical repair lifecycle for host endpoints required by the
+running app. It always contains `app` and adds `supabase-gateway` when the generated
+Supabase Kubernetes runtime is enabled. It deliberately excludes `studio` and
+`db-migration`; `all` retains those operational/bootstrap forwards. Start, stop, or inspect
+the group with `scripts/port-forward.sh {start|stop|status} runtime`. Package consumers
+should call `ensureProjectInfrastructureRuntime()` from `@ankhorage/infra/project` instead
+of depending on concrete provider forward names.
+
 ## Supabase Runtime
 
 Runtime ownership is Kubernetes. Migration authoring/history remains Supabase migration

package/src/adapters/minikube/base/index.test.ts

@@ -452,6 +452,19 @@ describe('generateMinikubeBaseArtifacts app-owned cluster model', () => {
     expect(portForwardScript).toContain('service/gateway');
     expect(portForwardScript).toContain('service/studio');
     expect(portForwardScript).toContain('service/postgres');
+    expect(portForwardScript).toContain('RUNTIME_FORWARD_NAMES=(app supabase-gateway)');
+    expect(portForwardScript).toContain(
+      'ALL_FORWARD_NAMES=(app supabase-gateway studio db-migration)',
+    );
+    expect(portForwardScript).toContain(
+      'start:runtime) for_each_forward start "${RUNTIME_FORWARD_NAMES[@]}"',
+    );
+    expect(portForwardScript).toContain(
+      'stop:runtime) for_each_forward stop "${RUNTIME_FORWARD_NAMES[@]}"',
+    );
+    expect(portForwardScript).toContain(
+      'status:runtime) for_each_forward status "${RUNTIME_FORWARD_NAMES[@]}"',
+    );
     expect(portForwardScript).toContain('${PROFILE}-${1}.pid');
     expect(portForwardScript).toContain('crashed stale_pid');
     expect(portForwardScript).toContain('is_port_accepting()');
@@ -488,6 +501,26 @@ describe('generateMinikubeBaseArtifacts app-owned cluster model', () => {
     expect(upScript).toContain('trap - ERR');
     expect(downScript).toContain('port-forward.sh" stop all');
   });
+
+  test('generates an app-only runtime forward group without Supabase', () => {
+    const result = generateInfrastructure(
+      {
+        deployment: {
+          target: 'minikube',
+          monitoring: false,
+        },
+        modules: [],
+      },
+      {
+        appManifest: createAppManifest('frontend-only'),
+      },
+    );
+    const portForwardScript = getFile(result.files, 'infra/minikube/scripts/port-forward.sh');
+
+    expect(portForwardScript).toContain('RUNTIME_FORWARD_NAMES=(app)');
+    expect(portForwardScript).toContain('ALL_FORWARD_NAMES=(app)');
+    expect(portForwardScript).not.toContain('RUNTIME_FORWARD_NAMES=(app supabase-gateway)');
+  });
 });
 
 function createSupabaseManifest(): InfraManifestInput {

package/src/adapters/minikube/base/index.ts

@@ -385,6 +385,15 @@ 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}
@@ -2992,6 +3001,11 @@ function getPortForwardScript(args: {
   supabaseHostPorts: SupabaseHostPorts;
 }): string {
   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
@@ -3010,6 +3024,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
@@ -3295,26 +3311,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

package/src/adapters/minikube/base/portForwardRuntime.test.ts

@@ -0,0 +1,288 @@
+import { afterEach, describe, expect, test } from 'bun:test';
+import { promises as fs } from 'fs';
+import os from 'os';
+import path from 'path';
+
+import { generateInfrastructure } from '../../../index.js';
+import { createAppManifest } from '../../../testSupport.js';
+import type { InfraManifestInput } from '../../../types.js';
+
+const temporaryPaths = new Set<string>();
+
+afterEach(async () => {
+  for (const rootPath of temporaryPaths) {
+    await stopFixtureProcesses(rootPath);
+    await fs.rm(rootPath, { force: true, recursive: true });
+  }
+  temporaryPaths.clear();
+});
+
+describe('generated Minikube runtime port-forward lifecycle', () => {
+  test(
+    'keeps healthy app forwarding, repairs a stopped Supabase gateway, and isolates operational forwards',
+    async () => {
+      const fixture = await createPortForwardFixture(createSupabaseManifest(), 'runtime-recovery');
+
+      const firstStart = await runPortForward(fixture, 'start', 'runtime');
+      expect(firstStart.stdout).toContain('app: started');
+      expect(firstStart.stdout).toContain('supabase-gateway: started');
+
+      const appPid = await readForwardPid(fixture, 'app');
+      const firstGatewayPid = await readForwardPid(fixture, 'supabase-gateway');
+      await expectForwardPid(fixture, 'studio', false);
+      await expectForwardPid(fixture, 'db-migration', false);
+
+      const repeatedStart = await runPortForward(fixture, 'start', 'runtime');
+      expect(repeatedStart.stdout).toContain(`app: running (pid ${appPid})`);
+      expect(repeatedStart.stdout).toContain(`supabase-gateway: running (pid ${firstGatewayPid})`);
+      expect(await readForwardPid(fixture, 'app')).toBe(appPid);
+      expect(await readForwardPid(fixture, 'supabase-gateway')).toBe(firstGatewayPid);
+
+      await runPortForward(fixture, 'stop', 'supabase-gateway');
+      expect(await readForwardPid(fixture, 'app')).toBe(appPid);
+      await expectForwardPid(fixture, 'supabase-gateway', false);
+
+      const recovery = await runPortForward(fixture, 'start', 'runtime');
+      expect(recovery.stdout).toContain(`app: running (pid ${appPid})`);
+      expect(recovery.stdout).toContain('supabase-gateway: started');
+      expect(await readForwardPid(fixture, 'app')).toBe(appPid);
+      expect(await readForwardPid(fixture, 'supabase-gateway')).not.toBe(firstGatewayPid);
+      await expectForwardPid(fixture, 'studio', false);
+      await expectForwardPid(fixture, 'db-migration', false);
+
+      await runPortForward(fixture, 'stop', 'runtime');
+    },
+    { timeout: 30_000 },
+  );
+
+  test(
+    'starts only the app forward when no provider owns another runtime endpoint',
+    async () => {
+      const fixture = await createPortForwardFixture(
+        { deployment: { target: 'minikube', monitoring: false }, modules: [] },
+        'runtime-app-only',
+      );
+
+      const result = await runPortForward(fixture, 'start', 'runtime');
+
+      expect(result.stdout).toContain('app: started');
+      expect(result.stdout).not.toContain('supabase-gateway');
+      await expectForwardPid(fixture, 'app', true);
+      await expectForwardPid(fixture, 'supabase-gateway', false);
+      await expectForwardPid(fixture, 'studio', false);
+      await expectForwardPid(fixture, 'db-migration', false);
+
+      await runPortForward(fixture, 'stop', 'runtime');
+    },
+    { timeout: 15_000 },
+  );
+});
+
+interface PortForwardFixture {
+  readonly env: Record<string, string>;
+  readonly processDirectory: string;
+  readonly profile: string;
+  readonly rootPath: string;
+  readonly scriptPath: string;
+}
+
+async function createPortForwardFixture(
+  manifest: InfraManifestInput,
+  profile: string,
+): Promise<PortForwardFixture> {
+  const rootPath = await fs.mkdtemp(path.join(os.tmpdir(), 'infra-port-forward-runtime-'));
+  temporaryPaths.add(rootPath);
+  const generated = generateInfrastructure(manifest, {
+    appManifest: createAppManifest(profile),
+  });
+  const generatedScript = generated.files.find(
+    (file) => file.path === 'infra/minikube/scripts/port-forward.sh',
+  );
+  if (generatedScript === undefined) {
+    throw new Error('Generated port-forward script was missing.');
+  }
+
+  const scriptPath = path.join(rootPath, generatedScript.path);
+  const fakeBin = path.join(rootPath, 'fake-bin');
+  const processDirectory = path.join(rootPath, 'fake-processes');
+  const serverScript = path.join(rootPath, 'forward-server.ts');
+  await fs.mkdir(path.dirname(scriptPath), { recursive: true });
+  await fs.mkdir(fakeBin, { recursive: true });
+  await fs.mkdir(processDirectory, { recursive: true });
+  await fs.writeFile(scriptPath, generatedScript.content, 'utf8');
+  await fs.chmod(scriptPath, 0o755);
+  await fs.writeFile(
+    serverScript,
+    [
+      "const port = Number.parseInt(Bun.argv[2] ?? '', 10);",
+      "Bun.serve({ hostname: '127.0.0.1', port, fetch: () => new Response('ok') });",
+      'await new Promise(() => undefined);',
+      '',
+    ].join('\n'),
+    'utf8',
+  );
+  await writeExecutable(
+    path.join(fakeBin, 'kubectl'),
+    `#!/usr/bin/env bash
+set -euo pipefail
+if [[ " $* " == *" get "* ]]; then
+  exit 0
+fi
+if [[ " $* " != *" port-forward "* ]]; then
+  exit 1
+fi
+endpoint="\${!#}"
+local_port="\${endpoint%%:*}"
+printf 'kubectl %s\n' "$*" > "\${FAKE_PROCESS_DIRECTORY}/$$.command"
+exec bun "\${FAKE_FORWARD_SERVER_SCRIPT}" "\${local_port}"
+`,
+  );
+  await writeExecutable(
+    path.join(fakeBin, 'ps'),
+    `#!/usr/bin/env bash
+set -euo pipefail
+pid=""
+format=""
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    -p) pid="$2"; shift 2 ;;
+    -o) format="$2"; shift 2 ;;
+    *) shift ;;
+  esac
+done
+command_file="\${FAKE_PROCESS_DIRECTORY}/\${pid}.command"
+if [[ -f "\${command_file}" && "\${format}" == "comm=" ]]; then
+  echo kubectl
+elif [[ -f "\${command_file}" && "\${format}" == "command=" ]]; then
+  cat "\${command_file}"
+else
+  /bin/ps -p "\${pid}" -o "\${format}"
+fi
+`,
+  );
+
+  const ports = reserveAvailablePorts(4);
+  return {
+    env: {
+      ...process.env,
+      ANKH_APP_SLUG: profile,
+      APP_PORT_FORWARD_LOCAL_PORT: String(ports[0]),
+      SUPABASE_GATEWAY_FORWARD_LOCAL_PORT: String(ports[1]),
+      SUPABASE_STUDIO_FORWARD_LOCAL_PORT: String(ports[2]),
+      SUPABASE_DB_FORWARD_LOCAL_PORT: String(ports[3]),
+      FAKE_FORWARD_SERVER_SCRIPT: serverScript,
+      FAKE_PROCESS_DIRECTORY: processDirectory,
+      PATH: `${fakeBin}:${process.env.PATH ?? ''}`,
+    },
+    processDirectory,
+    profile,
+    rootPath,
+    scriptPath,
+  };
+}
+
+async function runPortForward(
+  fixture: PortForwardFixture,
+  action: string,
+  name: string,
+): Promise<{ readonly exitCode: number; readonly stderr: string; readonly stdout: string }> {
+  const process = Bun.spawn(['bash', fixture.scriptPath, action, name], {
+    env: fixture.env,
+    stderr: 'pipe',
+    stdout: 'pipe',
+  });
+  const [exitCode, stdout, stderr] = await Promise.all([
+    process.exited,
+    new Response(process.stdout).text(),
+    new Response(process.stderr).text(),
+  ]);
+  if (exitCode !== 0) {
+    throw new Error(`port-forward ${action} ${name} failed (${exitCode}): ${stdout}${stderr}`);
+  }
+  return { exitCode, stderr, stdout };
+}
+
+async function readForwardPid(fixture: PortForwardFixture, name: string): Promise<number> {
+  const value = await fs.readFile(forwardPidPath(fixture, name), 'utf8');
+  return Number.parseInt(value.trim(), 10);
+}
+
+async function expectForwardPid(
+  fixture: PortForwardFixture,
+  name: string,
+  exists: boolean,
+): Promise<void> {
+  expect(await pathExists(forwardPidPath(fixture, name))).toBe(exists);
+}
+
+function forwardPidPath(fixture: PortForwardFixture, name: string): string {
+  return path.join(
+    fixture.rootPath,
+    'infra/minikube/.state/forwards',
+    `${fixture.profile}-${name}.pid`,
+  );
+}
+
+function reserveAvailablePorts(count: number): number[] {
+  const listeners = Array.from({ length: count }, () =>
+    Bun.listen({
+      hostname: '127.0.0.1',
+      port: 0,
+      socket: { data: () => undefined },
+    }),
+  );
+  const ports = listeners.map((listener) => listener.port);
+  listeners.forEach((listener) => listener.stop(true));
+  return ports;
+}
+
+async function writeExecutable(filePath: string, content: string): Promise<void> {
+  await fs.writeFile(filePath, content, 'utf8');
+  await fs.chmod(filePath, 0o755);
+}
+
+async function pathExists(filePath: string): Promise<boolean> {
+  try {
+    await fs.access(filePath);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function stopFixtureProcesses(rootPath: string): Promise<void> {
+  const stateDirectory = path.join(rootPath, 'infra/minikube/.state/forwards');
+  let entries: string[];
+  try {
+    entries = await fs.readdir(stateDirectory);
+  } catch {
+    return;
+  }
+
+  await Promise.all(
+    entries
+      .filter((entry) => entry.endsWith('.pid'))
+      .map(async (entry) => {
+        const pid = Number.parseInt(
+          await fs.readFile(path.join(stateDirectory, entry), 'utf8'),
+          10,
+        );
+        if (Number.isInteger(pid)) {
+          try {
+            process.kill(pid, 'SIGKILL');
+          } catch {
+            // The generated lifecycle may already have stopped the process.
+          }
+        }
+      }),
+  );
+}
+
+function createSupabaseManifest(): InfraManifestInput {
+  return {
+    deployment: { target: 'minikube', monitoring: false },
+    auth: { scope: 'global', provider: 'supabase' },
+    database: { provider: 'supabase', tier: 'dev' },
+    modules: [],
+  };
+}