@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/cli/migration-gates.js

@@ -1,290 +1,2 @@
-/**
- * @module cli/migration-gates
- *
- * Provides CLI runtime support for Migration Gates.
- */
-
-!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]="33842ea7-43c9-52a3-a9ec-75f190a5fd6f")}catch(e){}}();
-import { pathExists, getActiveExtensionRegistrations, resolveItemTypeRegistry, migrateItemFilesToFormat, getSettingsPath, persistSelectedItemFormat, readSettingsWithMetadata, writeSettings, EXIT_CODE, PmCliError, toNonEmptyStringOrUndefined, printError, evaluateMutationGuard, isMutationAction, resolveAuthor, locateItem, readLocatedItem, } from "../sdk/runtime-primitives.js";
-/** Implements resolve migration id for the public runtime surface of this module. */
-export function resolveMigrationId(definition, fallbackIndex) {
-    const explicit = toNonEmptyStringOrUndefined(definition.id);
-    if (explicit) {
-        return explicit;
-    }
-    return `migration-${String(fallbackIndex + 1).padStart(3, "0")}`;
-}
-/** Implements resolve normalized migration status for the public runtime surface of this module. */
-export function resolveNormalizedMigrationStatus(definition) {
-    const normalized = toNonEmptyStringOrUndefined(definition.status)?.toLowerCase();
-    return normalized ?? "pending";
-}
-function isMandatoryMigrationDefinition(definition) {
-    return definition.mandatory === true;
-}
-function compareMandatoryMigrationBlockers(left, right) {
-    const byLayer = left.layer.localeCompare(right.layer);
-    if (byLayer !== 0) {
-        return byLayer;
-    }
-    const byName = left.name.localeCompare(right.name);
-    if (byName !== 0) {
-        return byName;
-    }
-    return left.id.localeCompare(right.id);
-}
-/** Implements collect mandatory migration blockers for the public runtime surface of this module. */
-export function collectMandatoryMigrationBlockers(migrations) {
-    const blockers = [];
-    migrations.forEach((entry, index) => {
-        if (!isMandatoryMigrationDefinition(entry.definition)) {
-            return;
-        }
-        const status = resolveNormalizedMigrationStatus(entry.definition);
-        if (status === "applied") {
-            return;
-        }
-        blockers.push({
-            layer: entry.layer,
-            name: entry.name,
-            id: resolveMigrationId(entry.definition, index),
-            status,
-        });
-    });
-    blockers.sort(compareMandatoryMigrationBlockers);
-    return blockers;
-}
-function hasMutatingListValues(value) {
-    return Array.isArray(value) && value.length > 0;
-}
-const ALWAYS_MUTATING_COMMANDS = new Set([
-    "create",
-    "beads import",
-    "todos import",
-]);
-const FORCEABLE_MUTATING_COMMANDS = new Set([
-    "restore",
-    "update",
-    "close",
-    "delete",
-    "append",
-    "claim",
-    "release",
-]);
-const TEXT_APPEND_COMMANDS = new Set(["comments", "notes", "learnings"]);
-const LIST_MUTATION_COMMANDS = new Set(["files", "docs", "test"]);
-const POSITIONAL_MUTATION_VERBS = new Set([
-    "activate",
-    "add",
-    "add-field",
-    "add-status",
-    "add-type",
-    "apply",
-    "compact",
-    "create",
-    "deactivate",
-    "delete",
-    "disable",
-    "edit",
-    "enable",
-    "import",
-    "infer",
-    "install",
-    "materialize",
-    "migrate",
-    "redact",
-    "remove",
-    "remove-field",
-    "remove-status",
-    "remove-type",
-    "remap-status",
-    "rename-field",
-    "rename-type",
-    "repair",
-    "run",
-    "save",
-    "set",
-    "unset",
-    "update",
-    "upgrade",
-]);
-/** Implements decide write gate for the public runtime surface of this module. */
-export function decideWriteGate(commandPath, options) {
-    const forceRequested = options.force === true;
-    if (ALWAYS_MUTATING_COMMANDS.has(commandPath)) {
-        return { isMutation: true, forceCapable: false, forceRequested: false };
-    }
-    if (FORCEABLE_MUTATING_COMMANDS.has(commandPath)) {
-        return { isMutation: true, forceCapable: true, forceRequested };
-    }
-    if (TEXT_APPEND_COMMANDS.has(commandPath)) {
-        return {
-            isMutation: typeof options.add === "string",
-            forceCapable: true,
-            forceRequested,
-        };
-    }
-    if (LIST_MUTATION_COMMANDS.has(commandPath)) {
-        return {
-            isMutation: hasMutatingListValues(options.add) ||
-                hasMutatingListValues(options.remove),
-            forceCapable: true,
-            forceRequested,
-        };
-    }
-    return { isMutation: false, forceCapable: false, forceRequested: false };
-}
-function isMutationInvocation(commandPath, commandArgs, options) {
-    if (decideWriteGate(commandPath, options).isMutation) {
-        return true;
-    }
-    const normalizedCommand = commandPath.trim().toLowerCase();
-    if (!isMutationAction(normalizedCommand)) {
-        return false;
-    }
-    if ([
-        "close-many",
-        "close-task",
-        "copy",
-        "delete",
-        "discover",
-        "focus",
-        "pause-task",
-        "start-task",
-        "update-many",
-    ].includes(normalizedCommand)) {
-        return true;
-    }
-    return commandArgs.some((argument) => POSITIONAL_MUTATION_VERBS.has(argument.trim().toLowerCase()));
-}
-/** Normalize configured active-status spellings for preflight comparison. */
-export function normalizedLifecycleStatus(value) {
-    return (value ?? "in_progress").trim().toLowerCase().replaceAll("-", "_");
-}
-/** Convert incomplete schema-evolution CLI invocations into typed usage errors. */
-export function enforceSchemaMigrationInput(commandPath, commandArgs, options) {
-    const subcommand = commandArgs[0]?.trim().toLowerCase() ?? "";
-    if (commandPath.trim().toLowerCase() !== "schema" ||
-        !["rename-type", "rename-field", "remap-status"].includes(subcommand)) {
-        return;
-    }
-    const missing = [];
-    if (!toNonEmptyStringOrUndefined(commandArgs[1]))
-        missing.push("source");
-    if (!toNonEmptyStringOrUndefined(options.to))
-        missing.push("--to");
-    if (missing.length === 0) {
-        return;
-    }
-    throw new PmCliError(`Schema migration requires ${missing.join(", ")}.`, EXIT_CODE.USAGE, {
-        code: "schema_migration_input_required",
-        required: missing.join(","),
-        why: "Schema migrations require a source and target. A workspace-bound stable migration id is derived automatically when --migration-id is omitted.",
-        recovery: {
-            recovery_mode: "compact",
-            missing_required_fields: missing,
-            suggested_flags: missing.filter((entry) => entry.startsWith("--")),
-            suggested_retry: `pm schema ${subcommand} <source> --to <target>`,
-        },
-    });
-}
-async function warnForUnclaimedInProgressUpdate(commandPath, commandArgs, options, pmRoot, settings) {
-    if (commandPath.trim().toLowerCase() !== "update" ||
-        typeof options.status !== "string" ||
-        normalizedLifecycleStatus(options.status) !==
-            normalizedLifecycleStatus(settings.schema.workflow.in_progress_status)) {
-        return;
-    }
-    const rawId = commandArgs[0];
-    if (!rawId) {
-        return;
-    }
-    const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-    const located = await locateItem(pmRoot, rawId, settings.id_prefix, settings.item_format, typeRegistry.type_to_folder);
-    if (!located) {
-        return;
-    }
-    const current = await readLocatedItem(located, { schema: settings.schema });
-    const requestedAssignee = typeof options.assignee === "string" ? options.assignee.trim() : undefined;
-    const prospectiveAssignee = requestedAssignee === undefined
-        ? current.document.metadata.assignee?.trim()
-        : ["", "none", "null", "undefined"].includes(requestedAssignee.toLowerCase())
-            ? undefined
-            : requestedAssignee;
-    if (prospectiveAssignee) {
-        return;
-    }
-    printError(`warning:in_progress_item_unclaimed:${located.id}:claim_with=pm claim ${located.id}`);
-}
-/**
- * Apply SDK-owned provenance and secret policy to one parsed CLI invocation.
- * Advisory output is stderr-only so JSON/TOON result envelopes stay unchanged.
- */
-export async function enforceMutationGuardPreflight(commandPath, commandArgs, options, global, pmRoot) {
-    if (!isMutationInvocation(commandPath, commandArgs, options)) {
-        return;
-    }
-    enforceSchemaMigrationInput(commandPath, commandArgs, options);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        return;
-    }
-    const settings = await readSettingsWithMetadata(pmRoot);
-    if (global.json !== true) {
-        await warnForUnclaimedInProgressUpdate(commandPath, commandArgs, options, pmRoot, settings.settings);
-    }
-    const result = evaluateMutationGuard({
-        author: resolveAuthor(global.author, settings.settings.author_default),
-        payload: { command: commandPath, args: commandArgs, options },
-        settings: settings.settings.mutation_guard,
-        force: global.force === true || options.force === true,
-    });
-    for (const warning of result.warnings) {
-        printError(`warning:${warning}`);
-    }
-}
-/** Implements enforce mandatory migration write gate for the public runtime surface of this module. */
-export function enforceMandatoryMigrationWriteGate(commandPath, options, blockers) {
-    if (blockers.length === 0) {
-        return;
-    }
-    const decision = decideWriteGate(commandPath, options);
-    if (!decision.isMutation) {
-        return;
-    }
-    if (decision.forceCapable && decision.forceRequested) {
-        return;
-    }
-    const codes = blockers.map((entry) => `extension_migration_blocking:${entry.layer}:${entry.name}:${entry.id}:${entry.status}`);
-    const forceGuidance = decision.forceCapable
-        ? "Re-run this command with --force to bypass."
-        : "This command path does not support --force bypass.";
-    throw new PmCliError(`Write command "${commandPath}" blocked by unresolved mandatory extension migrations (${codes.join(",")}). ${forceGuidance}`, EXIT_CODE.CONFLICT);
-}
-/** Implements enforce item format write gate and preflight migration for the public runtime surface of this module. */
-export async function enforceItemFormatWriteGateAndPreflightMigration(commandPath, options, pmRoot, decision) {
-    const writeGate = decideWriteGate(commandPath, options);
-    if (!writeGate.isMutation) {
-        return;
-    }
-    if (!decision.enforce_item_format_gate &&
-        !decision.run_preflight_item_format_sync) {
-        return;
-    }
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        return;
-    }
-    const { settings, metadata, warnings } = await readSettingsWithMetadata(pmRoot);
-    for (const warning of warnings) {
-        printError(`warning:${warning}`);
-    }
-    if (decision.enforce_item_format_gate && !metadata.has_explicit_item_format) {
-        persistSelectedItemFormat(settings);
-        await writeSettings(pmRoot, settings, "item_format:auto_select_default");
-    }
-    if (decision.run_preflight_item_format_sync) {
-        const typeRegistry = resolveItemTypeRegistry(settings, getActiveExtensionRegistrations());
-        await migrateItemFilesToFormat(pmRoot, settings.item_format, "item_format:pre_mutation_sync", typeRegistry.type_to_folder, 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]="840b471e-c996-57e2-b97c-3a84bd68f050")}catch(e2){}})();import{pathExists,getActiveExtensionRegistrations,resolveItemTypeRegistry,migrateItemFilesToFormat,getSettingsPath,persistSelectedItemFormat,readSettingsWithMetadata,writeSettings,EXIT_CODE,PmCliError,toNonEmptyStringOrUndefined,printError,evaluateMutationGuard,isMutationAction,resolveAuthor,locateItem,readLocatedItem}from"../sdk/runtime-primitives.js";function resolveMigrationId(definition,fallbackIndex){const explicit=toNonEmptyStringOrUndefined(definition.id);if(explicit){return explicit}return`migration-${String(fallbackIndex+1).padStart(3,"0")}`}function resolveNormalizedMigrationStatus(definition){const normalized=toNonEmptyStringOrUndefined(definition.status)?.toLowerCase();return normalized??"pending"}function isMandatoryMigrationDefinition(definition){return definition.mandatory===true}function compareMandatoryMigrationBlockers(left,right){const byLayer=left.layer.localeCompare(right.layer);if(byLayer!==0){return byLayer}const byName=left.name.localeCompare(right.name);if(byName!==0){return byName}return left.id.localeCompare(right.id)}function collectMandatoryMigrationBlockers(migrations){const blockers=[];migrations.forEach((entry,index)=>{if(!isMandatoryMigrationDefinition(entry.definition)){return}const status=resolveNormalizedMigrationStatus(entry.definition);if(status==="applied"){return}blockers.push({layer:entry.layer,name:entry.name,id:resolveMigrationId(entry.definition,index),status})});blockers.sort(compareMandatoryMigrationBlockers);return blockers}function hasMutatingListValues(value){return Array.isArray(value)&&value.length>0}const ALWAYS_MUTATING_COMMANDS=new Set(["create","beads import","todos import"]);const FORCEABLE_MUTATING_COMMANDS=new Set(["restore","update","close","delete","append","claim","release"]);const TEXT_APPEND_COMMANDS=new Set(["comments","notes","learnings"]);const LIST_MUTATION_COMMANDS=new Set(["files","docs","test"]);const POSITIONAL_MUTATION_VERBS=new Set(["activate","add","add-field","add-status","add-type","apply","compact","create","deactivate","delete","disable","edit","enable","import","infer","install","materialize","migrate","redact","remove","remove-field","remove-status","remove-type","remap-status","rename-field","rename-type","repair","run","save","set","unset","update","upgrade"]);function decideWriteGate(commandPath,options){const forceRequested=options.force===true;if(ALWAYS_MUTATING_COMMANDS.has(commandPath)){return{isMutation:true,forceCapable:false,forceRequested:false}}if(FORCEABLE_MUTATING_COMMANDS.has(commandPath)){return{isMutation:true,forceCapable:true,forceRequested}}if(TEXT_APPEND_COMMANDS.has(commandPath)){return{isMutation:typeof options.add==="string",forceCapable:true,forceRequested}}if(LIST_MUTATION_COMMANDS.has(commandPath)){return{isMutation:hasMutatingListValues(options.add)||hasMutatingListValues(options.remove),forceCapable:true,forceRequested}}return{isMutation:false,forceCapable:false,forceRequested:false}}function isMutationInvocation(commandPath,commandArgs,options){if(decideWriteGate(commandPath,options).isMutation){return true}const normalizedCommand=commandPath.trim().toLowerCase();if(!isMutationAction(normalizedCommand)){return false}if(["close-many","close-task","copy","delete","discover","focus","pause-task","start-task","update-many"].includes(normalizedCommand)){return true}return commandArgs.some(argument=>POSITIONAL_MUTATION_VERBS.has(argument.trim().toLowerCase()))}function normalizedLifecycleStatus(value){return(value??"in_progress").trim().toLowerCase().replaceAll("-","_")}function enforceSchemaMigrationInput(commandPath,commandArgs,options){const subcommand=commandArgs[0]?.trim().toLowerCase()??"";if(commandPath.trim().toLowerCase()!=="schema"||!["rename-type","rename-field","remap-status"].includes(subcommand)){return}const missing=[];if(!toNonEmptyStringOrUndefined(commandArgs[1]))missing.push("source");if(!toNonEmptyStringOrUndefined(options.to))missing.push("--to");if(missing.length===0){return}throw new PmCliError(`Schema migration requires ${missing.join(", ")}.`,EXIT_CODE.USAGE,{code:"schema_migration_input_required",required:missing.join(","),why:"Schema migrations require a source and target. A workspace-bound stable migration id is derived automatically when --migration-id is omitted.",recovery:{recovery_mode:"compact",missing_required_fields:missing,suggested_flags:missing.filter(entry=>entry.startsWith("--")),suggested_retry:`pm schema ${subcommand} <source> --to <target>`}})}async function warnForUnclaimedInProgressUpdate(commandPath,commandArgs,options,pmRoot,settings){if(commandPath.trim().toLowerCase()!=="update"||typeof options.status!=="string"||normalizedLifecycleStatus(options.status)!==normalizedLifecycleStatus(settings.schema.workflow.in_progress_status)){return}const rawId=commandArgs[0];if(!rawId){return}const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());const located=await locateItem(pmRoot,rawId,settings.id_prefix,settings.item_format,typeRegistry.type_to_folder);if(!located){return}const current=await readLocatedItem(located,{schema:settings.schema});const requestedAssignee=typeof options.assignee==="string"?options.assignee.trim():void 0;const prospectiveAssignee=requestedAssignee===void 0?current.document.metadata.assignee?.trim():["","none","null","undefined"].includes(requestedAssignee.toLowerCase())?void 0:requestedAssignee;if(prospectiveAssignee){return}printError(`warning:in_progress_item_unclaimed:${located.id}:claim_with=pm claim ${located.id}`)}async function enforceMutationGuardPreflight(commandPath,commandArgs,options,global2,pmRoot){if(!isMutationInvocation(commandPath,commandArgs,options)){return}enforceSchemaMigrationInput(commandPath,commandArgs,options);if(!await pathExists(getSettingsPath(pmRoot))){return}const settings=await readSettingsWithMetadata(pmRoot);if(global2.json!==true){await warnForUnclaimedInProgressUpdate(commandPath,commandArgs,options,pmRoot,settings.settings)}const result=evaluateMutationGuard({author:resolveAuthor(global2.author,settings.settings.author_default),payload:{command:commandPath,args:commandArgs,options},settings:settings.settings.mutation_guard,force:global2.force===true||options.force===true});for(const warning of result.warnings){printError(`warning:${warning}`)}}function enforceMandatoryMigrationWriteGate(commandPath,options,blockers){if(blockers.length===0){return}const decision=decideWriteGate(commandPath,options);if(!decision.isMutation){return}if(decision.forceCapable&&decision.forceRequested){return}const codes=blockers.map(entry=>`extension_migration_blocking:${entry.layer}:${entry.name}:${entry.id}:${entry.status}`);const forceGuidance=decision.forceCapable?"Re-run this command with --force to bypass.":"This command path does not support --force bypass.";throw new PmCliError(`Write command "${commandPath}" blocked by unresolved mandatory extension migrations (${codes.join(",")}). ${forceGuidance}`,EXIT_CODE.CONFLICT)}async function enforceItemFormatWriteGateAndPreflightMigration(commandPath,options,pmRoot,decision){const writeGate=decideWriteGate(commandPath,options);if(!writeGate.isMutation){return}if(!decision.enforce_item_format_gate&&!decision.run_preflight_item_format_sync){return}if(!await pathExists(getSettingsPath(pmRoot))){return}const{settings,metadata,warnings}=await readSettingsWithMetadata(pmRoot);for(const warning of warnings){printError(`warning:${warning}`)}if(decision.enforce_item_format_gate&&!metadata.has_explicit_item_format){persistSelectedItemFormat(settings);await writeSettings(pmRoot,settings,"item_format:auto_select_default")}if(decision.run_preflight_item_format_sync){const typeRegistry=resolveItemTypeRegistry(settings,getActiveExtensionRegistrations());await migrateItemFilesToFormat(pmRoot,settings.item_format,"item_format:pre_mutation_sync",typeRegistry.type_to_folder,settings.schema)}}export{collectMandatoryMigrationBlockers,decideWriteGate,enforceItemFormatWriteGateAndPreflightMigration,enforceMandatoryMigrationWriteGate,enforceMutationGuardPreflight,enforceSchemaMigrationInput,normalizedLifecycleStatus,resolveMigrationId,resolveNormalizedMigrationStatus};
 //# sourceMappingURL=migration-gates.js.map
-//# debugId=33842ea7-43c9-52a3-a9ec-75f190a5fd6f

package/dist/cli/public.js

@@ -1,21 +1,2 @@
-/**
- * @module cli/public
- *
- * Publishes the supported embeddable CLI entrypoint without exposing the
- * implementation module's repository-only test seams to package consumers.
- */
-
-!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]="8e212bdf-7568-54dd-91aa-7de146d65d03")}catch(e){}}();
-import { runPmCli as runInternalPmCli } from "./main.js";
-/** Run one embedded CLI invocation without leaking its exit status into the host process. */
-export async function runPmCli(rawArgv) {
-    const previousExitCode = process.exitCode;
-    try {
-        await runInternalPmCli(rawArgv);
-    }
-    finally {
-        process.exitCode = previousExitCode;
-    }
-}
+!(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]="b63b9ea0-d392-547a-a05b-0911712d5016")}catch(e2){}})();import{runPmCli as runInternalPmCli}from"./main.js";async function runPmCli(rawArgv){const previousExitCode=process.exitCode;try{await runInternalPmCli(rawArgv)}finally{process.exitCode=previousExitCode}}export{runPmCli};
 //# sourceMappingURL=public.js.map
-//# debugId=8e212bdf-7568-54dd-91aa-7de146d65d03

package/dist/cli/register-annotations.js

@@ -1,271 +1,2 @@
-
-!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]="775518a4-ff3e-5a54-8fbd-b2c4863e23db")}catch(e){}}();
-import { EXIT_CODE, PmCliError, } from "../sdk/runtime-primitives.js";
-import { renderPmCommand } from "../sdk/command-line.js";
-import { runComments } from "./commands/comments.js";
-import { runLearnings } from "./commands/learnings.js";
-import { runNotes } from "./commands/notes.js";
-import { addHiddenOption, getGlobalOptions, invalidateSearchCachesForMutation, printError, printResult, readOptionString, } from "./registration-helpers.js";
-function assertNoTransposedAnnotationAction(collection, id, text, options) {
-    if (id.trim().toLowerCase() !== "add" || !text?.trim()) {
-        return;
-    }
-    const suppliedText = readOptionString(options, "add") ??
-        readOptionString(options, "text") ??
-        readOptionString(options, "note") ??
-        readOptionString(options, "body") ??
-        readOptionString(options, "comment");
-    const file = readOptionString(options, "file");
-    const retryArgs = [collection, text.trim()];
-    if (suppliedText !== undefined)
-        retryArgs.push("--add", suppliedText);
-    else if (options.stdin === true)
-        retryArgs.push("--stdin");
-    else if (file !== undefined)
-        retryArgs.push("--file", file);
-    else
-        retryArgs.push("--add", "-");
-    const suggestedRetry = renderPmCommand(retryArgs);
-    const stdinRetry = renderPmCommand([collection, text.trim(), "--add", "-"]);
-    throw new PmCliError(`The positional token "add" was parsed as the item id, while "${text.trim()}" was parsed as annotation text. ${collection} does not use an add subcommand.`, EXIT_CODE.USAGE, {
-        code: "annotation_transposed_subcommand",
-        reason: "noun_verb_object_transposition",
-        required: `Place the item id immediately after ${collection}, then use --add for annotation text.`,
-        examples: [...new Set([suggestedRetry, stdinRetry])],
-        recovery: {
-            attempted_command: `pm ${collection} add ${text.trim()}`,
-            normalized_args: [collection, "add", text.trim()],
-            parsed_positionals: [
-                { role: "transposed_subcommand", value: "add" },
-                { role: "item_id", value: text.trim() },
-            ],
-            suggested_retry: suggestedRetry,
-        },
-    });
-}
-function resolveAnnotationTextAliases(label, options, aliases) {
-    const supplied = aliases.flatMap((alias) => {
-        const value = readOptionString(options, alias);
-        return value === undefined ? [] : [{ alias, value }];
-    });
-    const distinctValues = [...new Set(supplied.map(({ value }) => value))];
-    if (distinctValues.length > 1) {
-        throw new PmCliError(`Specify ${label} text with one alias or the same value across aliases: ${supplied.map(({ alias }) => `--${alias}`).join(", ")}`, EXIT_CODE.USAGE, { code: "annotation_alias_conflict" });
-    }
-    return supplied[0]?.value;
-}
-function resolveCommentSources(text, options) {
-    const editIndex = typeof options.edit === "number" ? options.edit : undefined;
-    const deleteIndex = typeof options.delete === "number" ? options.delete : undefined;
-    const addFromOption = resolveAnnotationTextAliases("comment", options, [
-        "add",
-        "text",
-        "body",
-        "comment",
-    ]);
-    const addFromPositional = typeof text === "string" ? text : undefined;
-    const readFromStdin = options.stdin === true;
-    const readFromFile = readOptionString(options, "file");
-    const sourceCount = Number(addFromOption !== undefined) +
-        Number(addFromPositional !== undefined) +
-        Number(readFromStdin) +
-        Number(readFromFile !== undefined);
-    if (sourceCount > 1) {
-        if (addFromOption !== undefined &&
-            addFromPositional !== undefined &&
-            !readFromStdin &&
-            readFromFile === undefined) {
-            throw new PmCliError("Specify comment text either as positional [text] or with --add, not both", EXIT_CODE.USAGE);
-        }
-        throw new PmCliError("Specify comment text with exactly one source: positional [text], --add, --stdin, or --file", EXIT_CODE.USAGE);
-    }
-    const add = addFromOption ?? addFromPositional;
-    return {
-        add,
-        readFromStdin,
-        readFromFile,
-        editIndex,
-        deleteIndex,
-        isMutation: typeof add === "string" ||
-            readFromStdin ||
-            readFromFile !== undefined ||
-            editIndex !== undefined ||
-            deleteIndex !== undefined,
-    };
-}
-/** Resolves every mutation-bearing source for notes and learnings once. */
-function resolveSingleAnnotationSources(label, positional, options) {
-    const addFromOption = resolveAnnotationTextAliases(label, options, label === "note" ? ["add", "text", "note"] : ["add", "text"]);
-    const addFromPositional = typeof positional === "string" ? positional : undefined;
-    if (addFromOption !== undefined && addFromPositional !== undefined) {
-        throw new PmCliError(`Specify ${label} text either as positional [text] or with --add, not both`, EXIT_CODE.USAGE);
-    }
-    const add = addFromOption ?? addFromPositional;
-    const addJson = label === "note" ? readOptionString(options, "addJson") : undefined;
-    const readFromStdin = options.stdin === true;
-    const readFromFile = readOptionString(options, "file");
-    const editIndex = typeof options.edit === "number" ? options.edit : undefined;
-    const deleteIndex = typeof options.delete === "number" ? options.delete : undefined;
-    return {
-        add,
-        addJson,
-        readFromStdin,
-        readFromFile,
-        editIndex,
-        deleteIndex,
-        isMutation: typeof add === "string" ||
-            addJson !== undefined ||
-            readFromStdin ||
-            readFromFile !== undefined ||
-            editIndex !== undefined ||
-            deleteIndex !== undefined,
-    };
-}
-async function runCommentsAction(id, text, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    assertNoTransposedAnnotationAction("comments", id, text, options);
-    const sources = resolveCommentSources(text, options);
-    const result = await runComments(id, {
-        add: sources.add,
-        stdin: sources.readFromStdin,
-        file: sources.readFromFile,
-        edit: sources.editIndex,
-        delete: sources.deleteIndex,
-        limit: readOptionString(options, "limit"),
-        fullHistory: options.fullHistory === true,
-        ifAbsent: options.ifAbsent === true,
-        author: readOptionString(options, "author"),
-        message: readOptionString(options, "message"),
-        ownershipAppendBypass: options.ownershipAppendBypass === true,
-        force: Boolean(options.force),
-    }, globalOptions);
-    if (sources.isMutation && result.changed !== false) {
-        await invalidateSearchCachesForMutation(globalOptions, result);
-    }
-    printAnnotationResult("comments", result, globalOptions, startedAt);
-}
-async function runNotesAction(id, text, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    assertNoTransposedAnnotationAction("notes", id, text, options);
-    const sources = resolveSingleAnnotationSources("note", text, options);
-    const result = await runNotes(id, {
-        add: sources.add,
-        addJson: sources.addJson,
-        stdin: sources.readFromStdin,
-        file: sources.readFromFile,
-        edit: sources.editIndex,
-        delete: sources.deleteIndex,
-        limit: readOptionString(options, "limit"),
-        since: readOptionString(options, "since"),
-        eventType: readOptionString(options, "eventType"),
-        includeMeta: options.includeMeta === true,
-        fullHistory: options.fullHistory === true,
-        ifAbsent: options.ifAbsent === true,
-        author: readOptionString(options, "author"),
-        message: readOptionString(options, "message"),
-        ownershipAppendBypass: options.ownershipAppendBypass === true,
-        force: Boolean(options.force),
-    }, globalOptions);
-    if (sources.isMutation && result.changed !== false) {
-        await invalidateSearchCachesForMutation(globalOptions, result);
-    }
-    printAnnotationResult("notes", result, globalOptions, startedAt);
-}
-async function runLearningsAction(id, text, options, command) {
-    const globalOptions = getGlobalOptions(command);
-    const startedAt = Date.now();
-    assertNoTransposedAnnotationAction("learnings", id, text, options);
-    const sources = resolveSingleAnnotationSources("learning", text, options);
-    const result = await runLearnings(id, {
-        add: sources.add,
-        stdin: sources.readFromStdin,
-        file: sources.readFromFile,
-        edit: sources.editIndex,
-        delete: sources.deleteIndex,
-        limit: readOptionString(options, "limit"),
-        fullHistory: options.fullHistory === true,
-        ifAbsent: options.ifAbsent === true,
-        author: readOptionString(options, "author"),
-        message: readOptionString(options, "message"),
-        ownershipAppendBypass: options.ownershipAppendBypass === true,
-        force: Boolean(options.force),
-    }, globalOptions);
-    if (sources.isMutation && result.changed !== false) {
-        await invalidateSearchCachesForMutation(globalOptions, result);
-    }
-    printAnnotationResult("learnings", result, globalOptions, startedAt);
-}
-function printAnnotationResult(command, result, globalOptions, startedAt) {
-    printResult(result, globalOptions);
-    if (globalOptions.profile) {
-        printError(`profile:command=${command} took_ms=${Date.now() - startedAt}`);
-    }
-}
-/** Register bounded annotation commands on the root Commander program. */
-export function registerAnnotationCommands(program, parsePositiveInteger) {
-    const commentsCommand = program
-        .command("comments")
-        .argument("<id>", "Item id")
-        .argument("[text]", "Optional comment text shorthand (equivalent to --add)")
-        .option("--add <text>", "Append comment text; use text=<value> for structured input or - for stdin")
-        .option("--stdin", "Read comment text from stdin (supports multiline markdown)")
-        .option("--file <path>", "Read comment text from a file or stdin (-)")
-        .option("--edit <index>", "Replace one comment using positional text, --add, --stdin, or --file", parsePositiveInteger("--edit"))
-        .option("--delete <index>", "Delete the comment at 1-based <index>", parsePositiveInteger("--delete"))
-        .option("--limit <n>", "Return only latest n comments")
-        .option("--full-history", "Return complete comment history instead of a bounded mutation receipt")
-        .option("--if-absent", "Append only when resolved author and text are absent")
-        .option("--author [value]", "Comment author; defaults to PM_AUTHOR or settings")
-        .option("--message <value>", "History message")
-        .option("--force", "Force ownership override")
-        .description("List, add, edit, or delete comments for an item.")
-        .action(runCommentsAction);
-    addHiddenOption(commentsCommand, "--body <text>", "Alias for --add", false);
-    addHiddenOption(commentsCommand, "--text <text>", "Alias for --add", false);
-    addHiddenOption(commentsCommand, "--comment <text>", "Alias for --add", false);
-    const notesCommand = program
-        .command("notes")
-        .argument("<id>", "Item id")
-        .argument("[text]", "Optional note text shorthand for --add")
-        .option("--add <text>", "Add a text note (- reads stdin)")
-        .option("--note <text>", "Alias for --add")
-        .option("--add-json <json>", "Append a JSON event")
-        .option("--stdin", "Read note text from stdin")
-        .option("--file <path>", "Read note from file or stdin (-)")
-        .option("--edit <index>", "Replace a 1-based note using the selected text input", parsePositiveInteger("--edit"))
-        .option("--delete <index>", "Delete the note at 1-based <index>", parsePositiveInteger("--delete"))
-        .option("--limit <n>", "Return only latest n notes")
-        .option("--since <timestamp>", "Filter JSON events from this ISO time")
-        .option("--event-type <value>", "Filter JSON events by top-level type")
-        .option("--include-meta", "Include count and truncation metadata")
-        .option("--full-history", "Return complete note history instead of a bounded receipt")
-        .option("--if-absent", "Append only when resolved author and text are absent")
-        .option("--author [value]", "Author; defaults to PM_AUTHOR/settings")
-        .option("--message <value>", "History message")
-        .option("--force", "Force ownership override")
-        .description("Manage merge-safe text notes and JSON context events.")
-        .action(runNotesAction);
-    addHiddenOption(notesCommand, "--text <text>", "Alias for --add", false);
-    const learningsCommand = program
-        .command("learnings")
-        .argument("<id>", "Item id")
-        .argument("[text]", "Optional learning text shorthand for --add")
-        .option("--add <text>", "Append learning text; use text=<value> or - for stdin")
-        .option("--stdin", "Read learning text from stdin")
-        .option("--file <path>", "Read learning text from a file or stdin (-)")
-        .option("--edit <index>", "Replace one learning using positional text, --add, --stdin, or --file", parsePositiveInteger("--edit"))
-        .option("--delete <index>", "Delete the learning at 1-based <index>", parsePositiveInteger("--delete"))
-        .option("--limit <n>", "Return only latest n learnings")
-        .option("--full-history", "Return complete learning history instead of a bounded receipt")
-        .option("--if-absent", "Append only when resolved author and text are absent")
-        .option("--author [value]", "Learning author (optional; falls back to PM_AUTHOR/settings)")
-        .option("--message <value>", "History message")
-        .option("--force", "Force ownership override")
-        .description("List, add, edit, or delete learnings for an item.")
-        .action(runLearningsAction);
-    addHiddenOption(learningsCommand, "--text <text>", "Alias for --add", false);
-}
+!(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]="0b92ef55-bb44-5a94-840d-a972b90b696c")}catch(e2){}})();import{EXIT_CODE,PmCliError}from"../sdk/runtime-primitives.js";import{renderPmCommand}from"../sdk/command-line.js";import{runComments}from"./commands/comments.js";import{runLearnings}from"./commands/learnings.js";import{runNotes}from"./commands/notes.js";import{addHiddenOption,getGlobalOptions,invalidateSearchCachesForMutation,printError,printResult,readOptionString}from"./registration-helpers.js";function assertNoTransposedAnnotationAction(collection,id,text,options){if(id.trim().toLowerCase()!=="add"||!text?.trim()){return}const suppliedText=readOptionString(options,"add")??readOptionString(options,"text")??readOptionString(options,"note")??readOptionString(options,"body")??readOptionString(options,"comment");const file=readOptionString(options,"file");const retryArgs=[collection,text.trim()];if(suppliedText!==void 0)retryArgs.push("--add",suppliedText);else if(options.stdin===true)retryArgs.push("--stdin");else if(file!==void 0)retryArgs.push("--file",file);else retryArgs.push("--add","-");const suggestedRetry=renderPmCommand(retryArgs);const stdinRetry=renderPmCommand([collection,text.trim(),"--add","-"]);throw new PmCliError(`The positional token "add" was parsed as the item id, while "${text.trim()}" was parsed as annotation text. ${collection} does not use an add subcommand.`,EXIT_CODE.USAGE,{code:"annotation_transposed_subcommand",reason:"noun_verb_object_transposition",required:`Place the item id immediately after ${collection}, then use --add for annotation text.`,examples:[...new Set([suggestedRetry,stdinRetry])],recovery:{attempted_command:`pm ${collection} add ${text.trim()}`,normalized_args:[collection,"add",text.trim()],parsed_positionals:[{role:"transposed_subcommand",value:"add"},{role:"item_id",value:text.trim()}],suggested_retry:suggestedRetry}})}function resolveAnnotationTextAliases(label,options,aliases){const supplied=aliases.flatMap(alias=>{const value=readOptionString(options,alias);return value===void 0?[]:[{alias,value}]});const distinctValues=[...new Set(supplied.map(({value})=>value))];if(distinctValues.length>1){throw new PmCliError(`Specify ${label} text with one alias or the same value across aliases: ${supplied.map(({alias})=>`--${alias}`).join(", ")}`,EXIT_CODE.USAGE,{code:"annotation_alias_conflict"})}return supplied[0]?.value}function resolveCommentSources(text,options){const editIndex=typeof options.edit==="number"?options.edit:void 0;const deleteIndex=typeof options.delete==="number"?options.delete:void 0;const addFromOption=resolveAnnotationTextAliases("comment",options,["add","text","body","comment"]);const addFromPositional=typeof text==="string"?text:void 0;const readFromStdin=options.stdin===true;const readFromFile=readOptionString(options,"file");const sourceCount=Number(addFromOption!==void 0)+Number(addFromPositional!==void 0)+Number(readFromStdin)+Number(readFromFile!==void 0);if(sourceCount>1){if(addFromOption!==void 0&&addFromPositional!==void 0&&!readFromStdin&&readFromFile===void 0){throw new PmCliError("Specify comment text either as positional [text] or with --add, not both",EXIT_CODE.USAGE)}throw new PmCliError("Specify comment text with exactly one source: positional [text], --add, --stdin, or --file",EXIT_CODE.USAGE)}const add=addFromOption??addFromPositional;return{add,readFromStdin,readFromFile,editIndex,deleteIndex,isMutation:typeof add==="string"||readFromStdin||readFromFile!==void 0||editIndex!==void 0||deleteIndex!==void 0}}function resolveSingleAnnotationSources(label,positional,options){const addFromOption=resolveAnnotationTextAliases(label,options,label==="note"?["add","text","note"]:["add","text"]);const addFromPositional=typeof positional==="string"?positional:void 0;if(addFromOption!==void 0&&addFromPositional!==void 0){throw new PmCliError(`Specify ${label} text either as positional [text] or with --add, not both`,EXIT_CODE.USAGE)}const add=addFromOption??addFromPositional;const addJson=label==="note"?readOptionString(options,"addJson"):void 0;const readFromStdin=options.stdin===true;const readFromFile=readOptionString(options,"file");const editIndex=typeof options.edit==="number"?options.edit:void 0;const deleteIndex=typeof options.delete==="number"?options.delete:void 0;return{add,addJson,readFromStdin,readFromFile,editIndex,deleteIndex,isMutation:typeof add==="string"||addJson!==void 0||readFromStdin||readFromFile!==void 0||editIndex!==void 0||deleteIndex!==void 0}}async function runCommentsAction(id,text,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertNoTransposedAnnotationAction("comments",id,text,options);const sources=resolveCommentSources(text,options);const result=await runComments(id,{add:sources.add,stdin:sources.readFromStdin,file:sources.readFromFile,edit:sources.editIndex,delete:sources.deleteIndex,limit:readOptionString(options,"limit"),fullHistory:options.fullHistory===true,ifAbsent:options.ifAbsent===true,author:readOptionString(options,"author"),message:readOptionString(options,"message"),ownershipAppendBypass:options.ownershipAppendBypass===true,force:Boolean(options.force)},globalOptions);if(sources.isMutation&&result.changed!==false){await invalidateSearchCachesForMutation(globalOptions,result)}printAnnotationResult("comments",result,globalOptions,startedAt)}async function runNotesAction(id,text,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertNoTransposedAnnotationAction("notes",id,text,options);const sources=resolveSingleAnnotationSources("note",text,options);const result=await runNotes(id,{add:sources.add,addJson:sources.addJson,stdin:sources.readFromStdin,file:sources.readFromFile,edit:sources.editIndex,delete:sources.deleteIndex,limit:readOptionString(options,"limit"),since:readOptionString(options,"since"),eventType:readOptionString(options,"eventType"),includeMeta:options.includeMeta===true,fullHistory:options.fullHistory===true,ifAbsent:options.ifAbsent===true,author:readOptionString(options,"author"),message:readOptionString(options,"message"),ownershipAppendBypass:options.ownershipAppendBypass===true,force:Boolean(options.force)},globalOptions);if(sources.isMutation&&result.changed!==false){await invalidateSearchCachesForMutation(globalOptions,result)}printAnnotationResult("notes",result,globalOptions,startedAt)}async function runLearningsAction(id,text,options,command){const globalOptions=getGlobalOptions(command);const startedAt=Date.now();assertNoTransposedAnnotationAction("learnings",id,text,options);const sources=resolveSingleAnnotationSources("learning",text,options);const result=await runLearnings(id,{add:sources.add,stdin:sources.readFromStdin,file:sources.readFromFile,edit:sources.editIndex,delete:sources.deleteIndex,limit:readOptionString(options,"limit"),fullHistory:options.fullHistory===true,ifAbsent:options.ifAbsent===true,author:readOptionString(options,"author"),message:readOptionString(options,"message"),ownershipAppendBypass:options.ownershipAppendBypass===true,force:Boolean(options.force)},globalOptions);if(sources.isMutation&&result.changed!==false){await invalidateSearchCachesForMutation(globalOptions,result)}printAnnotationResult("learnings",result,globalOptions,startedAt)}function printAnnotationResult(command,result,globalOptions,startedAt){printResult(result,globalOptions);if(globalOptions.profile){printError(`profile:command=${command} took_ms=${Date.now()-startedAt}`)}}function registerAnnotationCommands(program,parsePositiveInteger){const commentsCommand=program.command("comments").argument("<id>","Item id").argument("[text]","Optional comment text shorthand (equivalent to --add)").option("--add <text>","Append comment text; use text=<value> for structured input or - for stdin").option("--stdin","Read comment text from stdin (supports multiline markdown)").option("--file <path>","Read comment text from a file or stdin (-)").option("--edit <index>","Replace one comment using positional text, --add, --stdin, or --file",parsePositiveInteger("--edit")).option("--delete <index>","Delete the comment at 1-based <index>",parsePositiveInteger("--delete")).option("--limit <n>","Return only latest n comments").option("--full-history","Return complete comment history instead of a bounded mutation receipt").option("--if-absent","Append only when resolved author and text are absent").option("--author [value]","Comment author; defaults to PM_AUTHOR or settings").option("--message <value>","History message").option("--force","Force ownership override").description("List, add, edit, or delete comments for an item.").action(runCommentsAction);addHiddenOption(commentsCommand,"--body <text>","Alias for --add",false);addHiddenOption(commentsCommand,"--text <text>","Alias for --add",false);addHiddenOption(commentsCommand,"--comment <text>","Alias for --add",false);const notesCommand=program.command("notes").argument("<id>","Item id").argument("[text]","Optional note text shorthand for --add").option("--add <text>","Add a text note (- reads stdin)").option("--note <text>","Alias for --add").option("--add-json <json>","Append a JSON event").option("--stdin","Read note text from stdin").option("--file <path>","Read note from file or stdin (-)").option("--edit <index>","Replace a 1-based note using the selected text input",parsePositiveInteger("--edit")).option("--delete <index>","Delete the note at 1-based <index>",parsePositiveInteger("--delete")).option("--limit <n>","Return only latest n notes").option("--since <timestamp>","Filter JSON events from this ISO time").option("--event-type <value>","Filter JSON events by top-level type").option("--include-meta","Include count and truncation metadata").option("--full-history","Return complete note history instead of a bounded receipt").option("--if-absent","Append only when resolved author and text are absent").option("--author [value]","Author; defaults to PM_AUTHOR/settings").option("--message <value>","History message").option("--force","Force ownership override").description("Manage merge-safe text notes and JSON context events.").action(runNotesAction);addHiddenOption(notesCommand,"--text <text>","Alias for --add",false);const learningsCommand=program.command("learnings").argument("<id>","Item id").argument("[text]","Optional learning text shorthand for --add").option("--add <text>","Append learning text; use text=<value> or - for stdin").option("--stdin","Read learning text from stdin").option("--file <path>","Read learning text from a file or stdin (-)").option("--edit <index>","Replace one learning using positional text, --add, --stdin, or --file",parsePositiveInteger("--edit")).option("--delete <index>","Delete the learning at 1-based <index>",parsePositiveInteger("--delete")).option("--limit <n>","Return only latest n learnings").option("--full-history","Return complete learning history instead of a bounded receipt").option("--if-absent","Append only when resolved author and text are absent").option("--author [value]","Learning author (optional; falls back to PM_AUTHOR/settings)").option("--message <value>","History message").option("--force","Force ownership override").description("List, add, edit, or delete learnings for an item.").action(runLearningsAction);addHiddenOption(learningsCommand,"--text <text>","Alias for --add",false)}export{registerAnnotationCommands};
 //# sourceMappingURL=register-annotations.js.map
-//# debugId=775518a4-ff3e-5a54-8fbd-b2c4863e23db