@unbrained/pm-cli 2026.9.7 → 2026.9.9

package/dist/sdk/cli-contracts/tool-parameter-tables.js

@@ -1,2168 +1,2 @@
-/**
- * @module sdk/cli-contracts/tool-parameter-tables
- *
- * Defines SDK command-contract metadata for Tool Parameter Tables.
- */
-
-!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]="7f278171-3479-5ce6-a925-da6393463200")}catch(e){}}();
-import { PLAN_HARNESS_VALUES, PLAN_MODE_VALUES, PLAN_STEP_LINK_KIND_VALUES, PLAN_STEP_STATUS_VALUES, } from "../../types/index.js";
-import { PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS } from "../read-output-session.js";
-import { ASSURANCE_DEFINITION_SCHEMA } from "./schemas/assurance-definition.js";
-/** Public contract for pm tool parameter properties, shared by SDK and presentation-layer consumers. */
-export const PM_TOOL_PARAMETER_PROPERTIES = {
-    json: { type: "boolean", default: true },
-    quiet: { type: "boolean" },
-    profile: { type: "boolean" },
-    noExtensions: { type: "boolean" },
-    noPager: { type: "boolean" },
-    tokenAccounting: { type: "boolean" },
-    outputInclude: { type: "string", minLength: 1 },
-    outputLimit: {
-        anyOf: [{ type: "integer", minimum: 1 }, { const: "unbounded" }],
-    },
-    outputBudget: {
-        anyOf: [{ type: "integer", minimum: 1 }, { const: "unbounded" }],
-    },
-    outputFormat: { type: "string", enum: ["json", "toon"] },
-    outputSession: {
-        anyOf: [
-            { type: "string", minLength: 1 },
-            {
-                type: "object",
-                additionalProperties: false,
-                required: [
-                    "version",
-                    "id",
-                    "token_budget",
-                    "spent_tokens",
-                    "seen_item_ids",
-                ],
-                properties: {
-                    version: { const: 1 },
-                    id: {
-                        type: "string",
-                        pattern: "^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$",
-                    },
-                    token_budget: { type: "integer", minimum: 256 },
-                    spent_tokens: { type: "integer", minimum: 0 },
-                    seen_item_ids: {
-                        type: "array",
-                        maxItems: PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS,
-                        items: {
-                            type: "string",
-                            pattern: "^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$",
-                        },
-                    },
-                },
-            },
-        ],
-    },
-    outputCursor: { type: "string", minLength: 1 },
-    outputRowContract: { type: "boolean" },
-    path: { type: "string" },
-    pmExecutable: { type: "string" },
-    timeoutMs: { type: "number" },
-    id: { type: "string" },
-    target: { type: "string" },
-    snapshotAction: {
-        type: "string",
-        enum: ["create", "list", "inspect", "restore", "delete"],
-    },
-    artifact: {
-        type: "string",
-        enum: ["item", "history", "relationship", "json"],
-    },
-    basePath: { type: "string" },
-    oursPath: { type: "string" },
-    theirsPath: { type: "string" },
-    outputPath: { type: "string" },
-    itemPath: { type: "string" },
-    prefer: { type: "string", enum: ["ours", "theirs"] },
-    includeReconciled: { type: "boolean" },
-    lockTtlSeconds: { type: "number" },
-    lockWaitMs: { type: "number" },
-    capability: { type: "string", minLength: 1 },
-    declarative: { type: "boolean" },
-    output: { type: "string", minLength: 1 },
-    markdown: { type: "boolean" },
-    init: { type: "boolean" },
-    install: { type: "boolean" },
-    uninstall: { type: "boolean" },
-    explore: { type: "boolean" },
-    manage: { type: "boolean" },
-    describe: { type: "boolean" },
-    doctor: { type: "boolean" },
-    catalog: { type: "boolean" },
-    adopt: { type: "boolean" },
-    adoptAll: { type: "boolean" },
-    activate: { type: "boolean" },
-    deactivate: { type: "boolean" },
-    filterFilesMissing: { type: "boolean" },
-    filterDocsMissing: { type: "boolean" },
-    matchMode: { type: "string", enum: ["all", "any", "phrase"] },
-    minScore: {
-        anyOf: [
-            { type: "number" },
-            { type: "string", pattern: "^\\d+(\\.\\d+)?$" },
-        ],
-    },
-    rank: {
-        anyOf: [{ type: "number" }, { type: "string", pattern: "^-?\\d+$" }],
-    },
-    exemptIsolateType: {
-        anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-    },
-    saveBaseline: { type: "boolean" },
-    rebuild: { type: "boolean" },
-    github: { type: "string" },
-    ref: { type: "string" },
-    query: { type: "string" },
-    queries: { type: "string" },
-    k: { anyOf: [{ type: "number" }, { type: "string" }] },
-    failUnder: { anyOf: [{ type: "number" }, { type: "string" }] },
-    for: { type: "string", minLength: 1 },
-    keywords: { type: "string" },
-    fields: { type: "string" },
-    sort: {
-        type: "string",
-        enum: [
-            "priority",
-            "deadline",
-            "updated_at",
-            "created_at",
-            "title",
-            "parent",
-        ],
-    },
-    prefix: { type: "string" },
-    idPrefix: { type: "string" },
-    workspace: { type: "string" },
-    preset: { type: "string", enum: ["minimal", "default", "strict", "custom"] },
-    typePreset: { type: "string", enum: ["agile", "ops", "research"] },
-    defaults: { type: "boolean" },
-    verbose: { type: "boolean" },
-    agentGuidance: { type: "string", enum: ["ask", "add", "skip", "status"] },
-    withPackages: { type: "boolean" },
-    mergeFence: { type: "boolean" },
-    scope: { type: "string", enum: ["project", "global"] },
-    allOver: { type: "number" },
-    minEntries: { type: "number" },
-    closed: { type: "boolean" },
-    allStreams: { type: "boolean" },
-    contractAction: { type: "string" },
-    command: { type: "string" },
-    summary: { type: "boolean" },
-    schemaOnly: { type: "boolean" },
-    flagsOnly: { type: "boolean" },
-    availabilityOnly: { type: "boolean" },
-    runtimeOnly: { type: "boolean" },
-    activeOnly: { type: "boolean" },
-    eagerTags: { type: "boolean" },
-    fullChangedFields: { type: "boolean" },
-    provenance: { type: "boolean" },
-    provenanceSummary: { type: "boolean" },
-    agentInstance: {
-        anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-    },
-    provenanceFilter: {
-        anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-    },
-    idOnly: { type: "boolean" },
-    allowMissingParent: { type: "boolean" },
-    allowUnresolvedDeps: { type: "boolean" },
-    allowDuplicate: { type: "boolean" },
-    duplicateOf: { type: "string" },
-    configAction: { type: "string", enum: ["get", "set", "list", "export"] },
-    key: { type: "string" },
-    title: { type: "string" },
-    item: {
-        anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-    },
-    start: { type: "string" },
-    duration: { type: "string" },
-    end: { type: "string" },
-    location: { type: "string" },
-    timezone: { type: "string" },
-    allDay: { type: "boolean" },
-    description: { type: "string" },
-    type: { type: "string" },
-    template: { type: "string" },
-    createMode: { type: "string", enum: ["strict", "progressive"] },
-    schedulePreset: { type: "string", enum: ["lightweight"] },
-    status: { type: "string" },
-    since: { type: "string", format: "date-time" },
-    cursorMode: { type: "string", enum: ["batch", "row"] },
-    exhaustive: { type: "boolean" },
-    threshold: { type: "number", minimum: 0, maximum: 1 },
-    filterStatus: { type: "string" },
-    filterType: { type: "string" },
-    filterTag: { type: "string" },
-    filterPriority: { anyOf: [{ type: "string" }, { type: "number" }] },
-    filterDeadlineBefore: { type: "string" },
-    filterDeadlineAfter: { type: "string" },
-    filterUpdatedAfter: { type: "string" },
-    filterUpdatedBefore: { type: "string" },
-    filterCreatedAfter: { type: "string" },
-    filterCreatedBefore: { type: "string" },
-    filterAssignee: { type: "string" },
-    filterAssigneeFilter: { type: "string", enum: ["assigned", "unassigned"] },
-    filterParent: { type: "string" },
-    filterSprint: { type: "string" },
-    filterRelease: { type: "string" },
-    closeReason: { type: "string" },
-    completedAt: { type: "string", format: "date-time" },
-    reason: { type: "string" },
-    priority: { anyOf: [{ type: "string" }, { type: "number" }] },
-    tags: { type: "string" },
-    addTags: { type: "array", items: { type: "string" } },
-    removeTags: { type: "array", items: { type: "string" } },
-    addAc: { type: "array", items: { type: "string" } },
-    removeAc: { type: "array", items: { type: "string" } },
-    body: { type: "string" },
-    deadline: { type: "string" },
-    estimate: { anyOf: [{ type: "string" }, { type: "number" }] },
-    acceptanceCriteria: { type: "string" },
-    author: { type: "string" },
-    message: { type: "string" },
-    owner: { type: "string" },
-    enforcement: { type: "string" },
-    assignee: { type: "string" },
-    assigneeFilter: { type: "string", enum: ["assigned", "unassigned"] },
-    parent: { type: "string" },
-    reviewer: { type: "string" },
-    attributedAuthor: { type: "string" },
-    planFingerprint: { type: "string", pattern: "^[a-f0-9]{64}$" },
-    historyEvent: { type: "array", items: { type: "string" } },
-    risk: { type: "string" },
-    confidence: { anyOf: [{ type: "string" }, { type: "number" }] },
-    sprint: { type: "string" },
-    release: { type: "string" },
-    blockedBy: { type: "string" },
-    blockedReason: { type: "string" },
-    unblockNote: { type: "string" },
-    reporter: { type: "string" },
-    severity: { type: "string" },
-    environment: { type: "string" },
-    reproSteps: { type: "string" },
-    resolution: { type: "string" },
-    expectedResult: { type: "string" },
-    actualResult: { type: "string" },
-    affectedVersion: { type: "string" },
-    fixedVersion: { type: "string" },
-    component: { type: "string" },
-    regression: {
-        anyOf: [{ type: "boolean" }, { type: "string" }, { type: "number" }],
-    },
-    customerImpact: { type: "string" },
-    definitionOfReady: { type: "string" },
-    order: { anyOf: [{ type: "string" }, { type: "number" }] },
-    goal: { type: "string" },
-    objective: { type: "string" },
-    value: { type: "string" },
-    impact: { type: "string" },
-    outcome: { type: "string" },
-    whyNow: { type: "string" },
-    mode: {
-        type: "string",
-        enum: ["keyword", "semantic", "hybrid"],
-    },
-    semanticWeight: { anyOf: [{ type: "string" }, { type: "number" }] },
-    op: { type: "string" },
-    compact: { type: "boolean" },
-    raw: { type: "boolean" },
-    brief: { type: "boolean" },
-    full: { type: "boolean" },
-    includeEmpty: { type: "boolean" },
-    view: { type: "string", enum: ["agenda", "day", "week", "month"] },
-    date: { type: "string" },
-    from: { type: "string" },
-    before: { type: "string" },
-    at: { type: "string" },
-    to: { type: "string" },
-    migrationId: { type: "string" },
-    fieldTypeScope: { type: "string" },
-    past: { type: "boolean" },
-    fullPeriod: { type: "boolean" },
-    include: { type: "string" },
-    recurrenceLookaheadDays: { anyOf: [{ type: "string" }, { type: "number" }] },
-    recurrenceLookbackDays: { anyOf: [{ type: "string" }, { type: "number" }] },
-    occurrenceLimit: { anyOf: [{ type: "string" }, { type: "number" }] },
-    includeLinked: { type: "boolean" },
-    semantic: { type: "boolean" },
-    hybrid: { type: "boolean" },
-    titleExact: { type: "boolean" },
-    phraseExact: { type: "boolean" },
-    highlight: { type: "boolean" },
-    includeBody: { type: "boolean" },
-    noTruncate: { type: "boolean" },
-    strictRead: { type: "boolean" },
-    tag: { type: "string" },
-    deadlineBefore: { type: "string" },
-    deadlineAfter: { type: "string" },
-    today: { type: "boolean" },
-    recent: { type: "boolean" },
-    updatedAfter: { type: "string" },
-    updatedBefore: { type: "string" },
-    createdAfter: { type: "string" },
-    createdBefore: { type: "string" },
-    filterAcMissing: { type: "boolean" },
-    filterEstimatesMissing: { type: "boolean" },
-    filterResolutionMissing: { type: "boolean" },
-    filterMetadataMissing: { type: "boolean" },
-    filterReviewerMissing: { type: "boolean" },
-    filterRiskMissing: { type: "boolean" },
-    filterConfidenceMissing: { type: "boolean" },
-    filterSprintMissing: { type: "boolean" },
-    filterReleaseMissing: { type: "boolean" },
-    // Content-field presence/absence filters (list/search). The --no-* variants
-    // select items where the field is empty/absent.
-    hasNotes: { type: "boolean" },
-    noNotes: { type: "boolean" },
-    hasLearnings: { type: "boolean" },
-    noLearnings: { type: "boolean" },
-    hasFiles: { type: "boolean" },
-    noFiles: { type: "boolean" },
-    hasDocs: { type: "boolean" },
-    noDocs: { type: "boolean" },
-    hasTests: { type: "boolean" },
-    noTests: { type: "boolean" },
-    hasComments: { type: "boolean" },
-    noComments: { type: "boolean" },
-    hasDeps: { type: "boolean" },
-    noDeps: { type: "boolean" },
-    hasBody: { type: "boolean" },
-    emptyBody: { type: "boolean" },
-    hasLinkedCommand: { type: "boolean" },
-    noLinkedCommand: { type: "boolean" },
-    // Bulk-selection (update-many/close-many) content + governance filters mirror
-    // the list/search presence filters under the --filter- prefix.
-    filterHasNotes: { type: "boolean" },
-    filterNoNotes: { type: "boolean" },
-    filterHasLearnings: { type: "boolean" },
-    filterNoLearnings: { type: "boolean" },
-    filterHasFiles: { type: "boolean" },
-    filterNoFiles: { type: "boolean" },
-    filterHasDocs: { type: "boolean" },
-    filterNoDocs: { type: "boolean" },
-    filterHasTests: { type: "boolean" },
-    filterNoTests: { type: "boolean" },
-    filterHasComments: { type: "boolean" },
-    filterNoComments: { type: "boolean" },
-    filterHasDeps: { type: "boolean" },
-    filterNoDeps: { type: "boolean" },
-    filterHasBody: { type: "boolean" },
-    filterEmptyBody: { type: "boolean" },
-    filterHasLinkedCommand: { type: "boolean" },
-    filterNoLinkedCommand: { type: "boolean" },
-    ids: { type: "string" },
-    limit: { anyOf: [{ type: "string" }, { type: "number" }] },
-    blockedLimit: { anyOf: [{ type: "string" }, { type: "number" }] },
-    readyOnly: { type: "boolean" },
-    offset: { anyOf: [{ type: "string" }, { type: "number" }] },
-    progress: { type: "boolean" },
-    background: { type: "boolean" },
-    runId: { type: "string" },
-    stream: {
-        anyOf: [
-            { type: "boolean" },
-            {
-                type: "string",
-                enum: ["stdout", "stderr", "both", "rows", "ndjson", "jsonl"],
-            },
-        ],
-    },
-    tail: { anyOf: [{ type: "string" }, { type: "number" }] },
-    addJson: {
-        anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-    },
-    eventType: { type: "string" },
-    includeMeta: { type: "boolean" },
-    allActionable: { type: "boolean" },
-    verboseAuthorEvents: { type: "boolean" },
-    match: { type: "string" },
-    onlyIndex: { anyOf: [{ type: "string" }, { type: "number" }] },
-    removeIndex: {
-        type: "array",
-        items: { anyOf: [{ type: "string" }, { type: "number" }] },
-    },
-    onlyLast: { type: "boolean" },
-    envSet: { type: "array", items: { type: "string" } },
-    envClear: { type: "array", items: { type: "string" } },
-    sharedHostSafe: { type: "boolean" },
-    detail: { type: "string", enum: ["summary", "deep"] },
-    trace: { type: "boolean" },
-    reload: { type: "boolean" },
-    watch: { type: "boolean" },
-    runtimeProbe: { type: "boolean" },
-    fixManagedState: { type: "boolean" },
-    isolated: { type: "boolean" },
-    ignoreGlobal: { type: "boolean" },
-    pmContext: { type: "string", enum: ["schema", "tracker", "auto"] },
-    overrideLinkedPmContext: { type: "boolean" },
-    workspaceContext: {
-        type: "string",
-        enum: ["source", "isolated", "snapshot"],
-    },
-    overrideLinkedWorkspaceContext: { type: "boolean" },
-    allowUntrustedLinkedTests: { type: "boolean" },
-    acknowledgeLinkedTests: { type: "boolean" },
-    failOnContextMismatch: { type: "boolean" },
-    failOnSkipped: { type: "boolean" },
-    failOnEmptyTestRun: { type: "boolean" },
-    requireAssertionsForPm: { type: "boolean" },
-    checkContext: { type: "boolean" },
-    autoPmContext: { type: "boolean" },
-    measure: { type: "array", items: { type: "string" } },
-    metricBelow: { type: "string" },
-    metricDiff: { type: "string" },
-    diff: { type: "boolean" },
-    storage: { type: "boolean" },
-    metadataCoverage: { type: "boolean" },
-    fieldUtilization: { type: "boolean" },
-    byAssignee: { type: "boolean" },
-    byTag: { type: "boolean" },
-    byPriority: { type: "boolean" },
-    tagPrefix: { type: "string" },
-    measurements: { type: "boolean" },
-    metric: { type: "string" },
-    measurementLimit: { type: "integer", minimum: 0, maximum: 1000 },
-    observe: { type: "array", items: { type: "string" } },
-    improvementDirection: {
-        type: "string",
-        enum: ["higher", "lower", "target"],
-    },
-    measurementSource: { type: "string" },
-    measurementItem: { type: "string" },
-    measurementRevision: { type: "string" },
-    provenanceCoverage: { type: "boolean" },
-    fleetAttribution: { type: "boolean" },
-    eventLimit: { type: "integer", minimum: 1, maximum: 100000 },
-    minimumSample: { type: "integer", minimum: 1, maximum: 10000 },
-    verify: { type: "boolean" },
-    literal: { type: "array", items: { type: "string" } },
-    regex: { type: "array", items: { type: "string" } },
-    replacement: { type: "string" },
-    timeout: { anyOf: [{ type: "string" }, { type: "number" }] },
-    validateClose: { type: "string", enum: ["off", "warn", "strict"] },
-    checkMetadata: { type: "boolean" },
-    metadataProfile: { type: "string", enum: ["core", "strict", "custom"] },
-    checkResolution: { type: "boolean" },
-    checkLifecycle: { type: "boolean" },
-    checkStaleBlockers: { type: "boolean" },
-    dependencyCycleSeverity: { type: "string", enum: ["off", "warn", "error"] },
-    parentCycleSeverity: { type: "string", enum: ["off", "warn", "error"] },
-    checkFiles: { type: "boolean" },
-    checkStorageIntegrity: { type: "boolean" },
-    strictDirectories: { type: "boolean" },
-    requireMergeDrivers: { type: "boolean" },
-    checkOnly: { type: "boolean" },
-    checkTelemetry: { type: "boolean" },
-    noRefresh: { type: "boolean" },
-    refreshVectors: { type: "boolean" },
-    verboseStaleItems: { type: "boolean" },
-    skipVectors: { type: "boolean" },
-    skipIntegrity: { type: "boolean" },
-    skipDrift: { type: "boolean" },
-    verboseDiagnostics: { type: "boolean" },
-    allAffectedIds: { type: "boolean" },
-    scanMode: {
-        type: "string",
-        enum: ["default", "tracked-all", "tracked-all-strict"],
-    },
-    includePmInternals: { type: "boolean" },
-    verboseFileLists: { type: "boolean" },
-    strictExit: { type: "boolean" },
-    failOnWarn: { type: "boolean" },
-    fixHints: { type: "boolean" },
-    autoFix: { type: "boolean" },
-    fixScope: {
-        type: "array",
-        items: {
-            type: "string",
-            enum: ["metadata", "resolution", "estimates", "lifecycle"],
-        },
-    },
-    pruneMissing: { type: "boolean" },
-    checkHistoryDrift: { type: "boolean" },
-    checkCommandReferences: { type: "boolean" },
-    counts: { type: "boolean" },
-    edit: { type: "integer", minimum: 1 },
-    delete: { type: "integer", minimum: 1 },
-    dryRun: { type: "boolean" },
-    normalizeProvenance: { type: "boolean" },
-    salvageTail: { type: "boolean" },
-    all: { type: "boolean" },
-    clear: { type: "boolean" },
-    cliOnly: { type: "boolean" },
-    packagesOnly: { type: "boolean" },
-    repair: { type: "boolean" },
-    packageName: { type: "string" },
-    rollback: { type: "string" },
-    noCheckpoint: { type: "boolean" },
-    force: { type: "boolean" },
-    ifAvailable: { type: "boolean" },
-    ifAbsent: { type: "boolean" },
-    next: { type: "boolean" },
-    maxAttempts: {
-        anyOf: [
-            { type: "integer", minimum: 1, maximum: 100 },
-            { type: "string", pattern: "^(?:[1-9]|[1-9][0-9]|100)$" },
-        ],
-    },
-    includeDecisions: { type: "boolean" },
-    includeGates: { type: "boolean" },
-    includeContainers: { type: "boolean" },
-    explainRanking: { type: "boolean" },
-    noTags: { type: "boolean" },
-    noExtensionHealth: { type: "boolean" },
-    run: { type: "boolean" },
-    count: { type: "boolean" },
-    sum: { type: "string" },
-    avg: { type: "string" },
-    tree: { type: "boolean" },
-    treeId: { type: "string", minLength: 1 },
-    definition: { type: "object" },
-    trigger: {
-        type: "string",
-        enum: [
-            "pre-commit",
-            "pre-push",
-            "pre-merge",
-            "ci",
-            "pre-release",
-            "post-release",
-            "scheduled",
-            "on-claim",
-            "on-close",
-        ],
-    },
-    gate: { type: "string", minLength: 1 },
-    treeDepth: { anyOf: [{ type: "string" }, { type: "number" }] },
-    includeUnparented: { type: "boolean" },
-    gcScope: {
-        type: "array",
-        items: {
-            type: "string",
-            enum: ["index", "embeddings", "runtime", "locks"],
-        },
-    },
-    maxDepth: { anyOf: [{ type: "string" }, { type: "number" }] },
-    nodeLimit: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
-    edgeLimit: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
-    tokenBudget: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
-    cursor: { type: "string" },
-    direction: { type: "string", enum: ["outgoing", "incoming", "both"] },
-    kind: {
-        anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-    },
-    after: { type: "string" },
-    maxPaths: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
-    sample: { anyOf: [{ type: "string" }, { type: "integer", minimum: 1 }] },
-    exemptIsolate: {
-        anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-    },
-    collapse: { type: "string", enum: ["none", "repeated"] },
-    shell: { type: "string", enum: ["bash", "zsh", "fish"] },
-    stdin: { type: "boolean" },
-    file: { type: "string" },
-    preserveSourceIds: { type: "boolean" },
-    folder: { type: "string" },
-    subcommand: { type: "string" },
-    name: { type: "string" },
-    defaultStatus: { type: "string" },
-    alias: { type: "array", items: { type: "string" } },
-    role: { type: "array", items: { type: "string" } },
-    fieldType: {
-        type: "string",
-        enum: ["string", "number", "boolean", "string_array"],
-    },
-    commands: { type: "array", items: { type: "string" } },
-    cliFlag: { type: "string" },
-    required: { type: "boolean" },
-    requiredOnCreate: { type: "boolean" },
-    allowUnset: { type: "boolean" },
-    requiredTypes: { type: "array", items: { type: "string" } },
-    infer: { type: "boolean" },
-    minCount: { type: "number" },
-    text: { type: "string" },
-    add: { type: "array", items: { type: "string" } },
-    addGlob: { type: "array", items: { type: "string" } },
-    remove: { type: "array", items: { type: "string" } },
-    migrate: { type: "array", items: { type: "string" } },
-    discover: { type: "boolean" },
-    apply: { type: "boolean" },
-    discoveryNote: { type: "string" },
-    lookupPath: { type: "array", items: { type: "string" } },
-    explain: { type: "boolean" },
-    lines: { type: "string", pattern: "^[1-9]\\d*:[1-9]\\d*$" },
-    decisionDepth: { type: "integer", minimum: 1, maximum: 32 },
-    // GH-170 (pm-pfnx): single-string note for files/docs add batches (the shared
-    // `note` key below is the array-typed create/update note seed).
-    addNote: { type: "string" },
-    list: { type: "boolean" },
-    appendStable: { type: "boolean" },
-    validatePaths: { type: "boolean" },
-    dep: { type: "array", items: { type: "string" } },
-    depRemove: { type: "array", items: { type: "string" } },
-    replaceDeps: { type: "boolean" },
-    replaceTests: { type: "boolean" },
-    replaceFiles: { type: "boolean" },
-    replaceDocs: { type: "boolean" },
-    comment: { type: "array", items: { type: "string" } },
-    note: { type: "array", items: { type: "string" } },
-    learning: { type: "array", items: { type: "string" } },
-    linkedFile: { type: "array", items: { type: "string" } },
-    linkedTest: { type: "array", items: { type: "string" } },
-    doc: { type: "array", items: { type: "string" } },
-    reminder: { type: "array", items: { type: "string" } },
-    event: { type: "array", items: { type: "string" } },
-    typeOption: { type: "array", items: { type: "string" } },
-    field: { type: "array", items: { type: "string" } },
-    unset: { type: "array", items: { type: "string" } },
-    clearDeps: { type: "boolean" },
-    clearComments: { type: "boolean" },
-    clearNotes: { type: "boolean" },
-    clearLearnings: { type: "boolean" },
-    clearFiles: { type: "boolean" },
-    clearTests: { type: "boolean" },
-    clearDocs: { type: "boolean" },
-    clearReminders: { type: "boolean" },
-    clearEvents: { type: "boolean" },
-    clearTypeOptions: { type: "boolean" },
-    criterion: { type: "array", items: { type: "string" } },
-    clearCriteria: { type: "boolean" },
-    groupBy: { type: "string" },
-    completion: { type: "boolean" },
-    format: { type: "string" },
-    unbounded: { type: "boolean" },
-    depth: { type: "string", enum: ["brief", "standard", "deep", "full"] },
-    section: {
-        type: "array",
-        items: {
-            type: "string",
-            enum: [
-                "hierarchy",
-                "activity",
-                "progress",
-                "blockers",
-                "files",
-                "workload",
-                "staleness",
-                "tests",
-            ],
-        },
-    },
-    activityLimit: { anyOf: [{ type: "string" }, { type: "number" }] },
-    staleThreshold: { type: "string" },
-    policy: { type: "string" },
-};
-/** Per-action property overrides for parameters whose transport shape differs from their shared default. */
-export const PM_TOOL_ACTION_SCOPED_PARAMETER_PROPERTIES = {
-    assurance: {
-        definition: ASSURANCE_DEFINITION_SCHEMA,
-        kind: {
-            type: "string",
-            enum: ["measurement", "assertion", "gate"],
-        },
-        subcommand: {
-            type: "string",
-            enum: [
-                "list",
-                "show",
-                "put",
-                "remove",
-                "run",
-                "verdicts",
-                "presets",
-                "apply",
-                "derive",
-                "promote",
-                "risk",
-                "lineages",
-            ],
-        },
-        preset: {
-            type: "string",
-            enum: ["software-delivery", "research", "agent-evaluation", "operations"],
-        },
-        enforcement: { type: "string", enum: ["warn", "block"] },
-        limit: { type: "integer", minimum: 1, maximum: 1000 },
-    },
-    activity: {
-        harness: {
-            anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-        },
-    },
-    "update-many": {
-        ids: {
-            anyOf: [
-                { type: "string" },
-                { type: "number" },
-                {
-                    type: "array",
-                    items: { anyOf: [{ type: "string" }, { type: "number" }] },
-                },
-            ],
-        },
-    },
-    "close-many": {
-        ids: {
-            anyOf: [
-                { type: "string" },
-                { type: "number" },
-                {
-                    type: "array",
-                    items: { anyOf: [{ type: "string" }, { type: "number" }] },
-                },
-            ],
-        },
-    },
-    "history-compact": {
-        ids: {
-            anyOf: [
-                { type: "string" },
-                { type: "number" },
-                {
-                    type: "array",
-                    items: { anyOf: [{ type: "string" }, { type: "number" }] },
-                },
-            ],
-        },
-    },
-    events: {
-        since: { type: "string", minLength: 1 },
-        type: {
-            anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-        },
-        author: {
-            anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-        },
-        item: {
-            anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-        },
-        limit: { type: "integer", minimum: 0, maximum: 1000 },
-        harness: {
-            anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-        },
-    },
-    history: {
-        harness: {
-            anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-        },
-    },
-    remind: {
-        at: { type: "string", minLength: 1 },
-    },
-};
-/** Supported values accepted by the plan subcommand contract. */
-export const PLAN_SUBCOMMAND_VALUES = [
-    "create",
-    "show",
-    "add-step",
-    "update-step",
-    "complete-step",
-    "block-step",
-    "reorder-step",
-    "remove-step",
-    "link",
-    "unlink",
-    "decision",
-    "discovery",
-    "validation",
-    "resume",
-    "approve",
-    "materialize",
-];
-/** Public contract for plan action parameter properties, shared by SDK and presentation-layer consumers. */
-export const PLAN_ACTION_PARAMETER_PROPERTIES = {
-    subcommand: { type: "string", enum: [...PLAN_SUBCOMMAND_VALUES] },
-    stepRef: { type: "string" },
-    reorderTo: { anyOf: [{ type: "string" }, { type: "number" }] },
-    scope: { type: "string" },
-    harness: { type: "string", enum: [...PLAN_HARNESS_VALUES] },
-    mode: { type: "string", enum: [...PLAN_MODE_VALUES] },
-    resumeContext: { type: "string" },
-    related: { type: "string" },
-    blocks: { type: "string" },
-    claim: { type: "boolean" },
-    fromSearch: { type: "string" },
-    stepTitle: { type: "string" },
-    // pm-6mit: ordered step titles for create (string or array; values are never
-    // comma-split). On step subcommands a single value aliases stepTitle.
-    step: {
-        anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-    },
-    stepBody: { type: "string" },
-    stepOwner: { type: "string" },
-    stepStatus: { type: "string", enum: [...PLAN_STEP_STATUS_VALUES] },
-    stepEvidence: { type: "string" },
-    stepBlockedReason: { type: "string" },
-    stepReplacement: { type: "string" },
-    dependsOn: { type: "string" },
-    link: { type: "string" },
-    linkKind: { type: "string", enum: [...PLAN_STEP_LINK_KIND_VALUES] },
-    linkNote: { type: "string" },
-    promoteToItemDep: { type: "boolean" },
-    allowMultipleActive: { type: "boolean" },
-    file: {
-        anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-    },
-    test: {
-        anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-    },
-    doc: {
-        anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-    },
-    decisionText: { type: "string" },
-    decision: { type: "string" },
-    decisionRationale: { type: "string" },
-    decisionEvidence: { type: "string" },
-    discoveryText: { type: "string" },
-    discovery: { type: "string" },
-    validationText: { type: "string" },
-    validation: { type: "string" },
-    validationCommand: { type: "string" },
-    validationExpected: { type: "string" },
-    steps: { type: "array", items: { type: "string" } },
-    materializeType: { type: "string" },
-    materializeParent: { type: "string" },
-    materializeTags: { type: "string" },
-    field: {
-        anyOf: [{ type: "string" }, { type: "array", items: { type: "string" } }],
-    },
-};
-/** Public contract for plan action parameter metadata, shared by SDK and presentation-layer consumers. */
-export const PLAN_ACTION_PARAMETER_METADATA = {
-    subcommand: {
-        description: "Plan workflow operation to run.",
-        examples: ["create", "show", "add-step", "approve"],
-    },
-    stepRef: {
-        description: "Plan step id or order for step lifecycle subcommands.",
-        examples: ["plan-step-001", "1"],
-    },
-    reorderTo: {
-        description: "New integer order for reorder-step.",
-        examples: [1, "2"],
-    },
-    scope: {
-        description: "Short free-text scope statement describing what the Plan covers.",
-        examples: ["Release readiness audit", "Search package migration"],
-    },
-    mode: {
-        description: "Plan lifecycle mode.",
-        examples: ["draft", "research", "approved"],
-    },
-    step: {
-        description: "Ordered initial step titles for create (string or array, never comma-split; stepTitle, when also set, becomes the first step). For step subcommands a single value aliases stepTitle.",
-        examples: [["Read the code", "Write the fix", "Run the tests"]],
-    },
-    file: {
-        description: "File link to attach while creating or materializing a Plan.",
-        examples: ["path=src/cli.ts,note=implementation surface"],
-    },
-    test: {
-        description: "Test command link to attach while creating or materializing a Plan.",
-        examples: ["command=pnpm build,timeout_seconds=300"],
-    },
-    doc: {
-        description: "Documentation link to attach while creating or materializing a Plan.",
-        examples: ["path=docs/SDK.md,note=public API reference"],
-    },
-};
-/** Public contract for pm tool parameter metadata, shared by SDK and presentation-layer consumers. */
-export const PM_TOOL_PARAMETER_METADATA = {
-    includeGates: {
-        description: "Opt next or claim-next into outcome gates. Blocker and ownership restrictions still apply.",
-    },
-    includeContainers: {
-        description: "Opt next or claim-next into containers with unfinished descendants. Blocker and ownership restrictions still apply.",
-    },
-    action: {
-        description: "Tool action to execute.",
-    },
-    pmExecutable: {
-        description: "Override the pm executable used by actions that invoke or verify an external CLI process.",
-        examples: ["pm", "node dist/cli.js"],
-    },
-    force: {
-        description: "Allow the selected action to override its supported ownership, terminal-state, or destructive-operation guard.",
-    },
-    limit: {
-        description: "Maximum number of rows returned by the selected action.",
-        examples: [10, "25"],
-    },
-    text: {
-        description: "Text payload used by append, comment, note, or learning mutations.",
-    },
-    path: {
-        description: "Optional PM data root override for this invocation.",
-        examples: [".agents/pm"],
-    },
-    scope: {
-        description: "Scope selector for commands that operate on project or global state. Linked files, docs, and tests default to project scope when omitted.",
-        examples: ["project", "global"],
-    },
-    detail: {
-        description: "Detail mode for commands that support concise and deep diagnostics.",
-        examples: ["summary", "deep"],
-    },
-    trace: {
-        description: "When true for extension-doctor, include actionable registration traces in deep diagnostics.",
-    },
-    reload: {
-        description: "When true for extension action payloads, trigger cache-busted extension module reload.",
-    },
-    watch: {
-        description: "When true for extension-reload/extension action payloads, enable watch mode semantics.",
-    },
-    runtimeProbe: {
-        description: "When true for extension-manage, run a doctor-like runtime activation probe for parity fields.",
-    },
-    fixManagedState: {
-        description: "When true for extension-manage/extension-doctor, adopt unmanaged extensions before diagnostics/update checks.",
-    },
-    isolated: {
-        description: "When true for extension-doctor/package-doctor, ignore global registrations for hermetic project diagnostics.",
-    },
-    ignoreGlobal: {
-        description: "Alias for isolated on extension-doctor/package-doctor action payloads.",
-    },
-    target: {
-        description: "Positional target argument for the selected action (ID, source, package source, or extension name).",
-        examples: ["pm-a1b2", ".agents/pm/extensions/sample", "sample-extension"],
-    },
-    capability: {
-        description: "Starter capability selected by extension-init or package-init scaffolding.",
-        examples: ["commands", "hooks", "search", "schema"],
-    },
-    declarative: {
-        description: "Generate the package composeExtension declarative blueprint starter.",
-    },
-    output: {
-        description: "File path for commands that write generated output, such as package/extension describe Markdown references.",
-        examples: ["docs/pm-package-reference.md"],
-    },
-    markdown: {
-        description: "Render the package or extension description as Markdown instead of structured output.",
-        examples: [true],
-    },
-    github: {
-        description: "GitHub shorthand owner/repo[/path] source for package/extension install actions.",
-        examples: ["org/repo/extensions/sample"],
-    },
-    ref: {
-        description: "Git ref/branch/tag used when installing from GitHub shorthand/URL sources.",
-        examples: ["main", "v1.0.0"],
-    },
-    cliOnly: {
-        description: "Restrict upgrade to the pm CLI/SDK npm package.",
-    },
-    packagesOnly: {
-        description: "Restrict upgrade to managed installable pm packages.",
-    },
-    repair: {
-        description: "Force npm global reinstall semantics when upgrading the pm CLI/SDK.",
-    },
-    tag: {
-        description: "npm version or dist-tag used for CLI and registry package upgrades.",
-        examples: ["latest", "next", "2026.5.11"],
-    },
-    today: {
-        description: "When true for list actions, include only items updated since local midnight today.",
-    },
-    recent: {
-        description: "When true for list actions, include only items updated in the last seven days.",
-    },
-    packageName: {
-        description: "Override the pm CLI package name for self-upgrade automation and tests.",
-        examples: ["@unbrained/pm-cli"],
-    },
-    json: {
-        description: "Emit machine-readable JSON output.",
-    },
-    quiet: {
-        description: "Suppress stdout payload output.",
-    },
-    noExtensions: {
-        description: "Disable extension loading for this invocation.",
-    },
-    noPager: {
-        description: "Disable pager integration for help and long output.",
-    },
-    tokenAccounting: {
-        description: "Request a bounded transport-level receipt for output emitted by a compatible CLI or MCP host.",
-    },
-    outputInclude: {
-        description: "Comma-separated fields or sections retained by any built-in read action.",
-        examples: ["id,title,status", "summary,counts"],
-    },
-    outputLimit: {
-        description: "Universal read row ceiling, or unbounded to disable the shared ceiling.",
-        examples: [10, "unbounded"],
-    },
-    outputBudget: {
-        description: "Universal estimated-token ceiling for a read result, or unbounded to disable the shared ceiling.",
-        examples: [600, 1200, "unbounded"],
-    },
-    outputFormat: {
-        description: "Universal read-result encoding selector.",
-        examples: ["toon", "json"],
-    },
-    outputSession: {
-        description: "Caller-carried JSON session state that enforces a token ceiling across read calls and replaces repeated item facts with resolvable context references.",
-        examples: [
-            {
-                version: 1,
-                id: "orientation",
-                token_budget: 4000,
-                spent_tokens: 0,
-                seen_item_ids: [],
-            },
-        ],
-    },
-    outputCursor: {
-        description: "Opaque continuation cursor returned when a declared row collection is compacted by the output budget.",
-    },
-    outputRowContract: {
-        description: "Include the row selector and TOON row-encoding contract on a read result.",
-    },
-    profile: {
-        description: "Emit deterministic timing diagnostics to stderr.",
-    },
-    timeoutMs: {
-        description: "Tool execution timeout in milliseconds.",
-        examples: [120000],
-    },
-    id: {
-        description: "Item identifier for read or mutation actions.",
-        examples: ["pm-a1b2"],
-    },
-    treeId: {
-        description: "Commit, tree, snapshot, or immutable workspace identity judged by an assurance gate.",
-        examples: ["0123456789abcdef", "release-candidate-3"],
-    },
-    definition: {
-        description: "Structured measurement, assertion, or gate declaration used by assurance put.",
-    },
-    trigger: {
-        description: "Lifecycle trigger used to evaluate an assurance gate.",
-        examples: ["ci", "pre-release"],
-    },
-    gate: {
-        description: "Stable assurance gate id used to filter durable verdict history.",
-        examples: ["release-readiness"],
-    },
-    owner: {
-        description: "pm item that owns preset or observation-derived assurance assertions.",
-        examples: ["pm-a1b2"],
-    },
-    enforcement: {
-        description: "Explicit next assurance enforcement level.",
-        examples: ["warn", "block"],
-    },
-    runId: {
-        description: "Background test run identifier.",
-        examples: ["tr-kq9x3f-93acde"],
-    },
-    title: {
-        description: "Item title text.",
-    },
-    description: {
-        description: "Item description text.",
-    },
-    type: {
-        description: "Item type name from the active runtime type registry.",
-        examples: ["Task", "Feature"],
-    },
-    subcommand: {
-        description: "Subcommand selector for schema, profile, telemetry, and graph actions.",
-    },
-    name: {
-        description: "Custom definition name, schema migration source name, or profile name.",
-        examples: ["Spike", "review", "component"],
-    },
-    defaultStatus: {
-        description: "Default status hint recorded for a custom item type.",
-        examples: ["open"],
-    },
-    alias: {
-        description: "Aliases for the custom item type or status (repeatable).",
-        examples: [["spike", "research"]],
-    },
-    role: {
-        description: "Lifecycle roles for a custom status (schema add-status): draft, active, blocked, terminal, terminal_done, terminal_canceled, default_open, default_close, default_cancel.",
-        examples: [["active"], ["terminal", "terminal_done"]],
-    },
-    fieldType: {
-        description: "Value type for a custom field (schema add-field): string, number, boolean, or string_array.",
-        examples: ["string", "number", "string_array"],
-    },
-    fieldTypeScope: {
-        description: "Optional item type restricting which records participate in schema rename-field.",
-        examples: ["Issue", "Feature"],
-    },
-    migrationId: {
-        description: "Optional stable idempotency override used to persist and resume a schema migration plan; omitted values are derived from the workspace and normalized request.",
-        examples: ["severity-to-impact-v2"],
-    },
-    commands: {
-        description: "Commands a custom field is wired onto (schema add-field): create, update, update_many, list, search, calendar, context.",
-        examples: [
-            ["create", "update"],
-            ["create", "update", "list"],
-        ],
-    },
-    cliFlag: {
-        description: "Override the auto-derived CLI flag for a custom field (schema add-field).",
-        examples: ["--owner"],
-    },
-    required: {
-        description: "Mark a custom field as always required (schema add-field).",
-    },
-    requiredOnCreate: {
-        description: "Mark a custom field as required at create time (schema add-field).",
-    },
-    allowUnset: {
-        description: "Whether a custom field may be cleared via --unset (schema add-field); defaults to true.",
-    },
-    allowDuplicate: {
-        description: "Explicitly proceed when strict similarity governance finds likely duplicate items.",
-    },
-    allowUnresolvedDeps: {
-        description: "Permit unresolved local dependency targets while returning dependency_target_unresolved warning receipts. Cross-workspace references should use source_kind=external instead.",
-        examples: [true],
-    },
-    requiredTypes: {
-        description: "Restrict a custom field's requirement to specific item types (schema add-field).",
-        examples: [["Bug"], ["Story", "Spike"]],
-    },
-    infer: {
-        description: "Infer custom item types from title-prefix conventions (schema add-type); previews unless apply is true.",
-    },
-    minCount: {
-        description: "Minimum number of items sharing a title prefix for schema add-type inference (default 10).",
-        examples: [10, 25],
-    },
-    preset: {
-        description: "Governance preset for initialization flows.",
-        examples: ["minimal", "default", "strict"],
-    },
-    idPrefix: {
-        description: "Tracker item identifier prefix used by initialization; overrides the positional compatibility prefix.",
-        examples: ["pm", "work"],
-    },
-    workspace: {
-        description: "Workspace directory where initialization resolves or creates the tracker.",
-        examples: [".", "packages/app"],
-    },
-    typePreset: {
-        description: "Domain item-type preset registered during initialization.",
-        examples: ["agile", "ops", "research"],
-    },
-    defaults: {
-        description: "Use non-interactive setup defaults during initialization.",
-    },
-    verbose: {
-        description: "Include the full resolved settings tree in init output.",
-    },
-    agentGuidance: {
-        description: "Control AGENTS.md/CLAUDE.md guidance behavior during init: ask, add, skip, or status.",
-        examples: ["ask", "add", "skip", "status"],
-    },
-    withPackages: {
-        description: "Install all bundled first-party pm packages during initialization.",
-    },
-    mergeFence: {
-        description: "Install the repository merge-driver fence for a fresh Git-backed tracker; set false to opt out.",
-    },
-    createMode: {
-        description: "Create required-option policy mode.",
-        examples: ["strict", "progressive"],
-    },
-    schedulePreset: {
-        description: "Schedule-centric create preset for Reminder, Meeting, and Event types.",
-        examples: ["lightweight"],
-    },
-    status: {
-        description: "Item status value. Statuses are project-configurable via .agents/pm/settings.json (schema block); the built-in defaults are draft, open, in_progress, blocked, closed, canceled. Custom statuses defined for the project are accepted — discover the active set with the pm_contracts tool (workspace.statuses) or `pm contracts`. Unknown statuses are rejected at runtime with a did-you-mean hint rather than blocked by a fixed schema enum.",
-        examples: ["open", "in_progress"],
-    },
-    since: {
-        description: "Inclusive ISO 8601 creation timestamp lower bound for duplicate discovery.",
-        examples: ["2026-01-01T00:00:00.000Z"],
-    },
-    exhaustive: {
-        description: "Compare every duplicate pair within the disclosed safety bound; default prefix filtering preserves exact recall.",
-    },
-    threshold: {
-        description: "Minimum duplicate similarity score from zero through one.",
-        examples: [0.85],
-    },
-    priority: {
-        description: "Priority value in range 0..4.",
-        examples: [0, 1, "2"],
-    },
-    order: {
-        description: "Planning order/rank value for create/update, or sort direction (asc|desc) for list-family sorting.",
-        examples: [0, 1, "2", "asc", "desc"],
-    },
-    sort: {
-        description: "List-family sort field selector.",
-        examples: [
-            "priority",
-            "deadline",
-            "updated_at",
-            "created_at",
-            "title",
-            "parent",
-        ],
-    },
-    tags: {
-        description: "Comma-delimited tag list.",
-        examples: ["pm-cli,agent-ux"],
-    },
-    addTags: {
-        description: "Tags to add to the existing list without replacing it. Each entry may be CSV or a JSON array.",
-        examples: [["agent-ux"], ["fix", "security"]],
-    },
-    addAc: {
-        description: "Acceptance criteria appended individually without replacing the existing list (one criterion per entry).",
-        examples: [["error path covered by a regression test"]],
-    },
-    removeAc: {
-        description: "Acceptance criteria removed individually by exact text match; the mutation fails atomically if any selector is unmatched (one criterion per entry).",
-        examples: [["superseded manual QA step"]],
-    },
-    removeTags: {
-        description: "Tags to remove from the existing list. Each entry may be CSV or a JSON array.",
-        examples: [["stale"], ["legacy", "wontfix"]],
-    },
-    deadline: {
-        description: "ISO/date timestamp or relative offset (+6h/+1d/+2w/+6m).",
-        examples: ["2026-04-01T00:00:00.000Z", "+1d"],
-    },
-    reminder: {
-        description: "Repeatable reminder seed entries at=<iso|relative>,text=<text>.",
-        examples: [["at=+2d,text=Review PR"]],
-    },
-    event: {
-        description: "Repeatable event seed entries start=<iso|relative> with end=<iso|relative> or duration=<relative|30min|PT30M>. Bare `m` remains months for backward compatibility.",
-        examples: [
-            ["start=2026-07-01T10:00:00Z,duration=2h,title=planning"],
-            ["start=2026-07-01T10:00:00Z,duration=30min,title=standup"],
-            ["start=2026-07-01T10:00:00Z,duration=PT30M,title=window"],
-        ],
-    },
-    historyEvent: {
-        description: "Unknown-author history target in <item-id>:<one-based-line> form.",
-        examples: [["pm-example:4", "pm-example:5"]],
-    },
-    planFingerprint: {
-        description: "Exact SHA-256 returned by a history-author-acknowledge dry-run preview; apply refuses stale or changed source coordinates.",
-        examples: [
-            "0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef",
-        ],
-    },
-    estimate: {
-        description: "Estimated effort in minutes.",
-        examples: [60, "120"],
-    },
-    acceptanceCriteria: {
-        description: "Complete acceptance-criteria text supplied while creating or replacing an item field.",
-    },
-    author: {
-        description: "Intentional mutation-author override. Agent harness identity is automatic when omitted.",
-    },
-    attributedAuthor: {
-        description: "Principal attributed to the immutable unknown-author history events after review.",
-        examples: ["reviewed-principal"],
-    },
-    message: {
-        description: "History message for mutation audit trail.",
-    },
-    ifAbsent: {
-        description: "For annotations, append only when no existing entry has the same resolved author and exact stored text; retries return changed false without a history event.",
-    },
-    assignee: {
-        description: "Assignee identity.",
-    },
-    assigneeFilter: {
-        description: "Assignee presence selector for list, calendar, and context filters.",
-        examples: ["assigned", "unassigned"],
-    },
-    parent: {
-        description: "Parent item ID filter for hierarchical list queries.",
-        examples: ["pm-epic01"],
-    },
-    blockedLimit: {
-        description: "Cap blocked rows returned by the next action (defaults to the ready --limit).",
-        examples: ["3"],
-    },
-    readyOnly: {
-        description: "When true, the next action omits the blocked companion list.",
-    },
-    unset: {
-        description: "Repeatable list of item-metadata fields to clear explicitly during create/update mutations.",
-        examples: [["deadline", "assignee"], ["close-reason"]],
-    },
-    clearDeps: {
-        description: "When true, clear linked dependencies.",
-    },
-    replaceDeps: {
-        description: "When true for update, atomically replace dependencies with the supplied --dep values.",
-    },
-    replaceTests: {
-        description: "When true for update, atomically replace linked tests with the supplied --test values.",
-    },
-    replaceFiles: {
-        description: "When true for update, atomically replace linked files with the supplied --file values.",
-    },
-    replaceDocs: {
-        description: "When true for update, atomically replace linked docs with the supplied --doc values.",
-    },
-    lookupPath: {
-        description: "One or more source paths whose referencing pm items should be returned by files lookup.",
-        examples: [["src/sdk/files.ts"], ["README.md", "docs/SDK.md"]],
-    },
-    explain: {
-        description: "Include ranked linked-file, rationale, and governing-decision evidence for a files lookup.",
-    },
-    lines: {
-        description: "Inclusive start:end source-line range for Git contribution attribution; requires one lookup path.",
-        examples: ["10:24"],
-    },
-    decisionDepth: {
-        description: "Maximum typed relationship depth searched for a governing Decision during files lookup.",
-        examples: [8],
-    },
-    clearComments: {
-        description: "When true, clear item comments.",
-    },
-    clearNotes: {
-        description: "When true, clear item notes.",
-    },
-    clearLearnings: {
-        description: "When true, clear item learnings.",
-    },
-    clearFiles: {
-        description: "When true, clear linked files.",
-    },
-    clearTests: {
-        description: "When true, clear linked tests.",
-    },
-    clearDocs: {
-        description: "When true, clear linked docs.",
-    },
-    clearReminders: {
-        description: "When true, clear reminders.",
-    },
-    clearEvents: {
-        description: "When true, clear events.",
-    },
-    clearTypeOptions: {
-        description: "When true, clear type option metadata.",
-    },
-    clearCriteria: {
-        description: "When true for config set criteria-list keys (definition-of-done, metadata-required-fields, lifecycle pattern lists), clear the criteria list.",
-    },
-    mode: {
-        description: "Mode selector for search and reindex (keyword|semantic|hybrid).",
-        examples: ["keyword", "hybrid"],
-    },
-    semanticWeight: {
-        description: "Per-query hybrid semantic weight override in [0,1] for search action; invalid values fall back to settings.",
-        examples: [0.2, "0.7"],
-    },
-    op: {
-        description: "History operation filter for activity output.",
-        examples: ["create", "update", "close", "update_ownership_bypass"],
-    },
-    fullPeriod: {
-        description: "For day/week/month calendar views, include the full anchored period instead of clipping the start to now.",
-    },
-    progress: {
-        description: "Emit progress diagnostics to stderr for long-running operations.",
-    },
-    background: {
-        description: "Run linked tests in managed background mode.",
-    },
-    addJson: {
-        description: "JSON input: one structured context event for notes, or repeatable linked-test entries for test.",
-        examples: [
-            [
-                `{"command":"node scripts/run-tests.mjs test -- tests/unit/output.spec.ts","timeout_seconds":240}`,
-            ],
-        ],
-    },
-    eventType: {
-        description: "For notes action, return structured context events whose top-level type matches this value.",
-    },
-    includeMeta: {
-        description: "Include structured-event counts for notes reads; filtered reads also include total, returned, limit, and has-more metadata.",
-    },
-    allActionable: {
-        description: "For history-author-acknowledge, select every currently actionable undispositioned event.",
-    },
-    match: {
-        description: "Run only linked tests whose command or path contains this case-insensitive substring.",
-        examples: ["output.spec.ts", "coverage"],
-    },
-    onlyIndex: {
-        description: "Run only the 1-based linked-test index from pm test <id> --list order.",
-        examples: [1, "2"],
-    },
-    removeIndex: {
-        description: "Remove linked tests by their 1-based positions from pm test <id> --list order; repeatable and lossless for commands containing commas or equals signs.",
-        examples: [[1], ["2", "4"]],
-    },
-    onlyLast: {
-        description: "Run only the most recently added linked-test entry.",
-    },
-    envSet: {
-        description: "Repeatable runtime environment KEY=VALUE overrides for linked-test execution.",
-        examples: [["PORT=0", "PLAYWRIGHT_HTML_OPEN=never"]],
-    },
-    envClear: {
-        description: "Repeatable runtime environment variable names to clear before linked-test execution.",
-        examples: [["PLAYWRIGHT_BASE_URL"]],
-    },
-    sharedHostSafe: {
-        description: "Apply additive shared-host-safe runtime defaults during linked-test execution.",
-    },
-    pmContext: {
-        description: "PM linked-test context mode (schema keeps isolated tracker data; tracker seeds source tracker data; auto uses tracker for PM tracker-read linked commands).",
-        examples: ["schema", "tracker", "auto"],
-    },
-    overrideLinkedPmContext: {
-        description: "Force run-level --pm-context to override per-linked-test pm_context_mode metadata for all linked-test entries.",
-    },
-    workspaceContext: {
-        description: "Source-workspace mode: source preserves read-only source context, isolated omits it for self-sandboxing commands, and snapshot runs from a temporary workspace paired with the selected tracker sandbox.",
-        examples: ["source", "isolated", "snapshot"],
-    },
-    overrideLinkedWorkspaceContext: {
-        description: "Force run-level --workspace-context over per-linked-test workspace_context_mode metadata.",
-    },
-    allowUntrustedLinkedTests: {
-        description: "Explicitly execute commands not yet trusted by this clone when testing.allow_untrusted_linked_tests is also enabled.",
-    },
-    acknowledgeLinkedTests: {
-        description: "Record clone-local trust for the item's current linked commands without executing them.",
-    },
-    failOnContextMismatch: {
-        description: "Fail linked PM command runs when source and sandbox tracker item counts differ.",
-    },
-    failOnSkipped: {
-        description: "Treat skipped linked tests as dependency-failed policy violations.",
-    },
-    failOnEmptyTestRun: {
-        description: "Treat successful linked-test commands that report zero executed tests as failures.",
-    },
-    requireAssertionsForPm: {
-        description: "Require assertion metadata for linked PM command test entries during run execution.",
-    },
-    checkContext: {
-        description: "Run linked PM command context preflight diagnostics before command execution.",
-    },
-    autoPmContext: {
-        description: "Auto-remediate PM tracker-read linked commands by routing those entries through tracker context regardless of linked-test pm_context_mode overrides.",
-    },
-    measure: {
-        description: "Repeatable numeric run evidence in name=value[,unit=...][,threshold=...] form.",
-        examples: [["coverage=100,unit=percent,threshold=100"]],
-    },
-    metricBelow: {
-        description: "Return recorded evidence below a name=value threshold.",
-        examples: ["coverage=100"],
-    },
-    metricDiff: {
-        description: "Compare the latest and previous values for one metric.",
-        examples: ["coverage"],
-    },
-    dryRun: {
-        description: "Preview command effects without mutating storage artifacts.",
-    },
-    normalizeProvenance: {
-        description: "For history-repair: remove invalid legacy provenance observations and emit only aggregate privacy-safe repair evidence.",
-    },
-    salvageTail: {
-        description: "For history-repair with one explicit id: remove an invalid trailing suffix after a verified prefix; refuses interior corruption.",
-    },
-    all: {
-        description: "For history-repair action: scan every stream for drift and repair each drifted stream in one audited pass (mutually exclusive with id).",
-    },
-    clear: {
-        description: "For focus action: clear the session focused item instead of setting it (mutually exclusive with id).",
-    },
-    gcScope: {
-        description: "Repeatable gc scope selector values (index, embeddings, runtime, locks, checkpoints, transactions).",
-        examples: [
-            ["index", "embeddings"],
-            ["runtime"],
-            ["locks"],
-            ["checkpoints"],
-        ],
-    },
-    storage: {
-        description: "For stats action: include aggregate history-stream storage metrics (total streams/lines/bytes, largest + deepest streams, oldest/newest entries) for compaction and storage planning.",
-    },
-    fieldUtilization: {
-        description: "For stats action: include a field_utilization block reporting present/total/percent for content fields (notes, learnings, files, docs, tests, comments, deps, body, linked_command) across all items so under-documented dimensions are visible at a glance.",
-    },
-    measurements: {
-        description: "For stats action: include the audited append-only improvement ledger and baseline-to-latest trends.",
-    },
-    metric: {
-        description: "Exact improvement metric name used to filter ledger reads.",
-        examples: ["quality.coverage.lines"],
-    },
-    measurementLimit: {
-        description: "Maximum newest improvement observations returned by stats.",
-        examples: [50],
-    },
-    observe: {
-        description: "Repeatable audited observation in name=value[,unit=...][,threshold=...] form.",
-        examples: [["quality.coverage.lines=100,unit=percent,threshold=100"]],
-    },
-    improvementDirection: {
-        description: "Improvement direction for newly recorded observations.",
-        examples: ["higher", "lower", "target"],
-    },
-    measurementSource: {
-        description: "Producing gate or instrument for a new observation.",
-        examples: ["pnpm coverage"],
-    },
-    measurementItem: {
-        description: "Tracked item that owns an improvement observation.",
-        examples: ["pm-123abc"],
-    },
-    measurementRevision: {
-        description: "Explicit source revision for a new observation.",
-        examples: ["0123456789abcdef"],
-    },
-    provenanceCoverage: {
-        description: "For stats action: compare configured provenance descriptors with bounded immutable-history observations.",
-    },
-    fleetAttribution: {
-        description: "For stats action: derive observational throughput, rework, and defect-escape rates by harness, model, and author source.",
-    },
-    eventLimit: {
-        description: "Maximum immutable history events consumed by an analytics projection.",
-        examples: [10000],
-    },
-    minimumSample: {
-        description: "Minimum denominator before analytics rates are reported.",
-        examples: [5],
-    },
-    offset: {
-        description: "Number of matching rows to skip before limit is applied.",
-        examples: [0, 50, "100"],
-    },
-    provenance: {
-        description: "Return patch-free immutable author, harness, instance, and extensible provenance rows.",
-    },
-    provenanceSummary: {
-        description: "Include bounded observed, unavailable, legacy-missing, and unresolved-author counts.",
-    },
-    agentInstance: {
-        description: "Privacy-safe agent invocation fingerprint filter, supplied once or as a list.",
-        examples: ["a1b2c3d4", ["a1b2c3d4", "e5f6g7h8"]],
-    },
-    provenanceFilter: {
-        description: "Exact extensible provenance predicate in dimension=value form, supplied once or as a list.",
-        examples: ["model=gpt-5.6-sol", ["effort=xhigh", "role=reviewer"]],
-    },
-    before: {
-        description: "For history-compact, compact entries strictly before this boundary (version number or ISO timestamp). Single-id mode only.",
-        examples: ["5", "2026-06-01T00:00:00.000Z"],
-    },
-    at: {
-        description: "Read-only historical projection boundary as an item version or ISO timestamp.",
-        examples: ["3", "2026-07-01T12:00:00.000Z"],
-    },
-    allOver: {
-        description: "For history-compact bulk mode, compact every stream with more than N entries. When history.compact_policy is enabled and this is omitted, the policy's max_entries is used.",
-        examples: [200, "500"],
-    },
-    minEntries: {
-        description: "For history-compact bulk mode, skip streams with at most N entries as already-compact (default 3).",
-        examples: [3, "10"],
-    },
-    closed: {
-        description: "For history-compact bulk mode, compact only closed (terminal) items' history streams.",
-    },
-    allStreams: {
-        description: "For history-compact bulk mode, compact every history stream regardless of lifecycle state.",
-    },
-    literal: {
-        description: "Repeatable literal matcher used by history-redact to scrub exact string values.",
-        examples: ["[redacted_path_prefix]/private/path"],
-    },
-    regex: {
-        description: "Repeatable regex matcher used by history-redact. Accepts either /pattern/flags or a raw pattern (global mode is auto-enabled).",
-        examples: ["/192\\\\.168\\\\.[0-9.]+/g", "token=[A-Za-z0-9_-]+"],
-    },
-    replacement: {
-        description: 'Replacement text used by history-redact (defaults to "[redacted]").',
-        examples: ["[scrubbed_path]"],
-    },
-    validateClose: {
-        description: 'Close-time metadata validation mode ("off", "warn", or "strict").',
-        examples: ["off", "warn", "strict"],
-    },
-    checkMetadata: {
-        description: "Run metadata completeness checks.",
-    },
-    metadataProfile: {
-        description: "Select metadata validation profile for --check-metadata.",
-        examples: ["core", "strict", "custom"],
-    },
-    checkResolution: {
-        description: "Run closed-item resolution metadata checks.",
-    },
-    checkLifecycle: {
-        description: "Run active-item lifecycle governance drift checks.",
-    },
-    checkStaleBlockers: {
-        description: "Include stale blocker-pattern diagnostics in lifecycle checks.",
-    },
-    dependencyCycleSeverity: {
-        description: "Set dependency-cycle warning policy for lifecycle checks.",
-        examples: ["off", "warn", "error"],
-    },
-    parentCycleSeverity: {
-        description: "Set parent-cycle warning policy for lifecycle checks.",
-        examples: ["off", "warn", "error"],
-    },
-    checkFiles: {
-        description: "Run linked-file and orphaned-file checks.",
-    },
-    checkStorageIntegrity: {
-        description: "Run deep item, history, index, and vector storage integrity checks.",
-    },
-    strictDirectories: {
-        description: "Treat optional item-type directories as required health failures.",
-    },
-    requireMergeDrivers: {
-        description: "Treat never-installed clone-local semantic merge drivers as required health failures.",
-    },
-    checkOnly: {
-        description: "For health action, run read-only diagnostics without refreshing vectors.",
-    },
-    checkTelemetry: {
-        description: "For health action, probe telemetry endpoint health and include network diagnostics.",
-    },
-    noRefresh: {
-        description: "For health action, skip vector refresh while still running checks.",
-    },
-    refreshVectors: {
-        description: "For health action, explicitly refresh stale vectors.",
-    },
-    verboseStaleItems: {
-        description: "For health action, include full stale-item arrays in vectorization details.",
-    },
-    verboseAuthorEvents: {
-        description: "For health action, include every actionable unknown-author event coordinate.",
-    },
-    skipVectors: {
-        description: "For health action, skip vectorization checks for a faster diagnostic run.",
-    },
-    skipIntegrity: {
-        description: "For health action, skip item/history file integrity checks for a faster diagnostic run.",
-    },
-    skipDrift: {
-        description: "For health action, skip history drift hash checks for a faster diagnostic run.",
-    },
-    scanMode: {
-        description: "Select file candidate scan mode for --check-files.",
-        examples: ["default", "tracked-all", "tracked-all-strict"],
-    },
-    includePmInternals: {
-        description: "Include PM storage internals in tracked-all candidate scans.",
-    },
-    verboseFileLists: {
-        description: "For validate action, include full file-path lists for --check-files details.",
-    },
-    verboseDiagnostics: {
-        description: "For validate action, include full diagnostic ID lists instead of compact summaries.",
-    },
-    strictExit: {
-        description: "Apply the selected capability's strict exit policy; health also requires merge drivers.",
-    },
-    failOnWarn: {
-        description: "Alias for strictExit in health, validation, history, and managed doctor actions.",
-    },
-    fixHints: {
-        description: "For validate action, add a machine-executable fix_hints[] of pm commands to each failing check's details.",
-    },
-    autoFix: {
-        description: "For validate action, apply the safe, deterministic subset of fix-hint remediations (field backfills) automatically; combine with dryRun to preview and fixScope to grant gated scopes.",
-    },
-    fixScope: {
-        description: "For validate action, grant --auto-fix scopes (metadata, resolution, estimates, lifecycle). Defaults to the safe scopes metadata and resolution; estimates (per-type default estimated_minutes backfill) and lifecycle must be named explicitly.",
-        examples: [["estimates"], ["lifecycle"], ["metadata", "resolution"]],
-    },
-    pruneMissing: {
-        description: "For validate action, remove stale linked-file/doc LINKS whose paths classified as deleted (link removal only — never touches real files); honors dryRun.",
-    },
-    checkHistoryDrift: {
-        description: "Run item/history hash drift checks.",
-    },
-    checkCommandReferences: {
-        description: "Run linked-command PM-ID reference checks.",
-    },
-    edit: {
-        description: "For comments, notes, and learnings actions, replace the annotation at this 1-based index with supplied replacement text.",
-    },
-    delete: {
-        description: "For comments, notes, and learnings actions, delete the annotation at this 1-based index.",
-    },
-    stdin: {
-        description: "For comments, notes, and learnings actions, read annotation text from piped stdin (supports multiline markdown).",
-    },
-    file: {
-        description: "CLI-only path to an input file for commands that read payload text; tool actions exclude host file access.",
-        examples: ["notes/comment.md"],
-    },
-    preserveSourceIds: {
-        description: "Preserve explicit source IDs during Beads imports instead of normalizing to tracker prefix.",
-        examples: [true],
-    },
-    appendStable: {
-        description: "When true for files action, preserve existing linked-file order and append new links without full-array resorting.",
-    },
-    discover: {
-        description: "When true for files action, use `pm files discover <id>` to scan item text for referenced file paths.",
-    },
-    apply: {
-        description: "Persist changes instead of returning a dry-run preview: for files discovery, add the missing discovered file links; for schema add-type --infer, register the inferred custom item types.",
-    },
-    discoveryNote: {
-        description: "Note attached to file links added by files discovery.",
-        examples: ["discovered from item text"],
-    },
-    addNote: {
-        description: "Note attached to every link added by add/addGlob in this call (per-entry embedded note= wins; requires add or addGlob). Maps to the CLI --note flag on pm files/pm docs.",
-        examples: ["command wiring"],
-    },
-    list: {
-        description: "When true, list command-specific entries without mutating state (for example linked paths for files/docs or topics for guide).",
-        examples: [true],
-    },
-    stream: {
-        description: "Stream selector: test-runs logs accepts stdout|stderr|both; activity accepts boolean/rows|ndjson|jsonl for line-delimited output.",
-        examples: ["stderr", "stdout", "both", "rows", "ndjson", "jsonl", true],
-    },
-    tail: {
-        description: "Number of lines to tail for background run logs.",
-        examples: [100],
-    },
-    query: {
-        description: "Search query text for search action.",
-    },
-    for: {
-        description: "Named context intent projection declared for the selected read action.",
-        examples: ["orient", "inspect", "triage", "execute", "discover"],
-    },
-    keywords: {
-        description: "Alias for query in search action payloads.",
-    },
-    includeLinked: {
-        description: "Include readable linked docs/files/tests content in keyword and hybrid lexical scoring.",
-    },
-    titleExact: {
-        description: "For search action, require exact normalized title match for the full query string.",
-    },
-    phraseExact: {
-        description: "For search action, require exact normalized query phrase match in item text fields.",
-    },
-    highlight: {
-        description: "For search action, emit per-field matched-text snippets (wrapped in «…») on each hit. Off by default.",
-    },
-    includeBody: {
-        description: "When true for list-family actions, include item body text in projected rows.",
-    },
-    noTruncate: {
-        description: "When true for list-family actions, return every matched row, overriding any limit (surfaces total when rows were dropped).",
-    },
-    strictRead: {
-        description: "When true for list-family actions, fail if any source item or item directory cannot be read.",
-    },
-    compact: {
-        description: "Render compact projection output for search and list-family actions.",
-    },
-    raw: {
-        description: "For activity, restore the compact per-event stream instead of the default item digest.",
-    },
-    brief: {
-        description: "Emit compact low-token output for commands that support terse projections or health details.",
-        examples: [true],
-    },
-    full: {
-        description: "Enable command-specific full/detail output mode when supported, such as deep item reads for get or full payload mode for search/history.",
-    },
-    includeEmpty: {
-        description: "For stats, restore zero-count registered type and lifecycle-status buckets.",
-    },
-    fields: {
-        description: "Comma-separated projection fields for get, search, list-family, or context outputs. Valid field names are command-specific (e.g. score/matched_fields apply to search; context projects focus-row fields such as priority/deadline/completion_pct).",
-        examples: [
-            "id,title,status,parent,type",
-            "id,title,score,matched_fields",
-            "id,title,priority,deadline",
-        ],
-    },
-    groupBy: {
-        description: "Comma-separated aggregate grouping fields (supported: parent,type,priority,status,assignee,tags,sprint,release).",
-        examples: [
-            "parent,type",
-            "type,status",
-            "priority,assignee",
-            "tags",
-            "sprint,release",
-        ],
-    },
-    count: {
-        description: "Enable grouped count output for aggregate action.",
-    },
-    completion: {
-        description: "For aggregate action, add open/in_progress/closed/other counts and completion_pct per group.",
-    },
-    sum: {
-        description: "Numeric field to sum per aggregate group (count and null_count are still returned).",
-        examples: ["estimated_minutes", "priority"],
-    },
-    avg: {
-        description: "Numeric field to average per aggregate group (count and null_count are still returned).",
-        examples: ["estimated_minutes", "priority"],
-    },
-    tree: {
-        description: "When true for list/get actions, render recursive parent/child tree ordering.",
-    },
-    treeDepth: {
-        description: "Maximum recursion depth for tree output (0 keeps root rows only).",
-        examples: [0, 1, "2"],
-    },
-    includeUnparented: {
-        description: "Include unparented rows when aggregate grouping includes parent.",
-    },
-    maxDepth: {
-        description: "Maximum dependency traversal depth for deps action (0 keeps only the root node).",
-        examples: [0, 1, "2"],
-    },
-    nodeLimit: {
-        description: "Maximum related nodes returned by deps --format context.",
-        examples: [10, "20"],
-    },
-    edgeLimit: {
-        description: "Maximum related edges returned by deps --format context.",
-        examples: [20, "40"],
-    },
-    tokenBudget: {
-        description: "Maximum estimated output tokens for the command output.",
-        examples: [600, "1200"],
-    },
-    cursor: {
-        description: "Opaque continuation cursor returned by deps --format context.",
-    },
-    direction: {
-        description: 'Graph-context traversal direction for deps action ("outgoing", "incoming", or "both").',
-        examples: ["both", "incoming"],
-    },
-    kind: {
-        description: "Registered relationship kinds narrowing deps --format context traversal (string, comma-separated, or array).",
-        examples: ["blocked_by", ["parent", "related"]],
-    },
-    after: {
-        description: "Continuation cursor resuming a bounded listing or traversal after this previously returned id.",
-        examples: ["pm-x1y2"],
-    },
-    maxPaths: {
-        description: "Maximum enumerated paths for graph paths queries.",
-        examples: [5, "10"],
-    },
-    sample: {
-        description: "Maximum evidence sample entries per graph audit finding.",
-        examples: [10, "25"],
-    },
-    exemptIsolate: {
-        description: "Item ids the graph audit treats as explicitly valid isolates (string, comma-separated, or array).",
-        examples: ["pm-x1y2", ["pm-x1y2", "pm-a3b4"]],
-    },
-    exemptIsolateType: {
-        description: "Item types whose active isolates the graph audit treats as policy-valid (string, comma-separated, or array).",
-        examples: ["Reminder", ["Reminder", "Event"]],
-    },
-    saveBaseline: {
-        description: "When true, persist the graph audit census as the change-since-baseline comparison point (audit only).",
-    },
-    rebuild: {
-        description: "When true, rebuild and warm the durable graph index (graph index only).",
-    },
-    collapse: {
-        description: 'Dependency tree collapse mode for deps action ("none" or "repeated").',
-        examples: ["none", "repeated"],
-    },
-    summary: {
-        description: "When true, return the command's compact summary projection (deps counts, health rollup, or contracts command intents).",
-    },
-    shell: {
-        description: "Shell target for completion generation.",
-        examples: ["bash"],
-    },
-    eagerTags: {
-        description: "When true for completion, eagerly embed current tracker tags into generated scripts (legacy mode).",
-    },
-    contractAction: {
-        description: "Filter contracts schema to one tool action.",
-        examples: ["create", "update"],
-    },
-    command: {
-        description: "Scope contracts output to one CLI command name; action/schema surfaces narrow by default.",
-        examples: ["create", "search", "list"],
-    },
-    schemaOnly: {
-        description: "When true, contracts action returns schema-focused payloads (mutually exclusive with flagsOnly/availabilityOnly).",
-    },
-    flagsOnly: {
-        description: "When true, contracts action returns only command flag surface payloads (mutually exclusive projection mode).",
-    },
-    availabilityOnly: {
-        description: "When true, contracts action returns only action availability payloads (mutually exclusive projection mode).",
-    },
-    runtimeOnly: {
-        description: "When true, contracts action only includes actions invocable in the current runtime.",
-    },
-    activeOnly: {
-        description: "Alias for runtimeOnly in contracts action payloads.",
-    },
-    depth: {
-        description: "Context depth level controlling how many sections are included (brief=focus+agenda, standard=+hierarchy/activity/progress/workload, deep=all sections, full=every section with no per-section row cap).",
-        examples: ["brief", "standard", "deep", "full"],
-    },
-    section: {
-        description: "Repeatable section selector for context; overrides --depth when provided.",
-        examples: [
-            ["hierarchy", "activity"],
-            ["blockers", "files", "staleness"],
-        ],
-    },
-    activityLimit: {
-        description: "Maximum number of recent activity entries to include in context output.",
-        examples: [5, 10, "20"],
-    },
-    staleThreshold: {
-        description: "Staleness cutoff in days for context staleness section (e.g. 7 or 7d).",
-        examples: ["7", "14d", "30"],
-    },
-};
-/**
- * Per-action overrides for tool parameters that are shared across actions in the
- * aggregated `pm_run` schema. The action-scoped strict schema builds one sub-schema per
- * action, but every action reuses the single {@link PM_TOOL_PARAMETER_METADATA} entry
- * for a given parameter — so a parameter used by more than one action (notably `name`,
- * carried by both `schema` and `profile`) would otherwise describe every action's usage
- * inside every action's schema (the `schema` action mentioning profiles and vice versa).
- * Keying the override by action then parameter lets each action carry only its own usage,
- * matching the action-specific descriptions on the narrow pm_schema / pm_profile tools
- * (pm-fq80). The flat provider schema keeps using {@link PM_TOOL_PARAMETER_METADATA}
- * because its single `name` property must cover every action at once.
- */
-export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
-    "health": { strictExit: { description: "Return non-zero for a failing health verdict; also require merge drivers." } },
-    "validate": { strictExit: { description: "Return non-zero when validation reports warnings." } },
-    "extension-doctor": { strictExit: { description: "Return non-zero when extension diagnostics report warnings or a non-ok summary." } },
-    "package-doctor": { strictExit: { description: "Return non-zero when package diagnostics report warnings or a non-ok summary." } },
-    "history": { strictExit: { description: "Return non-zero for history verification failures when verify is enabled." } },
-    extension: { strictExit: { description: "For doctor operations, return non-zero on warnings or a non-ok diagnostic summary." } },
-    package: { strictExit: { description: "For doctor operations, return non-zero on warnings or a non-ok diagnostic summary." } },
-    assurance: {
-        subcommand: {
-            description: "Assurance operation: list, show, put, remove, run, verdicts, presets, apply, derive, promote, risk, or lineages.",
-            examples: ["list", "run", "risk", "lineages"],
-        },
-        kind: {
-            description: "Assurance declaration kind for registry operations: measurement, assertion, or gate.",
-            examples: ["measurement", "assertion", "gate"],
-        },
-        id: {
-            description: "Stable assurance declaration id or gate id, depending on subcommand.",
-            examples: ["active-issues", "release-readiness"],
-        },
-        limit: {
-            description: "Maximum number of newest assurance verdicts returned.",
-            examples: [10, 25],
-        },
-        preset: {
-            description: "Built-in assurance project shape to preview or apply.",
-            examples: ["software-delivery", "agent-evaluation"],
-        },
-    },
-    update: {
-        acceptanceCriteria: {
-            description: "Complete acceptance-criteria replacement text. Use removeAc plus addAc together for an atomic one-entry repair that preserves unrelated criteria.",
-        },
-    },
-    "update-many": {
-        acceptanceCriteria: {
-            description: "Complete acceptance-criteria replacement text. Use removeAc plus addAc together for an atomic one-entry repair that preserves unrelated criteria.",
-        },
-    },
-    stats: {
-        since: {
-            description: "Inclusive ISO 8601 timestamp or negative duration lower bound for provenance and fleet analytics.",
-            examples: ["2026-08-01T00:00:00.000Z", "-30d"],
-        },
-    },
-    events: {
-        since: {
-            description: "Durable event cursor returned as next_cursor, or an inclusive event timestamp.",
-            examples: ["eyJmaW5nZXJwcmludCI6Ii4uLiJ9", "2026-08-01T00:00:00.000Z"],
-        },
-        type: {
-            description: "Mutation event type filter, supplied once or as a list.",
-            examples: ["create", ["create", "update"]],
-        },
-        author: {
-            description: "Mutation author filter, supplied once or as a list.",
-            examples: ["agent-a", ["agent-a", "agent-b"]],
-        },
-        item: {
-            description: "Tracked item id filter, supplied once or as a list.",
-            examples: ["pm-a1b2", ["pm-a1b2", "pm-c3d4"]],
-        },
-        limit: {
-            description: "Maximum mutation events returned, from 0 through 1000.",
-            examples: [0, 100],
-        },
-        cursorMode: {
-            description: "Cursor framing: batch returns one terminal next_cursor (default); row also adds a cursor to every event.",
-            examples: ["batch", "row"],
-        },
-    },
-    remind: {
-        at: {
-            description: "Reminder time as an ISO 8601 timestamp or supported relative expression.",
-            examples: ["2026-08-02T09:00:00+02:00", "tomorrow 09:00"],
-        },
-    },
-    deps: {
-        tokenBudget: {
-            description: "Maximum estimated output tokens for deps --format context.",
-            examples: [600, "1200"],
-        },
-    },
-    comments: {
-        full: {
-            description: "Return the complete post-mutation comment history instead of the bounded mutation receipt projection.",
-        },
-        ifAbsent: {
-            description: "Append a comment only when the resolved author and exact stored text are absent; a duplicate retry returns changed false without writing history.",
-        },
-    },
-    notes: {
-        full: {
-            description: "Return the complete post-mutation note history instead of the bounded mutation receipt projection.",
-        },
-        ifAbsent: {
-            description: "Append a note only when the resolved author and exact stored text are absent; a duplicate retry returns changed false without writing history.",
-        },
-        since: {
-            description: "Inclusive ISO 8601 creation timestamp lower bound for structured note event filtering.",
-            examples: ["2026-01-01T00:00:00.000Z"],
-        },
-    },
-    learnings: {
-        full: {
-            description: "Return the complete post-mutation learning history instead of the bounded mutation receipt projection.",
-        },
-        ifAbsent: {
-            description: "Append a learning only when the resolved author and exact stored text are absent; a duplicate retry returns changed false without writing history.",
-        },
-    },
-    next: {
-        tag: {
-            description: "Only recommend items carrying this exact tag.",
-            examples: ["sdk", "release"],
-        },
-        tokenBudget: {
-            description: "Maximum estimated output tokens for the recommendation context.",
-            examples: [600, "1200"],
-        },
-    },
-    claim: {
-        tag: {
-            description: "When claiming the next item, only consider work carrying this exact tag.",
-            examples: ["sdk", "release"],
-        },
-        tokenBudget: {
-            description: "Maximum estimated output tokens for the next-item context returned with the claim.",
-            examples: [600, "1200"],
-        },
-    },
-    close: {
-        text: {
-            description: "Backward-compatible alias for the item close reason when reason is not provided.",
-        },
-    },
-    "close-task": {
-        text: {
-            description: "Close reason used before releasing the item's active assignment.",
-        },
-    },
-    schema: {
-        name: {
-            description: "Custom item type name (add-type/remove-type/show), custom status id (show-status/add-status/remove-status), or custom field key (add-field/remove-field/show-field). Required for those subcommands.",
-            examples: ["Spike", "review", "component"],
-        },
-    },
-    profile: {
-        name: {
-            description: "Profile name for show/apply/lint. Built-in profiles are agile, ops, and research; an active extension can contribute additional archetype names that resolve here too.",
-            examples: ["agile", "ops", "research"],
-        },
-    },
-    graph: {
-        subcommand: {
-            description: "Graph query selector: ancestors|descendants|predecessors|successors|paths|impact|analyze|audit|communities|redundancy|dominators|slack|centrality|articulation|plan|index. Traversals, paths, impact, and dominators require id; paths also requires target; slack reports critical-path float, centrality ranks betweenness/closeness/degree, articulation reports cut points and bridges; plan derives dry-run remediation proposals from the governance audit; index reports, rebuilds, or clears the durable cross-process graph index.",
-            examples: ["successors", "audit"],
-        },
-        clear: {
-            description: "When true, delete the durable graph index (graph index only).",
-        },
-        id: {
-            description: "Root item id for traversal, paths, impact, and dominators graph queries.",
-            examples: ["pm-x1y2"],
-        },
-        target: {
-            description: "Target item id for graph paths queries.",
-            examples: ["pm-a3b4"],
-        },
-        direction: {
-            description: 'Edge orientation for graph paths/impact/dominators queries ("outgoing", "incoming", or "both"; default "both").',
-            examples: ["incoming"],
-        },
-        kind: {
-            description: "Registered relationship kinds narrowing the graph query (string, comma-separated, or array).",
-            examples: ["blocked_by", ["parent", "related"]],
-        },
-        maxDepth: {
-            description: "Maximum graph traversal depth (non-negative integer).",
-            examples: [2, "4"],
-        },
-        after: {
-            description: "Resume a hierarchy/ordering graph traversal after this previously returned node id.",
-            examples: ["pm-x1y2"],
-        },
-        limit: {
-            description: "Maximum returned rows per bounded graph collection (traversal ids, impact rows, analyze/communities samples, redundancy rows, dominator bottlenecks).",
-            examples: [10, "25"],
-        },
-        summary: {
-            description: "When true, return counts-first graph envelopes without row collections.",
-        },
-    },
-};
+!(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]="13afdd63-c264-5e19-a574-4067594b535b")}catch(e2){}})();import{PLAN_HARNESS_VALUES,PLAN_MODE_VALUES,PLAN_STEP_LINK_KIND_VALUES,PLAN_STEP_STATUS_VALUES}from"../../types/index.js";import{PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS}from"../read-output-session.js";import{ASSURANCE_DEFINITION_SCHEMA}from"./schemas/assurance-definition.js";const PM_TOOL_PARAMETER_PROPERTIES={json:{type:"boolean",default:true},quiet:{type:"boolean"},profile:{type:"boolean"},noExtensions:{type:"boolean"},noPager:{type:"boolean"},tokenAccounting:{type:"boolean"},outputInclude:{type:"string",minLength:1},outputLimit:{anyOf:[{type:"integer",minimum:1},{const:"unbounded"}]},outputBudget:{anyOf:[{type:"integer",minimum:1},{const:"unbounded"}]},outputFormat:{type:"string",enum:["json","toon"]},outputSession:{anyOf:[{type:"string",minLength:1},{type:"object",additionalProperties:false,required:["version","id","token_budget","spent_tokens","seen_item_ids"],properties:{version:{const:1},id:{type:"string",pattern:"^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$"},token_budget:{type:"integer",minimum:256},spent_tokens:{type:"integer",minimum:0},seen_item_ids:{type:"array",maxItems:PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS,items:{type:"string",pattern:"^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$"}}}}]},outputCursor:{type:"string",minLength:1},outputRowContract:{type:"boolean"},path:{type:"string"},pmExecutable:{type:"string"},timeoutMs:{type:"number"},id:{type:"string"},target:{type:"string"},snapshotAction:{type:"string",enum:["create","list","inspect","restore","delete"]},artifact:{type:"string",enum:["item","history","relationship","json"]},basePath:{type:"string"},oursPath:{type:"string"},theirsPath:{type:"string"},outputPath:{type:"string"},itemPath:{type:"string"},prefer:{type:"string",enum:["ours","theirs"]},includeReconciled:{type:"boolean"},lockTtlSeconds:{type:"number"},lockWaitMs:{type:"number"},capability:{type:"string",minLength:1},declarative:{type:"boolean"},output:{type:"string",minLength:1},markdown:{type:"boolean"},init:{type:"boolean"},install:{type:"boolean"},uninstall:{type:"boolean"},explore:{type:"boolean"},manage:{type:"boolean"},describe:{type:"boolean"},doctor:{type:"boolean"},catalog:{type:"boolean"},adopt:{type:"boolean"},adoptAll:{type:"boolean"},activate:{type:"boolean"},deactivate:{type:"boolean"},filterFilesMissing:{type:"boolean"},filterDocsMissing:{type:"boolean"},matchMode:{type:"string",enum:["all","any","phrase"]},minScore:{anyOf:[{type:"number"},{type:"string",pattern:"^\\d+(\\.\\d+)?$"}]},rank:{anyOf:[{type:"number"},{type:"string",pattern:"^-?\\d+$"}]},exemptIsolateType:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},saveBaseline:{type:"boolean"},rebuild:{type:"boolean"},github:{type:"string"},ref:{type:"string"},query:{type:"string"},queries:{type:"string"},k:{anyOf:[{type:"number"},{type:"string"}]},failUnder:{anyOf:[{type:"number"},{type:"string"}]},for:{type:"string",minLength:1},keywords:{type:"string"},fields:{type:"string"},sort:{type:"string",enum:["priority","deadline","updated_at","created_at","title","parent"]},prefix:{type:"string"},idPrefix:{type:"string"},workspace:{type:"string"},preset:{type:"string",enum:["minimal","default","strict","custom"]},typePreset:{type:"string",enum:["agile","ops","research"]},defaults:{type:"boolean"},verbose:{type:"boolean"},agentGuidance:{type:"string",enum:["ask","add","skip","status"]},withPackages:{type:"boolean"},mergeFence:{type:"boolean"},scope:{type:"string",enum:["project","global"]},allOver:{type:"number"},minEntries:{type:"number"},closed:{type:"boolean"},allStreams:{type:"boolean"},contractAction:{type:"string"},command:{type:"string"},summary:{type:"boolean"},schemaOnly:{type:"boolean"},flagsOnly:{type:"boolean"},availabilityOnly:{type:"boolean"},runtimeOnly:{type:"boolean"},activeOnly:{type:"boolean"},eagerTags:{type:"boolean"},fullChangedFields:{type:"boolean"},provenance:{type:"boolean"},provenanceSummary:{type:"boolean"},agentInstance:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},provenanceFilter:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},idOnly:{type:"boolean"},allowMissingParent:{type:"boolean"},allowUnresolvedDeps:{type:"boolean"},allowDuplicate:{type:"boolean"},duplicateOf:{type:"string"},configAction:{type:"string",enum:["get","set","list","export"]},key:{type:"string"},title:{type:"string"},item:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},start:{type:"string"},duration:{type:"string"},end:{type:"string"},location:{type:"string"},timezone:{type:"string"},allDay:{type:"boolean"},description:{type:"string"},type:{type:"string"},template:{type:"string"},createMode:{type:"string",enum:["strict","progressive"]},schedulePreset:{type:"string",enum:["lightweight"]},status:{type:"string"},since:{type:"string",format:"date-time"},cursorMode:{type:"string",enum:["batch","row"]},exhaustive:{type:"boolean"},threshold:{type:"number",minimum:0,maximum:1},filterStatus:{type:"string"},filterType:{type:"string"},filterTag:{type:"string"},filterPriority:{anyOf:[{type:"string"},{type:"number"}]},filterDeadlineBefore:{type:"string"},filterDeadlineAfter:{type:"string"},filterUpdatedAfter:{type:"string"},filterUpdatedBefore:{type:"string"},filterCreatedAfter:{type:"string"},filterCreatedBefore:{type:"string"},filterAssignee:{type:"string"},filterAssigneeFilter:{type:"string",enum:["assigned","unassigned"]},filterParent:{type:"string"},filterSprint:{type:"string"},filterRelease:{type:"string"},closeReason:{type:"string"},completedAt:{type:"string",format:"date-time"},reason:{type:"string"},priority:{anyOf:[{type:"string"},{type:"number"}]},tags:{type:"string"},addTags:{type:"array",items:{type:"string"}},removeTags:{type:"array",items:{type:"string"}},addAc:{type:"array",items:{type:"string"}},removeAc:{type:"array",items:{type:"string"}},body:{type:"string"},deadline:{type:"string"},estimate:{anyOf:[{type:"string"},{type:"number"}]},acceptanceCriteria:{type:"string"},author:{type:"string"},message:{type:"string"},owner:{type:"string"},enforcement:{type:"string"},assignee:{type:"string"},assigneeFilter:{type:"string",enum:["assigned","unassigned"]},parent:{type:"string"},reviewer:{type:"string"},attributedAuthor:{type:"string"},planFingerprint:{type:"string",pattern:"^[a-f0-9]{64}$"},historyEvent:{type:"array",items:{type:"string"}},risk:{type:"string"},confidence:{anyOf:[{type:"string"},{type:"number"}]},sprint:{type:"string"},release:{type:"string"},blockedBy:{type:"string"},blockedReason:{type:"string"},unblockNote:{type:"string"},reporter:{type:"string"},severity:{type:"string"},environment:{type:"string"},reproSteps:{type:"string"},resolution:{type:"string"},expectedResult:{type:"string"},actualResult:{type:"string"},affectedVersion:{type:"string"},fixedVersion:{type:"string"},component:{type:"string"},regression:{anyOf:[{type:"boolean"},{type:"string"},{type:"number"}]},customerImpact:{type:"string"},definitionOfReady:{type:"string"},order:{anyOf:[{type:"string"},{type:"number"}]},goal:{type:"string"},objective:{type:"string"},value:{type:"string"},impact:{type:"string"},outcome:{type:"string"},whyNow:{type:"string"},mode:{type:"string",enum:["keyword","semantic","hybrid"]},semanticWeight:{anyOf:[{type:"string"},{type:"number"}]},op:{type:"string"},compact:{type:"boolean"},raw:{type:"boolean"},brief:{type:"boolean"},full:{type:"boolean"},includeEmpty:{type:"boolean"},view:{type:"string",enum:["agenda","day","week","month"]},date:{type:"string"},from:{type:"string"},before:{type:"string"},at:{type:"string"},to:{type:"string"},migrationId:{type:"string"},fieldTypeScope:{type:"string"},past:{type:"boolean"},fullPeriod:{type:"boolean"},include:{type:"string"},recurrenceLookaheadDays:{anyOf:[{type:"string"},{type:"number"}]},recurrenceLookbackDays:{anyOf:[{type:"string"},{type:"number"}]},occurrenceLimit:{anyOf:[{type:"string"},{type:"number"}]},includeLinked:{type:"boolean"},semantic:{type:"boolean"},hybrid:{type:"boolean"},titleExact:{type:"boolean"},phraseExact:{type:"boolean"},highlight:{type:"boolean"},includeBody:{type:"boolean"},noTruncate:{type:"boolean"},strictRead:{type:"boolean"},tag:{type:"string"},deadlineBefore:{type:"string"},deadlineAfter:{type:"string"},today:{type:"boolean"},recent:{type:"boolean"},updatedAfter:{type:"string"},updatedBefore:{type:"string"},createdAfter:{type:"string"},createdBefore:{type:"string"},filterAcMissing:{type:"boolean"},filterEstimatesMissing:{type:"boolean"},filterResolutionMissing:{type:"boolean"},filterMetadataMissing:{type:"boolean"},filterReviewerMissing:{type:"boolean"},filterRiskMissing:{type:"boolean"},filterConfidenceMissing:{type:"boolean"},filterSprintMissing:{type:"boolean"},filterReleaseMissing:{type:"boolean"},hasNotes:{type:"boolean"},noNotes:{type:"boolean"},hasLearnings:{type:"boolean"},noLearnings:{type:"boolean"},hasFiles:{type:"boolean"},noFiles:{type:"boolean"},hasDocs:{type:"boolean"},noDocs:{type:"boolean"},hasTests:{type:"boolean"},noTests:{type:"boolean"},hasComments:{type:"boolean"},noComments:{type:"boolean"},hasDeps:{type:"boolean"},noDeps:{type:"boolean"},hasBody:{type:"boolean"},emptyBody:{type:"boolean"},hasLinkedCommand:{type:"boolean"},noLinkedCommand:{type:"boolean"},filterHasNotes:{type:"boolean"},filterNoNotes:{type:"boolean"},filterHasLearnings:{type:"boolean"},filterNoLearnings:{type:"boolean"},filterHasFiles:{type:"boolean"},filterNoFiles:{type:"boolean"},filterHasDocs:{type:"boolean"},filterNoDocs:{type:"boolean"},filterHasTests:{type:"boolean"},filterNoTests:{type:"boolean"},filterHasComments:{type:"boolean"},filterNoComments:{type:"boolean"},filterHasDeps:{type:"boolean"},filterNoDeps:{type:"boolean"},filterHasBody:{type:"boolean"},filterEmptyBody:{type:"boolean"},filterHasLinkedCommand:{type:"boolean"},filterNoLinkedCommand:{type:"boolean"},ids:{type:"string"},limit:{anyOf:[{type:"string"},{type:"number"}]},blockedLimit:{anyOf:[{type:"string"},{type:"number"}]},readyOnly:{type:"boolean"},offset:{anyOf:[{type:"string"},{type:"number"}]},progress:{type:"boolean"},background:{type:"boolean"},runId:{type:"string"},stream:{anyOf:[{type:"boolean"},{type:"string",enum:["stdout","stderr","both","rows","ndjson","jsonl"]}]},tail:{anyOf:[{type:"string"},{type:"number"}]},addJson:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},eventType:{type:"string"},includeMeta:{type:"boolean"},allActionable:{type:"boolean"},verboseAuthorEvents:{type:"boolean"},match:{type:"string"},onlyIndex:{anyOf:[{type:"string"},{type:"number"}]},removeIndex:{type:"array",items:{anyOf:[{type:"string"},{type:"number"}]}},onlyLast:{type:"boolean"},envSet:{type:"array",items:{type:"string"}},envClear:{type:"array",items:{type:"string"}},sharedHostSafe:{type:"boolean"},detail:{type:"string",enum:["summary","deep"]},trace:{type:"boolean"},reload:{type:"boolean"},watch:{type:"boolean"},runtimeProbe:{type:"boolean"},fixManagedState:{type:"boolean"},isolated:{type:"boolean"},ignoreGlobal:{type:"boolean"},pmContext:{type:"string",enum:["schema","tracker","auto"]},overrideLinkedPmContext:{type:"boolean"},workspaceContext:{type:"string",enum:["source","isolated","snapshot"]},overrideLinkedWorkspaceContext:{type:"boolean"},allowUntrustedLinkedTests:{type:"boolean"},acknowledgeLinkedTests:{type:"boolean"},failOnContextMismatch:{type:"boolean"},failOnSkipped:{type:"boolean"},failOnEmptyTestRun:{type:"boolean"},requireAssertionsForPm:{type:"boolean"},checkContext:{type:"boolean"},autoPmContext:{type:"boolean"},measure:{type:"array",items:{type:"string"}},metricBelow:{type:"string"},metricDiff:{type:"string"},diff:{type:"boolean"},storage:{type:"boolean"},metadataCoverage:{type:"boolean"},fieldUtilization:{type:"boolean"},byAssignee:{type:"boolean"},byTag:{type:"boolean"},byPriority:{type:"boolean"},tagPrefix:{type:"string"},measurements:{type:"boolean"},metric:{type:"string"},measurementLimit:{type:"integer",minimum:0,maximum:1e3},observe:{type:"array",items:{type:"string"}},improvementDirection:{type:"string",enum:["higher","lower","target"]},measurementSource:{type:"string"},measurementItem:{type:"string"},measurementRevision:{type:"string"},provenanceCoverage:{type:"boolean"},fleetAttribution:{type:"boolean"},eventLimit:{type:"integer",minimum:1,maximum:1e5},minimumSample:{type:"integer",minimum:1,maximum:1e4},verify:{type:"boolean"},literal:{type:"array",items:{type:"string"}},regex:{type:"array",items:{type:"string"}},replacement:{type:"string"},timeout:{anyOf:[{type:"string"},{type:"number"}]},validateClose:{type:"string",enum:["off","warn","strict"]},checkMetadata:{type:"boolean"},metadataProfile:{type:"string",enum:["core","strict","custom"]},checkResolution:{type:"boolean"},checkCompleteness:{type:"boolean"},checkLifecycle:{type:"boolean"},checkStaleBlockers:{type:"boolean"},dependencyCycleSeverity:{type:"string",enum:["off","warn","error"]},parentCycleSeverity:{type:"string",enum:["off","warn","error"]},checkFiles:{type:"boolean"},checkStorageIntegrity:{type:"boolean"},strictDirectories:{type:"boolean"},requireMergeDrivers:{type:"boolean"},checkOnly:{type:"boolean"},checkTelemetry:{type:"boolean"},noRefresh:{type:"boolean"},refreshVectors:{type:"boolean"},verboseStaleItems:{type:"boolean"},skipVectors:{type:"boolean"},skipIntegrity:{type:"boolean"},skipDrift:{type:"boolean"},verboseDiagnostics:{type:"boolean"},allAffectedIds:{type:"boolean"},scanMode:{type:"string",enum:["default","tracked-all","tracked-all-strict"]},includePmInternals:{type:"boolean"},verboseFileLists:{type:"boolean"},strictExit:{type:"boolean"},failOnWarn:{type:"boolean"},fixHints:{type:"boolean"},autoFix:{type:"boolean"},fixScope:{type:"array",items:{type:"string",enum:["metadata","resolution","estimates","lifecycle"]}},pruneMissing:{type:"boolean"},checkHistoryDrift:{type:"boolean"},checkCommandReferences:{type:"boolean"},counts:{type:"boolean"},edit:{type:"integer",minimum:1},delete:{type:"integer",minimum:1},dryRun:{type:"boolean"},normalizeProvenance:{type:"boolean"},salvageTail:{type:"boolean"},all:{type:"boolean"},clear:{type:"boolean"},cliOnly:{type:"boolean"},packagesOnly:{type:"boolean"},repair:{type:"boolean"},packageName:{type:"string"},rollback:{type:"string"},noCheckpoint:{type:"boolean"},force:{type:"boolean"},ifAvailable:{type:"boolean"},ifAbsent:{type:"boolean"},next:{type:"boolean"},maxAttempts:{anyOf:[{type:"integer",minimum:1,maximum:100},{type:"string",pattern:"^(?:[1-9]|[1-9][0-9]|100)$"}]},includeDecisions:{type:"boolean"},includeGates:{type:"boolean"},includeContainers:{type:"boolean"},explainRanking:{type:"boolean"},noTags:{type:"boolean"},noExtensionHealth:{type:"boolean"},run:{type:"boolean"},count:{type:"boolean"},sum:{type:"string"},avg:{type:"string"},tree:{type:"boolean"},treeId:{type:"string",minLength:1},definition:{type:"object"},trigger:{type:"string",enum:["pre-commit","pre-push","pre-merge","ci","pre-release","post-release","scheduled","on-claim","on-close"]},gate:{type:"string",minLength:1},treeDepth:{anyOf:[{type:"string"},{type:"number"}]},includeUnparented:{type:"boolean"},gcScope:{type:"array",items:{type:"string",enum:["index","embeddings","runtime","locks"]}},maxDepth:{anyOf:[{type:"string"},{type:"number"}]},nodeLimit:{anyOf:[{type:"string"},{type:"integer",minimum:1}]},edgeLimit:{anyOf:[{type:"string"},{type:"integer",minimum:1}]},tokenBudget:{anyOf:[{type:"string"},{type:"integer",minimum:1}]},cursor:{type:"string"},direction:{type:"string",enum:["outgoing","incoming","both"]},kind:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},after:{type:"string"},maxPaths:{anyOf:[{type:"string"},{type:"integer",minimum:1}]},sample:{anyOf:[{type:"string"},{type:"integer",minimum:1}]},exemptIsolate:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},collapse:{type:"string",enum:["none","repeated"]},shell:{type:"string",enum:["bash","zsh","fish"]},stdin:{type:"boolean"},file:{type:"string"},preserveSourceIds:{type:"boolean"},folder:{type:"string"},subcommand:{type:"string"},name:{type:"string"},defaultStatus:{type:"string"},alias:{type:"array",items:{type:"string"}},role:{type:"array",items:{type:"string"}},fieldType:{type:"string",enum:["string","number","boolean","string_array"]},commands:{type:"array",items:{type:"string"}},cliFlag:{type:"string"},required:{type:"boolean"},requiredOnCreate:{type:"boolean"},allowUnset:{type:"boolean"},requiredTypes:{type:"array",items:{type:"string"}},infer:{type:"boolean"},minCount:{type:"number"},text:{type:"string"},add:{type:"array",items:{type:"string"}},addGlob:{type:"array",items:{type:"string"}},remove:{type:"array",items:{type:"string"}},migrate:{type:"array",items:{type:"string"}},discover:{type:"boolean"},apply:{type:"boolean"},discoveryNote:{type:"string"},lookupPath:{type:"array",items:{type:"string"}},explain:{type:"boolean"},lines:{type:"string",pattern:"^[1-9]\\d*:[1-9]\\d*$"},decisionDepth:{type:"integer",minimum:1,maximum:32},addNote:{type:"string"},list:{type:"boolean"},appendStable:{type:"boolean"},validatePaths:{type:"boolean"},dep:{type:"array",items:{type:"string"}},depRemove:{type:"array",items:{type:"string"}},replaceDeps:{type:"boolean"},replaceTests:{type:"boolean"},replaceFiles:{type:"boolean"},replaceDocs:{type:"boolean"},comment:{type:"array",items:{type:"string"}},note:{type:"array",items:{type:"string"}},learning:{type:"array",items:{type:"string"}},linkedFile:{type:"array",items:{type:"string"}},linkedTest:{type:"array",items:{type:"string"}},doc:{type:"array",items:{type:"string"}},reminder:{type:"array",items:{type:"string"}},event:{type:"array",items:{type:"string"}},typeOption:{type:"array",items:{type:"string"}},field:{type:"array",items:{type:"string"}},unset:{type:"array",items:{type:"string"}},clearDeps:{type:"boolean"},clearComments:{type:"boolean"},clearNotes:{type:"boolean"},clearLearnings:{type:"boolean"},clearFiles:{type:"boolean"},clearTests:{type:"boolean"},clearDocs:{type:"boolean"},clearReminders:{type:"boolean"},clearEvents:{type:"boolean"},clearTypeOptions:{type:"boolean"},criterion:{type:"array",items:{type:"string"}},clearCriteria:{type:"boolean"},groupBy:{type:"string"},setMode:{type:"string",enum:["element","tuple"]},completion:{type:"boolean"},format:{type:"string"},unbounded:{type:"boolean"},depth:{type:"string",enum:["brief","standard","deep","full"]},section:{type:"array",items:{type:"string",enum:["hierarchy","activity","progress","blockers","files","workload","staleness","tests"]}},activityLimit:{anyOf:[{type:"string"},{type:"number"}]},staleThreshold:{type:"string"},policy:{type:"string"}};const PM_TOOL_ACTION_SCOPED_PARAMETER_PROPERTIES={schema:{definition:{type:["object","string"]}},assurance:{definition:ASSURANCE_DEFINITION_SCHEMA,kind:{type:"string",enum:["measurement","assertion","gate"]},subcommand:{type:"string",enum:["list","show","put","remove","run","verdicts","presets","apply","derive","promote","risk","lineages"]},preset:{type:"string",enum:["software-delivery","research","agent-evaluation","operations"]},enforcement:{type:"string",enum:["warn","block"]},limit:{type:"integer",minimum:1,maximum:1e3}},activity:{harness:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]}},"update-many":{ids:{anyOf:[{type:"string"},{type:"number"},{type:"array",items:{anyOf:[{type:"string"},{type:"number"}]}}]}},"close-many":{ids:{anyOf:[{type:"string"},{type:"number"},{type:"array",items:{anyOf:[{type:"string"},{type:"number"}]}}]}},"history-compact":{ids:{anyOf:[{type:"string"},{type:"number"},{type:"array",items:{anyOf:[{type:"string"},{type:"number"}]}}]}},events:{since:{type:"string",minLength:1},type:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},author:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},item:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},limit:{type:"integer",minimum:0,maximum:1e3},harness:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]}},history:{harness:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]}},remind:{at:{type:"string",minLength:1}}};const PLAN_SUBCOMMAND_VALUES=["create","show","add-step","update-step","complete-step","block-step","reorder-step","remove-step","link","unlink","decision","discovery","validation","resume","approve","materialize"];const PLAN_ACTION_PARAMETER_PROPERTIES={subcommand:{type:"string",enum:[...PLAN_SUBCOMMAND_VALUES]},stepRef:{type:"string"},reorderTo:{anyOf:[{type:"string"},{type:"number"}]},scope:{type:"string"},harness:{type:"string",enum:[...PLAN_HARNESS_VALUES]},mode:{type:"string",enum:[...PLAN_MODE_VALUES]},resumeContext:{type:"string"},related:{type:"string"},blocks:{type:"string"},claim:{type:"boolean"},fromSearch:{type:"string"},stepTitle:{type:"string"},step:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},stepBody:{type:"string"},stepOwner:{type:"string"},stepStatus:{type:"string",enum:[...PLAN_STEP_STATUS_VALUES]},stepEvidence:{type:"string"},stepBlockedReason:{type:"string"},stepReplacement:{type:"string"},dependsOn:{type:"string"},link:{type:"string"},linkKind:{type:"string",enum:[...PLAN_STEP_LINK_KIND_VALUES]},linkNote:{type:"string"},promoteToItemDep:{type:"boolean"},allowMultipleActive:{type:"boolean"},file:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},test:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},doc:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]},decisionText:{type:"string"},decision:{type:"string"},decisionRationale:{type:"string"},decisionEvidence:{type:"string"},discoveryText:{type:"string"},discovery:{type:"string"},validationText:{type:"string"},validation:{type:"string"},validationCommand:{type:"string"},validationExpected:{type:"string"},steps:{type:"array",items:{type:"string"}},materializeType:{type:"string"},materializeParent:{type:"string"},materializeTags:{type:"string"},field:{anyOf:[{type:"string"},{type:"array",items:{type:"string"}}]}};const PLAN_ACTION_PARAMETER_METADATA={subcommand:{description:"Plan workflow operation to run.",examples:["create","show","add-step","approve"]},stepRef:{description:"Plan step id or order for step lifecycle subcommands.",examples:["plan-step-001","1"]},reorderTo:{description:"New integer order for reorder-step.",examples:[1,"2"]},scope:{description:"Short free-text scope statement describing what the Plan covers.",examples:["Release readiness audit","Search package migration"]},mode:{description:"Plan lifecycle mode.",examples:["draft","research","approved"]},step:{description:"Ordered initial step titles for create (string or array, never comma-split; stepTitle, when also set, becomes the first step). For step subcommands a single value aliases stepTitle.",examples:[["Read the code","Write the fix","Run the tests"]]},file:{description:"File link to attach while creating or materializing a Plan.",examples:["path=src/cli.ts,note=implementation surface"]},test:{description:"Test command link to attach while creating or materializing a Plan.",examples:["command=pnpm build,timeout_seconds=300"]},doc:{description:"Documentation link to attach while creating or materializing a Plan.",examples:["path=docs/SDK.md,note=public API reference"]}};const PM_TOOL_PARAMETER_METADATA={includeGates:{description:"Opt next or claim-next into outcome gates. Blocker and ownership restrictions still apply."},includeContainers:{description:"Opt next or claim-next into containers with unfinished descendants. Blocker and ownership restrictions still apply."},action:{description:"Tool action to execute."},pmExecutable:{description:"Override the pm executable used by actions that invoke or verify an external CLI process.",examples:["pm","node dist/cli.js"]},force:{description:"Allow the selected action to override its supported ownership, terminal-state, or destructive-operation guard."},limit:{description:"Maximum number of rows returned by the selected action.",examples:[10,"25"]},text:{description:"Text payload used by append, comment, note, or learning mutations."},path:{description:"Optional PM data root override for this invocation.",examples:[".agents/pm"]},scope:{description:"Scope selector for commands that operate on project or global state. Linked files, docs, and tests default to project scope when omitted.",examples:["project","global"]},detail:{description:"Detail mode for commands that support concise and deep diagnostics.",examples:["summary","deep"]},trace:{description:"When true for extension-doctor, include actionable registration traces in deep diagnostics."},reload:{description:"When true for extension action payloads, trigger cache-busted extension module reload."},watch:{description:"When true for extension-reload/extension action payloads, enable watch mode semantics."},runtimeProbe:{description:"When true for extension-manage, run a doctor-like runtime activation probe for parity fields."},fixManagedState:{description:"When true for extension-manage/extension-doctor, adopt unmanaged extensions before diagnostics/update checks."},isolated:{description:"When true for extension-doctor/package-doctor, ignore global registrations for hermetic project diagnostics."},ignoreGlobal:{description:"Alias for isolated on extension-doctor/package-doctor action payloads."},target:{description:"Positional target argument for the selected action (ID, source, package source, or extension name).",examples:["pm-a1b2",".agents/pm/extensions/sample","sample-extension"]},capability:{description:"Starter capability selected by extension-init or package-init scaffolding.",examples:["commands","hooks","search","schema"]},declarative:{description:"Generate the package composeExtension declarative blueprint starter."},output:{description:"File path for commands that write generated output, such as package/extension describe Markdown references.",examples:["docs/pm-package-reference.md"]},markdown:{description:"Render the package or extension description as Markdown instead of structured output.",examples:[true]},github:{description:"GitHub shorthand owner/repo[/path] source for package/extension install actions.",examples:["org/repo/extensions/sample"]},ref:{description:"Git ref/branch/tag used when installing from GitHub shorthand/URL sources.",examples:["main","v1.0.0"]},cliOnly:{description:"Restrict upgrade to the pm CLI/SDK npm package."},packagesOnly:{description:"Restrict upgrade to managed installable pm packages."},repair:{description:"Force npm global reinstall semantics when upgrading the pm CLI/SDK."},tag:{description:"npm version or dist-tag used for CLI and registry package upgrades.",examples:["latest","next","2026.5.11"]},today:{description:"When true for list actions, include only items updated since local midnight today."},recent:{description:"When true for list actions, include only items updated in the last seven days."},packageName:{description:"Override the pm CLI package name for self-upgrade automation and tests.",examples:["@unbrained/pm-cli"]},json:{description:"Emit machine-readable JSON output."},quiet:{description:"Suppress stdout payload output."},noExtensions:{description:"Disable extension loading for this invocation."},noPager:{description:"Disable pager integration for help and long output."},tokenAccounting:{description:"Request a bounded transport-level receipt for output emitted by a compatible CLI or MCP host."},outputInclude:{description:"Comma-separated fields or sections retained by any built-in read action.",examples:["id,title,status","summary,counts"]},outputLimit:{description:"Universal read row ceiling, or unbounded to disable the shared ceiling.",examples:[10,"unbounded"]},outputBudget:{description:"Universal estimated-token ceiling for a read result, or unbounded to disable the shared ceiling.",examples:[600,1200,"unbounded"]},outputFormat:{description:"Universal read-result encoding selector.",examples:["toon","json"]},outputSession:{description:"Caller-carried JSON session state that enforces a token ceiling across read calls and replaces repeated item facts with resolvable context references.",examples:[{version:1,id:"orientation",token_budget:4e3,spent_tokens:0,seen_item_ids:[]}]},outputCursor:{description:"Opaque continuation cursor returned when a declared row collection is compacted by the output budget."},outputRowContract:{description:"Include the row selector and TOON row-encoding contract on a read result."},profile:{description:"Emit deterministic timing diagnostics to stderr."},timeoutMs:{description:"Tool execution timeout in milliseconds.",examples:[12e4]},id:{description:"Item identifier for read or mutation actions.",examples:["pm-a1b2"]},treeId:{description:"Commit, tree, snapshot, or immutable workspace identity judged by an assurance gate.",examples:["0123456789abcdef","release-candidate-3"]},definition:{description:"Structured measurement, assertion, or gate declaration used by assurance put."},trigger:{description:"Lifecycle trigger used to evaluate an assurance gate.",examples:["ci","pre-release"]},gate:{description:"Stable assurance gate id used to filter durable verdict history.",examples:["release-readiness"]},owner:{description:"pm item that owns preset or observation-derived assurance assertions.",examples:["pm-a1b2"]},enforcement:{description:"Explicit next assurance enforcement level.",examples:["warn","block"]},runId:{description:"Background test run identifier.",examples:["tr-kq9x3f-93acde"]},title:{description:"Item title text."},description:{description:"Item description text."},type:{description:"Item type name from the active runtime type registry.",examples:["Task","Feature"]},subcommand:{description:"Subcommand selector for schema, profile, telemetry, and graph actions."},name:{description:"Custom definition name, schema migration source name, or profile name.",examples:["Spike","review","component"]},defaultStatus:{description:"Default status hint recorded for a custom item type.",examples:["open"]},alias:{description:"Aliases for the custom item type or status (repeatable).",examples:[["spike","research"]]},role:{description:"Lifecycle roles for a custom status (schema add-status): draft, active, blocked, terminal, terminal_done, terminal_canceled, default_open, default_close, default_cancel.",examples:[["active"],["terminal","terminal_done"]]},fieldType:{description:"Value type for a custom field (schema add-field): string, number, boolean, or string_array.",examples:["string","number","string_array"]},fieldTypeScope:{description:"Optional item type restricting which records participate in schema rename-field.",examples:["Issue","Feature"]},migrationId:{description:"Optional stable idempotency override used to persist and resume a schema migration plan; omitted values are derived from the workspace and normalized request.",examples:["severity-to-impact-v2"]},commands:{description:"Commands a custom field is wired onto (schema add-field): create, update, update_many, list, search, calendar, context.",examples:[["create","update"],["create","update","list"]]},cliFlag:{description:"Override the auto-derived CLI flag for a custom field (schema add-field).",examples:["--owner"]},required:{description:"Mark a custom field as always required (schema add-field)."},requiredOnCreate:{description:"Mark a custom field as required at create time (schema add-field)."},allowUnset:{description:"Whether a custom field may be cleared via --unset (schema add-field); defaults to true."},allowDuplicate:{description:"Explicitly proceed when strict similarity governance finds likely duplicate items."},allowUnresolvedDeps:{description:"Permit unresolved local dependency targets while returning dependency_target_unresolved warning receipts. Cross-workspace references should use source_kind=external instead.",examples:[true]},requiredTypes:{description:"Restrict a custom field's requirement to specific item types (schema add-field).",examples:[["Bug"],["Story","Spike"]]},infer:{description:"Infer custom item types from title-prefix conventions (schema add-type); previews unless apply is true."},minCount:{description:"Minimum number of items sharing a title prefix for schema add-type inference (default 10).",examples:[10,25]},preset:{description:"Governance preset for initialization flows.",examples:["minimal","default","strict"]},idPrefix:{description:"Tracker item identifier prefix used by initialization; overrides the positional compatibility prefix.",examples:["pm","work"]},workspace:{description:"Workspace directory where initialization resolves or creates the tracker.",examples:[".","packages/app"]},typePreset:{description:"Domain item-type preset registered during initialization.",examples:["agile","ops","research"]},defaults:{description:"Use non-interactive setup defaults during initialization."},verbose:{description:"Include the full resolved settings tree in init output."},agentGuidance:{description:"Control AGENTS.md/CLAUDE.md guidance behavior during init: ask, add, skip, or status.",examples:["ask","add","skip","status"]},withPackages:{description:"Install all bundled first-party pm packages during initialization."},mergeFence:{description:"Install the repository merge-driver fence for a fresh Git-backed tracker; set false to opt out."},createMode:{description:"Create required-option policy mode.",examples:["strict","progressive"]},schedulePreset:{description:"Schedule-centric create preset for Reminder, Meeting, and Event types.",examples:["lightweight"]},status:{description:"Item status value. Statuses are project-configurable via .agents/pm/settings.json (schema block); the built-in defaults are draft, open, in_progress, blocked, closed, canceled. Custom statuses defined for the project are accepted \u2014 discover the active set with the pm_contracts tool (workspace.statuses) or `pm contracts`. Unknown statuses are rejected at runtime with a did-you-mean hint rather than blocked by a fixed schema enum.",examples:["open","in_progress"]},since:{description:"Inclusive ISO 8601 creation timestamp lower bound for duplicate discovery.",examples:["2026-01-01T00:00:00.000Z"]},exhaustive:{description:"Compare every duplicate pair within the disclosed safety bound; default prefix filtering preserves exact recall."},threshold:{description:"Minimum duplicate similarity score from zero through one.",examples:[.85]},priority:{description:"Priority value in range 0..4.",examples:[0,1,"2"]},order:{description:"Planning order/rank value for create/update, or sort direction (asc|desc) for list-family sorting.",examples:[0,1,"2","asc","desc"]},sort:{description:"List-family sort field selector.",examples:["priority","deadline","updated_at","created_at","title","parent"]},tags:{description:"Comma-delimited tag list.",examples:["pm-cli,agent-ux"]},addTags:{description:"Tags to add to the existing list without replacing it. Each entry may be CSV or a JSON array.",examples:[["agent-ux"],["fix","security"]]},addAc:{description:"Acceptance criteria appended individually without replacing the existing list (one criterion per entry).",examples:[["error path covered by a regression test"]]},removeAc:{description:"Acceptance criteria removed individually by exact text match; the mutation fails atomically if any selector is unmatched (one criterion per entry).",examples:[["superseded manual QA step"]]},removeTags:{description:"Tags to remove from the existing list. Each entry may be CSV or a JSON array.",examples:[["stale"],["legacy","wontfix"]]},deadline:{description:"ISO/date timestamp or relative offset (+6h/+1d/+2w/+6m).",examples:["2026-04-01T00:00:00.000Z","+1d"]},reminder:{description:"Repeatable reminder seed entries at=<iso|relative>,text=<text>.",examples:[["at=+2d,text=Review PR"]]},event:{description:"Repeatable event seed entries start=<iso|relative> with end=<iso|relative> or duration=<relative|30min|PT30M>. Bare `m` remains months for backward compatibility.",examples:[["start=2026-07-01T10:00:00Z,duration=2h,title=planning"],["start=2026-07-01T10:00:00Z,duration=30min,title=standup"],["start=2026-07-01T10:00:00Z,duration=PT30M,title=window"]]},historyEvent:{description:"Unknown-author history target in <item-id>:<one-based-line> form.",examples:[["pm-example:4","pm-example:5"]]},planFingerprint:{description:"Exact SHA-256 returned by a history-author-acknowledge dry-run preview; apply refuses stale or changed source coordinates.",examples:["0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"]},estimate:{description:"Estimated effort in minutes.",examples:[60,"120"]},acceptanceCriteria:{description:"Complete acceptance-criteria text supplied while creating or replacing an item field."},author:{description:"Intentional mutation-author override. Agent harness identity is automatic when omitted."},attributedAuthor:{description:"Principal attributed to the immutable unknown-author history events after review.",examples:["reviewed-principal"]},message:{description:"History message for mutation audit trail."},ifAbsent:{description:"For annotations, append only when no existing entry has the same resolved author and exact stored text; retries return changed false without a history event."},assignee:{description:"Assignee identity."},assigneeFilter:{description:"Assignee presence selector for list, calendar, and context filters.",examples:["assigned","unassigned"]},parent:{description:"Parent item ID filter for hierarchical list queries.",examples:["pm-epic01"]},blockedLimit:{description:"Cap blocked rows returned by the next action (defaults to the ready --limit).",examples:["3"]},readyOnly:{description:"When true, the next action omits the blocked companion list."},unset:{description:"Repeatable list of item-metadata fields to clear explicitly during create/update mutations.",examples:[["deadline","assignee"],["close-reason"]]},clearDeps:{description:"When true, clear linked dependencies."},replaceDeps:{description:"When true for update, atomically replace dependencies with the supplied --dep values."},replaceTests:{description:"When true for update, atomically replace linked tests with the supplied --test values."},replaceFiles:{description:"When true for update, atomically replace linked files with the supplied --file values."},replaceDocs:{description:"When true for update, atomically replace linked docs with the supplied --doc values."},lookupPath:{description:"One or more source paths whose referencing pm items should be returned by files lookup.",examples:[["src/sdk/files.ts"],["README.md","docs/SDK.md"]]},explain:{description:"Include ranked linked-file, rationale, and governing-decision evidence for a files lookup."},lines:{description:"Inclusive start:end source-line range for Git contribution attribution; requires one lookup path.",examples:["10:24"]},decisionDepth:{description:"Maximum typed relationship depth searched for a governing Decision during files lookup.",examples:[8]},clearComments:{description:"When true, clear item comments."},clearNotes:{description:"When true, clear item notes."},clearLearnings:{description:"When true, clear item learnings."},clearFiles:{description:"When true, clear linked files."},clearTests:{description:"When true, clear linked tests."},clearDocs:{description:"When true, clear linked docs."},clearReminders:{description:"When true, clear reminders."},clearEvents:{description:"When true, clear events."},clearTypeOptions:{description:"When true, clear type option metadata."},clearCriteria:{description:"When true for config set criteria-list keys (definition-of-done, metadata-required-fields, lifecycle pattern lists), clear the criteria list."},mode:{description:"Mode selector for search and reindex (keyword|semantic|hybrid).",examples:["keyword","hybrid"]},semanticWeight:{description:"Per-query hybrid semantic weight override in [0,1] for search action; invalid values fall back to settings.",examples:[.2,"0.7"]},op:{description:"History operation filter for activity output.",examples:["create","update","close","update_ownership_bypass"]},fullPeriod:{description:"For day/week/month calendar views, include the full anchored period instead of clipping the start to now."},progress:{description:"Emit progress diagnostics to stderr for long-running operations."},background:{description:"Run linked tests in managed background mode."},addJson:{description:"JSON input: one structured context event for notes, or repeatable linked-test entries for test.",examples:[[`{"command":"node scripts/run-tests.mjs test -- tests/unit/output.spec.ts","timeout_seconds":240}`]]},eventType:{description:"For notes action, return structured context events whose top-level type matches this value."},includeMeta:{description:"Include structured-event counts for notes reads; filtered reads also include total, returned, limit, and has-more metadata."},allActionable:{description:"For history-author-acknowledge, select every currently actionable undispositioned event."},match:{description:"Run only linked tests whose command or path contains this case-insensitive substring.",examples:["output.spec.ts","coverage"]},onlyIndex:{description:"Run only the 1-based linked-test index from pm test <id> --list order.",examples:[1,"2"]},removeIndex:{description:"Remove linked tests by their 1-based positions from pm test <id> --list order; repeatable and lossless for commands containing commas or equals signs.",examples:[[1],["2","4"]]},onlyLast:{description:"Run only the most recently added linked-test entry."},envSet:{description:"Repeatable runtime environment KEY=VALUE overrides for linked-test execution.",examples:[["PORT=0","PLAYWRIGHT_HTML_OPEN=never"]]},envClear:{description:"Repeatable runtime environment variable names to clear before linked-test execution.",examples:[["PLAYWRIGHT_BASE_URL"]]},sharedHostSafe:{description:"Apply additive shared-host-safe runtime defaults during linked-test execution."},pmContext:{description:"PM linked-test context mode (schema keeps isolated tracker data; tracker seeds source tracker data; auto uses tracker for PM tracker-read linked commands).",examples:["schema","tracker","auto"]},overrideLinkedPmContext:{description:"Force run-level --pm-context to override per-linked-test pm_context_mode metadata for all linked-test entries."},workspaceContext:{description:"Source-workspace mode: source preserves read-only source context, isolated omits it for self-sandboxing commands, and snapshot runs from a temporary workspace paired with the selected tracker sandbox.",examples:["source","isolated","snapshot"]},overrideLinkedWorkspaceContext:{description:"Force run-level --workspace-context over per-linked-test workspace_context_mode metadata."},allowUntrustedLinkedTests:{description:"Explicitly execute commands not yet trusted by this clone when testing.allow_untrusted_linked_tests is also enabled."},acknowledgeLinkedTests:{description:"Record clone-local trust for the item's current linked commands without executing them."},failOnContextMismatch:{description:"Fail linked PM command runs when source and sandbox tracker item counts differ."},failOnSkipped:{description:"Treat skipped linked tests as dependency-failed policy violations."},failOnEmptyTestRun:{description:"Treat successful linked-test commands that report zero executed tests as failures."},requireAssertionsForPm:{description:"Require assertion metadata for linked PM command test entries during run execution."},checkContext:{description:"Run linked PM command context preflight diagnostics before command execution."},autoPmContext:{description:"Auto-remediate PM tracker-read linked commands by routing those entries through tracker context regardless of linked-test pm_context_mode overrides."},measure:{description:"Repeatable numeric run evidence in name=value[,unit=...][,threshold=...] form.",examples:[["coverage=100,unit=percent,threshold=100"]]},metricBelow:{description:"Return recorded evidence below a name=value threshold.",examples:["coverage=100"]},metricDiff:{description:"Compare the latest and previous values for one metric.",examples:["coverage"]},dryRun:{description:"Preview command effects without mutating storage artifacts."},normalizeProvenance:{description:"For history-repair: remove invalid legacy provenance observations and emit only aggregate privacy-safe repair evidence."},salvageTail:{description:"For history-repair with one explicit id: remove an invalid trailing suffix after a verified prefix; refuses interior corruption."},all:{description:"For history-repair action: scan every stream for drift and repair each drifted stream in one audited pass (mutually exclusive with id)."},clear:{description:"For focus action: clear the session focused item instead of setting it (mutually exclusive with id)."},gcScope:{description:"Repeatable gc scope selector values (index, embeddings, runtime, locks, checkpoints, transactions).",examples:[["index","embeddings"],["runtime"],["locks"],["checkpoints"]]},storage:{description:"For stats action: include aggregate history-stream storage metrics (total streams/lines/bytes, largest + deepest streams, oldest/newest entries) for compaction and storage planning."},fieldUtilization:{description:"For stats action: include a field_utilization block reporting present/total/percent for content fields (notes, learnings, files, docs, tests, comments, deps, body, linked_command) across all items so under-documented dimensions are visible at a glance."},measurements:{description:"For stats action: include the audited append-only improvement ledger and baseline-to-latest trends."},metric:{description:"Exact improvement metric name used to filter ledger reads.",examples:["quality.coverage.lines"]},measurementLimit:{description:"Maximum newest improvement observations returned by stats.",examples:[50]},observe:{description:"Repeatable audited observation in name=value[,unit=...][,threshold=...] form.",examples:[["quality.coverage.lines=100,unit=percent,threshold=100"]]},improvementDirection:{description:"Improvement direction for newly recorded observations.",examples:["higher","lower","target"]},measurementSource:{description:"Producing gate or instrument for a new observation.",examples:["pnpm coverage"]},measurementItem:{description:"Tracked item that owns an improvement observation.",examples:["pm-123abc"]},measurementRevision:{description:"Explicit source revision for a new observation.",examples:["0123456789abcdef"]},provenanceCoverage:{description:"For stats action: compare configured provenance descriptors with bounded immutable-history observations."},fleetAttribution:{description:"For stats action: derive observational throughput, rework, and defect-escape rates by harness, model, and author source."},eventLimit:{description:"Maximum immutable history events consumed by an analytics projection.",examples:[1e4]},minimumSample:{description:"Minimum denominator before analytics rates are reported.",examples:[5]},offset:{description:"Number of matching rows to skip before limit is applied.",examples:[0,50,"100"]},provenance:{description:"Return patch-free immutable author, harness, instance, and extensible provenance rows."},provenanceSummary:{description:"Include bounded observed, unavailable, legacy-missing, and unresolved-author counts."},agentInstance:{description:"Privacy-safe agent invocation fingerprint filter, supplied once or as a list.",examples:["a1b2c3d4",["a1b2c3d4","e5f6g7h8"]]},provenanceFilter:{description:"Exact extensible provenance predicate in dimension=value form, supplied once or as a list.",examples:["model=gpt-5.6-sol",["effort=xhigh","role=reviewer"]]},before:{description:"For history-compact, compact entries strictly before this boundary (version number or ISO timestamp). Single-id mode only.",examples:["5","2026-06-01T00:00:00.000Z"]},at:{description:"Read-only historical projection boundary as an item version or ISO timestamp.",examples:["3","2026-07-01T12:00:00.000Z"]},allOver:{description:"For history-compact bulk mode, compact every stream with more than N entries. When history.compact_policy is enabled and this is omitted, the policy's max_entries is used.",examples:[200,"500"]},minEntries:{description:"For history-compact bulk mode, skip streams with at most N entries as already-compact (default 3).",examples:[3,"10"]},closed:{description:"For history-compact bulk mode, compact only closed (terminal) items' history streams."},allStreams:{description:"For history-compact bulk mode, compact every history stream regardless of lifecycle state."},literal:{description:"Repeatable literal matcher used by history-redact to scrub exact string values.",examples:["[redacted_path_prefix]/private/path"]},regex:{description:"Repeatable regex matcher used by history-redact. Accepts either /pattern/flags or a raw pattern (global mode is auto-enabled).",examples:["/192\\\\.168\\\\.[0-9.]+/g","token=[A-Za-z0-9_-]+"]},replacement:{description:'Replacement text used by history-redact (defaults to "[redacted]").',examples:["[scrubbed_path]"]},validateClose:{description:'Close-time metadata validation mode ("off", "warn", or "strict").',examples:["off","warn","strict"]},checkMetadata:{description:"Run metadata completeness checks."},metadataProfile:{description:"Select metadata validation profile for --check-metadata.",examples:["core","strict","custom"]},checkResolution:{description:"Run closed-item resolution metadata checks."},checkCompleteness:{description:"Evaluate declarative lifecycle field requirements, with per-type counts and bounded missing-field diagnostics."},checkLifecycle:{description:"Run active-item lifecycle governance drift checks."},checkStaleBlockers:{description:"Include stale blocker-pattern diagnostics in lifecycle checks."},dependencyCycleSeverity:{description:"Set dependency-cycle warning policy for lifecycle checks.",examples:["off","warn","error"]},parentCycleSeverity:{description:"Set parent-cycle warning policy for lifecycle checks.",examples:["off","warn","error"]},checkFiles:{description:"Run linked-file and orphaned-file checks."},checkStorageIntegrity:{description:"Run deep item, history, index, and vector storage integrity checks."},strictDirectories:{description:"Treat optional item-type directories as required health failures."},requireMergeDrivers:{description:"Treat never-installed clone-local semantic merge drivers as required health failures."},checkOnly:{description:"For health action, run read-only diagnostics without refreshing vectors."},checkTelemetry:{description:"For health action, probe telemetry endpoint health and include network diagnostics."},noRefresh:{description:"For health action, skip vector refresh while still running checks."},refreshVectors:{description:"For health action, explicitly refresh stale vectors."},verboseStaleItems:{description:"For health action, include full stale-item arrays in vectorization details."},verboseAuthorEvents:{description:"For health action, include every actionable unknown-author event coordinate."},skipVectors:{description:"For health action, skip vectorization checks for a faster diagnostic run."},skipIntegrity:{description:"For health action, skip item/history file integrity checks for a faster diagnostic run."},skipDrift:{description:"For health action, skip history drift hash checks for a faster diagnostic run."},scanMode:{description:"Select file candidate scan mode for --check-files.",examples:["default","tracked-all","tracked-all-strict"]},includePmInternals:{description:"Include PM storage internals in tracked-all candidate scans."},verboseFileLists:{description:"For validate action, include full file-path lists for --check-files details."},verboseDiagnostics:{description:"For validate action, include full diagnostic ID lists instead of compact summaries."},strictExit:{description:"Apply the selected capability's strict exit policy; health also requires merge drivers."},failOnWarn:{description:"Alias for strictExit in health, validation, history, and managed doctor actions."},fixHints:{description:"For validate action, add a machine-executable fix_hints[] of pm commands to each failing check's details."},autoFix:{description:"For validate action, apply the safe, deterministic subset of fix-hint remediations (field backfills) automatically; combine with dryRun to preview and fixScope to grant gated scopes."},fixScope:{description:"For validate action, grant --auto-fix scopes (metadata, resolution, estimates, lifecycle). Defaults to the safe scopes metadata and resolution; estimates (per-type default estimated_minutes backfill) and lifecycle must be named explicitly.",examples:[["estimates"],["lifecycle"],["metadata","resolution"]]},pruneMissing:{description:"For validate action, remove stale linked-file/doc LINKS whose paths classified as deleted (link removal only \u2014 never touches real files); honors dryRun."},checkHistoryDrift:{description:"Run item/history hash drift checks."},checkCommandReferences:{description:"Run linked-command PM-ID reference checks."},edit:{description:"For comments, notes, and learnings actions, replace the annotation at this 1-based index with supplied replacement text."},delete:{description:"For comments, notes, and learnings actions, delete the annotation at this 1-based index."},stdin:{description:"For comments, notes, and learnings actions, read annotation text from piped stdin (supports multiline markdown)."},file:{description:"CLI-only path to an input file for commands that read payload text; tool actions exclude host file access.",examples:["notes/comment.md"]},preserveSourceIds:{description:"Preserve explicit source IDs during Beads imports instead of normalizing to tracker prefix.",examples:[true]},appendStable:{description:"When true for files action, preserve existing linked-file order and append new links without full-array resorting."},discover:{description:"When true for files action, use `pm files discover <id>` to scan item text for referenced file paths."},apply:{description:"Persist changes instead of returning a dry-run preview: for files discovery, add the missing discovered file links; for schema add-type --infer, register the inferred custom item types."},discoveryNote:{description:"Note attached to file links added by files discovery.",examples:["discovered from item text"]},addNote:{description:"Note attached to every link added by add/addGlob in this call (per-entry embedded note= wins; requires add or addGlob). Maps to the CLI --note flag on pm files/pm docs.",examples:["command wiring"]},list:{description:"When true, list command-specific entries without mutating state (for example linked paths for files/docs or topics for guide).",examples:[true]},stream:{description:"Stream selector: test-runs logs accepts stdout|stderr|both; activity accepts boolean/rows|ndjson|jsonl for line-delimited output.",examples:["stderr","stdout","both","rows","ndjson","jsonl",true]},tail:{description:"Number of lines to tail for background run logs.",examples:[100]},query:{description:"Search query text for search action."},for:{description:"Named context intent projection declared for the selected read action.",examples:["orient","inspect","triage","execute","discover"]},keywords:{description:"Alias for query in search action payloads."},includeLinked:{description:"Include readable linked docs/files/tests content in keyword and hybrid lexical scoring."},titleExact:{description:"For search action, require exact normalized title match for the full query string."},phraseExact:{description:"For search action, require exact normalized query phrase match in item text fields."},highlight:{description:"For search action, emit per-field matched-text snippets (wrapped in \xAB\u2026\xBB) on each hit. Off by default."},includeBody:{description:"When true for list-family actions, include item body text in projected rows."},noTruncate:{description:"When true for list-family actions, return every matched row, overriding any limit (surfaces total when rows were dropped)."},strictRead:{description:"When true for list-family actions, fail if any source item or item directory cannot be read."},compact:{description:"Render compact projection output for search and list-family actions."},raw:{description:"For activity, restore the compact per-event stream instead of the default item digest."},brief:{description:"Emit compact low-token output for commands that support terse projections or health details.",examples:[true]},full:{description:"Enable command-specific full/detail output mode when supported, such as deep item reads for get or full payload mode for search/history."},includeEmpty:{description:"For stats, restore zero-count registered type and lifecycle-status buckets."},fields:{description:"Comma-separated projection fields for get, search, list-family, or context outputs. Valid field names are command-specific (e.g. score/matched_fields apply to search; context projects focus-row fields such as priority/deadline/completion_pct).",examples:["id,title,status,parent,type","id,title,score,matched_fields","id,title,priority,deadline"]},groupBy:{description:"Comma-separated aggregate grouping fields (supported: parent,type,priority,status,assignee,tags,sprint,release).",examples:["parent,type","type,status","priority,assignee","tags","sprint,release"]},setMode:{description:"Aggregate array dimensions by distinct element (default), or by the complete normalized tuple. Empty sets retain a null group.",examples:["element","tuple"]},count:{description:"Enable grouped count output for aggregate action."},completion:{description:"For aggregate action, add open/in_progress/closed/other counts and completion_pct per group."},sum:{description:"Numeric field to sum per aggregate group (count and null_count are still returned).",examples:["estimated_minutes","priority"]},avg:{description:"Numeric field to average per aggregate group (count and null_count are still returned).",examples:["estimated_minutes","priority"]},tree:{description:"When true for list/get actions, render recursive parent/child tree ordering."},treeDepth:{description:"Maximum recursion depth for tree output (0 keeps root rows only).",examples:[0,1,"2"]},includeUnparented:{description:"Include unparented rows when aggregate grouping includes parent."},maxDepth:{description:"Maximum dependency traversal depth for deps action (0 keeps only the root node).",examples:[0,1,"2"]},nodeLimit:{description:"Maximum related nodes returned by deps --format context.",examples:[10,"20"]},edgeLimit:{description:"Maximum related edges returned by deps --format context.",examples:[20,"40"]},tokenBudget:{description:"Maximum estimated output tokens for the command output.",examples:[600,"1200"]},cursor:{description:"Opaque continuation cursor returned by deps --format context."},direction:{description:'Graph-context traversal direction for deps action ("outgoing", "incoming", or "both").',examples:["both","incoming"]},kind:{description:"Registered relationship kinds narrowing deps --format context traversal (string, comma-separated, or array).",examples:["blocked_by",["parent","related"]]},after:{description:"Opaque action-specific continuation cursor returned by the preceding bounded query.",examples:["pm-x1y2"]},maxPaths:{description:"Maximum enumerated paths for graph paths queries.",examples:[5,"10"]},sample:{description:"Maximum evidence sample entries per graph audit finding.",examples:[10,"25"]},exemptIsolate:{description:"Item ids the graph audit treats as explicitly valid isolates (string, comma-separated, or array).",examples:["pm-x1y2",["pm-x1y2","pm-a3b4"]]},exemptIsolateType:{description:"Item types whose active isolates the graph audit treats as policy-valid (string, comma-separated, or array).",examples:["Reminder",["Reminder","Event"]]},saveBaseline:{description:"When true, persist the graph audit census as the change-since-baseline comparison point (audit only)."},rebuild:{description:"When true, rebuild and warm the durable graph index (graph index only)."},collapse:{description:'Dependency tree collapse mode for deps action ("none" or "repeated").',examples:["none","repeated"]},summary:{description:"When true, return the command's compact summary projection (deps counts, health rollup, or contracts command intents)."},shell:{description:"Shell target for completion generation.",examples:["bash"]},eagerTags:{description:"When true for completion, eagerly embed current tracker tags into generated scripts (legacy mode)."},contractAction:{description:"Filter contracts schema to one tool action.",examples:["create","update"]},command:{description:"Scope contracts output to one CLI command name; action/schema surfaces narrow by default.",examples:["create","search","list"]},schemaOnly:{description:"When true, contracts action returns schema-focused payloads (mutually exclusive with flagsOnly/availabilityOnly)."},flagsOnly:{description:"When true, contracts action returns only command flag surface payloads (mutually exclusive projection mode)."},availabilityOnly:{description:"When true, contracts action returns only action availability payloads (mutually exclusive projection mode)."},runtimeOnly:{description:"When true, contracts action only includes actions invocable in the current runtime."},activeOnly:{description:"Alias for runtimeOnly in contracts action payloads."},depth:{description:"Context depth level controlling how many sections are included (brief=focus+agenda, standard=+hierarchy/activity/progress/workload, deep=all sections, full=every section with no per-section row cap).",examples:["brief","standard","deep","full"]},section:{description:"Repeatable section selector for context; overrides --depth when provided.",examples:[["hierarchy","activity"],["blockers","files","staleness"]]},activityLimit:{description:"Maximum number of recent activity entries to include in context output.",examples:[5,10,"20"]},staleThreshold:{description:"Staleness cutoff in days for context staleness section (e.g. 7 or 7d).",examples:["7","14d","30"]}};const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA={"health":{strictExit:{description:"Return non-zero for a failing health verdict; also require merge drivers."}},"validate":{strictExit:{description:"Return non-zero when validation reports warnings."}},"extension-doctor":{strictExit:{description:"Return non-zero when extension diagnostics report warnings or a non-ok summary."}},"package-doctor":{strictExit:{description:"Return non-zero when package diagnostics report warnings or a non-ok summary."}},"history":{strictExit:{description:"Return non-zero for history verification failures when verify is enabled."}},extension:{strictExit:{description:"For doctor operations, return non-zero on warnings or a non-ok diagnostic summary."}},package:{strictExit:{description:"For doctor operations, return non-zero on warnings or a non-ok diagnostic summary."}},assurance:{subcommand:{description:"Assurance operation: list, show, put, remove, run, verdicts, presets, apply, derive, promote, risk, or lineages.",examples:["list","run","risk","lineages"]},kind:{description:"Assurance declaration kind for registry operations: measurement, assertion, or gate.",examples:["measurement","assertion","gate"]},id:{description:"Stable assurance declaration id or gate id, depending on subcommand.",examples:["active-issues","release-readiness"]},limit:{description:"Maximum number of newest assurance verdicts returned.",examples:[10,25]},preset:{description:"Built-in assurance project shape to preview or apply.",examples:["software-delivery","agent-evaluation"]}},update:{acceptanceCriteria:{description:"Complete acceptance-criteria replacement text. Use removeAc plus addAc together for an atomic one-entry repair that preserves unrelated criteria."}},"update-many":{acceptanceCriteria:{description:"Complete acceptance-criteria replacement text. Use removeAc plus addAc together for an atomic one-entry repair that preserves unrelated criteria."}},stats:{since:{description:"Inclusive ISO 8601 timestamp or negative duration lower bound for provenance and fleet analytics.",examples:["2026-08-01T00:00:00.000Z","-30d"]}},events:{since:{description:"Durable event cursor returned as next_cursor, or an inclusive event timestamp.",examples:["eyJmaW5nZXJwcmludCI6Ii4uLiJ9","2026-08-01T00:00:00.000Z"]},type:{description:"Mutation event type filter, supplied once or as a list.",examples:["create",["create","update"]]},author:{description:"Mutation author filter, supplied once or as a list.",examples:["agent-a",["agent-a","agent-b"]]},item:{description:"Tracked item id filter, supplied once or as a list.",examples:["pm-a1b2",["pm-a1b2","pm-c3d4"]]},limit:{description:"Maximum mutation events returned, from 0 through 1000.",examples:[0,100]},cursorMode:{description:"Cursor framing: batch returns one terminal next_cursor (default); row also adds a cursor to every event.",examples:["batch","row"]}},remind:{at:{description:"Reminder time as an ISO 8601 timestamp or supported relative expression.",examples:["2026-08-02T09:00:00+02:00","tomorrow 09:00"]}},deps:{tokenBudget:{description:"Maximum estimated output tokens for deps --format context.",examples:[600,"1200"]}},comments:{full:{description:"Return the complete post-mutation comment history instead of the bounded mutation receipt projection."},ifAbsent:{description:"Append a comment only when the resolved author and exact stored text are absent; a duplicate retry returns changed false without writing history."}},notes:{full:{description:"Return the complete post-mutation note history instead of the bounded mutation receipt projection."},ifAbsent:{description:"Append a note only when the resolved author and exact stored text are absent; a duplicate retry returns changed false without writing history."},since:{description:"Inclusive ISO 8601 creation timestamp lower bound for structured note event filtering.",examples:["2026-01-01T00:00:00.000Z"]}},learnings:{full:{description:"Return the complete post-mutation learning history instead of the bounded mutation receipt projection."},ifAbsent:{description:"Append a learning only when the resolved author and exact stored text are absent; a duplicate retry returns changed false without writing history."}},next:{tag:{description:"Only recommend items carrying this exact tag.",examples:["sdk","release"]},tokenBudget:{description:"Maximum estimated output tokens for the recommendation context.",examples:[600,"1200"]}},claim:{tag:{description:"When claiming the next item, only consider work carrying this exact tag.",examples:["sdk","release"]},tokenBudget:{description:"Maximum estimated output tokens for the next-item context returned with the claim.",examples:[600,"1200"]}},close:{text:{description:"Backward-compatible alias for the item close reason when reason is not provided."}},"close-task":{text:{description:"Close reason used before releasing the item's active assignment."}},schema:{definition:{description:"Workflow policy declaration for policy-put, or proposed item fields for policy-check."},policy:{description:"Declared approval rule id for policy-approve."},name:{description:"Custom item type name, status id, field key, policy id, or item id for the selected schema verb; policy-mode requires advise|refuse.",examples:["Spike","review","component"]}},profile:{name:{description:"Profile name for show/apply/lint. Built-in profiles are agile, ops, and research; an active extension can contribute additional archetype names that resolve here too.",examples:["agile","ops","research"]}},graph:{subcommand:{description:"Graph query selector: ancestors|descendants|predecessors|successors|paths|impact|analyze|audit|communities|redundancy|dominators|slack|centrality|articulation|plan|index. Traversals, paths, impact, and dominators require id; paths also requires target; slack reports critical-path float, centrality ranks betweenness/closeness/degree, articulation reports cut points and bridges; plan derives dry-run remediation proposals from the governance audit; index reports, rebuilds, or clears the durable cross-process graph index.",examples:["successors","audit"]},clear:{description:"When true, delete the durable graph index (graph index only)."},id:{description:"Root item id for traversal, paths, impact, and dominators graph queries.",examples:["pm-x1y2"]},target:{description:"Target item id for graph paths queries.",examples:["pm-a3b4"]},direction:{description:'Edge orientation for graph paths/impact/dominators queries ("outgoing", "incoming", or "both"; default "both").',examples:["incoming"]},kind:{description:"Registered relationship kinds narrowing the graph query (string, comma-separated, or array).",examples:["blocked_by",["parent","related"]]},maxDepth:{description:"Maximum graph traversal depth (non-negative integer).",examples:[2,"4"]},after:{description:"Resume a hierarchy/ordering graph traversal after this previously returned node id.",examples:["pm-x1y2"]},limit:{description:"Maximum returned rows per bounded graph collection (traversal ids, impact rows, analyze/communities samples, redundancy rows, dominator bottlenecks).",examples:[10,"25"]},summary:{description:"When true, return counts-first graph envelopes without row collections."}}};export{PLAN_ACTION_PARAMETER_METADATA,PLAN_ACTION_PARAMETER_PROPERTIES,PLAN_SUBCOMMAND_VALUES,PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA,PM_TOOL_ACTION_SCOPED_PARAMETER_PROPERTIES,PM_TOOL_PARAMETER_METADATA,PM_TOOL_PARAMETER_PROPERTIES};
 //# sourceMappingURL=tool-parameter-tables.js.map
-//# debugId=7f278171-3479-5ce6-a925-da6393463200