@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/query/parsers.js

@@ -1,45 +1,2 @@
-/**
- * @module sdk/query/parsers
- *
- * Provides shared query parsers for SDK and CLI runtime consumers.
- */
-
-!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]="eb044a23-d43b-5e9c-9ae7-4ac91b5e587a")}catch(e){}}();
-import { PmCliError } from "../../core/shared/errors.js";
-import { EXIT_CODE } from "../../core/shared/constants.js";
-export { parseLimit } from "../../core/shared/numeric-parsers.js";
-import { resolveTypeName, } from "../../core/item/type-registry.js";
-/** Implements parse integer limit for the public runtime surface of this module. */
-export function parseIntegerLimit(raw, label = "--limit") {
-    if (raw === undefined)
-        return undefined;
-    const normalized = String(raw).trim();
-    const parsed = normalized.length === 0 ? Number.NaN : Number(normalized);
-    if (!Number.isInteger(parsed) || parsed < 0) {
-        throw new PmCliError(`${label} must be a non-negative integer`, EXIT_CODE.USAGE);
-    }
-    return parsed;
-}
-/** Implements parse priority for the public runtime surface of this module. */
-export function parsePriority(raw, label = "--priority") {
-    if (raw === undefined)
-        return undefined;
-    const normalized = String(raw).trim();
-    const parsed = normalized.length === 0 ? Number.NaN : Number(normalized);
-    if (!Number.isInteger(parsed) || parsed < 0 || parsed > 4) {
-        throw new PmCliError(`${label} filter must be 0..4`, EXIT_CODE.USAGE);
-    }
-    return parsed;
-}
-/** Implements parse type for the public runtime surface of this module. */
-export function parseType(raw, typeRegistry, label = "--type") {
-    if (raw === undefined)
-        return undefined;
-    const parsed = resolveTypeName(raw, typeRegistry);
-    if (!parsed) {
-        throw new PmCliError(`${label} filter must be one of ${typeRegistry.types.join("|")}`, EXIT_CODE.USAGE);
-    }
-    return parsed;
-}
+!(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]="fdc16f69-f63f-5e17-9139-35d54db7bab5")}catch(e2){}})();import{PmCliError}from"../../core/shared/errors.js";import{EXIT_CODE}from"../../core/shared/constants.js";import{parseLimit}from"../../core/shared/numeric-parsers.js";import{resolveTypeName}from"../../core/item/type-registry.js";function parseIntegerLimit(raw,label="--limit"){if(raw===void 0)return void 0;const normalized=String(raw).trim();const parsed=normalized.length===0?Number.NaN:Number(normalized);if(!Number.isInteger(parsed)||parsed<0){throw new PmCliError(`${label} must be a non-negative integer`,EXIT_CODE.USAGE)}return parsed}function parsePriority(raw,label="--priority"){if(raw===void 0)return void 0;const normalized=String(raw).trim();const parsed=normalized.length===0?Number.NaN:Number(normalized);if(!Number.isInteger(parsed)||parsed<0||parsed>4){throw new PmCliError(`${label} filter must be 0..4`,EXIT_CODE.USAGE)}return parsed}function parseType(raw,typeRegistry,label="--type"){if(raw===void 0)return void 0;const parsed=resolveTypeName(raw,typeRegistry);if(!parsed){throw new PmCliError(`${label} filter must be one of ${typeRegistry.types.join("|")}`,EXIT_CODE.USAGE)}return parsed}export{parseIntegerLimit,parseLimit,parsePriority,parseType};
 //# sourceMappingURL=parsers.js.map
-//# debugId=eb044a23-d43b-5e9c-9ae7-4ac91b5e587a

package/dist/sdk/query/projection-contracts.js

@@ -1,185 +1,2 @@
-/**
- * @module sdk/query/projection-contracts
- *
- * Declares dependency-light projection vocabularies for list, get, and search
- * so contract-only SDK imports do not initialize query runtimes or storage.
- */
-
-!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]="5bb71ec1-7eb1-558e-a965-acd779570c2e")}catch(e){}}();
-import { ITEM_METADATA_KEY_ORDER } from "../../core/shared/item-metadata-contract.js";
-/** Stable field order for the compact list projection. */
-export const DEFAULT_COMPACT_LIST_FIELDS = [
-    "id",
-    "title",
-    "status",
-    "type",
-    "priority",
-    "parent",
-    "updated_at",
-];
-/** Stable field order for the agent-optimized brief list projection. */
-export const BRIEF_LIST_FIELDS = ["id", "status", "type", "title"];
-/** Machine-readable default projection contract for every list command. */
-export const LIST_COMMAND_DEFAULT_PROJECTIONS = {
-    list: "brief",
-    "list-all": "full",
-    "list-draft": "full",
-    "list-open": "brief",
-    "list-in-progress": "brief",
-    "list-blocked": "brief",
-    "list-closed": "full",
-    "list-canceled": "full",
-};
-const TREE_METADATA_FIELDS = [
-    "tree_depth",
-    "tree_parent",
-    "tree_children",
-    "tree_title",
-];
-/** Return every accepted list projection selector for core and runtime metadata. */
-export function listListProjectionFields(runtimeMetadataKeys = []) {
-    return [
-        ...new Set([
-            ...ITEM_METADATA_KEY_ORDER,
-            "body",
-            ...TREE_METADATA_FIELDS,
-            ...runtimeMetadataKeys,
-        ]),
-    ]
-        .flatMap((field) => [field, `item.${field}`])
-        .sort();
-}
-/** Canonical get depth values. The CLI also accepts full as an alias for deep. */
-export const GET_DEPTH_VALUES = ["brief", "standard", "deep"];
-const GET_ROOT_PROJECTION_FIELDS = [
-    "body",
-    "linked",
-    "claim_state",
-    "children",
-    "schedule",
-];
-const GET_LINKED_PROJECTION_FIELDS = [
-    "linked.files",
-    "linked.tests",
-    "linked.docs",
-];
-const GET_CLAIM_STATE_PROJECTION_FIELDS = [
-    "claim_state.claimed",
-    "claim_state.assignee",
-    "claim_state.last_claim",
-    "claim_state.last_release",
-];
-const GET_SCHEDULE_PROJECTION_FIELDS = [
-    "schedule.deadline",
-    "schedule.start_at",
-    "schedule.end_at",
-    "schedule.location",
-    "schedule.reminders",
-    "schedule.events",
-];
-/** Return every accepted get projection selector for core and runtime metadata. */
-export function listGetProjectionFields(runtimeMetadataKeys = []) {
-    const itemFields = [
-        ...new Set([
-            ...ITEM_METADATA_KEY_ORDER,
-            ...runtimeMetadataKeys,
-            "notes_count",
-            "tests_count",
-            "collection_counts",
-        ]),
-    ];
-    return [
-        ...itemFields.flatMap((field) => [field, `item.${field}`]),
-        ...GET_ROOT_PROJECTION_FIELDS,
-        ...GET_LINKED_PROJECTION_FIELDS,
-        ...GET_CLAIM_STATE_PROJECTION_FIELDS,
-        ...GET_SCHEDULE_PROJECTION_FIELDS,
-    ].sort();
-}
-/** Stable field order for compact search results. */
-export const DEFAULT_COMPACT_SEARCH_FIELDS = [
-    "id",
-    "title",
-    "status",
-    "type",
-    "priority",
-    "updated_at",
-    "score",
-    "matched_fields",
-];
-/** Search-result fields that live beside the nested item projection. */
-export const SEARCH_HIT_FIELD_KEYS = [
-    "score",
-    "matched_fields",
-    "highlights",
-];
-/** Core item fields accepted by explicit search projections. */
-export const SEARCH_ITEM_FIELD_KEYS = [
-    "id",
-    "title",
-    "description",
-    "type",
-    "status",
-    "priority",
-    "tags",
-    "created_at",
-    "updated_at",
-    "deadline",
-    "assignee",
-    "author",
-    "estimated_minutes",
-    "acceptance_criteria",
-    "dependencies",
-    "comments",
-    "notes",
-    "learnings",
-    "reminders",
-    "events",
-    "files",
-    "tests",
-    "docs",
-    "close_reason",
-    "parent",
-    "reviewer",
-    "risk",
-    "confidence",
-    "sprint",
-    "release",
-    "blocked_by",
-    "blocked_reason",
-    "reporter",
-    "severity",
-    "environment",
-    "repro_steps",
-    "resolution",
-    "expected_result",
-    "actual_result",
-    "affected_version",
-    "fixed_version",
-    "component",
-    "regression",
-    "customer_impact",
-    "definition_of_ready",
-    "order",
-    "rank",
-    "goal",
-    "objective",
-    "value",
-    "impact",
-    "outcome",
-    "why_now",
-    "plan",
-];
-/** Return every accepted search projection selector for core and runtime metadata. */
-export function listSearchProjectionFields(runtimeMetadataKeys = []) {
-    const runtimeKeys = [...new Set(runtimeMetadataKeys)];
-    return [
-        ...SEARCH_HIT_FIELD_KEYS,
-        ...SEARCH_ITEM_FIELD_KEYS,
-        ...SEARCH_ITEM_FIELD_KEYS.map((field) => `item.${field}`),
-        ...runtimeKeys,
-        ...runtimeKeys.map((field) => `item.${field}`),
-    ].sort();
-}
+!(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]="7bef182d-ada7-542d-8ffa-10876e5a97b0")}catch(e2){}})();import{ITEM_METADATA_KEY_ORDER}from"../../core/shared/item-metadata-contract.js";const DEFAULT_COMPACT_LIST_FIELDS=["id","title","status","type","priority","parent","updated_at"];const BRIEF_LIST_FIELDS=["id","status","type","title"];const LIST_COMMAND_DEFAULT_PROJECTIONS={list:"brief","list-all":"full","list-draft":"full","list-open":"brief","list-in-progress":"brief","list-blocked":"brief","list-closed":"full","list-canceled":"full"};const TREE_METADATA_FIELDS=["tree_depth","tree_parent","tree_children","tree_title"];function listListProjectionFields(runtimeMetadataKeys=[]){return[...new Set([...ITEM_METADATA_KEY_ORDER,"body",...TREE_METADATA_FIELDS,...runtimeMetadataKeys])].flatMap(field=>[field,`item.${field}`]).sort()}const GET_DEPTH_VALUES=["brief","standard","deep"];const GET_ROOT_PROJECTION_FIELDS=["body","linked","claim_state","children","schedule"];const GET_LINKED_PROJECTION_FIELDS=["linked.files","linked.tests","linked.docs"];const GET_CLAIM_STATE_PROJECTION_FIELDS=["claim_state.claimed","claim_state.assignee","claim_state.last_claim","claim_state.last_release"];const GET_SCHEDULE_PROJECTION_FIELDS=["schedule.deadline","schedule.start_at","schedule.end_at","schedule.location","schedule.reminders","schedule.events"];function listGetProjectionFields(runtimeMetadataKeys=[]){const itemFields=[...new Set([...ITEM_METADATA_KEY_ORDER,...runtimeMetadataKeys,"notes_count","tests_count","collection_counts"])];return[...itemFields.flatMap(field=>[field,`item.${field}`]),...GET_ROOT_PROJECTION_FIELDS,...GET_LINKED_PROJECTION_FIELDS,...GET_CLAIM_STATE_PROJECTION_FIELDS,...GET_SCHEDULE_PROJECTION_FIELDS].sort()}const DEFAULT_COMPACT_SEARCH_FIELDS=["id","title","status","type","priority","updated_at","score","matched_fields"];const SEARCH_HIT_FIELD_KEYS=["score","matched_fields","highlights"];const SEARCH_ITEM_FIELD_KEYS=["id","title","description","type","status","priority","tags","created_at","updated_at","deadline","assignee","author","estimated_minutes","acceptance_criteria","dependencies","comments","notes","learnings","reminders","events","files","tests","docs","close_reason","parent","reviewer","risk","confidence","sprint","release","blocked_by","blocked_reason","reporter","severity","environment","repro_steps","resolution","expected_result","actual_result","affected_version","fixed_version","component","regression","customer_impact","definition_of_ready","order","rank","goal","objective","value","impact","outcome","why_now","plan"];function listSearchProjectionFields(runtimeMetadataKeys=[]){const runtimeKeys=[...new Set(runtimeMetadataKeys)];return[...SEARCH_HIT_FIELD_KEYS,...SEARCH_ITEM_FIELD_KEYS,...SEARCH_ITEM_FIELD_KEYS.map(field=>`item.${field}`),...runtimeKeys,...runtimeKeys.map(field=>`item.${field}`)].sort()}export{BRIEF_LIST_FIELDS,DEFAULT_COMPACT_LIST_FIELDS,DEFAULT_COMPACT_SEARCH_FIELDS,GET_DEPTH_VALUES,LIST_COMMAND_DEFAULT_PROJECTIONS,SEARCH_HIT_FIELD_KEYS,SEARCH_ITEM_FIELD_KEYS,listGetProjectionFields,listListProjectionFields,listSearchProjectionFields};
 //# sourceMappingURL=projection-contracts.js.map
-//# debugId=5bb71ec1-7eb1-558e-a965-acd779570c2e

package/dist/sdk/query/search-contracts.js

@@ -1,231 +1,2 @@
-/**
- * @module sdk/query/search-contracts
- *
- * Owns search input parsing, output projection contracts, and tuning defaults.
- */
-
-!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]="d20ab01b-a8ae-5fe8-988a-d05fe87951f6")}catch(e){}}();
-import { coerceNumberInRange } from "../../core/shared/primitives.js";
-import { resolveIsoOrRelative } from "../../core/shared/time.js";
-import { renderPmCommand } from "../command-line.js";
-import { EXIT_CODE, PmCliError } from "../runtime-primitives.js";
-import { DEFAULT_COMPACT_SEARCH_FIELDS, listSearchProjectionFields, } from "./projection-contracts.js";
-export { DEFAULT_COMPACT_SEARCH_FIELDS, SEARCH_HIT_FIELD_KEYS, SEARCH_ITEM_FIELD_KEYS, listSearchProjectionFields, } from "./projection-contracts.js";
-/** Parse the configured search execution mode. */
-export function parseSearchMode(raw) {
-    if (raw === undefined)
-        return "keyword";
-    const normalized = raw.trim().toLowerCase();
-    if (normalized !== "keyword" &&
-        normalized !== "semantic" &&
-        normalized !== "hybrid") {
-        throw new PmCliError("Search mode must be one of keyword|semantic|hybrid", EXIT_CODE.USAGE);
-    }
-    return normalized;
-}
-/** Normalize an opt-in boolean search flag. */
-export function parseSearchBoolean(raw) {
-    return raw === true;
-}
-/** Parse a per-query semantic weight override. */
-export function parseSemanticWeightOverride(raw) {
-    return coerceNumberInRange(raw, 0, 1) ?? undefined;
-}
-/** Parse the lexical match strategy. */
-export function parseSearchMatchMode(raw) {
-    if (raw === undefined)
-        return "or";
-    const normalized = raw.trim().toLowerCase();
-    if (normalized !== "and" && normalized !== "or" && normalized !== "exact") {
-        throw new PmCliError("Search --match-mode must be one of and|or|exact", EXIT_CODE.USAGE);
-    }
-    return normalized;
-}
-/** Parse a non-negative per-query score threshold. */
-export function parseMinScoreOverride(raw) {
-    if (raw === undefined || raw === null || raw === "")
-        return undefined;
-    /* c8 ignore start -- numeric-vs-string coercion is exercised through CLI parsing */
-    const parsed = typeof raw === "number" ? raw : Number(String(raw).trim());
-    /* c8 ignore stop */
-    if (!Number.isFinite(parsed) || parsed < 0) {
-        throw new PmCliError("Search --min-score must be a finite number >= 0", EXIT_CODE.USAGE);
-    }
-    return parsed;
-}
-/** Parse an ISO or signed-relative timestamp window. */
-export function parseTimestampWindow(raw, fieldLabel) {
-    if (raw == null)
-        return undefined;
-    const value = String(raw).trim();
-    if (value.length === 0)
-        return undefined;
-    return resolveIsoOrRelative(value, new Date(), fieldLabel);
-}
-/** Normalize a phrase for case-insensitive matching. */
-export function normalizeSearchPhrase(value) {
-    return value.toLowerCase().replace(/\s+/g, " ").trim();
-}
-/** Parse an optional deadline filter. */
-export function parseSearchDeadline(raw, fieldLabel) {
-    if (raw === undefined)
-        return undefined;
-    return resolveIsoOrRelative(raw, new Date(), fieldLabel);
-}
-function parseFieldSelectors(raw) {
-    if (raw === undefined)
-        return undefined;
-    const selectors = raw
-        .split(",")
-        .map((entry) => entry.trim())
-        .filter((entry) => entry.length > 0);
-    if (selectors.length === 0) {
-        throw new PmCliError("Search --fields requires a comma-separated list of field names", EXIT_CODE.USAGE);
-    }
-    return [...new Set(selectors)];
-}
-/** Resolve mutually exclusive compact, full, or explicit-field projection. */
-export function parseSearchProjection(options, query = "<query>") {
-    const compactRequested = options.compact === true;
-    const fullRequested = options.full === true;
-    const fieldSelectors = parseFieldSelectors(options.fields);
-    const enabledModes = Number(compactRequested) +
-        Number(fullRequested) +
-        Number(fieldSelectors !== undefined);
-    if (enabledModes > 1) {
-        throw new PmCliError("Search projection options are mutually exclusive. Use one of --compact, --full, or --fields.", EXIT_CODE.USAGE, {
-            code: "projection_options_mutually_exclusive",
-            recovery: {
-                suggested_retry: renderPmCommand(["search", query, "--full"]),
-                suggested_retry_args: ["search", query, "--full"],
-            },
-        });
-    }
-    if (compactRequested) {
-        return { mode: "compact", fields: [...DEFAULT_COMPACT_SEARCH_FIELDS] };
-    }
-    if (fullRequested)
-        return { mode: "full", fields: [] };
-    if (fieldSelectors)
-        return { mode: "fields", fields: fieldSelectors };
-    return { mode: "full", fields: [] };
-}
-/** Validate explicit projection fields against core and runtime metadata. */
-export function validateSearchProjectionFields(projection, runtimeFieldRegistry, query = "<query>") {
-    if (projection.mode !== "fields")
-        return;
-    const allowedValues = listSearchProjectionFields(runtimeFieldRegistry.definitions.flatMap((field) => [
-        field.key,
-        field.metadata_key,
-    ]));
-    const allowed = new Set(allowedValues);
-    const unknown = projection.fields.filter((field) => {
-        const normalized = field.trim();
-        return !allowed.has(normalized);
-    });
-    if (unknown.length > 0) {
-        const suggestedRetryArguments = [
-            "search",
-            query,
-            "--fields",
-            "id,title,status,score",
-        ];
-        throw new PmCliError(`Unknown search --fields value(s): ${unknown.join(", ")}`, EXIT_CODE.USAGE, {
-            code: "unknown_field_projection",
-            examples: [
-                "pm search <query> --fields id,title,status,score",
-                "pm search <query> --fields id,title,item.description,matched_fields",
-            ],
-            nextSteps: [
-                "Use item.<field> for explicit item metadata fields, or run pm search --help for projection examples.",
-            ],
-            recovery: {
-                allowed_values: allowedValues,
-                suggested_retry: renderPmCommand(suggestedRetryArguments),
-                suggested_retry_args: suggestedRetryArguments,
-            },
-        });
-    }
-}
-/** Parse a non-empty normalized query into lexical tokens. */
-export function parseSearchTokens(query) {
-    const normalized = normalizeSearchPhrase(query);
-    if (!normalized) {
-        throw new PmCliError("Search query must not be empty", EXIT_CODE.USAGE);
-    }
-    return normalized.split(/\s+/u).filter(Boolean);
-}
-/** Resolve the bounded default maximum result count. */
-export function resolveSearchMaxResults(settings) {
-    const candidate = settings.search
-        ?.max_results;
-    if (typeof candidate === "number" &&
-        Number.isFinite(candidate) &&
-        candidate > 0) {
-        return Math.floor(candidate);
-    }
-    return 50;
-}
-/** Resolve the configured minimum result score. */
-export function resolveSearchScoreThreshold(settings) {
-    const candidate = settings
-        .search?.score_threshold;
-    return typeof candidate === "number" && Number.isFinite(candidate)
-        ? candidate
-        : 0;
-}
-/** Resolve the configured hybrid semantic weighting. */
-export function resolveHybridSemanticWeight(settings) {
-    const candidate = settings.search?.hybrid_semantic_weight;
-    if (typeof candidate === "number" &&
-        Number.isFinite(candidate) &&
-        candidate >= 0 &&
-        candidate <= 1) {
-        return candidate;
-    }
-    return 0.7;
-}
-/** Resolve non-negative field weights over stable defaults. */
-export function resolveSearchTuning(settings) {
-    const defaults = {
-        title_exact_bonus: 10,
-        title_weight: 48,
-        description_weight: 5,
-        tags_weight: 6,
-        status_weight: 2,
-        body_weight: 1,
-        comments_weight: 1,
-        notes_weight: 1,
-        learnings_weight: 1,
-        reminders_weight: 2,
-        events_weight: 2,
-        dependencies_weight: 3,
-        linked_content_weight: 1,
-    };
-    const tuning = settings
-        .search?.tuning;
-    if (!tuning)
-        return defaults;
-    const resolveWeight = (candidate, fallback) => typeof candidate === "number" &&
-        Number.isFinite(candidate) &&
-        candidate >= 0
-        ? candidate
-        : fallback;
-    return {
-        title_exact_bonus: resolveWeight(tuning.title_exact_bonus, defaults.title_exact_bonus),
-        title_weight: resolveWeight(tuning.title_weight, defaults.title_weight),
-        description_weight: resolveWeight(tuning.description_weight, defaults.description_weight),
-        tags_weight: resolveWeight(tuning.tags_weight, defaults.tags_weight),
-        status_weight: resolveWeight(tuning.status_weight, defaults.status_weight),
-        body_weight: resolveWeight(tuning.body_weight, defaults.body_weight),
-        comments_weight: resolveWeight(tuning.comments_weight, defaults.comments_weight),
-        notes_weight: resolveWeight(tuning.notes_weight, defaults.notes_weight),
-        learnings_weight: resolveWeight(tuning.learnings_weight, defaults.learnings_weight),
-        reminders_weight: resolveWeight(tuning.reminders_weight, defaults.reminders_weight),
-        events_weight: resolveWeight(tuning.events_weight, defaults.events_weight),
-        dependencies_weight: resolveWeight(tuning.dependencies_weight, defaults.dependencies_weight),
-        linked_content_weight: resolveWeight(tuning.linked_content_weight, defaults.linked_content_weight),
-    };
-}
+!(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]="fdd0f9b0-bd89-5cc1-9b20-bea153f4d896")}catch(e2){}})();import{coerceNumberInRange}from"../../core/shared/primitives.js";import{resolveIsoOrRelative}from"../../core/shared/time.js";import{renderPmCommand}from"../command-line.js";import{EXIT_CODE,PmCliError}from"../runtime-primitives.js";import{DEFAULT_COMPACT_SEARCH_FIELDS,listSearchProjectionFields}from"./projection-contracts.js";import{DEFAULT_COMPACT_SEARCH_FIELDS as DEFAULT_COMPACT_SEARCH_FIELDS2,SEARCH_HIT_FIELD_KEYS,SEARCH_ITEM_FIELD_KEYS,listSearchProjectionFields as listSearchProjectionFields2}from"./projection-contracts.js";function parseSearchMode(raw){if(raw===void 0)return"keyword";const normalized=raw.trim().toLowerCase();if(normalized!=="keyword"&&normalized!=="semantic"&&normalized!=="hybrid"){throw new PmCliError("Search mode must be one of keyword|semantic|hybrid",EXIT_CODE.USAGE)}return normalized}function parseSearchBoolean(raw){return raw===true}function parseSemanticWeightOverride(raw){return coerceNumberInRange(raw,0,1)??void 0}function parseSearchMatchMode(raw){if(raw===void 0)return"or";const normalized=raw.trim().toLowerCase();if(normalized!=="and"&&normalized!=="or"&&normalized!=="exact"){throw new PmCliError("Search --match-mode must be one of and|or|exact",EXIT_CODE.USAGE)}return normalized}function parseMinScoreOverride(raw){if(raw===void 0||raw===null||raw==="")return void 0;const parsed=typeof raw==="number"?raw:Number(String(raw).trim());if(!Number.isFinite(parsed)||parsed<0){throw new PmCliError("Search --min-score must be a finite number >= 0",EXIT_CODE.USAGE)}return parsed}function parseTimestampWindow(raw,fieldLabel){if(raw==null)return void 0;const value=String(raw).trim();if(value.length===0)return void 0;return resolveIsoOrRelative(value,new Date,fieldLabel)}function normalizeSearchPhrase(value){return value.toLowerCase().replace(/\s+/g," ").trim()}function parseSearchDeadline(raw,fieldLabel){if(raw===void 0)return void 0;return resolveIsoOrRelative(raw,new Date,fieldLabel)}function parseFieldSelectors(raw){if(raw===void 0)return void 0;const selectors=raw.split(",").map(entry=>entry.trim()).filter(entry=>entry.length>0);if(selectors.length===0){throw new PmCliError("Search --fields requires a comma-separated list of field names",EXIT_CODE.USAGE)}return[...new Set(selectors)]}function parseSearchProjection(options,query="<query>"){const compactRequested=options.compact===true;const fullRequested=options.full===true;const fieldSelectors=parseFieldSelectors(options.fields);const enabledModes=Number(compactRequested)+Number(fullRequested)+Number(fieldSelectors!==void 0);if(enabledModes>1){throw new PmCliError("Search projection options are mutually exclusive. Use one of --compact, --full, or --fields.",EXIT_CODE.USAGE,{code:"projection_options_mutually_exclusive",recovery:{suggested_retry:renderPmCommand(["search",query,"--full"]),suggested_retry_args:["search",query,"--full"]}})}if(compactRequested){return{mode:"compact",fields:[...DEFAULT_COMPACT_SEARCH_FIELDS]}}if(fullRequested)return{mode:"full",fields:[]};if(fieldSelectors)return{mode:"fields",fields:fieldSelectors};return{mode:"full",fields:[]}}function validateSearchProjectionFields(projection,runtimeFieldRegistry,query="<query>"){if(projection.mode!=="fields")return;const allowedValues=listSearchProjectionFields(runtimeFieldRegistry.definitions.flatMap(field=>[field.key,field.metadata_key]));const allowed=new Set(allowedValues);const unknown=projection.fields.filter(field=>{const normalized=field.trim();return!allowed.has(normalized)});if(unknown.length>0){const suggestedRetryArguments=["search",query,"--fields","id,title,status,score"];throw new PmCliError(`Unknown search --fields value(s): ${unknown.join(", ")}`,EXIT_CODE.USAGE,{code:"unknown_field_projection",examples:["pm search <query> --fields id,title,status,score","pm search <query> --fields id,title,item.description,matched_fields"],nextSteps:["Use item.<field> for explicit item metadata fields, or run pm search --help for projection examples."],recovery:{allowed_values:allowedValues,suggested_retry:renderPmCommand(suggestedRetryArguments),suggested_retry_args:suggestedRetryArguments}})}}function parseSearchTokens(query){const normalized=normalizeSearchPhrase(query);if(!normalized){throw new PmCliError("Search query must not be empty",EXIT_CODE.USAGE)}return normalized.split(/\s+/u).filter(Boolean)}function resolveSearchMaxResults(settings){const candidate=settings.search?.max_results;if(typeof candidate==="number"&&Number.isFinite(candidate)&&candidate>0){return Math.floor(candidate)}return 50}function resolveSearchScoreThreshold(settings){const candidate=settings.search?.score_threshold;return typeof candidate==="number"&&Number.isFinite(candidate)?candidate:0}function resolveHybridSemanticWeight(settings){const candidate=settings.search?.hybrid_semantic_weight;if(typeof candidate==="number"&&Number.isFinite(candidate)&&candidate>=0&&candidate<=1){return candidate}return .7}function resolveSearchTuning(settings){const defaults={title_exact_bonus:10,title_weight:48,description_weight:5,tags_weight:6,status_weight:2,body_weight:1,comments_weight:1,notes_weight:1,learnings_weight:1,reminders_weight:2,events_weight:2,dependencies_weight:3,linked_content_weight:1};const tuning=settings.search?.tuning;if(!tuning)return defaults;const resolveWeight=(candidate,fallback)=>typeof candidate==="number"&&Number.isFinite(candidate)&&candidate>=0?candidate:fallback;return{title_exact_bonus:resolveWeight(tuning.title_exact_bonus,defaults.title_exact_bonus),title_weight:resolveWeight(tuning.title_weight,defaults.title_weight),description_weight:resolveWeight(tuning.description_weight,defaults.description_weight),tags_weight:resolveWeight(tuning.tags_weight,defaults.tags_weight),status_weight:resolveWeight(tuning.status_weight,defaults.status_weight),body_weight:resolveWeight(tuning.body_weight,defaults.body_weight),comments_weight:resolveWeight(tuning.comments_weight,defaults.comments_weight),notes_weight:resolveWeight(tuning.notes_weight,defaults.notes_weight),learnings_weight:resolveWeight(tuning.learnings_weight,defaults.learnings_weight),reminders_weight:resolveWeight(tuning.reminders_weight,defaults.reminders_weight),events_weight:resolveWeight(tuning.events_weight,defaults.events_weight),dependencies_weight:resolveWeight(tuning.dependencies_weight,defaults.dependencies_weight),linked_content_weight:resolveWeight(tuning.linked_content_weight,defaults.linked_content_weight)}}export{DEFAULT_COMPACT_SEARCH_FIELDS2 as DEFAULT_COMPACT_SEARCH_FIELDS,SEARCH_HIT_FIELD_KEYS,SEARCH_ITEM_FIELD_KEYS,listSearchProjectionFields2 as listSearchProjectionFields,normalizeSearchPhrase,parseMinScoreOverride,parseSearchBoolean,parseSearchDeadline,parseSearchMatchMode,parseSearchMode,parseSearchProjection,parseSearchTokens,parseSemanticWeightOverride,parseTimestampWindow,resolveHybridSemanticWeight,resolveSearchMaxResults,resolveSearchScoreThreshold,resolveSearchTuning,validateSearchProjectionFields};
 //# sourceMappingURL=search-contracts.js.map
-//# debugId=d20ab01b-a8ae-5fe8-988a-d05fe87951f6

package/dist/sdk/query/search-pagination.js

@@ -1,36 +1,2 @@
-/**
- * @module sdk/query/search-pagination
- *
- * Applies the shared SDK cursor contract to ranked search results.
- */
-
-!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]="0fc9ed92-daf5-5fa2-b9a4-ee6c36256ed1")}catch(e){}}();
-import { createQueryFingerprint, paginateQueryRows, selectCursorSemanticOptions, } from "../pagination.js";
-import { SEARCH_FLAG_CONTRACTS } from "../cli-contracts/flag-contracts.js";
-/** Build the query-only fingerprint shared by search retrieval and paging. */
-export function createSearchCursorFingerprint(options) {
-    return createQueryFingerprint("search", {
-        query: options.query.trim(),
-        mode: options.mode,
-        options: selectCursorSemanticOptions(options.searchOptions, SEARCH_FLAG_CONTRACTS),
-    });
-}
-/** Page ranked search hits without coupling cursor mechanics to search scoring. */
-export function resolveSearchPage(options) {
-    const page = paginateQueryRows(options.sorted, {
-        cursor: options.searchOptions.after,
-        fingerprint: createSearchCursorFingerprint(options),
-        limit: options.limit,
-        readId: (hit) => hit.item.id,
-    });
-    return {
-        limited: page.rows,
-        pageExtras: {
-            applied_limit: options.limit,
-            ...(page.has_more ? { has_more: true, truncated: true } : {}),
-            ...(page.next_cursor ? { next_cursor: page.next_cursor } : {}),
-        },
-    };
-}
+!(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]="91b01dd0-6a8d-5b97-96d2-c27f4044c009")}catch(e2){}})();import{createQueryFingerprint,paginateQueryRows,selectCursorSemanticOptions}from"../pagination.js";import{SEARCH_FLAG_CONTRACTS}from"../cli-contracts/flag-contracts.js";function createSearchCursorFingerprint(options){return createQueryFingerprint("search",{query:options.query.trim(),mode:options.mode,options:selectCursorSemanticOptions(options.searchOptions,SEARCH_FLAG_CONTRACTS)})}function resolveSearchPage(options){const page=paginateQueryRows(options.sorted,{cursor:options.searchOptions.after,fingerprint:createSearchCursorFingerprint(options),limit:options.limit,readId:hit=>hit.item.id});return{limited:page.rows,pageExtras:{applied_limit:options.limit,...page.has_more?{has_more:true,truncated:true}:{},...page.next_cursor?{next_cursor:page.next_cursor}:{}}}}export{createSearchCursorFingerprint,resolveSearchPage};
 //# sourceMappingURL=search-pagination.js.map
-//# debugId=0fc9ed92-daf5-5fa2-b9a4-ee6c36256ed1

package/dist/sdk/query/search-rendering.js

@@ -1,106 +1,2 @@
-/**
- * @module sdk/query/search-rendering
- *
- * Builds stable compact and verbose filter projections for search responses.
- */
-
-!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]="b0abcc02-bd6e-536a-b876-e13cfc8ea741")}catch(e){}}();
-import { applyFilterValueEcho, buildContentFilterEcho, buildGovernanceMissingFilterEcho, } from "./list.js";
-function isAllStatuses(value) {
-    if (typeof value !== "string")
-        return false;
-    const tokens = value
-        .split(",")
-        .map((entry) => entry.trim().toLowerCase())
-        .filter(Boolean);
-    return tokens.length === 1 && tokens[0] === "all";
-}
-const COMPACT_SEARCH_VALUE_FILTER_ECHO_ENTRIES = [
-    {
-        optionKey: "status",
-        summaryKey: "status",
-        normalize: (value) => (isAllStatuses(value) ? "all" : value),
-    },
-    { optionKey: "type", summaryKey: "type" },
-    { optionKey: "tag", summaryKey: "tag" },
-    { optionKey: "priority", summaryKey: "priority" },
-    { optionKey: "deadlineBefore", summaryKey: "deadline_before" },
-    { optionKey: "deadlineAfter", summaryKey: "deadline_after" },
-    { optionKey: "updatedAfter", summaryKey: "updated_after" },
-    { optionKey: "updatedBefore", summaryKey: "updated_before" },
-    { optionKey: "createdAfter", summaryKey: "created_after" },
-    { optionKey: "createdBefore", summaryKey: "created_before" },
-    { optionKey: "assignee", summaryKey: "assignee" },
-    { optionKey: "sprint", summaryKey: "sprint" },
-    { optionKey: "release", summaryKey: "release" },
-    { optionKey: "parent", summaryKey: "parent" },
-];
-/** Builds the token-efficient filter echo used by compact search results. */
-export function buildCompactSearchFilterSummary(params) {
-    const { mode, matchMode, options, includeLinked, titleExact, phraseExact, scoreThreshold, hybridSemanticWeight, runtimeFieldFilters } = params;
-    const filters = {};
-    applyFilterValueEcho(filters, options, COMPACT_SEARCH_VALUE_FILTER_ECHO_ENTRIES);
-    Object.assign(filters, buildGovernanceMissingFilterEcho(options));
-    Object.assign(filters, buildContentFilterEcho(options));
-    if (matchMode !== undefined && matchMode !== "or") {
-        filters.match_mode = matchMode;
-    }
-    if (includeLinked)
-        filters.include_linked = true;
-    if (titleExact)
-        filters.title_exact = true;
-    if (phraseExact)
-        filters.phrase_exact = true;
-    if (scoreThreshold > 0)
-        filters.score_threshold = scoreThreshold;
-    if (mode === "hybrid" && options.semanticWeight !== undefined) {
-        filters.hybrid_semantic_weight = hybridSemanticWeight;
-    }
-    if (options.limit !== undefined)
-        filters.limit = options.limit;
-    if (runtimeFieldFilters && Object.keys(runtimeFieldFilters).length > 0) {
-        filters.runtime_filters = runtimeFieldFilters;
-    }
-    return filters;
-}
-/** Builds the complete filter echo shared by verbose search response paths. */
-export function buildVerboseSearchFilters(params) {
-    const { effectiveMode, matchMode, options, includeLinked, titleExact, phraseExact, scoreThreshold, hybridSemanticWeight, queryExpansion, rerank, runtimeFieldFilters } = params;
-    const valueOrNull = (value) => value ?? null;
-    return {
-        mode: effectiveMode,
-        match_mode: matchMode,
-        status: options.status === undefined || isAllStatuses(options.status)
-            ? "all"
-            : options.status,
-        type: valueOrNull(options.type),
-        tag: valueOrNull(options.tag),
-        priority: valueOrNull(options.priority),
-        deadline_before: valueOrNull(options.deadlineBefore),
-        deadline_after: valueOrNull(options.deadlineAfter),
-        updated_after: valueOrNull(options.updatedAfter),
-        updated_before: valueOrNull(options.updatedBefore),
-        created_after: valueOrNull(options.createdAfter),
-        created_before: valueOrNull(options.createdBefore),
-        assignee: valueOrNull(options.assignee),
-        sprint: valueOrNull(options.sprint),
-        release: valueOrNull(options.release),
-        parent: valueOrNull(options.parent),
-        ...buildGovernanceMissingFilterEcho(options),
-        ...buildContentFilterEcho(options),
-        include_linked: includeLinked,
-        title_exact: titleExact,
-        phrase_exact: phraseExact,
-        score_threshold: scoreThreshold,
-        hybrid_semantic_weight: effectiveMode === "hybrid" ? hybridSemanticWeight : null,
-        query_expansion_enabled: queryExpansion.enabled,
-        query_expansion_provider: queryExpansion.provider,
-        rerank_enabled: rerank.enabled,
-        rerank_model: rerank.model,
-        rerank_top_k: rerank.top_k,
-        limit: valueOrNull(options.limit),
-        runtime_filters: runtimeFieldFilters,
-    };
-}
+!(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]="48888c80-60e1-5905-afd5-8c1b6e532f99")}catch(e2){}})();import{applyFilterValueEcho,buildContentFilterEcho,buildGovernanceMissingFilterEcho}from"./list.js";function isAllStatuses(value){if(typeof value!=="string")return false;const tokens=value.split(",").map(entry=>entry.trim().toLowerCase()).filter(Boolean);return tokens.length===1&&tokens[0]==="all"}const COMPACT_SEARCH_VALUE_FILTER_ECHO_ENTRIES=[{optionKey:"status",summaryKey:"status",normalize:value=>isAllStatuses(value)?"all":value},{optionKey:"type",summaryKey:"type"},{optionKey:"tag",summaryKey:"tag"},{optionKey:"priority",summaryKey:"priority"},{optionKey:"deadlineBefore",summaryKey:"deadline_before"},{optionKey:"deadlineAfter",summaryKey:"deadline_after"},{optionKey:"updatedAfter",summaryKey:"updated_after"},{optionKey:"updatedBefore",summaryKey:"updated_before"},{optionKey:"createdAfter",summaryKey:"created_after"},{optionKey:"createdBefore",summaryKey:"created_before"},{optionKey:"assignee",summaryKey:"assignee"},{optionKey:"sprint",summaryKey:"sprint"},{optionKey:"release",summaryKey:"release"},{optionKey:"parent",summaryKey:"parent"}];function buildCompactSearchFilterSummary(params){const{mode,matchMode,options,includeLinked,titleExact,phraseExact,scoreThreshold,hybridSemanticWeight,runtimeFieldFilters}=params;const filters={};applyFilterValueEcho(filters,options,COMPACT_SEARCH_VALUE_FILTER_ECHO_ENTRIES);Object.assign(filters,buildGovernanceMissingFilterEcho(options));Object.assign(filters,buildContentFilterEcho(options));if(matchMode!==void 0&&matchMode!=="or"){filters.match_mode=matchMode}if(includeLinked)filters.include_linked=true;if(titleExact)filters.title_exact=true;if(phraseExact)filters.phrase_exact=true;if(scoreThreshold>0)filters.score_threshold=scoreThreshold;if(mode==="hybrid"&&options.semanticWeight!==void 0){filters.hybrid_semantic_weight=hybridSemanticWeight}if(options.limit!==void 0)filters.limit=options.limit;if(runtimeFieldFilters&&Object.keys(runtimeFieldFilters).length>0){filters.runtime_filters=runtimeFieldFilters}return filters}function buildVerboseSearchFilters(params){const{effectiveMode,matchMode,options,includeLinked,titleExact,phraseExact,scoreThreshold,hybridSemanticWeight,queryExpansion,rerank,runtimeFieldFilters}=params;const valueOrNull=value=>value??null;return{mode:effectiveMode,match_mode:matchMode,status:options.status===void 0||isAllStatuses(options.status)?"all":options.status,type:valueOrNull(options.type),tag:valueOrNull(options.tag),priority:valueOrNull(options.priority),deadline_before:valueOrNull(options.deadlineBefore),deadline_after:valueOrNull(options.deadlineAfter),updated_after:valueOrNull(options.updatedAfter),updated_before:valueOrNull(options.updatedBefore),created_after:valueOrNull(options.createdAfter),created_before:valueOrNull(options.createdBefore),assignee:valueOrNull(options.assignee),sprint:valueOrNull(options.sprint),release:valueOrNull(options.release),parent:valueOrNull(options.parent),...buildGovernanceMissingFilterEcho(options),...buildContentFilterEcho(options),include_linked:includeLinked,title_exact:titleExact,phrase_exact:phraseExact,score_threshold:scoreThreshold,hybrid_semantic_weight:effectiveMode==="hybrid"?hybridSemanticWeight:null,query_expansion_enabled:queryExpansion.enabled,query_expansion_provider:queryExpansion.provider,rerank_enabled:rerank.enabled,rerank_model:rerank.model,rerank_top_k:rerank.top_k,limit:valueOrNull(options.limit),runtime_filters:runtimeFieldFilters}}export{buildCompactSearchFilterSummary,buildVerboseSearchFilters};
 //# sourceMappingURL=search-rendering.js.map
-//# debugId=b0abcc02-bd6e-536a-b876-e13cfc8ea741