@unbrained/pm-cli 2026.5.18 → 2026.5.27

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/README.md

@@ -6,9 +6,13 @@ First-party package that restores optional advanced search surfaces in bare-core
 
 - Adds `pm search-advanced` with:
   - `--mode keyword|semantic|hybrid`
+  - `--semantic`, `--hybrid`
   - `--include-linked`
   - `--title-exact`
   - `--phrase-exact`
+  - `--type`, `--tag`, `--priority`
+  - `--deadline-before`, `--deadline-after`
+  - `--limit`, `--fields`, `--compact`, `--full`
 - Adds `pm reindex` with:
   - `--mode keyword|semantic|hybrid`
   - `--progress`
@@ -23,5 +27,9 @@ pm install search-advanced --project
 
 ```bash
 pm search-advanced "vector cache" --mode hybrid --limit 5 --json
+pm search-advanced --hybrid "vector cache" --limit 5 --json
+pm search-advanced "calendar package" --mode keyword --fields id,title,score --compact --json
 pm reindex --mode hybrid --progress --json
 ```
+
+Without `--mode`, `--semantic`, or `--hybrid`, `search-advanced` stays keyword-first for fast agent reads.

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 = [
@@ -15,6 +15,16 @@ const searchAdvancedFlags = [
     value_type: "string",
     description: "Search mode override: keyword|semantic|hybrid.",
   },
+  {
+    long: "--semantic",
+    value_type: "boolean",
+    description: "Alias for --mode semantic.",
+  },
+  {
+    long: "--hybrid",
+    value_type: "boolean",
+    description: "Alias for --mode hybrid.",
+  },
   {
     long: "--include-linked",
     value_type: "boolean",
@@ -45,6 +55,70 @@ const searchAdvancedFlags = [
     value_type: "boolean",
     description: "Alias for --phrase-exact.",
   },
+  {
+    long: "--type",
+    value_name: "value",
+    value_type: "string",
+    description: "Filter by item type.",
+  },
+  {
+    long: "--tag",
+    value_name: "value",
+    value_type: "string",
+    description: "Filter by tag.",
+  },
+  {
+    long: "--priority",
+    value_name: "value",
+    value_type: "string",
+    description: "Filter by priority.",
+  },
+  {
+    long: "--deadline-before",
+    value_name: "date",
+    value_type: "string",
+    description: "Filter to items with deadlines before a date.",
+  },
+  {
+    long: "--deadline_before",
+    value_name: "date",
+    value_type: "string",
+    description: "Alias for --deadline-before.",
+  },
+  {
+    long: "--deadline-after",
+    value_name: "date",
+    value_type: "string",
+    description: "Filter to items with deadlines after a date.",
+  },
+  {
+    long: "--deadline_after",
+    value_name: "date",
+    value_type: "string",
+    description: "Alias for --deadline-after.",
+  },
+  {
+    long: "--limit",
+    value_name: "count",
+    value_type: "string",
+    description: "Limit the number of search results.",
+  },
+  {
+    long: "--fields",
+    value_name: "list",
+    value_type: "string",
+    description: "Return only selected result fields.",
+  },
+  {
+    long: "--compact",
+    value_type: "boolean",
+    description: "Return compact token-efficient search results.",
+  },
+  {
+    long: "--full",
+    value_type: "boolean",
+    description: "Return full search results.",
+  },
 ];
 
 const reindexFlags = [

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

@@ -16,6 +16,16 @@ const searchAdvancedFlags = [
     value_type: "string",
     description: "Search mode override: keyword|semantic|hybrid.",
   },
+  {
+    long: "--semantic",
+    value_type: "boolean",
+    description: "Alias for --mode semantic.",
+  },
+  {
+    long: "--hybrid",
+    value_type: "boolean",
+    description: "Alias for --mode hybrid.",
+  },
   {
     long: "--include-linked",
     value_type: "boolean",
@@ -46,6 +56,70 @@ const searchAdvancedFlags = [
     value_type: "boolean",
     description: "Alias for --phrase-exact.",
   },
+  {
+    long: "--type",
+    value_name: "value",
+    value_type: "string",
+    description: "Filter by item type.",
+  },
+  {
+    long: "--tag",
+    value_name: "value",
+    value_type: "string",
+    description: "Filter by tag.",
+  },
+  {
+    long: "--priority",
+    value_name: "value",
+    value_type: "string",
+    description: "Filter by priority.",
+  },
+  {
+    long: "--deadline-before",
+    value_name: "date",
+    value_type: "string",
+    description: "Filter to items with deadlines before a date.",
+  },
+  {
+    long: "--deadline_before",
+    value_name: "date",
+    value_type: "string",
+    description: "Alias for --deadline-before.",
+  },
+  {
+    long: "--deadline-after",
+    value_name: "date",
+    value_type: "string",
+    description: "Filter to items with deadlines after a date.",
+  },
+  {
+    long: "--deadline_after",
+    value_name: "date",
+    value_type: "string",
+    description: "Alias for --deadline-after.",
+  },
+  {
+    long: "--limit",
+    value_name: "count",
+    value_type: "string",
+    description: "Limit the number of search results.",
+  },
+  {
+    long: "--fields",
+    value_name: "list",
+    value_type: "string",
+    description: "Return only selected result fields.",
+  },
+  {
+    long: "--compact",
+    value_type: "boolean",
+    description: "Return compact token-efficient search results.",
+  },
+  {
+    long: "--full",
+    value_type: "boolean",
+    description: "Return full search results.",
+  },
 ] as const;
 
 const reindexFlags = [