@unbrained/pm-cli 2026.7.5 → 2026.7.6

package/dist/cli-bundle/chunks/register-operations-A3XAM5J7.js

@@ -1,513 +0,0 @@
-
-!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]="83cf690f-7473-5e78-9177-87c2b9db9f13")}catch(e){}}();
-import {
-  buildBackgroundTestAllCommandArgs,
-  buildBackgroundTestCommandArgs,
-  collect,
-  getGlobalOptions,
-  invalidateSearchCachesForMutation,
-  readOptionString
-} from "./chunk-75U6M5ZD.js";
-import "./chunk-7QH7DHUB.js";
-import {
-  printError,
-  printResult
-} from "./chunk-4OFLJHX6.js";
-import "./chunk-PPE4YUQM.js";
-import "./chunk-57C2RLW5.js";
-import "./chunk-HK72NWAD.js";
-import "./chunk-FJRKQREY.js";
-import {
-  PmCliError,
-  readSettings,
-  setActiveCommandResult
-} from "./chunk-US3T3W5J.js";
-import "./chunk-NNHHXJB2.js";
-import {
-  EXIT_CODE,
-  normalizeStatusInputWithRegistry,
-  resolvePmRoot,
-  resolveRuntimeStatusRegistry
-} from "./chunk-YD5FML7K.js";
-
-// dist/cli/register-operations.js
-function resolveStartTaskInProgressStatus(statusRegistry) {
-  return normalizeStatusInputWithRegistry("in_progress", statusRegistry) ?? statusRegistry.open_status;
-}
-function resolveTelemetrySubcommand(namespaceOrSubcommand, subcommand) {
-  const normalizedNamespace = namespaceOrSubcommand?.trim().toLowerCase();
-  const normalizedSubcommand = subcommand?.trim().toLowerCase();
-  if (normalizedNamespace === void 0 || normalizedNamespace.length === 0) {
-    return normalizedSubcommand;
-  }
-  if (normalizedNamespace === "local-analytics") {
-    return normalizedSubcommand && normalizedSubcommand.length > 0 ? normalizedSubcommand : "status";
-  }
-  if (normalizedSubcommand !== void 0 && normalizedSubcommand.length > 0) {
-    throw new PmCliError(`Unknown pm telemetry path "${namespaceOrSubcommand} ${subcommand}". Use "pm telemetry ${namespaceOrSubcommand}" or legacy alias "pm telemetry local-analytics ${normalizedSubcommand}".`, EXIT_CODE.USAGE, {
-      code: "unknown_subcommand",
-      examples: [
-        "pm telemetry status",
-        "pm telemetry flush",
-        "pm telemetry stats --limit 10",
-        "pm telemetry clear",
-        "pm telemetry local-analytics status --json"
-      ]
-    });
-  }
-  return normalizedNamespace;
-}
-function collectTestMutationValues(options) {
-  return {
-    addValues: Array.isArray(options.add) ? options.add : [],
-    addJsonValues: Array.isArray(options.addJson) ? options.addJson : [],
-    removeValues: Array.isArray(options.remove) ? options.remove : []
-  };
-}
-function validateBackgroundTestOptions(options, values) {
-  if (options.background !== true) {
-    return;
-  }
-  if (options.run !== true) {
-    throw new PmCliError("--background requires --run", EXIT_CODE.USAGE);
-  }
-  if (values.addValues.length > 0 || values.addJsonValues.length > 0 || values.removeValues.length > 0) {
-    throw new PmCliError("--background does not support --add/--add-json/--remove; update linked tests first, then run in background", EXIT_CODE.USAGE);
-  }
-}
-async function runBackgroundLinkedTests(id, options, globalOptions, values) {
-  const { runStartBackgroundRun } = await import("./test-runs-245OINZR.js");
-  const result = await runStartBackgroundRun({
-    kind: "test",
-    commandArgs: buildBackgroundTestCommandArgs(id, { ...options, add: values.addValues, addJson: values.addJsonValues, remove: values.removeValues }),
-    targetId: id,
-    author: typeof options.author === "string" ? options.author : void 0,
-    noExtensions: globalOptions.noExtensions === true
-  }, globalOptions);
-  printResult(result, globalOptions);
-}
-function buildRunTestOptions(options, values) {
-  return {
-    add: values.addValues,
-    addJson: values.addJsonValues,
-    remove: values.removeValues,
-    list: Boolean(options.list),
-    run: Boolean(options.run),
-    match: typeof options.match === "string" ? options.match : void 0,
-    onlyIndex: typeof options.onlyIndex === "string" || typeof options.onlyIndex === "number" ? options.onlyIndex : void 0,
-    onlyLast: Boolean(options.onlyLast),
-    timeout: typeof options.timeout === "string" ? options.timeout : void 0,
-    progress: Boolean(options.progress),
-    envSet: Array.isArray(options.envSet) ? options.envSet : [],
-    envClear: Array.isArray(options.envClear) ? options.envClear : [],
-    sharedHostSafe: Boolean(options.sharedHostSafe),
-    pmContext: typeof options.pmContext === "string" ? options.pmContext : void 0,
-    overrideLinkedPmContext: Boolean(options.overrideLinkedPmContext),
-    failOnContextMismatch: Boolean(options.failOnContextMismatch),
-    failOnSkipped: Boolean(options.failOnSkipped),
-    failOnEmptyTestRun: Boolean(options.failOnEmptyTestRun),
-    requireAssertionsForPm: Boolean(options.requireAssertionsForPm),
-    checkContext: Boolean(options.checkContext),
-    autoPmContext: Boolean(options.autoPmContext),
-    author: typeof options.author === "string" ? options.author : void 0,
-    message: typeof options.message === "string" ? options.message : void 0,
-    force: Boolean(options.force)
-  };
-}
-async function runForegroundLinkedTests(id, options, globalOptions, values) {
-  const { runTest } = await import("./test-DQ2QFJ7W.js");
-  const result = await runTest(id, buildRunTestOptions(options, values), globalOptions);
-  if (values.addValues.length > 0 || values.addJsonValues.length > 0 || values.removeValues.length > 0 || options.run === true) {
-    await invalidateSearchCachesForMutation(globalOptions, result);
-  }
-  printResult(result, globalOptions);
-  if (result.run_results.some((entry) => entry.status === "failed") || result.fail_on_skipped_triggered === true) {
-    process.exitCode = EXIT_CODE.DEPENDENCY_FAILED;
-  }
-}
-async function runTestCommandAction(id, options, command) {
-  const globalOptions = getGlobalOptions(command);
-  const startedAt = Date.now();
-  const values = collectTestMutationValues(options);
-  validateBackgroundTestOptions(options, values);
-  if (options.background === true) {
-    await runBackgroundLinkedTests(id, options, globalOptions, values);
-  } else {
-    await runForegroundLinkedTests(id, options, globalOptions, values);
-  }
-  if (globalOptions.profile) {
-    printError(`profile:command=test took_ms=${Date.now() - startedAt}`);
-  }
-}
-function buildLifecycleMutationOptions(options) {
-  return {
-    author: readOptionString(options, "author"),
-    message: readOptionString(options, "message")
-  };
-}
-async function runTestAllAction(options, command) {
-  const globalOptions = getGlobalOptions(command);
-  const startedAt = Date.now();
-  const runInBackground = options.background === true;
-  if (runInBackground) {
-    const { runStartBackgroundRun } = await import("./test-runs-245OINZR.js");
-    const result2 = await runStartBackgroundRun({
-      kind: "test-all",
-      commandArgs: buildBackgroundTestAllCommandArgs(options),
-      statusFilter: readOptionString(options, "status"),
-      noExtensions: globalOptions.noExtensions === true
-    }, globalOptions);
-    printResult(result2, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=test-all took_ms=${Date.now() - startedAt}`);
-    }
-    return;
-  }
-  const { runTestAll } = await import("./test-all-636NTRTT.js");
-  const result = await runTestAll({
-    status: readOptionString(options, "status"),
-    limit: readOptionString(options, "limit"),
-    offset: readOptionString(options, "offset"),
-    timeout: readOptionString(options, "timeout"),
-    progress: Boolean(options.progress),
-    envSet: Array.isArray(options.envSet) ? options.envSet : [],
-    envClear: Array.isArray(options.envClear) ? options.envClear : [],
-    sharedHostSafe: Boolean(options.sharedHostSafe),
-    pmContext: readOptionString(options, "pmContext"),
-    overrideLinkedPmContext: Boolean(options.overrideLinkedPmContext),
-    failOnContextMismatch: Boolean(options.failOnContextMismatch),
-    failOnSkipped: Boolean(options.failOnSkipped),
-    failOnEmptyTestRun: Boolean(options.failOnEmptyTestRun),
-    requireAssertionsForPm: Boolean(options.requireAssertionsForPm),
-    checkContext: Boolean(options.checkContext),
-    autoPmContext: Boolean(options.autoPmContext)
-  }, globalOptions);
-  await invalidateSearchCachesForMutation(globalOptions, { ids: result.results.map((entry) => entry.id) });
-  printResult(result, globalOptions);
-  if (result.failed > 0 || result.fail_on_skipped_triggered === true) {
-    process.exitCode = EXIT_CODE.DEPENDENCY_FAILED;
-  }
-  if (globalOptions.profile) {
-    printError(`profile:command=test-all took_ms=${Date.now() - startedAt}`);
-  }
-}
-async function runTelemetryAction(namespaceOrSubcommand, subcommand, options, command) {
-  const globalOptions = getGlobalOptions(command);
-  const startedAt = Date.now();
-  const { runTelemetry } = await import("./telemetry-QBYWQA76.js");
-  const result = await runTelemetry({
-    subcommand: resolveTelemetrySubcommand(namespaceOrSubcommand, subcommand),
-    // Commander always parses `--limit <n>` to a string (or leaves it
-    // undefined), so a string passthrough covers every CLI-reachable input.
-    limit: readOptionString(options, "limit")
-  }, globalOptions);
-  printResult(result, globalOptions);
-  if (globalOptions.profile) {
-    printError(`profile:command=telemetry took_ms=${Date.now() - startedAt}`);
-  }
-}
-async function runStatsAction(options, command) {
-  const globalOptions = getGlobalOptions(command);
-  const startedAt = Date.now();
-  const { runStats } = await import("./stats-L2D5Y2O5.js");
-  const result = await runStats(globalOptions, {
-    storage: options.storage === true,
-    metadataCoverage: options.metadataCoverage === true,
-    byAssignee: options.byAssignee === true,
-    byTag: options.byTag === true,
-    byPriority: options.byPriority === true,
-    tagPrefix: readOptionString(options, "tagPrefix"),
-    fieldUtilization: options.fieldUtilization === true
-  });
-  printResult(result, globalOptions);
-  if (globalOptions.profile) {
-    printError(`profile:command=stats took_ms=${Date.now() - startedAt}`);
-  }
-}
-async function runHealthAction(options, command) {
-  const globalOptions = getGlobalOptions(command);
-  const startedAt = Date.now();
-  const { runHealth } = await import("./health-3GVPMQBL.js");
-  const result = await runHealth(globalOptions, {
-    strictDirectories: Boolean(options.strictDirectories),
-    checkOnly: Boolean(options.checkOnly),
-    checkTelemetry: Boolean(options.checkTelemetry),
-    noRefresh: Boolean(options.noRefresh),
-    refreshVectors: Boolean(options.refreshVectors),
-    verboseStaleItems: Boolean(options.verboseStaleItems),
-    brief: Boolean(options.brief),
-    summary: Boolean(options.summary),
-    skipVectors: Boolean(options.skipVectors),
-    skipIntegrity: Boolean(options.skipIntegrity),
-    skipDrift: Boolean(options.skipDrift),
-    full: Boolean(options.full)
-  });
-  printResult(result, globalOptions);
-  const strictExit = Boolean(options.strictExit) || Boolean(options.failOnWarn);
-  if (strictExit && !result.ok) {
-    setActiveCommandResult({
-      ...result,
-      exit_code: EXIT_CODE.GENERIC_FAILURE,
-      error_code: "health_findings",
-      error_category: "validation",
-      command_resolution: "health_findings",
-      resolution_stage: "execute"
-    });
-    process.exitCode = EXIT_CODE.GENERIC_FAILURE;
-  }
-  if (globalOptions.profile) {
-    printError(`profile:command=health took_ms=${Date.now() - startedAt}`);
-  }
-}
-async function runValidateAction(options, command) {
-  const globalOptions = getGlobalOptions(command);
-  const startedAt = Date.now();
-  const { runValidate } = await import("./validate-Z7L75YEJ.js");
-  const result = await runValidate({
-    checkMetadata: Boolean(options.checkMetadata),
-    metadataProfile: readOptionString(options, "metadataProfile"),
-    checkResolution: Boolean(options.checkResolution),
-    checkLifecycle: Boolean(options.checkLifecycle),
-    checkStaleBlockers: Boolean(options.checkStaleBlockers),
-    dependencyCycleSeverity: readOptionString(options, "dependencyCycleSeverity"),
-    parentCycleSeverity: readOptionString(options, "parentCycleSeverity"),
-    checkFiles: Boolean(options.checkFiles),
-    checkCommandReferences: Boolean(options.checkCommandReferences),
-    scanMode: readOptionString(options, "scanMode"),
-    includePmInternals: Boolean(options.includePmInternals),
-    verboseFileLists: Boolean(options.verboseFileLists),
-    verboseDiagnostics: Boolean(options.verboseDiagnostics),
-    allAffectedIds: Boolean(options.allAffectedIds),
-    checkHistoryDrift: Boolean(options.checkHistoryDrift),
-    fixHints: Boolean(options.fixHints),
-    autoFix: Boolean(options.autoFix),
-    dryRun: Boolean(options.dryRun),
-    fixScope: Array.isArray(options.fixScope) ? options.fixScope : void 0,
-    pruneMissing: Boolean(options.pruneMissing)
-  }, globalOptions);
-  printResult(result, globalOptions);
-  const strictExit = Boolean(options.strictExit) || Boolean(options.failOnWarn);
-  if (strictExit && (result.has_warnings || !result.ok)) {
-    setActiveCommandResult({
-      ...result,
-      exit_code: EXIT_CODE.GENERIC_FAILURE,
-      error_code: "validation_findings",
-      error_category: "validation",
-      command_resolution: "validation_findings",
-      resolution_stage: "execute"
-    });
-    process.exitCode = EXIT_CODE.GENERIC_FAILURE;
-  }
-  if (globalOptions.profile) {
-    printError(`profile:command=validate took_ms=${Date.now() - startedAt}`);
-  }
-}
-async function runGcAction(options, command) {
-  const globalOptions = getGlobalOptions(command);
-  const startedAt = Date.now();
-  const { runGc } = await import("./gc-RLBP4QVN.js");
-  const result = await runGc(globalOptions, {
-    dryRun: options.dryRun === true,
-    scope: Array.isArray(options.scope) ? options.scope : []
-  });
-  printResult(result, globalOptions);
-  if (globalOptions.profile) {
-    printError(`profile:command=gc took_ms=${Date.now() - startedAt}`);
-  }
-}
-async function runContractsAction(options, command) {
-  const globalOptions = getGlobalOptions(command);
-  const startedAt = Date.now();
-  const { runContracts } = await import("./contracts-OJEXMKVW.js");
-  const result = await runContracts({
-    action: readOptionString(options, "action"),
-    command: readOptionString(options, "command"),
-    schemaOnly: Boolean(options.schemaOnly),
-    flagsOnly: Boolean(options.flagsOnly),
-    availabilityOnly: Boolean(options.availabilityOnly),
-    runtimeOnly: Boolean(options.runtimeOnly) || Boolean(options.activeOnly),
-    full: Boolean(options.full)
-  }, globalOptions);
-  printResult(result, globalOptions);
-  if (globalOptions.profile) {
-    printError(`profile:command=contracts took_ms=${Date.now() - startedAt}`);
-  }
-}
-async function runClaimAction(id, options, command) {
-  const globalOptions = getGlobalOptions(command);
-  const startedAt = Date.now();
-  const { runClaim } = await import("./claim-4DROPSIS.js");
-  const result = await runClaim(id, Boolean(options.force), globalOptions, {
-    ...buildLifecycleMutationOptions(options),
-    ifAvailable: options.ifAvailable === true
-  });
-  await invalidateSearchCachesForMutation(globalOptions, result);
-  printResult(result, globalOptions);
-  if (globalOptions.profile) {
-    printError(`profile:command=claim took_ms=${Date.now() - startedAt}`);
-  }
-}
-async function runReleaseAction(id, options, command) {
-  const globalOptions = getGlobalOptions(command);
-  const startedAt = Date.now();
-  const { runRelease } = await import("./claim-4DROPSIS.js");
-  const result = await runRelease(id, Boolean(options.force), globalOptions, {
-    ...buildLifecycleMutationOptions(options),
-    allowAuditRelease: options.allowAuditRelease === true
-  });
-  await invalidateSearchCachesForMutation(globalOptions, result);
-  printResult(result, globalOptions);
-  if (globalOptions.profile) {
-    printError(`profile:command=release took_ms=${Date.now() - startedAt}`);
-  }
-}
-async function runStartTaskAction(id, options, command) {
-  const globalOptions = getGlobalOptions(command);
-  const startedAt = Date.now();
-  const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);
-  const settings = await readSettings(pmRoot);
-  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
-  const inProgressStatus = resolveStartTaskInProgressStatus(statusRegistry);
-  const force = Boolean(options.force);
-  const mutationOptions = buildLifecycleMutationOptions(options);
-  const [{ runClaim }, { runUpdate }] = await Promise.all([
-    import("./claim-4DROPSIS.js"),
-    import("./update-SFLZPJXX.js")
-  ]);
-  const claimResult = await runClaim(id, force, globalOptions, mutationOptions);
-  await invalidateSearchCachesForMutation(globalOptions, claimResult);
-  const updateResult = await runUpdate(id, { ...mutationOptions, status: inProgressStatus, force }, globalOptions);
-  await invalidateSearchCachesForMutation(globalOptions, updateResult);
-  printResult({ id, action: "start_task", claim: claimResult, update: updateResult }, globalOptions);
-  if (globalOptions.profile) {
-    printError(`profile:command=start-task took_ms=${Date.now() - startedAt}`);
-  }
-}
-async function runPauseTaskAction(id, options, command) {
-  const globalOptions = getGlobalOptions(command);
-  const startedAt = Date.now();
-  const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);
-  const settings = await readSettings(pmRoot);
-  const statusRegistry = resolveRuntimeStatusRegistry(settings.schema);
-  const force = Boolean(options.force);
-  const mutationOptions = buildLifecycleMutationOptions(options);
-  const [{ runUpdate }, { runRelease }] = await Promise.all([
-    import("./update-SFLZPJXX.js"),
-    import("./claim-4DROPSIS.js")
-  ]);
-  const updateResult = await runUpdate(id, { ...mutationOptions, status: statusRegistry.open_status, force }, globalOptions);
-  await invalidateSearchCachesForMutation(globalOptions, updateResult);
-  const releaseResult = await runRelease(id, force, globalOptions, mutationOptions);
-  await invalidateSearchCachesForMutation(globalOptions, releaseResult);
-  printResult({ id, action: "pause_task", update: updateResult, release: releaseResult }, globalOptions);
-  if (globalOptions.profile) {
-    printError(`profile:command=pause-task took_ms=${Date.now() - startedAt}`);
-  }
-}
-async function runCloseTaskAction(id, reason, options, command) {
-  const globalOptions = getGlobalOptions(command);
-  const startedAt = Date.now();
-  const force = Boolean(options.force);
-  const mutationOptions = buildLifecycleMutationOptions(options);
-  const [{ runClose }, { runRelease }] = await Promise.all([
-    import("./close-3YRR3XY6.js"),
-    import("./claim-4DROPSIS.js")
-  ]);
-  const closeResult = await runClose(id, reason, {
-    ...mutationOptions,
-    validateClose: readOptionString(options, "validateClose"),
-    force
-  }, globalOptions);
-  await invalidateSearchCachesForMutation(globalOptions, closeResult);
-  const releaseResult = await runRelease(id, force, globalOptions, mutationOptions);
-  await invalidateSearchCachesForMutation(globalOptions, releaseResult);
-  printResult({ id, action: "close_task", close: closeResult, release: releaseResult }, globalOptions);
-  if (globalOptions.profile) {
-    printError(`profile:command=close-task took_ms=${Date.now() - startedAt}`);
-  }
-}
-function registerOperationCommands(program) {
-  program.command("test").argument("<id>", "Item id").option("--add <value>", "Add linked test entry (CSV/markdown pairs or - for stdin)", collect).option("--add-json <value>", "Add linked test entry from JSON object/array (or - for stdin)", collect).option("--remove <value>", "Remove linked test entry by command/path (command=<value>, path=<value>, markdown pairs, plain value, or - for stdin)", collect).option("--list", "List linked tests without mutating").option("--run", "Run linked test commands").option("--match <value>", "Run only linked tests whose command/path contains this substring").option("--only-index <n>", "Run only the 1-based linked-test index from --list order").option("--only-last", "Run only the most recently added linked test").option("--background", "Run linked tests in managed background mode").option("--timeout <seconds>", "Default run timeout in seconds").option("--progress", "Emit linked-test progress to stderr (always shown in TTY, opt-in for non-TTY)").option("--env-set <value>", "Set environment variable(s) for linked-test runs (KEY=VALUE, repeatable)", collect).option("--env-clear <value>", "Clear environment variable(s) for linked-test runs (NAME, repeatable)", collect).option("--shared-host-safe", "Apply additive shared-host-safe runtime defaults for linked-test runs").option("--pm-context <mode>", "PM linked-test context mode: schema|tracker|auto (default: schema)").option("--override-linked-pm-context", "Force run-level --pm-context to override per-linked-test pm_context_mode metadata").option("--fail-on-context-mismatch", "Fail linked PM commands when context item counts differ").option("--fail-on-skipped", "Treat skipped linked tests as dependency failures").option("--fail-on-empty-test-run", "Treat successful linked-test commands that report zero executed tests as failures").option("--require-assertions-for-pm", "Require assertion metadata for linked PM command tests").option("--check-context", "Preflight linked PM command context diagnostics before executing commands").option("--auto-pm-context", "Auto-remediate PM tracker-read context mismatches by routing those linked commands through tracker context").option("--author <value>", "Mutation author").option("--message <value>", "History message").option("--force", "Force ownership override").description("Manage tests linked to an item and optionally run them.").action(runTestCommandAction);
-  program.command("test-all").description("Run linked tests across matching items.").option("--status <value>", "Filter items by status before running tests").option("--limit <n>", "Limit matching items before running linked tests").option("--offset <n>", "Skip matching items before running linked tests").option("--background", "Run linked tests in managed background mode").option("--timeout <seconds>", "Default run timeout in seconds").option("--progress", "Emit linked-test progress to stderr (always shown in TTY, opt-in for non-TTY)").option("--env-set <value>", "Set environment variable(s) for linked-test runs (KEY=VALUE, repeatable)", collect).option("--env-clear <value>", "Clear environment variable(s) for linked-test runs (NAME, repeatable)", collect).option("--shared-host-safe", "Apply additive shared-host-safe runtime defaults for linked-test runs").option("--pm-context <mode>", "PM linked-test context mode: schema|tracker|auto (default: schema)").option("--override-linked-pm-context", "Force run-level --pm-context to override per-linked-test pm_context_mode metadata").option("--fail-on-context-mismatch", "Fail linked PM commands when context item counts differ").option("--fail-on-skipped", "Treat skipped linked tests as dependency failures").option("--fail-on-empty-test-run", "Treat successful linked-test commands that report zero executed tests as failures").option("--require-assertions-for-pm", "Require assertion metadata for linked PM command tests").option("--check-context", "Preflight linked PM command context diagnostics before executing commands").option("--auto-pm-context", "Auto-remediate PM tracker-read context mismatches by routing those linked commands through tracker context").action(runTestAllAction);
-  program.command("test-runs-worker", { hidden: true }).argument("<runId>", "Background run id").description("Internal background worker command.").action(async (runId, _options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const { runTestRunsWorker } = await import("./test-runs-245OINZR.js");
-    await runTestRunsWorker(runId, globalOptions);
-  });
-  program.command("telemetry").argument("[namespaceOrSubcommand]", "Telemetry subcommand: status, flush, stats, clear (default: status)").argument("[subcommand]", "Compatibility alias target for local-analytics: status, flush, stats, clear").option("--limit <n>", "Maximum command groups returned by telemetry stats").description("Inspect and manage local telemetry queue/runtime state.").action(runTelemetryAction);
-  program.command("stats").description("Show project tracker statistics.").option("--storage", "Include aggregate history-stream storage metrics (total streams/lines/bytes, largest + deepest streams, oldest/newest entries)").option("--metadata-coverage", "Include metadata coverage % (acceptance_criteria, estimated_minutes, resolution, tags, parent) overall and by type").option("--by-assignee", "Include a lifecycle-bucketed item breakdown grouped by assignee").option("--by-tag", "Include a lifecycle-bucketed item breakdown grouped by tag").option("--by-priority", "Include a lifecycle-bucketed item breakdown grouped by priority").option("--tag-prefix <value>", "With --by-tag: only count tags starting with this prefix (e.g. domain:)").option("--field-utilization", "Report content-field utilization rates (notes/learnings/files/docs/tests/comments/deps/body) for governance audits").action(runStatsAction);
-  program.command("health").description("Show project tracker health checks.").option("--strict-directories", "Treat optional item-type directories as required failures").option("--check-only", "Run read-only health diagnostics without refreshing vectors").option("--check-telemetry", "Probe telemetry endpoint health and include network diagnostics").option("--no-refresh", "Disable automatic vector refresh attempts during health checks").option("--refresh-vectors", "Explicitly enable vector refresh attempts during health checks").option("--verbose-stale-items", "Include full stale vectorization ID lists in health output").option("--brief", "Emit compact health details for low-token agent checks").option("--summary", "Emit one-line-style health status with check names and warning count").option("--skip-vectors", "Skip vectorization check for a faster run").option("--skip-integrity", "Skip item/history file integrity check for a faster run").option("--skip-drift", "Skip history drift hash check for a faster run").option("--full", "Run all checks including slow integrity, drift, and vectorization checks").option("--strict-exit", "Return non-zero exit when health is not ok (advisory telemetry warnings are excluded; see warnings[])").option("--fail-on-warn", "Alias for --strict-exit").action(runHealthAction);
-  program.command("validate").description("Run standalone metadata, resolution, lifecycle, files, linked-command reference, and history drift validation checks.").option("--check-metadata", "Run metadata completeness checks").option("--metadata-profile <value>", "Select metadata validation profile for --check-metadata (core|strict|custom)").option("--check-resolution", "Run closed-item resolution metadata checks").option("--check-lifecycle", "Run active-item lifecycle governance drift checks").option("--check-stale-blockers", "Include stale blocker-pattern diagnostics in lifecycle checks").option("--dependency-cycle-severity <value>", "Set dependency-cycle warning policy for lifecycle checks (off|warn|error)").option("--parent-cycle-severity <value>", "Set parent-hierarchy cycle warning policy for lifecycle checks (off|warn|error)").option("--check-files", "Run linked-file and orphaned-file checks").option("--check-command-references", "Run linked-command PM-ID reference checks").option("--scan-mode <value>", "Select file candidate scan mode for --check-files (default|tracked-all|tracked-all-strict)").option("--include-pm-internals", "Include PM storage internals in tracked-all candidate scans").option("--verbose-file-lists", "Include full file-path lists for validate --check-files details").option("--verbose-diagnostics", "Include full validate diagnostic ID lists instead of compact summaries").option("--all-affected-ids", "Emit complete missing_* affected-ID lists with no truncation (implied by --json)").option("--strict-exit", "Return non-zero exit when validation warnings are present").option("--fail-on-warn", "Alias for --strict-exit").option("--fix-hints", "Add a machine-executable fix_hints[] of pm commands to each failing check's details").option("--auto-fix", "Apply the safe, deterministic subset of fix-hint remediations (field backfills) automatically").option("--dry-run", "Preview planned --auto-fix/--prune-missing fixes without applying them").option("--fix-scope <scope>", "Grant --auto-fix scopes (metadata, resolution, lifecycle; comma-separated or repeatable). Default: metadata, resolution; lifecycle must be named explicitly", collect).option("--prune-missing", "Remove stale linked-file/doc LINKS whose paths classified as deleted (never touches real files)").option("--check-history-drift", "Run item/history hash drift checks").action(runValidateAction);
-  program.command("gc").option("--dry-run", "Preview cleanup targets without deleting files; without this flag, pm gc deletes matched artifacts").option("--scope <value>", "Limit cleanup to one or more scopes (comma-separated or repeatable): index, embeddings, runtime, locks, checkpoints", collect).description("Delete optional cache artifacts by default (including expired lock debris) and show a summary.").action(runGcAction);
-  program.command("contracts").description("Show machine-readable command and schema contracts for agents.").option("--action <value>", "Filter tool schema branches to a specific action").option("--command <value>", "Scope contracts output to one CLI command (narrow-by-default)").option("--schema-only", "Return schema-focused output only").option("--flags-only", "Return command flag contracts only").option("--availability-only", "Return action availability surface only").option("--runtime-only", "Include only actions invocable in the current runtime").option("--active-only", "Alias for --runtime-only").option("--full", "Include full schema and command-flag surfaces (large; default brief output omits heavy sections for unfiltered queries)").action(runContractsAction);
-  program.command("claim").argument("<id>", "Item id").option("--author <value>", "Mutation author").option("--message <value>", "History message").option("--force", "Force claim override").option("--if-available", "Skip silently when the item is already claimed by another author (returns skipped=true)").description("Claim an item for active work.").action(runClaimAction);
-  program.command("release").argument("<id>", "Item id").option("--author <value>", "Mutation author").option("--message <value>", "History message").option("--allow-audit-release", "Allow non-owner release handoffs without requiring --force").option("--force", "Force release override").description("Release an item's active claim.").action(runReleaseAction);
-  program.command("start-task").argument("<id>", "Item id").option("--author <value>", "Mutation author").option("--message <value>", "History message").option("--force", "Force ownership or terminal override when required").description("Lifecycle alias: claim an item and move it to in_progress.").action(runStartTaskAction);
-  program.command("pause-task").argument("<id>", "Item id").option("--author <value>", "Mutation author").option("--message <value>", "History message").option("--force", "Force ownership override when required").description("Lifecycle alias: move an item to open and release its claim.").action(runPauseTaskAction);
-  program.command("close-task").argument("<id>", "Item id").argument("[reason]", "Close reason text").option("--author <value>", "Mutation author").option("--message <value>", "History message").option("--validate-close <value>", "Close-time validation mode: off|warn|strict").option("--force", "Force ownership or terminal override when required").description("Lifecycle alias: close an item and release assignment metadata.").action(runCloseTaskAction);
-  registerSchedulingShortcutCommands(program);
-}
-function optionalString(value) {
-  return typeof value === "string" ? value : void 0;
-}
-function buildShortcutCommonOptions(options) {
-  return {
-    parent: optionalString(options.parent),
-    allowMissingParent: options.allowMissingParent === true ? true : void 0,
-    tags: optionalString(options.tags),
-    priority: optionalString(options.priority),
-    body: optionalString(options.body),
-    description: optionalString(options.description),
-    author: optionalString(options.author),
-    message: optionalString(options.message)
-  };
-}
-function registerSchedulingShortcutCommands(program) {
-  for (const { name, describe } of [
-    { name: "meet", describe: "Shortcut: create a Meeting with a start time and duration." },
-    { name: "event", describe: "Shortcut: create an Event with a start time and duration." }
-  ]) {
-    program.command(name).argument("<title>", "Item title").option("--start <when>", "Start time (ISO, 'now', or relative like +1h/+2d); defaults to now").option("--duration <span>", "Duration from start (relative like 1h/2d); defaults to 1h when --end is omitted").option("--end <when>", "End time (ISO or relative); overrides --duration").option("--location <value>", "Location").option("--timezone <value>", "IANA timezone (for example America/New_York)").option("--all-day", "Mark as an all-day event").option("--parent <id>", "Parent item id").option("--allow-missing-parent", "Permit a parent id that does not exist yet").option("--tags <list>", "Comma-separated tags").option("--priority <value>", "Priority").option("--body <text>", "Body/markdown content").option("--description <text>", "Short description").option("--author <value>", "Mutation author").option("--message <value>", "History message").description(describe).action(async (title, options, command) => {
-      const globalOptions = getGlobalOptions(command);
-      const startedAt = Date.now();
-      const { runMeet, runEvent } = await import("./scheduling-shortcuts-ULRG7MNP.js");
-      const run = name === "meet" ? runMeet : runEvent;
-      const result = await run(title, {
-        ...buildShortcutCommonOptions(options),
-        start: optionalString(options.start),
-        duration: optionalString(options.duration),
-        end: optionalString(options.end),
-        location: optionalString(options.location),
-        timezone: optionalString(options.timezone),
-        allDay: options.allDay === true ? true : void 0
-      }, globalOptions);
-      await invalidateSearchCachesForMutation(globalOptions, result);
-      printResult(result, globalOptions);
-      if (globalOptions.profile) {
-        printError(`profile:command=${name} took_ms=${Date.now() - startedAt}`);
-      }
-    });
-  }
-  program.command("remind").argument("<title>", "Item title").option("--at <when>", "Reminder time (ISO, 'now', or relative like +2d); defaults to +1d").option("--text <value>", "Reminder text; defaults to the title").option("--parent <id>", "Parent item id").option("--allow-missing-parent", "Permit a parent id that does not exist yet").option("--tags <list>", "Comma-separated tags").option("--priority <value>", "Priority").option("--body <text>", "Body/markdown content").option("--description <text>", "Short description").option("--author <value>", "Mutation author").option("--message <value>", "History message").description("Shortcut: create a Reminder from a single point in time.").action(async (title, options, command) => {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    const { runRemind } = await import("./scheduling-shortcuts-ULRG7MNP.js");
-    const result = await runRemind(title, {
-      ...buildShortcutCommonOptions(options),
-      at: optionalString(options.at),
-      text: optionalString(options.text)
-    }, globalOptions);
-    await invalidateSearchCachesForMutation(globalOptions, result);
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-      printError(`profile:command=remind took_ms=${Date.now() - startedAt}`);
-    }
-  });
-}
-export {
-  registerOperationCommands,
-  resolveStartTaskInProgressStatus
-};
-//# sourceMappingURL=register-operations-A3XAM5J7.js.map
-
-//# debugId=83cf690f-7473-5e78-9177-87c2b9db9f13