@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/sdk/governance/extension-host-version.js

@@ -1,116 +1,2 @@
-/**
- * @module sdk/governance/extension-host-version
- *
- * Discovers the pm-cli copy that each loaded extension resolves at runtime so
- * package-manager layout skew is visible before SDK singleton state diverges.
- */
-
-!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]="c21b1a94-1d80-57c0-b090-c4831fc505a2")}catch(e){}}();
-import fs from "node:fs/promises";
-import { createRequire } from "node:module";
-import path from "node:path";
-import { resolvePmPackageRootFromModule } from "../../core/packages/root.js";
-function displayPackagePath(packageJsonPath, workspaceRoot) {
-    const relative = path.relative(workspaceRoot, packageJsonPath);
-    if (relative.length > 0 &&
-        relative !== ".." &&
-        !relative.startsWith(`..${path.sep}`) &&
-        !path.isAbsolute(relative)) {
-        return relative.split(path.sep).join("/");
-    }
-    const externalPath = path.resolve(packageJsonPath);
-    let fingerprint = 0xcbf29ce484222325n;
-    for (let index = 0; index < externalPath.length; index += 1) {
-        fingerprint ^= BigInt(externalPath.charCodeAt(index));
-        fingerprint = BigInt.asUintN(64, fingerprint * 0x100000001b3n);
-    }
-    const installationId = fingerprint.toString(16).padStart(16, "0");
-    return `<external>/${installationId}/${path.basename(path.dirname(packageJsonPath))}/package.json`;
-}
-function dependencyLayout(packageJsonPath) {
-    if (packageJsonPath.includes(`${path.sep}.pnpm${path.sep}`))
-        return "pnpm";
-    if (packageJsonPath.includes(`${path.sep}node_modules${path.sep}`)) {
-        return "npm";
-    }
-    return "other";
-}
-async function readPackageVersion(packageJsonPath) {
-    try {
-        const parsed = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
-        return parsed.name === "@unbrained/pm-cli" &&
-            typeof parsed.version === "string" &&
-            parsed.version.trim().length > 0
-            ? parsed.version.trim()
-            : undefined;
-    }
-    catch {
-        return undefined;
-    }
-}
-/** Resolve symlink and platform alias segments without failing soft scans for absent hosts. */
-async function canonicalPath(candidate) {
-    try {
-        return await fs.realpath(candidate);
-    }
-    catch {
-        return path.resolve(candidate);
-    }
-}
-/** Scan the host plus the nearest pm-cli package resolvable by every loaded extension. */
-export async function scanExtensionHostVersions(loadedExtensions, workspaceRoot, hostPackageRoot = resolvePmPackageRootFromModule(import.meta.url, [
-    "../../..",
-])) {
-    const canonicalWorkspaceRoot = await canonicalPath(workspaceRoot);
-    const hostPackageJson = await canonicalPath(path.join(hostPackageRoot, "package.json"));
-    const hostVersion = await readPackageVersion(hostPackageJson);
-    const copies = new Map();
-    if (hostVersion !== undefined) {
-        copies.set(hostPackageJson, {
-            version: hostVersion,
-            path: displayPackagePath(hostPackageJson, canonicalWorkspaceRoot),
-            layout: "host",
-            consumers: ["pm-cli-host"],
-        });
-    }
-    for (const extension of loadedExtensions) {
-        try {
-            const resolved = createRequire(extension.entry_path).resolve("@unbrained/pm-cli/package.json");
-            const canonicalPackageJson = await canonicalPath(resolved);
-            const version = await readPackageVersion(canonicalPackageJson);
-            if (version === undefined)
-                continue;
-            const key = canonicalPackageJson;
-            const existing = copies.get(key);
-            if (existing) {
-                if (!existing.consumers.includes(extension.name)) {
-                    existing.consumers.push(extension.name);
-                    existing.consumers.sort((left, right) => left.localeCompare(right));
-                }
-                continue;
-            }
-            copies.set(key, {
-                version,
-                path: displayPackagePath(canonicalPackageJson, canonicalWorkspaceRoot),
-                layout: dependencyLayout(canonicalPackageJson),
-                consumers: [extension.name],
-            });
-        }
-        catch {
-            // Extensions that do not resolve pm-cli use the host surface they were
-            // handed. Load/activation diagnostics own unrelated resolution failures.
-        }
-    }
-    const sortedCopies = [...copies.values()].sort((left, right) => left.path.localeCompare(right.path));
-    const mismatches = hostVersion === undefined
-        ? []
-        : sortedCopies.filter((copy) => copy.version !== hostVersion);
-    return {
-        host_version: hostVersion ?? null,
-        copies: sortedCopies,
-        mismatches,
-        warnings: mismatches.map((copy) => `extension_host_pm_cli_version_skew:${hostVersion}:${copy.version}:${copy.consumers.join("+")}`),
-    };
-}
+!(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]="a0014621-9e3d-5620-8f36-081811054843")}catch(e2){}})();import fs from"node:fs/promises";import{createRequire}from"node:module";import path from"node:path";import{resolvePmPackageRootFromModule}from"../../core/packages/root.js";function displayPackagePath(packageJsonPath,workspaceRoot){const relative=path.relative(workspaceRoot,packageJsonPath);if(relative.length>0&&relative!==".."&&!relative.startsWith(`..${path.sep}`)&&!path.isAbsolute(relative)){return relative.split(path.sep).join("/")}const externalPath=path.resolve(packageJsonPath);let fingerprint=0xcbf29ce484222325n;for(let index=0;index<externalPath.length;index+=1){fingerprint^=BigInt(externalPath.charCodeAt(index));fingerprint=BigInt.asUintN(64,fingerprint*0x100000001b3n)}const installationId=fingerprint.toString(16).padStart(16,"0");return`<external>/${installationId}/${path.basename(path.dirname(packageJsonPath))}/package.json`}function dependencyLayout(packageJsonPath){if(packageJsonPath.includes(`${path.sep}.pnpm${path.sep}`))return"pnpm";if(packageJsonPath.includes(`${path.sep}node_modules${path.sep}`)){return"npm"}return"other"}async function readPackageVersion(packageJsonPath){try{const parsed=JSON.parse(await fs.readFile(packageJsonPath,"utf8"));return parsed.name==="@unbrained/pm-cli"&&typeof parsed.version==="string"&&parsed.version.trim().length>0?parsed.version.trim():void 0}catch{return void 0}}async function canonicalPath(candidate){try{return await fs.realpath(candidate)}catch{return path.resolve(candidate)}}async function scanExtensionHostVersions(loadedExtensions,workspaceRoot,hostPackageRoot=resolvePmPackageRootFromModule(import.meta.url,["../../.."])){const canonicalWorkspaceRoot=await canonicalPath(workspaceRoot);const hostPackageJson=await canonicalPath(path.join(hostPackageRoot,"package.json"));const hostVersion=await readPackageVersion(hostPackageJson);const copies=new Map;if(hostVersion!==void 0){copies.set(hostPackageJson,{version:hostVersion,path:displayPackagePath(hostPackageJson,canonicalWorkspaceRoot),layout:"host",consumers:["pm-cli-host"]})}for(const extension of loadedExtensions){try{const resolved=createRequire(extension.entry_path).resolve("@unbrained/pm-cli/package.json");const canonicalPackageJson=await canonicalPath(resolved);const version=await readPackageVersion(canonicalPackageJson);if(version===void 0)continue;const key=canonicalPackageJson;const existing=copies.get(key);if(existing){if(!existing.consumers.includes(extension.name)){existing.consumers.push(extension.name);existing.consumers.sort((left,right)=>left.localeCompare(right))}continue}copies.set(key,{version,path:displayPackagePath(canonicalPackageJson,canonicalWorkspaceRoot),layout:dependencyLayout(canonicalPackageJson),consumers:[extension.name]})}catch{}}const sortedCopies=[...copies.values()].sort((left,right)=>left.path.localeCompare(right.path));const mismatches=hostVersion===void 0?[]:sortedCopies.filter(copy=>copy.version!==hostVersion);return{host_version:hostVersion??null,copies:sortedCopies,mismatches,warnings:mismatches.map(copy=>`extension_host_pm_cli_version_skew:${hostVersion}:${copy.version}:${copy.consumers.join("+")}`)}}export{scanExtensionHostVersions};
 //# sourceMappingURL=extension-host-version.js.map
-//# debugId=c21b1a94-1d80-57c0-b090-c4831fc505a2

package/dist/sdk/governance/gc.js

@@ -1,369 +1,2 @@
-/**
- * @module sdk/governance/gc
- *
- * Implements the pm gc 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]="76f8405f-138d-5119-a300-f068354394a5")}catch(e){}}();
-import { assertInitializedTracker } from "../environment/tracker-preflight.js";
-import fs from "node:fs/promises";
-import path from "node:path";
-import { runCheckpointGc } from "../../core/checkpoint/checkpoint-gc.js";
-import { runWorkspaceTransactionGc } from "../workspace-transaction-gc.js";
-import { runActiveOnIndexHooks, runActiveOnReadHooks, runActiveOnWriteHooks, } from "../../core/extensions/index.js";
-import { isFileMissingError, pathExists } from "../../core/fs/fs-utils.js";
-import { runLockGc } from "../../core/lock/lock-gc.js";
-import { EXIT_CODE } from "../../core/shared/constants.js";
-import { PmCliError } from "../../core/shared/errors.js";
-import { nowIso } from "../../core/shared/time.js";
-import { resolvePmRoot } from "../../core/store/paths.js";
-import { readSettings } from "../../core/store/settings.js";
-const GC_SCOPE_VALUES = [
-    "index",
-    "embeddings",
-    "runtime",
-    "locks",
-    "checkpoints",
-    "transactions",
-];
-const WORKSPACE_SNAPSHOT_TEMP_RETENTION_MS = 24 * 60 * 60 * 1_000;
-const GC_TARGETS = [
-    {
-        scope: "index",
-        relativePath: "index/manifest.json",
-        kind: "file",
-    },
-    {
-        scope: "embeddings",
-        relativePath: "search/embeddings.jsonl",
-        kind: "file",
-    },
-    {
-        scope: "embeddings",
-        relativePath: "search/vectorization-status.json",
-        kind: "file",
-    },
-    {
-        scope: "embeddings",
-        relativePath: "search/lancedb",
-        kind: "directory",
-    },
-    {
-        // Removing embeddings invalidates the whole semantic index, so the queued
-        // background-refresh work is also meaningless: a worker draining a stale
-        // queue against an empty ledger would rebuild a partial, inconsistent index
-        // (only the queued items vectorized). Clear the queue and its gate so the
-        // next mutation re-seeds from a clean slate. See core/search/background-refresh.ts.
-        scope: "embeddings",
-        relativePath: "search/pending-refresh.json",
-        kind: "file",
-    },
-    {
-        scope: "embeddings",
-        relativePath: "search/pending-refresh.gate.lock",
-        kind: "directory",
-    },
-    {
-        scope: "runtime",
-        relativePath: "runtime/test-runs",
-        kind: "directory",
-    },
-    {
-        scope: "runtime",
-        relativePath: "runtime/history-drift-cache.json",
-        kind: "file",
-    },
-];
-async function removeCacheFile(pmRoot, target, dryRun) {
-    const relativePath = target.relativePath;
-    const absolutePath = path.join(pmRoot, relativePath);
-    const warnings = await runActiveOnReadHooks({
-        path: absolutePath,
-        scope: "project",
-    });
-    try {
-        const stats = await fs.stat(absolutePath);
-        if (target.kind === "file" && !stats.isFile()) {
-            return {
-                removed: false,
-                warnings: [...warnings, `not_a_file:${relativePath}`],
-            };
-        }
-        if (target.kind === "directory" && !stats.isDirectory()) {
-            return {
-                removed: false,
-                warnings: [...warnings, `not_a_directory:${relativePath}`],
-            };
-        }
-        if (dryRun) {
-            return {
-                removed: true,
-                warnings,
-            };
-        }
-        if (target.kind === "file") {
-            await fs.unlink(absolutePath);
-        }
-        else {
-            await fs.rm(absolutePath, { recursive: true, force: true });
-        }
-        const writeWarnings = await runActiveOnWriteHooks({
-            path: absolutePath,
-            scope: "project",
-            op: "gc:remove",
-        });
-        return {
-            removed: true,
-            warnings: [...warnings, ...writeWarnings],
-        };
-    }
-    catch (error) {
-        if (isFileMissingError(error)) {
-            return {
-                removed: false,
-                warnings,
-            };
-        }
-        throw error;
-    }
-}
-async function sweepWorkspaceSnapshotTemps(pmRoot, dryRun) {
-    const roots = [
-        {
-            relativePath: "runtime/workspace-snapshots/objects",
-            prefix: ".create-",
-        },
-        {
-            relativePath: "runtime/workspace-snapshots/refs",
-            prefix: ".ref-",
-        },
-    ];
-    const removed = [];
-    const retained = [];
-    const warnings = [];
-    const staleBefore = Date.now() - WORKSPACE_SNAPSHOT_TEMP_RETENTION_MS;
-    for (const root of roots) {
-        const absoluteRoot = path.join(pmRoot, root.relativePath);
-        if (!(await pathExists(absoluteRoot))) {
-            continue;
-        }
-        const names = (await fs.readdir(absoluteRoot))
-            .filter((name) => name.startsWith(root.prefix))
-            .sort();
-        for (const name of names) {
-            const relativePath = path.posix.join(root.relativePath, name);
-            const absolutePath = path.join(absoluteRoot, name);
-            warnings.push(...(await runActiveOnReadHooks({
-                path: absolutePath,
-                scope: "project",
-            })));
-            const stats = await fs.stat(absolutePath).catch((error) => {
-                if (isFileMissingError(error)) {
-                    return undefined;
-                }
-                throw error;
-            });
-            if (!stats) {
-                continue;
-            }
-            if (stats.mtimeMs > staleBefore) {
-                retained.push(relativePath);
-                continue;
-            }
-            removed.push(relativePath);
-            if (dryRun) {
-                continue;
-            }
-            await fs.rm(absolutePath, { recursive: true, force: true });
-            warnings.push(...(await runActiveOnWriteHooks({
-                path: absolutePath,
-                scope: "project",
-                op: "gc:workspace_snapshot_temp_remove",
-            })));
-        }
-    }
-    return { removed, retained, warnings };
-}
-function parseScopes(raw) {
-    if (!raw || raw.length === 0) {
-        return [...GC_SCOPE_VALUES];
-    }
-    const tokens = raw
-        .flatMap((entry) => entry.split(","))
-        .map((entry) => entry.trim().toLowerCase())
-        .filter((entry) => entry.length > 0);
-    if (tokens.length === 0) {
-        throw new PmCliError(`--scope requires at least one value (${GC_SCOPE_VALUES.join(",")})`, EXIT_CODE.USAGE);
-    }
-    const resolved = new Set();
-    for (const token of tokens) {
-        if (!GC_SCOPE_VALUES.includes(token)) {
-            throw new PmCliError(`Invalid --scope value "${token}". Expected one or more of: ${GC_SCOPE_VALUES.join(", ")}`, EXIT_CODE.USAGE);
-        }
-        resolved.add(token);
-    }
-    return GC_SCOPE_VALUES.filter((scope) => resolved.has(scope));
-}
-function buildGcGuidance(params) {
-    const guidance = [];
-    if (params.dryRun) {
-        guidance.push("Dry-run preview only: no cache artifacts were deleted.");
-    }
-    const searchScopeSelected = params.scopes.includes("index") || params.scopes.includes("embeddings");
-    const searchArtifactsAffected = params.removed.some((entry) => entry === "index/manifest.json" ||
-        entry === "search/embeddings.jsonl" ||
-        entry === "search/vectorization-status.json" ||
-        entry === "search/lancedb" ||
-        entry === "search/pending-refresh.json" ||
-        entry === "search/pending-refresh.gate.lock");
-    if (searchScopeSelected && searchArtifactsAffected) {
-        guidance.push('Search artifacts were removed; the semantic index (including any queued background refresh) is invalidated. Run "pm install search-advanced --project" if reindex is unavailable, then "pm reindex --mode keyword" (and "--mode semantic" when semantic search is enabled) before search-heavy workflows.');
-    }
-    if (params.removed.includes("runtime/history-drift-cache.json")) {
-        guidance.push('History drift cache was removed; the next "pm health" run performs a full history-drift re-scan.');
-    }
-    if (!params.dryRun &&
-        params.removed.some((entry) => entry.startsWith("checkpoints/"))) {
-        guidance.push('Aged rollback checkpoints were removed; their "pm update-many"/"pm close-many --rollback" windows are no longer recoverable.');
-    }
-    if (!params.dryRun &&
-        params.removed.some((entry) => entry.startsWith("transactions/"))) {
-        guidance.push("Aged terminal workspace-transaction journals were removed; replaying those transactionIds re-executes their idempotent steps instead of short-circuiting.");
-    }
-    return guidance;
-}
-/** Implements run gc for the public runtime surface of this module. */
-export async function runGc(global, options = {}) {
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    await assertInitializedTracker(pmRoot);
-    const settings = await readSettings(pmRoot);
-    const dryRun = options.dryRun === true;
-    const scopes = parseScopes(options.scope);
-    const selectedTargets = GC_TARGETS.filter((target) => scopes.includes(target.scope));
-    const removed = [];
-    const retained = [];
-    const warnings = [];
-    for (const target of selectedTargets) {
-        const result = await removeCacheFile(pmRoot, target, dryRun);
-        if (result.removed) {
-            removed.push(target.relativePath);
-        }
-        else {
-            retained.push(target.relativePath);
-        }
-        warnings.push(...result.warnings);
-    }
-    if (scopes.includes("runtime")) {
-        const snapshotTempResult = await sweepWorkspaceSnapshotTemps(pmRoot, dryRun);
-        removed.push(...snapshotTempResult.removed);
-        retained.push(...snapshotTempResult.retained);
-        warnings.push(...snapshotTempResult.warnings);
-    }
-    // The locks scope is not a path-based GC_TARGET: it sweeps the locks/ directory
-    // and removes only locks whose own embedded ttl has expired (crashed-process
-    // debris), retaining active and unparseable locks. See core/lock/lock-gc.ts.
-    let locksSummary;
-    if (scopes.includes("locks")) {
-        const lockResult = await runLockGc(pmRoot, {
-            dryRun,
-            hooks: {
-                onRead: (lockPath) => runActiveOnReadHooks({ path: lockPath, scope: "project" }),
-                onWrite: (lockPath) => runActiveOnWriteHooks({
-                    path: lockPath,
-                    scope: "project",
-                    op: "gc:lock_remove",
-                }),
-            },
-        });
-        removed.push(...lockResult.removed);
-        retained.push(...lockResult.retained);
-        warnings.push(...lockResult.warnings);
-        locksSummary = {
-            scanned: lockResult.scanned,
-            removed: lockResult.removed.length,
-            retained: lockResult.retained.length,
-        };
-    }
-    // The checkpoints scope is also not a path-based GC_TARGET: it sweeps
-    // checkpoints/ and removes only rollback checkpoints older than the configured
-    // checkpoints.retention_days, retaining active and unparseable files. See
-    // core/checkpoint/checkpoint-gc.ts.
-    // The transactions scope sweeps transactions/sdk/ and removes only terminal
-    // (committed/compensated) workspace-transaction journals older than the
-    // shared recovery-receipt retention, retaining in-flight and unparseable
-    // journals. See sdk/workspace-transaction-gc.ts.
-    let transactionsSummary;
-    if (scopes.includes("transactions")) {
-        const retentionDays = settings.checkpoints.retention_days;
-        const transactionResult = await runWorkspaceTransactionGc(pmRoot, {
-            dryRun,
-            retentionDays,
-            hooks: {
-                onRead: (journalPath) => runActiveOnReadHooks({ path: journalPath, scope: "project" }),
-                onWrite: (journalPath) => runActiveOnWriteHooks({
-                    path: journalPath,
-                    scope: "project",
-                    op: "gc:transaction_journal_remove",
-                }),
-            },
-        });
-        removed.push(...transactionResult.removed);
-        retained.push(...transactionResult.retained);
-        warnings.push(...transactionResult.warnings);
-        transactionsSummary = {
-            scanned: transactionResult.scanned,
-            removed: transactionResult.removed.length,
-            retained: transactionResult.retained.length,
-            retention_days: retentionDays,
-        };
-    }
-    let checkpointsSummary;
-    if (scopes.includes("checkpoints")) {
-        const retentionDays = settings.checkpoints.retention_days;
-        const checkpointResult = await runCheckpointGc(pmRoot, {
-            dryRun,
-            retentionDays,
-            hooks: {
-                onRead: (checkpointPath) => runActiveOnReadHooks({ path: checkpointPath, scope: "project" }),
-                onWrite: (checkpointPath) => runActiveOnWriteHooks({
-                    path: checkpointPath,
-                    scope: "project",
-                    op: "gc:checkpoint_remove",
-                }),
-            },
-        });
-        removed.push(...checkpointResult.removed);
-        retained.push(...checkpointResult.retained);
-        warnings.push(...checkpointResult.warnings);
-        checkpointsSummary = {
-            scanned: checkpointResult.scanned,
-            removed: checkpointResult.removed.length,
-            retained: checkpointResult.retained.length,
-            retention_days: retentionDays,
-        };
-    }
-    warnings.push(...(await runActiveOnIndexHooks({
-        mode: dryRun ? "gc:dry-run" : "gc",
-        total_items: selectedTargets.length,
-    })));
-    const guidance = buildGcGuidance({
-        dryRun,
-        scopes,
-        removed,
-    });
-    return {
-        ok: warnings.length === 0,
-        dry_run: dryRun,
-        scope: scopes,
-        removed,
-        retained,
-        warnings,
-        ...(locksSummary ? { locks: locksSummary } : {}),
-        ...(checkpointsSummary ? { checkpoints: checkpointsSummary } : {}),
-        ...(transactionsSummary ? { transactions: transactionsSummary } : {}),
-        guidance,
-        generated_at: nowIso(),
-    };
-}
+!(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]="8e2e3b62-5eb1-5773-96bf-866b26a59345")}catch(e2){}})();import{assertInitializedTracker}from"../environment/tracker-preflight.js";import fs from"node:fs/promises";import path from"node:path";import{runCheckpointGc}from"../../core/checkpoint/checkpoint-gc.js";import{runWorkspaceTransactionGc}from"../workspace-transaction-gc.js";import{runActiveOnIndexHooks,runActiveOnReadHooks,runActiveOnWriteHooks}from"../../core/extensions/index.js";import{isFileMissingError,pathExists}from"../../core/fs/fs-utils.js";import{runLockGc}from"../../core/lock/lock-gc.js";import{EXIT_CODE}from"../../core/shared/constants.js";import{PmCliError}from"../../core/shared/errors.js";import{nowIso}from"../../core/shared/time.js";import{resolvePmRoot}from"../../core/store/paths.js";import{readSettings}from"../../core/store/settings.js";const GC_SCOPE_VALUES=["index","embeddings","runtime","locks","checkpoints","transactions"];const WORKSPACE_SNAPSHOT_TEMP_RETENTION_MS=24*60*60*1e3;const GC_TARGETS=[{scope:"index",relativePath:"index/manifest.json",kind:"file"},{scope:"embeddings",relativePath:"search/embeddings.jsonl",kind:"file"},{scope:"embeddings",relativePath:"search/vectorization-status.json",kind:"file"},{scope:"embeddings",relativePath:"search/lancedb",kind:"directory"},{scope:"embeddings",relativePath:"search/pending-refresh.json",kind:"file"},{scope:"embeddings",relativePath:"search/pending-refresh.gate.lock",kind:"directory"},{scope:"runtime",relativePath:"runtime/test-runs",kind:"directory"},{scope:"runtime",relativePath:"runtime/history-drift-cache.json",kind:"file"}];async function removeCacheFile(pmRoot,target,dryRun){const relativePath=target.relativePath;const absolutePath=path.join(pmRoot,relativePath);const warnings=await runActiveOnReadHooks({path:absolutePath,scope:"project"});try{const stats=await fs.stat(absolutePath);if(target.kind==="file"&&!stats.isFile()){return{removed:false,warnings:[...warnings,`not_a_file:${relativePath}`]}}if(target.kind==="directory"&&!stats.isDirectory()){return{removed:false,warnings:[...warnings,`not_a_directory:${relativePath}`]}}if(dryRun){return{removed:true,warnings}}if(target.kind==="file"){await fs.unlink(absolutePath)}else{await fs.rm(absolutePath,{recursive:true,force:true})}const writeWarnings=await runActiveOnWriteHooks({path:absolutePath,scope:"project",op:"gc:remove"});return{removed:true,warnings:[...warnings,...writeWarnings]}}catch(error){if(isFileMissingError(error)){return{removed:false,warnings}}throw error}}async function sweepWorkspaceSnapshotTemps(pmRoot,dryRun){const roots=[{relativePath:"runtime/workspace-snapshots/objects",prefix:".create-"},{relativePath:"runtime/workspace-snapshots/refs",prefix:".ref-"}];const removed=[];const retained=[];const warnings=[];const staleBefore=Date.now()-WORKSPACE_SNAPSHOT_TEMP_RETENTION_MS;for(const root of roots){const absoluteRoot=path.join(pmRoot,root.relativePath);if(!await pathExists(absoluteRoot)){continue}const names=(await fs.readdir(absoluteRoot)).filter(name=>name.startsWith(root.prefix)).sort();for(const name of names){const relativePath=path.posix.join(root.relativePath,name);const absolutePath=path.join(absoluteRoot,name);warnings.push(...await runActiveOnReadHooks({path:absolutePath,scope:"project"}));const stats=await fs.stat(absolutePath).catch(error=>{if(isFileMissingError(error)){return void 0}throw error});if(!stats){continue}if(stats.mtimeMs>staleBefore){retained.push(relativePath);continue}removed.push(relativePath);if(dryRun){continue}await fs.rm(absolutePath,{recursive:true,force:true});warnings.push(...await runActiveOnWriteHooks({path:absolutePath,scope:"project",op:"gc:workspace_snapshot_temp_remove"}))}}return{removed,retained,warnings}}function parseScopes(raw){if(!raw||raw.length===0){return[...GC_SCOPE_VALUES]}const tokens=raw.flatMap(entry=>entry.split(",")).map(entry=>entry.trim().toLowerCase()).filter(entry=>entry.length>0);if(tokens.length===0){throw new PmCliError(`--scope requires at least one value (${GC_SCOPE_VALUES.join(",")})`,EXIT_CODE.USAGE)}const resolved=new Set;for(const token of tokens){if(!GC_SCOPE_VALUES.includes(token)){throw new PmCliError(`Invalid --scope value "${token}". Expected one or more of: ${GC_SCOPE_VALUES.join(", ")}`,EXIT_CODE.USAGE)}resolved.add(token)}return GC_SCOPE_VALUES.filter(scope=>resolved.has(scope))}function buildGcGuidance(params){const guidance=[];if(params.dryRun){guidance.push("Dry-run preview only: no cache artifacts were deleted.")}const searchScopeSelected=params.scopes.includes("index")||params.scopes.includes("embeddings");const searchArtifactsAffected=params.removed.some(entry=>entry==="index/manifest.json"||entry==="search/embeddings.jsonl"||entry==="search/vectorization-status.json"||entry==="search/lancedb"||entry==="search/pending-refresh.json"||entry==="search/pending-refresh.gate.lock");if(searchScopeSelected&&searchArtifactsAffected){guidance.push('Search artifacts were removed; the semantic index (including any queued background refresh) is invalidated. Run "pm install search-advanced --project" if reindex is unavailable, then "pm reindex --mode keyword" (and "--mode semantic" when semantic search is enabled) before search-heavy workflows.')}if(params.removed.includes("runtime/history-drift-cache.json")){guidance.push('History drift cache was removed; the next "pm health" run performs a full history-drift re-scan.')}if(!params.dryRun&&params.removed.some(entry=>entry.startsWith("checkpoints/"))){guidance.push('Aged rollback checkpoints were removed; their "pm update-many"/"pm close-many --rollback" windows are no longer recoverable.')}if(!params.dryRun&&params.removed.some(entry=>entry.startsWith("transactions/"))){guidance.push("Aged terminal workspace-transaction journals were removed; replaying those transactionIds re-executes their idempotent steps instead of short-circuiting.")}return guidance}async function runGc(global2,options={}){const pmRoot=resolvePmRoot(process.cwd(),global2.path);await assertInitializedTracker(pmRoot);const settings=await readSettings(pmRoot);const dryRun=options.dryRun===true;const scopes=parseScopes(options.scope);const selectedTargets=GC_TARGETS.filter(target=>scopes.includes(target.scope));const removed=[];const retained=[];const warnings=[];for(const target of selectedTargets){const result=await removeCacheFile(pmRoot,target,dryRun);if(result.removed){removed.push(target.relativePath)}else{retained.push(target.relativePath)}warnings.push(...result.warnings)}if(scopes.includes("runtime")){const snapshotTempResult=await sweepWorkspaceSnapshotTemps(pmRoot,dryRun);removed.push(...snapshotTempResult.removed);retained.push(...snapshotTempResult.retained);warnings.push(...snapshotTempResult.warnings)}let locksSummary;if(scopes.includes("locks")){const lockResult=await runLockGc(pmRoot,{dryRun,hooks:{onRead:lockPath=>runActiveOnReadHooks({path:lockPath,scope:"project"}),onWrite:lockPath=>runActiveOnWriteHooks({path:lockPath,scope:"project",op:"gc:lock_remove"})}});removed.push(...lockResult.removed);retained.push(...lockResult.retained);warnings.push(...lockResult.warnings);locksSummary={scanned:lockResult.scanned,removed:lockResult.removed.length,retained:lockResult.retained.length}}let transactionsSummary;if(scopes.includes("transactions")){const retentionDays=settings.checkpoints.retention_days;const transactionResult=await runWorkspaceTransactionGc(pmRoot,{dryRun,retentionDays,hooks:{onRead:journalPath=>runActiveOnReadHooks({path:journalPath,scope:"project"}),onWrite:journalPath=>runActiveOnWriteHooks({path:journalPath,scope:"project",op:"gc:transaction_journal_remove"})}});removed.push(...transactionResult.removed);retained.push(...transactionResult.retained);warnings.push(...transactionResult.warnings);transactionsSummary={scanned:transactionResult.scanned,removed:transactionResult.removed.length,retained:transactionResult.retained.length,retention_days:retentionDays}}let checkpointsSummary;if(scopes.includes("checkpoints")){const retentionDays=settings.checkpoints.retention_days;const checkpointResult=await runCheckpointGc(pmRoot,{dryRun,retentionDays,hooks:{onRead:checkpointPath=>runActiveOnReadHooks({path:checkpointPath,scope:"project"}),onWrite:checkpointPath=>runActiveOnWriteHooks({path:checkpointPath,scope:"project",op:"gc:checkpoint_remove"})}});removed.push(...checkpointResult.removed);retained.push(...checkpointResult.retained);warnings.push(...checkpointResult.warnings);checkpointsSummary={scanned:checkpointResult.scanned,removed:checkpointResult.removed.length,retained:checkpointResult.retained.length,retention_days:retentionDays}}warnings.push(...await runActiveOnIndexHooks({mode:dryRun?"gc:dry-run":"gc",total_items:selectedTargets.length}));const guidance=buildGcGuidance({dryRun,scopes,removed});return{ok:warnings.length===0,dry_run:dryRun,scope:scopes,removed,retained,warnings,...locksSummary?{locks:locksSummary}:{},...checkpointsSummary?{checkpoints:checkpointsSummary}:{},...transactionsSummary?{transactions:transactionsSummary}:{},guidance,generated_at:nowIso()}}export{runGc};
 //# sourceMappingURL=gc.js.map
-//# debugId=76f8405f-138d-5119-a300-f068354394a5