@mycompbox/compbox-mcp 1.21.12 → 1.21.15

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/index.js +853 -661
  2. package/package.json +1 -1
package/index.js CHANGED
@@ -137,7 +137,7 @@ var init_mailbox = __esm({
137
137
  ];
138
138
  TERMINAL_JOB_STATUSES = ["done", "failed", "cancelled"];
139
139
  TURN_ROLES = ["agent", "user"];
140
- START_EXECUTION_KINDS = ["plan", "orchestrate", "refine"];
140
+ START_EXECUTION_KINDS = ["plan", "orchestrate", "refine", "follow_up"];
141
141
  MIN_CLI_FOR_REPLY_RESUME = "1.21.10";
142
142
  }
143
143
  });
@@ -457,7 +457,10 @@ function getModelDisplayName(id) {
457
457
  function isValidModelId(id) {
458
458
  return MODEL_CATALOG.some((m) => m.id === id);
459
459
  }
460
- var thinkingLevelValues, modelRecommendationSourceValues, MODEL_CATALOG;
460
+ function isConversationChatModel(value) {
461
+ return typeof value === "string" && CONVERSATION_CHAT_MODEL_IDS.includes(value);
462
+ }
463
+ var thinkingLevelValues, modelRecommendationSourceValues, MODEL_CATALOG, CONVERSATION_CHAT_MODELS, CONVERSATION_CHAT_MODEL_IDS, DEFAULT_CONVERSATION_CHAT_MODEL;
461
464
  var init_model_catalog = __esm({
462
465
  "../shared/dist/model-catalog.js"() {
463
466
  "use strict";
@@ -492,6 +495,14 @@ var init_model_catalog = __esm({
492
495
  costMultiplier: 7.5
493
496
  }
494
497
  ];
498
+ CONVERSATION_CHAT_MODELS = [
499
+ { id: "claude-haiku-5-5", label: "Haiku 5.5" },
500
+ { id: "claude-sonnet-5-5", label: "Sonnet 5.5" },
501
+ { id: "claude-opus-5-5", label: "Opus 5.5" },
502
+ { id: "claude-fable-5-1", label: "Fable 5.1" }
503
+ ];
504
+ CONVERSATION_CHAT_MODEL_IDS = CONVERSATION_CHAT_MODELS.map((m) => m.id);
505
+ DEFAULT_CONVERSATION_CHAT_MODEL = "claude-haiku-5-5";
495
506
  }
496
507
  });
497
508
 
@@ -904,6 +915,11 @@ var init_interview_completion = __esm({
904
915
  });
905
916
 
906
917
  // ../shared/dist/interview-conversation.js
918
+ function contentText(content) {
919
+ if (typeof content === "string")
920
+ return content;
921
+ return content.flatMap((b) => b.type === "text" && typeof b.text === "string" ? [b.text] : []).join("\n\n");
922
+ }
907
923
  function requestLockReason(saved) {
908
924
  if (!saved)
909
925
  return null;
@@ -953,6 +969,10 @@ What a good request covers:
953
969
  ${definition.map(renderSection).join("\n")}
954
970
  Optional topics may be skipped when the person has nothing to add. Never invent or pad facts.
955
971
 
972
+ What you can and can't do:
973
+ - The ONLY thing you can change is the request's own text (title and topics), by replying with the completion JSON below. You can't move it to another project, approve or reject it, make a blueprint, start a build, or change tasks, parts or anything else in CompBox.
974
+ - Never say or imply you did any of those things (no "Done", "Moved", "Approved"). If they ask, say plainly that you can't do that from here and tell them where they can: the idea's page for approving and making the blueprint, "Move to project" on the classic page for a personal idea, or an admin.
975
+
956
976
  Before saving for the first time: when the needed topics are covered, show a short preview in plain text (the title, then one or two lines per topic) and ask whether to save it or change anything. Only after they agree, or ask you to save, reply with ONLY a fenced JSON block, no other text:
957
977
  \`\`\`json
958
978
  {"done": true, ${shape}}
@@ -976,7 +996,7 @@ function toConversationMessages(turns) {
976
996
  return messages;
977
997
  }
978
998
  function renderConversationPrompt(messages) {
979
- const lines = messages.map((m) => `${m.role === "assistant" ? "You" : "Them"}: ${m.content}`);
999
+ const lines = messages.map((m) => `${m.role === "assistant" ? "You" : "Them"}: ${contentText(m.content)}`);
980
1000
  return `The conversation so far:
981
1001
 
982
1002
  ${lines.join("\n\n")}
@@ -1011,10 +1031,11 @@ async function runConversationStep(input, deps) {
1011
1031
  let createdHere = false;
1012
1032
  let qualityRounds = 0;
1013
1033
  let repairs = 0;
1034
+ let kind = "chat";
1014
1035
  for (; ; ) {
1015
1036
  let reply;
1016
1037
  try {
1017
- reply = await deps.reply(system, messages);
1038
+ reply = await deps.reply(system, messages, kind);
1018
1039
  } catch (error) {
1019
1040
  if (savedNow)
1020
1041
  return { kind: "saved", text: savedMessage(savedNow.saved, savedNow.created), ...savedNow };
@@ -1027,12 +1048,22 @@ Send another message (for example "try again") when you're ready and I'll pick u
1027
1048
  };
1028
1049
  }
1029
1050
  const draft = extractCompletionJson(reply);
1051
+ if (!draft && !looksLikeCompletionAttempt(reply)) {
1052
+ const text = reply.trim();
1053
+ if (savedNow) {
1054
+ return { kind: "saved", text: savedMessage(savedNow.saved, savedNow.created, text || void 0), ...savedNow };
1055
+ }
1056
+ if (!text)
1057
+ return { kind: "error", text: "I didn't get a reply that time. Send another message and I'll try again." };
1058
+ return { kind: "message", text };
1059
+ }
1030
1060
  if (draft) {
1031
1061
  if (lockReason) {
1032
1062
  const why = lockReason === "ownership" ? "Only the request's creator can change it, and I'm not its creator." : "That request is locked and can't be changed.";
1033
1063
  messages.push({ role: "assistant", content: reply }, { role: "user", content: `${why} Reply to me in plain text instead.` });
1034
1064
  if (++repairs > JSON_REPAIRS)
1035
1065
  return { kind: "error", text: lockedRequestMessage(lockReason) };
1066
+ kind = "repair";
1036
1067
  continue;
1037
1068
  }
1038
1069
  let saved;
@@ -1057,22 +1088,14 @@ Reply "try again" and I'll retry.` };
1057
1088
 
1058
1089
  The request IS already saved, and the person will be shown its score. If you ask them something, ask it as a way to improve the saved request; never say it hasn't been saved.`
1059
1090
  });
1091
+ kind = "save";
1060
1092
  continue;
1061
1093
  }
1062
- if (looksLikeCompletionAttempt(reply)) {
1063
- if (++repairs > JSON_REPAIRS) {
1064
- return savedNow ? { kind: "saved", text: savedMessage(savedNow.saved, savedNow.created), ...savedNow } : { kind: "error", text: `I had trouble writing up the request. Reply "try again" and I'll have another go.` };
1065
- }
1066
- messages.push({ role: "assistant", content: reply }, { role: "user", content: COMPLETION_REPAIR_INSTRUCTION });
1067
- continue;
1068
- }
1069
- const text = reply.trim();
1070
- if (savedNow) {
1071
- return { kind: "saved", text: savedMessage(savedNow.saved, savedNow.created, text || void 0), ...savedNow };
1094
+ if (++repairs > JSON_REPAIRS) {
1095
+ return savedNow ? { kind: "saved", text: savedMessage(savedNow.saved, savedNow.created), ...savedNow } : { kind: "error", text: `I had trouble writing up the request. Reply "try again" and I'll have another go.` };
1072
1096
  }
1073
- if (!text)
1074
- return { kind: "error", text: "I didn't get a reply that time. Send another message and I'll try again." };
1075
- return { kind: "message", text };
1097
+ messages.push({ role: "assistant", content: reply }, { role: "user", content: COMPLETION_REPAIR_INSTRUCTION });
1098
+ kind = "repair";
1076
1099
  }
1077
1100
  }
1078
1101
  function savedContextFromRecord(record, access) {
@@ -2835,6 +2858,156 @@ var init_needs_input = __esm({
2835
2858
  }
2836
2859
  });
2837
2860
 
2861
+ // ../shared/dist/idea-stage.js
2862
+ function isActive(job) {
2863
+ return !!job && !ENDED.has(job.status);
2864
+ }
2865
+ function isAsking(job) {
2866
+ return isActive(job) && job.status === "waiting" && job.waitingReason === "needs_input";
2867
+ }
2868
+ function epicIdFromPlanning(planningState) {
2869
+ if (!planningState)
2870
+ return null;
2871
+ if (typeof planningState !== "string")
2872
+ return planningState.epicId ?? null;
2873
+ try {
2874
+ const parsed = JSON.parse(planningState);
2875
+ return typeof parsed?.epicId === "string" ? parsed.epicId : null;
2876
+ } catch {
2877
+ return null;
2878
+ }
2879
+ }
2880
+ function stageOf(facts) {
2881
+ const { request, epic, planJob, buildJob } = facts;
2882
+ if (request.status === "rejected")
2883
+ return { stage: "idea", closed: true, needsYou: null };
2884
+ const display = epic?.displayState ?? null;
2885
+ const openPrs = facts.openPullRequests ?? 0;
2886
+ const hasEpic = !!(request.convertedEpicId ?? epicIdFromPlanning(request.planningState)) || !!epic;
2887
+ const stillWorking = isActive(buildJob) || openPrs > 0 || display !== null && BUILD_DISPLAY.has(display);
2888
+ const partsLeft = typeof epic?.featureCount === "number" ? Math.max(0, epic.featureCount - (epic.completedFeatureCount ?? 0)) : 0;
2889
+ const merged = display === "merged" || epic?.buildPullRequestState === "merged";
2890
+ const finished = epic?.state === "implemented" || merged && partsLeft === 0;
2891
+ const done = finished && !stillWorking;
2892
+ const building = stillWorking || merged || (epic?.completedFeatureCount ?? 0) > 0;
2893
+ let stage;
2894
+ if (done)
2895
+ stage = "done";
2896
+ else if (building)
2897
+ stage = "build";
2898
+ else if (request.status !== "pending" || hasEpic || isActive(planJob))
2899
+ stage = "blueprint";
2900
+ else
2901
+ stage = "idea";
2902
+ return { stage, closed: false, needsYou: done ? null : needsYouOf(facts, hasEpic, openPrs, display) };
2903
+ }
2904
+ function needsYouOf(facts, hasEpic, openPrs, display) {
2905
+ const { request, planJob, buildJob } = facts;
2906
+ if (facts.interviewJobStatus === "awaiting_input")
2907
+ return "answer_idea_helper";
2908
+ if (isAsking(buildJob))
2909
+ return MERGE_KINDS.has(buildJob?.needsInput?.kind ?? "") ? "merge_prs" : "answer_builder";
2910
+ if (isAsking(planJob))
2911
+ return "answer_blueprint_maker";
2912
+ const buildWorking = isActive(buildJob) && buildJob.status !== "waiting";
2913
+ if (openPrs > 0 && !buildWorking)
2914
+ return "merge_prs";
2915
+ if (display === "needs_decision" || display === "failed")
2916
+ return "decide_build";
2917
+ if (display === "ready")
2918
+ return "review_build";
2919
+ if (request.status === "approved" && !hasEpic && !isActive(planJob))
2920
+ return "make_blueprint";
2921
+ return null;
2922
+ }
2923
+ var ENDED, BUILD_DISPLAY, MERGE_KINDS;
2924
+ var init_idea_stage = __esm({
2925
+ "../shared/dist/idea-stage.js"() {
2926
+ "use strict";
2927
+ ENDED = /* @__PURE__ */ new Set(["done", "failed", "cancelled"]);
2928
+ BUILD_DISPLAY = /* @__PURE__ */ new Set(["running", "ready", "needs_decision", "failed", "follow_up"]);
2929
+ MERGE_KINDS = /* @__PURE__ */ new Set(["merge_approval", "merge_prs"]);
2930
+ }
2931
+ });
2932
+
2933
+ // ../shared/dist/run-progress.js
2934
+ import { z as z2 } from "zod";
2935
+ var isoTimestamp, runKindSchema, runStageStatusSchema, runStateSchema, runProgressStageSchema, runEtaSchema, runProgressBaseSchema, runProgressSchema;
2936
+ var init_run_progress = __esm({
2937
+ "../shared/dist/run-progress.js"() {
2938
+ "use strict";
2939
+ isoTimestamp = z2.string().datetime({ offset: true });
2940
+ runKindSchema = z2.enum(["planning", "build"]);
2941
+ runStageStatusSchema = z2.enum(["pending", "active", "completed", "failed", "skipped"]);
2942
+ runStateSchema = z2.enum([
2943
+ "pending",
2944
+ "active",
2945
+ "completed",
2946
+ "failed",
2947
+ "cancelled",
2948
+ "stalled"
2949
+ ]);
2950
+ runProgressStageSchema = z2.object({
2951
+ /** Stable machine key for the stage, unique within the run. */
2952
+ key: z2.string().min(1),
2953
+ /** Human-readable label shown in the UI. */
2954
+ label: z2.string().min(1),
2955
+ /** Current status of the stage. */
2956
+ status: runStageStatusSchema,
2957
+ /** Optional short detail line (for example "3 of 7 tasks"). */
2958
+ detail: z2.string().nullable(),
2959
+ /** When the stage started, or null if it has not started yet. */
2960
+ startedAt: isoTimestamp.nullable(),
2961
+ /** When the stage finished, or null if it has not finished yet. */
2962
+ completedAt: isoTimestamp.nullable()
2963
+ });
2964
+ runEtaSchema = z2.object({
2965
+ /** Estimated seconds left, or null when no estimate can be made. */
2966
+ secondsRemaining: z2.number().int().nonnegative().nullable(),
2967
+ /** How much to trust the estimate, based mostly on sample size. */
2968
+ confidence: z2.enum(["low", "medium", "high"]),
2969
+ /** Number of past runs the estimate is based on. */
2970
+ sampleSize: z2.number().int().nonnegative(),
2971
+ /** True when the run has already taken longer than the estimate. */
2972
+ overrun: z2.boolean()
2973
+ });
2974
+ runProgressBaseSchema = z2.object({
2975
+ // --- Identity ---
2976
+ /** Which kind of run this is. */
2977
+ runKind: runKindSchema,
2978
+ // --- Stages ---
2979
+ /** Ordered list of the run's stages. */
2980
+ stages: z2.array(runProgressStageSchema),
2981
+ /** Key of the stage currently running, or null if none is running. */
2982
+ currentStageKey: z2.string().min(1).nullable(),
2983
+ // --- Counts ---
2984
+ /** Units of work finished (stages for planning, tasks for build). */
2985
+ completed: z2.number().int().nonnegative(),
2986
+ /** Total units of work in the run. */
2987
+ total: z2.number().int().nonnegative(),
2988
+ // --- State ---
2989
+ /** Overall state of the run. */
2990
+ state: runStateSchema,
2991
+ /** Why the run failed or stalled, or null otherwise. */
2992
+ failureReason: z2.string().nullable(),
2993
+ // --- Timing ---
2994
+ /** When the run started. */
2995
+ startedAt: isoTimestamp,
2996
+ /** When progress was last reported. */
2997
+ updatedAt: isoTimestamp,
2998
+ /** Estimated time remaining, or null when there is no estimate. */
2999
+ eta: runEtaSchema.nullable()
3000
+ });
3001
+ runProgressSchema = runProgressBaseSchema.refine((p) => p.completed <= p.total, {
3002
+ message: "completed must not be greater than total",
3003
+ path: ["completed"]
3004
+ }).refine((p) => p.currentStageKey === null || p.stages.some((s) => s.key === p.currentStageKey), {
3005
+ message: "currentStageKey must match one of the stage keys",
3006
+ path: ["currentStageKey"]
3007
+ });
3008
+ }
3009
+ });
3010
+
2838
3011
  // ../shared/dist/index.js
2839
3012
  var dist_exports = {};
2840
3013
  __export(dist_exports, {
@@ -2845,8 +3018,11 @@ __export(dist_exports, {
2845
3018
  CLOUD_SQL_MONTHLY_ESTIMATE_USD: () => CLOUD_SQL_MONTHLY_ESTIMATE_USD,
2846
3019
  CLOUD_SQL_PROXY_VERSION: () => CLOUD_SQL_PROXY_VERSION,
2847
3020
  COMPLETION_REPAIR_INSTRUCTION: () => COMPLETION_REPAIR_INSTRUCTION,
3021
+ CONVERSATION_CHAT_MODELS: () => CONVERSATION_CHAT_MODELS,
3022
+ CONVERSATION_CHAT_MODEL_IDS: () => CONVERSATION_CHAT_MODEL_IDS,
2848
3023
  CONVERSATION_QUALITY_ROUNDS: () => CONVERSATION_QUALITY_ROUNDS,
2849
3024
  DATABASE_CHOICE_VALUES: () => DATABASE_CHOICE_VALUES,
3025
+ DEFAULT_CONVERSATION_CHAT_MODEL: () => DEFAULT_CONVERSATION_CHAT_MODEL,
2850
3026
  DESCRIPTION_MAX: () => DESCRIPTION_MAX,
2851
3027
  EMPTY_ARM_TEMPLATE: () => EMPTY_ARM_TEMPLATE,
2852
3028
  GCP_CONNECT_STEPS: () => GCP_CONNECT_STEPS,
@@ -2904,6 +3080,7 @@ __export(dist_exports, {
2904
3080
  cloudSqlInstanceName: () => cloudSqlInstanceName,
2905
3081
  compareMachineVersions: () => compareMachineVersions,
2906
3082
  complianceFromRecord: () => complianceFromRecord,
3083
+ contentText: () => contentText,
2907
3084
  databaseSecretName: () => databaseSecretName,
2908
3085
  deployRunTitle: () => deployRunTitle,
2909
3086
  err: () => err,
@@ -2930,6 +3107,7 @@ __export(dist_exports, {
2930
3107
  isAzureLocation: () => isAzureLocation,
2931
3108
  isAzureResourceGroup: () => isAzureResourceGroup,
2932
3109
  isAzureStorageAccount: () => isAzureStorageAccount,
3110
+ isConversationChatModel: () => isConversationChatModel,
2933
3111
  isGcpProjectId: () => isGcpProjectId,
2934
3112
  isGcpProjectNumber: () => isGcpProjectNumber,
2935
3113
  isGcpRegion: () => isGcpRegion,
@@ -2972,6 +3150,13 @@ __export(dist_exports, {
2972
3150
  requestLockReason: () => requestLockReason,
2973
3151
  resolveRouting: () => resolveRouting,
2974
3152
  runConversationStep: () => runConversationStep,
3153
+ runEtaSchema: () => runEtaSchema,
3154
+ runKindSchema: () => runKindSchema,
3155
+ runProgressBaseSchema: () => runProgressBaseSchema,
3156
+ runProgressSchema: () => runProgressSchema,
3157
+ runProgressStageSchema: () => runProgressStageSchema,
3158
+ runStageStatusSchema: () => runStageStatusSchema,
3159
+ runStateSchema: () => runStateSchema,
2975
3160
  safeReturnTo: () => safeReturnTo,
2976
3161
  safeValidateSkillPackManifest: () => safeValidateSkillPackManifest,
2977
3162
  savedContextFromRecord: () => savedContextFromRecord,
@@ -2983,6 +3168,7 @@ __export(dist_exports, {
2983
3168
  stackAppName: () => stackAppName,
2984
3169
  stackEnvSettings: () => stackEnvSettings,
2985
3170
  stackEnvironments: () => stackEnvironments,
3171
+ stageOf: () => stageOf,
2986
3172
  stripRunnerOnlyFields: () => stripRunnerOnlyFields,
2987
3173
  teardownConfirmation: () => teardownConfirmation,
2988
3174
  teardownRunTitle: () => teardownRunTitle,
@@ -3011,6 +3197,8 @@ var init_dist = __esm({
3011
3197
  init_return_to();
3012
3198
  init_machineVersion();
3013
3199
  init_needs_input();
3200
+ init_idea_stage();
3201
+ init_run_progress();
3014
3202
  }
3015
3203
  });
3016
3204
 
@@ -3021,7 +3209,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
3021
3209
 
3022
3210
  // src/tools/epics.ts
3023
3211
  init_dist();
3024
- import { z as z2 } from "zod";
3212
+ import { z as z3 } from "zod";
3025
3213
 
3026
3214
  // src/api-client.ts
3027
3215
  var ApiError = class extends Error {
@@ -4996,22 +5184,22 @@ function registerEpicTools(server2) {
4996
5184
  {
4997
5185
  description: "List epics in the user's CompBox workspace. Returns paginated results with epic metadata including team information and feature counts. Supports filtering by team, scope, and cursor-based pagination. Epics are ordered by sort order then creation date (newest first). Use scope='personal' to list only personal epics, scope='team' for team epics only, or scope='all' (default) for all accessible epics.",
4998
5186
  inputSchema: {
4999
- scope: z2.enum(["personal", "team", "all"]).optional().describe(
5187
+ scope: z3.enum(["personal", "team", "all"]).optional().describe(
5000
5188
  "Filter by scope. 'personal' returns only epics in the user's personal scope, 'team' returns only team-scoped epics, 'all' (default) returns both. When 'personal' is specified, the 'team' filter is ignored."
5001
5189
  ),
5002
- team: z2.string().optional().describe(
5190
+ team: z3.string().optional().describe(
5003
5191
  "Filter by team. Accepts team ID (UUID), name, or key (e.g., 'Engineering', 'ENG', or '550e8400-e29b-41d4-a716-446655440000'). Only applies when scope is 'team' or 'all'."
5004
5192
  ),
5005
- includeArchived: z2.boolean().optional().describe(
5193
+ includeArchived: z3.boolean().optional().describe(
5006
5194
  "Include archived epics in results. When false (default), only active epics are returned. Set to true to see all epics including archived ones."
5007
5195
  ),
5008
- state: z2.enum(["active", "implemented", "archived"]).optional().describe(
5196
+ state: z3.enum(["active", "implemented", "archived"]).optional().describe(
5009
5197
  "Filter epics by state. 'active' returns epics still in progress, 'implemented' returns fully completed epics, 'archived' returns archived epics. When not provided, returns all non-archived epics (unless includeArchived is true)."
5010
5198
  ),
5011
- limit: z2.number().int().min(1).max(100).optional().describe(
5199
+ limit: z3.number().int().min(1).max(100).optional().describe(
5012
5200
  "Maximum number of epics to return per page (default: 20, max: 100). Use with cursor for pagination through large result sets."
5013
5201
  ),
5014
- cursor: z2.string().optional().describe(
5202
+ cursor: z3.string().optional().describe(
5015
5203
  "Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
5016
5204
  )
5017
5205
  }
@@ -5156,7 +5344,7 @@ function registerEpicTools(server2) {
5156
5344
  {
5157
5345
  description: "Get detailed information about a specific epic by ID, identifier, or name. Returns the full epic object including scope information (team or personal), metadata, and a list of all features in the epic. Features are ordered by sort order then creation date (newest first). Only returns non-archived epics. Works for both team-scoped and personal-scoped epics.",
5158
5346
  inputSchema: {
5159
- query: z2.string().describe(
5347
+ query: z3.string().describe(
5160
5348
  "The epic identifier to look up. Accepts a UUID (e.g., '550e8400-e29b-41d4-a716-446655440000'), an identifier (e.g., 'ENG-E1'), or an exact epic name (e.g., 'Mobile App Redesign'). Name matching is case-sensitive."
5161
5349
  )
5162
5350
  }
@@ -5227,26 +5415,26 @@ function registerEpicTools(server2) {
5227
5415
 
5228
5416
  Create a new epic in CompBox. An epic is a container for features and must belong to a team. Returns the created epic with all metadata including the assigned team information and initial feature count (0). For creating personal epics, use compbox__create_personal_epic instead. Optionally pass epicRequestId to link this epic to an approved Epic Request.`,
5229
5417
  inputSchema: {
5230
- name: z2.string().min(1).describe(
5418
+ name: z3.string().min(1).describe(
5231
5419
  "The display name for the epic (required). Should be descriptive and unique within the team (e.g., 'Q1 2024 Features', 'Mobile App Redesign')."
5232
5420
  ),
5233
- team: z2.string().describe(
5421
+ team: z3.string().describe(
5234
5422
  "The team to associate this epic with (required). Accepts team ID (UUID), name, or key (e.g., 'Engineering', 'ENG', or '550e8400-e29b-41d4-a716-446655440000'). The team determines which statuses are available for features in this epic."
5235
5423
  ),
5236
- description: z2.string().max(DESCRIPTION_MAX).optional().describe(
5424
+ description: z3.string().max(DESCRIPTION_MAX).optional().describe(
5237
5425
  "A longer description of the epic's purpose and scope. Supports plain text (e.g., 'Features for the mobile app redesign initiative')."
5238
5426
  ),
5239
- icon: z2.string().optional().describe(
5427
+ icon: z3.string().optional().describe(
5240
5428
  "An icon identifier for visual display (e.g., 'rocket', 'star', 'folder'). Used in the UI to help identify the epic at a glance."
5241
5429
  ),
5242
- color: z2.string().optional().describe(
5430
+ color: z3.string().optional().describe(
5243
5431
  "A hex color code for the epic's visual theme (e.g., '#FF5733', '#3B82F6'). Used in the UI for epic badges and highlights."
5244
5432
  ),
5245
- epicRequestId: z2.string().uuid().optional().describe(
5433
+ epicRequestId: z3.string().uuid().optional().describe(
5246
5434
  "UUID of an Epic Request to link to this epic. When provided without deferConversion, the Epic Request will be marked as converted. With deferConversion: true, conversion is skipped (ER must be in 'planning' status)."
5247
5435
  ),
5248
- bypassGovernance: z2.boolean().optional(),
5249
- deferConversion: z2.boolean().optional().describe(
5436
+ bypassGovernance: z3.boolean().optional(),
5437
+ deferConversion: z3.boolean().optional().describe(
5250
5438
  "When true, governance accepts 'planning' status and skips auto-conversion of the Epic Request. Used by the planner pipeline which handles conversion in its final VERIFY stage."
5251
5439
  )
5252
5440
  }
@@ -5300,22 +5488,22 @@ Create a new epic in CompBox. An epic is a container for features and must belon
5300
5488
  {
5301
5489
  description: "Update an existing epic. Only the fields you provide will be updated; omitted fields retain their current values. Returns the updated epic with all current field values. Use this to change the name, description, icon, or color of an epic.\n\nState-based restrictions apply:\n- Active epics: all fields can be updated freely.\n- Implemented epics: only appendToDescription is allowed for the description (full description replacement is rejected). Name, icon, and color can still be changed.\n- Archived epics: cannot be updated. Requests to update archived epics will return 404.\n\nUse appendToDescription for atomic server-side concatenation (e.g., appending execution summaries). It cannot be provided together with description \u2014 the API rejects requests that set both fields.",
5302
5490
  inputSchema: {
5303
- id: z2.string().describe(
5491
+ id: z3.string().describe(
5304
5492
  "The epic to update (required). Accepts a UUID (e.g., '550e8400-e29b-41d4-a716-446655440000'), an identifier (e.g., 'ENG-E1'), or an exact epic name (e.g., 'Mobile App Redesign'). Name matching is case-sensitive."
5305
5493
  ),
5306
- name: z2.string().min(1).optional().describe(
5494
+ name: z3.string().min(1).optional().describe(
5307
5495
  "New name for the epic. Only provide if you want to change the name."
5308
5496
  ),
5309
- description: z2.string().max(DESCRIPTION_MAX).optional().describe(
5497
+ description: z3.string().max(DESCRIPTION_MAX).optional().describe(
5310
5498
  "New description for the epic in Markdown format. Replaces the entire existing description. Supports full Markdown syntax. Use appendToDescription if you want to append content instead of replacing it. Cannot be used together with appendToDescription. Not allowed on implemented epics \u2014 use appendToDescription instead."
5311
5499
  ),
5312
- appendToDescription: z2.string().max(APPEND_DESCRIPTION_MAX).optional().describe(
5500
+ appendToDescription: z3.string().max(APPEND_DESCRIPTION_MAX).optional().describe(
5313
5501
  "Markdown content to append to the existing description. Performs atomic server-side concatenation \u2014 the server inserts '\\n\\n---\\n\\n' between the existing description and the new content. Cannot be used together with description (mutually exclusive). This is the only way to modify the description of implemented epics."
5314
5502
  ),
5315
- icon: z2.string().optional().describe(
5503
+ icon: z3.string().optional().describe(
5316
5504
  "New icon identifier for visual display (e.g., 'rocket', 'star', 'folder')."
5317
5505
  ),
5318
- color: z2.string().optional().describe(
5506
+ color: z3.string().optional().describe(
5319
5507
  "New hex color code for the epic's visual theme (e.g., '#FF5733', '#3B82F6')."
5320
5508
  )
5321
5509
  }
@@ -5383,16 +5571,16 @@ Create a new epic in CompBox. An epic is a container for features and must belon
5383
5571
  {
5384
5572
  description: "Set the recommended AI model for an epic. Records which model and thinking level should be used when executing this epic, along with a rationale. The recommendation source is automatically set to 'planner' and the timestamp is recorded server-side.\n\nUse this after analyzing an epic's complexity to recommend the appropriate model tier, such as 'claude-sonnet-4.6', 'claude-opus-4.6', or 'gpt-5.5'.",
5385
5573
  inputSchema: {
5386
- epicId: z2.string().describe(
5574
+ epicId: z3.string().describe(
5387
5575
  "The epic to set recommendation for. Accepts UUID, identifier (e.g., 'ENG-E1'), or exact name."
5388
5576
  ),
5389
- model: z2.string().describe(
5577
+ model: z3.string().describe(
5390
5578
  "Model ID from the catalog (e.g., 'claude-sonnet-4.6', 'claude-opus-4.6', 'gpt-5.5')."
5391
5579
  ),
5392
- thinkingLevel: z2.enum(["none", "low", "medium", "high"]).describe(
5580
+ thinkingLevel: z3.enum(["none", "low", "medium", "high"]).describe(
5393
5581
  "Recommended thinking level for the model."
5394
5582
  ),
5395
- reason: z2.string().min(1).max(2e3).describe(
5583
+ reason: z3.string().min(1).max(2e3).describe(
5396
5584
  "1-2 sentence rationale for the model recommendation (e.g., 'Complex multi-file refactoring requiring deep reasoning')."
5397
5585
  )
5398
5586
  }
@@ -5442,16 +5630,16 @@ Create a new epic in CompBox. An epic is a container for features and must belon
5442
5630
  {
5443
5631
  description: "Record which AI model was actually used during epic execution. Call this after execution begins to track the actual model and thinking level used, such as 'claude-sonnet-4.6', 'claude-opus-4.6', or 'gpt-5.5'. The timestamp is recorded server-side.\n\nIf the model you used differs from the epic's recommendedModel, you MUST provide a `justification` (min 10 chars) explaining why. The API will reject the call without one. If no recommendation exists or models match, justification is not required.",
5444
5632
  inputSchema: {
5445
- epicId: z2.string().describe(
5633
+ epicId: z3.string().describe(
5446
5634
  "The epic to record model usage for. Accepts UUID, identifier (e.g., 'ENG-E1'), or exact name."
5447
5635
  ),
5448
- model: z2.string().describe(
5636
+ model: z3.string().describe(
5449
5637
  "Model ID that was actually used (e.g., 'claude-sonnet-4.6', 'claude-opus-4.6', 'gpt-5.5')."
5450
5638
  ),
5451
- thinkingLevel: z2.enum(["none", "low", "medium", "high"]).describe(
5639
+ thinkingLevel: z3.enum(["none", "low", "medium", "high"]).describe(
5452
5640
  "Thinking level that was actually used."
5453
5641
  ),
5454
- justification: z2.string().trim().min(10).max(5e3).optional().describe(
5642
+ justification: z3.string().trim().min(10).max(5e3).optional().describe(
5455
5643
  "Required when the model used differs from the recommended model. Explain why a different model was chosen (e.g., cost, availability, task complexity)."
5456
5644
  )
5457
5645
  }
@@ -5508,14 +5696,14 @@ Create a new epic in CompBox. An epic is a container for features and must belon
5508
5696
  }
5509
5697
 
5510
5698
  // src/tools/epic-requests.ts
5511
- import { z as z3 } from "zod";
5699
+ import { z as z4 } from "zod";
5512
5700
  function registerEpicRequestTools(server2) {
5513
5701
  server2.registerTool(
5514
5702
  "compbox__draft_epic_request",
5515
5703
  {
5516
5704
  description: "Get a template for creating an Epic Request. Returns either the default scaffold (with field descriptions) or a named built-in template such as 'bug-sourced' (pre-fills repro steps, severity, scope for bug-originated requests). Use 'list' to enumerate available templates.",
5517
5705
  inputSchema: {
5518
- template: z3.string().optional().describe(
5706
+ template: z4.string().optional().describe(
5519
5707
  "Optional template name. Pass 'bug-sourced' for the bug-report scaffold, 'default' for the empty scaffold (default behavior), or 'list' to enumerate all available templates without returning a specific scaffold."
5520
5708
  )
5521
5709
  }
@@ -5583,47 +5771,47 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
5583
5771
  // vice-versa.
5584
5772
  // -----------------------------------------------------------------------
5585
5773
  inputSchema: {
5586
- title: z3.string().min(1).max(500).describe("Title of the epic request (required, max 500 chars)"),
5587
- description: z3.string().max(1e6).optional().describe(
5774
+ title: z4.string().min(1).max(500).describe("Title of the epic request (required, max 500 chars)"),
5775
+ description: z4.string().max(1e6).optional().describe(
5588
5776
  "Plain markdown description of the epic request (optional)"
5589
5777
  ),
5590
- scope: z3.enum(["personal", "team"]).optional().describe(
5778
+ scope: z4.enum(["personal", "team"]).optional().describe(
5591
5779
  "Scope for the epic request. 'team' (default) creates a team-scoped request requiring approval. 'personal' creates in your personal scope (requires approval, visible only to you)."
5592
5780
  ),
5593
- teamId: z3.string().uuid().optional().describe(
5781
+ teamId: z4.string().uuid().optional().describe(
5594
5782
  "Team to associate this epic request with. When scope is 'team', this specifies which team the request belongs to. Use compbox__list_teams to find available teams."
5595
5783
  ),
5596
- structuredDesc: z3.object({
5597
- problemStatement: z3.string().min(1).max(1e6).describe(
5784
+ structuredDesc: z4.object({
5785
+ problemStatement: z4.string().min(1).max(1e6).describe(
5598
5786
  "Clear statement of the problem or opportunity this epic would address (required)"
5599
5787
  ),
5600
- proposedSolution: z3.string().min(1).max(1e6).describe(
5788
+ proposedSolution: z4.string().min(1).max(1e6).describe(
5601
5789
  "High-level description of how this epic would solve the problem (required)"
5602
5790
  ),
5603
- impactAssessment: z3.string().min(1).max(1e6).describe(
5791
+ impactAssessment: z4.string().min(1).max(1e6).describe(
5604
5792
  "Expected impact and benefits of implementing this epic (required)"
5605
5793
  ),
5606
- targetAudience: z3.string().max(1e6).optional().describe(
5794
+ targetAudience: z4.string().max(1e6).optional().describe(
5607
5795
  "Who will benefit from this epic - users, teams, etc. (optional)"
5608
5796
  ),
5609
- successMetrics: z3.string().max(1e6).optional().describe(
5797
+ successMetrics: z4.string().max(1e6).optional().describe(
5610
5798
  "How success will be measured if this epic is implemented (optional)"
5611
5799
  ),
5612
- alternatives: z3.string().max(1e6).optional().describe(
5800
+ alternatives: z4.string().max(1e6).optional().describe(
5613
5801
  "Alternative approaches considered (optional)"
5614
5802
  ),
5615
- dependencies: z3.string().max(1e6).optional().describe(
5803
+ dependencies: z4.string().max(1e6).optional().describe(
5616
5804
  "External dependencies or prerequisites (optional)"
5617
5805
  ),
5618
- estimatedEffort: z3.string().max(1e6).optional().describe(
5806
+ estimatedEffort: z4.string().max(1e6).optional().describe(
5619
5807
  "Rough effort estimate, e.g., '2-3 weeks', '1 quarter' (optional)"
5620
5808
  )
5621
5809
  }).optional().describe(
5622
5810
  "Structured description with detailed proposal information. If provided, problemStatement, proposedSolution, and impactAssessment are required."
5623
5811
  ),
5624
- originatingTicketUrl: z3.preprocess(
5812
+ originatingTicketUrl: z4.preprocess(
5625
5813
  (value) => typeof value === "string" ? value.trim() : value,
5626
- z3.string().url().max(2048)
5814
+ z4.string().url().max(2048)
5627
5815
  ).refine((value) => {
5628
5816
  try {
5629
5817
  const url = new URL(value);
@@ -5695,16 +5883,16 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
5695
5883
  {
5696
5884
  description: "List all epic requests with cursor-based pagination and optional filtering. Returns requests with aggregated reaction counts (like, fire, dislike) and the current user's reaction if any. Supports filtering by status (pending, approved, rejected, converted) and by the user who created the request. Results are ordered by creation date (newest first). Note: This lists team-scoped epic requests. For personal epic requests, use compbox__list_personal_epic_requests instead.",
5697
5885
  inputSchema: {
5698
- cursor: z3.string().optional().describe(
5886
+ cursor: z4.string().optional().describe(
5699
5887
  "Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
5700
5888
  ),
5701
- limit: z3.number().int().min(1).max(100).optional().describe(
5889
+ limit: z4.number().int().min(1).max(100).optional().describe(
5702
5890
  "Maximum number of epic requests to return per page (default: 20, max: 100). Use with cursor for pagination through large result sets."
5703
5891
  ),
5704
- status: z3.enum(["pending", "approved", "rejected", "converted"]).optional().describe(
5892
+ status: z4.enum(["pending", "approved", "rejected", "converted"]).optional().describe(
5705
5893
  "Filter by request status: 'pending' (awaiting review), 'approved' (approved by admin), 'rejected' (rejected by admin), or 'converted' (already converted to epic)"
5706
5894
  ),
5707
- requestedById: z3.string().optional().describe(
5895
+ requestedById: z4.string().optional().describe(
5708
5896
  "Filter by the user ID who created the request. Returns only requests created by this user."
5709
5897
  )
5710
5898
  }
@@ -5732,7 +5920,7 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
5732
5920
  {
5733
5921
  description: "Get a single epic request by ID with full details including reaction counts and the current user's reaction. Returns the complete epic request object with structured description if present, requester information, and aggregated reactions. Access control: team-scoped requests are visible to all authenticated users; personal-scoped requests are only visible to the owner. Use this to view the full details of a specific epic request.",
5734
5922
  inputSchema: {
5735
- id: z3.string().describe(
5923
+ id: z4.string().describe(
5736
5924
  "The epic request to retrieve. Accepts UUID or identifier (e.g., 'ER-1'). Get this from list_epic_requests."
5737
5925
  )
5738
5926
  }
@@ -5767,27 +5955,27 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
5767
5955
  // vice-versa.
5768
5956
  // -----------------------------------------------------------------------
5769
5957
  inputSchema: {
5770
- id: z3.string().describe("The epic request to update. Accepts UUID or identifier (e.g., 'ER-1')"),
5771
- title: z3.string().min(1).max(500).optional().describe("New title for the epic request (optional, max 500 chars)"),
5772
- description: z3.string().max(1e6).optional().describe(
5958
+ id: z4.string().describe("The epic request to update. Accepts UUID or identifier (e.g., 'ER-1')"),
5959
+ title: z4.string().min(1).max(500).optional().describe("New title for the epic request (optional, max 500 chars)"),
5960
+ description: z4.string().max(1e6).optional().describe(
5773
5961
  "New plain markdown description (optional). This replaces the entire description."
5774
5962
  ),
5775
- structuredDesc: z3.object({
5776
- problemStatement: z3.string().min(1).max(1e6).describe("Problem statement (required if structuredDesc provided)"),
5777
- proposedSolution: z3.string().min(1).max(1e6).describe("Proposed solution (required if structuredDesc provided)"),
5778
- impactAssessment: z3.string().min(1).max(1e6).describe("Impact assessment (required if structuredDesc provided)"),
5779
- targetAudience: z3.string().max(1e6).optional().describe("Target audience (optional)"),
5780
- successMetrics: z3.string().max(1e6).optional().describe("Success metrics (optional)"),
5781
- alternatives: z3.string().max(1e6).optional().describe("Alternative approaches (optional)"),
5782
- dependencies: z3.string().max(1e6).optional().describe("Dependencies (optional)"),
5783
- estimatedEffort: z3.string().max(1e6).optional().describe("Estimated effort (optional)")
5963
+ structuredDesc: z4.object({
5964
+ problemStatement: z4.string().min(1).max(1e6).describe("Problem statement (required if structuredDesc provided)"),
5965
+ proposedSolution: z4.string().min(1).max(1e6).describe("Proposed solution (required if structuredDesc provided)"),
5966
+ impactAssessment: z4.string().min(1).max(1e6).describe("Impact assessment (required if structuredDesc provided)"),
5967
+ targetAudience: z4.string().max(1e6).optional().describe("Target audience (optional)"),
5968
+ successMetrics: z4.string().max(1e6).optional().describe("Success metrics (optional)"),
5969
+ alternatives: z4.string().max(1e6).optional().describe("Alternative approaches (optional)"),
5970
+ dependencies: z4.string().max(1e6).optional().describe("Dependencies (optional)"),
5971
+ estimatedEffort: z4.string().max(1e6).optional().describe("Estimated effort (optional)")
5784
5972
  }).optional().describe(
5785
5973
  "New structured description (optional). This replaces the entire structuredDesc."
5786
5974
  ),
5787
- status: z3.enum(["pending", "approved", "rejected", "converted"]).optional().describe(
5975
+ status: z4.enum(["pending", "approved", "rejected", "converted"]).optional().describe(
5788
5976
  "New status (optional, admin only). Use approve/reject endpoints instead when possible."
5789
5977
  ),
5790
- convertedEpicId: z3.string().uuid().optional().describe(
5978
+ convertedEpicId: z4.string().uuid().optional().describe(
5791
5979
  "The ID of the epic created from this request. Set when transitioning to 'converted' status."
5792
5980
  )
5793
5981
  }
@@ -5849,7 +6037,7 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
5849
6037
  {
5850
6038
  description: "Delete an epic request. Only the creator or a global admin can delete a request. This permanently removes the epic request and all associated reactions and comments. Use with caution - this action cannot be undone.",
5851
6039
  inputSchema: {
5852
- id: z3.string().describe("The epic request to delete. Accepts UUID or identifier (e.g., 'ER-1')")
6040
+ id: z4.string().describe("The epic request to delete. Accepts UUID or identifier (e.g., 'ER-1')")
5853
6041
  }
5854
6042
  },
5855
6043
  async (input) => {
@@ -5882,8 +6070,8 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
5882
6070
  {
5883
6071
  description: "Add or update a reaction on an epic request. Valid reaction types are 'like', 'fire', and 'dislike'. If you've already reacted to this request, this will replace your existing reaction with the new one. Each user can have only one reaction per request. Use this to show support or feedback on epic proposals.",
5884
6072
  inputSchema: {
5885
- id: z3.string().describe("The epic request to react to. Accepts UUID or identifier (e.g., 'ER-1')"),
5886
- reactionType: z3.enum(["like", "fire", "dislike"]).describe(
6073
+ id: z4.string().describe("The epic request to react to. Accepts UUID or identifier (e.g., 'ER-1')"),
6074
+ reactionType: z4.enum(["like", "fire", "dislike"]).describe(
5887
6075
  "Type of reaction: 'like' (positive), 'fire' (excited/strong support), or 'dislike' (negative)"
5888
6076
  )
5889
6077
  }
@@ -5913,8 +6101,8 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
5913
6101
  {
5914
6102
  description: "Create a new comment on an epic request. Comments are used for discussion, feedback, and questions about the proposal. The current user is automatically set as the comment author. Comments support plain text up to 5000 characters. Returns the created comment with author information.",
5915
6103
  inputSchema: {
5916
- id: z3.string().describe("The epic request to comment on. Accepts UUID or identifier (e.g., 'ER-1')"),
5917
- content: z3.string().min(1).max(5e3).describe(
6104
+ id: z4.string().describe("The epic request to comment on. Accepts UUID or identifier (e.g., 'ER-1')"),
6105
+ content: z4.string().min(1).max(5e3).describe(
5918
6106
  "Content of the comment (required, 1-5000 chars). Plain text only."
5919
6107
  )
5920
6108
  }
@@ -5944,11 +6132,11 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
5944
6132
  {
5945
6133
  description: "List all comments for an epic request with cursor-based pagination. Returns comments with author information (name and email). Comments are ordered by creation date (oldest first) to show the discussion flow. Use this to view feedback and discussion on an epic request.",
5946
6134
  inputSchema: {
5947
- id: z3.string().describe("The epic request to list comments for. Accepts UUID or identifier (e.g., 'ER-1')"),
5948
- cursor: z3.string().optional().describe(
6135
+ id: z4.string().describe("The epic request to list comments for. Accepts UUID or identifier (e.g., 'ER-1')"),
6136
+ cursor: z4.string().optional().describe(
5949
6137
  "Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
5950
6138
  ),
5951
- limit: z3.number().int().min(1).max(100).optional().describe(
6139
+ limit: z4.number().int().min(1).max(100).optional().describe(
5952
6140
  "Maximum number of comments to return per page (default: 20, max: 100)"
5953
6141
  )
5954
6142
  }
@@ -5979,11 +6167,11 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
5979
6167
  {
5980
6168
  description: "Transfer an epic request between personal and team scope. Use 'personal-to-team' to move a personal epic request to team scope (sets status to 'pending' for approval). Use 'team-to-personal' to move a team epic request to your personal scope (sets status to pending). Only the creator of the epic request can transfer it. Returns the updated epic request.",
5981
6169
  inputSchema: {
5982
- id: z3.string().describe("The epic request to transfer. Accepts UUID or identifier (e.g., 'ER-1')"),
5983
- direction: z3.enum(["personal-to-team", "team-to-personal"]).describe(
6170
+ id: z4.string().describe("The epic request to transfer. Accepts UUID or identifier (e.g., 'ER-1')"),
6171
+ direction: z4.enum(["personal-to-team", "team-to-personal"]).describe(
5984
6172
  "Transfer direction: 'personal-to-team' moves to team scope (requires teamId, sets status to pending for approval), 'team-to-personal' moves to your personal scope (sets status to pending)"
5985
6173
  ),
5986
- teamId: z3.string().uuid().optional().describe(
6174
+ teamId: z4.string().uuid().optional().describe(
5987
6175
  "Target team ID. Required when direction is 'personal-to-team'. Use compbox__list_teams to find available teams."
5988
6176
  )
5989
6177
  }
@@ -6037,11 +6225,11 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
6037
6225
  {
6038
6226
  description: "Transfer an epic between personal and team scope. Use 'personal-to-team' to move a personal epic to a team (cascades scope change to all child features and tasks with status remapping). Use 'team-to-personal' to move a team epic to your personal scope. Requires authentication. Returns the updated epic.",
6039
6227
  inputSchema: {
6040
- id: z3.string().describe("The epic to transfer. Accepts UUID or identifier (e.g., 'ENG-E1')"),
6041
- direction: z3.enum(["personal-to-team", "team-to-personal"]).describe(
6228
+ id: z4.string().describe("The epic to transfer. Accepts UUID or identifier (e.g., 'ENG-E1')"),
6229
+ direction: z4.enum(["personal-to-team", "team-to-personal"]).describe(
6042
6230
  "Transfer direction: 'personal-to-team' moves to team scope (requires teamId, cascades to children), 'team-to-personal' moves to your personal scope"
6043
6231
  ),
6044
- teamId: z3.string().uuid().optional().describe(
6232
+ teamId: z4.string().uuid().optional().describe(
6045
6233
  "Target team ID. Required when direction is 'personal-to-team'. Use compbox__list_teams to find available teams."
6046
6234
  )
6047
6235
  }
@@ -6088,29 +6276,29 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
6088
6276
  {
6089
6277
  description: "Update planning pipeline progress for an Epic Request during Planner agent execution. Call this at each stage boundary (ANALYZE, DECOMPOSE, DETAIL, EVALUATE, VERIFY) to report stage transitions. Automatically transitions the ER from approved\u2192planning on first call. After DECOMPOSE completes, include epicId and epicIdentifier. After EVALUATE completes, include qualityScore. On failure, set error with message.",
6090
6278
  inputSchema: {
6091
- epicRequestId: z3.string().min(1).describe(
6279
+ epicRequestId: z4.string().min(1).describe(
6092
6280
  "The epic request ID or identifier (e.g., 'ER-112' or UUID). Required."
6093
6281
  ),
6094
- stage: z3.enum(["ANALYZE", "DECOMPOSE", "DETAIL", "EVALUATE", "VERIFY"]).describe("The pipeline stage being updated"),
6095
- status: z3.enum(["active", "completed", "failed"]).describe(
6282
+ stage: z4.enum(["ANALYZE", "DECOMPOSE", "DETAIL", "EVALUATE", "VERIFY"]).describe("The pipeline stage being updated"),
6283
+ status: z4.enum(["active", "completed", "failed"]).describe(
6096
6284
  "The new status: active (starting), completed (finished), failed (error)"
6097
6285
  ),
6098
- details: z3.string().max(2e3).optional().describe(
6286
+ details: z4.string().max(2e3).optional().describe(
6099
6287
  "Optional context for this stage (e.g., scope summary after ANALYZE)"
6100
6288
  ),
6101
- epicId: z3.string().uuid().optional().describe("Created epic UUID \u2014 provide when DECOMPOSE completes"),
6102
- epicIdentifier: z3.string().optional().describe(
6289
+ epicId: z4.string().uuid().optional().describe("Created epic UUID \u2014 provide when DECOMPOSE completes"),
6290
+ epicIdentifier: z4.string().optional().describe(
6103
6291
  "Created epic identifier (e.g., ENG-E1) \u2014 provide when DECOMPOSE completes"
6104
6292
  ),
6105
- qualityScore: z3.object({
6106
- overall: z3.number().min(0).max(100).describe("Overall quality score (0\u2013100) summarizing evaluation results"),
6107
- epicDescription: z3.number().min(0).max(100).describe("Quality of the epic description content and clarity (0\u2013100)"),
6108
- structure: z3.number().min(0).max(100).describe("Structure and organization quality of the planned epic (0\u2013100)"),
6109
- detail: z3.number().min(0).max(100).describe("Level of implementation detail and specificity (0\u2013100)"),
6110
- scoping: z3.number().min(0).max(100).describe("Quality of scoping and boundaries for the epic (0\u2013100)")
6293
+ qualityScore: z4.object({
6294
+ overall: z4.number().min(0).max(100).describe("Overall quality score (0\u2013100) summarizing evaluation results"),
6295
+ epicDescription: z4.number().min(0).max(100).describe("Quality of the epic description content and clarity (0\u2013100)"),
6296
+ structure: z4.number().min(0).max(100).describe("Structure and organization quality of the planned epic (0\u2013100)"),
6297
+ detail: z4.number().min(0).max(100).describe("Level of implementation detail and specificity (0\u2013100)"),
6298
+ scoping: z4.number().min(0).max(100).describe("Quality of scoping and boundaries for the epic (0\u2013100)")
6111
6299
  }).optional().describe("Quality scores \u2014 provide when EVALUATE completes"),
6112
- error: z3.object({
6113
- message: z3.string().max(1e3).describe("Human-readable error message explaining why the stage failed")
6300
+ error: z4.object({
6301
+ message: z4.string().max(1e3).describe("Human-readable error message explaining why the stage failed")
6114
6302
  }).optional().describe("Error details when stage fails")
6115
6303
  }
6116
6304
  },
@@ -6141,7 +6329,7 @@ Create a new Epic Request - a proposal for a new epic that requires approval. Ep
6141
6329
  }
6142
6330
 
6143
6331
  // src/tools/features.ts
6144
- import { z as z4 } from "zod";
6332
+ import { z as z5 } from "zod";
6145
6333
 
6146
6334
  // src/tools/utils/reminder-injector.ts
6147
6335
  var REMINDER_RULES = {
@@ -6211,22 +6399,22 @@ function registerFeatureTools(server2) {
6211
6399
  {
6212
6400
  description: "List features in CompBox with optional filtering by epic, status, assignee, or search query. Returns paginated results ordered by sort order then creation date (newest first). Features are the primary work items in CompBox, similar to issues in other project management tools. Each feature has an auto-generated identifier (e.g., 'COM-123') based on its team key.",
6213
6401
  inputSchema: {
6214
- epic: z4.string().optional().describe(
6402
+ epic: z5.string().optional().describe(
6215
6403
  "Filter by epic. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name (e.g., 'Mobile App Redesign' or '550e8400-e29b-41d4-a716-446655440000'). Name matching is case-sensitive."
6216
6404
  ),
6217
- status: z4.string().optional().describe(
6405
+ status: z5.string().optional().describe(
6218
6406
  "Filter by status. Accepts status ID (UUID) or exact status name (e.g., 'In Progress', 'Done'). Status names are team-specific."
6219
6407
  ),
6220
- assignee: z4.string().optional().describe(
6408
+ assignee: z5.string().optional().describe(
6221
6409
  "Filter by assignee. Accepts user ID (UUID) or the special value 'me' to filter by the current authenticated user. Use 'me' for 'my features' queries."
6222
6410
  ),
6223
- query: z4.string().optional().describe(
6411
+ query: z5.string().optional().describe(
6224
6412
  "Search query to filter features by title (case-insensitive substring match). For example, 'login' will match 'User Login Flow' and 'Login Page Redesign'."
6225
6413
  ),
6226
- limit: z4.number().int().min(1).max(100).optional().describe(
6414
+ limit: z5.number().int().min(1).max(100).optional().describe(
6227
6415
  "Maximum number of features to return per page (default: 20, max: 100). Use with cursor for pagination through large result sets."
6228
6416
  ),
6229
- cursor: z4.string().optional().describe(
6417
+ cursor: z5.string().optional().describe(
6230
6418
  "Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
6231
6419
  )
6232
6420
  }
@@ -6256,7 +6444,7 @@ function registerFeatureTools(server2) {
6256
6444
  {
6257
6445
  description: "Get detailed information about a specific feature by ID or identifier. Returns the full feature object including all metadata and a list of all tasks (sub-issues) associated with the feature. Tasks are ordered by sort order then creation date (newest first).",
6258
6446
  inputSchema: {
6259
- id: z4.string().describe(
6447
+ id: z5.string().describe(
6260
6448
  "The feature identifier to look up. Accepts either a UUID (e.g., '550e8400-e29b-41d4-a716-446655440000') or a human-readable identifier (e.g., 'COM-123'). The identifier format is '{TEAM_KEY}-{NUMBER}'."
6261
6449
  )
6262
6450
  }
@@ -6286,35 +6474,35 @@ function registerFeatureTools(server2) {
6286
6474
  {
6287
6475
  description: "Create a new feature in an epic. Features are the primary work items in CompBox. Each feature is automatically assigned a unique identifier based on the epic's team key (e.g., if the team key is 'COM', the feature might be 'COM-123'). Returns the created feature with all metadata including the generated identifier.\n\n**REQUIRED FIELDS**: executionOrder and estimatedComplexity must be provided. These fields are mandatory for proper planning and execution tracking.",
6288
6476
  inputSchema: {
6289
- title: z4.string().min(1).describe(
6477
+ title: z5.string().min(1).describe(
6290
6478
  "The title of the feature (required). Should be a concise description of the work (e.g., 'User Authentication Flow', 'Add Dark Mode Support')."
6291
6479
  ),
6292
- epic: z4.string().describe(
6480
+ epic: z5.string().describe(
6293
6481
  "The epic to add this feature to (required). Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name (e.g., 'Mobile App Redesign'). The epic's team determines the identifier prefix and available statuses."
6294
6482
  ),
6295
- description: z4.string().optional().describe(
6483
+ description: z5.string().optional().describe(
6296
6484
  "A detailed description of the feature in Markdown format. Can include requirements, acceptance criteria, technical notes, etc. Supports full Markdown syntax."
6297
6485
  ),
6298
- status: z4.string().optional().describe(
6486
+ status: z5.string().optional().describe(
6299
6487
  "Initial status for the feature. Accepts status ID (UUID) or exact status name (e.g., 'Backlog', 'In Progress'). If not provided, the feature is created without a status. Status names are resolved within the epic's team context."
6300
6488
  ),
6301
- assignee: z4.string().optional().describe(
6489
+ assignee: z5.string().optional().describe(
6302
6490
  "User to assign this feature to. Accepts user ID (UUID) or the special value 'me' to assign to the current authenticated user. If not provided, the feature is unassigned."
6303
6491
  ),
6304
6492
  // Execution metadata
6305
- executionOrder: z4.number().int().positive().optional().describe(
6493
+ executionOrder: z5.number().int().positive().optional().describe(
6306
6494
  "Suggested execution order (1, 2, 3...). Lower numbers are worked on first."
6307
6495
  ),
6308
- canParallelize: z4.boolean().optional().describe(
6496
+ canParallelize: z5.boolean().optional().describe(
6309
6497
  "Whether this feature can run alongside other features in parallel."
6310
6498
  ),
6311
- parallelGroup: z4.string().max(100).optional().describe(
6499
+ parallelGroup: z5.string().max(100).optional().describe(
6312
6500
  "Group identifier for features that can run together in parallel."
6313
6501
  ),
6314
- dependencies: z4.array(z4.string().uuid()).optional().describe(
6502
+ dependencies: z5.array(z5.string().uuid()).optional().describe(
6315
6503
  "Array of feature UUIDs that must be completed before this feature."
6316
6504
  ),
6317
- estimatedComplexity: z4.enum(["trivial", "simple", "moderate", "complex"]).optional().describe(
6505
+ estimatedComplexity: z5.enum(["trivial", "simple", "moderate", "complex"]).optional().describe(
6318
6506
  "Estimated complexity: 'trivial', 'simple', 'moderate', or 'complex'."
6319
6507
  )
6320
6508
  }
@@ -6371,35 +6559,35 @@ function registerFeatureTools(server2) {
6371
6559
  {
6372
6560
  description: "Update an existing feature. Only the fields you provide will be updated; omitted fields retain their current values. Returns the updated feature with all current field values. Use this to change status, reassign, or modify content.\n\nTIP: After completing significant work on a feature, consider using:\n- compbox__complete_work to mark it done (auto-calculates duration)\n- compbox__log_progress to note partial progress\n- compbox__start_work to begin work (sets status and timestamps)",
6373
6561
  inputSchema: {
6374
- id: z4.string().describe(
6562
+ id: z5.string().describe(
6375
6563
  "The feature to update (required). Accepts either a UUID (e.g., '550e8400-e29b-41d4-a716-446655440000') or a human-readable identifier (e.g., 'COM-123')."
6376
6564
  ),
6377
- title: z4.string().min(1).optional().describe(
6565
+ title: z5.string().min(1).optional().describe(
6378
6566
  "New title for the feature. Only provide if you want to change the title (e.g., 'Updated: User Authentication Flow')."
6379
6567
  ),
6380
- description: z4.string().optional().describe(
6568
+ description: z5.string().optional().describe(
6381
6569
  "New description in Markdown format. Replaces the entire description; there is no append mode. Supports full Markdown syntax."
6382
6570
  ),
6383
- status: z4.string().optional().describe(
6571
+ status: z5.string().optional().describe(
6384
6572
  "New status for the feature. Accepts status ID (UUID) or exact status name (e.g., 'In Progress', 'Done'). Status names are resolved within the feature's team context."
6385
6573
  ),
6386
- assignee: z4.string().optional().describe(
6574
+ assignee: z5.string().optional().describe(
6387
6575
  "New assignee for the feature. Accepts user ID (UUID) or the special value 'me' to assign to the current authenticated user."
6388
6576
  ),
6389
6577
  // Execution metadata
6390
- executionOrder: z4.number().int().positive().optional().describe(
6578
+ executionOrder: z5.number().int().positive().optional().describe(
6391
6579
  "Suggested execution order (1, 2, 3...). Lower numbers are worked on first."
6392
6580
  ),
6393
- canParallelize: z4.boolean().optional().describe(
6581
+ canParallelize: z5.boolean().optional().describe(
6394
6582
  "Whether this feature can run alongside other features in parallel."
6395
6583
  ),
6396
- parallelGroup: z4.string().max(100).optional().describe(
6584
+ parallelGroup: z5.string().max(100).optional().describe(
6397
6585
  "Group identifier for features that can run together in parallel."
6398
6586
  ),
6399
- dependencies: z4.array(z4.string().uuid()).optional().describe(
6587
+ dependencies: z5.array(z5.string().uuid()).optional().describe(
6400
6588
  "Array of feature UUIDs that must be completed before this feature."
6401
6589
  ),
6402
- estimatedComplexity: z4.enum(["trivial", "simple", "moderate", "complex"]).optional().describe(
6590
+ estimatedComplexity: z5.enum(["trivial", "simple", "moderate", "complex"]).optional().describe(
6403
6591
  "Estimated complexity: 'trivial', 'simple', 'moderate', or 'complex'."
6404
6592
  )
6405
6593
  }
@@ -6436,26 +6624,26 @@ function registerFeatureTools(server2) {
6436
6624
  }
6437
6625
 
6438
6626
  // src/tools/tasks.ts
6439
- import { z as z5 } from "zod";
6627
+ import { z as z6 } from "zod";
6440
6628
  function registerTaskTools(server2) {
6441
6629
  server2.registerTool(
6442
6630
  "compbox__list_tasks",
6443
6631
  {
6444
6632
  description: "List tasks in CompBox with optional filtering by feature, status, or assignee. Tasks are sub-issues that belong to a parent feature, used for breaking down work into smaller pieces. Returns paginated results ordered by sort order then creation date (newest first). Each task has an auto-generated identifier based on its parent feature (e.g., if the feature is 'COM-123', tasks are 'COM-123-1', 'COM-123-2', etc.).",
6445
6633
  inputSchema: {
6446
- feature: z5.string().optional().describe(
6634
+ feature: z6.string().optional().describe(
6447
6635
  "Filter tasks by parent feature. Accepts feature ID (UUID) or identifier (e.g., 'COM-123'). Use this to get all tasks for a specific feature."
6448
6636
  ),
6449
- status: z5.string().optional().describe(
6637
+ status: z6.string().optional().describe(
6450
6638
  "Filter by status ID (UUID). Tasks use the same status system as features, scoped to the feature's team."
6451
6639
  ),
6452
- assignee: z5.string().optional().describe(
6640
+ assignee: z6.string().optional().describe(
6453
6641
  "Filter by assignee user ID (UUID). Returns only tasks assigned to the specified user."
6454
6642
  ),
6455
- limit: z5.number().int().min(1).max(100).optional().describe(
6643
+ limit: z6.number().int().min(1).max(100).optional().describe(
6456
6644
  "Maximum number of tasks to return per page (default: 20, max: 100). Use with cursor for pagination through large result sets."
6457
6645
  ),
6458
- cursor: z5.string().optional().describe(
6646
+ cursor: z6.string().optional().describe(
6459
6647
  "Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
6460
6648
  )
6461
6649
  }
@@ -6487,7 +6675,7 @@ function registerTaskTools(server2) {
6487
6675
  {
6488
6676
  description: "Get detailed information about a specific task by ID or identifier. Returns the full task object including all metadata such as title, description, status, assignee, and timestamps.",
6489
6677
  inputSchema: {
6490
- id: z5.string().describe(
6678
+ id: z6.string().describe(
6491
6679
  "The task identifier to look up. Accepts either a UUID (e.g., '550e8400-e29b-41d4-a716-446655440000') or a human-readable identifier (e.g., 'COM-123-1'). The identifier format is '{FEATURE_IDENTIFIER}-{NUMBER}'."
6492
6680
  )
6493
6681
  }
@@ -6510,35 +6698,35 @@ function registerTaskTools(server2) {
6510
6698
  {
6511
6699
  description: "Create a new task under a feature. Tasks are sub-issues used to break down features into smaller, actionable work items. Each task is automatically assigned a unique identifier based on its parent feature (e.g., if the feature is 'COM-123', the task might be 'COM-123-1'). Returns the created task with all metadata including the generated identifier.\n\n**REQUIRED FIELDS**: executionOrder and estimatedComplexity must be provided. These fields are mandatory for proper planning and execution tracking.",
6512
6700
  inputSchema: {
6513
- title: z5.string().min(1).describe(
6701
+ title: z6.string().min(1).describe(
6514
6702
  "The title of the task (required). Should be a concise, actionable description (e.g., 'Implement password validation', 'Write unit tests for auth module')."
6515
6703
  ),
6516
- feature_id: z5.string().describe(
6704
+ feature_id: z6.string().describe(
6517
6705
  "The parent feature for this task (required). Accepts feature ID (UUID) or identifier (e.g., 'COM-123'). The task inherits team scope from its parent feature."
6518
6706
  ),
6519
- description: z5.string().optional().describe(
6707
+ description: z6.string().optional().describe(
6520
6708
  "A detailed description of the task in Markdown format. Can include implementation notes, acceptance criteria, or technical details. Supports full Markdown syntax."
6521
6709
  ),
6522
- status: z5.string().optional().describe(
6710
+ status: z6.string().optional().describe(
6523
6711
  "Initial status for the task. Accepts status ID (UUID) or exact status name (e.g., 'Backlog', 'In Progress'). Status names are resolved within the parent feature's team context. If not provided, the task is created without a status."
6524
6712
  ),
6525
- assignee: z5.string().optional().describe(
6713
+ assignee: z6.string().optional().describe(
6526
6714
  "User ID (UUID) to assign this task to. If not provided, the task is unassigned."
6527
6715
  ),
6528
6716
  // Execution metadata
6529
- executionOrder: z5.number().int().positive().optional().describe(
6717
+ executionOrder: z6.number().int().positive().optional().describe(
6530
6718
  "Suggested execution order (1, 2, 3...). Lower numbers are worked on first."
6531
6719
  ),
6532
- canParallelize: z5.boolean().optional().describe(
6720
+ canParallelize: z6.boolean().optional().describe(
6533
6721
  "Whether this task can run alongside other tasks in parallel."
6534
6722
  ),
6535
- parallelGroup: z5.string().max(100).optional().describe(
6723
+ parallelGroup: z6.string().max(100).optional().describe(
6536
6724
  "Group identifier for tasks that can run together in parallel."
6537
6725
  ),
6538
- dependencies: z5.array(z5.string().uuid()).optional().describe(
6726
+ dependencies: z6.array(z6.string().uuid()).optional().describe(
6539
6727
  "Array of task UUIDs that must be completed before this task."
6540
6728
  ),
6541
- estimatedComplexity: z5.enum(["trivial", "simple", "moderate", "complex"]).optional().describe(
6729
+ estimatedComplexity: z6.enum(["trivial", "simple", "moderate", "complex"]).optional().describe(
6542
6730
  "Estimated complexity: 'trivial', 'simple', 'moderate', or 'complex'."
6543
6731
  )
6544
6732
  }
@@ -6596,35 +6784,35 @@ function registerTaskTools(server2) {
6596
6784
  {
6597
6785
  description: "Update an existing task. Only the fields you provide will be updated; omitted fields retain their current values. Returns the updated task with all current field values. Use this to change status, reassign, or modify content.\n\nTIP: After completing significant work on a task, consider using:\n- compbox__complete_work to mark it done (auto-calculates duration)\n- compbox__log_progress to note partial progress\n- compbox__start_work to begin work (sets status and timestamps)",
6598
6786
  inputSchema: {
6599
- id: z5.string().describe(
6787
+ id: z6.string().describe(
6600
6788
  "The task to update (required). Accepts either a UUID (e.g., '550e8400-e29b-41d4-a716-446655440000') or a human-readable identifier (e.g., 'COM-123-1')."
6601
6789
  ),
6602
- title: z5.string().min(1).optional().describe(
6790
+ title: z6.string().min(1).optional().describe(
6603
6791
  "New title for the task. Only provide if you want to change the title (e.g., 'Updated: Implement password validation')."
6604
6792
  ),
6605
- description: z5.string().optional().describe(
6793
+ description: z6.string().optional().describe(
6606
6794
  "New description in Markdown format. Replaces the entire description; there is no append mode. Supports full Markdown syntax."
6607
6795
  ),
6608
- status: z5.string().optional().describe(
6796
+ status: z6.string().optional().describe(
6609
6797
  "New status for the task. Accepts status ID (UUID) or exact status name (e.g., 'In Progress', 'Done'). Status names are resolved within the parent feature's team context."
6610
6798
  ),
6611
- assignee: z5.string().optional().describe(
6799
+ assignee: z6.string().optional().describe(
6612
6800
  "New assignee user ID (UUID) for the task."
6613
6801
  ),
6614
6802
  // Execution metadata
6615
- executionOrder: z5.number().int().positive().optional().describe(
6803
+ executionOrder: z6.number().int().positive().optional().describe(
6616
6804
  "Suggested execution order (1, 2, 3...). Lower numbers are worked on first."
6617
6805
  ),
6618
- canParallelize: z5.boolean().optional().describe(
6806
+ canParallelize: z6.boolean().optional().describe(
6619
6807
  "Whether this task can run alongside other tasks in parallel."
6620
6808
  ),
6621
- parallelGroup: z5.string().max(100).optional().describe(
6809
+ parallelGroup: z6.string().max(100).optional().describe(
6622
6810
  "Group identifier for tasks that can run together in parallel."
6623
6811
  ),
6624
- dependencies: z5.array(z5.string().uuid()).optional().describe(
6812
+ dependencies: z6.array(z6.string().uuid()).optional().describe(
6625
6813
  "Array of task UUIDs that must be completed before this task."
6626
6814
  ),
6627
- estimatedComplexity: z5.enum(["trivial", "simple", "moderate", "complex"]).optional().describe(
6815
+ estimatedComplexity: z6.enum(["trivial", "simple", "moderate", "complex"]).optional().describe(
6628
6816
  "Estimated complexity: 'trivial', 'simple', 'moderate', or 'complex'."
6629
6817
  )
6630
6818
  }
@@ -6662,17 +6850,17 @@ function registerTaskTools(server2) {
6662
6850
  }
6663
6851
 
6664
6852
  // src/tools/statuses.ts
6665
- import { z as z6 } from "zod";
6853
+ import { z as z7 } from "zod";
6666
6854
  var listStatusesSchema = {
6667
- team: z6.string().describe(
6855
+ team: z7.string().describe(
6668
6856
  "The team to list statuses for (required). Accepts team ID (UUID), name, or key (e.g., 'Engineering', 'ENG', or '550e8400-e29b-41d4-a716-446655440000'). Each team has its own set of workflow statuses."
6669
6857
  )
6670
6858
  };
6671
6859
  var getStatusSchema = {
6672
- id: z6.string().describe(
6860
+ id: z7.string().describe(
6673
6861
  "The status to look up. Accepts status ID (UUID) or exact status name (e.g., 'In Progress', 'Done'). When using a name, provide the team parameter to avoid ambiguity since different teams may have statuses with the same name."
6674
6862
  ),
6675
- team: z6.string().optional().describe(
6863
+ team: z7.string().optional().describe(
6676
6864
  "Team context for name-based lookup. Accepts team ID (UUID), name, or key (e.g., 'Engineering', 'ENG'). Required when looking up a status by name to ensure the correct team's status is returned. Not needed when using a status UUID."
6677
6865
  )
6678
6866
  };
@@ -6742,30 +6930,30 @@ function registerStatusTools(server2) {
6742
6930
  }
6743
6931
 
6744
6932
  // src/tools/ordering.ts
6745
- import { z as z7 } from "zod";
6933
+ import { z as z8 } from "zod";
6746
6934
  function registerOrderingTools(server2) {
6747
6935
  server2.registerTool(
6748
6936
  "compbox__reorder_item",
6749
6937
  {
6750
6938
  description: "Reorder epics, features, or tasks using a unified interface. This composite tool consolidates 3 reordering operations into a single tool with action-based routing.\n\nActions:\n- 'reorder_epic': Change position of an epic within its team\n- 'reorder_feature': Change position of a feature within its epic\n- 'reorder_task': Change position of a task within its feature\n\nUse afterId, beforeId, or both to specify the new position. At least one position reference is required.\n\nUse this instead of the individual reorder tools for a more streamlined workflow.",
6751
- inputSchema: z7.discriminatedUnion("action", [
6752
- z7.object({
6753
- action: z7.literal("reorder_epic"),
6754
- id: z7.string().uuid().describe("UUID of the epic to reorder"),
6755
- afterId: z7.string().uuid().optional().describe("UUID of the epic to place this after"),
6756
- beforeId: z7.string().uuid().optional().describe("UUID of the epic to place this before")
6939
+ inputSchema: z8.discriminatedUnion("action", [
6940
+ z8.object({
6941
+ action: z8.literal("reorder_epic"),
6942
+ id: z8.string().uuid().describe("UUID of the epic to reorder"),
6943
+ afterId: z8.string().uuid().optional().describe("UUID of the epic to place this after"),
6944
+ beforeId: z8.string().uuid().optional().describe("UUID of the epic to place this before")
6757
6945
  }),
6758
- z7.object({
6759
- action: z7.literal("reorder_feature"),
6760
- id: z7.string().uuid().describe("UUID of the feature to reorder"),
6761
- afterId: z7.string().uuid().optional().describe("UUID of the feature to place this after"),
6762
- beforeId: z7.string().uuid().optional().describe("UUID of the feature to place this before")
6946
+ z8.object({
6947
+ action: z8.literal("reorder_feature"),
6948
+ id: z8.string().uuid().describe("UUID of the feature to reorder"),
6949
+ afterId: z8.string().uuid().optional().describe("UUID of the feature to place this after"),
6950
+ beforeId: z8.string().uuid().optional().describe("UUID of the feature to place this before")
6763
6951
  }),
6764
- z7.object({
6765
- action: z7.literal("reorder_task"),
6766
- id: z7.string().uuid().describe("UUID of the task to reorder"),
6767
- afterId: z7.string().uuid().optional().describe("UUID of the task to place this after"),
6768
- beforeId: z7.string().uuid().optional().describe("UUID of the task to place this before")
6952
+ z8.object({
6953
+ action: z8.literal("reorder_task"),
6954
+ id: z8.string().uuid().describe("UUID of the task to reorder"),
6955
+ afterId: z8.string().uuid().optional().describe("UUID of the task to place this after"),
6956
+ beforeId: z8.string().uuid().optional().describe("UUID of the task to place this before")
6769
6957
  })
6770
6958
  ])
6771
6959
  },
@@ -6835,13 +7023,13 @@ function registerOrderingTools(server2) {
6835
7023
  {
6836
7024
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__reorder_item with action='reorder_epic' instead.\n\nReorder an epic within its team's epic list. Use this to change the position of an epic relative to other epics. Provide afterId to place the epic after another one, or beforeId to place it before another one, or both to place it precisely between two epics. Epics must belong to the same team.",
6837
7025
  inputSchema: {
6838
- id: z7.string().uuid().describe(
7026
+ id: z8.string().uuid().describe(
6839
7027
  "The UUID of the epic to reorder."
6840
7028
  ),
6841
- afterId: z7.string().uuid().optional().describe(
7029
+ afterId: z8.string().uuid().optional().describe(
6842
7030
  "The UUID of the epic to place this epic after. If not provided, the epic will be placed at the start (when used with beforeId) or at the end (when neither is provided)."
6843
7031
  ),
6844
- beforeId: z7.string().uuid().optional().describe(
7032
+ beforeId: z8.string().uuid().optional().describe(
6845
7033
  "The UUID of the epic to place this epic before. If not provided, the epic will be placed at the end (when used with afterId) or at the start (when neither is provided)."
6846
7034
  )
6847
7035
  }
@@ -6882,13 +7070,13 @@ function registerOrderingTools(server2) {
6882
7070
  {
6883
7071
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__reorder_item with action='reorder_feature' instead.\n\nReorder a feature within its epic. Use this to change the position of a feature relative to other features. Provide afterId to place the feature after another one, or beforeId to place it before another one, or both to place it precisely between two features. Features must belong to the same epic.",
6884
7072
  inputSchema: {
6885
- id: z7.string().uuid().describe(
7073
+ id: z8.string().uuid().describe(
6886
7074
  "The UUID of the feature to reorder."
6887
7075
  ),
6888
- afterId: z7.string().uuid().optional().describe(
7076
+ afterId: z8.string().uuid().optional().describe(
6889
7077
  "The UUID of the feature to place this feature after. If not provided, the feature will be placed at the start (when used with beforeId) or at the end (when neither is provided)."
6890
7078
  ),
6891
- beforeId: z7.string().uuid().optional().describe(
7079
+ beforeId: z8.string().uuid().optional().describe(
6892
7080
  "The UUID of the feature to place this feature before. If not provided, the feature will be placed at the end (when used with afterId) or at the start (when neither is provided)."
6893
7081
  )
6894
7082
  }
@@ -6929,13 +7117,13 @@ function registerOrderingTools(server2) {
6929
7117
  {
6930
7118
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__reorder_item with action='reorder_task' instead.\n\nReorder a task within its parent feature. Use this to change the position of a task relative to other tasks. Provide afterId to place the task after another one, or beforeId to place it before another one, or both to place it precisely between two tasks. Tasks must belong to the same feature.",
6931
7119
  inputSchema: {
6932
- id: z7.string().uuid().describe(
7120
+ id: z8.string().uuid().describe(
6933
7121
  "The UUID of the task to reorder."
6934
7122
  ),
6935
- afterId: z7.string().uuid().optional().describe(
7123
+ afterId: z8.string().uuid().optional().describe(
6936
7124
  "The UUID of the task to place this task after. If not provided, the task will be placed at the start (when used with beforeId) or at the end (when neither is provided)."
6937
7125
  ),
6938
- beforeId: z7.string().uuid().optional().describe(
7126
+ beforeId: z8.string().uuid().optional().describe(
6939
7127
  "The UUID of the task to place this task before. If not provided, the task will be placed at the end (when used with afterId) or at the start (when neither is provided)."
6940
7128
  )
6941
7129
  }
@@ -6974,41 +7162,41 @@ function registerOrderingTools(server2) {
6974
7162
  }
6975
7163
 
6976
7164
  // src/tools/search.ts
6977
- import { z as z8 } from "zod";
7165
+ import { z as z9 } from "zod";
6978
7166
  function registerSearchTools(server2) {
6979
7167
  server2.registerTool(
6980
7168
  "compbox__search",
6981
7169
  {
6982
7170
  description: "Search for features and tasks in CompBox with various filters. Supports text search, filtering by epic, status, assignee, and date ranges. Can search features only, tasks only, or both combined. Results include a 'type' field indicating whether each item is a 'feature' or 'task'. Features are the primary work items, while tasks are sub-issues under features.",
6983
7171
  inputSchema: {
6984
- query: z8.string().optional().describe(
7172
+ query: z9.string().optional().describe(
6985
7173
  "Text search query. Searches in title and description (case-insensitive). For example, 'login' will match 'User Login Flow' and items with 'login' in description."
6986
7174
  ),
6987
- epic: z8.string().optional().describe(
7175
+ epic: z9.string().optional().describe(
6988
7176
  "Filter by epic. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name. Only features in this epic (and their tasks) will be returned. Name matching is case-sensitive."
6989
7177
  ),
6990
- status: z8.string().optional().describe(
7178
+ status: z9.string().optional().describe(
6991
7179
  "Filter by status. Accepts status ID (UUID) or exact status name (e.g., 'In Progress', 'Done'). Status names are team-specific."
6992
7180
  ),
6993
- statusCategory: z8.string().optional().describe(
7181
+ statusCategory: z9.string().optional().describe(
6994
7182
  "Filter by status category. Valid values are: 'backlog', 'unstarted', 'started', 'completed', 'canceled'. This filters items by the category their status belongs to, rather than a specific status."
6995
7183
  ),
6996
- assignee: z8.string().optional().describe(
7184
+ assignee: z9.string().optional().describe(
6997
7185
  "Filter by assignee. Accepts user ID (UUID), email address, or special values: 'me' for the current authenticated user, 'none' for unassigned items."
6998
7186
  ),
6999
- createdAt: z8.string().optional().describe(
7187
+ createdAt: z9.string().optional().describe(
7000
7188
  "Filter by creation date. Accepts ISO-8601 date (e.g., '2024-01-15') or ISO-8601 duration for relative dates (e.g., '-P7D' for last 7 days, '-P1M' for last month). Returns items created on or after this date."
7001
7189
  ),
7002
- updatedAt: z8.string().optional().describe(
7190
+ updatedAt: z9.string().optional().describe(
7003
7191
  "Filter by last update date. Accepts ISO-8601 date or duration format. Returns items updated on or after this date. Useful for finding recently modified items (e.g., '-P1D' for items updated in the last day)."
7004
7192
  ),
7005
- type: z8.enum(["feature", "task", "all"]).optional().describe(
7193
+ type: z9.enum(["feature", "task", "all"]).optional().describe(
7006
7194
  "Type of items to search. 'feature' searches only features, 'task' searches only tasks, 'all' searches both (default). When searching 'all', results are combined and sorted by creation date (newest first)."
7007
7195
  ),
7008
- limit: z8.number().int().min(1).max(100).optional().describe(
7196
+ limit: z9.number().int().min(1).max(100).optional().describe(
7009
7197
  "Maximum number of results to return per page (default: 50, max: 100). When type='all', this limit applies to the combined results. Use with cursor for pagination."
7010
7198
  ),
7011
- cursor: z8.string().optional().describe(
7199
+ cursor: z9.string().optional().describe(
7012
7200
  "Pagination cursor from a previous response. Format: 'feature:{cursor}' or 'task:{cursor}' when searching a specific type, or a combined cursor when searching all. Pass this to fetch the next page of results."
7013
7201
  )
7014
7202
  }
@@ -7043,7 +7231,7 @@ function registerSearchTools(server2) {
7043
7231
  }
7044
7232
 
7045
7233
  // src/tools/personal.ts
7046
- import { z as z9 } from "zod";
7234
+ import { z as z10 } from "zod";
7047
7235
  function registerPersonalTools(server2) {
7048
7236
  server2.registerTool(
7049
7237
  "compbox__get_personal_scope",
@@ -7074,10 +7262,10 @@ function registerPersonalTools(server2) {
7074
7262
  {
7075
7263
  description: "List all projects in the authenticated user's personal scope. Personal projects are private and only visible to the owner. Returns paginated results ordered by sort order then creation date (newest first). Use this tool when the user wants to see their private/personal projects.",
7076
7264
  inputSchema: {
7077
- limit: z9.number().int().min(1).max(100).optional().describe(
7265
+ limit: z10.number().int().min(1).max(100).optional().describe(
7078
7266
  "Maximum number of projects to return per page (default: 20, max: 100). Use with cursor for pagination through large result sets."
7079
7267
  ),
7080
- cursor: z9.string().optional().describe(
7268
+ cursor: z10.string().optional().describe(
7081
7269
  "Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
7082
7270
  )
7083
7271
  }
@@ -7121,16 +7309,16 @@ function registerPersonalTools(server2) {
7121
7309
  {
7122
7310
  description: "Create a new project in the authenticated user's personal scope. Personal projects are private and only visible to the owner. Unlike team projects, personal projects use the user's personal statuses. Returns the created project with all metadata. Use this when the user wants to create a private project not associated with any team.",
7123
7311
  inputSchema: {
7124
- name: z9.string().min(1).describe(
7312
+ name: z10.string().min(1).describe(
7125
7313
  "The display name for the project (required). Should be descriptive (e.g., 'Personal Tasks', 'Side Project Ideas', 'Learning Goals')."
7126
7314
  ),
7127
- description: z9.string().optional().describe(
7315
+ description: z10.string().optional().describe(
7128
7316
  "A longer description of the project's purpose and scope. Supports plain text (e.g., 'My personal task tracking and notes')."
7129
7317
  ),
7130
- icon: z9.string().optional().describe(
7318
+ icon: z10.string().optional().describe(
7131
7319
  "An icon identifier for visual display (e.g., 'rocket', 'star', 'folder'). Used in the UI to help identify the project at a glance."
7132
7320
  ),
7133
- color: z9.string().optional().describe(
7321
+ color: z10.string().optional().describe(
7134
7322
  "A hex color code for the project's visual theme (e.g., '#FF5733', '#3B82F6'). Used in the UI for project badges and highlights."
7135
7323
  )
7136
7324
  }
@@ -7201,13 +7389,13 @@ function registerPersonalTools(server2) {
7201
7389
  {
7202
7390
  description: "List epic requests in the authenticated user's personal scope. Personal epic requests are private and only visible to the owner. Returns paginated results with optional status filtering, ordered by creation date (newest first). Use this to see your personal epic request drafts and proposals.",
7203
7391
  inputSchema: {
7204
- cursor: z9.string().optional().describe(
7392
+ cursor: z10.string().optional().describe(
7205
7393
  "Pagination cursor from a previous response's meta.cursor field. Pass this to fetch the next page of results."
7206
7394
  ),
7207
- limit: z9.number().int().min(1).max(100).optional().describe(
7395
+ limit: z10.number().int().min(1).max(100).optional().describe(
7208
7396
  "Maximum number of epic requests to return per page (default: 20, max: 100). Use with cursor for pagination through large result sets."
7209
7397
  ),
7210
- status: z9.enum(["pending", "approved", "rejected", "converted"]).optional().describe(
7398
+ status: z10.enum(["pending", "approved", "rejected", "converted"]).optional().describe(
7211
7399
  "Filter by request status: 'pending', 'approved', 'rejected', or 'converted'. Personal requests require approval like team requests."
7212
7400
  )
7213
7401
  }
@@ -7236,7 +7424,7 @@ function registerPersonalTools(server2) {
7236
7424
  }
7237
7425
 
7238
7426
  // src/tools/execution.ts
7239
- import { z as z10 } from "zod";
7427
+ import { z as z11 } from "zod";
7240
7428
  var complexityValues = ["trivial", "simple", "moderate", "complex"];
7241
7429
  function registerExecutionTools(server2) {
7242
7430
  server2.registerTool(
@@ -7244,7 +7432,7 @@ function registerExecutionTools(server2) {
7244
7432
  {
7245
7433
  description: "Get an ordered execution plan for features in an epic. Returns phases with items grouped by dependencies and parallel execution capability. Use this to understand what order to work on features, which can run in parallel, and estimated complexity. Items are ordered by their execution metadata (executionOrder, dependencies, parallelGroup).",
7246
7434
  inputSchema: {
7247
- epicId: z10.string().describe(
7435
+ epicId: z11.string().describe(
7248
7436
  "The epic to generate an execution plan for. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name (e.g., 'Mobile App Redesign')."
7249
7437
  )
7250
7438
  }
@@ -7268,23 +7456,23 @@ function registerExecutionTools(server2) {
7268
7456
  {
7269
7457
  description: "Set execution metadata for a feature or task. Use this to define execution order, dependencies, parallelization, and complexity estimates. This metadata helps AI agents understand how to approach work items.",
7270
7458
  inputSchema: {
7271
- id: z10.string().describe(
7459
+ id: z11.string().describe(
7272
7460
  "The feature or task identifier to update. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks)."
7273
7461
  ),
7274
- type: z10.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
7275
- executionOrder: z10.number().int().positive().optional().describe(
7462
+ type: z11.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
7463
+ executionOrder: z11.number().int().positive().optional().describe(
7276
7464
  "Suggested execution order (1, 2, 3...). Items with lower numbers should be worked on first. Items without executionOrder are processed after numbered items."
7277
7465
  ),
7278
- canParallelize: z10.boolean().optional().describe(
7466
+ canParallelize: z11.boolean().optional().describe(
7279
7467
  "Whether this item can run alongside other items. Set to true if the work is independent and doesn't conflict with other parallel work."
7280
7468
  ),
7281
- parallelGroup: z10.string().max(100).optional().describe(
7469
+ parallelGroup: z11.string().max(100).optional().describe(
7282
7470
  "Group identifier for items that can run together. Items in the same parallelGroup with canParallelize=true will be grouped in the same execution phase."
7283
7471
  ),
7284
- dependencies: z10.array(z10.string().uuid()).optional().describe(
7472
+ dependencies: z11.array(z11.string().uuid()).optional().describe(
7285
7473
  "Array of feature/task UUIDs that must be completed before this item. The execution plan will ensure dependencies are scheduled in earlier phases."
7286
7474
  ),
7287
- estimatedComplexity: z10.enum(complexityValues).optional().describe(
7475
+ estimatedComplexity: z11.enum(complexityValues).optional().describe(
7288
7476
  "Estimated complexity of the work: 'trivial' (< 1 hour), 'simple' (1-4 hours), 'moderate' (1-3 days), or 'complex' (> 3 days). Helps with planning and prioritization."
7289
7477
  )
7290
7478
  }
@@ -7351,11 +7539,11 @@ ${JSON.stringify(result, null, 2)}`
7351
7539
  {
7352
7540
  description: "Mark a feature or task as blocked by another item. Adds the blocker to the item's dependencies, ensuring the blocker is completed first in execution plans.",
7353
7541
  inputSchema: {
7354
- id: z10.string().describe(
7542
+ id: z11.string().describe(
7355
7543
  "The feature or task that is blocked. Accepts UUID or human-readable identifier."
7356
7544
  ),
7357
- type: z10.enum(["feature", "task"]).describe("Whether the blocked item is a 'feature' or 'task'."),
7358
- blockedById: z10.string().uuid().describe(
7545
+ type: z11.enum(["feature", "task"]).describe("Whether the blocked item is a 'feature' or 'task'."),
7546
+ blockedById: z11.string().uuid().describe(
7359
7547
  "The UUID of the feature or task that is blocking this item. This item will be added to the dependencies list."
7360
7548
  )
7361
7549
  }
@@ -7404,11 +7592,11 @@ ${JSON.stringify(result, null, 2)}`
7404
7592
  {
7405
7593
  description: "Remove a blocker from a feature or task. Removes the specified item from the dependencies list, allowing it to be scheduled without waiting for the blocker.",
7406
7594
  inputSchema: {
7407
- id: z10.string().describe(
7595
+ id: z11.string().describe(
7408
7596
  "The feature or task to unblock. Accepts UUID or human-readable identifier."
7409
7597
  ),
7410
- type: z10.enum(["feature", "task"]).describe("Whether the item is a 'feature' or 'task'."),
7411
- unblockedFromId: z10.string().uuid().describe(
7598
+ type: z11.enum(["feature", "task"]).describe("Whether the item is a 'feature' or 'task'."),
7599
+ unblockedFromId: z11.string().uuid().describe(
7412
7600
  "The UUID of the feature or task to remove from dependencies."
7413
7601
  )
7414
7602
  }
@@ -7453,7 +7641,7 @@ ${JSON.stringify(result, null, 2)}`
7453
7641
  }
7454
7642
 
7455
7643
  // src/tools/help.ts
7456
- import { z as z11 } from "zod";
7644
+ import { z as z12 } from "zod";
7457
7645
  var topicValues = ["all", "overview", "execution", "progress", "summary", "search", "workflow", "personal", "templates", "sessions", "structured", "codeContext", "validations", "decisions"];
7458
7646
  var helpTopics = {
7459
7647
  overview: `# CompBox Overview
@@ -8528,7 +8716,7 @@ function registerHelpTools(server2) {
8528
8716
  {
8529
8717
  description: "Get instructions and guidance for using CompBox effectively. Call this tool at the start of a session to understand available capabilities, best practices, and recommended workflows. Topics include: overview, sessions (handoff between AI sessions), summary (progress dashboard), execution (planning & dependencies), progress (tracking tools), structured (rich descriptions), codeContext (link code artifacts), validations (executable acceptance criteria), decisions (append-only decision log), search (filtering), workflow (recommended patterns), personal (private workspace), and templates (implementation plan templates).",
8530
8718
  inputSchema: {
8531
- topic: z11.enum(topicValues).default("all").describe(
8719
+ topic: z12.enum(topicValues).default("all").describe(
8532
8720
  "Which topic to get help on. Use 'all' for complete instructions, or choose a specific topic: 'overview' (concepts), 'sessions' (AI session handoff), 'summary' (progress dashboard), 'execution' (planning & dependencies), 'progress' (tracking tools), 'structured' (rich descriptions), 'codeContext' (link code artifacts), 'validations' (executable acceptance criteria), 'decisions' (append-only decision log), 'search' (filtering), 'workflow' (recommended patterns), 'personal' (private workspace), 'templates' (implementation plan templates)."
8533
8721
  )
8534
8722
  }
@@ -8545,32 +8733,32 @@ function registerHelpTools(server2) {
8545
8733
  }
8546
8734
 
8547
8735
  // src/tools/ai-context.ts
8548
- import { z as z12 } from "zod";
8736
+ import { z as z13 } from "zod";
8549
8737
  function registerAiContextTools(server2) {
8550
8738
  server2.registerTool(
8551
8739
  "compbox__manage_ai_context",
8552
8740
  {
8553
8741
  description: "Manage AI context and notes for features, tasks, and epics using a unified interface. This composite tool consolidates 3 AI context operations into a single tool with action-based routing.\n\nActions:\n- 'get_context': Retrieve AI context and notes for an item\n- 'set_context': Replace the entire AI context field\n- 'append_note': Add a new note to the AI notes array\n\nUse this instead of the individual AI context tools for a more streamlined workflow.",
8554
- inputSchema: z12.discriminatedUnion("action", [
8555
- z12.object({
8556
- action: z12.literal("get_context"),
8557
- id: z12.string().describe("Feature, task, or epic identifier (UUID or human-readable). Epics also accept identifiers like 'ENG-E1'"),
8558
- type: z12.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'")
8742
+ inputSchema: z13.discriminatedUnion("action", [
8743
+ z13.object({
8744
+ action: z13.literal("get_context"),
8745
+ id: z13.string().describe("Feature, task, or epic identifier (UUID or human-readable). Epics also accept identifiers like 'ENG-E1'"),
8746
+ type: z13.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'")
8559
8747
  }),
8560
- z12.object({
8561
- action: z12.literal("set_context"),
8562
- id: z12.string().describe("Feature, task, or epic identifier (UUID or human-readable). Epics also accept identifiers like 'ENG-E1'"),
8563
- type: z12.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'"),
8564
- context: z12.string().max(5e4).describe("Structured context for AI consumption (replaces entire field)"),
8565
- sessionId: z12.string().max(255).optional().describe("Optional AI session identifier")
8748
+ z13.object({
8749
+ action: z13.literal("set_context"),
8750
+ id: z13.string().describe("Feature, task, or epic identifier (UUID or human-readable). Epics also accept identifiers like 'ENG-E1'"),
8751
+ type: z13.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'"),
8752
+ context: z13.string().max(5e4).describe("Structured context for AI consumption (replaces entire field)"),
8753
+ sessionId: z13.string().max(255).optional().describe("Optional AI session identifier")
8566
8754
  }),
8567
- z12.object({
8568
- action: z12.literal("append_note"),
8569
- id: z12.string().describe("Feature, task, or epic identifier (UUID or human-readable). Epics also accept identifiers like 'ENG-E1'"),
8570
- type: z12.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'"),
8571
- noteType: z12.enum(["observation", "decision", "blocker", "next-step", "context"]).describe("Type of note"),
8572
- content: z12.string().min(1).max(1e4).describe("Content of the note"),
8573
- sessionId: z12.string().max(255).optional().describe("Optional AI session identifier")
8755
+ z13.object({
8756
+ action: z13.literal("append_note"),
8757
+ id: z13.string().describe("Feature, task, or epic identifier (UUID or human-readable). Epics also accept identifiers like 'ENG-E1'"),
8758
+ type: z13.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'"),
8759
+ noteType: z13.enum(["observation", "decision", "blocker", "next-step", "context"]).describe("Type of note"),
8760
+ content: z13.string().min(1).max(1e4).describe("Content of the note"),
8761
+ sessionId: z13.string().max(255).optional().describe("Optional AI session identifier")
8574
8762
  })
8575
8763
  ])
8576
8764
  },
@@ -8718,10 +8906,10 @@ function registerAiContextTools(server2) {
8718
8906
  {
8719
8907
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__manage_ai_context with action='get_context' instead.\n\nRetrieve AI context for a feature, task, or epic. Returns structured context that was set by previous AI sessions, along with an array of AI notes (observations, decisions, blockers, next-steps). Use this at the start of a session to understand previous work and continue from where the last session left off.",
8720
8908
  inputSchema: {
8721
- id: z12.string().describe(
8909
+ id: z13.string().describe(
8722
8910
  "The feature, task, or epic identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks). Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
8723
8911
  ),
8724
- type: z12.enum(["feature", "task", "epic"]).describe(
8912
+ type: z13.enum(["feature", "task", "epic"]).describe(
8725
8913
  "Whether this is a 'feature', 'task', or 'epic'."
8726
8914
  )
8727
8915
  }
@@ -8770,16 +8958,16 @@ function registerAiContextTools(server2) {
8770
8958
  {
8771
8959
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__manage_ai_context with action='set_context' instead.\n\nSet structured context for a feature, task, or epic. This replaces the entire AI context field. Use this to store a summary or structured data that future sessions should know. For incremental updates, prefer compbox__append_ai_note instead.",
8772
8960
  inputSchema: {
8773
- id: z12.string().describe(
8961
+ id: z13.string().describe(
8774
8962
  "The feature, task, or epic identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks). Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
8775
8963
  ),
8776
- type: z12.enum(["feature", "task", "epic"]).describe(
8964
+ type: z13.enum(["feature", "task", "epic"]).describe(
8777
8965
  "Whether this is a 'feature', 'task', or 'epic'."
8778
8966
  ),
8779
- context: z12.string().max(5e4).describe(
8967
+ context: z13.string().max(5e4).describe(
8780
8968
  "Structured context for AI consumption. Can be free-form text, markdown, or structured data. This replaces the entire context field."
8781
8969
  ),
8782
- sessionId: z12.string().max(255).optional().describe(
8970
+ sessionId: z13.string().max(255).optional().describe(
8783
8971
  "Optional identifier for this AI session. Helps track which session made changes."
8784
8972
  )
8785
8973
  }
@@ -8837,19 +9025,19 @@ function registerAiContextTools(server2) {
8837
9025
  {
8838
9026
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__manage_ai_context with action='append_note' instead.\n\nAppend a note to a feature, task, or epic's AI notes array. Notes are never overwritten, only appended. Use this to log observations, decisions, blockers, or next-steps as you work. Each note is timestamped and can include a session identifier.",
8839
9027
  inputSchema: {
8840
- id: z12.string().describe(
9028
+ id: z13.string().describe(
8841
9029
  "The feature, task, or epic identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks). Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
8842
9030
  ),
8843
- type: z12.enum(["feature", "task", "epic"]).describe(
9031
+ type: z13.enum(["feature", "task", "epic"]).describe(
8844
9032
  "Whether this is a 'feature', 'task', or 'epic'."
8845
9033
  ),
8846
- noteType: z12.enum(["observation", "decision", "blocker", "next-step", "context"]).describe(
9034
+ noteType: z13.enum(["observation", "decision", "blocker", "next-step", "context"]).describe(
8847
9035
  "The type of note:\n- 'observation': What you noticed or discovered\n- 'decision': A choice made and why\n- 'blocker': What's preventing progress\n- 'next-step': What should happen next\n- 'context': General background information"
8848
9036
  ),
8849
- content: z12.string().min(1).max(1e4).describe(
9037
+ content: z13.string().min(1).max(1e4).describe(
8850
9038
  "The content of the note. Should be clear and actionable for future AI sessions."
8851
9039
  ),
8852
- sessionId: z12.string().max(255).optional().describe(
9040
+ sessionId: z13.string().max(255).optional().describe(
8853
9041
  "Optional identifier for this AI session. Helps track which session added the note."
8854
9042
  )
8855
9043
  }
@@ -8923,49 +9111,49 @@ function registerAiContextTools(server2) {
8923
9111
  }
8924
9112
 
8925
9113
  // src/tools/progress.ts
8926
- import { z as z13 } from "zod";
9114
+ import { z as z14 } from "zod";
8927
9115
  function registerProgressTools(server2) {
8928
9116
  server2.registerTool(
8929
9117
  "compbox__manage_progress",
8930
9118
  {
8931
9119
  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.",
8932
- inputSchema: z13.discriminatedUnion("action", [
8933
- z13.object({
8934
- action: z13.literal("start_work"),
8935
- id: z13.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
8936
- type: z13.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
8937
- sessionId: z13.string().max(255).optional().describe("Optional AI session identifier")
9120
+ inputSchema: z14.discriminatedUnion("action", [
9121
+ z14.object({
9122
+ action: z14.literal("start_work"),
9123
+ id: z14.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
9124
+ type: z14.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
9125
+ sessionId: z14.string().max(255).optional().describe("Optional AI session identifier")
8938
9126
  }),
8939
- z13.object({
8940
- action: z13.literal("complete_work"),
8941
- id: z13.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
8942
- type: z13.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
8943
- summary: z13.string().max(5e3).optional().describe("Optional summary of work completed"),
8944
- sessionId: z13.string().max(255).optional().describe("Optional AI session identifier")
9127
+ z14.object({
9128
+ action: z14.literal("complete_work"),
9129
+ id: z14.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
9130
+ type: z14.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
9131
+ summary: z14.string().max(5e3).optional().describe("Optional summary of work completed"),
9132
+ sessionId: z14.string().max(255).optional().describe("Optional AI session identifier")
8945
9133
  }),
8946
- z13.object({
8947
- action: z13.literal("log_progress"),
8948
- id: z13.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
8949
- type: z13.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
8950
- message: z13.string().min(1).max(5e3).describe("Progress message to log as AI note"),
8951
- percentComplete: z13.number().int().min(0).max(100).optional().describe("Optional percentage (0-100)"),
8952
- sessionId: z13.string().max(255).optional().describe("Optional AI session identifier")
9134
+ z14.object({
9135
+ action: z14.literal("log_progress"),
9136
+ id: z14.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
9137
+ type: z14.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
9138
+ message: z14.string().min(1).max(5e3).describe("Progress message to log as AI note"),
9139
+ percentComplete: z14.number().int().min(0).max(100).optional().describe("Optional percentage (0-100)"),
9140
+ sessionId: z14.string().max(255).optional().describe("Optional AI session identifier")
8953
9141
  }),
8954
- z13.object({
8955
- action: z13.literal("report_blocker"),
8956
- id: z13.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
8957
- type: z13.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
8958
- reason: z13.string().min(1).max(5e3).describe("Description of what is blocking progress"),
8959
- blockedById: z13.string().uuid().optional().describe("Optional UUID of the blocking item"),
8960
- sessionId: z13.string().max(255).optional().describe("Optional AI session identifier")
9142
+ z14.object({
9143
+ action: z14.literal("report_blocker"),
9144
+ id: z14.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
9145
+ type: z14.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
9146
+ reason: z14.string().min(1).max(5e3).describe("Description of what is blocking progress"),
9147
+ blockedById: z14.string().uuid().optional().describe("Optional UUID of the blocking item"),
9148
+ sessionId: z14.string().max(255).optional().describe("Optional AI session identifier")
8961
9149
  }),
8962
- z13.object({
8963
- action: z13.literal("resolve_blocker"),
8964
- id: z13.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
8965
- type: z13.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
8966
- resolution: z13.string().min(1).max(5e3).describe("Description of how the blocker was resolved"),
8967
- unblockedFromId: z13.string().uuid().optional().describe("Optional UUID of the blocking item to drop from this item's dependencies"),
8968
- sessionId: z13.string().max(255).optional().describe("Optional AI session identifier")
9150
+ z14.object({
9151
+ action: z14.literal("resolve_blocker"),
9152
+ id: z14.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
9153
+ type: z14.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
9154
+ resolution: z14.string().min(1).max(5e3).describe("Description of how the blocker was resolved"),
9155
+ unblockedFromId: z14.string().uuid().optional().describe("Optional UUID of the blocking item to drop from this item's dependencies"),
9156
+ sessionId: z14.string().max(255).optional().describe("Optional AI session identifier")
8969
9157
  })
8970
9158
  ])
8971
9159
  },
@@ -9076,13 +9264,13 @@ function registerProgressTools(server2) {
9076
9264
  {
9077
9265
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__manage_progress with action='start_work' instead.\n\nBegin working on a feature or task. This tool:\n- Sets the status to 'In Progress'\n- Records the start timestamp\n- Logs an AI note about starting work\n\nUse this at the beginning of working on any item to properly track timing and status.",
9078
9266
  inputSchema: {
9079
- id: z13.string().describe(
9267
+ id: z14.string().describe(
9080
9268
  "The feature or task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks)."
9081
9269
  ),
9082
- type: z13.enum(["feature", "task"]).describe(
9270
+ type: z14.enum(["feature", "task"]).describe(
9083
9271
  "Whether this is a 'feature' or 'task'."
9084
9272
  ),
9085
- sessionId: z13.string().max(255).optional().describe(
9273
+ sessionId: z14.string().max(255).optional().describe(
9086
9274
  "Optional identifier for this AI session. Helps track which session started the work."
9087
9275
  )
9088
9276
  }
@@ -9116,16 +9304,16 @@ function registerProgressTools(server2) {
9116
9304
  {
9117
9305
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__manage_progress with action='complete_work' instead.\n\nMark a feature or task as complete. This tool:\n- Sets the status to 'Done'\n- Records the completion timestamp\n- Calculates and stores the duration (if started)\n- Sets progress to 100%\n- Clears any blocker reason\n- Optionally logs a summary as an AI note\n\nUse this when you've finished working on an item to properly close it out.",
9118
9306
  inputSchema: {
9119
- id: z13.string().describe(
9307
+ id: z14.string().describe(
9120
9308
  "The feature or task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks)."
9121
9309
  ),
9122
- type: z13.enum(["feature", "task"]).describe(
9310
+ type: z14.enum(["feature", "task"]).describe(
9123
9311
  "Whether this is a 'feature' or 'task'."
9124
9312
  ),
9125
- summary: z13.string().max(5e3).optional().describe(
9313
+ summary: z14.string().max(5e3).optional().describe(
9126
9314
  "Optional summary of the work completed. Will be logged as an AI note for future reference. Good for documenting what was done and any important decisions."
9127
9315
  ),
9128
- sessionId: z13.string().max(255).optional().describe(
9316
+ sessionId: z14.string().max(255).optional().describe(
9129
9317
  "Optional identifier for this AI session."
9130
9318
  )
9131
9319
  }
@@ -9161,19 +9349,19 @@ function registerProgressTools(server2) {
9161
9349
  {
9162
9350
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__manage_progress with action='log_progress' instead.\n\nLog progress on a feature or task without changing its status. This tool:\n- Appends a progress message to AI notes\n- Optionally updates the percent complete (0-100)\n\nUse this for long-running tasks to record incremental progress, decisions made, or notable observations during work.",
9163
9351
  inputSchema: {
9164
- id: z13.string().describe(
9352
+ id: z14.string().describe(
9165
9353
  "The feature or task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks)."
9166
9354
  ),
9167
- type: z13.enum(["feature", "task"]).describe(
9355
+ type: z14.enum(["feature", "task"]).describe(
9168
9356
  "Whether this is a 'feature' or 'task'."
9169
9357
  ),
9170
- message: z13.string().min(1).max(5e3).describe(
9358
+ message: z14.string().min(1).max(5e3).describe(
9171
9359
  "Progress message describing what has been done or the current state. This will be logged as an AI note."
9172
9360
  ),
9173
- percentComplete: z13.number().int().min(0).max(100).optional().describe(
9361
+ percentComplete: z14.number().int().min(0).max(100).optional().describe(
9174
9362
  "Optional percentage (0-100) indicating overall completion. Useful for tracking progress on multi-step work items."
9175
9363
  ),
9176
- sessionId: z13.string().max(255).optional().describe(
9364
+ sessionId: z14.string().max(255).optional().describe(
9177
9365
  "Optional identifier for this AI session."
9178
9366
  )
9179
9367
  }
@@ -9211,19 +9399,19 @@ function registerProgressTools(server2) {
9211
9399
  {
9212
9400
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__manage_progress with action='report_blocker' instead.\n\nReport that a feature or task is blocked. This tool:\n- Sets the status to 'Blocked' (if available)\n- Records the blocker reason\n- Optionally links to the blocking item\n- Logs a blocker note for tracking\n\nUse this when you encounter something preventing progress on an item.",
9213
9401
  inputSchema: {
9214
- id: z13.string().describe(
9402
+ id: z14.string().describe(
9215
9403
  "The feature or task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks)."
9216
9404
  ),
9217
- type: z13.enum(["feature", "task"]).describe(
9405
+ type: z14.enum(["feature", "task"]).describe(
9218
9406
  "Whether this is a 'feature' or 'task'."
9219
9407
  ),
9220
- reason: z13.string().min(1).max(5e3).describe(
9408
+ reason: z14.string().min(1).max(5e3).describe(
9221
9409
  "Description of what is blocking progress. Be specific about what needs to happen to unblock."
9222
9410
  ),
9223
- blockedById: z13.string().uuid().optional().describe(
9411
+ blockedById: z14.string().uuid().optional().describe(
9224
9412
  "Optional UUID of the feature or task that is blocking this item. This creates a dependency relationship."
9225
9413
  ),
9226
- sessionId: z13.string().max(255).optional().describe(
9414
+ sessionId: z14.string().max(255).optional().describe(
9227
9415
  "Optional identifier for this AI session."
9228
9416
  )
9229
9417
  }
@@ -9259,7 +9447,7 @@ function registerProgressTools(server2) {
9259
9447
  }
9260
9448
 
9261
9449
  // src/tools/templates.ts
9262
- import { z as z14 } from "zod";
9450
+ import { z as z15 } from "zod";
9263
9451
  async function resolveTeamId3(teamQuery) {
9264
9452
  const apiClient = getApiClient();
9265
9453
  const result = await apiClient.getTeam(teamQuery);
@@ -9295,7 +9483,7 @@ function registerTemplateTools(server2) {
9295
9483
  {
9296
9484
  description: "Get detailed information about a specific template by name or ID. Returns the complete template structure including all features, tasks, and available variable placeholders that can be customized.",
9297
9485
  inputSchema: {
9298
- name: z14.string().describe(
9486
+ name: z15.string().describe(
9299
9487
  "The template name or ID to retrieve (e.g., 'Code Feature', 'Bug Fix')."
9300
9488
  )
9301
9489
  }
@@ -9325,9 +9513,9 @@ function registerTemplateTools(server2) {
9325
9513
  {
9326
9514
  description: "Preview what will be created from a template without actually creating anything. Shows the expanded epic name, features, and tasks with variable substitution applied. Use this to verify the structure before creating.",
9327
9515
  inputSchema: {
9328
- templateName: z14.string().describe("The name or ID of the template to preview."),
9329
- epicName: z14.string().describe("The name to use for the epic that will be created."),
9330
- variables: z14.record(z14.string(), z14.string()).optional().describe(
9516
+ templateName: z15.string().describe("The name or ID of the template to preview."),
9517
+ epicName: z15.string().describe("The name to use for the epic that will be created."),
9518
+ variables: z15.record(z15.string(), z15.string()).optional().describe(
9331
9519
  "Key-value pairs for variable substitution. Variables in templates use {{variableName}} syntax. For example: { topic: 'Payment Processing' } will replace {{topic}} with 'Payment Processing'."
9332
9520
  )
9333
9521
  }
@@ -9375,21 +9563,21 @@ function registerTemplateTools(server2) {
9375
9563
  {
9376
9564
  description: "Create a complete epic with features and tasks from a template. This is the main tool for applying templates - it creates everything atomically. Returns the created epic with all features and tasks. Optionally pass epicRequestId to link this epic to an approved Epic Request.",
9377
9565
  inputSchema: {
9378
- templateName: z14.string().describe("The name or ID of the template to use."),
9379
- epicName: z14.string().min(1).describe("The name for the new epic."),
9380
- team: z14.string().describe(
9566
+ templateName: z15.string().describe("The name or ID of the template to use."),
9567
+ epicName: z15.string().min(1).describe("The name for the new epic."),
9568
+ team: z15.string().describe(
9381
9569
  "The team to create the epic in. Accepts team ID (UUID), name, or key (e.g., 'Engineering', 'ENG')."
9382
9570
  ),
9383
- variables: z14.record(z14.string(), z14.string()).optional().describe(
9571
+ variables: z15.record(z15.string(), z15.string()).optional().describe(
9384
9572
  "Key-value pairs for variable substitution. Variables in templates use {{variableName}} syntax."
9385
9573
  ),
9386
- epicDescription: z14.string().optional().describe("Custom description for the epic. Overrides template default."),
9387
- epicIcon: z14.string().optional().describe("Custom icon for the epic. Overrides template default."),
9388
- epicColor: z14.string().optional().describe("Custom color (hex code) for the epic. Overrides template default."),
9389
- epicRequestId: z14.string().uuid().optional().describe(
9574
+ epicDescription: z15.string().optional().describe("Custom description for the epic. Overrides template default."),
9575
+ epicIcon: z15.string().optional().describe("Custom icon for the epic. Overrides template default."),
9576
+ epicColor: z15.string().optional().describe("Custom color (hex code) for the epic. Overrides template default."),
9577
+ epicRequestId: z15.string().uuid().optional().describe(
9390
9578
  "UUID of an approved Epic Request to link to this epic. When provided, the Epic Request will be marked as converted."
9391
9579
  ),
9392
- bypassGovernance: z14.boolean().optional()
9580
+ bypassGovernance: z15.boolean().optional()
9393
9581
  }
9394
9582
  },
9395
9583
  async (input) => {
@@ -9460,11 +9648,11 @@ function registerTemplateTools(server2) {
9460
9648
  {
9461
9649
  description: "Save an existing epic's structure as a new reusable template. Extracts the epic's features and tasks into a template that can be used to create similar structures in the future.",
9462
9650
  inputSchema: {
9463
- epicId: z14.string().describe(
9651
+ epicId: z15.string().describe(
9464
9652
  "The ID, identifier (e.g., 'ENG-E1'), or name of the epic to save as a template. The epic must have at least one feature."
9465
9653
  ),
9466
- templateName: z14.string().min(1).max(255).describe("The name for the new template. Must be unique."),
9467
- description: z14.string().max(5e3).optional().describe("Optional description of the template.")
9654
+ templateName: z15.string().min(1).max(255).describe("The name for the new template. Must be unique."),
9655
+ description: z15.string().max(5e3).optional().describe("Optional description of the template.")
9468
9656
  }
9469
9657
  },
9470
9658
  async (input) => {
@@ -9507,7 +9695,7 @@ function registerTemplateTools(server2) {
9507
9695
  }
9508
9696
 
9509
9697
  // src/tools/structured-desc.ts
9510
- import { z as z15 } from "zod";
9698
+ import { z as z16 } from "zod";
9511
9699
  var SECTION_NAMES = [
9512
9700
  "summary",
9513
9701
  "aiInstructions",
@@ -9523,80 +9711,80 @@ var SECTION_NAMES = [
9523
9711
  "estimatedEffort"
9524
9712
  ];
9525
9713
  var baseSchema = {
9526
- id: z15.string().describe(
9714
+ id: z16.string().describe(
9527
9715
  "The feature, task, or epic identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks). Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
9528
9716
  ),
9529
- type: z15.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'.")
9717
+ type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'.")
9530
9718
  };
9531
9719
  function registerStructuredDescTools(server2) {
9532
9720
  server2.registerTool(
9533
9721
  "compbox__manage_description",
9534
9722
  {
9535
9723
  description: "\u2728 CONSOLIDATED TOOL: Manage structured descriptions for features, tasks, and epics. Replaces 6 separate tools with a single interface.\n\n**Actions:**\n\u2022 'get': Retrieve structured description with all sections\n\u2022 'set': Replace entire structured description (requires summary)\n\u2022 'update_section': Update a single section without affecting others\n\u2022 'add_criterion': Append acceptance criterion (deduplicates)\n\u2022 'link_file': Add file path to filesInvolved (deduplicates)\n\u2022 'add_link': Add external documentation link (deduplicates by URL)\n\nUse this tool instead of the deprecated individual tools for better token efficiency.",
9536
- inputSchema: z15.discriminatedUnion("action", [
9724
+ inputSchema: z16.discriminatedUnion("action", [
9537
9725
  // Action: get
9538
- z15.object({
9539
- action: z15.literal("get"),
9726
+ z16.object({
9727
+ action: z16.literal("get"),
9540
9728
  ...baseSchema
9541
9729
  }),
9542
9730
  // Action: set
9543
- z15.object({
9544
- action: z15.literal("set"),
9731
+ z16.object({
9732
+ action: z16.literal("set"),
9545
9733
  ...baseSchema,
9546
- structuredDesc: z15.object({
9547
- summary: z15.string().describe("Required: Human-readable summary"),
9548
- aiInstructions: z15.string().optional().describe("Instructions specifically for AI agents"),
9549
- acceptanceCriteria: z15.array(z15.string()).optional().describe("List of acceptance criteria"),
9550
- filesInvolved: z15.array(z15.string()).optional().describe("File paths involved"),
9551
- functionsToModify: z15.array(z15.string()).optional().describe("Functions to modify (format: 'file:function')"),
9552
- testingStrategy: z15.string().optional().describe("Testing approach"),
9553
- testFiles: z15.array(z15.string()).optional().describe("Test file paths"),
9554
- relatedItemIds: z15.array(z15.string()).optional().describe("Related feature/task IDs"),
9555
- externalLinks: z15.array(z15.object({
9556
- url: z15.string(),
9557
- title: z15.string()
9734
+ structuredDesc: z16.object({
9735
+ summary: z16.string().describe("Required: Human-readable summary"),
9736
+ aiInstructions: z16.string().optional().describe("Instructions specifically for AI agents"),
9737
+ acceptanceCriteria: z16.array(z16.string()).optional().describe("List of acceptance criteria"),
9738
+ filesInvolved: z16.array(z16.string()).optional().describe("File paths involved"),
9739
+ functionsToModify: z16.array(z16.string()).optional().describe("Functions to modify (format: 'file:function')"),
9740
+ testingStrategy: z16.string().optional().describe("Testing approach"),
9741
+ testFiles: z16.array(z16.string()).optional().describe("Test file paths"),
9742
+ relatedItemIds: z16.array(z16.string()).optional().describe("Related feature/task IDs"),
9743
+ externalLinks: z16.array(z16.object({
9744
+ url: z16.string(),
9745
+ title: z16.string()
9558
9746
  })).optional().describe("External documentation links"),
9559
- technicalNotes: z15.string().optional().describe("Technical implementation notes"),
9560
- riskLevel: z15.enum(["low", "medium", "high"]).optional().describe("Risk assessment"),
9561
- estimatedEffort: z15.enum(["trivial", "small", "medium", "large", "xl"]).optional().describe("Effort estimate: trivial (<1hr), small (1-4hr), medium (1-2d), large (3-5d), xl (>5d)")
9747
+ technicalNotes: z16.string().optional().describe("Technical implementation notes"),
9748
+ riskLevel: z16.enum(["low", "medium", "high"]).optional().describe("Risk assessment"),
9749
+ estimatedEffort: z16.enum(["trivial", "small", "medium", "large", "xl"]).optional().describe("Effort estimate: trivial (<1hr), small (1-4hr), medium (1-2d), large (3-5d), xl (>5d)")
9562
9750
  }),
9563
- skipValidation: z15.boolean().optional().describe(
9751
+ skipValidation: z16.boolean().optional().describe(
9564
9752
  "If true, bypasses validation requirements. Use with caution - validation ensures structured descriptions meet minimum quality standards."
9565
9753
  )
9566
9754
  }),
9567
9755
  // Action: update_section
9568
- z15.object({
9569
- action: z15.literal("update_section"),
9756
+ z16.object({
9757
+ action: z16.literal("update_section"),
9570
9758
  ...baseSchema,
9571
- section: z15.enum(SECTION_NAMES).describe(
9759
+ section: z16.enum(SECTION_NAMES).describe(
9572
9760
  "Section to update: summary, aiInstructions, acceptanceCriteria, filesInvolved, functionsToModify, testingStrategy, testFiles, relatedItemIds, externalLinks, technicalNotes, riskLevel, estimatedEffort"
9573
9761
  ),
9574
- value: z15.unknown().describe(
9762
+ value: z16.unknown().describe(
9575
9763
  "New value (type varies by section: string, string[], object[], or enum)"
9576
9764
  )
9577
9765
  }),
9578
9766
  // Action: add_criterion
9579
- z15.object({
9580
- action: z15.literal("add_criterion"),
9767
+ z16.object({
9768
+ action: z16.literal("add_criterion"),
9581
9769
  ...baseSchema,
9582
- criterion: z15.string().min(1).max(1e3).describe(
9770
+ criterion: z16.string().min(1).max(1e3).describe(
9583
9771
  "Acceptance criterion to add (e.g., 'All unit tests pass')"
9584
9772
  )
9585
9773
  }),
9586
9774
  // Action: link_file
9587
- z15.object({
9588
- action: z15.literal("link_file"),
9775
+ z16.object({
9776
+ action: z16.literal("link_file"),
9589
9777
  ...baseSchema,
9590
- filePath: z15.string().min(1).max(500).describe(
9778
+ filePath: z16.string().min(1).max(500).describe(
9591
9779
  "File path to link (e.g., 'src/services/user.ts')"
9592
9780
  )
9593
9781
  }),
9594
9782
  // Action: add_link
9595
- z15.object({
9596
- action: z15.literal("add_link"),
9783
+ z16.object({
9784
+ action: z16.literal("add_link"),
9597
9785
  ...baseSchema,
9598
- url: z15.string().url().describe("URL to link"),
9599
- title: z15.string().min(1).max(255).describe("Descriptive title for the link")
9786
+ url: z16.string().url().describe("URL to link"),
9787
+ title: z16.string().min(1).max(255).describe("Descriptive title for the link")
9600
9788
  })
9601
9789
  ])
9602
9790
  },
@@ -9810,10 +9998,10 @@ To bypass validation, set skipValidation: true. However, this is not recommended
9810
9998
  {
9811
9999
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__manage_description with action='get' instead.\n\nGet the structured description for a feature, task, or epic. Returns parsed sections like summary, aiInstructions, acceptanceCriteria, filesInvolved, etc.",
9812
10000
  inputSchema: {
9813
- id: z15.string().describe(
10001
+ id: z16.string().describe(
9814
10002
  "The feature, task, or epic identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks). Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
9815
10003
  ),
9816
- type: z15.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'.")
10004
+ type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'.")
9817
10005
  }
9818
10006
  },
9819
10007
  async (input) => {
@@ -9860,26 +10048,26 @@ To bypass validation, set skipValidation: true. However, this is not recommended
9860
10048
  {
9861
10049
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__manage_description with action='set' instead.\n\nSet the entire structured description for a feature, task, or epic. This replaces any existing structured description. The 'summary' field is required.",
9862
10050
  inputSchema: {
9863
- id: z15.string().describe(
10051
+ id: z16.string().describe(
9864
10052
  "The feature, task, or epic identifier. Accepts UUID or human-readable identifier. Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
9865
10053
  ),
9866
- type: z15.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
9867
- structuredDesc: z15.object({
9868
- summary: z15.string().describe("Required: Human-readable summary"),
9869
- aiInstructions: z15.string().optional().describe("Instructions specifically for AI agents"),
9870
- acceptanceCriteria: z15.array(z15.string()).optional().describe("List of acceptance criteria"),
9871
- filesInvolved: z15.array(z15.string()).optional().describe("File paths involved"),
9872
- functionsToModify: z15.array(z15.string()).optional().describe("Functions to modify (format: 'file:function')"),
9873
- testingStrategy: z15.string().optional().describe("Testing approach"),
9874
- testFiles: z15.array(z15.string()).optional().describe("Test file paths"),
9875
- relatedItemIds: z15.array(z15.string()).optional().describe("Related feature/task IDs"),
9876
- externalLinks: z15.array(z15.object({
9877
- url: z15.string(),
9878
- title: z15.string()
10054
+ type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
10055
+ structuredDesc: z16.object({
10056
+ summary: z16.string().describe("Required: Human-readable summary"),
10057
+ aiInstructions: z16.string().optional().describe("Instructions specifically for AI agents"),
10058
+ acceptanceCriteria: z16.array(z16.string()).optional().describe("List of acceptance criteria"),
10059
+ filesInvolved: z16.array(z16.string()).optional().describe("File paths involved"),
10060
+ functionsToModify: z16.array(z16.string()).optional().describe("Functions to modify (format: 'file:function')"),
10061
+ testingStrategy: z16.string().optional().describe("Testing approach"),
10062
+ testFiles: z16.array(z16.string()).optional().describe("Test file paths"),
10063
+ relatedItemIds: z16.array(z16.string()).optional().describe("Related feature/task IDs"),
10064
+ externalLinks: z16.array(z16.object({
10065
+ url: z16.string(),
10066
+ title: z16.string()
9879
10067
  })).optional().describe("External documentation links"),
9880
- technicalNotes: z15.string().optional().describe("Technical implementation notes"),
9881
- riskLevel: z15.enum(["low", "medium", "high"]).optional().describe("Risk assessment"),
9882
- estimatedEffort: z15.enum(["trivial", "small", "medium", "large", "xl"]).optional().describe("Effort estimate: trivial (<1hr), small (1-4hr), medium (1-2d), large (3-5d), xl (>5d)")
10068
+ technicalNotes: z16.string().optional().describe("Technical implementation notes"),
10069
+ riskLevel: z16.enum(["low", "medium", "high"]).optional().describe("Risk assessment"),
10070
+ estimatedEffort: z16.enum(["trivial", "small", "medium", "large", "xl"]).optional().describe("Effort estimate: trivial (<1hr), small (1-4hr), medium (1-2d), large (3-5d), xl (>5d)")
9883
10071
  }).describe("The structured description object")
9884
10072
  }
9885
10073
  },
@@ -9939,14 +10127,14 @@ To bypass validation, set skipValidation: true. However, this is not recommended
9939
10127
  {
9940
10128
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__manage_description with action='update_section' instead.\n\nUpdate a specific section of a feature, task, or epic's structured description without touching other sections.",
9941
10129
  inputSchema: {
9942
- id: z15.string().describe(
10130
+ id: z16.string().describe(
9943
10131
  "The feature, task, or epic identifier. Accepts UUID or human-readable identifier. Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
9944
10132
  ),
9945
- type: z15.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
9946
- section: z15.enum(SECTION_NAMES).describe(
10133
+ type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
10134
+ section: z16.enum(SECTION_NAMES).describe(
9947
10135
  "The section to update: summary, aiInstructions, acceptanceCriteria, filesInvolved, functionsToModify, testingStrategy, testFiles, relatedItemIds, externalLinks, technicalNotes, riskLevel, estimatedEffort"
9948
10136
  ),
9949
- value: z15.unknown().describe(
10137
+ value: z16.unknown().describe(
9950
10138
  "The new value for the section. Type depends on section: string for summary/aiInstructions/testingStrategy/technicalNotes, string[] for acceptanceCriteria/filesInvolved/functionsToModify/testFiles/relatedItemIds, { url: string, title: string }[] for externalLinks, 'low'|'medium'|'high' for riskLevel, 'trivial'|'small'|'medium'|'large'|'xl' for estimatedEffort"
9951
10139
  )
9952
10140
  }
@@ -10010,11 +10198,11 @@ To bypass validation, set skipValidation: true. However, this is not recommended
10010
10198
  {
10011
10199
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__manage_description with action='add_criterion' instead.\n\nAdd an acceptance criterion to a feature, task, or epic. This appends to the existing list without removing other criteria. Duplicates are ignored.",
10012
10200
  inputSchema: {
10013
- id: z15.string().describe(
10201
+ id: z16.string().describe(
10014
10202
  "The feature, task, or epic identifier. Accepts UUID or human-readable identifier. Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
10015
10203
  ),
10016
- type: z15.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
10017
- criterion: z15.string().min(1).max(1e3).describe("The acceptance criterion to add (e.g., 'All unit tests pass')")
10204
+ type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
10205
+ criterion: z16.string().min(1).max(1e3).describe("The acceptance criterion to add (e.g., 'All unit tests pass')")
10018
10206
  }
10019
10207
  },
10020
10208
  async (input) => {
@@ -10076,11 +10264,11 @@ To bypass validation, set skipValidation: true. However, this is not recommended
10076
10264
  {
10077
10265
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__manage_description with action='link_file' instead.\n\nLink a file to a feature, task, or epic. This appends the file path to the filesInvolved list. Useful for tracking which files are involved in implementing an item. Duplicates are ignored.",
10078
10266
  inputSchema: {
10079
- id: z15.string().describe(
10267
+ id: z16.string().describe(
10080
10268
  "The feature, task, or epic identifier. Accepts UUID or human-readable identifier. Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
10081
10269
  ),
10082
- type: z15.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
10083
- filePath: z15.string().min(1).max(500).describe("The file path to link (e.g., 'src/services/user.ts')")
10270
+ type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
10271
+ filePath: z16.string().min(1).max(500).describe("The file path to link (e.g., 'src/services/user.ts')")
10084
10272
  }
10085
10273
  },
10086
10274
  async (input) => {
@@ -10133,12 +10321,12 @@ To bypass validation, set skipValidation: true. However, this is not recommended
10133
10321
  {
10134
10322
  description: "\u26A0\uFE0F DEPRECATED: Use compbox__manage_description with action='add_link' instead.\n\nAdd an external link to a feature, task, or epic. Useful for linking to documentation, PRs, design docs, or other external resources. Duplicates (by URL) are ignored.",
10135
10323
  inputSchema: {
10136
- id: z15.string().describe(
10324
+ id: z16.string().describe(
10137
10325
  "The feature, task, or epic identifier. Accepts UUID or human-readable identifier. Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
10138
10326
  ),
10139
- type: z15.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
10140
- url: z15.string().url().describe("The URL to link (e.g., 'https://docs.example.com/feature')"),
10141
- title: z15.string().min(1).max(255).describe("A descriptive title for the link")
10327
+ type: z16.enum(["feature", "task", "epic"]).describe("Whether this is a 'feature', 'task', or 'epic'."),
10328
+ url: z16.string().url().describe("The URL to link (e.g., 'https://docs.example.com/feature')"),
10329
+ title: z16.string().min(1).max(255).describe("A descriptive title for the link")
10142
10330
  }
10143
10331
  },
10144
10332
  async (input) => {
@@ -10190,62 +10378,62 @@ To bypass validation, set skipValidation: true. However, this is not recommended
10190
10378
  }
10191
10379
 
10192
10380
  // src/tools/code-context.ts
10193
- import { z as z16 } from "zod";
10381
+ import { z as z17 } from "zod";
10194
10382
  function registerCodeContextTools(server2) {
10195
10383
  server2.registerTool(
10196
10384
  "compbox__manage_code_context",
10197
10385
  {
10198
10386
  description: "Manage code context for features and tasks. This composite tool provides 7 actions:\n\n**get_context** - Get all code artifacts (files, functions, branch, commits, PR)\n**link_file** - Link a file path to track files involved in implementation\n**unlink_file** - Remove a file from the tracked files list\n**link_function** - Link a function (stored as 'filePath:functionName')\n**link_branch** - Link the git branch used for this work (replaces previous)\n**link_commit** - Link a git commit SHA (multiple commits supported)\n**link_pr** - Link a pull request by number and URL (replaces previous)\n\nUse this instead of individual code context tools for more efficient token usage.",
10199
- inputSchema: z16.discriminatedUnion("action", [
10387
+ inputSchema: z17.discriminatedUnion("action", [
10200
10388
  // get_context action
10201
- z16.object({
10202
- action: z16.literal("get_context").describe("Get all code artifacts"),
10203
- id: z16.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10204
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'")
10389
+ z17.object({
10390
+ action: z17.literal("get_context").describe("Get all code artifacts"),
10391
+ id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10392
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'")
10205
10393
  }),
10206
10394
  // link_file action
10207
- z16.object({
10208
- action: z16.literal("link_file").describe("Link a file to the work item"),
10209
- id: z16.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10210
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
10211
- filePath: z16.string().min(1).max(500).describe("File path to link (e.g., 'src/services/user.ts')")
10395
+ z17.object({
10396
+ action: z17.literal("link_file").describe("Link a file to the work item"),
10397
+ id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10398
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
10399
+ filePath: z17.string().min(1).max(500).describe("File path to link (e.g., 'src/services/user.ts')")
10212
10400
  }),
10213
10401
  // unlink_file action
10214
- z16.object({
10215
- action: z16.literal("unlink_file").describe("Unlink a file from the work item"),
10216
- id: z16.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10217
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
10218
- filePath: z16.string().min(1).max(500).describe("File path to unlink")
10402
+ z17.object({
10403
+ action: z17.literal("unlink_file").describe("Unlink a file from the work item"),
10404
+ id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10405
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
10406
+ filePath: z17.string().min(1).max(500).describe("File path to unlink")
10219
10407
  }),
10220
10408
  // link_function action
10221
- z16.object({
10222
- action: z16.literal("link_function").describe("Link a function to the work item"),
10223
- id: z16.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10224
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
10225
- filePath: z16.string().min(1).max(500).describe("File path containing the function"),
10226
- functionName: z16.string().min(1).max(200).describe("Name of the function")
10409
+ z17.object({
10410
+ action: z17.literal("link_function").describe("Link a function to the work item"),
10411
+ id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10412
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
10413
+ filePath: z17.string().min(1).max(500).describe("File path containing the function"),
10414
+ functionName: z17.string().min(1).max(200).describe("Name of the function")
10227
10415
  }),
10228
10416
  // link_branch action
10229
- z16.object({
10230
- action: z16.literal("link_branch").describe("Link a git branch to the work item"),
10231
- id: z16.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10232
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
10233
- branchName: z16.string().min(1).max(255).describe("Git branch name (e.g., 'feature/COM-7-integration')")
10417
+ z17.object({
10418
+ action: z17.literal("link_branch").describe("Link a git branch to the work item"),
10419
+ id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10420
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
10421
+ branchName: z17.string().min(1).max(255).describe("Git branch name (e.g., 'feature/COM-7-integration')")
10234
10422
  }),
10235
10423
  // link_commit action
10236
- z16.object({
10237
- action: z16.literal("link_commit").describe("Link a git commit to the work item"),
10238
- id: z16.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10239
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
10240
- commitSha: z16.string().min(7).max(40).describe("Git commit SHA (short or full, e.g., 'abc1234')")
10424
+ z17.object({
10425
+ action: z17.literal("link_commit").describe("Link a git commit to the work item"),
10426
+ id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10427
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
10428
+ commitSha: z17.string().min(7).max(40).describe("Git commit SHA (short or full, e.g., 'abc1234')")
10241
10429
  }),
10242
10430
  // link_pr action
10243
- z16.object({
10244
- action: z16.literal("link_pr").describe("Link a pull request to the work item"),
10245
- id: z16.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10246
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
10247
- prNumber: z16.number().int().positive().describe("Pull request number"),
10248
- prUrl: z16.string().url().max(2048).describe("Full URL to the pull request")
10431
+ z17.object({
10432
+ action: z17.literal("link_pr").describe("Link a pull request to the work item"),
10433
+ id: z17.string().describe("Feature or task identifier (UUID or human-readable like 'COM-123')"),
10434
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'"),
10435
+ prNumber: z17.number().int().positive().describe("Pull request number"),
10436
+ prUrl: z17.string().url().max(2048).describe("Full URL to the pull request")
10249
10437
  })
10250
10438
  ])
10251
10439
  },
@@ -10414,10 +10602,10 @@ function registerCodeContextTools(server2) {
10414
10602
  {
10415
10603
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_code_context with action='get_context'. Get all code artifacts linked to a feature or task. Returns files, functions, git branch, commits, and pull request info. Use this at the start of a session to instantly understand the code context without separate exploration.",
10416
10604
  inputSchema: {
10417
- id: z16.string().describe(
10605
+ id: z17.string().describe(
10418
10606
  "The feature or task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks)."
10419
10607
  ),
10420
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'.")
10608
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'.")
10421
10609
  }
10422
10610
  },
10423
10611
  async (input) => {
@@ -10445,11 +10633,11 @@ function registerCodeContextTools(server2) {
10445
10633
  {
10446
10634
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_code_context with action='link_file'. Link a file to a feature or task. This records which files are involved in implementing the work item. The file path is added to the list of related files. Duplicates are ignored. Use this as you work on files to build context for future sessions.",
10447
10635
  inputSchema: {
10448
- id: z16.string().describe(
10636
+ id: z17.string().describe(
10449
10637
  "The feature or task identifier. Accepts UUID or human-readable identifier."
10450
10638
  ),
10451
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
10452
- filePath: z16.string().min(1).max(500).describe("The file path to link (e.g., 'src/services/user.ts')")
10639
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
10640
+ filePath: z17.string().min(1).max(500).describe("The file path to link (e.g., 'src/services/user.ts')")
10453
10641
  }
10454
10642
  },
10455
10643
  async (input) => {
@@ -10483,11 +10671,11 @@ function registerCodeContextTools(server2) {
10483
10671
  {
10484
10672
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_code_context with action='unlink_file'. Unlink a file from a feature or task. Removes the file path from the list of related files. Use this if a file is no longer relevant to the work item.",
10485
10673
  inputSchema: {
10486
- id: z16.string().describe(
10674
+ id: z17.string().describe(
10487
10675
  "The feature or task identifier. Accepts UUID or human-readable identifier."
10488
10676
  ),
10489
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
10490
- filePath: z16.string().min(1).max(500).describe("The file path to unlink")
10677
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
10678
+ filePath: z17.string().min(1).max(500).describe("The file path to unlink")
10491
10679
  }
10492
10680
  },
10493
10681
  async (input) => {
@@ -10521,12 +10709,12 @@ function registerCodeContextTools(server2) {
10521
10709
  {
10522
10710
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_code_context with action='link_function'. Link a function to a feature or task. Records which functions need to be modified or are relevant to the work item. Stored as 'filePath:functionName'. Duplicates are ignored.",
10523
10711
  inputSchema: {
10524
- id: z16.string().describe(
10712
+ id: z17.string().describe(
10525
10713
  "The feature or task identifier. Accepts UUID or human-readable identifier."
10526
10714
  ),
10527
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
10528
- filePath: z16.string().min(1).max(500).describe("The file path containing the function"),
10529
- functionName: z16.string().min(1).max(200).describe("The name of the function")
10715
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
10716
+ filePath: z17.string().min(1).max(500).describe("The file path containing the function"),
10717
+ functionName: z17.string().min(1).max(200).describe("The name of the function")
10530
10718
  }
10531
10719
  },
10532
10720
  async (input) => {
@@ -10568,11 +10756,11 @@ function registerCodeContextTools(server2) {
10568
10756
  {
10569
10757
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_code_context with action='link_branch'. Link a git branch to a feature or task. Records which branch is being used for this work item. Only one branch can be linked at a time (replaces previous).",
10570
10758
  inputSchema: {
10571
- id: z16.string().describe(
10759
+ id: z17.string().describe(
10572
10760
  "The feature or task identifier. Accepts UUID or human-readable identifier."
10573
10761
  ),
10574
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
10575
- branchName: z16.string().min(1).max(255).describe("The git branch name (e.g., 'feature/COM-7-codebase-integration')")
10762
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
10763
+ branchName: z17.string().min(1).max(255).describe("The git branch name (e.g., 'feature/COM-7-codebase-integration')")
10576
10764
  }
10577
10765
  },
10578
10766
  async (input) => {
@@ -10606,11 +10794,11 @@ function registerCodeContextTools(server2) {
10606
10794
  {
10607
10795
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_code_context with action='link_commit'. Link a git commit to a feature or task. Records commits made as part of implementing this work item. Multiple commits can be linked. Duplicates are ignored.",
10608
10796
  inputSchema: {
10609
- id: z16.string().describe(
10797
+ id: z17.string().describe(
10610
10798
  "The feature or task identifier. Accepts UUID or human-readable identifier."
10611
10799
  ),
10612
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
10613
- commitSha: z16.string().min(7).max(40).describe("The git commit SHA (short or full, e.g., 'abc1234')")
10800
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
10801
+ commitSha: z17.string().min(7).max(40).describe("The git commit SHA (short or full, e.g., 'abc1234')")
10614
10802
  }
10615
10803
  },
10616
10804
  async (input) => {
@@ -10644,12 +10832,12 @@ function registerCodeContextTools(server2) {
10644
10832
  {
10645
10833
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_code_context with action='link_pr'. Link a pull request to a feature or task. Records the PR number and URL associated with this work item. Only one PR can be linked at a time (replaces previous).",
10646
10834
  inputSchema: {
10647
- id: z16.string().describe(
10835
+ id: z17.string().describe(
10648
10836
  "The feature or task identifier. Accepts UUID or human-readable identifier."
10649
10837
  ),
10650
- type: z16.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
10651
- prNumber: z16.number().int().positive().describe("The pull request number"),
10652
- prUrl: z16.string().url().max(2048).describe("The full URL to the pull request")
10838
+ type: z17.enum(["feature", "task"]).describe("Whether this is a 'feature' or 'task'."),
10839
+ prNumber: z17.number().int().positive().describe("The pull request number"),
10840
+ prUrl: z17.string().url().max(2048).describe("The full URL to the pull request")
10653
10841
  }
10654
10842
  },
10655
10843
  async (input) => {
@@ -10689,7 +10877,7 @@ function registerCodeContextTools(server2) {
10689
10877
  }
10690
10878
 
10691
10879
  // src/tools/validations.ts
10692
- import { z as z17 } from "zod";
10880
+ import { z as z18 } from "zod";
10693
10881
  var validationCheckTypes = [
10694
10882
  "command",
10695
10883
  "file_exists",
@@ -10702,56 +10890,56 @@ function registerValidationTools(server2) {
10702
10890
  "compbox__manage_validations",
10703
10891
  {
10704
10892
  description: "Manage validation checks for tasks. This composite tool provides 7 actions:\n\n**add**: Add a validation check (command, file_exists, file_contains, test_passes, manual)\n**list**: List all validation checks with their status (pending, passed, failed)\n**run**: Run a single validation check and update its status\n**run_all**: Run all validation checks and return summary\n**mark_manual**: Mark a manual validation check as validated\n**remove**: Remove a validation check from a task\n**reset**: Reset all validation checks to pending status\n\nUse this to define, execute, and track acceptance criteria for tasks.",
10705
- inputSchema: z17.discriminatedUnion("action", [
10893
+ inputSchema: z18.discriminatedUnion("action", [
10706
10894
  // Add validation
10707
- z17.object({
10708
- action: z17.literal("add"),
10709
- taskId: z17.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
10710
- type: z17.enum(validationCheckTypes).describe("Validation check type"),
10711
- description: z17.string().min(1).max(500).describe("What this check validates"),
10712
- command: z17.string().max(1e3).optional().describe("Shell command (for 'command' type)"),
10713
- expectedExitCode: z17.number().int().min(0).max(255).optional().describe("Expected exit code (default: 0)"),
10714
- timeoutMs: z17.number().int().min(1e3).max(3e5).optional().describe("Timeout in ms (default: 30000)"),
10715
- filePath: z17.string().max(500).optional().describe("File path (for 'file_exists' or 'file_contains')"),
10716
- searchPattern: z17.string().max(1e3).optional().describe("Regex pattern (for 'file_contains')"),
10717
- testCommand: z17.string().max(1e3).optional().describe("Test command (for 'test_passes')")
10895
+ z18.object({
10896
+ action: z18.literal("add"),
10897
+ taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
10898
+ type: z18.enum(validationCheckTypes).describe("Validation check type"),
10899
+ description: z18.string().min(1).max(500).describe("What this check validates"),
10900
+ command: z18.string().max(1e3).optional().describe("Shell command (for 'command' type)"),
10901
+ expectedExitCode: z18.number().int().min(0).max(255).optional().describe("Expected exit code (default: 0)"),
10902
+ timeoutMs: z18.number().int().min(1e3).max(3e5).optional().describe("Timeout in ms (default: 30000)"),
10903
+ filePath: z18.string().max(500).optional().describe("File path (for 'file_exists' or 'file_contains')"),
10904
+ searchPattern: z18.string().max(1e3).optional().describe("Regex pattern (for 'file_contains')"),
10905
+ testCommand: z18.string().max(1e3).optional().describe("Test command (for 'test_passes')")
10718
10906
  }),
10719
10907
  // List validations
10720
- z17.object({
10721
- action: z17.literal("list"),
10722
- taskId: z17.string().describe("Task identifier (UUID or e.g., 'COM-123-1')")
10908
+ z18.object({
10909
+ action: z18.literal("list"),
10910
+ taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')")
10723
10911
  }),
10724
10912
  // Run single validation
10725
- z17.object({
10726
- action: z17.literal("run"),
10727
- taskId: z17.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
10728
- checkId: z17.string().uuid().describe("Validation check ID"),
10729
- workingDirectory: z17.string().max(1e3).optional().describe("Working directory for command execution")
10913
+ z18.object({
10914
+ action: z18.literal("run"),
10915
+ taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
10916
+ checkId: z18.string().uuid().describe("Validation check ID"),
10917
+ workingDirectory: z18.string().max(1e3).optional().describe("Working directory for command execution")
10730
10918
  }),
10731
10919
  // Run all validations
10732
- z17.object({
10733
- action: z17.literal("run_all"),
10734
- taskId: z17.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
10735
- stopOnFailure: z17.boolean().optional().describe("Stop after first failure (default: false)"),
10736
- workingDirectory: z17.string().max(1e3).optional().describe("Working directory for command execution")
10920
+ z18.object({
10921
+ action: z18.literal("run_all"),
10922
+ taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
10923
+ stopOnFailure: z18.boolean().optional().describe("Stop after first failure (default: false)"),
10924
+ workingDirectory: z18.string().max(1e3).optional().describe("Working directory for command execution")
10737
10925
  }),
10738
10926
  // Mark manual validated
10739
- z17.object({
10740
- action: z17.literal("mark_manual"),
10741
- taskId: z17.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
10742
- checkId: z17.string().uuid().describe("Manual validation check ID"),
10743
- notes: z17.string().max(1e3).optional().describe("Notes about manual verification")
10927
+ z18.object({
10928
+ action: z18.literal("mark_manual"),
10929
+ taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
10930
+ checkId: z18.string().uuid().describe("Manual validation check ID"),
10931
+ notes: z18.string().max(1e3).optional().describe("Notes about manual verification")
10744
10932
  }),
10745
10933
  // Remove validation
10746
- z17.object({
10747
- action: z17.literal("remove"),
10748
- taskId: z17.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
10749
- checkId: z17.string().uuid().describe("Validation check ID to remove")
10934
+ z18.object({
10935
+ action: z18.literal("remove"),
10936
+ taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')"),
10937
+ checkId: z18.string().uuid().describe("Validation check ID to remove")
10750
10938
  }),
10751
10939
  // Reset validations
10752
- z17.object({
10753
- action: z17.literal("reset"),
10754
- taskId: z17.string().describe("Task identifier (UUID or e.g., 'COM-123-1')")
10940
+ z18.object({
10941
+ action: z18.literal("reset"),
10942
+ taskId: z18.string().describe("Task identifier (UUID or e.g., 'COM-123-1')")
10755
10943
  })
10756
10944
  ])
10757
10945
  },
@@ -10841,31 +11029,31 @@ function registerValidationTools(server2) {
10841
11029
  {
10842
11030
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_validations with action='add'. Add a validation check to a task. Validation checks are executable criteria that define 'done' in a verifiable way. Types:\n- 'command': Run a shell command, check exit code\n- 'file_exists': Verify a file exists\n- 'file_contains': Search file content with regex\n- 'test_passes': Run a test command\n- 'manual': Requires human verification\n\nUse this to define acceptance criteria that can be automatically validated.",
10843
11031
  inputSchema: {
10844
- taskId: z17.string().describe(
11032
+ taskId: z18.string().describe(
10845
11033
  "The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
10846
11034
  ),
10847
- type: z17.enum(validationCheckTypes).describe(
11035
+ type: z18.enum(validationCheckTypes).describe(
10848
11036
  "The type of validation check."
10849
11037
  ),
10850
- description: z17.string().min(1).max(500).describe(
11038
+ description: z18.string().min(1).max(500).describe(
10851
11039
  "Human-readable description of what this check validates."
10852
11040
  ),
10853
- command: z17.string().max(1e3).optional().describe(
11041
+ command: z18.string().max(1e3).optional().describe(
10854
11042
  "Shell command to run (required for 'command' type). E.g., 'pnpm lint'."
10855
11043
  ),
10856
- expectedExitCode: z17.number().int().min(0).max(255).optional().describe(
11044
+ expectedExitCode: z18.number().int().min(0).max(255).optional().describe(
10857
11045
  "Expected exit code for command (default: 0)."
10858
11046
  ),
10859
- timeoutMs: z17.number().int().min(1e3).max(3e5).optional().describe(
11047
+ timeoutMs: z18.number().int().min(1e3).max(3e5).optional().describe(
10860
11048
  "Timeout in milliseconds (default: 30000, max: 300000)."
10861
11049
  ),
10862
- filePath: z17.string().max(500).optional().describe(
11050
+ filePath: z18.string().max(500).optional().describe(
10863
11051
  "File path for 'file_exists' or 'file_contains' checks."
10864
11052
  ),
10865
- searchPattern: z17.string().max(1e3).optional().describe(
11053
+ searchPattern: z18.string().max(1e3).optional().describe(
10866
11054
  "Regex pattern for 'file_contains' check."
10867
11055
  ),
10868
- testCommand: z17.string().max(1e3).optional().describe(
11056
+ testCommand: z18.string().max(1e3).optional().describe(
10869
11057
  "Test command for 'test_passes' type. E.g., 'pnpm test --filter auth'."
10870
11058
  )
10871
11059
  }
@@ -10902,7 +11090,7 @@ function registerValidationTools(server2) {
10902
11090
  {
10903
11091
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_validations with action='list'. List all validation checks for a task. Returns the checks with their current status (pending, passed, failed) and a summary of validation state.",
10904
11092
  inputSchema: {
10905
- taskId: z17.string().describe(
11093
+ taskId: z18.string().describe(
10906
11094
  "The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
10907
11095
  )
10908
11096
  }
@@ -10926,13 +11114,13 @@ function registerValidationTools(server2) {
10926
11114
  {
10927
11115
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_validations with action='run'. Run a single validation check and update its status. Returns the result including whether the check passed, any error message, and captured output.",
10928
11116
  inputSchema: {
10929
- taskId: z17.string().describe(
11117
+ taskId: z18.string().describe(
10930
11118
  "The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
10931
11119
  ),
10932
- checkId: z17.string().uuid().describe(
11120
+ checkId: z18.string().uuid().describe(
10933
11121
  "The ID of the validation check to run."
10934
11122
  ),
10935
- workingDirectory: z17.string().max(1e3).optional().describe(
11123
+ workingDirectory: z18.string().max(1e3).optional().describe(
10936
11124
  "Working directory for command execution (defaults to cwd)."
10937
11125
  )
10938
11126
  }
@@ -10960,13 +11148,13 @@ function registerValidationTools(server2) {
10960
11148
  {
10961
11149
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_validations with action='run_all'. Run all validation checks for a task. Returns a summary with pass/fail counts and individual results. Use this to verify all acceptance criteria are met before marking a task complete.",
10962
11150
  inputSchema: {
10963
- taskId: z17.string().describe(
11151
+ taskId: z18.string().describe(
10964
11152
  "The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
10965
11153
  ),
10966
- stopOnFailure: z17.boolean().optional().describe(
11154
+ stopOnFailure: z18.boolean().optional().describe(
10967
11155
  "If true, stops running checks after the first failure (default: false)."
10968
11156
  ),
10969
- workingDirectory: z17.string().max(1e3).optional().describe(
11157
+ workingDirectory: z18.string().max(1e3).optional().describe(
10970
11158
  "Working directory for command execution (defaults to cwd)."
10971
11159
  )
10972
11160
  }
@@ -10993,13 +11181,13 @@ function registerValidationTools(server2) {
10993
11181
  {
10994
11182
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_validations with action='mark_manual'. Mark a manual validation check as validated. Use this for checks that require human verification and cannot be automated (e.g., 'UI looks correct', 'Documentation is clear').",
10995
11183
  inputSchema: {
10996
- taskId: z17.string().describe(
11184
+ taskId: z18.string().describe(
10997
11185
  "The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
10998
11186
  ),
10999
- checkId: z17.string().uuid().describe(
11187
+ checkId: z18.string().uuid().describe(
11000
11188
  "The ID of the manual validation check to mark as validated."
11001
11189
  ),
11002
- notes: z17.string().max(1e3).optional().describe(
11190
+ notes: z18.string().max(1e3).optional().describe(
11003
11191
  "Optional notes about the manual verification."
11004
11192
  )
11005
11193
  }
@@ -11030,10 +11218,10 @@ function registerValidationTools(server2) {
11030
11218
  {
11031
11219
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_validations with action='remove'. Remove a validation check from a task. Use this to remove checks that are no longer relevant or were added in error.",
11032
11220
  inputSchema: {
11033
- taskId: z17.string().describe(
11221
+ taskId: z18.string().describe(
11034
11222
  "The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
11035
11223
  ),
11036
- checkId: z17.string().uuid().describe(
11224
+ checkId: z18.string().uuid().describe(
11037
11225
  "The ID of the validation check to remove."
11038
11226
  )
11039
11227
  }
@@ -11062,7 +11250,7 @@ function registerValidationTools(server2) {
11062
11250
  {
11063
11251
  description: "\u26A0\uFE0F DEPRECATED: Prefer compbox__manage_validations with action='reset'. Reset all validation checks for a task to pending status. Use this before re-running validations after making changes.",
11064
11252
  inputSchema: {
11065
- taskId: z17.string().describe(
11253
+ taskId: z18.string().describe(
11066
11254
  "The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
11067
11255
  )
11068
11256
  }
@@ -11087,14 +11275,14 @@ function registerValidationTools(server2) {
11087
11275
  }
11088
11276
 
11089
11277
  // src/tools/summary.ts
11090
- import { z as z18 } from "zod";
11278
+ import { z as z19 } from "zod";
11091
11279
  function registerSummaryTools(server2) {
11092
11280
  server2.registerTool(
11093
11281
  "compbox__get_progress_summary",
11094
11282
  {
11095
11283
  description: "Get comprehensive progress summary for an epic. Returns:\n- Feature/task counts (total, completed, in-progress, blocked)\n- Overall progress percentage and estimated remaining work\n- All blocked items with reasons\n- Next actionable items (ready to work on, sorted by execution order)\n- Recently completed items\n- Last session context (summary, next steps)\n\nUse this at the START of a session to quickly understand project status and what to work on next.",
11096
11284
  inputSchema: {
11097
- epicId: z18.string().describe(
11285
+ epicId: z19.string().describe(
11098
11286
  "The epic to get progress summary for. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name."
11099
11287
  )
11100
11288
  }
@@ -11149,7 +11337,7 @@ function registerSummaryTools(server2) {
11149
11337
  {
11150
11338
  description: "Get an org-wide, per-person plan-vs-progress rollup (Director Dashboard). For each member of your organization \u2014 optionally narrowed to a team subtree \u2014 returns:\n- The member (name, email)\n- Their current plan: active epics and active features (with status and % complete)\n- Aggregated progress: total assigned, completed, in-progress, blocked, and overall % complete\n\nStrictly organization-scoped: you only ever see members and work in your own organization. Pass an optional `teamId` to scope the rollup to that team and all of its descendants (the manager's subtree). Use this to read how everyone below you in the org chart is progressing.",
11151
11339
  inputSchema: {
11152
- teamId: z18.string().optional().describe(
11340
+ teamId: z19.string().optional().describe(
11153
11341
  "Optional team ID to scope the rollup to that team and all its descendant teams. Omit for the whole organization."
11154
11342
  )
11155
11343
  }
@@ -11167,7 +11355,7 @@ function registerSummaryTools(server2) {
11167
11355
  }
11168
11356
 
11169
11357
  // src/tools/decisions.ts
11170
- import { z as z19 } from "zod";
11358
+ import { z as z20 } from "zod";
11171
11359
  var decisionCategories = [
11172
11360
  "architecture",
11173
11361
  "library",
@@ -11184,34 +11372,34 @@ function registerDecisionTools(server2) {
11184
11372
  {
11185
11373
  description: "Record a decision with its rationale. Use this to preserve the reasoning behind implementation choices, library selections, architectural decisions, or scope changes. Decisions are append-only - once logged, they cannot be modified. This creates an audit trail for future sessions to understand why choices were made.\n\nWhen to log decisions:\n- Choosing between multiple libraries/approaches\n- Deciding to skip or defer something\n- Making assumptions about requirements\n- Changing direction from original plan",
11186
11374
  inputSchema: {
11187
- epicId: z19.string().uuid().describe(
11375
+ epicId: z20.string().uuid().describe(
11188
11376
  "The epic this decision relates to (required). All decisions must be associated with an epic to maintain context. Accepts UUID or identifier (e.g., 'ENG-E1')."
11189
11377
  ),
11190
- featureId: z19.string().uuid().optional().describe(
11378
+ featureId: z20.string().uuid().optional().describe(
11191
11379
  "Optional feature this decision relates to. Use when the decision is specific to a particular feature within the epic."
11192
11380
  ),
11193
- taskId: z19.string().uuid().optional().describe(
11381
+ taskId: z20.string().uuid().optional().describe(
11194
11382
  "Optional task this decision relates to. Use when the decision is specific to a particular task within a feature."
11195
11383
  ),
11196
- question: z19.string().min(1).max(1e3).describe(
11384
+ question: z20.string().min(1).max(1e3).describe(
11197
11385
  "What was being decided (required). A clear statement of the decision point. Example: 'Which state management library to use for the dashboard'"
11198
11386
  ),
11199
- decision: z19.string().min(1).max(2e3).describe(
11387
+ decision: z20.string().min(1).max(2e3).describe(
11200
11388
  "The choice that was made (required). A clear statement of what was decided. Example: 'Use Zustand instead of Redux'"
11201
11389
  ),
11202
- rationale: z19.string().min(1).max(5e3).describe(
11390
+ rationale: z20.string().min(1).max(5e3).describe(
11203
11391
  "Why this choice was made (required). The reasoning behind the decision. Example: 'Zustand has simpler API, smaller bundle size, and sufficient features for our use case. Redux would be overkill for this project.'"
11204
11392
  ),
11205
- alternatives: z19.array(z19.string().max(500)).max(10).optional().describe(
11393
+ alternatives: z20.array(z20.string().max(500)).max(10).optional().describe(
11206
11394
  "What other options were considered. List alternatives that were evaluated but not chosen. Example: ['Redux', 'MobX', 'Jotai']"
11207
11395
  ),
11208
- madeBy: z19.string().min(1).max(255).default("AI").describe(
11396
+ madeBy: z20.string().min(1).max(255).default("AI").describe(
11209
11397
  "Who made the decision. Use 'AI' for AI-made decisions, 'human' for user decisions, or a user ID for specific attribution. Default: 'AI'"
11210
11398
  ),
11211
- category: z19.enum(decisionCategories).optional().describe(
11399
+ category: z20.enum(decisionCategories).optional().describe(
11212
11400
  "Category of the decision for filtering and grouping:\n- 'architecture': System design decisions\n- 'library': Package/dependency choices\n- 'approach': Implementation strategy\n- 'scope': Feature inclusion/exclusion\n- 'design': UI/UX decisions\n- 'tradeoff': Explicit tradeoff acknowledgment\n- 'deferral': Postponed decisions"
11213
11401
  ),
11214
- impact: z19.enum(impactLevels).optional().describe(
11402
+ impact: z20.enum(impactLevels).optional().describe(
11215
11403
  "Impact level of the decision:\n- 'low': Minor impact, easily reversible\n- 'medium': Moderate impact, some effort to change\n- 'high': Major impact, significant effort to reverse"
11216
11404
  )
11217
11405
  }
@@ -11256,25 +11444,25 @@ function registerDecisionTools(server2) {
11256
11444
  {
11257
11445
  description: "Get decisions for a specific context. Returns decisions filtered by epic, feature, task, category, or impact level. Results are ordered by date (newest first). Use this to review past decisions before making new ones, or to understand the context of previous work.",
11258
11446
  inputSchema: {
11259
- epicId: z19.string().uuid().optional().describe(
11447
+ epicId: z20.string().uuid().optional().describe(
11260
11448
  "Filter by epic ID. Returns all decisions associated with this epic. Accepts UUID or identifier (e.g., 'ENG-E1')."
11261
11449
  ),
11262
- featureId: z19.string().uuid().optional().describe(
11450
+ featureId: z20.string().uuid().optional().describe(
11263
11451
  "Filter by feature ID. Returns decisions associated with this feature."
11264
11452
  ),
11265
- taskId: z19.string().uuid().optional().describe(
11453
+ taskId: z20.string().uuid().optional().describe(
11266
11454
  "Filter by task ID. Returns decisions associated with this task."
11267
11455
  ),
11268
- category: z19.enum(decisionCategories).optional().describe(
11456
+ category: z20.enum(decisionCategories).optional().describe(
11269
11457
  "Filter by decision category (architecture, library, approach, scope, design, tradeoff, deferral)."
11270
11458
  ),
11271
- impact: z19.enum(impactLevels).optional().describe(
11459
+ impact: z20.enum(impactLevels).optional().describe(
11272
11460
  "Filter by impact level (low, medium, high)."
11273
11461
  ),
11274
- limit: z19.number().int().min(1).max(100).optional().describe(
11462
+ limit: z20.number().int().min(1).max(100).optional().describe(
11275
11463
  "Maximum number of decisions to return (default: 20, max: 100)."
11276
11464
  ),
11277
- cursor: z19.string().optional().describe(
11465
+ cursor: z20.string().optional().describe(
11278
11466
  "Pagination cursor from a previous response."
11279
11467
  )
11280
11468
  }
@@ -11309,16 +11497,16 @@ function registerDecisionTools(server2) {
11309
11497
  {
11310
11498
  description: "Find relevant decisions by searching question, decision, and rationale text. Use this to find past decisions that might be relevant to current work, or to check if similar decisions have been made before.",
11311
11499
  inputSchema: {
11312
- query: z19.string().min(1).describe(
11500
+ query: z20.string().min(1).describe(
11313
11501
  "Search query (required). Searches in question, decision, and rationale fields. Example: 'authentication', 'database choice', 'performance optimization'"
11314
11502
  ),
11315
- epicId: z19.string().uuid().optional().describe(
11503
+ epicId: z20.string().uuid().optional().describe(
11316
11504
  "Optional: Limit search to a specific epic. Accepts UUID or identifier (e.g., 'ENG-E1')."
11317
11505
  ),
11318
- limit: z19.number().int().min(1).max(100).optional().describe(
11506
+ limit: z20.number().int().min(1).max(100).optional().describe(
11319
11507
  "Maximum number of results (default: 20, max: 100)."
11320
11508
  ),
11321
- cursor: z19.string().optional().describe(
11509
+ cursor: z20.string().optional().describe(
11322
11510
  "Pagination cursor from a previous response."
11323
11511
  )
11324
11512
  }
@@ -11351,10 +11539,10 @@ function registerDecisionTools(server2) {
11351
11539
  {
11352
11540
  description: "Get all decisions related to current work. Returns decisions organized by scope:\n- Task-level decisions (if taskId provided)\n- Feature-level decisions\n- Epic-level decisions\n\nThis provides full decision history context for the current work item. Use at the start of working on a task or feature to understand past decisions.",
11353
11541
  inputSchema: {
11354
- taskId: z19.string().describe(
11542
+ taskId: z20.string().describe(
11355
11543
  "The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1'). Returns decisions for the task, its parent feature, and the epic."
11356
11544
  ).optional(),
11357
- featureId: z19.string().describe(
11545
+ featureId: z20.string().describe(
11358
11546
  "The feature identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123'). Returns decisions for the feature and the epic. Use when not working on a specific task."
11359
11547
  ).optional()
11360
11548
  }
@@ -11416,7 +11604,7 @@ function isUuid(value) {
11416
11604
  }
11417
11605
 
11418
11606
  // src/tools/teams.ts
11419
- import { z as z20 } from "zod";
11607
+ import { z as z21 } from "zod";
11420
11608
  function gcpKeylessGuidance(k) {
11421
11609
  const auth = k.workloadProvider ? `In GitHub Actions, sign in with google-github-actions/auth using workload_identity_provider "${k.workloadProvider}" and the deploy service account; never ask the owner for the workload provider, it is given here.` : "The Workload Identity provider is missing for this connection, so keyless sign-in can't be configured yet; don't ask the owner to type it in \u2014 an organization admin should reconnect Google Cloud in Settings -> Cloud.";
11422
11610
  const missing = k.missing.length > 0 ? ` Missing: ${k.missing.join(" ")}` : "";
@@ -11456,7 +11644,7 @@ function registerTeamTools(server2) {
11456
11644
  {
11457
11645
  description: "Get the cloud a project (team) deploys to: provider (gcp/aws/azure), cloud project or account ID, region and deploy identity, and whether it is the project's own choice or the organization's default. A team's cloudConnectionId of null means it FOLLOWS THE ORG DEFAULT, not that it has no cloud; always call this before planning hosting, databases or deployment. Returns cloud: null only when the organization has no cloud connected. For Google Cloud it also returns gcpKeyless: projectNumber, workloadProvider (pass it as workload_identity_provider to google-github-actions/auth), identityPool, attributeCondition, allowedGithubOwners, deployRoles and requiredApis \u2014 everything a keyless deploy needs.",
11458
11646
  inputSchema: {
11459
- team: z20.string().min(1).describe("The project/team: UUID, name or key (e.g. 'SAISUD').")
11647
+ team: z21.string().min(1).describe("The project/team: UUID, name or key (e.g. 'SAISUD').")
11460
11648
  }
11461
11649
  },
11462
11650
  async (input) => {
@@ -11493,19 +11681,19 @@ function registerTeamTools(server2) {
11493
11681
  }
11494
11682
 
11495
11683
  // src/tools/team-hierarchy.ts
11496
- import { z as z21 } from "zod";
11684
+ import { z as z22 } from "zod";
11497
11685
  var createTeamChildSchema = {
11498
- parentId: z21.string().uuid().describe("The UUID of the parent team that will own the new child team."),
11499
- name: z21.string().min(1).max(255).describe("Display name for the child team."),
11500
- key: z21.string().min(1).max(10).regex(/^[A-Z][A-Z0-9-]*$/).describe("Unique team key for the child team. Must start with an uppercase letter and contain only uppercase letters, digits, or hyphens."),
11501
- level: z21.enum(["group", "product-line", "product", "discipline"]).describe("Hierarchy level for the child team (required).")
11686
+ parentId: z22.string().uuid().describe("The UUID of the parent team that will own the new child team."),
11687
+ name: z22.string().min(1).max(255).describe("Display name for the child team."),
11688
+ key: z22.string().min(1).max(10).regex(/^[A-Z][A-Z0-9-]*$/).describe("Unique team key for the child team. Must start with an uppercase letter and contain only uppercase letters, digits, or hyphens."),
11689
+ level: z22.enum(["group", "product-line", "product", "discipline"]).describe("Hierarchy level for the child team (required).")
11502
11690
  };
11503
11691
  var getTeamPathSchema = {
11504
- teamId: z21.string().uuid().describe("The UUID of the team whose ordered ancestor path should be returned.")
11692
+ teamId: z22.string().uuid().describe("The UUID of the team whose ordered ancestor path should be returned.")
11505
11693
  };
11506
11694
  var moveTeamSchema = {
11507
- teamId: z21.string().uuid().describe("The UUID of the team to move within the hierarchy."),
11508
- newParentId: z21.string().uuid().nullable().describe("The UUID of the new parent team. Pass null to move the team to the root level.")
11695
+ teamId: z22.string().uuid().describe("The UUID of the team to move within the hierarchy."),
11696
+ newParentId: z22.string().uuid().nullable().describe("The UUID of the new parent team. Pass null to move the team to the root level.")
11509
11697
  };
11510
11698
  function registerTeamHierarchyTools(server2) {
11511
11699
  server2.registerTool(
@@ -11605,7 +11793,7 @@ function registerTeamHierarchyTools(server2) {
11605
11793
 
11606
11794
  // src/tools/composite.ts
11607
11795
  init_dist();
11608
- import { z as z22 } from "zod";
11796
+ import { z as z23 } from "zod";
11609
11797
  var COMPOSITE_TIMEOUT_MS = 12e4;
11610
11798
  function withTimeout(promise, ms, operationName) {
11611
11799
  return new Promise((resolve, reject) => {
@@ -11631,47 +11819,49 @@ function withTimeout(promise, ms, operationName) {
11631
11819
  var estimatedComplexityValues = ["trivial", "simple", "moderate", "complex"];
11632
11820
  var estimatedEffortValues = ["trivial", "small", "medium", "large", "xl"];
11633
11821
  var riskLevelValues = ["low", "medium", "high"];
11634
- var externalLinkSchema = z22.object({
11635
- url: z22.string().describe("URL of the external resource"),
11636
- title: z22.string().describe("Display title for the link")
11822
+ var externalLinkSchema = z23.object({
11823
+ url: z23.string().describe("URL of the external resource"),
11824
+ title: z23.string().describe("Display title for the link")
11637
11825
  });
11638
- var structuredDescSchema = z22.object({
11639
- summary: z22.string().describe("Brief human-readable summary (required)"),
11640
- aiInstructions: z22.string().optional().describe("Specific instructions for AI agents implementing this item"),
11641
- acceptanceCriteria: z22.array(z22.string()).optional().describe("List of acceptance criteria that must be met"),
11642
- filesInvolved: z22.array(z22.string()).optional().describe("File paths that will be involved in this work"),
11643
- functionsToModify: z22.array(z22.string()).optional().describe("Functions to modify in format 'filePath:functionName'"),
11644
- testingStrategy: z22.string().optional().describe("Description of how this work should be tested"),
11645
- testFiles: z22.array(z22.string()).optional().describe("Test file paths"),
11646
- relatedItemIds: z22.array(z22.string()).optional().describe("Related feature or task identifiers"),
11647
- externalLinks: z22.array(externalLinkSchema).optional().describe("External documentation or reference links"),
11648
- technicalNotes: z22.string().optional().describe("Technical implementation notes or constraints"),
11649
- riskLevel: z22.enum(riskLevelValues).optional().describe("Risk level assessment: low, medium, or high"),
11650
- estimatedEffort: z22.enum(estimatedEffortValues).optional().describe("Effort estimate: trivial, small, medium, large, or xl")
11826
+ var structuredDescSchema = z23.object({
11827
+ summary: z23.string().describe("Brief human-readable summary (required)"),
11828
+ aiInstructions: z23.string().optional().describe("Specific instructions for AI agents implementing this item"),
11829
+ acceptanceCriteria: z23.array(z23.string()).optional().describe("List of acceptance criteria that must be met"),
11830
+ filesInvolved: z23.array(z23.string()).optional().describe("File paths that will be involved in this work"),
11831
+ functionsToModify: z23.array(z23.string()).optional().describe("Functions to modify in format 'filePath:functionName'"),
11832
+ testingStrategy: z23.string().optional().describe("Description of how this work should be tested"),
11833
+ testFiles: z23.array(z23.string()).optional().describe("Test file paths"),
11834
+ relatedItemIds: z23.array(z23.string()).optional().describe("Related feature or task identifiers"),
11835
+ externalLinks: z23.array(externalLinkSchema).optional().describe("External documentation or reference links"),
11836
+ technicalNotes: z23.string().optional().describe("Technical implementation notes or constraints"),
11837
+ riskLevel: z23.enum(riskLevelValues).optional().describe("Risk level assessment: low, medium, or high"),
11838
+ estimatedEffort: z23.enum(estimatedEffortValues).optional().describe("Effort estimate: trivial, small, medium, large, or xl")
11651
11839
  });
11652
- var compositeTaskSchema = z22.object({
11653
- title: z22.string().min(1).max(500).describe("Task title (required)"),
11654
- executionOrder: z22.number().int().positive().optional().describe("Execution order within the feature (1, 2, 3...). Lower numbers first."),
11655
- estimatedComplexity: z22.enum(estimatedComplexityValues).optional().describe("Complexity: trivial (<1hr), simple (1-4hr), moderate (1-3d), complex (>3d)"),
11840
+ var compositeTaskSchema = z23.object({
11841
+ title: z23.string().min(1).max(500).describe("Task title (required)"),
11842
+ executionOrder: z23.number().int().positive().optional().describe("Execution order within the feature (1, 2, 3...). Lower numbers first."),
11843
+ estimatedComplexity: z23.enum(estimatedComplexityValues).optional().describe("Complexity: trivial (<1hr), simple (1-4hr), moderate (1-3d), complex (>3d)"),
11656
11844
  structuredDesc: structuredDescSchema.optional().describe("Structured description with summary, aiInstructions, acceptanceCriteria, etc.")
11657
11845
  });
11658
- var compositeFeatureSchema = z22.object({
11659
- title: z22.string().min(1).max(500).describe("Feature title (required)"),
11660
- executionOrder: z22.number().int().positive().describe("Execution order within the epic (required). Lower numbers first."),
11661
- estimatedComplexity: z22.enum(estimatedComplexityValues).describe("Complexity (required): trivial, simple, moderate, or complex"),
11662
- canParallelize: z22.boolean().optional().describe("Whether this feature can run alongside other features in parallel"),
11663
- parallelGroup: z22.string().max(100).optional().describe("Group identifier for features that can run together"),
11664
- dependencies: z22.array(z22.number().int().min(0)).optional().describe(
11846
+ var compositeFeatureSchema = z23.object({
11847
+ title: z23.string().min(1).max(500).describe("Feature title (required)"),
11848
+ executionOrder: z23.number().int().positive().describe("Execution order within the epic (required). Lower numbers first."),
11849
+ estimatedComplexity: z23.enum(estimatedComplexityValues).describe("Complexity (required): trivial, simple, moderate, or complex"),
11850
+ canParallelize: z23.boolean().optional().describe("Whether this feature can run alongside other features in parallel"),
11851
+ parallelGroup: z23.string().max(100).optional().describe("Group identifier for features that can run together"),
11852
+ dependencies: z23.array(z23.number().int().min(0)).optional().describe(
11665
11853
  "Array of 0-based indices referencing earlier features in this array that must complete first"
11666
11854
  ),
11667
11855
  structuredDesc: structuredDescSchema.optional().describe("Structured description with summary, aiInstructions, acceptanceCriteria, etc."),
11668
- tasks: z22.array(compositeTaskSchema).min(1).describe("Array of tasks for this feature (at least 1 required)")
11856
+ tasks: z23.array(compositeTaskSchema).min(1).describe("Array of tasks for this feature (at least 1 required)")
11669
11857
  });
11670
11858
  function registerCompositeTools(server2) {
11671
11859
  server2.registerTool(
11672
11860
  "compbox__create_epic_complete",
11673
11861
  {
11674
- description: `IMPORTANT: Before calling this tool, you MUST: (1) call compbox__list_epic_owner_teams to get available product teams; (2) present the options to the user with their fullPath values (e.g., "Engineering / CompBox") for disambiguation; (3) await the user's explicit selection before passing the team parameter. This enforcement prevents silent misassignment to the wrong product.
11862
+ description: `IMPORTANT: When epicRequestId is NOT provided, before calling this tool you MUST: (1) call compbox__list_epic_owner_teams to get available product teams; (2) present the options to the user with their fullPath values (e.g., "Engineering / CompBox") for disambiguation; (3) await the user's explicit selection before passing the team parameter. This enforcement prevents silent misassignment to the wrong product.
11863
+
11864
+ When epicRequestId IS provided and the Epic Request belongs to a team, team MUST be the Epic Request's team (its teamId) \u2014 do not select a different team. The server rejects a mismatch with a 400 validation error ("Epic Request '\u2026' belongs to team \u2026, but the epic targets a different team \u2026"); to use another team, move the request first with POST /api/v1/epic-requests/:id/reassign-team.
11675
11865
 
11676
11866
  Create an epic with all features, tasks, and structured descriptions in a single atomic operation.
11677
11867
 
@@ -11695,19 +11885,19 @@ Use this instead of individual create calls when building a complete implementat
11695
11885
 
11696
11886
  Optionally pass epicRequestId to link this epic to an approved Epic Request.`,
11697
11887
  inputSchema: {
11698
- name: z22.string().min(1).max(255).describe("Epic name (required)"),
11699
- team: z22.string().min(1).describe("Team ID, name, or key (required). Use compbox__list_teams to find available teams."),
11700
- description: z22.string().max(DESCRIPTION_MAX).optional().describe("Epic description"),
11701
- icon: z22.string().max(50).optional().describe("Icon identifier (e.g., 'rocket', 'star')"),
11702
- color: z22.string().max(20).optional().describe("Hex color code (e.g., '#FF5733')"),
11703
- epicRequestId: z22.string().uuid().optional().describe(
11704
- "UUID of an Epic Request to link to this epic. When provided without deferConversion, the Epic Request will be marked as converted. With deferConversion: true, conversion is skipped (ER must be in 'planning' status)."
11705
- ),
11706
- bypassGovernance: z22.boolean().optional(),
11707
- deferConversion: z22.boolean().optional().describe(
11888
+ name: z23.string().min(1).max(255).describe("Epic name (required)"),
11889
+ team: z23.string().min(1).describe("Team ID, name, or key (required). Use compbox__list_teams to find available teams."),
11890
+ description: z23.string().max(DESCRIPTION_MAX).optional().describe("Epic description"),
11891
+ icon: z23.string().max(50).optional().describe("Icon identifier (e.g., 'rocket', 'star')"),
11892
+ color: z23.string().max(20).optional().describe("Hex color code (e.g., '#FF5733')"),
11893
+ epicRequestId: z23.string().uuid().optional().describe(
11894
+ "UUID of an Epic Request to link to this epic. When provided without deferConversion, the Epic Request will be marked as converted. With deferConversion: true, conversion is skipped (ER must be in 'planning' status). If the Epic Request has a team, the team parameter must be that same team; the server rejects a mismatch with a 400 validation error."
11895
+ ),
11896
+ bypassGovernance: z23.boolean().optional(),
11897
+ deferConversion: z23.boolean().optional().describe(
11708
11898
  "When true, governance accepts 'planning' status and skips auto-conversion of the Epic Request. Used by the planner pipeline which handles conversion in its final VERIFY stage."
11709
11899
  ),
11710
- features: z22.array(compositeFeatureSchema).min(1).describe(
11900
+ features: z23.array(compositeFeatureSchema).min(1).describe(
11711
11901
  "Array of features to create. Each feature must have at least 1 task. Features are created in order, so dependencies must reference earlier indices (0-based)."
11712
11902
  )
11713
11903
  }
@@ -11782,8 +11972,10 @@ Optionally pass epicRequestId to link this epic to an approved Epic Request.`,
11782
11972
  }
11783
11973
  if (error.status === 400) {
11784
11974
  const body = error.body;
11975
+ const rawError = body && typeof body === "object" ? body.error : void 0;
11976
+ const serverMessage = typeof rawError === "string" ? rawError : typeof rawError?.message === "string" ? rawError.message : void 0;
11785
11977
  return createErrorResponse(
11786
- new Error(`Validation error: ${body.error ?? "Invalid input"}`)
11978
+ new Error(`Validation error: ${serverMessage ?? "Invalid input"}`)
11787
11979
  );
11788
11980
  }
11789
11981
  }
@@ -11803,19 +11995,19 @@ Optionally pass epicRequestId to link this epic to an approved Epic Request.`,
11803
11995
  {
11804
11996
  description: "Run all validations for a task and mark it complete if all pass.\n\nThis composite tool combines:\n- compbox__run_all_validations\n- compbox__complete_work (if validations pass)\n\nBehavior:\n- Runs all validation checks defined on the task\n- If ALL validations pass, marks the task as complete with the provided summary\n- If ANY validation fails, returns the failure details WITHOUT completing the task\n- If no validations are defined, completes the task immediately\n\nUse this at the end of implementing a task to ensure all acceptance criteria are met before marking it done.",
11805
11997
  inputSchema: {
11806
- taskId: z22.string().describe(
11998
+ taskId: z23.string().describe(
11807
11999
  "The task identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123-1')."
11808
12000
  ),
11809
- summary: z22.string().max(5e3).optional().describe(
12001
+ summary: z23.string().max(5e3).optional().describe(
11810
12002
  "Summary of work completed. Will be logged as an AI note when the task is marked complete."
11811
12003
  ),
11812
- workingDirectory: z22.string().max(1e3).optional().describe(
12004
+ workingDirectory: z23.string().max(1e3).optional().describe(
11813
12005
  "Working directory for running validation commands. Defaults to current working directory."
11814
12006
  ),
11815
- stopOnFirstFailure: z22.boolean().optional().describe(
12007
+ stopOnFirstFailure: z23.boolean().optional().describe(
11816
12008
  "If true, stops running validations after the first failure. Default is false (run all)."
11817
12009
  ),
11818
- skipValidations: z22.boolean().optional().describe(
12010
+ skipValidations: z23.boolean().optional().describe(
11819
12011
  "If true, skips running validations and completes the task immediately. Use with caution - only for tasks where validations are not applicable."
11820
12012
  )
11821
12013
  }
@@ -11928,17 +12120,17 @@ Optionally pass epicRequestId to link this epic to an approved Epic Request.`,
11928
12120
  }
11929
12121
 
11930
12122
  // src/tools/workflow.ts
11931
- import { z as z23 } from "zod";
12123
+ import { z as z24 } from "zod";
11932
12124
  function registerWorkflowTools(server2) {
11933
12125
  server2.registerTool(
11934
12126
  "compbox__get_next_required_action",
11935
12127
  {
11936
12128
  description: "Analyze current work item state and suggest the next required action to maintain compliance with CompBox best practices. Returns prioritized list of suggestions with tool names and example parameters.\n\nUse this when you're unsure what to do next with a feature, task, or epic to ensure proper workflow compliance and tracking.",
11937
12129
  inputSchema: {
11938
- itemId: z23.string().describe(
12130
+ itemId: z24.string().describe(
11939
12131
  "The feature, task, or epic identifier. Accepts UUID or human-readable identifier (e.g., 'COM-123' for features, 'COM-123-1' for tasks). Epics use UUID, identifier (e.g., 'ENG-E1'), or exact name."
11940
12132
  ),
11941
- itemType: z23.enum(["feature", "task", "epic"]).describe(
12133
+ itemType: z24.enum(["feature", "task", "epic"]).describe(
11942
12134
  "Whether this is a 'feature', 'task', or 'epic'."
11943
12135
  )
11944
12136
  }
@@ -12139,7 +12331,7 @@ function registerWorkflowTools(server2) {
12139
12331
  {
12140
12332
  description: "Get the current state of an AI session and allowed state transitions. The session state machine tracks workflow progress through states: STARTED \u2192 PLANNING \u2192 IMPLEMENTING \u2192 VALIDATING \u2192 COMPLETING.\n\nUse this to understand where you are in the workflow and what transitions are allowed.",
12141
12333
  inputSchema: {
12142
- sessionId: z23.string().describe(
12334
+ sessionId: z24.string().describe(
12143
12335
  "The session ID to query. Get this from compbox__start_session or compbox__get_active_session."
12144
12336
  )
12145
12337
  }
@@ -12169,17 +12361,17 @@ function registerWorkflowTools(server2) {
12169
12361
  // src/tools/project-flags.ts
12170
12362
  import * as fs from "fs/promises";
12171
12363
  import * as path from "path";
12172
- import { z as z24 } from "zod";
12364
+ import { z as z25 } from "zod";
12173
12365
  function registerProjectFlagTools(server2) {
12174
12366
  server2.registerTool(
12175
12367
  "compbox__mark_docs_audit_complete",
12176
12368
  {
12177
12369
  description: "Mark a project's documentation audit as complete by writing the .compbox/docs-audit.json sentinel file. This creates the .compbox/ directory if needed and writes a JSON file that prevents the Request Formulator from prompting about documentation audits on future invocations. Use this when a user confirms their project is already documented.",
12178
- inputSchema: z24.object({
12179
- projectRoot: z24.string().optional().describe(
12370
+ inputSchema: z25.object({
12371
+ projectRoot: z25.string().optional().describe(
12180
12372
  "Project root directory (default: current working directory)"
12181
12373
  ),
12182
- epicRequestId: z24.string().optional().describe(
12374
+ epicRequestId: z25.string().optional().describe(
12183
12375
  "Optional Epic Request ID if the audit was completed via a CompBox epic request"
12184
12376
  )
12185
12377
  })
@@ -12231,7 +12423,7 @@ function registerProjectFlagTools(server2) {
12231
12423
  }
12232
12424
 
12233
12425
  // src/tools/changelog.ts
12234
- import { z as z25 } from "zod";
12426
+ import { z as z26 } from "zod";
12235
12427
  var entityTypes = ["epic", "feature", "task"];
12236
12428
  function registerChangelogTools(server2) {
12237
12429
  server2.registerTool(
@@ -12239,31 +12431,31 @@ function registerChangelogTools(server2) {
12239
12431
  {
12240
12432
  description: "Query entity change history with formatted output. Returns field-level changes showing what was modified, when, and by whom. Each entry shows 'field: oldValue \u2192 newValue'. Useful for understanding how an entity evolved over time or tracking specific field changes.\n\nUse cases:\n- See all changes to a feature or task\n- Track status changes over time\n- Find who changed a specific field\n- Audit changes within a date range\n- Review epic-wide changes across all features/tasks",
12241
12433
  inputSchema: {
12242
- entityType: z25.enum(entityTypes).describe(
12434
+ entityType: z26.enum(entityTypes).describe(
12243
12435
  "Type of entity to query (required). 'epic' for epic changes, 'feature' for feature changes, 'task' for task changes."
12244
12436
  ),
12245
- entityId: z25.string().describe(
12437
+ entityId: z26.string().describe(
12246
12438
  "UUID of the entity to query (required). The specific epic, feature, or task ID."
12247
12439
  ),
12248
- epicId: z25.string().uuid().optional().describe(
12440
+ epicId: z26.string().uuid().optional().describe(
12249
12441
  "Filter by epic ID (optional). Accepts UUID or identifier (e.g., 'ENG-E1'). When provided, only returns changes for entities within this epic. Useful for narrowing down results in a multi-epic query."
12250
12442
  ),
12251
- field: z25.string().max(255).optional().describe(
12443
+ field: z26.string().max(255).optional().describe(
12252
12444
  "Filter by specific field name (optional). Examples: 'statusId', 'title', 'assigneeId', 'description'. Only changes to this field will be returned."
12253
12445
  ),
12254
- changedBy: z25.string().uuid().optional().describe(
12446
+ changedBy: z26.string().uuid().optional().describe(
12255
12447
  "Filter by user ID who made the change (optional). Only returns changes made by this user."
12256
12448
  ),
12257
- since: z25.string().optional().describe(
12449
+ since: z26.string().optional().describe(
12258
12450
  "Filter changes on or after this date (optional). Accepts ISO-8601 date (e.g., '2024-01-15') or duration (e.g., '-P7D' for last 7 days, '-P1M' for last month)."
12259
12451
  ),
12260
- until: z25.string().optional().describe(
12452
+ until: z26.string().optional().describe(
12261
12453
  "Filter changes before this date (optional). Accepts ISO-8601 date format."
12262
12454
  ),
12263
- limit: z25.number().int().min(1).max(100).optional().describe(
12455
+ limit: z26.number().int().min(1).max(100).optional().describe(
12264
12456
  "Maximum number of entries to return (default: 20, max: 100)."
12265
12457
  ),
12266
- cursor: z25.string().optional().describe(
12458
+ cursor: z26.string().optional().describe(
12267
12459
  "Pagination cursor from a previous response. Pass this to fetch the next page of results."
12268
12460
  )
12269
12461
  }
@@ -12316,7 +12508,7 @@ function registerChangelogTools(server2) {
12316
12508
  }
12317
12509
 
12318
12510
  // src/tools/sessions.ts
12319
- import { z as z26 } from "zod";
12511
+ import { z as z27 } from "zod";
12320
12512
  import * as fs2 from "fs";
12321
12513
  import * as path2 from "path";
12322
12514
  function readLocalManifest() {
@@ -12377,13 +12569,13 @@ function registerSessionTools(server2) {
12377
12569
  {
12378
12570
  description: "Start a new AI session for an epic. Creates a session record, abandons any existing active session, and returns the previous session's handoff data plus epic progress. Call this at the START of any work session to properly track AI activity. Optionally scope the session to a specific feature within the epic by providing featureId.",
12379
12571
  inputSchema: {
12380
- epicId: z26.string().describe(
12572
+ epicId: z27.string().describe(
12381
12573
  "The epic to start a session for. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name."
12382
12574
  ),
12383
- externalId: z26.string().optional().describe(
12575
+ externalId: z27.string().optional().describe(
12384
12576
  "Optional external session identifier (e.g., from Copilot or another AI tool)."
12385
12577
  ),
12386
- featureId: z26.string().uuid().optional().describe(
12578
+ featureId: z27.string().uuid().optional().describe(
12387
12579
  "Optional feature ID (UUID) to scope this session to a specific feature within the epic. When provided, the session tracks work on a single feature. Omit for epic-wide sessions (default behavior)."
12388
12580
  )
12389
12581
  }
@@ -12411,19 +12603,19 @@ function registerSessionTools(server2) {
12411
12603
  {
12412
12604
  description: "End the active AI session for an epic with handoff data. Records summary, next steps, blockers, and decisions for the next session. Call this at the END of a work session. If the session was feature-scoped, the response includes featureId indicating which feature was targeted.",
12413
12605
  inputSchema: {
12414
- epicId: z26.string().describe(
12606
+ epicId: z27.string().describe(
12415
12607
  "The epic whose active session to end. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name."
12416
12608
  ),
12417
- summary: z26.string().describe("Summary of work completed during this session."),
12418
- nextSteps: z26.array(z26.string()).optional().describe("Recommended next actions for the successor session."),
12419
- blockers: z26.array(z26.string()).optional().describe("Blockers encountered during this session."),
12420
- decisions: z26.array(
12421
- z26.object({
12422
- decision: z26.string(),
12423
- rationale: z26.string().optional()
12609
+ summary: z27.string().describe("Summary of work completed during this session."),
12610
+ nextSteps: z27.array(z27.string()).optional().describe("Recommended next actions for the successor session."),
12611
+ blockers: z27.array(z27.string()).optional().describe("Blockers encountered during this session."),
12612
+ decisions: z27.array(
12613
+ z27.object({
12614
+ decision: z27.string(),
12615
+ rationale: z27.string().optional()
12424
12616
  })
12425
12617
  ).optional().describe("Key decisions made during this session with rationale."),
12426
- contextBlob: z26.string().optional().describe("Optional free-form context blob for the next session.")
12618
+ contextBlob: z27.string().optional().describe("Optional free-form context blob for the next session.")
12427
12619
  }
12428
12620
  },
12429
12621
  async (input) => {
@@ -12447,7 +12639,7 @@ function registerSessionTools(server2) {
12447
12639
  {
12448
12640
  description: "Check if there is an active AI session for an epic. Returns the session if active, or null.",
12449
12641
  inputSchema: {
12450
- epicId: z26.string().describe(
12642
+ epicId: z27.string().describe(
12451
12643
  "The epic to check. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name."
12452
12644
  )
12453
12645
  }
@@ -12467,7 +12659,7 @@ function registerSessionTools(server2) {
12467
12659
  {
12468
12660
  description: "Get the last completed session for an epic. Returns previous session handoff data without starting a new session. Use this to review what happened in the previous session.",
12469
12661
  inputSchema: {
12470
- epicId: z26.string().describe(
12662
+ epicId: z27.string().describe(
12471
12663
  "The epic to query. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name."
12472
12664
  )
12473
12665
  }
@@ -12487,10 +12679,10 @@ function registerSessionTools(server2) {
12487
12679
  {
12488
12680
  description: "Get the history of AI sessions for an epic. Returns past sessions ordered by most recent first.",
12489
12681
  inputSchema: {
12490
- epicId: z26.string().describe(
12682
+ epicId: z27.string().describe(
12491
12683
  "The epic to query. Accepts epic ID (UUID), identifier (e.g., 'ENG-E1'), or exact epic name."
12492
12684
  ),
12493
- limit: z26.number().int().min(1).max(100).optional().describe("Maximum number of sessions to return (default: 10, max: 100).")
12685
+ limit: z27.number().int().min(1).max(100).optional().describe("Maximum number of sessions to return (default: 10, max: 100).")
12494
12686
  }
12495
12687
  },
12496
12688
  async (input) => {
@@ -12509,7 +12701,7 @@ function registerSessionTools(server2) {
12509
12701
  }
12510
12702
 
12511
12703
  // src/tools/compliance.ts
12512
- import { z as z27 } from "zod";
12704
+ import { z as z28 } from "zod";
12513
12705
  var TIER_EMOJI = {
12514
12706
  pass: "\u2705",
12515
12707
  advisory: "\u26A0\uFE0F",
@@ -12580,7 +12772,7 @@ function registerComplianceTools(server2) {
12580
12772
  {
12581
12773
  description: "Trigger a compliance audit for an Epic Request. Evaluates the epic request against compliance rules and returns a detailed score with dimension breakdown and issues. The audit result is persisted on the epic request for future reference.",
12582
12774
  inputSchema: {
12583
- id: z27.string().min(1).describe(
12775
+ id: z28.string().min(1).describe(
12584
12776
  "The epic request to audit. Accepts UUID or identifier (e.g., 'ER-1')."
12585
12777
  )
12586
12778
  }
@@ -12602,7 +12794,7 @@ function registerComplianceTools(server2) {
12602
12794
  {
12603
12795
  description: "Trigger a full compliance audit for an Epic. Evaluates the epic and all its features and tasks against compliance rules. Returns a detailed score with dimension breakdown and issues. The audit result is persisted on the epic for future reference.",
12604
12796
  inputSchema: {
12605
- id: z27.string().min(1).describe(
12797
+ id: z28.string().min(1).describe(
12606
12798
  "The epic to audit. Accepts UUID, identifier (e.g., 'ENG-E1'), or exact name."
12607
12799
  )
12608
12800
  }
@@ -12639,20 +12831,20 @@ function registerComplianceTools(server2) {
12639
12831
  }
12640
12832
 
12641
12833
  // src/tools/skill-packs/manage.ts
12642
- import { z as z30 } from "zod";
12834
+ import { z as z31 } from "zod";
12643
12835
 
12644
12836
  // src/tools/skill-packs/get-manifest.ts
12645
- import { z as z28 } from "zod";
12837
+ import { z as z29 } from "zod";
12646
12838
  function registerGetPackManifestTool(server2) {
12647
12839
  server2.registerTool(
12648
12840
  "compbox__get_pack_manifest",
12649
12841
  {
12650
12842
  description: "Get the detailed manifest for a specific version of a skill pack.\n\nThe manifest describes the pack's contents including:\n- Agents: AI agents included in the pack\n- Skills: Individual skills/capabilities\n- Instructions: Documentation and usage guides\n- Dependencies: Other packs this pack depends on\n\nUse this to understand what a skill pack contains before installing it, or to see the details of an installed pack's current version.",
12651
12843
  inputSchema: {
12652
- id: z28.string().describe(
12844
+ id: z29.string().describe(
12653
12845
  "Skill pack ID or name (e.g., '@mycompbox/planning' or UUID)"
12654
12846
  ),
12655
- version: z28.string().optional().describe(
12847
+ version: z29.string().optional().describe(
12656
12848
  "Specific version to get manifest for (e.g., '1.2.3'). If not provided, uses latest stable version."
12657
12849
  )
12658
12850
  }
@@ -12742,7 +12934,7 @@ function registerGetPackManifestTool(server2) {
12742
12934
  }
12743
12935
 
12744
12936
  // src/tools/skill-packs/sync-local.ts
12745
- import { z as z29 } from "zod";
12937
+ import { z as z30 } from "zod";
12746
12938
  import * as fs3 from "fs/promises";
12747
12939
  import * as path3 from "path";
12748
12940
  import { existsSync } from "fs";
@@ -12752,7 +12944,7 @@ function registerSyncLocalPacksTool(server2) {
12752
12944
  {
12753
12945
  description: "Detect drift between local skill pack installations and the registry.\n\nThis tool compares:\n1. .compbox/manifest.json (local installation record)\n2. Actual files in .github/ (agents, skills, instructions, presets)\n3. Database registry (what's officially installed)\n\nReports:\n- **Untracked files**: Files exist locally but not in manifest\n- **Missing files**: Files in manifest but not on filesystem\n- **Registry mismatches**: Local manifest differs from database registry\n- **Version differences**: Installed version vs. available version\n\nUse this to audit local installations and identify cleanup/sync needs.",
12754
12946
  inputSchema: {
12755
- projectRoot: z29.string().optional().describe(
12947
+ projectRoot: z30.string().optional().describe(
12756
12948
  "Project root directory (default: current working directory). Must contain .compbox/ and .github/ directories."
12757
12949
  )
12758
12950
  }
@@ -12944,21 +13136,21 @@ function registerSkillPackTools(server2) {
12944
13136
  "compbox__manage_skill_packs",
12945
13137
  {
12946
13138
  description: "Manage Skill Packs with action-based routing. This composite tool provides 5 actions:\n\n**list** - List available skill packs from the registry (supports filtering by official/search)\n**get** - Get details about a specific skill pack by ID or name\n**install** - Install a skill pack by ID/name and version\n**update** - Update an installed skill pack to a new version (or 'latest')\n**list_installed** - List all installed skill packs with their status\n\nUse this to discover, install, and manage skill packs during AI sessions.",
12947
- inputSchema: z30.object({
12948
- action: z30.enum(["list", "get", "install", "update", "list_installed"]).describe(
13139
+ inputSchema: z31.object({
13140
+ action: z31.enum(["list", "get", "install", "update", "list_installed"]).describe(
12949
13141
  "The action to perform: 'list' (browse registry), 'get' (pack details), 'install', 'update', or 'list_installed' (your installed packs)"
12950
13142
  ),
12951
13143
  // Used by: list, get, install, update
12952
- id: z30.string().optional().describe("Skill pack ID or name (e.g., '@mycompbox/planning'). Required for get/install/update actions."),
13144
+ id: z31.string().optional().describe("Skill pack ID or name (e.g., '@mycompbox/planning'). Required for get/install/update actions."),
12953
13145
  // Used by: list
12954
- cursor: z30.string().optional().describe("Pagination cursor from previous response (list action only)"),
12955
- limit: z30.number().int().min(1).max(100).optional().describe("Maximum results per page, default 20, max 100 (list action only)"),
12956
- isOfficial: z30.boolean().optional().describe("Filter by official packs (list action only)"),
12957
- query: z30.string().optional().describe("Search query to filter by name (list action only)"),
13146
+ cursor: z31.string().optional().describe("Pagination cursor from previous response (list action only)"),
13147
+ limit: z31.number().int().min(1).max(100).optional().describe("Maximum results per page, default 20, max 100 (list action only)"),
13148
+ isOfficial: z31.boolean().optional().describe("Filter by official packs (list action only)"),
13149
+ query: z31.string().optional().describe("Search query to filter by name (list action only)"),
12958
13150
  // Used by: get
12959
- includeVersions: z30.boolean().optional().describe("Include all versions in response (get action only)"),
13151
+ includeVersions: z31.boolean().optional().describe("Include all versions in response (get action only)"),
12960
13152
  // Used by: install, update
12961
- version: z30.string().optional().describe("Version to install/update to (e.g., '1.2.3' or 'latest'). Required for install/update actions.")
13153
+ version: z31.string().optional().describe("Version to install/update to (e.g., '1.2.3' or 'latest'). Required for install/update actions.")
12962
13154
  })
12963
13155
  },
12964
13156
  async (input) => {
@@ -13244,7 +13436,7 @@ function withLegacyToolCallRewrite(transport) {
13244
13436
  var SERVER_NAME = "compbox-mcp";
13245
13437
  function resolveServerVersion() {
13246
13438
  if (true) {
13247
- return "1.21.12";
13439
+ return "1.21.15";
13248
13440
  }
13249
13441
  const require2 = createRequire(import.meta.url);
13250
13442
  for (const candidate of ["../package.json", "./package.json"]) {