@unbrained/pm-cli 2026.9.6 → 2026.9.8

package/dist/mcp/legacy-adapter.js

@@ -1,78 +1,2 @@
-/**
- * @module mcp/legacy-adapter
- *
- * Isolates the bounded initialize-era stdio compatibility surface from the
- * canonical stateless dispatcher. No modern transport imports policy from it.
- */
-
-!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]="75228af6-d015-596d-ac32-4f5e78cb3916")}catch(e){}}();
-import { PmCliError } from "../sdk/runtime-primitives.js";
-import { PM_MCP_ERROR_CODES, PM_MCP_LEGACY_PROTOCOL_VERSIONS, PM_MCP_PROTOCOL_VERSION, PmMcpProtocolError, } from "../sdk/mcp/protocol.js";
-/**
- * Resolve the legacy revision a handshake negotiates, or refuse with the full
- * supported set.
- *
- * A legacy client has no fall-forward mechanism, so the refusal names every
- * accepted legacy revision alongside the canonical modern one: the error text
- * is the only diagnostic such a client can surface.
- */
-export function resolveLegacyProtocolVersion(requestedVersion) {
-    if (requestedVersion === undefined || requestedVersion === null) {
-        return PM_MCP_LEGACY_PROTOCOL_VERSIONS[0];
-    }
-    const accepted = PM_MCP_LEGACY_PROTOCOL_VERSIONS.find((candidate) => candidate === requestedVersion);
-    if (accepted)
-        return accepted;
-    throw new PmMcpProtocolError("Unsupported legacy MCP protocol version", PM_MCP_ERROR_CODES.unsupportedProtocolVersion, {
-        supported: [...PM_MCP_LEGACY_PROTOCOL_VERSIONS],
-        requested: requestedVersion,
-        modern: PM_MCP_PROTOCOL_VERSION,
-    });
-}
-/** Explicit compatibility adapter with no cross-process or modern-session role. */
-export class LegacyMcpAdapter {
-    #options;
-    #clientInfo;
-    /** Create one process-local legacy stdio adapter. */
-    constructor(options) {
-        this.#options = options;
-    }
-    /** Read the bounded identity most recently supplied to legacy initialize. */
-    getClientInfo() {
-        return this.#clientInfo ? structuredClone(this.#clientInfo) : undefined;
-    }
-    /** Validate and answer the historical initialize handshake. */
-    initialize(params) {
-        const requestedVersion = params?.protocolVersion;
-        const negotiatedVersion = resolveLegacyProtocolVersion(requestedVersion);
-        this.#clientInfo = this.#options.parseClientInfo(params?.clientInfo);
-        return {
-            protocolVersion: negotiatedVersion,
-            capabilities: structuredClone(this.#options.capabilities),
-            serverInfo: { ...this.#options.serverInfo },
-            instructions: this.#options.instructions,
-        };
-    }
-    /** Dispatch one unversioned request through the finite legacy method set. */
-    async dispatch(request) {
-        if (request.method === "ping")
-            return {};
-        if (request.method === "tools/list")
-            return this.#options.listTools(request.params);
-        if (request.method === "tools/call") {
-            return this.#options.callTool(request.params, this.#clientInfo);
-        }
-        if (request.method === "resources/list")
-            return this.#options.listResources();
-        if (request.method === "resources/read") {
-            return this.#options.readResource(request.params);
-        }
-        if (request.method === "prompts/list")
-            return this.#options.listPrompts();
-        if (request.method === "prompts/get")
-            return this.#options.getPrompt(request.params);
-        throw new PmCliError(`Unsupported MCP method: ${request.method ?? "(missing)"}`, 64);
-    }
-}
+!(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]="b2c28b4c-9997-5b7f-a24a-12116f19c004")}catch(e2){}})();import{PmCliError}from"../sdk/runtime-primitives.js";import{PM_MCP_ERROR_CODES,PM_MCP_LEGACY_PROTOCOL_VERSIONS,PM_MCP_PROTOCOL_VERSION,PmMcpProtocolError}from"../sdk/mcp/protocol.js";function resolveLegacyProtocolVersion(requestedVersion){if(requestedVersion===void 0||requestedVersion===null){return PM_MCP_LEGACY_PROTOCOL_VERSIONS[0]}const accepted=PM_MCP_LEGACY_PROTOCOL_VERSIONS.find(candidate=>candidate===requestedVersion);if(accepted)return accepted;throw new PmMcpProtocolError("Unsupported legacy MCP protocol version",PM_MCP_ERROR_CODES.unsupportedProtocolVersion,{supported:[...PM_MCP_LEGACY_PROTOCOL_VERSIONS],requested:requestedVersion,modern:PM_MCP_PROTOCOL_VERSION})}class LegacyMcpAdapter{#options;#clientInfo;constructor(options){this.#options=options}getClientInfo(){return this.#clientInfo?structuredClone(this.#clientInfo):void 0}initialize(params){const requestedVersion=params?.protocolVersion;const negotiatedVersion=resolveLegacyProtocolVersion(requestedVersion);this.#clientInfo=this.#options.parseClientInfo(params?.clientInfo);return{protocolVersion:negotiatedVersion,capabilities:structuredClone(this.#options.capabilities),serverInfo:{...this.#options.serverInfo},instructions:this.#options.instructions}}async dispatch(request){if(request.method==="ping")return{};if(request.method==="tools/list")return this.#options.listTools(request.params);if(request.method==="tools/call"){return this.#options.callTool(request.params,this.#clientInfo)}if(request.method==="resources/list")return this.#options.listResources();if(request.method==="resources/read"){return this.#options.readResource(request.params)}if(request.method==="prompts/list")return this.#options.listPrompts();if(request.method==="prompts/get")return this.#options.getPrompt(request.params);throw new PmCliError(`Unsupported MCP method: ${request.method??"(missing)"}`,64)}}export{LegacyMcpAdapter,resolveLegacyProtocolVersion};
 //# sourceMappingURL=legacy-adapter.js.map
-//# debugId=75228af6-d015-596d-ac32-4f5e78cb3916

package/dist/mcp/runtime-capabilities.js

@@ -1,201 +1,2 @@
-/**
- * @module mcp/runtime-capabilities
- *
- * Resolves bounded MCP profiles and workspace-customized tool schemas from the
- * public SDK contracts.
- */
-
-!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]="428f8ed0-dfa8-5c8e-9fdc-baa9fbf9b030")}catch(e){}}();
-import { PM_MCP_TOOL_COMMAND_CONTRACTS, listPmMcpToolsForProfile, } from "../sdk/agent-capability-contracts.js";
-import { getWorkspaceContracts, } from "../sdk/runtime.js";
-import { PmCliError, getSettingsPath, pathExists, resolvePmRoot, } from "../sdk/runtime-primitives.js";
-import { TOOLS, } from "./tool-definitions.js";
-function workspaceFields(workspace) {
-    return workspace.fields ?? [];
-}
-function workspaceExtensionCommands(workspace) {
-    return workspace.extensionCommands ?? [];
-}
-function compactSchemaDescriptions(value, inProperties = false) {
-    if (Array.isArray(value)) {
-        return value.map((entry) => compactSchemaDescriptions(entry));
-    }
-    if (typeof value !== "object" || value === null) {
-        return value;
-    }
-    return Object.fromEntries(Object.entries(value)
-        .filter(([key]) => inProperties || key !== "description")
-        .map(([key, entry]) => [
-        key,
-        compactSchemaDescriptions(entry, key === "properties"),
-    ]));
-}
-function parseCustomToolAllowlist(value, availableNames) {
-    const requested = new Set((value ?? "")
-        .split(",")
-        .map((name) => name.trim())
-        .filter(Boolean));
-    if (requested.size === 0) {
-        throw new PmCliError("PM_MCP_PROFILE=custom requires a non-empty PM_MCP_TOOLS allowlist.", 64);
-    }
-    const unknown = [...requested].filter((name) => !availableNames.has(name));
-    if (unknown.length > 0) {
-        throw new PmCliError(`PM_MCP_TOOLS contains unknown tools: ${unknown.join(", ")}.`, 64);
-    }
-    return requested;
-}
-function resolveSelectedToolNames(availableTools, profile, environment) {
-    const availableNames = new Set(availableTools.map((tool) => tool.name));
-    return profile === "custom"
-        ? parseCustomToolAllowlist(environment.PM_MCP_TOOLS, availableNames)
-        : new Set(listPmMcpToolsForProfile([...availableNames], profile));
-}
-/** Resolve and validate the configured MCP profile. */
-export function resolveMcpToolProfile(environment = process.env) {
-    const value = environment.PM_MCP_PROFILE?.trim().toLowerCase() || "core";
-    if (value !== "core" &&
-        value !== "standard" &&
-        value !== "full" &&
-        value !== "custom") {
-        throw new PmCliError(`Invalid PM_MCP_PROFILE "${value}"; expected core, standard, full, or custom.`, 64);
-    }
-    return value;
-}
-/** Select extension actions visible to one validated MCP profile. */
-export function selectMcpExtensionActions(commands, profile, selectedNames) {
-    const profileRanks = { core: 0, standard: 1, full: 2 };
-    const tierRanks = { core: 0, standard: 1, full: 2, internal: 3 };
-    return commands
-        .filter((command) => profile === "custom"
-        ? selectedNames.has("pm_run")
-        : tierRanks[command.tier] <= profileRanks[profile])
-        .map((command) => command.action);
-}
-function fieldProperty(type, description) {
-    if (type === "array") {
-        return { type: "array", items: {}, description };
-    }
-    if (type === "object") {
-        return { type: "object", additionalProperties: true, description };
-    }
-    const scalar = {
-        type: type === "string_array" ? "string" : type,
-        description,
-    };
-    return type === "string_array"
-        ? {
-            type: "array",
-            items: scalar,
-            description,
-        }
-        : scalar;
-}
-function projectWorkspaceToolDefinition(tool, workspace, extensionActions, compact) {
-    const inputSchema = structuredClone(tool.inputSchema);
-    const properties = inputSchema.properties;
-    const command = PM_MCP_TOOL_COMMAND_CONTRACTS[tool.name];
-    if (workspace && command) {
-        if (properties.type)
-            properties.type.enum = [...workspace.types];
-        if (properties.status)
-            properties.status.enum = [...workspace.statuses];
-        for (const field of workspaceFields(workspace)) {
-            if (field.commands.includes(command) &&
-                !Object.prototype.hasOwnProperty.call(properties, field.optionName)) {
-                properties[field.optionName] = fieldProperty(field.type, field.description);
-            }
-        }
-    }
-    if (tool.name === "pm_run" && extensionActions.length > 0) {
-        const action = properties.action;
-        action.enum = [
-            ...new Set([...action.enum, ...extensionActions]),
-        ];
-    }
-    return {
-        ...tool,
-        inputSchema: compact ? compactSchemaDescriptions(inputSchema) : inputSchema,
-    };
-}
-/**
- * Resolve a profile-filtered tool list and enrich schemas with live workspace
- * types, statuses, custom fields, and extension actions.
- */
-export async function resolveMcpToolSurface(availableTools, args = {}, environment = process.env) {
-    const profile = resolveMcpToolProfile(environment);
-    const selectedNames = resolveSelectedToolNames(availableTools, profile, environment);
-    const cwd = typeof args.cwd === "string" ? args.cwd : process.cwd();
-    const pmRoot = resolvePmRoot(cwd, typeof args.path === "string" ? args.path : undefined);
-    const workspace = (await pathExists(getSettingsPath(pmRoot)))
-        ? await getWorkspaceContracts(pmRoot, { cwd })
-        : null;
-    const extensionActions = selectMcpExtensionActions(workspace ? workspaceExtensionCommands(workspace) : [], profile, selectedNames);
-    if (extensionActions.length > 0 && profile !== "custom") {
-        selectedNames.add("pm_run");
-    }
-    const tools = availableTools
-        .filter((tool) => selectedNames.has(tool.name))
-        .map((tool) => projectWorkspaceToolDefinition(tool, workspace, extensionActions, profile === "core"));
-    return { profile, tools, extensionActions };
-}
-/**
- * Resolve one tool's callability without cloning and enriching the complete
- * schema surface. Only compact/standard `pm_run` calls need workspace
- * contracts because an activated extension action can promote that dispatcher.
- */
-export async function resolveMcpToolAccess(availableTools, toolName, args = {}, environment = process.env) {
-    const profile = resolveMcpToolProfile(environment);
-    const selectedNames = resolveSelectedToolNames(availableTools, profile, environment);
-    if (selectedNames.has(toolName))
-        return { profile, available: true };
-    if (toolName !== "pm_run" || profile === "custom") {
-        return { profile, available: false };
-    }
-    const cwd = typeof args.cwd === "string" ? args.cwd : process.cwd();
-    const pmRoot = resolvePmRoot(cwd, typeof args.path === "string" ? args.path : undefined);
-    if (!(await pathExists(getSettingsPath(pmRoot)))) {
-        return { profile, available: false };
-    }
-    const workspace = await getWorkspaceContracts(pmRoot, { cwd });
-    return {
-        profile,
-        available: selectMcpExtensionActions(workspaceExtensionCommands(workspace), profile, selectedNames).length > 0,
-    };
-}
-/** Move declared custom-field inputs into the runtime action option bag. */
-export async function normalizeWorkspaceToolArguments(toolName, args) {
-    const command = PM_MCP_TOOL_COMMAND_CONTRACTS[toolName];
-    if (command !== "create" && command !== "update")
-        return args;
-    const cwd = typeof args.cwd === "string" ? args.cwd : process.cwd();
-    const pmRoot = resolvePmRoot(cwd, typeof args.path === "string" ? args.path : undefined);
-    if (!(await pathExists(getSettingsPath(pmRoot))))
-        return args;
-    const workspace = await getWorkspaceContracts(pmRoot, { cwd });
-    const options = typeof args.options === "object" &&
-        args.options !== null &&
-        !Array.isArray(args.options)
-        ? { ...args.options }
-        : {};
-    const normalizedArgs = { ...args };
-    const canonicalTool = TOOLS.find((tool) => tool.name === toolName);
-    const canonicalProperties = new Set(Object.keys(canonicalTool.inputSchema.properties));
-    let changed = false;
-    for (const field of workspaceFields(workspace)) {
-        if (field.commands.includes(command) &&
-            !canonicalProperties.has(field.optionName) &&
-            Object.prototype.hasOwnProperty.call(args, field.optionName)) {
-            options[field.optionName] = args[field.optionName];
-            delete normalizedArgs[field.optionName];
-            changed = true;
-        }
-    }
-    return changed ? { ...normalizedArgs, options } : args;
-}
-/** Internal compatibility helpers exposed only for exhaustive fallback tests. */
-export const _testOnlyMcpRuntimeCapabilities = {
-    workspaceExtensionCommands,
-    workspaceFields,
-};
+!(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]="60fd538d-49b0-5a65-a368-9117b86efa32")}catch(e2){}})();import{PM_MCP_TOOL_COMMAND_CONTRACTS,listPmMcpToolsForProfile}from"../sdk/agent-capability-contracts.js";import{getWorkspaceContracts}from"../sdk/runtime.js";import{PmCliError,getSettingsPath,pathExists,resolvePmRoot}from"../sdk/runtime-primitives.js";import{TOOLS}from"./tool-definitions.js";function workspaceFields(workspace){return workspace.fields??[]}function workspaceExtensionCommands(workspace){return workspace.extensionCommands??[]}function compactSchemaDescriptions(value,inProperties=false){if(Array.isArray(value)){return value.map(entry=>compactSchemaDescriptions(entry))}if(typeof value!=="object"||value===null){return value}return Object.fromEntries(Object.entries(value).filter(([key])=>inProperties||key!=="description").map(([key,entry])=>[key,compactSchemaDescriptions(entry,key==="properties")]))}function parseCustomToolAllowlist(value,availableNames){const requested=new Set((value??"").split(",").map(name=>name.trim()).filter(Boolean));if(requested.size===0){throw new PmCliError("PM_MCP_PROFILE=custom requires a non-empty PM_MCP_TOOLS allowlist.",64)}const unknown=[...requested].filter(name=>!availableNames.has(name));if(unknown.length>0){throw new PmCliError(`PM_MCP_TOOLS contains unknown tools: ${unknown.join(", ")}.`,64)}return requested}function resolveSelectedToolNames(availableTools,profile,environment){const availableNames=new Set(availableTools.map(tool=>tool.name));return profile==="custom"?parseCustomToolAllowlist(environment.PM_MCP_TOOLS,availableNames):new Set(listPmMcpToolsForProfile([...availableNames],profile))}function resolveMcpToolProfile(environment=process.env){const value=environment.PM_MCP_PROFILE?.trim().toLowerCase()||"core";if(value!=="core"&&value!=="standard"&&value!=="full"&&value!=="custom"){throw new PmCliError(`Invalid PM_MCP_PROFILE "${value}"; expected core, standard, full, or custom.`,64)}return value}function selectMcpExtensionActions(commands,profile,selectedNames){const profileRanks={core:0,standard:1,full:2};const tierRanks={core:0,standard:1,full:2,internal:3};return commands.filter(command=>profile==="custom"?selectedNames.has("pm_run"):tierRanks[command.tier]<=profileRanks[profile]).map(command=>command.action)}function fieldProperty(type,description){if(type==="array"){return{type:"array",items:{},description}}if(type==="object"){return{type:"object",additionalProperties:true,description}}const scalar={type:type==="string_array"?"string":type,description};return type==="string_array"?{type:"array",items:scalar,description}:scalar}function projectWorkspaceToolDefinition(tool,workspace,extensionActions,compact){const inputSchema=structuredClone(tool.inputSchema);const properties=inputSchema.properties;const command=PM_MCP_TOOL_COMMAND_CONTRACTS[tool.name];if(workspace&&command){if(properties.type)properties.type.enum=[...workspace.types];if(properties.status)properties.status.enum=[...workspace.statuses];for(const field of workspaceFields(workspace)){if(field.commands.includes(command)&&!Object.prototype.hasOwnProperty.call(properties,field.optionName)){properties[field.optionName]=fieldProperty(field.type,field.description)}}}if(tool.name==="pm_run"&&extensionActions.length>0){const action=properties.action;action.enum=[...new Set([...action.enum,...extensionActions])]}return{...tool,inputSchema:compact?compactSchemaDescriptions(inputSchema):inputSchema}}async function resolveMcpToolSurface(availableTools,args={},environment=process.env){const profile=resolveMcpToolProfile(environment);const selectedNames=resolveSelectedToolNames(availableTools,profile,environment);const cwd=typeof args.cwd==="string"?args.cwd:process.cwd();const pmRoot=resolvePmRoot(cwd,typeof args.path==="string"?args.path:void 0);const workspace=await pathExists(getSettingsPath(pmRoot))?await getWorkspaceContracts(pmRoot,{cwd}):null;const extensionActions=selectMcpExtensionActions(workspace?workspaceExtensionCommands(workspace):[],profile,selectedNames);if(extensionActions.length>0&&profile!=="custom"){selectedNames.add("pm_run")}const tools=availableTools.filter(tool=>selectedNames.has(tool.name)).map(tool=>projectWorkspaceToolDefinition(tool,workspace,extensionActions,profile==="core"));return{profile,tools,extensionActions}}async function resolveMcpToolAccess(availableTools,toolName,args={},environment=process.env){const profile=resolveMcpToolProfile(environment);const selectedNames=resolveSelectedToolNames(availableTools,profile,environment);if(selectedNames.has(toolName))return{profile,available:true};if(toolName!=="pm_run"||profile==="custom"){return{profile,available:false}}const cwd=typeof args.cwd==="string"?args.cwd:process.cwd();const pmRoot=resolvePmRoot(cwd,typeof args.path==="string"?args.path:void 0);if(!await pathExists(getSettingsPath(pmRoot))){return{profile,available:false}}const workspace=await getWorkspaceContracts(pmRoot,{cwd});return{profile,available:selectMcpExtensionActions(workspaceExtensionCommands(workspace),profile,selectedNames).length>0}}async function normalizeWorkspaceToolArguments(toolName,args){const command=PM_MCP_TOOL_COMMAND_CONTRACTS[toolName];if(command!=="create"&&command!=="update")return args;const cwd=typeof args.cwd==="string"?args.cwd:process.cwd();const pmRoot=resolvePmRoot(cwd,typeof args.path==="string"?args.path:void 0);if(!await pathExists(getSettingsPath(pmRoot)))return args;const workspace=await getWorkspaceContracts(pmRoot,{cwd});const options=typeof args.options==="object"&&args.options!==null&&!Array.isArray(args.options)?{...args.options}:{};const normalizedArgs={...args};const canonicalTool=TOOLS.find(tool=>tool.name===toolName);const canonicalProperties=new Set(Object.keys(canonicalTool.inputSchema.properties));let changed=false;for(const field of workspaceFields(workspace)){if(field.commands.includes(command)&&!canonicalProperties.has(field.optionName)&&Object.prototype.hasOwnProperty.call(args,field.optionName)){options[field.optionName]=args[field.optionName];delete normalizedArgs[field.optionName];changed=true}}return changed?{...normalizedArgs,options}:args}const _testOnlyMcpRuntimeCapabilities={workspaceExtensionCommands,workspaceFields};export{_testOnlyMcpRuntimeCapabilities,normalizeWorkspaceToolArguments,resolveMcpToolAccess,resolveMcpToolProfile,resolveMcpToolSurface,selectMcpExtensionActions};
 //# sourceMappingURL=runtime-capabilities.js.map
-//# debugId=428f8ed0-dfa8-5c8e-9fdc-baa9fbf9b030