@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/core/shared/command-types.js

@@ -1,5 +1,2 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="525dce5a-3824-5c45-aa61-bd8b132bd973")}catch(e){}}();
-export {};
+!(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]="40feb89e-a797-5d1d-8797-957fa490add4")}catch(e2){}})();
 //# sourceMappingURL=command-types.js.map
-//# debugId=525dce5a-3824-5c45-aa61-bd8b132bd973

package/dist/core/shared/conflict-markers.js

@@ -1,32 +1,2 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="fedb7b50-6946-589d-b240-9f074e09e467")}catch(e){}}();
-const CONFLICT_MARKER_PATTERN = /^\s*(<<<<<<<|=======|>>>>>>>)(?:\s.*)?$/;
-/** Implements find merge conflict markers for the public runtime surface of this module. */
-export function findMergeConflictMarkers(content) {
-    if (content.length === 0) {
-        return [];
-    }
-    const lines = content.split(/\r?\n/);
-    const matches = [];
-    for (let index = 0; index < lines.length; index += 1) {
-        const line = lines[index] ?? "";
-        const markerMatch = line.match(CONFLICT_MARKER_PATTERN);
-        if (!markerMatch) {
-            continue;
-        }
-        const marker = markerMatch[1];
-        matches.push({
-            line: index + 1,
-            marker,
-            text: line,
-        });
-    }
-    return matches;
-}
-/** Implements find first merge conflict marker for the public runtime surface of this module. */
-export function findFirstMergeConflictMarker(content) {
-    const matches = findMergeConflictMarkers(content);
-    return matches[0];
-}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="45fa31ba-dea9-56db-b971-84c11e8a1c88")}catch(e2){}})();const CONFLICT_MARKER_PATTERN=/^\s*(<<<<<<<|=======|>>>>>>>)(?:\s.*)?$/;function findMergeConflictMarkers(content){if(content.length===0){return[]}const lines=content.split(/\r?\n/);const matches=[];for(let index=0;index<lines.length;index+=1){const line=lines[index]??"";const markerMatch=line.match(CONFLICT_MARKER_PATTERN);if(!markerMatch){continue}const marker=markerMatch[1];matches.push({line:index+1,marker,text:line})}return matches}function findFirstMergeConflictMarker(content){const matches=findMergeConflictMarkers(content);return matches[0]}export{findFirstMergeConflictMarker,findMergeConflictMarkers};
 //# sourceMappingURL=conflict-markers.js.map
-//# debugId=fedb7b50-6946-589d-b240-9f074e09e467

package/dist/core/shared/constants.js

@@ -1,406 +1,2 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="4bb01c24-e203-5f9f-ba23-25888bd7f6ea")}catch(e){}}();
-import { createDefaultExtensionGovernancePolicy } from "../extensions/extension-types.js";
-export { ITEM_METADATA_KEY_ORDER, ITEM_PROJECT_CONTEXT_KEYS, } from "./item-metadata-contract.js";
-/**
- * Canonical default lifecycle status model and workflow role mapping.
- *
- * Single source of truth: `SETTINGS_DEFAULTS.schema` references these, and
- * `src/core/schema/runtime-schema.ts` re-exports them as
- * `DEFAULT_RUNTIME_STATUS_DEFINITIONS` / `DEFAULT_RUNTIME_WORKFLOW`.
- */
-export const DEFAULT_STATUS_DEFINITIONS = Object.freeze([
-    {
-        id: "draft",
-        roles: ["draft"],
-    },
-    {
-        id: "open",
-        roles: ["active", "default_open"],
-    },
-    {
-        id: "in_progress",
-        aliases: ["in-progress"],
-        roles: ["active"],
-    },
-    {
-        id: "blocked",
-        roles: ["blocked"],
-    },
-    {
-        id: "closed",
-        roles: ["terminal", "terminal_done", "default_close"],
-    },
-    {
-        id: "canceled",
-        aliases: ["cancelled"],
-        roles: ["terminal", "terminal_canceled", "default_cancel"],
-    },
-]);
-/** Fallback workflow definition used when callers do not provide an override. */
-export const DEFAULT_WORKFLOW_DEFINITION = Object.freeze({
-    draft_status: "draft",
-    open_status: "open",
-    in_progress_status: "in_progress",
-    blocked_status: "blocked",
-    close_status: "closed",
-    canceled_status: "canceled",
-});
-/** Public contract for pm dirname, shared by SDK and presentation-layer consumers. */
-export const PM_DIRNAME = ".agents/pm";
-/** Public contract for settings filename, shared by SDK and presentation-layer consumers. */
-export const SETTINGS_FILENAME = "settings.json";
-/** @deprecated Terminal transitions no longer synthesize reasons; retained for SDK source compatibility. */
-export const CREATE_DIRECT_CLOSE_REASON_DEFAULT = "Closed at creation via pm create";
-/** Public contract for pm core required subdirs, shared by SDK and presentation-layer consumers. */
-export const PM_CORE_REQUIRED_SUBDIRS = [
-    "",
-    "epics",
-    "features",
-    "tasks",
-    "chores",
-    "issues",
-    "schema",
-    "history",
-    "search",
-    "extensions",
-    "locks",
-];
-/** Public contract for pm optional type subdirs, shared by SDK and presentation-layer consumers. */
-export const PM_OPTIONAL_TYPE_SUBDIRS = [
-    "decisions",
-    "events",
-    "reminders",
-    "milestones",
-    "meetings",
-    "plans",
-];
-/** Public contract for pm required subdirs, shared by SDK and presentation-layer consumers. */
-export const PM_REQUIRED_SUBDIRS = [
-    ...PM_CORE_REQUIRED_SUBDIRS,
-    ...PM_OPTIONAL_TYPE_SUBDIRS,
-];
-/** Public contract for type to folder, shared by SDK and presentation-layer consumers. */
-export const TYPE_TO_FOLDER = {
-    Epic: "epics",
-    Feature: "features",
-    Task: "tasks",
-    Chore: "chores",
-    Issue: "issues",
-    Decision: "decisions",
-    Event: "events",
-    Reminder: "reminders",
-    Milestone: "milestones",
-    Meeting: "meetings",
-    Plan: "plans",
-};
-/** Public contract for governance preset defaults, shared by SDK and presentation-layer consumers. */
-export const GOVERNANCE_PRESET_DEFAULTS = {
-    minimal: {
-        ownership_enforcement: "none",
-        create_mode_default: "progressive",
-        close_validation_default: "off",
-        require_close_reason: true,
-        parent_reference: "strict_error",
-        metadata_profile: "core",
-        force_required_for_stale_lock: false,
-        duplicate_detection_mode: "off",
-        duplicate_detection_threshold: 0.8,
-        duplicate_detection_limit: 3,
-    },
-    default: {
-        ownership_enforcement: "warn",
-        create_mode_default: "progressive",
-        close_validation_default: "warn",
-        require_close_reason: true,
-        parent_reference: "strict_error",
-        metadata_profile: "core",
-        force_required_for_stale_lock: true,
-        duplicate_detection_mode: "strict",
-        duplicate_detection_threshold: 0.8,
-        duplicate_detection_limit: 3,
-    },
-    strict: {
-        ownership_enforcement: "strict",
-        create_mode_default: "strict",
-        close_validation_default: "strict",
-        require_close_reason: true,
-        parent_reference: "strict_error",
-        metadata_profile: "strict",
-        force_required_for_stale_lock: true,
-        duplicate_detection_mode: "strict",
-        duplicate_detection_threshold: 0.8,
-        duplicate_detection_limit: 3,
-    },
-};
-/** Fallback validate stale blocker reason patterns used when callers do not provide an override. */
-export const DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS = [
-    "no active blocker",
-    "ready for planned execution sequencing",
-    "work completed",
-    "work is closed",
-];
-/** Fallback validate closure like metadata field patterns used when callers do not provide an override. */
-export const DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS = {
-    blocked_reason: [
-        "no active blocker because work is closed",
-        "work is closed",
-    ],
-    resolution: [
-        "closed with implementation evidence",
-        "closed with verification evidence",
-        "work completed and recorded",
-        "work is closed",
-    ],
-    actual_result: [
-        "closed and recorded",
-        "work completed",
-        "work completed and recorded",
-    ],
-};
-function cloneOptionalArray(values) {
-    return values ? [...values] : undefined;
-}
-/** Public contract for settings defaults, shared by SDK and presentation-layer consumers. */
-export const SETTINGS_DEFAULTS = {
-    version: 1,
-    id_prefix: "pm-",
-    ids: {
-        token_length: 4,
-    },
-    author_default: "",
-    agent_identity: {
-        probes_enabled: true,
-        identity_vocabulary: {
-            version: 1,
-            aliases: {},
-        },
-        harness_signals: [],
-    },
-    mutation_guard: {
-        require_attributed_author: false,
-        secret_guard: "advise",
-        stale_in_progress_hours: 72,
-    },
-    item_format: "toon",
-    locks: {
-        ttl_seconds: 1800,
-        wait_ms: 3000,
-    },
-    checkpoints: {
-        retention_days: 14,
-    },
-    output: {
-        default_format: "toon",
-    },
-    ux: {
-        deprecation_hints: true,
-    },
-    history: {
-        missing_stream: "auto_create",
-        compact_policy: {
-            enabled: false,
-            max_entries: 500,
-            trigger: "health_warn",
-        },
-    },
-    validation: {
-        sprint_release_format: "warn",
-        parent_reference: "warn",
-        metadata_profile: "core",
-        metadata_required_fields: [],
-        lifecycle_stale_blocker_reason_patterns: [
-            ...DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS,
-        ],
-        lifecycle_closure_like_blocked_reason_patterns: [
-            ...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.blocked_reason,
-        ],
-        lifecycle_closure_like_resolution_patterns: [
-            ...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.resolution,
-        ],
-        lifecycle_closure_like_actual_result_patterns: [
-            ...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.actual_result,
-        ],
-        estimate_defaults_by_type: {},
-    },
-    governance: {
-        preset: "minimal",
-        ...GOVERNANCE_PRESET_DEFAULTS.minimal,
-    },
-    workflow: {
-        definition_of_done: [],
-    },
-    testing: {
-        record_results_to_items: false,
-        allow_untrusted_linked_tests: false,
-    },
-    telemetry: {
-        enabled: true,
-        first_run_prompt_completed: false,
-        capture_level: "redacted",
-        endpoint: "https://pm-cli.unbrained.dev/v1/events",
-        installation_id: "",
-        retention_days: 365,
-    },
-    agent_guidance: {
-        prompt_completed: false,
-        declined: false,
-        declined_at: "",
-        template_version: 1,
-        last_checked_files: [],
-    },
-    item_types: {
-        definitions: [],
-    },
-    schema: {
-        version: 1,
-        files: {
-            types: "schema/types.json",
-            statuses: "schema/statuses.json",
-            fields: "schema/fields.json",
-            workflows: "schema/workflows.json",
-        },
-        statuses: DEFAULT_STATUS_DEFINITIONS.map((definition) => ({
-            ...definition,
-            aliases: cloneOptionalArray(definition.aliases),
-            roles: cloneOptionalArray(definition.roles),
-        })),
-        fields: [],
-        workflow: { ...DEFAULT_WORKFLOW_DEFINITION },
-        unknown_field_policy: "allow",
-    },
-    extensions: {
-        enabled: [],
-        disabled: [],
-        policy: createDefaultExtensionGovernancePolicy(),
-    },
-    search: {
-        score_threshold: 0,
-        hybrid_semantic_weight: 0.7,
-        max_results: 50,
-        embedding_model: "",
-        embedding_batch_size: 32,
-        embedding_timeout_ms: 30_000,
-        scanner_max_batch_retries: 3,
-        provider: "",
-        mutation_refresh_policy: "semantic_configured",
-        query_expansion: {
-            enabled: false,
-            provider: "",
-        },
-        rerank: {
-            enabled: false,
-            model: "",
-            top_k: 20,
-        },
-    },
-    providers: {
-        openai: {
-            base_url: "",
-            api_key: "",
-            model: "",
-        },
-        ollama: {
-            base_url: "",
-            model: "",
-        },
-    },
-    context: {
-        default_depth: "brief",
-        activity_limit: 10,
-        stale_threshold_days: 7,
-        sections: {
-            hierarchy: true,
-            activity: true,
-            progress: true,
-            recently_created: true,
-            unparented: true,
-            blockers: true,
-            files: true,
-            workload: true,
-            staleness: true,
-            tests: true,
-        },
-    },
-    vector_store: {
-        adapter: "",
-        collection_name: "pm_items",
-        qdrant: {
-            url: "",
-            api_key: "",
-        },
-        lancedb: {
-            path: "",
-        },
-    },
-};
-/** Public contract for empty canonical document, shared by SDK and presentation-layer consumers. */
-export const EMPTY_CANONICAL_DOCUMENT = {
-    metadata: {},
-    body: "",
-};
-/** Public contract for exit code, shared by SDK and presentation-layer consumers. */
-export const EXIT_CODE = {
-    SUCCESS: 0,
-    GENERIC_FAILURE: 1,
-    USAGE: 2,
-    NOT_FOUND: 3,
-    CONFLICT: 4,
-    DEPENDENCY_FAILED: 5,
-    NO_EFFECT: 6,
-    PARTIAL_EFFECT: 7,
-};
-/** Public contract for telemetry error category by code, shared by SDK and presentation-layer consumers. */
-export const TELEMETRY_ERROR_CATEGORY_BY_CODE = Object.freeze({
-    unknown_command: "usage",
-    unknown_option: "usage",
-    missing_required_option: "usage",
-    missing_required_argument: "usage",
-    invalid_command_usage: "usage",
-    linked_test_value_not_quoted: "usage",
-    invalid_argument_value: "validation",
-    health_findings: "validation",
-    validation_findings: "validation",
-    close_through_update: "validation",
-    no_update_fields: "validation",
-    unsupported_update_option: "validation",
-    tracker_not_initialized: "validation",
-    item_not_found: "validation",
-    ownership_conflict: "conflict",
-    lock_conflict: "conflict",
-    terminal_state_conflict: "conflict",
-    dependency_failed: "runtime",
-    init_gitignore_unwritable: "runtime",
-    merge_git_config_unwritable: "runtime",
-    command_failed: "runtime",
-    unknown_error: "runtime",
-});
-/** Implements resolve telemetry error category for the public runtime surface of this module. */
-export function resolveTelemetryErrorCategory(errorCode) {
-    const normalized = (errorCode ?? "").trim().toLowerCase();
-    if (normalized.length === 0) {
-        return "unknown";
-    }
-    const explicit = TELEMETRY_ERROR_CATEGORY_BY_CODE[normalized];
-    if (typeof explicit === "string") {
-        return explicit;
-    }
-    if (normalized.includes("conflict") || normalized.includes("locked")) {
-        return "conflict";
-    }
-    if (normalized.startsWith("unknown_") ||
-        normalized.startsWith("missing_required_")) {
-        return "usage";
-    }
-    if (normalized.startsWith("invalid_") ||
-        normalized.endsWith("_not_found") ||
-        normalized.includes("validation")) {
-        return "validation";
-    }
-    if (normalized.endsWith("_error") || normalized.endsWith("_failed")) {
-        return "runtime";
-    }
-    return "unknown";
-}
+!(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]="3239e763-ac05-54ca-a9a8-db810193c1ac")}catch(e2){}})();import{createDefaultExtensionGovernancePolicy}from"../extensions/extension-types.js";import{ITEM_METADATA_KEY_ORDER,ITEM_PROJECT_CONTEXT_KEYS}from"./item-metadata-contract.js";const DEFAULT_STATUS_DEFINITIONS=Object.freeze([{id:"draft",roles:["draft"]},{id:"open",roles:["active","default_open"]},{id:"in_progress",aliases:["in-progress"],roles:["active"]},{id:"blocked",roles:["blocked"]},{id:"closed",roles:["terminal","terminal_done","default_close"]},{id:"canceled",aliases:["cancelled"],roles:["terminal","terminal_canceled","default_cancel"]}]);const DEFAULT_WORKFLOW_DEFINITION=Object.freeze({draft_status:"draft",open_status:"open",in_progress_status:"in_progress",blocked_status:"blocked",close_status:"closed",canceled_status:"canceled"});const PM_DIRNAME=".agents/pm";const SETTINGS_FILENAME="settings.json";const CREATE_DIRECT_CLOSE_REASON_DEFAULT="Closed at creation via pm create";const PM_CORE_REQUIRED_SUBDIRS=["","epics","features","tasks","chores","issues","schema","history","search","extensions","locks"];const PM_OPTIONAL_TYPE_SUBDIRS=["decisions","events","reminders","milestones","meetings","plans"];const PM_REQUIRED_SUBDIRS=[...PM_CORE_REQUIRED_SUBDIRS,...PM_OPTIONAL_TYPE_SUBDIRS];const TYPE_TO_FOLDER={Epic:"epics",Feature:"features",Task:"tasks",Chore:"chores",Issue:"issues",Decision:"decisions",Event:"events",Reminder:"reminders",Milestone:"milestones",Meeting:"meetings",Plan:"plans"};const GOVERNANCE_PRESET_DEFAULTS={minimal:{ownership_enforcement:"none",create_mode_default:"progressive",close_validation_default:"off",require_close_reason:true,parent_reference:"strict_error",metadata_profile:"core",force_required_for_stale_lock:false,duplicate_detection_mode:"off",duplicate_detection_threshold:.8,duplicate_detection_limit:3},default:{ownership_enforcement:"warn",create_mode_default:"progressive",close_validation_default:"warn",require_close_reason:true,parent_reference:"strict_error",metadata_profile:"core",force_required_for_stale_lock:true,duplicate_detection_mode:"strict",duplicate_detection_threshold:.8,duplicate_detection_limit:3},strict:{ownership_enforcement:"strict",create_mode_default:"strict",close_validation_default:"strict",require_close_reason:true,parent_reference:"strict_error",metadata_profile:"strict",force_required_for_stale_lock:true,duplicate_detection_mode:"strict",duplicate_detection_threshold:.8,duplicate_detection_limit:3}};const DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS=["no active blocker","ready for planned execution sequencing","work completed","work is closed"];const DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS={blocked_reason:["no active blocker because work is closed","work is closed"],resolution:["closed with implementation evidence","closed with verification evidence","work completed and recorded","work is closed"],actual_result:["closed and recorded","work completed","work completed and recorded"]};function cloneOptionalArray(values){return values?[...values]:void 0}const SETTINGS_DEFAULTS={version:1,id_prefix:"pm-",ids:{token_length:4},author_default:"",agent_identity:{probes_enabled:true,identity_vocabulary:{version:1,aliases:{}},harness_signals:[]},mutation_guard:{require_attributed_author:false,secret_guard:"advise",stale_in_progress_hours:72},item_format:"toon",locks:{ttl_seconds:1800,wait_ms:3e3},checkpoints:{retention_days:14},output:{default_format:"toon"},ux:{deprecation_hints:true},history:{missing_stream:"auto_create",compact_policy:{enabled:false,max_entries:500,trigger:"health_warn"}},validation:{sprint_release_format:"warn",parent_reference:"warn",metadata_profile:"core",metadata_required_fields:[],lifecycle_stale_blocker_reason_patterns:[...DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS],lifecycle_closure_like_blocked_reason_patterns:[...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.blocked_reason],lifecycle_closure_like_resolution_patterns:[...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.resolution],lifecycle_closure_like_actual_result_patterns:[...DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS.actual_result],estimate_defaults_by_type:{}},governance:{preset:"minimal",...GOVERNANCE_PRESET_DEFAULTS.minimal},workflow:{definition_of_done:[]},testing:{record_results_to_items:false,allow_untrusted_linked_tests:false},telemetry:{enabled:true,first_run_prompt_completed:false,capture_level:"redacted",endpoint:"https://pm-cli.unbrained.dev/v1/events",installation_id:"",retention_days:365},agent_guidance:{prompt_completed:false,declined:false,declined_at:"",template_version:1,last_checked_files:[]},item_types:{definitions:[]},schema:{version:1,files:{types:"schema/types.json",statuses:"schema/statuses.json",fields:"schema/fields.json",workflows:"schema/workflows.json"},statuses:DEFAULT_STATUS_DEFINITIONS.map(definition=>({...definition,aliases:cloneOptionalArray(definition.aliases),roles:cloneOptionalArray(definition.roles)})),fields:[],workflow:{...DEFAULT_WORKFLOW_DEFINITION},unknown_field_policy:"allow"},extensions:{enabled:[],disabled:[],policy:createDefaultExtensionGovernancePolicy()},search:{score_threshold:0,hybrid_semantic_weight:.7,max_results:50,embedding_model:"",embedding_batch_size:32,embedding_timeout_ms:3e4,scanner_max_batch_retries:3,provider:"",mutation_refresh_policy:"semantic_configured",query_expansion:{enabled:false,provider:""},rerank:{enabled:false,model:"",top_k:20}},providers:{openai:{base_url:"",api_key:"",model:""},ollama:{base_url:"",model:""}},context:{default_depth:"brief",activity_limit:10,stale_threshold_days:7,sections:{hierarchy:true,activity:true,progress:true,recently_created:true,unparented:true,blockers:true,files:true,workload:true,staleness:true,tests:true}},vector_store:{adapter:"",collection_name:"pm_items",qdrant:{url:"",api_key:""},lancedb:{path:""}}};const EMPTY_CANONICAL_DOCUMENT={metadata:{},body:""};const EXIT_CODE={SUCCESS:0,GENERIC_FAILURE:1,USAGE:2,NOT_FOUND:3,CONFLICT:4,DEPENDENCY_FAILED:5,NO_EFFECT:6,PARTIAL_EFFECT:7};const TELEMETRY_ERROR_CATEGORY_BY_CODE=Object.freeze({unknown_command:"usage",unknown_option:"usage",missing_required_option:"usage",missing_required_argument:"usage",invalid_command_usage:"usage",linked_test_value_not_quoted:"usage",invalid_argument_value:"validation",health_findings:"validation",validation_findings:"validation",close_through_update:"validation",no_update_fields:"validation",unsupported_update_option:"validation",tracker_not_initialized:"validation",item_not_found:"validation",ownership_conflict:"conflict",lock_conflict:"conflict",terminal_state_conflict:"conflict",dependency_failed:"runtime",init_gitignore_unwritable:"runtime",merge_git_config_unwritable:"runtime",command_failed:"runtime",unknown_error:"runtime"});function resolveTelemetryErrorCategory(errorCode){const normalized=(errorCode??"").trim().toLowerCase();if(normalized.length===0){return"unknown"}const explicit=TELEMETRY_ERROR_CATEGORY_BY_CODE[normalized];if(typeof explicit==="string"){return explicit}if(normalized.includes("conflict")||normalized.includes("locked")){return"conflict"}if(normalized.startsWith("unknown_")||normalized.startsWith("missing_required_")){return"usage"}if(normalized.startsWith("invalid_")||normalized.endsWith("_not_found")||normalized.includes("validation")){return"validation"}if(normalized.endsWith("_error")||normalized.endsWith("_failed")){return"runtime"}return"unknown"}export{CREATE_DIRECT_CLOSE_REASON_DEFAULT,DEFAULT_STATUS_DEFINITIONS,DEFAULT_VALIDATE_CLOSURE_LIKE_METADATA_FIELD_PATTERNS,DEFAULT_VALIDATE_STALE_BLOCKER_REASON_PATTERNS,DEFAULT_WORKFLOW_DEFINITION,EMPTY_CANONICAL_DOCUMENT,EXIT_CODE,GOVERNANCE_PRESET_DEFAULTS,ITEM_METADATA_KEY_ORDER,ITEM_PROJECT_CONTEXT_KEYS,PM_CORE_REQUIRED_SUBDIRS,PM_DIRNAME,PM_OPTIONAL_TYPE_SUBDIRS,PM_REQUIRED_SUBDIRS,SETTINGS_DEFAULTS,SETTINGS_FILENAME,TELEMETRY_ERROR_CATEGORY_BY_CODE,TYPE_TO_FOLDER,resolveTelemetryErrorCategory};
 //# sourceMappingURL=constants.js.map
-//# debugId=4bb01c24-e203-5f9f-ba23-25888bd7f6ea

package/dist/core/shared/errors.js

@@ -1,21 +1,2 @@
-/** Implements the exported pm cli error runtime abstraction for core/shared/errors.ts. */
-
-!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]="9ab4b378-900c-5a2a-9237-b1d8d4f2ae13")}catch(e){}}();
-export class PmCliError extends Error {
-    /** Value that configures or reports exit code for this contract. */
-    exitCode;
-    /** Stable machine-readable code mirrored from context for direct SDK consumption. */
-    code;
-    /** Value that configures or reports context for this contract. */
-    context;
-    /** Value that configures or reports constructor for this contract. */
-    constructor(message, exitCode, context = {}) {
-        super(message);
-        this.name = "PmCliError";
-        this.exitCode = exitCode;
-        this.context = context;
-        this.code = context.code;
-    }
-}
+!(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]="20b70512-0d72-5ed0-a27c-df849db200a4")}catch(e2){}})();class PmCliError extends Error{exitCode;code;context;constructor(message,exitCode,context={}){super(message);this.name="PmCliError";this.exitCode=exitCode;this.context=context;this.code=context.code}}export{PmCliError};
 //# sourceMappingURL=errors.js.map
-//# debugId=9ab4b378-900c-5a2a-9237-b1d8d4f2ae13

package/dist/core/shared/html-entity-decode.js

@@ -1,132 +1,2 @@
-/**
- * @module core/shared/html-entity-decode
- *
- * Provides shared primitives and utilities for Html Entity Decode.
- */
-// Defensive HTML-entity decode for free-text fields arriving over the MCP boundary.
-// Background (pm-ydkl 2026-05-28): when Claude / the Anthropic MCP SDK forwards
-// tool arguments containing `<` or `>`, the upstream platform HTML-encodes those
-// characters before they reach pm-cli. The result is stored pm text containing
-// literal `&lt;type&gt;` instead of `<type>`. Direct CLI calls do NOT have this
-// issue — only the MCP path — so the decode is applied exclusively at the MCP
-// server boundary on incoming tool-call arguments.
-//
-// We decode only the five core HTML entities and ONLY when `&lt;` or `&gt;` is
-// present in the string (the signal that something upstream HTML-encoded it).
-// That makes the function a true no-op for normal text. All replacements run in
-// a single non-greedy pass via a lookup map so we never double-decode — most
-// importantly `&amp;lt;` stays as the literal `&lt;` (because `&amp;` is the
-// last entity resolved in the pass), preserving any text that was already
-// double-encoded upstream.
-
-!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]="c43dd9f2-78ac-5c22-970a-0016a06b87b3")}catch(e){}}();
-const ENTITY_MAP = Object.freeze({
-    "&lt;": "<",
-    "&gt;": ">",
-    "&quot;": '"',
-    "&#39;": "'",
-    "&amp;": "&",
-});
-// Pattern order is important for documentation only: the alternation matches
-// the leftmost occurrence at each position, and the map lookup resolves each
-// match independently. Crucially, `&amp;` is matched as a whole token, so a
-// substring like `&amp;lt;` matches `&amp;` once → `&lt;` (literal) and the
-// regex engine then advances past the inserted text without re-scanning it.
-const ENTITY_PATTERN = /&(?:lt|gt|quot|#39|amp);/g;
-/**
- * Decode the five core HTML entities (`&lt;`, `&gt;`, `&quot;`, `&#39;`,
- * `&amp;`) in a single pass — but only when the input contains `&lt;` or
- * `&gt;`. Returns the input unchanged otherwise so the function is a no-op for
- * normal text and idempotent on already-decoded strings.
- *
- * Single-pass semantics guarantee `&amp;lt;` decodes to `&lt;` (literal) rather
- * than collapsing to `<`, preserving any intentional double-encoding.
- */
-export function decodeHtmlEntitiesIfEscaped(input) {
-    if (typeof input !== "string") {
-        return input;
-    }
-    // Activation signal is INTENTIONALLY narrow: only `&lt;` / `&gt;` trigger
-    // decoding. Rationale: the observed MCP-platform behavior only encodes
-    // angle brackets (the characters that risk display-time HTML
-    // misinterpretation upstream). Widening to `&amp;` / `&quot;` / `&#39;`
-    // would risk altering legitimate text that contains those literal token
-    // sequences for unrelated reasons (a URL containing `&amp;`, a snippet
-    // of HTML being intentionally stored as escaped, etc.). If upstream
-    // changes its encoding policy to cover `&` / `"` / `'` standalone, the
-    // signal-guard here will need to be widened in lockstep — covered by
-    // tests `&amp;-only is no-op` and `&quot;-only is no-op`.
-    if (!input.includes("&lt;") && !input.includes("&gt;")) {
-        return input;
-    }
-    // The regex only matches keys present in ENTITY_MAP, so the lookup is total.
-    return input.replace(ENTITY_PATTERN, (match) => ENTITY_MAP[match]);
-}
-/**
- * Walk an arbitrary value (string / array / plain object) and apply
- * {@link decodeHtmlEntitiesIfEscaped} to every string leaf. Non-string scalars
- * (numbers, booleans, null, undefined) and non-plain values pass through
- * untouched.
- *
- * The walker mutates a fresh shallow copy at each level so the caller's input
- * is not modified. Cycles are not expected (MCP arguments arrive as JSON), but
- * a WeakMap is used as defensive protection against accidental cycles and
- * repeated references.
- */
-export function decodeHtmlEntitiesInOptions(options) {
-    return decodeValue(options, new WeakMap());
-}
-function decodeValue(value, seen) {
-    if (typeof value === "string") {
-        return decodeHtmlEntitiesIfEscaped(value);
-    }
-    if (Array.isArray(value)) {
-        if (seen.has(value)) {
-            return seen.get(value);
-        }
-        const result = [];
-        seen.set(value, result);
-        for (const entry of value) {
-            result.push(decodeValue(entry, seen));
-        }
-        return result;
-    }
-    if (value !== null && typeof value === "object") {
-        // Only traverse plain objects (`{}` and `Object.create(null)` literals).
-        // Class instances (Date, RegExp, Map, Set, Buffer, etc.) and `null`-proto
-        // objects with no proto would lose their prototype and methods if we
-        // rebuilt them as a `Record<string, unknown>` here, so we pass them through.
-        if (!isPlainObject(value)) {
-            return value;
-        }
-        if (seen.has(value)) {
-            return seen.get(value);
-        }
-        const source = value;
-        // Preserve the original prototype so downstream callers can still rely on
-        // standard methods like `.hasOwnProperty` on plain objects.
-        const result = Object.create(Object.getPrototypeOf(value));
-        seen.set(value, result);
-        // Use Object.defineProperty (not bracket assignment) for ALL keys so a
-        // smuggled `__proto__` / `constructor` / `prototype` key from an MCP
-        // caller becomes a regular own property — never triggers JS's special
-        // prototype-chain assignment semantics that would otherwise pollute
-        // Object.prototype. This preserves legitimate data while staying safe.
-        for (const [key, entry] of Object.entries(source)) {
-            Object.defineProperty(result, key, {
-                value: decodeValue(entry, seen),
-                enumerable: true,
-                writable: true,
-                configurable: true,
-            });
-        }
-        return result;
-    }
-    return value;
-}
-function isPlainObject(value) {
-    const proto = Object.getPrototypeOf(value);
-    return proto === Object.prototype || proto === null;
-}
+!(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]="eb1afbe5-eb0a-56d2-bb94-80fd427325f7")}catch(e2){}})();const ENTITY_MAP=Object.freeze({"&lt;":"<","&gt;":">","&quot;":'"',"&#39;":"'","&amp;":"&"});const ENTITY_PATTERN=/&(?:lt|gt|quot|#39|amp);/g;function decodeHtmlEntitiesIfEscaped(input){if(typeof input!=="string"){return input}if(!input.includes("&lt;")&&!input.includes("&gt;")){return input}return input.replace(ENTITY_PATTERN,match=>ENTITY_MAP[match])}function decodeHtmlEntitiesInOptions(options){return decodeValue(options,new WeakMap)}function decodeValue(value,seen){if(typeof value==="string"){return decodeHtmlEntitiesIfEscaped(value)}if(Array.isArray(value)){if(seen.has(value)){return seen.get(value)}const result=[];seen.set(value,result);for(const entry of value){result.push(decodeValue(entry,seen))}return result}if(value!==null&&typeof value==="object"){if(!isPlainObject(value)){return value}if(seen.has(value)){return seen.get(value)}const source=value;const result=Object.create(Object.getPrototypeOf(value));seen.set(value,result);for(const[key,entry]of Object.entries(source)){Object.defineProperty(result,key,{value:decodeValue(entry,seen),enumerable:true,writable:true,configurable:true})}return result}return value}function isPlainObject(value){const proto=Object.getPrototypeOf(value);return proto===Object.prototype||proto===null}export{decodeHtmlEntitiesIfEscaped,decodeHtmlEntitiesInOptions};
 //# sourceMappingURL=html-entity-decode.js.map
-//# debugId=c43dd9f2-78ac-5c22-970a-0016a06b87b3

package/dist/core/shared/index.js

@@ -1,13 +1,2 @@
-/**
- * @module core/shared/index
- *
- * Provides shared primitives and utilities for Index.
- */
-
-!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]="6b675c8d-bdf1-557b-9bea-30542daaceb1")}catch(e){}}();
-export * from "./command-types.js";
-export * from "./constants.js";
-export * from "./errors.js";
-export * from "./primitives.js";
+!(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]="c351b7f8-5ad4-57cf-9a67-bdb39d5b53a8")}catch(e2){}})();export*from"./command-types.js";export*from"./constants.js";export*from"./errors.js";export*from"./primitives.js";
 //# sourceMappingURL=index.js.map
-//# debugId=6b675c8d-bdf1-557b-9bea-30542daaceb1