@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/query/history.js

@@ -1,187 +1,2 @@
-/**
- * @module cli/commands/history
- *
- * Implements the pm history command surface and its agent-facing runtime behavior.
- */
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="13e944b0-f049-55e5-8ff8-6335ce888b65")}catch(e){}}();
-import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import { historyVersionOffset } from "../../core/history/version-address.js";
-import { pathExists, computeHistoryDiff, patchPathToChangedField, normalizeReplayPatchOps, verifyHistoryChain, enforceHistoryStreamPolicyForItem, EXIT_CODE, PmCliError, getActiveExtensionRegistrations, normalizeItemId, resolveItemTypeRegistry, locateItem, readLocatedItem, getHistoryPath, getWorkspaceHistoryPath, inspectWorkspaceHistoryState, resolvePmRoot, readSettings, WORKSPACE_HISTORY_ID, } from "../runtime-primitives.js";
-import { readHistoryEntries, verifyHistoryEntries, } from "../history-read.js";
-export { readHistoryEntries } from "../history-read.js";
-import { parseLimit } from "./parsers.js";
-import { resolveModePairedOutputOmissionReceipt, } from "../output-projection.js";
-import { compileHistoryProvenanceMatcher, projectHistoryProvenance, resolveHistoryProvenanceDimensions, summarizeHistoryProvenance, } from "../history-provenance.js";
-export { verifyHistoryChain };
-function limitEntries(values, limit) {
-    if (limit === undefined)
-        return values;
-    return values.slice(Math.max(0, values.length - limit));
-}
-/** Summarize patch fields with physical indices and separately mapped durable versions. */
-function buildDiffEntries(entries, addressing) {
-    return entries.map(({ entry, version }) => {
-        const changedFields = new Set();
-        const patch = normalizeReplayPatchOps(entry.patch);
-        for (const op of patch) {
-            changedFields.add(patchPathToChangedField(op.path));
-            if (op.from) {
-                changedFields.add(patchPathToChangedField(op.from));
-            }
-        }
-        return {
-            index: version,
-            ...(addressing ? { version: addressing.offset === null ? null : addressing.offset + version } : {}),
-            ts: entry.ts,
-            op: entry.op,
-            author: entry.author,
-            patch_ops: patch.length,
-            changed_fields: [...changedFields].sort((left, right) => left.localeCompare(right)),
-        };
-    });
-}
-/** Describe the checkpoint mapping without changing physical diagnostic indices. */
-function buildVersionAddressing(history) {
-    if (history[0]?.op !== "history_compact_baseline")
-        return undefined;
-    const offset = historyVersionOffset(history, true);
-    return {
-        offset,
-        first_version: offset === null ? null : offset + 1,
-        last_version: offset === null ? null : offset + history.length,
-    };
-}
-async function resolveHistoryReadTarget(id, global) {
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    await assertInitializedTracker(pmRoot);
-    const settings = await readSettings(pmRoot);
-    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-    const workspaceHistoryRequested = id.trim() === WORKSPACE_HISTORY_ID;
-    const normalizedId = workspaceHistoryRequested
-        ? WORKSPACE_HISTORY_ID
-        : normalizeItemId(id, settings.id_prefix);
-    const located = await locateItem(pmRoot, normalizedId, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
-    const resolvedId = located?.id ?? normalizedId;
-    const historyPath = workspaceHistoryRequested
-        ? getWorkspaceHistoryPath(pmRoot)
-        : getHistoryPath(pmRoot, resolvedId);
-    if (!located && !(await pathExists(historyPath))) {
-        throw new PmCliError(`Item ${id} not found`, EXIT_CODE.NOT_FOUND);
-    }
-    /* c8 ignore next -- resolved ids in command tests always map to located items. */
-    if (located) {
-        await enforceHistoryStreamPolicyForItem({
-            pmRoot,
-            settings,
-            itemId: located.id,
-            commandLabel: "history",
-        });
-    }
-    return { historyPath, located, resolvedId, settings };
-}
-/** Implements run history for the public runtime surface of this module. */
-export async function runHistory(id, options, global) {
-    const limit = parseLimit(options.limit);
-    const { historyPath, located, resolvedId, settings } = await resolveHistoryReadTarget(id, global);
-    const fullHistory = await readHistoryEntries(historyPath, resolvedId);
-    const addressing = buildVersionAddressing(fullHistory);
-    const vocabulary = settings.agent_identity.identity_vocabulary;
-    const provenanceDimensions = resolveHistoryProvenanceDimensions(settings.agent_identity.harness_signals);
-    const matchesProvenance = compileHistoryProvenanceMatcher({
-        harness: options.harness,
-        agentInstance: options.agentInstance,
-        provenance: options.provenanceFilter,
-    }, vocabulary, provenanceDimensions);
-    const filteredHistory = indexHistoryEntries(fullHistory)
-        .filter(({ entry }) => matchesProvenance(entry));
-    const selectedHistory = limitEntries(filteredHistory, limit);
-    const history = selectedHistory.map(({ entry }) => entry);
-    const compact = options.compact === true;
-    const compactHistory = compact
-        ? buildDiffEntries(selectedHistory, addressing)
-        : undefined;
-    const provenanceHistory = options.provenance === true
-        ? selectedHistory.map(({ entry, durableVersion }) => projectHistoryProvenance(entry, vocabulary, {
-            itemId: resolvedId,
-            version: durableVersion,
-        }))
-        : undefined;
-    const projectionMode = options.provenance === true ? "provenance" : compact ? "compact" : "full";
-    const rowProjection = {
-        compact: { compact_history: compactHistory },
-        provenance: { provenance_history: provenanceHistory },
-        full: { history },
-    }[projectionMode];
-    const rowKey = {
-        compact: "compact_history",
-        provenance: "provenance_history",
-        full: "history",
-    };
-    const result = {
-        id: resolvedId,
-        ...rowProjection,
-        compact,
-        projection: {
-            mode: projectionMode,
-            row_key: rowKey[projectionMode],
-        },
-        omission_receipt: resolveModePairedOutputOmissionReceipt("history", projectionMode),
-        count: history.length,
-        limit: limit ?? null,
-        version_addressing: addressing,
-        ...(options.provenanceSummary === true
-            ? {
-                provenance_summary: summarizeHistoryProvenance(filteredHistory.map(({ entry }) => entry), vocabulary, provenanceDimensions),
-            }
-            : {}),
-    };
-    if (options.diff || options.field !== undefined) {
-        // --diff replays the full chain to surface per-field before/after values for
-        // the displayed window (the latest --limit entries). --field narrows to a
-        // single field's transitions ("when did status change?"). Unlike the compact
-        // projection above, the value diff is independent of the compact/full toggle.
-        result.diff = computeHistoryDiff(fullHistory, {
-            windowStartIndex: Math.max(0, fullHistory.length - history.length),
-            field: options.field,
-        });
-    }
-    if (options.verify) {
-        /* c8 ignore next -- verify command paths currently execute with located on-disk items. */
-        const currentDocument = located
-            ? (await readLocatedItem(located, {
-                schema: settings.schema,
-            })).document
-            : undefined;
-        result.verification = verifyHistoryEntries(fullHistory, currentDocument);
-        if (resolvedId === WORKSPACE_HISTORY_ID && result.verification.ok) {
-            const agreement = await inspectWorkspaceHistoryState(resolvePmRoot(process.cwd(), global.path));
-            result.verification = {
-                ...result.verification,
-                ok: agreement.ok,
-                errors: agreement.ok
-                    ? result.verification.errors
-                    : [
-                        ...result.verification.errors,
-                        "verify_failed:workspace_state_mismatch",
-                    ],
-                workspace_state_matches_latest: agreement.ok,
-                workspace_state_mismatches: agreement.mismatched_documents,
-                workspace_state_missing: agreement.missing_documents,
-                workspace_state_unreadable: agreement.unreadable_documents,
-            };
-        }
-    }
-    return result;
-}
-/** Attach physical and durable coordinates before filtering or limiting the stream. */
-function indexHistoryEntries(history) {
-    const offset = historyVersionOffset(history, true);
-    return history.map((entry, index) => ({
-        entry,
-        version: index + 1,
-        durableVersion: offset === null ? undefined : offset + index + 1,
-    }));
-}
+!(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]="0cc18a30-5068-5c59-b559-7afc4d446ed8")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import{historyVersionOffset}from"../../core/history/version-address.js";import{pathExists,computeHistoryDiff,patchPathToChangedField,normalizeReplayPatchOps,verifyHistoryChain,enforceHistoryStreamPolicyForItem,EXIT_CODE,PmCliError,getActiveExtensionRegistrations,normalizeItemId,resolveItemTypeRegistry,locateItem,readLocatedItem,getHistoryPath,getWorkspaceHistoryPath,inspectWorkspaceHistoryState,resolvePmRoot,readSettings,WORKSPACE_HISTORY_ID}from"../runtime-primitives.js";import{readHistoryEntries,verifyHistoryEntries}from"../history-read.js";import{readHistoryEntries as readHistoryEntries2}from"../history-read.js";import{parseLimit}from"./parsers.js";import{resolveModePairedOutputOmissionReceipt}from"../output-projection.js";import{compileHistoryProvenanceMatcher,projectHistoryProvenance,resolveHistoryProvenanceDimensions,summarizeHistoryProvenance}from"../history-provenance.js";function limitEntries(values,limit){if(limit===void 0)return values;return values.slice(Math.max(0,values.length-limit))}function buildDiffEntries(entries,addressing){return entries.map(({entry,version})=>{const changedFields=new Set;const patch=normalizeReplayPatchOps(entry.patch);for(const op of patch){changedFields.add(patchPathToChangedField(op.path));if(op.from){changedFields.add(patchPathToChangedField(op.from))}}return{index:version,...addressing?{version:addressing.offset===null?null:addressing.offset+version}:{},ts:entry.ts,op:entry.op,author:entry.author,patch_ops:patch.length,changed_fields:[...changedFields].sort((left,right)=>left.localeCompare(right))}})}function buildVersionAddressing(history){if(history[0]?.op!=="history_compact_baseline")return void 0;const offset=historyVersionOffset(history,true);return{offset,first_version:offset===null?null:offset+1,last_version:offset===null?null:offset+history.length}}async function resolveHistoryReadTarget(id,global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());const workspaceHistoryRequested=id.trim()===WORKSPACE_HISTORY_ID;const normalizedId=workspaceHistoryRequested?WORKSPACE_HISTORY_ID:normalizeItemId(id,settings.id_prefix);const located=await locateItem(pmRoot,normalizedId,settings.id_prefix,settings.item_format,typeRegistry.type_to_folder);const resolvedId=located?.id??normalizedId;const historyPath=workspaceHistoryRequested?getWorkspaceHistoryPath(pmRoot):getHistoryPath(pmRoot,resolvedId);if(!located&&!await pathExists(historyPath)){throw new PmCliError(`Item ${id} not found`,EXIT_CODE.NOT_FOUND)}if(located){await enforceHistoryStreamPolicyForItem({pmRoot,settings,itemId:located.id,commandLabel:"history"})}return{historyPath,located,resolvedId,settings}}async function runHistory(id,options,global2){const limit=parseLimit(options.limit);const{historyPath,located,resolvedId,settings}=await resolveHistoryReadTarget(id,global2);const fullHistory=await readHistoryEntries(historyPath,resolvedId);const addressing=buildVersionAddressing(fullHistory);const vocabulary=settings.agent_identity.identity_vocabulary;const provenanceDimensions=resolveHistoryProvenanceDimensions(settings.agent_identity.harness_signals);const matchesProvenance=compileHistoryProvenanceMatcher({harness:options.harness,agentInstance:options.agentInstance,provenance:options.provenanceFilter},vocabulary,provenanceDimensions);const filteredHistory=indexHistoryEntries(fullHistory).filter(({entry})=>matchesProvenance(entry));const selectedHistory=limitEntries(filteredHistory,limit);const history=selectedHistory.map(({entry})=>entry);const compact=options.compact===true;const compactHistory=compact?buildDiffEntries(selectedHistory,addressing):void 0;const provenanceHistory=options.provenance===true?selectedHistory.map(({entry,durableVersion})=>projectHistoryProvenance(entry,vocabulary,{itemId:resolvedId,version:durableVersion})):void 0;const projectionMode=options.provenance===true?"provenance":compact?"compact":"full";const rowProjection={compact:{compact_history:compactHistory},provenance:{provenance_history:provenanceHistory},full:{history}}[projectionMode];const rowKey={compact:"compact_history",provenance:"provenance_history",full:"history"};const result={id:resolvedId,...rowProjection,compact,projection:{mode:projectionMode,row_key:rowKey[projectionMode]},omission_receipt:resolveModePairedOutputOmissionReceipt("history",projectionMode),count:history.length,limit:limit??null,version_addressing:addressing,...options.provenanceSummary===true?{provenance_summary:summarizeHistoryProvenance(filteredHistory.map(({entry})=>entry),vocabulary,provenanceDimensions)}:{}};if(options.diff||options.field!==void 0){result.diff=computeHistoryDiff(fullHistory,{windowStartIndex:Math.max(0,fullHistory.length-history.length),field:options.field})}if(options.verify){const currentDocument=located?(await readLocatedItem(located,{schema:settings.schema})).document:void 0;result.verification=verifyHistoryEntries(fullHistory,currentDocument);if(resolvedId===WORKSPACE_HISTORY_ID&&result.verification.ok){const agreement=await inspectWorkspaceHistoryState(resolvePmRoot(process.cwd(),global2.path));result.verification={...result.verification,ok:agreement.ok,errors:agreement.ok?result.verification.errors:[...result.verification.errors,"verify_failed:workspace_state_mismatch"],workspace_state_matches_latest:agreement.ok,workspace_state_mismatches:agreement.mismatched_documents,workspace_state_missing:agreement.missing_documents,workspace_state_unreadable:agreement.unreadable_documents}}}return result}function indexHistoryEntries(history){const offset=historyVersionOffset(history,true);return history.map((entry,index)=>({entry,version:index+1,durableVersion:offset===null?void 0:offset+index+1}))}export{readHistoryEntries2 as readHistoryEntries,runHistory,verifyHistoryChain};
 //# sourceMappingURL=history.js.map
-//# debugId=13e944b0-f049-55e5-8ff8-6335ce888b65

package/dist/sdk/query/item-filter-options.js

@@ -1,10 +1,2 @@
-/**
- * @module sdk/query/item-filter-options
- *
- * Shared item-filter option contracts used by command implementations and SDK-facing types.
- */
-
-!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]="5133d678-01f4-5164-aea7-2cc5ed42dd58")}catch(e){}}();
-export {};
+!(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]="d45a8203-4501-5797-a6cc-a2e7844adec9")}catch(e2){}})();
 //# sourceMappingURL=item-filter-options.js.map
-//# debugId=5133d678-01f4-5164-aea7-2cc5ed42dd58

package/dist/sdk/query/light-metadata.js

@@ -1,19 +1,2 @@
-/**
- * @module sdk/query/light-metadata
- *
- * Resolves workspace settings for the host-bound lightweight metadata reader.
- */
-
-!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]="6ede8efb-54ec-5b13-a1bf-216b525acc12")}catch(e){}}();
-import { resolveItemTypeRegistry } from "../../core/item/type-registry.js";
-import { listAllItemMetadataLight } from "../../core/store/item-store.js";
-import { resolvePmRoot } from "../../core/store/paths.js";
-import { readSettings } from "../../core/store/settings.js";
-/** Read scalar-only metadata using client workspace defaults and custom type folders. */
-export async function listClientItemMetadataLight(pmRootOverride, cwdOverride) {
-    const pmRoot = resolvePmRoot(cwdOverride ?? process.cwd(), pmRootOverride);
-    const settings = await readSettings(pmRoot);
-    return listAllItemMetadataLight(pmRoot, settings.item_format, resolveItemTypeRegistry(settings, null).type_to_folder, undefined, settings.schema);
-}
+!(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]="3046466c-614c-5e2b-a156-df96fba8c483")}catch(e2){}})();import{resolveItemTypeRegistry}from"../../core/item/type-registry.js";import{listAllItemMetadataLight}from"../../core/store/item-store.js";import{resolvePmRoot}from"../../core/store/paths.js";import{readSettings}from"../../core/store/settings.js";async function listClientItemMetadataLight(pmRootOverride,cwdOverride){const pmRoot=resolvePmRoot(cwdOverride??process.cwd(),pmRootOverride);const settings=await readSettings(pmRoot);return listAllItemMetadataLight(pmRoot,settings.item_format,resolveItemTypeRegistry(settings,null).type_to_folder,void 0,settings.schema)}export{listClientItemMetadataLight};
 //# sourceMappingURL=light-metadata.js.map
-//# debugId=6ede8efb-54ec-5b13-a1bf-216b525acc12

package/dist/sdk/query/list-filter-shared.js

@@ -1,82 +1,2 @@
-
-!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]="ab1153b1-2d91-58a5-9b4a-1d9c5f35a54a")}catch(e){}}();
-const LIST_VALUE_FILTER_KEYS = [
-    "status",
-    "type",
-    "tag",
-    "priority",
-    "deadlineBefore",
-    "deadlineAfter",
-    "updatedAfter",
-    "updatedBefore",
-    "createdAfter",
-    "createdBefore",
-    "ids",
-    "assignee",
-    "assigneeFilter",
-    "parent",
-    "sprint",
-    "release",
-];
-const LIST_BOOLEAN_FILTER_KEYS = [
-    "filterAcMissing",
-    "filterEstimatesMissing",
-    "filterResolutionMissing",
-    "filterMetadataMissing",
-    "filterReviewerMissing",
-    "filterRiskMissing",
-    "filterConfidenceMissing",
-    "filterSprintMissing",
-    "filterReleaseMissing",
-    "hasNotes",
-    "hasLearnings",
-    "hasFiles",
-    "hasDocs",
-    "hasTests",
-    "hasComments",
-    "hasDeps",
-    "hasBody",
-    "hasLinkedCommand",
-    "noNotes",
-    "noLearnings",
-    "noFiles",
-    "noDocs",
-    "noTests",
-    "noComments",
-    "noDeps",
-    "emptyBody",
-    "noLinkedCommand",
-];
-function isActiveListFilterValue(value) {
-    return (value != null &&
-        (typeof value !== "string" ||
-            value.split(",").some((entry) => entry.trim().length > 0)));
-}
-/** Implements check whether list filters for the public runtime surface of this module. */
-export function hasListFilters(list, status, options = {}) {
-    const includePagination = options.includePagination !== false;
-    const valueCandidates = [
-        status,
-        ...LIST_VALUE_FILTER_KEYS.map((key) => list?.[key]),
-        ...(includePagination ? [list?.limit, list?.offset] : []),
-    ];
-    return (valueCandidates.some(isActiveListFilterValue) ||
-        LIST_BOOLEAN_FILTER_KEYS.some((key) => list?.[key] === true));
-}
-/** Implements build list query filters for the public runtime surface of this module. */
-export function buildListQueryFilters(filters) {
-    return {
-        type: filters.type,
-        tag: filters.tag,
-        priority: filters.priority,
-        deadlineBefore: filters.deadlineBefore,
-        deadlineAfter: filters.deadlineAfter,
-        assignee: filters.assignee,
-        assigneeFilter: filters.assigneeFilter,
-        parent: filters.parent,
-        sprint: filters.sprint,
-        release: filters.release,
-    };
-}
+!(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]="2a9a4dc0-8027-5761-9bbf-cac1ef83bd10")}catch(e2){}})();const LIST_VALUE_FILTER_KEYS=["status","type","tag","priority","deadlineBefore","deadlineAfter","updatedAfter","updatedBefore","createdAfter","createdBefore","ids","assignee","assigneeFilter","parent","sprint","release"];const LIST_BOOLEAN_FILTER_KEYS=["filterAcMissing","filterEstimatesMissing","filterResolutionMissing","filterMetadataMissing","filterReviewerMissing","filterRiskMissing","filterConfidenceMissing","filterSprintMissing","filterReleaseMissing","hasNotes","hasLearnings","hasFiles","hasDocs","hasTests","hasComments","hasDeps","hasBody","hasLinkedCommand","noNotes","noLearnings","noFiles","noDocs","noTests","noComments","noDeps","emptyBody","noLinkedCommand"];function isActiveListFilterValue(value){return value!=null&&(typeof value!=="string"||value.split(",").some(entry=>entry.trim().length>0))}function hasListFilters(list,status,options={}){const includePagination=options.includePagination!==false;const valueCandidates=[status,...LIST_VALUE_FILTER_KEYS.map(key=>list?.[key]),...includePagination?[list?.limit,list?.offset]:[]];return valueCandidates.some(isActiveListFilterValue)||LIST_BOOLEAN_FILTER_KEYS.some(key=>list?.[key]===true)}function buildListQueryFilters(filters){return{type:filters.type,tag:filters.tag,priority:filters.priority,deadlineBefore:filters.deadlineBefore,deadlineAfter:filters.deadlineAfter,assignee:filters.assignee,assigneeFilter:filters.assigneeFilter,parent:filters.parent,sprint:filters.sprint,release:filters.release}}export{buildListQueryFilters,hasListFilters};
 //# sourceMappingURL=list-filter-shared.js.map
-//# debugId=ab1153b1-2d91-58a5-9b4a-1d9c5f35a54a