@unbrained/pm-cli 2026.7.16 → 2026.7.17

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

@@ -7,7 +7,7 @@
 import { EXIT_CODE, PmCliError, PmClient, type ListOptions } from "./sdk.ts";
 
 /** Retain only list filters that the package-owned audit queries may forward. */
-export function buildListQueryFilters(
+export const buildListQueryFilters = (
   filters: Pick<
     ListOptions,
     | "type"
@@ -21,7 +21,7 @@ export function buildListQueryFilters(
     | "sprint"
     | "release"
   >,
-): ListOptions {
+): ListOptions => {
   const {
     type,
     tag,
@@ -46,48 +46,50 @@ export function buildListQueryFilters(
     sprint,
     release,
   };
-}
+};
 
 /** Order valid timestamps chronologically and malformed values lexicographically. */
-export function compareTimestampStrings(left: string, right: string): number {
+export const compareTimestampStrings = (
+  left: string,
+  right: string,
+): number => {
   const leftMs = Date.parse(left);
   const rightMs = Date.parse(right);
   if (Number.isFinite(leftMs) && Number.isFinite(rightMs) && leftMs !== rightMs)
     return leftMs - rightMs;
   return left.localeCompare(right);
-}
+};
 
 /** Measure set overlap between two token lists on the inclusive zero-to-one scale. */
-export function jaccardSimilarity(
+export const jaccardSimilarity = (
   leftTokens: string[],
   rightTokens: string[],
-): number {
-  if (leftTokens.length === 0 && rightTokens.length === 0) return 1;
-  if (leftTokens.length === 0 || rightTokens.length === 0) return 0;
+): number => {
   const left = new Set(leftTokens);
   const right = new Set(rightTokens);
-  let intersection = 0;
-  for (const token of left) if (right.has(token)) intersection += 1;
-  return intersection / new Set([...left, ...right]).size;
-}
+  const union = new Set([...left, ...right]);
+  if (union.size === 0) return 1;
+  const intersection = [...left].filter((token) => right.has(token)).length;
+  return intersection / union.size;
+};
 
 /** Trim, lowercase, and collapse internal whitespace for stable audit comparisons. */
-export function normalizeLowercaseWhitespace(value: string): string {
+export const normalizeLowercaseWhitespace = (value: string): string => {
   return value.trim().toLowerCase().replace(/\s+/g, " ");
-}
+};
 
 /** Split normalized text into non-empty lowercase ASCII alphanumeric tokens. */
-export function tokenizeAlphaNumeric(value: string): string[] {
+export const tokenizeAlphaNumeric = (value: string): string[] => {
   return normalizeLowercaseWhitespace(value)
     .split(/[^a-z0-9]+/)
     .filter((token) => token.length > 0);
-}
+};
 
 /** Parse an optional non-negative integer limit with package-specific error context. */
-export function parseIntegerLimit(
+export const parseIntegerLimit = (
   raw: string | undefined,
   label = "--limit",
-): number | undefined {
+): number | undefined => {
   if (raw === undefined) return undefined;
   const parsed = Number(raw);
   if (!Number.isInteger(parsed) || parsed < 0)
@@ -96,31 +98,31 @@ export function parseIntegerLimit(
       EXIT_CODE.USAGE,
     );
   return parsed;
-}
+};
 
 /** Normalize an optional comma-separated value into trimmed non-empty entries. */
-export function splitCommaList(raw: string | undefined | null): string[] {
+export const splitCommaList = (raw: string | undefined | null): string[] => {
   if (raw == null) return [];
   return raw
     .split(",")
     .map((entry) => entry.trim())
     .filter(Boolean);
-}
+};
 
 /** Convert thrown values to a concise message suitable for audit result envelopes. */
-export function toErrorMessage(error: unknown): string {
+export const toErrorMessage = (error: unknown): string => {
   if (error instanceof Error) return error.message.trim() || error.name;
   return String(error);
-}
+};
 
 /** Return trimmed non-empty text while rejecting non-string and blank values. */
-export function toNonEmptyStringOrUndefined(
+export const toNonEmptyStringOrUndefined = (
   value: unknown,
-): string | undefined {
+): string | undefined => {
   if (typeof value !== "string") return undefined;
   const normalized = value.trim();
   return normalized.length > 0 ? normalized : undefined;
-}
+};
 
 /** Inputs used to attribute linked paths to every item that references them. */
 export interface LinkedArtifactAuditPayload {
@@ -141,18 +143,22 @@ export interface LinkedArtifactAuditEntry {
 }
 
 /** Build sorted, duplicate-free reverse attribution for requested artifact paths. */
-export function buildLinkedArtifactAudit(
+export const buildLinkedArtifactAudit = (
   input: LinkedArtifactAuditPayload,
-): LinkedArtifactAuditEntry[] {
+): LinkedArtifactAuditEntry[] => {
+  /** Build a stable reverse index over optional item and path collections. */
+  /** Normalize an optional read-only collection into an iterable array. */
+  const optionalArray = <Value>(values: readonly Value[] | undefined) =>
+    values ?? [];
   const index = new Map<string, Set<string>>();
-  for (const item of input.items ?? []) {
-    for (const artifact of item.artifacts ?? []) {
+  for (const item of optionalArray(input.items)) {
+    for (const artifact of optionalArray(item.artifacts)) {
       const ids = index.get(artifact.path) ?? new Set<string>();
       ids.add(item.id);
       index.set(artifact.path, ids);
     }
   }
-  return [...new Set(input.paths ?? [])]
+  return [...new Set(optionalArray(input.paths))]
     .sort((left, right) => left.localeCompare(right))
     .map((linkedPath) => {
       const linkedItemIds = [...(index.get(linkedPath) ?? [])].sort(
@@ -164,7 +170,7 @@ export function buildLinkedArtifactAudit(
         linked_item_ids: linkedItemIds,
       };
     });
-}
+};
 
 interface CommandResultPayload {
   command?: string;
@@ -174,80 +180,123 @@ interface CommandResultPayload {
   result?: unknown;
 }
 
-function asRecord(value: unknown): Record<string, unknown> | undefined {
+const asRecord = (value: unknown): Record<string, unknown> | undefined => {
+  /** Narrow an unknown payload to a non-null object record. */
   return typeof value === "object" && value !== null
     ? (value as Record<string, unknown>)
     : undefined;
-}
+};
 
-function hasUpdateAuditBypass(options: Record<string, unknown>): boolean {
+const hasUpdateAuditBypass = (
+  options: Record<string, unknown> | undefined,
+): boolean => {
+  /** Detect every supported update-audit bypass alias. */
+  const resolved = options ?? {};
   return (
-    options.allowAuditUpdate === true ||
-    options.allow_audit_update === true ||
-    options.allowAuditDepUpdate === true ||
-    options.allow_audit_dep_update === true
+    resolved.allowAuditUpdate === true ||
+    resolved.allow_audit_update === true ||
+    resolved.allowAuditDepUpdate === true ||
+    resolved.allow_audit_dep_update === true
   );
-}
+};
+
+const resolveLinkedArtifactAuditKey = (
+  payload: CommandResultPayload,
+): "files" | "docs" | undefined => {
+  /** Resolve the supported linked-artifact result key for an eligible audit request. */
+  const artifactKey = (["files", "docs"] as const).find(
+    (candidate) => candidate === payload.command,
+  );
+  if (artifactKey === undefined) return undefined;
+  if (payload.options?.audit !== true) return undefined;
+  if (!payload.pm_root) return undefined;
+  return artifactKey;
+};
 
-async function decorateLinkedArtifactResult(
+const decorateLinkedArtifactResult = async (
   payload: CommandResultPayload,
   result: Record<string, unknown>,
-): Promise<Record<string, unknown> | undefined> {
-  if (
-    (payload.command !== "files" && payload.command !== "docs") ||
-    payload.options?.audit !== true ||
-    !payload.pm_root
-  ) {
-    return undefined;
-  }
-  const artifactKey = payload.command;
+): Promise<Record<string, unknown> | undefined> => {
+  /** Add reverse linked-artifact attribution to eligible files/docs results. */
+  const artifactKey = resolveLinkedArtifactAuditKey(payload);
+  if (artifactKey === undefined) return undefined;
   const artifacts = Array.isArray(result[artifactKey])
-    ? (result[artifactKey] as Array<{ path?: unknown }>)
+    ? result[artifactKey]
     : [];
-  const paths = artifacts.flatMap((entry) =>
-    typeof entry.path === "string" ? [entry.path] : [],
-  );
+  const paths = artifacts.flatMap((entry) => {
+    const artifact = asRecord(entry);
+    return typeof artifact?.path === "string" ? [artifact.path] : [];
+  });
   const listed = await new PmClient({ pmRoot: payload.pm_root }).list({
     status: "all",
     noTruncate: true,
     fields: `id,${artifactKey}`,
   });
-  const items = listed.items.map((item) => ({
-    id: item.id,
-    artifacts: Array.isArray(item[artifactKey])
-      ? (item[artifactKey] as Array<{ path: string }>)
-      : undefined,
-  }));
+  const items = listed.items.flatMap((item) =>
+    typeof item.id === "string"
+      ? [
+          {
+            id: item.id,
+            artifacts: Array.isArray(item[artifactKey])
+              ? item[artifactKey].flatMap((entry) => {
+                  const artifact = asRecord(entry);
+                  return typeof artifact?.path === "string"
+                    ? [{ path: artifact.path }]
+                    : [];
+                })
+              : undefined,
+          },
+        ]
+      : [],
+  );
   return {
     ...result,
     audit: buildLinkedArtifactAudit({ paths, items }),
   };
-}
+};
+
+const decorateUpdateAuditBypassResult = (
+  payload: CommandResultPayload,
+  result: Record<string, unknown>,
+): Record<string, unknown> | undefined => {
+  /** Add the package-owned audit marker for an explicit update bypass. */
+  const isUpdate = ["update", "update-many"].includes(String(payload.command));
+  if (isUpdate && hasUpdateAuditBypass(payload.options)) {
+    return { ...result, audit_update: true };
+  }
+  return undefined;
+};
+
+const decorateReleaseAuditBypassResult = (
+  payload: CommandResultPayload,
+  result: Record<string, unknown>,
+): Record<string, unknown> | undefined => {
+  /** Add the package-owned audit marker for an explicit release bypass. */
+  if (
+    payload.command === "release" &&
+    payload.options?.allowAuditRelease === true
+  ) {
+    return { ...result, audit_release: true };
+  }
+  return undefined;
+};
 
 /** Add package-owned fields to a completed core command result. */
-export async function decorateGovernanceCommandResult(
+export const decorateGovernanceCommandResult = async (
   raw: unknown,
-): Promise<unknown> {
+): Promise<unknown> => {
   const payload = asRecord(raw) as CommandResultPayload | undefined;
-  const result = asRecord(payload?.result);
-  const options = payload?.options ?? {};
-  if (!payload || !result) return payload?.result;
+  if (!payload) return undefined;
+  const result = asRecord(payload.result);
+  if (!result) return payload.result;
   const linkedArtifactResult = await decorateLinkedArtifactResult(
     payload,
     result,
   );
   if (linkedArtifactResult) return linkedArtifactResult;
-
-  if (
-    (payload.command === "update" || payload.command === "update-many") &&
-    hasUpdateAuditBypass(options)
-  ) {
-    return { ...result, audit_update: true };
-  }
-
-  if (payload.command === "release" && options.allowAuditRelease === true) {
-    return { ...result, audit_release: true };
-  }
-
-  return result;
-}
+  const bypassResult = [
+    decorateUpdateAuditBypassResult(payload, result),
+    decorateReleaseAuditBypassResult(payload, result),
+  ].find((candidate) => candidate !== undefined);
+  return bypassResult ?? result;
+};

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

@@ -6,16 +6,63 @@
  */
 import path from "node:path";
 import { pathToFileURL } from "node:url";
-import type * as RuntimeSdk from "@unbrained/pm-cli/sdk/runtime";
+import type {
+  EXIT_CODE as RuntimeExitCode,
+  PmCliError as RuntimePmCliError,
+  PmClient as RuntimePmClient,
+  getActiveExtensionRegistrations as runtimeGetActiveExtensionRegistrations,
+  getSettingsPath as runtimeGetSettingsPath,
+  isTerminalStatus as runtimeIsTerminalStatus,
+  locateItem as runtimeLocateItem,
+  normalizeStatusInput as runtimeNormalizeStatusInput,
+  nowIso as runtimeNowIso,
+  pathExists as runtimePathExists,
+  readBooleanOption as runtimeReadBooleanOption,
+  readCsvListOption as runtimeReadCsvListOption,
+  readLocatedItem as runtimeReadLocatedItem,
+  readSettings as runtimeReadSettings,
+  readStringOption as runtimeReadStringOption,
+  resolveItemTypeRegistry as runtimeResolveItemTypeRegistry,
+  resolvePmRoot as runtimeResolvePmRoot,
+  resolveRuntimeStatusRegistry as runtimeResolveRuntimeStatusRegistry,
+  runClose as runtimeRunClose,
+  runList as runtimeRunList,
+  runUpdate as runtimeRunUpdate,
+} from "@unbrained/pm-cli/sdk/runtime";
+
+/** Typed host-runtime values consumed through the package's dynamic boundary. */
+interface RuntimeSdkModule {
+  EXIT_CODE: typeof RuntimeExitCode;
+  PmCliError: typeof RuntimePmCliError;
+  PmClient: typeof RuntimePmClient;
+  getActiveExtensionRegistrations: typeof runtimeGetActiveExtensionRegistrations;
+  getSettingsPath: typeof runtimeGetSettingsPath;
+  isTerminalStatus: typeof runtimeIsTerminalStatus;
+  locateItem: typeof runtimeLocateItem;
+  normalizeStatusInput: typeof runtimeNormalizeStatusInput;
+  nowIso: typeof runtimeNowIso;
+  pathExists: typeof runtimePathExists;
+  readBooleanOption: typeof runtimeReadBooleanOption;
+  readCsvListOption: typeof runtimeReadCsvListOption;
+  readLocatedItem: typeof runtimeReadLocatedItem;
+  readSettings: typeof runtimeReadSettings;
+  readStringOption: typeof runtimeReadStringOption;
+  resolveItemTypeRegistry: typeof runtimeResolveItemTypeRegistry;
+  resolvePmRoot: typeof runtimeResolvePmRoot;
+  resolveRuntimeStatusRegistry: typeof runtimeResolveRuntimeStatusRegistry;
+  runClose: typeof runtimeRunClose;
+  runList: typeof runtimeRunList;
+  runUpdate: typeof runtimeRunUpdate;
+}
 
 const packageRoot = process.env.PM_CLI_PACKAGE_ROOT?.trim();
-let loadedRuntime: typeof RuntimeSdk;
+let loadedRuntime: RuntimeSdkModule;
 /* c8 ignore start -- copied installs exercise PM_CLI_PACKAGE_ROOT in subprocess integration coverage. */
 try {
   if (packageRoot) {
     loadedRuntime = (await import(
       pathToFileURL(path.join(packageRoot, "dist", "sdk", "runtime.js")).href
-    )) as typeof RuntimeSdk;
+    )) as RuntimeSdkModule;
   } else {
     loadedRuntime = await import("@unbrained/pm-cli/sdk/runtime");
   }
@@ -50,10 +97,12 @@ export const {
   resolvePmRoot,
   resolveRuntimeStatusRegistry,
   runClose,
-  runList,
   runUpdate,
 } = runtime;
 
+/** Preserve the host SDK list overloads across the dynamic runtime boundary. */
+export const runList: typeof runtimeRunList = runtime.runList;
+
 /** Runtime status registry inferred from the host SDK's schema resolver. */
 export type RuntimeStatusRegistry = ReturnType<
   typeof resolveRuntimeStatusRegistry

package/packages/pm-governance-audit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-governance-audit",
-  "version": "2026.7.16",
+  "version": "2026.7.17",
   "private": true,
   "type": "module",
   "description": "First-party pm package for governance audit and normalization workflows.",

package/packages/pm-guide-shell/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-guide-shell",
-  "version": "2026.7.16",
+  "version": "2026.7.17",
   "private": true,
   "type": "module",
   "description": "First-party pm package for guide and shell completion workflows.",

package/packages/pm-kanban/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-kanban",
-  "version": "2026.7.16",
+  "version": "2026.7.17",
   "private": true,
   "type": "module",
   "description": "First-party pm archetype package: a complete Kanban continuous-flow profile built on public SDK primitives.",

package/packages/pm-lifecycle-hooks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-lifecycle-hooks",
-  "version": "2026.7.16",
+  "version": "2026.7.17",
   "private": true,
   "type": "module",
   "description": "First-party pm package demonstrating safe lifecycle hook registration.",

package/packages/pm-linked-test-adapters/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-linked-test-adapters",
-  "version": "2026.7.16",
+  "version": "2026.7.17",
   "private": true,
   "type": "module",
   "description": "First-party pm package for optional linked-test run management adapters and reporters.",

package/packages/pm-search-advanced/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-search-advanced",
-  "version": "2026.7.16",
+  "version": "2026.7.17",
   "private": true,
   "type": "module",
   "description": "First-party pm package for semantic, hybrid, and reindex search workflows.",

package/packages/pm-templates/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-templates",
-  "version": "2026.7.16",
+  "version": "2026.7.17",
   "private": true,
   "type": "module",
   "description": "First-party pm package for reusable create templates.",

package/packages/pm-todos/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unbrained/pm-todos",
-  "version": "2026.7.16",
+  "version": "2026.7.17",
   "private": true,
   "type": "module",
   "description": "First-party pm package for Todo markdown import and export.",

package/plugins/pm-claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pm-claude",
   "description": "Native pm CLI integration for Claude Code — 28 MCP tools, 5 workflow skills, 14 slash commands, 4 subagents (coordinator, delivery-chain, triage, verification), hybrid TUI task tracking (pm as persistent store + Claude Code task panel as live view), session context injection, and full git-based project management without leaving Claude Code.",
-  "version": "2026.7.16",
+  "version": "2026.7.17",
   "author": {
     "name": "unbrained",
     "url": "https://github.com/unbraind/pm-cli"

package/plugins/pm-codex/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pm-codex",
-  "version": "2026.7.16",
+  "version": "2026.7.17",
   "description": "Native Codex integration for pm-cli with bundled MCP tools, skills, commands, and agent workflows.",
   "author": {
     "name": "unbrained",

package/dist/cli/commands/item-filter-options.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"item-filter-options.js","sources":["cli/commands/item-filter-options.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/item-filter-options\n *\n * Shared item-filter option contracts used by command implementations and SDK-facing types.\n */\n\n/** Common scalar item filters accepted by list/search-style commands. */\nexport interface SharedItemScalarFilterOptions {\n  /** Lifecycle state reported for status. */\n  status?: string;\n  /** Schema type that determines the shape and validation rules for this value. */\n  type?: string;\n  /** Value that configures or reports tag for this contract. */\n  tag?: string;\n  /** Value that configures or reports priority for this contract. */\n  priority?: string;\n  /** Value that configures or reports deadline before for this contract. */\n  deadlineBefore?: string;\n  /** Value that configures or reports deadline after for this contract. */\n  deadlineAfter?: string;\n  /** Value that configures or reports updated after for this contract. */\n  updatedAfter?: string;\n  /** Value that configures or reports updated before for this contract. */\n  updatedBefore?: string;\n  /** Value that configures or reports created after for this contract. */\n  createdAfter?: string;\n  /** Value that configures or reports created before for this contract. */\n  createdBefore?: string;\n  /** Value that configures or reports assignee for this contract. */\n  assignee?: string;\n  /** Value that configures or reports parent for this contract. */\n  parent?: string;\n  /** Value that configures or reports sprint for this contract. */\n  sprint?: string;\n  /** Value that configures or reports release for this contract. */\n  release?: string;\n}\n\n/** Common governance-metadata presence filters accepted by item query commands. */\nexport interface SharedGovernanceMissingFilterOptions {\n  /** Value that configures or reports filter reviewer missing for this contract. */\n  filterReviewerMissing?: boolean;\n  /** Value that configures or reports filter risk missing for this contract. */\n  filterRiskMissing?: boolean;\n  /** Value that configures or reports filter confidence missing for this contract. */\n  filterConfidenceMissing?: boolean;\n  /** Value that configures or reports filter sprint missing for this contract. */\n  filterSprintMissing?: boolean;\n  /** Value that configures or reports filter release missing for this contract. */\n  filterReleaseMissing?: boolean;\n}\n\n/** Common content-field presence filters accepted by item query commands. */\nexport interface SharedContentFieldFilterOptions {\n  /** Whether notes applies to this operation. */\n  hasNotes?: boolean;\n  /** Whether learnings applies to this operation. */\n  hasLearnings?: boolean;\n  /** Whether files applies to this operation. */\n  hasFiles?: boolean;\n  /** Whether docs applies to this operation. */\n  hasDocs?: boolean;\n  /** Whether tests applies to this operation. */\n  hasTests?: boolean;\n  /** Whether comments applies to this operation. */\n  hasComments?: boolean;\n  /** Whether deps applies to this operation. */\n  hasDeps?: boolean;\n  /** Whether body applies to this operation. */\n  hasBody?: boolean;\n  /** Whether linked command applies to this operation. */\n  hasLinkedCommand?: boolean;\n  /** Value that configures or reports no notes for this contract. */\n  noNotes?: boolean;\n  /** Value that configures or reports no learnings for this contract. */\n  noLearnings?: boolean;\n  /** Value that configures or reports no files for this contract. */\n  noFiles?: boolean;\n  /** Value that configures or reports filter files missing for this contract. */\n  filterFilesMissing?: boolean;\n  /** Value that configures or reports no docs for this contract. */\n  noDocs?: boolean;\n  /** Value that configures or reports filter docs missing for this contract. */\n  filterDocsMissing?: boolean;\n  /** Value that configures or reports no tests for this contract. */\n  noTests?: boolean;\n  /** Value that configures or reports no comments for this contract. */\n  noComments?: boolean;\n  /** Value that configures or reports no deps for this contract. */\n  noDeps?: boolean;\n  /** Value that configures or reports empty body for this contract. */\n  emptyBody?: boolean;\n  /** Value that configures or reports no linked command for this contract. */\n  noLinkedCommand?: boolean;\n}\n\n/** Base option shape for item query commands with schema/runtime extension flags. */\nexport interface SharedItemFilterOptions\n  extends\n    SharedItemScalarFilterOptions,\n    SharedGovernanceMissingFilterOptions,\n    SharedContentFieldFilterOptions {\n  [key: string]: unknown;\n}\n"],"names":[],"mappings":"AAAA;;;;GAIG","debugId":"e9715bcc-aec2-557d-8ccd-13d3d0262792"}

package/dist/cli/commands/search-pagination.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"search-pagination.js","sources":["cli/commands/search-pagination.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/search-pagination\n *\n * Applies the shared SDK cursor contract to ranked search results.\n */\nimport {\n  createQueryFingerprint,\n  paginateQueryRows,\n} from \"../../sdk/pagination.js\";\nimport type { SearchHit, SearchOptions } from \"./search.js\";\nimport type { SearchMode } from \"./search-rendering.js\";\n\n/** Build the query-only fingerprint shared by search retrieval and paging. */\nexport function createSearchCursorFingerprint(options: {\n  query: string;\n  mode: SearchMode;\n  searchOptions: SearchOptions;\n}): string {\n  const normalizedOptions: Record<string, unknown> = {\n    ...options.searchOptions,\n  };\n  delete normalizedOptions.after;\n  delete normalizedOptions.limit;\n  delete normalizedOptions.compact;\n  delete normalizedOptions.full;\n  delete normalizedOptions.fields;\n  delete normalizedOptions.highlight;\n  delete normalizedOptions.format;\n  return createQueryFingerprint(\"search\", {\n    query: options.query.trim(),\n    mode: options.mode,\n    options: normalizedOptions,\n  });\n}\n\n/** Page ranked search hits without coupling cursor mechanics to search scoring. */\nexport function resolveSearchPage(options: {\n  sorted: SearchHit[];\n  query: string;\n  mode: SearchMode;\n  searchOptions: SearchOptions;\n  limit: number;\n}): {\n  limited: SearchHit[];\n  pageExtras: {\n    has_more?: boolean;\n    next_cursor?: string;\n    applied_limit: number;\n    truncated?: true;\n  };\n} {\n  const page = paginateQueryRows(options.sorted, {\n    cursor: options.searchOptions.after,\n    fingerprint: createSearchCursorFingerprint(options),\n    limit: options.limit,\n    readId: (hit) => hit.item.id,\n  });\n  return {\n    limited: page.rows,\n    pageExtras: {\n      applied_limit: options.limit,\n      ...(page.has_more ? { has_more: true, truncated: true } : {}),\n      ...(page.next_cursor ? { next_cursor: page.next_cursor } : {}),\n    },\n  };\n}\n"],"names":[],"mappings":"AAAA;;;;GAIG;;;AACH,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC;AAIjC,8EAA8E;AAC9E,MAAM,UAAU,6BAA6B,CAAC,OAI7C;IACC,MAAM,iBAAiB,GAA4B;QACjD,GAAG,OAAO,CAAC,aAAa;KACzB,CAAC;IACF,OAAO,iBAAiB,CAAC,KAAK,CAAC;IAC/B,OAAO,iBAAiB,CAAC,KAAK,CAAC;IAC/B,OAAO,iBAAiB,CAAC,OAAO,CAAC;IACjC,OAAO,iBAAiB,CAAC,IAAI,CAAC;IAC9B,OAAO,iBAAiB,CAAC,MAAM,CAAC;IAChC,OAAO,iBAAiB,CAAC,SAAS,CAAC;IACnC,OAAO,iBAAiB,CAAC,MAAM,CAAC;IAChC,OAAO,sBAAsB,CAAC,QAAQ,EAAE;QACtC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE;QAC3B,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,iBAAiB;KAC3B,CAAC,CAAC;AACL,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,OAMjC;IASC,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,EAAE;QAC7C,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,KAAK;QACnC,WAAW,EAAE,6BAA6B,CAAC,OAAO,CAAC;QACnD,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;KAC7B,CAAC,CAAC;IACH,OAAO;QACL,OAAO,EAAE,IAAI,CAAC,IAAI;QAClB,UAAU,EAAE;YACV,aAAa,EAAE,OAAO,CAAC,KAAK;YAC5B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/D;KACF,CAAC;AACJ,CAAC","debugId":"39599b41-97b7-53e2-9318-db5e3724bf2e"}

package/dist/cli/commands/search-rendering.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"search-rendering.js","sources":["cli/commands/search-rendering.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/search-rendering\n *\n * Builds stable compact and verbose filter projections for search responses.\n */\nimport {\n  applyFilterValueEcho,\n  buildContentFilterEcho,\n  buildGovernanceMissingFilterEcho,\n} from \"./list.js\";\nimport type { SearchMatchMode, SearchOptions } from \"./search.js\";\n\n/** Search execution modes represented in response metadata. */\nexport type SearchMode = \"keyword\" | \"semantic\" | \"hybrid\";\n\ninterface SearchRenderingQueryExpansion {\n  enabled: boolean;\n  provider: string | null;\n}\n\ninterface SearchRenderingRerank {\n  enabled: boolean;\n  model: string;\n  top_k: number;\n}\n\nfunction isAllStatuses(value: unknown): boolean {\n  if (typeof value !== \"string\") return false;\n  const tokens = value\n    .split(\",\")\n    .map((entry) => entry.trim().toLowerCase())\n    .filter(Boolean);\n  return tokens.length === 1 && tokens[0] === \"all\";\n}\n\nconst COMPACT_SEARCH_VALUE_FILTER_ECHO_ENTRIES = [\n  {\n    optionKey: \"status\",\n    summaryKey: \"status\",\n    normalize: (value: unknown) => (isAllStatuses(value) ? \"all\" : value),\n  },\n  { optionKey: \"type\", summaryKey: \"type\" },\n  { optionKey: \"tag\", summaryKey: \"tag\" },\n  { optionKey: \"priority\", summaryKey: \"priority\" },\n  { optionKey: \"deadlineBefore\", summaryKey: \"deadline_before\" },\n  { optionKey: \"deadlineAfter\", summaryKey: \"deadline_after\" },\n  { optionKey: \"updatedAfter\", summaryKey: \"updated_after\" },\n  { optionKey: \"updatedBefore\", summaryKey: \"updated_before\" },\n  { optionKey: \"createdAfter\", summaryKey: \"created_after\" },\n  { optionKey: \"createdBefore\", summaryKey: \"created_before\" },\n  { optionKey: \"assignee\", summaryKey: \"assignee\" },\n  { optionKey: \"sprint\", summaryKey: \"sprint\" },\n  { optionKey: \"release\", summaryKey: \"release\" },\n  { optionKey: \"parent\", summaryKey: \"parent\" },\n] as const;\n\n/** Builds the token-efficient filter echo used by compact search results. */\nexport function buildCompactSearchFilterSummary(params: {\n  mode: SearchMode;\n  matchMode: SearchMatchMode;\n  options: SearchOptions;\n  includeLinked: boolean;\n  titleExact: boolean;\n  phraseExact: boolean;\n  scoreThreshold: number;\n  hybridSemanticWeight: number;\n  runtimeFieldFilters?: Record<string, unknown>;\n}): Record<string, unknown> {\n  const { mode, matchMode, options, includeLinked, titleExact, phraseExact, scoreThreshold, hybridSemanticWeight, runtimeFieldFilters } = params;\n  const filters: Record<string, unknown> = {};\n  applyFilterValueEcho(filters, options, COMPACT_SEARCH_VALUE_FILTER_ECHO_ENTRIES);\n  Object.assign(filters, buildGovernanceMissingFilterEcho(options as Record<string, unknown>));\n  Object.assign(filters, buildContentFilterEcho(options as Record<string, unknown>));\n  if (matchMode !== \"or\") filters.match_mode = matchMode;\n  if (includeLinked) filters.include_linked = true;\n  if (titleExact) filters.title_exact = true;\n  if (phraseExact) filters.phrase_exact = true;\n  if (scoreThreshold > 0) filters.score_threshold = scoreThreshold;\n  if (mode === \"hybrid\" && options.semanticWeight !== undefined) {\n    filters.hybrid_semantic_weight = hybridSemanticWeight;\n  }\n  if (options.limit !== undefined) filters.limit = options.limit;\n  if (runtimeFieldFilters && Object.keys(runtimeFieldFilters).length > 0) {\n    filters.runtime_filters = runtimeFieldFilters;\n  }\n  return filters;\n}\n\n/** Builds the complete filter echo shared by verbose search response paths. */\nexport function buildVerboseSearchFilters(params: {\n  effectiveMode: SearchMode;\n  matchMode: SearchMatchMode;\n  options: SearchOptions;\n  includeLinked: boolean;\n  titleExact: boolean;\n  phraseExact: boolean;\n  scoreThreshold: number;\n  hybridSemanticWeight: number;\n  queryExpansion: SearchRenderingQueryExpansion;\n  rerank: SearchRenderingRerank;\n  runtimeFieldFilters: Record<string, unknown>;\n}): Record<string, unknown> {\n  const { effectiveMode, matchMode, options, includeLinked, titleExact, phraseExact, scoreThreshold, hybridSemanticWeight, queryExpansion, rerank, runtimeFieldFilters } = params;\n  const valueOrNull = (value: unknown): unknown => value ?? null;\n  return {\n    mode: effectiveMode,\n    match_mode: matchMode,\n    status: isAllStatuses(options.status) ? \"all\" : valueOrNull(options.status),\n    type: valueOrNull(options.type),\n    tag: valueOrNull(options.tag),\n    priority: valueOrNull(options.priority),\n    deadline_before: valueOrNull(options.deadlineBefore),\n    deadline_after: valueOrNull(options.deadlineAfter),\n    updated_after: valueOrNull(options.updatedAfter),\n    updated_before: valueOrNull(options.updatedBefore),\n    created_after: valueOrNull(options.createdAfter),\n    created_before: valueOrNull(options.createdBefore),\n    assignee: valueOrNull(options.assignee),\n    sprint: valueOrNull(options.sprint),\n    release: valueOrNull(options.release),\n    parent: valueOrNull(options.parent),\n    ...buildGovernanceMissingFilterEcho(options as Record<string, unknown>),\n    ...buildContentFilterEcho(options as Record<string, unknown>),\n    include_linked: includeLinked,\n    title_exact: titleExact,\n    phrase_exact: phraseExact,\n    score_threshold: scoreThreshold,\n    hybrid_semantic_weight: effectiveMode === \"hybrid\" ? hybridSemanticWeight : null,\n    query_expansion_enabled: queryExpansion.enabled,\n    query_expansion_provider: queryExpansion.provider,\n    rerank_enabled: rerank.enabled,\n    rerank_model: rerank.model,\n    rerank_top_k: rerank.top_k,\n    limit: valueOrNull(options.limit),\n    runtime_filters: runtimeFieldFilters,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"4445c28d-0c05-583a-8b92-9dbe60e8b467"}

package/dist/cli-bundle/chunks/append-UZVHUO74.js

@@ -1,11 +0,0 @@
-import {
-  runAppend
-} from "./chunk-AHVTB5I5.js";
-import "./chunk-YRYYFGV3.js";
-import "./chunk-TKOVBP6C.js";
-import "./chunk-XSJUSQAE.js";
-import "./chunk-BSEQUTQP.js";
-export {
-  runAppend
-};
-//# sourceMappingURL=append-UZVHUO74.js.map