@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/sdk/output.js

@@ -1,65 +1,2 @@
-/**
- * @module sdk/output
- *
- * Defines public output-control primitives for extension commands, exporters,
- * renderers, and custom SDK-built hosts.
- */
-
-!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]="38facf38-c1e1-5574-9e70-98977494d939")}catch(e){}}();
-export { SUPPRESS_HOST_OUTPUT_MARKER, isHostOutputSuppressed, suppressHostOutput, } from "../core/output/output-control.js";
-/**
- * Serialize object rows as newline-delimited JSON without adding a trailing
- * newline. CLI hosts can append their final newline while SDK consumers can
- * stream or frame the returned payload themselves.
- *
- * @throws {TypeError} When a row or its `toJSON` projection is not a non-null,
- * non-array object.
- */
-export function serializeNdjsonRows(rows) {
-    return rows
-        .map((row, index) => {
-        if (typeof row !== "object" || row === null || Array.isArray(row)) {
-            throw new TypeError(`NDJSON row ${index} must be a non-null object.`);
-        }
-        const serialized = JSON.stringify(row);
-        if (serialized === undefined) {
-            throw new TypeError(`NDJSON row ${index} must serialize to a non-null object.`);
-        }
-        const projected = JSON.parse(serialized);
-        if (typeof projected !== "object" ||
-            projected === null ||
-            Array.isArray(projected)) {
-            throw new TypeError(`NDJSON row ${index} must serialize to a non-null object.`);
-        }
-        return serialized;
-    })
-        .join("\n");
-}
-/**
- * Serialize a bounded NDJSON batch followed by exactly one typed terminal
- * trailer. The result has no trailing newline so callers retain framing
- * control while consumers always receive count and recovery metadata, even
- * for an empty batch.
- *
- * @throws {TypeError} When the trailer count differs from the number of domain
- * rows or a domain row uses the reserved terminal discriminator.
- */
-export function serializeNdjsonStream(rows, trailer) {
-    if (trailer.count !== rows.length) {
-        throw new TypeError(`NDJSON trailer count ${trailer.count} does not match ${rows.length} ${rows.length === 1 ? "row" : "rows"}.`);
-    }
-    for (const [index, row] of rows.entries()) {
-        if (typeof row === "object" &&
-            row !== null &&
-            !Array.isArray(row) &&
-            Reflect.get(row, "record_type") === "pm.stream.trailer") {
-            throw new TypeError(`NDJSON row ${index} uses reserved record_type pm.stream.trailer`);
-        }
-    }
-    return serializeNdjsonRows([
-        ...rows,
-        { ...trailer, record_type: "pm.stream.trailer" },
-    ]);
-}
+!(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]="c56ec8fb-56b5-57a6-9d77-843c774dcc20")}catch(e2){}})();import{SUPPRESS_HOST_OUTPUT_MARKER,isHostOutputSuppressed,suppressHostOutput}from"../core/output/output-control.js";function serializeNdjsonRows(rows){return rows.map((row,index)=>{if(typeof row!=="object"||row===null||Array.isArray(row)){throw new TypeError(`NDJSON row ${index} must be a non-null object.`)}const serialized=JSON.stringify(row);if(serialized===void 0){throw new TypeError(`NDJSON row ${index} must serialize to a non-null object.`)}const projected=JSON.parse(serialized);if(typeof projected!=="object"||projected===null||Array.isArray(projected)){throw new TypeError(`NDJSON row ${index} must serialize to a non-null object.`)}return serialized}).join("\n")}function serializeNdjsonStream(rows,trailer){if(trailer.count!==rows.length){throw new TypeError(`NDJSON trailer count ${trailer.count} does not match ${rows.length} ${rows.length===1?"row":"rows"}.`)}for(const[index,row]of rows.entries()){if(typeof row==="object"&&row!==null&&!Array.isArray(row)&&Reflect.get(row,"record_type")==="pm.stream.trailer"){throw new TypeError(`NDJSON row ${index} uses reserved record_type pm.stream.trailer`)}}return serializeNdjsonRows([...rows,{...trailer,record_type:"pm.stream.trailer"}])}export{SUPPRESS_HOST_OUTPUT_MARKER,isHostOutputSuppressed,serializeNdjsonRows,serializeNdjsonStream,suppressHostOutput};
 //# sourceMappingURL=output.js.map
-//# debugId=38facf38-c1e1-5574-9e70-98977494d939

package/dist/sdk/ownership-source.js

@@ -1,22 +1,2 @@
-/**
- * @module sdk/ownership-source
- *
- * Resolves whether an item's current assignee originated from an explicit
- * claim or a general metadata assignment using the append-only history stream.
- */
-
-!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]="d0579277-f123-5f96-8664-dfe05ade1b24")}catch(e){}}();
-import { readHistoryEntries } from "../core/history/read.js";
-import { getHistoryPath } from "../core/store/paths.js";
-/** Describe the current ownership source for an atomic claim conflict. */
-export async function describeItemOwnershipConflict(pmRoot, itemId, assignee) {
-    const history = await readHistoryEntries(getHistoryPath(pmRoot, itemId), itemId).catch(() => []);
-    const latestOwnershipOperation = [...history]
-        .reverse()
-        .find((entry) => entry.patch.some((operation) => operation.path === "/metadata/assignee"))?.op;
-    return latestOwnershipOperation === "claim"
-        ? `claimed by ${assignee}`
-        : `assigned to ${assignee}`;
-}
+!(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]="f366dd76-73b4-55c4-8c63-2913d0a0c380")}catch(e2){}})();import{readHistoryEntries}from"../core/history/read.js";import{getHistoryPath}from"../core/store/paths.js";async function describeItemOwnershipConflict(pmRoot,itemId,assignee){const history=await Promise.resolve().then(()=>readHistoryEntries(getHistoryPath(pmRoot,itemId),itemId)).catch(()=>[]);const latestOwnershipOperation=[...history].reverse().find(entry=>entry.patch.some(operation=>operation.path==="/metadata/assignee"))?.op;return latestOwnershipOperation==="claim"?`claimed by ${assignee}`:`assigned to ${assignee}`}export{describeItemOwnershipConflict};
 //# sourceMappingURL=ownership-source.js.map
-//# debugId=d0579277-f123-5f96-8664-dfe05ade1b24

package/dist/sdk/package-import-adapters.js

@@ -1,443 +1,2 @@
-/**
- * Shared external-source import adapter primitives for bundled pm packages.
- *
- * The Beads (pm-beads) and Todos (pm-todos) importers map records from an
- * external format into pm items. The field-by-field mapping is intentionally
- * package-specific (different source schemas, type vocabularies, and timestamp
- * rules), but a number of value-coercion helpers and the item write/commit
- * sequence are behavior-identical across both adapters.
- *
- * These primitives are re-exported from the SDK runtime surface (`src/sdk/runtime.ts`),
- * which is the only module bundled packages are permitted to import (they load it
- * at runtime via `PM_CLI_PACKAGE_ROOT`). Centralizing them here removes copy-pasted
- * helper bodies while keeping each package's explicit field mapping in the package.
- */
-
-!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]="863df651-49e0-552f-a7f0-92c3cc9a12a2")}catch(e){}}();
-import { appendHistoryEntry, createHistoryEntry, } from "../core/history/history.js";
-import { acquireLock } from "../core/lock/lock.js";
-import { parseTags } from "../core/item/parse.js";
-import { normalizeStatusInput } from "../core/item/status.js";
-import { serializeItemDocument } from "../core/item/item-format.js";
-import { getHistoryPath } from "../core/store/paths.js";
-import { removeFileIfExists, writeFileAtomic, } from "../core/fs/fs-utils.js";
-import { runActiveOnWriteHooks } from "../core/extensions/index.js";
-import { EXIT_CODE } from "../core/shared/constants.js";
-import { PmCliError } from "../core/shared/errors.js";
-import { resolveAuthor } from "../core/shared/author.js";
-import { nowIso } from "../core/shared/time.js";
-import { assertInitializedTracker } from "./environment/tracker-preflight.js";
-/** Returns the trimmed string when `value` is a non-empty string, else undefined. */
-export function toNonEmptyImportString(value) {
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const trimmed = value.trim();
-    return trimmed.length > 0 ? trimmed : undefined;
-}
-/** Coerces a non-negative finite numeric estimate (number or numeric string). */
-export function toEstimatedMinutesValue(value) {
-    if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
-        return value;
-    }
-    if (typeof value === "string" && value.trim().length > 0) {
-        const parsed = Number(value);
-        if (Number.isFinite(parsed) && parsed >= 0) {
-            return parsed;
-        }
-    }
-    return undefined;
-}
-/** Coerces a priority into the 0..4 range, defaulting to 2. */
-export function toImportPriority(value) {
-    if (typeof value === "number" &&
-        Number.isInteger(value) &&
-        value >= 0 &&
-        value <= 4) {
-        return value;
-    }
-    if (typeof value === "string" && value.trim().length > 0) {
-        const parsed = Number(value);
-        if (Number.isInteger(parsed) && parsed >= 0 && parsed <= 4) {
-            return parsed;
-        }
-    }
-    return 2;
-}
-/** Normalizes tags from an array of strings or a comma-separated string. */
-export function toImportTags(value) {
-    if (Array.isArray(value)) {
-        const tags = value
-            .filter((entry) => typeof entry === "string")
-            .map((entry) => entry.trim().toLowerCase())
-            .filter((entry) => entry.length > 0);
-        return Array.from(new Set(tags)).sort((left, right) => left.localeCompare(right));
-    }
-    if (typeof value === "string") {
-        return parseTags(value);
-    }
-    return [];
-}
-/** Maps a raw status value to a canonical pm status, defaulting to "open". */
-export function toImportStatus(value) {
-    const normalized = toNonEmptyImportString(value);
-    if (normalized) {
-        const canonical = normalizeStatusInput(normalized);
-        if (canonical) {
-            return canonical;
-        }
-    }
-    return "open";
-}
-/** Coerces a finite integer from a number or non-empty numeric string. */
-export function toImportInteger(value) {
-    if (typeof value === "number" && Number.isInteger(value)) {
-        return value;
-    }
-    if (typeof value !== "string" || value.trim().length === 0) {
-        return undefined;
-    }
-    const parsed = Number(value);
-    return Number.isInteger(parsed) ? parsed : undefined;
-}
-/** Coerces common boolean representations used by external package formats. */
-export function toImportBoolean(value) {
-    if (typeof value === "boolean") {
-        return value;
-    }
-    if (typeof value === "number") {
-        return value === 1 ? true : value === 0 ? false : undefined;
-    }
-    if (typeof value !== "string") {
-        return undefined;
-    }
-    const normalized = value.trim().toLowerCase();
-    if (normalized === "true" || normalized === "1") {
-        return true;
-    }
-    return normalized === "false" || normalized === "0" ? false : undefined;
-}
-/** Coerces an array of non-empty strings. */
-export function toImportStringList(value) {
-    if (!Array.isArray(value)) {
-        return undefined;
-    }
-    const entries = value
-        .map((entry) => toNonEmptyImportString(entry))
-        .filter((entry) => entry !== undefined);
-    return entries.length > 0 ? entries : undefined;
-}
-/** Coerces a record of non-empty string values. */
-export function toImportStringMap(value) {
-    return toImportValueMap(value, toNonEmptyImportString);
-}
-/** Coerces a record of finite numeric values. */
-export function toImportNumberMap(value) {
-    return toImportValueMap(value, toImportFiniteNumber);
-}
-/** Maps a loose source confidence value onto pm's confidence field. */
-export function toImportConfidence(value, allowedTextValues) {
-    if (typeof value === "number" &&
-        Number.isInteger(value) &&
-        value >= 0 &&
-        value <= 100) {
-        return value;
-    }
-    const normalized = toNonEmptyImportString(value)?.toLowerCase();
-    if (!normalized) {
-        return undefined;
-    }
-    const candidate = normalized === "med" ? "medium" : normalized;
-    if (allowedTextValues.some((entry) => entry === candidate)) {
-        return candidate;
-    }
-    const parsed = Number(candidate);
-    return Number.isInteger(parsed) && parsed >= 0 && parsed <= 100
-        ? parsed
-        : undefined;
-}
-/** Maps a string onto an allowed enum value, including the common "med" alias. */
-export function toImportNormalizedEnum(value, allowed) {
-    const normalized = toNonEmptyImportString(value)?.toLowerCase();
-    if (!normalized) {
-        return undefined;
-    }
-    const candidate = normalized === "med" ? "medium" : normalized;
-    return allowed.includes(candidate)
-        ? candidate
-        : undefined;
-}
-/** Resolves pm linked-artifact scope values, defaulting to project scope. */
-export function toImportLinkScope(value) {
-    return toNonEmptyImportString(value)?.toLowerCase() === "global"
-        ? "global"
-        : "project";
-}
-/** Converts source comments, notes, or learnings into pm log notes. */
-export function toImportLogEntries(value, options) {
-    const values = normalizeImportCollection(value, options.allowScalar === true);
-    if (!values) {
-        return undefined;
-    }
-    const entries = values
-        .map((entry) => toImportLogEntry(entry, options))
-        .filter((entry) => entry !== undefined);
-    return entries.length > 0 ? entries : undefined;
-}
-/** Converts source file artifacts into pm linked files. */
-export function toImportLinkedFiles(value, options = {}) {
-    return toImportLinkedArtifacts(value, options, (pathValue, record) => ({
-        path: pathValue,
-        scope: toImportLinkScope(record?.scope),
-        note: toNonEmptyImportString(record?.note),
-    }));
-}
-/** Converts source doc artifacts into pm linked docs. */
-export function toImportLinkedDocs(value, options = {}) {
-    return toImportLinkedArtifacts(value, options, (pathValue, record) => ({
-        path: pathValue,
-        scope: toImportLinkScope(record?.scope),
-        note: toNonEmptyImportString(record?.note),
-    }));
-}
-/** Converts source test artifacts into pm linked tests. */
-export function toImportLinkedTests(value, options = {}) {
-    const values = normalizeImportCollection(value, options.allowScalar === true);
-    if (!values) {
-        return undefined;
-    }
-    const entries = values
-        .map((entry) => toImportLinkedTest(entry, options))
-        .filter((entry) => entry !== undefined);
-    return entries.length > 0 ? entries : undefined;
-}
-/** Resolves the effective import author through the canonical CLI and SDK precedence contract. */
-export function selectImportAuthor(explicitAuthor, settingsAuthor) {
-    return resolveAuthor(explicitAuthor, settingsAuthor);
-}
-function isImportRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function normalizeImportCollection(value, allowScalar) {
-    if (Array.isArray(value)) {
-        return value;
-    }
-    return allowScalar ? [value] : undefined;
-}
-function firstNonEmptyImportString(record, keys) {
-    for (const key of keys) {
-        const value = toNonEmptyImportString(record[key]);
-        if (value) {
-            return value;
-        }
-    }
-    return undefined;
-}
-function toImportValueMap(value, coerce) {
-    if (!isImportRecord(value)) {
-        return undefined;
-    }
-    const entries = Object.entries(value)
-        .map(([key, entryValue]) => [key.trim(), coerce(entryValue)])
-        .filter((entry) => entry[0].length > 0 && entry[1] !== undefined);
-    return entries.length > 0 ? Object.fromEntries(entries) : undefined;
-}
-function toImportLogEntry(entry, options) {
-    if (typeof entry === "string") {
-        return toImportLogEntryFromText(entry, options);
-    }
-    if (!isImportRecord(entry)) {
-        return undefined;
-    }
-    const text = firstNonEmptyImportString(entry, options.textKeys ?? ["text"]);
-    if (!text) {
-        return undefined;
-    }
-    const createdAtKey = options.createdAtKey ?? "created_at";
-    const authorKey = options.authorKey ?? "author";
-    const createdAt = (options.toIsoString
-        ? options.toIsoString(entry[createdAtKey])
-        : toNonEmptyImportString(entry[createdAtKey])) ??
-        options.fallbackCreatedAt;
-    return {
-        created_at: createdAt,
-        author: toNonEmptyImportString(entry[authorKey]) ?? options.fallbackAuthor,
-        text,
-    };
-}
-function toImportLogEntryFromText(entry, options) {
-    const text = toNonEmptyImportString(entry);
-    return text
-        ? {
-            created_at: options.fallbackCreatedAt,
-            author: options.fallbackAuthor,
-            text,
-        }
-        : undefined;
-}
-function toImportLinkedArtifacts(value, options, build) {
-    const values = normalizeImportCollection(value, options.allowScalar === true);
-    if (!values) {
-        return undefined;
-    }
-    const pathKeys = options.pathKeys ?? ["path"];
-    const entries = values
-        .map((entry) => toImportLinkedArtifact(entry, pathKeys, build))
-        .filter((entry) => entry !== undefined);
-    return entries.length > 0 ? entries : undefined;
-}
-function toImportLinkedArtifact(entry, pathKeys, build) {
-    if (typeof entry === "string") {
-        const pathValue = toNonEmptyImportString(entry);
-        return pathValue ? build(pathValue) : undefined;
-    }
-    if (!isImportRecord(entry)) {
-        return undefined;
-    }
-    const pathValue = firstNonEmptyImportString(entry, pathKeys);
-    return pathValue ? build(pathValue, entry) : undefined;
-}
-function toImportLinkedTest(entry, options) {
-    if (typeof entry === "string") {
-        const command = toNonEmptyImportString(entry);
-        return command ? { command, scope: "project" } : undefined;
-    }
-    if (!isImportRecord(entry)) {
-        return undefined;
-    }
-    const command = firstNonEmptyImportString(entry, options.commandKeys ?? ["command"]);
-    const testPath = firstNonEmptyImportString(entry, options.pathKeys ?? ["path"]);
-    if (!command && (options.requireCommand === true || !testPath)) {
-        return undefined;
-    }
-    return {
-        ...(command ? { command } : {}),
-        ...(testPath ? { path: testPath } : {}),
-        scope: toImportLinkScope(entry.scope),
-        timeout_seconds: toImportLinkedTestTimeout(entry.timeout_seconds, options),
-        note: toNonEmptyImportString(entry.note),
-        ...(options.includeExtendedAssertions === true
-            ? toImportLinkedTestAssertions(entry)
-            : {}),
-    };
-}
-function toImportLinkedTestTimeout(value, options) {
-    const parsed = options.integerTimeout === true
-        ? toImportInteger(value)
-        : toImportFiniteNumber(value);
-    if (parsed === undefined) {
-        return undefined;
-    }
-    const minimum = options.timeoutMinimum ?? 0;
-    return options.timeoutExclusiveMinimum === true
-        ? parsed > minimum
-            ? parsed
-            : undefined
-        : parsed >= minimum
-            ? parsed
-            : undefined;
-}
-function toImportFiniteNumber(value) {
-    if (typeof value === "number" && Number.isFinite(value)) {
-        return value;
-    }
-    if (typeof value !== "string" || value.trim().length === 0) {
-        return undefined;
-    }
-    const parsed = Number(value);
-    return Number.isFinite(parsed) ? parsed : undefined;
-}
-function toImportLinkedTestAssertions(entry) {
-    return {
-        pm_context_mode: toImportNormalizedEnum(entry.pm_context_mode, [
-            "schema",
-            "tracker",
-            "auto",
-        ]),
-        env_set: toImportStringMap(entry.env_set),
-        env_clear: toImportStringList(entry.env_clear),
-        shared_host_safe: toImportBoolean(entry.shared_host_safe),
-        assert_stdout_contains: toImportStringList(entry.assert_stdout_contains),
-        assert_stdout_regex: toImportStringList(entry.assert_stdout_regex),
-        assert_stderr_contains: toImportStringList(entry.assert_stderr_contains),
-        assert_stderr_regex: toImportStringList(entry.assert_stderr_regex),
-        assert_stdout_min_lines: toImportInteger(entry.assert_stdout_min_lines),
-        assert_json_field_equals: toImportStringMap(entry.assert_json_field_equals),
-        assert_json_field_gte: toImportNumberMap(entry.assert_json_field_gte),
-    };
-}
-/** Throws a NOT_FOUND PmCliError when the tracker has not been initialized. */
-export async function ensureTrackerInitialized(pmRoot) {
-    await assertInitializedTracker(pmRoot);
-}
-/** Returns an empty item document used as the `before` state on import. */
-export function emptyImportedDocument() {
-    return {
-        metadata: {},
-        body: "",
-    };
-}
-/** Performs the shared item write/commit sequence: acquire the per-item lock, atomically write the TOON document, append the import history entry, and run on-write hooks. On a lock CONFLICT it returns a `conflictWarning` (using the caller-supplied prefix) instead of throwing; any other error removes the partially written file and rethrows. */
-export async function commitImportedItem(params) {
-    const { pmRoot, id, itemPath, document, author, message, settings, conflictWarningPrefix, } = params;
-    const historyPath = getHistoryPath(pmRoot, id);
-    const beforeDocument = emptyImportedDocument();
-    try {
-        const releaseLock = await acquireLock(pmRoot, id, settings.locks.ttl_seconds, author, false, settings.governance.force_required_for_stale_lock, settings.locks.wait_ms);
-        try {
-            await writeFileAtomic(itemPath, serializeItemDocument(document, { format: "toon" }));
-            try {
-                const entry = createHistoryEntry({
-                    nowIso: nowIso(),
-                    author,
-                    op: "import",
-                    before: beforeDocument,
-                    after: document,
-                    message,
-                });
-                await appendHistoryEntry(historyPath, entry);
-                const writeWarnings = [
-                    ...(await runActiveOnWriteHooks({
-                        path: itemPath,
-                        scope: "project",
-                        op: "import",
-                        item_id: document.metadata.id,
-                        item_type: document.metadata.type,
-                        before: beforeDocument,
-                        after: document,
-                        changed_fields: ["imported"],
-                    })),
-                    ...(await runActiveOnWriteHooks({
-                        path: historyPath,
-                        scope: "project",
-                        op: "import:history",
-                        item_id: document.metadata.id,
-                        item_type: document.metadata.type,
-                        before: beforeDocument,
-                        after: document,
-                        changed_fields: ["imported"],
-                    })),
-                ];
-                return { committed: true, writeWarnings };
-            }
-            catch (error) {
-                await removeFileIfExists(itemPath);
-                throw error;
-            }
-        }
-        finally {
-            await releaseLock();
-        }
-    }
-    catch (error) {
-        if (error instanceof PmCliError && error.exitCode === EXIT_CODE.CONFLICT) {
-            return {
-                committed: false,
-                conflictWarning: `${conflictWarningPrefix}:${id}`,
-            };
-        }
-        throw error;
-    }
-}
+!(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]="f248824b-d56a-52ec-ac50-8b69b5ab1c99")}catch(e2){}})();import{appendHistoryEntry,createHistoryEntry}from"../core/history/history.js";import{acquireLock}from"../core/lock/lock.js";import{parseTags}from"../core/item/parse.js";import{normalizeStatusInput}from"../core/item/status.js";import{serializeItemDocument}from"../core/item/item-format.js";import{getHistoryPath}from"../core/store/paths.js";import{removeFileIfExists,writeFileAtomic}from"../core/fs/fs-utils.js";import{runActiveOnWriteHooks}from"../core/extensions/index.js";import{EXIT_CODE}from"../core/shared/constants.js";import{PmCliError}from"../core/shared/errors.js";import{resolveAuthor}from"../core/shared/author.js";import{nowIso}from"../core/shared/time.js";import{assertInitializedTracker}from"./environment/tracker-preflight.js";function toNonEmptyImportString(value){if(typeof value!=="string"){return void 0}const trimmed=value.trim();return trimmed.length>0?trimmed:void 0}function toEstimatedMinutesValue(value){if(typeof value==="number"&&Number.isFinite(value)&&value>=0){return value}if(typeof value==="string"&&value.trim().length>0){const parsed=Number(value);if(Number.isFinite(parsed)&&parsed>=0){return parsed}}return void 0}function toImportPriority(value){if(typeof value==="number"&&Number.isInteger(value)&&value>=0&&value<=4){return value}if(typeof value==="string"&&value.trim().length>0){const parsed=Number(value);if(Number.isInteger(parsed)&&parsed>=0&&parsed<=4){return parsed}}return 2}function toImportTags(value){if(Array.isArray(value)){const tags=value.filter(entry=>typeof entry==="string").map(entry=>entry.trim().toLowerCase()).filter(entry=>entry.length>0);return Array.from(new Set(tags)).sort((left,right)=>left.localeCompare(right))}if(typeof value==="string"){return parseTags(value)}return[]}function toImportStatus(value){const normalized=toNonEmptyImportString(value);if(normalized){const canonical=normalizeStatusInput(normalized);if(canonical){return canonical}}return"open"}function toImportInteger(value){if(typeof value==="number"&&Number.isInteger(value)){return value}if(typeof value!=="string"||value.trim().length===0){return void 0}const parsed=Number(value);return Number.isInteger(parsed)?parsed:void 0}function toImportBoolean(value){if(typeof value==="boolean"){return value}if(typeof value==="number"){return value===1?true:value===0?false:void 0}if(typeof value!=="string"){return void 0}const normalized=value.trim().toLowerCase();if(normalized==="true"||normalized==="1"){return true}return normalized==="false"||normalized==="0"?false:void 0}function toImportStringList(value){if(!Array.isArray(value)){return void 0}const entries=value.map(entry=>toNonEmptyImportString(entry)).filter(entry=>entry!==void 0);return entries.length>0?entries:void 0}function toImportStringMap(value){return toImportValueMap(value,toNonEmptyImportString)}function toImportNumberMap(value){return toImportValueMap(value,toImportFiniteNumber)}function toImportConfidence(value,allowedTextValues){if(typeof value==="number"&&Number.isInteger(value)&&value>=0&&value<=100){return value}const normalized=toNonEmptyImportString(value)?.toLowerCase();if(!normalized){return void 0}const candidate=normalized==="med"?"medium":normalized;if(allowedTextValues.some(entry=>entry===candidate)){return candidate}const parsed=Number(candidate);return Number.isInteger(parsed)&&parsed>=0&&parsed<=100?parsed:void 0}function toImportNormalizedEnum(value,allowed){const normalized=toNonEmptyImportString(value)?.toLowerCase();if(!normalized){return void 0}const candidate=normalized==="med"?"medium":normalized;return allowed.includes(candidate)?candidate:void 0}function toImportLinkScope(value){return toNonEmptyImportString(value)?.toLowerCase()==="global"?"global":"project"}function toImportLogEntries(value,options){const values=normalizeImportCollection(value,options.allowScalar===true);if(!values){return void 0}const entries=values.map(entry=>toImportLogEntry(entry,options)).filter(entry=>entry!==void 0);return entries.length>0?entries:void 0}function toImportLinkedFiles(value,options={}){return toImportLinkedArtifacts(value,options,(pathValue,record)=>({path:pathValue,scope:toImportLinkScope(record?.scope),note:toNonEmptyImportString(record?.note)}))}function toImportLinkedDocs(value,options={}){return toImportLinkedArtifacts(value,options,(pathValue,record)=>({path:pathValue,scope:toImportLinkScope(record?.scope),note:toNonEmptyImportString(record?.note)}))}function toImportLinkedTests(value,options={}){const values=normalizeImportCollection(value,options.allowScalar===true);if(!values){return void 0}const entries=values.map(entry=>toImportLinkedTest(entry,options)).filter(entry=>entry!==void 0);return entries.length>0?entries:void 0}function selectImportAuthor(explicitAuthor,settingsAuthor){return resolveAuthor(explicitAuthor,settingsAuthor)}function isImportRecord(value){return typeof value==="object"&&value!==null&&!Array.isArray(value)}function normalizeImportCollection(value,allowScalar){if(Array.isArray(value)){return value}return allowScalar?[value]:void 0}function firstNonEmptyImportString(record,keys){for(const key of keys){const value=toNonEmptyImportString(record[key]);if(value){return value}}return void 0}function toImportValueMap(value,coerce){if(!isImportRecord(value)){return void 0}const entries=Object.entries(value).map(([key,entryValue])=>[key.trim(),coerce(entryValue)]).filter(entry=>entry[0].length>0&&entry[1]!==void 0);return entries.length>0?Object.fromEntries(entries):void 0}function toImportLogEntry(entry,options){if(typeof entry==="string"){return toImportLogEntryFromText(entry,options)}if(!isImportRecord(entry)){return void 0}const text=firstNonEmptyImportString(entry,options.textKeys??["text"]);if(!text){return void 0}const createdAtKey=options.createdAtKey??"created_at";const authorKey=options.authorKey??"author";const createdAt=(options.toIsoString?options.toIsoString(entry[createdAtKey]):toNonEmptyImportString(entry[createdAtKey]))??options.fallbackCreatedAt;return{created_at:createdAt,author:toNonEmptyImportString(entry[authorKey])??options.fallbackAuthor,text}}function toImportLogEntryFromText(entry,options){const text=toNonEmptyImportString(entry);return text?{created_at:options.fallbackCreatedAt,author:options.fallbackAuthor,text}:void 0}function toImportLinkedArtifacts(value,options,build){const values=normalizeImportCollection(value,options.allowScalar===true);if(!values){return void 0}const pathKeys=options.pathKeys??["path"];const entries=values.map(entry=>toImportLinkedArtifact(entry,pathKeys,build)).filter(entry=>entry!==void 0);return entries.length>0?entries:void 0}function toImportLinkedArtifact(entry,pathKeys,build){if(typeof entry==="string"){const pathValue2=toNonEmptyImportString(entry);return pathValue2?build(pathValue2):void 0}if(!isImportRecord(entry)){return void 0}const pathValue=firstNonEmptyImportString(entry,pathKeys);return pathValue?build(pathValue,entry):void 0}function toImportLinkedTest(entry,options){if(typeof entry==="string"){const command2=toNonEmptyImportString(entry);return command2?{command:command2,scope:"project"}:void 0}if(!isImportRecord(entry)){return void 0}const command=firstNonEmptyImportString(entry,options.commandKeys??["command"]);const testPath=firstNonEmptyImportString(entry,options.pathKeys??["path"]);if(!command&&(options.requireCommand===true||!testPath)){return void 0}return{...command?{command}:{},...testPath?{path:testPath}:{},scope:toImportLinkScope(entry.scope),timeout_seconds:toImportLinkedTestTimeout(entry.timeout_seconds,options),note:toNonEmptyImportString(entry.note),...options.includeExtendedAssertions===true?toImportLinkedTestAssertions(entry):{}}}function toImportLinkedTestTimeout(value,options){const parsed=options.integerTimeout===true?toImportInteger(value):toImportFiniteNumber(value);if(parsed===void 0){return void 0}const minimum=options.timeoutMinimum??0;return options.timeoutExclusiveMinimum===true?parsed>minimum?parsed:void 0:parsed>=minimum?parsed:void 0}function toImportFiniteNumber(value){if(typeof value==="number"&&Number.isFinite(value)){return value}if(typeof value!=="string"||value.trim().length===0){return void 0}const parsed=Number(value);return Number.isFinite(parsed)?parsed:void 0}function toImportLinkedTestAssertions(entry){return{pm_context_mode:toImportNormalizedEnum(entry.pm_context_mode,["schema","tracker","auto"]),env_set:toImportStringMap(entry.env_set),env_clear:toImportStringList(entry.env_clear),shared_host_safe:toImportBoolean(entry.shared_host_safe),assert_stdout_contains:toImportStringList(entry.assert_stdout_contains),assert_stdout_regex:toImportStringList(entry.assert_stdout_regex),assert_stderr_contains:toImportStringList(entry.assert_stderr_contains),assert_stderr_regex:toImportStringList(entry.assert_stderr_regex),assert_stdout_min_lines:toImportInteger(entry.assert_stdout_min_lines),assert_json_field_equals:toImportStringMap(entry.assert_json_field_equals),assert_json_field_gte:toImportNumberMap(entry.assert_json_field_gte)}}async function ensureTrackerInitialized(pmRoot){await assertInitializedTracker(pmRoot)}function emptyImportedDocument(){return{metadata:{},body:""}}async function commitImportedItem(params){const{pmRoot,id,itemPath,document,author,message,settings,conflictWarningPrefix}=params;const historyPath=getHistoryPath(pmRoot,id);const beforeDocument=emptyImportedDocument();try{const releaseLock=await acquireLock(pmRoot,id,settings.locks.ttl_seconds,author,false,settings.governance.force_required_for_stale_lock,settings.locks.wait_ms);try{await writeFileAtomic(itemPath,serializeItemDocument(document,{format:"toon"}));try{const entry=createHistoryEntry({nowIso:nowIso(),author,op:"import",before:beforeDocument,after:document,message});await appendHistoryEntry(historyPath,entry);const writeWarnings=[...await runActiveOnWriteHooks({path:itemPath,scope:"project",op:"import",item_id:document.metadata.id,item_type:document.metadata.type,before:beforeDocument,after:document,changed_fields:["imported"]}),...await runActiveOnWriteHooks({path:historyPath,scope:"project",op:"import:history",item_id:document.metadata.id,item_type:document.metadata.type,before:beforeDocument,after:document,changed_fields:["imported"]})];return{committed:true,writeWarnings}}catch(error){await removeFileIfExists(itemPath);throw error}}finally{await releaseLock()}}catch(error){if(error instanceof PmCliError&&error.exitCode===EXIT_CODE.CONFLICT){return{committed:false,conflictWarning:`${conflictWarningPrefix}:${id}`}}throw error}}export{commitImportedItem,emptyImportedDocument,ensureTrackerInitialized,selectImportAuthor,toEstimatedMinutesValue,toImportBoolean,toImportConfidence,toImportInteger,toImportLinkScope,toImportLinkedDocs,toImportLinkedFiles,toImportLinkedTests,toImportLogEntries,toImportNormalizedEnum,toImportNumberMap,toImportPriority,toImportStatus,toImportStringList,toImportStringMap,toImportTags,toNonEmptyImportString};
 //# sourceMappingURL=package-import-adapters.js.map
-//# debugId=863df651-49e0-552f-a7f0-92c3cc9a12a2

package/dist/sdk/package-migrations.js

@@ -1,21 +1,2 @@
-/**
- * @module sdk/package-migrations
- *
- * Provides one-shot SDK helpers for extension and package migration lifecycle.
- */
-
-!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]="5bbfab95-010d-5507-ab01-f8f43943d295")}catch(e){}}();
-import { PmClient, } from "./runtime.js";
-/** Plan or apply active extension migrations without constructing a reusable client. */
-export function extensionMigrate(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).extension(undefined, {
-        ...options,
-        migrate: true,
-    });
-}
-/** Plan or apply active package migrations without constructing a reusable client. */
-export function packageMigrate(options = {}, clientOptions = {}) {
-    return new PmClient(clientOptions).packageMigrate(options);
-}
+!(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]="14bbf3be-03a5-5ff3-888f-6e8b9a68ac73")}catch(e2){}})();import{PmClient}from"./runtime.js";function extensionMigrate(options={},clientOptions={}){return new PmClient(clientOptions).extension(void 0,{...options,migrate:true})}function packageMigrate(options={},clientOptions={}){return new PmClient(clientOptions).packageMigrate(options)}export{extensionMigrate,packageMigrate};
 //# sourceMappingURL=package-migrations.js.map
-//# debugId=5bbfab95-010d-5507-ab01-f8f43943d295

package/dist/sdk/package-runtime-options.js

@@ -1,81 +1,2 @@
-/**
- * Pure option-parsing helpers shared by bundled pm package runtimes.
- *
- * Bundled packages (pm-beads, pm-todos, pm-guide-shell, pm-governance-audit,
- * pm-linked-test-adapters, pm-search-advanced, ...) are standalone-installable
- * and may only depend on the public SDK runtime surface that they already load
- * via `PM_CLI_PACKAGE_ROOT`. These helpers are dependency-free string/boolean
- * coercion utilities; centralizing them here removes copy-pasted helper bodies
- * from each package runtime while staying on the SDK surface those packages are
- * permitted to import.
- */
-
-!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]="2643d11d-befc-5a87-8bec-760951eec4d0")}catch(e){}}();
-const BOOLEAN_TRUE_VALUES = new Set(["true", "1", "yes", "on"]);
-const BOOLEAN_FALSE_VALUES = new Set(["false", "0", "no", "off"]);
-/** Returns the first non-empty string value found for `key` or any alias. */
-export function readStringOption(options, key, aliases = []) {
-    const keys = [key, ...aliases];
-    for (const candidate of keys) {
-        const value = options[candidate];
-        if (typeof value === "string" && value.trim().length > 0) {
-            return value.trim();
-        }
-    }
-    return undefined;
-}
-/**
- * Coerces the first defined value found for `key` or any alias into a boolean.
- *
- * Accepts native booleans and the canonical truthy/falsy string literals; any
- * other value is ignored so a later alias can still match.
- */
-export function readBooleanOption(options, key, aliases = []) {
-    const keys = [key, ...aliases];
-    for (const candidate of keys) {
-        const value = options[candidate];
-        if (value === undefined) {
-            continue;
-        }
-        if (typeof value === "boolean") {
-            return value;
-        }
-        if (typeof value === "string") {
-            const normalized = value.trim().toLowerCase();
-            if (BOOLEAN_TRUE_VALUES.has(normalized)) {
-                return true;
-            }
-            if (BOOLEAN_FALSE_VALUES.has(normalized)) {
-                return false;
-            }
-        }
-    }
-    return undefined;
-}
-/**
- * Normalizes a comma-separated or Commander-accumulated list option.
- *
- * Repeatable extension flags arrive as string arrays while legacy and direct
- * SDK callers may still provide one comma-separated string. Supporting both
- * shapes lets package runtimes consume canonical `list` flag contracts without
- * reimplementing option coercion.
- */
-export function readCsvListOption(options, key, aliases = []) {
-    for (const candidate of [key, ...aliases]) {
-        const value = options[candidate];
-        const entries = typeof value === "string"
-            ? value.split(",")
-            : Array.isArray(value)
-                ? value.flatMap((entry) => typeof entry === "string" ? entry.split(",") : [])
-                : [];
-        const normalized = entries
-            .map((entry) => entry.trim())
-            .filter((entry) => entry.length > 0);
-        if (normalized.length > 0) {
-            return normalized;
-        }
-    }
-    return [];
-}
+!(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]="4277a72c-f012-55d2-9e18-c9a836d829d6")}catch(e2){}})();const BOOLEAN_TRUE_VALUES=new Set(["true","1","yes","on"]);const BOOLEAN_FALSE_VALUES=new Set(["false","0","no","off"]);function readStringOption(options,key,aliases=[]){const keys=[key,...aliases];for(const candidate of keys){const value=options[candidate];if(typeof value==="string"&&value.trim().length>0){return value.trim()}}return void 0}function readBooleanOption(options,key,aliases=[]){const keys=[key,...aliases];for(const candidate of keys){const value=options[candidate];if(value===void 0){continue}if(typeof value==="boolean"){return value}if(typeof value==="string"){const normalized=value.trim().toLowerCase();if(BOOLEAN_TRUE_VALUES.has(normalized)){return true}if(BOOLEAN_FALSE_VALUES.has(normalized)){return false}}}return void 0}function readCsvListOption(options,key,aliases=[]){for(const candidate of[key,...aliases]){const value=options[candidate];const entries=typeof value==="string"?value.split(","):Array.isArray(value)?value.flatMap(entry=>typeof entry==="string"?entry.split(","):[]):[];const normalized=entries.map(entry=>entry.trim()).filter(entry=>entry.length>0);if(normalized.length>0){return normalized}}return[]}export{readBooleanOption,readCsvListOption,readStringOption};
 //# sourceMappingURL=package-runtime-options.js.map
-//# debugId=2643d11d-befc-5a87-8bec-760951eec4d0