@powerhousedao/shared 6.2.3-dev.57 → 6.2.3-dev.58

package/dist/clis/args/{help-DVPTARGn.d.mts → help-KuqI-EEG.d.mts}

@@ -1,8 +1,20 @@
 //#region clis/command-names.d.ts
-declare const phCliCommandNames: readonly ["generate", "vetra", "connect", "build", "publish", "list", "l", "access-token", "registry-login", "inspect", "is", "migrate", "switchboard", "reactor", "login", "logout", "install", "add", "i", "uninstall", "remove"];
+declare const phCliCommandNames: readonly ["run", "generate", "vetra", "connect", "build", "publish", "list", "l", "access-token", "registry-login", "inspect", "is", "migrate", "switchboard", "reactor", "login", "logout", "install", "add", "i", "uninstall", "remove"];
 //#endregion
 //#region clis/args/help.d.ts
-declare const phCliHelpCommands: {
+declare const allPhCliHelpCommands: {
+  run: Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
+    parse(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<{
+      [x: string]: any;
+    }>>;
+  } & import("cmd-ts/dist/cjs/helpdoc.js").PrintHelp & import("cmd-ts/dist/cjs/helpdoc.js").ProvidesHelp & import("cmd-ts/dist/cjs/helpdoc.js").Named & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Versioned> & import("cmd-ts/dist/cjs/argparser.js").Register & import("cmd-ts/dist/cjs/runner.js").Handling<{
+    [x: string]: any;
+  }, any> & {
+    run(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<any>>;
+  } & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Versioned & import("cmd-ts/dist/cjs/helpdoc.js").Descriptive & import("cmd-ts/dist/cjs/helpdoc.js").Aliased> & {
+    readonly name: "run";
+    readonly aliases: readonly [];
+  };
   generate: Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
     parse(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<{
       [x: string]: any;
@@ -184,7 +196,8 @@ declare const phCliHelpCommands: {
     readonly aliases: ["remove"];
   };
 };
+declare const phCliHelpCommands: typeof allPhCliHelpCommands;
 //#endregion
 export { phCliCommandNames as n, phCliHelpCommands as t };
 export {};
-//# sourceMappingURL=help-DVPTARGn.d.mts.map
+//# sourceMappingURL=help-KuqI-EEG.d.mts.map

package/dist/clis/args/help-KuqI-EEG.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-KuqI-EEG.d.mts","names":[],"sources":["../../../clis/command-names.ts","../../../clis/args/help.ts"],"mappings":";cAEa;;;cCqCP;EACJ,KAAG,+CAAA;;;;;;;;;;;;EAMH,UAAQ,+CAAA;;;;;;;;;;;;EAMR,OAAK,+CAAA;;;;;;;;;;;;EAOL,SAAO,+CAAA;;;;;;;;;;;;EAMP,OAAK,+CAAA;;;;;;;;;;;;EAML,SAAO,+CAAA;;;;;;;;;;;;EAMP,MAAI,+CAAA;;;;;;;;;;;;EAOJ,gBAAc,+CAAA;;;;;;;;;;;;EAMd,kBAAgB,+CAAA;;;;;;;;;;;;EAOhB,SAAO,+CAAA;;;;;;;;;;;;EAOP,SAAO,+CAAA;;;;;;;;;;;;EAMP,aAAW,+CAAA;;;;;;;;;;;;EAOX,OAAK,+CAAA;;;;;;;;;;;;EAML,QAAM,+CAAA;;;;;;;;;;;;EAMN,SAAO,+CAAA;;;;;;;;;;;;EAOP,WAAS,+CAAA;;;;;;;;;;;;;cAaE,0BAID"}

package/dist/clis/args/{help-DS1NlcJQ.mjs → help-bzmA6Muf.mjs}

@@ -9,12 +9,32 @@ import { t as loginArgs } from "./login-CIFkQExi.mjs";
 import { t as migrateArgs } from "./migrate-DwJGhc2d.mjs";
 import { t as publishArgs } from "./publish-DHqlGWmL.mjs";
 import { n as registryLoginArgs } from "./registry-DIwES3l2.mjs";
+import { t as runArgs } from "./run-Yw1lziWC.mjs";
 import { t as switchboardArgs } from "./switchboard-CCaAtU56.mjs";
 import { t as uninstallArgs } from "./uninstall-3U0B8g5c.mjs";
 import { r as vetraArgs } from "./vetra-BUNlAAPp.mjs";
 import { command } from "cmd-ts";
+//#region clis/feature-flags.ts
+/**
+* Feature toggles shared by the CLIs (ph-cli and ph-cmd's dispatch/help).
+* Hand-rolled env predicates by the CLI convention — deliberately no
+* OpenFeature dependency here; that stack belongs to the runtime apps.
+*/
+/**
+* Gates the uniform-runners surface: the `ph run` command (registration,
+* help listing, and ph-cmd forwarding), host-name sugar, and the `ph init`
+* hosts/ scaffold. Off by default; set to `1` or `true` to enable. Rollout
+* plan: docs/plans/2026-10-13-uniform-runners.md.
+*/
+const UNIFORM_RUNNERS_FLAG = "FEATURE_UNIFORM_RUNNERS_ENABLED";
+function isUniformRunnersEnabled(env = process.env) {
+	const value = env[UNIFORM_RUNNERS_FLAG]?.trim().toLowerCase();
+	return value === "1" || value === "true";
+}
+//#endregion
 //#region clis/command-names.ts
 const phCliCommandNames = [
+	"run",
 	"generate",
 	"vetra",
 	"connect",
@@ -49,7 +69,13 @@ function helpCommand(config) {
 		aliases
 	});
 }
-const phCliHelpCommands = {
+const allPhCliHelpCommands = {
+	run: helpCommand({
+		name: "run",
+		args: runArgs,
+		description: "Run a host from hosts/ with its runner",
+		handler: () => {}
+	}),
 	generate: helpCommand({
 		name: "generate",
 		args: generateArgs,
@@ -146,7 +172,8 @@ const phCliHelpCommands = {
 		handler: () => {}
 	})
 };
+const phCliHelpCommands = isUniformRunnersEnabled() ? allPhCliHelpCommands : (({ run: _run, ...rest }) => rest)(allPhCliHelpCommands);
 //#endregion
 export { phCliCommandNames as n, phCliHelpCommands as t };
 
-//# sourceMappingURL=help-DS1NlcJQ.mjs.map
+//# sourceMappingURL=help-bzmA6Muf.mjs.map

package/dist/clis/args/help-bzmA6Muf.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-bzmA6Muf.mjs","names":[],"sources":["../../../clis/feature-flags.ts","../../../clis/command-names.ts","../../../clis/args/help.ts"],"sourcesContent":["/**\n * Feature toggles shared by the CLIs (ph-cli and ph-cmd's dispatch/help).\n * Hand-rolled env predicates by the CLI convention — deliberately no\n * OpenFeature dependency here; that stack belongs to the runtime apps.\n */\n\n/**\n * Gates the uniform-runners surface: the `ph run` command (registration,\n * help listing, and ph-cmd forwarding), host-name sugar, and the `ph init`\n * hosts/ scaffold. Off by default; set to `1` or `true` to enable. Rollout\n * plan: docs/plans/2026-10-13-uniform-runners.md.\n */\nexport const UNIFORM_RUNNERS_FLAG = \"FEATURE_UNIFORM_RUNNERS_ENABLED\";\n\nexport function isUniformRunnersEnabled(\n  env: Record<string, string | undefined> = process.env,\n): boolean {\n  const value = env[UNIFORM_RUNNERS_FLAG]?.trim().toLowerCase();\n  return value === \"1\" || value === \"true\";\n}\n","// Hardcoded so ph-cmd's dispatch doesn't have to evaluate phCliHelpCommands.\n// The compile-time guard in args/help.ts catches drift.\nexport const phCliCommandNames = [\n  \"run\",\n  \"generate\",\n  \"vetra\",\n  \"connect\",\n  \"build\",\n  \"publish\",\n  \"list\",\n  \"l\",\n  \"access-token\",\n  \"registry-login\",\n  \"inspect\",\n  \"is\",\n  \"migrate\",\n  \"switchboard\",\n  \"reactor\",\n  \"login\",\n  \"logout\",\n  \"install\",\n  \"add\",\n  \"i\",\n  \"uninstall\",\n  \"remove\",\n] as const;\n","import { command } from \"cmd-ts\";\nimport { isUniformRunnersEnabled } from \"../feature-flags.js\";\nimport type { phCliCommandNames } from \"../command-names.js\";\nimport { accessTokenArgs } from \"./access-token.js\";\nimport { debugArgs } from \"./common.js\";\nimport { connectArgs } from \"./connect.js\";\nimport { generateArgs } from \"./generate.js\";\nimport { inspectArgs } from \"./inspect.js\";\nimport { installArgs } from \"./install.js\";\nimport { listArgs } from \"./list.js\";\nimport { loginArgs } from \"./login.js\";\nimport { migrateArgs } from \"./migrate.js\";\nimport { publishArgs } from \"./publish.js\";\nimport { registryLoginArgs } from \"./registry.js\";\nimport { runArgs } from \"./run.js\";\nimport { switchboardArgs } from \"./switchboard.js\";\nimport { uninstallArgs } from \"./uninstall.js\";\nimport { vetraArgs } from \"./vetra.js\";\n\n// Thin wrapper around `command()` that preserves the literal types of\n// `name` and `aliases` on the return value.\nfunction helpCommand<\n  const N extends string,\n  const A extends readonly string[] = readonly [],\n>(\n  config: Parameters<typeof command>[0] & { name: N; aliases?: A },\n): ReturnType<typeof command> & { readonly name: N; readonly aliases: A } {\n  const aliases = (config.aliases ?? ([] as readonly string[])) as A;\n  // Forward the original config (with the normalized aliases) through cmd-ts\n  // and re-attach the literal types via a localized cast.\n  return Object.assign(command({ ...config, aliases: [...aliases] }), {\n    name: config.name,\n    aliases,\n  }) as ReturnType<typeof command> & {\n    readonly name: N;\n    readonly aliases: A;\n  };\n}\n\nconst allPhCliHelpCommands = {\n  run: helpCommand({\n    name: \"run\",\n    args: runArgs,\n    description: \"Run a host from hosts/ with its runner\",\n    handler: () => {},\n  }),\n  generate: helpCommand({\n    name: \"generate\",\n    args: generateArgs,\n    description: \"Generate powerhouse code\",\n    handler: () => {},\n  }),\n  vetra: helpCommand({\n    name: \"vetra\",\n    args: vetraArgs,\n    description:\n      \"Starts Vetra development environment with switchboard, reactor, and connect\",\n    handler: () => {},\n  }),\n  connect: helpCommand({\n    name: \"connect\",\n    args: connectArgs,\n    description: \"Powerhouse Connect commands\",\n    handler: () => {},\n  }),\n  build: helpCommand({\n    name: \"build\",\n    args: debugArgs,\n    description: \"Build your project for publishing to the registry\",\n    handler: () => {},\n  }),\n  publish: helpCommand({\n    name: \"publish\",\n    args: publishArgs,\n    description: \"Publish a package to the Powerhouse registry\",\n    handler: () => {},\n  }),\n  list: helpCommand({\n    name: \"list\",\n    aliases: [\"l\"],\n    args: listArgs,\n    description: \"List installed packages\",\n    handler: () => {},\n  }),\n  \"access-token\": helpCommand({\n    name: \"access-token\",\n    args: accessTokenArgs,\n    description: \"Generate a bearer token for API authentication\",\n    handler: () => {},\n  }),\n  \"registry-login\": helpCommand({\n    name: \"registry-login\",\n    args: registryLoginArgs,\n    description:\n      \"Log in to a Powerhouse registry (writes a Renown bearer token to ~/.npmrc)\",\n    handler: () => {},\n  }),\n  inspect: helpCommand({\n    name: \"inspect\",\n    aliases: [\"is\"],\n    args: inspectArgs,\n    description: \"Inspect a package\",\n    handler: () => {},\n  }),\n  migrate: helpCommand({\n    name: \"migrate\",\n    args: migrateArgs,\n    description: \"Run migrations\",\n    handler: () => {},\n  }),\n  switchboard: helpCommand({\n    name: \"switchboard\",\n    aliases: [\"reactor\"],\n    args: switchboardArgs,\n    description: \"Starts local Switchboard\",\n    handler: () => {},\n  }),\n  login: helpCommand({\n    name: \"login\",\n    args: loginArgs,\n    description: \"Authenticate with Renown using your Ethereum wallet\",\n    handler: () => {},\n  }),\n  logout: helpCommand({\n    name: \"logout\",\n    args: loginArgs,\n    description: \"Deletes an existing session created with 'ph login'\",\n    handler: () => {},\n  }),\n  install: helpCommand({\n    name: \"install\",\n    aliases: [\"add\", \"i\"],\n    args: installArgs,\n    description: \"Install a Powerhouse dependency\",\n    handler: () => {},\n  }),\n  uninstall: helpCommand({\n    name: \"uninstall\",\n    aliases: [\"remove\"],\n    args: uninstallArgs,\n    description: \"Uninstall a Powerhouse dependency\",\n    handler: () => {},\n  }),\n};\n\n// `run` is flag-gated: with uniform-runners off it must not surface in help\n// or dispatch at all (ph-cli also skips its registration). The cast keeps the\n// FULL compile-time shape so the drift guard below still pairs the name lists\n// while the runtime object simply lacks the key.\nexport const phCliHelpCommands = (\n  isUniformRunnersEnabled()\n    ? allPhCliHelpCommands\n    : (({ run: _run, ...rest }) => rest)(allPhCliHelpCommands)\n) as typeof allPhCliHelpCommands;\n\nexport { phCliCommandNames } from \"../command-names.js\";\n\n// Compile-time drift guard: phCliCommandNames must match the names+aliases\n// declared above. If you add or rename a command/alias, the type of\n// `_DerivedNames` changes and the assignment below errors until\n// `command-names.ts` is updated to match. Costs nothing at runtime.\ntype _DerivedNames = {\n  [K in keyof typeof phCliHelpCommands]:\n    | (typeof phCliHelpCommands)[K][\"name\"]\n    | (typeof phCliHelpCommands)[K][\"aliases\"][number];\n}[keyof typeof phCliHelpCommands];\n\ntype _Names = (typeof phCliCommandNames)[number];\n\ntype _Equal<A, B> =\n  (<T>() => T extends A ? 1 : 2) extends <T>() => T extends B ? 1 : 2\n    ? true\n    : false;\n\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nconst _phCliCommandNamesInSync: _Equal<_DerivedNames, _Names> extends true\n  ? true\n  : never = true;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,MAAa,uBAAuB;AAEpC,SAAgB,wBACd,MAA0C,QAAQ,KACzC;CACT,MAAM,QAAQ,IAAI,qBAAqB,EAAE,KAAK,CAAC,CAAC,YAAY;CAC5D,OAAO,UAAU,OAAO,UAAU;AACpC;;;ACjBA,MAAa,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;;ACJA,SAAS,YAIP,QACwE;CACxE,MAAM,UAAW,OAAO,WAAY,CAAC;CAGrC,OAAO,OAAO,OAAO,QAAQ;EAAE,GAAG;EAAQ,SAAS,CAAC,GAAG,OAAO;CAAE,CAAC,GAAG;EAClE,MAAM,OAAO;EACb;CACF,CAAC;AAIH;AAEA,MAAM,uBAAuB;CAC3B,KAAK,YAAY;EACf,MAAM;EACN,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;CACD,UAAU,YAAY;EACpB,MAAM;EACN,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;CACD,OAAO,YAAY;EACjB,MAAM;EACN,MAAM;EACN,aACE;EACF,eAAe,CAAC;CAClB,CAAC;CACD,SAAS,YAAY;EACnB,MAAM;EACN,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;CACD,OAAO,YAAY;EACjB,MAAM;EACN,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;CACD,SAAS,YAAY;EACnB,MAAM;EACN,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;CACD,MAAM,YAAY;EAChB,MAAM;EACN,SAAS,CAAC,GAAG;EACb,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;CACD,gBAAgB,YAAY;EAC1B,MAAM;EACN,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;CACD,kBAAkB,YAAY;EAC5B,MAAM;EACN,MAAM;EACN,aACE;EACF,eAAe,CAAC;CAClB,CAAC;CACD,SAAS,YAAY;EACnB,MAAM;EACN,SAAS,CAAC,IAAI;EACd,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;CACD,SAAS,YAAY;EACnB,MAAM;EACN,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;CACD,aAAa,YAAY;EACvB,MAAM;EACN,SAAS,CAAC,SAAS;EACnB,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;CACD,OAAO,YAAY;EACjB,MAAM;EACN,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;CACD,QAAQ,YAAY;EAClB,MAAM;EACN,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;CACD,SAAS,YAAY;EACnB,MAAM;EACN,SAAS,CAAC,OAAO,GAAG;EACpB,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;CACD,WAAW,YAAY;EACrB,MAAM;EACN,SAAS,CAAC,QAAQ;EAClB,MAAM;EACN,aAAa;EACb,eAAe,CAAC;CAClB,CAAC;AACH;AAMA,MAAa,oBACX,wBAAwB,IACpB,yBACE,EAAE,KAAK,MAAM,GAAG,WAAW,KAAA,CAAM,oBAAoB"}

package/dist/clis/args/help.d.mts

@@ -1,3 +1,3 @@
-import { n as phCliCommandNames, t as phCliHelpCommands } from "./help-DVPTARGn.mjs";
+import { n as phCliCommandNames, t as phCliHelpCommands } from "./help-KuqI-EEG.mjs";
 export { phCliCommandNames, phCliHelpCommands };
 export {};

package/dist/clis/args/help.mjs

@@ -1,2 +1,2 @@
-import { n as phCliCommandNames, t as phCliHelpCommands } from "./help-DS1NlcJQ.mjs";
+import { n as phCliCommandNames, t as phCliHelpCommands } from "./help-bzmA6Muf.mjs";
 export { phCliCommandNames, phCliHelpCommands };

package/dist/clis/args/index.d.mts

@@ -2,7 +2,7 @@ import { t as accessTokenArgs } from "./access-token-C5sKsH2O.mjs";
 import { _ as packageManagerArgs, a as connectBasePath, b as renownSwitchboardUrl, c as disableLocalPackages, d as getPackageManagerCommand, f as https, g as logLevel, h as localPackage, i as commonServerArgs, l as drivesPreserveStrategy, m as httpsKeyFile, n as buildArgs, o as debugArgs, p as httpsCertFile, r as commonArgs, s as defaultDrivesUrl, t as AGENTS, u as force, v as packages, x as vetraSwitchboardArgs, y as renownNamespace } from "./common-Bnm859xU.mjs";
 import { a as connectStudioArgs, i as connectPreviewArgs, n as connectBuildArgs, r as connectConfigArgs, t as connectArgs } from "./connect-DjeiqXus.mjs";
 import { t as generateArgs } from "./generate-BPBBLeUD.mjs";
-import { n as phCliCommandNames, t as phCliHelpCommands } from "./help-DVPTARGn.mjs";
+import { n as phCliCommandNames, t as phCliHelpCommands } from "./help-KuqI-EEG.mjs";
 import { t as initArgs } from "./init-CTaK80wE.mjs";
 import { t as inspectArgs } from "./inspect-BjRmtB86.mjs";
 import { t as installArgs } from "./install-B0tMyUMw.mjs";

package/dist/clis/args/index.mjs

@@ -2,6 +2,7 @@ import { _ as packageManagerArgs, a as connectBasePath, b as renownSwitchboardUr
 import { t as accessTokenArgs } from "./access-token-3Hqv_U8I.mjs";
 import { a as connectStudioArgs, i as connectPreviewArgs, n as connectBuildArgs, r as connectConfigArgs, t as connectArgs } from "./connect-BG3HkYBk.mjs";
 import { t as generateArgs } from "./generate-BOItUNvP.mjs";
+import { n as phCliCommandNames, t as phCliHelpCommands } from "./help-bzmA6Muf.mjs";
 import { t as inspectArgs } from "./inspect-UNQgtuR0.mjs";
 import { t as installArgs } from "./install-F-27kF6m.mjs";
 import { t as listArgs } from "./list-Bkfn8Yuo.mjs";
@@ -12,7 +13,6 @@ import { n as registryLoginArgs, t as DEFAULT_REGISTRY_LOGIN_EXPIRY } from "./re
 import { t as switchboardArgs } from "./switchboard-CCaAtU56.mjs";
 import { t as uninstallArgs } from "./uninstall-3U0B8g5c.mjs";
 import { n as resolveSwitchboardPortDefault, r as vetraArgs, t as resolveConnectPortDefault } from "./vetra-BUNlAAPp.mjs";
-import { n as phCliCommandNames, t as phCliHelpCommands } from "./help-DS1NlcJQ.mjs";
 import { t as initArgs } from "./init-xlCNZ8Oe.mjs";
 import { t as serviceArgs } from "./service-Cpjlyeu5.mjs";
 import { t as unpublishArgs } from "./unpublish-s9zUh6Gw.mjs";

package/dist/clis/args/run-Yw1lziWC.mjs

@@ -0,0 +1,23 @@
+import { boolean, flag, optional, positional, string } from "cmd-ts";
+//#region clis/args/run.ts
+const runArgs = {
+	host: positional({
+		type: string,
+		displayName: "host",
+		description: "the host to run (a directory under hosts/)"
+	}),
+	verb: positional({
+		type: optional(string),
+		displayName: "verb",
+		description: "optional verb the runner forwards (dev, build, serve, …)"
+	}),
+	debug: flag({
+		type: optional(boolean),
+		long: "debug",
+		description: "verbose runner diagnostics"
+	})
+};
+//#endregion
+export { runArgs as t };
+
+//# sourceMappingURL=run-Yw1lziWC.mjs.map

package/dist/clis/args/run-Yw1lziWC.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-Yw1lziWC.mjs","names":[],"sources":["../../../clis/args/run.ts"],"sourcesContent":["import { boolean, flag, optional, positional, string } from \"cmd-ts\";\n\n// Mirrors clis/ph-cli/src/commands/run.ts — the uniform-runners entry point.\n// Kept here so ph-cmd's help/dispatch (phCliHelpCommands) can describe it;\n// the command itself stays flag-gated in ph-cli (FEATURE_UNIFORM_RUNNERS_ENABLED).\nexport const runArgs = {\n  host: positional({\n    type: string,\n    displayName: \"host\",\n    description: \"the host to run (a directory under hosts/)\",\n  }),\n  verb: positional({\n    type: optional(string),\n    displayName: \"verb\",\n    description: \"optional verb the runner forwards (dev, build, serve, …)\",\n  }),\n  debug: flag({\n    type: optional(boolean),\n    long: \"debug\",\n    description: \"verbose runner diagnostics\",\n  }),\n};\n"],"mappings":";;AAKA,MAAa,UAAU;CACrB,MAAM,WAAW;EACf,MAAM;EACN,aAAa;EACb,aAAa;CACf,CAAC;CACD,MAAM,WAAW;EACf,MAAM,SAAS,MAAM;EACrB,aAAa;EACb,aAAa;CACf,CAAC;CACD,OAAO,KAAK;EACV,MAAM,SAAS,OAAO;EACtB,MAAM;EACN,aAAa;CACf,CAAC;AACH"}

package/dist/clis/args/run.d.mts

@@ -0,0 +1,15 @@
+//#region clis/args/run.d.ts
+export declare const runArgs: {
+  host: Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
+    parse(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<string>>;
+  } & import("cmd-ts/dist/cjs/helpdoc.js").ProvidesHelp & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Descriptive>;
+  verb: Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
+    parse(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<string | undefined>>;
+  } & import("cmd-ts/dist/cjs/helpdoc.js").ProvidesHelp & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Descriptive>;
+  debug: Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
+    parse(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<boolean | undefined>>;
+  } & import("cmd-ts/dist/cjs/helpdoc.js").ProvidesHelp & import("cmd-ts/dist/cjs/argparser.js").Register & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Descriptive>;
+};
+//#endregion
+export {};
+//# sourceMappingURL=run.d.mts.map

package/dist/clis/args/run.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.mts","names":[],"sources":["../../../clis/args/run.ts"],"mappings":";qBAKa;EACX,MAAI,+CAAA;;;EAKJ,MAAI,+CAAA;;;EAKJ,OAAK,+CAAA"}

package/dist/clis/args/run.mjs

@@ -0,0 +1,2 @@
+import { t as runArgs } from "./run-Yw1lziWC.mjs";
+export { runArgs };

package/dist/clis/command-names.d.mts

@@ -1,5 +1,5 @@
 //#region clis/command-names.d.ts
-export declare const phCliCommandNames: readonly ["generate", "vetra", "connect", "build", "publish", "list", "l", "access-token", "registry-login", "inspect", "is", "migrate", "switchboard", "reactor", "login", "logout", "install", "add", "i", "uninstall", "remove"];
+export declare const phCliCommandNames: readonly ["run", "generate", "vetra", "connect", "build", "publish", "list", "l", "access-token", "registry-login", "inspect", "is", "migrate", "switchboard", "reactor", "login", "logout", "install", "add", "i", "uninstall", "remove"];
 //#endregion
 export {};
 //# sourceMappingURL=command-names.d.mts.map

package/dist/clis/command-names.mjs

@@ -1,5 +1,6 @@
 //#region clis/command-names.ts
 const phCliCommandNames = [
+	"run",
 	"generate",
 	"vetra",
 	"connect",

package/dist/clis/command-names.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"command-names.mjs","names":[],"sources":["../../clis/command-names.ts"],"sourcesContent":["// Hardcoded so ph-cmd's dispatch doesn't have to evaluate phCliHelpCommands.\n// The compile-time guard in args/help.ts catches drift.\nexport const phCliCommandNames = [\n  \"generate\",\n  \"vetra\",\n  \"connect\",\n  \"build\",\n  \"publish\",\n  \"list\",\n  \"l\",\n  \"access-token\",\n  \"registry-login\",\n  \"inspect\",\n  \"is\",\n  \"migrate\",\n  \"switchboard\",\n  \"reactor\",\n  \"login\",\n  \"logout\",\n  \"install\",\n  \"add\",\n  \"i\",\n  \"uninstall\",\n  \"remove\",\n] as const;\n"],"mappings":";AAEA,MAAa,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}
+{"version":3,"file":"command-names.mjs","names":[],"sources":["../../clis/command-names.ts"],"sourcesContent":["// Hardcoded so ph-cmd's dispatch doesn't have to evaluate phCliHelpCommands.\n// The compile-time guard in args/help.ts catches drift.\nexport const phCliCommandNames = [\n  \"run\",\n  \"generate\",\n  \"vetra\",\n  \"connect\",\n  \"build\",\n  \"publish\",\n  \"list\",\n  \"l\",\n  \"access-token\",\n  \"registry-login\",\n  \"inspect\",\n  \"is\",\n  \"migrate\",\n  \"switchboard\",\n  \"reactor\",\n  \"login\",\n  \"logout\",\n  \"install\",\n  \"add\",\n  \"i\",\n  \"uninstall\",\n  \"remove\",\n] as const;\n"],"mappings":";AAEA,MAAa,oBAAoB;CAC/B;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF"}

package/dist/clis/feature-flags.d.mts

@@ -0,0 +1,17 @@
+//#region clis/feature-flags.d.ts
+/**
+ * Feature toggles shared by the CLIs (ph-cli and ph-cmd's dispatch/help).
+ * Hand-rolled env predicates by the CLI convention — deliberately no
+ * OpenFeature dependency here; that stack belongs to the runtime apps.
+ */
+/**
+ * Gates the uniform-runners surface: the `ph run` command (registration,
+ * help listing, and ph-cmd forwarding), host-name sugar, and the `ph init`
+ * hosts/ scaffold. Off by default; set to `1` or `true` to enable. Rollout
+ * plan: docs/plans/2026-10-13-uniform-runners.md.
+ */
+export declare const UNIFORM_RUNNERS_FLAG = "FEATURE_UNIFORM_RUNNERS_ENABLED";
+export declare function isUniformRunnersEnabled(env?: Record<string, string | undefined>): boolean;
+//#endregion
+export {};
+//# sourceMappingURL=feature-flags.d.mts.map

package/dist/clis/feature-flags.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.mts","names":[],"sources":["../../clis/feature-flags.ts"],"mappings":";;;;;;;;;;;;qBAYa;wBAEG,wBACd,MAAK"}

package/dist/clis/feature-flags.mjs

@@ -0,0 +1,21 @@
+//#region clis/feature-flags.ts
+/**
+* Feature toggles shared by the CLIs (ph-cli and ph-cmd's dispatch/help).
+* Hand-rolled env predicates by the CLI convention — deliberately no
+* OpenFeature dependency here; that stack belongs to the runtime apps.
+*/
+/**
+* Gates the uniform-runners surface: the `ph run` command (registration,
+* help listing, and ph-cmd forwarding), host-name sugar, and the `ph init`
+* hosts/ scaffold. Off by default; set to `1` or `true` to enable. Rollout
+* plan: docs/plans/2026-10-13-uniform-runners.md.
+*/
+const UNIFORM_RUNNERS_FLAG = "FEATURE_UNIFORM_RUNNERS_ENABLED";
+function isUniformRunnersEnabled(env = process.env) {
+	const value = env[UNIFORM_RUNNERS_FLAG]?.trim().toLowerCase();
+	return value === "1" || value === "true";
+}
+//#endregion
+export { UNIFORM_RUNNERS_FLAG, isUniformRunnersEnabled };
+
+//# sourceMappingURL=feature-flags.mjs.map

package/dist/clis/feature-flags.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.mjs","names":[],"sources":["../../clis/feature-flags.ts"],"sourcesContent":["/**\n * Feature toggles shared by the CLIs (ph-cli and ph-cmd's dispatch/help).\n * Hand-rolled env predicates by the CLI convention — deliberately no\n * OpenFeature dependency here; that stack belongs to the runtime apps.\n */\n\n/**\n * Gates the uniform-runners surface: the `ph run` command (registration,\n * help listing, and ph-cmd forwarding), host-name sugar, and the `ph init`\n * hosts/ scaffold. Off by default; set to `1` or `true` to enable. Rollout\n * plan: docs/plans/2026-10-13-uniform-runners.md.\n */\nexport const UNIFORM_RUNNERS_FLAG = \"FEATURE_UNIFORM_RUNNERS_ENABLED\";\n\nexport function isUniformRunnersEnabled(\n  env: Record<string, string | undefined> = process.env,\n): boolean {\n  const value = env[UNIFORM_RUNNERS_FLAG]?.trim().toLowerCase();\n  return value === \"1\" || value === \"true\";\n}\n"],"mappings":";;;;;;;;;;;;AAYA,MAAa,uBAAuB;AAEpC,SAAgB,wBACd,MAA0C,QAAQ,KACzC;CACT,MAAM,QAAQ,IAAI,qBAAqB,EAAE,KAAK,CAAC,CAAC,YAAY;CAC5D,OAAO,UAAU,OAAO,UAAU;AACpC"}

package/dist/clis/index.d.mts

@@ -748,10 +748,22 @@ export declare const generateArgs: {
 };
 //#endregion
 //#region clis/command-names.d.ts
-export declare const phCliCommandNames: readonly ["generate", "vetra", "connect", "build", "publish", "list", "l", "access-token", "registry-login", "inspect", "is", "migrate", "switchboard", "reactor", "login", "logout", "install", "add", "i", "uninstall", "remove"];
+export declare const phCliCommandNames: readonly ["run", "generate", "vetra", "connect", "build", "publish", "list", "l", "access-token", "registry-login", "inspect", "is", "migrate", "switchboard", "reactor", "login", "logout", "install", "add", "i", "uninstall", "remove"];
 //#endregion
 //#region clis/args/help.d.ts
-export declare const phCliHelpCommands: {
+declare const allPhCliHelpCommands: {
+  run: Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
+    parse(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<{
+      [x: string]: any;
+    }>>;
+  } & import("cmd-ts/dist/cjs/helpdoc.js").PrintHelp & import("cmd-ts/dist/cjs/helpdoc.js").ProvidesHelp & import("cmd-ts/dist/cjs/helpdoc.js").Named & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Versioned> & import("cmd-ts/dist/cjs/argparser.js").Register & import("cmd-ts/dist/cjs/runner.js").Handling<{
+    [x: string]: any;
+  }, any> & {
+    run(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<any>>;
+  } & Partial<import("cmd-ts/dist/cjs/helpdoc.js").Versioned & import("cmd-ts/dist/cjs/helpdoc.js").Descriptive & import("cmd-ts/dist/cjs/helpdoc.js").Aliased> & {
+    readonly name: "run";
+    readonly aliases: readonly [];
+  };
   generate: Partial<import("cmd-ts/dist/cjs/argparser.js").Register> & {
     parse(context: import("cmd-ts/dist/cjs/argparser.js").ParseContext): Promise<import("cmd-ts/dist/cjs/argparser.js").ParsingResult<{
       [x: string]: any;
@@ -933,6 +945,7 @@ export declare const phCliHelpCommands: {
     readonly aliases: ["remove"];
   };
 };
+export declare const phCliHelpCommands: typeof allPhCliHelpCommands;
 //#endregion
 //#region clis/args/init.d.ts
 export declare const initArgs: {

package/dist/clis/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../clis/args/access-token.ts","../../clis/args/common.ts","../../clis/args/connect.ts","../../clis/args/generate.ts","../../clis/command-names.ts","../../clis/args/help.ts","../../clis/args/init.ts","../../clis/args/inspect.ts","../../clis/args/install.ts","../../clis/args/list.ts","../../clis/args/login.ts","../../clis/args/migrate.ts","../../clis/args/publish.ts","../../clis/args/registry.ts","../../document-model/schemas.ts","../../document-model/types.ts","../../clis/constants.ts","../../clis/types.ts","../../clis/args/service.ts","../../clis/args/switchboard.ts","../../clis/args/uninstall.ts","../../clis/args/unpublish.ts","../../clis/args/vetra.ts","../../clis/file-system/dependencies.ts","../../clis/file-system/directory-exists.ts","../../clis/file-system/file-exists.ts","../../clis/file-system/get-config.ts","../../clis/file-system/package-json.ts","../../clis/file-system/projects.ts","../../clis/file-system/run-cmd.ts","../../clis/file-system/spawn-async.ts","../../clis/file-system/version-info.ts","../../clis/file-system/write-file-ensuring-dir.ts","../../clis/services/telemetry.ts","../../clis/services/use-local.ts","../../clis/source-config-schema.ts","../../clis/utils.ts"],"mappings":"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;;;;;;;;qBAaA;qBAGA;qBAEA;qBACA;qBACA;qBACA;qBAEA;qBAEA;qBAEA;qBAGA;qBAOA;qBACA;qBAEA;qBACA;qBACA;qBAQA;;aACU;aAAa;;;aACT;aAAY;;;aAC5B;aAAa;;;aACP;aAAa;;;aACrB;aAAY;;;qBAKR;;aAET;aACA;aACA;;;aAKA;aACA;aACA;;;qBAWS;qBAUA;qBAiBA;WACC;WACN;WACI;;qBAGC;qBAeA;WACX;aACE;aACA;aACA;;WAEF;aACE;aACA;;WAEF;aACE;aACA;aACA;;WAEF;aACE;aACA;aACA;;WAEF;aACE;aACA;aACA;;WAEF;aACE;aACA;aACA;;WAEF;aACE;aACA;;WAEF;aACE;aACA;aACA;;WAKF;aACE;aACA;;WAEF;aACE;aACA;;WAEF;WACA;;qBAGW;WACX;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WAEA;;qBAIW;qBAIA;qBAcA;qBAwBA;WACX;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;qBAGW,iBAAiB;qBAuBjB,gBAAgB;;;KC9VjB,wBAAwB;KACxB,gBAAgB;KAChB,iCAAiC;KACjC,wBAAwB;KACxB,mBAAmB;KACnB,WAAW;KAEX,gBAAgB,KAAK,UAAU,gBAAgB,OAAO;KACtD,qBAAqB,uBACxB;KAGG;KAEA,kBAAkB;KAClB;EACV;EACA;EACA,WAAW;EACX;;KAGU;EACV;EACA;;KAGU;EACV;EACA;EACA;;KAGU;;EAEV;;EAEA;EACA;EACA;;EAEA;;KAGU,wBACR,8BACA;KAEQ;EACV;EACA;EACA;;KAGU;EACV,SAAS;EACT,QAAQ;;KAGE;EACV;EACA,gBAAgB;EAChB,mBAAmB;EACnB,WAAW;;KAGD;EACV;EACA;EACA;EAGA;EAKA;;KAGU;;EAEV;;KAGU;EACV;;EAEA;;KAGU;;EAEV;;EAEA;;KAGU;;EAEV;;EAEA;;EAEA;;KAGU;EACV,UAAU;EACV,QAAQ;;KAGE;EACV;EACA;EACA;;EAEA;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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../clis/args/access-token.ts","../../clis/args/common.ts","../../clis/args/connect.ts","../../clis/args/generate.ts","../../clis/command-names.ts","../../clis/args/help.ts","../../clis/args/init.ts","../../clis/args/inspect.ts","../../clis/args/install.ts","../../clis/args/list.ts","../../clis/args/login.ts","../../clis/args/migrate.ts","../../clis/args/publish.ts","../../clis/args/registry.ts","../../document-model/schemas.ts","../../document-model/types.ts","../../clis/constants.ts","../../clis/types.ts","../../clis/args/service.ts","../../clis/args/switchboard.ts","../../clis/args/uninstall.ts","../../clis/args/unpublish.ts","../../clis/args/vetra.ts","../../clis/file-system/dependencies.ts","../../clis/file-system/directory-exists.ts","../../clis/file-system/file-exists.ts","../../clis/file-system/get-config.ts","../../clis/file-system/package-json.ts","../../clis/file-system/projects.ts","../../clis/file-system/run-cmd.ts","../../clis/file-system/spawn-async.ts","../../clis/file-system/version-info.ts","../../clis/file-system/write-file-ensuring-dir.ts","../../clis/services/telemetry.ts","../../clis/services/use-local.ts","../../clis/source-config-schema.ts","../../clis/utils.ts"],"mappings":";;;;;;;;qBAIa;;;;;;;;;;;;;qBCmBA,QAAQ;qBAER;EACX,OAAK,+CAAA;;;;qBAOM;;;;;;;;;;;;;;qBA2BA;EACX,gBAAc,+CAAA;;;EAOd,KAAG,+CAAA;;;EAKH,MAAI,+CAAA;;;EAKJ,MAAI,+CAAA;;;EAKJ,KAAG,+CAAA;;;;qBAMQ,0BAAwB,+CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAInC,6CAAA,iDAAA,mDAAA;qBACW,UAAQ,+CAAA;;yCAKnB,eAAA,6CAAA;qBAEW,cAAY,+CAAA;;yCAKvB,eAAA,6CAAA;qBAEW,sBAAoB,+CAAA;;yCAK/B,sDAAA,WAAA,6CAAA;qBAEW,cAAY,+CAAA;;yCAWvB,eAAA,6CAAA;qBAEW,eAAa,+CAAA;;yCAWxB,eAAA,6CAAA;qBAEW,OAAK,+CAAA;;yCAUhB,sDAAA,WAAA,6CAAA;qBAEW;;;;;;;;;;;;;;;;;;;;;;;qBAmBA,kBAAgB,+CAAA;;yCAK3B,eAAA,6CAAA;qBAEW,UAAQ,+CAAA;;yCAOnB,eAAA,6CAAA;qBAEW,iBAAe,+CAAA;;yCAK1B,eAAA,6CAAA;qBAEW,iBAAe,+CAAA;;yCAK1B,eAAA,6CAAA;qBAEW,sBAAoB,+CAAA;;yCAK/B,eAAA,6CAAA;qBAEW,wBAAsB,+CAAA;;yCAMjC,eAAA,6CAAA;qBAEW,OAAK,+CAAA;;yCAKhB,sDAAA,WAAA,6CAAA;qBAEW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAYA;EACX,MAAI,+CAAA;;;EAMJ,MAAI,+CAAA;;;EAKJ,MAAI,+CAAA;;;EAKJ,YAAU,+CAAA;;;EAKV,WAAS,+CAAA;;;EAOT,kBAAgB,+CAAA;;;EAOhB,cAAY,+CAAA;;;;;;qBCrOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA4JA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAyBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBA8CA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAqBA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBC5PA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBCrCA;;;cCqCP;EACJ,KAAG,+CAAA;;;;;;;;;;;;EAMH,UAAQ,+CAAA;;;;;;;;;;;;EAMR,OAAK,+CAAA;;;;;;;;;;;;EAOL,SAAO,+CAAA;;;;;;;;;;;;EAMP,OAAK,+CAAA;;;;;;;;;;;;EAML,SAAO,+CAAA;;;;;;;;;;;;EAMP,MAAI,+CAAA;;;;;;;;;;;;EAOJ,gBAAc,+CAAA;;;;;;;;;;;;EAMd,kBAAgB,+CAAA;;;;;;;;;;;;EAOhB,SAAO,+CAAA;;;;;;;;;;;;EAOP,SAAO,+CAAA;;;;;;;;;;;;EAMP,aAAW,+CAAA;;;;;;;;;;;;EAOX,OAAK,+CAAA;;;;;;;;;;;;EAML,QAAM,+CAAA;;;;;;;;;;;;EAMN,SAAO,+CAAA;;;;;;;;;;;;EAOP,WAAS,+CAAA;;;;;;;;;;;;;qBAaE,0BAID;;;qBC9IC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBCRA;;;;;;;;;;qBCSA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBCVA;;;;;;;qBCEA;;;;;;;;;;;;;;;;;;;;;;qBCDA;;;;;;;;;;;;;;;;qBCAA;;;;;;;;;;;;;qBCAA;qBAEA;;;;;;;;;;;;;cC01BA,gBAAc,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoBzB,EAAA,KAAA;;;KC40BU,WAAW,EAAE,aAAa;;;qBC1rDzB;qBAQA;qBACA;qBACA;qBAEA;qBAKA;qBAQA;qBAEA;qBAEA;qBAEA;qBAEA;qBAEA;qBAEA;qBAEA;qBAqBA;qBACA;qBACA;qBACA;;;;;;;;;;;;qBAaA;qBAGA;qBAEA;qBACA;qBACA;qBACA;qBAEA;qBAEA;qBAEA;qBAGA;qBAOA;qBACA;qBAEA;qBACA;qBACA;qBAQA;;aACU;aAAa;;;aACT;aAAY;;;aAC5B;aAAa;;;aACP;aAAa;;;aACrB;aAAY;;;qBAKR;;aAET;aACA;aACA;;;aAKA;aACA;aACA;;;qBAWS;qBAUA;qBAiBA;WACC;WACN;WACI;;qBAGC;qBAeA;WACX;aACE;aACA;aACA;;WAEF;aACE;aACA;;WAEF;aACE;aACA;aACA;;WAEF;aACE;aACA;aACA;;WAEF;aACE;aACA;aACA;;WAEF;aACE;aACA;aACA;;WAEF;aACE;aACA;;WAEF;aACE;aACA;aACA;;WAKF;aACE;aACA;;WAEF;aACE;aACA;;WAEF;WACA;;qBAGW;WACX;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WAEA;;qBAIW;qBAIA;qBAcA;qBAwBA;WACX;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;WACA;;qBAGW,iBAAiB;qBAuBjB,gBAAgB;;;KC9VjB,wBAAwB;KACxB,gBAAgB;KAChB,iCAAiC;KACjC,wBAAwB;KACxB,mBAAmB;KACnB,WAAW;KAEX,gBAAgB,KAAK,UAAU,gBAAgB,OAAO;KACtD,qBAAqB,uBACxB;KAGG;KAEA,kBAAkB;KAClB;EACV;EACA;EACA,WAAW;EACX;;KAGU;EACV;EACA;;KAGU;EACV;EACA;EACA;;KAGU;;EAEV;;EAEA;EACA;EACA;;EAEA;;KAGU,wBACR,8BACA;KAEQ;EACV;EACA;EACA;;KAGU;EACV,SAAS;EACT,QAAQ;;KAGE;EACV;EACA,gBAAgB;EAChB,mBAAmB;EACnB,WAAW;;KAGD;EACV;EACA;EACA;EAGA;EAKA;;KAGU;;EAEV;;KAGU;EACV;;EAEA;;KAGU;;EAEV;;EAEA;;KAGU;;EAEV;;EAEA;;EAEA;;KAGU;EACV,UAAU;EACV,QAAQ;;KAGE;EACV;EACA;EACA;;EAEA;;EAEA;;EAEA,WAAW;;KAGD;;EAEV;;EAEA;;EAEA;;KAGU;;EAEV;;EAEA;;EAEA;;EAEA;;KAGU;EACV;EACA;;EAEA;;;;KAKU;;EAEV;;EAEA;;EAEA;;EAEA;;KAGU;EACV,eAAe;;EAEf;;EAEA;;;;;;;;;;KAWU;EAEN;EAAgB;;KAEV;;KAQA;EACV,YAAY;EACZ,SAAS;EACT;EACA;IACE;;;IAGA;IACA;MAAe;MAAqB;;IACpC;MACE;MACA,UAAU;;;;KAKJ;EACV;EACA;EACA;EACA;;;;;;;;;KAUU;;EAEV,QAAQ;;EAER,QAAQ;EACR;;;KAIU;EACV;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;;EAER,gBAAgB;;EAEhB;IACE;;;;;EASF;;;;;;;;;;;;KAaU;EACV,WAAW;;EAEX;;EAEA;;EAEA;;EAEA,iBAAiB;;EAEjB,2BAA2B;;KAGjB;EACV,WAAW;EACX,MAAM;EACN,KAAK;EACL,WAAW;EACX,SAAS;EACT,SAAS;EACT,SAAS;EACT,YAAY;EACZ,WAAW;EACX,UAAU;EACV,MAAM;;;KAII;;;EAGV;;EAEA;;EAEA;;KAGU;EAEV,UAAU;EACV;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;IACE;IACA;MAIM;MACA;;IAEN;MACE;MACA;MACA;;;EAGJ;IACE;IACA;IACA,SAAS;;EAEX;IACE;MACE;;IAEF;;EAEF;IACE;IACA;IACA;IACA;;EAEF,WAAW;EACX;IACE;IACA;IACA;;EAIF;IACE;;EAEF;EACA,UAAU;;;;qBC9WC;;;;;;;;;;qBCCA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBCJA;;;;;;;;;;;;;;;;;;;;;;;;;qBCQA;;;;;;;;;;;;;;;;;;;;;;;;;;;wBCWG;;wBAUA;qBASH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBCnCS,kCACpB,qBACA,cAAW;wBAgBG,cAAc;wBAIR,mCACpB,0BACA,uBAAoB;wBAiBA,oBAAoB;EACxC;EACA;EACA;IACD;wBAeqB,0BAA0B;EAC9C;EACA;EACA;IACD;wBAWqB,6BAA6B;EACjD;EACA;EACA;IACE,QAAQ;wBAmBI,SAAS;EACvB;EACA;EACA;EACA;;wBAUc,oBAAoB;EAClC,iBAAiB;EACjB;EACA;EACA;EACA;IACE;wBAUY,+BACd,SAAS,uDACT;wBAgBc,kBAAkB;wBAOlB,iBAAiB;EAC/B;EACA;EACA;;wBAQoB,iCACpB,0BAAuB;;;wBCvKH,gBAAgB,kCAA+B;wBAWrD,oBACd,kCACC;wBAKa,YACd,QAAQ,4BACP,UAAU;;;wBCpBS,WAAW,kCAA+B;wBAWhD,eACd,kCACC;wBAKa,OAAO,QAAQ,4BAA4B,UAAU;;;wBClBrD,UAAU,gBAAiC;;;wBCFrC,iCAA6B;;;wBCW7B,oBAAoB,cAAW;wBAM/B,oCAAgC;wBAUhC,qCAAiC;wBAYjC,4CACpB,qCAAkC,QAAA;wBASd,mCACpB,qBAAqB,OACrB,kBAAmB;wBAcC,qCACpB,oCACA,kBAAmB;wBAqBC,6BACpB,wBACA,uBAAoB;;;;wBAgCA,yBACpB,OAAO,QAAQ,qBACf;EAAY;IAAkB;;;;;;;;;wBC5HhB,OAAO,iBAAiB;EAAW;;;;wBCAnC,WACd,iBACA,gBACA;EACE;EACA,MAAM,OAAO;IAEd;;;wBCJmB,oBAAoB,uBAAoB;wBAWxC,uBAAmB;;;wBCbnB,qBACpB,kBACA,mBAAmB,SAAM;;;YC8Bf;EACV;EACA;EACA;EACA;EACA;;YAGU;;;;;;EAMV,0BAA0B,MAAM;;;;;EAKhC,kBACE,cACA;IAAS;QACN;;;;;;wBA8Ce,2BAA2B;;;;;wBAgH3B,iBAAiB;EACrC;EACA;IACE,QAAQ;;;;wBAgGI,oBAAoB;;;;wBAOpB;EACV;EAAe;;EACf;EAAkB;EAAkB;;EACpC;EAAmB;;;;wBCzTH,YAAY,sBAAsB,wBAAqB;wBAsH7D,cAAc,qBAAqB;;;qBCjHtC;qBAGA;WACF;;WAEF;WAEL;WACI;;;;eAQF;eACA;;;eAIA;eACA;eACA;;;eAGA;eACA;;;eAGA;eACA;;;eAGA;eACA;;;eAGA;eACA;;;eAGA;eACA;;;eAGA;eACA;;;eAIA;eACA;;;eAGA;eACA;;;eAGA;eACA;eACA;eACA;iBACE;mBACE;mBACA;;iBAEF;mBACE;qBACI;;qBAEA;qBACA;qBACA;qBACA;uBACE;yBACE;yBACA;;uBAEF;yBACE;yBACA;;;;mBAKR;;iBAGF;mBACE;mBACA;mBACA;mBACA;mBACA;qBACE;uBACE;uBACA;;qBAEF;uBACE;uBACA;;qBAEF;uBACE;uBACA;;;;;;;eAOR;eACA;eACA;eACA;eACA;iBACE;mBACE;mBACA;;iBAEF;mBACE;mBACA;qBAAS;;mBACT;;iBAEF;mBACE;mBACA;mBACA;mBAEA;qBACE;uBACE;uBACA;uBACA;;qBAGF;uBACE;uBACA;;qBAGF;uBACE;uBACA;;;;;;;eAQR;eACA;eACA;eACA;iBACE;mBACE;mBACA;mBACA;qBACE;uBACE;uBACA;;;;iBAIN;mBACE;mBACA;;;;;eAKJ;eACA;eACA;eACA;eACA;iBACE;mBACE;mBACA;;iBAEF;mBACE;mBACA;;iBAEF;mBACE;mBACA;;iBAEF;mBACE;mBACA;;;;;eAKJ;eACA;eAEA;;;;;;;;;;;;;;;;;;;;;;;;;;eAGA;eACA;eACA;eACA;iBACE;mBAAW;;iBACX;mBAAY;;iBACZ;mBACE;mBACA;;;;;eAMJ;eACA;eACA;eACA;iBACE;mBACE;mBACA;;;;;eAMJ;eACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAME;;;;;;;;;;;;wBCjPQ,sBACd,YACA;EAAY;EAAiB;;qBAOlB,yBAAyB;EACpC,YAAY,wBAAwB;SAO7B,QAAQ,iBAAiB,SAAS;;wBAK3B,kBAAkB"}

package/dist/clis/index.mjs

@@ -954,6 +954,24 @@ const generateArgs = {
 	...debugArgs
 };
 //#endregion
+//#region clis/feature-flags.ts
+/**
+* Feature toggles shared by the CLIs (ph-cli and ph-cmd's dispatch/help).
+* Hand-rolled env predicates by the CLI convention — deliberately no
+* OpenFeature dependency here; that stack belongs to the runtime apps.
+*/
+/**
+* Gates the uniform-runners surface: the `ph run` command (registration,
+* help listing, and ph-cmd forwarding), host-name sugar, and the `ph init`
+* hosts/ scaffold. Off by default; set to `1` or `true` to enable. Rollout
+* plan: docs/plans/2026-10-13-uniform-runners.md.
+*/
+const UNIFORM_RUNNERS_FLAG = "FEATURE_UNIFORM_RUNNERS_ENABLED";
+function isUniformRunnersEnabled(env = process.env) {
+	const value = env[UNIFORM_RUNNERS_FLAG]?.trim().toLowerCase();
+	return value === "1" || value === "true";
+}
+//#endregion
 //#region clis/args/inspect.ts
 const inspectArgs = {
 	packageName: positional({
@@ -1085,6 +1103,25 @@ const registryLoginArgs = {
 	...debugArgs
 };
 //#endregion
+//#region clis/args/run.ts
+const runArgs = {
+	host: positional({
+		type: string,
+		displayName: "host",
+		description: "the host to run (a directory under hosts/)"
+	}),
+	verb: positional({
+		type: optional(string),
+		displayName: "verb",
+		description: "optional verb the runner forwards (dev, build, serve, …)"
+	}),
+	debug: flag({
+		type: optional(boolean),
+		long: "debug",
+		description: "verbose runner diagnostics"
+	})
+};
+//#endregion
 //#region clis/args/switchboard.ts
 const switchboardArgs = {
 	...vetraSwitchboardArgs,
@@ -1297,6 +1334,7 @@ const vetraArgs = {
 //#endregion
 //#region clis/command-names.ts
 const phCliCommandNames = [
+	"run",
 	"generate",
 	"vetra",
 	"connect",
@@ -1331,7 +1369,13 @@ function helpCommand(config) {
 		aliases
 	});
 }
-const phCliHelpCommands = {
+const allPhCliHelpCommands = {
+	run: helpCommand({
+		name: "run",
+		args: runArgs,
+		description: "Run a host from hosts/ with its runner",
+		handler: () => {}
+	}),
 	generate: helpCommand({
 		name: "generate",
 		args: generateArgs,
@@ -1428,6 +1472,7 @@ const phCliHelpCommands = {
 		handler: () => {}
 	})
 };
+const phCliHelpCommands = isUniformRunnersEnabled() ? allPhCliHelpCommands : (({ run: _run, ...rest }) => rest)(allPhCliHelpCommands);
 //#endregion
 //#region clis/args/init.ts
 const initArgs = {