@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/core/item/parse.js

@@ -1,604 +1,3 @@
-/**
- * @module core/item/parse
- *
- * Defines item parsing, formatting, and lifecycle helpers for Parse.
- */
-
-!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]="80965b57-856c-5fef-a372-0c9f3766ada5")}catch(e){}}();
-import { PmCliError } from "../shared/errors.js";
-import { EXIT_CODE } from "../shared/constants.js";
-const STDIN_TOKEN = "-";
-const CONTINUABLE_VALUE_KEYS = new Set([
-    "actual_result",
-    "body",
-    "cmd",
-    "command",
-    "customer_impact",
-    "description",
-    "environment",
-    "expected_result",
-    "impact",
-    "location",
-    "message",
-    "note",
-    "outcome",
-    "repro_steps",
-    "resolution",
-    "text",
-    "title",
-    "unblock_note",
-    "value",
-    "why_now",
-]);
-/** Classify plaintext as structured key/value input using an explicit accepted-key vocabulary. */
-export function looksLikeStructuredKeyValueEntry(raw, keys) {
-    if (raw.startsWith("```") || raw.includes("\n")) {
-        return true;
-    }
-    const keyPattern = keys
-        .map((key) => key.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"))
-        .join("|");
-    return new RegExp(`^(?:[-*+]\\s+)?(?:${keyPattern})\\s*[:=]`, "i").test(raw);
-}
-/** Implements parse tags for the public runtime surface of this module. */
-export function parseTags(raw) {
-    const trimmed = raw.trim();
-    if (trimmed === "") {
-        return [];
-    }
-    const source = coerceJsonTagArray(trimmed) ?? trimmed.split(",");
-    const tags = source
-        .map((tag) => tag.trim())
-        .filter(Boolean)
-        .map((tag) => tag.toLowerCase());
-    return Array.from(new Set(tags)).sort((a, b) => a.localeCompare(b));
-}
-/** Merge repeated `--add-tags` / `--remove-tags` values into a single normalized tag list. Each entry can itself be CSV or a JSON array, mirroring the format accepted by `--tags`. Returns a deterministically sorted, deduped list. */
-export function collectTagFlagValues(values) {
-    if (!Array.isArray(values) || values.length === 0) {
-        return [];
-    }
-    const collected = [];
-    for (const raw of values) {
-        if (typeof raw !== "string") {
-            continue;
-        }
-        for (const tag of parseTags(raw)) {
-            collected.push(tag);
-        }
-    }
-    return Array.from(new Set(collected)).sort((a, b) => a.localeCompare(b));
-}
-/** Normalize a base tag list to the canonical form pm stores: trimmed, lowercased, non-empty. Existing item-metadata tags are almost always already canonical (parseTags lowercases on write), but legacy or hand-edited `.toon` files can carry mixed-case entries — normalizing here keeps additive and subtractive mutations case-insensitive (so `--add-tags beta` dedupes against an existing `Beta`, and `--remove-tags alpha` removes an existing `Alpha`). */
-function normalizeBaseTags(baseTags) {
-    // Defensive: item-metadata parsed from corrupted/hand-edited `.toon` (or an
-    // external SDK caller) could pass a non-array or non-string entries despite
-    // the `string[]` type — guard the array and skip non-strings rather than
-    // throwing on `.filter`/`.trim()`.
-    if (!Array.isArray(baseTags)) {
-        return [];
-    }
-    return baseTags
-        .filter((tag) => typeof tag === "string")
-        .map((tag) => tag.trim().toLowerCase())
-        .filter(Boolean);
-}
-/** Split a stored `acceptance_criteria` value into its individual criteria. Criteria are stored as one string joined with `"; "` (repeated `--ac` values accumulate that way), so the semicolon is the criterion boundary and cannot appear inside one criterion; entries are trimmed and blanks dropped. Non-string/absent values yield an empty list. */
-export function splitAcceptanceCriteria(value) {
-    if (typeof value !== "string") {
-        return [];
-    }
-    return value
-        .split(";")
-        .map((criterion) => criterion.trim())
-        .filter(Boolean);
-}
-/** Apply additive/subtractive acceptance-criteria mutations to a base criteria list. Used by `pm update --add-ac/--remove-ac` so individual semicolon-free criteria can be edited without replacing the whole `acceptance_criteria` value (tag-API parity; disjoint additions merge cleanly across branches). Additions append in argv order and dedupe on exact trimmed text; removals match exact trimmed text and report unmatched selectors so a typo never becomes a silent no-op. */
-export function applyAcceptanceCriteriaMutations(baseCriteria, add, remove) {
-    const criteria = baseCriteria
-        .map((criterion) => criterion.trim())
-        .filter(Boolean);
-    for (const raw of add ?? []) {
-        const criterion = raw.trim();
-        if (criterion.includes(";")) {
-            throw new PmCliError('Acceptance criteria added with --add-ac cannot contain ";" because semicolons delimit stored criteria', EXIT_CODE.USAGE, {
-                code: "acceptance_criteria_semicolon_forbidden",
-                required: "Pass one semicolon-free criterion per --add-ac value",
-                why: "A semicolon inside one criterion would be re-read as multiple criteria",
-                nextSteps: [
-                    "Split the text into repeated --add-ac values, or replace the semicolon with punctuation that is not the storage delimiter",
-                ],
-            });
-        }
-        if (criterion.length > 0 && !criteria.includes(criterion)) {
-            criteria.push(criterion);
-        }
-    }
-    const unmatchedRemovals = [];
-    let remaining = criteria;
-    for (const raw of remove ?? []) {
-        const criterion = raw.trim();
-        if (criterion.length === 0) {
-            continue;
-        }
-        if (!remaining.includes(criterion)) {
-            unmatchedRemovals.push(criterion);
-            continue;
-        }
-        remaining = remaining.filter((entry) => entry !== criterion);
-    }
-    return { criteria: remaining, unmatchedRemovals };
-}
-/** Apply an additive tag mutation to a base tag list. Used by `pm create` and `pm update` so `--add-tags` extends `--tags` (or the existing tags) without replacing them. Output is sorted + deduped lowercase, matching `parseTags`. */
-export function mergeAdditiveTags(baseTags, add) {
-    const normalizedBase = normalizeBaseTags(baseTags);
-    if (!add || add.length === 0) {
-        return Array.from(new Set(normalizedBase)).sort((a, b) => a.localeCompare(b));
-    }
-    const merged = new Set(normalizedBase);
-    for (const tag of collectTagFlagValues(add)) {
-        merged.add(tag);
-    }
-    return Array.from(merged).sort((a, b) => a.localeCompare(b));
-}
-/** Apply a subtractive tag mutation to a base tag list. Used by `pm update` so `--remove-tags x,y` prunes those entries without rewriting the full set. Removal is case-insensitive: both the base list and the removal selectors are normalized to canonical lowercase before matching. */
-export function applyTagRemovals(baseTags, remove) {
-    const normalizedBase = Array.from(new Set(normalizeBaseTags(baseTags))).sort((a, b) => a.localeCompare(b));
-    if (!remove || remove.length === 0) {
-        return normalizedBase;
-    }
-    const removeSet = new Set(collectTagFlagValues(remove));
-    if (removeSet.size === 0) {
-        return normalizedBase;
-    }
-    return normalizedBase.filter((tag) => !removeSet.has(tag));
-}
-// Agents and MCP callers frequently pass --tags as a JSON array (e.g.
-// `--tags '["a","b"]'`). The MCP server normalizes that upstream, but direct
-// CLI invocations used to write the raw bracket string into item metadata,
-// silently corrupting tags. Accept JSON arrays of primitives transparently.
-function coerceJsonTagArray(trimmed) {
-    if (!trimmed.startsWith("[")) {
-        return null;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(trimmed);
-    }
-    catch {
-        return null;
-    }
-    const parsedArray = parsed;
-    return parsedArray
-        .map((entry) => typeof entry === "string" ||
-        typeof entry === "number" ||
-        typeof entry === "boolean"
-        ? String(entry)
-        : "")
-        .filter((entry) => entry.length > 0);
-}
-function normalizeLineEndings(value) {
-    return value.replace(/\r\n/g, "\n");
-}
-function stripCodeFenceEnvelope(value) {
-    const normalized = normalizeLineEndings(value).trim();
-    if (!normalized.startsWith("```")) {
-        return value;
-    }
-    const lines = normalized.split("\n");
-    if (lines.length < 2) {
-        return value;
-    }
-    if (lines.at(-1)?.trim() !== "```") {
-        return value;
-    }
-    return lines.slice(1, -1).join("\n");
-}
-function splitCsvSegments(raw) {
-    const segments = [];
-    let current = "";
-    let inQuotes = false;
-    for (let index = 0; index < raw.length; index += 1) {
-        const char = raw[index];
-        if (char === "\\" && raw[index + 1] === ",") {
-            current += ",";
-            index += 1;
-            continue;
-        }
-        if (char === "\\" && raw[index + 1] !== undefined) {
-            current += `${char}${raw[index + 1]}`;
-            index += 1;
-            continue;
-        }
-        if (char === '"') {
-            inQuotes = !inQuotes;
-            current += char;
-            continue;
-        }
-        if (char === "," && !inQuotes) {
-            segments.push(current);
-            current = "";
-            continue;
-        }
-        current += char;
-    }
-    if (current.trim()) {
-        segments.push(current);
-    }
-    return segments;
-}
-function unquoteValue(value) {
-    const trimmed = value.trim();
-    if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
-        try {
-            const parsed = JSON.parse(trimmed);
-            if (typeof parsed === "string")
-                return parsed;
-        }
-        catch {
-            // Preserve the legacy permissive quoted-value parser for non-JSON input.
-        }
-        return trimmed.slice(1, -1).replace(/\\"/g, '"');
-    }
-    return value;
-}
-function findKeyValueDelimiter(segment) {
-    const equalsIndex = segment.indexOf("=");
-    const colonIndex = segment.indexOf(":");
-    const hasEquals = equalsIndex >= 0;
-    const hasColon = colonIndex >= 0;
-    if (hasEquals && hasColon) {
-        return Math.min(equalsIndex, colonIndex);
-    }
-    if (hasEquals) {
-        return equalsIndex;
-    }
-    if (hasColon) {
-        return colonIndex;
-    }
-    return -1;
-}
-function buildOptionSpecificKvGuidance(raw, optionName) {
-    if (optionName === "--add" || optionName === "--add-glob") {
-        const looksLikePath = /[./\\]/.test(raw) || /\.[a-z]{1,6}$/i.test(raw.trim());
-        if (looksLikePath) {
-            return "For file/doc paths use: path=<file-path>[,scope=project|global]. The scope field is optional and defaults to project (example: path=src/api.ts or path=README.md,scope=project). ";
-        }
-    }
-    if (optionName !== "--event") {
-        return "";
-    }
-    const lowered = raw.toLowerCase();
-    const recurrenceHint = lowered.includes("recur_") || lowered.includes("recurrence")
-        ? ' Recurrence list values must stay in one field and use "|" delimiters (for example recur_by_weekday=mon|wed or recur_by_month_day=1|15).'
-        : "";
-    const weekdayAliasHint = lowered.includes("recur_byweekday")
-        ? " Use recur_by_weekday (with underscores) for weekday recurrence filters."
-        : "";
-    return `${recurrenceHint}${weekdayAliasHint}`;
-}
-function buildInvalidKvMessage(raw, optionName) {
-    const condensed = raw.replaceAll(/\s+/g, " ").trim();
-    const preview = condensed.length > 160 ? `${condensed.slice(0, 157)}...` : condensed;
-    const optionSpecificGuidance = buildOptionSpecificKvGuidance(raw, optionName);
-    return (`Invalid ${optionName} value "${preview}". Expected key=value entries separated by commas. ` +
-        optionSpecificGuidance +
-        'Also accepts markdown-style key/value lines (for example "- path: README.md"). ' +
-        `Use ${optionName} ${STDIN_TOKEN} to read piped stdin input.`);
-}
-function parseMarkdownKeyValueLines(raw) {
-    const normalized = stripCodeFenceEnvelope(raw).trim();
-    if (normalized.length === 0) {
-        return null;
-    }
-    if (!normalized.includes("\n") &&
-        !normalized.startsWith("-") &&
-        !normalized.startsWith("*") &&
-        !normalized.startsWith("+")) {
-        return null;
-    }
-    const result = {};
-    let activeKey;
-    const lines = normalizeLineEndings(normalized)
-        .split("\n")
-        .map((line) => line.trim())
-        .filter((line) => line.length > 0);
-    for (const line of lines) {
-        const match = line.match(/^(?:[-*+]\s+)?([a-zA-Z0-9_.-]+)\s*(=|:)\s*(.*)$/);
-        if (match) {
-            const key = match[1].trim();
-            result[key] = unquoteValue(match[3].trim());
-            activeKey = key;
-            continue;
-        }
-        if (activeKey && CONTINUABLE_VALUE_KEYS.has(activeKey.toLowerCase())) {
-            result[activeKey] = `${result[activeKey]}\n${line}`;
-            continue;
-        }
-        return null;
-    }
-    return result;
-}
-/** Implements parse csv kv for the public runtime surface of this module. */
-export function parseCsvKv(raw, optionName) {
-    const trimmed = stripCodeFenceEnvelope(raw).trim();
-    if (!trimmed) {
-        throw new PmCliError(`${optionName} cannot be empty`, EXIT_CODE.USAGE);
-    }
-    const markdownStyle = parseMarkdownKeyValueLines(trimmed);
-    if (markdownStyle) {
-        return markdownStyle;
-    }
-    const result = {};
-    let activeKey;
-    const segments = splitCsvSegments(trimmed);
-    for (const segment of segments) {
-        const delimiterIndex = findKeyValueDelimiter(segment);
-        if (delimiterIndex >= 0) {
-            const key = segment.slice(0, delimiterIndex).trim();
-            if (!key) {
-                throw new PmCliError(buildInvalidKvMessage(raw, optionName), EXIT_CODE.USAGE);
-            }
-            const value = unquoteValue(segment.slice(delimiterIndex + 1).trim());
-            result[key] = value;
-            activeKey = key;
-            continue;
-        }
-        if (activeKey && CONTINUABLE_VALUE_KEYS.has(activeKey.toLowerCase())) {
-            result[activeKey] = `${result[activeKey]},${segment}`;
-            continue;
-        }
-        throw new PmCliError(buildInvalidKvMessage(raw, optionName), EXIT_CODE.USAGE);
-    }
-    return result;
-}
-const WINDOWS_ABSOLUTE_PATH_PATTERN = /^[A-Za-z]:[\\/]/;
-const GENERIC_LEADING_KV_KEY_PATTERN = /^(?:[-*+]\s+)?[A-Za-z_][A-Za-z0-9_.-]*\s*=/;
-/**
- * Detect a CSV/markdown entry that opens with a generic `key=` token even when
- * that key is unknown (e.g. a typo like `lable=main,path=README.md`). Callers
- * combine this with their known-key prefix check so a first-key typo is routed
- * through structured parsing and rejected by {@link assertNoUnknownCsvKeys}
- * (GH-258) instead of being silently swallowed as a bare path/value.
- *
- * Windows absolute paths (`C:\…`) are excluded so a drive-lettered bare path is
- * never misread as a `C=…` key/value entry.
- */
-export function looksLikeGenericKeyValueEntry(raw) {
-    const trimmed = raw.trim();
-    if (WINDOWS_ABSOLUTE_PATH_PATTERN.test(trimmed)) {
-        return false;
-    }
-    return GENERIC_LEADING_KV_KEY_PATTERN.test(trimmed);
-}
-/** Refuse a comma-bearing bare value whose meaning depends on guessing whether the comma separates values or belongs to one value. */
-export function assertNoAmbiguousBareCommaEntry(raw, optionName, noun, structured) {
-    if (structured || !raw.includes(","))
-        return;
-    throw new PmCliError(`${optionName} received an ambiguous comma-bearing bare ${noun}. Repeat ${optionName} for multiple values, or quote or escape literal commas in a structured key=<value> entry.`, EXIT_CODE.USAGE, {
-        code: "bare_comma_entry_ambiguous",
-        required: `Use one ${optionName} per bare ${noun}, or quote or escape literal commas in a structured key=<value> entry.`,
-    });
-}
-/**
- * Reject any key in a parsed CSV/markdown key/value map that is not part of the
- * caller's allowed-key contract, mirroring the strict `test --add` behavior
- * (see linked-test-parsers). This closes the cross-command consistency defect
- * (GH-258) where structured link/metadata parsers silently DROPPED typoed keys
- * (e.g. `lable=` instead of `label=`), storing data the author never intended.
- *
- * Comparison is case-insensitive so a key the downstream reader would accept
- * (e.g. `Path`) is never falsely rejected; the emitted "Allowed keys" list
- * preserves the canonical casing the caller passes in. Recognized keys are then
- * normalized in-place to their lowercase canonical form so downstream readers
- * (`kv.path`, `kv.id`, `kv.at`, …) see the value even when the input used mixed
- * casing — otherwise `Path=README.md` would pass validation yet read back as an
- * undefined `path` and surface a confusing "requires path" error. A key that
- * collides with another after normalization (e.g. `path=a,Path=b`) is rejected.
- *
- * Parsers with an intentional plaintext fallback (`--comment`/`--note`/
- * `--learning`, annotation `--add`) deliberately do NOT call this — there an
- * unrecognized key means "treat the whole entry as plaintext", not an error.
- */
-export function assertNoUnknownCsvKeys(kv, optionName, allowedKeys) {
-    const allowed = new Set(allowedKeys.map((key) => key.toLowerCase()));
-    const unknownKeys = Object.keys(kv).filter((key) => !allowed.has(key.toLowerCase()));
-    if (unknownKeys.length > 0) {
-        throw new PmCliError(`${optionName} does not recognize key${unknownKeys.length > 1 ? "s" : ""} ${unknownKeys
-            .map((key) => `"${key}"`)
-            .join(", ")}. Allowed keys: ${allowedKeys.join(", ")}.`, EXIT_CODE.USAGE);
-    }
-    for (const key of Object.keys(kv)) {
-        const normalizedKey = key.toLowerCase();
-        if (normalizedKey === key) {
-            continue;
-        }
-        if (Object.hasOwn(kv, normalizedKey)) {
-            throw new PmCliError(`${optionName} provides key "${key}" more than once after case normalization.`, EXIT_CODE.USAGE);
-        }
-        kv[normalizedKey] = kv[key];
-        delete kv[key];
-    }
-}
-async function readStdinText(optionName) {
-    if (process.stdin.isTTY === true) {
-        throw new PmCliError(`${optionName} value "${STDIN_TOKEN}" requires piped stdin input. Pipe content into the command, or end manual stdin with Ctrl+D (Unix/macOS) or Ctrl+Z then Enter (Windows).`, EXIT_CODE.USAGE);
-    }
-    process.stdin.setEncoding("utf8");
-    return await new Promise((resolve, reject) => {
-        let input = "";
-        process.stdin.on("data", (chunk) => {
-            input += chunk;
-        });
-        process.stdin.on("end", () => {
-            resolve(normalizeLineEndings(input));
-        });
-        process.stdin.on("error", (error) => {
-            reject(error);
-        });
-    });
-}
-const ALL_MUTATION_STDIN_FIELDS = Symbol("all-mutation-stdin-fields");
-const literalStdinTokenFields = new WeakMap();
-/** Mark transport-decoded options whose dash values are data, not stdin tokens. */
-export function preserveMutationStdinTokenLiterals(options) {
-    literalStdinTokenFields.set(options, ALL_MUTATION_STDIN_FIELDS);
-    return options;
-}
-/** Mark selected mutation fields whose dash values are literal transport data. */
-export function preserveMutationStdinTokenFields(options, fields) {
-    const current = literalStdinTokenFields.get(options);
-    if (current === ALL_MUTATION_STDIN_FIELDS)
-        return options;
-    literalStdinTokenFields.set(options, new Set([...(current ?? []), ...fields]));
-    return options;
-}
-/** Copy the complete mutation stdin-token policy across an option clone. */
-export function transferMutationStdinTokenPolicy(source, target) {
-    const policy = literalStdinTokenFields.get(source);
-    if (policy === undefined)
-        return target;
-    literalStdinTokenFields.set(target, policy === ALL_MUTATION_STDIN_FIELDS ? policy : new Set(policy));
-    return target;
-}
-/** Add a source mutation stdin-token policy without weakening the target. */
-export function overlayMutationStdinTokenPolicy(source, target) {
-    const sourcePolicy = literalStdinTokenFields.get(source);
-    const targetPolicy = literalStdinTokenFields.get(target);
-    if (sourcePolicy === undefined ||
-        targetPolicy === ALL_MUTATION_STDIN_FIELDS) {
-        return target;
-    }
-    if (sourcePolicy === ALL_MUTATION_STDIN_FIELDS) {
-        literalStdinTokenFields.set(target, sourcePolicy);
-        return target;
-    }
-    literalStdinTokenFields.set(target, new Set([...(targetPolicy ?? []), ...sourcePolicy]));
-    return target;
-}
-/** Report whether lifecycle input should interpret dash values as stdin tokens. */
-export function shouldResolveMutationStdinTokens(options) {
-    return literalStdinTokenFields.get(options) !== ALL_MUTATION_STDIN_FIELDS;
-}
-/** Report whether one mutation field should interpret dash as a stdin token. */
-export function shouldResolveMutationStdinTokenField(options, field) {
-    const literalFields = literalStdinTokenFields.get(options);
-    return (literalFields !== ALL_MUTATION_STDIN_FIELDS && !literalFields?.has(field));
-}
-/** Refuse competing stdin-token fields before any resolver starts reading. */
-export function assertSingleStdinTokenConsumer(candidates) {
-    let stdinConsumerOption;
-    for (const candidate of candidates) {
-        if (candidate.resolveToken === false || candidate.value === undefined) {
-            continue;
-        }
-        const values = Array.isArray(candidate.value)
-            ? candidate.value
-            : [candidate.value];
-        const tokenCount = values.filter((value) => value.trim() === STDIN_TOKEN).length;
-        if (tokenCount > 1) {
-            throw new PmCliError(`${candidate.optionName} accepts "${STDIN_TOKEN}" stdin token at most once per command invocation`, EXIT_CODE.USAGE);
-        }
-        if (tokenCount === 0)
-            continue;
-        if (stdinConsumerOption !== undefined &&
-            stdinConsumerOption !== candidate.optionName) {
-            throw new PmCliError(`Only one option may use "${STDIN_TOKEN}" stdin token per command invocation. Already used by ${stdinConsumerOption}.`, EXIT_CODE.USAGE);
-        }
-        stdinConsumerOption = candidate.optionName;
-    }
-}
-/** Resolve a typed mutation option bag only after its complete stdin plan is conflict-free. */
-export async function resolveMutationStdinTokenFields(options, scalarFields, listFields) {
-    const source = options;
-    const definitions = [...scalarFields, ...listFields];
-    assertSingleStdinTokenConsumer(definitions.map(([field, optionName]) => ({
-        value: source[field],
-        optionName,
-        resolveToken: shouldResolveMutationStdinTokenField(options, field),
-    })));
-    const stdinResolver = createStdinTokenResolver();
-    const resolved = { ...source };
-    for (const [field, optionName] of scalarFields) {
-        resolved[field] = await stdinResolver.resolveValue(source[field], optionName, shouldResolveMutationStdinTokenField(options, field));
-    }
-    for (const [field, optionName] of listFields) {
-        resolved[field] = await stdinResolver.resolveList(source[field], optionName, shouldResolveMutationStdinTokenField(options, field));
-    }
-    return preserveMutationStdinTokenLiterals(resolved);
-}
-/** Implements create stdin token resolver for the public runtime surface of this module. */
-export function createStdinTokenResolver() {
-    let stdinValuePromise;
-    let stdinConsumerOption;
-    const consumeStdin = async (optionName) => {
-        if (stdinConsumerOption && stdinConsumerOption !== optionName) {
-            throw new PmCliError(`Only one option may use "${STDIN_TOKEN}" stdin token per command invocation. Already used by ${stdinConsumerOption}.`, EXIT_CODE.USAGE);
-        }
-        stdinConsumerOption = optionName;
-        if (!stdinValuePromise) {
-            stdinValuePromise = readStdinText(optionName);
-        }
-        return await stdinValuePromise;
-    };
-    const resolveValue = async (value, optionName, resolveToken = true) => {
-        if (!resolveToken)
-            return value;
-        if (value === undefined) {
-            return undefined;
-        }
-        if (value.trim() !== STDIN_TOKEN) {
-            return value;
-        }
-        return await consumeStdin(optionName);
-    };
-    const resolveList = async (values, optionName, resolveToken = true) => {
-        if (!resolveToken)
-            return values;
-        if (!values) {
-            return undefined;
-        }
-        const tokenIndexes = values
-            .map((entry, index) => (entry.trim() === STDIN_TOKEN ? index : -1))
-            .filter((index) => index >= 0);
-        if (tokenIndexes.length === 0) {
-            return values;
-        }
-        if (tokenIndexes.length > 1) {
-            throw new PmCliError(`${optionName} accepts "${STDIN_TOKEN}" stdin token at most once per command invocation`, EXIT_CODE.USAGE);
-        }
-        const stdinValue = await consumeStdin(optionName);
-        const next = [...values];
-        next[tokenIndexes[0]] = stdinValue;
-        return next;
-    };
-    return {
-        resolveValue,
-        resolveList,
-    };
-}
-/** Implements parse optional number for the public runtime surface of this module. */
-export function parseOptionalNumber(raw, optionName) {
-    const value = Number(raw);
-    if (!Number.isFinite(value)) {
-        throw new PmCliError(`Invalid ${optionName} value "${raw}"`, EXIT_CODE.USAGE);
-    }
-    return value;
-}
-/** Parse a non-negative integer option such as an item duration estimate. */
-export function parseOptionalNonNegativeInteger(raw, optionName) {
-    const trimmed = raw.trim();
-    const value = Number(trimmed);
-    if (trimmed === "" || !Number.isInteger(value) || value < 0) {
-        throw new PmCliError(`Invalid ${optionName} value "${raw}". Expected a non-negative integer.`, EXIT_CODE.USAGE);
-    }
-    return value;
-}
-/** Public contract for test only, shared by SDK and presentation-layer consumers. */
-export const _testOnly = {
-    coerceJsonTagArray,
-    stripCodeFenceEnvelope,
-    parseMarkdownKeyValueLines,
-};
+!(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]="74ce3524-6c25-5646-b1a0-5ca8a3759034")}catch(e2){}})();import{PmCliError}from"../shared/errors.js";import{EXIT_CODE}from"../shared/constants.js";const STDIN_TOKEN="-";const CONTINUABLE_VALUE_KEYS=new Set(["actual_result","body","cmd","command","customer_impact","description","environment","expected_result","impact","location","message","note","outcome","repro_steps","resolution","text","title","unblock_note","value","why_now"]);function looksLikeStructuredKeyValueEntry(raw,keys){if(raw.startsWith("```")||raw.includes("\n")){return true}const keyPattern=keys.map(key=>key.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")).join("|");return new RegExp(`^(?:[-*+]\\s+)?(?:${keyPattern})\\s*[:=]`,"i").test(raw)}function parseTags(raw){const trimmed=raw.trim();if(trimmed===""){return[]}const source=coerceJsonTagArray(trimmed)??trimmed.split(",");const tags=source.map(tag=>tag.trim()).filter(Boolean).map(tag=>tag.toLowerCase());return Array.from(new Set(tags)).sort((a,b)=>a.localeCompare(b))}function collectTagFlagValues(values){if(!Array.isArray(values)||values.length===0){return[]}const collected=[];for(const raw of values){if(typeof raw!=="string"){continue}for(const tag of parseTags(raw)){collected.push(tag)}}return Array.from(new Set(collected)).sort((a,b)=>a.localeCompare(b))}function normalizeBaseTags(baseTags){if(!Array.isArray(baseTags)){return[]}return baseTags.filter(tag=>typeof tag==="string").map(tag=>tag.trim().toLowerCase()).filter(Boolean)}function splitAcceptanceCriteria(value){if(typeof value!=="string"){return[]}return value.split(";").map(criterion=>criterion.trim()).filter(Boolean)}function applyAcceptanceCriteriaMutations(baseCriteria,add,remove){const criteria=baseCriteria.map(criterion=>criterion.trim()).filter(Boolean);for(const raw of add??[]){const criterion=raw.trim();if(criterion.includes(";")){throw new PmCliError('Acceptance criteria added with --add-ac cannot contain ";" because semicolons delimit stored criteria',EXIT_CODE.USAGE,{code:"acceptance_criteria_semicolon_forbidden",required:"Pass one semicolon-free criterion per --add-ac value",why:"A semicolon inside one criterion would be re-read as multiple criteria",nextSteps:["Split the text into repeated --add-ac values, or replace the semicolon with punctuation that is not the storage delimiter"]})}if(criterion.length>0&&!criteria.includes(criterion)){criteria.push(criterion)}}const unmatchedRemovals=[];let remaining=criteria;for(const raw of remove??[]){const criterion=raw.trim();if(criterion.length===0){continue}if(!remaining.includes(criterion)){unmatchedRemovals.push(criterion);continue}remaining=remaining.filter(entry=>entry!==criterion)}return{criteria:remaining,unmatchedRemovals}}function mergeAdditiveTags(baseTags,add){const normalizedBase=normalizeBaseTags(baseTags);if(!add||add.length===0){return Array.from(new Set(normalizedBase)).sort((a,b)=>a.localeCompare(b))}const merged=new Set(normalizedBase);for(const tag of collectTagFlagValues(add)){merged.add(tag)}return Array.from(merged).sort((a,b)=>a.localeCompare(b))}function applyTagRemovals(baseTags,remove){const normalizedBase=Array.from(new Set(normalizeBaseTags(baseTags))).sort((a,b)=>a.localeCompare(b));if(!remove||remove.length===0){return normalizedBase}const removeSet=new Set(collectTagFlagValues(remove));if(removeSet.size===0){return normalizedBase}return normalizedBase.filter(tag=>!removeSet.has(tag))}function coerceJsonTagArray(trimmed){if(!trimmed.startsWith("[")){return null}let parsed;try{parsed=JSON.parse(trimmed)}catch{return null}const parsedArray=parsed;return parsedArray.map(entry=>typeof entry==="string"||typeof entry==="number"||typeof entry==="boolean"?String(entry):"").filter(entry=>entry.length>0)}function normalizeLineEndings(value){return value.replace(/\r\n/g,"\n")}function stripCodeFenceEnvelope(value){const normalized=normalizeLineEndings(value).trim();if(!normalized.startsWith("```")){return value}const lines=normalized.split("\n");if(lines.length<2){return value}if(lines.at(-1)?.trim()!=="```"){return value}return lines.slice(1,-1).join("\n")}function splitCsvSegments(raw){const segments=[];let current="";let inQuotes=false;for(let index=0;index<raw.length;index+=1){const char=raw[index];if(char==="\\"&&raw[index+1]===","){current+=",";index+=1;continue}if(char==="\\"&&raw[index+1]!==void 0){current+=`${char}${raw[index+1]}`;index+=1;continue}if(char==='"'){inQuotes=!inQuotes;current+=char;continue}if(char===","&&!inQuotes){segments.push(current);current="";continue}current+=char}if(current.trim()){segments.push(current)}return segments}function unquoteValue(value){const trimmed=value.trim();if(trimmed.startsWith('"')&&trimmed.endsWith('"')){try{const parsed=JSON.parse(trimmed);if(typeof parsed==="string")return parsed}catch{}return trimmed.slice(1,-1).replace(/\\"/g,'"')}return value}function findKeyValueDelimiter(segment){const equalsIndex=segment.indexOf("=");const colonIndex=segment.indexOf(":");const hasEquals=equalsIndex>=0;const hasColon=colonIndex>=0;if(hasEquals&&hasColon){return Math.min(equalsIndex,colonIndex)}if(hasEquals){return equalsIndex}if(hasColon){return colonIndex}return-1}function buildOptionSpecificKvGuidance(raw,optionName){if(optionName==="--add"||optionName==="--add-glob"){const looksLikePath=/[./\\]/.test(raw)||/\.[a-z]{1,6}$/i.test(raw.trim());if(looksLikePath){return"For file/doc paths use: path=<file-path>[,scope=project|global]. The scope field is optional and defaults to project (example: path=src/api.ts or path=README.md,scope=project). "}}if(optionName!=="--event"){return""}const lowered=raw.toLowerCase();const recurrenceHint=lowered.includes("recur_")||lowered.includes("recurrence")?' Recurrence list values must stay in one field and use "|" delimiters (for example recur_by_weekday=mon|wed or recur_by_month_day=1|15).':"";const weekdayAliasHint=lowered.includes("recur_byweekday")?" Use recur_by_weekday (with underscores) for weekday recurrence filters.":"";return`${recurrenceHint}${weekdayAliasHint}`}function buildInvalidKvMessage(raw,optionName){const condensed=raw.replaceAll(/\s+/g," ").trim();const preview=condensed.length>160?`${condensed.slice(0,157)}...`:condensed;const optionSpecificGuidance=buildOptionSpecificKvGuidance(raw,optionName);return`Invalid ${optionName} value "${preview}". Expected key=value entries separated by commas. `+optionSpecificGuidance+`Also accepts markdown-style key/value lines (for example "- path: README.md"). Use ${optionName} ${STDIN_TOKEN} to read piped stdin input.`}function parseMarkdownKeyValueLines(raw){const normalized=stripCodeFenceEnvelope(raw).trim();if(normalized.length===0){return null}if(!normalized.includes("\n")&&!normalized.startsWith("-")&&!normalized.startsWith("*")&&!normalized.startsWith("+")){return null}const result={};let activeKey;const lines=normalizeLineEndings(normalized).split("\n").map(line=>line.trim()).filter(line=>line.length>0);for(const line of lines){const match=line.match(/^(?:[-*+]\s+)?([a-zA-Z0-9_.-]+)\s*(=|:)\s*(.*)$/);if(match){const key=match[1].trim();result[key]=unquoteValue(match[3].trim());activeKey=key;continue}if(activeKey&&CONTINUABLE_VALUE_KEYS.has(activeKey.toLowerCase())){result[activeKey]=`${result[activeKey]}
+${line}`;continue}return null}return result}function parseCsvKv(raw,optionName){const trimmed=stripCodeFenceEnvelope(raw).trim();if(!trimmed){throw new PmCliError(`${optionName} cannot be empty`,EXIT_CODE.USAGE)}const markdownStyle=parseMarkdownKeyValueLines(trimmed);if(markdownStyle){return markdownStyle}const result={};let activeKey;const segments=splitCsvSegments(trimmed);for(const segment of segments){const delimiterIndex=findKeyValueDelimiter(segment);if(delimiterIndex>=0){const key=segment.slice(0,delimiterIndex).trim();if(!key){throw new PmCliError(buildInvalidKvMessage(raw,optionName),EXIT_CODE.USAGE)}const value=unquoteValue(segment.slice(delimiterIndex+1).trim());result[key]=value;activeKey=key;continue}if(activeKey&&CONTINUABLE_VALUE_KEYS.has(activeKey.toLowerCase())){result[activeKey]=`${result[activeKey]},${segment}`;continue}throw new PmCliError(buildInvalidKvMessage(raw,optionName),EXIT_CODE.USAGE)}return result}const WINDOWS_ABSOLUTE_PATH_PATTERN=/^[A-Za-z]:[\\/]/;const GENERIC_LEADING_KV_KEY_PATTERN=/^(?:[-*+]\s+)?[A-Za-z_][A-Za-z0-9_.-]*\s*=/;function looksLikeGenericKeyValueEntry(raw){const trimmed=raw.trim();if(WINDOWS_ABSOLUTE_PATH_PATTERN.test(trimmed)){return false}return GENERIC_LEADING_KV_KEY_PATTERN.test(trimmed)}function assertNoAmbiguousBareCommaEntry(raw,optionName,noun,structured){if(structured||!raw.includes(","))return;throw new PmCliError(`${optionName} received an ambiguous comma-bearing bare ${noun}. Repeat ${optionName} for multiple values, or quote or escape literal commas in a structured key=<value> entry.`,EXIT_CODE.USAGE,{code:"bare_comma_entry_ambiguous",required:`Use one ${optionName} per bare ${noun}, or quote or escape literal commas in a structured key=<value> entry.`})}function assertNoUnknownCsvKeys(kv,optionName,allowedKeys){const allowed=new Set(allowedKeys.map(key=>key.toLowerCase()));const unknownKeys=Object.keys(kv).filter(key=>!allowed.has(key.toLowerCase()));if(unknownKeys.length>0){throw new PmCliError(`${optionName} does not recognize key${unknownKeys.length>1?"s":""} ${unknownKeys.map(key=>`"${key}"`).join(", ")}. Allowed keys: ${allowedKeys.join(", ")}.`,EXIT_CODE.USAGE)}for(const key of Object.keys(kv)){const normalizedKey=key.toLowerCase();if(normalizedKey===key){continue}if(Object.hasOwn(kv,normalizedKey)){throw new PmCliError(`${optionName} provides key "${key}" more than once after case normalization.`,EXIT_CODE.USAGE)}kv[normalizedKey]=kv[key];delete kv[key]}}async function readStdinText(optionName){if(process.stdin.isTTY===true){throw new PmCliError(`${optionName} value "${STDIN_TOKEN}" requires piped stdin input. Pipe content into the command, or end manual stdin with Ctrl+D (Unix/macOS) or Ctrl+Z then Enter (Windows).`,EXIT_CODE.USAGE)}process.stdin.setEncoding("utf8");return await new Promise((resolve,reject)=>{let input="";process.stdin.on("data",chunk=>{input+=chunk});process.stdin.on("end",()=>{resolve(normalizeLineEndings(input))});process.stdin.on("error",error=>{reject(error)})})}const ALL_MUTATION_STDIN_FIELDS=Symbol("all-mutation-stdin-fields");const literalStdinTokenFields=new WeakMap;function preserveMutationStdinTokenLiterals(options){literalStdinTokenFields.set(options,ALL_MUTATION_STDIN_FIELDS);return options}function preserveMutationStdinTokenFields(options,fields){const current=literalStdinTokenFields.get(options);if(current===ALL_MUTATION_STDIN_FIELDS)return options;literalStdinTokenFields.set(options,new Set([...current??[],...fields]));return options}function transferMutationStdinTokenPolicy(source,target){const policy=literalStdinTokenFields.get(source);if(policy===void 0)return target;literalStdinTokenFields.set(target,policy===ALL_MUTATION_STDIN_FIELDS?policy:new Set(policy));return target}function overlayMutationStdinTokenPolicy(source,target){const sourcePolicy=literalStdinTokenFields.get(source);const targetPolicy=literalStdinTokenFields.get(target);if(sourcePolicy===void 0||targetPolicy===ALL_MUTATION_STDIN_FIELDS){return target}if(sourcePolicy===ALL_MUTATION_STDIN_FIELDS){literalStdinTokenFields.set(target,sourcePolicy);return target}literalStdinTokenFields.set(target,new Set([...targetPolicy??[],...sourcePolicy]));return target}function shouldResolveMutationStdinTokens(options){return literalStdinTokenFields.get(options)!==ALL_MUTATION_STDIN_FIELDS}function shouldResolveMutationStdinTokenField(options,field){const literalFields=literalStdinTokenFields.get(options);return literalFields!==ALL_MUTATION_STDIN_FIELDS&&!literalFields?.has(field)}function assertSingleStdinTokenConsumer(candidates){let stdinConsumerOption;for(const candidate of candidates){if(candidate.resolveToken===false||candidate.value===void 0){continue}const values=Array.isArray(candidate.value)?candidate.value:[candidate.value];const tokenCount=values.filter(value=>value.trim()===STDIN_TOKEN).length;if(tokenCount>1){throw new PmCliError(`${candidate.optionName} accepts "${STDIN_TOKEN}" stdin token at most once per command invocation`,EXIT_CODE.USAGE)}if(tokenCount===0)continue;if(stdinConsumerOption!==void 0&&stdinConsumerOption!==candidate.optionName){throw new PmCliError(`Only one option may use "${STDIN_TOKEN}" stdin token per command invocation. Already used by ${stdinConsumerOption}.`,EXIT_CODE.USAGE)}stdinConsumerOption=candidate.optionName}}async function resolveMutationStdinTokenFields(options,scalarFields,listFields){const source=options;const definitions=[...scalarFields,...listFields];assertSingleStdinTokenConsumer(definitions.map(([field,optionName])=>({value:source[field],optionName,resolveToken:shouldResolveMutationStdinTokenField(options,field)})));const stdinResolver=createStdinTokenResolver();const resolved={...source};for(const[field,optionName]of scalarFields){resolved[field]=await stdinResolver.resolveValue(source[field],optionName,shouldResolveMutationStdinTokenField(options,field))}for(const[field,optionName]of listFields){resolved[field]=await stdinResolver.resolveList(source[field],optionName,shouldResolveMutationStdinTokenField(options,field))}return preserveMutationStdinTokenLiterals(resolved)}function createStdinTokenResolver(){let stdinValuePromise;let stdinConsumerOption;const consumeStdin=async optionName=>{if(stdinConsumerOption&&stdinConsumerOption!==optionName){throw new PmCliError(`Only one option may use "${STDIN_TOKEN}" stdin token per command invocation. Already used by ${stdinConsumerOption}.`,EXIT_CODE.USAGE)}stdinConsumerOption=optionName;if(!stdinValuePromise){stdinValuePromise=readStdinText(optionName)}return await stdinValuePromise};const resolveValue=async(value,optionName,resolveToken=true)=>{if(!resolveToken)return value;if(value===void 0){return void 0}if(value.trim()!==STDIN_TOKEN){return value}return await consumeStdin(optionName)};const resolveList=async(values,optionName,resolveToken=true)=>{if(!resolveToken)return values;if(!values){return void 0}const tokenIndexes=values.map((entry,index)=>entry.trim()===STDIN_TOKEN?index:-1).filter(index=>index>=0);if(tokenIndexes.length===0){return values}if(tokenIndexes.length>1){throw new PmCliError(`${optionName} accepts "${STDIN_TOKEN}" stdin token at most once per command invocation`,EXIT_CODE.USAGE)}const stdinValue=await consumeStdin(optionName);const next=[...values];next[tokenIndexes[0]]=stdinValue;return next};return{resolveValue,resolveList}}function parseOptionalNumber(raw,optionName){const value=Number(raw);if(!Number.isFinite(value)){throw new PmCliError(`Invalid ${optionName} value "${raw}"`,EXIT_CODE.USAGE)}return value}function parseOptionalNonNegativeInteger(raw,optionName){const trimmed=raw.trim();const value=Number(trimmed);if(trimmed===""||!Number.isInteger(value)||value<0){throw new PmCliError(`Invalid ${optionName} value "${raw}". Expected a non-negative integer.`,EXIT_CODE.USAGE)}return value}const _testOnly={coerceJsonTagArray,stripCodeFenceEnvelope,parseMarkdownKeyValueLines};export{_testOnly,applyAcceptanceCriteriaMutations,applyTagRemovals,assertNoAmbiguousBareCommaEntry,assertNoUnknownCsvKeys,assertSingleStdinTokenConsumer,collectTagFlagValues,createStdinTokenResolver,looksLikeGenericKeyValueEntry,looksLikeStructuredKeyValueEntry,mergeAdditiveTags,overlayMutationStdinTokenPolicy,parseCsvKv,parseOptionalNonNegativeInteger,parseOptionalNumber,parseTags,preserveMutationStdinTokenFields,preserveMutationStdinTokenLiterals,resolveMutationStdinTokenFields,shouldResolveMutationStdinTokenField,shouldResolveMutationStdinTokens,splitAcceptanceCriteria,transferMutationStdinTokenPolicy};
 //# sourceMappingURL=parse.js.map
-//# debugId=80965b57-856c-5fef-a372-0c9f3766ada5

package/dist/core/item/plan-lifecycle.js

@@ -1,20 +1,2 @@
-/** Plan modes that intentionally prevent any further Plan mutation. */
-
-!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]="f280c1df-b134-57c3-91f6-cbf5a37e6e31")}catch(e){}}();
-export const TERMINAL_PLAN_MODES = new Set([
-    "completed",
-    "superseded",
-]);
-/** Return whether a Plan mode represents a terminal planning state. */
-export function isTerminalPlanMode(mode) {
-    return mode !== undefined && TERMINAL_PLAN_MODES.has(mode);
-}
-/** Return whether closing this item should complete its Plan lifecycle in the same mutation. */
-export function shouldCompletePlanOnClose(item) {
-    if (item.type.trim().toLowerCase() !== "plan")
-        return false;
-    const steps = item.plan_steps ?? [];
-    return steps.length > 0 && steps.every((step) => step.status === "completed");
-}
+!(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]="d2940263-a7b4-5d29-b1e5-631fe1072a5b")}catch(e2){}})();const TERMINAL_PLAN_MODES=new Set(["completed","superseded"]);function isTerminalPlanMode(mode){return mode!==void 0&&TERMINAL_PLAN_MODES.has(mode)}function shouldCompletePlanOnClose(item){if(item.type.trim().toLowerCase()!=="plan")return false;const steps=item.plan_steps??[];return steps.length>0&&steps.every(step=>step.status==="completed")}export{TERMINAL_PLAN_MODES,isTerminalPlanMode,shouldCompletePlanOnClose};
 //# sourceMappingURL=plan-lifecycle.js.map
-//# debugId=f280c1df-b134-57c3-91f6-cbf5a37e6e31