@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/query/duplicate-candidates.js

@@ -1,71 +1,2 @@
-/**
- * @module sdk/query/duplicate-candidates
- *
- * Lossless prefix filtering for Jaccard joins. A globally ordered prefix of
- * length n-ceil(threshold*n)+1 must intersect the corresponding prefix of
- * every qualifying set. Exact titles and issue codes remain independent
- * signals, including titles with no word tokens.
- */
-
-!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]="d425cf45-5b62-5613-a5ce-78da6b0e201b")}catch(e){}}();
-import { EXIT_CODE } from "../../core/shared/constants.js";
-import { PmCliError } from "../../core/shared/errors.js";
-/** Declared safety bound applies to retained pairs, never silently to recall. */
-export const MAX_DUPLICATE_CANDIDATE_PAIRS = 1_000_000;
-/** Generate every potentially qualifying pair once, with an explicit exhaustive oracle. */
-export function collectDuplicateCandidatePairs(items, maxPairs = MAX_DUPLICATE_CANDIDATE_PAIRS, threshold = 0.8, exhaustive = false) {
-    const candidates = new Set();
-    /** Deduplicate a candidate pair and refuse before publishing an over-budget result. */
-    const add = (left, right) => {
-        candidates.add(`${left}:${right}`);
-        if (candidates.size > maxPairs) {
-            throw new PmCliError(`Duplicate sweep exceeded ${maxPairs} candidate pairs; narrow it with statuses or since.`, EXIT_CODE.CONFLICT, { code: "duplicate_sweep_cost_limit", required: "Narrow the duplicate query or increase its similarity threshold. No partial result was returned." });
-        }
-    };
-    if (exhaustive || threshold === 0) {
-        for (let right = 0; right < items.length; right += 1) {
-            for (let left = 0; left < right; left += 1)
-                add(left, right);
-        }
-        return candidates;
-    }
-    const frequencies = new Map();
-    for (const { prepared } of items) {
-        for (const token of prepared.tokens)
-            frequencies.set(token, (frequencies.get(token) ?? 0) + 1);
-    }
-    const exact = new Map();
-    const codes = new Map();
-    const prefixes = new Map();
-    for (const [right, { prepared }] of items.entries()) {
-        const tokens = [...prepared.tokens].sort((left, other) => frequencies.get(left) - frequencies.get(other) || left.localeCompare(other));
-        // An epsilon expands rather than shrinks the prefix at floating boundaries.
-        const prefixLength = tokens.length - Math.ceil(threshold * tokens.length - 1e-12) + 1;
-        const signals = [
-            { index: exact, keys: [prepared.normalized], lengthFilter: false },
-            { index: codes, keys: threshold <= 0.99 ? prepared.issueCodes : [], lengthFilter: false },
-            { index: prefixes, keys: tokens.length === 0 ? [""] : tokens.slice(0, prefixLength), lengthFilter: true },
-        ];
-        for (const signal of signals) {
-            appendPostingCandidates(items, right, signal, threshold, add);
-        }
-    }
-    return candidates;
-}
-/** Join one exact/code/prefix posting list, applying the Jaccard length bound only to tokens. */
-function appendPostingCandidates(items, right, signal, threshold, add) {
-    const rightLength = items[right].prepared.tokens.length;
-    for (const key of signal.keys) {
-        const posting = signal.index.get(key) ?? [];
-        for (const left of posting) {
-            const leftLength = items[left].prepared.tokens.length;
-            if (signal.lengthFilter && Math.min(leftLength, rightLength) / Math.max(leftLength, rightLength) + 1e-12 < threshold)
-                continue;
-            add(left, right);
-        }
-        posting.push(right);
-        signal.index.set(key, posting);
-    }
-}
+!(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]="4e54ed7b-3bab-51a2-912b-1284eaf8187a")}catch(e2){}})();import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";const MAX_DUPLICATE_CANDIDATE_PAIRS=1e6;function collectDuplicateCandidatePairs(items,maxPairs=MAX_DUPLICATE_CANDIDATE_PAIRS,threshold=.8,exhaustive=false){const candidates=new Set;const add=(left,right)=>{candidates.add(`${left}:${right}`);if(candidates.size>maxPairs){throw new PmCliError(`Duplicate sweep exceeded ${maxPairs} candidate pairs; narrow it with statuses or since.`,EXIT_CODE.CONFLICT,{code:"duplicate_sweep_cost_limit",required:"Narrow the duplicate query or increase its similarity threshold. No partial result was returned."})}};if(exhaustive||threshold===0){for(let right=0;right<items.length;right+=1){for(let left=0;left<right;left+=1)add(left,right)}return candidates}const frequencies=new Map;for(const{prepared}of items){for(const token of prepared.tokens)frequencies.set(token,(frequencies.get(token)??0)+1)}const exact=new Map;const codes=new Map;const prefixes=new Map;for(const[right,{prepared}]of items.entries()){const tokens=[...prepared.tokens].sort((left,other)=>frequencies.get(left)-frequencies.get(other)||left.localeCompare(other));const prefixLength=tokens.length-Math.ceil(threshold*tokens.length-1e-12)+1;const signals=[{index:exact,keys:[prepared.normalized],lengthFilter:false},{index:codes,keys:threshold<=.99?prepared.issueCodes:[],lengthFilter:false},{index:prefixes,keys:tokens.length===0?[""]:tokens.slice(0,prefixLength),lengthFilter:true}];for(const signal of signals){appendPostingCandidates(items,right,signal,threshold,add)}}return candidates}function appendPostingCandidates(items,right,signal,threshold,add){const rightLength=items[right].prepared.tokens.length;for(const key of signal.keys){const posting=signal.index.get(key)??[];for(const left of posting){const leftLength=items[left].prepared.tokens.length;if(signal.lengthFilter&&Math.min(leftLength,rightLength)/Math.max(leftLength,rightLength)+1e-12<threshold)continue;add(left,right)}posting.push(right);signal.index.set(key,posting)}}export{MAX_DUPLICATE_CANDIDATE_PAIRS,collectDuplicateCandidatePairs};
 //# sourceMappingURL=duplicate-candidates.js.map
-//# debugId=d425cf45-5b62-5613-a5ce-78da6b0e201b

package/dist/sdk/query/get.js

@@ -1,451 +1,2 @@
-/**
- * @module sdk/query/get
- *
- * Implements the SDK-owned item query shared by every surface.
- */
-
-!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]="88732a1d-ae5a-5dfb-93d6-9659cb6f05c3")}catch(e){}}();
-import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import { getActiveExtensionRegistrations, toItemRecord, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, EXIT_CODE, TYPE_TO_FOLDER, PmCliError, buildItemNotFoundError, listAllItemMetadataLight, locateItem, readLocatedItem, getHistoryPath, resolvePmRoot, readSettings, resolveAuthor, } from "../runtime-primitives.js";
-import { readHistoryEntries } from "../history-read.js";
-import { renderPmCommand } from "../command-line.js";
-import { recordContextUsageTouches } from "../context-usage.js";
-import { buildItemChildrenRollup, } from "../item-children.js";
-import { buildItemSchedule, } from "../item-schedule.js";
-import { getItemAt } from "../history-read.js";
-import { parseIntegerLimit } from "./parsers.js";
-import { runList } from "./list.js";
-import { registerOutputMaterialFieldGroups } from "../output-projection.js";
-import { GET_DEPTH_VALUES, listGetProjectionFields, } from "./projection-contracts.js";
-export { GET_DEPTH_VALUES, listGetProjectionFields, } from "./projection-contracts.js";
-const AUTOMATIC_CHILD_ROLLUP_TYPES = new Set([
-    "epic",
-    "feature",
-    "milestone",
-    "plan",
-]);
-const BUILTIN_ITEM_TYPES = new Set(Object.keys(TYPE_TO_FOLDER).map((type) => type.toLowerCase()));
-function itemCollectionCounts(item) {
-    const lengths = Object.fromEntries([
-        "comments",
-        "notes",
-        "learnings",
-        "files",
-        "tests",
-        "docs",
-        "reminders",
-        "events",
-    ].map((key) => [
-        key,
-        item[key]
-            ?.length ?? 0,
-    ]));
-    return lengths;
-}
-function itemMaterialFieldGroups(item, body) {
-    const collectionCounts = itemCollectionCounts(item);
-    return [
-        ...(body.length > 0 ? ["body"] : []),
-        ...Object.entries(collectionCounts).flatMap(([name, count]) => count > 0 ? [name] : []),
-        ...(collectionCounts.files +
-            collectionCounts.tests +
-            collectionCounts.docs >
-            0
-            ? ["linked"]
-            : []),
-        "children",
-        ...(typeof item.assignee === "string" && item.assignee.trim().length > 0
-            ? ["claim_state"]
-            : []),
-        ...(buildItemSchedule(item) ? ["schedule"] : []),
-    ];
-}
-/** Decide whether a normal read should pay for a workspace-wide child projection. */
-function shouldAutoIncludeGetChildren(itemType) {
-    const normalizedType = itemType.trim().toLowerCase();
-    return (normalizedType.length > 0 &&
-        (AUTOMATIC_CHILD_ROLLUP_TYPES.has(normalizedType) ||
-            !BUILTIN_ITEM_TYPES.has(normalizedType)));
-}
-function toClaimHistoryContext(entry) {
-    return {
-        ts: entry.ts,
-        author: entry.author,
-        message: entry.message ?? null,
-    };
-}
-function resolveClaimStateContext(assigneeValue, history) {
-    const assignee = assigneeValue?.trim();
-    const normalizedAssignee = assignee && assignee.length > 0 ? assignee : null;
-    const lastClaim = [...history]
-        .reverse()
-        .find((entry) => entry.op === "claim");
-    const lastRelease = [...history]
-        .reverse()
-        .find((entry) => entry.op === "release");
-    return {
-        claimed: normalizedAssignee !== null,
-        assignee: normalizedAssignee,
-        last_claim: lastClaim ? toClaimHistoryContext(lastClaim) : null,
-        last_release: lastRelease ? toClaimHistoryContext(lastRelease) : null,
-    };
-}
-function parseGetDepth(raw) {
-    if (raw === undefined || raw.trim().length === 0) {
-        return "standard";
-    }
-    const normalized = raw.trim().toLowerCase();
-    if (normalized === "full") {
-        return "deep";
-    }
-    if (GET_DEPTH_VALUES.includes(normalized)) {
-        return normalized;
-    }
-    throw new PmCliError("Get --depth must be one of brief|standard|deep|full", EXIT_CODE.USAGE);
-}
-function projectItemForDepth(item, depth) {
-    const collectionCounts = itemCollectionCounts(item);
-    if (depth === "deep") {
-        return {
-            ...item,
-            comments: item.comments ?? [],
-            notes: item.notes ?? [],
-            learnings: item.learnings ?? [],
-            files: item.files ?? [],
-            tests: item.tests ?? [],
-            docs: item.docs ?? [],
-            reminders: item.reminders ?? [],
-            events: item.events ?? [],
-            notes_count: collectionCounts.notes,
-            tests_count: collectionCounts.tests,
-            collection_counts: collectionCounts,
-        };
-    }
-    const { comments: _comments, notes: _notes, learnings: _learnings, files: _files, tests: _tests, docs: _docs, reminders: _reminders, events: _events, ...projected } = item;
-    return {
-        ...projected,
-        notes_count: item.notes?.length ?? 0,
-        tests_count: item.tests?.length ?? 0,
-        collection_counts: collectionCounts,
-    };
-}
-function parseGetFields(raw) {
-    if (raw === undefined) {
-        return null;
-    }
-    const fields = raw
-        .split(",")
-        .map((entry) => entry.trim())
-        .filter((entry) => entry.length > 0);
-    if (fields.length === 0) {
-        throw new PmCliError("Get --fields requires a comma-separated list of field names", EXIT_CODE.USAGE);
-    }
-    return fields;
-}
-function normalizeGetField(field) {
-    return field.startsWith("item.") ? field.slice("item.".length) : field;
-}
-function validateGetFields(fields, runtimeMetadataKeys, id) {
-    if (fields === null) {
-        return;
-    }
-    const allowedValues = listGetProjectionFields(runtimeMetadataKeys);
-    const allowed = new Set(allowedValues);
-    const unknown = fields.filter((field) => {
-        const normalized = normalizeGetField(field);
-        return (!allowed.has(field) &&
-            !allowed.has(normalized));
-    });
-    if (unknown.length > 0) {
-        const suggestedRetryArguments = [
-            "get",
-            id,
-            "--fields",
-            "id,title,status",
-        ];
-        throw new PmCliError(`Unknown get --fields value(s): ${unknown.join(", ")}`, EXIT_CODE.USAGE, {
-            code: "unknown_field_projection",
-            examples: [
-                "pm get <id> --fields id,title,status,type,updated_at",
-                "pm get <id> --fields id,title,claim_state",
-                "pm get <id> --fields id,title,body,linked.files",
-            ],
-            recovery: {
-                allowed_values: allowedValues,
-                suggested_retry: renderPmCommand(suggestedRetryArguments),
-                suggested_retry_args: suggestedRetryArguments,
-            },
-        });
-    }
-}
-const EMPTY_PROJECTED_COLLECTION_FIELDS = new Set([
-    "comments",
-    "notes",
-    "learnings",
-    "files",
-    "tests",
-    "test_runs",
-    "docs",
-    "reminders",
-    "events",
-    "dependencies",
-    "plan_steps",
-    "plan_decisions",
-    "plan_discoveries",
-    "plan_validation",
-]);
-/** Resolve one projected metadata value while distinguishing an empty requested collection from an omitted field. */
-function projectedMetadataValue(source, counts, field) {
-    if (Object.hasOwn(counts, field))
-        return counts[field];
-    if (source[field] !== undefined)
-        return source[field];
-    return EMPTY_PROJECTED_COLLECTION_FIELDS.has(field) ? [] : undefined;
-}
-function projectItemForFields(item, fields) {
-    const source = toItemRecord(item);
-    const omittedCounts = {
-        notes_count: item.notes?.length ?? 0,
-        tests_count: item.tests?.length ?? 0,
-        collection_counts: itemCollectionCounts(item),
-    };
-    const projected = { id: item.id };
-    for (const field of fields) {
-        const normalized = normalizeGetField(field);
-        if (normalized === "body" ||
-            normalized === "linked" ||
-            normalized.startsWith("linked.") ||
-            normalized === "claim_state" ||
-            normalized.startsWith("claim_state.") ||
-            normalized === "children" ||
-            normalized.startsWith("children.") ||
-            normalized === "schedule" ||
-            normalized.startsWith("schedule.")) {
-            continue;
-        }
-        projected[normalized] = projectedMetadataValue(source, omittedCounts, normalized);
-    }
-    return projected;
-}
-function fieldsInclude(fields, name) {
-    return (fields?.some((field) => field === name || field === `item.${name}`) ?? false);
-}
-function fieldsIncludeRoot(fields, name) {
-    return fields.some((field) => {
-        const normalized = normalizeGetField(field);
-        return normalized === name || normalized.startsWith(`${name}.`);
-    });
-}
-function resolveGetProjection(options, id) {
-    if (options.full &&
-        (options.fields !== undefined || options.depth !== undefined)) {
-        throw new PmCliError("Get projection options are mutually exclusive; remove the extra projection flag and retry.", EXIT_CODE.USAGE, {
-            code: "projection_options_mutually_exclusive",
-            recovery: {
-                suggested_retry: renderPmCommand(["get", id, "--full"]),
-                suggested_retry_args: ["get", id, "--full"],
-            },
-        });
-    }
-    if (options.tree !== true && options.treeDepth !== undefined) {
-        throw new PmCliError("Get --tree-depth requires --tree", EXIT_CODE.USAGE);
-    }
-    if (options.at !== undefined && options.tree === true) {
-        throw new PmCliError("Get --at cannot be combined with --tree because workspace-level historical projections are not yet indexed.", EXIT_CODE.USAGE);
-    }
-    return {
-        depth: options.full ? "deep" : parseGetDepth(options.depth),
-        treeDepth: options.tree === true
-            ? parseIntegerLimit(options.treeDepth, "--tree-depth")
-            : undefined,
-        fields: parseGetFields(options.fields),
-        fieldProjection: options.fields !== undefined,
-    };
-}
-async function loadGetItemContext(id, global, at) {
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    await assertInitializedTracker(pmRoot);
-    const settings = await readSettings(pmRoot);
-    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-    if (at !== undefined) {
-        const historical = await getItemAt(id, at, { pmRoot: global.path });
-        return {
-            pmRoot,
-            settings,
-            typeToFolder: typeRegistry.type_to_folder,
-            locatedId: historical.document.metadata.id,
-            metadata: historical.document.metadata,
-            body: historical.document.body,
-            historical,
-        };
-    }
-    const located = await locateItem(pmRoot, id, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
-    if (!located) {
-        throw await buildItemNotFoundError(pmRoot, id, settings.id_prefix, typeRegistry.type_to_folder);
-    }
-    const loaded = await readLocatedItem(located, { schema: settings.schema });
-    return {
-        pmRoot,
-        settings,
-        typeToFolder: typeRegistry.type_to_folder,
-        locatedId: located.id,
-        metadata: loaded.document.metadata,
-        body: loaded.document.body,
-    };
-}
-function validateGetProjectionFields(fields, settings, historical, id) {
-    const runtimeMetadataKeys = resolveRuntimeFieldRegistry(settings.schema).definitions.map((field) => field.metadata_key);
-    validateGetFields(fields, runtimeMetadataKeys, id);
-    if (historical && fieldsIncludeRoot(fields ?? [], "children")) {
-        throw new PmCliError("Get --at cannot project children because workspace-level historical relationships are not yet indexed.", EXIT_CODE.USAGE);
-    }
-}
-function shouldIncludeGetField(params) {
-    const { fieldProjection, depth, fields, field } = params;
-    if (fieldProjection) {
-        if (field === "body" || field === "linked") {
-            return fieldsInclude(fields, field);
-        }
-        return fieldsIncludeRoot(fields, field);
-    }
-    return depth !== "brief";
-}
-/** Derive claim evidence from the selected physical history prefix, excluding future claims. */
-async function resolveGetClaimState(context, includeClaimState) {
-    if (!includeClaimState) {
-        return undefined;
-    }
-    const historyPath = getHistoryPath(context.pmRoot, context.locatedId);
-    const history = await readHistoryEntries(historyPath, context.locatedId);
-    return resolveClaimStateContext(context.metadata.assignee, context.historical
-        ? history.slice(0, context.historical.target.historyIndex + 1)
-        : history);
-}
-function attachGetLinked(result, context, fields, includeLinked) {
-    const includeLinkedFiles = includeLinked || fieldsInclude(fields, "linked.files");
-    const includeLinkedTests = includeLinked || fieldsInclude(fields, "linked.tests");
-    const includeLinkedDocs = includeLinked || fieldsInclude(fields, "linked.docs");
-    if (!includeLinked &&
-        !includeLinkedFiles &&
-        !includeLinkedTests &&
-        !includeLinkedDocs) {
-        return;
-    }
-    result.linked = {
-        files: includeLinkedFiles ? (context.metadata.files ?? []) : [],
-        tests: includeLinkedTests ? (context.metadata.tests ?? []) : [],
-        docs: includeLinkedDocs ? (context.metadata.docs ?? []) : [],
-    };
-}
-/** Enumerate hierarchy metadata only when the caller explicitly requested a child rollup. */
-async function buildGetChildrenRollup(context, includeChildren) {
-    if (!includeChildren) {
-        return undefined;
-    }
-    const statusRegistry = resolveRuntimeStatusRegistry(context.settings.schema);
-    const corpus = await listAllItemMetadataLight(context.pmRoot, context.settings.item_format, context.typeToFolder, undefined, context.settings.schema);
-    return buildItemChildrenRollup(context.locatedId, corpus, statusRegistry);
-}
-function attachGetSchedule(result, context, fields, includeSchedule) {
-    if (!includeSchedule) {
-        return;
-    }
-    const schedule = buildItemSchedule(context.metadata);
-    if (!schedule) {
-        return;
-    }
-    if (fields === null || fieldsInclude(fields, "schedule")) {
-        result.schedule = schedule;
-        return;
-    }
-    result.schedule = Object.fromEntries(Object.entries(schedule).filter(([key]) => fields.some((field) => normalizeGetField(field) === `schedule.${key}`)));
-}
-async function buildGetTree(context, options, treeDepth, global) {
-    if (options.tree !== true) {
-        return undefined;
-    }
-    const subtree = await runList(undefined, {
-        parent: context.locatedId,
-        tree: true,
-        treeDepth: treeDepth === undefined ? undefined : String(treeDepth),
-        full: true,
-    }, global);
-    return {
-        root_id: context.locatedId,
-        root_title: context.metadata.title,
-        depth_limit: treeDepth ?? null,
-        count: subtree.count,
-        items: subtree.items.map((entry) => toItemRecord(entry)),
-    };
-}
-/** Implements run get for the public runtime surface of this module. */
-export async function runGet(id, global, options = {}) {
-    const projection = resolveGetProjection(options, id);
-    const context = await loadGetItemContext(id, global, options.at);
-    validateGetProjectionFields(projection.fields, context.settings, context.historical !== undefined, context.locatedId);
-    const includeBody = shouldIncludeGetField({ ...projection, field: "body" });
-    const includeLinked = shouldIncludeGetField({
-        ...projection,
-        field: "linked",
-    });
-    const includeClaimState = shouldIncludeGetField({
-        ...projection,
-        field: "claim_state",
-    });
-    const includeChildren = context.historical === undefined &&
-        (projection.fieldProjection
-            ? fieldsIncludeRoot(projection.fields, "children")
-            : projection.depth === "deep" &&
-                shouldAutoIncludeGetChildren(context.metadata.type));
-    const includeSchedule = projection.fieldProjection
-        ? fieldsIncludeRoot(projection.fields, "schedule")
-        : projection.depth !== "brief";
-    const claimState = await resolveGetClaimState(context, includeClaimState);
-    const result = {
-        item: projection.fieldProjection
-            ? projectItemForFields(context.metadata, projection.fields)
-            : projectItemForDepth(context.metadata, projection.depth),
-    };
-    if (includeBody) {
-        result.item.body = context.body;
-    }
-    attachGetLinked(result, context, projection.fields, includeLinked);
-    if (claimState) {
-        result.claim_state = claimState;
-    }
-    attachGetSchedule(result, context, projection.fields, includeSchedule);
-    const children = await buildGetChildrenRollup(context, includeChildren);
-    if (children !== undefined) {
-        result.children = children;
-    }
-    const tree = await buildGetTree(context, options, projection.treeDepth, global);
-    if (tree !== undefined) {
-        result.tree = tree;
-    }
-    if (context.historical) {
-        result.reconstructed = true;
-        result.as_of_version = context.historical.as_of_version;
-        result.as_of_timestamp = context.historical.as_of_timestamp;
-    }
-    if (context.historical === undefined) {
-        try {
-            await recordContextUsageTouches({
-                pmRoot: context.pmRoot,
-                author: resolveAuthor(undefined, context.settings.author_default),
-                itemIds: [context.locatedId],
-                intent: "get",
-            });
-        }
-        catch {
-            // Derived usage feedback must never make the source-of-truth read fail.
-        }
-    }
-    registerOutputMaterialFieldGroups(result, itemMaterialFieldGroups(context.metadata, context.body));
-    return result;
-}
-/** Public contract for test-only get command policy helpers. */
-export const _testOnlyGetCommand = {
-    shouldAutoIncludeGetChildren,
-};
+!(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]="26bf8487-2515-5885-b6de-56ba6292fb65")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{getActiveExtensionRegistrations,toItemRecord,resolveItemTypeRegistry,resolveRuntimeFieldRegistry,resolveRuntimeStatusRegistry,EXIT_CODE,TYPE_TO_FOLDER,PmCliError,buildItemNotFoundError,listAllItemMetadataLight,locateItem,readLocatedItem,getHistoryPath,resolvePmRoot,readSettings,resolveAuthor}from"../runtime-primitives.js";import{readHistoryEntries}from"../history-read.js";import{renderPmCommand}from"../command-line.js";import{recordContextUsageTouches}from"../context-usage.js";import{buildItemChildrenRollup}from"../item-children.js";import{buildItemSchedule}from"../item-schedule.js";import{getItemAt}from"../history-read.js";import{parseIntegerLimit}from"./parsers.js";import{runList}from"./list.js";import{registerOutputMaterialFieldGroups}from"../output-projection.js";import{GET_DEPTH_VALUES,listGetProjectionFields}from"./projection-contracts.js";import{GET_DEPTH_VALUES as GET_DEPTH_VALUES2,listGetProjectionFields as listGetProjectionFields2}from"./projection-contracts.js";const AUTOMATIC_CHILD_ROLLUP_TYPES=new Set(["epic","feature","milestone","plan"]);const BUILTIN_ITEM_TYPES=new Set(Object.keys(TYPE_TO_FOLDER).map(type=>type.toLowerCase()));function itemCollectionCounts(item){const lengths=Object.fromEntries(["comments","notes","learnings","files","tests","docs","reminders","events"].map(key=>[key,item[key]?.length??0]));return lengths}function itemMaterialFieldGroups(item,body){const collectionCounts=itemCollectionCounts(item);return[...body.length>0?["body"]:[],...Object.entries(collectionCounts).flatMap(([name,count])=>count>0?[name]:[]),...collectionCounts.files+collectionCounts.tests+collectionCounts.docs>0?["linked"]:[],"children",...typeof item.assignee==="string"&&item.assignee.trim().length>0?["claim_state"]:[],...buildItemSchedule(item)?["schedule"]:[]]}function shouldAutoIncludeGetChildren(itemType){const normalizedType=itemType.trim().toLowerCase();return normalizedType.length>0&&(AUTOMATIC_CHILD_ROLLUP_TYPES.has(normalizedType)||!BUILTIN_ITEM_TYPES.has(normalizedType))}function toClaimHistoryContext(entry){return{ts:entry.ts,author:entry.author,message:entry.message??null}}function resolveClaimStateContext(assigneeValue,history){const assignee=assigneeValue?.trim();const normalizedAssignee=assignee&&assignee.length>0?assignee:null;const lastClaim=[...history].reverse().find(entry=>entry.op==="claim");const lastRelease=[...history].reverse().find(entry=>entry.op==="release");return{claimed:normalizedAssignee!==null,assignee:normalizedAssignee,last_claim:lastClaim?toClaimHistoryContext(lastClaim):null,last_release:lastRelease?toClaimHistoryContext(lastRelease):null}}function parseGetDepth(raw){if(raw===void 0||raw.trim().length===0){return"standard"}const normalized=raw.trim().toLowerCase();if(normalized==="full"){return"deep"}if(GET_DEPTH_VALUES.includes(normalized)){return normalized}throw new PmCliError("Get --depth must be one of brief|standard|deep|full",EXIT_CODE.USAGE)}function projectItemForDepth(item,depth){const collectionCounts=itemCollectionCounts(item);if(depth==="deep"){return{...item,comments:item.comments??[],notes:item.notes??[],learnings:item.learnings??[],files:item.files??[],tests:item.tests??[],docs:item.docs??[],reminders:item.reminders??[],events:item.events??[],notes_count:collectionCounts.notes,tests_count:collectionCounts.tests,collection_counts:collectionCounts}}const{comments:_comments,notes:_notes,learnings:_learnings,files:_files,tests:_tests,docs:_docs,reminders:_reminders,events:_events,...projected}=item;return{...projected,notes_count:item.notes?.length??0,tests_count:item.tests?.length??0,collection_counts:collectionCounts}}function parseGetFields(raw){if(raw===void 0){return null}const fields=raw.split(",").map(entry=>entry.trim()).filter(entry=>entry.length>0);if(fields.length===0){throw new PmCliError("Get --fields requires a comma-separated list of field names",EXIT_CODE.USAGE)}return fields}function normalizeGetField(field){return field.startsWith("item.")?field.slice("item.".length):field}function validateGetFields(fields,runtimeMetadataKeys,id){if(fields===null){return}const allowedValues=listGetProjectionFields(runtimeMetadataKeys);const allowed=new Set(allowedValues);const unknown=fields.filter(field=>{const normalized=normalizeGetField(field);return!allowed.has(field)&&!allowed.has(normalized)});if(unknown.length>0){const suggestedRetryArguments=["get",id,"--fields","id,title,status"];throw new PmCliError(`Unknown get --fields value(s): ${unknown.join(", ")}`,EXIT_CODE.USAGE,{code:"unknown_field_projection",examples:["pm get <id> --fields id,title,status,type,updated_at","pm get <id> --fields id,title,claim_state","pm get <id> --fields id,title,body,linked.files"],recovery:{allowed_values:allowedValues,suggested_retry:renderPmCommand(suggestedRetryArguments),suggested_retry_args:suggestedRetryArguments}})}}const EMPTY_PROJECTED_COLLECTION_FIELDS=new Set(["comments","notes","learnings","files","tests","test_runs","docs","reminders","events","dependencies","plan_steps","plan_decisions","plan_discoveries","plan_validation"]);function projectedMetadataValue(source,counts,field){if(Object.hasOwn(counts,field))return counts[field];if(source[field]!==void 0)return source[field];return EMPTY_PROJECTED_COLLECTION_FIELDS.has(field)?[]:void 0}function projectItemForFields(item,fields){const source=toItemRecord(item);const omittedCounts={notes_count:item.notes?.length??0,tests_count:item.tests?.length??0,collection_counts:itemCollectionCounts(item)};const projected={id:item.id};for(const field of fields){const normalized=normalizeGetField(field);if(normalized==="body"||normalized==="linked"||normalized.startsWith("linked.")||normalized==="claim_state"||normalized.startsWith("claim_state.")||normalized==="children"||normalized.startsWith("children.")||normalized==="schedule"||normalized.startsWith("schedule.")){continue}projected[normalized]=projectedMetadataValue(source,omittedCounts,normalized)}return projected}function fieldsInclude(fields,name){return fields?.some(field=>field===name||field===`item.${name}`)??false}function fieldsIncludeRoot(fields,name){return fields.some(field=>{const normalized=normalizeGetField(field);return normalized===name||normalized.startsWith(`${name}.`)})}function resolveGetProjection(options,id){if(options.full&&(options.fields!==void 0||options.depth!==void 0)){throw new PmCliError("Get projection options are mutually exclusive; remove the extra projection flag and retry.",EXIT_CODE.USAGE,{code:"projection_options_mutually_exclusive",recovery:{suggested_retry:renderPmCommand(["get",id,"--full"]),suggested_retry_args:["get",id,"--full"]}})}if(options.tree!==true&&options.treeDepth!==void 0){throw new PmCliError("Get --tree-depth requires --tree",EXIT_CODE.USAGE)}if(options.at!==void 0&&options.tree===true){throw new PmCliError("Get --at cannot be combined with --tree because workspace-level historical projections are not yet indexed.",EXIT_CODE.USAGE)}return{depth:options.full?"deep":parseGetDepth(options.depth),treeDepth:options.tree===true?parseIntegerLimit(options.treeDepth,"--tree-depth"):void 0,fields:parseGetFields(options.fields),fieldProjection:options.fields!==void 0}}async function loadGetItemContext(id,global2,at){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());if(at!==void 0){const historical=await getItemAt(id,at,{pmRoot:global2.path});return{pmRoot,settings,typeToFolder:typeRegistry.type_to_folder,locatedId:historical.document.metadata.id,metadata:historical.document.metadata,body:historical.document.body,historical}}const located=await locateItem(pmRoot,id,settings.id_prefix,settings.item_format,typeRegistry.type_to_folder);if(!located){throw await buildItemNotFoundError(pmRoot,id,settings.id_prefix,typeRegistry.type_to_folder)}const loaded=await readLocatedItem(located,{schema:settings.schema});return{pmRoot,settings,typeToFolder:typeRegistry.type_to_folder,locatedId:located.id,metadata:loaded.document.metadata,body:loaded.document.body}}function validateGetProjectionFields(fields,settings,historical,id){const runtimeMetadataKeys=resolveRuntimeFieldRegistry(settings.schema).definitions.map(field=>field.metadata_key);validateGetFields(fields,runtimeMetadataKeys,id);if(historical&&fieldsIncludeRoot(fields??[],"children")){throw new PmCliError("Get --at cannot project children because workspace-level historical relationships are not yet indexed.",EXIT_CODE.USAGE)}}function shouldIncludeGetField(params){const{fieldProjection,depth,fields,field}=params;if(fieldProjection){if(field==="body"||field==="linked"){return fieldsInclude(fields,field)}return fieldsIncludeRoot(fields,field)}return depth!=="brief"}async function resolveGetClaimState(context,includeClaimState){if(!includeClaimState){return void 0}const historyPath=getHistoryPath(context.pmRoot,context.locatedId);const history=await readHistoryEntries(historyPath,context.locatedId);return resolveClaimStateContext(context.metadata.assignee,context.historical?history.slice(0,context.historical.target.historyIndex+1):history)}function attachGetLinked(result,context,fields,includeLinked){const includeLinkedFiles=includeLinked||fieldsInclude(fields,"linked.files");const includeLinkedTests=includeLinked||fieldsInclude(fields,"linked.tests");const includeLinkedDocs=includeLinked||fieldsInclude(fields,"linked.docs");if(!includeLinked&&!includeLinkedFiles&&!includeLinkedTests&&!includeLinkedDocs){return}result.linked={files:includeLinkedFiles?context.metadata.files??[]:[],tests:includeLinkedTests?context.metadata.tests??[]:[],docs:includeLinkedDocs?context.metadata.docs??[]:[]}}async function buildGetChildrenRollup(context,includeChildren){if(!includeChildren){return void 0}const statusRegistry=resolveRuntimeStatusRegistry(context.settings.schema);const corpus=await listAllItemMetadataLight(context.pmRoot,context.settings.item_format,context.typeToFolder,void 0,context.settings.schema);return buildItemChildrenRollup(context.locatedId,corpus,statusRegistry)}function attachGetSchedule(result,context,fields,includeSchedule){if(!includeSchedule){return}const schedule=buildItemSchedule(context.metadata);if(!schedule){return}if(fields===null||fieldsInclude(fields,"schedule")){result.schedule=schedule;return}result.schedule=Object.fromEntries(Object.entries(schedule).filter(([key])=>fields.some(field=>normalizeGetField(field)===`schedule.${key}`)))}async function buildGetTree(context,options,treeDepth,global2){if(options.tree!==true){return void 0}const subtree=await runList(void 0,{parent:context.locatedId,tree:true,treeDepth:treeDepth===void 0?void 0:String(treeDepth),full:true},global2);return{root_id:context.locatedId,root_title:context.metadata.title,depth_limit:treeDepth??null,count:subtree.count,items:subtree.items.map(entry=>toItemRecord(entry))}}async function runGet(id,global2,options={}){const projection=resolveGetProjection(options,id);const context=await loadGetItemContext(id,global2,options.at);validateGetProjectionFields(projection.fields,context.settings,context.historical!==void 0,context.locatedId);const includeBody=shouldIncludeGetField({...projection,field:"body"});const includeLinked=shouldIncludeGetField({...projection,field:"linked"});const includeClaimState=shouldIncludeGetField({...projection,field:"claim_state"});const includeChildren=context.historical===void 0&&(projection.fieldProjection?fieldsIncludeRoot(projection.fields,"children"):projection.depth==="deep"&&shouldAutoIncludeGetChildren(context.metadata.type));const includeSchedule=projection.fieldProjection?fieldsIncludeRoot(projection.fields,"schedule"):projection.depth!=="brief";const claimState=await resolveGetClaimState(context,includeClaimState);const result={item:projection.fieldProjection?projectItemForFields(context.metadata,projection.fields):projectItemForDepth(context.metadata,projection.depth)};if(includeBody){result.item.body=context.body}attachGetLinked(result,context,projection.fields,includeLinked);if(claimState){result.claim_state=claimState}attachGetSchedule(result,context,projection.fields,includeSchedule);const children=await buildGetChildrenRollup(context,includeChildren);if(children!==void 0){result.children=children}const tree=await buildGetTree(context,options,projection.treeDepth,global2);if(tree!==void 0){result.tree=tree}if(context.historical){result.reconstructed=true;result.as_of_version=context.historical.as_of_version;result.as_of_timestamp=context.historical.as_of_timestamp}if(context.historical===void 0){try{await recordContextUsageTouches({pmRoot:context.pmRoot,author:resolveAuthor(void 0,context.settings.author_default),itemIds:[context.locatedId],intent:"get"})}catch{}}registerOutputMaterialFieldGroups(result,itemMaterialFieldGroups(context.metadata,context.body));return result}const _testOnlyGetCommand={shouldAutoIncludeGetChildren};export{GET_DEPTH_VALUES2 as GET_DEPTH_VALUES,_testOnlyGetCommand,listGetProjectionFields2 as listGetProjectionFields,runGet};
 //# sourceMappingURL=get.js.map
-//# debugId=88732a1d-ae5a-5dfb-93d6-9659cb6f05c3