@unbrained/pm-cli 2026.7.1 → 2026.7.2

package/dist/cli/commands/recurrence-parsers.js

@@ -4,7 +4,7 @@
  * Implements the pm recurrence parsers command surface and its agent-facing runtime behavior.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="53948d99-ccdf-5f05-b75b-6885238982f1")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6a8f99fb-f5b4-5d82-986e-934fac3cfb6a")}catch(e){}}();
 import { parseOptionalNumber } from "../../core/item/parse.js";
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
@@ -73,6 +73,41 @@ export const RECURRENCE_CSV_KEYS = [
     "recur_by_month_day",
     "recur_exdates",
 ];
+function numericRecurrenceValueProvided(raw, guard) {
+    return guard === "defined" ? raw !== undefined : Boolean(raw);
+}
+function parsePositiveRecurrenceInteger(raw, label, guard) {
+    if (!numericRecurrenceValueProvided(raw, guard)) {
+        return undefined;
+    }
+    const parsed = parseOptionalNumber(raw, `event ${label}`);
+    if (!Number.isInteger(parsed) || parsed < 1) {
+        throw new PmCliError(`--event ${label} must be an integer >= 1`, EXIT_CODE.USAGE);
+    }
+    return parsed;
+}
+function parseRecurrenceUntil(untilRaw, startAt, nowValue) {
+    const until = untilRaw ? resolveIsoOrRelative(untilRaw, nowValue, "event.recur_until") : undefined;
+    if (until && until < startAt) {
+        throw new PmCliError("--event recur_until must be at or after start", EXIT_CODE.USAGE);
+    }
+    return until;
+}
+function parseRecurrenceWeekdays(raw) {
+    return Array.from(new Set(parseDelimitedList(raw).map((value) => ensureEnumValue(value.toLowerCase(), RECURRENCE_WEEKDAY_VALUES, "event weekday")))).sort((left, right) => weekdayOrderIndex(left) - weekdayOrderIndex(right));
+}
+function parseRecurrenceMonthDays(raw) {
+    return Array.from(new Set(parseDelimitedList(raw).map((value) => {
+        const day = parseOptionalNumber(value, "event recur_by_month_day");
+        if (!Number.isInteger(day) || day < 1 || day > 31) {
+            throw new PmCliError("--event recur_by_month_day values must be integers 1..31", EXIT_CODE.USAGE);
+        }
+        return day;
+    }))).sort((left, right) => left - right);
+}
+function parseRecurrenceExdates(raw, nowValue) {
+    return Array.from(new Set(parseDelimitedList(raw).map((value) => resolveIsoOrRelative(value, nowValue, "event.recur_exdates")))).sort((left, right) => left.localeCompare(right));
+}
 /**
  * Implements parse recurrence rule for the public runtime surface of this module.
  */
@@ -91,30 +126,13 @@ export function parseRecurrenceRule(kv, startAt, nowValue, emptyNumericGuard) {
     if (!freqRaw) {
         throw new PmCliError("--event recurrence fields require recur_freq=<daily|weekly|monthly|yearly>", EXIT_CODE.USAGE);
     }
-    const numericProvided = (raw) => emptyNumericGuard === "defined" ? raw !== undefined : Boolean(raw);
     const freq = ensureEnumValue(freqRaw.toLowerCase(), RECURRENCE_FREQUENCY_VALUES, "event recurrence frequency");
-    const interval = numericProvided(intervalRaw) ? parseOptionalNumber(intervalRaw, "event recur_interval") : undefined;
-    if (interval !== undefined && (!Number.isInteger(interval) || interval < 1)) {
-        throw new PmCliError("--event recur_interval must be an integer >= 1", EXIT_CODE.USAGE);
-    }
-    const count = numericProvided(countRaw) ? parseOptionalNumber(countRaw, "event recur_count") : undefined;
-    if (count !== undefined && (!Number.isInteger(count) || count < 1)) {
-        throw new PmCliError("--event recur_count must be an integer >= 1", EXIT_CODE.USAGE);
-    }
-    const until = untilRaw ? resolveIsoOrRelative(untilRaw, nowValue, "event.recur_until") : undefined;
-    if (until && until < startAt) {
-        throw new PmCliError("--event recur_until must be at or after start", EXIT_CODE.USAGE);
-    }
-    const byWeekday = Array.from(new Set(parseDelimitedList(byWeekdayRaw).map((value) => ensureEnumValue(value.toLowerCase(), RECURRENCE_WEEKDAY_VALUES, "event weekday")))).sort((left, right) => weekdayOrderIndex(left) -
-        weekdayOrderIndex(right));
-    const byMonthDay = Array.from(new Set(parseDelimitedList(byMonthDayRaw).map((value) => {
-        const day = parseOptionalNumber(value, "event recur_by_month_day");
-        if (!Number.isInteger(day) || day < 1 || day > 31) {
-            throw new PmCliError("--event recur_by_month_day values must be integers 1..31", EXIT_CODE.USAGE);
-        }
-        return day;
-    }))).sort((left, right) => left - right);
-    const exdates = Array.from(new Set(parseDelimitedList(exdatesRaw).map((value) => resolveIsoOrRelative(value, nowValue, "event.recur_exdates")))).sort((left, right) => left.localeCompare(right));
+    const interval = parsePositiveRecurrenceInteger(intervalRaw, "recur_interval", emptyNumericGuard);
+    const count = parsePositiveRecurrenceInteger(countRaw, "recur_count", emptyNumericGuard);
+    const until = parseRecurrenceUntil(untilRaw, startAt, nowValue);
+    const byWeekday = parseRecurrenceWeekdays(byWeekdayRaw);
+    const byMonthDay = parseRecurrenceMonthDays(byMonthDayRaw);
+    const exdates = parseRecurrenceExdates(exdatesRaw, nowValue);
     return {
         freq,
         interval,
@@ -126,4 +144,4 @@ export function parseRecurrenceRule(kv, startAt, nowValue, emptyNumericGuard) {
     };
 }
 //# sourceMappingURL=recurrence-parsers.js.map
-//# debugId=53948d99-ccdf-5f05-b75b-6885238982f1
+//# debugId=6a8f99fb-f5b4-5d82-986e-934fac3cfb6a

package/dist/cli/commands/recurrence-parsers.js.map

@@ -1 +1 @@
-{"version":3,"file":"recurrence-parsers.js","sources":["cli/commands/recurrence-parsers.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/recurrence-parsers\n *\n * Implements the pm recurrence parsers command surface and its agent-facing runtime behavior.\n */\nimport { parseOptionalNumber } from \"../../core/item/parse.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolveIsoOrRelative } from \"../../core/shared/time.js\";\nimport {\n  RECURRENCE_FREQUENCY_VALUES,\n  RECURRENCE_WEEKDAY_VALUES,\n  weekdayOrderIndex,\n} from \"../../types/index.js\";\nimport type { RecurrenceRule } from \"../../types/index.js\";\n\n/**\n * Shared calendar recurrence/event parsing helpers used by the `create` and\n * `update` commands. Extracted verbatim from create.ts and update.ts (pm-why9).\n *\n * `parseEventBoolean`, `parseDelimitedList`, and `ensureEnumValue` were\n * byte-identical between the two commands (update spelled `ensureEnumValue` as\n * `ensureEnum`).\n *\n * `parseRecurrenceRule` was identical apart from the recur_interval/recur_count\n * \"provided\" guard: create used `intervalRaw !== undefined` (an empty\n * `recur_interval=` is parsed and rejected), while update used the truthy\n * `intervalRaw ?` (an empty value is skipped). That distinction is preserved\n * via the `emptyNumericGuard` option so both call sites keep their exact\n * behaviour, including error strings.\n */\n\nexport function parseEventBoolean(value: string, flag: string): boolean {\n  const normalized = value.trim().toLowerCase();\n  if (normalized === \"true\" || normalized === \"1\" || normalized === \"yes\") {\n    return true;\n  }\n  if (normalized === \"false\" || normalized === \"0\" || normalized === \"no\") {\n    return false;\n  }\n  throw new PmCliError(`${flag} must be one of true|false|1|0|yes|no`, EXIT_CODE.USAGE);\n}\n\n/**\n * Implements parse delimited list for the public runtime surface of this module.\n */\nexport function parseDelimitedList(raw: string | undefined): string[] {\n  if (!raw) {\n    return [];\n  }\n  return raw\n    .split(\"|\")\n    .map((value) => value.trim())\n    .filter((value) => value.length > 0);\n}\n\n/**\n * Implements ensure enum value for the public runtime surface of this module.\n */\nexport function ensureEnumValue<T extends string>(value: string, allowed: readonly T[], label: string): T {\n  if (!allowed.includes(value as T)) {\n    throw new PmCliError(`Invalid ${label} value \"${value}\". Allowed: ${allowed.join(\", \")}`, EXIT_CODE.USAGE);\n  }\n  return value as T;\n}\n\n/**\n * `\"defined\"` parses `recur_interval=`/`recur_count=` (empty values), matching\n * the historical `create` behaviour. `\"truthy\"` skips empty values, matching\n * the historical `update` behaviour.\n */\nexport type RecurrenceEmptyNumericGuard = \"defined\" | \"truthy\";\n\n/**\n * Authoritative list of the CSV/markdown recurrence keys this parser reads.\n * Co-located with {@link parseRecurrenceRule} so adding a recurrence field\n * updates the reads AND the strict unknown-key allow-list in one place — the\n * `--event` validator (repeatable-metadata-parsers EVENT_KEYS) spreads this, so\n * a new recur key can never be silently rejected (GH-258). Keep in sync with\n * the `kv.recur_*` reads below.\n */\nexport const RECURRENCE_CSV_KEYS = [\n  \"recur_freq\",\n  \"recur_interval\",\n  \"recur_count\",\n  \"recur_until\",\n  \"recur_by_weekday\",\n  \"recur_by_month_day\",\n  \"recur_exdates\",\n] as const;\n\n/**\n * Implements parse recurrence rule for the public runtime surface of this module.\n */\nexport function parseRecurrenceRule(\n  kv: Record<string, string>,\n  startAt: string,\n  nowValue: Date,\n  emptyNumericGuard: RecurrenceEmptyNumericGuard,\n): RecurrenceRule | undefined {\n  const freqRaw = kv.recur_freq?.trim();\n  const intervalRaw = kv.recur_interval?.trim();\n  const countRaw = kv.recur_count?.trim();\n  const untilRaw = kv.recur_until?.trim();\n  const byWeekdayRaw = kv.recur_by_weekday?.trim();\n  const byMonthDayRaw = kv.recur_by_month_day?.trim();\n  const exdatesRaw = kv.recur_exdates?.trim();\n\n  const recurrenceInputsProvided = [freqRaw, intervalRaw, countRaw, untilRaw, byWeekdayRaw, byMonthDayRaw, exdatesRaw].some(\n    (value) => value !== undefined,\n  );\n  if (!recurrenceInputsProvided) {\n    return undefined;\n  }\n  if (!freqRaw) {\n    throw new PmCliError(\"--event recurrence fields require recur_freq=<daily|weekly|monthly|yearly>\", EXIT_CODE.USAGE);\n  }\n\n  const numericProvided = (raw: string | undefined): boolean =>\n    emptyNumericGuard === \"defined\" ? raw !== undefined : Boolean(raw);\n\n  const freq = ensureEnumValue(freqRaw.toLowerCase(), RECURRENCE_FREQUENCY_VALUES, \"event recurrence frequency\");\n  const interval = numericProvided(intervalRaw) ? parseOptionalNumber(intervalRaw as string, \"event recur_interval\") : undefined;\n  if (interval !== undefined && (!Number.isInteger(interval) || interval < 1)) {\n    throw new PmCliError(\"--event recur_interval must be an integer >= 1\", EXIT_CODE.USAGE);\n  }\n  const count = numericProvided(countRaw) ? parseOptionalNumber(countRaw as string, \"event recur_count\") : undefined;\n  if (count !== undefined && (!Number.isInteger(count) || count < 1)) {\n    throw new PmCliError(\"--event recur_count must be an integer >= 1\", EXIT_CODE.USAGE);\n  }\n  const until = untilRaw ? resolveIsoOrRelative(untilRaw, nowValue, \"event.recur_until\") : undefined;\n  if (until && until < startAt) {\n    throw new PmCliError(\"--event recur_until must be at or after start\", EXIT_CODE.USAGE);\n  }\n\n  const byWeekday = Array.from(\n    new Set(\n      parseDelimitedList(byWeekdayRaw).map((value) => ensureEnumValue(value.toLowerCase(), RECURRENCE_WEEKDAY_VALUES, \"event weekday\")),\n    ),\n  ).sort(\n    (left, right) =>\n      weekdayOrderIndex(left as (typeof RECURRENCE_WEEKDAY_VALUES)[number]) -\n      weekdayOrderIndex(right as (typeof RECURRENCE_WEEKDAY_VALUES)[number]),\n  );\n\n  const byMonthDay = Array.from(\n    new Set(\n      parseDelimitedList(byMonthDayRaw).map((value) => {\n        const day = parseOptionalNumber(value, \"event recur_by_month_day\");\n        if (!Number.isInteger(day) || day < 1 || day > 31) {\n          throw new PmCliError(\"--event recur_by_month_day values must be integers 1..31\", EXIT_CODE.USAGE);\n        }\n        return day;\n      }),\n    ),\n  ).sort((left, right) => left - right);\n\n  const exdates = Array.from(\n    new Set(parseDelimitedList(exdatesRaw).map((value) => resolveIsoOrRelative(value, nowValue, \"event.recur_exdates\"))),\n  ).sort((left, right) => left.localeCompare(right));\n\n  return {\n    freq,\n    interval,\n    count,\n    until,\n    by_weekday: byWeekday.length > 0 ? byWeekday : undefined,\n    by_month_day: byMonthDay.length > 0 ? byMonthDay : undefined,\n    exdates: exdates.length > 0 ? exdates : undefined,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"53948d99-ccdf-5f05-b75b-6885238982f1"}
+{"version":3,"file":"recurrence-parsers.js","sources":["cli/commands/recurrence-parsers.ts"],"sourceRoot":"/","sourcesContent":["/**\n * @module cli/commands/recurrence-parsers\n *\n * Implements the pm recurrence parsers command surface and its agent-facing runtime behavior.\n */\nimport { parseOptionalNumber } from \"../../core/item/parse.js\";\nimport { EXIT_CODE } from \"../../core/shared/constants.js\";\nimport { PmCliError } from \"../../core/shared/errors.js\";\nimport { resolveIsoOrRelative } from \"../../core/shared/time.js\";\nimport {\n  RECURRENCE_FREQUENCY_VALUES,\n  RECURRENCE_WEEKDAY_VALUES,\n  weekdayOrderIndex,\n} from \"../../types/index.js\";\nimport type { RecurrenceRule } from \"../../types/index.js\";\n\n/**\n * Shared calendar recurrence/event parsing helpers used by the `create` and\n * `update` commands. Extracted verbatim from create.ts and update.ts (pm-why9).\n *\n * `parseEventBoolean`, `parseDelimitedList`, and `ensureEnumValue` were\n * byte-identical between the two commands (update spelled `ensureEnumValue` as\n * `ensureEnum`).\n *\n * `parseRecurrenceRule` was identical apart from the recur_interval/recur_count\n * \"provided\" guard: create used `intervalRaw !== undefined` (an empty\n * `recur_interval=` is parsed and rejected), while update used the truthy\n * `intervalRaw ?` (an empty value is skipped). That distinction is preserved\n * via the `emptyNumericGuard` option so both call sites keep their exact\n * behaviour, including error strings.\n */\n\nexport function parseEventBoolean(value: string, flag: string): boolean {\n  const normalized = value.trim().toLowerCase();\n  if (normalized === \"true\" || normalized === \"1\" || normalized === \"yes\") {\n    return true;\n  }\n  if (normalized === \"false\" || normalized === \"0\" || normalized === \"no\") {\n    return false;\n  }\n  throw new PmCliError(`${flag} must be one of true|false|1|0|yes|no`, EXIT_CODE.USAGE);\n}\n\n/**\n * Implements parse delimited list for the public runtime surface of this module.\n */\nexport function parseDelimitedList(raw: string | undefined): string[] {\n  if (!raw) {\n    return [];\n  }\n  return raw\n    .split(\"|\")\n    .map((value) => value.trim())\n    .filter((value) => value.length > 0);\n}\n\n/**\n * Implements ensure enum value for the public runtime surface of this module.\n */\nexport function ensureEnumValue<T extends string>(value: string, allowed: readonly T[], label: string): T {\n  if (!allowed.includes(value as T)) {\n    throw new PmCliError(`Invalid ${label} value \"${value}\". Allowed: ${allowed.join(\", \")}`, EXIT_CODE.USAGE);\n  }\n  return value as T;\n}\n\n/**\n * `\"defined\"` parses `recur_interval=`/`recur_count=` (empty values), matching\n * the historical `create` behaviour. `\"truthy\"` skips empty values, matching\n * the historical `update` behaviour.\n */\nexport type RecurrenceEmptyNumericGuard = \"defined\" | \"truthy\";\n\n/**\n * Authoritative list of the CSV/markdown recurrence keys this parser reads.\n * Co-located with {@link parseRecurrenceRule} so adding a recurrence field\n * updates the reads AND the strict unknown-key allow-list in one place — the\n * `--event` validator (repeatable-metadata-parsers EVENT_KEYS) spreads this, so\n * a new recur key can never be silently rejected (GH-258). Keep in sync with\n * the `kv.recur_*` reads below.\n */\nexport const RECURRENCE_CSV_KEYS = [\n  \"recur_freq\",\n  \"recur_interval\",\n  \"recur_count\",\n  \"recur_until\",\n  \"recur_by_weekday\",\n  \"recur_by_month_day\",\n  \"recur_exdates\",\n] as const;\n\nfunction numericRecurrenceValueProvided(raw: string | undefined, guard: RecurrenceEmptyNumericGuard): boolean {\n  return guard === \"defined\" ? raw !== undefined : Boolean(raw);\n}\n\nfunction parsePositiveRecurrenceInteger(raw: string | undefined, label: string, guard: RecurrenceEmptyNumericGuard): number | undefined {\n  if (!numericRecurrenceValueProvided(raw, guard)) {\n    return undefined;\n  }\n  const parsed = parseOptionalNumber(raw as string, `event ${label}`);\n  if (!Number.isInteger(parsed) || parsed < 1) {\n    throw new PmCliError(`--event ${label} must be an integer >= 1`, EXIT_CODE.USAGE);\n  }\n  return parsed;\n}\n\nfunction parseRecurrenceUntil(untilRaw: string | undefined, startAt: string, nowValue: Date): string | undefined {\n  const until = untilRaw ? resolveIsoOrRelative(untilRaw, nowValue, \"event.recur_until\") : undefined;\n  if (until && until < startAt) {\n    throw new PmCliError(\"--event recur_until must be at or after start\", EXIT_CODE.USAGE);\n  }\n  return until;\n}\n\nfunction parseRecurrenceWeekdays(raw: string | undefined): Array<(typeof RECURRENCE_WEEKDAY_VALUES)[number]> {\n  return Array.from(\n    new Set(\n      parseDelimitedList(raw).map((value) => ensureEnumValue(value.toLowerCase(), RECURRENCE_WEEKDAY_VALUES, \"event weekday\")),\n    ),\n  ).sort((left, right) => weekdayOrderIndex(left) - weekdayOrderIndex(right));\n}\n\nfunction parseRecurrenceMonthDays(raw: string | undefined): number[] {\n  return Array.from(\n    new Set(\n      parseDelimitedList(raw).map((value) => {\n        const day = parseOptionalNumber(value, \"event recur_by_month_day\");\n        if (!Number.isInteger(day) || day < 1 || day > 31) {\n          throw new PmCliError(\"--event recur_by_month_day values must be integers 1..31\", EXIT_CODE.USAGE);\n        }\n        return day;\n      }),\n    ),\n  ).sort((left, right) => left - right);\n}\n\nfunction parseRecurrenceExdates(raw: string | undefined, nowValue: Date): string[] {\n  return Array.from(\n    new Set(parseDelimitedList(raw).map((value) => resolveIsoOrRelative(value, nowValue, \"event.recur_exdates\"))),\n  ).sort((left, right) => left.localeCompare(right));\n}\n\n/**\n * Implements parse recurrence rule for the public runtime surface of this module.\n */\nexport function parseRecurrenceRule(\n  kv: Record<string, string>,\n  startAt: string,\n  nowValue: Date,\n  emptyNumericGuard: RecurrenceEmptyNumericGuard,\n): RecurrenceRule | undefined {\n  const freqRaw = kv.recur_freq?.trim();\n  const intervalRaw = kv.recur_interval?.trim();\n  const countRaw = kv.recur_count?.trim();\n  const untilRaw = kv.recur_until?.trim();\n  const byWeekdayRaw = kv.recur_by_weekday?.trim();\n  const byMonthDayRaw = kv.recur_by_month_day?.trim();\n  const exdatesRaw = kv.recur_exdates?.trim();\n\n  const recurrenceInputsProvided = [freqRaw, intervalRaw, countRaw, untilRaw, byWeekdayRaw, byMonthDayRaw, exdatesRaw].some(\n    (value) => value !== undefined,\n  );\n  if (!recurrenceInputsProvided) {\n    return undefined;\n  }\n  if (!freqRaw) {\n    throw new PmCliError(\"--event recurrence fields require recur_freq=<daily|weekly|monthly|yearly>\", EXIT_CODE.USAGE);\n  }\n\n  const freq = ensureEnumValue(freqRaw.toLowerCase(), RECURRENCE_FREQUENCY_VALUES, \"event recurrence frequency\");\n  const interval = parsePositiveRecurrenceInteger(intervalRaw, \"recur_interval\", emptyNumericGuard);\n  const count = parsePositiveRecurrenceInteger(countRaw, \"recur_count\", emptyNumericGuard);\n  const until = parseRecurrenceUntil(untilRaw, startAt, nowValue);\n  const byWeekday = parseRecurrenceWeekdays(byWeekdayRaw);\n  const byMonthDay = parseRecurrenceMonthDays(byMonthDayRaw);\n  const exdates = parseRecurrenceExdates(exdatesRaw, nowValue);\n\n  return {\n    freq,\n    interval,\n    count,\n    until,\n    by_weekday: byWeekday.length > 0 ? byWeekday : undefined,\n    by_month_day: byMonthDay.length > 0 ? byMonthDay : undefined,\n    exdates: exdates.length > 0 ? exdates : undefined,\n  };\n}\n"],"names":[],"mappings":"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","debugId":"6a8f99fb-f5b4-5d82-986e-934fac3cfb6a"}

package/dist/cli/commands/reindex.d.ts

@@ -4,6 +4,7 @@ import type { VectorizationEmbeddingIdentity } from "../../core/search/vectoriza
 import type { GlobalOptions } from "../../core/shared/command-types.js";
 import { type CachedDocumentCandidate } from "../../core/store/front-matter-cache.js";
 import type { ItemDocument, PmSettings } from "../../types/index.js";
+type ReindexMode = "keyword" | "semantic" | "hybrid";
 /**
  * Documents the reindex options payload exchanged by command, SDK, and package integrations.
  */
@@ -17,7 +18,7 @@ export interface ReindexOptions {
  */
 export interface ReindexResult {
     ok: boolean;
-    mode: "keyword" | "semantic" | "hybrid";
+    mode: ReindexMode;
     total_items: number;
     semantic: {
         enabled: boolean;
@@ -36,9 +37,9 @@ export interface ReindexResult {
 }
 declare function shouldEmitReindexProgress(options: ReindexOptions): boolean;
 declare function emitReindexProgress(enabled: boolean, message: string): void;
-declare function parseMode(raw: string | undefined): "keyword" | "semantic" | "hybrid";
+declare function parseMode(raw: string | undefined): ReindexMode;
 declare function hydrateDocuments(pmRoot: string, candidates: CachedDocumentCandidate[], schema: PmSettings["schema"], warnings: string[], itemIds?: Set<string>): Promise<ItemDocument[]>;
-declare function buildKeywordRecord(document: ItemDocument, mode: "keyword" | "semantic" | "hybrid", corpusFields?: string[]): Record<string, unknown>;
+declare function buildKeywordRecord(document: ItemDocument, mode: ReindexMode, corpusFields?: string[]): Record<string, unknown>;
 type ExtensionEmbedBatch = (context: {
     inputs: string[];
     settings: PmSettings;
@@ -62,8 +63,8 @@ type ExtensionVectorDelete = (context: {
     settings: PmSettings;
 }) => Promise<void> | void;
 interface ExtensionVectorAdapter {
-    name: string;
-    upsert: ExtensionVectorUpsert;
+    adapterName: string;
+    upsert?: ExtensionVectorUpsert;
     delete?: ExtensionVectorDelete;
 }
 interface ReindexEmbeddingExecutionResult {
@@ -86,6 +87,7 @@ export declare const _testOnly: {
     collectLedgerOrphanIds: typeof collectLedgerOrphanIds;
     resetVectorStoreForReindex: typeof resetVectorStoreForReindex;
     pruneReindexOrphanVectors: typeof pruneReindexOrphanVectors;
+    upsertReindexVectors: typeof upsertReindexVectors;
 };
 declare function resolveExtensionSearchEmbedding(settings: PmSettings): {
     name: string;
@@ -111,6 +113,20 @@ declare function executeReindexEmbedding(settings: PmSettings, requestedMode: "k
 } | null, documents: ItemDocument[], semanticWarnings: string[], semanticSummary: ReindexResult["semantic"], progressEnabled: boolean): Promise<ReindexEmbeddingExecutionResult>;
 declare function resetVectorStoreForReindex(activeVectorStore: ReturnType<typeof resolveVectorStores>["active"], extensionVectorAdapter: ExtensionVectorAdapter | null, ledgerEntries: Record<string, string>, settings: PmSettings, semanticWarnings: string[], vectorDimension?: number): Promise<void>;
 declare function pruneReindexOrphanVectors(activeVectorStore: ReturnType<typeof resolveVectorStores>["active"], extensionVectorAdapter: ExtensionVectorAdapter | null, orphanIds: string[], settings: PmSettings, semanticWarnings: string[]): Promise<void>;
+declare function upsertReindexVectors(params: {
+    requestedMode: ReindexMode;
+    activeVectorStore: ReturnType<typeof resolveVectorStores>["active"];
+    extensionVectorAdapter: ExtensionVectorAdapter | null;
+    settings: PmSettings;
+    points: Array<{
+        id: string;
+        vector: number[];
+        payload: Record<string, unknown>;
+    }>;
+    semanticWarnings: string[];
+    semanticSummary: ReindexResult["semantic"];
+    progressEnabled: boolean;
+}): Promise<void>;
 /**
  * Implements run reindex for the public runtime surface of this module.
  */