@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/governance/upgrade.js

@@ -1,328 +1,3 @@
-/**
- * @module cli/commands/upgrade
- *
- * Implements the pm upgrade 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]="46439d77-bb74-5f36-9383-ac3362f41b3e")}catch(e){}}();
-import { execFile } from "node:child_process";
-import path from "node:path";
-import { promisify } from "node:util";
-import { renderPmCommand } from "../command-line.js";
-import { readManagedExtensionState, runExtension, } from "../extension.js";
-import { resolveExtensionRoots, pathExists, EXIT_CODE, PmCliError, resolvePmRoot, resolvePmCliVersion, } from "../runtime-primitives.js";
-const execFileAsync = promisify(execFile);
-const DEFAULT_CLI_PACKAGE = "@unbrained/pm-cli";
-const DEFAULT_TAG = "latest";
-const PACKAGE_UPGRADE_RETRY_SCOPE_FLAGS = {
-    global: ["--global"],
-    project: [],
-};
-/** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export const _testOnly = {
-    defaultCommandRunner,
-    isLocalNpmSpec,
-    normalizeTarget,
-    packageRecordMatchesTarget,
-    resolveCliPackage,
-    resolvePackageInstallSource,
-    resolveRunnablePackageSource,
-    resolveScope,
-    resolveTag,
-    packageCommandFor,
-    summarize,
-};
-function resolveScope(options) {
-    const projectLike = options.project === true ||
-        options.local === true ||
-        options.scope === "project";
-    const global = options.global === true || options.scope === "global";
-    if (projectLike && global) {
-        throw new PmCliError('Options "--project/--local" and "--global" are mutually exclusive.', EXIT_CODE.USAGE);
-    }
-    return global ? "global" : "project";
-}
-function normalizeTarget(value) {
-    return value.trim().toLowerCase();
-}
-function packageRecordMatchesTarget(record, target) {
-    const normalizedTarget = normalizeTarget(target);
-    const values = [
-        record.name,
-        record.directory,
-        record.source.input,
-        record.source.location,
-        record.source.package,
-        record.source.repository,
-        record.source.owner && record.source.repo
-            ? `${record.source.owner}/${record.source.repo}`
-            : undefined,
-    ];
-    return values.some((value) => typeof value === "string" && normalizeTarget(value) === normalizedTarget);
-}
-function resolveRoots(scope, global) {
-    const pmRoot = resolvePmRoot(process.cwd(), global.path);
-    const roots = resolveExtensionRoots(pmRoot, process.cwd());
-    return {
-        selected_root: scope === "global" ? roots.global : roots.project,
-    };
-}
-async function defaultCommandRunner(command, args, options) {
-    try {
-        const result = await execFileAsync(command, args, {
-            cwd: options?.cwd,
-            encoding: "utf8",
-        });
-        return {
-            stdout: result.stdout,
-            stderr: result.stderr,
-        };
-    }
-    catch (error) {
-        const stderr = typeof error === "object" && error !== null && "stderr" in error
-            ? String(error.stderr ?? "")
-            : "";
-        const message = stderr.trim().length > 0
-            ? stderr.trim()
-            : error instanceof Error
-                ? error.message
-                : String(error);
-        throw new PmCliError(`Command failed: ${command} ${args.join(" ")}\n${message}`, EXIT_CODE.GENERIC_FAILURE);
-    }
-}
-async function readCurrentVersion() {
-    return resolvePmCliVersion(import.meta.url, ["../../.."]);
-}
-function resolveTag(options) {
-    return typeof options.tag === "string" && options.tag.trim().length > 0
-        ? options.tag.trim()
-        : DEFAULT_TAG;
-}
-function resolveCliPackage(options) {
-    return typeof options.packageName === "string" &&
-        options.packageName.trim().length > 0
-        ? options.packageName.trim()
-        : DEFAULT_CLI_PACKAGE;
-}
-async function upgradeCli(options, dryRun) {
-    const runner = options.commandRunner ?? defaultCommandRunner;
-    const packageName = resolveCliPackage(options);
-    const tag = resolveTag(options);
-    const target = `${packageName}@${tag}`;
-    const command = ["npm", "install", "-g", target];
-    if (options.repair === true) {
-        command.push("--force");
-    }
-    const beforeVersion = await readCurrentVersion();
-    const planned = {
-        requested: true,
-        status: "planned",
-        package: packageName,
-        target,
-        command,
-        before_version: beforeVersion,
-        repair: options.repair === true,
-    };
-    if (dryRun) {
-        return planned;
-    }
-    try {
-        await runner(command[0], command.slice(1));
-        const verified = await runner("pm", ["--version"]);
-        return {
-            ...planned,
-            status: "updated",
-            after_version: verified.stdout.trim() || undefined,
-        };
-    }
-    catch (error) {
-        return {
-            ...planned,
-            status: "failed",
-            error: error instanceof Error ? error.message : String(error),
-        };
-    }
-}
-function isLocalNpmSpec(spec) {
-    return (path.isAbsolute(spec) ||
-        spec.startsWith(".") ||
-        spec.startsWith("..") ||
-        spec.startsWith("file:"));
-}
-function resolvePackageInstallSource(source, tag) {
-    if (source.kind === "npm") {
-        const rawSpec = source.input.startsWith("npm:")
-            ? source.input.slice("npm:".length).trim()
-            : source.input.trim();
-        if (!isLocalNpmSpec(rawSpec) &&
-            source.package &&
-            source.package.trim().length > 0) {
-            return `npm:${source.package.trim()}@${tag}`;
-        }
-        return source.input.startsWith("npm:")
-            ? source.input
-            : `npm:${source.input}`;
-    }
-    return source.input;
-}
-async function resolveRunnablePackageSource(source, tag) {
-    const installSource = resolvePackageInstallSource(source, tag);
-    if (source.kind !== "local") {
-        return installSource;
-    }
-    if (await pathExists(installSource)) {
-        return installSource;
-    }
-    if (await pathExists(source.location)) {
-        return source.location;
-    }
-    return installSource;
-}
-function packageCommandFor(source, installSource, scope, ref) {
-    const command = [
-        "pm",
-        "package",
-        "install",
-        installSource,
-        scope === "global" ? "--global" : "--project",
-    ];
-    if (source.kind === "github" && ref && ref.trim().length > 0) {
-        command.push("--ref", ref.trim());
-    }
-    return command;
-}
-async function readManagedRecords(scope, global) {
-    const roots = resolveRoots(scope, global);
-    const managedState = await readManagedExtensionState(roots.selected_root);
-    return managedState.state.entries.filter((entry) => entry.scope === scope);
-}
-async function refreshManagedRecord(scope, global, record) {
-    const records = await readManagedRecords(scope, global);
-    return (records.find((candidate) => packageRecordMatchesTarget(candidate, record.name)) ??
-        records.find((candidate) => normalizeTarget(candidate.directory) ===
-            normalizeTarget(record.directory)));
-}
-async function upgradePackageRecord(record, options, global, scope, dryRun) {
-    const tag = resolveTag(options);
-    const installSource = await resolveRunnablePackageSource(record.source, tag);
-    const command = packageCommandFor(record.source, installSource, scope, record.source.ref);
-    const planned = {
-        name: record.name,
-        directory: record.directory,
-        scope,
-        source: record.source,
-        status: "planned",
-        command,
-        previous_version: record.manifest_version,
-    };
-    if (dryRun) {
-        return planned;
-    }
-    try {
-        await runExtension(installSource, {
-            install: true,
-            project: scope === "project",
-            global: scope === "global",
-            ref: record.source.kind === "github" ? record.source.ref : undefined,
-        }, global);
-        const refreshed = await refreshManagedRecord(scope, global, record);
-        return {
-            ...planned,
-            status: "updated",
-            installed_version: refreshed?.manifest_version,
-        };
-    }
-    catch (error) {
-        return {
-            ...planned,
-            status: "failed",
-            error: error instanceof Error ? error.message : String(error),
-        };
-    }
-}
-function summarize(cli, packages, includeCli, includePackages) {
-    const statuses = [
-        includeCli ? cli.status : undefined,
-        ...packages.map((entry) => entry.status),
-    ].filter((value) => typeof value === "string");
-    return {
-        requested_cli: includeCli,
-        requested_packages: includePackages,
-        planned: statuses.filter((status) => status === "planned").length,
-        updated: statuses.filter((status) => status === "updated").length,
-        skipped: statuses.filter((status) => status === "skipped").length,
-        failed: statuses.filter((status) => status === "failed").length,
-    };
-}
-/** Implements run upgrade for the public runtime surface of this module. */
-export async function runUpgrade(target, options, global) {
-    const normalizedTarget = typeof target === "string" && target.trim().length > 0
-        ? target.trim()
-        : undefined;
-    if (options.cliOnly === true && options.packagesOnly === true) {
-        const suggestedRetryArguments = [
-            "package",
-            "upgrade",
-            ...(normalizedTarget ? [normalizedTarget] : []),
-            "--packages-only",
-            "--dry-run",
-            ...PACKAGE_UPGRADE_RETRY_SCOPE_FLAGS[resolveScope(options)],
-        ];
-        throw new PmCliError('Options "--cli-only" and "--packages-only" are mutually exclusive.', EXIT_CODE.USAGE, {
-            code: "package_upgrade_modes_mutually_exclusive",
-            recovery: {
-                suggested_retry: renderPmCommand(suggestedRetryArguments),
-                suggested_retry_args: suggestedRetryArguments,
-            },
-        });
-    }
-    const scope = resolveScope(options);
-    const dryRun = options.dryRun === true;
-    if (options.cliOnly === true && normalizedTarget) {
-        throw new PmCliError('A package target cannot be used with "--cli-only".', EXIT_CODE.USAGE);
-    }
-    const includeCli = options.packagesOnly === true || normalizedTarget ? false : true;
-    const includePackages = options.cliOnly === true ? false : true;
-    const cli = includeCli
-        ? await upgradeCli(options, dryRun)
-        : {
-            requested: false,
-            status: "skipped",
-            package: resolveCliPackage(options),
-            target: `${resolveCliPackage(options)}@${resolveTag(options)}`,
-            command: [
-                "npm",
-                "install",
-                "-g",
-                `${resolveCliPackage(options)}@${resolveTag(options)}`,
-            ],
-            repair: options.repair === true,
-            reason: "not_requested",
-        };
-    let packageRecords = includePackages
-        ? await readManagedRecords(scope, global)
-        : [];
-    if (normalizedTarget) {
-        packageRecords = packageRecords.filter((entry) => packageRecordMatchesTarget(entry, normalizedTarget));
-        if (packageRecords.length === 0) {
-            throw new PmCliError(`Managed package "${normalizedTarget}" was not found in ${scope} scope.`, EXIT_CODE.NOT_FOUND);
-        }
-    }
-    const packages = [];
-    for (const record of packageRecords) {
-        packages.push(await upgradePackageRecord(record, options, global, scope, dryRun));
-    }
-    const summary = summarize(cli, packages, includeCli, includePackages);
-    return {
-        ok: summary.failed === 0,
-        action: "upgrade",
-        dry_run: dryRun,
-        scope,
-        target: normalizedTarget,
-        cli,
-        packages,
-        summary,
-    };
-}
+!(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]="b2b646c0-92fb-5bf6-998f-37d83428335d")}catch(e2){}})();import{execFile}from"node:child_process";import path from"node:path";import{promisify}from"node:util";import{renderPmCommand}from"../command-line.js";import{readManagedExtensionState,runExtension}from"../extension.js";import{resolveExtensionRoots,pathExists,EXIT_CODE,PmCliError,resolvePmRoot,resolvePmCliVersion}from"../runtime-primitives.js";const execFileAsync=promisify(execFile);const DEFAULT_CLI_PACKAGE="@unbrained/pm-cli";const DEFAULT_TAG="latest";const PACKAGE_UPGRADE_RETRY_SCOPE_FLAGS={global:["--global"],project:[]};const _testOnly={defaultCommandRunner,isLocalNpmSpec,normalizeTarget,packageRecordMatchesTarget,resolveCliPackage,resolvePackageInstallSource,resolveRunnablePackageSource,resolveScope,resolveTag,packageCommandFor,summarize};function resolveScope(options){const projectLike=options.project===true||options.local===true||options.scope==="project";const global2=options.global===true||options.scope==="global";if(projectLike&&global2){throw new PmCliError('Options "--project/--local" and "--global" are mutually exclusive.',EXIT_CODE.USAGE)}return global2?"global":"project"}function normalizeTarget(value){return value.trim().toLowerCase()}function packageRecordMatchesTarget(record,target){const normalizedTarget=normalizeTarget(target);const values=[record.name,record.directory,record.source.input,record.source.location,record.source.package,record.source.repository,record.source.owner&&record.source.repo?`${record.source.owner}/${record.source.repo}`:void 0];return values.some(value=>typeof value==="string"&&normalizeTarget(value)===normalizedTarget)}function resolveRoots(scope,global2){const pmRoot=resolvePmRoot(process.cwd(),global2.path);const roots=resolveExtensionRoots(pmRoot,process.cwd());return{selected_root:scope==="global"?roots.global:roots.project}}async function defaultCommandRunner(command,args,options){try{const result=await execFileAsync(command,args,{cwd:options?.cwd,encoding:"utf8"});return{stdout:result.stdout,stderr:result.stderr}}catch(error){const stderr=typeof error==="object"&&error!==null&&"stderr"in error?String(error.stderr??""):"";const message=stderr.trim().length>0?stderr.trim():error instanceof Error?error.message:String(error);throw new PmCliError(`Command failed: ${command} ${args.join(" ")}
+${message}`,EXIT_CODE.GENERIC_FAILURE)}}async function readCurrentVersion(){return resolvePmCliVersion(import.meta.url,["../../.."])}function resolveTag(options){return typeof options.tag==="string"&&options.tag.trim().length>0?options.tag.trim():DEFAULT_TAG}function resolveCliPackage(options){return typeof options.packageName==="string"&&options.packageName.trim().length>0?options.packageName.trim():DEFAULT_CLI_PACKAGE}async function upgradeCli(options,dryRun){const runner=options.commandRunner??defaultCommandRunner;const packageName=resolveCliPackage(options);const tag=resolveTag(options);const target=`${packageName}@${tag}`;const command=["npm","install","-g",target];if(options.repair===true){command.push("--force")}const beforeVersion=await readCurrentVersion();const planned={requested:true,status:"planned",package:packageName,target,command,before_version:beforeVersion,repair:options.repair===true};if(dryRun){return planned}try{await runner(command[0],command.slice(1));const verified=await runner("pm",["--version"]);return{...planned,status:"updated",after_version:verified.stdout.trim()||void 0}}catch(error){return{...planned,status:"failed",error:error instanceof Error?error.message:String(error)}}}function isLocalNpmSpec(spec){return path.isAbsolute(spec)||spec.startsWith(".")||spec.startsWith("..")||spec.startsWith("file:")}function resolvePackageInstallSource(source,tag){if(source.kind==="npm"){const rawSpec=source.input.startsWith("npm:")?source.input.slice("npm:".length).trim():source.input.trim();if(!isLocalNpmSpec(rawSpec)&&source.package&&source.package.trim().length>0){return`npm:${source.package.trim()}@${tag}`}return source.input.startsWith("npm:")?source.input:`npm:${source.input}`}return source.input}async function resolveRunnablePackageSource(source,tag){const installSource=resolvePackageInstallSource(source,tag);if(source.kind!=="local"){return installSource}if(await pathExists(installSource)){return installSource}if(await pathExists(source.location)){return source.location}return installSource}function packageCommandFor(source,installSource,scope,ref){const command=["pm","package","install",installSource,scope==="global"?"--global":"--project"];if(source.kind==="github"&&ref&&ref.trim().length>0){command.push("--ref",ref.trim())}return command}async function readManagedRecords(scope,global2){const roots=resolveRoots(scope,global2);const managedState=await readManagedExtensionState(roots.selected_root);return managedState.state.entries.filter(entry=>entry.scope===scope)}async function refreshManagedRecord(scope,global2,record){const records=await readManagedRecords(scope,global2);return records.find(candidate=>packageRecordMatchesTarget(candidate,record.name))??records.find(candidate=>normalizeTarget(candidate.directory)===normalizeTarget(record.directory))}async function upgradePackageRecord(record,options,global2,scope,dryRun){const tag=resolveTag(options);const installSource=await resolveRunnablePackageSource(record.source,tag);const command=packageCommandFor(record.source,installSource,scope,record.source.ref);const planned={name:record.name,directory:record.directory,scope,source:record.source,status:"planned",command,previous_version:record.manifest_version};if(dryRun){return planned}try{await runExtension(installSource,{install:true,project:scope==="project",global:scope==="global",ref:record.source.kind==="github"?record.source.ref:void 0},global2);const refreshed=await refreshManagedRecord(scope,global2,record);return{...planned,status:"updated",installed_version:refreshed?.manifest_version}}catch(error){return{...planned,status:"failed",error:error instanceof Error?error.message:String(error)}}}function summarize(cli,packages,includeCli,includePackages){const statuses=[includeCli?cli.status:void 0,...packages.map(entry=>entry.status)].filter(value=>typeof value==="string");return{requested_cli:includeCli,requested_packages:includePackages,planned:statuses.filter(status=>status==="planned").length,updated:statuses.filter(status=>status==="updated").length,skipped:statuses.filter(status=>status==="skipped").length,failed:statuses.filter(status=>status==="failed").length}}async function runUpgrade(target,options,global2){const normalizedTarget=typeof target==="string"&&target.trim().length>0?target.trim():void 0;if(options.cliOnly===true&&options.packagesOnly===true){const suggestedRetryArguments=["package","upgrade",...normalizedTarget?[normalizedTarget]:[],"--packages-only","--dry-run",...PACKAGE_UPGRADE_RETRY_SCOPE_FLAGS[resolveScope(options)]];throw new PmCliError('Options "--cli-only" and "--packages-only" are mutually exclusive.',EXIT_CODE.USAGE,{code:"package_upgrade_modes_mutually_exclusive",recovery:{suggested_retry:renderPmCommand(suggestedRetryArguments),suggested_retry_args:suggestedRetryArguments}})}const scope=resolveScope(options);const dryRun=options.dryRun===true;if(options.cliOnly===true&&normalizedTarget){throw new PmCliError('A package target cannot be used with "--cli-only".',EXIT_CODE.USAGE)}const includeCli=options.packagesOnly===true||normalizedTarget?false:true;const includePackages=options.cliOnly===true?false:true;const cli=includeCli?await upgradeCli(options,dryRun):{requested:false,status:"skipped",package:resolveCliPackage(options),target:`${resolveCliPackage(options)}@${resolveTag(options)}`,command:["npm","install","-g",`${resolveCliPackage(options)}@${resolveTag(options)}`],repair:options.repair===true,reason:"not_requested"};let packageRecords=includePackages?await readManagedRecords(scope,global2):[];if(normalizedTarget){packageRecords=packageRecords.filter(entry=>packageRecordMatchesTarget(entry,normalizedTarget));if(packageRecords.length===0){throw new PmCliError(`Managed package "${normalizedTarget}" was not found in ${scope} scope.`,EXIT_CODE.NOT_FOUND)}}const packages=[];for(const record of packageRecords){packages.push(await upgradePackageRecord(record,options,global2,scope,dryRun))}const summary=summarize(cli,packages,includeCli,includePackages);return{ok:summary.failed===0,action:"upgrade",dry_run:dryRun,scope,target:normalizedTarget,cli,packages,summary}}export{_testOnly,runUpgrade};
 //# sourceMappingURL=upgrade.js.map
-//# debugId=46439d77-bb74-5f36-9383-ac3362f41b3e

package/dist/sdk/governance/validate-history-drift.js

@@ -1,82 +1,2 @@
-/**
- * @module sdk/governance/validate-history-drift
- *
- * Projects append-only item and workspace singleton drift into the validation
- * check contract without adding history-specific weight to the main validate
- * orchestration module.
- */
-
-!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]="a2c96f3a-fa7a-538f-ae11-7b821e5b7ab2")}catch(e){}}();
-import { scanHistoryDrift } from "../../core/history/drift-scan.js";
-const DEFAULT_DIAGNOSTIC_LIMIT = 5;
-/** Build the validation warning and bounded evidence projection for history drift. */
-export async function buildValidateHistoryDriftCheck(pmRoot, items, verboseDiagnostics) {
-    const drift = await scanHistoryDrift(pmRoot, items);
-    const warningCounts = [
-        ["validate_history_drift_missing_streams", drift.missingStreams.length],
-        [
-            "validate_history_drift_unreadable_streams",
-            drift.unreadableStreams.length,
-        ],
-        ["validate_history_drift_hash_mismatches", drift.hashMismatches.length],
-        ["validate_history_drift_chain_mismatches", drift.chainMismatches.length],
-        ["validate_history_drift_version_skews", drift.versionSkews.length],
-        [
-            "validate_history_drift_workspace_state_mismatches",
-            drift.workspaceStateMismatches.length,
-        ],
-        [
-            "validate_history_drift_workspace_state_missing",
-            drift.workspaceStateMissing.length,
-        ],
-        [
-            "validate_history_drift_workspace_state_unreadable",
-            drift.workspaceStateUnreadable.length,
-        ],
-    ];
-    const warnings = warningCounts
-        .filter(([, count]) => count > 0)
-        .map(([code, count]) => `${code}:${count}`);
-    const diagnosticLimit = verboseDiagnostics
-        ? Number.POSITIVE_INFINITY
-        : DEFAULT_DIAGNOSTIC_LIMIT;
-    const driftedItems = drift.driftedItems.slice(0, diagnosticLimit);
-    const identityDiscontinuities = drift.identityDiscontinuities ?? [];
-    return {
-        check: {
-            name: "history_drift",
-            status: identityDiscontinuities.length > 0
-                ? "error"
-                : warnings.length === 0
-                    ? "ok"
-                    : "warn",
-            ok: identityDiscontinuities.length === 0 && warnings.length === 0,
-            details: {
-                identity_discontinuities: identityDiscontinuities.slice(0, diagnosticLimit),
-                identity_discontinuities_count: identityDiscontinuities.length,
-                identity_discontinuities_truncated: identityDiscontinuities.length > diagnosticLimit,
-                checked_items: items.length,
-                drifted_items_count: drift.driftedItems.length,
-                drifted_items: driftedItems,
-                drifted_items_truncated: driftedItems.length < drift.driftedItems.length,
-                counts: {
-                    missing_streams: drift.missingStreams.length,
-                    unreadable_streams: drift.unreadableStreams.length,
-                    hash_mismatches: drift.hashMismatches.length,
-                    chain_mismatches: drift.chainMismatches.length,
-                    version_skews: drift.versionSkews.length,
-                    workspace_state_mismatches: drift.workspaceStateMismatches.length,
-                    workspace_state_missing: drift.workspaceStateMissing.length,
-                    workspace_state_unreadable: drift.workspaceStateUnreadable.length,
-                },
-                workspace_state_mismatches: drift.workspaceStateMismatches,
-                workspace_state_missing: drift.workspaceStateMissing,
-                workspace_state_unreadable: drift.workspaceStateUnreadable,
-                version_skews: drift.versionSkews.slice(0, diagnosticLimit),
-            },
-        },
-        warnings,
-    };
-}
+!(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]="42402d5d-8074-591f-98b4-75f479509cb4")}catch(e2){}})();import{scanHistoryDrift}from"../../core/history/drift-scan.js";const DEFAULT_DIAGNOSTIC_LIMIT=5;async function buildValidateHistoryDriftCheck(pmRoot,items,verboseDiagnostics){const drift=await scanHistoryDrift(pmRoot,items);const warningCounts=[["validate_history_drift_missing_streams",drift.missingStreams.length],["validate_history_drift_unreadable_streams",drift.unreadableStreams.length],["validate_history_drift_hash_mismatches",drift.hashMismatches.length],["validate_history_drift_chain_mismatches",drift.chainMismatches.length],["validate_history_drift_version_skews",drift.versionSkews.length],["validate_history_drift_workspace_state_mismatches",drift.workspaceStateMismatches.length],["validate_history_drift_workspace_state_missing",drift.workspaceStateMissing.length],["validate_history_drift_workspace_state_unreadable",drift.workspaceStateUnreadable.length]];const warnings=warningCounts.filter(([,count])=>count>0).map(([code,count])=>`${code}:${count}`);const diagnosticLimit=verboseDiagnostics?Number.POSITIVE_INFINITY:DEFAULT_DIAGNOSTIC_LIMIT;const driftedItems=drift.driftedItems.slice(0,diagnosticLimit);const identityDiscontinuities=drift.identityDiscontinuities??[];return{check:{name:"history_drift",status:identityDiscontinuities.length>0?"error":warnings.length===0?"ok":"warn",ok:identityDiscontinuities.length===0&&warnings.length===0,details:{identity_discontinuities:identityDiscontinuities.slice(0,diagnosticLimit),identity_discontinuities_count:identityDiscontinuities.length,identity_discontinuities_truncated:identityDiscontinuities.length>diagnosticLimit,checked_items:items.length,drifted_items_count:drift.driftedItems.length,drifted_items:driftedItems,drifted_items_truncated:driftedItems.length<drift.driftedItems.length,counts:{missing_streams:drift.missingStreams.length,unreadable_streams:drift.unreadableStreams.length,hash_mismatches:drift.hashMismatches.length,chain_mismatches:drift.chainMismatches.length,version_skews:drift.versionSkews.length,workspace_state_mismatches:drift.workspaceStateMismatches.length,workspace_state_missing:drift.workspaceStateMissing.length,workspace_state_unreadable:drift.workspaceStateUnreadable.length},workspace_state_mismatches:drift.workspaceStateMismatches,workspace_state_missing:drift.workspaceStateMissing,workspace_state_unreadable:drift.workspaceStateUnreadable,version_skews:drift.versionSkews.slice(0,diagnosticLimit)}},warnings}}export{buildValidateHistoryDriftCheck};
 //# sourceMappingURL=validate-history-drift.js.map
-//# debugId=a2c96f3a-fa7a-538f-ae11-7b821e5b7ab2

package/dist/sdk/governance/validate-item-reader.js

@@ -1,18 +1,2 @@
-/**
- * @module sdk/governance/validate-item-reader
- *
- * Selects the least expensive authoritative item projection required by a
- * validation run.
- */
-
-!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]="01f042d0-7f02-59f5-8894-cf48eb936d99")}catch(e){}}();
-import { listAllItemMetadata, listAllItemMetadataWithBody, } from "../../core/store/item-store.js";
-/** Load collections for normal checks and add bodies only when history hashes must be verified. */
-export async function readValidateItems(params) {
-    if (params.includeBody) {
-        return listAllItemMetadataWithBody(params.pmRoot, params.settings.item_format, params.typeToFolder, params.warnings, params.settings.schema, { forceSourceScan: true });
-    }
-    return listAllItemMetadata(params.pmRoot, params.settings.item_format, params.typeToFolder, params.warnings, params.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]="3ae38c0a-7f43-5457-b9a5-d23491a371ea")}catch(e2){}})();import{listAllItemMetadata,listAllItemMetadataWithBody}from"../../core/store/item-store.js";async function readValidateItems(params){if(params.includeBody){return listAllItemMetadataWithBody(params.pmRoot,params.settings.item_format,params.typeToFolder,params.warnings,params.settings.schema,{forceSourceScan:true})}return listAllItemMetadata(params.pmRoot,params.settings.item_format,params.typeToFolder,params.warnings,params.settings.schema)}export{readValidateItems};
 //# sourceMappingURL=validate-item-reader.js.map
-//# debugId=01f042d0-7f02-59f5-8894-cf48eb936d99

package/dist/sdk/governance/validate-normalization.js

@@ -1,37 +1,2 @@
-/**
- * @module sdk/governance/validate-normalization
- *
- * Provides shared path and meaningful-value normalization for validation
- * diagnostics without coupling the helpers to the command orchestration.
- */
-
-!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]="de2cc648-965a-59c9-b688-0fe12edeec82")}catch(e){}}();
-import { toNonEmptyStringOrUndefined } from "../../core/shared/primitives.js";
-/** Normalize a repository-relative path to stable forward-slash form. */
-export function normalizeRelativePath(value) {
-    return value
-        .replaceAll("\\", "/")
-        .replace(/^\.\/+/, "")
-        .replace(/^\/+/, "");
-}
-/** Normalize a repository-relative directory without trailing separators. */
-export function normalizeRelativeDirectoryPath(value) {
-    return normalizeRelativePath(value).replace(/\/+$/, "");
-}
-/** Treat blank and legacy null-like metadata tokens as absent values. */
-export function toMeaningfulString(value) {
-    const normalized = toNonEmptyStringOrUndefined(value);
-    if (!normalized) {
-        return undefined;
-    }
-    const lowered = normalized.toLowerCase();
-    if (lowered === "none" ||
-        lowered === "null" ||
-        lowered === "n/a" ||
-        lowered === "na") {
-        return undefined;
-    }
-    return normalized;
-}
+!(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]="1d8059aa-0711-522b-a12e-f5469286542f")}catch(e2){}})();import{toNonEmptyStringOrUndefined}from"../../core/shared/primitives.js";function normalizeRelativePath(value){return value.replaceAll("\\","/").replace(/^\.\/+/,"").replace(/^\/+/,"")}function normalizeRelativeDirectoryPath(value){return normalizeRelativePath(value).replace(/\/+$/,"")}function toMeaningfulString(value){const normalized=toNonEmptyStringOrUndefined(value);if(!normalized){return void 0}const lowered=normalized.toLowerCase();if(lowered==="none"||lowered==="null"||lowered==="n/a"||lowered==="na"){return void 0}return normalized}export{normalizeRelativeDirectoryPath,normalizeRelativePath,toMeaningfulString};
 //# sourceMappingURL=validate-normalization.js.map
-//# debugId=de2cc648-965a-59c9-b688-0fe12edeec82

package/dist/sdk/governance/validate.d.ts

@@ -9,7 +9,7 @@ import { type RelationshipKindRegistry } from "../relationships.js";
 import { type ValidateItem } from "./validate-item-reader.js";
 import { buildLifecycleParentGraph, detectLifecycleParentCycles, resolveLifecycleDependencyCycleSamplePath } from "./hierarchy-validation.js";
 import { toMeaningfulString } from "./validate-normalization.js";
-type ValidateCheckName = "metadata" | "resolution" | "lifecycle" | "dependency_references" | "files" | "command_references" | "history_drift" | "format_version" | "storage_integrity";
+type ValidateCheckName = "completeness" | "metadata" | "resolution" | "lifecycle" | "dependency_references" | "files" | "command_references" | "history_drift" | "format_version" | "storage_integrity";
 type ValidateStatus = "ok" | "warn" | "error";
 type ValidateDependencyCycleSeverity = "off" | "warn" | "error";
 type ValidateFileScanMode = "default" | "tracked-all" | "tracked-all-strict";
@@ -18,6 +18,8 @@ type OrphanedPathClassification = "docs_unowned" | "tests_unowned" | "source_uno
 type LifecyclePatternFieldKey = "blocked_reason" | "resolution" | "actual_result";
 /** Documents the validate command options payload exchanged by command, SDK, and package integrations. */
 export interface ValidateCommandOptions {
+    /** Evaluate workspace field requirements for each item's current lifecycle status. */
+    checkCompleteness?: boolean;
     /** Value that configures or reports check metadata for this contract. */
     checkMetadata?: boolean;
     /** Value that configures or reports check resolution for this contract. */