@unbrained/pm-cli 2026.9.7 → 2026.9.8

package/dist/sdk/notes.js

@@ -1,140 +1,2 @@
-/**
- * @module cli/commands/notes
- *
- * Implements the pm notes 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]="216389a2-fb85-56a0-8ef2-9f41f1321c16")}catch(e){}}();
-import { EXIT_CODE, PmCliError, parseLimit, stableStringify, } from "./runtime-primitives.js";
-import { limitAnnotationEntries, parseAnnotationTextInput, resolveAnnotationInput, runAnnotationCommand, } from "./annotations.js";
-function parseStructuredEventPayload(raw) {
-    if (raw === undefined)
-        return undefined;
-    if (raw.trim().length === 0) {
-        throw new PmCliError("--add-json must contain a JSON value", EXIT_CODE.USAGE, { code: "structured_event_json_empty" });
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        throw new PmCliError("--add-json must be valid JSON", EXIT_CODE.USAGE, {
-            code: "structured_event_json_invalid",
-        });
-    }
-    return parsed;
-}
-function structuredEventType(value) {
-    if (typeof value !== "object" || value === null || Array.isArray(value)) {
-        return undefined;
-    }
-    const candidate = value.type;
-    return typeof candidate === "string" && candidate.trim().length > 0
-        ? candidate.trim()
-        : undefined;
-}
-function parseSinceTimestamp(value) {
-    if (value === undefined)
-        return undefined;
-    const timestamp = Date.parse(value);
-    if (!Number.isFinite(timestamp)) {
-        throw new PmCliError("--since must be a valid ISO timestamp", EXIT_CODE.USAGE, { code: "structured_event_since_invalid" });
-    }
-    return timestamp;
-}
-/** Implements run notes for the public runtime surface of this module. */
-export async function runNotes(id, options, global) {
-    const structuredPayload = parseStructuredEventPayload(options.addJson);
-    const conflictingStructuredInputs = [
-        options.add !== undefined,
-        options.stdin === true,
-        options.file !== undefined,
-        options.edit !== undefined,
-        options.delete !== undefined,
-    ].includes(true);
-    if (structuredPayload !== undefined && conflictingStructuredInputs) {
-        throw new PmCliError("--add-json cannot be combined with text, edit, delete, stdin, or file inputs", EXIT_CODE.USAGE, { code: "structured_event_input_conflict" });
-    }
-    const canonicalJson = structuredPayload === undefined
-        ? undefined
-        : stableStringify(structuredPayload);
-    const filteringEvents = [options.since, options.eventType].some((value) => value !== undefined);
-    const sinceTimestamp = parseSinceTimestamp(options.since);
-    const limit = parseLimit(options.limit);
-    const result = await runAnnotationCommand(id, {
-        ...options,
-        ...(filteringEvents ? { limit: undefined } : {}),
-        includeMeta: [options.includeMeta === true, filteringEvents].includes(true),
-    }, global, {
-        input: await resolveAnnotationInput(canonicalJson === undefined ? options : { add: canonicalJson }, "note"),
-        collectionKey: "notes",
-        op: "note_add",
-        editOp: "note_edit",
-        deleteOp: "note_delete",
-        parseText: (raw) => parseAnnotationTextInput(raw),
-        createEntry: (entry) => structuredPayload === undefined
-            ? entry
-            : {
-                ...entry,
-                format: "json",
-                data: structuredPayload,
-                event_type: structuredEventType(structuredPayload),
-            },
-        bypassOwnershipConflict: Boolean([
-            options.edit === undefined,
-            options.delete === undefined,
-            options.ownershipAppendBypass === true,
-        ].every(Boolean)),
-        conflictGuidance: {
-            required: "For an approved append-only handoff on another owner's item, use the package-provided ownership bypass before considering --force.",
-            examples: [
-                'pm notes pm-a1b2 --add "review note" --author "reviewer" --force',
-            ],
-            nextSteps: [
-                "Use an installed package's narrow append-only ownership bypass when available.",
-                "Use --force only when an ownership override is explicitly approved.",
-            ],
-        },
-    });
-    const eventType = options.eventType?.trim();
-    const matching = result.notes.filter((note) => {
-        const isStructured = [
-            note.format === "json",
-            note.data !== undefined,
-        ].every(Boolean);
-        const matchesSince = [
-            sinceTimestamp === undefined,
-            Date.parse(note.created_at) >=
-                (sinceTimestamp ?? Number.POSITIVE_INFINITY),
-        ].includes(true);
-        const matchesType = [!eventType, note.event_type === eventType].includes(true);
-        return [
-            !filteringEvents,
-            [isStructured, matchesSince, matchesType].every(Boolean),
-        ].includes(true);
-    });
-    const filtered = filteringEvents
-        ? limitAnnotationEntries(matching, limit)
-        : matching;
-    const structuredEventCount = filtered.filter((note) => note.format === "json").length;
-    return {
-        ...result,
-        notes: filtered,
-        count: filtered.length,
-        ...(filteringEvents
-            ? {
-                total_count: matching.length,
-                returned_count: filtered.length,
-                has_more: filtered.length < matching.length,
-                ...(limit === undefined ? {} : { limit }),
-                structured_event_count: structuredEventCount,
-            }
-            : options.includeMeta === true
-                ? {
-                    structured_event_count: structuredEventCount,
-                }
-                : {}),
-    };
-}
+!(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]="eab6a65d-8f97-593e-8609-6ae452b1c5aa")}catch(e2){}})();import{EXIT_CODE,PmCliError,parseLimit,stableStringify}from"./runtime-primitives.js";import{limitAnnotationEntries,parseAnnotationTextInput,resolveAnnotationInput,runAnnotationCommand}from"./annotations.js";function parseStructuredEventPayload(raw){if(raw===void 0)return void 0;if(raw.trim().length===0){throw new PmCliError("--add-json must contain a JSON value",EXIT_CODE.USAGE,{code:"structured_event_json_empty"})}let parsed;try{parsed=JSON.parse(raw)}catch{throw new PmCliError("--add-json must be valid JSON",EXIT_CODE.USAGE,{code:"structured_event_json_invalid"})}return parsed}function structuredEventType(value){if(typeof value!=="object"||value===null||Array.isArray(value)){return void 0}const candidate=value.type;return typeof candidate==="string"&&candidate.trim().length>0?candidate.trim():void 0}function parseSinceTimestamp(value){if(value===void 0)return void 0;const timestamp=Date.parse(value);if(!Number.isFinite(timestamp)){throw new PmCliError("--since must be a valid ISO timestamp",EXIT_CODE.USAGE,{code:"structured_event_since_invalid"})}return timestamp}async function runNotes(id,options,global2){const structuredPayload=parseStructuredEventPayload(options.addJson);const conflictingStructuredInputs=[options.add!==void 0,options.stdin===true,options.file!==void 0,options.edit!==void 0,options.delete!==void 0].includes(true);if(structuredPayload!==void 0&&conflictingStructuredInputs){throw new PmCliError("--add-json cannot be combined with text, edit, delete, stdin, or file inputs",EXIT_CODE.USAGE,{code:"structured_event_input_conflict"})}const canonicalJson=structuredPayload===void 0?void 0:stableStringify(structuredPayload);const filteringEvents=[options.since,options.eventType].some(value=>value!==void 0);const sinceTimestamp=parseSinceTimestamp(options.since);const limit=parseLimit(options.limit);const result=await runAnnotationCommand(id,{...options,...filteringEvents?{limit:void 0}:{},includeMeta:[options.includeMeta===true,filteringEvents].includes(true)},global2,{input:await resolveAnnotationInput(canonicalJson===void 0?options:{add:canonicalJson},"note"),collectionKey:"notes",op:"note_add",editOp:"note_edit",deleteOp:"note_delete",parseText:raw=>parseAnnotationTextInput(raw),createEntry:entry=>structuredPayload===void 0?entry:{...entry,format:"json",data:structuredPayload,event_type:structuredEventType(structuredPayload)},bypassOwnershipConflict:Boolean([options.edit===void 0,options.delete===void 0,options.ownershipAppendBypass===true].every(Boolean)),conflictGuidance:{required:"For an approved append-only handoff on another owner's item, use the package-provided ownership bypass before considering --force.",examples:['pm notes pm-a1b2 --add "review note" --author "reviewer" --force'],nextSteps:["Use an installed package's narrow append-only ownership bypass when available.","Use --force only when an ownership override is explicitly approved."]}});const eventType=options.eventType?.trim();const matching=result.notes.filter(note=>{const isStructured=[note.format==="json",note.data!==void 0].every(Boolean);const matchesSince=[sinceTimestamp===void 0,Date.parse(note.created_at)>=(sinceTimestamp??Number.POSITIVE_INFINITY)].includes(true);const matchesType=[!eventType,note.event_type===eventType].includes(true);return[!filteringEvents,[isStructured,matchesSince,matchesType].every(Boolean)].includes(true)});const filtered=filteringEvents?limitAnnotationEntries(matching,limit):matching;const structuredEventCount=filtered.filter(note=>note.format==="json").length;return{...result,notes:filtered,count:filtered.length,...filteringEvents?{total_count:matching.length,returned_count:filtered.length,has_more:filtered.length<matching.length,...limit===void 0?{}:{limit},structured_event_count:structuredEventCount}:options.includeMeta===true?{structured_event_count:structuredEventCount}:{}}}export{runNotes};
 //# sourceMappingURL=notes.js.map
-//# debugId=216389a2-fb85-56a0-8ef2-9f41f1321c16

package/dist/sdk/output-contracts.js

@@ -1,173 +1,2 @@
-/**
- * @module sdk/output-contracts
- *
- * Defines portable result-envelope contracts and safe mutation receipt parsing
- * for CLI, SDK, MCP, and 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]="af86d275-63a8-5205-a8b3-154efdbd8e2a")}catch(e){}}();
-import { PM_CORE_COMMAND_NAMES } from "./cli-contracts/enum-contracts.js";
-/** Stable machine-readable result families used across pm transports. */
-export const PM_OUTPUT_ENVELOPE_KINDS = [
-    "mutation_receipt",
-    "entity",
-    "collection",
-    "diagnostic",
-    "stream",
-];
-const MUTATION_COMMANDS = new Set([
-    "append",
-    "claim",
-    "close",
-    "close-task",
-    "copy",
-    "create",
-    "delete",
-    "focus",
-    "pause-task",
-    "release",
-    "restore",
-    "start-task",
-    "update",
-]);
-const COLLECTION_MUTATION_COMMANDS = new Set(["close-many", "update-many"]);
-const COLLECTION_COMMANDS = new Set([
-    "activity",
-    "comments",
-    "contracts",
-    "events",
-    "history",
-    "learnings",
-    "list",
-    "notes",
-    "search",
-]);
-const DIAGNOSTIC_COMMANDS = new Set([
-    "aggregate",
-    "deps",
-    "graph",
-    "health",
-    "stats",
-    "validate",
-]);
-/** Validate and preserve one package-authored output-envelope declaration. */
-export function definePmCommandOutputEnvelope(contract) {
-    if (contract.command.trim().length === 0) {
-        throw new TypeError("command must be a non-empty command path");
-    }
-    if (!PM_OUTPUT_ENVELOPE_KINDS.includes(contract.kind)) {
-        throw new TypeError(`Unsupported output envelope kind: ${contract.kind}`);
-    }
-    return contract;
-}
-function createOutputEnvelopeContract(command) {
-    const normalizedCommand = command.trim().replace(/\s+/gu, " ");
-    const [rootCommand = normalizedCommand] = normalizedCommand.split(" ");
-    if (COLLECTION_MUTATION_COMMANDS.has(rootCommand)) {
-        return definePmCommandOutputEnvelope({
-            command: normalizedCommand,
-            kind: "collection",
-            wrapper_key: "rows",
-            cardinality: "many",
-            format_flag: "--json",
-        });
-    }
-    if (MUTATION_COMMANDS.has(rootCommand)) {
-        return definePmCommandOutputEnvelope({
-            command: normalizedCommand,
-            kind: "mutation_receipt",
-            wrapper_key: null,
-            cardinality: "one",
-            format_flag: "--json",
-        });
-    }
-    if (COLLECTION_COMMANDS.has(rootCommand)) {
-        return definePmCommandOutputEnvelope({
-            command: normalizedCommand,
-            kind: "collection",
-            wrapper_key: rootCommand === "contracts" ? null : "items",
-            cardinality: "many",
-            format_flag: "--json",
-        });
-    }
-    if (DIAGNOSTIC_COMMANDS.has(rootCommand)) {
-        return definePmCommandOutputEnvelope({
-            command: normalizedCommand,
-            kind: "diagnostic",
-            wrapper_key: null,
-            cardinality: "none",
-            format_flag: "--json",
-        });
-    }
-    return definePmCommandOutputEnvelope({
-        command: normalizedCommand,
-        kind: rootCommand === "get" ? "entity" : "diagnostic",
-        wrapper_key: rootCommand === "get" ? "item" : null,
-        cardinality: rootCommand === "get" ? "one" : "none",
-        format_flag: "--json",
-    });
-}
-/** Default envelope declaration for every built-in command. */
-export const PM_COMMAND_OUTPUT_ENVELOPE_CONTRACTS = PM_CORE_COMMAND_NAMES.map((command) => createOutputEnvelopeContract(command));
-const OUTPUT_ENVELOPE_BY_COMMAND = new Map(PM_COMMAND_OUTPUT_ENVELOPE_CONTRACTS.map((contract) => [contract.command, contract]));
-/** Resolve a built-in envelope or generate a conservative package fallback. */
-export function resolvePmCommandOutputEnvelope(command) {
-    const normalized = command.trim().replace(/\s+/gu, " ");
-    if (normalized.length === 0) {
-        throw new TypeError("command must be a non-empty command path");
-    }
-    const [rootCommand = normalized] = normalized.split(" ");
-    const declared = OUTPUT_ENVELOPE_BY_COMMAND.get(rootCommand);
-    return declared
-        ? { ...declared, command: normalized }
-        : createOutputEnvelopeContract(normalized);
-}
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-/** Return whether an unknown value is the flat CLI mutation receipt shape. */
-export function isPmMutationReceipt(value) {
-    return (isRecord(value) &&
-        typeof value.id === "string" &&
-        value.id.length > 0 &&
-        typeof value.status === "string" &&
-        value.status.length > 0 &&
-        Number.isSafeInteger(value.changed_field_count) &&
-        Number(value.changed_field_count) >= 0 &&
-        (value.close_reason === undefined ||
-            typeof value.close_reason === "string") &&
-        (value.deleted === undefined || typeof value.deleted === "boolean") &&
-        (value.previous_status === undefined ||
-            typeof value.previous_status === "string") &&
-        (value.warnings === undefined || Array.isArray(value.warnings)));
-}
-/** Implement string parsing and decoded-value validation at one boundary. */
-export function parseMutationReceipt(input) {
-    let value = input;
-    if (typeof input === "string") {
-        try {
-            value = JSON.parse(input);
-        }
-        catch (error) {
-            throw new TypeError(`Mutation receipt must be valid JSON: ${String(error)}`, { cause: error });
-        }
-    }
-    if (!isPmMutationReceipt(value)) {
-        throw new TypeError("Mutation receipt must be a flat object with top-level id, status, and changed_field_count fields");
-    }
-    return {
-        id: value.id,
-        status: value.status,
-        changedFieldCount: value.changed_field_count,
-        ...(typeof value.close_reason === "string"
-            ? { closeReason: value.close_reason }
-            : {}),
-        ...(typeof value.deleted === "boolean" ? { deleted: value.deleted } : {}),
-        ...(typeof value.previous_status === "string"
-            ? { previousStatus: value.previous_status }
-            : {}),
-        ...(Array.isArray(value.warnings) ? { warnings: value.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]="49e76519-d1f8-58ef-818f-927c563aa006")}catch(e2){}})();import{resolvePmHistoryOperation}from"./cli-contracts/command-aliases.js";import{PM_CORE_COMMAND_NAMES}from"./cli-contracts/enum-contracts.js";const PM_OUTPUT_ENVELOPE_KINDS=["mutation_receipt","entity","collection","diagnostic","stream"];const MUTATION_COMMANDS=new Set(["append","claim","close","close-task","copy","create","delete","focus","pause-task","release","restore","start-task","update"]);const COLLECTION_MUTATION_COMMANDS=new Set(["close-many","update-many"]);const COLLECTION_COMMANDS=new Set(["activity","comments","contracts","events","history","learnings","list","notes","search"]);const DIAGNOSTIC_COMMANDS=new Set(["aggregate","deps","graph","health","history-redact","history-repair","history-compact","stats","validate"]);function definePmCommandOutputEnvelope(contract){if(contract.command.trim().length===0){throw new TypeError("command must be a non-empty command path")}if(!PM_OUTPUT_ENVELOPE_KINDS.includes(contract.kind)){throw new TypeError(`Unsupported output envelope kind: ${contract.kind}`)}return contract}function createOutputEnvelopeContract(command){const normalizedCommand=command.trim().replace(/\s+/gu," ");const[rootCommand=normalizedCommand]=normalizedCommand.split(" ");if(COLLECTION_MUTATION_COMMANDS.has(rootCommand)){return definePmCommandOutputEnvelope({command:normalizedCommand,kind:"collection",wrapper_key:"rows",cardinality:"many",format_flag:"--json"})}if(MUTATION_COMMANDS.has(rootCommand)){return definePmCommandOutputEnvelope({command:normalizedCommand,kind:"mutation_receipt",wrapper_key:null,cardinality:"one",format_flag:"--json"})}if(COLLECTION_COMMANDS.has(rootCommand)){return definePmCommandOutputEnvelope({command:normalizedCommand,kind:"collection",wrapper_key:rootCommand==="contracts"?null:"items",cardinality:"many",format_flag:"--json"})}if(DIAGNOSTIC_COMMANDS.has(rootCommand)){return definePmCommandOutputEnvelope({command:normalizedCommand,kind:"diagnostic",wrapper_key:null,cardinality:"none",format_flag:"--json"})}return definePmCommandOutputEnvelope({command:normalizedCommand,kind:rootCommand==="get"?"entity":"diagnostic",wrapper_key:rootCommand==="get"?"item":null,cardinality:rootCommand==="get"?"one":"none",format_flag:"--json"})}const PM_COMMAND_OUTPUT_ENVELOPE_CONTRACTS=PM_CORE_COMMAND_NAMES.map(command=>createOutputEnvelopeContract(command));const OUTPUT_ENVELOPE_BY_COMMAND=new Map(PM_COMMAND_OUTPUT_ENVELOPE_CONTRACTS.map(contract=>[contract.command,contract]));function resolvePmCommandOutputEnvelope(command){const normalized=command.trim().replace(/\s+/gu," ");if(normalized.length===0){throw new TypeError("command must be a non-empty command path")}const[rootCommand=normalized]=resolvePmHistoryOperation(normalized).split(" ");const declared=OUTPUT_ENVELOPE_BY_COMMAND.get(rootCommand);return declared?{...declared,command:normalized}:createOutputEnvelopeContract(normalized)}function isRecord(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)}function isPmMutationReceipt(value){return isRecord(value)&&typeof value.id==="string"&&value.id.length>0&&typeof value.status==="string"&&value.status.length>0&&Number.isSafeInteger(value.changed_field_count)&&Number(value.changed_field_count)>=0&&(value.close_reason===void 0||typeof value.close_reason==="string")&&(value.deleted===void 0||typeof value.deleted==="boolean")&&(value.previous_status===void 0||typeof value.previous_status==="string")&&(value.warnings===void 0||Array.isArray(value.warnings))}function parseMutationReceipt(input){let value=input;if(typeof input==="string"){try{value=JSON.parse(input)}catch(error){throw new TypeError(`Mutation receipt must be valid JSON: ${String(error)}`,{cause:error})}}if(!isPmMutationReceipt(value)){throw new TypeError("Mutation receipt must be a flat object with top-level id, status, and changed_field_count fields")}return{id:value.id,status:value.status,changedFieldCount:value.changed_field_count,...typeof value.close_reason==="string"?{closeReason:value.close_reason}:{},...typeof value.deleted==="boolean"?{deleted:value.deleted}:{},...typeof value.previous_status==="string"?{previousStatus:value.previous_status}:{},...Array.isArray(value.warnings)?{warnings:value.warnings}:{}}}export{PM_COMMAND_OUTPUT_ENVELOPE_CONTRACTS,PM_OUTPUT_ENVELOPE_KINDS,definePmCommandOutputEnvelope,isPmMutationReceipt,parseMutationReceipt,resolvePmCommandOutputEnvelope};
 //# sourceMappingURL=output-contracts.js.map
-//# debugId=af86d275-63a8-5205-a8b3-154efdbd8e2a