@bridge_gpt/mcp-server 0.2.50 → 0.2.51

package/build/sfcc/reads-custom-object-def.js

@@ -50,11 +50,10 @@ const READ_ANNOTATIONS = {
 // ---------------------------------------------------------------------------
 // Input schemas
 // ---------------------------------------------------------------------------
-const OBJECT_TYPE_DISCOVERY_HINT = 'Known custom object type id (e.g. starting with "c_"). OCAPI cannot enumerate ' +
-    "type IDs directly, but you can discover a candidate via system_object_list at " +
-    "projection=\"full\" (distinct display_name + attribute_definition_count per " +
-    "custom type) and confirm it by checking that this tool's returned attribute " +
-    "count matches that row's attribute_definition_count.";
+const OBJECT_TYPE_DISCOVERY_HINT = 'Known custom object type id (e.g. starting with "c_"). ' +
+    "Type ids aren't enumerable; find via system_object_list projection=full. " +
+    "Match by display_name + attribute_definition_count per custom type, then " +
+    "confirm this tool's returned attribute count matches that row's count.";
 const customObjectAttributesGetInput = z.object({
     object_type: z.string().describe(OBJECT_TYPE_DISCOVERY_HINT),
     projection: projectionInputFor("attribute_collection"),
@@ -139,20 +138,18 @@ function buildCustomObjectAttributeSearchHandler(gateDeps, getDocsDir) {
 export function registerSfccCustomObjectDefReadTools(registerTool, deps) {
     const { gateDeps, getDocsDir } = deps;
     registerTool("custom_object_definition_attributes_get", {
-        description: "Retrieve attribute definitions for a KNOWN custom object type via " +
+        description: "Retrieve the FULL attribute-definition set for a KNOWN custom object type via " +
             "GET /custom_object_definitions/{type}/attribute_definitions " +
-            "(default_value withheld). OCAPI cannot enumerate type IDs directly; " +
-            "derive one via system_object_list (projection=full, attribute_definition_count), " +
-            "confirm here. Type creation is v2 metadata-import only.",
+            "(default_value withheld). Type creation is v2 metadata-import only. " +
+            "Oversized output saved locally.",
         inputSchema: customObjectAttributesGetInput,
         annotations: READ_ANNOTATIONS,
     }, buildCustomObjectAttributesGetHandler(gateDeps, getDocsDir));
     registerTool("custom_object_definition_attribute_search", {
-        description: "Search attribute definitions within a KNOWN custom object type via " +
+        description: "Filter the attribute-definition set within a KNOWN custom object type via " +
             "POST /custom_object_definitions/{type}/attribute_definition_search " +
-            "(default_value withheld). OCAPI cannot enumerate type IDs directly; " +
-            "derive one via system_object_list (projection=full, attribute_definition_count), " +
-            "confirm here. Type creation is v2 metadata-import only.",
+            "(default_value withheld). Type creation is v2 metadata-import only. " +
+            "Oversized output saved locally.",
         inputSchema: customObjectAttributeSearchInput,
         annotations: READ_ANNOTATIONS,
     }, buildCustomObjectAttributeSearchHandler(gateDeps, getDocsDir));

package/build/sfcc/reads-site-preference.js

@@ -226,15 +226,15 @@ export function registerSitePreferenceTools(registerTool, deps) {
         description: "List custom site preference group ids from the developer sandbox via " +
             "GET /system_object_definitions/SitePreferences/attribute_groups. Read-only; " +
             "use this to discover group ids before site_preference_get or site_preference_search. " +
-            "Accepts optional `count` and `start` for paging. Oversized outputs are auto-saved locally.",
+            "Accepts optional `count` and `start` for paging. Oversized output saved locally.",
         inputSchema: sitePreferenceGroupListInput,
         annotations: READ_ANNOTATIONS,
     }, buildSitePreferenceGroupListHandler(gateDeps, getDocsDir));
     registerTool("site_preference_get", {
-        description: "List preference IDENTIFIERS for a site preference group from the developer sandbox via a match-all " +
+        description: "List ALL preference ids in a group (match-all) from the developer sandbox via " +
             "POST /site_preferences/preference_groups/{group}/sandbox/preference_search. " +
-            "Returns ids only, NOT values — 'unset' and 'empty string' are indistinguishable. " +
-            "Read-only, sandbox-only. Optional start/count paging. Oversized payloads auto-saved locally.",
+            "Returns identifiers only, NOT values — 'unset' and 'empty string' are indistinguishable. " +
+            "Read-only, sandbox-only. Optional start/count paging. Oversized output saved locally.",
         inputSchema: sitePreferenceGetInput,
         annotations: READ_ANNOTATIONS,
     }, buildSitePreferenceGetHandler(gateDeps, getDocsDir));
@@ -243,7 +243,7 @@ export function registerSitePreferenceTools(registerTool, deps) {
             "POST /site_preferences/preference_groups/{group}/sandbox/preference_search. " +
             "Returns ids only — this endpoint does not expose values. Read-only; v1 sandbox only. " +
             "Pass a plain string for id-only text search or a structured OCAPI query. " +
-            "Oversized results auto-saved locally.",
+            "Oversized output saved locally.",
         inputSchema: sitePreferenceSearchInput,
         annotations: READ_ANNOTATIONS,
     }, buildSitePreferenceSearchHandler(gateDeps, getDocsDir));

package/build/sfcc/reads-system-object.js

@@ -149,7 +149,7 @@ export function registerSystemObjectReadTools(registerTool, deps) {
             "GET /system_object_definitions. Read-only. " +
             "Accepts optional `count` and `start` for paging (OCAPI default pagination applies when omitted). " +
             "Returns ids only by default; pass projection=full for all fields. " +
-            "Oversized outputs are auto-saved locally.",
+            "Oversized output saved locally.",
         inputSchema: systemObjectListInput,
         annotations: READ_ANNOTATIONS,
     }, buildSystemObjectListHandler(gateDeps, getDocsDir));
@@ -157,17 +157,17 @@ export function registerSystemObjectReadTools(registerTool, deps) {
         description: "Retrieve a system object type definition from the developer sandbox. Read-only. " +
             "GET /system_object_definitions/{type}. " +
             "Prefer system_object_attribute_search for targeted attribute lookups. " +
-            "Oversized payloads are auto-saved locally.",
+            "Oversized output saved locally.",
         inputSchema: systemObjectGetInput,
         annotations: READ_ANNOTATIONS,
     }, buildSystemObjectGetHandler(gateDeps, getDocsDir));
     registerTool("system_object_attribute_search", {
         description: "Search attribute definitions for a system object type. Read-only. " +
             "POST /system_object_definitions/{type}/attribute_definition_search. " +
-            "Use for targeted c_ attribute lookups; returns each attribute's schema " +
+            "Use for targeted attribute lookups; returns each attribute's schema " +
             "by default (default_value withheld). " +
             "Pass a plain string for text search or a structured OCAPI query. " +
-            "Oversized results auto-saved locally.",
+            "Oversized output saved locally.",
         inputSchema: systemObjectAttributeSearchInput,
         annotations: READ_ANNOTATIONS,
     }, buildSystemObjectAttributeSearchHandler(gateDeps, getDocsDir));

package/build/sfcc/writes-custom-object-def.js

@@ -37,9 +37,8 @@ const INSTANCE_DESCRIBE = "OCAPI instance context. Omit or pass \"sandbox\"; any
 const createCustomObjectAttributeDefinitionInput = z.object({
     object_type: z
         .string()
-        .describe('Known custom object type identifier (must already exist). OCAPI cannot ' +
-        "create types, and cannot enumerate type IDs directly — only attribute " +
-        "definitions on a known type."),
+        .describe('Known custom object type identifier (must already exist; OCAPI cannot create ' +
+        "types). Type ids aren't enumerable; find via system_object_list projection=full."),
     attribute_id: z
         .string()
         .describe("URL attribute-definition id. If the body also carries `id`, it must match."),
@@ -49,7 +48,8 @@ const createCustomObjectAttributeDefinitionInput = z.object({
 const updateCustomObjectAttributeDefinitionInput = z.object({
     object_type: z
         .string()
-        .describe("Known custom object type identifier (must already exist). OCAPI cannot create types."),
+        .describe("Known custom object type identifier (must already exist; OCAPI cannot create " +
+        "types). Type ids aren't enumerable; find via system_object_list projection=full."),
     attribute_id: z.string().describe("URL attribute-definition id to update."),
     patch: objectAttributeDefinitionPatchBodySchema.describe("Partial ObjectAttributeDefinition body; must change at least one field."),
     instance: z.string().optional().describe(INSTANCE_DESCRIBE),
@@ -134,15 +134,15 @@ export function registerSfccCustomObjectDefWriteTools(registerTool, deps) {
     registerTool("custom_object_definition_attribute_create", {
         description: "Create an attribute definition on a KNOWN custom object type via " +
             "PUT /custom_object_definitions/{type}/attribute_definitions/{id}. Sandbox-only, " +
-            "destructive; the type must pre-exist (OCAPI cannot create types). Echoes paste-ready " +
-            "grant JSON on 403.",
+            "destructive; the type must pre-exist (OCAPI cannot create types). " +
+            "403 → paste-ready grant JSON.",
         inputSchema: createCustomObjectAttributeDefinitionInput,
         annotations: WRITE_ANNOTATIONS,
     }, buildCreateCustomObjectAttributeDefinitionHandler(gateDeps));
     registerTool("custom_object_definition_attribute_update", {
         description: "Update an attribute definition on a KNOWN custom object type via an ETag-conditional " +
             "PATCH /custom_object_definitions/{type}/attribute_definitions/{id}. Sandbox-only, " +
-            "destructive; surfaces 409/412 conflicts and echoes grant JSON on 403.",
+            "destructive; surfaces 409/412 conflicts. 403 → paste-ready grant JSON.",
         inputSchema: updateCustomObjectAttributeDefinitionInput,
         annotations: WRITE_ANNOTATIONS,
     }, buildUpdateCustomObjectAttributeDefinitionHandler(gateDeps));

package/build/sfcc/writes-site-preference.js

@@ -92,9 +92,10 @@ export const SITE_PREFERENCE_WRITE_TOOL_NAMES = ["site_preference_values_set"];
 export function registerSitePreferenceWriteTools(registerTool, deps) {
     const { gateDeps } = deps;
     registerTool("site_preference_values_set", {
-        description: "Set custom site-preference VALUES via PATCH /site_preferences/preference_groups/{group}/sandbox. " +
-            "Sandbox-only, destructive; body is a flat map of c_-prefixed ids to string/number/boolean/string[] " +
-            "values. A bad group returns 404 CustomPreferenceGroupNotFoundException; echoes grant JSON on 403.",
+        description: "Set site-preference VALUES via PATCH /site_preferences/preference_groups/{group}/sandbox. " +
+            "Preference must already be defined via custom_preference_definition_create. Sandbox-only, " +
+            "destructive; flat c_-prefixed id→value map (string/number/boolean/string[]). " +
+            "Bad group → 404 CustomPreferenceGroupNotFoundException. 403 → paste-ready grant JSON.",
         inputSchema: sitePreferenceValuesSetInput,
         annotations: WRITE_ANNOTATIONS,
     }, buildSitePreferenceValuesSetHandler(gateDeps));

package/build/sfcc/writes-system-object.js

@@ -276,42 +276,43 @@ export function registerSystemObjectWriteTools(registerTool, deps) {
     registerTool("system_object_attribute_definition_create", {
         description: "Create a system-object attribute definition (sandbox-only, destructive). " +
             "PUT .../attribute_definitions/{id}; body id must equal URL id and system must be false. " +
-            "Returns 201. HTTP 403 echoes the OCAPI write-grant JSON.",
+            "Returns 201. 403 → paste-ready grant JSON.",
         inputSchema: createAttributeDefinitionInput,
         annotations: WRITE_ANNOTATIONS,
     }, buildCreateAttributeDefinitionHandler(gateDeps));
     registerTool("system_object_attribute_definition_update", {
         description: "Update a system-object attribute definition (sandbox-only, destructive). " +
             "PATCH .../attribute_definitions/{id} via the ETag GET-then-If-Match round trip. " +
-            "Returns 200; surfaces 409/412 on ETag conflicts. HTTP 403 echoes the write-grant JSON.",
+            "Returns 200; surfaces 409/412 on ETag conflicts. 403 → paste-ready grant JSON.",
         inputSchema: updateAttributeDefinitionInput,
         annotations: WRITE_ANNOTATIONS,
     }, buildUpdateAttributeDefinitionHandler(gateDeps));
     registerTool("system_object_attribute_group_create", {
         description: "Create a system-object attribute group (sandbox-only, destructive). " +
             "PUT .../attribute_groups/{id} with a minimal body (display_name + internal). " +
-            "HTTP 403 echoes the OCAPI write-grant JSON.",
+            "403 → paste-ready grant JSON.",
         inputSchema: createAttributeGroupInput,
         annotations: WRITE_ANNOTATIONS,
     }, buildCreateAttributeGroupHandler(gateDeps));
     registerTool("system_object_attribute_group_update", {
         description: "Update a system-object attribute group (sandbox-only, destructive). " +
             "PATCH .../attribute_groups/{id} via the ETag round trip (display_name and/or internal). " +
-            "HTTP 403 echoes the OCAPI write-grant JSON.",
+            "403 → paste-ready grant JSON.",
         inputSchema: updateAttributeGroupInput,
         annotations: WRITE_ANNOTATIONS,
     }, buildUpdateAttributeGroupHandler(gateDeps));
     registerTool("system_object_attribute_assign_to_group", {
         description: "Assign an attribute definition to an attribute group (sandbox-only, destructive). " +
             "PUT .../attribute_groups/{group}/attribute_definitions/{def} with an empty body. " +
-            "HTTP 403 echoes the OCAPI write-grant JSON.",
+            "403 → paste-ready grant JSON.",
         inputSchema: assignAttributeToGroupInput,
         annotations: WRITE_ANNOTATIONS,
     }, buildAssignAttributeToGroupHandler(gateDeps));
     registerTool("custom_preference_definition_create", {
         description: "Create a custom preference definition (sandbox-only, destructive). " +
             "PUT .../{SitePreferences|OrganizationPreferences}/attribute_definitions/{id}. " +
-            "Booleans resolve to null unless default_value is set. HTTP 403 echoes the write-grant JSON.",
+            "Booleans resolve to null unless default_value is set. After defining the schema, " +
+            "set its value with site_preference_values_set. 403 → paste-ready grant JSON.",
         inputSchema: createCustomPreferenceDefinitionInput,
         annotations: WRITE_ANNOTATIONS,
     }, buildCreateCustomPreferenceDefinitionHandler(gateDeps));

package/build/version.generated.js

@@ -1,4 +1,4 @@
 // AUTO-GENERATED — do not edit manually. Regenerate with: npm run build
-export const VERSION = "0.2.50";
-export const BUILD_COMMIT = "4b5d3e65b2a3";
-export const LAUNCHER_ARGS = ["-y", "--prefer-offline", "@bridge_gpt/mcp-server@0.2.50", "serve"];
+export const VERSION = "0.2.51";
+export const BUILD_COMMIT = "3cdbee6cfd9b";
+export const LAUNCHER_ARGS = ["-y", "--prefer-offline", "@bridge_gpt/mcp-server@0.2.51", "serve"];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridge_gpt/mcp-server",
-  "version": "0.2.50",
+  "version": "0.2.51",
   "description": "Bridge API MCP server — exposes Jira endpoints as MCP tools for Claude Code agents",
   "license": "MIT",
   "type": "module",
@@ -26,6 +26,7 @@
     "build": "node scripts/bundle-version.js && node scripts/sync-readme-host-examples.js --check && node scripts/validate-packaged-command-references.js && node scripts/bundle-readme.js && node scripts/bundle-pipelines.js && node scripts/bundle-commands.js && node scripts/bundle-agents.js && node scripts/bundle-docs.js && tsc && node scripts/sync-agent-mirrors.js && node scripts/bundle-esbuild.js",
     "version": "node scripts/sync-readme-host-examples.js --write && git add -- README.md package.json package-lock.json && git commit -m \"chore(mcp-server): release $npm_package_version\" && git tag \"mcp-server/v$npm_package_version\"",
     "check:version-generated": "node scripts/bundle-version.js && node scripts/check-version-generated.js",
+    "assert:release-identity": "node scripts/assert-release-identity.js",
     "postbuild": "node scripts/prepend-shebang.cjs",
     "start": "node build/index.js",
     "test": "npm run test:normal && npm run test:module-mocks",
@@ -34,7 +35,7 @@
     "test:integration": "node scripts/run-integration-tests.js",
     "test:smoke": "node --test build/integration/packaged-cli-smoke.test.js",
     "canary:agent-capabilities": "npm run build && node scripts/agent-capabilities-canary.mjs",
-    "prepublishOnly": "node scripts/bundle-assets.js && npm run build && node scripts/verify-shebang.cjs"
+    "prepublishOnly": "node scripts/bundle-assets.js && npm run build && node scripts/verify-shebang.cjs && npm run assert:release-identity"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",

package/pipelines/plan-epic.json

@@ -45,6 +45,11 @@
       "instruction_file": "explore-epic-subtasks.md",
       "description": "Perform focused exploration for each sub-task"
     },
+    {
+      "type": "agent_task",
+      "instruction_file": "assess-conductor-eligibility.md",
+      "description": "Assessing conductor eligibility"
+    },
     {
       "type": "agent_task",
       "instruction_file": "write-epic-summary.md",