@unbrained/pm-cli 2026.5.24 → 2026.5.28

package/packages/pm-governance-audit/extensions/governance-audit/runtime.ts

@@ -8,6 +8,8 @@ interface GovernanceRuntimeSdkModule {
   runDedupeAudit: (options: Record<string, unknown>, global: GlobalOptions) => Promise<unknown>;
   runCommentsAudit: (options: Record<string, unknown>, global: GlobalOptions) => Promise<unknown>;
   runNormalize: (options: Record<string, unknown>, global: GlobalOptions) => Promise<unknown>;
+  readStringOption: (options: Record<string, unknown>, key: string, aliases?: string[]) => string | undefined;
+  readBooleanOption: (options: Record<string, unknown>, key: string, aliases?: string[]) => boolean | undefined;
 }
 
 let governanceModule: GovernanceRuntimeSdkModule | null = null;
@@ -37,7 +39,9 @@ async function loadGovernanceModule(): Promise<GovernanceRuntimeSdkModule> {
     if (
       typeof loaded.runDedupeAudit === "function" &&
       typeof loaded.runCommentsAudit === "function" &&
-      typeof loaded.runNormalize === "function"
+      typeof loaded.runNormalize === "function" &&
+      typeof loaded.readStringOption === "function" &&
+      typeof loaded.readBooleanOption === "function"
     ) {
       return loaded as GovernanceRuntimeSdkModule;
     }
@@ -49,41 +53,11 @@ async function loadGovernanceModule(): Promise<GovernanceRuntimeSdkModule> {
   );
 }
 
-function readStringOption(options: Record<string, unknown>, key: string, aliases: string[] = []): string | undefined {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (typeof value === "string" && value.trim().length > 0) {
-      return value;
-    }
-  }
-  return undefined;
-}
-
-function readBooleanOption(options: Record<string, unknown>, key: string, aliases: string[] = []): boolean | undefined {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (value === undefined) {
-      continue;
-    }
-    if (typeof value === "boolean") {
-      return value;
-    }
-    if (typeof value === "string") {
-      const normalized = value.trim().toLowerCase();
-      if (normalized === "true" || normalized === "1" || normalized === "yes" || normalized === "on") {
-        return true;
-      }
-      if (normalized === "false" || normalized === "0" || normalized === "no" || normalized === "off") {
-        return false;
-      }
-    }
-  }
-  return undefined;
-}
-
-function normalizeDedupeAuditOptions(raw: Record<string, unknown>): Record<string, unknown> {
+function normalizeDedupeAuditOptions(
+  sdk: GovernanceRuntimeSdkModule,
+  raw: Record<string, unknown>,
+): Record<string, unknown> {
+  const readStringOption = sdk.readStringOption;
   return {
     mode: readStringOption(raw, "mode"),
     status: readStringOption(raw, "status"),
@@ -102,7 +76,12 @@ function normalizeDedupeAuditOptions(raw: Record<string, unknown>): Record<strin
   };
 }
 
-function normalizeCommentsAuditOptions(raw: Record<string, unknown>): Record<string, unknown> {
+function normalizeCommentsAuditOptions(
+  sdk: GovernanceRuntimeSdkModule,
+  raw: Record<string, unknown>,
+): Record<string, unknown> {
+  const readStringOption = sdk.readStringOption;
+  const readBooleanOption = sdk.readBooleanOption;
   return {
     status: readStringOption(raw, "status"),
     type: readStringOption(raw, "type"),
@@ -120,7 +99,12 @@ function normalizeCommentsAuditOptions(raw: Record<string, unknown>): Record<str
   };
 }
 
-function normalizeNormalizeOptions(raw: Record<string, unknown>): Record<string, unknown> {
+function normalizeNormalizeOptions(
+  sdk: GovernanceRuntimeSdkModule,
+  raw: Record<string, unknown>,
+): Record<string, unknown> {
+  const readStringOption = sdk.readStringOption;
+  const readBooleanOption = sdk.readBooleanOption;
   return {
     status: readStringOption(raw, "filterStatus", ["filter_status", "status"]),
     list: {
@@ -156,7 +140,7 @@ export async function runDedupeAuditPackage(
   global: GlobalOptions,
 ): Promise<unknown> {
   const module = await ensureGovernanceModule();
-  return module.runDedupeAudit(normalizeDedupeAuditOptions(options), global);
+  return module.runDedupeAudit(normalizeDedupeAuditOptions(module, options), global);
 }
 
 export async function runCommentsAuditPackage(
@@ -164,7 +148,7 @@ export async function runCommentsAuditPackage(
   global: GlobalOptions,
 ): Promise<unknown> {
   const module = await ensureGovernanceModule();
-  return module.runCommentsAudit(normalizeCommentsAuditOptions(options), global);
+  return module.runCommentsAudit(normalizeCommentsAuditOptions(module, options), global);
 }
 
 export async function runNormalizePackage(
@@ -172,5 +156,5 @@ export async function runNormalizePackage(
   global: GlobalOptions,
 ): Promise<unknown> {
   const module = await ensureGovernanceModule();
-  return module.runNormalize(normalizeNormalizeOptions(options), global);
+  return module.runNormalize(normalizeNormalizeOptions(module, options), global);
 }

package/packages/pm-guide-shell/extensions/guide-shell/runtime.js

@@ -39,7 +39,10 @@ async function loadRuntimeBundle() {
       typeof sdkLoaded.resolveRuntimeStatusRegistry === "function" &&
       typeof sdkLoaded.resolveRuntimeFieldRegistry === "function" &&
       typeof sdkLoaded.listAllFrontMatter === "function" &&
-      typeof sdkLoaded.getActiveExtensionRegistrations === "function"
+      typeof sdkLoaded.getActiveExtensionRegistrations === "function" &&
+      typeof sdkLoaded.readStringOption === "function" &&
+      typeof sdkLoaded.readBooleanOption === "function" &&
+      typeof sdkLoaded.readCsvListOption === "function"
     ) {
       return {
         sdk: sdkLoaded,
@@ -53,52 +56,8 @@ async function loadRuntimeBundle() {
   );
 }
 
-function readStringOption(options, key, aliases = []) {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (typeof value === "string" && value.trim().length > 0) {
-      return value;
-    }
-  }
-  return undefined;
-}
-
-function readBooleanOption(options, key, aliases = []) {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (value === undefined) {
-      continue;
-    }
-    if (typeof value === "boolean") {
-      return value;
-    }
-    if (typeof value === "string") {
-      const normalized = value.trim().toLowerCase();
-      if (normalized === "true" || normalized === "1" || normalized === "yes" || normalized === "on") {
-        return true;
-      }
-      if (normalized === "false" || normalized === "0" || normalized === "no" || normalized === "off") {
-        return false;
-      }
-    }
-  }
-  return undefined;
-}
-
-function readCsvListOption(options, key, aliases = []) {
-  const value = readStringOption(options, key, aliases);
-  if (!value) {
-    return [];
-  }
-  return value
-    .split(",")
-    .map((entry) => entry.trim())
-    .filter((entry) => entry.length > 0);
-}
-
-function normalizeGuideOptions(args, options) {
+function normalizeGuideOptions(bundle, args, options) {
+  const { readStringOption, readBooleanOption } = bundle.sdk;
   const topicFromArgs = args[0];
   return {
     topic: readStringOption(options, "topic") ?? (typeof topicFromArgs === "string" && topicFromArgs.trim().length > 0 ? topicFromArgs : undefined),
@@ -108,7 +67,8 @@ function normalizeGuideOptions(args, options) {
   };
 }
 
-function normalizeCompletionOptions(args, options) {
+function normalizeCompletionOptions(bundle, args, options) {
+  const { readStringOption, readBooleanOption, readCsvListOption } = bundle.sdk;
   const shellFromOptions = readStringOption(options, "shell");
   const shellFromArgs = typeof args[0] === "string" && args[0].trim().length > 0 ? args[0].trim() : undefined;
   return {
@@ -185,12 +145,12 @@ function collectTagsFromItems(items) {
 
 export async function runGuidePackage(args, options, global) {
   const bundle = await ensureRuntimeBundle();
-  return bundle.sdk.runGuide(normalizeGuideOptions(args, options), global);
+  return bundle.sdk.runGuide(normalizeGuideOptions(bundle, args, options), global);
 }
 
 export async function runCompletionPackage(args, options, global) {
   const bundle = await ensureRuntimeBundle();
-  const normalized = normalizeCompletionOptions(args, options);
+  const normalized = normalizeCompletionOptions(bundle, args, options);
   const runtimeConfig = await buildCompletionRuntimeConfig(bundle, global);
   return bundle.sdk.runCompletion(
     normalized.shell,

package/packages/pm-guide-shell/extensions/guide-shell/runtime.ts

@@ -39,6 +39,9 @@ interface RuntimeSdkModule {
     schema?: unknown,
   ) => Promise<Array<{ metadata: { tags?: string[] } }>>;
   getActiveExtensionRegistrations: () => unknown;
+  readStringOption: (options: Record<string, unknown>, key: string, aliases?: string[]) => string | undefined;
+  readBooleanOption: (options: Record<string, unknown>, key: string, aliases?: string[]) => boolean | undefined;
+  readCsvListOption: (options: Record<string, unknown>, key: string, aliases?: string[]) => string[];
 }
 
 interface RuntimeBundle {
@@ -82,7 +85,10 @@ async function loadRuntimeBundle(): Promise<RuntimeBundle> {
       typeof sdkLoaded.resolveRuntimeStatusRegistry === "function" &&
       typeof sdkLoaded.resolveRuntimeFieldRegistry === "function" &&
       typeof sdkLoaded.listAllFrontMatter === "function" &&
-      typeof sdkLoaded.getActiveExtensionRegistrations === "function"
+      typeof sdkLoaded.getActiveExtensionRegistrations === "function" &&
+      typeof sdkLoaded.readStringOption === "function" &&
+      typeof sdkLoaded.readBooleanOption === "function" &&
+      typeof sdkLoaded.readCsvListOption === "function"
     ) {
       return {
         sdk: sdkLoaded as RuntimeSdkModule,
@@ -96,52 +102,12 @@ async function loadRuntimeBundle(): Promise<RuntimeBundle> {
   );
 }
 
-function readStringOption(options: Record<string, unknown>, key: string, aliases: string[] = []): string | undefined {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (typeof value === "string" && value.trim().length > 0) {
-      return value;
-    }
-  }
-  return undefined;
-}
-
-function readBooleanOption(options: Record<string, unknown>, key: string, aliases: string[] = []): boolean | undefined {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (value === undefined) {
-      continue;
-    }
-    if (typeof value === "boolean") {
-      return value;
-    }
-    if (typeof value === "string") {
-      const normalized = value.trim().toLowerCase();
-      if (normalized === "true" || normalized === "1" || normalized === "yes" || normalized === "on") {
-        return true;
-      }
-      if (normalized === "false" || normalized === "0" || normalized === "no" || normalized === "off") {
-        return false;
-      }
-    }
-  }
-  return undefined;
-}
-
-function readCsvListOption(options: Record<string, unknown>, key: string, aliases: string[] = []): string[] {
-  const value = readStringOption(options, key, aliases);
-  if (!value) {
-    return [];
-  }
-  return value
-    .split(",")
-    .map((entry) => entry.trim())
-    .filter((entry) => entry.length > 0);
-}
-
-function normalizeGuideOptions(args: string[], options: Record<string, unknown>): Record<string, unknown> {
+function normalizeGuideOptions(
+  bundle: RuntimeBundle,
+  args: string[],
+  options: Record<string, unknown>,
+): Record<string, unknown> {
+  const { readStringOption, readBooleanOption } = bundle.sdk;
   const topicFromArgs = args[0];
   return {
     topic: readStringOption(options, "topic") ?? (typeof topicFromArgs === "string" && topicFromArgs.trim().length > 0 ? topicFromArgs : undefined),
@@ -151,12 +117,13 @@ function normalizeGuideOptions(args: string[], options: Record<string, unknown>)
   };
 }
 
-function normalizeCompletionOptions(args: string[], options: Record<string, unknown>): {
+function normalizeCompletionOptions(bundle: RuntimeBundle, args: string[], options: Record<string, unknown>): {
   shell: string;
   itemTypes: string[];
   tags: string[];
   eagerTags: boolean;
 } {
+  const { readStringOption, readBooleanOption, readCsvListOption } = bundle.sdk;
   const shellFromOptions = readStringOption(options, "shell");
   const shellFromArgs = typeof args[0] === "string" && args[0].trim().length > 0 ? args[0].trim() : undefined;
   return {
@@ -243,7 +210,7 @@ export async function runGuidePackage(
   global: GlobalOptions,
 ): Promise<unknown> {
   const bundle = await ensureRuntimeBundle();
-  return bundle.sdk.runGuide(normalizeGuideOptions(args, options), global);
+  return bundle.sdk.runGuide(normalizeGuideOptions(bundle, args, options), global);
 }
 
 export async function runCompletionPackage(
@@ -252,7 +219,7 @@ export async function runCompletionPackage(
   global: GlobalOptions,
 ): Promise<unknown> {
   const bundle = await ensureRuntimeBundle();
-  const normalized = normalizeCompletionOptions(args, options);
+  const normalized = normalizeCompletionOptions(bundle, args, options);
   const runtimeConfig = await buildCompletionRuntimeConfig(bundle, global);
   return bundle.sdk.runCompletion(
     normalized.shell,

package/packages/pm-linked-test-adapters/extensions/linked-test-adapters/runtime.js

@@ -33,6 +33,8 @@ async function loadRuntimeBundle() {
       typeof sdkLoaded.runTestRunsStop === "function" &&
       typeof sdkLoaded.runTestRunsResume === "function" &&
       typeof sdkLoaded.PmCliError === "function" &&
+      typeof sdkLoaded.readStringOption === "function" &&
+      typeof sdkLoaded.readBooleanOption === "function" &&
       typeof sdkLoaded.EXIT_CODE === "object" &&
       sdkLoaded.EXIT_CODE !== null
     ) {
@@ -48,40 +50,6 @@ async function loadRuntimeBundle() {
   );
 }
 
-function readStringOption(options, key, aliases = []) {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (typeof value === "string" && value.trim().length > 0) {
-      return value;
-    }
-  }
-  return undefined;
-}
-
-function readBooleanOption(options, key, aliases = []) {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (value === undefined) {
-      continue;
-    }
-    if (typeof value === "boolean") {
-      return value;
-    }
-    if (typeof value === "string") {
-      const normalized = value.trim().toLowerCase();
-      if (normalized === "true" || normalized === "1" || normalized === "yes" || normalized === "on") {
-        return true;
-      }
-      if (normalized === "false" || normalized === "0" || normalized === "no" || normalized === "off") {
-        return false;
-      }
-    }
-  }
-  return undefined;
-}
-
 function requireRunId(bundle, commandName, args) {
   const runId = args[0];
   if (typeof runId === "string" && runId.trim().length > 0) {
@@ -94,8 +62,8 @@ export async function runTestRunsListPackage(options, global) {
   const bundle = await ensureRuntimeBundle();
   return bundle.sdk.runTestRunsList(
     {
-      status: readStringOption(options, "status"),
-      limit: readStringOption(options, "limit"),
+      status: bundle.sdk.readStringOption(options, "status"),
+      limit: bundle.sdk.readStringOption(options, "limit"),
     },
     global,
   );
@@ -111,8 +79,8 @@ export async function runTestRunsLogsPackage(args, options, global) {
   return bundle.sdk.runTestRunsLogs(
     requireRunId(bundle, "test-runs logs", args),
     {
-      stream: readStringOption(options, "stream"),
-      tail: readStringOption(options, "tail"),
+      stream: bundle.sdk.readStringOption(options, "stream"),
+      tail: bundle.sdk.readStringOption(options, "tail"),
     },
     global,
   );
@@ -123,7 +91,7 @@ export async function runTestRunsStopPackage(args, options, global) {
   return bundle.sdk.runTestRunsStop(
     requireRunId(bundle, "test-runs stop", args),
     {
-      force: readBooleanOption(options, "force") === true,
+      force: bundle.sdk.readBooleanOption(options, "force") === true,
     },
     global,
   );
@@ -134,7 +102,7 @@ export async function runTestRunsResumePackage(args, options, global) {
   return bundle.sdk.runTestRunsResume(
     requireRunId(bundle, "test-runs resume", args),
     {
-      author: readStringOption(options, "author"),
+      author: bundle.sdk.readStringOption(options, "author"),
       noExtensions: global.noExtensions === true,
     },
     global,

package/packages/pm-linked-test-adapters/extensions/linked-test-adapters/runtime.ts

@@ -12,6 +12,8 @@ interface RuntimeSdkModule {
   runTestRunsLogs: (runId: string, options: Record<string, unknown>, global: GlobalOptions) => Promise<unknown>;
   runTestRunsStop: (runId: string, options: Record<string, unknown>, global: GlobalOptions) => Promise<unknown>;
   runTestRunsResume: (runId: string, options: Record<string, unknown>, global: GlobalOptions) => Promise<unknown>;
+  readStringOption: (options: Record<string, unknown>, key: string, aliases?: string[]) => string | undefined;
+  readBooleanOption: (options: Record<string, unknown>, key: string, aliases?: string[]) => boolean | undefined;
 }
 
 interface RuntimeBundle {
@@ -49,6 +51,8 @@ async function loadRuntimeBundle(): Promise<RuntimeBundle> {
       typeof sdkLoaded.runTestRunsStop === "function" &&
       typeof sdkLoaded.runTestRunsResume === "function" &&
       typeof sdkLoaded.PmCliError === "function" &&
+      typeof sdkLoaded.readStringOption === "function" &&
+      typeof sdkLoaded.readBooleanOption === "function" &&
       typeof sdkLoaded.EXIT_CODE === "object" &&
       sdkLoaded.EXIT_CODE !== null
     ) {
@@ -64,40 +68,6 @@ async function loadRuntimeBundle(): Promise<RuntimeBundle> {
   );
 }
 
-function readStringOption(options: Record<string, unknown>, key: string, aliases: string[] = []): string | undefined {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (typeof value === "string" && value.trim().length > 0) {
-      return value;
-    }
-  }
-  return undefined;
-}
-
-function readBooleanOption(options: Record<string, unknown>, key: string, aliases: string[] = []): boolean | undefined {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (value === undefined) {
-      continue;
-    }
-    if (typeof value === "boolean") {
-      return value;
-    }
-    if (typeof value === "string") {
-      const normalized = value.trim().toLowerCase();
-      if (normalized === "true" || normalized === "1" || normalized === "yes" || normalized === "on") {
-        return true;
-      }
-      if (normalized === "false" || normalized === "0" || normalized === "no" || normalized === "off") {
-        return false;
-      }
-    }
-  }
-  return undefined;
-}
-
 function requireRunId(bundle: RuntimeBundle, commandName: string, args: string[]): string {
   const runId = args[0];
   if (typeof runId === "string" && runId.trim().length > 0) {
@@ -113,8 +83,8 @@ export async function runTestRunsListPackage(
   const bundle = await ensureRuntimeBundle();
   return bundle.sdk.runTestRunsList(
     {
-      status: readStringOption(options, "status"),
-      limit: readStringOption(options, "limit"),
+      status: bundle.sdk.readStringOption(options, "status"),
+      limit: bundle.sdk.readStringOption(options, "limit"),
     },
     global,
   );
@@ -134,8 +104,8 @@ export async function runTestRunsLogsPackage(
   return bundle.sdk.runTestRunsLogs(
     requireRunId(bundle, "test-runs logs", args),
     {
-      stream: readStringOption(options, "stream"),
-      tail: readStringOption(options, "tail"),
+      stream: bundle.sdk.readStringOption(options, "stream"),
+      tail: bundle.sdk.readStringOption(options, "tail"),
     },
     global,
   );
@@ -150,7 +120,7 @@ export async function runTestRunsStopPackage(
   return bundle.sdk.runTestRunsStop(
     requireRunId(bundle, "test-runs stop", args),
     {
-      force: readBooleanOption(options, "force") === true,
+      force: bundle.sdk.readBooleanOption(options, "force") === true,
     },
     global,
   );
@@ -165,7 +135,7 @@ export async function runTestRunsResumePackage(
   return bundle.sdk.runTestRunsResume(
     requireRunId(bundle, "test-runs resume", args),
     {
-      author: readStringOption(options, "author"),
+      author: bundle.sdk.readStringOption(options, "author"),
       noExtensions: global.noExtensions === true,
     },
     global,

package/packages/pm-search-advanced/extensions/search-advanced/index.js

@@ -5,7 +5,7 @@ export const manifest = {
   version: "0.1.0",
   entry: "./index.js",
   priority: 0,
-  capabilities: ["commands"],
+  capabilities: ["commands", "schema"],
 };
 
 const searchAdvancedFlags = [

package/packages/pm-search-advanced/extensions/search-advanced/runtime.js

@@ -8,6 +8,8 @@ const {
   PmCliError,
   runSearch,
   runReindex,
+  readStringOption,
+  readBooleanOption,
 } = sdk;
 
 async function loadSearchSdkModule() {
@@ -24,6 +26,8 @@ async function loadSearchSdkModule() {
       typeof loaded.runSearch === "function" &&
       typeof loaded.runReindex === "function" &&
       typeof loaded.PmCliError === "function" &&
+      typeof loaded.readStringOption === "function" &&
+      typeof loaded.readBooleanOption === "function" &&
       typeof loaded.EXIT_CODE === "object" &&
       loaded.EXIT_CODE !== null
     ) {
@@ -37,43 +41,6 @@ async function loadSearchSdkModule() {
   );
 }
 
-function readStringOption(options, key, aliases = []) {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (typeof value === "string" && value.trim().length > 0) {
-      return value;
-    }
-  }
-  return undefined;
-}
-
-const BOOLEAN_TRUE_VALUES = new Set(["true", "1", "yes", "on"]);
-const BOOLEAN_FALSE_VALUES = new Set(["false", "0", "no", "off"]);
-
-function readBooleanOption(options, key, aliases = []) {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (value === undefined) {
-      continue;
-    }
-    if (typeof value === "boolean") {
-      return value;
-    }
-    if (typeof value === "string") {
-      const normalized = value.trim().toLowerCase();
-      if (BOOLEAN_TRUE_VALUES.has(normalized)) {
-        return true;
-      }
-      if (BOOLEAN_FALSE_VALUES.has(normalized)) {
-        return false;
-      }
-    }
-  }
-  return undefined;
-}
-
 const SEARCH_VALUE_FLAGS = new Set([
   "--mode",
   "--type",

package/packages/pm-search-advanced/extensions/search-advanced/runtime.ts

@@ -17,6 +17,8 @@ interface SearchRuntimeSdkModule {
   PmCliError: new (message: string, exitCode?: number) => Error;
   runSearch: (query: string, options: SearchOptions, global: GlobalOptions) => Promise<SearchResult>;
   runReindex: (options: ReindexOptions, global: GlobalOptions) => Promise<ReindexResult>;
+  readStringOption: (options: Record<string, unknown>, key: string, aliases?: string[]) => string | undefined;
+  readBooleanOption: (options: Record<string, unknown>, key: string, aliases?: string[]) => boolean | undefined;
 }
 
 const sdk = await loadSearchSdkModule();
@@ -25,6 +27,8 @@ const {
   PmCliError,
   runSearch,
   runReindex,
+  readStringOption,
+  readBooleanOption,
 } = sdk;
 
 async function loadSearchSdkModule(): Promise<SearchRuntimeSdkModule> {
@@ -41,6 +45,8 @@ async function loadSearchSdkModule(): Promise<SearchRuntimeSdkModule> {
       typeof loaded.runSearch === "function" &&
       typeof loaded.runReindex === "function" &&
       typeof loaded.PmCliError === "function" &&
+      typeof loaded.readStringOption === "function" &&
+      typeof loaded.readBooleanOption === "function" &&
       typeof loaded.EXIT_CODE === "object" &&
       loaded.EXIT_CODE !== null
     ) {
@@ -54,43 +60,6 @@ async function loadSearchSdkModule(): Promise<SearchRuntimeSdkModule> {
   );
 }
 
-function readStringOption(options: Record<string, unknown>, key: string, aliases: string[] = []): string | undefined {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (typeof value === "string" && value.trim().length > 0) {
-      return value;
-    }
-  }
-  return undefined;
-}
-
-const BOOLEAN_TRUE_VALUES = new Set(["true", "1", "yes", "on"]);
-const BOOLEAN_FALSE_VALUES = new Set(["false", "0", "no", "off"]);
-
-function readBooleanOption(options: Record<string, unknown>, key: string, aliases: string[] = []): boolean | undefined {
-  const keys = [key, ...aliases];
-  for (const candidate of keys) {
-    const value = options[candidate];
-    if (value === undefined) {
-      continue;
-    }
-    if (typeof value === "boolean") {
-      return value;
-    }
-    if (typeof value === "string") {
-      const normalized = value.trim().toLowerCase();
-      if (BOOLEAN_TRUE_VALUES.has(normalized)) {
-        return true;
-      }
-      if (BOOLEAN_FALSE_VALUES.has(normalized)) {
-        return false;
-      }
-    }
-  }
-  return undefined;
-}
-
 const SEARCH_VALUE_FLAGS = new Set([
   "--mode",
   "--type",