@unbrained/pm-cli 2026.7.14 → 2026.7.16

package/dist/cli/commands/history-redact.d.ts

@@ -1,120 +1,8 @@
-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. */
-    literal?: string[] | string;
-    /** Value that configures or reports regex for this contract. */
-    regex?: string[] | string;
-    /** Value that configures or reports replacement for this contract. */
-    replacement?: string;
-    /** Value that configures or reports dry run for this contract. */
-    dryRun?: boolean;
-    /** Value that configures or reports author for this contract. */
-    author?: string;
-    /** Human-readable explanation suitable for logs and agent-facing output. */
-    message?: string;
-    /** Value that configures or reports force for this contract. */
-    force?: boolean;
-}
-interface RegexRule {
-    kind: "regex";
-    source: string;
-    flags: string;
-    label: string;
-}
-interface LiteralRule {
-    kind: "literal";
-    value: string;
-    label: 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. */
-    id: string;
-    /** Value that configures or reports dry run for this contract. */
-    dry_run: boolean;
-    /** Value that configures or reports changed for this contract. */
-    changed: boolean;
-    /** Value that configures or reports patterns for this contract. */
-    patterns: {
-        literals: string[];
-        regex: string[];
-        replacement: string;
-    };
-    /** Value that configures or reports history for this contract. */
-    history: {
-        path: string;
-        entries_scanned: number;
-        entries_changed: number;
-        replacements: number;
-        hash_mismatches_before: number;
-        hash_mismatches_after: number;
-        preexisting_hash_mismatches: number;
-        audit_entry_added: boolean;
-        verify_ok: boolean;
-        verify_errors: string[];
-    };
-    /** Value that configures or reports item for this contract. */
-    item: {
-        existed_before: boolean;
-        exists_after: boolean;
-        path_before: string | null;
-        path_after: string | null;
-        changed: boolean;
-    };
-    /** Value that configures or reports warnings for this contract. */
-    warnings: string[];
-    /** ISO 8601 timestamp recording when generated occurred. */
-    generated_at: string;
-}
-declare function normalizeStringArrayInput(value: string[] | string | undefined): string[];
-declare function normalizeRegexFlags(flags: string): string;
-declare function parseRegexRule(spec: string): RegexRule;
-declare function buildRedactionRules(literalInput: string[] | string | undefined, regexInput: string[] | string | undefined): RedactionRule[];
-declare function applyLiteralRule(value: string, literal: string, replacement: string): {
-    value: string;
-    replacements: number;
-};
-declare function applyRegexRule(value: string, rule: RegexRule, replacement: string): {
-    value: string;
-    replacements: number;
-};
-declare function redactStringValue(value: string, rules: RedactionRule[], replacement: string): {
-    value: string;
-    replacements: number;
-};
-declare function redactUnknownValue(value: unknown, rules: RedactionRule[], replacement: string): {
-    value: unknown;
-    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. */
-export declare const _testOnly: {
-    applyLiteralRule: typeof applyLiteralRule;
-    applyRegexRule: typeof applyRegexRule;
-    buildRedactionRules: typeof buildRedactionRules;
-    hasItemMetadata: typeof hasItemMetadata;
-    normalizeRegexFlags: typeof normalizeRegexFlags;
-    normalizeStringArrayInput: typeof normalizeStringArrayInput;
-    parseRegexRule: typeof parseRegexRule;
-    redactStringValue: typeof redactStringValue;
-    redactUnknownValue: typeof redactUnknownValue;
-};
-export {};
+/**
+ * @module cli/commands/history-redact
+ *
+ * Presentation compatibility shim for the public SDK history-redaction
+ * primitive. CLI registration imports this module so extensions and existing
+ * integrations keep a stable command path while all domain logic is SDK-owned.
+ */
+export { _testOnly, resolveHistorySubject, runHistoryRedact, type HistoryRedactCommandOptions, type HistoryRedactResult, type HistorySubject, } from "../../sdk/history-redact.js";