@unbrained/pm-cli 2026.3.9

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

@@ -0,0 +1,21 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+import type { ItemFrontMatter, ItemStatus } from "../../types/index.js";
+export interface ListOptions {
+    type?: string;
+    tag?: string;
+    priority?: string;
+    deadlineBefore?: string;
+    deadlineAfter?: string;
+    assignee?: string;
+    sprint?: string;
+    release?: string;
+    limit?: string;
+    excludeTerminal?: boolean;
+}
+export interface ListResult {
+    items: ItemFrontMatter[];
+    count: number;
+    filters: Record<string, unknown>;
+    now: string;
+}
+export declare function runList(status: ItemStatus | undefined, options: ListOptions, global: GlobalOptions): Promise<ListResult>;

package/dist/cli/commands/list.js

@@ -0,0 +1,137 @@
+import { pathExists } from "../../core/fs/fs-utils.js";
+import { EXIT_CODE } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+import { nowIso, resolveIsoOrRelative } from "../../core/shared/time.js";
+import { listAllFrontMatter } from "../../core/store/item-store.js";
+import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
+import { readSettings } from "../../core/store/settings.js";
+const ITEM_TYPES_BY_LOWER = new Map([
+    ["epic", "Epic"],
+    ["feature", "Feature"],
+    ["task", "Task"],
+    ["chore", "Chore"],
+    ["issue", "Issue"],
+]);
+function isTerminal(status) {
+    return status === "closed" || status === "canceled";
+}
+function sortItems(items) {
+    return [...items].sort((a, b) => {
+        const aTerminal = isTerminal(a.status);
+        const bTerminal = isTerminal(b.status);
+        if (aTerminal !== bTerminal) {
+            return aTerminal ? 1 : -1;
+        }
+        const byPriority = a.priority - b.priority;
+        if (byPriority !== 0)
+            return byPriority;
+        const byUpdated = b.updated_at.localeCompare(a.updated_at);
+        if (byUpdated !== 0)
+            return byUpdated;
+        return a.id.localeCompare(b.id);
+    });
+}
+function parsePriority(raw) {
+    if (raw === undefined)
+        return undefined;
+    const parsed = Number(raw);
+    if (!Number.isInteger(parsed) || parsed < 0 || parsed > 4) {
+        throw new PmCliError("Priority filter must be 0..4", EXIT_CODE.USAGE);
+    }
+    return parsed;
+}
+function parseType(raw) {
+    if (raw === undefined)
+        return undefined;
+    const parsed = ITEM_TYPES_BY_LOWER.get(raw.trim().toLowerCase());
+    if (!parsed) {
+        throw new PmCliError("Type filter must be one of Epic|Feature|Task|Chore|Issue", EXIT_CODE.USAGE);
+    }
+    return parsed;
+}
+function parseDeadline(raw) {
+    if (raw === undefined)
+        return undefined;
+    return resolveIsoOrRelative(raw);
+}
+function parseLimit(raw) {
+    if (raw === undefined)
+        return undefined;
+    const parsed = Number(raw);
+    if (!Number.isInteger(parsed) || parsed < 0) {
+        throw new PmCliError("Limit filter must be a non-negative integer", EXIT_CODE.USAGE);
+    }
+    return parsed;
+}
+function applyFilters(items, status, options) {
+    const typeFilter = parseType(options.type);
+    const tagFilter = options.tag?.trim().toLowerCase();
+    const priorityFilter = parsePriority(options.priority);
+    const deadlineBefore = parseDeadline(options.deadlineBefore);
+    const deadlineAfter = parseDeadline(options.deadlineAfter);
+    const assigneeFilter = options.assignee?.trim();
+    const sprintFilter = options.sprint?.trim();
+    const releaseFilter = options.release?.trim();
+    return items.filter((item) => {
+        if (status && item.status !== status)
+            return false;
+        if (options.excludeTerminal && isTerminal(item.status))
+            return false;
+        if (typeFilter && item.type !== typeFilter)
+            return false;
+        if (tagFilter && !item.tags.includes(tagFilter))
+            return false;
+        if (priorityFilter !== undefined && item.priority !== priorityFilter)
+            return false;
+        if (deadlineBefore && (!item.deadline || item.deadline > deadlineBefore))
+            return false;
+        if (deadlineAfter && (!item.deadline || item.deadline < deadlineAfter))
+            return false;
+        if (assigneeFilter !== undefined) {
+            if (assigneeFilter.toLowerCase() === "none") {
+                if (item.assignee)
+                    return false;
+            }
+            else {
+                if (item.assignee !== assigneeFilter)
+                    return false;
+            }
+        }
+        if (sprintFilter !== undefined && item.sprint !== sprintFilter)
+            return false;
+        if (releaseFilter !== undefined && item.release !== releaseFilter)
+            return false;
+        return true;
+    });
+}
+export async function runList(status, options, global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    if (!(await pathExists(getSettingsPath(pmRoot)))) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+    await readSettings(pmRoot);
+    const items = await listAllFrontMatter(pmRoot);
+    const filtered = applyFilters(items, status, options);
+    const sorted = sortItems(filtered);
+    const limit = parseLimit(options.limit);
+    const limited = limit === undefined ? sorted : sorted.slice(0, limit);
+    const now = nowIso();
+    return {
+        items: limited,
+        count: limited.length,
+        filters: {
+            status: status ?? null,
+            type: options.type ?? null,
+            tag: options.tag ?? null,
+            priority: options.priority ?? null,
+            deadline_before: options.deadlineBefore ?? null,
+            deadline_after: options.deadlineAfter ?? null,
+            assignee: options.assignee ?? null,
+            sprint: options.sprint ?? null,
+            release: options.release ?? null,
+            limit: options.limit ?? null,
+        },
+        now,
+    };
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,16 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+export interface ReindexOptions {
+    mode?: string;
+}
+export interface ReindexResult {
+    ok: boolean;
+    mode: "keyword" | "semantic" | "hybrid";
+    total_items: number;
+    artifacts: {
+        manifest: string;
+        embeddings: string;
+    };
+    warnings: string[];
+    generated_at: string;
+}
+export declare function runReindex(options: ReindexOptions, global: GlobalOptions): Promise<ReindexResult>;

package/dist/cli/commands/reindex.js

@@ -0,0 +1,154 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { runActiveOnIndexHooks, runActiveOnReadHooks, runActiveOnWriteHooks } from "../../core/extensions/index.js";
+import { pathExists, writeFileAtomic } from "../../core/fs/fs-utils.js";
+import { parseItemDocument } from "../../core/item/item-format.js";
+import { executeEmbeddingBatchesWithRetry } from "../../core/search/embedding-batches.js";
+import { resolveEmbeddingProviders } from "../../core/search/providers.js";
+import { executeVectorUpsert, resolveVectorStores } from "../../core/search/vector-stores.js";
+import { EXIT_CODE, TYPE_TO_FOLDER } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+import { nowIso } from "../../core/shared/time.js";
+import { listAllFrontMatter } from "../../core/store/item-store.js";
+import { getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
+import { readSettings } from "../../core/store/settings.js";
+const MANIFEST_PATH = "index/manifest.json";
+const EMBEDDINGS_PATH = "search/embeddings.jsonl";
+function parseMode(raw) {
+    const normalized = (raw ?? "keyword").trim().toLowerCase();
+    if (normalized === "keyword") {
+        return "keyword";
+    }
+    if (normalized === "semantic" || normalized === "hybrid") {
+        return normalized;
+    }
+    throw new PmCliError("Reindex mode must be one of keyword|semantic|hybrid", EXIT_CODE.USAGE);
+}
+async function loadDocuments(pmRoot) {
+    const items = await listAllFrontMatter(pmRoot);
+    const sortedItems = [...items].sort((a, b) => a.id.localeCompare(b.id));
+    const documents = [];
+    for (const item of sortedItems) {
+        const itemPath = path.join(pmRoot, TYPE_TO_FOLDER[item.type], `${item.id}.md`);
+        const raw = await fs.readFile(itemPath, "utf8");
+        await runActiveOnReadHooks({
+            path: itemPath,
+            scope: "project",
+        });
+        documents.push(parseItemDocument(raw));
+    }
+    return documents;
+}
+function buildKeywordRecord(document, mode) {
+    const item = document.front_matter;
+    return {
+        id: item.id,
+        mode,
+        updated_at: item.updated_at,
+        corpus: {
+            title: item.title,
+            description: item.description,
+            tags: item.tags,
+            status: item.status,
+            body: document.body,
+            comments: (item.comments ?? []).map((entry) => entry.text),
+            notes: (item.notes ?? []).map((entry) => entry.text),
+            learnings: (item.learnings ?? []).map((entry) => entry.text),
+            dependencies: (item.dependencies ?? []).map((entry) => ({
+                id: entry.id,
+                kind: entry.kind,
+            })),
+        },
+    };
+}
+function buildSemanticCorpusInput(document) {
+    return JSON.stringify(buildKeywordRecord(document, "semantic").corpus);
+}
+export async function runReindex(options, global) {
+    const requestedMode = parseMode(options.mode);
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    if (!(await pathExists(getSettingsPath(pmRoot)))) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+    const settings = await readSettings(pmRoot);
+    let activeEmbeddingProvider = null;
+    let activeVectorStore = null;
+    if (requestedMode !== "keyword") {
+        const providerResolution = resolveEmbeddingProviders(settings);
+        if (!providerResolution.active) {
+            throw new PmCliError(`Reindex mode '${requestedMode}' requires a configured embedding provider in settings.providers.openai or settings.providers.ollama`, EXIT_CODE.USAGE);
+        }
+        const vectorResolution = resolveVectorStores(settings);
+        if (!vectorResolution.active) {
+            throw new PmCliError(`Reindex mode '${requestedMode}' requires a configured vector store in settings.vector_store.qdrant or settings.vector_store.lancedb`, EXIT_CODE.USAGE);
+        }
+        activeEmbeddingProvider = providerResolution.active;
+        activeVectorStore = vectorResolution.active;
+    }
+    const mode = requestedMode;
+    const documents = await loadDocuments(pmRoot);
+    const generatedAt = nowIso();
+    const manifest = {
+        version: 1,
+        mode,
+        generated_at: generatedAt,
+        total_items: documents.length,
+        items: documents.map((document) => ({
+            id: document.front_matter.id,
+            type: document.front_matter.type,
+            status: document.front_matter.status,
+            priority: document.front_matter.priority,
+            updated_at: document.front_matter.updated_at,
+        })),
+    };
+    const manifestPath = path.join(pmRoot, MANIFEST_PATH);
+    const embeddingsPath = path.join(pmRoot, EMBEDDINGS_PATH);
+    const embeddingsLines = documents.map((document) => JSON.stringify(buildKeywordRecord(document, mode))).join("\n");
+    const semanticWarnings = [];
+    if (mode !== "keyword" && documents.length > 0 && activeEmbeddingProvider && activeVectorStore) {
+        const corpusInputs = documents.map((document) => buildSemanticCorpusInput(document));
+        const embeddingResult = await executeEmbeddingBatchesWithRetry(activeEmbeddingProvider, settings, corpusInputs);
+        semanticWarnings.push(...embeddingResult.warnings);
+        await executeVectorUpsert(activeVectorStore, documents.map((document, index) => ({
+            id: document.front_matter.id,
+            vector: embeddingResult.vectors[index],
+            payload: {
+                id: document.front_matter.id,
+                type: document.front_matter.type,
+                status: document.front_matter.status,
+                priority: document.front_matter.priority,
+                updated_at: document.front_matter.updated_at,
+            },
+        })));
+    }
+    await writeFileAtomic(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+    await writeFileAtomic(embeddingsPath, `${embeddingsLines}\n`);
+    const hookWarnings = [
+        ...(await runActiveOnWriteHooks({
+            path: manifestPath,
+            scope: "project",
+            op: "reindex:manifest",
+        })),
+        ...(await runActiveOnWriteHooks({
+            path: embeddingsPath,
+            scope: "project",
+            op: "reindex:embeddings",
+        })),
+        ...(await runActiveOnIndexHooks({
+            mode,
+            total_items: documents.length,
+        })),
+    ];
+    return {
+        ok: true,
+        mode,
+        total_items: documents.length,
+        artifacts: {
+            manifest: MANIFEST_PATH,
+            embeddings: EMBEDDINGS_PATH,
+        },
+        warnings: [...semanticWarnings, ...hookWarnings],
+        generated_at: generatedAt,
+    };
+}
+//# sourceMappingURL=reindex.js.map

package/dist/cli/commands/reindex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reindex.js","sourceRoot":"","sources":["../../../src/cli/commands/reindex.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,20 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+import type { ItemFrontMatter } from "../../types/index.js";
+export interface RestoreCommandOptions {
+    author?: string;
+    message?: string;
+    force?: boolean;
+}
+export interface RestoreResult {
+    item: ItemFrontMatter;
+    restored_from: {
+        kind: "version" | "timestamp";
+        target: string;
+        history_index: number;
+        entry_ts: string;
+        entry_op: string;
+    };
+    changed_fields: string[];
+    warnings: string[];
+}
+export declare function runRestore(id: string, target: string, options: RestoreCommandOptions, global: GlobalOptions): Promise<RestoreResult>;

package/dist/cli/commands/restore.js

@@ -0,0 +1,208 @@
+import jsonPatch from "fast-json-patch";
+import { pathExists, writeFileAtomic } from "../../core/fs/fs-utils.js";
+import { appendHistoryEntry, createHistoryEntry } from "../../core/history/history.js";
+import { canonicalDocument, serializeItemDocument } from "../../core/item/item-format.js";
+import { acquireLock } from "../../core/lock/lock.js";
+import { EXIT_CODE, FRONT_MATTER_KEY_ORDER } from "../../core/shared/constants.js";
+import { PmCliError } from "../../core/shared/errors.js";
+import { nowIso } from "../../core/shared/time.js";
+import { orderObject, sha256Hex, stableStringify } from "../../core/shared/serialization.js";
+import { runActiveOnWriteHooks } from "../../core/extensions/index.js";
+import { locateItem, readLocatedItem } from "../../core/store/item-store.js";
+import { getHistoryPath, getSettingsPath, resolvePmRoot } from "../../core/store/paths.js";
+import { readSettings } from "../../core/store/settings.js";
+import { readHistoryEntries } from "./history.js";
+const EMPTY_REPLAY_DOCUMENT = {
+    front_matter: {},
+    body: "",
+};
+function toAuthor(candidate, defaultAuthor) {
+    const resolved = candidate ?? process.env.PM_AUTHOR ?? defaultAuthor;
+    const trimmed = resolved.trim();
+    return trimmed || "unknown";
+}
+function toReplayDocument(document) {
+    const canonical = canonicalDocument(document);
+    return {
+        front_matter: orderObject(canonical.front_matter, FRONT_MATTER_KEY_ORDER),
+        body: canonical.body,
+    };
+}
+function replayHash(document) {
+    return sha256Hex(stableStringify(document));
+}
+function ensureReplayTarget(target, history) {
+    const trimmed = target.trim();
+    if (!trimmed) {
+        throw new PmCliError("Missing restore target. Use a timestamp or version number.", EXIT_CODE.USAGE);
+    }
+    if (/^\d+$/.test(trimmed)) {
+        const version = Number(trimmed);
+        if (!Number.isSafeInteger(version) || version < 1 || version > history.length) {
+            throw new PmCliError(`Restore version must be between 1 and ${history.length} for this item.`, EXIT_CODE.USAGE);
+        }
+        return {
+            kind: "version",
+            raw: trimmed,
+            historyIndex: version - 1,
+        };
+    }
+    const parsedTarget = Date.parse(trimmed);
+    if (!Number.isFinite(parsedTarget)) {
+        throw new PmCliError(`Invalid restore target "${target}". Use a positive version number or ISO timestamp.`, EXIT_CODE.USAGE);
+    }
+    let index = -1;
+    for (let i = 0; i < history.length; i += 1) {
+        const entryTimestamp = Date.parse(history[i].ts);
+        if (!Number.isFinite(entryTimestamp)) {
+            throw new PmCliError(`History for this item contains invalid timestamp at entry ${i + 1}.`, EXIT_CODE.GENERIC_FAILURE);
+        }
+        if (entryTimestamp <= parsedTarget) {
+            index = i;
+        }
+    }
+    if (index < 0) {
+        throw new PmCliError(`No history entries exist at or before timestamp ${trimmed}.`, EXIT_CODE.USAGE);
+    }
+    return {
+        kind: "timestamp",
+        raw: trimmed,
+        historyIndex: index,
+    };
+}
+function applyHistoryPatch(current, patch, entryNumber) {
+    try {
+        const applied = jsonPatch.applyPatch(structuredClone(current), patch, true, false).newDocument;
+        if (typeof applied !== "object" ||
+            applied === null ||
+            !("front_matter" in applied) ||
+            !("body" in applied) ||
+            typeof applied.body !== "string" ||
+            typeof applied.front_matter !== "object" ||
+            applied.front_matter === null) {
+            throw new PmCliError(`History replay produced an invalid document shape at entry ${entryNumber}.`, EXIT_CODE.GENERIC_FAILURE);
+        }
+        const replay = applied;
+        return {
+            front_matter: replay.front_matter,
+            body: replay.body,
+        };
+    }
+    catch (error) {
+        if (error instanceof PmCliError) {
+            throw error;
+        }
+        throw new PmCliError(`Failed to apply history patch at entry ${entryNumber}.`, EXIT_CODE.GENERIC_FAILURE);
+    }
+}
+function replayToTarget(history, targetIndex) {
+    let document = structuredClone(EMPTY_REPLAY_DOCUMENT);
+    for (let i = 0; i <= targetIndex; i += 1) {
+        const entry = history[i];
+        const beforeHash = replayHash(document);
+        if (beforeHash !== entry.before_hash) {
+            throw new PmCliError(`History hash mismatch before replay at entry ${i + 1}.`, EXIT_CODE.GENERIC_FAILURE);
+        }
+        document = applyHistoryPatch(document, entry.patch, i + 1);
+        const afterHash = replayHash(document);
+        if (afterHash !== entry.after_hash) {
+            throw new PmCliError(`History hash mismatch after replay at entry ${i + 1}.`, EXIT_CODE.GENERIC_FAILURE);
+        }
+    }
+    return document;
+}
+function changedFields(beforeDocument, afterDocument) {
+    const beforeReplay = toReplayDocument(beforeDocument);
+    const afterReplay = toReplayDocument(afterDocument);
+    const patch = jsonPatch.compare(beforeReplay, afterReplay);
+    const fields = new Set();
+    for (const op of patch) {
+        if (op.path === "/body" || op.path.startsWith("/body/")) {
+            fields.add("body");
+            continue;
+        }
+        const segment = op.path.replace(/^\/front_matter\/?/, "").split("/")[0];
+        fields.add(segment.replaceAll("~1", "/").replaceAll("~0", "~"));
+    }
+    return Array.from(fields).sort((a, b) => a.localeCompare(b));
+}
+export async function runRestore(id, target, options, global) {
+    const pmRoot = resolvePmRoot(process.cwd(), global.path);
+    if (!(await pathExists(getSettingsPath(pmRoot)))) {
+        throw new PmCliError(`Tracker is not initialized at ${pmRoot}. Run pm init first.`, EXIT_CODE.NOT_FOUND);
+    }
+    const settings = await readSettings(pmRoot);
+    const located = await locateItem(pmRoot, id, settings.id_prefix);
+    if (!located) {
+        throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);
+    }
+    const historyPath = getHistoryPath(pmRoot, located.id);
+    const history = await readHistoryEntries(historyPath, located.id);
+    if (history.length === 0) {
+        throw new PmCliError(`No history exists for ${located.id}; restore is unavailable.`, EXIT_CODE.NOT_FOUND);
+    }
+    const resolvedTarget = ensureReplayTarget(target, history);
+    const replayDocument = replayToTarget(history, resolvedTarget.historyIndex);
+    const restoredDocument = canonicalDocument({
+        front_matter: replayDocument.front_matter,
+        body: replayDocument.body,
+    });
+    if (restoredDocument.front_matter.id !== located.id) {
+        throw new PmCliError(`Restore target resolved to item ${restoredDocument.front_matter.id}, expected ${located.id}.`, EXIT_CODE.GENERIC_FAILURE);
+    }
+    const author = toAuthor(options.author, settings.author_default);
+    const releaseLock = await acquireLock(pmRoot, located.id, settings.locks.ttl_seconds, author, Boolean(options.force));
+    try {
+        const { raw: originalRaw, document: currentDocument } = await readLocatedItem(located);
+        const assigned = currentDocument.front_matter.assignee?.trim();
+        if (assigned && assigned !== author && !options.force) {
+            throw new PmCliError(`Item ${located.id} is assigned to ${assigned}. Use --force to override.`, EXIT_CODE.CONFLICT);
+        }
+        const serializedRestore = serializeItemDocument(restoredDocument);
+        await writeFileAtomic(located.itemPath, serializedRestore);
+        const historyEntry = createHistoryEntry({
+            nowIso: nowIso(),
+            author,
+            op: "restore",
+            before: currentDocument,
+            after: restoredDocument,
+            message: options.message,
+        });
+        try {
+            await appendHistoryEntry(historyPath, historyEntry);
+        }
+        catch (error) {
+            await writeFileAtomic(located.itemPath, originalRaw);
+            throw error;
+        }
+        const hookWarnings = [
+            ...(await runActiveOnWriteHooks({
+                path: located.itemPath,
+                scope: "project",
+                op: "restore",
+            })),
+            ...(await runActiveOnWriteHooks({
+                path: historyPath,
+                scope: "project",
+                op: "restore:history",
+            })),
+        ];
+        const targetEntry = history[resolvedTarget.historyIndex];
+        return {
+            item: restoredDocument.front_matter,
+            restored_from: {
+                kind: resolvedTarget.kind,
+                target: resolvedTarget.raw,
+                history_index: resolvedTarget.historyIndex + 1,
+                entry_ts: targetEntry.ts,
+                entry_op: targetEntry.op,
+            },
+            changed_fields: changedFields(currentDocument, restoredDocument),
+            warnings: hookWarnings,
+        };
+    }
+    finally {
+        await releaseLock();
+    }
+}
+//# sourceMappingURL=restore.js.map

package/dist/cli/commands/restore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore.js","sourceRoot":"","sources":["../../../src/cli/commands/restore.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,45 @@
+import type { GlobalOptions } from "../../core/shared/command-types.js";
+import type { ItemFrontMatter } from "../../types/index.js";
+export interface SearchOptions {
+    mode?: string;
+    includeLinked?: boolean;
+    type?: string;
+    tag?: string;
+    priority?: string;
+    deadlineBefore?: string;
+    deadlineAfter?: string;
+    limit?: string;
+}
+type SearchMode = "keyword" | "semantic" | "hybrid";
+export interface SearchHit {
+    item: ItemFrontMatter;
+    score: number;
+    matched_fields: string[];
+}
+export interface SearchResult {
+    query: string;
+    mode: SearchMode;
+    items: SearchHit[];
+    count: number;
+    filters: Record<string, unknown>;
+    now: string;
+}
+export interface SearchTuning {
+    title_exact_bonus: number;
+    title_weight: number;
+    description_weight: number;
+    tags_weight: number;
+    status_weight: number;
+    body_weight: number;
+    comments_weight: number;
+    notes_weight: number;
+    learnings_weight: number;
+    dependencies_weight: number;
+    linked_content_weight: number;
+}
+export declare function resolveSearchMaxResults(settings: unknown): number;
+export declare function resolveSearchScoreThreshold(settings: unknown): number;
+export declare function resolveHybridSemanticWeight(settings: unknown): number;
+export declare function resolveSearchTuning(settings: unknown): SearchTuning;
+export declare function runSearch(query: string, options: SearchOptions, global: GlobalOptions): Promise<SearchResult>;
+export {};