@unbrained/pm-cli 2026.7.16 → 2026.7.18

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.18",
   "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.18",
   "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.18",
   "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.18",
   "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.18",
   "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.18",
   "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.18",
   "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.18",
   "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.18",
   "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.18",
   "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

package/dist/cli-bundle/chunks/chunk-2NCIPMQP.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../../../../../../../core/item/actionability.ts"],"sourcesContent":["/**\n * @module core/item/actionability\n *\n * Pure, dependency-aware actionability model shared by the `pm next` command and\n * the close-time auto-unblock sweep. It answers \"what is ready to work on now?\"\n * without any I/O: given a candidate set and the surrounding corpus it partitions\n * work into READY items (active, leaf, no open blockers) and BLOCKED items (active\n * leaf waiting on at least one open blocker). Keeping the logic here — rather than\n * inside a CLI command — makes it trivially testable and reusable, and gives the\n * `blocked_by` resolution a single source of truth.\n */\nimport { isTerminalStatus, normalizeStatusForRegistry } from \"./status.js\";\nimport type { RuntimeStatusRegistry } from \"../schema/runtime-schema.js\";\nimport type { ItemMetadata, ItemStatus } from \"../../types/index.js\";\n\n/** Dependency kind that marks \"this item is blocked by the referenced item\". */\nconst BLOCKED_BY_DEPENDENCY_KIND = \"blocked_by\";\n\n/**\n * Normalizes an item id / parent reference / blocker id to its canonical\n * comparison key (trimmed, lowercased). pm ids are canonically lowercase, but\n * resolving case-insensitively — as {@link collectSubtreeIds} does — keeps a\n * hand-edited mixed-case reference from being silently treated as missing.\n */\nfunction normalizeItemId(id: string): string {\n  return id.trim().toLowerCase();\n}\n\n/** Collects the blocker item ids declared by an item: the legacy scalar `blocked_by` field plus every `blocked_by` dependency edge. Ids are trimmed, de-duplicated, and returned in stable lexicographic order. This is the single source of truth for \"what must close before this item can proceed\", shared by `pm next` readiness classification and the close-time auto-unblock sweep. */\nexport function collectBlockedByIds(\n  item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\">,\n): string[] {\n  const ids = new Set<string>();\n  const scalar =\n    typeof item.blocked_by === \"string\" ? item.blocked_by.trim() : \"\";\n  if (scalar.length > 0) {\n    ids.add(scalar);\n  }\n  for (const dependency of item.dependencies ?? []) {\n    if (\n      dependency.kind === BLOCKED_BY_DEPENDENCY_KIND &&\n      typeof dependency.id === \"string\" &&\n      dependency.id.trim().length > 0\n    ) {\n      ids.add(dependency.id.trim());\n    }\n  }\n  return [...ids].sort((left, right) => left.localeCompare(right));\n}\n\n/** A blocker reference resolved against the corpus and annotated with its state. */\nexport interface ResolvedBlocker {\n  /** Stable identifier used to reference this record across commands and storage. */\n  id: string;\n  /** Value that configures or reports title for this contract. */\n  title: string | null;\n  /** Lifecycle state reported for status. */\n  status: ItemStatus | null;\n  /** True when the blocker no longer gates work because the referenced item is terminal. */\n  resolved: boolean;\n}\n\n/** Resolves an item's declared blockers against a corpus index, annotating each with the blocker's title/status and whether it still gates work. Unknown ids remain unresolved: silently treating a typo as satisfied would dispatch work whose prerequisite was never completed. Terminal referenced items alone are resolved. */\nexport function resolveItemBlockers(\n  item: Pick<ItemMetadata, \"blocked_by\" | \"dependencies\">,\n  itemsById: Map<string, ItemMetadata>,\n  statusRegistry: RuntimeStatusRegistry,\n): ResolvedBlocker[] {\n  return collectBlockedByIds(item).map((id) => {\n    const blocker = itemsById.get(normalizeItemId(id));\n    if (!blocker) {\n      return { id, title: null, status: null, resolved: false };\n    }\n    return {\n      id,\n      title: blocker.title,\n      status: blocker.status,\n      resolved: isTerminalStatus(blocker.status, statusRegistry),\n    };\n  });\n}\n\n/** A classified actionable item plus the context an agent needs to act on it. */\nexport interface ActionableEntry {\n  /** Value that configures or reports item for this contract. */\n  item: ItemMetadata;\n  /** Blockers that still gate the item (resolved blockers are filtered out). */\n  open_blockers: ResolvedBlocker[];\n  /** Ids of non-terminal items whose `blocked_by` points at this item. */\n  unblocks: string[];\n}\n\n/** Result of partitioning a candidate set into ready vs blocked leaf work. */\nexport interface ActionabilityReport {\n  /** Active leaves with no open blockers — ready to work on now. */\n  ready: ActionableEntry[];\n  /** Active leaves with at least one open blocker — waiting to become ready. */\n  blocked: ActionableEntry[];\n  /** Active candidates considered before the leaf/blocker split. */\n  active_count: number;\n  /** Active candidates skipped because they still have open descendants. */\n  container_count: number;\n}\n\n/** Resolves the registry's active status set, falling back to just the canonical open status when a custom schema declares none — the same safety net `pm context` applies so the report never misclassifies every item as inactive. */\nfunction resolveActiveStatusSet(\n  statusRegistry: RuntimeStatusRegistry,\n): Set<string> {\n  /* c8 ignore start -- fallback applies only to custom schemas that intentionally define zero active statuses */\n  return statusRegistry.active_statuses.size > 0\n    ? statusRegistry.active_statuses\n    : new Set<string>([statusRegistry.open_status]);\n  /* c8 ignore stop */\n}\n\n/** Returns whether an item has any non-terminal descendant by walking the parent→children index depth-first, short-circuiting on the first one found. Such an item is a container (its real work lives in its children), so `pm next` skips it and recommends a leaf instead. Cycle-safe via a visited set. */\nfunction hasOpenDescendant(\n  rootId: string,\n  childrenByParent: Map<string, ItemMetadata[]>,\n  statusRegistry: RuntimeStatusRegistry,\n): boolean {\n  const stack = [normalizeItemId(rootId)];\n  const visited = new Set<string>();\n  while (stack.length > 0) {\n    const current = stack.pop() as string;\n    /* c8 ignore start -- defensive cycle-guard: unreachable for active roots (an open child returns before any node is revisited, and single-parent graphs cannot form a root-reachable cycle excluding the root), retained for safety */\n    if (visited.has(current)) continue;\n    /* c8 ignore stop */\n    visited.add(current);\n    for (const child of childrenByParent.get(current) ?? []) {\n      if (!isTerminalStatus(child.status, statusRegistry)) {\n        return true;\n      }\n      stack.push(normalizeItemId(child.id));\n    }\n  }\n  return false;\n}\n\n/** Indexes the corpus into a by-id map, a parent→children map, and a reverse blocker map (blocker id → ids of items it blocks). Built once per report so blocker resolution, descendant counting, and downstream \"unblocks\" lookups share the same passes over the corpus. */\nfunction indexCorpus(corpus: ItemMetadata[]): {\n  itemsById: Map<string, ItemMetadata>;\n  childrenByParent: Map<string, ItemMetadata[]>;\n  blockedByReverse: Map<string, string[]>;\n} {\n  const itemsById = new Map<string, ItemMetadata>();\n  const childrenByParent = new Map<string, ItemMetadata[]>();\n  const blockedByReverse = new Map<string, string[]>();\n  for (const item of corpus) {\n    // Index keys are normalized (lowercased) for case-insensitive resolution;\n    // stored values keep the item's original-case id for display.\n    itemsById.set(normalizeItemId(item.id), item);\n    const parent = typeof item.parent === \"string\" ? item.parent.trim() : \"\";\n    if (parent.length > 0) {\n      const parentKey = normalizeItemId(parent);\n      const siblings = childrenByParent.get(parentKey) ?? [];\n      siblings.push(item);\n      childrenByParent.set(parentKey, siblings);\n    }\n    for (const blockerId of collectBlockedByIds(item)) {\n      const blockerKey = normalizeItemId(blockerId);\n      const dependents = blockedByReverse.get(blockerKey) ?? [];\n      dependents.push(item.id);\n      blockedByReverse.set(blockerKey, dependents);\n    }\n  }\n  return { itemsById, childrenByParent, blockedByReverse };\n}\n\n/**\n * Partitions a candidate set into ready vs blocked leaf work using the corpus to\n * resolve blockers, descendants, and downstream dependents.\n *\n * An item qualifies when its status is active. Containers — items with at least\n * one non-terminal descendant — are excluded from both lists because the real\n * work is the leaf beneath them. A leaf with no open blockers is READY; a leaf\n * with one or more open blockers is BLOCKED, annotated with the unresolved\n * blockers and the non-terminal items it would unblock. Returned lists preserve\n * the candidate order so the caller can apply its own ranking.\n */\nexport function computeActionabilityReport(\n  candidates: ItemMetadata[],\n  corpus: ItemMetadata[],\n  statusRegistry: RuntimeStatusRegistry,\n): ActionabilityReport {\n  const { itemsById, childrenByParent, blockedByReverse } = indexCorpus(corpus);\n  const activeStatuses = new Set([\n    ...resolveActiveStatusSet(statusRegistry),\n    ...statusRegistry.blocked_statuses,\n  ]);\n  // Ids of corpus items still in flight, used to keep only the non-terminal\n  // dependents in each item's downstream \"unblocks\" list.\n  const nonTerminalIds = new Set(\n    corpus\n      .filter((entry) => !isTerminalStatus(entry.status, statusRegistry))\n      .map((entry) => normalizeItemId(entry.id)),\n  );\n  const ready: ActionableEntry[] = [];\n  const blocked: ActionableEntry[] = [];\n  let activeCount = 0;\n  let containerCount = 0;\n  for (const item of candidates) {\n    if (\n      !activeStatuses.has(\n        normalizeStatusForRegistry(item.status, statusRegistry),\n      )\n    )\n      continue;\n    activeCount += 1;\n    if (hasOpenDescendant(item.id, childrenByParent, statusRegistry)) {\n      containerCount += 1;\n      continue;\n    }\n    const openBlockers = resolveItemBlockers(\n      item,\n      itemsById,\n      statusRegistry,\n    ).filter((blocker) => !blocker.resolved);\n    const unblocks = (blockedByReverse.get(normalizeItemId(item.id)) ?? [])\n      .filter((dependentId) => nonTerminalIds.has(normalizeItemId(dependentId)))\n      .sort((left, right) => left.localeCompare(right));\n    const entry: ActionableEntry = {\n      item,\n      open_blockers: openBlockers,\n      unblocks,\n    };\n    const lifecycleBlocked = statusRegistry.blocked_statuses.has(\n      normalizeStatusForRegistry(item.status, statusRegistry),\n    );\n    if (openBlockers.length === 0 && !lifecycleBlocked) {\n      ready.push(entry);\n    } else {\n      blocked.push(entry);\n    }\n  }\n  return {\n    ready,\n    blocked,\n    active_count: activeCount,\n    container_count: containerCount,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"2fcf91f3-1b2e-5b80-a790-93055aee4f49"}