@mycompbox/compbox-mcp 1.17.2 → 1.19.0

package/index.js

@@ -118,7 +118,8 @@ var init_mailbox = __esm({
     JOB_TYPES = [
       "epic_request",
       "interview_reply",
-      "start_execution"
+      "start_execution",
+      "connect_repo"
     ];
     JOB_STATUSES = [
       "pending",
@@ -328,6 +329,74 @@ var init_skill_packs = __esm({
   }
 });
 
+// ../shared/dist/ai-providers.js
+var aiRouteValues, aiProviderValues, AI_PROVIDERS;
+var init_ai_providers = __esm({
+  "../shared/dist/ai-providers.js"() {
+    "use strict";
+    aiRouteValues = ["machine", "api_key"];
+    aiProviderValues = ["anthropic", "openai", "xai", "openrouter"];
+    AI_PROVIDERS = {
+      anthropic: {
+        id: "anthropic",
+        name: "Anthropic (Claude)",
+        keyPageUrl: "https://console.anthropic.com/settings/keys",
+        limitsPageUrl: "https://console.anthropic.com/settings/limits",
+        keyPrefix: "sk-ant-",
+        steps: [
+          "Sign in to the Anthropic Console and add a payment method or credits under Billing.",
+          'Open API keys and choose Create key. Name it after this project, for example "CompBox \u2013 My App".',
+          "Copy the key. Anthropic shows it only once.",
+          "Optional: set a monthly spend limit under Limits."
+        ],
+        reportsBalance: false
+      },
+      openai: {
+        id: "openai",
+        name: "OpenAI",
+        keyPageUrl: "https://platform.openai.com/api-keys",
+        limitsPageUrl: "https://platform.openai.com/settings/organization/limits",
+        keyPrefix: "sk-",
+        steps: [
+          "Sign in to the OpenAI Platform and add credits under Billing.",
+          "Open API keys and choose Create new secret key. Name it after this project.",
+          "Copy the key. OpenAI shows it only once.",
+          "Optional: set a monthly budget under Limits."
+        ],
+        reportsBalance: false
+      },
+      xai: {
+        id: "xai",
+        name: "xAI (Grok)",
+        keyPageUrl: "https://console.x.ai",
+        limitsPageUrl: "https://console.x.ai",
+        keyPrefix: "xai-",
+        steps: [
+          "Sign in to the xAI Console and add credits under Billing.",
+          "Open API Keys and create a key. Name it after this project.",
+          "Copy the key. xAI shows it only once.",
+          "Optional: set a spending limit in the console."
+        ],
+        reportsBalance: false
+      },
+      openrouter: {
+        id: "openrouter",
+        name: "OpenRouter",
+        keyPageUrl: "https://openrouter.ai/settings/keys",
+        limitsPageUrl: "https://openrouter.ai/settings/credits",
+        keyPrefix: "sk-or-",
+        note: "One key for models from many providers, including free models with daily limits.",
+        steps: [
+          "Sign in to OpenRouter. Free models work without credits; add credits under Credits for paid models and higher limits.",
+          "Open Keys and choose Create key. Name it after yourself or your company, and optionally set a credit limit on the key.",
+          "Copy the key. OpenRouter shows it only once."
+        ],
+        reportsBalance: true
+      }
+    };
+  }
+});
+
 // ../shared/dist/model-catalog.js
 function getModelById(id) {
   return MODEL_CATALOG.find((m) => m.id === id);
@@ -631,10 +700,142 @@ var init_interview_definition = __esm({
   }
 });
 
+// ../shared/dist/interview-completion.js
+function meetsComplianceTarget(compliance) {
+  return !compliance || compliance.tier === TARGET_COMPLIANCE_TIER;
+}
+function buildAuditFeedback(compliance) {
+  const ordered = [
+    ...compliance.issues.filter((i) => i.tier === "critical"),
+    ...compliance.issues.filter((i) => i.tier === "advisory")
+  ].slice(0, 8);
+  const list = ordered.length > 0 ? ordered.map((i) => `- ${i.message}`).join("\n") : "- (no specific issues returned; expand the required fields with more concrete detail)";
+  return `The epic request you just produced scored ${String(compliance.overall)}/100 (tier: ${compliance.tier}). It must reach 90/100 with ZERO critical issues before the interview can finish. Fix these:
+${list}
+
+If you can resolve these by EXPANDING what the employee already told you \u2014 a longer, more complete and concrete problemStatement / proposedSolution / impactAssessment / description that comfortably clear the length minimums \u2014 re-emit the completion JSON now with richer fields. Do NOT re-ask something you already have an answer for. Only if you genuinely need NEW information from the employee, ask ONE focused question to get it.`;
+}
+function isEpicRequestDraft(value) {
+  if (typeof value !== "object" || value === null)
+    return false;
+  const v = value;
+  const nonEmpty = (x) => typeof x === "string" && x.trim().length > 0;
+  const requiredOk = nonEmpty(v.title) && nonEmpty(v.problemStatement) && nonEmpty(v.proposedSolution) && nonEmpty(v.impactAssessment) && nonEmpty(v.description);
+  if (!requiredOk)
+    return false;
+  for (const key of OPTIONAL_DRAFT_KEYS) {
+    if (key in v && v[key] !== void 0 && typeof v[key] !== "string")
+      return false;
+  }
+  return true;
+}
+function stripTrailingCommas(json) {
+  return json.replace(/,(\s*[}\]])/g, "$1");
+}
+function escapeRawControlCharsInStrings(json) {
+  let out = "";
+  let inString = false;
+  let escaped = false;
+  for (const ch of json) {
+    if (escaped) {
+      out += ch;
+      escaped = false;
+      continue;
+    }
+    if (ch === "\\") {
+      out += ch;
+      escaped = true;
+      continue;
+    }
+    if (ch === '"') {
+      inString = !inString;
+      out += ch;
+      continue;
+    }
+    if (inString && (ch === "\n" || ch === "\r" || ch === "	")) {
+      out += ch === "\n" ? "\\n" : ch === "\r" ? "\\r" : "\\t";
+      continue;
+    }
+    out += ch;
+  }
+  return out;
+}
+function completionJsonCandidates(text) {
+  const candidates = [];
+  const fenced = /```(?:json)?\s*([\s\S]*?)```/i.exec(text);
+  if (fenced?.[1])
+    candidates.push(fenced[1]);
+  const trimmed = text.trim();
+  if (trimmed.startsWith("{"))
+    candidates.push(trimmed);
+  const first = text.indexOf("{");
+  const last = text.lastIndexOf("}");
+  if (first !== -1 && last > first)
+    candidates.push(text.slice(first, last + 1));
+  return candidates;
+}
+function toDraft(parsed) {
+  const draft = {
+    title: parsed.title,
+    problemStatement: parsed.problemStatement,
+    proposedSolution: parsed.proposedSolution,
+    impactAssessment: parsed.impactAssessment,
+    description: parsed.description
+  };
+  for (const key of OPTIONAL_DRAFT_KEYS) {
+    const raw = parsed[key];
+    if (typeof raw === "string" && raw.trim().length > 0) {
+      draft[key] = raw;
+    }
+  }
+  return draft;
+}
+function extractCompletionJson(text) {
+  for (const candidate of completionJsonCandidates(text)) {
+    for (const variant of [
+      candidate,
+      stripTrailingCommas(candidate),
+      escapeRawControlCharsInStrings(candidate),
+      escapeRawControlCharsInStrings(stripTrailingCommas(candidate))
+    ]) {
+      try {
+        const parsed = JSON.parse(variant);
+        if (isEpicRequestDraft(parsed))
+          return toDraft(parsed);
+      } catch {
+      }
+    }
+  }
+  return null;
+}
+function looksLikeCompletionAttempt(text) {
+  const hasObject = /```(?:json)?\s*\{/i.test(text) || text.trim().startsWith("{");
+  if (!hasObject)
+    return false;
+  return /"(?:done|title|problemStatement|proposedSolution|impactAssessment|description)"\s*:/i.test(text);
+}
+var TARGET_COMPLIANCE_TIER, OPTIONAL_DRAFT_KEYS, COMPLETION_REPAIR_INSTRUCTION;
+var init_interview_completion = __esm({
+  "../shared/dist/interview-completion.js"() {
+    "use strict";
+    TARGET_COMPLIANCE_TIER = "pass";
+    OPTIONAL_DRAFT_KEYS = [
+      "successMetrics",
+      "targetAudience",
+      "alternatives",
+      "dependencies",
+      "estimatedEffort"
+    ];
+    COMPLETION_REPAIR_INSTRUCTION = 'Your last message looked like a completion but I could NOT parse it as a valid JSON object with all required fields. Re-emit ONLY a single valid JSON object inside a ```json code fence \u2014 no other text \u2014 with every string value properly escaped (escape any internal double-quotes as \\" and any line breaks as \\n), and make sure title, problemStatement, proposedSolution, impactAssessment, and description are all present and non-empty:\n```json\n{"done": true, "title": "...", "problemStatement": "...", "proposedSolution": "...", "impactAssessment": "...", "description": "..."}\n```';
+  }
+});
+
 // ../shared/dist/index.js
 var dist_exports = {};
 __export(dist_exports, {
+  AI_PROVIDERS: () => AI_PROVIDERS,
   APPEND_DESCRIPTION_MAX: () => APPEND_DESCRIPTION_MAX,
+  COMPLETION_REPAIR_INSTRUCTION: () => COMPLETION_REPAIR_INSTRUCTION,
   DESCRIPTION_MAX: () => DESCRIPTION_MAX,
   INTERVIEW_DEFINITION: () => INTERVIEW_DEFINITION,
   INTERVIEW_FIELD_MIN_WORDS: () => INTERVIEW_FIELD_MIN_WORDS,
@@ -649,10 +850,15 @@ __export(dist_exports, {
   SUBSCRIPTION_STATUSES: () => SUBSCRIPTION_STATUSES,
   SUMMARY_MAX: () => SUMMARY_MAX,
   SessionEventType: () => SessionEventType,
+  TARGET_COMPLIANCE_TIER: () => TARGET_COMPLIANCE_TIER,
   TURN_ROLES: () => TURN_ROLES,
   agentSchema: () => agentSchema,
+  aiProviderValues: () => aiProviderValues,
+  aiRouteValues: () => aiRouteValues,
+  buildAuditFeedback: () => buildAuditFeedback,
   buildInterviewSystemPrompt: () => buildInterviewSystemPrompt,
   err: () => err,
+  extractCompletionJson: () => extractCompletionJson,
   getAnthropicProxyUrl: () => getAnthropicProxyUrl,
   getModelById: () => getModelById,
   getModelDisplayName: () => getModelDisplayName,
@@ -675,8 +881,10 @@ __export(dist_exports, {
   isSubscriptionStatus: () => isSubscriptionStatus,
   isTurnRole: () => isTurnRole,
   isValidModelId: () => isValidModelId,
+  looksLikeCompletionAttempt: () => looksLikeCompletionAttempt,
   mcpConfigSchema: () => mcpConfigSchema,
   mcpServerConfigSchema: () => mcpServerConfigSchema,
+  meetsComplianceTarget: () => meetsComplianceTarget,
   modelRecommendationSourceValues: () => modelRecommendationSourceValues,
   normalizeGitRemote: () => normalizeGitRemote,
   ok: () => ok,
@@ -696,9 +904,11 @@ var init_dist = __esm({
     init_types();
     init_utils();
     init_skill_packs();
+    init_ai_providers();
     init_model_catalog();
     init_pxpipe();
     init_interview_definition();
+    init_interview_completion();
   }
 });
 
@@ -1182,6 +1392,16 @@ var ApiClient = class {
       input
     );
   }
+  /**
+   * Resolve (clear) a blocker on a feature - inverse of reportFeatureBlocker
+   */
+  async resolveFeatureBlocker(featureId, input) {
+    return this.request(
+      "POST",
+      `/api/v1/features/${encodeURIComponent(featureId)}/progress/unblock`,
+      input
+    );
+  }
   /**
    * Start work on a task - sets status to "In Progress" and records start time
    */
@@ -1222,6 +1442,16 @@ var ApiClient = class {
       input
     );
   }
+  /**
+   * Resolve (clear) a blocker on a task - inverse of reportTaskBlocker
+   */
+  async resolveTaskBlocker(taskId, input) {
+    return this.request(
+      "POST",
+      `/api/v1/tasks/${encodeURIComponent(taskId)}/progress/unblock`,
+      input
+    );
+  }
   // ---------------------------------------------------------------------------
   // Structured Description Methods
   // ---------------------------------------------------------------------------
@@ -6588,7 +6818,7 @@ function registerProgressTools(server2) {
   server2.registerTool(
     "compbox__manage_progress",
     {
-      description: "Manage progress tracking for features and tasks using a unified interface. This composite tool consolidates 4 progress operations into a single tool with action-based routing.\n\nActions:\n- 'start_work': Begin working on an item (sets status to In Progress)\n- 'complete_work': Mark an item as complete (sets status to Done)\n- 'log_progress': Record progress without changing status\n- 'report_blocker': Report that an item is blocked\n\nUse this instead of the individual progress tools for a more streamlined workflow.",
+      description: "Manage progress tracking for features and tasks using a unified interface. This composite tool consolidates 5 progress operations into a single tool with action-based routing.\n\nActions:\n- 'start_work': Begin working on an item (sets status to In Progress)\n- 'complete_work': Mark an item as complete (sets status to Done)\n- 'log_progress': Record progress without changing status\n- 'report_blocker': Report that an item is blocked\n- 'resolve_blocker': Clear a blocker and resume the item (inverse of 'report_blocker')\n\nUse this instead of the individual progress tools for a more streamlined workflow.",
       inputSchema: z13.discriminatedUnion("action", [
         z13.object({
           action: z13.literal("start_work"),
@@ -6618,6 +6848,14 @@ function registerProgressTools(server2) {
           reason: z13.string().min(1).max(5e3).describe("Description of what is blocking progress"),
           blockedById: z13.string().uuid().optional().describe("Optional UUID of the blocking item"),
           sessionId: z13.string().max(255).optional().describe("Optional AI session identifier")
+        }),
+        z13.object({
+          action: z13.literal("resolve_blocker"),
+          id: z13.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
+          type: z13.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
+          resolution: z13.string().min(1).max(5e3).describe("Description of how the blocker was resolved"),
+          unblockedFromId: z13.string().uuid().optional().describe("Optional UUID of the blocking item to drop from this item's dependencies"),
+          sessionId: z13.string().max(255).optional().describe("Optional AI session identifier")
         })
       ])
     },
@@ -6695,6 +6933,25 @@ function registerProgressTools(server2) {
               return createResponse(result);
             }
           }
+          case "resolve_blocker": {
+            if (input.type === "feature") {
+              const { data: feature } = await apiClient.getFeature(input.id);
+              const { data: result } = await apiClient.resolveFeatureBlocker(feature.id, {
+                resolution: input.resolution,
+                unblockedFromId: input.unblockedFromId,
+                sessionId: input.sessionId
+              });
+              return createResponse(result);
+            } else {
+              const { data: task } = await apiClient.getTask(input.id);
+              const { data: result } = await apiClient.resolveTaskBlocker(task.id, {
+                resolution: input.resolution,
+                unblockedFromId: input.unblockedFromId,
+                sessionId: input.sessionId
+              });
+              return createResponse(result);
+            }
+          }
         }
       } catch (error) {
         if (error instanceof ApiError && error.status === 404) {
@@ -10832,7 +11089,7 @@ function withLegacyToolCallRewrite(transport) {
 var SERVER_NAME = "compbox-mcp";
 function resolveServerVersion() {
   if (true) {
-    return "1.17.2";
+    return "1.19.0";
   }
   const require2 = createRequire(import.meta.url);
   for (const candidate of ["../package.json", "./package.json"]) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mycompbox/compbox-mcp",
-  "version": "1.17.2",
+  "version": "1.19.0",
   "description": "CompBox MCP server - Uses HTTP API client (no direct database access)",
   "license": "MIT",
   "type": "module",