@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/history-provenance.js

@@ -1,183 +1,2 @@
-/**
- * @module sdk/history-provenance
- *
- * Provides patch-free immutable-history provenance projections, filtering,
- * identity interpretation, and bounded coverage summaries.
- */
-
-!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]="8b010e79-a73a-5760-ac05-8dc88484cd69")}catch(e){}}();
-import { AGENT_PROVENANCE_DIMENSIONS, } from "../core/shared/author.js";
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-/** Default interpretation used when a legacy workspace has no vocabulary. */
-export const DEFAULT_AUTHOR_IDENTITY_VOCABULARY = {
-    version: 1,
-    aliases: {},
-};
-/** Resolve the extensible dimension vocabulary declared by built-ins and workspace descriptors. */
-export function resolveHistoryProvenanceDimensions(descriptors = []) {
-    const dimensions = new Set(AGENT_PROVENANCE_DIMENSIONS);
-    const addDimension = (dimension) => {
-        if (/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(dimension)) {
-            dimensions.add(dimension);
-        }
-    };
-    for (const descriptor of descriptors) {
-        for (const dimension of Object.keys(descriptor.provenance_environment_keys ?? {})) {
-            addDimension(dimension);
-        }
-        for (const dimension of Object.keys(descriptor.provenance_resolvers ?? {})) {
-            addDimension(dimension);
-        }
-        for (const dimension of descriptor.provenance_unavailable_dimensions ??
-            []) {
-            addDimension(dimension);
-        }
-    }
-    return [...dimensions].sort();
-}
-function normalizeSet(value) {
-    if (value === undefined)
-        return undefined;
-    const values = typeof value === "string" ? [value] : value;
-    const normalized = values
-        .flatMap((entry) => entry.split(","))
-        .map((entry) => entry.trim())
-        .filter((entry) => entry.length > 0);
-    return normalized.length === 0 ? undefined : new Set(normalized);
-}
-function resolveCanonicalHarness(entry, vocabulary) {
-    if (entry.agent_harness?.trim()) {
-        return { agent_harness: entry.agent_harness, harness_source: "recorded" };
-    }
-    const interpreted = vocabulary.aliases[entry.author];
-    return interpreted
-        ? { agent_harness: interpreted, harness_source: "vocabulary" }
-        : { harness_source: "unresolved" };
-}
-/** Parse and validate exact provenance dimension predicates. */
-export function parseHistoryProvenanceFilters(filters, dimensions = AGENT_PROVENANCE_DIMENSIONS) {
-    const allowed = new Set(dimensions);
-    const predicates = new Map();
-    const values = filters.provenance === undefined
-        ? []
-        : typeof filters.provenance === "string"
-            ? [filters.provenance]
-            : filters.provenance;
-    for (const raw of values.flatMap((entry) => entry.split(","))) {
-        const separator = raw.indexOf("=");
-        if (separator < 0) {
-            throw new PmCliError(`Provenance predicate must use dimension=value; received "${raw.trim()}".`, EXIT_CODE.USAGE, { code: "invalid_provenance_predicate" });
-        }
-        const dimension = raw.slice(0, separator).trim().toLowerCase();
-        const value = raw.slice(separator + 1).trim();
-        if (!allowed.has(dimension)) {
-            throw new PmCliError(`Unknown provenance dimension "${dimension || raw.trim()}". Declared dimensions: ${[...allowed].sort().join(", ")}.`, EXIT_CODE.USAGE, { code: "unknown_provenance_dimension" });
-        }
-        if (value.length === 0) {
-            throw new PmCliError(`Provenance predicate must use dimension=value; received "${raw.trim()}".`, EXIT_CODE.USAGE, { code: "invalid_provenance_predicate" });
-        }
-        const accepted = predicates.get(dimension) ?? new Set();
-        accepted.add(value);
-        predicates.set(dimension, accepted);
-    }
-    return predicates;
-}
-/** Project one immutable entry without its JSON Patch or document hashes. */
-export function projectHistoryProvenance(entry, vocabulary = DEFAULT_AUTHOR_IDENTITY_VOCABULARY, coordinates = {}) {
-    const harness = resolveCanonicalHarness(entry, vocabulary);
-    return {
-        ...(coordinates.itemId === undefined
-            ? {}
-            : { item_id: coordinates.itemId }),
-        ...(coordinates.version === undefined
-            ? {}
-            : { version: coordinates.version }),
-        ts: entry.ts,
-        op: entry.op,
-        author: entry.author,
-        ...(entry.author_source === undefined
-            ? {}
-            : { author_source: entry.author_source }),
-        ...harness,
-        vocabulary_version: vocabulary.version,
-        ...(entry.agent_instance === undefined
-            ? {}
-            : { agent_instance: entry.agent_instance }),
-        agent_provenance: entry.agent_provenance ?? {},
-        ...(entry.message === undefined ? {} : { message: entry.message }),
-    };
-}
-/** Test one immutable entry against shared provenance predicates. */
-export function historyEntryMatchesProvenance(entry, filters, vocabulary = DEFAULT_AUTHOR_IDENTITY_VOCABULARY, dimensions = AGENT_PROVENANCE_DIMENSIONS) {
-    return compileHistoryProvenanceMatcher(filters, vocabulary, dimensions)(entry);
-}
-/** Compile shared provenance predicates once for efficient history scans. */
-export function compileHistoryProvenanceMatcher(filters, vocabulary = DEFAULT_AUTHOR_IDENTITY_VOCABULARY, dimensions = AGENT_PROVENANCE_DIMENSIONS) {
-    const harnesses = normalizeSet(filters.harness);
-    const instances = normalizeSet(filters.agentInstance);
-    const predicates = parseHistoryProvenanceFilters(filters, dimensions);
-    return (entry) => {
-        const resolved = resolveCanonicalHarness(entry, vocabulary);
-        const resolvedHarness = resolved.agent_harness;
-        if (harnesses && (!resolvedHarness || !harnesses.has(resolvedHarness)))
-            return false;
-        if (instances && !instances.has(entry.agent_instance ?? ""))
-            return false;
-        for (const [dimension, accepted] of predicates) {
-            const observation = entry.agent_provenance?.[dimension];
-            if (!observation || !accepted.has(observation.value))
-                return false;
-        }
-        return true;
-    };
-}
-/** Summarize identity and dimension completeness without returning event rows. */
-export function summarizeHistoryProvenance(entries, vocabulary = DEFAULT_AUTHOR_IDENTITY_VOCABULARY, dimensions = AGENT_PROVENANCE_DIMENSIONS) {
-    const allDimensions = new Set(dimensions);
-    const unresolvedAuthors = new Map();
-    let resolvedHarnesses = 0;
-    for (const entry of entries) {
-        for (const dimension of Object.keys(entry.agent_provenance ?? {})) {
-            allDimensions.add(dimension);
-        }
-        const harness = resolveCanonicalHarness(entry, vocabulary);
-        if (harness.agent_harness)
-            resolvedHarnesses += 1;
-        else {
-            unresolvedAuthors.set(entry.author, (unresolvedAuthors.get(entry.author) ?? 0) + 1);
-        }
-    }
-    return {
-        entries: entries.length,
-        vocabulary_version: vocabulary.version,
-        harness: {
-            resolved: resolvedHarnesses,
-            unresolved: entries.length - resolvedHarnesses,
-            unresolved_authors: [...unresolvedAuthors]
-                .map(([author, count]) => ({ author, entries: count }))
-                .sort((left, right) => right.entries - left.entries ||
-                left.author.localeCompare(right.author))
-                .slice(0, 20),
-        },
-        dimensions: [...allDimensions].sort().map((dimension) => {
-            let observed = 0;
-            let unavailable = 0;
-            for (const entry of entries) {
-                const observation = entry.agent_provenance?.[dimension];
-                if (observation === null)
-                    unavailable += 1;
-                else if (observation !== undefined)
-                    observed += 1;
-            }
-            return {
-                dimension,
-                observed,
-                unavailable,
-                legacy_missing: entries.length - observed - unavailable,
-            };
-        }),
-    };
-}
+!(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]="94a81e04-bb02-5c2e-9362-4cf7212d66e6")}catch(e2){}})();import{AGENT_PROVENANCE_DIMENSIONS}from"../core/shared/author.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";const DEFAULT_AUTHOR_IDENTITY_VOCABULARY={version:1,aliases:{}};function resolveHistoryProvenanceDimensions(descriptors=[]){const dimensions=new Set(AGENT_PROVENANCE_DIMENSIONS);const addDimension=dimension=>{if(/^[a-z0-9]+(?:-[a-z0-9]+)*$/u.test(dimension)){dimensions.add(dimension)}};for(const descriptor of descriptors){for(const dimension of Object.keys(descriptor.provenance_environment_keys??{})){addDimension(dimension)}for(const dimension of Object.keys(descriptor.provenance_resolvers??{})){addDimension(dimension)}for(const dimension of descriptor.provenance_unavailable_dimensions??[]){addDimension(dimension)}}return[...dimensions].sort()}function normalizeSet(value){if(value===void 0)return void 0;const values=typeof value==="string"?[value]:value;const normalized=values.flatMap(entry=>entry.split(",")).map(entry=>entry.trim()).filter(entry=>entry.length>0);return normalized.length===0?void 0:new Set(normalized)}function resolveCanonicalHarness(entry,vocabulary){if(entry.agent_harness?.trim()){return{agent_harness:entry.agent_harness,harness_source:"recorded"}}const interpreted=vocabulary.aliases[entry.author];return interpreted?{agent_harness:interpreted,harness_source:"vocabulary"}:{harness_source:"unresolved"}}function parseHistoryProvenanceFilters(filters,dimensions=AGENT_PROVENANCE_DIMENSIONS){const allowed=new Set(dimensions);const predicates=new Map;const values=filters.provenance===void 0?[]:typeof filters.provenance==="string"?[filters.provenance]:filters.provenance;for(const raw of values.flatMap(entry=>entry.split(","))){const separator=raw.indexOf("=");if(separator<0){throw new PmCliError(`Provenance predicate must use dimension=value; received "${raw.trim()}".`,EXIT_CODE.USAGE,{code:"invalid_provenance_predicate"})}const dimension=raw.slice(0,separator).trim().toLowerCase();const value=raw.slice(separator+1).trim();if(!allowed.has(dimension)){throw new PmCliError(`Unknown provenance dimension "${dimension||raw.trim()}". Declared dimensions: ${[...allowed].sort().join(", ")}.`,EXIT_CODE.USAGE,{code:"unknown_provenance_dimension"})}if(value.length===0){throw new PmCliError(`Provenance predicate must use dimension=value; received "${raw.trim()}".`,EXIT_CODE.USAGE,{code:"invalid_provenance_predicate"})}const accepted=predicates.get(dimension)??new Set;accepted.add(value);predicates.set(dimension,accepted)}return predicates}function projectHistoryProvenance(entry,vocabulary=DEFAULT_AUTHOR_IDENTITY_VOCABULARY,coordinates={}){const harness=resolveCanonicalHarness(entry,vocabulary);return{...coordinates.itemId===void 0?{}:{item_id:coordinates.itemId},...coordinates.version===void 0?{}:{version:coordinates.version},ts:entry.ts,op:entry.op,author:entry.author,...entry.author_source===void 0?{}:{author_source:entry.author_source},...harness,vocabulary_version:vocabulary.version,...entry.agent_instance===void 0?{}:{agent_instance:entry.agent_instance},agent_provenance:entry.agent_provenance??{},...entry.message===void 0?{}:{message:entry.message}}}function historyEntryMatchesProvenance(entry,filters,vocabulary=DEFAULT_AUTHOR_IDENTITY_VOCABULARY,dimensions=AGENT_PROVENANCE_DIMENSIONS){return compileHistoryProvenanceMatcher(filters,vocabulary,dimensions)(entry)}function compileHistoryProvenanceMatcher(filters,vocabulary=DEFAULT_AUTHOR_IDENTITY_VOCABULARY,dimensions=AGENT_PROVENANCE_DIMENSIONS){const harnesses=normalizeSet(filters.harness);const instances=normalizeSet(filters.agentInstance);const predicates=parseHistoryProvenanceFilters(filters,dimensions);return entry=>{const resolved=resolveCanonicalHarness(entry,vocabulary);const resolvedHarness=resolved.agent_harness;if(harnesses&&(!resolvedHarness||!harnesses.has(resolvedHarness)))return false;if(instances&&!instances.has(entry.agent_instance??""))return false;for(const[dimension,accepted]of predicates){const observation=entry.agent_provenance?.[dimension];if(!observation||!accepted.has(observation.value))return false}return true}}function summarizeHistoryProvenance(entries,vocabulary=DEFAULT_AUTHOR_IDENTITY_VOCABULARY,dimensions=AGENT_PROVENANCE_DIMENSIONS){const allDimensions=new Set(dimensions);const unresolvedAuthors=new Map;let resolvedHarnesses=0;for(const entry of entries){for(const dimension of Object.keys(entry.agent_provenance??{})){allDimensions.add(dimension)}const harness=resolveCanonicalHarness(entry,vocabulary);if(harness.agent_harness)resolvedHarnesses+=1;else{unresolvedAuthors.set(entry.author,(unresolvedAuthors.get(entry.author)??0)+1)}}return{entries:entries.length,vocabulary_version:vocabulary.version,harness:{resolved:resolvedHarnesses,unresolved:entries.length-resolvedHarnesses,unresolved_authors:[...unresolvedAuthors].map(([author,count])=>({author,entries:count})).sort((left,right)=>right.entries-left.entries||left.author.localeCompare(right.author)).slice(0,20)},dimensions:[...allDimensions].sort().map(dimension=>{let observed=0;let unavailable=0;for(const entry of entries){const observation=entry.agent_provenance?.[dimension];if(observation===null)unavailable+=1;else if(observation!==void 0)observed+=1}return{dimension,observed,unavailable,legacy_missing:entries.length-observed-unavailable}})}}export{DEFAULT_AUTHOR_IDENTITY_VOCABULARY,compileHistoryProvenanceMatcher,historyEntryMatchesProvenance,parseHistoryProvenanceFilters,projectHistoryProvenance,resolveHistoryProvenanceDimensions,summarizeHistoryProvenance};
 //# sourceMappingURL=history-provenance.js.map
-//# debugId=8b010e79-a73a-5760-ac05-8dc88484cd69

package/dist/sdk/history-read.js

@@ -1,97 +1,2 @@
-/**
- * @module sdk/history-read
- *
- * Public, mutation-free item time-travel reads backed by the same verified
- * replay kernel used by `pm restore`. Integrators can use this primitive as a
- * building block for provenance browsers, immutable records, and VCS-like
- * systems without acquiring locks or appending history.
- */
-
-!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]="6fe766e2-93e8-5653-beb5-16bd92efae51")}catch(e){}}();
-import { assertInitializedTracker } from "./environment/tracker-preflight.js";
-import { getActiveExtensionRegistrations } from "../core/extensions/index.js";
-import { applyHistoryPatch, ensureMaterializedHistoryTarget, extractPatchFailureContext, replayHistoryToTarget, resolveHistoryTarget, } from "../core/history/projection.js";
-import { readHistoryEntries } from "../core/history/read.js";
-import { historyVersionOffset } from "../core/history/version-address.js";
-import { hashDocument, hashDocumentVerificationCandidates, hashEmptyDocument, } from "../core/history/history.js";
-import { replayToCanonicalItemDocument, verifyHistoryChainWithVersion, } from "../core/history/replay.js";
-import { resolveItemTypeRegistry } from "../core/item/type-registry.js";
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-import { resolvePmRoot } from "../core/store/paths.js";
-import { readSettings } from "../core/store/settings.js";
-import { resolveHistorySubject } from "./history-redact.js";
-export { findHistoryIdentityDiscontinuities, } from "../core/history/identity.js";
-/**
- * Verify a history chain and optionally compare it with a current document.
- *
- * Omitting the current document is useful for workspace-scoped streams, which
- * aggregate multiple configuration files and therefore have no single item
- * document to compare.
- */
-export function verifyHistoryEntries(history, currentDocument) {
-    const verification = verifyHistoryChainWithVersion(history);
-    const latestAfterHash = history.length > 0
-        ? history[history.length - 1].after_hash
-        : hashEmptyDocument();
-    const currentItemHashCandidates = currentDocument === undefined ||
-        verification.item_hash_version === undefined
-        ? undefined
-        : hashDocumentVerificationCandidates(currentDocument, verification.item_hash_version);
-    const currentItemHash = currentDocument === undefined
-        ? undefined
-        : currentItemHashCandidates === undefined
-            ? hashDocument(currentDocument)
-            : currentItemHashCandidates[Math.max(0, currentItemHashCandidates.indexOf(latestAfterHash))];
-    const currentMatchesLatest = currentItemHash === undefined
-        ? undefined
-        : currentItemHash === latestAfterHash;
-    const errors = [...verification.errors];
-    if (currentMatchesLatest === false) {
-        errors.push("verify_failed:current_item_hash_mismatch");
-    }
-    return {
-        ok: errors.length === 0,
-        entries: history.length,
-        errors,
-        latest_after_hash: history.length > 0 ? history[history.length - 1].after_hash : undefined,
-        current_item_hash: currentItemHash,
-        current_matches_latest: currentMatchesLatest,
-    };
-}
-/**
- * Reconstruct one item at a one-based version or ISO timestamp without locks,
- * item writes, history writes, or derived-index mutations.
- */
-export async function getItemAt(id, target, options = {}) {
-    const pmRoot = resolvePmRoot(options.cwd ?? process.cwd(), options.pmRoot);
-    await assertInitializedTracker(pmRoot);
-    const settings = await readSettings(pmRoot);
-    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-    const subject = await resolveHistorySubject(pmRoot, id, settings, typeRegistry.type_to_folder);
-    const history = await readHistoryEntries(subject.historyPath, subject.id);
-    if (history.length === 0) {
-        throw new PmCliError(`No history exists for ${subject.id}; point-in-time reads are unavailable.`, EXIT_CODE.NOT_FOUND);
-    }
-    const resolvedTarget = resolveHistoryTarget(target, history);
-    const replay = ensureMaterializedHistoryTarget(replayHistoryToTarget(history, resolvedTarget.historyIndex), resolvedTarget);
-    const document = replayToCanonicalItemDocument(replay, {
-        schema: settings.schema,
-    });
-    if (document.metadata.id !== subject.id) {
-        throw new PmCliError(`History target resolved to item ${document.metadata.id}, expected ${subject.id}.`, EXIT_CODE.GENERIC_FAILURE);
-    }
-    const targetEntry = history[resolvedTarget.historyIndex];
-    const offset = historyVersionOffset(history, true);
-    return {
-        document,
-        reconstructed: true,
-        as_of_version: offset === null ? null : offset + resolvedTarget.historyIndex + 1,
-        as_of_timestamp: targetEntry.ts,
-        target: resolvedTarget,
-        history_length: history.length,
-    };
-}
-export { applyHistoryPatch, ensureMaterializedHistoryTarget, extractPatchFailureContext, readHistoryEntries, replayHistoryToTarget, resolveHistoryTarget, };
+!(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]="ed4ecd27-71df-5dca-a155-11409db4af21")}catch(e2){}})();import{assertInitializedTracker}from"./environment/tracker-preflight.js";import{getActiveExtensionRegistrations}from"../core/extensions/index.js";import{applyHistoryPatch,ensureMaterializedHistoryTarget,extractPatchFailureContext,replayHistoryToTarget,resolveHistoryTarget}from"../core/history/projection.js";import{readHistoryEntries}from"../core/history/read.js";import{historyVersionOffset}from"../core/history/version-address.js";import{hashDocument,hashDocumentVerificationCandidates,hashEmptyDocument}from"../core/history/history.js";import{replayToCanonicalItemDocument,verifyHistoryChainWithVersion}from"../core/history/replay.js";import{resolveItemTypeRegistry}from"../core/item/type-registry.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{resolvePmRoot}from"../core/store/paths.js";import{readSettings}from"../core/store/settings.js";import{resolveHistorySubject}from"./history/subject.js";import{findHistoryIdentityDiscontinuities}from"../core/history/identity.js";function verifyHistoryEntries(history,currentDocument){const verification=verifyHistoryChainWithVersion(history);const latestAfterHash=history.length>0?history[history.length-1].after_hash:hashEmptyDocument();const currentItemHashCandidates=currentDocument===void 0||verification.item_hash_version===void 0?void 0:hashDocumentVerificationCandidates(currentDocument,verification.item_hash_version);const currentItemHash=currentDocument===void 0?void 0:currentItemHashCandidates===void 0?hashDocument(currentDocument):currentItemHashCandidates[Math.max(0,currentItemHashCandidates.indexOf(latestAfterHash))];const currentMatchesLatest=currentItemHash===void 0?void 0:currentItemHash===latestAfterHash;const errors=[...verification.errors];if(currentMatchesLatest===false){errors.push("verify_failed:current_item_hash_mismatch")}return{ok:errors.length===0,entries:history.length,errors,latest_after_hash:history.length>0?history[history.length-1].after_hash:void 0,current_item_hash:currentItemHash,current_matches_latest:currentMatchesLatest}}async function getItemAt(id,target,options={}){const pmRoot=resolvePmRoot(options.cwd??process.cwd(),options.pmRoot);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());const subject=await resolveHistorySubject(pmRoot,id,settings,typeRegistry.type_to_folder);const history=await readHistoryEntries(subject.historyPath,subject.id);if(history.length===0){throw new PmCliError(`No history exists for ${subject.id}; point-in-time reads are unavailable.`,EXIT_CODE.NOT_FOUND)}const resolvedTarget=resolveHistoryTarget(target,history);const replay=ensureMaterializedHistoryTarget(replayHistoryToTarget(history,resolvedTarget.historyIndex),resolvedTarget);const document=replayToCanonicalItemDocument(replay,{schema:settings.schema});if(document.metadata.id!==subject.id){throw new PmCliError(`History target resolved to item ${document.metadata.id}, expected ${subject.id}.`,EXIT_CODE.GENERIC_FAILURE)}const targetEntry=history[resolvedTarget.historyIndex];const offset=historyVersionOffset(history,true);return{document,reconstructed:true,as_of_version:offset===null?null:offset+resolvedTarget.historyIndex+1,as_of_timestamp:targetEntry.ts,target:resolvedTarget,history_length:history.length}}export{applyHistoryPatch,ensureMaterializedHistoryTarget,extractPatchFailureContext,findHistoryIdentityDiscontinuities,getItemAt,readHistoryEntries,replayHistoryToTarget,resolveHistoryTarget,verifyHistoryEntries};
 //# sourceMappingURL=history-read.js.map
-//# debugId=6fe766e2-93e8-5653-beb5-16bd92efae51

package/dist/sdk/history-redact.d.ts

@@ -1,7 +1,6 @@
+export { resolveHistorySubject, type HistorySubject, } from "./history/subject.js";
 import { type ReplayDocument } from "../core/history/replay.js";
 import type { GlobalOptions } from "../core/shared/command-types.js";
-import { locateItem } from "../core/store/item-store.js";
-import { readSettings } from "../core/store/settings.js";
 /** Documents the history redact command options payload exchanged by command, SDK, and package integrations. */
 export interface HistoryRedactCommandOptions {
     /** Value that configures or reports literal for this contract. */
@@ -29,15 +28,6 @@ interface LiteralRule {
     value: string;
 }
 type RedactionRule = RegexRule | LiteralRule;
-/** Documents the history subject payload exchanged by command, SDK, and package integrations. */
-export interface HistorySubject {
-    /** Stable identifier used to reference this record across commands and storage. */
-    id: string;
-    /** Filesystem path used for history resolution. */
-    historyPath: string;
-    /** Value that configures or reports located for this contract. */
-    located: Awaited<ReturnType<typeof locateItem>>;
-}
 /** Documents the history redact result payload exchanged by command, SDK, and package integrations. */
 export interface HistoryRedactResult {
     /** Stable identifier used to reference this record across commands and storage. */
@@ -104,8 +94,6 @@ declare function redactUnknownValue(value: unknown, rules: RedactionRule[], repl
     replacements: number;
 };
 declare function hasItemMetadata(replay: ReplayDocument): boolean;
-/** Implements resolve history subject for the public runtime surface of this module. */
-export declare function resolveHistorySubject(pmRoot: string, id: string, settings: Awaited<ReturnType<typeof readSettings>>, typeToFolder: Record<string, string>): Promise<HistorySubject>;
 /** Implements run history redact for the public runtime surface of this module. */
 export declare function runHistoryRedact(id: string, options: HistoryRedactCommandOptions, global: GlobalOptions): Promise<HistoryRedactResult>;
 /** Public contract for test only, shared by SDK and presentation-layer consumers. */
@@ -120,4 +108,3 @@ export declare const _testOnly: {
     redactStringValue: typeof redactStringValue;
     redactUnknownValue: typeof redactUnknownValue;
 };
-export {};